Merge pull request #2 from vim-ctrlspace/feature_improved_tutorials

Feature improved tutorials

Author: ryrych

_posts/2015-12-01-adding_a_project_to_bookmarks.md

@@ -17,27 +17,66 @@ categories: asciicast
 change that! Fasten your seatbelts and add your first project to bookmarks
 following the steps below!
 
-```console
-$ vim
-<kbd>CTRL</kbd>+<kbd>C</kbd>
-<kbd>b</kbd>
-<kbd>a</kbd>
-⌗ Add directory to bookmarks: /Users/ryrych/projects/ember_awesome/<kbd>Enter</kbd>
-⌗ New bookmark name: Ember is Awesome Bookmark<kbd>Enter</kbd>
-```
+1. <kbd>CTRL</kbd>+<kbd>SPACE</kbd>
+2. <kbd>b</kbd>
+3. <kbd>a</kbd>
+4. *Vim-CtrlSpace* will ask you to type the path to the project
+5. Confirm the path with <kbd>Enter</kbd>
+6. Optionally you can change the bookmark name
+
+After adding the project to bookmarks, choose the project from the list using
+either:
 
-After adding the project to bookmarks, you choose the project from the list
-using <kbd>j</kbd> and <kbd>k</kbd> keys. Press <kbd>Enter</kbd> to confirm.
+- <kbd>j</kbd> and <kbd>k</kbd>
+- toggling search mode with <kbd>/</kbd> when the list is long
 
-An unnamed tab should open.
+Press <kbd>Enter</kbd> to confirm the choice. An unnamed tab should open.
 
 ```
 > [1*No Name] ★
 ```
 
-Press <kbd>o</kbd> to open project file list. Press <kbd>r</kbd> to index all files from the
-project. After indexing you should get this message:
+1. Press <kbd>o</kbd> to open project file list.
+2. Press <kbd>r</kbd> to index all project files.
+
+After indexing you should get this message:
 
 ```
 ⌗  Collecting files... Done (399).
 ```
+
+Now you’re ready to feel the power of *Vim-CtrlSpace*!
+
+## Common questions
+
+### Re-indexing — do I need it?
+
+Almost **each editor**, or *IDE* you have had experience with, **re-index
+files**. Many of them do it automatically for you. This allows for faster
+searching files. Some *IDE* like *RubyMine* can, in large projects, hang even
+a powerful *Macbook Pro*.
+
+*Vim-CtrlSpace* allows you to re-index files **manually**. Don’t worry about
+forgetting to re-index as sooner or later it’ll become your habit.
+
+### Re-indexing — when?
+
+Usually when:
+
+- Switching between *Git* (or any other *VCS*) branches
+- Regenerating *Ctags*
+- Adding or removing files
+
+Remember that you can still open the files with:
+
+- `:e file-name.rb`
+- [The NERD Tree][1]
+- [vinegar.vim][2]
+- Your favourite tool, etc.
+
+New files will not be available when **using fuzzy search** until you re-index
+them. That’s it!
+
+
+[1]: https://github.com/scrooloose/nerdtree
+[2]: https://github.com/tpope/vim-vinegar

_posts/2015-12-01-finding-bookmarked-projects.md

@@ -14,18 +14,17 @@ categories: asciicast
 
 Once you [added your first project to bookmarks][1], every time you start
 working on the project, after opening *Vim*, you have to select the project in
-*Vim-CtrlSpace*.  Fortunately it’s a walk in the park! See below how easy it is:
+*Vim-CtrlSpace*. Fortunately all you have to do is **pressing**:
 
-```console
-$ vim
-[CTRL]+[C]
-[B]
-```
+<kbd>CTRL</kbd>+<kbd>SPACE</kbd> and then <kbd>b</kbd>.
+
+## Opening projects in search mode
+
+Capital <kbd>B</kbd> **opens the project list in the search mode** so you can
+find the project faster.
 
-Capital <kbd>B</kbd> **opens the project list in a search mode** so you can start
-typing your search term.
 Alternatively you can open the list of projects with <kbd>b</kbd> and then
-open the search mode with <kbd>/</kbd>.
+open the search mode with <kbd>/</kbd>. The same applies for all lists.
 
 Opening projects in *Vim* has never been so easy!
 

_posts/2015-12-01-grouping-files.md

@@ -24,41 +24,28 @@ the project scope. This way a third tab, *Plans & goals* can be added.
 
 Will **learning Vim-CtrlSpace** land in your **2016 Plan & goals** list?
 
-```console
-$ vim
+Opening project
 
-# Open Ember project
-[CTRL]+[SPACE]
-[B]
->ember<
-[Enter]
+1. <kbd>CTRL</kbd> + <kbd>SPACE</kbd>
+2. <kbd>B</kbd>
+3. Enter project name `>ember<`
+4. Confirm with <kbd>Enter</kbd>
 
-# Search for `README.md` and open it in the current tab without closing the plugin window
-[O]
->readme<
-[enter][space]
+Finding file and opening it in the first tab
 
-# Open 3 files in a separate tab (note the `+3` indicator)
-[/]
-[CTRL]+[U]
->computed<
+1. <kbd>O</kbd>
+2. Enter file name `>readme<` and confirm with <kbd>Enter</kbd>
+3. Press <kbd>space</kbd> to add the file to the tab without closing the plugin window
 
-# Select each file with:
-[SHIFT]+[T]
+Opening another 3 files in a separate tab
 
-# Clear search term
-[/]
-[CTRL]+[U]
-[/]
+1. Open search mode with <kbd>/</kbd>
+2. Press <kbd>CTRL</kbd> + <kbd>U</kbd> to clear the previous search term
+3. Type `>computed<` to find new files
+4. Open each found file with <kbd>Shift</kbd> + <kbd>T</kbd>
 
-# Open list of tabs
-[l]
+Adding a custom tab label
 
-# Give second tab custom label
-[j]
-[=]
->Computed feature + spec<
-[Enter]
-[ESC]
-[qa]
-```
+1. Press <kbd>Backspace</kbd> to exit search mode
+2. Press <kbd>l</kbd> to open a list of tabs
+3. Press <kbd>=</kbd> to change the default label

_sass/_syntax.scss

@@ -112,3 +112,21 @@ code {
 .highlight .vg{color:#dcdccc}
 .highlight .vi{color:#ffffc7}
 .highlight .il{color:#8cd0d3}
+
+kbd {
+  font-family: Arial,Helvetica,sans-serif;
+  font-size: 11px;
+  line-height: 1.4;
+  display: inline-block;
+  margin: 0 .1em;
+  padding: .1em .6em;
+  white-space: nowrap;
+  color: #333;
+  border: 1px solid #ccc;
+  border-radius: 3px;
+  background-color: #f7f7f7;
+  -webkit-box-shadow: 0 1px 0 rgba(0,0,0,.2),0 0 0 2px #fff inset;
+  -moz-box-shadow: 0 1px 0 rgba(0,0,0,.2),0 0 0 2px #fff inset;
+  box-shadow: 0 1px 0 rgba(0,0,0,.2),0 0 0 2px #fff inset;
+  text-shadow: 0 1px 0 #fff;
+}