Commit Graph

934 Commits

Author SHA1 Message Date
Georg Brandl
1653c5d242 Make mode: refactor using a class and add source dir to the makefile 2014-01-19 16:23:23 +01:00
Georg Brandl
411d88a90e Merged in birkenfeld/sphinx-new-make-mode/stable (pull request #203)
Add "make mode" to sphinx-build, invoked by the -M flag.
2014-01-19 15:38:23 +01:00
Georg Brandl
91d92be8ad Add "make mode" to sphinx-build, invoked by the -M flag.
This is intended to do almost all of what the quickstart-generated Makefile
and make.bat did, but within Sphinx.  The advantages are:

* no duplication between Unix and Windows files
* updates and fixes are propagated (the generated makefiles never update)
* more Python code, less shell code!
2014-01-11 19:36:05 +01:00
Georg Brandl
6deebc4ef0 minor doc fixes 2014-01-11 14:52:41 +01:00
Georg Brandl
b29226a060 Closes #845: In code blocks, when the selected lexer fails, display line numbers nevertheless if configured. 2014-01-11 10:00:49 +01:00
Georg Brandl
166ac0d5ca fix target confusion 2014-01-10 21:44:59 +01:00
Georg Brandl
8b2417bc6d small fixes in intl document 2014-01-10 21:25:59 +01:00
Georg Brandl
2b6dc512b8 doc intro: add a pointer to readthedocs.org 2014-01-10 15:22:39 +01:00
Georg Brandl
bae7682bad merge with intersphinx tutorial section 2014-01-10 14:55:25 +01:00
Takayuki Shimizukawa
bcff26c6da update a Intersphinx tutorial section. refs #1325 2013-12-18 08:33:37 +09:00
Eric Knibbe
6c70ea2aae corrected descriptions of tabularcolumns specifiers 2013-12-17 18:14:28 +00:00
Eric Knibbe
9298e15ae0 recommend exclude_patterns instead of unused_docs or exclude_trees 2013-12-17 18:12:54 +00:00
Takayuki Shimizukawa
1367f6f9c6 Added a "Intersphinx" tutorial section. (:file:doc/tutorial.rst). Closes #1325 2013-12-17 23:54:30 +09:00
Georg Brandl
5dedeb30b0 py:decorator clarification 2013-11-25 20:43:23 +01:00
Georg Brandl
1efbc75905 Clarify use of signatures in python domain directives. 2013-11-24 16:02:34 +01:00
Georg Brandl
78b5d9aac2 Overhaul py directive documentation, remove old practices. 2014-01-13 19:12:42 +01:00
Georg Brandl
9708319f5c docs: fix some broken links 2014-01-13 00:05:22 +01:00
Georg Brandl
a72406d434 Closes #1328: clarify that builder-specific tags are not available when conf.py is executed. 2014-01-12 22:40:50 +01:00
Georg Brandl
123572e1db #1345: Fix two bugs with :confval:nitpick_ignore; now you don't have to
remove the store environment for changes to have effect.
2014-01-12 20:45:34 +01:00
Georg Brandl
3f1235e2ea doc: note that "image" paths should not have spaces. 2014-01-12 16:28:27 +01:00
Georg Brandl
31aed07386 Closes #1156: bring manpage up to scratch with current options and builders. 2014-01-12 16:07:21 +01:00
Georg Brandl
9d25862700 add link to "write the docs", move hosting chapter to home page 2014-01-12 12:44:36 +01:00
Georg Brandl
d38c5cac8d Closes #1082: clarify that html_title default value does not really have placeholders 2014-01-11 21:03:56 +01:00
Georg Brandl
48524dcecc Closes #983: clarify "docstitle" behavior with singlehtml 2014-01-11 20:18:37 +01:00
Georg Brandl
453290fc66 doc: make it more prominent that sub-toctrees shouldnt get :numbered:
Should be enforced programmatically at some point!
2014-01-11 19:54:47 +01:00
Georg Brandl
c5ff9386d6 Fix autodoc. 2013-10-12 21:01:25 +02:00
Georg Brandl
695cebd254 Add sphinx.version_info for better programmatic check of the Sphinx version. 2013-10-12 20:48:03 +02:00
Georg Brandl
ea8fad0de6 Removed the `sphinx.ext.refcounting` extension -- it is very specific to
CPython and has no place in the main distribution.
2013-10-12 19:27:49 +02:00
Eric Knibbe
0b22e43653 Added more domain links. 2013-10-08 14:35:32 +00:00
Takayuki Shimizukawa
e81a2d884e Added a ez_setup to replace distribute_setup. ez_setup become defacto. Closes #1264 2013-10-03 05:55:58 +00:00
Georg Brandl
8870db8787 grammar fix 2013-10-01 19:51:45 +02:00
Takayuki Shimizukawa
dab3f56267 Merged in erikb85/sphinx (pull request #154)
Removing "sphinx" prefix from Latex class parsing
2013-09-23 22:53:10 +09:00
Erik Bernoth
831f450bba Note in the documentation, that prepending "sphinx" is not necessary anymore. 2013-09-23 13:54:18 +02:00
anatoly techtonik
02123adce4 add link to IRC channel 2013-09-21 07:55:37 +00:00
Georg Brandl
d0cf2617cf Merged in dcmouser/sphinx-fork-dcmouser (pull request #161)
Added option to apidoc to write each module to standalone page instead of combining all modules in a package on one page.
2013-09-17 14:39:04 +02:00
Georg Brandl
7b8f78afac Small doc fixes for setuptools change. 2013-09-17 07:51:30 +02:00
Takayuki Shimizukawa
93e7623cd8 Add feature: theme package collection by using setuptools plugin mechanism. 2013-09-16 23:57:58 +09:00
Georg Brandl
44418fd1a1 changelog update for PR#136 2013-09-16 09:26:14 +02:00
Georg Brandl
d2b4f9a095 Merged in Vladimirsson/sphinx (pull request #136)
Added ``imported-members`` option for ``automodule`` directive in autodoc
2013-09-16 09:23:56 +02:00
Georg Brandl
de2e47bfce IRC channel update. 2013-09-16 09:16:08 +02:00
Georg Brandl
eafc199e06 Locale update: new locales, others updated from Transifex. 2013-09-16 09:02:06 +02:00
Georg Brandl
4b3a0b677d Add the cover of the Learning Sphinx book as an image. 2013-09-16 05:17:38 +02:00
Georg Brandl
900c50dd92 merge with stable 2013-09-16 05:10:27 +02:00
Georg Brandl
3541cef023 Update link to Japanese translation of the docs, and a link to the new OReilly book. 2013-09-16 05:09:05 +02:00
Georg Brandl
7c7c5af02a Merged in mcmtroffaes/sphinx-html-extra-path (pull request #158)
Add html_extra_path option to copy additional files ad verbatim to the output root folder.
2013-09-16 04:28:22 +02:00
Georg Brandl
e732807869 Merged in JonnyJD/sphinx/autodoc_novalue (pull request #109)
feature: autodoc: add :annotation: option for autodata and autoattribute
2013-09-16 04:25:53 +02:00
Georg Brandl
d521ebf93e Fixup docfield example usage. 2013-09-16 03:51:02 +02:00
dc mouser
3f888742ff Added option to apidoc to have it output each module to its own page and updated apidoc docs. 2013-09-08 16:25:41 -05:00
Kevin Burke
8faf315643 Add more inline examples
The idea is to show off all of the supported functionality of Sphinx
autodocs for domains in the given example. I always get confused about
the format for raised exceptions, etc. It would be great if this was a
little bit more of a comprehensive reference.
2013-09-05 09:52:54 -07:00
Matthias C. M. Troffaes
28873bfa6a Set up initial test. 2013-08-22 09:20:47 +01:00