# NVCode for ArchLinx

作業程序：

安裝 Neovim v5.x
安裝 Neovim 執行環境
安裝 Neovim Plugins 支援軟件
安裝 VS Code 及 Extensions
設定 VS Code 執行環境
設定 NVCode 執行環境
設定 Django Projects 執行環境

# 安裝 Neovim v5.x

https://wiki.archlinux.org/index.php/Neovim

# 使用套件管理器安裝

sudo pacman -Sy
yay -S neovim-git

【註】：

在 Neovim v5.x 未發行前，以下的指令，只會安裝「正式」發行版 v4.x。 sudo pacman -S neovim

（4）驗證安裝結果：

# 安裝 Neovim 執行環境

# Python support for Neovim

先完成 pyenv ：Python 版本管理器之安裝後，再執行如下指令：

[alanjui@VB2101-Manjaro-KDE-202 .vim]$ pyenv versions 
 system 
* 3.9.1 (set by /home/alanjui/.pyenv/version) 
 3.9.1/envs/my_venv 
 3.9.1/envs/venv-3.9.1 
 my_venv 
 venv-3.9.1


pip install --upgrade pip
pip install pynvim
pip install neovim-remote

# Node.JS support for Neovim

先完成 n : Node.JS 版本管理器之安裝後，再執行如下指令：

[alanjui@VB2101-Manjaro-KDE-202 .vim]$ n 
  installed : v14.15.4 (with npm 6.14.10) 
[alanjui@VB2101-Manjaro-KDE-202 .vim]$ node -v 
v14.15.4 
[alanjui@VB2101-Manjaro-KDE-202 .vim]$ npm -v 
6.14.10


npm install -g neovim

# Lua support for Neovim

【執行檔直接安裝法】：

sudo pacman -S lua luarocks

【驗證安裝結果】：

[alanjui@VB2101-Manjaro-KDE-202 .vim]$ which lua 
/usr/bin/lua 
[alanjui@VB2101-Manjaro-KDE-202 .vim]$ which luarocks 
/usr/bin/luarocks


$ lua
Lua 5.4.2  Copyright (C) 1994-2020 Lua.org, PUC-Rio
> ^D

$ sudo luarocks install luasocket
$ lua
Lua 5.4.2  Copyright (C) 1994-2020 Lua.org, PUC-Rio
> require "socket"
table: 0x7ff0ef004f50   /usr/share/lua/5.4/socket.lua
> ^D

# Git support for Neovim

（1）安裝 git 軟件

sudo pacman -S git

（2）設置 git 執行環境

$ git config --global user.name "Alan Jui"
$ git config --global user.email "alanjui.1960@gmail.com"

# 安裝 Neovim Plugins 支援軟件

Neovim Plugin 在「執行」時，會呼叫某些「作業系統」層級之軟件，以達成其「功能」之用途。故而需要安裝這些「Neovim Plugins 支援軟件」。

# 《Clipboard支援軟件》

https://wiki.archlinux.org/index.php/clipboard

sudo pacman -S xsel

# 《ripgrep》

sudo pacman -S ripgrep

# 《silver searcher》

sudo pacman -S the_silver_searcher

https://github.com/ggreer/the_silver_searcher

# 《fd》

sudo pacman -S fd

https://github.com/sharkdp/fd

# 《ranger》

安裝 ranger (File Manager) sudo pacman -S ranger
安裝 ueberzug (Image Preview Tool) sudo pacman -S ueberzug
設定 ranger 執行環境 vim ~/.config/ranger/rc.conf

set preview_images true set preview_images_method ueberzug

default_linemod devicons set show_hidden true

【參考文章】：

https://www.everythingcli.org/ranger-image-preview-on-osx-with-iterm2/

# 《Rnvimr》

pip install ueberzug

【註】： Requirements

Ranger (v1.9.3 at least)
Pynvim
Neovim
Python 3.6
Ueberzug (optiona, v18.1.6 at least) : 只有 Linux 版可安裝

https://github.com/kevinhwang91/rnvimr

【註】： Rnvimr is a NeoVim plugin that allows you to use Ranger in a floating window.

Different than other Ranger vim-plugins, Rnvimr gives you full control over Ranger. It uses RPC (opens new window) to communicate with Ranger.

This plugin does not support Vim.

macOS users please install ranger by `pip3 ranger-fm` instead of `brew install ranger`

https://awesomeopensource.com/project/kevinhwang91/rnvimr?categoryPage=40#installation

# 《universal-ctags》

sudo pacman -S universal-ctags

https://github.com/universal-ctags/homebrew-universal-ctags

# 《lazy git》

yay -S lazygit-git

https://github.com/jesseduffield/lazygit#ubuntu

# 《lazy docker》

yay -S lazydocker-git

https://github.com/jesseduffield/lazydocker#installation

# 《coc-nvim extension: bash-language-server》

yay -S bash-language-server


npm i -g bash-language-server

https://github.com/bash-lsp/bash-language-server

# 《coc-nvim extension: lua-language-server》

yay -S lua-language-server-git

《vim-visual-multi》

https://github.com/mg979/vim-visual-multi

《fzf-preview》

https://github.com/yuki-yano/fzf-preview.vim

sudo pacman -S fzf



[ -f ~/.fzf.bash ] && source ~/.fzf.bash

# 安裝 VS Code 及 Extensions

# 安裝 VS Code 軟件

安裝 VS Code 軟件，有以下三種方法：

使用官方提供之執行檔安裝
使用作業系統套件舘安裝
使用原始碼編譯及安裝

使用官方提供之執行檔安裝

自「官網」下載，及執行「安裝執行檔」。

https://code.visualstudio.com/download

Mac 版： VSCode-darwin.zip
Ubuntu/Debian 版： code_1.52.1-1608136922_amd64.deb
Linux 版： code-stable-x64-1608137260.tar.gz （GZip壓縮檔）

使用作業系統套件舘安裝

許多的 Linux 作業系統，如： Ubuntu / Debian / CentOS 均有提供「套件舘（Package Library）」的安裝方式：

https://linuxhint.com/install_visual_studio_code_archlinux/

使用原始碼編譯及安裝

如：ArchLinux https://wiki.archlinux.org/index.php/Visual_Studio_Code

# 安裝 VS Code 擴充軟件（Extensions）

啟動 VS Code 後，安裝下列 Extensions：

Neo Vim (asvetliakov.vscode-neovim)
Which Key (vspacecode.whichkey)
prettier - Code formatter (esbenp.prettier-vscode)
Material Icon Theme (pkief.material-icon-theme)
Auto Rename Tag (formulahendry.auto-rename-tag)
Django (batisteo.vscode-django)
Djaneiro - Django Snippets (thebarkman.vscode-djaneiro)
Django Samples (mengsicode.vscode-django-boilerplate)
Bracket Pair Colorizer 2 (coenraads.bracket-pair-colorizer-2)
GitLens - Git supercharged (eamodio.gitlens)
Git Graph (mhutchie.git-graph)
Markdown All in One (yzhang.markdown-all-in-one)

【註】：其它參考

https://blog.logrocket.com/top-10-vs-code-extensions-2021/

# 安裝 VS Code Terminal 使用字型

Hack Nerd Font 下載網址：

Hack Regular Nerd Font Complete Mono.ttf

$ su -
$ cd /usr/share/fonts/truetype/

$ wget https://github.com/source-foundry/Hack/releases/download/v3.003/Hack-v3.003-ttf.zip
$ unzip Hack-v3.003-ttf.zip


sudo mv ttf/*.ttf /usr/share/fonts/TTF/



cd
mkdir -p ~/.local/share/fonts && cd $_
wget https://github.com/source-foundry/Hack/releases/download/v3.003/Hack-v3.003-ttf.zip
unzip Hack-v3.003-ttf.zip

https://github.com/ryanoasis/nerd-fonts/tree/master/patched-fonts/Hack

cd ~/tmp
wget https://github.com/source-foundry/Hack/releases/download/v3.003/Hack-v3.003-ttf.zip
unzip Hack-v3.003-ttf.zip
sudo mv ttf/*.ttf /usr/share/fonts/truetype/

安裝 Hack Nerd Font 作業程序

《macOS》

Download the latest version of Hack (opens new window).
Extract the files from the archive (.zip) and click to open them.
Follow the instructions from your operating system.

《Linux》

Download the latest version of Hack (opens new window).
Extract the files from the archive (.zip).
Copy the font files to either your system font folder (often /usr/share/fonts/) or user font folder (often ~/.local/share/fonts/ or /usr/local/share/fonts).
Copy the font configuration file in config/fontconfig/ to either the system font configuration folder (often /etc/fonts/conf.d/) or the font user folder (often ~/.config/fontconfig/conf.d)
Clear and regenerate your font cache and indexes with the following command: $ fc-cache -f -v

You can confirm that the fonts are installed with the following command:

$ fc-list | grep "Hack"

# 設定 VS Code 執行環境

# 置入 NVCode 支援之設定

將 NVCode 所提供之 VS Code 「設定」放進以下設定檔中：

來源處所在目錄： ~/.config/nvim/utils/vscode_config/
標的處所在目錄： ~/Library/Application\ Support/Code/User/
來源處之 Git Repo 網址：https://github.com/ChristianChiarulli/nvim

設定標的及其設定檔名稱：

執行環境設定： settings.json
快捷鍵設定：keybindings.json

# 同步 VS Code 執行環境設定

啟動 VS Code 後，執行「登入」及「Settings is Sync On」功能。

# 檢查 VS Code 執行環境設定

檢查「設定檔」： ~/Library/Application\ Support/Code/User/settings.json 的「設定」內容：

設定 Terminal

  "terminal.external.osxExec": "iTerm.app",
  "terminal.integrated.cursorBlinking": true,
  "terminal.integrated.fontFamily": "Hack Nerd Font Mono",
  "terminal.integrated.fontSize": 14,
  "terminal.integrated.rightClickCopyPaste": true,

設定 editor

  "editor.fontSize": 14,
  "editor.suggestFontSize": 14,
  "editor.suggestSelection": "first",
  "editor.cursorBlinking": "solid",
  "editor.fontFamily": "FiraCode Nerd Font Mono, Hack, Menlo, Monaco, 'Courier New', monospace",
  "editor.minimap.enabled": false,
  "editor.snippetSuggestions": "bottom",
  "editor.scrollbar.horizontal": "hidden",
  "editor.scrollbar.vertical": "hidden",
  "editor.tokenColorCustomizations": {
    "[One Dark Pro]": {
      ....
  },

設定 Emmet

設定 HTML 之編輯，在 Emmet 之使用，於 Django Template 編輯時，可使用 Django Extension 的Snippets 。

  "emmet.showSuggestionsAsSnippets": true,
  "emmet.triggerExpansionOnTab": true,
  "emmet.includeLanguages": {
    "javascript": "javascriptreact",
    "django-html": "html",
    "razor": "html",
    "plaintext": "pug"
  },

設定 Neo Vim Extension

  "vscode-neovim.mouseSelectionStartVisualMode": true,
  "vscode-neovim.neovimExecutablePaths.linux": "/home/alanjui/.local/bin/nvim",
  "vscode-neovim.neovimInitVimPaths.linux": "/home/alanjui/.config/nvim/init.vim",
  "vscode-neovim.neovimExecutablePaths.darwin": "/Users/alanjui/.local/share/nvim-osx64/bin/nvim",
  "vscode-neovim.neovimInitVimPaths.darwin": "/Users/alanjui/.config/nvim/init.vim",

【註】：不可將 /Users/alanjui 目錄路徑「縮寫」成如下「格式」：

        - ~
        - $HOME

設定 Which Key Extension

  "whichkey.sortOrder": "alphabetically",
  "whichkey.delay": 0,
  "whichkey.bindings": [
    {
      "key": ";",
      "name": "commands",
      "type": "command",
      "command": "workbench.action.showCommands"
    },
    ....
  ]

整體設定參考

~/Library/Application\ Support/Code/User/settings.json

{
  "vscode-neovim.mouseSelectionStartVisualMode": true,
  "vscode-neovim.neovimExecutablePaths.linux": "/usr/bin/nvim",
  "vscode-neovim.neovimInitVimPaths.linux": "~/.config/nvim/init.vim",
  "vscode-neovim.neovimExecutablePaths.darwin": "/Users/alanjui/.local/share/nvim/bin/nvim",
  "vscode-neovim.neovimInitVimPaths.darwin": "/Users/alanjuigg/.config/nvim/init.vim",

  "files.associations": {
    "**/*.html": "html",
    "**/templates/**/*.html": "django-html",
    "**/templates/**/*": "django-txt",
    "**/requirements{/**,*}.{txt,in}": "pip-requirements"
  },
  "files.exclude": {
    "**/__pycache__": true,
    "**/.classpath": true,
    "**/.project": true,
    "**/.settings": true,
    "**/.factorypath": true
  },
  "code-runner.executorMap": {
    "python": "$pythonPath $fileName",
    "java": "cd $dir && javac $fileName && java $fileNameWithoutExt",
    "c": "cd $dir && gcc $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt"
  },
  "[javascript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  
  "emmet.showSuggestionsAsSnippets": true,
  "emmet.triggerExpansionOnTab": true,
  "emmet.includeLanguages": {
    "javascript": "javascriptreact",
    "django-html": "html",
    "razor": "html",
    "plaintext": "pug"
  },

  "editor.fontSize": 14,
  "editor.suggestFontSize": 14,
  "editor.suggestSelection": "first",
  "editor.cursorBlinking": "solid",
  "editor.fontFamily": "FiraCode Nerd Font Mono, Hack, Menlo, Monaco, 'Courier New', monospace",
  "editor.minimap.enabled": false,
  "editor.snippetSuggestions": "bottom",
  "editor.scrollbar.horizontal": "hidden",
  "editor.scrollbar.vertical": "hidden",

  //==================================================================
  // Python
  //==================================================================
  //"python.pythonPath": "/home/chris/.miniconda/envs/ds/bin/python",
  //"python.condaPath": "$HOME/.miniconda/bin/conda",
  "python.languageServer": "Pylance",
  "python.formatting.provider": "autopep8",
  "python.terminal.activateEnvironment": false,
  "python.insidersChannel": "off",
  "python.showStartPage": false,
  "python.dataScience.alwaysTrustNotebooks": true,
 
  "whichkey.bindings": [
    {
      "key": ";",
      "name": "commands",
      "type": "command",
      "command": "workbench.action.showCommands"
    },
    ....
  ]

設定 Python Extension

  "python.languageServer": "Pylance",
  "python.formatting.provider": "autopep8",
  "python.terminal.activateEnvironment": false,
  "python.insidersChannel": "off",
  "python.showStartPage": false,
  "python.dataScience.alwaysTrustNotebooks": true,

code-runner.executorMap: 原始碼與執行編譯器之對映關係

  "code-runner.executorMap": {
    "python": "$pythonPath $fileName",
    "java": "cd $dir && javac $fileName && java $fileNameWithoutExt",
    "c": "cd $dir && gcc $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt"
  },

file.exclude: 檔案瀏器可忽略不顯示之目錄或檔案

  "files.exclude": {
    "**/__pycache__": true,
    "**/.classpath": true,
    "**/.project": true,
    "**/.settings": true,
    "**/.factorypath": true
  },

設定 Django Extension

files.associations: 設定「檔案型態辨識規則」

"files.associations": {
    "**/*.html": "html",
    "**/templates/**/*.html": "django-html",
    "**/templates/**/*": "django-txt",
    "**/requirements{/**,*}.{txt,in}": "pip-requirements"
},

【註】：

配合 Django Extension 使用之 snippets 檔存放路徑： $HOME/Library/Application\ Support/Code/User/snippets/django-html.json
在 Coc-nvim 使用 Django Extension Snippets 需配合之設定： { .... "snippets.textmateSnippetsRoots": [ "~/.config/nvim/snips" ], .... }
建立 Symbolic Link: htmldjango.json 指向 django-html.json：

在 coc-nvim 使用之 Snippets 檔案，集中於目錄路徑： ~/.config/nvim/snips/ 。為方便 Snippet 檔案內容同步的管理，應避免使用「實體檔案」，而改用：「軟連結（Symbolic Link）」，建立檔案連結指向為宜。

【Mac】：

cd ~/.config/nvim/snips
ln -s -f ~/Library/Application\ Support/Code/User/snippets/django-html.json htmldjango.json

【ArchLinux】：

cd ~/.config/nvim/snips
ln -s -f ~/.config/Code/User/snippets/django-html.json  htmldjango.json
ln -s -f ~/.config/Code/User/snippets/markdown.json

# 設定 NVCode 執行環境

# 作業程序：

下載 NVCode 設定檔
編輯 NVCode 設定檔
編輯 coc-nvim 設定檔
安裝 Neovim Plugings
設置個人客製化設定

# 下載 NVCode 設定檔

git clone git@github.com:AlanJui/MyNVCode.git ~/.config/nvim


git clone https://github.com/AlanJui/MyNVCode.git ~/.config/nvim

# 編輯 NVCode 設定檔

（1）修訂～/.config/nvim/init.vim

https://github.com/AlanJui/MyNVCode.git

（2）設定 coc-settings.json 所在路徑

cd ~/.config/nvim
rm coc-settings.json
ln -s -f my-nvim/coc-settings.json

# 編輯 coc-nvim 設定檔

修訂設定檔： coc-settings.json

vim ~/.config/nvim/coc-settings.json

python 應用設定

  "python.analysis.autoImportCompletions": true,
  "python.analysis.autoSearchPaths": true,
  "python.analysis.diagnosticMode": "openFilesOnly",
  "python.analysis.stubPath": "typings",
  "python.analysis.typeshedPaths": [],
  "python.analysis.diagnosticSeverityOverrides": {},
  "python.analysis.typeCheckingMode": "basic",
  "python.analysis.useLibraryCodeForTypes": true,
  "python.pythonPath": "python",
  "python.venvPath": "",
  "python.linting.enabled": true,
  "python.linting.pylintEnabled": true,
  "python.linting.pylintArgs": ["--disable=F401, E722, C0115, C0116, W0613"],
  "python.formatting.provider": "autopep8",
  "python.jediEnabled": false,
  // "python.formatting.provider": "black",
  // "python.formatting.blackPath": "~/.local/bin/black",
  // "python.linting.pylintPath": "~/.miniconda/envs/neovim/bin/pylint",
  // "python.condaPath": "~/.miniconda/bin/conda",
  // "python.sortImports.path": "~/.miniconda/envs/neovim/bin/isort",
  // "python.jediPath": "~/.miniconda/envs/neovim/lib/python3.8/site-packages",
  "pyright.disableCompletion": false,
  "pyright.disableLanguageServices": false,
  "pyright.disableOrganizeImports": false,

Snippets 設定

  "suggest.noselect": false,
  "snippets.userSnippetsDirectory": "~/.config/nvim/snips",
  "snippets.ultisnips.enable": true,
  "snippets.ultisnips.directories": ["UltiSnips", "~/.config/nvim/snips"],
  "snippets.snipmate.enable": false,
  "snippets.textmateSnippetsRoots": [
    // Ubuntu Path:
    //  "~/.config/Code/User/snippets"
    //
    // macOS(Darwin) Path:
    // "~/Library/Application Support/Code/User/snippets"
    "~/.config/nvim/snips"
  ],

Emmet 設定

  "emmet.includeLanguages": {
    "htmldjango": "html",
    "django-html": "html",
    "python.django": "python",
    "vue-html": "html",
    "javascript": "javascriptreact"
  },
  "emmet.showAbbreviationSuggestions": true,
  "emmet.showExpandedAbbreviation": "always",

存檔後自動編排原始碼格式設定

執行「存檔」指令後，自動編排「原始碼」應有的「格式」：

  "coc.preferences.formatOnSaveFiletypes": [
    "python",
    "html",
    "htmldjango",
    "django-html",
    "css",
    "markdown",
    "javascript",
    "graphql",
    "yaml",
    "json",
    "jsonc",
    "java"
  ],

Language Server 設定

{
  ....
  "languageserver": {
    "bash": {
      "command": "bash-language-server",
      "args": ["start"],
      "filetypes": ["sh"],
      "ignoredRootPaths": ["~"]
    },
    "lua": {
      "command": "/usr/local/bin/lua-language-server",
      "filetypes": ["lua"],
      "trace.server": "verbose"
    }
}

# 修訂 coc-nvim extensions 安裝清單

配合 coc-nvim 使用的 extensions（亦算是 Neovim Plugins 的一種），除了可在 Neovim 中，透過指令 CocInstall ，逐個「手動安裝」外。亦可透過設定「安裝清單設定檔」： coc-extensions.vim ，令 coc-nvim 自動安裝。

vim ~/.config/nvim/plug-config/coc/coc-extensions.vim


let g:coc_global_extensions = [
  \ 'coc-snippets',
  \ 'coc-actions',
  \ 'coc-sh',
  \ 'coc-java-debug',
  \ 'coc-java',
  \ 'coc-lists',
  \ 'coc-emmet',
  \ 'coc-tasks',
  \ 'coc-pairs',
  \ 'coc-tsserver',
  \ 'coc-floaterm',
  \ 'coc-fzf-preview',
  \ 'coc-html',
  \ 'coc-css',
  \ 'coc-cssmodules',
  \ 'coc-stylelintplus',
  \ 'coc-emoji',
  \ 'coc-yaml',
  \ 'coc-explorer',
  \ 'coc-svg',
  \ 'coc-prettier',
  \ 'coc-vimlsp',
  \ 'coc-xml',
  \ 'coc-yank',
  \ 'coc-json',
  \ 'coc-marketplace',
  \ ]
  " \ 'coc-pyright',
  " \ 'coc-bookmark',
  " \ 'coc-tabnine',
  " \ 'coc-highlight',

# 安裝 Neovim 擴充軟件（Plugins ）

（1）啟動 Neovim

（2）安裝 Neovim Plugins

（3）啟動 FAR

nvim
:UpdateRemotePlugins

# 設置個人客製化設定

（1）設定「個人客製化」環境

cd ~/.config/nvim
git clone <Repo> my-nvim

my-nvim 之目錄結構與檔案清單：

[alanjui@VB2101-Manjaro-KDE-202 nvim]$ tree my-nvim        
my-nvim 
├── coc-settings.json 
├── lua 
│   ├── ccc-eviline.lua 
│   ├── ccc-spaceline.lua 
│   ├── ccc-statusline.lua 
│   └── my-statusLine.lua 
├── my-init.vim 
├── my-settings.vim 
└── snips 
   ├── html.snippets 
   ├── javascript-node.snippets 
   ├── javascript.snippets 
   ├── json.snippets 
   ├── markdown.json 
   ├── markdown.snippets 
   └── python.snippets 

2 directories, 14 files

（2）修訂原設定檔，以便加入「個人客製化」設定：

cd ~/.config/nvim
cp init.vim init.vim.org
vim init.vim

在「檔案底端」加入如下「設定」：

"=========================================================================
" User Define

if !exists('g:vscode')
    let g:python3_host_prog = expand("$HOME/.pyenv/versions/3.9.1/envs/venv-3.9.1/bin/python3")
    let g:node_host_prog = expand("$HOME/n/bin/neovim-node-host")

    let g:loaded_python_provider = 0
    let g:loaded_ruby_provider = 0
    let g:loaded_perl_provider = 0

    source  $HOME/.config/nvim/my-nvim/my-settings.vim
    luafile $HOME/.config/nvim/my-nvim/lua/my-statusLine.lua
endif

（3）設定 Snippets

與 VS Code 共用 Snippets

《Mac版》

cd ~/.config/nvim/snips
ln -s -f ~/Library/Application\ Support/Code/User/snippets/django-html.json htmldjango.json
ln -s -f ~/Library/Application\ Support/Code/User/snippets/django-python.json
ln -s -f ~/Library/Application\ Support/Code/User/snippets/markdown.json

《Linux版》

cd ~/.config/nvim/snips
ln -s -f ~/.config/Code/User/snippets/django-html.json htmldjango.json
ln -s -f ~/.config/Code/User/snippets/django-python.json
ln -s -f ~/.config/Code/User/snippets/markdown.json

設定個人用 Snippets

cd ~/.config/nvim/snips
ln -s -f ../my-nvim/snips/html.snippets
ln -s -f ../my-nvim/snips/javascript-node.snippets
ln -s -f ../my-nvim/snips/javascript.snippets
ln -s -f ../my-nvim/snips/json.snippets
ln -s -f ../my-nvim/snips/markdown.snippets
ln -s -f ../my-nvim/snips/python.snippets

# 設定 Django Projects 執行環境

# 作業程序：

安裝 Python 執行環境
建置 Django Project
設定 Django Project 執行環境

# 建置 Django Project 目錄

（1）建置專案目錄

cd ~/workspace/django
mkdir <ProjectName> && cd $_

（2）設定專案使用 Python 版本

《建置新的虛擬環境》

pyenv versions
pyenv virtualenv 3.9.1 venv-3.9.1

《指定專案所使用的虛擬環境》

pyenv local venv-3.9.1
pyenv version

（3）安裝 Python 套件：Django

pip install django

（4）安裝 Python 格式編排器

pip install autopep8

（5）安裝 Python 語法檢視器

安裝 pylint pip install pylint cp ~/.config/nvim/my-nvim/utils/.pylintrc

【註】：自行產生 .pylintrc 設定檔

pylint --generate-rcfile > .pylintrc

設定可略過之「規則」：
- C0114 (missing-module-docstring)
- C0115 (missing-class-docstring)
- C0116 (missing-function-docstring)
[MASTER] .... disable=print-statement, ...., C0114, C0115, C0116, compresension-escape

（6）建置 pyright 設定：pyrightconfig.json

cp ~/.config/nvim/my-nvim/utils/pyrightconfig.json .


nvim pyrightconfig.json


{
  "venvPath": "/Users/alanjui/.pyenv/versions/3.9.1/envs",
  "venv": "venv-3.9.1",
  "reportMissingImports": true, 
  "pythonVersion": "3.9",
  "exclude": [
    "**/node_modules",
    "**/__pycache__"
  ]
}

【註】： venvPath 的設定，不可使用 Home Dir 的簡寫：

- $**HOME**/.pyenv/versions/3.9.1/envs
- **~**/.pyenv/versions/3.9.1/envs

（7）建置 git 版本管理器

cp ~/.config/nvim/my-nvim/utils/.gitignore .
git init
git add .
git commit -m "Initial project"


$ cat .gitignore
$HOME/.config/coc/extensions/
###################
.DS_Store
.hg
.svn
.idea
.vscode
*.vscode
node_modules
###################
# Python files
.venv/
env/
__pycache__/
.pyc
static_collected/
# Temporary files
*.kate-swp
*.swp
*.swo
*~

（8）建立 Django Project

django-admin startproject web_config .

（9）驗證建立結果

$ ./manage.py runserver
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
January 26, 2021 - 04:12:53
Django version 3.1.5, using settings 'web_config.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

（10）建立 app

$ ./manage.py startapp <AppName>

# VS Code 操作

設定 Python 直譯器版本

1.《Shift》＋《Cmd》＋《P》

Python: Select Interpreter ==> venv-3.9.1

# 設定 launch.json

《專案目錄》/.vscode/launch.json

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Django",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/manage.py",
            "args": [
                "runserver",
                "0.0.0.0:9000"
            ],
            "django": true
        }
    ]
}

# 參考資訊

# Vim 8.2 (opens new window)

sudo pacman -S vim
git clone git@github.com:AlanJui/vim8.git ~/.vim


sudo pacman -S vim
正在解決依賴關係…
正在檢查衝突的軟體包…

軟體包 (2) vim-runtime-8.2.2380-1  vim-8.2.2380-1

總計下載大小：   8.18 MiB
總計安裝大小：  34.01 MiB
淨升級大小：   0.01 MiB

:: 進行安裝嗎？ [Y/n] 
....

# Coc-nvim 參考資料

Neovim Plugin: Coc-nvim 簡介 https://www.chrisatmachine.com/Neovim/04-vim-coc/

Coc-nvim 對 Code Snippets 的支援

https://kanneg881.gitbook.io/workspace/vim/wai-gua-tui-jian/dai-ma/coc/coc-snippets

存檔時自動編排原始碼格式

https://github.com/neoclide/coc-prettier

https://prettier.io/docs/en/vim.html

# Command Line File Explorr

ranger

（1）Install on Mac

pyenv global venv-3.9.1
pip install ranger-fm

（2）Execute

$ ranger

# Lua 原始碼安裝作業

透過「原始碼」安裝 Lua 。

（1）在此網頁查詢 Lua 版本及下載網址：

http://www.lua.org/versions.html
http://www.lua.org/ftp/

（2）編譯原始碼及安裝執行檔

$ cd ~/build
$ curl -R -O http://www.lua.org/ftp/lua-5.4.2.tar.gz
$ tar -zxvf lua-5.4.2.tar.gz
$ cd lua-5.4.2
$ make macosx
$ sudo make install



$ sudo make install
Password:
cd src && mkdir -p /usr/local/bin /usr/local/include /usr/local/lib /usr/local/man/man1 /usr/local/share/lua/5.4 /usr/local/lib/lua/5.4
cd src && install -p -m 0755 lua luac /usr/local/bin
cd src && install -p -m 0644 lua.h luaconf.h lualib.h lauxlib.h lua.hpp /usr/local/include
cd src && install -p -m 0644 liblua.a /usr/local/lib
cd doc && install -p -m 0644 lua.1 luac.1 /usr/local/man/man1

【註】：

Lua V5.3.4 下載 $ curl -R -O http://www.lua.org/ftp/lua-5.3.4.tar.gz
lua 安裝結果與執行檔所在路徑
- lua: /usr/local/bin/lua
- luac: /usr/local/bin/luac
- lua.h luaconf.h lualib.h lauxlib.h lua.php: /usr/local/include
- liblua.a: /usr/local/lib
- lua.1 luac.1 /usr/local/man/man1
驗證安裝結果 $ which lua /usr/local/bin/lua

$ which lua /usr/local/bin/luac

$ ll /usr/local/include/lua* -rw-r--r-- 1 root admin 15K 11 13 23:32 /usr/local/include/lua.h -rw-r--r-- 1 root admin 191B 12 23 2004 /usr/local/include/lua.hpp -rw-r--r-- 1 root admin 20K 11 13 23:32 /usr/local/include/luaconf.h lrwxr-xr-x 1 alanjui admin 41B 1 22 13:11 /usr/local/include/luajit-2.0 -> ../Cellar/luajit/2.0.5/include/luajit-2.0 -rw-r--r-- 1 root admin 1.2K 11 13 23:32 /usr/local/include/lualib.h

$ ll /usr/local/lib/lua total 0 drwxr-xr-x 2 root admin 64B 1 18 13:36 5.2 drwxr-xr-x 3 root admin 96B 1 20 11:27 5.3 drwxr-xr-x 2 root admin 64B 1 24 10:33 5.4

$ ll /usr/local/man/man1 total 16 -rw-r--r-- 1 root wheel 3.0K 5 22 2020 lua.1 -rw-r--r-- 1 root wheel 3.0K 11 17 2011 luac.1

Lua 操作參考：

https://codertw.com/%E7%A8%8B%E5%BC%8F%E8%AA%9E%E8%A8%80/84650/

# Lua 套件管理器：luarocks 安裝

https://luarocks.org/#quick-start

【Installation instructions for macOS】

https://github.com/luarocks/luarocks/wiki/Installation-instructions-for-macOS

【Installation instructions for Unix】

https://github.com/luarocks/luarocks/wiki/Installation-instructions-for-Unix

【Using LuaRocks】

https://github.com/luarocks/luarocks/wiki/Using-LuaRocks

【使用原始碼安裝法】：

$ cd ~/build
$ wget https://luarocks.org/releases/luarocks-3.5.0.tar.gz
$ tar zxpf luarocks-3.5.0.tar.gz
$ cd luarocks-3.5.0
$ ./configure && make && sudo make install

【安裝後驗證】：

$ which luarocks
/usr/local/bin/luarocks

$ sudo luarocks install luasocket
$ lua
Lua 5.3.5 Copyright (C) 1994-2018 Lua.org, PUC-Rio
> require "socket"

《註》：執行時參考資訊

$ ./configure

Configuring LuaRocks version 3.5.0...

Lua version detected: 5.1
Lua interpreter found: /usr/local/bin/luajit
lua.h found: /usr/local/include/lua.h
unzip found in PATH: /usr/bin

Done configuring.

LuaRocks will be installed at......: /usr/local
LuaRocks will install rocks at.....: /usr/local
LuaRocks configuration directory...: /usr/local/etc/luarocks
Using Lua from.....................: /usr/local

* Type make and make install:
  to install to /usr/local as usual.
* Type make bootstrap:
  to install LuaRocks into /usr/local as a rock.