Browse Source

Update README.md instructions and formatting

Add a first step to explicitly start the Zsh shell, as some issues were
reported before because users were skipping this. See #214 for example.

Also mention `~/.zlogin` as part of the uninstalling process.

Use the following formatting styles:
* Headers >1 are in `Sentence case`.
* The names `Zim` and `Zsh` always appear capitalized, even in the
  middle of sentences.
* Prefer

      code indented with 4 spaces

  instead of
  ```
  code fenced by lines with three back-ticks
  ```

Closes #315
Eric Nielsen 5 years ago
parent
commit
b4ae40652d
1 changed files with 32 additions and 35 deletions
  1. 32 35
      README.md

+ 32 - 35
README.md

@@ -1,5 +1,5 @@
-ZIM - Zsh IMproved
-==================
+Zsh IMproved FrameWork
+======================
 
 <div align="center">
   <a href="https://github.com/zimfw/zimfw">
@@ -26,10 +26,10 @@ For a speed comparison between Zim and other frameworks, see [this wiki entry][s
 
 To preview some of the available themes, check the [themes wiki page][themes].
 
-### Fish-shell History Navigation
+### Fish-shell history navigation
 ![history-substring-search][fish_shell]
 
-### Syntax Highlighting
+### Syntax highlighting
 ![syntax-highlighting][syntax_highlighting]
 
 ### And much more!
@@ -40,56 +40,53 @@ Installation
 Installing Zim is easy. If you have a different shell framework installed (like oh-my-zsh or prezto),
 *uninstall those first to prevent conflicts*. It can be installed manually by following the instructions below:
 
-1. In a Zsh shell, clone the repository:
-  ```
-  git clone --recursive https://github.com/zimfw/zimfw.git ${ZDOTDIR:-${HOME}}/.zim
-  ```
+1. Start a Zsh shell:
 
-2. Paste this into your terminal to prepend the initialization templates to your configs:
-  ```
-  for template_file in ${ZDOTDIR:-${HOME}}/.zim/templates/*; do
-    user_file="${ZDOTDIR:-${HOME}}/.${template_file:t}"
-    cat ${template_file} ${user_file}(.N) >! ${user_file}
-  done
-  ```
+       zsh
 
-3. Set Zsh as the default shell:
-  ```
-  chsh -s =zsh
-  ```
+2. Clone the repository:
 
-4. Open a new terminal and finish optimization (this is only needed once, hereafter it will happen upon desktop/tty login):
-  ```
-  source ${ZDOTDIR:-${HOME}}/.zlogin
-  ```
+       git clone --recursive https://github.com/zimfw/zimfw.git ${ZDOTDIR:-${HOME}}/.zim
 
-5. You're done! Enjoy your Zsh IMproved! Take some time to read about the [available modules][modules] and tweak your `.zshrc` file.
+3. Paste this into your terminal to prepend the initialization templates to your configs:
+
+       for template_file in ${ZDOTDIR:-${HOME}}/.zim/templates/*; do
+         user_file="${ZDOTDIR:-${HOME}}/.${template_file:t}"
+         cat ${template_file} ${user_file}(.N) >! ${user_file}
+       done
+
+4. Set Zsh as the default shell:
+
+       chsh -s =zsh
+
+5. Open a new terminal and finish optimization (this is only needed once, hereafter it will happen upon desktop/tty login):
+
+       source ${ZDOTDIR:-${HOME}}/.zlogin
+
+6. You're done! Enjoy your Zsh IMproved! Take some time to read about the [available modules][modules] and tweak your `.zshrc` file.
 
 Updating
 --------
 
-To update zim, run:
+To update Zim, run:
 
-```
-zmanage update
-```
+    zmanage update
 
 For more information about the `zmanage` tool, run `zmanage help`.
 
 Uninstalling
 ------------
 
-The best way to remove zim is to manually delete `~/.zim`, `~/.zimrc`, and
-remove the initialization lines from your `~/.zshrc`.
+The best way to remove Zim is to manually delete `~/.zim`, `~/.zimrc`, and
+remove the initialization lines from your `~/.zshrc` and `~/.zlogin`.
 
-However, there are some **experimental** convenience functions to remove zim:
+However, there are some **experimental** convenience functions to remove Zim:
 
 **NOTE: This functionality is experimental!**
 
-To remove zim, run:
-```
-zmanage remove
-```
+To remove Zim, run:
+
+    zmanage remove
 
 **NOTE: This functionality is experimental!**