Как конвертировать документы ReStructuredText в блокноты ipython?

В наши дни большая часть документации в сообществе Python написана на ReStructuredText. Я хочу преобразовать некоторые из этих документов в блокноты ipython, чтобы можно было не только читать примеры в документах, но и сразу взаимодействовать с ними.

Как преобразовать ReStructuredTexts в блокноты ipython? Есть какой-либо способ сделать это? Может быть, использовать pandoc в качестве промежуточного шага?

Я уже прочитал некоторые документы о том, как конвертировать ipython блокноты в другие форматы, но мне интересно сделать наоборот, от rst до iptyhon. Есть идеи?


python ipython documentation restructuredtext
person Private    schedule 01.04.2014    source источник

Ответы (3)


arrow_upward
2
arrow_downward

В дополнение к sphinxcontrib-jupyter/jupinx, Google нашел rst2ipynb. Кажется, он использует pandoc. Хотя сам я еще не пробовал.

person akaihola    schedule 17.01.2019

arrow_upward
1
arrow_downward

Есть пакет для уценки до ipynb. заметка 1.0.3. Вы можете использовать pandoc сначала для md, а затем md для ipynb.

person Chris    schedule 10.04.2014
comment
Спасибо за ваше предложение. Я пробовал это, и это не работает, потому что pandoc превращает первые >>> в \>\>\>, а не в блок кода. Какие-либо предложения? - person Private; 10.04.2014
comment
Я запускал pandoc 1.11.1 Linux на github.com/sympy/ sympy/blob/master/doc/src/guide.rst и got>>> вместо \>\>\> в блоках doctest. Я не уверен, откуда берутся побеги. Кодовые блоки выполняются в Ipy, даже если интерактивные подсказки остаются. Я согласен, что было бы лучше, если бы они были раздеты, но я не знаю ни одного готового решения. Заметил еще одну проблему в блоках кода. notedown разбивает блоки, потому что в пустых строках нет отступа. Довольно легко объединить ячейки постфактум, но вам придется сделать хотя бы некоторое ручное редактирование. - person Chris; 12.04.2014

arrow_upward
1
arrow_downward

Если вы все еще ищете решение, мы создаем расширение Sphinx для преобразования коллекции файлов RST в блокноты Jupyter.

sphinxcontrib-jupyter

person sanguineturtle    schedule 10.08.2018