evil-basics: update for mkdocs

resolve: #333

Author: practicalli-johnny

docs/spacemacs-basics/evil-g-menu.md

@@ -1,7 +1,8 @@
 # Evil G menu
+
 `g` in normal mode opens a menu of convenient utilities.  Practicalli uses this menu to comment existing lines, edit with multiple cursors, jumping to top or bottom of the buffer and joining lines together.
 
-[![Spacemacs Vim Normal - g menu](/images/spacemacs-vim-normal-g-menu.png)](/images/spacemacs-vim-normal-g-menu.png)
+![Spacemacs Vim Normal - g menu](https://github.com/practicalli/graphic-design/blob/live/editors/spacemacs/screenshots/spacemacs-vim-normal-g-menu.png?raw=true)
 
 
 ## Comment lines and regions
@@ -11,7 +12,7 @@
 
 
 ## Multiple cursors
-`g r` is the menu for [multiple cursors](/spacemacs-basics/evil-tools/multiple-cursors.md), allowing simultaneous editing at multiple points
+`g r` is the menu for [:fontawesome-solid-book-open: multiple cursors](/spacemacs/spacemacs-basics/evil-tools/multiple-cursors/), allowing simultaneous editing at multiple points
 
 `12 gr j` will add a cursor to the 12 lines below the current cursor, using the same position in the line.  Any edits are applied to all cursors.
 
@@ -29,11 +30,11 @@
 
 
 ## Workspaces
-`g t` to switch to next [workspace](working-with-projects/layouts.md), `g T` to switch to previous.
+`g t` to switch to next [:fontawesome-solid-book-open: workspace](/spacemacs-basics/working-with-projects/layouts/), `g T` to switch to previous.
 
 
 ## Changing text case
 `g u` to change the current character or selection to lowercase, `g U` for uppercase.
 
-> #### Hint::Toggle case with `~`
-> `~` will toggle the case of the current character or selected region.
+!!! HINT "Toggle case with `~`"
+    `~` will toggle the case of the current character or selected region.

docs/spacemacs-basics/evil-tools/helm-swoop.md

@@ -8,7 +8,7 @@ Search a buffer (Clojure namespace) or project and use the results to navigate t
 
 `SPC s S` assumes word under cursor is the symbol you wish to search for.
 
-helm-swoop is also available in the [symbol highlight transient menu](/navigating-code/names-symbols.md).
+helm-swoop is also available in the [:fontawesome-solid-book-open: symbol highlight transient menu](/spacemacs/navigating-code/names-symbols/).
 
 
 | Keybindings | Description                  |
@@ -22,5 +22,5 @@ For example, navigate to a function definition and all the places that function
 
 ![Helm multi-swoop](https://raw.githubusercontent.com/ShingoFukuyama/spacemacs/images/master/helm-multi-swoop.gif)
 
-> #### Hint::Refactor code
-> [Refactor section](/refactor/) provides examples of using helm-ag, helm-swoop, iedit, narrowing and clj-refactor.
+!!! HINT "Refactor code"
+    [:fontawesome-solid-book-open: Refactor section](/spacemacs/refactor/) provides examples of using helm-ag, helm-swoop, iedit, narrowing and clj-refactor.

docs/spacemacs-basics/evil-tools/iedit-in-action.md

@@ -26,6 +26,7 @@ Once editing the selections, use `n` to jump to next word/region and `N` to the
 
 !!! HINT "iedit and narrowing"
     iedit selects all occurrences in a buffer.  If you only want to change one part of the text (or a specific function), then you can narrow to just edit that specific region.
+
     See [narrow](narrowing.md) for more details
 
 

docs/spacemacs-basics/evil-tools/iedit.md

@@ -2,7 +2,9 @@
 
 Make multiple matching edits within a buffer
 
-`SPC s e` to start [`evil-iedit-state`](https://github.com/syl20bnr/evil-iedit-state){target=_blank} to quickly edit multiple occurrences of a symbol within a buffer or selection. Use iedit with helm-ag to [make multiple matching edits across a project](replacing-text-across-projects.md).
+`SPC s e` to start [:globe_with_meridians: `evil-iedit-state`](https://github.com/syl20bnr/evil-iedit-state){target=_blank} to quickly edit multiple occurrences of a symbol within a buffer or selection.
+
+Use iedit with helm-ag to [:fontawesome-solid-book-open: make multiple matching edits across a project](replacing-text-across-projects.md).
 
 `e` within visual state and symbol highlight transient state also enables iedit.
 
@@ -57,10 +59,10 @@ Narrowing, `SPC n`, limits the scope of iedit so only the relevant occurrences a
 | `C-U` | down-case the occurrences                                                           |
 
 !!! Hint
-> `0`, `$`, `A` and `I` have the default Vim behavior when used outside of an `occurrence`.
+    `0`, `$`, `A` and `I` have the default Vim behavior when used outside of an `occurrence`.
 
 
 ## Reference
 
-* [iedit GitHub project](https://github.com/victorhge/iedit){target=_blank}
-* [evil-iedit-state](https://github.com/syl20bnr/evil-iedit-state){target=_blank}
+- [iedit GitHub project](https://github.com/victorhge/iedit){target=_blank}
+- [evil-iedit-state](https://github.com/syl20bnr/evil-iedit-state){target=_blank}

docs/spacemacs-basics/evil-tools/index.md

@@ -1,6 +1,6 @@
 # Evil tools
 
-> #### TODO::Expand on overview, provide video overview
+!!! TODO "TODO: Expand on overview, provide video overview"
 
 
 There are several Evil tools that add text manipulation features to your [Vim style editing](/editing/vim-style/).

docs/spacemacs-basics/evil-tools/multiple-cursors.md

@@ -6,10 +6,11 @@ Multiple cursors is especially useful where lines are not entirely identical, i.
 
 Multiple cursors allows you to call all Emacs named functions and have the results output to each cursor you have created.
 
-> #### Hint::iedit or multiple cursors
-> iedit is excellent for all kinds of search and replace actions where the text to change is the same.  iedit finds all matches in a buffer or the scope created by [narrowing](narrowing.md).
->
-> Where text lines do not match but have a similar form, multiple cursors allow for more irregular changes
+!!! HINT "iedit or multiple cursors"
+    iedit is excellent for all kinds of search and replace actions where the text to change is the same.  iedit finds all matches in a buffer or the scope created by [:fontawesome-solid-book-open: narrowing](narrowing.md).
+
+    Where text lines do not match but have a similar form, multiple cursors allow for more irregular changes
+
 
 ## Common usage
 
@@ -21,12 +22,14 @@ Multiple cursors allows you to call all Emacs named functions and have the resul
 
 `g r I` adds cursors to visual selection lines, `S-v` and arrow keys, or `v 20 j` to select the next 24 lines
 
-> #### Hint::Using Narrowing to constrain where cursors are created
-> `SPC n` menu allows you to narrow the view on the current buffer
-> `SPC n f` narrows to the current function definition
-> `SPC n r` narrows to a selected range of text
->
-> See the section on [Spacemacs - Narrowing](narrowing.md)
+
+!!! HINT "Using Narrowing to constrain where cursors are created"
+    `SPC n` menu allows you to narrow the view on the current buffer
+    `SPC n f` narrows to the current function definition
+    `SPC n r` narrows to a selected range of text
+
+    See the section on [:fontawesome-solid-book-open: Narrowing](narrowing.md)
+
 
 ## Keybindings
 
@@ -46,9 +49,11 @@ The most commonly used key bindings for multiple cursors
 
 `g r` shows the full menu
 
-![Spacemacs G menu multiple cursor commands](https://raw.githubusercontent.com/practicalli/graphic-design/live/spacemacs/screenshots/menus/spacemacs-g-menu-multiple-cursors.png)
+![Spacemacs G menu multiple cursor commands](https://github.com/practicalli/graphic-design/blob/live/editors/spacemacs/screenshots/spacemacs-vim-normal-g-menu.png?raw=true)
+
+
+!!! TODO "Add video of most commonly used features"
 
-> #### TODO::Add video of most commonly used features
 
 ## Known issues
 
@@ -59,6 +64,6 @@ The most commonly used key bindings for multiple cursors
 
 ## Reference
 
-* [multiple cursors layer - Spacemacs develop documentation](http://develop.spacemacs.org/layers/+misc/multiple-cursors/README.html)
-* [evil-mc](https://github.com/gabesoft/evil-mc) - default backend for multiple cursors layer
-* [evil-multiedit](https://github.com/hlissner/evil-multiedit) - used in Doom Emacs
+- [:globe_with_meridians: multiple cursors layer - Spacemacs develop documentation](http://spacemacs.org/layers/+misc/multiple-cursors/README.html)
+- [:fontawesome-brands-github: evil-mc](https://github.com/gabesoft/evil-mc) - default backend for multiple cursors layer
+- [:fontawesome-brands-github: evil-multiedit](https://github.com/hlissner/evil-multiedit) - used in Doom Emacs

docs/spacemacs-basics/evil-tools/narrowing.md

@@ -2,18 +2,21 @@
 
 Narrowing displays just a part of the current buffer you are working with, allowing you to carry out some very specific editing.
 
-[![Spacemacs](/images/spacemacs-narrow-numbers-menu.png)](/images/spacemacs-narrow-numbers-menu.png)
+![Spacemacs](https://github.com/practicalli/graphic-design/blob/live/editors/spacemacs/screenshots/spacemacs-narrow-numbers-menu.png?raw=true)
 
 
 Typical uses are to select a region or a function definition to narrow on.
 
-For example, you may have two Clojure functions that use the same local name in a `let` statement.  The local name is used a number of times and you want to rename it.  By narrowing on to just that function, you can change the local names all at once without affecting the other function definition.
+For example, you may have two Clojure functions that use the same local name in a `let` statement.  The local name is used a number of times and you want to rename it.
+
+By narrowing on to just that function, you can change the local names all at once without affecting the other function definition.
 
 
 ## Example: Narrowing and multiple replace
 
 In this example I narrow my 100-days-of-code log to just edit a single day of the log and use iedit to manage a multiple replace on just the text for that day.
 
-{% youtube %}
-https://www.youtube.com/watch?v=4bVMXXxPiQs
-{% endyoutube %}
+
+<p style="text-align:center">
+  <iframe width="560" height="315" src="https://www.youtube.com/embed/4bVMXXxPiQs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</p>

docs/spacemacs-basics/evil-tools/replacing-text-across-projects.md

@@ -1,7 +1,8 @@
 # Replacing text across projects
 
 If you have `ripgrep`, `ag` (silver searcher), `pt` or `ack` installed, replacing an occurrence of text in
-several files can be performed via [helm-ag](https://github.com/syohex/emacs-helm-ag).
+several files can be performed via [:fontawesome-brands-github: helm-ag](https://github.com/syohex/emacs-helm-ag).
+
 
 ## Example
 
@@ -18,9 +19,7 @@ To replace all `foo` occurrences by `bar` in your current project:
 `C-c C-c` to commit the changes you have just made, which will automatically update all the files in your project with these changes.  `C-c C-k` if you want to cancel your changes instead.
 
 
-> #### TODO::Add animated gif / video example
+!!! TODO "Add animated gif / video example"
 
----
 
-> #### Hint::
-> `helm-ag` despite its name works with all the search tools, except for `grep`
+!!! INFO "`helm-ag` works with all search tools, except grep"

docs/spacemacs-basics/evil-z-menu.md

@@ -1,10 +1,12 @@
 # Evil Z menu
+
 `z` in normal mode opens a menu of convenient utilities
 
-[![Spacemacs Vim Normal - zoom menu](/images/spacemacs-vim-normal-zoom-menu.png)](/images/spacemacs-vim-normal-zoom-menu.png)
+![Spacemacs Vim Normal - zoom menu](https://github.com/practicalli/graphic-design/blob/live/editors/spacemacs/screenshots/spacemacs-vim-normal-z-menu.png?raw=true)
 
 
 ## Folding code, comments and other content
+
 Code folding is very useful for hiding different levels of detail, for example you could hide everything but the function names in a namespace, showing just the API for that namespace.
 
 Comments and documentation can be folded to help you focus on a specific part of the content.
@@ -17,10 +19,11 @@ Comments and documentation can be folded to help you focus on a specific part of
 | `z O`      | open fold recursive (capital o)             |
 | `z r`      | open folds                                  |
 
-See [narrowing](/spacemacs-basics/evil-tools/narrowing.md) for a focused approach to editing.
+See [:fontawesome-solid-book-open: narrowing](/spacemacs/spacemacs-basics/evil-tools/narrowing.md) for a focused approach to editing.
 
 
 ## Scrolling
+
 Jump the current line to the center, top or bottom of the buffer. Evil equivalents of the Emacs `C-l` key bindings.
 
 | Keybinding | Description                                 |

docs/spacemacs-basics/evil/editing-states.md

@@ -1,6 +1,6 @@
 # Evil editing states
 
-![Spacemacs States](/images/spacemacs-states-vim.png)
+![Spacemacs - Evil states](https://github.com/practicalli/graphic-design/blob/live/editors/spacemacs/concepts/spacemacs-states-evil.png?raw=true)
 
 Each states allows keys to have different behaviour, helping minimise the cognitive load and quickly building muscle memory for very powerful actions.
 
@@ -14,22 +14,24 @@ Each states allows keys to have different behaviour, helping minimise the cognit
 
 First get familiar with **normal**, **insert** and **visual** states.  Then when you are comfortable, move on to **iedit** and **lisp** states.
 
-> #### Hint::Normal state by default
-> Evil normal state should be used most of the time, unless you are writing code or creating lots of text.
+!!! TIP "Normal state by default"
+    Evil normal state should be used most of the time, unless you are writing code or creating lots of text.
 
 
 ## Important key bindings
 
-`,` menu contains the major mode (e.g. Clojure) specific commands, organised mnemonically
+++"v"++ opens the visual state and allows you to selects text
 
-`v` opens the visual state and allows you to selects text
+++"i"++, ++"I"++, ++"a"++, ++"A"++, ++"o"++ , ++"O"++ all open insert state and allows you to type new text
 
-`i`, `a`, `o`, `O` opens insert state and allows you to create type text
+++esc++ or ++"f"++ ++"d"++ returns to Normal mode for text manipulation and leader / local leader commands
 
-`SPC s e` opens iedit and selects all matching instances of the highlighted text for editing
+++coma++ menu contains the major mode (e.g. Clojure) specific commands, organised mnemonically
 
-`SPC k` opens Lisp state, allowing you to do [structural editing](structural-editing/)
+++spc++ ++"s"++ ++"e"++ opens iedit and selects all matching instances of the highlighted text for editing
 
+++spc++ ++"k"++ opens Lisp state, allowing you to do [:fontawesome-solid-book-open: structural editing](/spacemacs/structural-editing/)
 
-> #### Hint::Refactor code tools
-> The [Refactor section](/refactor/) has further editing techniques and Clojure specific refactoring tools.
+
+!!! TIP "Refactor code tools"
+    The [:fontawesome-solid-book-open: Refactor section](/spacemacs/refactor/) has further editing techniques and Clojure specific refactoring tools.