Как автоматически сгенерировать симпатичные (полностью стилизованные) HTML документы для пакета python? - PullRequest
0 голосов
/ 19 февраля 2020

Я разрабатываю пакет python с нуля, и в настоящее время я ищу быстрый и "симпатичный" способ создания документов HTML для публикации. Я немного исследовал и нашел несколько форматов, которые остаются неизменными в разных пакетах и ​​средах. Сначала я использовал Sphinx, но когда я использовал его, я получил шаблон Html barebones. Я хочу создать полностью стилизованные документы html из 0. Я нашел такие структуры, как Keras (https://keras.io/) и ReadtheDocs (https://docs.readthedocs.io/en/stable/), которые используют согласованные шаблоны для представления своих документов , Это простые HTML шаблоны или это python инструмент? Нужно ли писать весь сайт с нуля?

1 Ответ

0 голосов
/ 20 февраля 2020

Как указал @mzjn, Sphinx с некоторой темой из https://sphinx-themes.org/ сделает свое дело. MkDocs может привести к одинаково привлекательному результату, но у него нет простого варианта автоматического создания документации на основе документации.

...