ApolloNvim/README-ENGLISH.md
2024-10-19 19:34:48 +02:00

173 lines
12 KiB
Markdown

# 🚀 ApolloNvim Distro 2024
#### Verzion: 24.10
#### 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.
* 👉 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.arch-linux.cz/kankys/zellij-mySetup), but it's not a requirement, of course.
## Advantages:
* 👉 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.
* 👉 [Hlchunk](https://github.com/shellRaining/hlchunk.nvim) propojí kód vertikálními lajny..
* 👉 [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:
- 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:
* 👉 [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.
* 👉 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:
* 👉 [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.
## 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!!!
Linux & Mac:
```
/home/user/.config/nvim/init.vim
```
Windows:
```
~/AppData/Local/nvim/init.vim
```
### Node.js:
* 👉 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:
[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:
* 👉 To install 🚀 ApolloNvim Distro, just download the init.vim file from this repository.
* 👉 Save it in the root directory `~/.. /nvim` according to your OS. **Don't forget to backup your existing files**.
* 👉 You can run neovim in the terminal with the `nvim` command.
* 👉 Click the error messages.
* 👉 In Neovim, type `PlugInstall` in the command line to install all plugins. Restart Neovim.
* 👉 If you are missing a plugin, you can easily install or uninstall it using `vim.plug`. For more information, please visit [vim.plug](https://github.com/junegunn/vim-plug) on GitHub or I'd be happy to advise you see about us.
* 👉 If you do not want to use a plugin, just comment it out in the `init.vim` file using double quotes `"`.
* 👉 Enter the Coc command in the command line to install the remaining plugins `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`. Reboot Neovim once more and you're all set.
* 👉 If you don't want to install everything manually you can download this repository and install only vim.plug (see above for how to install vim.plug) and then just use the `:PlugInstall` command and everything will work right away.
* 👉 I use this configuration on both Linux and macOS. It is also tested on Windows 11.
### Plans 🚀ApolloNvim:
- 👉 You can expect these new features and more in the future:
- 👉 New custom welcome screen.
- 👉 New plugins.
- 👉 Tutorials on plugins, how to set them up and how to work with them.
- 👉 Instructions for working with Neovi.
### Questions and Answers:
* 👉 How much does 🚀 ApolloNvim cost? -> Nothing 🚀 ApolloNvim is free.
* 👉 How complicated is 🚀 ApolloNvim? -> 🚀 ApolloNvim may be more complicated than other editors, but once you learn how to use it, you'll find out how great it is.
### Contact:
* 👉 [🚀 ApolloNvim in Telegram](https://t.me/+o6qcLGlFROJhNzhk)
* 👉 [Personal website autours 🚀 ApolloNvim ](https://lukaskanka.cz/)
### Support:
* 👉 If in any way you want to support or contribute to the content and functionality of 🚀 ApolloNvim, I'd be happy to hear from you.
* 👉 You can also support this project with a few Satoshi:
![SAT](https://lukan.cz/wp-content/uploads/2024/03/sat-150x150.jpeg)
### Other projects and links:
* 👉 [ArchLinux CZ](https://arch-linux.cz/)
* 👉 [Search web SearXNG CZ](https://searxng.cz/)
* 👉 [EndeavourOS Linux](https://endeavouros.cz/)