Как указать пронумерованные разделы в передней части Пандока?

Question

Я хотел бы указать пронумерованные разделы с помощью поддержки Pandoc для YAML. Я знаю, что флаг для использования командной строки --number-sections, но что-то вроде

---
title: Test
number-sections: true
---

не дает желаемого результата. Я знаю, что я близко, потому что вы можете сделать это с помощью пакета геометрии (например, geometry: margin=2cm). Хотелось бы, чтобы было исчерпывающее руководство о том, как Pandoc YAML решает вопросы. Например, следующее очень полезно (избегает шаблонов), но его обнаруживаемость низкая:

 header-includes: 
 - \usepackage{some latex package}

Answer 1

Чтобы включить пронумерованные секции в выводе латекса, нужно использовать numbersections в вашем блоке YAML. Если вы когда-нибудь захотите "открыть" такие вещи с помощью pandoc, просто покопайтесь в шаблонах:

 $ grep -i number default.latex
 $if(numbersections)$
 $ grep -i number default.html*
 $

Как вы можете видеть, эта опция не работает с HTML.

Markdown и YAML, с которыми я тестировал:

 ---
 title: Test
 numbersections: true
 ---


 # blah

 Text is here.

 ## Double Blah

 Twice the text is here

Если вам нужно, чтобы он работал не только с beamer,latex,context,opendoc, вам необходимо отправить сообщение об ошибке на github.

Answer 2

Чтобы показать номер раздела в производимом PDF-файле, есть два варианта.

В фронте ЯМЛ

Добавьте следующий параметр в начало файла уценки

---
 numbersections: true
---

В командной строке

Мы также можем использовать параметр команды для создания PDF с пронумерованным разделом. Согласно документации Pandoc, правильные параметры --number-sections или просто -N,

pandoc test.md -o test.pdf --number-sections
# pandoc test.md -o test.pdf -N