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