Editor Support . Boost , The Boost C++ Libraries BoostBook Documentation Subset , Chapter 47. Quickbook 1.6

Editor Support

Scintilla Text Editor
KDE Support

Редактирование файлов быстрой книги обычно выполняется с помощью текстовых редакторов, как простых, так и мощных. В следующих разделах перечислены настройки для некоторых редакторов, которые могут помочь сделать редактирование файлов быстрой книги немного проще.

	Note
	Вы можете отправить свои настройки, советы и предложения авторам или черезdocs Boost Docs список рассылки.

Scintilla Text Editor

Секция внесена Дином Майклом Беррисом

Scintilla Text Editor (SciTE) — бесплатный редактор исходного кода для Win32 и X. Он использует компонент редактирования исходного кода SCIntilla.

	Tip
	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=]

	Note
	Спасибо Рене Ривере за приведенные выше настройки SciTE.

KDE Support

boost::hs::quickbook

boost::hs::quickbook — это синтаксис, предназначенный для работы с Katepart. Он может использоваться в KWrite, Kate, Konqueror и KDevelop и поддерживает все конструкции Quickbook 1.4, включая таблицы, списки, шаблоны и макросы.

.qbk loaded in a text editor
.qbk loaded with boost::hs support

html, полученный из этого файла .qbk

Table 47.7. Code examples

Имя	Код	Описание
для петли	<`for(int k=0; k<10; k++) v+=k;`>	Несколько цифр.
В то время как петля	<`{ int k; while( k < 10 ) { v+=k; k++ } }`>	Тот же эффект.
Бесконечная петля	<`while( true ) { v+=1; }`>	Не очень хороший пример.

Code Folding

Повышение::hs выходит далеко за рамки простой окраски. Одна полезная вещь, которую вы можете заставить редактора сделать, это отметить регионы. Они появляются в небольшой серой линии, и каждая область может быть сложена или развернута независимо.

Auto Comment / Uncomment

Другой важной особенностью является возможность автокомментировать или откомментировать какой-либо фрагмент кода.Инструменты — Комментарий. Комментируемые области могут быть некомментированы простым вызовом командыuncomment, находясь в ней.

Styles reference

Имя	Стиль	Описание
простой текст	нормальный черный	Простые тексты на каждом уровне.
отформатированный текст	Черный формат	Смелый, курсивный, подчеркивающий и смешивающий. Телетайп, сменный, вычеркнутый.
структура	светло-голубой	Все символы в структурах быстрых книг ([, ], [блок-тип, простые границы форматирования, списки ключевых слов (*, #) )
макросы	Красный	Имена в макроопределениях, вставка макросов, если используется предложенная синтаксис __xxx__.
шаблоны	Красный	Имена в шаблонных определениях
якоря	Красный	Все ключевые слова, используемые для соединения быстрых книг вместе.
комментарии	Итальянский светло-серый	В комментариях.
таблицы	HTML как	Раскройте структуру, жирный заголовок, выделенный HTML, как заголовки столбцов.
переменные списки	HTML как	Раскройте структуру, смелый заголовок, смелые названия HTML.
c++ код	cpp Синтаксис Кейт	Блоки кода и встроенный код.
пути	Зеленый	Изображения, файлы и веб-пути
Специфика IDE	темно-синий	Команды IDE

About boost::hs

boost::hs::quickbook является компонентом boost::hs, подсветкой синтаксиса для C++, доксигена, Boost. Постройте jamfiles и QuickBook. У него есть своя страницаздесь.

	Note
	Улучшение::hs::cpp поддержка QuickBook код импорт комментарии стиль!

Installing boost::hs

Продолжаются усилия по стимулированию::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. Сценарий bash под названиемinstall.shвключает в себя копирование файлов в эту папку.

Статья Editor Support раздела The Boost C++ Libraries BoostBook Documentation Subset Chapter 47. Quickbook 1.6 может быть полезна для разработчиков на c++ и boost.