Как преобразовать файлы 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, кажется, игнорирует строки включения фигуры. Итак, как я могу конвертировать в файлы разметки без потери удивительности цифр? Благодаря

Ответы

Ответ 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:: examples/foo.png 
   :scale: 80%

   Fig. 1 : Illustration of the awesomeness of stackoverflow

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