Я использую Sphinx для создания документов для Python проект.
Выходной html не сохраняет разрывы строк, которые присутствуют в строке документации.
Пример: Код def testMethod (arg1, arg2): "" "...
Я хочу использовать событие sphinx autodoc-skip-member для выбора части членов в определенном классе Python для документации. Но это не ясно из документации sphinx, и я не могу найти никаких примеров ...
Поэтому в документации Sphinx говорится: «Если вы хотите, чтобы автозаполнение таблицы также использовалась как запись в тексте, используйте опцию toctree» - .. autosummary ::: toctree: DIRNAME sphinx.environment ....
Я хочу добавить группировку в модули / другие .rst-файлы, включенные в toctree, чтобы лучше объяснить документацию. Например, перечисленные ниже файлы сгруппированы в 3 части: Содержание: ...
Я прочитал в модуле (например, func.py) функцию автомодуля в Sphinx. func.py может выглядеть так, как def funca (arg1): «" Docstring funca "" "return arg1 def funcb (arg2)" "" ...
Я документировал пакет программного обеспечения с помощью Сфинкса и reStructuredText. В рамках моих документов существуют некоторые длинные фрагменты кода. Я хочу смочь иметь их скрытый как значение по умолчанию, с немного "...
Сфинкс, там путь к автоматически тексту ссылки как № 112 или r1023 к соответствующему tickets/changesets в Trac? Для, например: № 112-> http://mytracsite/tickets/112 r1023-> http://mytracsite/...
В этом примере reST, предназначенном для визуализации с помощью Sphinx, | yaco_url | не заменяется, потому что находится в блоке кода: .. | yaco_url | replace :: http://yaco.es/ Вы можете использовать wget для его загрузки: .. code -...
Таким образом, я стал несколько привыкшим к документации стиля Javadoc. Просматривая различные примеры кода Python, я нахожу, что на первый взгляд документация, кажется, пропускает много из...
Я пытаюсь заставить этот фрагмент работать: История версий---------------Это версии со временем::.. включайте:: ../../CHANGES.txt таким образом, используйте включать директиву так, чтобы файл был...
Как я могу перекрестно сослаться на индексируемый объект в reStructuredText документе? Например, как может я перекрестно ссылаться на SectionB:.. индекс:: пара: SectionA; SectionB SectionB--------SectionB...
Я в настоящее время использую Сфинкса для генерации ЛАТЕКСНОГО вывода, который превращен в PDF для вывода книжного стиля с помощью pdftex. В настоящее время у меня есть уведомления, предупреждения и другие "замечания", обнаруживающиеся в огранич
Я пытался установить django. У меня действительно есть Django-1.1-alpha-1. Я пытался сделать документацию, которая расположена при Django-1.1-alpha-1/doc использовании, делают утилиту. Но я получаю некоторую ошибку при высказывании...
При написании RST, который будет обрабатываться с помощью Sphinx, я не могу получить вывод Sphinx LaTeX для использования номеров фигур при ссылках на цифры. Например, этот код: лемминги атакуют, как может быть ...
Я просто зарегистрировал загрузки своего кода и изучил, как использовать сфинкса для генерации документации. Я хочу включать это в свою страницу проекта GitHub, но я не знаю как к. Делает любой знает существующий...
Я пишу, что некоторая документация со Сфинксом и хотел бы распечатать определенный блок текста только для документации HTML, не для ЛАТЕКСНОЙ документации. Что-то мне подсказывает, что я должен смочь сделать это...
У сфинкса есть функция, названная автометодом, который извлекает документацию из docstring метода и встраивает это в документацию. Но это не только встраивает docstring, но также и метод...
Я использую сфинкса и плагин автодокумента для генерации документации API для моих модулей Python. Пока я вижу, как приятно зарегистрировать определенные параметры, я не могу найти пример того, как зарегистрировать...
В некоторых документах сфинкса я пишу, я включаю примеры кода из вспомогательного файла как так:.. literalinclude:: mymodule.py: pyobject: MyClass: linenos: Этот конкретный документ является учебным руководством...
Когда я создаю ЛАТЕКСНЫЙ файл, сгенерированный из сфинкса, Элементов оглавления, и разделяю заголовки, являются синими. Существует ли простой способ отключить окраску этих объектов? В противном случае есть ли простой способ сделать их...
Я установил Сфинкса для документирования некоторых модулей Python и класса, я продолжаю работать. В то время как язык разметки выглядит очень хорошим, мне не удалось автозарегистрировать код Python. В основном, я...
Кажется, существует множество инструментов документации для Python. Другой, что я натыкался, является epydoc. Кажется, что Сфинкс является фактическим стандартом, потому что это используется для генерации чиновника...
Сфинкс является библиотекой Python для генерации хорошей документации от ряда файлов форматированного текста ReST. Не инструмент использовал для полнотекстового поиска, я также полностью осведомлен о doxygen / phpdoc инструменты. Я...
Я использую Sphinx для документирования проекта, не-Python. Я хочу распределить папки./doc в каждом подмодуле, содержащие файлы submodule_name.rst для документирования этого модуля. Затем я хочу высосать эти файлы...
Я хочу создать строку документации для моего проекта с именем "sortingalgorithm.py". Я настраиваю сфинкса. Я установил пакет sphinx и запустил быстрый запуск. Затем, когда я хочу "сделать HTML" и когда я начал это ...
ReadTheDocs.org - это действительно отличный способ опубликовать html, сгенерированный сфинксом, но есть несколько незначительных проблем, связанных с темой, которые я предпочел бы решать по-другому Прочитав кучу ...
Я использую Sphinx под python3 в Windows. Раньше у меня это работало: использовали sphinx-quickstart и sphinx-apidoc для генерации html. Теперь он показывает ошибку не удалось создать процесс, как это: перейти к ...
Я использую Sphinx для документации кода и использую несколько языков в коде, я хотел бы настроить подсветку для всего этого кода. Sphinx кратко упоминает несколько поддерживаемых им языков (...
У меня есть проект документации с использованием sphinx. У меня есть два вопроса относительно поведения поиска: Вопрос 1: Когда я ищу что-то в документах, я получаю первый вывод. Как я могу предотвратить это и ...