編輯器支援

Scintilla 文字編輯器
KDE 支援

編輯 quickbook 檔案通常使用簡單或功能強大的文字編輯器。以下章節列出了一些編輯器的設定，可以讓編輯 quickbook 檔案更容易一些。

	注意事項
	您可以將您的設定、技巧和建議提交給作者，或者透過 Boost Docs 郵件列表。

Scintilla 文字編輯器

此章節由 Dean Michael Berris 貢獻

Scintilla 文字編輯器 (SciTE) 是一個適用於 Win32 和 X 的免費原始碼編輯器。它使用 SCIntilla 原始碼編輯元件。

	提示
	SciTE 可以從 http://www.scintilla.org/SciTE.html 下載

您可以使用以下設定在編輯 quickbook 檔案時突出顯示 quickbook 標籤。

qbk=*.qbk
lexer.*.qbk=props
use.tabs.$(qbk)=0
tab.size.$(qbk)=4
indent.size.$(qbk)=4
style.props.32=$(font.base)
comment.stream.start.props=[/
comment.stream.end.props=]
comment.box.start.props=[/
comment.box.middle.props=
comment.box.end.props=]

	注意事項
	感謝 Rene Rivera 提供上述 SciTE 設定。

KDE 支援

boost::hs::quickbook

boost::hs::quickbook 是一種語法高亮顯示功能，設計用於 Katepart。它可以在 KWrite、Kate、Konqueror 和 KDevelop 中使用，並支援 Quickbook 1.4 的所有結構，包括表格、列表、模板和巨集。

在文字編輯器中載入的 .qbk 檔案
使用 boost::hs 支援載入的 .qbk 檔案

由此 .qbk 檔案產生的 html

表 48.7. 程式碼範例

名稱	程式碼	說明
for 迴圈	`for(int k=0; k<10; k++) v+=k;`	計算一些數字的總和。
while 迴圈	`{ int k; while( k < 10 ) { v+=k; k++ } }`	相同效果。
無限迴圈	`while( true ) { v+=1; }`	不是一個好例子。

程式碼摺疊

boost::hs 不僅僅是簡單的著色。您可以讓編輯器做一件有用的事情，那就是標記區域。它們顯示在一條小的灰色線上，每個區域都可以獨立地摺疊或展開。

自動註解/取消註解

另一個重要的功能是可以自動註解或取消註解某些程式碼片段（工具 - 註解）。已註解的區域可以透過在其中呼叫 取消註解 命令來取消註解。

樣式參考

名稱	樣式	說明
純文字*	一般黑色	每個層級的純文字。
格式化文字*	格式化黑色	粗體、斜體、底線和混合。電傳打字機、可替換、刪除線。
結構*	淺藍色	所有 quickbook 結構字元（[, ], [區塊類型、簡單格式化邊界、列表關鍵字 (*, #)
巨集*	紅色	巨集定義中的名稱，如果使用建議的 __xxx__ 語法，則插入巨集。
模板*	紅色	模板定義中的名稱
錨點*	紅色	用於連結 quickbook 的所有關鍵字。
註解*	淺灰色斜體	註解內。
表格*	類似 HTML	顯示結構、粗體標題、以 HTML 類似欄標題的方式醒目顯示。
變數列表*	類似 HTML	顯示結構、粗體標題、以 HTML 類似項目名稱的方式以粗體顯示。
C++ 程式碼*	Kate C++ 語法	程式碼區塊和行內程式碼。
路徑*	綠色	圖片、檔案和網路路徑
IDE 特定*	深藍色	IDE 指令

關於 boost::hs

boost::hs::quickbook 是 boost::hs 的一個組件，boost::hs 是一個用於 C++、doxygen、Boost.Build jamfiles 和 QuickBook 的語法高亮工具。boost::hs 有它自己的頁面，在此。

	注意事項
	boost::hs::cpp 支援 QuickBook 程式碼導入註釋風格！

安裝 boost::hs

目前正在努力將 boost::hs 推送到 KatePart 專案的上游。幾個月後，KDE 可能就會有原生 Quickbook 支援！目前您必須下載並安裝它。

您可以從這裡下載 boost::hs。

	注意事項
	boost::hs::quickbook 和 boost::hs::cpp 的副本可在 `boost/tools/quickbook/extra/katepart` 中找到。

要安裝它，您必須將資料夾 katepart/syntax/ 中的內容複製到您機器上適當的 katepart 語法資料夾。通常，這個資料夾會在 /usr/share/apps/katepart/syntax。包含一個名為 install.sh 的 bash 指令碼，它會將檔案複製到此資料夾。