0
ответов

Документирование Python с использованием Eclipse / Pydev

Я новичок в разработке Python и использую Eclipse / Pydev. Есть ли хороший способ интегрировать инструменты для создания документации (например, Sphinx, pydoc) в IDE, чтобы иметь хороший рабочий процесс, возможно, показывая ...
вопрос задан: 3 August 2011 08:59
0
ответов

Конфликт OptionParser со сфинксом?

Я пытаюсь написать документация для моего проекта в sphinx, и всякий раз, когда sphinx встречает OptionParser в моем модуле, он дает мне: sphinx-build: error: no such option: -b Я думал, что это ...
вопрос задан: 2 August 2011 12:23
0
ответов

можно ли переименовать "оглавление" в боковой панели сфинкса?

В более общем плане, как переименовать элементы Sphinx по умолчанию (например, Быстрый поиск для поиска)? Можете ли вы?
вопрос задан: 26 July 2011 00:38
0
ответов

Сфинкс настройки вывода latexpdf?

Просто любопытно, если кто-нибудь знает, как настроить вывод sphinx при использовании цели latexpdf? Я видел много нестандартных вещей для вывода html, но, похоже, не нашел ни одного примера нестандартного вывода pdf. ...
вопрос задан: 18 July 2011 19:05
0
ответов

Как создать документацию на основе Sphinx в проекте Jython?

Я работаю над несколькими проектами Jython с использованием библиотек, написанных на Java. Я хотел бы создать хорошую документацию по Sphinx благодаря расширению autodoc. Однако когда я пытаюсь создать html, я ...
вопрос задан: 18 July 2011 18:49
0
ответов

В Sphinx, как я могу создать связываемый раздел «терминология» без огромных накладных расходов?

Я хочу создать раздел «терминологии» с определениями терминов, которые я использую, чтобы каждый раз, когда я использую терминов в этом разделе терминологии создается ссылка, указывающая на определение. ...
вопрос задан: 18 July 2011 18:37
0
ответов

Python: получение «атрибута / метода / свойства» объекта либо как параметр метода, либо как свойство

В модуле WMI (да, мой босс хочет, чтобы я программировал в Windows - но, по крайней мере, его нет в COBOL), похоже, вы можете получить доступ к значению WMI, либо передав его имя в виде строкового параметра ...
вопрос задан: 18 July 2011 18:36
0
ответов

sphinx import parent dir rst file?

Мне нужно создать один проект sphinx для каждого модуля, и каждый модуль имеет некоторые общие rsts, такие как информация о компании, лицензия и т.д. Дерево моего проекта выглядит так: ./conf.py ./index.rst ./intro.rst ./...
вопрос задан: 18 July 2011 18:32
0
ответов

Использование Sphinx с расширением C, созданным с помощью distutils

Я написал модуль Python, включающий подмодуль, написанный на C: сам модуль называется foo, а часть C - foo ._бар. Структура выглядит так: src / foo / __ init__.py <- содержит ...
вопрос задан: 18 July 2011 18:30
0
ответов

Параметры Autodoc?

Я новичок в использовании sphinx. Выглядит неплохо. Я почти задокументировал весь свой проект с помощью autodoc, но хочу изменить одно поведение. Читая документацию, я видел это: http: //sphinx.pocoo ....
вопрос задан: 18 July 2011 18:29
0
ответов

Форматирование текста в ссылке в reStructuredText

Как форматировать текст в обозначенной ссылке в reStructuredText? В частности, я хочу сгенерировать следующий HTML из моего rst:
вопрос задан: 18 July 2011 18:29
0
ответов

Как лучше всего включить PDF в мою документацию по Sphinx? [закрыто]

У меня есть PDF, в котором есть некоторые подробные объяснения для примера в документации Sphinx для пакета, который у меня есть. Есть ли способ легко включить PDF в мой проект (и скопировать его, когда я ...
вопрос задан: 18 July 2011 18:14
0
ответов

Как я могу указать форматы изображений PNG для сборок HTML и форматы изображений PDF для сборок Latex / PDF с помощью документов Sphinx?

Используя генератор документов sphinx, я пытаюсь использовать изображения .png для HTML-сборок документации, а затем я хочу, чтобы изображения .svg использовались для сборок PDF / LATEx. Кто-нибудь знает, как «пометить» ...
вопрос задан: 18 July 2011 17:16
0
ответов

Добавить настраиваемая ссылка на страницу проекта Hudson

Я использую Hudson для создания документации для проекта Python с помощью Sphinx. Это создает HTML-документацию в папке project / _build / html, которую я настроил для использования в качестве артефакта сборки. ...
вопрос задан: 18 July 2011 17:04
0
ответов

Домен Sphinx для Clojure

Я привык работать со Sphinx для проектов C ++ и Python. Я только что начал проект на Clojure и хотел бы повторно использовать свои навыки Sphinx / reStructuredText для документирования моего кода Clojure. Поскольку там '...
вопрос задан: 18 July 2011 17:02
0
ответов

Путь поиска фреймворка GCC Mac OS X: / System / Library before / Library?

Я пытаюсь скомпилировать проект в Mac OS X который ссылается на Python. У меня есть фреймворк Python 2.7 в / Library / Frameworks. Я компилирую для Mac OS X 4, поэтому у меня также есть Python 2.3 в /Developer/SDKs/MacOSX10.4u....
вопрос задан: 18 July 2011 17:02
0
ответов

Структурирование документации Sphinx

Я начал документировать проект Python с помощью Sphinx. Я использую его впервые - я привык к инструментам, которые работают с синтаксисом, подобным JavaDoc, и у меня есть некоторые сомнения. Поскольку я хочу ...
вопрос задан: 18 July 2011 16:36
0
ответов

Можно ли переопределить автодок Sphinx для определенных функций?

Я использую Sphinx ' s плагин autodoc для автоматического документирования набора модулей. У меня есть функция, которая принимает * args, и я хотел бы переопределить документацию, чтобы показать немного более удобное имя функции (arg1 [...
вопрос задан: 18 July 2011 16:33
0
ответов

Документы Sphinx: Удалить пустые страницы из сгенерированных PDF-файлов?

По умолчанию документация Sphinx выводит PDF, отформатированный для двусторонней печати. Таким образом, существует пустая страница между титульным листом и оглавлением, оглавлением и введением, вступлением и ...
вопрос задан: 18 July 2011 16:33
0
ответов

Автоматически создавать документацию Sphinx при изменении исходного файла

Я использую Sphinx для документирования одного из моих проектов, и мне нравится предварительно просматривать свои изменения в моем браузере. Я хочу сохранить некоторые изменения в файле .rst и сразу же обновить свой браузер ...
вопрос задан: 18 July 2011 16:32
0
ответов

Как я могу добавить настраиваемый нижний колонтитул в документацию Sphinx? (reStructuredText)

Если у меня есть какая-то документация, например, документация Galleria, как я могу настроить ее, чтобы при запуске команды make html она добавляла настраиваемый нижний колонтитул на каждую страницу? Я видел, что могу ...
вопрос задан: 18 July 2011 16:28
0
ответов

Как использовать автодок Sphinx для документирования метода __init __ (self) класса?

По умолчанию Sphinx не создает документы для __init __ (self) . Я пробовал следующее: .. automodule :: mymodule: members: и ..autoclass :: MyClass: members: В conf.py установка ...
вопрос задан: 18 July 2011 16:27
0
ответов

Sphinx , лучшие практики

Я только начал использовать инструмент Sphinx для создания документации для своего кода. Но я немного сбит с толку, потому что это не так просто, как я ожидал. Я создаю документ Sphinx, используя: sphinx-quickstart, а затем я ...
вопрос задан: 18 July 2011 16:24
0
ответов

How can I put an intersphinx link to an arbitrary method in the standard library documentation?

I am trying to use Sphinx to document a project, but I cannot figure out how to use intersphinx. I use this line: :py:meth:`math.sin` to add the link, but in the output, it shows up bold, not as a ...
вопрос задан: 18 July 2011 16:23
0
ответов

Прогнозы. countDistinct с Hibernate дает неожиданный результат

У меня следующий код Критерии критериев = this.getCriteriaForClass (DeviceListItem.class); Projection rowCountProjection = Projection.countDistinct («цвет»); У меня есть кодовая база Python с папкой ...
вопрос задан: 18 July 2011 06:05
0
ответов

Объединение документации Sphinx из нескольких подпроектов: обработка индексов, синхронизация конфигурации и т. Д.

У нас есть многомодульный проект, задокументированный с помощью (превосходного) Sphinx. Наша установка мало чем отличается от описанной в списке рассылки. В целом это отлично работает! Но у нас есть несколько вопросов по этому поводу: ...
вопрос задан: 13 June 2011 23:58
0
ответов

Включение внешней документации в проект Sphinx

Мы поддерживаем довольно большую документацию, используя Sphinx в SVN. Как часть сгенерированного вывода мы хотели бы включить примечания к выпуску связанных модулей Python в качестве основного содержимого (а не как гиперссылку! ...
вопрос задан: 20 May 2011 06:36
0
ответов

Sphinx pdf output: Апострофы в исходном коде python заменены правыми одинарными кавычками

Я вывожу некоторую документацию в формате pdf, используя Sphinx. Все очень хорошо, за исключением случаев, когда выводится исходный код python, тогда одинарные кавычки (unicode U + 0027) выводятся как правые одинарные кавычки (U + 2019) ...
вопрос задан: 22 April 2011 16:41
0
ответов

Как создать вложенный список в reStructuredText?

Я пытаюсь создать правильно вложенный список, используя следующий код (после Sphinx и документация): 1. X a. U б. V в. W 2. Y 3. Я ожидаю, что это приведет к появлению двух OL, но я получаю ...
вопрос задан: 5 April 2011 09:56
0
ответов

Как сгенерировать исходный код reST / sphinx из python?

Я хотел бы сгенерировать документацию через reST, но не хочу писать источник reST вручную, но позвольте скрипту python сделать это, а затем создать другие форматы (HTML, PDF) с помощью sphinx. Представьте, что у меня есть ...
вопрос задан: 15 March 2011 18:36