LGJ Notes

自動去除不必要的空白

EdwardLee — Sun, 31 May 2009 13:00:32 +0800

在寫文章時，常會留些不小心留下的空白，例如行尾多了一堆空白，或者文章結束後多了一堆空白行。以下這是以前在 mailing list 上看到的，作者是 Vigil。把他寫入 .vimrc 就可以了，文件存檔時就會自動去除這些不必要的空白（diff 檔不會去更動）：

" Remove trailing whitespace when writing a buffer, but not for diff files.
" From: Vigil 
function RemoveTrailingWhitespace()
    if &ft != "diff"
        let b:curcol = col(".")
        let b:curline = line(".")
        silent! %s/\s\+$//
        silent! %s/\(\s*\n\)\+\%$//
        call cursor(b:curline, b:curcol)
    endif
endfunction
autocmd BufWritePre * call RemoveTrailingWhitespace()

留言處：
http://hyperrate.com/thread.php?tid=11373

利用 Vim 來編修 PDF 檔

EdwardLee — Tue, 03 Apr 2007 22:39:29 +0800

看到這種標題會不會很心動？別急，我只是說「編修」，而不是「編輯」，意思就是在修改 PDF 結構內容而言的，但這樣就已經不錯用了。

當然，這不是 Vim 本身就有的功能，Vim 只不過是一個單純的編輯器，雖然他有 binary mode，但編輯 binary 檔，那內容就像天書一樣，一般人是無法編輯的。

這是靠 pdftk 當後端，由 pdftk 去給處理後輸出，要不然 PDF 格式是 binary 檔，一不小心就會破壞內容，甚至無法再閱讀。pdftk 是專門處理 PDF 檔的一個工具，可以讓 PDF 加密、合併幾個 PDF 檔、把一個 PDF 檔分成好幾個小檔、填入 PDF forms 的資料、加浮水印、解開 PDF 附加檔（attachment）……等等。

首先，當然是要安裝好 pdftk，然後下載 pdftk.vim.zip 解開這個 Vim plugin 檔，置於：$HOME/.vim/plugin 目錄中，重新啟動 vim 就有這個功能了。

這當然不是 WYSIWYG 的去編輯 PDF 檔，而是去編輯經過 pdftk 解開的 PDF Page Stream，編修後再由 pdftk 回復為原 PDF Page Stream。所以，他主要是在編修一些作者、文件標題之類的內容，而不是去編修真正的內文。但如果是不嵌入字型的 PDF 檔，也是可以編修內文的。

這裡只舉一個例子，那就是替 PDF 檔加上作者資訊，其他的編修功能就得視你對 PDF 規格瞭解多少而定了。

通常一般 PDF 檔常常會沒有作者資訊，有些是忘了加進去，有些是一開始沒有想加進去，後來才想到要加進去。以這個 ctest-orig.pdf 為例，以 kpdf 或 acroread 開啟的話，會發現作者為 unkonwn：

我們現用 vim 開啟他。加上作者欄位（Author），並存檔：

現在我們來看看，修改過後的 PDF 檔：

現在我們加入中文試看看（請不要嚇到了！）：

那一堆天書般的英數字是什麼呢？這是 UTF-16BE 的編碼，可以參考《找尋字碼》及《LaTeX 中文 PDF outline》這兩篇文章來轉換，前面那個 feff 是必要的。現在來看一下 PDF 的結果：

其他的就請自行參考 PDF 的規格來做編修的動作了。

許功蓋：中文字的替換

EdwardLee — Mon, 28 Aug 2006 21:44:33 +0800

現在許多人都使用 UTF-8 的環境了。但是由於一些包袱，無法完完全全的轉移到 UTF-8 環境，例如一些舊文件、舊程式。幸好 Vim 對各地區性編碼都有支援，包括了我們的 Big-5 碼。

處理 Big-5 碼，最讓人頭疼的就是著名的『許功蓋』的問題，這些字，含有一些一般環境不被認同的字元，會被當做其他解釋，這時處理時就會誤解為其他含意，而不是原來的中文字了。

例如，我們想把文章中的『許』替換成『麼』，我們用 sed/awk/perl/ruby 來試試看（以下是在 Big-5 環境）：

[edt1023@lgj ~]$ sed -i -e 's/許/麼/' bg5.txt
sed: 1: "s/許/麼/": unterminated substitute in regular expression

[edt1023@lgj ~]$ awk 'gsub(/許/,"麼") {print}' bg5.txt
awk: non-terminated regular expression 許/,"麼") ... at source line 1
 context is
         ﹥﹥﹥  ﹤﹤﹤ 
awk: syntax error at source line 1
        missing )
awk: bailing out at source line 1

[edt1023@lgj ~]$ perl -pi -e 's/許/麼/' bg5.txt
Substitution replacement not terminated at -e line 1.

[edt1023@lgj ~]$ ruby -pi -e 'gsub(/許/,"麼")' bg5.txt
-e:1: unterminated string meets end of file
-e:1: parse error, unexpected tSTRING_END, expecting
tSTRING_CONTENT or tREGEXP_END or tSTRING_DBEG or 
tSTRING_DVAR

看到了嗎？通通不行！

因為這些程式是以 single byte 的方式來處理，並不認得我們 Big-5 碼的 double byte 的編碼方式，會從中去切開來解析，碰到特殊字元就會被解讀成另外一個意義去了。

Vim 可以支援 locale，他會視 locale 的設定來變換該使用的編碼環境，我們就來使用 vim 試試看：

vim --noplugin -esn -c %s/許/麼/g -c wq! bg5.txt

他是 OK 的，能很順利的處理 Big-5 中文，不怕『許功蓋』的問題。但是這有一個缺點，那就是不接受 sh pattern，例如 *.txt 之類的，來進行多檔處理。不過，在 sh 下，我們可以利用 sh for loop 來達成多檔處理的目的：

for f in *.txt
do
  vim --noplugin -esn -c %s/許/麼/g -c wq! $f
done

這樣就成了。vim 後所接的參數主要是不讓他進入 vim 編輯器，也可以去處理檔案，並把一些不必要的東西不去載入，改用 ex mode，來加快他的啟動速度。Vim 也是可以拿來這樣用喔！:-D

【更正：Tue Sep 5 18:29:38 CST 2006】
Ruby 可以指定編碼的方式來避開『許功蓋』的問題：

ruby -Ke -pi -e 'gsub(/么/,"麼")' bg5.txt

感謝 luke（小路）的指正。python 雖然也可以指定編碼，但他是以註解的方式來表現，無法用於命令列的一行文行形式。perl 也是可以指定編碼，但只對 stdin/stdout 有效，要使用 pipe 的方式來達成，無法就地編輯的方式來達成。

Vim7 的新功能

EdwardLee — Thu, 18 May 2006 20:32:58 +0800

Vim 已經在這個月八號釋出 7.0 正式版，Vim 的作者 Bram 也已經找到了全職工作，所以，這個版本意義重大，因為，將來 Bram 能花在 Vim 的時間將會減少。我們就來看看 Vim7 有了些什麼實用的新功能。

getscript plugin

:GetLatestVimScripts
  或
:GLVS

會從 sourceforge 線上更新最新的 Vim script。

vimball plugin

這是 Vim 檔案打包的新方式。例如我事先編輯好（或直接寫在目前 vim 正在編輯的檔案內容上亦可）欲打包的檔案（使用相對路徑）。例如在我的 ~/.vim 目錄中有：

~/.vim/doc/vifm.txt
~/.vim/plugin/vifm.vim

就可以編輯：

doc/vifm.txt
plugin/vifm.vim

只寫相對目錄，且每個檔案佔一行。假設，以上分別是在第一、二行，那麼要打包的話下指令：

:1,2MkVimball vifm

這樣就會在目前工作目錄上打包成 vifm.vba（VimBall Archive）這個檔案。現在我散佈給其他人，他就可以收到這個 vifm.vba 後，直接由 vim 打開他：

vim vifm.vba

可以看他的內容，覺得滿意，想安裝的話，執行：

:so %

就會安裝這些檔案（安裝在家目錄）。

spell 拼字檢查，已整合進 Vim7，變成是內建的功能了

:set spell
打開這個功能。或更進一步的指定：
:setlocal spell spelllang=en_us
關閉：
:set nospell

反白的部份是不認得的字。所以，除非你有個好的字典檔，否則文件容易變成大花臉，比較好的作法是，要用的時候才打開，用完後關閉。

]s 移至下一個拼錯或罕用的字。
[s 移至上一個拼錯或罕用的字。
]S 同 ]s，但只認完全拼錯的字。
[S 同 [s，但只認完全拼錯的字。
z= 檢查游標所在處的建議 words。
zg 加字於家目錄的字典檔。undo 鍵：zug，移除該字。
zw 同 zg，但標示此字為完全錯誤的字。undo 鍵 zuw，移除該字。

字典檔的格式和 Mozilla/OO.o 使用的 Myspell affix 壓縮檔相類似：

http://lingucomponent.openoffice.org/spell_dic.html
http://lingucomponent.openoffice.org/affix.readme

Vim 可以經由 :mkspell 指令可以將 Myspell 的 *.aff/*.dic 轉換成 Vim 使用的 *.spl/*.sug。當然要從純文字檔來轉換也是可以的。另外，Vim 有延伸他的功能，亦即也支援 Hunspell。詳細請 :help spell。

Omni 智慧型單字補全（completion）

這是在 insert mode 就可以把一些單字補全的功能，相當實用。

以 Ruby 為例：

:setlocal omnifunc=syntaxcomplete#Complete

這樣在編輯 Ruby 碼程式時，在鍵入 req 後，按 c-x c-o，就會自動補全為 require，有多種可能時，會列出選單供選擇。

內建 grep 功能

:vim[grep]

這個功能和 :grep 其實是一樣的，但目前已經內建於 Vim，不必再外部呼叫 grep 程式了，好處就是可以和 / 尋找功能一樣的方便使用，使用上整合流利，也支援壓縮檔及 remote 搜尋。例如：

:vim /require/ *.rb

vim 會開啟第一個找到的檔案，並把游標置於所找到的關鍵字上，要開啟第二個檔，可以下 :cn 指令，他的相反指令是 :cp 或 :cN。要知道目前所編輯的檔案是所找到的哪一個檔，可以下 :cc 指令，在狀態列會顯示。

CJK 列印

:hardcopy            ==> 直接送印表機
:hardcopy > some.ps  ==> 轉出所指定的 ps 檔。

用於中文文件，要設定好所使用的字型，以我個人 .vimrc 的例子：

set printmbcharset=ETEN
set printmbfont=r:MOESung-Regular
set printoptions=paper:A4

這會使用 MOESung-Regular 字型。但這個 ps 檔是不內嵌字型的，只指定字型名稱。這在目前的 gs8 可能會有問題，如有需要，可試著以下的方式來處理：

取得： MOESung-Regular

cd /usr/share/ghostscript/8.15/Resource
mkdir CIDFont
cd CIDFont
cp yourpath/MOESung-Regular .

即可。

這裡只是簡單的介紹，其他還增加許多功能，包括新的選項、新的 Vim script 函式及指令，詳細請：

:help version7.txt

Vi 的啟動方式

EdwardLee — Tue, 09 May 2006 20:13:22 +0800

Vi 的表兄弟姊妹很多，而各 OS/distro 所使用的預設 vi 又不太一樣，例如 FreeBSD/Debian 預設是使用 nvi，Slackware 預設是使用 elvis。其他的通常是使用 Vim。

而一般啟動的 vi，常常使用 symbolic link 的方式連結至可執行檔。或者，編譯出兩種不同的 vim，來做不同用途的連結，又或者，預設所連結的並不是 vim。

我個人的 Vi clone，通常是自行編譯的，因為 OS/distro 所附上的，常常不合我所需，而我也不喜歡檔案連來連去，所以就寫了一個 sh script，名字就是 vi，來啟動系統上所存在的真正可執行檔。會這麼做是因為，如果我正在更新 Vim 時，那麼就沒有 vim 可以用，那當初如果是 link 到 vim 的 vi 就無法啟動了。

以下是 vi (sh script) 的內容：

#!/usr/bin/env sh
# vim:ts=2 sw=2 et
# vi.sh :
# Edward G.J. Lee (04/26/06)

hasvi()
{
  which $1 > /dev/null 2>&1
  echo $?
}

if [ `hasvi vim-nox` = '0' ];then
  exec vim-nox "$@"
elif [ `hasvi vim` = '0' ];then
  exec vim "$@"
elif [ `hasvi vim7` = '0' ];then
  exec vim7 "$@"
elif [ `hasvi elvis` = '0' ];then
  exec elvis "$@"
elif [ `hasvi nvi` = '0' ];then
  exec nvi "$@"
elif [ `hasvi e3` = '0' ];then
  exec e3vi "$@"
else
  echo
  echo "You didn't install any vi clone!"
  echo
  exit
fi

其中的 vim-nox 就是另行編譯，沒有 GUI，但有一般基本編輯需要的功能的 vim，讓啟動可以快一點，當做是一般用途要用的 vi。

那個 e3 則是目前我所見過的最小的編輯器，他是使用組語來寫的，可以模擬 vi, emacs, wordstar, pico, nedit 等編輯器，e3vi 則預設執行的就是 vi 模式。我的系統上一定會編譯一個 e3 當成備胎來用，以防因某種原因而沒有 vi 可以用，他的可執行檔大小才 13323 bytes，夠小了吧！:-) 而且他跟本就不需要 [g]libc 就可以正常執行。

這樣，系統有什麼樣子的 vi 就會去呼叫這個 vi，不怕開天窗了，他會依順序去找系統上所有可以用的 vi clone 來執行，當然其中的喜好順序可以自行依自己喜好來調整。

更改 Vim 各項目的顏色

EdwardLee — Sun, 04 Dec 2005 20:04:26 +0800

Vim 裡頭會顯示各種顏色，不同的部份使用不同的顏色，這些顏色要怎麼知道使用了什麼顏色，及要如何修改他呢？

最簡單得知目前 Vim 的顏色配置的方法就是：

:highlight

這樣就會顯示目前的顏色配置，想更改其中的一個項目，可以直接在 Vim 的冒號命令列來修改，也可以把他設定在 $HOME/.vimrc 中，例如：

hi Visual ctermfg=brown ctermbg=gray gui=bold guifg=gray guibg=brown

其中 hi 是 highlight 的縮寫，Visual 是我們要更改的項目，就是反白時的顏色顯示，其他的由字義就可以知道他的意思，有 gui 字樣的，當然就是 GVim 時的顏色，沒有 gui 字樣的，就是在 console 或 X terminal 下顯示的顏色。bg 指的是背景顏色，fg 指的前景的顏色。