Это команда pandoc, которую можно запустить в бесплатном хостинг-провайдере OnWorks, используя одну из наших многочисленных бесплатных онлайн-рабочих станций, таких как Ubuntu Online, Fedora Online, онлайн-эмулятор Windows или онлайн-эмулятор MAC OS.
ПРОГРАММА:
ИМЯ
pandoc - конвертер общей разметки
СИНТАКСИС
пандок [кредита] [входной файл] ...
ОПИСАНИЕ
Pandoc - это библиотека Haskell для преобразования из одного формата разметки в другой, а
инструмент командной строки, использующий эту библиотеку. Он может читать Markdown, CommonMark, PHP Markdown
Extra, Markdown со вкусом GitHub и (подмножества) Textile, reStructuredText, HTML, LaTeX,
Разметка MediaWiki, разметка TWiki, разметка Haddock, OPML, режим Emacs Org, DocBook, txt2tags,
EPUB, ODT и Word docx; и он может писать простой текст, Markdown, CommonMark, PHP Markdown
Extra, разметка со вкусом GitHub, reStructuredText, XHTML, HTML5, LaTeX (включая beamer
слайд-шоу), ConTeXt, RTF, OPML, DocBook, OpenDocument, ODT, Word docx, GNU Texinfo,
Разметка MediaWiki, разметка DokuWiki, разметка Haddock, EPUB (v2 или v3), FictionBook2, Textile,
страницы руководства groff, режим Emacs Org, AsciiDoc, InDesign ICML и Slidy, Slideous, DZSlides,
Show.js или слайд-шоу S5 HTML. Он также может выводить PDF-файлы в системах, где LaTeX,
ConTeXt или wkhtmltopdf установлен.
Расширенная версия Markdown от Pandoc включает синтаксис для сносок, таблиц, гибких
упорядоченные списки, списки определений, изолированные блоки кода, надстрочные и подстрочные индексы,
зачеркивание, блоки метаданных, автоматические оглавления, встроенная математика LaTeX, цитаты,
и Markdown внутри блочных элементов HTML. (Эти улучшения, описанные ниже в
Markdown Pandoc можно отключить с помощью входного или выходного формата markdown_strict.)
В отличие от большинства существующих инструментов для преобразования Markdown в HTML, которые используют регулярное выражение
замен, pandoc имеет модульную конструкцию: он состоит из набора читателей, которые разбирают
текст в заданном формате и создать собственное представление документа, а также набор
писатели, которые конвертируют это собственное представление в целевой формат. Таким образом, добавляя
формат ввода или вывода требует только добавления читателя или писателя.
Поскольку промежуточное представление документа pandoc менее выразительно, чем многие из
форматы, между которыми он преобразуется, не следует ожидать идеального преобразования между каждым
формат и любой другой. Pandoc пытается сохранить структурные элементы
документ, но не детали форматирования, такие как размер поля. И некоторые элементы документа,
такие как сложные таблицы, могут не соответствовать простой модели документа pandoc. Пока
преобразования из Markdown pandoc во все форматы стремятся быть идеальными, преобразования из
форматы, более выразительные, чем Markdown pandoc, могут быть с потерями.
. пандок
Если нет входной файл указан, ввод читается из STDIN, В противном случае входные файлы
объединены (с пустой строкой между ними) и используются в качестве входных. Выход идет на стандартный вывод by
по умолчанию (хотя вывод в стандартный вывод отключен для вывода odt, docx, epub и epub3
форматы). Для вывода в файл используйте параметр -o:
pandoc -o выходной.html входной.txt
По умолчанию pandoc создает фрагмент документа, а не отдельный документ с правильным
Верхний и нижний колонтитулы. Чтобы создать автономный документ, используйте флаг -s или --standalone:
pandoc -s -o выходной.html входной.txt
Дополнительные сведения о том, как создаются автономные документы, см. В разделе «Шаблоны» ниже.
Вместо файла можно указать абсолютный URI. В этом случае pandoc получит
контент с использованием HTTP:
pandoc -f html -t уценка http://www.fsf.org
Если задано несколько входных файлов, pandoc объединит их все (с пустыми строками
между ними) перед разбором. Эта функция отключена для двоичных форматов ввода, таких как
EPUB, odt и docx.
Формат ввода и вывода можно указать явно с помощью параметров командной строки.
Формат ввода можно указать с помощью параметров -r / - read или -f / - from, вывод
форматирование с помощью параметров -w / - write или -t / -. Таким образом, чтобы преобразовать hello.txt из Markdown
в LaTeX вы можете ввести:
pandoc -f markdown -t латекс hello.txt
Чтобы преобразовать hello.html из HTML в Markdown:
pandoc -f html -t уценка hello.html
Поддерживаемые форматы вывода перечислены ниже с параметром -t / - to. Поддерживаемый ввод
форматы перечислены ниже под параметром -f / - from. Обратите внимание, что первые, текстиль, латекс,
и читатели html не завершены; есть некоторые конструкции, которые они не анализируют.
Если формат ввода или вывода не указан явно, pandoc попытается его угадать.
из расширений имен файлов ввода и вывода. Так, например,
pandoc -o привет.tex привет.txt
преобразует hello.txt из Markdown в LaTeX. Если выходной файл не указан (чтобы
вывод идет на стандартный вывод), или, если расширение выходного файла неизвестно, выходной формат
по умолчанию будет HTML. Если входной файл не указан (так что вход поступает из STDIN), или
если расширения входных файлов неизвестны, предполагается, что входной формат будет
Markdown, если явно не указано иное.
Pandoc использует кодировку символов UTF-8 как для ввода, так и для вывода. Если ваш местный
кодировка символов отличается от UTF-8, вы должны направлять ввод и вывод через iconv:
iconv -t utf-8 input.txt | pandoc | iconv -f UTF-8
Обратите внимание, что в некоторых форматах вывода (таких как HTML, LaTeX, ConTeXt, RTF, OPML, DocBook и
Texinfo) информация о кодировке символов включается в заголовок документа,
который будет включен только в том случае, если вы используете автономную опцию -s / -.
Создающий a PDF
Чтобы создать PDF-файл, укажите выходной файл с расширением .pdf. По умолчанию pandoc будет
используйте LaTeX, чтобы преобразовать его в PDF:
pandoc test.txt -o test.pdf
Для создания PDF-файла необходимо установить движок LaTeX (см. --Latex-engine ниже),
и предполагает, что доступны следующие пакеты LaTeX: amsfonts, amsmath, lm,
ifxetex, ifluatex, eurosym, листинги (если используется опция --listings), fancyvrb,
longtable, booktabs, graphicx и grffile (если документ содержит изображения), hyperref,
ulem, geometry (с набором переменных геометрии), setspace (с растяжкой) и babel
(с языком). Использование xelatex или lualatex в качестве движка LaTeX требует fontspec;
xelatex использует mathspec, polyglossia (с lang), xecjk и bidi (с переменной dir
набор). Пакеты upquote и microtype используются, если они доступны, и csquotes.
для умной пунктуации, если она добавлена в шаблон или включена в любой файл заголовка. В
Пакеты natbib, biblatex, bibtex и biber могут дополнительно использоваться для цитирования
рендеринг. Они включены во все последние версии TeX Live.
В качестве альтернативы pandoc может использовать ConTeXt или wkhtmltopdf для создания PDF-файла. Для этого укажите
выходной файл с расширением .pdf, как и раньше, но добавьте -t context или -t html5 в
командная строка.
Выводом PDF можно управлять с помощью переменных для LaTeX (если используется LaTeX) и переменных
для ConTeXt (если используется ConTeXt). Если используется wkhtmltopdf, то переменные margin-left,
margin-right, margin-top, margin-bottom и размер бумаги повлияют на вывод, как и
--css.
ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ
Общие кредита
-f ФОРМАТ, -r ФОРМАТ, --from =ФОРМАТ, --read =ФОРМАТ
Укажите формат ввода. ФОРМАТ может быть родным (родной Haskell), json (версия JSON
собственный AST), markdown (расширенный Markdown pandoc), markdown_strict (исходный
нерасширенный Markdown), markdown_phpextra (PHP Markdown Extra), markdown_github
(GitHub-Flavored Markdown), commonmark (CommonMark Markdown), Textile (Текстиль),
первый (reStructuredText), HTML (HTML), docbook (DocBook), t2t (txt2tags), docx
(docx), odt (ODT), epub (EPUB), opml (OPML), org (режим Emacs Org), mediawiki
(Разметка MediaWiki), твики (разметка TWiki), пикша (разметка пикши) или латекс
(Латекс). Если + lhs добавляется к markdown, rst, latex или html, ввод будет
рассматривается как грамотный источник Haskell: см. раздел «Поддержка Literate Haskell» ниже. Уценка
расширения синтаксиса можно индивидуально включить или отключить, добавив + EXTENSION
или -EXTENSION к имени формата. Так, например,
markdown_strict + footnotes + definition_lists - это строгий Markdown со сносками и
списки определений включены, а markdown-pipe_tables + hard_line_breaks - это pandoc's
Уценка без таблиц труб и с жесткими разрывами строк. См. Pandoc Markdown,
ниже, для списка расширений и их имен.
-t ФОРМАТ, -w ФОРМАТ, --to =ФОРМАТ, --write =ФОРМАТ
Укажите выходной формат. ФОРМАТ может быть родным (родной Haskell), json (версия JSON
собственного AST), plain (простой текст), markdown (расширенный Markdown pandoc),
markdown_strict (исходный нерасширенный Markdown), markdown_phpextra (PHP Markdown
Extra), markdown_github (разметка со вкусом GitHub), commonmark (CommonMark
Markdown), rst (reStructuredText), html (XHTML), html5 (HTML5), латекс (LaTeX),
beamer (слайд-шоу LaTeX beamer), context (ConTeXt), man (groff man), mediawiki
(Разметка MediaWiki), dokuwiki (разметка «ДокуВики»), textile (текстильная), org (Emacs Org
режим), texinfo (GNU Texinfo), opml (OPML), docbook (DocBook), opendocument
(OpenDocument), odt (текстовый документ OpenOffice), docx (Word docx), пикша (Haddock
разметка), RTF (форматированный текст), epub (книга EPUB v2), epub3 (EPUB v3), fb2
(Электронная книга FictionBook2), asciidoc (AsciiDoc), icml (InDesign ICML), slidy (Slidy HTML
и слайд-шоу javascript), слайд-шоу (слайд-шоу Slideous HTML и javascript),
dzslides (слайд-шоу DZSlides HTML5 + javascript), Showjs (Show.js HTML5 +
слайд-шоу javascript), s5 (слайд-шоу S5 HTML и javascript) или путь к
пользовательский писатель lua (см. Пользовательские писатели ниже). Обратите внимание, что odt, epub и epub3
вывод не будет направлен на стандартный вывод; имя выходного файла должно быть указано с использованием
параметр вывода -o / -. Если + lhs добавляется к markdown, rst, latex, beamer, html,
или html5, вывод будет отображаться как грамотный исходный код Haskell: см. Literate
Поддержка Haskell ниже. Расширения синтаксиса Markdown можно включить индивидуально или
отключено добавлением + EXTENSION или -EXTENSION к имени формата, как описано
выше под -f.
-o ФАЙЛОВ, --output =ФАЙЛОВ
Записать вывод в ФАЙЛОВ вместо стандартный вывод. Если ФАЙЛОВ есть -, вывод пойдет на стандартный вывод.
(Исключение: если формат вывода - odt, docx, epub или epub3, вывод на стандартный вывод будет
инвалид.)
--data-dir =СПРАВОЧНИК
Укажите каталог данных пользователя для поиска файлов данных pandoc. Если эта опция
не указано, будет использоваться каталог данных пользователя по умолчанию. Это в Unix:
$ HOME / .pandoc
в Windows XP:
C: \ Documents And Settings \ ИМЯ ПОЛЬЗОВАТЕЛЯ \ Данные приложения \ pandoc
и в Windows Vista или новее:
C: \ Users \ ИМЯ ПОЛЬЗОВАТЕЛЯ \ AppData \ Roaming \ pandoc
Вы можете найти каталог пользовательских данных по умолчанию в вашей системе, посмотрев на
вывод pandoc --version. Reference.odt, reference.docx, epub.css, шаблоны,
каталог slidy, slideous или s5, размещенный в этом каталоге, переопределит каталог pandoc
нормальные значения по умолчанию.
--bash-завершение
Создайте сценарий завершения bash. Чтобы включить завершение bash с помощью pandoc, добавьте это
в ваш .bashrc:
eval "$ (pandoc --bash-completion)"
--подробный
Предоставлять подробный отладочный вывод. В настоящее время это влияет только на вывод PDF.
-в, --версия
Версия для печати.
-час, --Помогите
Показать сообщение об использовании.
читатель кредита
-Р, --parse-сырье
Анализируйте непереводимые HTML-коды и среды LaTeX как необработанный HTML или LaTeX,
вместо того, чтобы игнорировать их. Влияет только на ввод HTML и LaTeX. Необработанный HTML может быть
напечатаны в Markdown, reStructuredText, HTML, Slidy, Slideous, DZSlides, discover.js,
и выход S5; raw LaTeX можно распечатать в Markdown, reStructuredText, LaTeX и
Вывод ConTeXt. По умолчанию читатели пропускают непереводимые HTML-коды.
и среды LaTeX. (Читатель LaTeX действительно проходит через непереводимый LaTeX
команды, даже если -R не указан.)
-С, --умный
Создавать типографически правильный вывод, преобразовывая прямые кавычки в фигурные,
--- в длинное тире, - в тире и ... в многоточие. Неразрывные пробелы
вставляется после определенных сокращений, таких как «Мистер». (Примечание: этот вариант выбран
автоматически, если формат вывода - латекс или контекст, если только --no-tex-ligatures
используется. Это не влияет на ввод латекса.)
- старое тире
Выбирает поведение pandoc <= 1.8.2.1 для анализа умных тире: - перед числом
- длинное тире, а - длинное тире. Этот вариант выбирается автоматически для
текстильный ввод.
--base-header-level =НОМЕР
Укажите базовый уровень для заголовков (по умолчанию 1).
--indented-code-classes =КЛАССЫ
Укажите классы, которые будут использоваться для блоков кода с отступом - например, perl, numberLines или
Хаскелл. Несколько классов можно разделять пробелами или запятыми.
--default-image-extension =РАСПРОСТРАНЕНИЕ
Укажите расширение по умолчанию, которое будет использоваться, когда пути к изображениям / URL-адреса не имеют расширения. Этот
позволяет использовать один и тот же источник для форматов, требующих разных типов
картинки. В настоящее время эта опция влияет только на считыватели Markdown и LaTeX.
--filter =EXECUTABLE
Укажите исполняемый файл, который будет использоваться в качестве фильтра, преобразующего AST pandoc после
ввод анализируется и перед записью вывода. Исполняемый файл должен читать JSON
из стандартного ввода и записать JSON в стандартный вывод. JSON должен быть отформатирован как собственный файл pandoc.
Ввод и вывод JSON. Имя выходного формата будет передано фильтру
как первый аргумент. Следовательно,
pandoc --filter ./caps.py -t латекс
эквивалентна
pandoc -t json | ./caps.py латекс | pandoc -f json -t латекс
Последняя форма может быть полезна для отладки фильтров.
Фильтры могут быть написаны на любом языке. Text.Pandoc.JSON экспортирует в JSONFilter в
облегчить написание фильтров на Haskell. Тем, кто предпочел бы писать фильтры в
python может использовать модуль pandocfilters, устанавливаемый из PyPI. Это также
библиотеки фильтров pandoc в PHP, perl и javascript / node.js.
Обратите внимание, что EXECUTABLE будет искать в PATH пользователя, а не в рабочем
каталог, если каталог не указан. Если вы хотите запустить скрипт в рабочем
каталог, поставьте перед именем файла./.
-M KEY[=VAL], --metadata =KEY[:VAL]
Установите поле метаданных KEY к значению VAL. Значение, указанное в командной строке
переопределяет значение, указанное в документе. Значения будут проанализированы как логическое значение YAML.
или строковые значения. Если значение не указано, значение будет рассматриваться как логическое.
истинный. Как и --variable, --metadata устанавливает переменные шаблона. Но в отличие от
--variable, --metadata влияет на метаданные базового документа (который
доступны из фильтров и могут быть распечатаны в некоторых форматах вывода).
- нормализовать
Нормализовать документ после прочтения: объединить соседние элементы Str или Emph, для
пример и удалите повторяющиеся пробелы.
-п, --preserve-табы
Сохраняйте табуляции вместо преобразования их в пробелы (по умолчанию). Обратите внимание, что это
будет влиять только на вкладки в буквальных диапазонах кода и блоках кода; табуляции в обычном тексте
будут рассматриваться как пробелы.
--tab-stop =НОМЕР
Укажите количество пробелов на вкладке (по умолчанию 4).
--track-changes = accept | reject | all
Определяет, что делать со вставками и удалениями, производимыми MS Word "Track".
Changes ". Accept (по умолчанию), вставляет все вставки и игнорирует все
удаления. reject вставляет все удаления и игнорирует вставки. все ставит в оба
вставки и удаления, заключенные в промежутки с классами вставки и удаления,
соответственно. Автор и время изменения указаны. все полезно для
сценарии: принятие изменений только от определенного рецензента, скажем, или до определенного
Дата. Эта опция влияет только на программу чтения docx.
--extract-media =DIR
Извлечь изображения и другие носители, содержащиеся в контейнере docx или epub, в путь
DIR, создав его, если необходимо, и скорректируйте ссылки на изображения в документе так, чтобы
они указывают на извлеченные файлы. Эта опция влияет только на docx и epub.
читатели.
Общие писатель кредита
-с, - автономный
Создавайте выходные данные с соответствующим верхним и нижним колонтитулами (например, автономный HTML,
LaTeX, или RTF файл, а не фрагмент). Эта опция устанавливается автоматически для pdf,
Вывод epub, epub3, fb2, docx и odt.
--template =ФАЙЛОВ
Используйте ФАЙЛОВ как настраиваемый шаблон для сгенерированного документа. Подразумевает --standalone.
Описание синтаксиса шаблона см. В разделе «Шаблоны» ниже. Если нет расширения
указано, расширение, соответствующее автору, будет добавлено, так что
--template = специально ищет special.html для вывода HTML. Если шаблон не
найдено, pandoc будет искать его в подкаталоге шаблонов пользовательских данных
каталог (см. --data-dir). Если этот параметр не используется, шаблон по умолчанию
будет использоваться соответствующий формат вывода (см. -D / - print-default-template).
-V KEY[=VAL], - переменная =KEY[:VAL]
Установите переменную шаблона KEY к значению VAL при рендеринге документа в
автономный режим. Обычно это полезно только при использовании параметра --template.
чтобы указать настраиваемый шаблон, поскольку pandoc автоматически устанавливает переменные, используемые в
шаблоны по умолчанию. Если нет VAL указано, ключу будет присвоено значение
правда.
-D ФОРМАТ, --print-default-template =ФОРМАТ
Распечатать системный шаблон по умолчанию для вывода ФОРМАТ. (См. -T для получения списка
возможное ФОРМАТs.) Шаблоны в каталоге пользовательских данных игнорируются.
--print-default-data-file =ФАЙЛОВ
Распечатайте системный файл данных по умолчанию. Файлы в каталоге пользовательских данных игнорируются.
--dpi =НОМЕР
Укажите значение dpi (точек на дюйм) для преобразования из пикселей в
дюйм / сантиметр и наоборот. По умолчанию 96 точек на дюйм. Технически правильный
термин будет ppi (пикселей на дюйм).
--wrap = [авто | нет | сохранить]
Определите, как текст помещается в выходные данные (исходный код, а не визуализированный
версия). С auto (по умолчанию) pandoc попытается перенести строки в столбец
ширина указывается --columns (по умолчанию 80). Если нет, pandoc не будет переносить строки
вообще. С preserve pandoc попытается сохранить упаковку от
исходный документ (то есть там, где в исходном тексте есть несемантические символы новой строки, там
будут также несемантическими символами новой строки на выходе).
- без обертывания
Устарел синоним --wrap = none.
--columns =НОМЕР
Укажите длину строк в символах (для переноса текста). Это влияет только на
сгенерированный исходный код, а не макет на отображаемой странице.
--ток, --оглавление
Включите автоматически сгенерированное оглавление (или, в случае латекса,
context, и сначала инструкция по его созданию) в выходном документе. Этот
опция не влияет на вывод man, docbook, slidy, slideous, s5, docx или odt.
--toc-depth =НОМЕР
Укажите количество уровней раздела для включения в оглавление. В
по умолчанию - 3 (это означает, что заголовки уровней 1, 2 и 3 будут перечислены в
содержание).
- не выделять
Отключает подсветку синтаксиса для блоков кода и встроенных строк, даже если язык
атрибут дается.
--highlight-style =СТИЛЬ
Задает стиль окраски, который будет использоваться в выделенном исходном коде. Варианты
пигменты (по умолчанию), кейт, монохромный, эспрессо, зенберн, пикша и танго.
Дополнительные сведения о выделении синтаксиса в pandoc см. В разделе Подсветка синтаксиса,
внизу.
-H ФАЙЛОВ, --include-in-header =ФАЙЛОВ
Включить содержимое ФАЙЛОВдословно в конце заголовка. Это можно использовать,
например, чтобы включить специальный CSS или javascript в HTML-документы. Этот вариант
может использоваться повторно для включения нескольких файлов в заголовок. Они будут
включены в указанном порядке. Подразумевает --standalone.
-B ФАЙЛОВ, --include-before-body =ФАЙЛОВ
Включить содержимое ФАЙЛОВдословно в начале тела документа (например,
после тег в HTML или команду \ begin {document} в LaTeX). Это может
использоваться для включения панелей навигации или баннеров в HTML-документы. Этот вариант может
многократно использоваться для включения нескольких файлов. Они будут включены в заказ
указано. Подразумевает --standalone.
-A ФАЙЛОВ, --include-after-body =ФАЙЛОВ
Включить содержимое ФАЙЛОВдословно в конце тела документа (перед
тег в HTML или команду \ end {document} в LaTeX). Этот вариант может быть
многократно использоваться для включения нескольких файлов. Они будут включены в заказ
указано. Подразумевает --standalone.
Возможности затрагивающий конкретный писатели
- автономный
Создайте автономный файл HTML без внешних зависимостей, используя данные: URI для
включать содержимое связанных скриптов, таблиц стилей, изображений и видео. В
итоговый файл должен быть "самодостаточным" в том смысле, что он не нуждается во внешних
файлы и нет сетевого доступа для правильного отображения в браузере. Этот вариант работает
только с форматами вывода HTML, включая html, html5, html + lhs, html5 + lhs, s5,
Slidy, Slidous, Dzslides и Showjs. Скрипты, изображения и таблицы стилей на
будут загружены абсолютные URL-адреса; те, которые имеют относительные URL-адреса, будут искать относительно
рабочий каталог (если первый исходный файл локальный) или относительно базового
URL (если первый исходный файл удален). Ограничение: загружаемые ресурсы
динамически через JavaScript не может быть включен; как результат,
--self -hibited не работает с --mathjax и некоторыми расширенными функциями (например,
масштабирование или заметки докладчика) могут не работать в автономном "автономном" слайде Show.js
шоу.
--html-q-теги
Используйте теги для кавычек в HTML.
--ascii
Используйте в выводе только символы ascii. В настоящее время поддерживается только для вывода HTML
(который использует числовые объекты вместо UTF-8, когда выбран этот параметр).
- ссылки-ссылки
Используйте ссылки в стиле справочника, а не встроенные ссылки, при написании Markdown или
reStructuredText. По умолчанию используются встроенные ссылки.
--atx-заголовки
Используйте заголовки в стиле ATX в выводе Markdown и asciidoc. По умолчанию используется
Заголовки в стиле setext для уровней 1-2, а затем заголовки ATX.
--главы
Рассматривайте заголовки верхнего уровня как главы в выводах LaTeX, ConTeXt и DocBook. Когда
класс документа LaTeX настроен на отчет, книгу или мемуары, эта опция подразумевается.
Если формат вывода - beamer, заголовки верхнего уровня станут \ part {..}.
-Н, --число-разделы
Нумерация заголовков разделов в выводе LaTeX, ConTeXt, HTML или EPUB. По умолчанию,
разделы не нумеруются. Разделы с ненумерованным классом никогда не нумеруются,
даже если указано --number-section.
--number-offset =НОМЕР[,НОМЕР,...]
Смещение заголовков разделов в выводе HTML (игнорируется в других форматах вывода). В
первое число добавляется к номеру раздела для заголовков верхнего уровня, второе - для
заголовки второго уровня и так далее. Так, например, если вам нужен первый верхний уровень
заголовок в вашем документе должен быть пронумерован "6", укажите --number-offset = 5. Если ваш
документ начинается с заголовка уровня 2, которому вы хотите присвоить номер "1.5", укажите
--number-offset = 1,4. По умолчанию смещения равны 0. Подразумевает --number-section.
--нетекс-лигатуры
Не используйте лигатуры TeX для кавычек, апострофов и тире (`... ',
`` .. '', -, ---) при записи или чтении LaTeX или ConTeXt. При чтении LaTeX проанализируйте
символы `, 'и - буквально, а не синтаксический анализ лигатур для цитаты
знаки и тире. При написании LaTeX или ConTeXt выведите кавычки Unicode и
буквально тире, а не преобразовывать их в стандартный ASCII TeX
лигатуры. Примечание: обычно --smart выбирается автоматически для LaTeX и ConTeXt.
вывод, но он должен быть указан явно, если выбран --no-tex-ligatures. Если
вы используете буквальные фигурные кавычки, тире и многоточия в исходном тексте, тогда вы можете
хотите использовать --no-tex-ligatures без --smart.
- списки
Используйте пакет листингов для блоков кода LaTeX
-я, - инкрементальный
Сделайте так, чтобы элементы списка в слайд-шоу отображались постепенно (по одному). По умолчанию
для одновременного отображения списков.
--slide-level =НОМЕР
Указывает, что заголовки с указанным уровнем создают слайды (для beamer, s5,
скользящие, скользящие, дзслайды). Заголовки выше этого уровня в иерархии используются для
разделить слайд-шоу на разделы; заголовки ниже этого уровня создают подзаголовки
внутри слайда. По умолчанию уровень слайда устанавливается на основе содержимого
документ; см. «Структурирование слайд-шоу».
--section-дивы
Обернуть разделы в теги (или теги в HTML5) и прикрепите идентификаторы к
ограждающий (или ), а не сам заголовок. См. Заголовок
идентификаторы, ниже.
--email-obfuscation = none | javascript | ссылки
Укажите метод обфускации ссылок mailto: в документах HTML. никто не уходит
mailto: ссылки как есть. javascript запутывает их с помощью javascript.
ссылки запутывают их, выводя их буквы как десятичные или шестнадцатеричные
ссылки на символы. По умолчанию используется javascript.
--id-prefix =STRING
Укажите префикс, который будет добавлен ко всем автоматически сгенерированным идентификаторам в HTML и
Вывод DocBook и номера сносок в выводе Markdown. Это полезно для
предотвращение дублирования идентификаторов при генерации фрагментов для включения в другие
страниц.
-T STRING, --title-prefix =STRING
Указывать STRING как префикс в начале заголовка, который появляется в HTML
заголовок (но не в заголовке, как в начале тела HTML).
Подразумевает --standalone.
-c URL, --css =URL
Ссылка на таблицу стилей CSS. Эту опцию можно использовать повторно, чтобы включить
несколько файлов. Они будут включены в указанном порядке.
--reference-odt =ФАЙЛОВ
Используйте указанный файл как ссылку на стиль при создании ODT. Для лучших результатов,
эталонный ODT должен быть модифицированной версией ODT, созданной с использованием pandoc.
Содержимое эталонного ODT игнорируется, но его таблицы стилей используются в
новый ODT. Если в командной строке не указан ссылочный ODT, pandoc будет выглядеть
для файла reference.odt в каталоге пользовательских данных (см. --data-dir). Если это
не найден, будут использоваться разумные значения по умолчанию.
--reference-docx =ФАЙЛОВ
Используйте указанный файл как ссылку на стиль при создании файла docx. Для лучшего
результатов, ссылочный docx должен быть измененной версией созданного файла docx
используя pandoc. Содержимое справочного docx игнорируется, но его таблицы стилей
и используются свойства документа (включая поля, размер страницы, верхний и нижний колонтитулы)
в новом docx. Если в командной строке не указан ссылочный docx, pandoc
будет искать файл reference.docx в каталоге пользовательских данных (см. --data-dir).
Если и этого не найдено, будут использоваться разумные значения по умолчанию. Следующие стили
используются pandoc: [параграф] Обычный, Основной текст, Первый абзац, Компактный, Заголовок,
Подзаголовок, Автор, Дата, Аннотация, Библиография, Заголовок 1, Заголовок 2, Заголовок 3,
Заголовок 4, Заголовок 5, Заголовок 6, Текст блока, Текст сноски, Термин определения,
Определение, Заголовок, Заголовок таблицы, Заголовок изображения, Рисунок, Рисунок с заголовком, TOC
Заголовок; [символ] Шрифт абзаца по умолчанию, символ основного текста, дословный символ,
Ссылка на сноску, гиперссылка; [таблица] Нормальный стол.
--epub-stylesheet =ФАЙЛОВ
Используйте указанный файл CSS для стилизации EPUB. Если таблица стилей не указана,
pandoc будет искать файл epub.css в каталоге пользовательских данных (см. --data-dir).
Если его там нет, будут использованы разумные значения по умолчанию.
--epub-cover-image =ФАЙЛОВ
Используйте указанное изображение в качестве обложки EPUB. Рекомендуется, чтобы изображение было
менее 1000 пикселей по ширине и высоте. Обратите внимание, что в исходном документе Markdown вы
также можно указать изображение-обложку в блоке метаданных YAML (см. Метаданные EPUB ниже).
--epub-metadata =ФАЙЛОВ
Найдите в указанном XML-файле метаданные для EPUB. Файл должен содержать
серия элементов Dublin Core. Например:
Creative Commons
es-AR
По умолчанию pandoc будет включать следующие элементы метаданных: (от
название документа), (от авторов документа), (от
дата документа, которая должна быть в формате ISO 8601), (с языка
переменная, или, если не задана, локаль), и (а
случайно сгенерированный UUID). Любой из них может быть отменен элементами в
файл метаданных.
Примечание. Если исходным документом является Markdown, блок метаданных YAML в документе может
использоваться вместо этого. См. Ниже в разделе «Метаданные EPUB».
--epub-embed-font =ФАЙЛОВ
Вставить указанный шрифт в EPUB. Этот вариант можно повторить, чтобы встроить
несколько шрифтов. Также можно использовать подстановочные знаки: например, DejaVuSans - *. Ttf.
Однако, если вы используете подстановочные знаки в командной строке, не забудьте их экранировать или поставить
все имя файла в одинарных кавычках, чтобы предотвратить их интерпретацию
оболочка. Чтобы использовать встроенные шрифты, вам нужно будет добавить объявления, такие как
следуя вашему CSS (см. --epub-stylesheet):
@ font-face {
семейство шрифтов: DejaVuSans;
стиль шрифта: нормальный;
Вес шрифта: нормальный;
src: url ("DejaVuSans-Regular.ttf");
}
@ font-face {
семейство шрифтов: DejaVuSans;
стиль шрифта: нормальный;
шрифта: жирный;
src: url ("DejaVuSans-Bold.ttf");
}
@ font-face {
семейство шрифтов: DejaVuSans;
стиль шрифта: курсив;
Вес шрифта: нормальный;
src: url ("DejaVuSans-Oblique.ttf");
}
@ font-face {
семейство шрифтов: DejaVuSans;
стиль шрифта: курсив;
шрифта: жирный;
src: url ("DejaVuSans-BoldOblique.ttf");
}
body {font-family: "DejaVuSans"; }
--epub-chapter-level =НОМЕР
Укажите уровень заголовка, на котором нужно разделить EPUB на отдельные файлы «глав».
По умолчанию разделы делятся на заголовки уровня 1. Эта опция влияет только на
внутренняя структура EPUB, а не то, как главы и разделы
отображается для пользователей. Некоторые программы чтения могут работать медленно, если файлы глав слишком велики,
поэтому для больших документов с несколькими заголовками уровня 1 можно использовать главу
уровень 2 или 3.
--latex-engine = pdflatex | lualatex | xelatex
Используйте указанный механизм LaTeX при создании вывода PDF. По умолчанию - pdflatex.
Если двигатель не находится в вашем PATH, может быть указан полный путь двигателя
здесь.
--latex-engine-opt =STRING
Используйте данную строку в качестве аргумента командной строки для механизма latex. Если используется
несколько раз аргументы предоставляются с пробелами между ними. Обратите внимание, что нет
проверка на дублирование опций сделана.
Цитата оказание
--bibliography =ФАЙЛОВ
Установите для поля библиографии в метаданных документа значение ФАЙЛОВ, переопределяя любое значение
установить в метаданных и обработать цитаты с помощью pandoc-citeproc. (Это
эквивалент --metadata bibliography = FILE --filter pandoc-citeproc.) Если --natbib
или --biblatex также предоставляется, pandoc-citeproc не используется, что делает этот эквивалент
to --metadata bibliography = FILE. Если вы укажете этот аргумент несколько раз, каждый
ФАЙЛОВ будет добавлен в библиографию.
--csl =ФАЙЛОВ
Установите для поля csl в метаданных документа значение ФАЙЛОВ, переопределяя любое значение, установленное в
метаданные. (Это эквивалентно --metadata csl = FILE.) Эта опция только
актуально с pandoc-citeproc.
--citation-abbreviations =ФАЙЛОВ
Установите для поля сокращений цитирования в метаданных документа значение ФАЙЛОВ, преобладающий
любое значение, установленное в метаданных. (Это эквивалентно
--metadata citation-abbreviations = FILE.) Эта опция актуальна только с
пандок-citeproc.
--натбиб
Используйте natbib для цитирования в выводе LaTeX. Этот параметр не предназначен для использования с
pandoc-citeproc или с выводом PDF. Он предназначен для использования в производстве
Файл LaTeX, который можно обработать с помощью bibtex.
--библатекс
Используйте biblatex для цитирования в выводе LaTeX. Этот параметр не предназначен для использования с
pandoc-citeproc или с выводом PDF. Он предназначен для использования в производстве
Файл LaTeX, который можно обрабатывать с помощью bibtex или biber.
Математики оказание in HTML
-m [URL], --latexmathml [=URL]
Используйте LaTeXMathML для отображения встроенной математики TeX в выводе HTML. В URL должен указать
в скрипт загрузки LaTeXMathML.js. Если URL не предоставляется, ссылка на
LaTeXMathML.js на домашней странице LaTeXMathML будет вставлен.
--mathml [=URL]
Преобразуйте математику TeX в MathML (в docbook, а также в html и html5). В автономном режиме
html, небольшой javascript (или ссылку на такой скрипт, если URL в комплект поставки)
будет вставлен, что позволит просматривать MathML в некоторых браузерах.
--jsmath [=URL]
Используйте jsMath для отображения встроенной математики TeX в выводе HTML. В URL должен указывать на
скрипт загрузки jsMath (например, jsMath / easy / load.js); если предоставлен, он будет связан
в заголовок автономных HTML-документов. Если URL не предусмотрено, без ссылки
в скрипт загрузки jsMath будет вставлен; тогда автор должен предоставить
такая ссылка в шаблоне HTML.
--mathjax [=URL]
Используйте MathJax для отображения встроенной математики TeX в выводе HTML. В URL должен указывать на
скрипт загрузки MathJax.js. Если URL не предоставляется, ссылка на MathJax CDN
будет вставлен.
--гладтекс
Приложите математику TeX к теги в выводе HTML. Затем они могут быть обработаны
gladTeX для создания ссылок на изображения наборных формул.
--mimetex [=URL]
Обработайте математику TeX с помощью скрипта mimeTeX CGI. Если URL не указано, это
предполагается, что сценарий находится в /cgi-bin/mimetex.cgi.
--webtex [=URL]
Визуализируйте формулы TeX с помощью внешнего скрипта, преобразующего формулы TeX в изображения.
Формула будет объединена с предоставленным URL-адресом. Если URL не указано,
будет использоваться Google Chart API.
--katex [=URL]
Используйте KaTeX для отображения встроенной математики TeX в выводе HTML. В URL следует указать на
katex.js загрузочный скрипт. Если URL не предоставляется, ссылка на KaTeX CDN будет
вставлено.
--katex-stylesheet =URL
Команда URL должен указывать на таблицу стилей katex.css. Если эта опция не указана,
будет вставлена ссылка на KaTeX CDN. Обратите внимание, что этот вариант не подразумевает
- катекс.
Возможности для обертка скрипты
--дамп-аргументы
Распечатать информацию об аргументах командной строки в стандартный вывод, затем выйдите. Этот вариант
предназначен в первую очередь для использования в сценариях оболочки. Первая строка вывода
содержит имя выходного файла, указанного с параметром -o, или - (для
стандартный вывод), если выходной файл не указан. Остальные строки содержат
аргументы командной строки, по одному на строку, в порядке их появления. Это не
включать обычные параметры pandoc и их аргументы, но включать любые параметры
появляется после разделителя - в конце строки.
--игнорировать-аргументы
Игнорировать аргументы командной строки (для использования в сценариях оболочки). Обычные варианты pandoc
не игнорируются. Так, например,
pandoc --ignore-args -o foo.html -s foo.txt - -e latin1
эквивалентна
пандок -о foo.html -s
ШАБЛОНЫ
Когда используется автономная опция -s / -, pandoc использует шаблон для добавления верхнего и нижнего колонтитула.
материал, необходимый для самостоятельного документа. Чтобы увидеть шаблон по умолчанию,
используется, просто введите
pandoc -D * ФОРМАТ *
в котором ФОРМАТ это имя выходного формата. Пользовательский шаблон можно указать с помощью
параметр --template. Вы также можете переопределить системные шаблоны по умолчанию для данного
Выходной формат ФОРМАТ поместив файл templates / default. * FORMAT * в пользовательские данные
каталог (см. --data-dir выше). Исключения: Для вывода odt настройте
шаблон default.opendocument. Для вывода в формате PDF настройте латексный шаблон по умолчанию.
Шаблоны содержат переменные, которые позволяют включать произвольную информацию в любой
точка в файле. Переменные могут быть установлены в документе с использованием блоков метаданных YAML.
Они также могут быть установлены в командной строке с помощью параметра -V / - variable: переменные установлены в
таким образом переопределить поля метаданных с тем же именем.
Переменные набор by пандок
Некоторые переменные автоматически устанавливаются pandoc. Они несколько различаются в зависимости от
выходной формат, но включает поля метаданных, а также следующее:
заглавие, автор, даты
позволяют идентифицировать основные аспекты документа. Включено в метаданные PDF
через LaTeX и ConTeXt. Их можно установить с помощью основной надписи pandoc, которая
позволяет использовать несколько авторов или через блок метаданных YAML:
Напишите нам в чат или Email
автор:
- Аристотель
- Питер Абеляр
...
подзаголовок
подзаголовок документа, включенный в HTML, EPUB, LaTeX, ConTeXt и Word docx; оказывает
в LaTeX только при использовании класса документа, который поддерживает \ subtitle, например, beamer
или серия KOMA-Script (scrartcl, scrreprt, scrbook).
Абстрактные
резюме документа, включенное в LaTeX, ConTeXt, AsciiDoc и Word docx
ключевые слова
список ключевых слов для включения в метаданные HTML, PDF и AsciiDoc; может быть
повторяется как для автора, выше
заголовок включает
содержимое, указанное -H / - include-in-header (может иметь несколько значений)
TOC ненулевое значение, если было указано --toc / - table-of-contents
заголовок
заголовок оглавления (работает только с EPUB и docx)
включить-перед
содержимое, указанное параметром -B / - include-before-body (может иметь несколько значений)
включить-после
содержимое, указанное параметром -A / - include-after-body (может иметь несколько значений)
тело основная часть документа
мета-json
JSON-представление всех метаданных документа
Язык переменные
Ланг определяет основной язык документа, используя код в соответствии с BCP 47
(например, en или en-GB). Для некоторых форматов вывода pandoc преобразует его в
соответствующий формат сохраняется в дополнительных переменных babel-lang, polyglossia-lang
(LaTeX) и язык контекста (ConTeXt).
Могут использоваться собственные диапазоны pandoc и div с атрибутом lang (значение в BCP 47).
для переключения языка в этом диапазоне.
другие языки
список других языков, используемых в документе в метаданных YAML, согласно
BCP 47. Например: другие языки: [en-GB, fr]. Это автоматически создается
из атрибутов lang во всех диапазонах и разделах, но их можно переопределить. В настоящее время
используется только LaTeX через сгенерированные babel-otherlangs и
переменные polyglossia-otherlangs. Писатель LaTeX выводит команды полиглоссии в
текст, но переменная babel-newcommands содержит сопоставления для них с
соответствующий вавилон.
директория базовое направление документа, либо rtl (справа налево), либо ltr
(слева направо).
Для двунаправленных документов собственные диапазоны pandoc и div с атрибутом dir
(значение rtl или ltr) может использоваться для отмены базового направления в некоторых выходных данных.
форматы. Это не всегда может быть необходимо, если окончательный рендерер (например,
браузер при генерации HTML) поддерживает двунаправленный алгоритм Unicode.
При использовании LaTeX для двунаправленных документов только движок xelatex полностью
поддерживается (используйте --latex-engine = xelatex).
Переменные для слайдах
Доступны переменные для создания слайд-шоу с помощью pandoc, включая все discover.js.
Варианты конфигурации.
скользящий URL
базовый URL-адрес для документов Slidy (по умолчанию http://www.w3.org/Talks/Tools/Slidy2)
слайд-URL
базовый URL-адрес для слайд-документов (по умолчанию слайд-документ)
s5-url базовый URL для документов S5 (по умолчанию s5 / по умолчанию)
Показать js-url
базовый URL-адрес для документов detect.js (по умолчанию detect.js)
тема, цветовая тема шрифттема, внутренняя тема внешняя тема
темы для документов проекторов LaTeX
навигация
управляет навигационными символами в документах beamer (по умолчанию пусто, без навигации
символы; другие допустимые значения: рамка, вертикаль и горизонталь).
заголовки разделов
включает "титульные листы" для новых разделов в beamer-документах (по умолчанию = true).
Переменные для Латекс
Переменные LaTeX используются при создании PDF.
размер бумаги
размер бумаги, например, Letter, A4
размер шрифта
размер шрифта для основного текста (например, 10 или 12 пунктов)
класс документов
класс документа, например, статья, отчет, книга, мемуары
классификация
опция для класса документа, например, oneide; может повторяться для нескольких вариантов
геометрия
опция для пакета геометрии, например margin = 1in; может повторяться для нескольких вариантов
маржа слева, маржа-право, маржа-верх, край дно
устанавливает поля, если геометрия не используется (в противном случае геометрия отменяет их)
растяжка
регулирует межстрочный интервал с помощью пакета setspace, например 1.25, 1.5
семейство шрифтов
пакет шрифтов для использования с pdflatex: TeX Live включает множество опций, задокументированных в
Каталог шрифтов LaTeX. По умолчанию используется латиноамериканский модерн.
варианты семейства шрифтов
параметры пакета, используемого как fontfamily: например, osf, sc с fontfamily, установленным на
mathpazo снабжает Палатино фигурками в старинном стиле и настоящими маленькими заглавными буквами; может быть
повторяется для нескольких вариантов
основной шрифт сансфонт монофонт математический шрифт CJKmainfont
семейства шрифтов для использования с xelatex или lualatex: возьмите имя любого системного шрифта,
используя пакет fontspec. Обратите внимание, что если используется CJKmainfont, пакет xecjk
должен быть доступен.
мейнфонтоптионс, безфонные опции, монофонтопции, математика, CJKoptions
параметры для использования с mainfont, sansfont, monofont, mathfont, CJKmainfont в xelatex
и люалатекс. Разрешите любой выбор, доступный через fontspec, например
Возможности OpenType: Numbers = OldStyle, Numbers = Proportional. Может повторяться для
несколько вариантов.
Fontenc
позволяет указывать кодировку шрифта через пакет fontenc (с pdflatex);
по умолчанию - T1 (см. руководство по кодировкам шрифтов LaTeX)
цветные ссылки
добавить цвет к тексту ссылки; автоматически включается, если любой из цветов ссылки, цвета цитаты,
urlcolor или toccolor установлены
цвет ссылки citecolor урлцвет, цвет
цвет для внутренних ссылок, ссылок для цитирования, внешних ссылок и ссылок в таблице
содержимое: использует любой из предопределенных цветов LaTeX
ссылки как заметки
приводит к тому, что ссылки печатаются как сноски
Отступ использует настройки класса документа для отступа (в противном случае - шаблон LaTeX по умолчанию
убирает отступы и добавляет пробелы между абзацами)
подпункт
отключает поведение по умолчанию шаблона LaTeX, который переопределяет (под) абзацы как
разделы, изменяющие внешний вид вложенных заголовков в некоторых классах
благодаря определяет содержание сноски благодарности после заголовка документа.
TOC включить оглавление (также можно задать с помощью --toc / - table-of-contents)
глубина
уровень раздела для включения в оглавление
лоф много
включить список рисунков, список таблиц
Список используемой литературы
библиография для использования при разрешении ссылок
библио-стиль
стиль библиографии при использовании с --natbib и --biblatex.
библексопции
список вариантов библатекса.
Переменные для КОНТЕКСТ
размер бумаги
размер бумаги, например, Letter, A4, альбомная ориентация (см. Настройка бумаги ConTeXt); может повторяться
для нескольких вариантов
макет параметры полей страницы и расположения текста (см. Макет ConTeXt); может повторяться
для нескольких вариантов
маржа слева, маржа-право, маржа-верх, край дно
устанавливает поля, если макет не используется (в противном случае макет отменяет их)
размер шрифта
размер шрифта для основного текста (например, 10 или 12 пунктов)
основной шрифт сансфонт монофонт математический шрифт
семейства шрифтов: возьмите имя любого системного шрифта (см. Переключение шрифтов ConTeXt)
цвет ссылки контраст
цвет для ссылок снаружи и внутри страницы, например красный, синий (см. ConTeXt Color)
стиль ссылок
стиль шрифта для ссылок, например, обычный, полужирный, наклонный, полужирный, шрифт, заглавные буквы,
небольшой
отступов
контролирует отступ абзацев, например, да, маленький, следующий (см. Отступ ConTeXt);
может повторяться для нескольких вариантов
пробельные
интервал между абзацами, например, нет, маленький (с использованием setupwhitespace)
межстрочное пространство
регулирует межстрочный интервал, например, 4ex (используя setupinterlinespace); может повторяться для
несколько вариантов
заголовок нижний колонтитул
текст, который будет помещен в бегущий верхний или нижний колонтитул (см. Заголовки и нижние колонтитулы ConTeXt);
может повторяться до четырех раз для разных мест размещения
нумерация страниц
стиль и расположение номера страницы (с использованием настройки нумерации); может повторяться для
несколько вариантов
TOC включить оглавление (также можно задать с помощью --toc / - table-of-contents)
лоф много
включить список рисунков, список таблиц
Переменные для человек страниц
.
номер раздела на страницах руководства
заголовок заголовок на страницах руководства
нижний колонтитул нижний колонтитул на страницах руководства
регулировка
выравнивает текст по левому (l), правому (r), центру (c) или обоим (b) полям
написанный через дефис
если true (по умолчанию), будет использоваться перенос
. переменные in шаблоны
Имена переменных представляют собой последовательности буквенно-цифровых символов, - и _, начинающиеся с буквы. А
имя переменной, окруженное знаками $, будет заменено ее значением. Например,
строка $ title $ в
$ title $
будет заменен заголовком документа.
Чтобы написать буквальный символ $ в шаблоне, используйте $$.
Шаблоны могут содержать условные выражения. Синтаксис следующий:
$ if (переменная) $
X
$ else $
Y
$ endif $
Это будет включать X в шаблон, если переменная имеет ненулевое значение; иначе это будет
включить Y. X и Y являются заполнителями для любого допустимого текста шаблона и могут включать
интерполированные переменные или другие условные выражения. Раздел $ else $ можно опустить.
Когда переменные могут иметь несколько значений (например, автор в документе с несколькими авторами),
вы можете использовать ключевое слово $ for $:
$ для (автора) $
$ endfor $
При желании вы можете указать разделитель, который будет использоваться между последовательными элементами:
$ for (автор) $$ author $$ sep $, $ endfor $
Точку можно использовать для выбора поля переменной, значение которой принимает объект. Так,
например:
$ author.name $ ($ author.affiliation $)
Если вы используете настраиваемые шаблоны, вам может потребоваться отредактировать их при изменении pandoc. Мы рекомендуем
отслеживание изменений в шаблонах по умолчанию и изменение ваших пользовательских шаблонов
соответственно. Легкий способ сделать это - разветвить репозиторий pandoc-templates и объединить
в изменениях после каждого выпуска pandoc.
ПАНДОК ОТМЕТКА
Pandoc понимает расширенную и немного переработанную версию Markdown Джона Грубера.
синтаксис. В этом документе объясняется синтаксис, отмечены отличия от стандартного Markdown.
Если не указано иное, эти различия можно подавить с помощью markdown_strict.
формат вместо уценки. Расширения можно включить, добавив + EXTENSION к
имя формата и отключено добавлением -EXTENSION. Например, markdown_strict + сноски - это
строгий Markdown с включенными сносками, а markdown-footnotes-pipe_tables - это pandoc's
Уценка без сносок и таблиц.
Философия
Markdown разработан таким образом, чтобы его было легко писать и, что еще более важно, легко читать:
Документ в формате Markdown должен публиковаться как есть, как обычный текст, без
выглядит так, как будто он был размечен тегами или инструкциями по форматированию. -- Джон
Gruber
Этот принцип лежит в основе решений pandoc при поиске синтаксиса для таблиц, сносок и
другие расширения.
Однако есть один аспект, в котором цели pandoc отличаются от первоначальных целей.
Markdown. Принимая во внимание, что Markdown изначально разрабатывался с учетом генерации HTML,
pandoc разработан для нескольких форматов вывода. Таким образом, в то время как pandoc позволяет встраивать
необработанного HTML, он не одобряет его и предоставляет другие, отличные от HTML способы представления
важные элементы документа, такие как списки определений, таблицы, математические данные и сноски.
Пункты
Абзац - это одна или несколько строк текста, за которыми следует одна или несколько пустых строк. Новые строки
рассматриваются как пробелы, поэтому вы можете изменять расположение абзацев по своему усмотрению. Если вам нужен жесткий
разрыв строки, поместите два или более пробелов в конце строки.
Расширение: escaped_line_breaks
Обратная косая черта, за которой следует новая строка, также является жестким разрывом строки. Примечание: в многострочном и сеточном виде
ячейки таблицы, это единственный способ создать жесткий разрыв строки, поскольку конечные пробелы в
ячейки игнорируются.
Заголовки
Есть два типа заголовков: Setext и ATX.
Сетевой стиль Заголовки
Заголовок в стиле setext - это строка текста, «подчеркнутая» с рядом знаков = (для уровня
один заголовок) или - знаки (для заголовка второго уровня):
Заголовок первого уровня
==================
Заголовок второго уровня
------------------
Текст заголовка может содержать встроенное форматирование, например выделение (см. Встроенное форматирование,
ниже).
В стиле ATX Заголовки
Заголовок в стиле ATX состоит из от одного до шести знаков # и строки текста, за которой можно следовать.
любым количеством знаков #. Количество знаков # в начале строки - это
уровень заголовка:
## Заголовок второго уровня
### Заголовок третьего уровня ###
Как и в случае заголовков в стиле setext, текст заголовка может содержать форматирование:
# Заголовок первого уровня с [ссылкой] (/ url) и * выделением *
Расширение: Blank_before_header
Стандартный синтаксис Markdown не требует наличия пустой строки перед заголовком. Пандок делает
требовать этого (кроме, конечно, начала документа). Причина
требование состоит в том, чтобы знак # мог оказаться в начале строки на
авария (возможно, из-за переноса строки). Рассмотрим, например:
Мне нравятся несколько их вкусов мороженого:
# 22, например, и # 5.
заголовок идентификаторы
Расширение: header_attributes
Заголовкам можно присвоить атрибуты, используя этот синтаксис в конце строки, содержащей
текст заголовка:
{#identifier .class .class key = value key = value}
Таким образом, например, всем следующим заголовкам будет присвоен идентификатор foo:
# Мой заголовок {#foo}
## Мой заголовок ## {#foo}
Другой мой заголовок {#foo}
---------------
(Этот синтаксис совместим с PHP Markdown Extra.)
Обратите внимание, что хотя этот синтаксис позволяет назначать классы и атрибуты ключ / значение,
писатели обычно не используют всю эту информацию. Идентификаторы, классы и ключ / значение
атрибуты используются в форматах HTML и на основе HTML, таких как EPUB и slidy. Идентификаторы
используются для меток и привязок ссылок в средствах записи LaTeX, ConTeXt, Textile и AsciiDoc.
Заголовки с ненумерованным классом не будут нумероваться, даже если --number-section -
указано. Одиночный дефис (-) в контексте атрибута эквивалентен .unnumbered, и
предпочтительно в неанглоязычных документах. Так,
# Мой заголовок {-}
точно так же, как
# Мой заголовок {.unnumbered}
Расширение: auto_identifiers
Заголовку без явно указанного идентификатора будет автоматически назначен
уникальный идентификатор на основе текста заголовка. Чтобы получить идентификатор из заголовка
Текст,
· Удалите все форматирование, ссылки и т. Д.
· Убрать все сноски.
· Удалите все знаки препинания, кроме подчеркивания, дефисов и точек.
· Замените все пробелы и символы новой строки дефисами.
· Преобразование всех буквенных символов в нижний регистр.
· Удалите все, вплоть до первой буквы (идентификаторы не могут начинаться с цифры или
знак препинания).
· Если после этого ничего не осталось, используйте раздел идентификаторов.
Так, например,
Идентификатор заголовка
───────────────────────────────────────────────────── ──────
Идентификаторы заголовка в HTML header-identifiers-in-html
* Собаки *? - в * моем * доме? собаки - в моем доме
[HTML], [S5] или [RTF]? html-s5-или-rtf
3. Приложения приложения
Раздел 33
Эти правила в большинстве случаев должны позволять определять идентификатор из заголовка.
текст. Исключение составляют случаи, когда несколько заголовков имеют одинаковый текст; в этом случае первый
получит идентификатор, как описано выше; второй получит тот же идентификатор с -1
добавлено; третий с -2; и так далее.
Эти идентификаторы используются для предоставления целей ссылки в оглавлении, созданном
параметр --toc | --table-of-contents. Они также упрощают предоставление ссылок из одного
раздел документа в другой. Ссылка на этот раздел, например, может выглядеть так:
это:
Смотрите раздел на
[идентификаторы заголовка] (# идентификаторы-заголовка-в-html-latex-и-контексте).
Однако обратите внимание, что этот метод предоставления ссылок на разделы работает только в HTML, LaTeX,
и форматы ConTeXt.
Если указан параметр --section-divs, то каждый раздел будет заключен в div (или
раздел, если был указан --html5), а идентификатор будет прикреплен к
(или ), а не сам заголовок. Это позволяет целым разделам быть
обрабатываются с помощью javascript или обрабатываются по-другому в CSS.
Расширение: implicit_header_references
Pandoc ведет себя так, как если бы ссылочные ссылки были определены для каждого заголовка. Итак, вместо
[идентификаторы заголовков] (# идентификаторы заголовков в HTML)
вы можете просто написать
[идентификаторы заголовка]
or
[идентификаторы заголовка] []
or
[раздел об идентификаторах заголовков] [идентификаторы заголовков]
Если имеется несколько заголовков с одинаковым текстом, в соответствующей ссылке будет ссылка
только к первому, и вам нужно будет использовать явные ссылки для ссылки на другие, так как
описано выше.
Как и в обычных ссылках, в этих ссылках регистр не учитывается.
Явные определения ссылок на ссылки всегда имеют приоритет над неявными ссылками на заголовки.
Итак, в следующем примере ссылка будет указывать на bar, а не на #foo:
# Фу
[foo]: бар
См. [Foo]
Заблокировать цитаты
Markdown использует соглашения об электронной почте для цитирования блоков текста. Цитата блока - это одна или
больше абзацев или других блочных элементов (например, списков или заголовков) в каждой строке
которому предшествует символ> и необязательный пробел. (Знак> необязательно начинать слева
margin, но отступ не должен превышать трех пробелов.)
> Это цитата из блока. Этот
> В абзаце две строки.
>
> 1. Это список внутри цитаты.
> 2. Второй пункт.
"Ленивая" форма, которая требует наличия символа> только в первой строке каждого блока, - это
также разрешено:
> Это цитата из блока. Этот
абзац состоит из двух строк.
> 1. Это список внутри цитаты.
2. Второй пункт.
Среди элементов блока, которые могут содержаться в цитате блока, есть и другие цитаты блока.
То есть блочные кавычки могут быть вложенными:
> Это цитата из блока.
>
>> Цитата внутри цитаты.
Если за символом> следует необязательный пробел, этот пробел будет считаться частью
маркер цитаты блока, а не часть отступа содержимого. Таким образом, чтобы поставить
кодовый блок с отступом в цитате блока, вам нужно пять пробелов после>:
> код
Расширение: Blank_before_blockquote
Стандартный синтаксис Markdown не требует пустой строки перед цитатой блока. Пандок делает
требовать этого (кроме, конечно, начала документа). Причина
требование состоит в том, что> слишком легко может оказаться в начале строки на
авария (возможно, из-за переноса строки). Итак, если не используется формат markdown_strict,
следующее не создает вложенную цитату блока в pandoc:
> Это цитата из блока.
>> Вложенные.
Дословно (код) Блоки
изрезанный код Блоки
Блок текста с отступом в четыре пробела (или одна табуляция) рассматривается как дословный текст: то есть,
специальные символы не вызывают специального форматирования, а все пробелы и разрывы строк
сохранились. Например,
if (a> 3) {
moveShip (5 * гравитация, ВНИЗ);
}
Начальный отступ (четыре пробела или одна табуляция) не считается частью дословного.
текст и удаляется при выводе.
Примечание: пустые строки в дословном тексте не обязательно должны начинаться с четырех пробелов.
огражденный код Блоки
Расширение: огражденные_кодовые_блоки
Помимо стандартных блоков кода с отступом, pandoc поддерживает огорожена кодовые блоки. Эти
начинаются строкой из трех или более тильд (~) и заканчиваются рядом тильд, которые должны быть
по крайней мере, по длине в стартовом ряду. Все, что находится между этими строками, рассматривается как код. Нет
отступ необходим:
~~~~~~~
if (a> 3) {
moveShip (5 * гравитация, ВНИЗ);
}
~~~~~~~
Как и обычные блоки кода, изолированные блоки кода должны быть отделены от окружающего текста символом
пустые строки.
Если сам код содержит ряд тильд или обратных кавычек, просто используйте более длинный ряд тильд.
или обратные кавычки в начале и в конце:
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~~~~~~~~~~
код, включая тильды
~~~~~~~~~~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
Расширение: backtick_code_blocks
То же, что и fenced_code_blocks, но использует обратные кавычки (`) вместо тильд (~).
Расширение: заборный_код_атрибуты
При желании вы можете прикрепить атрибуты к изолированному блоку кода или блоку кода с обратной кавычкой, используя этот синтаксис:
~~~~ {#mycode .haskell .numberLines startFrom = "100"}
сортировка [] = []
qsort (x: xs) = qsort (filter (<x) xs) ++ [x] ++
qsort (фильтр (> = x) xs)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Здесь mycode - это идентификатор, haskell и numberLines - это классы, а startFrom - это
атрибут со значением 100. Некоторые форматы вывода могут использовать эту информацию для синтаксиса.
выделение. В настоящее время единственными выходными форматами, в которых используется эта информация, являются HTML и
Латекс. Если выделение поддерживается для вашего формата и языка вывода, то код
блок выше будет выделен с пронумерованными строками. (Чтобы узнать, какие языки
поддерживается, выполните pandoc --version.) В противном случае приведенный выше блок кода будет выглядеть следующим образом:
...
Для указания языка блока кода также можно использовать форму быстрого доступа:
Хаскелл
сортировка [] = []
`` `
Это эквивалентно:
`` {.haskell}
сортировка [] = []
`` `
Если расширение fenced_code_attributes отключено, но входные данные содержат атрибут (ы) класса
для кодового блока атрибут первого класса будет напечатан после открывающейся ограды как
голое слово.
Чтобы предотвратить любое выделение, используйте флаг --no-highlight. Чтобы установить стиль выделения,
используйте --highlight-style. Дополнительные сведения о выделении см. В разделе Подсветка синтаксиса,
внизу.
линия Блоки
Расширение: line_blocks
Блок строки - это последовательность строк, начинающаяся с вертикальной черты (|), за которой следует пробел.
Разделение на строки будет сохранено в выводе, как и любые начальные пробелы;
в противном случае строки будут отформатированы как Markdown. Это полезно для стихов и
адреса:
| Пакеты лимерика смеются анатомически
| В космосе это довольно экономично.
| Но хорошие, которые я видел
| Так редко бывают чистыми
| И чистые так редко бывают смешными
| 200 Мэйн Ст.
| Беркли, Калифорния 94718
При необходимости строки могут быть жестко обернуты, но строка продолжения должна начинаться с символа
пространстве.
| Досточтимый досточтимый и праведный Сэмюэл Л.
Констебль-младший
| 200 Мэйн Ст.
| Беркли, Калифорния 94718
Этот синтаксис заимствован из reStructuredText.
Списки
Bullet списки
Маркированный список - это список элементов маркированного списка. Элемент маркированного списка начинается с маркера
(*, + или -). Вот простой пример:
* один
* два
* три
Это даст «компактный» список. Если вам нужен «свободный» список, в котором каждый элемент
отформатированный как абзац, между элементами ставьте пробелы:
* один
* два
* три
Пули не должны быть на одном уровне с левым краем; они могут быть с отступом один, два или
три пробела. После маркера должен быть пробел.
Элементы списка выглядят лучше, если последующие строки совпадают с первой строкой (после маркера):
* вот мой первый
пункт списка.
* и мой второй.
Но Markdown также допускает "ленивый" формат:
* вот мой первый
пункт списка.
* и мой второй.
Команда четырехмерный править
Элемент списка может содержать несколько абзацев и другое содержимое блочного уровня. Тем не мение,
последующим абзацам должна предшествовать пустая строка с четырьмя пробелами или табуляцией с отступом.
Список будет выглядеть лучше, если первый абзац выровнен с остальными:
* Первый параграф.
Продолжение.
* Второй абзац. С блоком кода, который должен иметь отступ
восемь пробелов:
{код}
Элементы списка могут включать другие списки. В этом случае предыдущая пустая строка не обязательна.
Вложенный список должен иметь отступ в четыре пробела или одну табуляцию:
* фрукты
+ яблоки
- макинтош
- красный вкусный
+ груши
+ персики
* овощи
+ брокколи
+ мангольд
Как отмечалось выше, Markdown позволяет «лениво» писать элементы списка вместо того, чтобы делать отступы.
линии продолжения. Однако, если в списке несколько абзацев или других блоков
item, первая строка каждого должна быть с отступом.
+ Ленивый, ленивый, список
пункт.
+ Еще один; это выглядит
плохо, но законно.
Второй абзац второго
пункт списка.
Примечание: Хотя правило четырех пробелов для продолжения абзацев взято из официального
Руководство по синтаксису Markdown, эталонная реализация Markdown.pl не следует ему. Так
pandoc даст отличные от Markdown.pl результаты, если авторы сделали отступ
в продолжении абзацев меньше четырех пробелов.
В руководстве по синтаксису Markdown не уточняется, применяется ли правило четырех пробелов к ВСЕ
блочный контент в элементе списка; он упоминает только абзацы и блоки кода. Но это
подразумевает, что правило применяется ко всему содержимому уровня блока (включая вложенные списки), и
pandoc интерпретирует это так.
Упорядоченный списки
Упорядоченные списки работают так же, как маркированные списки, за исключением того, что элементы начинаются с счетчиков.
а не пули.
В стандартном Markdown перечислители представляют собой десятичные числа, за которыми следуют точка и пробел.
Сами числа игнорируются, поэтому разницы между этим списком нет:
1. один
2. два
3. три
и этот:
5. один
7. два
1. три
Расширение: фантазии_списки
В отличие от стандартного Markdown, pandoc позволяет отмечать элементы упорядоченного списка заглавными буквами и
строчные буквы и римские цифры в дополнение к арабским цифрам. Маркеры списка могут быть
в круглых скобках или после одной правой круглой скобки или точки. Они должны быть
отделены от текста, который следует за ним, по крайней мере, одним пробелом, и, если маркер списка является
заглавная буква с точкой, не менее чем через два пробела.
Расширение fancy_lists также позволяет использовать '#' в качестве маркера упорядоченного списка вместо
числительное:
#. один
#. два
Расширение: стартовый номер
Pandoc также обращает внимание на тип используемого маркера списка и начальный номер,
и оба они сохраняются, где это возможно, в выходном формате. Таким образом, следующие
дает список с числами, за которыми следует одинарная скобка, начиная с 9, и
подсписок с римскими цифрами в нижнем регистре:
9) Девятая
10) Десятая
11) Одиннадцатая
я. subone
II. сабвуфер
iii. субтри
Pandoc будет начинать новый список каждый раз, когда используется другой тип маркера списка. Так что
следующее создаст три списка:
(2) Два
(5) Три
1. четыре
* Пять
Если требуются маркеры списка по умолчанию, используйте # .:
#. один
#. два
#. три
Определение списки
Расширение: списки_определений
Pandoc поддерживает списки определений, используя синтаксис PHP Markdown Extra с некоторыми
.
Срок 1
: Определение 1
Термин 2 с * встроенной разметкой *
: Определение 2
{некоторый код, часть определения 2}
Третий абзац определения 2.
Каждый термин должен умещаться в одной строке, за которой при желании может следовать пустая строка, и должен
после этого следует одно или несколько определений. Определение начинается с двоеточия или тильды, которые
может быть с отступом в один или два пробела.
Термин может иметь несколько определений, и каждое определение может состоять из одного или нескольких блоков.
элементы (абзац, блок кода, список и т. д.), каждый с отступом в четыре пробела или одну позицию табуляции.
Тело определения (включая первую строку, кроме двоеточия или тильды)
должен быть с отступом в четыре пробела. Однако, как и в случае с другими списками Markdown, вы можете "лениво"
опускать отступ, за исключением начала абзаца или другого элемента блока:
Срок 1
: Определение
с ленивым продолжением.
Второй абзац определения.
Если вы оставите пробел перед определением (как в примере выше), текст
определение будет рассматриваться как абзац. В некоторых форматах вывода это будет означать большее
интервал между парами термин / определение. Для более компактного списка определений опустите пробел
перед определением:
Срок 1
~ Определение 1
Срок 2
~ Определение 2a
~ Определение 2b
Обратите внимание, что требуется пробел между элементами в списке определений. (Вариант, который ослабляет
это требование, но запрещающее "ленивую" жесткую упаковку, может быть активировано с помощью
compact_definition_lists: см. Расширения, отличные от pandoc, ниже.)
нумерованный пример списки
Расширение: примеры_списков
Специальный маркер списка @ может использоваться для последовательно пронумерованных примеров. Первый список
элемент с маркером @ будет пронумерован "1", следующий "2" и т. д. на протяжении всего
документ. Пронумерованные примеры не обязательно должны быть в едином списке; каждый новый список с использованием @
возьму там, где остановился последний. Так, например:
(@) Мой первый пример будет пронумерован (1).
(@) Мой второй пример будет пронумерован (2).
Пояснение к примерам.
(@) Мой третий пример будет пронумерован (3).
Пронумерованные примеры могут быть помечены и ссылаться на них в другом месте документа:
(@good) Это хороший пример.
Как показывает (@good), ...
Метка может быть любой строкой, состоящей из буквенно-цифровых символов, знаков подчеркивания или дефисов.
Compact и свободный списки
Pandoc ведет себя иначе, чем Markdown.pl в некоторых «крайних случаях», связанных со списками.
Рассмотрим этот источник:
+ Первый
+ Второй:
- Платеж
- тьфу
- Враг
+ Третий
Pandoc преобразует это в "компактный список" (без теги вокруг "Первый", "Второй",
или "Третий"), а Markdown помещает теги вокруг "Второго" и "Третьего" (но не "Первого"),
из-за пустого места вокруг «Третьей». Pandoc следует простому правилу: если текст
за которым следует пустая строка, он рассматривается как абзац. Поскольку за словом "Второй" следует
список, а не пустая строка, он не рассматривается как абзац. Дело в том, что список
с пустой строкой не имеет значения. (Примечание: Pandoc работает таким образом, даже если
указан формат markdown_strict. Такое поведение согласуется с официальным
Описание синтаксиса Markdown, хотя оно отличается от Markdown.pl.)
Окончание a список
Что, если вы хотите поместить блок кода с отступом после списка?
- пункт один
- пункт два
{мой блок кода}
Беда! Здесь pandoc (как и другие реализации Markdown) будет рассматривать {мой блок кода} как
второй абзац пункта два, а не как блок кода.
Чтобы «отрезать» список после второго пункта, вы можете вставить какой-нибудь контент без отступов, например
Комментарий HTML, который не дает видимого вывода ни в каком формате:
- пункт один
- пункт два
{мой блок кода}
Вы можете использовать тот же прием, если хотите два последовательных списка вместо одного большого:
1. один
2. два
3. три
1. уно
2. дос
3. три
горизонтальный условиями,
Строка, содержащая строку из трех или более символов *, - или _ (необязательно разделенных символом
пробелы) создает горизонтальную линейку:
* * * *
---------------
таблицы
Можно использовать четыре вида таблиц. Первые три вида предполагают использование
шрифт фиксированной ширины, например Courier. Четвертый вид можно использовать с пропорционально разнесенными
шрифты, так как не требует выравнивания столбцов.
Расширение: table_captions
При желании подпись может быть снабжена всеми 4 видами таблиц (как показано на
примеры ниже). Подпись - это абзац, начинающийся строкой Таблица: (или просто :),
который будет снят. Он может появиться до или после таблицы.
Расширение: простые_таблицы
Простые таблицы выглядят так:
Правый Левый Центр По умолчанию
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
Таблица: Демонстрация простого синтаксиса таблицы.
Заголовки и строки таблицы должны умещаться каждая в одной строке. Выравнивание столбцов определяется
положение текста заголовка относительно пунктирной линии под ним:
· Если пунктирная линия находится на одном уровне с текстом заголовка справа, но выходит за его пределы
слева столбец выровнен по правому краю.
· Если пунктирная линия находится на одном уровне с текстом заголовка слева, но выходит за его пределы
справа столбец выровнен по левому краю.
· Если пунктирная линия выходит за пределы текста заголовка с обеих сторон, столбец центрируется.
· Если пунктирная линия находится на одном уровне с текстом заголовка с обеих сторон, выравнивание по умолчанию
используется (в большинстве случаев это останется).
Таблица должна заканчиваться пустой строкой или строкой тире, за которой следует пустая строка.
Заголовки столбцов могут быть опущены, если в конце таблицы используется пунктирная линия. За
пример:
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
------- ------ ---------- -------
Если заголовки опущены, выравнивание столбцов определяется на основе первой строки.
тела стола. Итак, в приведенных выше таблицах столбцы будут справа, слева, по центру и
с выравниванием по правому краю соответственно.
Расширение: многострочные_таблицы
Многострочные таблицы позволяют заголовкам и строкам таблицы занимать несколько строк текста (но ячейки
которые охватывают несколько столбцов или строк таблицы, не поддерживаются). Вот пример:
-------------------------------------------------- -----------
По центру По умолчанию Вправо Влево
Заголовок Выровнен Выровнен Выровнен
----------- ------- --------------- ----------------- --------
Первая строка 12.0 Пример строки,
занимает несколько строк.
Второй ряд 5.0 Вот еще один. Примечание
пустая строка между
строк.
-------------------------------------------------- -----------
Таблица: вот подпись. Это тоже может охватывать
несколько строк.
Они работают как простые таблицы, но со следующими отличиями:
· Они должны начинаться с ряда дефисов перед текстом заголовка (если заголовки не
опущено).
· Они должны заканчиваться строкой тире, а затем пустой строкой.
· Строки должны быть разделены пустыми строками.
В многострочных таблицах парсер таблиц обращает внимание на ширину столбцов, а
писатели пытаются воспроизвести эту относительную ширину на выходе. Итак, если вы обнаружите, что один из
столбцы в выводе слишком узкие, попробуйте расширить его в источнике Markdown.
Заголовки могут быть опущены в многострочных таблицах, а также в простых таблицах:
----------- ------- --------------- ----------------- --------
Первая строка 12.0 Пример строки,
занимает несколько строк.
Второй ряд 5.0 Вот еще один. Примечание
пустая строка между
строк.
----------- ------- --------------- ----------------- --------
: Вот многострочная таблица без заголовков.
В многострочной таблице может быть только одна строка, но за ней следует следовать
пустой строкой (а затем строкой дефисов, завершающей таблицу), или таблица может быть
интерпретируется как простая таблица.
Расширение: Grid_tables
Таблицы сетки выглядят так:
: Пример таблицы сетки.
+ --------------- + --------------- + ----------------- --- +
| Фрукты | Цена | Преимущества |
+ =============== + =============== + ================= === +
| Бананы | 1.34 $ | - встроенная обертка |
| | | - яркий цвет |
+ --------------- + --------------- + ----------------- --- +
| Апельсины | 2.10 $ | - лечит цингу |
| | | - вкусно |
+ --------------- + --------------- + ----------------- --- +
Строка = s отделяет заголовок от тела таблицы и может быть опущена для
таблица без заголовка. Ячейки таблиц-сеток могут содержать произвольные блочные элементы (несколько
абзацы, блоки кода, списки и т. д.). Выравнивания не поддерживаются, равно как и ячейки,
охватывают несколько столбцов или строк. Таблицы сетки можно легко создавать в табличном режиме Emacs.
Расширение: Pipe_tables
Таблицы труб выглядят так:
| Правильно | Слева | По умолчанию | Центр |
| ------: |: ----- | --------- |: ------: |
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |
: Демонстрация синтаксиса таблицы каналов.
Синтаксис идентичен таблицам PHP Markdown Extra. Начальная и конечная труба
символы не являются обязательными, но между всеми столбцами обязательны вертикальные черты. Двоеточие обозначают
выравнивание столбца, как показано. Заголовок нельзя опускать. Чтобы смоделировать таблицу без заголовка,
включить заголовок с пустыми ячейками.
Поскольку трубы указывают границы столбцов, столбцы не нужно выравнивать по вертикали, поскольку
они есть в приведенном выше примере. Итак, это совершенно законная (хотя и уродливая) таблица каналов:
фрукты | цена
----- | -----:
яблоко | 2.05
груша | 1.37
оранжевый | 3.09
Ячейки таблиц каналов не могут содержать блочные элементы, такие как абзацы и списки, и
не может занимать несколько строк. Если таблица каналов содержит строку, печатаемое содержимое которой
шире ширины столбца (см. --columns), тогда содержимое ячейки будет перенесено с
относительная ширина ячеек определяется шириной разделительных линий.
Примечание: pandoc также распознает таблицы каналов следующей формы, которые могут быть созданы с помощью
Orgtbl-режим Emacs:
| Один | Два |
| ----- + ------- |
| мой | стол |
| есть | приятно |
Разница в том, что + используется вместо |. Другие функции orgtbl не поддерживаются.
В частности, чтобы получить выравнивание столбцов по умолчанию, вам нужно добавить двоеточия, как указано выше.
Метаданные Блоки
Расширение: pandoc_title_block
Если файл начинается с основной надписи
% заглавие
% author (s) (через точку с запятой)
% Дата
он будет анализироваться как библиографическая информация, а не как обычный текст. (Он будет использоваться для
Например, в заголовке автономного вывода LaTeX или HTML.) Блок может содержать только
title, название и автор или все три элемента. Если вы хотите указать автора, но
без названия или названия и даты, но без автора, вам нужна пустая строка:
%
% Автор
% Мое название
%
% 15 июня 2006 г.
Заголовок может занимать несколько строк, но строки продолжения должны начинаться с ведущего пробела,
таким образом:
% Мое название
на нескольких строках
Если у документа несколько авторов, авторы могут быть помещены в отдельные строки с ведущими
пробел, или разделенные точкой с запятой, или и то, и другое. Итак, все следующее эквивалентно:
% Автор Один
Автор два
% Автор Один; Автор два
% Автор Один;
Автор два
Дата должна умещаться в одной строке.
Все три поля метаданных могут содержать стандартное встроенное форматирование (курсив, ссылки,
сноски и т. д.).
Блоки заголовков всегда будут анализироваться, но они повлияют на вывод только тогда, когда
Выбрана опция --standalone (-s). В выводе HTML заголовки будут отображаться дважды: один раз в
заголовок документа - это заголовок, который будет отображаться в верхней части окна в браузере
- и один раз в начале тела документа. Заголовок в заголовке документа может
иметь прикрепленный необязательный префикс (опция --title-prefix или -T). Заголовок в теле
отображается как элемент H1 с классом "title", поэтому его можно подавить или переформатировать с помощью
CSS. Если префикс заголовка указан с -T и в документе не отображается основная надпись,
префикс заголовка будет использоваться сам по себе как заголовок HTML.
Автор справочной страницы извлекает заголовок, номер раздела справочной страницы и другой верхний и нижний колонтитулы.
информация из строки заголовка. Предполагается, что заголовок является первым словом в заголовке.
строка, которая может дополнительно заканчиваться (однозначным) номером раздела в круглых скобках.
(Между заголовком и круглыми скобками не должно быть пробелов.) Все, что находится после этого, считается
предполагается, что это дополнительный текст нижнего и верхнего колонтитула. Одинарный вертикальный символ (|) должен быть
используется для отделения текста нижнего колонтитула от текста верхнего колонтитула. Таким образом,
% ПАНДОК(1)
откроет страницу руководства с заголовком PANDOC и разделом 1.
% ПАНДОК(1) Руководства пользователя Pandoc
в нижнем колонтитуле также будут «Руководства пользователя Pandoc».
% ПАНДОК(1) Руководства пользователя Pandoc | Версия 4.0
в шапке тоже будет "Версия 4.0".
Расширение: yaml_metadata_block
Блок метаданных YAML - это действительный объект YAML, разделенный строкой из трех дефисов (---).
вверху и строку из трех дефисов (---) или трех точек (...) внизу. ЯМЛ
блок метаданных может находиться в любом месте документа, но если его нет в начале, он
должна предшествовать пустой строке. (Обратите внимание, что из-за того, как pandoc объединяет
входных файлов, если их несколько, вы также можете сохранить метаданные в отдельном YAML
file и передайте его pandoc в качестве аргумента вместе с вашими файлами Markdown:
pandoc chap1.md chap2.md chap3.md метаданные.yaml -s -o book.html
Просто убедитесь, что файл YAML начинается с --- и заканчивается --- или ....)
Метаданные будут взяты из полей объекта YAML и добавлены к любым существующим
метаданные документа. Метаданные могут содержать списки и объекты (вложенные произвольно), но все
Строковые скаляры будут интерпретироваться как Markdown. Поля с названиями, оканчивающимися знаком подчеркивания
будет проигнорирован pandoc. (Им могут дать роль внешние процессоры.)
Документ может содержать несколько блоков метаданных. Поля метаданных будут объединены
через левосторонний союз: если два блока метаданных пытаются установить одно и то же поле,
будет взято значение из первого блока.
Когда pandoc используется с -t markdown для создания документа Markdown, блок метаданных YAML
будет производиться, только если используется автономная опция -s / -. Все метаданные будут
появляются одним блоком в начале документа.
Обратите внимание, что необходимо соблюдать правила экранирования YAML. Так, например, если заголовок содержит
двоеточие, его необходимо указывать. Символ вертикальной черты (|) можно использовать для начала блока с отступом.
это будет интерпретироваться буквально, без необходимости убегать. Эта форма необходима
когда поле содержит пустые строки:
Напишите нам в чат или Email
title: 'Это заголовок: он содержит двоеточие'
автор:
- имя: Автор Один
принадлежность: University of Somewhere
- имя: Автор Два
принадлежность: Университет ниоткуда
теги: [ничего, ничто]
аннотация: |
Это аннотация.
Он состоит из двух абзацев.
...
Переменные шаблона будут установлены автоматически из метаданных. Так, например, в
при написании HTML переменная abstract будет установлена в HTML-эквивалент Markdown в
абстрактное поле:
Это аннотация.
Он состоит из двух абзацев.
Примечание. Переменная автора в шаблонах по умолчанию предполагает простой список или строку. К
используйте структурированных авторов в примере, вам понадобится собственный шаблон. Например:
$ для (автора) $
$ if (имя автора) $
$ author.name $$ if (author.affiliation) $ ($ author.affiliation $) $ endif $
$ else $
$ author $
$ endif $
$ endfor $
бэкслэш побег
Расширение: all_symbols_escapable
За исключением кода внутри блока кода или встроенного кода, любой знак препинания или пробел, которому предшествует
обратная косая черта будет трактоваться буквально, даже если она обычно указывает на форматирование.
Так, например, если написать
*\*Привет\**
один получит
*Привет*
вместо
Привет
Это правило легче запомнить, чем стандартное правило Markdown, которое разрешает только
следующие символы должны быть экранированы обратной косой чертой:
\ `* _ {} [] ()> # + -.!
(Однако, если используется формат markdown_strict, будет использоваться стандартное правило Markdown.)
Пробел с обратной косой чертой анализируется как неразрывный. Он появится в выводе TeX
как ~, а в HTML и XML как \ или \.
Новая строка с экранированной обратной косой чертой (т.е. обратная косая черта, встречающаяся в конце строки) анализируется
как жесткий разрыв строки. Он будет отображаться в выводе TeX как \\ и в HTML как . Это
хорошая альтернатива «невидимому» способу Markdown указывать жесткие разрывы строк с помощью двух
конечные пробелы в строке.
Экраны с обратной косой чертой не работают в дословном контексте.
Smart пунктуация
Расширение
Если указан параметр --smart, pandoc выдаст типографически правильный вывод,
преобразование прямых кавычек в фигурные, --- в длинное тире, - в тире и ... в
эллипсы. Неразрывные пробелы вставляются после определенных сокращений, таких как «Мистер».
Примечание: если ваш шаблон LaTeX или любой включенный файл заголовка вызывает пакет csquotes,
pandoc обнаружит это автоматически и будет использовать \ enquote {...} для цитируемого текста.
В очереди форматирование
акцент
к подчеркивать какой-нибудь текст, заключите его в * s или _, например:
Этот текст _ подчеркнут подчеркиванием_, и это
отмечен * звездочками *.
Двойной * или _ производит сильный акцент:
Это ** сильный акцент ** и __ с подчеркиванием__.
Символ * или _, окруженный пробелами или экранированный обратной косой чертой, не вызывает выделения:
Это * не подчеркнуто *, и \ * тоже не \ *.
Расширение: внутрисловные_подчеркивания
Поскольку _ иногда используется внутри слов и идентификаторов, pandoc не интерпретирует _
окружен буквенно-цифровыми символами в качестве маркера выделения. Если вы хотите подчеркнуть
просто часть слова, используйте *:
выполнимо * возможно *, не * выполнимо *.
аут
Расширение: аут
Чтобы зачеркнуть фрагмент текста горизонтальной линией, начните и закантите его знаком ~~. Таким образом,
Например,
Это ~~ удаленный текст. ~~
Надстрочные индексы и подстрочные
Расширение: надстрочный индекс индекс
Надстрочные индексы можно написать, заключив надстрочный текст в символы ^;
Подстрочные индексы могут быть написаны окружением подстрочного текста символами ~. Таким образом, для
пример,
H ~ 2 ~ O - жидкость. 2 ^ 10 ^ равно 1024.
Если текст с надстрочным или подстрочным индексом содержит пробелы, эти пробелы необходимо экранировать.
с обратной косой чертой. (Это сделано для предотвращения случайного ввода надстрочных и нижних индексов через
обычное использование ~ и ^.) Таким образом, если вам нужна буква P с 'котом' в нижних индексах,
используйте P ~ a \ cat ~, а не P ~ a cat ~.
Дословно
Чтобы сделать короткий текст дословным, поместите его внутри обратных кавычек:
В чем разница между `>> =` и `>>`?
Если дословный текст включает обратную кавычку, используйте двойные обратные кавычки:
Вот буквальная обратная кавычка `` ''.
(Пробелы после открывающих обратных кавычек и перед закрывающими обратными кавычками будут проигнорированы.)
Общее правило состоит в том, что дословный интервал начинается с цепочки последовательных обратных кавычек.
(необязательно сопровождаемый пробелом) и заканчивается строкой с таким же количеством обратных кавычек
(необязательно предваряется пробелом).
Обратите внимание, что обратная косая черта (и другие конструкции Markdown) не работают дословно.
контексты:
Это обратная косая черта, за которой следует звездочка: `\ *`.
Расширение: inline_code_attributes
Атрибуты могут быть прикреплены к дословному тексту, как и к изолированным блокам кода:
`<$>` {.haskell}
крышки
Чтобы писать маленькие заглавные буквы, вы можете использовать тег HTML span:
Маленькие шапки
(Точка с запятой не обязательна, после двоеточия может быть пробел.) Это будет работать во всех
форматы вывода, поддерживающие маленькие заглавные буквы.
Математики
Расширение: tex_math_dollars
Все, что находится между двумя символами $, будет рассматриваться как математика TeX. Открывающий $ должен иметь
непробельный символ сразу справа от него, в то время как закрывающий $ должен иметь непробельный
сразу слева от него, и за ним не должна сразу идти цифра. Таким образом,
20,000 30,000 и XNUMX XNUMX долларов не будут рассматриваться как математические. Если по какой-то причине вам нужно заключить текст в
буквальные символы $, экранируйте их с помощью обратной косой черты, и они не будут рассматриваться как математические разделители.
Математика TeX будет напечатана во всех выходных форматах. Как это отображается, зависит от вывода
Формат:
Уценка, Латекс, Emacs организация Режим, КОНТЕКСТ
Оно будет отображаться дословно между символами $.
ReStructuredText
Он будет отображаться с использованием интерпретируемой текстовой роли: math :.
AsciiDoc
Он будет отображаться как latexmath: [...].
Тексинфо
Он будет отображаться внутри команды @math.
Грофф человек
Он будет отображаться дословно без $.
МедиаВики, ДокуВики
Он будет отображаться внутри теги.
Текстиль
Он будет отображаться внутри тегов.
РТФ, открытый документ, ODT
Он будет отображаться, если это возможно, с использованием символов Юникода, а в противном случае
появляются дословно.
DocBook
Если используется флаг --mathml, он будет отображаться с использованием MathML во встроенном уравнении
или тег informalequation. В противном случае он будет отображаться, если это возможно, с использованием юникода.
символы.
Docx Он будет отображаться с использованием математической разметки OMML.
Художественная книга2
Если используется параметр --webtex, формулы отображаются как изображения с помощью Google Charts.
или другой совместимый веб-сервис, загруженный и встроенный в электронную книгу. В противном случае,
они появятся дословно.
HTML, Слиди, ДЗСлайды, S5, EPUB
Способ отображения математических вычислений в HTML будет зависеть от выбранных параметров командной строки:
1. По умолчанию математика TeX отображается, насколько это возможно, с использованием символов Юникода,
как с выходными данными в форматах RTF, DocBook и OpenDocument. Формулы помещаются в промежуток
с class = "math", поэтому их стиль может отличаться от стиля окружающих
текст, если необходимо.
2. Если используется параметр --latexmathml, математика TeX будет отображаться между $ или $$.
символов и вставьте теги с классом LaTeX. Скрипт LaTeXMathML будет
использоваться для визуализации в виде формул. (Этот трюк работает не во всех браузерах,
но он работает в Firefox. В браузерах, не поддерживающих LaTeXMathML, TeX math
будет дословно отображаться между символами $.)
3. Если используется опция --jsmath, математика TeX будет помещена внутри тегов (для
встроенная математика) или теги (для отображения математики) с классом math. JsMath
скрипт будет использоваться для его рендеринга.
4. Если используется опция --mimetex, сценарий mimeTeX CGI будет вызываться для
генерировать изображения для каждой формулы TeX. Это должно работать во всех браузерах. В
Опция --mimetex принимает в качестве аргумента необязательный URL. Если URL-адрес не указан, он
будет предполагаться, что сценарий mimeTeX CGI находится в /cgi-bin/mimetex.cgi.
5. Если используется опция --gladtex, формулы TeX будут заключены в теги в
вывод HTML. Полученный файл htex может быть обработан gladTeX,
который будет создавать файлы изображений для каждой формулы и файл HTML со ссылками на
эти изображения. Итак, порядок действий такой:
pandoc -s --gladtex мой файл.txt -o мой файл.htex
гладекс -d мои файлы-изображения мой файл.htex
# создает myfile.html и изображения в myfile-images
6. Если используется опция --webtex, формулы TeX будут преобразованы в теги
ссылка на внешний скрипт, преобразующий формулы в изображения. Формула
будут закодированы в URL-адресе и объединены с предоставленным URL-адресом. Если URL не указан
указано, будет использоваться Google Chart API
(http://chart.apis.google.com/chart? cht = tx & chl =).
7. Если используется опция --mathjax, математика TeX будет отображаться между \ (... \) (для
встроенная математика) или \ [... \] (для отображения математики) и вставьте теги с классом
математика. Сценарий MathJax будет использоваться для визуализации его в виде формул.
Сырье HTML
Расширение: raw_html
Markdown позволяет вставлять необработанный HTML (или DocBook) в любом месте документа (кроме
дословные контексты, где <,> и & интерпретируются буквально). (Технически это не
расширение, так как стандартный Markdown позволяет это, но было сделано расширение, так что
при желании его можно отключить.)
Необработанный HTML передается без изменений в HTML, S5, Slidy, Slideous, DZSlides, EPUB,
Markdown и Textile вывод, а также подавляются в других форматах.
Расширение: markdown_in_html_blocks
Стандартный Markdown позволяет включать «блоки» HTML: блоки HTML между сбалансированными
теги, которые отделены от окружающего текста пустыми строками и начинаются и заканчиваются на
левое поле. Внутри этих блоков все интерпретируется как HTML, а не как Markdown; так
(например), * не означает выделение.
Pandoc ведет себя так, когда используется формат markdown_strict; но по умолчанию pandoc
интерпретирует материал между тегами блока HTML как Markdown. Так, например, pandoc будет
очередь
*один*
[ссылка](http://google.com)
в
один
<a href="/http://google.com"> ссылка
тогда как Markdown.pl сохранит его как есть.
Есть одно исключение из этого правила: текст между and tags is not
интерпретируется как Markdown.
Этот отход от стандартного Markdown должен упростить смешивание Markdown с HTML.
блочные элементы. Например, можно окружить блок текста Markdown с помощью теги
не препятствуя его интерпретации как Markdown.
Расширение: Native_divs
Используйте собственные блоки Div pandoc для содержимого внутри теги. По большей части это должно
дает тот же результат, что и markdown_in_html_blocks, но упрощает написание pandoc
фильтры для управления группами блоков.
Расширение: Native_spans
Используйте собственные блоки pandoc Span для содержимого внутри тегов. По большей части это
должен давать тот же результат, что и raw_html, но это упрощает запись фильтров pandoc в
управлять группами встроенных строк.
Сырье TeX
Расширение: сырой_текс
В дополнение к необработанному HTML, pandoc позволяет включать необработанные LaTeX, TeX и ConTeXt в
документ. Встроенные команды TeX будут сохранены и переданы без изменений в LaTeX и
Писатели ConTeXt. Таким образом, например, вы можете использовать LaTeX для включения цитат BibTeX:
Этот результат был доказан в \ cite {jones.1967}.
Обратите внимание, что в среде LaTeX, например
\ begin {tabular} {| l | l |} \ hline
Возраст и частота посещений \\ \ hline
18-25 и 15 \\
26-35 и 33 \\
36-45 и 22 \ hline
\ end {tabular}
материал между начальным и конечным тегами будет интерпретироваться как необработанный LaTeX, а не как
Уценка.
Встроенный LaTeX игнорируется в выходных форматах, отличных от Markdown, LaTeX и ConTeXt.
Латекс Макрос
Расширение: латекс_макрос
Для выходных форматов, отличных от LaTeX, pandoc будет анализировать LaTeX \ newcommand и \ Renewcommand
определения и применить полученные макросы ко всей математике LaTeX. Так, например,
следующее будет работать во всех форматах вывода, а не только в LaTeX:
\ newcommand {\ tuple} [1] {\ langle # 1 \ rangle}
$ \ tuple {a, b, c} $
В выводе LaTeX определение \ newcommand будет просто передано в вывод без изменений.
Ссылки
Markdown позволяет указывать ссылки несколькими способами.
Автоматический связи
Если вы заключите URL-адрес или адрес электронной почты в острые скобки, он станет ссылкой:
<http://google.com>
<[электронная почта защищена]>
В очереди связи
Встроенная ссылка состоит из текста ссылки в квадратных скобках, за которым следует URL-адрес в
скобки. (Необязательно, за URL-адресом может следовать заголовок ссылки в кавычках.)
Это [встроенная ссылка] (/ url), а вот [ссылка с
Заголовок](http://fsf.org «нажмите здесь, чтобы хорошо провести время!»).
Между частью в скобках и частью в скобках не должно быть места. Связь
текст может содержать форматирование (например, выделение), но заголовок не может.
Адреса электронной почты во встроенных ссылках не определяются автоматически, поэтому они должны начинаться с префикса
MAILTO:
[Напиши мне!](MAILTO:[электронная почта защищена])
ID связи
An явный Ссылочная ссылка состоит из двух частей: самой ссылки и определения ссылки, которые
может встречаться в другом месте документа (до или после ссылки).
Ссылка состоит из текста ссылки в квадратных скобках, за которым следует метка в квадратных скобках.
(Между ними может быть пробел.) Определение ссылки состоит из заключенной в скобки метки,
за которым следует двоеточие и пробел, за которым следует URL-адрес и, необязательно (после пробела),
название ссылки в кавычках или скобках. Метка не должна анализироваться как
цитирование (при условии, что расширение цитирования включено): цитаты имеют приоритет перед
ярлыки ссылок.
Вот несколько примеров:
[мой ярлык 1]: /foo/bar.html "Мой заголовок, необязательно"
[мой ярлык 2]: / foo
[мой ярлык 3]: http://fsf.org (Фонд свободного программного обеспечения)
[мой ярлык 4]: / bar # special 'Заголовок в одинарных кавычках'
URL-адрес может быть дополнительно заключен в угловые скобки:
[мой ярлык 5]:http://foo.bar.baz>
Заголовок может идти в следующей строке:
[мой ярлык 3]: http://fsf.org
«Фонд свободного программного обеспечения»
Обратите внимание, что метки ссылок не чувствительны к регистру. Итак, это будет работать:
Вот [моя ссылка] [FOO]
[Foo]: / bar / baz
В одном из безоговорочно ссылка, вторая пара скобок пуста:
См. [Мой веб-сайт] [].
[мой веб-сайт]: http://foo.bar.baz
Примечание. В Markdown.pl и большинстве других реализаций Markdown определения ссылочных ссылок
не может встречаться во вложенных конструкциях, таких как элементы списка или блочные кавычки. Подъемники Pandoc
это произвольное кажущееся ограничение. Так что в pandoc все нормально, но не в
большинство других реализаций:
> Мой блок [цитата].
>
> [цитата]: / foo
Расширение: ярлык_ссылка_ссылки
В кратчайший путь ссылочную ссылку, вторую пару скобок можно полностью опустить:
См. [Мой веб-сайт].
[мой веб-сайт]: http://foo.bar.baz
внутренний связи
Чтобы создать ссылку на другой раздел того же документа, используйте автоматически сгенерированный
идентификатор (см. Идентификаторы заголовка). Например:
См. [Введение] (# введение).
or
См. [Введение].
[Введение]: #introduction
В настоящее время внутренние ссылки поддерживаются для форматов HTML (включая слайд-шоу HTML и
EPUB), LaTeX и ConTeXt.
Фотографии
Ссылка, перед которой стоит! будет рассматриваться как изображение. Текст ссылки будет
используется в качестве альтернативного текста изображения:
! [la lune] (lalune.jpg «Путешествие на Луну»)
! [кинолента]
[катушка фильма]: movie.gif
Расширение: implicit_figures
Изображение, появляющееся само по себе в абзаце, будет отображаться как рисунок с подписью.
(В LaTeX будет использоваться среда рисунка; в HTML изображение будет помещено в div
с цифрой класса, вместе с подписью в ap с заголовком класса.) alt изображения
текст будет использоваться как заголовок.
! [Это подпись] (/ url / of / image.png)
Если вам просто нужно обычное встроенное изображение, просто убедитесь, что это не единственное, что есть в
параграф. Один из способов сделать это - вставить неразрывный пробел после изображения:
! [Это изображение не будет фигурой] (/ url / of / image.png) \
Расширение: link_attributes
Для ссылок и изображений можно установить атрибуты:
Встроенный! [Изображение] (foo.jpg) {# id .class width = 30 height = 20px}
и ссылку! [изображение] [ссылка] с атрибутами.
[ref]: foo.jpg "необязательный заголовок" {#id .class key = val key2 = "val 2"}
(Этот синтаксис совместим с PHP Markdown Extra, когда используются только #id и .class.)
Для HTML и EPUB все атрибуты, кроме ширины и высоты (но включая srcset и sizes)
проходят как есть. Другие авторы игнорируют атрибуты, которые не поддерживаются
их выходной формат.
Атрибуты ширины и высоты изображений обрабатываются особым образом. При использовании без
unit, единицей измерения считаются пиксели. Однако любой из следующих идентификаторов единиц
можно использовать: px, cm, mm, in, inch и%. Между числами не должно быть пробелов.
и агрегат. Например:
! [] (file.jpg) {width = 50%}
· Размеры конвертируются в дюймы для вывода в постраничных форматах, таких как LaTeX.
Размеры преобразуются в пиксели для вывода в форматах, подобных HTML. Используйте --dpi
возможность указать количество пикселей на дюйм. По умолчанию 96 точек на дюйм.
· Единица% обычно относится к некоторому доступному пространству. Например, приведенный выше пример
будет оказывать (HTML),
\ includegraphics [width = 0.5 \ textwidth] {file.jpg} (LaTeX) или
\ externalfigure [file.jpg] [width = 0.5 \ textwidth] (ConTeXt).
· Некоторые форматы вывода имеют понятие класса (ConTeXt) или уникального идентификатора (LaTeX
\ caption) или оба (HTML).
· Если не указаны атрибуты ширины или высоты, лучше всего взглянуть на изображение.
разрешение и метаданные dpi, встроенные в файл изображения.
Сноски
Расширение: сноски
Pandoc Markdown позволяет использовать сноски, используя следующий синтаксис:
Вот ссылка в сноске, [^ 1] и еще. [^ Longnote]
[^ 1]: Вот сноска.
[^ longnote]: Вот один с несколькими блоками.
Последующие абзацы имеют отступ, чтобы показать, что они
относятся к предыдущей сноске.
{some.code}
Может быть с отступом весь абзац или только первый
линия. Таким образом, сноски из нескольких абзацев работают как
пункты списка, состоящего из нескольких абзацев.
Этот абзац не будет частью примечания, потому что он
без отступа.
Идентификаторы в ссылках на сноски не могут содержать пробелов, табуляции или новых строк. Эти
идентификаторы используются только для сопоставления ссылки на сноску с самой заметкой; в
при выводе сноски будут нумероваться последовательно.
Сами сноски не обязательно размещать в конце документа. Они могут появиться
где угодно, кроме других элементов блока (списков, цитат, таблиц и т. д.).
Расширение: inline_notes
Строчные сноски также разрешены (хотя, в отличие от обычных, они не могут содержать
несколько абзацев). Синтаксис следующий:
Вот встроенная заметка. ^ [Встроенные заметки писать легче, так как
вам не нужно выбирать идентификатор и спускаться вниз, чтобы ввести
Примечание.]
Строчные и обычные сноски можно свободно смешивать.
Цитаты
Расширение: кавычки
Используя внешний фильтр, pandoc-citeproc, pandoc может автоматически генерировать цитаты и
библиография в нескольких стилях. Основное использование
pandoc --filter pandoc-citeproc myinput.txt
Чтобы использовать эту функцию, вам нужно будет указать файл библиографии с помощью
поле метаданных библиографии в разделе метаданных YAML или --bibliography в командной строке
аргумент. Вы можете указать несколько аргументов --bibliography или установить метаданные библиографии
в массив YAML, если вы хотите использовать несколько файлов библиографии. Библиография может
иметь любой из этих форматов:
Формат файла Расширение
───────────────────────────────
BibLaTeX .bib
БибТекс .bibtex
Копак .copac
CSL JSON.json
CSL YAML .yaml
EndNote .enl
EndNote XML .xml
ISI .wos
МЕДЛАЙН .medline
МОДЫ .mods
РИС .рис
Обратите внимание, что .bib можно использовать как с файлами BibTeX, так и с BibLaTeX; используйте .bibtex, чтобы заставить
БибТекс.
Обратите внимание, что pandoc-citeproc --bib2json и pandoc-citeproc --bib2yaml могут создавать .json и
.yaml файлы любого из поддерживаемых форматов.
Разметка в поле: в базах данных BibTeX и BibLaTeX pandoc-citeproc анализирует подмножество
Разметка LaTeX; в базах данных CSL YAML - pandoc Markdown; а в базах данных CSL JSON
HTML-подобная разметка:
курсив
...
булавка
<Span style = "font-variant: small-caps;"> ... or ...
маленькие столицы
...
индекс
...
верхний индекс
<Span class = "nocase"> ...
запретить использование заглавных букв в заглавных буквах
pandoc-citeproc -j и -y преобразуют форматы CSL JSON и CSL YAML настолько, насколько
возможное.
В качестве альтернативы указанию файла библиографии с помощью --bibliography или YAML
библиографию поля метаданных, вы можете включить данные цитирования прямо в список литературы
поле метаданных YAML документа. Поле должно содержать массив YAML-кодированных
ссылки, например:
Напишите нам в чат или Email
Рекомендации:
- тип: статья-журнал
идентификатор: WatsonCrick1953
автор:
- семья: Watson
дано: JD
- семья: Крик
дано: FHC
выпущен:
дата-части:
- - 1953
- 4
- 25
название: 'Молекулярная структура нуклеиновых кислот: структура дезоксирибозы
нуклеиновая кислота'
title-short: Молекулярная структура нуклеиновых кислот
название контейнера: Природа
объем: 171
выпуск: 4356
стр: 737-738
DOI: 10.1038 / 171737a0
URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
язык: en-GB
...
(pandoc-citeproc --bib2yaml может создавать их из файла библиографии в одном из
поддерживаемые форматы.)
Цитаты и ссылки могут быть отформатированы с использованием любого стиля, поддерживаемого стилем цитирования.
Язык, указанный в репозитории стилей Zotero. Эти файлы указываются с помощью
--csl или поле метаданных csl. По умолчанию pandoc-citeproc будет использовать Chicago
Руководство по стилю формата "автор-дата". Проект CSL предоставляет дополнительную информацию о
поиск и редактирование стилей.
Чтобы сделать ваши цитаты гиперссылками на соответствующие библиографические записи, добавьте
ссылки-цитаты: верно для ваших метаданных YAML.
Цитаты заключаются в квадратные скобки и разделяются точкой с запятой. Каждая цитата должна
иметь ключ, состоящий из '@' + идентификатора цитирования из базы данных, и может
необязательно иметь префикс, указатель и суффикс. Ключ цитирования должен начинаться с символа
буква, цифра или _ и может содержать буквенно-цифровые символы, _ и внутренние знаки пунктуации
(:. # $% & - +? <> ~ /). Вот некоторые примеры:
Бла-бла [см. @ Doe99, стр. 33-35; также @ smith04, гл. 1].
Бла-бла [@ doe99, стр. 33-35, 38-39 и * passim *].
Бла-бла [@ smith04; @ doe99].
pandoc-citeproc обнаруживает термины локатора в файлах локали CSL. Либо сокращенно, либо
принимаются несокращенные формы. В локали en-US термины локатора могут быть написаны на
формы единственного или множественного числа, например, книга, bk./bks .; глава, chap./chaps .; столбец,
col./cols .; рисунок, рис. / фиг .; folio, fol./fols .; номер, шт. / шт .; линия, л. / л .; Примечание,
н. / н .; opus, op./opp .; стр., стр. / стр .; абзац, абзац / абзац .; часть, пт. / пц .; раздел,
сек. / сек .; sub verbo, sv / s.vv .; стих, v./vv .; объем, об. / об .; ¶ / ¶¶; § / §§. Если нет
используется термин локатора, предполагается "страница".
Знак минус (-) перед @ подавит упоминание автора в цитате. Этот
может быть полезно, когда автор уже упоминается в тексте:
Смит говорит "бла" [- @ smith04].
Вы также можете написать цитату в тексте следующим образом:
@ smith04 говорит "бла".
@ smith04 [стр. 33] говорит бла.
Если для стиля требуется список цитируемых работ, он будет помещен в конец
документ. Обычно вам нужно закончить свой документ соответствующим заголовком:
последний абзац ...
# Использованная литература
Библиография будет вставлена после этого заголовка. Обратите внимание, что ненумерованный класс будет
быть добавленным в этот заголовок, чтобы раздел не был пронумерован.
Если вы хотите включить элементы в библиографию, не цитируя их в основном тексте
text, вы можете определить фиктивное поле метаданных nocite и поместить туда цитаты:
Напишите нам в чат или Email
ноцит: |
@ item1, @ item2
...
@ item3
В этом примере документ будет содержать ссылку только на item3, но список литературы
будет содержать записи для item1, item2 и item3.
Для вывода LaTeX или PDF вы также можете использовать natbib или biblatex для отображения библиографии. В
для этого укажите файлы библиографии, как описано выше, и добавьте --natbib или
--biblatex аргумент для вызова pandoc. Помните, что файлы библиографии должны быть
в соответствующем формате (BibTeX или BibLaTeX).
Для получения дополнительной информации см. Справочную страницу pandoc-citeproc.
Не-pandoc расширения
Следующие расширения синтаксиса Markdown по умолчанию не включены в pandoc, но могут быть
включается добавлением + EXTENSION к имени формата, где EXTENSION - это имя
расширение. Так, например, markdown + hard_line_breaks - это Markdown с жесткой строкой.
брейки.
Расширение: lists_without_preceding_blankline
Разрешить появление списка сразу после абзаца, без пробелов между ними.
Расширение: hard_line_breaks
Заставляет все символы новой строки в абзаце интерпретироваться как разрывы строк вместо
пространства.
Расширение: ignore_line_breaks
Заставляет игнорировать новые строки в абзаце, а не рассматривать их как пробелы или
как жесткие разрывы строк. Эта опция предназначена для использования с восточноазиатскими языками, где
Между словами не используются пробелы, но текст разбит на строки для удобства чтения.
Расширение: East_asian_line_breaks
Заставляет игнорировать новые строки в абзаце, а не рассматривать их как пробелы или
как жесткие разрывы строки, когда они встречаются между двумя восточноазиатскими символами. Это
лучший выбор, чем ignore_line_breaks для текстов, которые включают смесь восточноазиатских
персонажи и другие персонажи.
Расширение: Emoji
Разбирает текстовые смайлы, например: smile:, как смайлики Unicode.
Расширение: tex_math_single_backslash
Заставляет что-либо между \ (и \) интерпретироваться как встроенная математика TeX, и что-либо
между \ [и \], чтобы интерпретировать как отображать математику TeX. Примечание: недостаток этого
расширение состоит в том, что оно предотвращает экранирование (и [.
Расширение: tex_math_double_backslash
Заставляет что-либо между \\ (и \\) интерпретироваться как встроенная математика TeX, и что-либо
между \\ [и \\], чтобы интерпретировать как отображать математику TeX.
Расширение: уценка_атрибут
По умолчанию pandoc интерпретирует материал внутри тегов уровня блока как Markdown. Этот
расширение изменяет поведение, так что Markdown анализируется только внутри тегов уровня блока, если
теги имеют атрибут markdown = 1.
Расширение: mmd_title_block
Включает основную надпись в стиле MultiMarkdown вверху документа, например:
Название: Мое название
Автор: Джон Доу
Дата: сентябрь 1, 2008
Комментарий: это образец основной надписи mmd с
поле, охватывающее несколько строк.
Подробности см. В документации MultiMarkdown. Если pandoc_title_block или
yaml_metadata_block включен, он будет иметь приоритет над mmd_title_block.
Расширение: аббревиатуры
Разбирает ключи сокращений PHP Markdown Extra, например
* [HTML]: язык гипертекстовой разметки
Обратите внимание, что модель документа pandoc не поддерживает сокращения, поэтому, если это расширение
включен, ключи сокращений просто пропускаются (в отличие от анализа как
абзацы).
Расширение: autolink_bare_uris
Превращает все абсолютные URI в ссылки, даже если они не заключены в фигурные скобки <...>.
Расширение: ascii_identifiers
Заставляет идентификаторы, создаваемые auto_identifiers, быть чистыми ASCII. Акценты бывают
удаляются латинские буквы с ударением, а нелатинские буквы опускаются.
Расширение: mmd_link_attributes
Анализирует атрибуты "ключ-значение" в стиле мультимаркировки в ссылках и на изображениях. Этот
extension не следует путать с расширением link_attributes.
Это справочник! [Изображение] [ссылка] с атрибутами multimarkdown.
[ссылка]: http://path.to/image «Название изображения» ширина = 20 пикселей, высота = 30 пикселей
id = myId class = "myClass1 myClass2"
Расширение: mmd_header_identifiers
Анализирует идентификаторы заголовков в стиле мультимаркинга (в квадратных скобках, после заголовка, но
перед любыми завершающими знаками # в заголовке ATX).
Расширение: Compact_definition_lists
Активирует синтаксис списка определений для pandoc 1.12.x и более ранних версий. Этот синтаксис отличается
из описанного выше в Списках определений в нескольких отношениях:
· Между последовательными элементами списка определений не требуется пустых строк.
· Чтобы получить «плотный» или «компактный» список, опускайте пробелы между последовательными элементами; космос
между термином и его определением ни на что не влияет.
· Ленивый перенос абзацев не допускается: все определение должно быть с отступом четыре
пространства.
уценка варианты
Помимо расширенного Markdown от pandoc, поддерживаются следующие варианты Markdown:
markdown_phpextra (PHP уценка Дополнительный)
сноски, pipe_tables, raw_html, markdown_attribute, fenced_code_blocks,
списки_определений, символы подчеркивания внутри слова, атрибуты_заголовков, атрибуты_ссылок,
сокращения, shortcut_reference_links.
markdown_github (Со вкусом GitHub уценка)
pipe_tables, raw_html, tex_math_single_backslash, feded_code_blocks,
auto_identifiers, ascii_identifiers, backtick_code_blocks, autolink_bare_uris,
intraword_underscores, вычеркивание, hard_line_breaks, смайлики,
ярлык_ссылки_ссылки.
уценка_ммд (Мультиуценка)
Pipe_tables raw_html, markdown_attribute, mmd_link_attributes, raw_tex,
tex_math_double_backslash, intraword_underscores, mmd_title_block, сноски,
списки определений, all_symbols_escapable, implicit_header_references,
auto_identifiers, mmd_header_identifiers, ярлыки_ссылки.
уценка_строго (Markdown.pl)
raw_html
Расширения Форматы другими чем уценка
Некоторые из описанных выше расширений можно использовать с форматами, отличными от Markdown:
· Auto_identifiers могут использоваться с латексным, rst, mediawiki и текстильным вводом (и используется
по умолчанию).
· Могут использоваться tex_math_dollars, tex_math_single_backslash и tex_math_double_backslash
с вводом html. (Это удобно для чтения веб-страниц, отформатированных с использованием MathJax, для
пример.)
ПРОИЗВОДСТВО СЛАЙД ШОУ ПАНДОК
Вы можете использовать pandoc для создания слайд-презентации HTML + javascript, которую можно будет просмотреть.
через веб-браузер. Есть пять способов сделать это: S5, DZSlides, Slidy, Slideous,
или раскрыть.js. Вы также можете создать слайд-шоу в формате PDF, используя проектор LaTeX.
Вот исходный код в Markdown для простого слайд-шоу, habits.txt:
% Привычки
% Джон Доу
% 22 марта 2005 г.
# Утром
## Вставать
- Отключить будильник
- Вставай с постели
## Завтрак
- Ешьте яйца
- Пить кофе
# Вечером
## Обед
- Ешьте спагетти
- Пить вино
------------------
! [изображение спагетти] (images / spaghetti.jpg)
## Идти спать
- Ложись в постель
- Считать овец
Чтобы создать слайд-шоу HTML / javascript, просто введите
pandoc -t ФОРМАТ -s привычки.txt -o привычки.html
где ФОРМАТ - это s5, slidy, slideous, dzslides или discoverjs.
Для Slidy, Slideous, раскрыть.js и S5 файл, созданный pandoc с
-s / - автономная опция включает ссылку на файлы javascripts и CSS, которые, как предполагается,
доступен по относительному пути s5 / default (для S5), Slideous (для Slideous), discover.js
(для раскрытия.js) или на сайте Slidy по адресу w3.org (для Slidy). (Эти пути могут быть
изменяется путем установки переменных slidy-url, slideous-url, discoverjs-url или s5-url; видеть
Переменные для слайдов, см. Выше.) Для DZSlides (относительно короткие) javascript и css являются
включены в файл по умолчанию.
Для всех форматов слайдов HTML параметр --self -hibited может использоваться для создания одного
файл, содержащий все данные, необходимые для отображения слайд-шоу, включая связанные
скрипты, таблицы стилей, изображения и видео.
Чтобы создать слайд-шоу PDF с помощью beamer, введите
pandoc -t привычки проектора.txt -o привычки.pdf
Обратите внимание, что слайд-шоу Show.js также можно преобразовать в PDF, распечатав его в файл.
из браузера.
структурирующий скользить произошел
По умолчанию, скользить уровень это самый высокий уровень заголовка в иерархии, за которой следует
сразу по содержимому, а не по другому заголовку где-нибудь в документе. В примере
выше, за заголовками уровня 1 всегда следуют заголовки уровня 2, за которыми следует
контент, поэтому 2 - это уровень слайда. Это значение по умолчанию можно изменить с помощью параметра --slide-level.
опцию.
Документ разбивается на слайды по следующим правилам:
· Горизонтальная линейка всегда начинает новый слайд.
· Заголовок на уровне слайда всегда начинает новый слайд.
· Заголовки ниже уровень слайда в иерархии создает заголовки одной слайд.
· Заголовки выше уровень слайда в иерархии создает «слайды заголовков», которые просто содержат
заголовок раздела и поможет разбить слайд-шоу на разделы.
· Титульный лист создается автоматически из основной надписи документа, если таковая имеется.
(В случае с проектором это можно отключить, закомментировав некоторые строки по умолчанию
шаблон.)
Эти правила предназначены для поддержки множества разных стилей слайд-шоу. Если вы этого не сделаете
позаботьтесь о структурировании слайдов по разделам и подразделам, вы можете просто использовать уровень 1
заголовки для всех слайдов. (В этом случае уровень 1 будет уровнем слайда.) Но вы можете
также разделите слайд-шоу на разделы, как в примере выше.
Примечание: в слайд-шоу Show.js, если уровень слайда равен 2, будет отображаться двухмерный макет.
произведено, с заголовками уровня 1, строящимися по горизонтали, и заголовками уровня 2, строящимися
вертикально. Не рекомендуется использовать более глубокую вложенность уровней разделов с
раскрыть.js.
Дополнительный списки
По умолчанию эти авторы создают списки, отображающие «все сразу». Если вы хотите, чтобы ваши списки
для постепенного отображения (по одному элементу за раз) используйте параметр -i. Если вы хотите
конкретный список для отклонения от значения по умолчанию (то есть для постепенного отображения без
-i и все сразу с параметром -i), поместите его в цитату:
> - Ешьте спагетти
> - Пейте вино
Таким образом, в одном документе могут быть смешаны инкрементные и не инкрементные списки.
Вставка паузы
Вы можете добавить «паузы» в слайд, включив абзац, содержащий три точки,
разделенные пробелами:
# Слайд с паузой
содержание до паузы
. . .
содержимое после паузы
Cтайлинг слайдах
Вы можете изменить стиль слайдов HTML, поместив настроенные файлы CSS в
$ DATADIR / s5 / default (для S5), $ DATADIR / slidy (для Slidy) или $ DATADIR / slideous (для
Slideous), где $ DATADIR - это каталог данных пользователя (см. --Data-dir выше). В
оригиналы можно найти в каталоге системных данных pandoc (обычно
$ CABALDIR / pandoc-VERSION / s5 / default). Pandoc будет искать там файлы, которых нет.
найти в каталоге пользовательских данных.
Для dzslides CSS включен в сам файл HTML и может быть изменен там.
Все параметры конфигурации detect.js можно установить с помощью переменных. Например, темы могут
можно использовать, задав переменную темы:
-V тема = луна
Или вы можете указать собственную таблицу стилей, используя параметр --css.
Чтобы стилизовать слайды-проекторы, вы можете указать тему, цветовую схему, тему шрифта, внутреннюю тему и
externaltheme, используя параметр -V:
pandoc -t beamer habits.txt -V тема: Варшава -o habits.pdf
Обратите внимание, что атрибуты заголовка превратятся в атрибуты слайда (на или ) в
Форматы слайдов HTML, позволяющие стилизовать отдельные слайды. В beamer единственный заголовок
Атрибут, который влияет на слайды, - это класс allowframebreaks, который устанавливает
опция allowframebreaks, вызывающая создание нескольких слайдов, если контент переполняется
рамка. Это особенно рекомендуется для библиографий:
# Ссылки {.allowframebreaks}
Динамик ноты
Show.js хорошо поддерживает заметки докладчика. Вы можете добавлять примечания к вашему документу Markdown
таким образом:
Это моя записка.
- Может содержать Markdown
- нравится этот список
</div>
Чтобы открыть окно заметок, нажмите s во время просмотра презентации. Заметок еще нет
поддерживается для других форматов слайдов, но примечания не будут отображаться на самих слайдах.
Корзина Атрибуты in проектор
Иногда необходимо добавить опцию LaTeX [fragile] к кадру в beamer (для
например, при использовании среды minted). Этого можно добиться, добавив хрупкий
к заголовку, представляющему слайд:
# Хрупкий слайд {.fragile}
Все остальные атрибуты кадра, описанные в Разделе 8.1 Руководства пользователя Beamer, могут
также могут использоваться: allowdisplaybreaks, allowframebreaks, b, c, t, environment, label, plain,
сокращаться, сжиматься.
ФОРМИРОВАНИЕ ЭПУБС ПАНДОК
EPUB Метаданные
Метаданные EPUB можно указать с помощью параметра --epub-metadata, но если источник
документ - это Markdown, лучше использовать блок метаданных YAML. Вот пример:
Напишите нам в чат или Email
Название:
- тип: основной
текст: Моя книга
- тип: субтитры
текст: Исследование метаданных
создатель:
- роль: автор
текст: Джон Смит
- роль: редактор
текст: Сара Джонс
идентификатор:
- схема: DOI
текст: doi: 10.234234.234 / 33
издатель: My Press
права: © 2007 Джон Смит, CC BY-NC
...
Распознаются следующие поля:
идентификатор
Либо строковое значение, либо объект с полями текста и схемы. Допустимые значения для
схемы: ISBN-10, GTIN-13, UPC, ISMN-10, DOI, LCCN, GTIN-14, ISBN-13,
Номер обязательного депозита, URN, OCLC, ISMN-13, ISBN-A, JP, OLCC.
название Либо строковое значение, либо объект с полями file-as и type, либо список таких
объекты. Допустимые значения для типа: main, subtitle, short, collection, edition,
продлен.
создатель
Либо строковое значение, либо объект с ролью полей, как файл и текст, либо список
таких объектов. Допустимые значения для роли - отношения MARC, но pandoc попытается
переводить версии для чтения (например, «автор» и «редактор») в
соответствующие маркеры.
участник
Тот же формат, что и у создателя.
даты Строковое значение в формате ГГГГ-ММ-ДД. (Требуется только год.) Pandoc будет
попытаться преобразовать другие распространенные форматы даты.
Ланг (или наследие: язык)
Строковое значение в формате BCP 47. Pandoc по умолчанию будет использовать местный язык, если
ничего не указано.
предмет
Строковое значение или список таких значений.
описание
Строковое значение.
напишите Строковое значение.
формат Строковое значение.
связь
Строковое значение.
охват
Строковое значение.
правые Строковое значение.
обложка
Строковое значение (путь к обложке).
таблицы стилей
Строковое значение (путь к таблице стилей CSS).
направление прогрессии страницы
Либо ltr, либо rtl. Задает атрибут page-progression-direction для
элемент позвоночника.
Связанный средства массовой информации
По умолчанию pandoc будет загружать связанные медиафайлы (включая аудио и видео) и включать их
в контейнере EPUB, в результате чего получается полностью автономный EPUB. Если вы хотите сделать ссылку на
вместо внешних медиаресурсов используйте необработанный HTML в своем источнике и добавьте data-external = "1" в
тег с атрибутом src. Например:
<источник источника="/http://example.com/music/toccata.mp3"
data-external = "1" type = "audio / mpeg">
ЛИТЕРАТИВНЫЙ Haskell ПОДДЕРЖКA
Если вы добавите + lhs (или + literate_haskell) к соответствующему формату ввода или вывода
(markdown, markdown_strict, rst или latex для ввода или вывода; beamer, html или html5 для
только вывод), pandoc будет рассматривать документ как грамотный исходный код Haskell. Это означает, что
· При вводе Markdown разделы "птичьего трека" будут анализироваться как код Haskell, а не
блочные котировки. Текст между \ begin {code} и \ end {code} также будет рассматриваться как
Код Haskell. Для заголовков в стиле ATX будет использоваться символ '=' вместо '#'.
· В выходных данных Markdown блоки кода с классами haskell и literate будут отображаться с использованием
следы птиц, а цитаты блоков будут иметь отступ на один пробел, поэтому они не будут
рассматривается как код Haskell. Кроме того, заголовки будут отображаться в текстовом стиле (с
подчеркивания), а не в стиле ATX (с символами '#'). (Это потому, что ghc лечит
Символы '#' в столбце 1 обозначают номера строк.)
· При вводе реструктурированного текста разделы "птичьего следа" будут анализироваться как код Haskell.
· При выводе реструктурированного текста блоки кода с классом haskell будут отображаться с использованием птицы
треки.
· При вводе LaTeX текст в кодовых средах будет анализироваться как код Haskell.
· В выводе LaTeX блоки кода с классом haskell будут отображаться внутри кода
сред.
· В выводе HTML блоки кода с классом haskell будут отображаться с классом
грамотный скелл и птичьи следы.
Примеры:
pandoc -f уценка + lhs -t html
читает грамотный исходный код Haskell, отформатированный с использованием соглашений Markdown, и пишет обычный HTML
(без птичьих следов).
pandoc -f уценка + lhs -t html + lhs
записывает HTML с кодом Haskell в следы птиц, поэтому его можно скопировать и вставить как
грамотный исходный код Haskell.
СИНТАКСИС Подчеркивая
Pandoc автоматически выделит синтаксис в изолированных блоках кода, отмеченных значком
Название языка. Для выделения используется подсветка библиотеки Haskell-kate, которая
работает с выводом HTML, Docx и LaTeX / PDF. Цветовую схему можно выбрать с помощью
- вариант в стиле выделения. Цветовая схема по умолчанию - это пигменты, имитирующие
цветовая схема по умолчанию, используемая пигментами библиотеки Python, но пигменты на самом деле не
раньше делал мелирование.
Чтобы увидеть список языков, которые распознает pandoc, введите pandoc --version.
Чтобы отключить выделение, используйте параметр --no-highlight.
CUSTOM ПИСАТЕЛИ
Pandoc можно расширить с помощью специальных писателей, написанных на lua. (Pandoc включает lua
интерпретатор, поэтому lua не нужно устанавливать отдельно.)
Чтобы использовать настраиваемый писатель, просто укажите путь к сценарию lua вместо вывода
формат. Например:
pandoc -t данные / sample.lua
Создание настраиваемого писателя требует написания функции lua для каждого возможного элемента в
документ pandoc. Чтобы получить документированный пример, который вы можете изменить в соответствии с вашими
потребности, делай
pandoc --print-default-файл-данных sample.lua
АВТОРЫ
© 2006-2015 Джон Макфарлейн ([электронная почта защищена]). Выпущено под лицензией GPL, версии 2 или
больше. Это программное обеспечение не дает никаких гарантий. (См. АВТОРСКИЕ ПРАВА для полной
уведомления об авторских правах и гарантии.)
Среди авторов: Аарон Волен, Альберт Кревинкель, Александр Кондрацкий, Александр.
Сульфриан, Александр Вершилов, Альфред Вексельбергер, Андреас Лёв, Эндрю Даннинг,
Антуан Латтер, Арата Мизуки, Арло О'Киф, Артём Казак, Бен Гамари, Бени
Чернявский-Паскин, Бьорн Баквалтер, Брэдли Кун, Брент Йоргей, Брайан О'Салливан, Б.
Скотт Мишель, Калеб МакДэниел, Кельвин Бек, Кристоффер Акельман, Кристоффер Савицки,
Клэр Макрэ, Клинт Адамс, Конал Эллиотт, Крейг С. Босма, Дэниел Берджи, Дэниел Т.
Стаал, Дэвид Лазар, Дэвид Рётлисбергер, Денис Лаксальде, Дуглас Калверт, Дуглас Ф.
Калверт, Эрик Ков, Эрик Зайдель, Флориан Эйтель, Франсуа Ганназ, Фрейрик Барраль, Федор
Шереметьев, Габор Пали, Гэвин Битти, Грег Маслов, Грегори Батай, Грег Рандлетт,
gwern, Gwern Branwen, Hans-Peter Deifel, Henry de Valence, Илья В. Портнов, infinity0x,
Хайме Маркинес Феррандис, Джеймс Аспнес, Джейми Ф. Олсон, Ян Ларрес, Джейсон Роналло, Джефф
Арнольд, Джефф Раннин, Йенс Петерсен, Джереми Боббио, Джесси Розенталь, Дж. Льюис Мьюир, Джо
Хилленбранд, Джон Макфарлейн, Йонас Смедегаард, Джонатан Догерти, Йозеф Свеннингссон,
Хосе Луис Дюран, Жюльен Кретель, Джастин Богнер, Келси Хайтауэр, Константин Зудов,
Ларс-Доминик Браун, Люк Плант, Марк Шепиенец, Марк Райт, Масаеши Такахаши, Матей
Коллар, Матиас Шеннер, Мэттью Пикеринг, Матиас С.М. Троффес, Мауро Биг, Макс
Болингброк, Макс Райдал Андерсен, Мерин Верстраатен, Майкл Снойман, Майкл Томпсон,
МинРК, Натан Гасс, Нил Мэйхью, Ник Барт, Николас Кайзер, Николай Якимов, nkalvi, Пауло
Танимото, Поль Ривье, Питер Ван, Филипп Омбреданн, Филипп Алдей, Пунит Чаганти,
qerub, Ральф Стефан, Рекаи Окташ, rodja.trappe, RyanGlScott, Скотт Моррисон, Сергей
Трофимович, Сергей Астанин, Шахбаз Юссефи, Шон Аттфилд, shreevatsa.public, Саймон
Хенгель, Сумит Сахрават, Такахашим, Саттон, Тим Лин, Тимоти Хамфрис, Тодд Сифлит,
Том Лиз, Ули Кёлер, Вацлав Земан, Виктор Кронвалл, Винсент, Wikiwide и Ксавье Олив.
Исходный код Pandoc и всю документацию можно скачать сhttp://pandoc.org>.
Используйте pandoc в Интернете с помощью сервисов onworks.net
