Boost C++ 库

……世界上最受推崇和设计精良的 C++ 库项目之一。 Herb SutterAndrei Alexandrescu,《C++ 编码规范

PrevUpHomeNext

编辑器支持

Scintilla 文本编辑器
KDE 支持

Quickbook 文件的编辑通常使用简单而强大的文本编辑器完成。以下部分列出了某些编辑器的设置,这些设置可以使 Quickbook 文件的编辑更容易一些。

[Note] 注意

您可以将您的设置、技巧和建议提交给作者,或通过 docs Boost Docs 邮件列表

Dean Michael Berris 贡献的章节

Scintilla 文本编辑器 (SciTE) 是一款用于 Win32 和 X 的免费源代码编辑器。它使用 SCIntilla 源代码编辑组件。

[Tip] 提示

可以从 http://www.scintilla.org/SciTE.html 下载 SciTE。

您可以使用以下设置来突出显示编辑 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=]
[Note] 注意

感谢 Rene Rivera 提供以上 SciTE 设置。

boost::hs::quickbook

boost::hs::quickbook 是一款旨在与 Katepart 配合使用的语法高亮显示工具。它可以用于 KWrite、Kate、Konqueror 和 KDevelop,并支持 Quickbook 1.4 的所有结构,包括表格、列表、模板和宏。

.qbk 文件在文本编辑器中打开

.qbk 文件使用 boost::hs 支持打开

从此 .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++ 代码*

cpp Kate 语法

代码块和内联代码。

  • 路径*

绿色

图像、文件和 Web 路径

  • IDE 特定*

深蓝色

IDE 命令

关于 boost::hs

boost::hs::quickbook 是 boost::hs 的一个组件,boost::hs 是一款用于 C++、Doxygen、Boost.Build jamfile 和 QuickBook 的语法高亮显示工具。boost::hs 有其自己的页面 在此

[Note] 注意

boost::hs::cpp 支持 QuickBook 代码导入注释样式!

安装 boost::hs

目前正在努力将 boost::hs 推送到 KatePart 项目的上游。几个月后,KDE 可能会提供原生 Quickbook 支持!目前,您必须下载并安装它。

您可以从此处下载 boost::hs:此处

[Note] 注意

boost::hs::quickbook 和 boost::hs::cpp 的副本位于 boost/tools/quickbook/extra/katepart 中。

要安装它,您必须将文件夹 katepart/syntax/ 中的内容复制到计算机中相应的 katepart 语法文件夹。通常,此文件夹位于 /usr/share/apps/katepart/syntax。包含一个名为 install.sh 的 bash 脚本,它会将文件复制到此文件夹。


PrevUpHomeNext