vimwiki使用技巧

vimwiki強大的功能即是markdown語法的使用和強大的html輸出，所以，若是可以很好的使用這個插件，寫一些可以在網頁上顯示的內容，如博客等很是強大（github上建博客對於技術人員來講很流行），那麼，咱們就開始把。

基本vim語法以下：

= 一級標題 =  
== 二級標題 ==
=== 三級標題 ===
這次類推。

當標題前面有空白時，標題文本居中對齊。
       = 我是居中的標題 =

*粗體*  _斜體_  ~~刪除線~~   `Some Code 代碼` 

注意 這幾個針對文本格式的標籤，都要求左右留有空白。
請注意你的代碼高亮，通常來講，有了相應的高亮，你用的wiki標籤才生效。

^上^標  ,,下,,標

    四個空格縮進的內容會被轉成blockquote
    
{{{ class="brush:php"
這中間的內容會被放到一個 pre 裏，適合貼代碼。
上面的 class 是可選的，通常用來安排代碼高亮。
事實上，這一塊代碼展現就是放在了一個 pre 裏。
}}}

WikiItem  大寫開頭的駝峯英文會被自動看成一個維基詞條，並添加連接
[[Wiki Item]]  這是手動創建維基詞條的方式
[[wiki item|description]]  輸出HTML時顯示description，鏈到 wiki item
http://ktmud.com/  外部URL會被自動轉換成連接
[http://ktmud.com Ktmud]  帶文字的外鏈
[images/hello.jpg] 輸出 <img src="images/hello.jpg" />
[[images/hello.jpg]] 輸出圖片，並鏈向圖片地址

* 無序列表 條目一
* 無序列表 條目二 
  - 子列表 條目一
  - 自列表 條目二

# 有序列表 條目一
# 有序列表 條目二

* 和 - 是等價的，後面必須跟一個空格

特殊佔位符：

在wiki條目中使用如下佔位符，能對生成的HTML文件作一些特殊的處理。
    %toc 自動生成的目錄
    %title 指定HTML文檔的title，建議放到文檔最末尾。若是不指定，title 就是文件名
    %nohtml 告訴 vimwiki 不爲某條目生成HTML文件。即便你在該條目打開時爲它單獨執行 :Vimwiki2HTML ，也不會生成

鍵操做：

快捷鍵總覽
    <leader>ww 在當前窗口打開維基首頁
    <leader>wt 在新tab打開維基首頁
    <leader>w<leader>w 打開/新建當天日記
    <leader>w<keader>t 在新tab打開/新建當天日記
    <leader>ws 選擇維基項目（詳見下面的「多個維基項目」一節）

還沒有創建的詞條會被顯示爲紅色（或其餘你的 Vim 語法高亮定義的錯誤顏色），在詞條上敲回車鍵，能夠編輯這個詞條。點擊 Shift-回車，在新的分割窗口編輯該詞條。編輯好之後點擊退格（Backspace）鍵，能夠返回鏈入頁
    使用 Tab 鍵，能夠跳到下一個維基詞條或連接，使用 Shift-Tab 跳到上一個
    插入模式下使用Shift-Enter，插入 <br> 並換行
    在標題上點擊 - 和 = （也就是 - 和 + ），能夠分表提高和下降標題層級

另有條目管理相關的快捷鍵 <leader>wd 和 <leader>wr ，分表表明刪除和重命名當前條目。其中重命名條目很強大，還能更改全部其餘條目內引用了該條目的連接。 重命名以後別忘了從新生成全部條目的HTML。

更改一點默認配置

轉自：http://wiki.ktmud.com/tips/vim/vimwiki-guide.html

" vimwiki
 
"     是否在詞條文件保存時就輸出html  這個會讓保存大詞條比較慢
      因此我默認沒有啓用  有須要的話就把這一行復制到下面去
"     \ 'auto_export': 1,
 
" 多個維基項目的配置
let g:vimwiki_list = [{'path': 'E:/My Dropbox/vimwiki/',
      \ 'html_header': 'E:/My Dropbox/Public/vimwiki_template/header.htm',
      \ 'html_footer': 'E:/My Dropbox/Public/vimwiki_template/footer.htm',
      \ 'diary_link_count': 5},
      \{'path': 'Z:\demo\qiuchi\wiki'}]
 
" 對中文用戶來講，咱們並不怎麼須要駝峯英文成爲維基詞條
let g:vimwiki_camel_case = 0
 
" 標記爲完成的 checklist 項目會有特別的顏色
let g:vimwiki_hl_cb_checked = 1
 
" 個人 vim 是沒有菜單的，加一個 vimwiki 菜單項也沒有意義
let g:vimwiki_menu = ''
 
" 是否開啓按語法摺疊  會讓文件比較慢
"let g:vimwiki_folding = 1
 
" 是否在計算字串長度時用特別考慮中文字符
let g:vimwiki_CJK_length = 1
 
" 詳見下文...
let g:vimwiki_valid_html_tags='b,i,s,u,sub,sup,kbd,del,br,hr,div,code,h1'

作一個你本身的模板

vimwiki 生成的HTML會都會連接相應vimwiki_html目錄下的style.css。若是你不本身指定，它會自動生成一個默認的。CSS禪意花園的境界是 什麼來着，僅僅修改 style.css 就能擁有風格徹底不一樣的頁面。經過簡單修改 style.css ，你徹底能夠創造本身風格的維基站。加上自定義文檔頭部和尾部的功能，折騰出一個我的網站來綽綽有餘。固然，若是你還在想新聞列表，feed訂閱什麼的， 請趕快走開。畢竟， vimwiki 不是 CMS 。

惋惜的是，並不能指定一個 style.css 的模板，若是你還折騰了一些 JavaScript 加強，就更麻煩了。須要的話請自行把相關文件複製過去吧。固然，你也能夠直接把本頁面另存爲，使用個人模板！具體實現請本身折騰。