Специальные теги внутри ODT документа

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

Указание языка программирования для кода

Название языка программирования указывается с помощью тега ===codelang=<Название>===, расположенного в первой строке кода. Пример тега для языка C++: ===codelang=cpp===. После преобразования тег со строкой удаляется из исходного HTML-кода.

Тег обрабатывается внутри абзацев со стилем Программа. Пример HTML-кода после преобразования:

<div class="u-listing" id="code1" title="code1">
<pre class="prettyprint lang-cpp"><code class="language-cpp">
std::cout &lt;&lt; "Hello!" &lt;&lt; std::endl;</code>
</pre></div>

Если подсветка кода не нужна, то в параметре <Название> следует указать значение none. Пример HTML-кода после преобразования:

<div class="u-listing" id="code2" title="code2">
<pre><code class="language-plaintext">
std::cout &lt;&lt; "Hello!" &lt;&lt; std::endl;</code></pre></div>

Кроме того, тег обрабатывается внутри абзацев со стилем Отступ, при условии, что всё содержимое абзаца помечено стилем текста Courier. Пример HTML-кода после преобразования:

<div class="u-listing u-indent" id="code1" title="code1">
<pre class="prettyprint lang-cpp"><code class="language-cpp">
std::cout &lt;&lt; "Hello!" &lt;&lt; std::endl;</code>
</pre></div>

Если подсветка кода не нужна, то в параметре <Название> следует указать значение none. Пример HTML-кода после преобразования:

<div class="u-listing u-indent" id="code2" title="code2">
<pre><code class="language-plaintext">
std::cout &lt;&lt; "Hello!" &lt;&lt; std::endl;</code></pre></div>

Для подсветки синтаксиса программ используется библиотека code-prettify. Код подключения внутри раздела HEAD HTML-документа:

<script src="https://cdn.jsdelivr.net/gh/google/code-prettify@master/loader/run_prettify.js"></script>

Вместо code-prettify можно использовать библиотеку highlightjs. Код подключения внутри раздела HEAD HTML-документа (нужно дополнительно убрать стилизацию для листингов, чтобы код дважды не подсвечивался):

<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/styles/default.min.css">
<script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/highlight.min.js"></script>
<script>hljs.highlightAll();</script>

Оконная оболочка программы ODT2HTML позволяет упростить создание тега. Для этого на вкладке 5. Утилиты (рис. 1.18) вводим название языка в поле Язык программирования и нажимаем кнопку Сгенерировать тег языка листинга. Сгенерированный тег будет вставлен в поле Результат.

Рис. 1.18. Генерация тега для указания языка программирования

Оконная оболочка программы ODT2HTML позволяет указать код языка программирования по умолчанию. Если листинг не содержит тега языка программирования, то будет использоваться значение из поля Язык по умолчанию для листингов, расположенного на вкладке 2. Настройки (рис. 1.19).

Рис. 1.19. Указание языка программирования для листингов по умолчанию