# AstroNvim Configuration and Shortcuts

My Neovim config based on [AstroNvim](https://github.com/AstroNvim/AstroNvim).
For more details, visit the [AstroNvim website](https://astronvim.com/).

This document outlines neovim's configuration structure and various shortcuts/commands for efficient usage.

## Configuration Structure

| Description                                       | Standard Location                           | My Location                                                               |
| ------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------- |
| Neovim's config                                   | `~/.config/nvim`                            | AstroNvim's github repository, referenced as a flake input in this flake. |
| AstroNvim's user configuration                    | `$XDG_CONFIG_HOME/astronvim/lua/user`       | [./astronvim_user/](./astronvim_user/)                                    |
| Plugins installation directory (lazy.nvim)        | `~/.local/share/nvim/`                      | The same as standard location, generated and managed by lazy.nvim.        |
| LSP servers, DAP servers, linters, and formatters | `~/.local/share/nvim/mason/`(by mason.nvim) | [./default.nix](./default.nix), installed by nix.                         |

## Update/Clean Plugins

Note that lazy.nvim will not automatically update plugins, so you need to update them manually.

```bash
:Lazy update
```

Remove all unused plugins:

```bash
:Lazy clean
```

## Screenshots

![](/_img/astronvim_2023-07-13_00-39.webp)
![](/_img/hyprland_2023-07-29_2.webp)

## Visual Modes

| Action                   | Shortcut                                 |
| ------------------------ | ---------------------------------------- |
| Toggle visual mode       | `v`                                      |
| Toggle visual block mode | `<Ctrl> + v` (select a block vertically) |

## Incremental Selection

Provided by nvim-treesitter.

| Action            | Shortcut       |
| ----------------- | -------------- |
| init selection    | `<Ctrl-space>` |
| node incremental  | `<Ctrl-space>` |
| scope incremental | `<Alt-Space>`  |
| node decremental  | `Backspace`    |

## Search and Jump

Provided by [flash.nvim](https://github.com/folke/flash.nvim), it's a intelligent search and jump plugin.

1. It enhaces the default search and jump behavior of neovim.(search with prefix `/`)

| Action            | Shortcut                                                                                                      |
| ----------------- | ------------------------------------------------------------------------------------------------------------- |
| Search            | `/`(normal search), `s`(disable all code highlight, only highlight matches)                                   |
| Treesitter Search | `yR`,`dR`, `cR`, `vR`, `ctrl+v+R`(arround your matches, all the surrounding Treesitter nodes will be labeled) |
| Remote Flash      | `yr`, `dr`, `cr`, (arround your matches, all the surrounding Treesitter nodes will be labeled)                |

## Text Manipulation

- Add at the end of multiple lines: `:normal A<text>`

  - Execublock: `:A<text>`

  - visual block mode(ctrl + v)
  - Append text at the end of each line in the selected block
  - If position exceeds line end, neovim adds spaces automatically

- Delete the last char of multivle lines: `:normal $x`

  - Execute `$x` on each line
  - visual mode(v)
  - `$` moves cursor to the end of line
  - `x` deletes the character under the cursor

- Delete the last word of multiple lines: `:normal $bD`
  - Execute `$bD` on each line
  - visual mode(v)
  - `$` moves cursor to the end of line
  - `b` moves cursor to the beginning of the last word
  - `D` deletes from cursor to the end of line

## Commands & Shortcuts

| Action                        | Shortcut       |
| ----------------------------- | -------------- |
| Learn Neovim's Basics         | `:Tutor`       |
| Open file explorer            | `<Space> + e`  |
| Focus Neotree to current file | `<Space> + o`  |
| Floating Terminal             | `<Space> + tf` |
| Horizontal Split Terminal     | `<Space> + th` |
| Vertical Split Terminal       | `<Space> + tv` |
| Open IPython REPL             | `<Space> + tp` |
| Toggle line wrap              | `<Space> + uw` |
| Show line diagnostics         | `gl`           |
| Show function/variable info   | `K`            |
| Go to definition              | `gd`           |
| References of a symbol        | `gr`           |

## Window Navigation

- Switch between windows: `<Ctrl> + h/j/k/l`
- Resize windows: `<Ctrl> + Up/Down/Left/Right`
  - Note: On macOS, conflicts with system shortcuts
  - Disable in System Preferences -> Keyboard -> Shortcuts -> Mission Control

## Splitting and Buffers

| Action                | Shortcut      |
| --------------------- | ------------- |
| Horizontal Split      | `\`           |
| Vertical Split        | `\|`          |
| Next Buffer (Tab)     | `]b`          |
| Previous Buffer (Tab) | `[b`          |
| Close Buffer          | `<Space> + c` |

## Editing and Formatting

| Action                                                | Shortcut       |
| ----------------------------------------------------- | -------------- |
| Toggle buffer auto formatting                         | `<Space> + uf` |
| Format Document                                       | `<Space> + lf` |
| Code Actions                                          | `<Space> + la` |
| Rename                                                | `<Space> + lr` |
| Opening LSP symbols                                   | `<Space> + lS` |
| Comment Line(support multiple lines)                  | `<Space> + /`  |
| Open filepath/URL at cursor(neovim's builtin command) | `gx`           |
| Find files by name (fzf)                              | `<Space> + ff` |
| Grep string in files (ripgrep)                        | `<Space> + fw` |

## Sessions

| Action                         | Shortcut       |
| ------------------------------ | -------------- |
| Save Session                   | `<Space> + Ss` |
| Last Session                   | `<Space> + Sl` |
| Delete Session                 | `<Space> + Sd` |
| Search Session                 | `<Space> + Sf` |
| Load Current Directory Session | `<Space> + S.` |

## Debugging

Press `<Space> + D` to view available bindings and options.

## Find and Replace

| Action                   | Command                             |
| ------------------------ | ----------------------------------- |
| Replace in selected area | `:s/old/new/g`                      |
| Replace in current line  | Same as above                       |
| Replace in whole file    | `:% s/old/new/g`                    |
| Replace with regex       | `:% s@\vhttp://(\w+)@https://\1@gc` |

1. `\v` means means that in the regex pattern after it can be used without backslash escaping(similar to python's raw string).
2. `\1` means the first matched group in the pattern.

## Replace in the specific lines

| Action                                    | Command                                |
| ----------------------------------------- | -------------------------------------- |
| From the 10th line to the end of the file | `:10,$ s/old/new/g` or `:10,$ s@^@#@g` |
| From the 10th line to the 20th line       | `:10,20 s/old/new/g`                   |

The postfix(flags) in the above commands:

1. `g` means replace all the matched strings in the current line/file.
2. `c` means ask for confirmation before replacing.
3. `i` means ignore case.

## Search and Replace Globally

| Description                                                  | Shortcut                                                         |
| ------------------------------------------------------------ | ---------------------------------------------------------------- |
| Open spectre.nvim search and replace panel                   | `<Space> + ss`                                                   |
| Search and replace in command line(need install `sad` first) | `find -name "*.nix" \| sad '<pattern>' '<replacement>' \| delta` |

## Surrounding Characters

Provided by mini.surround plugin.

- Prefix `gz`

| Action                         | Shortcut | Description                                     |
| ------------------------------ | -------- | ----------------------------------------------- |
| Add surrounding characters     | `gzaiw'` | Add `'` around the word under cursor            |
| Delete surrounding characters  | `gzd'`   | Delete `'` around the word under cursor         |
| Replace surrounding characters | `gzr'"`  | Replace `'` by `"` around the word under cursor |
| Highlight surrounding          | `gzh'`   | Highlight `'` around the word under cursor      |

## Text Manipulation

| Action                                 |               |
| -------------------------------------- | ------------- |
| Join Selection of Lines With Space     | `:join`       |
| Join without spaces                    | `:join!`      |
| Join with LSP intelligence(treesj)     | `<Space> + j` |
| Split Line into Multiple Lines(treesj) | `<Space> + s` |

## Convert Text Case

| Action               |     |
| -------------------- | --- |
| Toggle text's case   | `~` |
| Convert to uppercase | `U` |
| Convert to lowercase | `u` |

## Miscellaneous

| Action                       |                                              |
| ---------------------------- | -------------------------------------------- |
| Save selected text to a file | `:w filename` (Will show `:'<,'>w filename`) |
| Show all Yank History        | `:<Space> + yh`                              |
| Show undo history            | `:<Space> + uh`                              |

## Additional Resources

For more detailed information and advanced usage, refer to:

1. [AstroNvim walkthrough](https://astronvim.com/Basic%20Usage/walkthrough)
2. [./astronvim_user/mapping.lua](./astronvim_user/mappings.lua)
3. All the plugins' documentations