Как преобразовать файлы reStructuredText с изображениями в уценку?

У меня есть первые файлы, содержащие строки вроде

.. figure:: examples/foo.png 
    :scale: 80%

    Fig. 1 : Illustration of the awesomeness of stackoverflow

теперь я хочу, чтобы этот файл был преобразован в уценку. Я пробовал использовать pandoc,

pandoc -s -w rst --toc foo.rst -o foo.md

но выходной файл foo.md, кажется, игнорирует строки включения рисунка. Итак, как я могу конвертировать в файлы разметки, не теряя при этом великолепия цифр? Спасибо


person nye17    schedule 26.05.2012    source источник
comment
Если вы хотите вывести Markdown, вам не нужен флаг -w rst, который говорит ему писать сначала.   -  person poolie    schedule 30.11.2015


Ответы (1)


Эта онлайн-демонстрация Pandoc преобразует следующую уценку:

![Map to buried treasure](/path/to/img.jpg "Optional title")

в следующий reStructuredText:

.. figure:: /path/to/img.jpg
   :align: center
   :alt: Optional title

   Map to buried treasure

Таким образом, вы можете определить цифру, которую можно преобразовать в уценку. Однако использование этого reStructuredText в онлайн-конвертере вызывает ошибку с очень бесполезным сообщением об ошибке. Вы получаете сообщения об ошибках при запуске Pandoc?

Возможно, ваш синтаксис reStructuredText неверен: параметры директивы figure (и любой другой) должны иметь отступ по отношению к имени директивы. Попробуйте использовать

.. figure:: examples/foo.png 
   :scale: 80%

   Fig. 1 : Illustration of the awesomeness of stackoverflow

и посмотрите, имеет ли это значение.

person Chris    schedule 26.05.2012
comment
при запуске pandoc ошибок не было, и мой первый синтаксис верен - он отображается правильно в другом месте или при преобразовании в html и т. д. - person nye17; 27.05.2012
comment
Тогда это, вероятно, ошибка Pandoc. Я бы отправил разработчикам электронное письмо или поднял этот вопрос в списке рассылки / системе отслеживания проблем Pandoc. - person Chris; 27.05.2012
comment
Конечно, и кажется, что альтернативных инструментов для выполнения этой работы нет. - person nye17; 27.05.2012
comment
Вы можете попробовать преобразовать reStructuredText в другой формат, например, HTML, а затем преобразовать его в уценку. Не лучшее решение, но стоит попробовать. - person Chris; 27.05.2012