IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity
6,382 Commits 2 Branches 219 Tags 163 MiB
a8dabf334d
Commit Graph

1293 Commits

Author SHA1 Message Date
Takayuki Shimizukawa
8b60f04431 * adding new sphinx supported system languages. closes #1403. 
* update all catalogs from transifex.
 2014-08-11 21:57:06 +09:00
Takayuki Shimizukawa
d39327d539 * for pull request #258: update CHANGES, add tests, add a document and refactoring. 2014-08-10 23:03:02 +09:00
Jakob Lykke Andersen
640dfc1951 Merged birkenfeld/sphinx into default 2014-08-06 18:54:23 +02:00
Jakob Lykke Andersen
9230dd6a89 Doc, update C++ domain. 2014-08-06 18:54:00 +02:00
Takayuki Shimizukawa
f7399a261a Add app.set_translator() API to register or override a Docutils translator class like :confval:html_translator_class. 2014-08-05 00:18:54 +09:00
Takayuki Shimizukawa
2e1c16486c * fix code to pass test, add versionadded to doc, update CHANGES for pull request #229 2014-08-03 19:19:31 +09:00
Takayuki Shimizukawa
9191ffaa50 Merged in russell/sphinx-pluggable-translators (pull request #229) 
Allow registration of other translators
 2014-08-03 18:52:02 +09:00
Takayuki Shimizukawa
eaed3ca9f1 Automatically compile `*.mo files from *.po` files. 2014-08-03 16:22:08 +09:00
Guillem Barba
b4b15181b4 Add env-read-docs event to allow modify docnames list before processing 2014-07-31 18:28:47 +02:00
Jakob Lykke Andersen
c19a15ea0d Doc, update C++ domain. 2014-07-27 11:42:01 +02:00
Lars Buitinck
5a13bce2e2 compress static PNG images with optipng -o10 
Average reduction in file size of 20%.
 2014-07-22 13:42:00 +02:00
Takeshi Komiya
024e8837cf Fix tx init command again. 2014-07-06 06:00:47 +00:00
Takeshi Komiya
65e83c6057 Do not enter password of transifex at command line by security reason 
Any command line options could be accessed by other users.
`tx init` command has interaction interface.
It should be used by all users by default.
 2014-07-06 05:09:16 +00:00
Takayuki Shimizukawa
c8e0a8759d Update documentation and sphinx-build -N option behavior for windows color console support. closes #1291. 2014-07-05 01:39:13 +09:00
EricFromCanada
4883e1eba2 more corrections for spelling and grammar 2014-06-19 12:14:47 -04:00
EricFromCanada
36313d98b1 corrected contractions 2014-06-18 12:52:32 -04:00
EricFromCanada
178a97cd73 improved consistency for how docs refer to True and False 2014-06-18 12:34:28 -04:00
EricFromCanada
65e924a3e4 rewrapping paragraphs when over 80 characters wide 2014-06-18 11:53:25 -04:00
EricFromCanada
8981b9bd13 corrections for misspellings 2014-06-18 11:19:01 -04:00
Rob Ruana
71b8fe8854 Closes #1489: Removes use of ":annotation:" for attribute types in napoleon, as inline markup is not allowed 2014-06-13 14:06:39 -06:00
David Bernard
7f78995d06 Expand tag documentation to include syntax requirements 2014-05-12 12:04:16 +10:00
Takayuki Shimizukawa
638458038d tiny documentation fix 2014-04-28 19:41:14 +09:00
Rob Ruana
7f710be021 Updates Napoleon documentation per suggestion by a user 2014-04-26 19:43:46 -04:00
Jean-Paul Calderone
19533c96a5 Fix a copy/paste (presumably) mistake in the extdev tutorial. 2014-04-04 11:53:37 -04:00
Georg Brandl
04065625ed merge with stable 2014-03-26 07:30:55 +01:00
Georg Brandl
c24cfbaed1 Add an example how to connect events. 2014-03-26 07:30:48 +01:00
Russell Sim
45a0bcd453 Allow registration of other translators 
This adds an add_translator method to the sphinx application class.
It allows developers to register custom translators (writers) with
sphinx, so other extensions that add new nodes can register support
for the custom translators.
 2014-03-20 12:34:11 +11:00
Rob Ruana
18df6421bf Closes #1396: Param types with inline markup no longer italicized 
Napoleon was attempting to render nested inline markup
( [a big no-no!](http://sphinx-doc.org/rest.html) ) for
parameter types. Now, if Napoleon sees any backquotes
in the parameter type, it is rendered without italics.
 2014-03-09 01:56:56 -05:00
Georg Brandl
02363c3ce2 merge with stable 2014-03-06 08:13:14 +01:00
Georg Brandl
b944c843f5 Add warnings that autodoc imports the modules. 2014-03-05 07:45:45 +01:00
Georg Brandl
afd6c0b28d Merged in shibu/sphinx/add_stemmer (pull request #214) 2014-03-04 19:10:19 +01:00
Georg Brandl
85ddf03f45 merge with stable 2014-03-02 08:50:10 +01:00
Georg Brandl
501c2d13e6 Fix long lines. 2014-03-02 08:40:48 +01:00
Georg Brandl
0312edd266 Merged in erny1803/sphinx (pull request #227) 
Latex: Allow alternative float options for figures
 2014-03-01 08:56:53 +01:00
Georg Brandl
c403737ec3 Add versionadded tags for new config values. 2014-03-01 08:25:22 +01:00
Georg Brandl
d50c5efb1a Merged in kenhys/sphinx (pull request #217) 
Add feature to suppress uuid/location information for message catalogs
 2014-03-01 08:21:59 +01:00
Georg Brandl
c3836b3188 Merged in shimizukawa/sphinx-drop-old-docutils (pull request #206) 
Drop docutils-0.7, 0.8, 0.9 support.
 2014-03-01 08:20:21 +01:00
Georg Brandl
ac92719ac3 Update copyright year. 2014-03-01 08:18:23 +01:00
Georg Brandl
e030031321 Update copyright year. 2014-03-01 08:18:16 +01:00
Georg Brandl
cbf13620e2 merge with stable 2014-03-01 08:08:24 +01:00
Ernesto Revilla
d82590927f Allow alternative float options for figure. See #1. no-pep8 2014-02-20 18:03:34 +01:00
Robert Lehmann
529519275e Fixed W3C Validator errors in index page. 2014-02-05 15:06:59 +01:00
Georg Brandl
2a2b59598c link to extdev doc from develop 2014-02-02 08:03:48 +01:00
Georg Brandl
43d056dbe4 link to extdev doc from develop 2014-02-02 08:03:48 +01:00
hayashi
e8503888bc Add feature to suppress uuid/location information for message catalogs 
Before: default

  #: ../../../source/news.txt:6
  # 9f62de6b9c3b477095dba5e468972e6d
  msgid "News"
  msgstr

After: suppress uuid & location information

  msgid "News"
  msgstr
 2014-02-01 02:34:09 +09:00
Georg Brandl
eb79fcafea merge with stable 2014-01-26 11:51:09 +01:00
Georg Brandl
cf60ef0e75 Update list of extensions in sphinx-contrib. 2014-01-26 11:40:22 +01:00
Georg Brandl
25ac2dda9c add link 2014-01-24 20:22:58 +01:00
Georg Brandl
1eb23c62ce merge with stable 2014-01-22 18:13:49 +01:00
Georg Brandl
2acaf03270 Closes #1357: Option names documented by :rst:dir:option are now again allowed to 
not start with a dash or slash, and referencing them will work correctly.
 2014-01-22 17:42:38 +01:00
Georg Brandl
38f47bc0ef Closes #1356: link to page with valid Pygments lexer alias 2014-01-22 17:28:04 +01:00
shibukawa yoshiki
6bda4586bd Add development memo about stemming JS code, acceleration tips about stemming, small bug fix 2014-01-22 02:12:04 -08:00
shibukawa yoshiki
18722362db update document 2014-01-22 00:34:14 -08:00
Georg Brandl
fb5a1a09a0 some directive creation docs 2014-01-21 10:32:30 +01:00
Georg Brandl
6b33e3fea4 remove duplicate wording 2014-01-21 10:05:23 +01:00
Georg Brandl
cc8d29dcab actually use exception markup 2014-01-21 10:04:11 +01:00
Georg Brandl
da09100869 doc: add exceptions from sphinx.errors 2014-01-21 09:54:31 +01:00
Georg Brandl
317930a7fb merge with stable 2014-01-20 21:21:33 +01:00
Georg Brandl
fe5ac65311 Merged in ViktorHaag/sphinx/stable (pull request #211) 
Fix for issue #1352
 2014-01-20 21:16:33 +01:00
Viktor Haag
3c0c9cd198 updates per Georg Brandl: 
- Change alteration to docs to express path relative to "configuration directory" and not "conf.py"
- Update block in HTML builder copying favicon to _static to mirror handling of html_logo
 2014-01-20 13:27:52 -05:00
Georg Brandl
883324fd6c Doc: move API docs in their own chapter and add more of it. 2014-01-20 17:21:44 +01:00
Viktor Haag
549b176c85 merge to tip 2014-01-20 10:37:51 -05:00
Viktor Haag
3706ed02ac address issue #1352 -- make sure to check for the actual file stored in config.html_logo. 2014-01-20 10:37:37 -05:00
Georg Brandl
aecf35c1bd mention loglevel 2014-01-20 11:21:30 +01:00
Georg Brandl
8115aa81a2 merge with stable 2014-01-20 08:54:40 +01:00
Georg Brandl
0e182d1d2b devguide: small updates 2014-01-20 08:51:47 +01:00
Rob Ruana
4219cd32c8 Merging changes 2014-01-19 13:44:28 -05:00
Rob Ruana
63fbb819c7 Makes suggested changes before adding napoleon to sphinx 2014-01-19 13:43:54 -05:00
Rob Ruana
3dcf8f4119 Merged birkenfeld/sphinx into default 2014-01-19 13:40:06 -05:00
Georg Brandl
66e64b9530 merge with stable 2014-01-19 19:13:17 +01:00
Rob Ruana
4c782604ed Merged birkenfeld/sphinx into default 2014-01-19 12:31:07 -05:00
Georg Brandl
ce49286240 Closes #1071: add mention of "orphan" to toctree docs 2014-01-19 18:12:52 +01:00
Georg Brandl
48aeed6fd8 add back missing @ 2014-01-19 17:49:57 +01:00
Georg Brandl
8c2fabe117 The deprecated config values `exclude_trees, exclude_dirnames and unused_docs` have been removed. 2014-01-19 17:46:06 +01:00
Georg Brandl
81b10b9b73 merge with stable 2014-01-19 17:41:41 +01:00
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
0d1aab9a45 Merged in keimlink/sphinx/improve-tags-docs (pull request #167) 
Explain that only tags set via command-line or tags.add() are available
 2014-01-19 11:09:42 +01:00
Georg Brandl
2458e5731a Add :filename: also for literalinclude. Changelog entry. 2014-01-19 11:04:12 +01:00
Georg Brandl
5023da8ac3 mock: little changes, changelog and versionadded 2014-01-19 10:34:52 +01:00
Georg Brandl
91cd11be3c Merged in guibog/sphinx2 (pull request #184) 
autodoc extension: add autodoc_mock_imports config value
 2014-01-19 10:31:15 +01:00
Rob Ruana
d11cb7325e Merge conflicts 2014-01-18 14:23:23 -05:00
Rob Ruana
a00a096069 Merges napoleon extension into mainline sphinx 2014-01-18 13:56:23 -05:00
Takayuki Shimizukawa
db9d91e8cc remove note it become useless anymore. 2014-01-18 21:47:20 +09:00
Takayuki Shimizukawa
c5bd935001 merge heads 2014-01-18 20:41:43 +09:00
Takayuki Shimizukawa
dd41adf0a0 merge heads 2014-01-18 16:34:47 +09:00
Georg Brandl
24a8b516bf Remove sphinx.ext.oldcmarkup compatibility extension. 2014-01-17 07:24:23 +01:00
Takayuki Shimizukawa
cc7509966c merge heads 2014-01-15 05:25:56 +00:00
Georg Brandl
dbd544d12b More tweaks to the py domain docs. 2014-01-13 20:13:44 +01:00
Georg Brandl
1723a09d72 merge with stable 2014-01-13 19:15:10 +01:00
Georg Brandl
78b5d9aac2 Overhaul py directive documentation, remove old practices. 2014-01-13 19:12:42 +01:00
Georg Brandl
d133f028af merge with stable 2014-01-13 00:14:00 +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
dd73c32892 merge with stable 2014-01-12 20:46: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
82e4751ed0 merge with stable 2014-01-12 17:04:58 +01:00
Georg Brandl
06364ca784 Closes #1174: Fix smart quotes being applied inside roles like :rst:role:program or :rst:role:makevar. 2014-01-12 17:01:22 +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
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
1d564ace28 merge stable into default 2014-01-11 14:53:07 +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
269ef714f3 Closes #668: Allow line numbering of `code-block and literalinclude` directives 
#to start at an arbitrary line number, with a new ``lineno-start`` option.
 2014-01-11 08:44:45 +01:00
Georg Brandl
5394fbb82b merge stable into default 2014-01-11 08:14:55 +01:00
Georg Brandl
166ac0d5ca fix target confusion 2014-01-10 21:44:59 +01:00
Georg Brandl
1356aff6d7 Closes #925: Allow list-typed config values to be provided on the command line, 
like ``-D key=val1,val2``.
 2014-01-10 21:44:14 +01:00
Georg Brandl
865d677eb8 merge stable into default 2014-01-10 21:26:12 +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
9a890a45c1 merge with stable 2014-01-10 14:57:43 +01:00
Georg Brandl
bae7682bad merge with intersphinx tutorial section 2014-01-10 14:55:25 +01:00
Georg Brandl
fcee847ae0 Merged in plaindocs/sphinx (pull request #185) 2014-01-10 09:24:23 +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
3c8de18e86 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
Eric Knibbe
d952469a22 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
Takayuki Shimizukawa
2050285ebf Drop docutils-0.7, 0.8 and 0.9 support 2013-12-15 16:25:01 +09:00
Takayuki Shimizukawa
f7cb510ebd Drop python-3.1 and remove support codes 2013-12-15 16:04:23 +09:00
Takayuki Shimizukawa
a8fc938d1b Drop python-2.5 and remove 2.4,2.5 support codes 2013-12-15 14:16:53 +09:00
Samuel Wright
4784bb7e32 Removed duplicate comma. 2013-12-10 19:42:47 +01: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
Samuel Wright
4bcb7a2c1b Fixed wording. 2013-10-25 13:22:01 +02:00
Samuel Wright
b3286c6b82 Fix for Issue #1071 2013-10-25 13:08:03 +02:00
guibog
a8f65e9d3c autodoc extension: add autodoc_mock_imports config value 2013-10-23 16:36:45 +08: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
Markus Zapke-Gründemann
d7caa3fa20 Explain that only tags set via command-line or tags.add() are available 2013-09-19 21:48:54 +02: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
Matthias C. M. Troffaes
57aceed4ed Add and document html_extra_path option. 2013-08-22 08:51:06 +01:00
Roland Meister
88c72be190 Add warning for unusual chars in filenames. Closes #1199 2013-08-10 15:36:05 +02:00
Takayuki Shimizukawa
d9f5439ffe fix: broken document format (rst) 2013-07-14 14:43:21 +09:00
Eric Holscher
f62a28d805 Add link to referenced docutils docs. 2013-07-11 13:30:17 -07:00
Roland Meister
73a1420cc6 Add epub_guide entry to doc/conf.py 
The toc for the spinx documentation actually is in contents.rst.
 2013-06-19 21:02:27 +02:00
Roland Meister
cc909ab2a9 More docs cleanup; add hint for the epub cover page 2013-06-07 20:48:14 +02:00
Roland Meister
2f5b7b8db1 Adjust docs about inline URLs for the epub builder 2013-06-06 21:53:59 +02:00
Roland Meister
ce6b8fff70 Clarify docs for the format and builder tags 2013-06-06 21:23:16 +02:00
Roland Meister
f879346cea Add the builder name as predefined tag for the only directive. 
At the moment only the epub builder distinguishes between format and name.
Explicit entries with format_ and builder_ prefix are also added.
 2013-04-25 23:08:30 +02:00
Bogdan Opanchuk
a7a4f7569a Added `imported-members option for automodule` directive in autodoc 2013-04-20 21:58:18 +10:00
Takayuki Shimizukawa
75a128b0f8 integrate 'translationguide.rst' into 'intl.rst' 2013-04-13 18:16:48 +09:00
Takayuki Shimizukawa
3b9ae95d01 update translation document 2013-04-11 23:45:15 +09:00
Roland Meister
36157e7cb8 Merged in rolmei/sphinx-epub (pull request #129) 
footnote setting for epub_show urls
 2013-04-08 23:14:05 +02:00
Georg Brandl
ff769018ca Add a section about updating locales to the devguide. 2013-04-05 16:42:47 +02:00
Roland Meister
c56b6aabcf Merge with birkenfeld/sphinx 2013-04-03 19:06:01 +02:00
Roland Meister
510ec71d07 Merged in rolmei/sphinx-epub (pull request #126) 
New option epub_tocscope
 2013-04-03 18:47:24 +02:00
Nozomu Kaneko
c505f70439 Update the draft of Sphinx Document Translation Guide 2013-04-03 03:25:53 +09:00
Takayuki Shimizukawa
d7e6ab3cfc add first draft for sphinx document translation 2013-04-03 00:11:55 +09:00
Takayuki Shimizukawa
649a75c427 add 'locale_dirs' and 'gettext_compact' to conf.py for translation setup easier 2013-03-31 12:22:08 +09:00
Georg Brandl
08839fac68 docs: fix link to MathJax documentation 2013-03-30 14:08:33 +01:00
Georg Brandl
0237940007 remove stray quote 2013-03-30 12:48:21 +01:00
Georg Brandl
ba39edb5db merge with parallel repo 2013-03-29 13:01:21 +01:00
Georg Brandl
dea5b77bb3 docs: add versionadded to epub_use_index confval 2013-03-29 12:49:53 +01:00
Georg Brandl
d492aad352 docs: proofread installation document 2013-03-29 11:45:07 +01:00
Takayuki Shimizukawa
e30b1325ef Because it was thought MaxJax CDN URL has not been written intentionally, I undo the changes. 
See also #683.
Backed out changeset 2f9a30b7d005.
 2013-03-29 10:52:52 +09:00
Takayuki Shimizukawa
c4a999f682 add missing mathjax_path default value in document. 2013-03-29 10:45:24 +09:00
Roland Meister
234c0c0c75 New 'footnote' setting for epub_show_links. 2013-03-11 21:59:53 +01:00
Roland Meister
948991ed28 Merge with birkenfeld/sphnx 2013-03-10 15:30:06 +01:00
Takayuki Shimizukawa
2c409959ac Add i18n capabilities for custom templates. 
For example: The Sphinx reference documentation in doc directory provides
sphinx.pot file from ``doc/_templates/*.html`` by ``make gettext``.
 2013-03-10 22:07:31 +09:00
Takayuki Shimizukawa
9afd86a569 Merged in rolmei/sphinx-epub (pull request #123) 
epub_use_index instead of html_use_index for epub builder (Issue #1106)
 2013-03-10 10:19:49 +09:00
shirou
fbd60fc0c9 change 1.1.3 to 1.2 about latex_additional_files in conf.py document. 2013-03-07 11:05:33 +09:00
Roland Meister
4507ada0bc Add new setting epub_tocscope for epub builder. 
The new setting replaces the old heuristic that was never that good.
 2013-03-06 20:48:00 +01:00
Roland Meister
a567d77e51 epub_use_index instead of html_use_index for epub builder (Issue #1106) 
The change adds the method get_builder_config.
This allows use of the option epub_use_index instead
of html_use_index for epub output.
 2013-03-06 18:43:21 +01:00
shirou
8bec3b8777 move "copy additional files" after "copying TeX support files" in latex builder. 
It enables the user to override TeX support files such as sphinx.sty by setting latex_additional_files.
 2013-03-05 22:17:05 +09:00
Johannes Dewender
649ab8030c autodoc: change :novalue: to :annoation: option 
The :novalue: option is now called :annotation: and has an additional feature:
When given with an argument, you can specify what the annotation
of the object will be.
 2013-02-27 16:38:55 +01:00
Jonathan Waltman
15b34a0940 Set latex_elements['fontpkg'] = '' for Cyrillic languages (suggested by Dmitry Shachnev) 2013-02-22 02:16:02 -06:00
Jonathan Waltman
3019758150 Merged in mitya57/sphinx (pull request #114) 
LaTeX writer: include cmap package by default
 2013-02-22 01:36:07 -06:00
Jonathan Waltman
eb88e37040 Merged in rolmei/sphinx-epub (pull request #117) 
Some small fixes
 2013-02-20 15:20:04 -06:00
Jonathan Waltman
c9a5c78a20 Changelog entry for pull request 115 and doc update. 2013-02-20 15:11:45 -06:00
Jonathan Waltman
50d4aec15c [texinfo] Update CHANGES and relevant documentation. 2013-02-20 04:09:50 -06:00
Jonathan Waltman
e3a27b76f2 Closes #1110: Add new config value texinfo_no_detailmenu and do not generate detailed menus for non-"Top" nodes. 2013-02-19 03:24:57 -06:00
Roland Meister
12d0574aee Merge with birkenfeld/sphinx 2013-02-14 21:47:58 +01:00
Roland Meister
0525c97427 Rename pythonorg.jpg to proper pythonorg.png. 2013-02-14 21:46:11 +01:00
Roland Meister
32414bf3d3 Add orphan documents as epub_post_files. 2013-02-14 21:34:26 +01:00
Dmitry Shachnev
6d4efb2d1f Add a versionadded directive 2013-02-11 09:11:18 +04:00
Dmitry Shachnev
0a11494e60 LaTeX writer: include cmap package by default. 
Also, fix a small typo in config.rst.
 2013-02-10 18:02:21 +04:00
Dmitry Shachnev
1c5638e40c doc/_templates/index.html: fix link to the list of extensions 2013-02-10 16:39:44 +04:00
shirou
c4f107a8cf add "versionadd". 2013-02-10 01:44:56 +09:00
shirou
3e1ce90183 change "epub_show_urls" option default value to 'inline'. 
This keeps the current behaviour.
 2013-02-09 23:01:42 +09:00
shirou
0635eddd07 add "epub_show_urls" option to doc and quickstart. 2013-02-09 23:00:47 +09:00
shirou
fc63acf3d1 Merged birkenfeld/sphinx into default 2013-02-09 22:44:56 +09:00
Georg Brandl
d8d94e15e3 Add Basque to the list of languages. 2013-02-07 18:50:09 +01:00
shirou
74cce431a3 add epub_show_urls option. This option is almost same as latex_show_urls. 2013-02-06 23:32:12 +09:00
Johannes Dewender
391f99d13a autodoc: document novalue option 
The update is listed for version 1.2.
This should be changed if the change is released later.
 2013-01-22 17:58:47 +01:00
Takayuki Shimizukawa
fbd63617cf add installations for each environments 2013-01-20 16:06:04 +09:00
Georg Brandl
926cd01168 Remove devguide mention. 2013-01-19 21:14:22 +01:00
Georg Brandl
20279b07a4 New doc design "sphinx13". 2013-01-18 23:17:11 +01:00
Georg Brandl
0939d6fcdb New doc design "sphinx13". 2013-01-18 23:17:11 +01:00
Georg Brandl
c59cb9d6f6 docs: document -j option and add changelog 2013-01-14 08:38:46 +01:00
Georg Brandl
2b06c656c1 faq: add sphinx-contrib 2013-01-14 00:07:19 +01:00
Georg Brandl
0701c850d2 faq: add Hieroglyph 2013-01-14 00:02:51 +01:00
Georg Brandl
b8967b4ee8 tutorial: make "documentation collection" clearer 2013-01-14 00:01:18 +01:00
Georg Brandl
1bf5a17534 Closes #1076: document new sphinx-build options. 2013-01-12 22:45:47 +01:00
Roland Meister
1639f59726 Add includehidden option to the toctree directive 
This option is equivalent to the includehidden option of the template function
toctree() and allows to restore to the toctree behaviour prior to version 1.1.
See also bug #790.
 2013-01-06 14:55:35 +01:00
Georg Brandl
1832284e89 Closes #1067: implement pluggable search scorer and tweak scoring to give good results. Patch by Hernan Grecco. 2013-01-04 11:17:32 +01:00
Roland Meister
a0ebe5a3c5 Merge with birkenfeld/sphinx 2013-01-02 09:40:37 +01:00
Georg Brandl
151856819c Copyright update. 2013-01-01 22:13:15 +01:00
Georg Brandl
998d567d5c Closes #1065: in Makefiles, ignore errors in "rm" using the -f flag, not a "-" prefix. 2012-12-31 09:39:02 +01:00
Roland Meister
50fadb9e94 Bug #1047: templating toctree()'s includehidden argument 
Document the includehidden option and give it sane defaults.
See bug #1047 for implementation alternatives.
 2012-12-10 21:54:11 +01:00
Denis
5b54c253bb Upgrade for 'default' theme: collapsiblesidebar works with rightsidebar 2012-12-10 14:13:35 +04:00
Jonathan Waltman
beae650645 xml: Update sphinx-build documentation 2012-12-10 02:41:12 -06:00
Jonathan Waltman
8ac4aa6282 Add Docutils-native XML and pseudo-XML builders 2012-12-04 21:10:15 -06:00
Jonathan Waltman
3a8673a66b devguide: Add guidelines for core developers 2012-12-03 00:55:47 -06:00
Jonathan Waltman
196cb44c30 devguide: Elaborate on pull requests 2012-12-02 01:18:54 -06:00
Jonathan Waltman
0cca0ad7cf Add initial draft of "Sphinx Developer's Guide" 2012-11-29 19:11:19 -06:00
Georg Brandl
4763419db1 Update Sphinx URL to new sphinx-doc.org domain. 2012-11-04 11:28:12 +01:00
Jonathan Waltman
55b28b0198 Fix whitespace / line length issues reported by "make test" 2012-11-03 11:04:32 -05:00
Robert Lehmann
31536aafa2 Link domains provided by sphinxcontrib. 2012-11-02 16:52:55 +01:00
Robert Lehmann
edebdbbb7b Update domains provided by sphinxcontrib. 2012-11-02 16:02:32 +01:00
Georg Brandl
d13c0470af Update requirements documentation. 2012-10-30 10:24:57 +01:00
Georg Brandl
d769d4ae71 Change sphinx-dev to sphinx-users where applicable. 2012-10-30 08:47:20 +01:00
Georg Brandl
0c02841412 Closes #1010: Make pngmath images transparent by default; IE7+ should handle it. 2012-10-28 19:06:48 +01:00
Georg Brandl
10a65f62ef Linkcode changelog entry. 2012-10-28 18:22:53 +01:00
Georg Brandl
201883d209 Merged in pv/sphinx-work/ext-linkcode (pull request #47) 2012-10-28 18:21:57 +01:00
Georg Brandl
88dac45c9e Fix Norwegian language code. 2012-10-28 18:19:54 +01:00
Georg Brandl
33828e4777 merge with stable 2012-10-28 18:01:57 +01:00
Georg Brandl
883887b57b Changelog and style fixes for PR#75. 2012-10-28 17:57:40 +01:00
Jonathan Waltman
ead356e3cf Remove note about sectioning limitation of the "only" directive. 2012-09-12 16:40:10 -05:00
Benoit Bryon
c127ac19bd Fixed apidoc's --follow-links option in documentation. 2012-08-30 15:51:46 +02:00
Benoit Bryon
236267847c Fixed documentation of default behaviour for apidoc's '--followlinks' option. 2012-08-30 14:19:10 +02:00
Benoit Bryon
316ddaf732 Added -l, --followlinks option to sphinx-apidoc. 2012-08-30 14:14:44 +02:00
Georg Brandl
c333f515cd Doc change for d7ac5e46307d 2012-05-08 12:51:28 +02:00
Georg Brandl
a0a7f37ab2 Merge with stable 2012-05-08 12:48:33 +02:00
Georg Brandl
9af2094ca4 Merged in rolmei/sphinx-epub (pull request #56) 2012-04-11 21:35:35 +02:00
Georg Brandl
fe8ed35dfb Make it clearer how autodoc special comments have to be formatted. 2012-03-17 16:54:17 +01:00
Pauli Virtanen
da4ba903a3 DOC: linkcode: fix up documentation a bit 2012-03-11 17:55:29 +01:00
Pauli Virtanen
135bb6f6c8 ENH: add a linkcode extension 2012-03-11 17:48:51 +01:00
Georg Brandl
c5513e960c merge with stable 2012-03-10 21:38:29 +01:00
Georg Brandl
729565b7a9 Fixes #795: explain that titles on the same level as the document heading cannot be put into only directives. 2012-03-10 21:21:43 +01:00
Georg Brandl
166c7e8d27 Style fixes. 2012-03-10 18:13:55 +01:00
Georg Brandl
94f8dda758 Merged in intgr/sphinx (pull request #45) 2012-03-10 18:07:16 +01:00
Roland Meister
c20c83140a Merge with birkenfeld/sphinx 2012-02-28 22:09:53 +01:00
Roland Meister
0d12036da0 Add documentation and automatic entries for the guide element 2012-02-28 21:59:57 +01:00
Marti Raudsepp
fd70920456 Fix docutils links found by linkcheck (with the new anchor checking feature) 2012-02-28 20:34:57 +02:00
Marti Raudsepp
e0e9d2a7fa Add #anchor checking to 'linkcheck' builder. 
This requires us to download the document and parse its HTML.
 2012-02-28 20:12:59 +02:00
Jeffrey Finkelstein
01a350c198 Added other domains currently listed in the sphinx-contrib repository (including Ada, Erlang, HTTP, PHP, and Ruby). 2012-02-24 01:09:32 -05:00
Georg Brandl
64593b946e merge with stable 2012-02-19 11:54:53 +01:00
Georg Brandl
1fe365f9cd Add versionadded tags. 2012-02-18 08:05:41 +01:00
Georg Brandl
ea5dc363e2 Merged in rolmei/sphinx-epub (pull request #42) 2012-02-18 08:04:31 +01:00
Robert Lehmann
f646779255 Fix typo. 2012-02-15 08:43:26 +01:00
Roland Meister
024b5950dd Merge with birkenfeld/sphinx 2012-02-13 20:59:37 +01:00
Georg Brandl
cc8a4a8126 Closes #817: note that math markup in docstrings needs to take care of backslashes. 2012-01-29 12:06:02 +01:00
Georg Brandl
4a8eef8479 Add Slovak translation to docs. 2012-01-29 10:04:29 +01:00
Georg Brandl
5ad2895e73 Add Hungarian translation to docs. 2012-01-29 10:03:09 +01:00
Georg Brandl
53d06fda7b Closes #793: Fix docutils version references. 2011-11-01 09:16:37 +01:00
Georg Brandl
9a4a3c9afa Satisfy "make check". 2011-10-09 23:09:57 +02:00
Robert Lehmann
356b1ab8d3 Fix typo. 2011-10-08 16:17:00 +02:00
Georg Brandl
38ebe67c4e Closes #585: document sphinx-apidoc. 2011-10-07 12:47:58 +02:00
Georg Brandl
ff940a16b6 Add a rudimentary manpage for sphinx-apidoc. 2011-10-07 12:27:19 +02:00
Robert Lehmann
b8873fe7b0 Fixes #354: Addressed PDF generation in the tutorial. 2011-10-06 14:52:54 +02:00
Robert Lehmann
77329bf497 Closes #561: Add configuration option to prevent catalog bundling. 2011-10-03 13:20:53 +02:00
Georg Brandl
2c77c05473 Merge with 1.0 2011-09-23 22:03:34 +02:00
Georg Brandl
09b5e1736c Add reference to odt2sphinx. 2011-09-23 11:36:32 +02:00
Georg Brandl
ded4bee328 Add note about inclusion with the "include" directive. 2011-09-23 11:22:35 +02:00
Armin Ronacher
2a021f1cf9 merged 2011-09-23 00:49:08 +02:00
Armin Ronacher
7eae4bcaeb Attach arrays to the name not the type for C++ domain and fixed a few rendering errors. 2011-09-23 00:48:52 +02:00
Armin Ronacher
5315d23365 Attach arrays to the name not the type for C++ domain and fixed a few rendering errors. 2011-09-23 00:48:52 +02:00
Georg Brandl
07427c48fb Merge with 1.0. 2011-09-22 14:39:27 +02:00
Georg Brandl
3d4b8830a0 Fix #708: add reference to Pandoc. 2011-09-22 14:05:03 +02:00
Georg Brandl
ad5d9f7c6b Add changelog entry for emphasize-lines and some coding style fixes. 2011-09-22 09:29:36 +02:00
Georg Brandl
5373125fc6 Merged in marklodato/sphinx (pull request #4) 2011-09-22 09:14:50 +02:00
Georg Brandl
e74a5541df Make it clear that math labels are internal. 2011-09-21 10:21:22 +02:00
Mark Lodato
2c0f936e6b add :emphasize-lines: option to source-code and literal-include 
Add a new option, :emphasize-lines:, to the source-code and
literal-include directives.  The format is the same as the :lines:
option for literal-include.  The resulting list of lines is passed to
the Pygments formatter as 'hl_lines', which is only honored by the HTML
formatter.
 2011-07-06 22:58:19 -04:00
Roland Meister
dbe932d30c Merge with birkenfeld/sphinx. 2011-05-23 21:22:33 +02:00
Roland Meister
0da0c03b53 Added the epub theme options relbar1 and footer. 2011-05-23 21:09:51 +02:00
Georg Brandl
10287a6684 merge with 1.0 2011-05-15 13:52:48 +02:00
Georg Brandl
8965cf1095 Closes #658: fix error in script_files example and document css_files. 2011-05-15 13:05:31 +02:00
Georg Brandl
99c505b63f Closes #683: set default MathJax path to the CDN URL, and update the docs accordingly. 2011-05-15 11:57:23 +02:00
Georg Brandl
8a08f5b42a Closes #694: add Latvian locale, thanks to Alexander Smishlajev. 2011-05-15 11:27:01 +02:00
Georg Brandl
1b6e2bfa9c Fix #766: Add Estonian locale, thanks to Aivar Annamaa. 2011-09-21 09:28:49 +02:00
Georg Brandl
4718e50f4b Fix #714: Add Korean locale, thanks to Channy Yun. 2011-09-21 09:25:37 +02:00