Выход латекса из кислорода: нумерация глав, разделов и подразделов - PullRequest
Новая
       46

Выход латекса из кислорода: нумерация глав, разделов и подразделов

0 голосов
/ 16 октября 2018

Я использую doxygen с markdown файлами для создания PDF-файлов через вывод LaTeX.Файлы организованы иерархически с использованием тегов @subpage.Уровни «Заголовок 1» каждого файла Markdown называются «Глава» или «Раздел» в файлах LaTeX в соответствии с уровнем файлов Markdown в иерархии.Вывод PDF этих «Главы» и «Раздела» пронумерован.Хорошо, пока здесь.

Но вывод PDF пропускает нумерацию подразделов и абзацев и нижних пунктов.Анализируя файлы LaTeX, я вижу звездочки (*) в таких элементах, как \subsection*{My Section}.

Мои вопросы:

  1. Как сказать Doxygen, чтобы не добавлять эти звездочкитак что я могу иметь нумерацию вроде "1.1", "1.1.1" и т. д.
  2. , удалив звездочки, разве у меня не будет растущего оглавления?Как я могу ограничить глубину результирующего оглавления?
  3. Нумерация "главы" довольно странная (глава XX \ r \ n Блабла).Как вы форсируете формат "XX Blabla"?

Некоторые точности:

Версия Doxygen: 1.8.14

Файлы разметки организованы следующим образом: 

FILES                 LaTex result
/root_folder
+---file1.md      ->  \chapter{My title 1}\label{my_title_1}\Hypertarget{my_title_1}
+---file1.1.md    ->  \section{My title 1.1}\label{my_title_1_1}\Hypertarget{my_title_1_1}
+---file1.2.md    ->  \section{My title 1.2}\label{my_title_1_2}\Hypertarget{my_title_1_2}
+---file2.md      ->  \chapter{My title 2}\label{my_title_2}\Hypertarget{my_title_2}
+---file2.1.md    ->  \section{My title 2.1}\label{my_title_2_1}\Hypertarget{my_title_2_1}
+---file2.2.md    ->  \section{My title 2.2}\label{my_title_2_2}\Hypertarget{my_title_2_2}
+---doxyfile
  • Каждый файл MD начинается с тега Title1 : # Мой заголовок XX {#my_title_xx}
  • Содержимое каждого md-файла продолжается с Title2, Title3 ... (## Sub title, ### Sub title, ...)
  • Файл md может ссылаться на подстраницы (например, file1.md относитсяв file1.1.md и file1.2.md).

Что я получаю:

  • Теги Title1 конвертируются как главы или разделыв соответствии с местом в иерархии.Они пронумерованы (т.е. без "*") => OK .
  • Title2, 3 .. теги каждого файла преобразуются в подраздел или подраздел в соответствии с местом в иерархии. Они являются un пронумерованы (т.е. с "*") и отсутствуют в оглавлении => KO .

Надеюсь, эта информация ясна;) Может быть, есть другаяспособ сделать структурированный вывод LaTex / PDF из md файлов ...

...