Merge pull request #72 from jdhao/lua-au-ctx

refactor: use ctx table for lua autocmd callback

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,40 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+---
+
+<!-- Before reporting: make sure that you have read the doc (https://github.com/jdhao/nvim-config/tree/master/docs) and searched existing issues. -->
+
+- `nvim --version`: <!--should be latest stable version: https://github.com/neovim/neovim/releases/tag/stable -->
+- terminal emulator and version:
+- Operating system/version:
+- Have you read and followed all steps in the [doc](https://github.com/jdhao/nvim-config/tree/master/docs):
+- Output of command `set runtimepath`:
+
+  <!-- paste your runtimepath below --->
+  ```
+
+  ```
+
+**Describe the bug**
+
+<!-- A clear and concise description of what the bug is. -->
+
+Steps to reproduce the issue:
+
+1.
+2.
+3.
+
+**Expected behavior**
+<!-- A clear and concise description of what you expected to happen. -->
+
+**Screenshots**
+<!-- If applicable, add screenshots to help explain your problem. -->
+
+**Additional context**
+
+<!-- Add any other context about the problem here. -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.gitignore

@@ -2,4 +2,5 @@ tags
 en.utf-8.add.spl
 *.exe
 .netrwhist
-packer_compiled.lua
+*.log
+.DS_Store

.stylua.toml

@@ -0,0 +1,6 @@
+# config for stylua, ref: https://github.com/JohnnyMorganz/StyLua
+line_endings = "Unix"
+indent_type = "Spaces"
+indent_width = 2
+quote_style = "AutoPreferDouble"
+no_call_parentheses = true

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018-2021 jdhao
+Copyright (c) 2018-2022 jdhao
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,34 +1,62 @@
-```
+<div align="center">
-███    ██ ██    ██ ██ ███    ███      ██████  ██████  ███    ██ ███████ ██  ██████
+<p>
-████   ██ ██    ██ ██ ████  ████     ██      ██    ██ ████   ██ ██      ██ ██
+    <a>
-██ ██  ██ ██    ██ ██ ██ ████ ██     ██      ██    ██ ██ ██  ██ █████   ██ ██   ███
+      <img alt="Linux" src="https://img.shields.io/badge/Linux-%23.svg?style=flat-square&logo=linux&color=FCC624&logoColor=black" />
-██  ██ ██  ██  ██  ██ ██  ██  ██     ██      ██    ██ ██  ██ ██ ██      ██ ██    ██
+    </a>
-██   ████   ████   ██ ██      ██      ██████  ██████  ██   ████ ██      ██  ██████
+    <a>
-```
+      <img alt="macOS" src="https://img.shields.io/badge/macOS-%23.svg?style=flat-square&logo=apple&color=000000&logoColor=white" />
+    </a>
+    <a>
+      <img alt="Windows" src="https://img.shields.io/badge/Windows-%23.svg?style=flat-square&logo=windows&color=0078D6&logoColor=white" />
+    </a>
+    <a href="https://github.com/jdhao/nvim-config/commits">
+      <img src="https://badgen.net/github/commits/jdhao/nvim-config" alt="Commit number" />
+    </a>
+    <a href="https://github.com/jdhao/nvim-config/network">
+      <img alt="Forks" src="https://badgen.net/github/forks/jdhao/nvim-config">
+    </a>
+    <a href="https://github.com/jdhao/nvim-config/stargazers">
+      <img alt="Stars" src="https://badgen.net/github/stars/jdhao/nvim-config">
+    </a>
+    <a href="https://github.com/jdhao/nvim-config/releases/latest">
+      <img alt="Latest release" src="https://img.shields.io/github/v/release/jdhao/nvim-config" />
+    </a>
+    <a href="https://github.com/neovim/neovim/releases/tag/stable">
+      <img src="https://img.shields.io/badge/Neovim-0.7.2-blueviolet.svg?style=flat-square&logo=Neovim&logoColor=green" alt="Neovim minimum version"/>
+    </a>
+    <a href="https://github.com/jdhao/nvim-config/search?l=vim-script">
+      <img src="https://img.shields.io/github/languages/top/jdhao/nvim-config" alt="Top languages"/>
+    </a>
+    <a href="https://github.com/jdhao/nvim-config/blob/master/LICENSE">
+      <img src="https://img.shields.io/github/license/jdhao/nvim-config?style=flat-square&logo=GNU&label=License" alt="License"/>
+    </a>
+</p>
+</div>
 
 # Introduction
 
-This repo hosts my Nvim configuration for all the platforms I am using (Linux,
+This repo hosts my Nvim configuration for Linux, macOS, and Windows.
-Windows and macOS). `init.vim` is the config entry point for terminal Nvim,
+`init.lua` is the config entry point for terminal Nvim,
-and `ginit.vim` is the additional config file for GUI client of Nvim (I am
+and `ginit.vim` is the additional config file for [GUI client of Nvim](https://github.com/neovim/neovim/wiki/Related-projects#gui).
-using [neovim-qt](https://github.com/equalsraf/neovim-qt) for now on Windows).
 
-My configurations are heavily documented to make it as clear as possible. While
+My configurations are heavily documented to make it as clear as possible.
-you can download the whole repository and use it, it is not recommended though.
+While you can clone the whole repository and use it, it is not recommended though.
-Good configurations are personal. Everyone should have his or her unique config
+Good configurations are personal. Everyone should have his or her unique config file.
-file. You are encouraged to copy from this repo the part you feel useful and
+You are encouraged to copy from this repo the part you want and add it to your own config.
-add it to your own Nvim config.
 
-See [doc here](docs/README.md) on how to install Nvim's dependencies, Nvim
+To reduce the possibility of breakage, **this config is only maintained for [the latest nvim stable release](https://github.com/neovim/neovim/releases/tag/stable).
-itself, and how to set up on different platforms (Linux, macOS and Windows).
+No effort is spent on maintaining backward compatibility.**
 
-**This config is tested against [Nvim 0.6.0 release](https://github.com/neovim/neovim/releases/tag/v0.6.0). No backward compatibility
+# Install and setup
-is guaranteed.**
+
+See [doc here](docs/README.md) on how to install Nvim's dependencies, Nvim itself,
+and how to set up on different platforms (Linux, macOS, and Windows).
 
 # Features #
 
 + Plugin management via [Packer.nvim](https://github.com/wbthomason/packer.nvim).
-+ Code auto-completion via [nvim-cmp](https://github.com/hrsh7th/nvim-cmp) and [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig).
++ Code, snippet, word auto-completion via [nvim-cmp](https://github.com/hrsh7th/nvim-cmp).
++ Language server protocol (LSP) support via [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig).
 + Git integration via [vim-fugitive](https://github.com/tpope/vim-fugitive).
 + Better escaping from insert mode via [better-escape.vim](https://github.com/jdhao/better-escape.vim).
 + Ultra-fast project-wide fuzzy searching via [LeaderF](https://github.com/Yggdroot/LeaderF).
@@ -36,42 +64,43 @@ is guaranteed.**
 + Faster matching pair insertion and jump via [delimitMate](https://github.com/Raimondi/delimitMate).
 + Smarter and faster matching pair management (add, replace or delete) via [vim-sandwich](https://github.com/machakann/vim-sandwich).
 + Fast buffer jump via [hop.nvim](https://github.com/phaazon/hop.nvim).
-+ Ultra fast snippet insertion via [Ultisnips](https://github.com/SirVer/ultisnips).
++ Powerful snippet insertion via [Ultisnips](https://github.com/SirVer/ultisnips).
-+ Beautiful status line via [lualine.nvim](https://github.com/nvim-lualine/lualine.nvim).
++ Beautiful statusline via [lualine.nvim](https://github.com/nvim-lualine/lualine.nvim).
++ File tree explorer via [nvim-tree.lua](https://github.com/kyazdani42/nvim-tree.lua).
 + Better quickfix list with [nvim-bqf](https://github.com/kevinhwang91/nvim-bqf).
 + Show search index and count with [nvim-hlslens](https://github.com/kevinhwang91/nvim-hlslens).
 + Command line auto-completion via [wilder.nvim](https://github.com/gelguy/wilder.nvim).
-+ Keymap display via [which-key.nvim](https://github.com/folke/which-key.nvim).
++ User-defined mapping hint via [which-key.nvim](https://github.com/folke/which-key.nvim).
 + Asynchronous code execution via [asyncrun.vim](https://github.com/skywind3000/asyncrun.vim).
 + Code highlighting via [nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter).
 + Code editing using true nvim inside browser via [firenvim](https://github.com/glacambre/firenvim).
 + Color theme via [vim-gruvbox8](https://github.com/lifepillar/vim-gruvbox8) and other beautiful themes.
 + Markdown writing and previewing via [vim-markdown](https://github.com/plasticboy/vim-markdown) and [markdown-preview.nvim](https://github.com/iamcco/markdown-preview.nvim).
++ LaTeX editing and previewing via [vimtex](https://github.com/lervag/vimtex) <sup id="a1">[1](#f1)</sup>.
 + Animated GUI style notification via [nvim-notify](https://github.com/rcarriga/nvim-notify).
 + Smooth scroll experience via [neoscroll](https://github.com/karb94/neoscroll.nvim).
 + Tags navigation via [vista](https://github.com/liuchengxu/vista.vim).
 + Code formatting via [Neoformat](https://github.com/sbdchd/neoformat).
 + Undo management via [vim-mundo](https://github.com/simnalamburt/vim-mundo)
-+ LaTeX editing via [vimtex](https://github.com/lervag/vimtex) <sup id="a1">[1](#f1)</sup>.
 + ......
 
 # UI Demo
 
-For more UI demos, see [here](https://github.com/jdhao/nvim-config/issues/15).
+For more UI demos, check [here](https://github.com/jdhao/nvim-config/issues/15).
 
-## Start screen with alpha-nvim
+## Start screen with dashboard-nvim
 
 <p align="center">
-<img src="https://user-images.githubusercontent.com/16662357/139459989-0537ded4-c119-4749-99bf-b551ca1ba118.jpg" width="800">
+<img src="https://user-images.githubusercontent.com/16662357/183256752-fb23b215-a6b8-4646-beed-9999f52d53f1.png" width="800">
 </p>
 
-## fuzzy finding using LeaderF
+## File fuzzy finding using LeaderF
 
 <p align="center">
-<img src="https://user-images.githubusercontent.com/16662357/139462025-7bce98c5-d2d5-413f-9659-20545865cdca.gif" width="800">
+<img src="https://user-images.githubusercontent.com/16662357/183257017-2d9d7605-3c4b-4e1d-8955-30998f9b6f28.gif" width="800">
 </p>
 
-## Autocompletion
+## Code autocompletion with nvim-cmp
 
 <p align="center">
 <img src="https://user-images.githubusercontent.com/16662357/128590006-0fc1451f-fac1-49b2-bb95-8aba21bfa44e.gif" width="800">
@@ -83,6 +112,12 @@ For more UI demos, see [here](https://github.com/jdhao/nvim-config/issues/15).
 <img src="https://user-images.githubusercontent.com/16662357/128590833-aaa05d53-19ef-441d-a5a9-ba1bbd3936c1.gif" width="800">
 </p>
 
+## Command-line autocompletion with wilder.nvim
+
+<p align="center">
+<img src="https://user-images.githubusercontent.com/16662357/147677787-8e5d229a-a16a-420e-98f5-88f2a1be84a2.gif" width="800">
+</p>
+
 ## Tags
 
 <p align="center">
@@ -97,71 +132,85 @@ Go to a string starting with `se`
 <img src="https://user-images.githubusercontent.com/16662357/139459219-8a7e6ac4-1d24-4008-a370-b56773d7cb85.gif" width="800">
 </p>
 
-## GUI-style notification
+## GUI-style notification with nvim-notify
 
 <p align="center">
 <img src="https://user-images.githubusercontent.com/16662357/128589873-aadb8264-1098-4834-9876-fa66a309be05.gif" width="800">
 </p>
 
-
 # Shortcuts
 
-Some of the shortcuts I use frequently. In the following shortcuts, `<leader>`
+Some of the shortcuts I use frequently are listed here. In the following shortcuts, `<leader>` represents ASCII character `,`.
-represents ASCII character `,`.
 
-| Shortcut          | Mode          | platform        | Description                                                      |
+| Shortcut          | Mode          | platform        | Description                                                              |
-|-------------------|---------------|-----------------|------------------------------------------------------------------|
+|-------------------|---------------|-----------------|--------------------------------------------------------------------------|
-| `<leader>ff`      | Normal        | Linux/macOS/Win | Fuzzy file searching in a floating window                        |
+| `<leader>ff`      | Normal        | Linux/macOS/Win | Fuzzy file searching in a floating window                                |
-| `<leader>fh`      | Normal        | Linux/macOS/Win | Fuzzy help file grepping in a floating window                    |
+| `<leader>fh`      | Normal        | Linux/macOS/Win | Fuzzy help file grepping in a floating window                            |
-| `<leader>fg`      | Normal        | Linux/macOS/Win | Fuzzy project-wide grepping in a floating window                 |
+| `<leader>fg`      | Normal        | Linux/macOS/Win | Fuzzy project-wide grepping in a floating window                         |
-| `<leader>ft`      | Normal        | Linux/macOS/Win | Fuzzy buffer tag searching in a floating window                  |
+| `<leader>ft`      | Normal        | Linux/macOS/Win | Fuzzy buffer tag searching in a floating window                          |
-| `<leader>fb`      | Normal        | Linux/macOS/Win | Fuzzy buffer switching in a floating window                      |
+| `<leader>fb`      | Normal        | Linux/macOS/Win | Fuzzy buffer switching in a floating window                              |
-| `<leader><Space>` | Normal        | Linux/macOS/Win | Remove trailing white spaces                                     |
+| `<leader><Space>` | Normal        | Linux/macOS/Win | Remove trailing white spaces                                             |
-| `<leader>v`       | Normal        | Linux/macOS/Win | Reselect last pasted text                                        |
+| `<leader>v`       | Normal        | Linux/macOS/Win | Reselect last pasted text                                                |
-| `<leader>ev`      | Normal        | Linux/macOS/Win | Edit Nvim config in a new tabpage                                |
+| `<leader>ev`      | Normal        | Linux/macOS/Win | Edit Nvim config in a new tabpage                                        |
-| `<leader>sv`      | Normal        | Linux/macOS/Win | Reload Nvim config                                               |
+| `<leader>sv`      | Normal        | Linux/macOS/Win | Reload Nvim config                                                       |
-| `<leader>st`      | Normal        | Linux/macOS/Win | Show highlight group for cursor text                             |
+| `<leader>st`      | Normal        | Linux/macOS/Win | Show highlight group for cursor text                                     |
-| `<leader>q`       | Normal        | Linux/macOS/Win | Quit current window                                              |
+| `<leader>q`       | Normal        | Linux/macOS/Win | Quit current window                                                      |
-| `<leader>Q`       | Normal        | Linux/macOS/Win | Quit all window and close Nvim                                   |
+| `<leader>Q`       | Normal        | Linux/macOS/Win | Quit all window and close Nvim                                           |
-| `<leader>w`       | Normal        | Linux/macOS/Win | Save current buffer content                                      |
+| `<leader>w`       | Normal        | Linux/macOS/Win | Save current buffer content                                              |
-| `<leader>cd`      | Normal        | Linux/macOS/Win | Change current directory to where current file is                |
+| `<leader>y`       | Normal        | Linux/macOS/Win | Copy the content of entire buffer to default register                    |
-| `<leader>y`       | Normal        | Linux/macOS/Win | Copy the content of entire buffer to default register            |
+| `<leader>cl`      | Normal        | Linux/macOS/Win | Toggle cursor column                                                     |
-| `<leader>cl`      | Normal        | Linux/macOS/Win | Toggle cursor column                                             |
+| `<leader>cd`      | Normal        | Linux/macOS/Win | Change current working directory to to the dir of current buffer         |
-| `<leader>cd`      | Normal        | Linux/macOS/Win | Change current working directory to to the dir of current buffer |
+| `<space>t`        | Normal        | Linux/macOS/Win | Toggle tag window (show project tags in the right window)                |
-| `<space>t`        | Normal        | Linux/macOS/Win | Toggle tag window (show project tags in the right window)        |
+| `<leader>gs`      | Normal        | Linux/macOS/Win | Show Git status result                                                   |
-| `<leader>gs`      | Normal        | Linux/macOS/Win | Show Git status result                                           |
+| `<leader>gw`      | Normal        | Linux/macOS/Win | Run Git add for current file                                             |
-| `<leader>gw`      | Normal        | Linux/macOS/Win | Run Git add for current file                                     |
+| `<leader>gd`      | Normal        | Linux/macOS/Win | Run git diff for current file                                            |
-| `<leader>gd`      | Normal        | Linux/macOS/Win | Run git diff for current file                                    |
+| `<leader>gc`      | Normal        | Linux/macOS/Win | Run git commit                                                           |
-| `<leader>gc`      | Normal        | Linux/macOS/Win | Run git commit                                                   |
+| `<leader>gpl`     | Normal        | Linux/macOS/Win | Run git pull                                                             |
-| `<F9>`            | Normal        | Linux/macOS/Win | Run current source file (for Python, C++)                        |
+| `<leader>gpu`     | Normal        | Linux/macOS/Win | Run git push                                                             |
-| `<F11>`           | Normal        | Linux/macOS/Win | Toggle spell checking                                            |
+| `<F9>`            | Normal        | Linux/macOS/Win | Compile&run current source file (for C++, LaTeX, Lua, Python)            |
-| `<F12>`           | Normal        | Linux/macOS/Win | Toggle paste mode                                                |
+| `<F11>`           | Normal        | Linux/macOS/Win | Toggle spell checking                                                    |
-| `\x`              | Normal        | Linux/macOS/Win | Close location or quickfix window                                |
+| `<F12>`           | Normal        | Linux/macOS/Win | Toggle paste mode                                                        |
-| `\d`              | Normal        | Linux/macOS/Win | Close current buffer and go to previous buffer                   |
+| `\x`              | Normal        | Linux/macOS/Win | Close location or quickfix window                                        |
-| `{count}gb`       | Normal        | Linux/macOS/Win | Go to buffer {count}  or next buffer in the buffer list.         |
+| `\d`              | Normal        | Linux/macOS/Win | Close current buffer and go to previous buffer                           |
-| `Alt-m`           | Normal        | macOS/Win       | Markdown previewing in system browser                            |
+| `{count}gb`       | Normal        | Linux/macOS/Win | Go to buffer `{count}` or next buffer in the buffer list.                |
-| `Alt-Shift-m`     | Normal        | macOS/Win       | Stopping Markdown previewing in system browser                   |
+| `{operator}iB`    | Normal        | Linux/macOS/Win | Operate in the whole buffer, `{operator}` can be `v`, `y`, `c`, `d` etc. |
-| `ob`              | Normal/Visual | macOS/Win       | Open link under cursor or search visual selection                |
+| `Alt-k`           | Normal        | Linux/macOS/Win | Move current line or selected lines up                                   |
-| `ctrl-u`          | Insert        | Linux/macOS/Win | Turn word under cursor to upper case                             |
+| `Alt-j`           | Normal        | Linux/macOS/Win | Move current line or selected lines down                                 |
-| `ctrl-t`          | Insert        | Linux/macOS/Win | Turn word under cursor to title case                             |
+| `Alt-m`           | Normal        | macOS/Win       | Markdown previewing in system browser                                    |
-| `jk`              | Insert        | Linux/macOS/Win | Return to Normal mode without lagging                            |
+| `Alt-Shift-m`     | Normal        | macOS/Win       | Stopping Markdown previewing in system browser                           |
+| `ob`              | Normal/Visual | macOS/Win       | Open link under cursor or search visual selection                        |
+| `ctrl-u`          | Insert        | Linux/macOS/Win | Turn word under cursor to upper case                                     |
+| `ctrl-t`          | Insert        | Linux/macOS/Win | Turn word under cursor to title case                                     |
+| `jk`              | Insert        | Linux/macOS/Win | Return to Normal mode without lagging                                    |
 
-# Trouble shooting
+# Custom commands
 
-If you come across an issue, you can first use `:checkhealth` command provided
+In addition to commands provided by various plugins, I have also created some custom commands for personal use.
-by `nvim` to trouble-shoot yourself. Please read carefully the messages
+
-provided by health check.
+| command    | description                                                             | example                        |
+|------------|-------------------------------------------------------------------------|--------------------------------|
+| `Redir`    | capture command output to a tabpage for easier inspection.              | `Redir hi`                     |
+| `Edit`     | edit multiple files at the same time, supports globing                  | `Edit *.vim`                   |
+| `Datetime` | print current date and time or convert Unix time stamp to date and time | `Datetime 12345` or `Datetime` |
+
+# Contributing
+
+If you find anything that needs improving, do not hesitate to point it out or create a PR.
+
+If you come across an issue, you can first use `:checkhealth` command provided by `nvim` to trouble-shoot yourself.
+Please read carefully the messages provided by health check.
 
 If you still have an issue, [open a new issue](https://github.com/jdhao/nvim-config/issues).
 
 # Further readings
 
-Some of the resources that I find helpful in mastering Vim is documented [here](docs/vim_resources.md).
+Some of the resources that I find helpful in mastering Nvim is documented [here](docs/nvim_resources.md).
-You may also be interested in my post in configuring Vim on different platforms:
+You may also be interested in my posts on configuring Nvim:
 
++ My nvim notes can be found [here](https://jdhao.github.io/categories/Nvim/)
++ [Using Neovim for Three years](https://jdhao.github.io/2021/12/31/using_nvim_after_three_years/)
 + [Config nvim on Linux for Python development](https://jdhao.github.io/2018/12/24/centos_nvim_install_use_guide_en/)
 + [Nvim config on Windows 10](https://jdhao.github.io/2018/11/15/neovim_configuration_windows/)
 + [Nvim-qt config on Windows 10](https://jdhao.github.io/2019/01/17/nvim_qt_settings_on_windows/)
-+ My nvim notes can be found [here](https://jdhao.github.io/categories/Nvim/)
 
-<b id="f1">1:</b> Not enabled by default for Linux, see [this issue](https://github.com/jdhao/nvim-config/issues/4) on how to enable vimtex on Linux. [↩](#a1)
+<b id="f1">1:</b> Not enabled for Linux, you need to tweak [`lua/plugins.lua`](lua/plugins.lua) and change the condition for installing vimtex.[↩](#a1)

after/ftplugin/javascript.vim

@@ -0,0 +1,8 @@
+" Disable inserting comment leader after hitting o or O or <Enter>
+set formatoptions-=o
+set formatoptions-=r
+
+set tabstop=2       " number of visual spaces per TAB
+set softtabstop=2   " number of spaces in tab when editing
+set shiftwidth=2    " number of spaces to use for autoindent
+set expandtab       " expand tab to spaces so that tabs are spaces

after/ftplugin/lua.vim

@@ -6,3 +6,5 @@ set tabstop=2       " number of visual spaces per TAB
 set softtabstop=2   " number of spaces in tab when editing
 set shiftwidth=2    " number of spaces to use for autoindent
 set expandtab       " expand tab to spaces so that tabs are spaces
+
+nnoremap <silent> <F9> :luafile %<CR>

after/ftplugin/markdown.vim

@@ -45,3 +45,25 @@ function! AddListSymbol(type, ...) abort
     call setline(line, new_text)
   endfor
 endfunction
+
+" Add hard line breaks for Markdown
+nnoremap <buffer><silent> \ :set operatorfunc=AddLineBreak<CR>g@
+xnoremap <buffer><silent> \ :<C-U> call AddLineBreak(visualmode(), 1)<CR>
+
+function! AddLineBreak(type, ...) abort
+  if a:0
+    let line_start = line("'<")
+    let line_end = line("'>")
+  else
+    let line_start = line("'[")
+    let line_end = line("']")
+  endif
+
+  for line in range(line_start, line_end)
+    let text = getline(line)
+    " add backslash to each line
+    let new_text = text . "\\"
+
+    call setline(line, new_text)
+  endfor
+endfunction

after/ftplugin/tex.lua

@@ -0,0 +1,2 @@
+vim.o.textwidth = 120
+vim.o.wrap = true

after/ftplugin/tex.vim

@@ -1,3 +0,0 @@
-set textwidth=79
-
-set wrap

after/ftplugin/vim.vim

@@ -6,8 +6,7 @@ set formatoptions-=r
 " modeline is annoying in that the modeline get executed each time the window
 " focus is lost (see
 " https://github.com/tmux-plugins/vim-tmux-focus-events/issues/14)
-set foldmethod=expr foldlevel=0 foldlevelstart=-1
+set foldmethod=expr foldexpr=utils#VimFolds(v:lnum) foldtext=utils#MyFoldText()
-      \ foldexpr=utils#VimFolds(v:lnum) foldtext=utils#MyFoldText()
 
 " Use :help command for keyword when pressing `K` in vim file,
 " see `:h K` and https://stackoverflow.com/q/15867323/6064933
@@ -17,3 +16,5 @@ set tabstop=2       " number of visual spaces per TAB
 set softtabstop=2   " number of spaces in tab when editing
 set shiftwidth=2    " number of spaces to use for autoindent
 set expandtab       " expand tab to spaces so that tabs are spaces
+
+nnoremap <silent> <F9> :source %<CR>

autoload/utils.vim

@@ -131,9 +131,11 @@ function! utils#Get_titlestr() abort
   if g:is_linux
       let l:title_str = hostname() . '  '
   endif
-  let l:title_str = l:title_str . expand('%:p:~') . '  '
+
-  if &buflisted
+  let l:buf_path = expand('%:p:~')
-    let l:title_str = l:title_str . strftime('%Y-%m-%d %H:%M',getftime(expand('%')))
+  let l:title_str = l:title_str . l:buf_path . '  '
+  if &buflisted && l:buf_path != ""
+    let l:title_str = l:title_str . strftime('%Y-%m-%d %H:%M:%S%z', getftime(expand('%')))
   endif
 
   return l:title_str
@@ -174,13 +176,18 @@ endfunction
 " Redirect command output to a register for later processing.
 " Ref: https://stackoverflow.com/q/2573021/6064933 and https://unix.stackexchange.com/q/8101/221410 .
 function! utils#CaptureCommandOutput(command) abort
+  let l:tmp = @m
   redir @m
-  execute a:command
+  silent! execute a:command
   redir END
-  call v:lua.vim.notify("command output captured to register m", "info", {'title': 'nvim-config'})
+
   "create a scratch buffer for dumping the text, ref: https://vi.stackexchange.com/a/11311/15292.
   tabnew | setlocal buftype=nofile bufhidden=wipe nobuflisted noswapfile
-  call nvim_buf_set_lines(0, 0, 0, 0, [@m])
+
+  let l:lines = split(@m, '\n')
+  call nvim_buf_set_lines(0, 0, 0, 0, l:lines)
+
+  let @m = l:tmp
 endfunction
 
 " Edit all files matching the given patterns.
@@ -193,12 +200,12 @@ function! utils#MultiEdit(patterns) abort
 endfunction
 
 function! utils#add_pack(name) abort
-  let l:success = v:true
+  let l:status = v:true
   try
     execute printf("packadd! %s", a:name)
   catch /^Vim\%((\a\+)\)\=:E919/
-    let l:success = v:false
+    let l:status = v:false
   endtry
 
-  return l:success
+  return l:status
 endfunction

core/autocommands.vim

@@ -19,32 +19,27 @@ augroup accurate_syn_highlight
   autocmd BufEnter * :syntax sync fromstart
 augroup END
 
-" Return to last edit position when opening a file
+" Return to last cursor position when opening a file
-augroup resume_edit_position
+augroup resume_cursor_position
   autocmd!
-  autocmd BufReadPost *
+  autocmd BufReadPost * call s:resume_cursor_position()
-        \ if line("'\"") > 1 && line("'\"") <= line("$") && &ft !~# 'commit' | execute "normal! g`\"zvzz" | endif
 augroup END
 
-" Display a message when the current file is not in utf-8 format.
+" Only resume last cursor position when there is no go-to-line command (something like '+23').
-" Note that we need to use `unsilent` command here because of this issue:
+function s:resume_cursor_position() abort
-" https://github.com/vim/vim/issues/4379
+  if line("'\"") > 1 && line("'\"") <= line("$") && &ft !~# 'commit'
-augroup non_utf8_file_warn
+    let l:args = v:argv  " command line arguments
-  autocmd!
+    for l:cur_arg in l:args
-  " we can not use `lua vim.notify()`: it will error out E5107 parsing lua.
+      " Check if a go-to-line command is given.
-  autocmd BufRead * if &fileencoding != 'utf-8' | call v:lua.vim.notify('File not in UTF-8 format!', 'warn', {'title': 'nvim-config'}) | endif
+      let idx = match(l:cur_arg, '\v^\+(\d){1,}$')
-augroup END
+      if idx != -1
+        return
+      endif
+    endfor
 
-" Automatically reload the file if it is changed outside of Nvim, see
+    execute "normal! g`\"zvzz"
-" https://unix.stackexchange.com/a/383044/221410. It seems that `checktime`
+  endif
-" command does not work in command line. We need to check if we are in command
+endfunction
-" line before executing this command. See also
-" https://vi.stackexchange.com/a/20397/15292.
-augroup auto_read
-  autocmd!
-  autocmd FileChangedShellPost * call v:lua.vim.notify("File changed on disk. Buffer reloaded!", 'warn', {'title': 'nvim-config'})
-  autocmd FocusGained,CursorHold * if getcmdwintype() == '' | checktime | endif
-augroup END
 
 augroup numbertoggle
   autocmd!
@@ -70,15 +65,9 @@ function! s:custom_highlight() abort
   highlight FloatBorder guifg=LightGreen guibg=NONE
 
   " highlight for matching parentheses
-  highlight MatchParen cterm=bold,reverse,underline gui=bold,reverse,underline
+  highlight MatchParen cterm=bold,underline gui=bold,underline
 endfunction
 
-" highlight yanked region, see `:h lua-highlight`
-augroup highlight_yank
-  autocmd!
-  au TextYankPost * silent! lua vim.highlight.on_yank{higroup="YankColor", timeout=300, on_visual=false}
-augroup END
-
 augroup auto_close_win
   autocmd!
   autocmd BufEnter * call s:quit_current_win()
@@ -86,10 +75,22 @@ augroup END
 
 " Quit Nvim if we have only one window, and its filetype match our pattern.
 function! s:quit_current_win() abort
-  let quit_filetypes = ['qf', 'vista']
+  let l:quit_filetypes = ['qf', 'vista', 'NvimTree']
-  let buftype = getbufvar(bufnr(), '&filetype')
+
-  if winnr('$') == 1 && index(quit_filetypes, buftype) != -1
+  let l:should_quit = v:true
-    quit
+
+  let l:tabwins = nvim_tabpage_list_wins(0)
+  for w in l:tabwins
+    let l:buf = nvim_win_get_buf(w)
+    let l:bf = getbufvar(l:buf, '&filetype')
+
+    if index(l:quit_filetypes, l:bf) == -1
+      let l:should_quit = v:false
+    endif
+  endfor
+
+  if l:should_quit
+    qall
   endif
 endfunction
 
@@ -98,8 +99,25 @@ augroup git_repo_check
   autocmd VimEnter,DirChanged * call utils#Inside_git_repo()
 augroup END
 
-" Auto-generate packer_compiled.lua file
+" ref: https://vi.stackexchange.com/a/169/15292
-augroup packer_auto_compile
+function! s:handle_large_file() abort
+  let g:large_file = 10485760 " 10MB
+  let f = expand("<afile>")
+
+  if getfsize(f) > g:large_file || getfsize(f) == -2
+    set eventignore+=all
+    " turning off relative number helps a lot
+    set norelativenumber
+    setlocal noswapfile bufhidden=unload buftype=nowrite undolevels=-1
+  else
+    set eventignore-=all relativenumber
+  endif
+endfunction
+
+augroup LargeFile
   autocmd!
-  autocmd BufWritePost */nvim/lua/plugins.lua source <afile> | PackerCompile
+  autocmd BufReadPre * call s:handle_large_file()
 augroup END
+
+" Load auto-command defined in Lua
+lua require("custom-autocmd")

core/globals.vim

@@ -7,9 +7,6 @@ let g:logging_level = 'info'
 "}}
 
 "{{ Builtin variables
-" Disable Python2 support
-let g:loaded_python_provider = 0
-
 " Disable perl provider
 let g:loaded_perl_provider = 0
 
@@ -34,17 +31,26 @@ else
 endif
 
 " Custom mapping <leader> (see `:h mapleader` for more info)
-let mapleader = ','
+let g:mapleader = ','
 
 " Enable highlighting for lua HERE doc inside vim script
 let g:vimsyn_embed = 'l'
+
+" Use English as main language
+if !g:is_mac
+  language en_US.utf-8
+endif
+
+" use filetype.lua instead of filetype.vim
+let g:do_filetype_lua = 1
+let g:did_load_filetypes = 0
 "}}
 
 "{{ Disable loading certain plugins
 " Whether to load netrw by default, see
 " https://github.com/bling/dotvim/issues/4
-" let g:loaded_netrw       = 0
+let g:loaded_netrw       = 1
-" let g:loaded_netrwPlugin = 0
+let g:loaded_netrwPlugin = 1
 let g:netrw_liststyle = 3
 if g:is_win
   let g:netrw_http_cmd = 'curl --ssl-no-revoke -Lo'
@@ -65,4 +71,7 @@ let g:loaded_tutor_mode_plugin = 1  " do not load the tutor plugin
 let g:loaded_matchit = 1
 let g:loaded_matchparen = 1
 "}}
+
+" Disable sql omni completion, it is broken.
+let g:loaded_sql_completion = 1
 "}

core/mappings.vim

@@ -45,8 +45,6 @@ nnoremap <silent> \d :<C-U>bprevious <bar> bdelete #<CR>
 
 " Insert a blank line below or above current line (do not move the cursor),
 " see https://stackoverflow.com/a/16136133/6064933
-nnoremap oo :echo 'Please use <lt>space>o instead'<CR>
-nnoremap OO :echo 'Please use <lt>space>O instead'<CR>
 nnoremap <expr> <Space>o printf('m`%so<ESC>``', v:count1)
 nnoremap <expr> <Space>O printf('m`%sO<ESC>``', v:count1)
 
@@ -89,7 +87,7 @@ xnoremap > >gv
 inoremap <expr> <tab> pumvisible() ? "\<c-n>" : "\<tab>"
 inoremap <expr> <s-tab> pumvisible() ? "\<c-p>" : "\<s-tab>"
 
-" Edit and reload init.vim quickly
+" Edit and reload nvim config file quickly
 nnoremap <silent> <leader>ev :<C-U>tabnew $MYVIMRC <bar> tcd %:h<cr>
 nnoremap <silent> <leader>sv :<C-U>silent update $MYVIMRC <bar> source $MYVIMRC <bar>
       \ call v:lua.vim.notify("Nvim config successfully reloaded!", 'info', {'title': 'nvim-config'})<cr>
@@ -97,13 +95,12 @@ nnoremap <silent> <leader>sv :<C-U>silent update $MYVIMRC <bar> source $MYVIMRC
 " Reselect the text that has just been pasted, see also https://stackoverflow.com/a/4317090/6064933.
 nnoremap <expr> <leader>v printf('`[%s`]', getregtype()[0])
 
+" Always use very magic mode for searching
+nnoremap / /\v
+
 " Search in selected region
 xnoremap / :<C-U>call feedkeys('/\%>'.(line("'<")-1).'l\%<'.(line("'>")+1)."l")<CR>
 
-" Find and replace (like Sublime Text 3)
-nnoremap <C-H> :%s/
-xnoremap <C-H> :s/
-
 " Change current working directory locally and print cwd after that,
 " see https://vim.fandom.com/wiki/Set_working_directory_to_the_current_file
 nnoremap <silent> <leader>cd :<C-U>lcd %:p:h<CR>:pwd<CR>
@@ -170,6 +167,7 @@ onoremap <silent> iB :<C-U>call text_obj#Buffer()<CR>
 
 " Do not move my cursor when joining lines.
 nnoremap J mzJ`z
+nnoremap gJ mzgJ`z
 
 " Break inserted text into smaller undo units.
 for ch in [',', '.', '!', '?', ';', ':']
@@ -192,3 +190,6 @@ function! s:restore_cursor() abort
   silent! normal `y
   silent! delmarks y
 endfunction
+
+" for mappings defined in lua
+lua require('custom-map')

core/options.vim

@@ -112,6 +112,9 @@ set shortmess+=c
 " choice, IMHO.
 set shortmess+=S
 
+" Disable showing intro message (:intro)
+set shortmess+=I
+
 " Completion behaviour
 " set completeopt+=noinsert  " Auto select the first completion entry
 set completeopt+=menuone  " Show menu even if there is only one item
@@ -120,7 +123,7 @@ set completeopt-=preview  " Disable the preview window
 set pumheight=10  " Maximum number of items to show in popup menu
 set pumblend=10  " pseudo transparency for completion menu
 
-set winblend=5  " pseudo transparency for floating window
+set winblend=0  " pseudo transparency for floating window
 
 " Insert mode key word completion setting
 set complete+=kspell complete-=w complete-=b complete-=u complete-=t

core/plugins.vim

@@ -12,6 +12,10 @@ call utils#Cabbrev('pud', 'PackerUpdate')
 call utils#Cabbrev('pc', 'PackerClean')
 call utils#Cabbrev('ps', 'PackerSync')
 
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+"                      configurations for vim script plugin                  "
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+
 """""""""""""""""""""""""UltiSnips settings"""""""""""""""""""
 " Trigger configuration. Do not use <tab> if you use YouCompleteMe
 let g:UltiSnipsExpandTrigger='<c-j>'
@@ -27,25 +31,9 @@ let g:UltiSnipsJumpBackwardTrigger='<c-k>'
 " https://jdhao.github.io/2019/04/17/neovim_snippet_s1/ for details.
 let g:UltiSnipsSnippetDirectories=['UltiSnips', 'my_snippets']
 
-"""""""""""""""""""""""""" semshi settings """""""""""""""""""""""""""""""
-" Do not highlight for all occurrences of variable under cursor
-let g:semshi#mark_selected_nodes=0
-
-" Do not show error sign since linting plugin is specialized for that
-let g:semshi#error_sign=v:false
-
 """""""""""""""""""""""""" vlime settings """"""""""""""""""""""""""""""""
 command! -nargs=0 StartVlime call jobstart(printf("sbcl --load %s/vlime/lisp/start-vlime.lisp", g:package_home))
 
-""""""""""""""""""""""""""""" settings for nvim-hlslens"""""""""""""""
-noremap <silent> n <Cmd>execute('normal! ' . v:count1 . 'nzzzv')<CR>
-            \<Cmd>lua require('hlslens').start()<CR>
-noremap <silent> N <Cmd>execute('normal! ' . v:count1 . 'Nzzzv')<CR>
-            \<Cmd>lua require('hlslens').start()<CR>
-
-map *  <Plug>(asterisk-z*)<Cmd>lua require('hlslens').start()<CR>
-map #  <Plug>(asterisk-z#)<Cmd>lua require('hlslens').start()<CR>
-
 """""""""""""""""""""""""""""LeaderF settings"""""""""""""""""""""
 " Do not use cache file
 let g:Lf_UseCache = 0
@@ -68,7 +56,7 @@ if g:is_linux
 endif
 
 " Only fuzzy-search files names
-let g:Lf_DefaultMode = 'NameOnly'
+let g:Lf_DefaultMode = 'FullPath'
 
 " Popup window settings
 let w = float2nr(&columns * 0.8)
@@ -105,17 +93,15 @@ nnoremap <silent> <leader>fg :<C-U>Leaderf rg --no-messages --popup<CR>
 
 " Search vim help files
 nnoremap <silent> <leader>fh :<C-U>Leaderf help --popup<CR>
-nnoremap <silent> <leader>h :<C-U>echoerr "Use \<lt>leader>fh instead!"<CR>
 
 " Search tags in current buffer
 nnoremap <silent> <leader>ft :<C-U>Leaderf bufTag --popup<CR>
-nnoremap <silent> <leader>t :<C-U>echoerr "Use \<lt>leader>ft instead!"<CR>
 
 " Switch buffers
 nnoremap <silent> <leader>fb :<C-U>Leaderf buffer --popup<CR>
 
 " Search recent files
-nnoremap <silent> <leader>fr :<C-U>Leaderf mru --popup<CR>
+nnoremap <silent> <leader>fr :<C-U>Leaderf mru --popup --absolute-path<CR>
 
 let g:Lf_PopupColorscheme = 'gruvbox_material'
 
@@ -306,7 +292,6 @@ if ( g:is_win || g:is_mac ) && executable('latex')
   " Viewer settings for different platforms
   if g:is_win
     let g:vimtex_view_general_viewer = 'SumatraPDF'
-    let g:vimtex_view_general_options_latexmk = '-reuse-instance'
     let g:vimtex_view_general_options = '-reuse-instance -forward-search @tex @line @pdf'
   endif
 
@@ -386,9 +371,16 @@ if exists('g:started_by_firenvim') && g:started_by_firenvim
       \ }
   \ }
 
+  function! s:setup_firenvim() abort
+    set noruler noshowcmd
+    set laststatus=0 showtabline=0
+  endfunction
+
   augroup firenvim
     autocmd!
-    autocmd BufEnter *.txt setlocal filetype=markdown laststatus=0 nonumber noshowcmd noruler showtabline=1
+    autocmd FileType text call s:setup_firenvim()
+    autocmd BufNewFile github.com_*.txt set filetype=markdown
+    autocmd BufNewFile stackoverflow.com_*.txt set filetype=markdown
   augroup END
 endif
 
@@ -396,21 +388,17 @@ endif
 nnoremap <leader>dp :<C-U>GdbStartPDB python -m pdb %<CR>
 
 """"""""""""""""""""""""""""""wilder.nvim settings""""""""""""""""""""""""""""""
-augroup wilder_init
+call timer_start(250, { -> s:wilder_init() })
-  autocmd!
-  " CursorHold is suggested here: https: //github.com/gelguy/wilder.nvim/issues/89#issuecomment-934465957.
-  autocmd CursorHold * ++once call s:wilder_init()
-augroup END
 
 function! s:wilder_init() abort
   try
-    call wilder#enable_cmdline_enter()
+    call wilder#setup({
-    set wildcharm=<Tab>
+          \ 'modes': [':', '/', '?'],
-    cmap <expr> <Tab> wilder#in_context() ? wilder#next() : "\<Tab>"
+          \ 'next_key': '<Tab>',
-    cmap <expr> <S-Tab> wilder#in_context() ? wilder#previous() : "\<S-Tab>"
+          \ 'previous_key': '<S-Tab>',
-
+          \ 'accept_key': '<C-y>',
-    " only / and ? are enabled by default
+          \ 'reject_key': '<C-e>'
-    call wilder#set_option('modes', ['/', '?', ':'])
+          \ })
 
     call wilder#set_option('pipeline', [
           \   wilder#branch(
@@ -432,14 +420,18 @@ function! s:wilder_init() abort
     let l:hl = wilder#make_hl('WilderAccent', 'Pmenu', [{}, {}, {'foreground': '#f4468f'}])
     call wilder#set_option('renderer', wilder#popupmenu_renderer({
           \ 'highlighter': wilder#basic_highlighter(),
-          \ 'winblend': 5,
           \ 'max_height': 15,
           \ 'highlights': {
           \   'accent': l:hl,
           \ },
+          \ 'left': [' ', wilder#popupmenu_devicons(),],
+          \ 'right': [' ', wilder#popupmenu_scrollbar(),],
           \ 'apply_incsearch_fix': 0,
           \ }))
   catch /^Vim\%((\a\+)\)\=:E117/
     echohl Error |echomsg "Wilder.nvim missing: run :PackerSync to fix."|echohl None
   endtry
 endfunction
+
+""""""""""""""""""""""""""""""vim-auto-save settings""""""""""""""""""""""""""""""
+let g:auto_save = 1  " enable AutoSave on Vim startup

core/themes.vim

@@ -50,6 +50,17 @@ function! s:theme_setup_dict.nightfox() dict abort
   colorscheme nordfox
 endfunction
 
+function! s:theme_setup_dict.kanagawa() dict abort
+  colorscheme kanagawa
+endfunction
+
+function! s:theme_setup_dict.catppuccin() dict abort
+  let g:catppuccin_flavour = "frappe" " latte, frappe, macchiato, mocha
+
+  lua require("catppuccin").setup()
+  colorscheme catppuccin
+endfunction
+
 " Theme to directory name mapping, because theme repo name is not necessarily
 " the same as the theme name itself.
 let s:theme2dir = {
@@ -61,7 +72,9 @@ let s:theme2dir = {
       \ 'nord': 'nord.nvim',
       \ 'doom_one': 'doom-one.nvim',
       \ 'everforest' :'everforest',
-      \ 'nightfox': 'nightfox.nvim'
+      \ 'nightfox': 'nightfox.nvim',
+      \ 'kanagawa': 'kanagawa.nvim',
+      \ 'catppuccin': 'catppuccin'
       \ }
 
 let s:theme = utils#RandElement(keys(s:theme2dir))
@@ -73,14 +86,14 @@ if !has_key(s:theme_setup_dict, s:theme)
   finish
 endif
 
-let s:res = utils#add_pack(s:theme2dir[s:theme])
+let s:status = utils#add_pack(s:theme2dir[s:theme])
-if !s:res
+if !s:status
   echomsg printf("Theme %s not installed. Run PackerSync to install.", s:theme)
   finish
 endif
 
 execute 'call ' . s:colorscheme_func
 if g:logging_level == 'debug'
-  let s:msg1 = "Currently loaded theme: " . s:theme
+  let s:msg1 = "Colorscheme: " . s:theme
   call v:lua.vim.notify(s:msg1, 'info', {'title': 'nvim-config'})
 endif

docs/README.md

@@ -1,37 +1,81 @@
+This doc summarizes how to install and use this configuration in detail.
+
 # Pre-requisite
 
-There are a few dependencies if we want to use Nvim for efficient editing and
+## Terminal emulators
-development work.
 
-## Python
+Which [terminal emulator](https://en.wikipedia.org/wiki/Terminal_emulator) we choose to use greatly affects the appearance and features of Nvim.
+Since Nvim supports true colors, terminals that support true colors are preferred.
+For a list of terminals that support true colors, see [here](https://github.com/termstandard/colors).
 
-A lot of Nvim plugins are mainly written in Python. To use auto-completion and
+For macOS, we can use [kitty](https://sw.kovidgoyal.net/kitty/), [iterm2](https://www.iterm2.com/), [wezterm](https://wezfurlong.org/wezterm/) or [Alacritty](https://github.com/jwilm/alacritty).
-other features, we must install Python 3. The easiest way to install is via
-[Anaconda](https://www.anaconda.com/distribution/#download-section) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html). Make sure that
-you can run `python --version`, and that the output should be Python 3.x.
 
-## Pynvim
+If you ssh to Linux server on Windows, I recommend [wsltty](https://github.com/mintty/wsltty) and [Cygwin](https://www.cygwin.com/),
+both of them use [mintty](https://github.com/mintty/mintty) as the terminal emulator.
+For the latest version of Windows 10, you can also try [Windows Terminal](https://github.com/microsoft/terminal).
 
-Nvim relies on [pynvim](https://github.com/neovim/pynvim) to communicate with
+## Patched Fonts
-plugins that utilize its Python binding. Pynvim is required by plugins such as
+
-[Semshi](https://github.com/numirias/semshi).
+Since statusline or file explorer plugins often use Unicode symbols not available in normal font,
+we need to install a patched font from the [nerd-fonts](https://github.com/ryanoasis/nerd-fonts) project.
+
+# Automatic installation
+
+## Automatic Installation for Linux
+
+To set up a workable Nvim environment on Linux,
+I use [a bash script](nvim_setup_linux.sh) to automatically install necessary dependencies, Nvim itself and configs.
+
+Note that the variable `PYTHON_INSTALLED`, `SYSTEM_PYTHON` and `ADD_TO_SYSTEM_PATH` in the script
+should be set properly based on your environment.
+
+## Automatic installation for Windows
+
+Run the script [nvim_setup_windows.ps1](nvim_setup_windows.ps1) in PowerShell **with Administrator rights**:
+
+```
+.\docs\nvim_setup_windows.ps1
+```
+
+# Manual install
+
+There are a few dependencies if we want to use Nvim for efficient editing and development work.
+
+## Dependencies
+
+### Python
+
+A lot of Nvim plugins are mainly written in Python, so we must install Python 3.
+The easiest way to install is via [Anaconda](https://docs.anaconda.com/anaconda/install/index.html) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html).
+
+After installation, make sure that you can run `python --version`,
+and that the output should be Python 3.x.
+
+### Pynvim
+
+Nvim relies on [pynvim](https://github.com/neovim/pynvim) to communicate with plugins that utilize its Python binding.
+Pynvim is required by plugins such as [wilder.nvim](https://github.com/gelguy/wilder.nvim).
 
 ```
 pip install -U pynvim
 ```
 
-## python-lsp-server
+### python-lsp-server
 
-[python-lsp-server](https://github.com/python-lsp/python-lsp-server) is the community-fork of [pyls](https://github.com/palantir/python-language-server), and it is a Python Language Server for completion,
+[python-lsp-server (pylsp)](https://github.com/python-lsp/python-lsp-server) is a Python [Language Server](https://microsoft.github.io/language-server-protocol/) for completion, linting, go to definition, etc.
-linting, go to definition, etc.
 
 ```
 pip install 'python-lsp-server[all]' pylsp-mypy pyls-isort
 ```
 
-## Node
+Note the executable for pylsp is also named `pylsp`. You need to set its PATH correctly.
+If you use pip from Anaconda, the executable path may be something like `$CONDA_ROOT/bin/pylsp`.
+For native python, the path for pylsp may be like `$HOME/.local/bin/pylsp`
 
-We need to install node.js from [here](https://nodejs.org/en/download/):
+### Node
+
+We need to install node.js from [here](https://nodejs.org/en/download/).
+For Linux, you can use the following script:
 
 ```bash
 # Ref: https://johnpapa.net/node-and-npm-without-sudo/
@@ -55,32 +99,31 @@ source ~/.bash_profile
 # source ~/.zshrc
 ```
 
-## vim-language-server
+### vim-language-server
 
-[vim-language-server](https://github.com/iamcco/vim-language-server) provides
+[vim-language-server](https://github.com/iamcco/vim-language-server) provides completion for vim script. We can install vim-language-server globally:
-completion for vim script. We can install vim-language-server globally and set
-its path:
 
 ```bash
 npm install -g vim-language-server
-
-export PATH="$HOME/.npm-packages/bin:$PATH"
 ```
 
-## Git
+vim-language-server is installed in the same directory as the node executable.
 
-Git is used by the plugin manager [packer.nvim](https://github.com/wbthomason/packer.nvim) to clone plugins from GitHub or
+### Git
-other Git repositories.
 
-Since Git is usually pre-installed on Linux and macOS, we do not need to worry
+Git is required by plugin manager [packer.nvim](https://github.com/wbthomason/packer.nvim) and other git-related plugins.
-if we are on these two platforms. For Windows, install [Git for Windows](https://git-scm.com/download/win)
-and make sure you can call `git` from the command line.
 
-## ctags
+For Linux and macOS, Git is usually pre-installed.
+The version of Git on the Linux system may be too old so that plugins may break.
+Check [here](https://jdhao.github.io/2021/03/27/upgrade_git_on_linux/) on how to install and set up the latest version of Git.
+For Windows, install [Git for Windows](https://git-scm.com/download/win) and make sure you can run `git` from command line.
 
-In order to use tags related plugins such as [vista.vim](https://github.com/liuchengxu/vista.vim), we need to
+### ctags
-install a ctags distribution. Universal-ctags is preferred.
 
+In order to use tags related plugins such as [vista.vim](https://github.com/liuchengxu/vista.vim), we need to install a ctags distribution.
+Universal-ctags is preferred.
+
+To install it on Linux, we need to build it from source. See [here](https://askubuntu.com/a/836521/768311) for the details.
 To install ctags on macOS, use [Homebrew](https://github.com/universal-ctags/homebrew-universal-ctags):
 
 ```bash
@@ -93,134 +136,99 @@ To install it Windows, use [chocolatey](https://chocolatey.org/) or [scoop](http
 choco install universal-ctags
 
 # scoop bucket add extras
-# scoop install univeral-ctags
+# scoop install universal-ctags
 ```
 
-To install it on Linux, we need to build it from source. See [here](https://askubuntu.com/a/836521/768311)
+Set its PATH properly and make sure you can run `ctags` from command line.
-for the details.
 
-Set its PATH properly and make sure you can call `ctags` from command line.
+### Ripgrep
 
-## Ripgrep
+[Ripgrep](https://github.com/BurntSushi/ripgrep), aka, `rg`, is a fast grepping tool available for both Linux, Windows and macOS.
+It is used by several searching plugins.
 
-[Ripgrep](https://github.com/BurntSushi/ripgrep), aka, `rg`, is a fast grepping
+For Windows and macOS, we can install it via chocolatey and homebrew respectively.
-tool available for both Linux, Windows and macOS. It is used by several
+For Linux, we can download the [binary release](https://github.com/BurntSushi/ripgrep/releases) and install it.
-searching plugins.
 
-For Windows and macOS, we can install it via chocolatey and homebrew
+Set its PATH properly and make sure you can run `rg` from command line.
-respectively. For Linux, we can download the executable file from its [release
-page](https://github.com/BurntSushi/ripgrep/releases) and install it.
 
-## Linters
+### Linters
 
-A linter is a tool to check the source code for possible style and syntax
+A linter is a tool to check the source code for possible style and syntax issues.
-issues. Based on the programming languages we use, we may need to install
+Based on the programming languages we use, we may need to install various linters.
-various linters.
 
 + Python: [pylint](https://github.com/PyCQA/pylint) and [flake8](https://github.com/PyCQA/flake8).
 + Vim script: [vint](https://github.com/Kuniwak/vint).
 
-## Terminal emulators
+Set their PATH properly and make sure you can run `pylint`, `flake8` and `vint` from command line.
 
-Which [terminal emulator](https://en.wikipedia.org/wiki/Terminal_emulator) we
+## Install Nvim
-choose to use greatly affects the appearance and functionalities of Nvim.
-Since Nvim supports true colors, terminals that support true colors are
-preferred. For a list of terminals that support true colors, see [here](https://github.com/termstandard/colors).
 
-For macOS, we can use [kitty](https://sw.kovidgoyal.net/kitty/), [iterm2](https://www.iterm2.com/), or [Alacritty](https://github.com/jwilm/alacritty).
+There are various ways to install Nvim depending on your system.
-If you connect to Linux server on Windows, I recommend [wsltty](https://github.com/mintty/wsltty) and
+This config is only maintained for [the latest nvim stable release](https://github.com/neovim/neovim/releases/tag/stable).
-[Cygwin](https://www.cygwin.com/), both of them use [mintty](https://github.com/mintty/mintty) as the terminal emulator.
 
-For the latest version of Windows 10, you can also try the new [Windows
+### Linux
-Terminal](https://github.com/microsoft/terminal).
 
-## Font
+You can directly download the binary release from [here](https://github.com/neovim/neovim/releases/download/stable/nvim-linux64.tar.gz).
+You can also use the system package manager to install nvim,
+but that is not reliable since the latest version may not be available.
 
-Since statusline or file explorer plugins often use Unicode symbols not
+### Windows
-available in normal font, we need to install a patched font from the [nerd-fonts](https://github.com/ryanoasis/nerd-fonts) project.
 
-# Install Nvim
+You may download from [nvim release](https://github.com/neovim/neovim/releases/download/stable/nvim-win64.zip) from GitHub and manually extract it.
 
-There are various ways to install Nvim depending on your system. Current
+Another way to install Nvim on Windows is via chocolatey or scoop:
-configuration is tested against nvim v0.6.0.
-
-## Linux
-
-We can directly download the binary release from [here](https://github.com/neovim/neovim/releases/download/v0.6.0/nvim-linux64.tar.gz).
-
-## Windows
-
-The easiest way to install Nvim on Windows is via chocolatey:
 
 ```
 choco install neovim
+
+# via scoop
+# scoop bucket add versions
+# scoop install neovim
 ```
 
-You may download from [nvim release](https://github.com/neovim/neovim/releases/download/v0.6.0/nvim-win64.zip) from GitHub and manually extract it.
+### macOS
 
-## macOS
+It is recommended to install neovim via [Homebrew](https://brew.sh/) on macOS. Simply run the following command:
-
-It is recommended to install neovim via [Homebrew](https://brew.sh/) on macOS.
-Simply run the following command:
 
 ```bash
 brew install neovim
 ```
 
-After installing Nvim, we need to add the directory where the Nvim executable
+After installing Nvim, we need to set the path to nvim correctly.
-(`nvim` on Linux and macOS, `nvim.exe` on Windows) resides to the system `PATH`.
+**Make sure that you can run `nvim` from the command line after all these setups**.
 
-Make sure that you can call `nvim` from the command line after all these
+## Setting up Nvim
-setups.
 
-# Setting up Nvim
+After installing nvim and all the dependencies, we will install plugin managers and set up this config.
 
-## Install plugin manager packer.nvim
+### Install plugin manager packer.nvim
 
-I use packer.nvim to manage my plugins. We need to install packer.nvim on our
+I use packer.nvim to manage my plugins. We need to install packer.nvim on our system first.
-system first.
 
-For Windows, if curl is installed, use the following command (on PowerShell):
+For Windows, if curl is installed, run the following command (on PowerShell):
 
 ```
 git clone --depth=1 https://github.com/wbthomason/packer.nvim "$env:LOCALAPPDATA\nvim-data\site\pack\packer\opt\packer.nvim"
 ```
 
-For macOS and Linux, use the following command:
+For macOS and Linux, run the following command:
 
 ```bash
 git clone --depth=1 https://github.com/wbthomason/packer.nvim ~/.local/share/nvim/site/pack/packer/opt/packer.nvim
 ```
 
-## How to install this configuration
+### How to install this configuration
 
-On Windows, the config directory is `$HOME/AppData/Local/nvim`[^1]. On Linux
+On Linux and macOS, the directory is `~/.config/nvim`.
-and macOS, the directory is `~/.config/nvim`. First, we need to remove all the
+On Windows, the config directory is `$HOME/AppData/Local/nvim`[^1].
-files under the config directory (including dot files), then go to this
+First, we need to remove all the files under the config directory (including dot files),
-directory, and run the following command to install this configuration:
+then go to this directory, and run the following command:
 
 ```
 git clone --depth=1 https://github.com/jdhao/nvim-config.git .
 ```
 
-After that, when we first open nvim, run command `:PackerSync` to install all
+After that, when we first open nvim, run command `:PackerSync` to install all the plugins.
-the plugins and generate `packer_compiled.lua`. Since I use quite a lot of
+Since I use quite a lot of plugins (more than 60), it may take some time to install all of them.
-plugins (more than 60), it may take some time to install all of them, depending
-on your network condition.
-
-# Automatic installation
-
-## Automatic Installation for Linux #
-
-To set up a workable Nvim environment on Linux, I use [this bash script](nvim_setup_linux.sh) to automatically install necessary
-dependencies, Nvim itself and Nvim configs in this repo.
-
-Note that the variable `PYTHON_INSTALLED`, `SYSTEM_PYTHON` and
-`ADD_TO_SYSTEM_PATH` in the script should be set properly based on your
-environment.
-
-## Automatic installation for Windows
-
-Run script [nvim_setup_windows.ps1](nvim_setup_windows.ps1) under PowerShell.
 
 [^1]: Use `echo %userprofile%` to see where your `$HOME` is.

docs/nvim_install_mac.sh

@@ -2,15 +2,16 @@
 #!/bin/bash
 set -eux
 
-wget https://github.com/neovim/neovim/releases/download/v0.6.0/nvim-macos.tar.gz
+wget https://github.com/neovim/neovim/releases/download/stable/nvim-macos.tar.gz
 
 if [[ ! -d "$HOME/tools/"  ]]; then
     mkdir -p "$HOME/tools"
 fi
 
 # Delete existing nvim installation.
-if [[ -d "$HOME/tools/nvim-osx64" ]]; then
+# For newer release, the directory name is nvim-macos
-    rm -rf "$HOME/tools/nvim-osx64"
+if [[ -d "$HOME/tools/nvim-macos" ]]; then
+    rm -rf "$HOME/tools/nvim-macos"
 fi
 
 # Extract the tar ball

docs/nvim_setup_linux.sh

@@ -34,11 +34,11 @@ fi
 if [[ "$INSTALL_ANACONDA" = true ]]; then
     CONDA_DIR=$HOME/tools/anaconda
     CONDA_NAME=Anaconda.sh
-    CONDA_LINK="https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-2021.05-Linux-x86_64.sh"
+    CONDA_LINK="https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-2021.11-Linux-x86_64.sh"
 else
     CONDA_DIR=$HOME/tools/miniconda
     CONDA_NAME=Miniconda.sh
-    CONDA_LINK="https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-latest-Linux-x86_64.sh"
+    CONDA_LINK="https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-py39_4.10.3-Linux-x86_64.sh"
 fi
 
 if [[ ! "$PYTHON_INSTALLED" = true ]]; then
@@ -87,21 +87,21 @@ else
 fi
 
 #######################################################################
-#                Install node and vim-language-server                 #
+#                Install node and js-based language server            #
 #######################################################################
 NODE_DIR=$HOME/tools/nodejs
 NODE_SRC_NAME=$HOME/packages/nodejs.tar.gz
 # when download speed is slow, we can also use its mirror site: https://mirrors.ustc.edu.cn/node/v15.0.0/
 NODE_LINK="https://mirrors.ustc.edu.cn/node/v15.0.0/node-v15.0.0-linux-x64.tar.xz"
 if [[ -z "$(command -v node)" ]]; then
-    echo "Install Nodejs"
+    echo "Install Node.js"
     if [[ ! -f $NODE_SRC_NAME ]]; then
-        echo "Downloading nodejs and renaming"
+        echo "Downloading Node.js and renaming"
         wget $NODE_LINK -O "$NODE_SRC_NAME"
     fi
 
     if [[ ! -d "$NODE_DIR" ]]; then
-        echo "Creating nodejs directory under tools directory"
+        echo "Creating Node.js directory under tools directory"
         mkdir -p "$NODE_DIR"
         echo "Extracting to $HOME/tools/nodejs directory"
         tar xvf "$NODE_SRC_NAME" -C "$NODE_DIR" --strip-components 1
@@ -111,18 +111,50 @@ if [[ -z "$(command -v node)" ]]; then
         echo "export PATH=\"$NODE_DIR/bin:\$PATH\"" >> "$HOME/.bash_profile"
     fi
 else
-    echo "Nodejs is already installed. Skip installing it."
+    echo "Node.js is already installed. Skip installing it."
 fi
 
 # Install vim-language-server
 "$NODE_DIR/bin/npm" install -g vim-language-server
 
+# Install bash-language-server
+"$NODE_DIR/bin/npm" install -g bash-language-server
+
+#######################################################################
+#                         lua-language-server                         #
+#######################################################################
+SUMNEKO_LUA_DIR=$HOME/tools/lua-language-server
+SUMNEKO_LUA_SRC_NAME=$HOME/packages/lua-language-server.tar.gz
+SUMNEKO_LUA_LINK="https://github.com/sumneko/lua-language-server/releases/download/3.5.3/lua-language-server-3.5.3-linux-x64.tar.gz"
+
+if [[ -z "$(command -v lua-language-server)" ]] && [[ ! -f "$SUMNEKO_LUA_DIR/bin/lua-language-server" ]]; then
+    echo 'Install lua-language-server'
+    if [[ ! -f $SUMNEKO_LUA_SRC_NAME ]]; then
+        echo "Downloading lua-language-server and renaming"
+        wget $SUMNEKO_LUA_LINK -O "$SUMNEKO_LUA_SRC_NAME"
+    fi
+
+    if [[ ! -d "$SUMNEKO_LUA_DIR" ]]; then
+        echo "Creating lua-language-server directory under tools directory"
+        mkdir -p "$SUMNEKO_LUA_DIR"
+        echo "Extracting to directory $SUMNEKO_LUA_DIR"
+
+        tar zxvf "$SUMNEKO_LUA_SRC_NAME" -C "$SUMNEKO_LUA_DIR"
+    fi
+
+    if [[ "$ADD_TO_SYSTEM_PATH" = true ]] && [[ "$USE_BASH_SHELL" = true ]]; then
+        echo "export PATH=\"$SUMNEKO_LUA_DIR/bin:\$PATH\"" >> "$HOME/.bash_profile"
+    fi
+else
+    echo "lua-language-server is already installed. Skip installing it."
+fi
+
 #######################################################################
 #                            Ripgrep part                             #
 #######################################################################
 RIPGREP_DIR=$HOME/tools/ripgrep
 RIPGREP_SRC_NAME=$HOME/packages/ripgrep.tar.gz
-RIPGREP_LINK="https://hub.fastgit.org/BurntSushi/ripgrep/releases/download/12.0.0/ripgrep-12.0.0-x86_64-unknown-linux-musl.tar.gz"
+RIPGREP_LINK="https://github.com/BurntSushi/ripgrep/releases/download/12.0.0/ripgrep-12.0.0-x86_64-unknown-linux-musl.tar.gz"
 if [[ -z "$(command -v rg)" ]] && [[ ! -f "$RIPGREP_DIR/rg" ]]; then
     echo "Install ripgrep"
     if [[ ! -f $RIPGREP_SRC_NAME ]]; then
@@ -142,8 +174,8 @@ if [[ -z "$(command -v rg)" ]] && [[ ! -f "$RIPGREP_DIR/rg" ]]; then
     fi
 
     # set up manpath and zsh completion for ripgrep
-    mkdir -p $HOME/tools/ripgrep/doc/man/man1
+    mkdir -p "$HOME/tools/ripgrep/doc/man/man1"
-    mv $HOME/tools/ripgrep/doc/rg.1 $HOME/tools/ripgrep/doc/man/man1
+    mv "$HOME/tools/ripgrep/doc/rg.1" "$HOME/tools/ripgrep/doc/man/man1"
 
     if [[ "$USE_BASH_SHELL" = true ]]; then
         echo 'export MANPATH=$HOME/tools/ripgrep/doc/man:$MANPATH' >> "$HOME/.bash_profile"
@@ -160,7 +192,7 @@ fi
 #######################################################################
 CTAGS_SRC_DIR=$HOME/packages/ctags
 CTAGS_DIR=$HOME/tools/ctags
-CTAGS_LINK="https://hub.fastgit.org/universal-ctags/ctags.git"
+CTAGS_LINK="https://github.com/universal-ctags/ctags.git"
 if [[ ! -f "$CTAGS_DIR/bin/ctags" ]]; then
     echo "Install ctags"
 
@@ -188,7 +220,7 @@ fi
 NVIM_DIR=$HOME/tools/nvim
 NVIM_SRC_NAME=$HOME/packages/nvim-linux64.tar.gz
 NVIM_CONFIG_DIR=$HOME/.config/nvim
-NVIM_LINK="https://github.com/neovim/neovim/releases/download/v0.6.0/nvim-linux64.tar.gz"
+NVIM_LINK="https://github.com/neovim/neovim/releases/download/stable/nvim-linux64.tar.gz"
 if [[ ! -f "$NVIM_DIR/bin/nvim" ]]; then
     echo "Installing Nvim"
     echo "Creating nvim directory under tools directory"
@@ -216,11 +248,13 @@ if [[ -d "$NVIM_CONFIG_DIR" ]]; then
     mv "$NVIM_CONFIG_DIR" "$NVIM_CONFIG_DIR.backup"
 fi
 
-git clone --depth=1 https://hub.fastgit.org/jdhao/nvim-config.git "$NVIM_CONFIG_DIR"
+git clone --depth=1 https://github.com/jdhao/nvim-config.git "$NVIM_CONFIG_DIR"
 
 echo "Installing packer.nvim"
-git clone --depth=1 https://hub.fastgit.org/wbthomason/packer.nvim \
+if [[ ! -d ~/.local/share/nvim/site/pack/packer/opt/packer.nvim ]]; then
-    ~/.local/share/nvim/site/pack/packer/opt/packer.nvim
+    git clone --depth=1 https://github.com/wbthomason/packer.nvim \
+        ~/.local/share/nvim/site/pack/packer/opt/packer.nvim
+fi
 
 echo "Installing nvim plugins, please wait"
 "$NVIM_DIR/bin/nvim" -c "autocmd User PackerComplete quitall" -c "PackerSync"

docs/nvim_setup_windows.ps1

@@ -1,6 +1,8 @@
-# Install scoop
+# Set policy to avoid errors
 Set-ExecutionPolicy RemoteSigned -scope CurrentUser
-iwr -useb get.scoop.sh | iex
+
+# Install scoop
+Invoke-WebRequest -UseBasicParsing get.scoop.sh | Invoke-Expression
 
 # Install node
 scoop install nodejs
@@ -15,7 +17,10 @@ scoop install universal-ctags
 # Install vim-language-server
 npm install -g vim-language-server
 
-# Install miniconda3
+# Install bash-language-server
+npm install -g bash-language-server
+
+# Install miniconda3 (for Python)
 scoop install miniconda3
 
 # Install pynvim
@@ -24,6 +29,27 @@ pip install -U pynvim
 # Install python-language-server
 pip install 'python-lsp-server[all]' pylsp-mypy pyls-isort
 
+# Install visual c++ redistribution
+scoop install vcredist2022
+
+# Install 7zip
+scoop install 7zip
+
+# Install lua-language-server
+$sumneko_lua_link = "https://github.com/sumneko/lua-language-server/releases/download/3.5.3/lua-language-server-3.5.3-win32-x64.zip"
+$sumneko_lua_install_dir = "D:\portable_tools"
+$sumneko_lua_src_dir = "$sumneko_lua_install_dir\lua-language-server.zip"
+$sumneko_lua_dir = "$sumneko_lua_install_dir\lua-language-server"
+
+# Download file, ref: https://stackoverflow.com/a/51225744/6064933
+Invoke-WebRequest $sumneko_lua_link -OutFile "$sumneko_lua_src_dir"
+
+# Extract the zip file using 7zip, ref: https://stackoverflow.com/a/41933215/6064933
+7z x "$sumneko_lua_src_dir" -o"$sumneko_lua_dir"
+
+# Setup PATH env variable, ref: https://stackoverflow.com/q/714877/6064933
+[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$sumneko_lua_dir\bin", "Machine")
+
 # Install neovim nightly
 scoop bucket add versions
-scoop install neovim-nightly
+scoop install neovim

ginit.vim

@@ -3,6 +3,9 @@ inoremap <silent> <S-Insert>  <C-R>+
 cnoremap <S-Insert> <C-R>+
 nnoremap <silent> <C-6> <C-^>
 
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+"                          config for nvim-qt                          "
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 " To check if neovim-qt is running, use `exists('g:GuiLoaded')`,
 " see https://github.com/equalsraf/neovim-qt/issues/219
 if exists('g:GuiLoaded')
@@ -13,6 +16,9 @@ if exists('g:GuiLoaded')
   GuiFont! Hack\ NF:h10:l
 endif
 
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+"                           config for fvim                            "
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 if exists('g:fvim_loaded')
   set termguicolors
   colorscheme gruvbox8_hard

init.lua

@@ -0,0 +1,37 @@
+-- This is my personal Nvim configuration supporting Mac, Linux and Windows, with various plugins configured.
+-- This configuration evolves as I learn more about Nvim and become more proficient in using Nvim.
+-- Since it is very long (more than 1000 lines!), you should read it carefully and take only the settings that suit you.
+-- I would not recommend cloning this repo and replace your own config. Good configurations are personal,
+-- built over time with a lot of polish.
+--
+-- Author: Jie-dong Hao
+-- Email: jdhao@hotmail.com
+-- Blog: https://jdhao.github.io/
+
+  -- check if we have the latest stable version of nvim
+local expected_ver = "0.7.2"
+
+local utils = require "utils"
+local nvim_ver = utils.get_nvim_version()
+
+if nvim_ver ~= expected_ver then
+  local msg = string.format("Unsupported nvim version: expect %s, but got %s instead!", expected_ver, nvim_ver)
+  vim.api.nvim_echo({ { msg, "ErrorMsg" } }, false, {})
+  return
+end
+
+local core_conf_files = {
+  "globals.vim",
+  "options.vim",
+  "autocommands.vim",
+  "mappings.vim",
+  "plugins.vim",
+  "themes.vim",
+}
+
+-- source all the core config files
+for _, name in ipairs(core_conf_files) do
+  local path = string.format("%s/core/%s", vim.fn.stdpath('config'), name)
+  local source_cmd = "source " .. path
+  vim.cmd(source_cmd)
+end

init.vim

@@ -1,26 +0,0 @@
-"{ Header info
-" Description: This is my personal Nvim configuration supporting Mac, Linux
-" and Windows, with various plugins configured. This configuration evolves as
-" I learn more about Nvim and becomes more proficient in using Nvim. Since it
-" is very long (more than 1000 lines!), you should read it carefully and take
-" only the settings and options that suits you. I would not recommend cloning
-" this repo and replace your own config. Good configurations are personal,
-" built over time with a lot of polish.
-" Author: Jie-dong Hao
-" Email: jdhao@hotmail.com
-"}
-
-"{ Main configurations
-let g:config_files = [
-      \ 'globals.vim',
-      \ 'options.vim',
-      \ 'autocommands.vim',
-      \ 'mappings.vim',
-      \ 'plugins.vim',
-      \ 'themes.vim'
-      \ ]
-
-for s:fname in g:config_files
-  execute printf('source %s/core/%s', stdpath('config'), s:fname)
-endfor
-"}

lua/config/alpha-nvim.lua

@@ -1,31 +0,0 @@
-local alpha = require("alpha")
-local dashboard = require("alpha.themes.dashboard")
-
--- Set header
-dashboard.section.header.val = {
-    "                                                     ",
-    "  ███╗   ██╗███████╗ ██████╗ ██╗   ██╗██╗███╗   ███╗ ",
-    "  ████╗  ██║██╔════╝██╔═══██╗██║   ██║██║████╗ ████║ ",
-    "  ██╔██╗ ██║█████╗  ██║   ██║██║   ██║██║██╔████╔██║ ",
-    "  ██║╚██╗██║██╔══╝  ██║   ██║╚██╗ ██╔╝██║██║╚██╔╝██║ ",
-    "  ██║ ╚████║███████╗╚██████╔╝ ╚████╔╝ ██║██║ ╚═╝ ██║ ",
-    "  ╚═╝  ╚═══╝╚══════╝ ╚═════╝   ╚═══╝  ╚═╝╚═╝     ╚═╝ ",
-    "                                                     ",
-}
-
--- Set menu
-dashboard.section.buttons.val = {
-    dashboard.button( "Leader f f", "  > Find file", ":Leaderf file --popup<CR>"),
-    dashboard.button( "Leader f r", "  > Recent files"   , ":Leaderf mru --popup<CR>"),
-    dashboard.button( "Leader f g", "  > Project grep" , ":Leaderf rg --popup<CR>"),
-    dashboard.button( "e", "  > New file" , ":enew <CR>"),
-    dashboard.button( "q", "  > Quit NVIM", ":qa<CR>"),
-}
-
-local fortune = require("alpha.fortune")
-dashboard.section.footer.val = fortune()
-
-alpha.setup(dashboard.opts)
-
--- Send config to alpha
-alpha.setup(dashboard.opts)

lua/config/autosave.lua

@@ -1,15 +0,0 @@
-require("autosave").setup({
-	enabled = true,
-	execution_message = "Autosaved at " .. vim.fn.strftime("%H:%M:%S"),
-	events = { "InsertLeave", "TextChanged" },
-	conditions = {
-		exists = true,
-		filename_is_not = {"plugins.lua"},
-		filetype_is_not = {},
-		modifiable = true,
-	},
-	write_all_buffers = false,
-	on_off_commands = true,
-	clean_command_line_interval = 1000,
-	debounce_delay = 135,
-})

lua/config/dashboard-nvim.lua

@@ -0,0 +1,65 @@
+local dashboard = require("dashboard")
+
+dashboard.custom_header = {
+  "                                                       ",
+  "                                                       ",
+  "                                                       ",
+  " ███╗   ██╗ ███████╗ ██████╗  ██╗   ██╗ ██╗ ███╗   ███╗",
+  " ████╗  ██║ ██╔════╝██╔═══██╗ ██║   ██║ ██║ ████╗ ████║",
+  " ██╔██╗ ██║ █████╗  ██║   ██║ ██║   ██║ ██║ ██╔████╔██║",
+  " ██║╚██╗██║ ██╔══╝  ██║   ██║ ╚██╗ ██╔╝ ██║ ██║╚██╔╝██║",
+  " ██║ ╚████║ ███████╗╚██████╔╝  ╚████╔╝  ██║ ██║ ╚═╝ ██║",
+  " ╚═╝  ╚═══╝ ╚══════╝ ╚═════╝    ╚═══╝   ╚═╝ ╚═╝     ╚═╝",
+  "                                                       ",
+  "                                                       ",
+  "                                                       ",
+  "                                                       ",
+}
+
+dashboard.custom_center = {
+  {
+    icon = "  ",
+    desc = "Find  File                              ",
+    action = "Leaderf file --popup",
+    shortcut = "<Leader> f f",
+  },
+  {
+    icon = "  ",
+    desc = "Recently opened files                   ",
+    action = "Leaderf mru --popup",
+    shortcut = "<Leader> f r",
+  },
+  {
+    icon = "  ",
+    desc = "Project grep                            ",
+    action = "Leaderf rg --popup",
+    shortcut = "<Leader> f g",
+  },
+  {
+    icon = "  ",
+    desc = "Open Nvim config                        ",
+    action = "tabnew $MYVIMRC | tcd %:p:h",
+    shortcut = "<Leader> e v",
+  },
+  {
+    icon = "  ",
+    desc = "New file                                ",
+    action = "enew",
+    shortcut = "e           ",
+  },
+  {
+    icon = "  ",
+    desc = "Quit Nvim                               ",
+    -- desc = "Quit Nvim                               ",
+    action = "qa",
+    shortcut = "q           "
+  }
+}
+
+vim.cmd([[
+  augroup dashboard_enter
+    au!
+    autocmd FileType dashboard nnoremap <buffer> q :qa<CR>
+    autocmd FileType dashboard nnoremap <buffer> e :enew<CR>
+  augroup END
+]])

lua/config/fidget-nvim.lua

@@ -0,0 +1 @@
+require"fidget".setup{}

lua/config/hlslens.lua

@@ -0,0 +1,34 @@
+require('hlslens').setup({
+    calm_down = true,
+    nearest_only = true,
+})
+
+local activate_hlslens = function(direction)
+  local cmd = string.format("normal! %s%szzzv", vim.v.count1, direction)
+  local status, msg = pcall(vim.fn.execute, cmd)
+  -- 13 is the index where real error message starts
+  msg = msg:sub(13)
+
+  if not status then
+    vim.api.nvim_echo({{msg, "ErrorMsg"}}, false, {})
+    return
+  end
+  require('hlslens').start()
+end
+
+vim.keymap.set('n', 'n', '',
+{
+  noremap = true,
+  silent = true,
+  callback = function() activate_hlslens('n') end
+})
+
+vim.keymap.set('n', 'N', '',
+{
+  noremap = true,
+  silent = true,
+  callback = function() activate_hlslens('N') end
+})
+
+vim.keymap.set('n', '*', "<Plug>(asterisk-z*)<Cmd>lua require('hlslens').start()<CR>", { silent = true })
+vim.keymap.set('n', '#', "<Plug>(asterisk-z#)<Cmd>lua require('hlslens').start()<CR>", { silent = true })

lua/config/lsp.lua

@@ -1,58 +1,66 @@
+local fn = vim.fn
 local api = vim.api
 local lsp = vim.lsp
 
-local M = {}
+local utils = require("utils")
-
-function M.show_line_diagnostics()
-  local opts = {
-    focusable = false,
-    close_events = { "BufLeave", "CursorMoved", "InsertEnter", "FocusLost" },
-    border = 'rounded',
-    source = 'always',  -- show source in diagnostic popup window
-    prefix = ' '
-  }
-  vim.diagnostic.open_float(nil, opts)
-end
 
 local custom_attach = function(client, bufnr)
-  local function buf_set_keymap(...)
-    api.nvim_buf_set_keymap(bufnr, ...)
-  end
-
   -- Mappings.
-  local opts = { noremap = true, silent = true }
+  local opts = { silent = true, buffer = bufnr }
-  buf_set_keymap("n", "gd", "<Cmd>lua vim.lsp.buf.definition()<CR>", opts)
+  vim.keymap.set("n", "gd", vim.lsp.buf.definition, opts)
-  buf_set_keymap("n", "<C-]>", "<Cmd>lua vim.lsp.buf.definition()<CR>", opts)
+  vim.keymap.set("n", "<C-]>", vim.lsp.buf.definition, opts)
-  buf_set_keymap("n", "K", "<Cmd>lua vim.lsp.buf.hover()<CR>", opts)
+  vim.keymap.set("n", "K", vim.lsp.buf.hover, opts)
-  buf_set_keymap("n", "<C-k>", "<cmd>lua vim.lsp.buf.signature_help()<CR>", opts)
+  vim.keymap.set("n", "<C-k>", vim.lsp.buf.signature_help, opts)
-  buf_set_keymap("n", "<space>wa", "<cmd>lua vim.lsp.buf.add_workspace_folder()<CR>", opts)
+  vim.keymap.set("n", "<space>wa", vim.lsp.buf.add_workspace_folder, opts)
-  buf_set_keymap("n", "<space>wr", "<cmd>lua vim.lsp.buf.remove_workspace_folder()<CR>", opts)
+  vim.keymap.set("n", "<space>wr", vim.lsp.buf.remove_workspace_folder, opts)
-  buf_set_keymap("n", "<space>wl", "<cmd>lua print(vim.inspect(vim.lsp.buf.list_workspace_folders()))<CR>", opts)
+  vim.keymap.set("n", "<space>wl", function() inspect(vim.lsp.buf.list_workspace_folders()) end, opts)
-  buf_set_keymap("n", "<space>rn", "<cmd>lua vim.lsp.buf.rename()<CR>", opts)
+  vim.keymap.set("n", "<space>rn", vim.lsp.buf.rename, opts)
-  buf_set_keymap("n", "gr", "<cmd>lua vim.lsp.buf.references()<CR>", opts)
+  vim.keymap.set("n", "gr", vim.lsp.buf.references, opts)
-  buf_set_keymap("n", "[d", "<cmd>lua vim.diagnostic.goto_prev()<CR>", opts)
+  vim.keymap.set("n", "[d", vim.diagnostic.goto_prev, opts)
-  buf_set_keymap("n", "]d", "<cmd>lua vim.diagnostic.goto_next()<CR>", opts)
+  vim.keymap.set("n", "]d", vim.diagnostic.goto_next, opts)
-  buf_set_keymap("n", "<space>q", "<cmd>lua vim.diagnostic.setqflist({open = true})<CR>", opts)
+  vim.keymap.set("n", "<space>q", function() vim.diagnostic.setqflist({open = true}) end, opts)
-  buf_set_keymap("n", "<space>ca", "<cmd>lua vim.lsp.buf.code_action()<CR>", opts)
+  vim.keymap.set("n", "<space>ca", vim.lsp.buf.code_action, opts)
 
-  vim.cmd([[
+  api.nvim_create_autocmd("CursorHold", {
-    autocmd CursorHold <buffer> lua require('config.lsp').show_line_diagnostics()
+    buffer=bufnr,
-  ]])
+    callback = function()
+      local float_opts = {
+        focusable = false,
+        close_events = { "BufLeave", "CursorMoved", "InsertEnter", "FocusLost" },
+        border = 'rounded',
+        source = 'always',  -- show source in diagnostic popup window
+        prefix = ' '
+      }
+
+      if not vim.b.diagnostics_pos then
+        vim.b.diagnostics_pos = { nil, nil }
+      end
+
+      local cursor_pos = api.nvim_win_get_cursor(0)
+      if (cursor_pos[1] ~= vim.b.diagnostics_pos[1] or cursor_pos[2] ~= vim.b.diagnostics_pos[2]) and
+        #vim.diagnostic.get() > 0
+      then
+          vim.diagnostic.open_float(nil, float_opts)
+      end
+
+      vim.b.diagnostics_pos = cursor_pos
+    end
+  })
 
   -- Set some key bindings conditional on server capabilities
   if client.resolved_capabilities.document_formatting then
-    buf_set_keymap("n", "<space>f", "<cmd>lua vim.lsp.buf.formatting_sync()<CR>", opts)
+    vim.keymap.set("n", "<space>f", vim.lsp.buf.formatting_sync, opts)
   end
   if client.resolved_capabilities.document_range_formatting then
-    buf_set_keymap("x", "<space>f", "<cmd>lua vim.lsp.buf.range_formatting()<CR><ESC>", opts)
+    vim.keymap.set("x", "<space>f", vim.lsp.buf.range_formatting, opts)
   end
 
   -- The blow command will highlight the current variable and its usages in the buffer.
   if client.resolved_capabilities.document_highlight then
     vim.cmd([[
-      hi link LspReferenceRead Visual
+      hi! link LspReferenceRead Visual
-      hi link LspReferenceText Visual
+      hi! link LspReferenceText Visual
-      hi link LspReferenceWrite Visual
+      hi! link LspReferenceWrite Visual
       augroup lsp_document_highlight
         autocmd! * <buffer>
         autocmd CursorHold <buffer> lua vim.lsp.buf.document_highlight()
@@ -67,84 +75,103 @@ local custom_attach = function(client, bufnr)
   end
 end
 
-local capabilities = require('cmp_nvim_lsp').update_capabilities(lsp.protocol.make_client_capabilities())
+local capabilities = lsp.protocol.make_client_capabilities()
+capabilities = require('cmp_nvim_lsp').update_capabilities(capabilities)
 capabilities.textDocument.completion.completionItem.snippetSupport = true
 
 local lspconfig = require("lspconfig")
 
-lspconfig.pylsp.setup({
+if utils.executable('pylsp') then
-  on_attach = custom_attach,
+  lspconfig.pylsp.setup({
-  settings = {
+    on_attach = custom_attach,
-    pylsp = {
+    settings = {
-      plugins = {
+      pylsp = {
-        pylint = { enabled = true, executable = "pylint" },
+        plugins = {
-        pyflakes = { enabled = false },
+          pylint = { enabled = true, executable = "pylint" },
-        pycodestyle = { enabled = false },
+          pyflakes = { enabled = false },
-        jedi_completion = { fuzzy = true },
+          pycodestyle = { enabled = false },
-        pyls_isort = { enabled = true },
+          jedi_completion = { fuzzy = true },
-        pylsp_mypy = { enabled = true },
+          pyls_isort = { enabled = true },
+          pylsp_mypy = { enabled = true },
+        },
       },
     },
-  },
+    flags = {
-  flags = {
+      debounce_text_changes = 200,
-    debounce_text_changes = 200,
+    },
-  },
+    capabilities = capabilities,
-  capabilities = capabilities,
+  })
-})
+else
+  vim.notify("pylsp not found!", 'warn', {title = 'Nvim-config'})
+end
 
--- lspconfig.pyright.setup{
+-- if utils.executable('pyright') then
---   on_attach = custom_attach,
+--   lspconfig.pyright.setup{
---   capabilities = capabilities
+--     on_attach = custom_attach,
--- }
+--     capabilities = capabilities
+--   }
+-- else
+--   vim.notify("pyright not found!", 'warn', {title = 'Nvim-config'})
+-- end
 
-lspconfig.clangd.setup({
+if utils.executable('clangd') then
-  on_attach = custom_attach,
+  lspconfig.clangd.setup({
-  capabilities = capabilities,
+    on_attach = custom_attach,
-  filetypes = { "c", "cpp", "cc" },
+    capabilities = capabilities,
-  flags = {
+    filetypes = { "c", "cpp", "cc" },
-    debounce_text_changes = 500,
+    flags = {
-  },
+      debounce_text_changes = 500,
-})
+    },
+  })
+else
+  vim.notify("clangd not found!", 'warn', {title = 'Nvim-config'})
+end
 
 -- set up vim-language-server
-lspconfig.vimls.setup({
+if utils.executable('vim-language-server') then
-  on_attach = custom_attach,
+  lspconfig.vimls.setup({
-  flags = {
+    on_attach = custom_attach,
-    debounce_text_changes = 500,
+    flags = {
-  },
+      debounce_text_changes = 500,
-  capabilities = capabilities,
+    },
-})
+    capabilities = capabilities,
-
+  })
-local sumneko_binary_path = vim.fn.exepath("lua-language-server")
+else
-if vim.g.is_mac or vim.g.is_linux and sumneko_binary_path ~= "" then
+  vim.notify("vim-language-server not found!", 'warn', {title = 'Nvim-config'})
-  local sumneko_root_path = vim.fn.fnamemodify(sumneko_binary_path, ":h:h:h")
+end
-
+
-  local runtime_path = vim.split(package.path, ";")
+-- set up bash-language-server
-  table.insert(runtime_path, "lua/?.lua")
+if utils.executable('bash-language-server') then
-  table.insert(runtime_path, "lua/?/init.lua")
+  lspconfig.bashls.setup({
-
+    on_attach = custom_attach,
-  require("lspconfig").sumneko_lua.setup({
+    capabilities = capabilities,
+  })
+end
+
+if utils.executable("lua-language-server") then
+  -- settings for lua-language-server can be found on https://github.com/sumneko/lua-language-server/wiki/Settings .
+  lspconfig.sumneko_lua.setup({
     on_attach = custom_attach,
-    cmd = { sumneko_binary_path, "-E", sumneko_root_path .. "/main.lua" },
     settings = {
       Lua = {
         runtime = {
           -- Tell the language server which version of Lua you're using (most likely LuaJIT in the case of Neovim)
           version = "LuaJIT",
-          -- Setup your lua path
-          path = runtime_path,
         },
         diagnostics = {
           -- Get the language server to recognize the `vim` global
           globals = { "vim" },
         },
         workspace = {
-          -- Make the server aware of Neovim runtime files
+          -- Make the server aware of Neovim runtime files,
-          library = api.nvim_get_runtime_file("", true),
+          -- see also https://github.com/sumneko/lua-language-server/wiki/Libraries#link-to-workspace .
-        },
+          -- Lua-dev.nvim also has similar settings for sumneko lua, https://github.com/folke/lua-dev.nvim/blob/main/lua/lua-dev/sumneko.lua .
-        -- Do not send telemetry data containing a randomized but unique identifier
+          library = {
-        telemetry = {
+            fn.stdpath('data') .. "/site/pack/packer/opt/emmylua-nvim",
-          enable = false,
+            fn.stdpath('config'),
+          },
+          maxPreload = 2000,
+          preloadFileSize = 50000,
         },
       },
     },
@@ -153,10 +180,10 @@ if vim.g.is_mac or vim.g.is_linux and sumneko_binary_path ~= "" then
 end
 
 -- Change diagnostic signs.
-vim.fn.sign_define("DiagnosticSignError", { text = "✗", texthl = "DiagnosticSignError" })
+fn.sign_define("DiagnosticSignError", { text = "✗", texthl = "DiagnosticSignError" })
-vim.fn.sign_define("DiagnosticSignWarn", { text = "!", texthl = "DiagnosticSignWarn" })
+fn.sign_define("DiagnosticSignWarn", { text = "!", texthl = "DiagnosticSignWarn" })
-vim.fn.sign_define("DiagnosticSignInformation", { text = "", texthl = "DiagnosticSignInfo" })
+fn.sign_define("DiagnosticSignInformation", { text = "", texthl = "DiagnosticSignInfo" })
-vim.fn.sign_define("DiagnosticSignHint", { text = "", texthl = "DiagnosticSignHint" })
+fn.sign_define("DiagnosticSignHint", { text = "", texthl = "DiagnosticSignHint" })
 
 -- global config for diagnostic
 vim.diagnostic.config({
@@ -177,5 +204,3 @@ vim.diagnostic.config({
 lsp.handlers["textDocument/hover"] = lsp.with(vim.lsp.handlers.hover, {
   border = "rounded",
 })
-
-return M

lua/config/nvim-cmp.lua

@@ -9,54 +9,75 @@ cmp.setup({
       vim.fn["UltiSnips#Anon"](args.body)
     end,
   },
-  mapping = {
+  mapping = cmp.mapping.preset.insert({
-    ['<Tab>'] = function(fallback)
+          ['<Tab>'] = function(fallback)
-      if cmp.visible() then
+            if cmp.visible() then
-        cmp.select_next_item()
+              cmp.select_next_item()
-      else
+            else
-        fallback()
+              fallback()
-      end
+            end
-    end,
+          end,
-    ['<S-Tab>'] = function(fallback)
+          ['<S-Tab>'] = function(fallback)
-      if cmp.visible() then
+            if cmp.visible() then
-        cmp.select_prev_item()
+              cmp.select_prev_item()
-      else
+            else
-        fallback()
+              fallback()
-      end
+            end
-    end,
+          end,
-    ['<Esc>'] = cmp.mapping.close(),
+          ['<CR>'] = cmp.mapping.confirm({ select = true }),
-    ['<CR>'] = cmp.mapping.confirm({ select = true }),
+          ['<C-e>'] = cmp.mapping.abort(),
-    ['<C-d>'] = cmp.mapping.scroll_docs(-4),
+          ['<Esc>'] = cmp.mapping.close(),
-    ['<C-f>'] = cmp.mapping.scroll_docs(4),
+          ['<C-d>'] = cmp.mapping.scroll_docs(-4),
-  },
+          ['<C-f>'] = cmp.mapping.scroll_docs(4),
+        }),
   sources = {
     { name = 'nvim_lsp' }, -- For nvim-lsp
     { name = 'ultisnips' }, -- For ultisnips user.
-    { name = 'nvim_lua' }, -- for nvim lua function
     { name = 'path' }, -- for path completion
     { name = 'buffer', keyword_length = 4 }, -- for buffer word completion
+    { name = 'omni' },
     { name = 'emoji', insert = true, } -- emoji completion
   },
   completion = {
     keyword_length = 1,
     completeopt = "menu,noselect"
   },
-  experimental = {
+  view = {
-    ghost_text = false
+    entries = 'custom',
   },
   formatting = {
     format = lspkind.cmp_format({
-      with_text = false,
+      mode = "symbol_text",
-      menu = {
+      menu = ({
         nvim_lsp = "[LSP]",
         ultisnips = "[US]",
         nvim_lua = "[Lua]",
         path = "[Path]",
         buffer = "[Buffer]",
         emoji = "[Emoji]",
-      },
+	      omni = "[Omni]",
+      }),
     }),
   },
 })
 
-vim.cmd("hi link CmpItemMenu Comment")
+--  see https://github.com/hrsh7th/nvim-cmp/wiki/Menu-Appearance#how-to-add-visual-studio-code-dark-theme-colors-to-the-menu
+vim.cmd[[
+  highlight! link CmpItemMenu Comment
+  " gray
+  highlight! CmpItemAbbrDeprecated guibg=NONE gui=strikethrough guifg=#808080
+  " blue
+  highlight! CmpItemAbbrMatch guibg=NONE guifg=#569CD6
+  highlight! CmpItemAbbrMatchFuzzy guibg=NONE guifg=#569CD6
+  " light blue
+  highlight! CmpItemKindVariable guibg=NONE guifg=#9CDCFE
+  highlight! CmpItemKindInterface guibg=NONE guifg=#9CDCFE
+  highlight! CmpItemKindText guibg=NONE guifg=#9CDCFE
+  " pink
+  highlight! CmpItemKindFunction guibg=NONE guifg=#C586C0
+  highlight! CmpItemKindMethod guibg=NONE guifg=#C586C0
+  " front
+  highlight! CmpItemKindKeyword guibg=NONE guifg=#D4D4D4
+  highlight! CmpItemKindProperty guibg=NONE guifg=#D4D4D4
+  highlight! CmpItemKindUnit guibg=NONE guifg=#D4D4D4
+]]

lua/config/nvim-tree.lua

@@ -0,0 +1,119 @@
+local nvim_tree = require("nvim-tree")
+
+nvim_tree.setup({
+  auto_reload_on_write = true,
+  disable_netrw = false,
+  hijack_cursor = false,
+  hijack_netrw = true,
+  hijack_unnamed_buffer_when_opening = false,
+  ignore_buffer_on_setup = false,
+  open_on_setup = false,
+  open_on_setup_file = false,
+  open_on_tab = false,
+  sort_by = "name",
+  update_cwd = false,
+  view = {
+    width = 30,
+    height = 30,
+    hide_root_folder = false,
+    side = "left",
+    preserve_window_proportions = false,
+    number = false,
+    relativenumber = false,
+    signcolumn = "yes",
+    mappings = {
+      custom_only = false,
+      list = {
+        -- user mappings go here
+      },
+    },
+  },
+  renderer = {
+    indent_markers = {
+      enable = false,
+      icons = {
+        corner = "└ ",
+        edge = "│ ",
+        none = "  ",
+      },
+    },
+    icons = {
+      webdev_colors = true,
+    },
+  },
+  hijack_directories = {
+    enable = true,
+    auto_open = true,
+  },
+  update_focused_file = {
+    enable = false,
+    update_cwd = false,
+    ignore_list = {},
+  },
+  ignore_ft_on_setup = {},
+  system_open = {
+    cmd = "",
+    args = {},
+  },
+  diagnostics = {
+    enable = false,
+    show_on_dirs = false,
+    icons = {
+      hint = "",
+      info = "",
+      warning = "",
+      error = "",
+    },
+  },
+  filters = {
+    dotfiles = false,
+    custom = {},
+    exclude = {},
+  },
+  git = {
+    enable = true,
+    ignore = true,
+    timeout = 400,
+  },
+  actions = {
+    use_system_clipboard = true,
+    change_dir = {
+      enable = true,
+      global = false,
+      restrict_above_cwd = false,
+    },
+    open_file = {
+      quit_on_open = false,
+      resize_window = false,
+      window_picker = {
+        enable = true,
+        chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890",
+        exclude = {
+          filetype = { "notify", "packer", "qf", "diff", "fugitive", "fugitiveblame" },
+          buftype = { "nofile", "terminal", "help" },
+        },
+      },
+    },
+  },
+  trash = {
+    cmd = "trash",
+    require_confirm = true,
+  },
+  log = {
+    enable = false,
+    truncate = false,
+    types = {
+      all = false,
+      config = false,
+      copy_paste = false,
+      diagnostics = false,
+      git = false,
+      profile = false,
+    },
+  },
+})
+
+vim.keymap.set('n', '<space>s', function()
+  return require('nvim-tree').toggle(false, true)
+end,
+{ noremap = true, silent = true, desc = "toggle nvim-tree"})

lua/config/nvim_hop.lua

@@ -5,6 +5,10 @@ vim.cmd[[ hi HopNextKey2 cterm=bold ctermfg=176 gui=bold guibg=#ff00ff guifg=#ff
 require('hop').setup({
   case_insensitive = true,
   char2_fallback_key = '<CR>',
+  quit_key='<Esc>',
 })
 
-vim.api.nvim_set_keymap('n', 'f', "<cmd>lua require'hop'.hint_char2()<cr>", {noremap = true})
+vim.keymap.set('n', 'f', function()
+  return require('hop').hint_char2()
+end,
+{ silent = true, noremap = true, desc = "nvim-hop char2" })

lua/config/statusline.lua

@@ -1,3 +1,5 @@
+local fn = vim.fn
+
 local function spell()
   if vim.o.spell then
     return string.format("[SPELL]")
@@ -6,37 +8,65 @@ local function spell()
   return ""
 end
 
+local function ime_state()
+  if vim.g.is_mac then
+    -- ref: https://github.com/vim-airline/vim-airline/blob/master/autoload/airline/extensions/xkblayout.vim#L11
+    local layout = fn.libcall(vim.g.XkbSwitchLib, 'Xkb_Switch_getXkbLayout', '')
+    if layout == '0' then
+      return '[CN]'
+    end
+  end
+
+  return ""
+end
+
 local function trailing_space()
-  -- Get the positions of trailing whitespaces from plugin 'jdhao/whitespace.nvim'.
+  if not vim.o.modifiable then
-  local trailing_space_pos = vim.b.trailing_whitespace_pos
+    return ""
+  end
+
+  local line_num = nil
+
+  for i=1, fn.line('$') do
+    local linetext = fn.getline(i)
+    -- To prevent invalid escape error, we wrap the regex string with `[[]]`.
+    local idx = fn.match(linetext, [[\v\s+$]])
+
+    if idx ~= -1 then
+      line_num = i
+      break
+    end
+  end
 
   local msg = ""
-  if #trailing_space_pos > 0 then
+  if line_num ~= nil then
-    -- Note that lua index is 1-based, not zero based!!!
+    msg = string.format("[%d]trailing", line_num)
-    local line = trailing_space_pos[1][1]
-    msg = string.format("[%d]trailing", line)
   end
 
   return msg
 end
 
 local function mixed_indent()
+  if not vim.o.modifiable then
+    return ""
+  end
+
   local space_pat = [[\v^ +]]
   local tab_pat = [[\v^\t+]]
-  local space_indent = vim.fn.search(space_pat, 'nwc')
+  local space_indent = fn.search(space_pat, 'nwc')
-  local tab_indent = vim.fn.search(tab_pat, 'nwc')
+  local tab_indent = fn.search(tab_pat, 'nwc')
   local mixed = (space_indent > 0 and tab_indent > 0)
   local mixed_same_line
   if not mixed then
-    mixed_same_line = vim.fn.search([[\v^(\t+ | +\t)]], 'nwc')
+    mixed_same_line = fn.search([[\v^(\t+ | +\t)]], 'nwc')
     mixed = mixed_same_line > 0
   end
   if not mixed then return '' end
   if mixed_same_line ~= nil and mixed_same_line > 0 then
      return 'MI:'..mixed_same_line
   end
-  local space_indent_cnt = vim.fn.searchcount({pattern=space_pat, max_count=1e3}).total
+  local space_indent_cnt = fn.searchcount({pattern=space_pat, max_count=1e3}).total
-  local tab_indent_cnt =  vim.fn.searchcount({pattern=tab_pat, max_count=1e3}).total
+  local tab_indent_cnt =  fn.searchcount({pattern=tab_pat, max_count=1e3}).total
   if space_indent_cnt > tab_indent_cnt then
     return 'MI:'..tab_indent
   else
@@ -59,11 +89,15 @@ require("lualine").setup({
     lualine_a = { "mode" },
     lualine_b = { "branch", "diff" },
     lualine_c = {
+      "filename",
+      {
+        ime_state,
+        color = {fg = 'black', bg = '#f46868'}
+      },
       {
         spell,
         color = {fg = 'black', bg = '#a7c080'}
       },
-      "filename"
     },
     lualine_x = {
       "encoding",
@@ -82,7 +116,7 @@ require("lualine").setup({
       "location",
       {
         "diagnostics",
-        sources = { "nvim_lsp" }
+        sources = { "nvim_diagnostic" }
       },
       {
         trailing_space,
@@ -103,6 +137,6 @@ require("lualine").setup({
     lualine_z = {},
   },
   tabline = {},
-  extensions = {'quickfix', 'fugitive'},
+  extensions = {'quickfix', 'fugitive', 'nvim-tree'},
 })
 

lua/custom-autocmd.lua

@@ -0,0 +1,89 @@
+local fn = vim.fn
+local api = vim.api
+
+local utils = require("utils")
+
+
+-- Display a message when the current file is not in utf-8 format.
+-- Note that we need to use `unsilent` command here because of this issue:
+-- https://github.com/vim/vim/issues/4379
+api.nvim_create_augroup("non_utf8_file", {
+  clear = true
+})
+
+api.nvim_create_autocmd({ "BufRead" }, {
+  pattern = "*",
+  group = "non_utf8_file",
+  callback = function()
+    if vim.bo.fileencoding ~= 'utf-8' then
+      vim.notify("File not in UTF-8 format!", vim.log.levels.WARN, { title = "nvim-config" })
+    end
+  end
+})
+
+-- highlight yanked region, see `:h lua-highlight`
+api.nvim_create_augroup("highlight_yank", {
+  clear = true
+})
+
+api.nvim_create_autocmd({ "TextYankPost" }, {
+  pattern = "*",
+  group = "highlight_yank",
+  callback = function()
+    vim.highlight.on_yank { higroup = "YankColor", timeout = 300, on_visual = false }
+  end
+})
+
+-- Auto-generate packer_compiled.lua file
+api.nvim_create_augroup("packer_auto_compile", {
+  clear = true
+})
+
+api.nvim_create_autocmd({ "BufWritePost" }, {
+  pattern = "*/nvim/lua/plugins.lua",
+  group = "packer_auto_compile",
+  callback = function(ctx)
+    local cmd = "source " .. ctx.file
+    vim.cmd(cmd)
+    vim.cmd("PackerCompile")
+  end
+})
+
+-- Auto-create dir when saving a file, in case some intermediate directory does not exist
+api.nvim_create_augroup("auto_create_dir", {
+  clear = true
+})
+
+api.nvim_create_autocmd({ "BufWritePre" }, {
+  pattern = "*",
+  group = "auto_create_dir",
+  callback = function(ctx)
+    local dir = fn.fnamemodify(ctx.file, ":p:h")
+    utils.may_create_dir(dir)
+  end
+})
+
+-- Automatically reload the file if it is changed outside of Nvim, see https://unix.stackexchange.com/a/383044/221410.
+-- It seems that `checktime` does not work in command line. We need to check if we are in command
+-- line before executing this command, see also https://vi.stackexchange.com/a/20397/15292 .
+api.nvim_create_augroup("auto_read", {
+  clear = true
+})
+
+api.nvim_create_autocmd({ "FileChangedShellPost" }, {
+  pattern = "*",
+  group = "auto_read",
+  callback = function()
+    vim.notify("File changed on disk. Buffer reloaded!", vim.log.levels.WARN, { title = "nvim-config" })
+  end
+})
+
+api.nvim_create_autocmd({ "FocusGained", "CursorHold" }, {
+  pattern = "*",
+  group = "auto_read",
+  callback = function()
+    if fn.getcmdwintype() == '' then
+      vim.cmd("checktime")
+    end
+  end
+})

lua/custom-map.lua

@@ -0,0 +1,11 @@
+local keymap = vim.keymap
+
+-- Go to the beginning and end of current line in insert mode quickly
+keymap.set('i', '<C-A>', '<HOME>')
+keymap.set('i', '<C-E>', '<END>')
+
+-- Go to beginning of command in command-line mode
+keymap.set('c', '<C-A>', '<HOME>')
+
+-- Delete the character to the right of the cursor
+keymap.set('i', '<C-D>', '<DEL>')

lua/plugins.lua

@@ -1,64 +1,64 @@
 local utils = require("utils")
 local fn = vim.fn
 
-vim.g.package_home = fn.stdpath("data") .. "/site/pack/packer/"
+-- The root dir to install all plugins. Plugins are under opt/ or start/ sub-directory.
-local packer_install_dir = vim.g.package_home .. "/opt/packer.nvim"
+vim.g.plugin_home = fn.stdpath("data") .. "/site/pack/packer"
 
-local plug_url_format = ""
+-- Where to install packer.nvim -- the package manager (we make it opt)
-if vim.g.is_linux then
+local packer_dir = vim.g.plugin_home .. "/opt/packer.nvim"
-  plug_url_format = "https://hub.fastgit.org/%s"
-else
-  plug_url_format = "https://github.com/%s"
-end
 
-local packer_repo = string.format(plug_url_format, "wbthomason/packer.nvim")
+-- Whether this is a fresh install, i.e., packer itself and plugins have not been installed.
-local install_cmd = string.format("10split |term git clone --depth=1 %s %s", packer_repo, packer_install_dir)
+local fresh_install = false
 
 -- Auto-install packer in case it hasn't been installed.
-if fn.glob(packer_install_dir) == "" then
+if fn.glob(packer_dir) == "" then
+  fresh_install = true
+
+  -- Now we need to install packer.nvim first.
+  local packer_repo = "https://github.com/wbthomason/packer.nvim"
+  local install_cmd = string.format("!git clone --depth=1 %s %s", packer_repo, packer_dir)
+
   vim.api.nvim_echo({ { "Installing packer.nvim", "Type" } }, true, {})
   vim.cmd(install_cmd)
 end
 
 -- Load packer.nvim
 vim.cmd("packadd packer.nvim")
-local util = require('packer.util')
 
-require("packer").startup({
+local packer = require("packer")
+local packer_util = require('packer.util')
+
+packer.startup({
   function(use)
     -- it is recommened to put impatient.nvim before any other plugins
     use {'lewis6991/impatient.nvim', config = [[require('impatient')]]}
 
     use({"wbthomason/packer.nvim", opt = true})
 
-    use {"onsails/lspkind-nvim", event = "BufEnter"}
+    use({"onsails/lspkind-nvim", event = "VimEnter"})
     -- auto-completion engine
     use {"hrsh7th/nvim-cmp", after = "lspkind-nvim", config = [[require('config.nvim-cmp')]]}
 
     -- nvim-cmp completion sources
     use {"hrsh7th/cmp-nvim-lsp", after = "nvim-cmp"}
-
+    -- use {"hrsh7th/cmp-nvim-lua", after = "nvim-cmp"}
-    -- nvim-lsp configuration (it relies on cmp-nvim-lsp, so it should be loaded after cmp-nvim-lsp).
-    use({ "neovim/nvim-lspconfig", after = "cmp-nvim-lsp", config = [[require('config.lsp')]] })
-
-    use {"hrsh7th/cmp-nvim-lua", after = "nvim-cmp"}
     use {"hrsh7th/cmp-path", after = "nvim-cmp"}
     use {"hrsh7th/cmp-buffer", after = "nvim-cmp"}
+    use { "hrsh7th/cmp-omni", after = "nvim-cmp" }
+
     -- use {"hrsh7th/cmp-cmdline", after = "nvim-cmp"}
     use {"quangnguyen30192/cmp-nvim-ultisnips", after = {'nvim-cmp', 'ultisnips'}}
     if vim.g.is_mac then
       use {"hrsh7th/cmp-emoji", after = 'nvim-cmp'}
     end
 
+    -- nvim-lsp configuration (it relies on cmp-nvim-lsp, so it should be loaded after cmp-nvim-lsp).
+    use({ "neovim/nvim-lspconfig", after = "cmp-nvim-lsp", config = [[require('config.lsp')]] })
+
     if vim.g.is_mac then
       use({ "nvim-treesitter/nvim-treesitter", event = 'BufEnter', run = ":TSUpdate", config = [[require('config.treesitter')]] })
     end
 
-    -- Python syntax highlighting and more
-    if vim.g.is_win then
-      use({ "numirias/semshi", ft = "python", config = "vim.cmd [[UpdateRemotePlugins]]" })
-    end
-
     -- Python indent (follows the PEP8 style)
     use({ "Vimjas/vim-python-pep8-indent", ft = { "python" } })
 
@@ -83,10 +83,15 @@ require("packer").startup({
     }
 
     -- Clear highlight search automatically for you
-    use({"romainl/vim-cool", event = "VimEnter"})
+    -- use({"romainl/vim-cool", event = "VimEnter"})
 
-    -- Show match number for search
+    -- Show match number and index for searching
-    use {'kevinhwang91/nvim-hlslens', branch = 'main', event = "VimEnter"}
+    use {
+      'kevinhwang91/nvim-hlslens',
+      branch = 'main',
+      keys = {{'n', '*'}, {'n', '#'}, {'n', 'n'}, {'n', 'N'}},
+      config = [[require('config.hlslens')]]
+    }
 
     -- Stay after pressing * and search selected text
     use({"haya14busa/vim-asterisk", event = 'VimEnter'})
@@ -124,25 +129,30 @@ require("packer").startup({
     use({"NTBBloodbath/doom-one.nvim", opt = true})
     use({"sainnhe/everforest", opt = true})
     use({"EdenEast/nightfox.nvim", opt = true})
+    use({"rebelot/kanagawa.nvim", opt = true})
+    use({"catppuccin/nvim", as = "catppuccin", opt = true})
 
     -- Show git change (change, delete, add) signs in vim sign column
     use({"mhinz/vim-signify", event = 'BufEnter'})
     -- Another similar plugin
     -- use 'airblade/vim-gitgutter'
 
+    use {'kyazdani42/nvim-web-devicons', event = 'VimEnter'}
+
     use {
-      'nvim-lualine/lualine.nvim', event = 'VimEnter',
+      'nvim-lualine/lualine.nvim',
-      requires = {'kyazdani42/nvim-web-devicons', opt = true},
+      event = 'VimEnter',
       config = [[require('config.statusline')]]
     }
 
     use({ "akinsho/bufferline.nvim", event = "VimEnter", config = [[require('config.bufferline')]] })
 
     -- fancy start screen
-    use { 'goolord/alpha-nvim', event = 'VimEnter', config = [[require('config.alpha-nvim')]] }
+    use { 'glepnir/dashboard-nvim', event = "VimEnter", config = [[require('config.dashboard-nvim')]] }
 
     use({
       "lukas-reineke/indent-blankline.nvim",
+      event = 'VimEnter',
       config = [[require('config.indent-blankline')]]
     })
 
@@ -185,13 +195,7 @@ require("packer").startup({
     -- use 'mg979/vim-visual-multi'
 
     -- Autosave files on certain events
-    use({
+    use({"907th/vim-auto-save", event = "InsertEnter"})
-      "Pocco81/AutoSave.nvim",
-      event = "VimEnter",
-      config = function()
-        vim.defer_fn(function() require('config.autosave') end, 1500)
-      end
-    })
 
     -- Show undo history visually
     use({"simnalamburt/vim-mundo", cmd = {"MundoToggle", "MundoShow"}})
@@ -230,7 +234,9 @@ require("packer").startup({
     -- Better git log display
     use({ "rbong/vim-flog", requires = "tpope/vim-fugitive", cmd = { "Flog" } })
 
-    use({ "kevinhwang91/nvim-bqf", event = "FileType qf", config = [[require('config.bqf')]] })
+    use({ "christoomey/vim-conflicted", requires = "tpope/vim-fugitive", cmd = {"Conflicted"}})
+
+    use({ "kevinhwang91/nvim-bqf", ft = "qf", config = [[require('config.bqf')]] })
 
     -- Better git commit experience
     use({"rhysd/committia.vim", opt = true, setup = [[vim.cmd('packadd committia.vim')]]})
@@ -349,17 +355,32 @@ require("packer").startup({
 
     -- show and trim trailing whitespaces
     use {'jdhao/whitespace.nvim', event = 'VimEnter'}
+
+    -- file explorer
+    use {
+      'kyazdani42/nvim-tree.lua',
+      requires = { 'kyazdani42/nvim-web-devicons' },
+      config = [[require('config.nvim-tree')]]
+    }
+
+    use { 'ii14/emmylua-nvim', ft = 'lua' }
+
+    use { 'j-hui/fidget.nvim', after = 'nvim-lspconfig', config = [[require('config.fidget-nvim')]]}
   end,
   config = {
     max_jobs = 16,
-    compile_path = util.join_paths(vim.fn.stdpath('config'), 'lua', 'packer_compiled.lua'),
+    compile_path = packer_util.join_paths(fn.stdpath('data'), 'site', 'lua', 'packer_compiled.lua'),
-    git = {
-      default_url_format = plug_url_format,
-    },
   },
 })
 
-local status, _ = pcall(require, 'packer_compiled')
+-- For fresh install, we need to install plugins. Otherwise, we just need to require `packer_compiled.lua`.
-if not status then
+if fresh_install then
+  -- We can command `PackerSync` here, because only after packer.startup, we can know what plugins to install.
+  -- So plugin install should be done after the startup process.
+  vim.cmd("PackerSync")
+else
+  local status, _ = pcall(require, 'packer_compiled')
+  if not status then
   vim.notify("Error requiring packer_compiled.lua: run PackerSync to fix!")
+  end
 end

lua/utils.lua

@@ -1,17 +1,34 @@
+local fn = vim.fn
+
 -- inspect something
--- Taken from https://github.com/jamestthompson3/vimConfig/blob/eeef4a8eeb5a24938f8a0969a35f69c78643fb66/lua/tt/nvim_utils.lua#L106
+function _G.inspect(item)
-function inspect(item)
+  vim.pretty_print(item)
-  print(vim.inspect(item))
 end
 
 local M = {}
 
 function M.executable(name)
-  if vim.fn.executable(name) > 0 then
+  if fn.executable(name) > 0 then
     return true
   end
 
   return false
 end
 
+--- Create a dir if if does not exist
+function M.may_create_dir(dir)
+  local res = fn.isdirectory(dir)
+
+  if res == 0 then
+    fn.mkdir(dir, 'p')
+  end
+end
+
+function M.get_nvim_version()
+  local actual_ver = vim.version()
+
+  local nvim_ver_str = string.format("%d.%d.%d", actual_ver.major, actual_ver.minor, actual_ver.patch)
+  return nvim_ver_str
+end
+
 return M

my_snippets/cpp.snippets

@@ -8,6 +8,7 @@ snippet bare "barebone code template"
 #include <unordered_set>
 #include <stack>
 #include <queue>
+#include <numeric>
 
 using std::cout;
 using std::endl;

my_snippets/markdown.snippets

@@ -23,7 +23,7 @@ snippet k3 "Three key strokes shortcut"
 <kbd>${1:KEY}</kbd> + <kbd>${2:KEY}</kbd> + <kbd>${3:KEY}</kbd>
 endsnippet
 
-snippet "meta" "Markdown front matter (YAML format)" b
+snippet meta "Markdown front matter (YAML format)" b
 ---
 title: "$1"
 date: `!p from datetime import datetime
@@ -47,7 +47,7 @@ $0
 endsnippet
 
 snippet font "HTML font tag"
-<font color="${1:red}">${2:TEXT}</font>
+<font color="${1:blue}">${2:TEXT}</font>
 endsnippet
 
 snippet link "Markdown links"
@@ -70,3 +70,99 @@ endsnippet
 snippet yh "直角引号" w
 「$1」
 endsnippet
+
+snippet info "info box"
+<style type="text/css">
+@import url('//maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css');
+
+.info-msg {
+	color: #059;
+	background-color: #BEF;
+	margin: 5px 0;
+	margin-bottom: 20px;
+	padding: 10px;
+	border-radius: 5px 5px 5px 5px;
+	border: 2px solid transparent;
+	border-color: transparent;
+}
+</style>
+
+<div class="info-msg">
+	<i class="fa fa-info-circle"> Info</i></br>
+	${1:info text}
+</div>
+$0
+endsnippet
+
+snippet warn "warning box"
+<style type="text/css">
+@import url('//maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css');
+
+.warning-msg {
+	color: #9F6000;
+	background-color: #FEEFB3;
+	margin: 5px 0;
+	margin-bottom: 20px;
+	padding: 10px;
+	border-radius: 5px 5px 5px 5px;
+	border: 2px solid transparent;
+	border-color: transparent;
+}
+</style>
+
+<div class="warning-msg">
+	<i class="fa fa-warning"> Warning</i></br>
+	${1:warning text}
+</div>
+$0
+endsnippet
+
+snippet error "error box"
+<style type="text/css">
+@import url('//maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css');
+
+.error-msg {
+	color: #D8000C;
+	background-color: #FFBABA;
+	margin: 5px 0;
+	margin-bottom: 20px;
+	padding: 10px;
+	border-radius: 5px 5px 5px 5px;
+	border: 2px solid transparent;
+	border-color: transparent;
+}
+</style>
+
+<div class="error-msg">
+	<i class="fa fa-times-circle"> Error</i></br>
+	${1:error text}
+</div>
+$0
+endsnippet
+
+snippet success "success box"
+<style type="text/css">
+@import url('//maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css');
+
+.success-msg {
+	color: #270;
+	background-color: #DFF2BF;
+	margin: 5px 0;
+	margin-bottom: 20px;
+	padding: 10px;
+	border-radius: 5px 5px 5px 5px;
+	border: 2px solid transparent;
+	border-color: transparent;
+}
+</style>
+
+<div class="success-msg">
+	<i class="fa fa-check"></i>
+	${1:success text}
+</div>
+$0
+endsnippet
+
+snippet td "too long do not read" bw
+tl;dr: $1
+endsnippet

my_snippets/python.snippets

@@ -24,3 +24,7 @@ def main():
 if __name__ == "__main__":
 	main()
 endsnippet
+
+snippet sol "solution" b
+solution = Solution()
+endsnippet

my_snippets/snippets.snippets

@@ -0,0 +1,6 @@
+# copied from https://github.com/honza/vim-snippets/blob/master/UltiSnips/snippets.snippets
+snippet snip "Ultisnips snippet definition" b
+`!p snip.rv = "snippet"` ${1:Tab_trigger} "${2:Description}" ${3:b}
+${0:${VISUAL}}
+`!p snip.rv = "endsnippet"`
+endsnippet

my_snippets/tex.snippets

@@ -1,3 +1,9 @@
-snippet frac "Math fractions"
+snippet use "usepackage" b
-\frac{${1:NUM}}{${2:DEN}} $0
+\usepackage{${1:package}}
+endsnippet
+
+snippet eqa "equation enviroment" b
+\begin{equation}\label{$1}
+	$2
+\end{equation}
 endsnippet

plugin/command.vim

@@ -8,3 +8,40 @@ call utils#Cabbrev('man', 'Man')
 
 " show current date and time in human readable format
 command! -nargs=? Datetime echo utils#iso_time(<q-args>)
+
+" Convert Markdown file to PDF
+command! ToPDF call s:md_to_pdf()
+
+function! s:md_to_pdf() abort
+  " check if pandoc is installed
+  if executable('pandoc') != 1
+    echoerr "pandoc not found"
+    return
+  endif
+
+  let l:md_path = expand("%:p")
+  let l:pdf_path = fnamemodify(l:md_path, ":r") .. ".pdf"
+
+  let l:header_path = stdpath('config') . '/resources/head.tex'
+
+  let l:cmd = "pandoc --pdf-engine=xelatex --highlight-style=zenburn --table-of-content " .
+        \ "--include-in-header=" . l:header_path . " -V fontsize=10pt -V colorlinks -V toccolor=NavyBlue " .
+        \ "-V linkcolor=red -V urlcolor=teal -V filecolor=magenta -s " .
+        \ l:md_path . " -o " . l:pdf_path
+
+  if g:is_mac
+    let l:cmd = l:cmd . '&& open ' . l:pdf_path
+  endif
+
+  if g:is_win
+    let l:cmd = l:cmd . '&& start ' . l:pdf_path
+  endif
+
+  " echomsg l:cmd
+
+  let l:id = jobstart(l:cmd)
+
+  if l:id == 0 || l:id == -1
+    echoerr "Error running command"
+  endif
+endfunction

plugin/log-autocmds.vim

@@ -0,0 +1,119 @@
+command! LogAutocmds call s:log_autocmds_toggle()
+
+function! s:log_autocmds_toggle()
+  augroup LogAutocmd
+    autocmd!
+  augroup END
+
+  let l:date = strftime('%F', localtime())
+  let s:activate = get(s:, 'activate', 0) ? 0 : 1
+  if !s:activate
+    call s:log('Stopped autocmd log (' . l:date . ')')
+    return
+  endif
+
+  call s:log('Started autocmd log (' . l:date . ')')
+  augroup LogAutocmd
+    for l:au in s:aulist
+      silent execute 'autocmd' l:au '* call s:log(''' . l:au . ''')'
+    endfor
+  augroup END
+endfunction
+
+function! s:log(message)
+  silent execute '!echo "'
+        \ . strftime('%T', localtime()) . ' - ' . a:message . '"'
+        \ '>> /tmp/vim_log_autocommands'
+endfunction
+
+" These are deliberately left out due to side effects
+" - SourceCmd
+" - FileAppendCmd
+" - FileWriteCmd
+" - BufWriteCmd
+" - FileReadCmd
+" - BufReadCmd
+" - FuncUndefined
+
+let s:aulist = [
+      \ 'BufNewFile',
+      \ 'BufReadPre',
+      \ 'BufRead',
+      \ 'BufReadPost',
+      \ 'FileReadPre',
+      \ 'FileReadPost',
+      \ 'FilterReadPre',
+      \ 'FilterReadPost',
+      \ 'StdinReadPre',
+      \ 'StdinReadPost',
+      \ 'BufWrite',
+      \ 'BufWritePre',
+      \ 'BufWritePost',
+      \ 'FileWritePre',
+      \ 'FileWritePost',
+      \ 'FileAppendPre',
+      \ 'FileAppendPost',
+      \ 'FilterWritePre',
+      \ 'FilterWritePost',
+      \ 'BufAdd',
+      \ 'BufCreate',
+      \ 'BufDelete',
+      \ 'BufWipeout',
+      \ 'BufFilePre',
+      \ 'BufFilePost',
+      \ 'BufEnter',
+      \ 'BufLeave',
+      \ 'BufWinEnter',
+      \ 'BufWinLeave',
+      \ 'BufUnload',
+      \ 'BufHidden',
+      \ 'BufNew',
+      \ 'SwapExists',
+      \ 'FileType',
+      \ 'Syntax',
+      \ 'EncodingChanged',
+      \ 'TermChanged',
+      \ 'VimEnter',
+      \ 'GUIEnter',
+      \ 'GUIFailed',
+      \ 'TermResponse',
+      \ 'QuitPre',
+      \ 'VimLeavePre',
+      \ 'VimLeave',
+      \ 'FileChangedShell',
+      \ 'FileChangedShellPost',
+      \ 'FileChangedRO',
+      \ 'ShellCmdPost',
+      \ 'ShellFilterPost',
+      \ 'CmdUndefined',
+      \ 'SpellFileMissing',
+      \ 'SourcePre',
+      \ 'VimResized',
+      \ 'FocusGained',
+      \ 'FocusLost',
+      \ 'CursorHold',
+      \ 'CursorHoldI',
+      \ 'CursorMoved',
+      \ 'CursorMovedI',
+      \ 'WinEnter',
+      \ 'WinLeave',
+      \ 'TabEnter',
+      \ 'TabLeave',
+      \ 'CmdwinEnter',
+      \ 'CmdwinLeave',
+      \ 'InsertEnter',
+      \ 'InsertChange',
+      \ 'InsertLeave',
+      \ 'InsertCharPre',
+      \ 'TextChanged',
+      \ 'TextChangedI',
+      \ 'ColorScheme',
+      \ 'RemoteReply',
+      \ 'QuickFixCmdPre',
+      \ 'QuickFixCmdPost',
+      \ 'SessionLoadPost',
+      \ 'MenuPopup',
+      \ 'CompleteDone',
+      \ 'User',
+      \ ]
+

resources/head.tex

@@ -0,0 +1,78 @@
+\usepackage{fancyvrb,newverbs}
+\usepackage[top=2cm, bottom=1.5cm, left=2cm, right=2cm]{geometry}
+
+\PassOptionsToPackage{dvipsnames,svgnames,x11names}{xcolor}
+\usepackage{hyperref}
+
+% begin a new page for each section (first level header),
+% we need to combine this with `-V subparagraph` when invoking pandc
+% \usepackage{titlesec}
+% \newcommand{\sectionbreak}{\clearpage}
+
+% change background color for inline code in markdown files.
+% The following code does not work well for long text, because the text will exceed the page boundary.
+\definecolor{bgcolor}{HTML}{DADADA}
+\let\oldtexttt\texttt
+
+\renewcommand{\texttt}[1]{
+  \colorbox{bgcolor}{\oldtexttt{#1}}
+}
+
+% change style of quote, see also https://tex.stackexchange.com/a/436253/114857
+\usepackage[most]{tcolorbox}
+
+\definecolor{linequote}{RGB}{224,215,188}
+\definecolor{backquote}{RGB}{249,245,233}
+\definecolor{bordercolor}{RGB}{221,221,221}
+
+% change left border: https://tex.stackexchange.com/a/475716/114857
+% change left margin: https://tex.stackexchange.com/a/457936/114857
+\newtcolorbox{myquote}[1][]{%
+    enhanced,
+    breakable,
+    size=minimal,
+    left=10pt,
+    top=5pt,
+    bottom=5pt,
+    frame hidden,
+    boxrule=0pt,
+    sharp corners=all,
+    colback=backquote,
+    borderline west={2pt}{0pt}{bordercolor},
+    #1
+}
+
+% redefine quote environment to use the myquote environment, see https://tex.stackexchange.com/a/337587/114857
+\renewenvironment{quote}{\begin{myquote}}{\end{myquote}}
+
+% start a new page after toc, we need to save the old command before defining
+% new one to avoid recursive command calls,
+% see https://tex.stackexchange.com/questions/47351/can-i-redefine-a-command-to-contain-itself
+\let\oldtoc\tableofcontents
+\renewcommand{\tableofcontents}{\oldtoc\newpage}
+
+% fix header level issue
+\usepackage{enumitem}
+\setlistdepth{9}
+
+\setlist[itemize,1]{label=$\bullet$}
+\setlist[itemize,2]{label=$\bullet$}
+\setlist[itemize,3]{label=$\bullet$}
+\setlist[itemize,4]{label=$\bullet$}
+\setlist[itemize,5]{label=$\bullet$}
+\setlist[itemize,6]{label=$\bullet$}
+\setlist[itemize,7]{label=$\bullet$}
+\setlist[itemize,8]{label=$\bullet$}
+\setlist[itemize,9]{label=$\bullet$}
+\renewlist{itemize}{itemize}{9}
+
+\setlist[enumerate,1]{label=$\arabic*.$}
+\setlist[enumerate,2]{label=$\alph*.$}
+\setlist[enumerate,3]{label=$\roman*.$}
+\setlist[enumerate,4]{label=$\arabic*.$}
+\setlist[enumerate,5]{label=$\alpha*$}
+\setlist[enumerate,6]{label=$\roman*.$}
+\setlist[enumerate,7]{label=$\arabic*.$}
+\setlist[enumerate,8]{label=$\alph*.$}
+\setlist[enumerate,9]{label=$\roman*.$}
+\renewlist{enumerate}{enumerate}{9}

spell/en.utf-8.add

@@ -345,3 +345,88 @@ teardown
 github
 fastgit
 EOL
+PyCharm
+deduplication
+STL
+delimitMate
+lspconfig
+lualine
+Keymap
+iCloud
+keyframe
+maskRCNN
+vundle
+ycm
+ftplugin
+vim9
+dotfile
+magit
+xelatex
+subarray
+fvim
+CUDA
+cuda
+cpu
+jdhao
+whitelisted
+BST
+autocmd
+init
+miniconda
+tsinghua
+pylsp
+mypy
+isort
+ustc
+PyTorch
+maxcdn
+torchvision
+FFmpeg
+pyav
+wezterm
+frac
+argmax
+NeruIPS
+InfoNCE
+LSTM
+linkedin
+hotmail
+datetime
+csv
+iterable
+dataframe
+CRNN
+ICPR
+matplotlib
+scikit
+NumPy
+cudnn
+SGD
+ImageNet
+ReLU
+CIFAR
+ResNet
+XGBoost
+Shenzhen
+Tanh
+Kaggle
+minist
+src
+RGBA
+yapf
+Vimming
+overfitting
+PCA
+SVM
+KNN
+leetcode
+Logitech
+WTF
+tensorboard
+Nvidia
+GPG
+manpage
+metatable
+open3d
+pyntcloud
+param