ApolloNvim/README-ENGLISH.md

198 lines
15 KiB
Markdown
Raw Normal View History

2024-10-16 15:27:40 +00:00
Lite 🚀 ApolloNvim Distro 2024 - Front-End Power
2024-10-16 15:43:11 +00:00
#### Verzion: 24.10
2024-10-16 15:27:40 +00:00
#### Link: [🚀 ApolloNvim](https://git.arch-linux.cz/kankys/ApolloNvim)
![ApolloNvim](./img/neovim.jpeg)
# Programming is much more fun when you are efficient. Neovim can get you there eventually, but you have to be willing to try new things. New plugins, new remaps, etc.
## Introduction:
* **Before installing new plugins, always check the documentation for the plugins on Github. This will prevent potential problems! If you're not sure about the process or something is not clear, you'd better check the documentation, write to us or find the answer on the forums. So always back up everything before you change it!**
* 👉 Neovim setup for front-end development based on [Coc](https://github.com/neoclide/coc.nvim) a [Lua](https://neovim.io/doc/user/lua-guide.html).
* 👉 The advantages of Neovim over a classic IDE are undeniable in the freedom of configuration, there are thousands of possibilities how your Neovim can look and work. For your inspiration and use, this project was created 🚀 ApolloNvim.
* 👉 This distribution doesn't just work by clicking a button and installing. It will lead you to a separate installation using this site. The goal is to understand how Neovim works so you can modify everything yourself, which even click-on distributions don't teach you.
2024-10-16 15:43:11 +00:00
* 👉 I made this setup for web development. I was inspired by the plugins I used in VSCode and Webstorm.
* 👉 New PHP support was added in October.
* 👉 Great emphasis is placed on speed and lightness.
* 👉 🚀 ApolloNvim Distro is regularly updated and so is the whole project.
* 👉 For the best experience with 🚀 ApolloNvim Distro I recommend using multiplexor [Zellij](https://git.archoslinux.cz/kankys/zellij-mySetup), but it's not a requirement, of course.
## Advantages:
2024-10-17 07:34:50 +00:00
* 👉 The main advantages of this setup are the support of Codeium alternative to Copilot for free, Prettier, AutoSave, HTML, CSS, JS and shortcuts to comment and uncomment code. There are also several plugins to make working in Neovi more enjoyable.
* 👉 With [LSP](https://github.com/neovim/nvim-lspconfig) in this installation, I use [Coc](https://github.com/neoclide/coc.nvim) for its simplicity without the need to intervene in the Coc configuration. LSP has been very useful in my [Helix](https://helix-editor.com/) modal editor to configure [Helixu](https://git.archoslinux.cz/kankys/Helix-frontend-setup).
* 👉 The best themes for Neovim (so you don't have to search for them), is Dracula by default.
* 👉 To change the theme in Neovi, simply use the `colorscheme command` in the command line and the Tab button to switch between themes.
## Plugins 🚀 ApolloNvim Distro 2024:
### Security and privacy are the most important things, which is why this list is here. In the list you will find all the plugins used in this configuration with a link to the source. Plugins you don't want to use can be commented out or deleted in init.vim. In the case of Coc plugin, omit the plugin-name when you run CocInstall.
* 👉 [Autoclosetag](https://github.com/m4xshen/autoclose.nvim) tool for closing all types of brackets and tags.
* 👉 [Coc](https://github.com/neoclide/coc.nvim) manager for installing add-ons to Neovim.
* 👉 [Prettier](https://giěthub.com/prettier/vim-prettier) code alignment plugin.
* 👉 [html5.vim](https://github.com/othree/html5.vim) plugin for HTML syntax highlighting.
* 👉 [NERDTree](https://github.com/valsorym/scrooloose-nerdtree) creates a tree sidebar for you.
* 👉 [Codeium](https://github.com/Exafunction/codeium.vim) alternative to GitHub Copilot, which you can also easily install.
* 👉 [Startify](https://github.com/mhinz/vim-startify) an alternative welcome screen with a different IT theme each time. May not work with some terminals or NERDTree set to start after boot.
* 👉 [NERD Commenter](https://github.com/preservim/nerdcommenter) plugin for commenting and uncommenting code in **NORMAL mode**. Here we have it set to `Ctrl + k`.
* 👉 [Wakatime](https://wakatime.com/neovim) a service that is able to measure how much time you spent coding on your pc and also on which project. WakaTime can be found at [here](https://wakatime.com/).
* 👉 [Auto-save](https://github.com/Pocco81/auto-save.nvim) plugin for automatic saving, after switching from INSERT to NORMAL mode.
* 👉 [Tree-sitter](https://github.com/nvim-treesitter/nvim-treesitter) plugin for code highlighting.
2024-10-16 15:27:40 +00:00
* 👉 [Hlchunk](https://github.com/shellRaining/hlchunk.nvim) propojí kód vertikálními lajny..
2024-10-17 07:34:50 +00:00
* 👉 [Vim-Fugitive](https://github.com/tpope/vim-fugitive) plugin for git.
* 👉 [Colorizer](https://github.com/lilydjwg/colorizer) plugin for color preview by code designation.
* 👉 [Vim - javascript](https://github.com/pangloss/vim-javascript) plugin for support javascript.
* 👉 [NVIM-CMP](https://github.com/hrsh7th/nvim-cmp) toolkit for better control comfort nvim. Such as help, command completion and much more.
- In this set you will find the following plugins:
2024-10-16 15:27:40 +00:00
- Plug 'neovim/nvim-lspconfig'
- Plug 'hrsh7th/nvim-cmp'
- Plug 'hrsh7th/cmp-nvim-lsp'
- Plug 'hrsh7th/cmp-buffer'
- Plug 'hrsh7th/cmp-path'
- Plug 'hrsh7th/cmp-cmdline'
- Plug 'hrsh7th/cmp-vsnip'
- Plug 'hrsh7th/vim-vsnip'
- Plug 'ray-x/lsp_signature.nvim'
- Plug 'kosayoda/nvim-lightbulb'
### Coc extensions:
2024-10-17 07:34:50 +00:00
* 👉 [Coc](https://github.com/neoclide/coc.nvim) manager for installing add-ons to Neovim.
* 👉 [Coc extensions](https://www.npmjs.com/search?q=keywords%3Acoc.nvim) under this link you can find all COC extensions for Neovim.
2024-10-16 15:27:40 +00:00
* 👉 coc-tailwindcss
* 👉 coc-json
* 👉 coc-html-css-support
* 👉 coc-html
* 👉 coc-emmet
* 👉 coc-xml
* 👉 coc-tsserver
* 👉 coc-lsp-wl
* 👉 coc-lit-html
* 👉 coc-htmldjango
* 👉 coc-css
* 👉 coc-markdown-preview-enhanced
* 👉 coc-webview
* 👉 coc-phpls
* 👉 coc-prettier
### Colorschemes v tomto projektu:
2024-10-17 07:34:50 +00:00
* 👉 [Dracula](https://github.com/dracula/vim)theme Dracula for Neovim.
* 👉 [Gruvbox](https://github.com/morhetz/gruvbox) theme Gruvbox for Neovim.
* 👉 [Catppuccin](https://github.com/catppuccin/nvim) theme Catppuccin for Neovim.
* 👉 [Nord](https://github.com/arcticicestudio/nord-vim) theme Nord for Neovim.
* 👉 [Tokyo Night](https://github.com/ghifarit53/tokyonight-vim) theme Tokyo Night for Neovim.
* 👉 [Nightfox](https://github.com/EdenEast/nightfox.nvim) theme Nightfox for Neovim.
* 👉 [Sonokai](https://github.com/sainnhe/sonokai) theme Sonokai for Neovim.
* 👉 [NeoSolarized](https://github.com/Tsuzat/NeoSolarized.nvim) theme NeoSolarized for Neovim.
* 👉 [Moonfly](https://github.com/bluz71/vim-moonfly-colors) theme Moonfly for Neovim.
* 👉 [Onedark](https://github.com/joshdick/onedark.vim) theme OneDark for Neovim.
* 👉 [Edge](https://github.com/sainnhe/edge) theme Edge for Neovim.
* 👉 [Airline](https://github.com/vim-airline/vim-airline) theme Airline for Neovim.
* 👉 [GitHub](https://github.com/projekt0n/github-nvim-theme) theme GitHub for Neovim.
* 👉 [Nightfly](https://github.com/bluz71/vim-nightfly-colors) theme Nightfly for Neovim.
* 👉 [Miasma](https://github.com/xero/miasma.nvim) theme Miasma for Neovim.
* 👉 [Pink moon](https://github.com/sts10/vim-pink-moon) theme Pink moon for Neovim.
* 👉 [Anderson](https://github.com/tlhr/anderson.vim) theme Anderson for Neovim.
* 👉 [Tender](https://github.com/jacoborus/tender.vim) theme Tender for Neovim.
* 👉 [Nightfox](https://github.com/EdenEast/nightfox.nvim) theme Nightfox for Neovim.
* 👉 [Night owl](https://github.com/haishanh/night-owl.vim) theme Night owl for Neovim.
2024-10-16 15:27:40 +00:00
2024-10-17 07:34:50 +00:00
## Installation and setup:
* 👉 If you haven't already, install [Neovim](https://neovim.io/).
* 👉 You will need to install plug.vim to install the extension.
* 👉 Go to this page `https://github.com/junegunn/vim-plug` under Installation, find your operating system and copy the link below it into your terminal.
* 👉 But first, back up your current Neovim settings!!!
2024-10-16 15:27:40 +00:00
Linux & Mac:
2024-10-17 07:38:29 +00:00
2024-10-16 15:27:40 +00:00
```
/home/user/.config/nvim/init.vim
```
2024-10-17 07:38:29 +00:00
2024-10-16 15:27:40 +00:00
Windows:
2024-10-17 07:38:29 +00:00
2024-10-16 15:27:40 +00:00
```
~/AppData/Local/nvim/init.vim
```
### Node.js:
2024-10-17 07:34:50 +00:00
* 👉 I also recommend having [Node.js](https://nodejs.org/en) installed.
* 👉 Next, install the [Live-server](https://www.npmjs.com/package/live-server) in Node.js using npm and `live-server`.
* 👉 In your project, you will be able to run your index.html using the `npx live-server` command.
* 👉 For proper LSP functionality, install the following packages:
2024-10-16 15:27:40 +00:00
[vscode-html-language-server](https://github.com/microsoft/vscode-html-languageservice)
[vscode-css-language-server](https://github.com/microsoft/vscode-css-languageservice)
[typescript-language-server](https://github.com/typescript-language-server/typescript-language-server)
[emmet-ls](https://github.com/aca/emmet-ls)
[tailwindcss-language-server](https://github.com/tailwindlabs/tailwindcss-intellisense/blob/master/packages/tailwindcss-language-server/README.md)
[marksman](https://github.com/artempyanykh/marksman)
[markdoc-ls](https://github.com/markdoc-extra/markdoc-ls)
[eslint](https://eslint.org/docs/latest/use/getting-started)
### Neovim:
2024-10-17 07:34:50 +00:00
* 👉 Pro instalaci 🚀 ApolloNvim Distra stačí stáhnout si pouze soubor init.vim s tohoto repositáře.
* 👉 Uložte ho do kořenováho adresáře `~/.. /nvim` dle tvého OS. **Nezapomeňte na zálohu stávajících souborů**
* 👉 Neovim pustíte v terminálu příkazem `nvim`.
* 👉 Odklikejte chybová hlášení.
* 👉 V Neovimu zadejte do command line `PlugInstall` , tím nainstalujete všechny pluginy. Restartujte Neovim.
* 👉 Pokud Vám některý plugin chybí, můžete lehce doinstalovat nebo odinstalovat pomocí `vim.plug`. Více informací najdete na GitHubu [vim.plug](https://github.com/junegunn/vim-plug) nebo velmi rád poradím viz. o nás.
* 👉 Pokud některý plugin nechcete používat stačí ho v souboru `init.vim` zakomentovat pomocí dvojitých uvozovek `"`.
* 👉 Do command line ještě zadejte Coc příkaz, pro doinstalování zbylých pluginů `CocInstall coc-tailwindcss coc-json coc-html-css-support coc-html coc-emmet coc-xml coc-tsserver coc-lsp-wl coc-lit-html coc-htmldjango coc-css coc-markdown-preview-enhanced coc-phpls`. A ještě jednou restartujte Neovim a vše máte připravené.
* 👉 Pokud se Vám vše nechce instalovat ručně můžete stáhnout tento repožitář a nainstalujte si pouze `vim.plug` (jak nainstalovat vim.plug najdeš výšše) a pak stačí jen použít příkaz `:PlugInstall` a vše Vám bude hned fungovat.
* 👉 Tuto konfiguraci používám na Linuxu i MacOS. Je odzkoušena i na Windows 11.
### Plán 🚀ApolloNvim:
* 👉 [] Do budoucna můžete očekávat tyto nové funkce a další novinky:
- 👉 [] Instalátor ApolloNvim Distra stačí stáhnout si pouze soubor init.vim s tohoto repositáře.
* 👉 Uložte ho do kořenováho adresáře `~/.. /nvim` dle tvého OS. **Nezapomeňte na zálohu stávajících souborů**
* 👉 Neovim pustíte v terminálu příkazem `nvim`.
* 👉 Odklikejte chybová hlášení.
* 👉 V Neovimu zadejte do command line `PlugInstall` , tím nainstalujete všechny pluginy. Restartujte Neovim.
* 👉 Pokud Vám některý plugin chybí, můžete lehce doinstalovat nebo odinstalovat pomocí `vim.plug`. Více informací najdete na GitHubu [vim.plug](https://github.com/junegunn/vim-plug) nebo velmi rád poradím viz. o nás.
* 👉 Pokud některý plugin nechcete používat stačí ho v souboru `init.vim` zakomentovat pomocí dvojitých uvozovek `"`.
* 👉 Do command line ještě zadejte Coc příkaz, pro doinstalování zbylých pluginů `CocInstall coc-tailwindcss coc-json coc-html-css-support coc-html coc-emmet coc-xml coc-tsserver coc-lsp-wl coc-lit-html coc-htmldjango coc-css coc-markdown-preview-enhanced coc-phpls`. A ještě jednou restartujte Neovim a vše máte připravené.
* 👉 Pokud se Vám vše nechce instalovat ručně můžete stáhnout tento repožitář a nainstalujte si pouze `vim.plug` (jak nainstalovat vim.plug najdeš výšše) a pak stačí jen použít příkaz `:PlugInstall` a vše Vám bude hned fungovat.
* 👉 Tuto konfiguraci používám na Linuxu i MacOS. Je odzkoušena i na Windows 11.
### Plán 🚀ApolloNvim:
* 👉 [] Do budoucna můžete očekávat tyto nové funkce a další novinky:
- 👉 [] Instalátor ApolloNvim Distra stačí stáhnout si pouze soubor init.vim s tohoto repositáře.
2024-10-16 15:27:40 +00:00
* 👉 Uložte ho do kořenováho adresáře `~/.. /nvim` dle tvého OS. **Nezapomeňte na zálohu stávajících souborů**
* 👉 Neovim pustíte v terminálu příkazem `nvim`.
* 👉 Odklikejte chybová hlášení.
* 👉 V Neovimu zadejte do command line `PlugInstall` , tím nainstalujete všechny pluginy. Restartujte Neovim.
* 👉 Pokud Vám některý plugin chybí, můžete lehce doinstalovat nebo odinstalovat pomocí `vim.plug`. Více informací najdete na GitHubu [vim.plug](https://github.com/junegunn/vim-plug) nebo velmi rád poradím viz. o nás.
* 👉 Pokud některý plugin nechcete používat stačí ho v souboru `init.vim` zakomentovat pomocí dvojitých uvozovek `"`.
* 👉 Do command line ještě zadejte Coc příkaz, pro doinstalování zbylých pluginů `CocInstall coc-tailwindcss coc-json coc-html-css-support coc-html coc-emmet coc-xml coc-tsserver coc-lsp-wl coc-lit-html coc-htmldjango coc-css coc-markdown-preview-enhanced coc-phpls`. A ještě jednou restartujte Neovim a vše máte připravené.
* 👉 Pokud se Vám vše nechce instalovat ručně můžete stáhnout tento repožitář a nainstalujte si pouze `vim.plug` (jak nainstalovat vim.plug najdeš výšše) a pak stačí jen použít příkaz `:PlugInstall` a vše Vám bude hned fungovat.
* 👉 Tuto konfiguraci používám na Linuxu i MacOS. Je odzkoušena i na Windows 11.
### Plán 🚀ApolloNvim:
* 👉 [] Do budoucna můžete očekávat tyto nové funkce a další novinky:
- 👉 [] Instalátor 🚀 ApolloNvim přes odkaz z Gitu.
- 👉 [] Nová vlastní uvítací obrazovka.
- 👉 [] Nové pluginy.
- 👉 [] Návody k pluginům, jak nastavit a jak s nimi pracovat.
- 👉 [] Návody k práci s Neovim.
### Otázky a odpovědi:
* 👉 Kolik stojí 🚀 ApolloNvim? -> Nic 🚀 ApolloNvim je zdarma.
* 👉 Jak je moc složitý 🚀 ApolloNvim? -> 🚀 ApolloNvim je možná složitější než ostatní editory, ale jak se sním človek naučí zjistí jak je skvělý editor.
### Kontakty:
* 👉 [🚀 ApolloNvim Telegram skupina](https://t.me/+o6qcLGlFROJhNzhk)
* 👉 [Osobní web autora 🚀 ApolloNvim ](https://lukaskanka.cz/)
### Podpora:
* 👉 Pokud jakkoliv chcete podpořit nebo se podílet na obsahu a funkčnosti 🚀 ApolloNvim, budu rád, když mi zde napíšete.
* 👉 Taky můžete tento projekt podpořit pár Satoshi:
![SAT](https://lukan.cz/wp-content/uploads/2024/03/sat-150x150.jpeg)
### Další projekty a odkazy:
* 👉 [ArchLinux CZ](https://arch-linux.cz/)
* 👉 [Vyhledávač SearXNG CZ](https://searxng.cz/)
* 👉 [EndeavourOS Linux](https://endeavouros.cz/)
* 👉 [i3 window manager](https://i3wm.org/)