Какой элемент DITA использовать для имени типа языка программирования в synph?

Question

Учитывая некоторый язык программирования текста, например

int foo (int a); 

или

function foo (a : int) return int; 

и цель положить разметку вокруг структурно важных частей, руководствуясь синтаксисом. Каким будет правильный выбор элемента, в который следует положить int, a тип, как часть <synph>? Обратите внимание, что эта разметка не предназначена для отображения блоков кода, но для определения syntactic structure. Я получаю, насколько

int <var>foo</foo> 
<delim>(</delim> 
    int <parmname>a</parmname> 
<delim>)</delim><delim>;</delim> 

Даже <var> не кажется правильным вокруг имени функции, поскольку var означает заменяемым, но не все функции. Просто <text>?

Я понимаю, что в этом примере используются имена лиц, тогда как железнодорожные диаграммы, грамматики и т. Д. Имели бы более абстрактные имена. Таким образом, возможно, более обычный пример

function FUNCTION-NAME (VAR-NAME : TYPE-NAME) return TYPE-NAME; 

Соответственно, разнообразный вопрос становится: Что Разметка я использую для TYPE-NAME? Будет ли специализация DITA практичной?

Answer 1

Правильный элемент для кода кода - codeblock. Вы не должны разметки каждой отдельной строки. Это имеет смысл только для встроенных элементов. Возможно, вы захотите взглянуть на все связанные элементы programming domain. Если вы публикуете свои данные, вы должны использовать маркер для автоматического выделения синтаксиса вашего блока. Вы можете использовать @outputclass, чтобы указать маркере, какой язык он должен использовать.