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
3,238 Commits 2 Branches 219 Tags 163 MiB
c9e18c2646
Commit Graph

326 Commits

Author SHA1 Message Date
Georg Brandl
8003801e8d #189: dont use title set by title directive for links, only for HTML title. 2009-06-16 22:02:51 +02:00
Georg Brandl
a6fdc4602a merge with 0.6 2009-06-16 21:32:05 +02:00
Georg Brandl
28b1f7eef6 Remove debugging code. 2009-06-16 19:59:16 +02:00
Georg Brandl
8820e99440 Added `titlesonly option to toctree` directive. 2009-06-15 18:05:07 +02:00
Georg Brandl
72516863b6 Add API to add components to a domain. 2009-07-28 17:45:02 +00:00
Georg Brandl
1c030b415e With a few disabled features (see XXX), the test suite runs again. 2009-07-13 21:28:01 +02:00
Georg Brandl
a1dd4695f3 First step of domain handling in environment. 2009-07-13 20:53:11 +02:00
Georg Brandl
db8395f9e1 Add make_refnode() utility function. 2009-07-13 18:27:34 +02:00
Georg Brandl
c92f97d848 Move xref resolution to domain class. 2009-07-13 17:28:07 +02:00
Georg Brandl
ab7cfb4a99 Make domains instances, which have factory methods for their roles and directives. 2009-07-13 16:59:45 +02:00
Georg Brandl
c02b7149aa Move domain-specific code around a bit; builtin domains are now completely in sphinx.domains. Test suite does not pass yet. 2009-07-05 12:24:27 +02:00
Georg Brandl
43667a2a9c Remove filemodules attribute which isnt used anymore. 2009-06-29 18:43:59 +02:00
Georg Brandl
5c6697e69f Fix some oversights. 2009-06-29 17:16:05 +02:00
Georg Brandl
2ea1de50a9 Introduce "domains". 2009-06-29 17:04:33 +02:00
Georg Brandl
92eef1b2e5 Set the default encoding to `utf-8-sig` to handle files with a 
UTF-8 BOM correctly.
 2009-05-31 18:58:28 +02:00
Georg Brandl
b4365ad72b #173: Respect the docutils `title` directive. 2009-05-17 19:15:28 +02:00
Georg Brandl
61146192c7 #172: The `obj` role now links to modules as promised. 2009-05-17 12:58:48 +02:00
Georg Brandl
adfb8c2668 Fix speling. 2009-05-16 12:47:18 +02:00
Georg Brandl
82af37ea7c Don't put image "alt" text into table-of-contents entries. 2009-04-28 20:46:24 +02:00
Georg Brandl
b966975ca6 Fix a small problem with rfind() methods. 2009-04-10 11:10:38 +02:00
Georg Brandl
30fe6d4190 Sanitize the Environment.update() method API. 2009-03-05 20:25:39 +01:00
Georg Brandl
b244dbf9b5 Use standard `file:line: warning: message` format for warning messages. 2009-03-05 09:21:35 +01:00
Georg Brandl
d31f68be58 Make "numbered" toctree attribute optional. 2009-02-24 21:05:50 +01:00
Georg Brandl
9ed275c868 #109: fix circular import problems by moving exceptions into their own module. 2009-02-24 19:15:39 +01:00
Georg Brandl
fb511a015a Paths to literal include files and download files can now be absolute too. 2009-02-24 13:38:15 +01:00
Georg Brandl
5f0a7375c8 Bump ENV_VERSION after section numbering change. 2009-02-22 16:30:40 +01:00
Georg Brandl
7792e27030 #10: implement HTML section numbering. 2009-02-22 15:22:23 +01:00
Georg Brandl
18c3748c98 merge with 0.5 2009-02-21 19:59:33 +01:00
Georg Brandl
2d0345a7d9 #71: If a decoding error occurs in source files, print a warning and replace the characters by "?". 2009-02-21 19:58:52 +01:00
Georg Brandl
b861ee622a Only move module targets that really come from module directives. 2009-02-20 09:43:00 +01:00
Georg Brandl
a43b651804 Make "make check" happy. 2009-02-19 23:31:34 +01:00
Georg Brandl
4c81b055c8 Added an `only` directive that can selectively include text 
based on enabled "tags".  Tags can be given on the command
line.  Also, the current builder output format (e.g. "html" or
"latex") is always a defined tag.
 2009-02-19 21:56:34 +01:00
Georg Brandl
d4f5796f3b The HTML builder now stores a small file named `.buildinfo` in 
its output directory.  It stores a hash of config values that
can be used to determine if a full rebuild needs to be done (e.g.
after changing ``html_theme``).
 2009-02-19 16:15:36 +01:00
Georg Brandl
0a703edf40 merge with 0.5 2009-02-18 10:10:06 +01:00
Georg Brandl
2244e57222 Backport two fixes that should have been made here. 2009-02-18 10:09:17 +01:00
Georg Brandl
342ef89bda Fix the fix for #82. 2009-02-18 01:13:57 +01:00
Georg Brandl
071756377a Don't output system messages while resolving, because they would stay in the doctrees even if keep_warnings is false. 2009-02-17 18:57:51 +01:00
Georg Brandl
3984c0f05c #82: Determine the correct path for dependencies noted by 
docutils.  This fixes behavior where a source with dependent
files was always reported as changed.
 2009-02-17 18:33:48 +01:00
Georg Brandl
33bed1ef6b Recognize toctree directives that are not on section toplevel, 
but within block items, such as tables.
 2009-02-14 20:19:01 +01:00
Georg Brandl
1b283a49c5 Use better error messages for unsupported markup in LaTeX documents. 2009-02-12 12:46:25 +01:00
Georg Brandl
5250c2efa9 Use a new RFC base URL, since rfc.org seems down. 2009-02-12 12:15:26 +01:00
Georg Brandl
eefc54baca Fix #86; merged from mq 2009-01-14 19:39:27 +01:00
mq
fccd4fff66 fix custom link titles in toctrees 2009-01-14 14:44:10 +01:00
Georg Brandl
677d096393 On Windows, the target of os.rename() may not exist. 2009-01-13 23:55:24 +01:00
Georg Brandl
0b28b3e6f6 Switch copyright and license tags to single style. Add contributor 
names in AUTHORS instead, and add the license of etree13 to
LICENSE.
 2009-01-03 11:57:07 +01:00
Georg Brandl
9b48c13ee8 * #81: Write environment and search index in a manner that is safe 
from exceptions that occur during dumping.
 2009-01-03 11:13:43 +01:00
Georg Brandl
8af0caea30 Fix #80: use string.ascii_* constants in case locale.setlocale() is 
somehow called which then leads to UnicodeErrors.
 2009-01-02 14:51:55 +01:00
Georg Brandl
83dba8fc76 Fix #60: "smart" image inclusion in subdirs. 2008-12-08 08:44:18 +01:00
Georg Brandl
a967dc4027 Fix #60: Don't crash for invalid index entries. 2008-11-30 20:56:08 +01:00
Georg Brandl
03a9656c72 merge with 0.5 2009-02-17 18:59:47 +01:00
Georg Brandl
55fde211f7 merge with 0.5 2009-02-17 18:34:22 +01:00
Georg Brandl
38e766c231 Allow "self" in toctrees, as a reference to the document containing the directive. 2009-02-17 18:17:17 +01:00
Georg Brandl
016f375403 merge with trunk 2009-02-15 10:46:17 +01:00
Georg Brandl
56b204b8a4 Use well-named IDs before auto-named IDs. 2009-02-15 02:49:08 +01:00
Georg Brandl
1219e3e73a merge with main 2009-02-14 23:25:30 +01:00
Georg Brandl
66609e8165 merge with 0.5 2009-02-14 20:19:16 +01:00
Georg Brandl
06b32a712f Image paths can now be absolute (like `/images/foo.png`). 
They are treated as relative to the top source directory.
 2009-02-14 15:29:18 +01:00
Georg Brandl
c09bf1ad85 merge with 0.5 2009-02-12 12:53:48 +01:00
Georg Brandl
26ae3f01aa Add a rst_epilog setting, usable for global substitutions. 2009-02-07 19:41:10 +01:00
Georg Brandl
394282223b Patch from Stefan Seefeld: make local toctree collapsible. 2009-02-07 13:32:47 +01:00
Georg Brandl
1e347aba51 Skip pygments-related tests if it is not installed. 2009-02-06 22:18:16 +01:00
Georg Brandl
4e3c3a43fc The new `trim_footnote_reference_space` config value mirrors 
the docutils config value of the same name and removes the
space before a footnote reference that is necessary for reST
to recognize the reference.
 2009-01-26 23:38:02 +01:00
Georg Brandl
d1e6119461 merge with trunk 2009-01-26 22:44:38 +01:00
Georg Brandl
f1e39097c6 Add a minimal test for external toctree links and fix a small bug found by it. 2009-01-26 22:04:29 +01:00
Georg Brandl
e974741c74 Added a toctree variable to the templates, and the ability to 
include external links in toctrees.

Patch by Stefan Seefeld.
 2009-01-26 21:57:15 +01:00
Georg Brandl
55c4f5a096 merge with trunk 2009-01-22 19:25:24 +01:00
Georg Brandl
a8756fb4b3 merge with 0.5 2009-01-14 19:39:42 +01:00
Georg Brandl
1f987f6af6 merge with trunk 2009-01-14 00:00:27 +01:00
Georg Brandl
88639dc45e merge with 0.5 2009-01-13 23:59:01 +01:00
Georg Brandl
b068e91803 Reformat to EOL80. 2009-01-10 21:23:39 +01:00
Benjamin Peterson
9a4369a413 remove usage of .message 2009-01-10 12:46:01 -06:00
Georg Brandl
5df8e162f9 Fix a few remaining copyrights and add 2009 to license. 2009-01-04 14:39:36 +01:00
Georg Brandl
f16f94f2cd Merge in copyright style changes from 0.5. 2009-01-03 12:15:19 +01:00
Georg Brandl
6a8b0aa599 merge in 0.5 2009-01-03 11:33:44 +01:00
Georg Brandl
29e893205e merge in 0.5 2009-01-02 14:53:33 +01:00
Georg Brandl
1aa8baa0d8 Fix #46: allow linking to special labels via :ref:abc <genindex>. 2008-12-28 23:59:40 +01:00
Georg Brandl
5d05ffc883 Fix #6: Don't generate redundant `<ul>` for top-level TOC tree 
items, which leads to a visual separation of TOC entries.
 2008-12-28 21:56:22 +01:00
Georg Brandl
b3d55c3139 Close #4: Added a `:download:` role that marks a non-document file 
for inclusion into the HTML output and links to it.
 2008-12-28 21:30:25 +01:00
Georg Brandl
78dec65bcc Due to popular demand, added a `:doc:` role which directly 
links to another document without the need of creating a
label to which a ``:ref:`` could link to.
 2008-12-28 19:44:54 +01:00
Georg Brandl
26d7aafaae Explicitly refer to the license in :license: tags. 2008-12-27 12:19:17 +01:00
Georg Brandl
c74163d0a0 The `toctree directive now supports a :hidden:` flag, 
which will prevent links from being generated in place of
the directive -- this allows you to define your document
structure, but place the links yourself.
 2008-12-20 23:23:39 +01:00
Georg Brandl
5b10659f87 Fix for Unicode strftime formats. 2008-11-13 09:35:01 +01:00
Georg Brandl
f490645392 #31: apply title transformations for xref roles in TOCs too. 2008-11-09 20:48:32 +01:00
Georg Brandl
4c3f2f0d7e Add classes to toctree items that indicate depth. 2008-11-09 20:43:36 +01:00
Georg Brandl
fb26a2a5fc #14: allow distinct programs for cmdoption directive. 2008-11-09 18:28:36 +01:00
Georg Brandl
7b62fc8f2d Add env-purge-doc event. Add some examples for event usage. 2008-11-09 11:56:40 +01:00
Georg Brandl
ef3528b36e #4251: some module links didn't have proper anchors. 2008-11-08 13:55:17 +01:00
Georg Brandl
dbfe74d5e6 Fix the handling of images in different directories. 2008-11-06 10:36:56 +01:00
Georg Brandl
3715bd90a0 Don't disable alphabetical and roman lists anymore. 2008-10-25 16:53:29 +00:00
Georg Brandl
406aae4d6a Fix outdated docstring. 2008-10-25 16:09:15 +00:00
Georg Brandl
29a3a86cef Add global citations. #1. 2008-10-25 15:54:34 +00:00
Georg Brandl
4b9119f990 Support <meta> tags via meta directive. 2008-10-18 09:29:49 +00:00
Georg Brandl
516d1a2872 Add "source_encoding" config value. 2008-10-16 19:21:06 +00:00
Georg Brandl
d7e2a48555 Add "source-read" event. 2008-10-16 19:04:45 +00:00
Georg Brandl
869df5123b Add cmember role (#3875). 2008-09-24 17:09:48 +00:00
Georg Brandl
47ce40c492 #16: allow referring to figures without explicit text. 2008-09-24 15:36:34 +00:00
Georg Brandl
246a7a09b6 Add _() to some english strings. 2008-09-11 22:08:29 +00:00
Georg Brandl
94bd56e4e4 Some pylint-found fixes and cleanups. 2008-09-06 17:34:35 +00:00
Georg Brandl
e6a6087335 Use alternate method of removing node from doctree which 
doesn't raise assertion errors. :)
 2008-08-15 19:16:20 +00:00
Georg Brandl
742821d6e0 Simplify index entry handling. 2008-08-11 08:40:12 +00:00
Georg Brandl
74d52b40bc Add exclude_dirnames value. 2008-08-10 17:21:08 +00:00
Georg Brandl
b3f1de1bf7 New config value "keep_warnings", default is to discard the from the saved doctrees. 2008-08-10 17:10:31 +00:00
Georg Brandl
e93af0e57c Merged revisions 65566-65567,65623,65625 via svnmerge from 
svn+ssh://pythondev@svn.python.org/doctools/branches/0.4.x

........
  r65566 | georg.brandl | 2008-08-07 09:11:11 +0000 (Thu, 07 Aug 2008) | 2 lines

  Clarification for the ref role.
........
  r65567 | georg.brandl | 2008-08-07 09:11:25 +0000 (Thu, 07 Aug 2008) | 2 lines

  Rebuild everything if extensions change.
........
  r65623 | georg.brandl | 2008-08-10 11:18:42 +0000 (Sun, 10 Aug 2008) | 2 lines

  Unify handling of LaTeX escaping, and add some more replacements.
........
  r65625 | georg.brandl | 2008-08-10 11:25:41 +0000 (Sun, 10 Aug 2008) | 2 lines

  Make tex escapes a module.
........
 2008-08-10 16:59:27 +00:00
Georg Brandl
74d36acbf7 * Add more generated text to the automatic translation. 
* Remove all locale-dependent text from sphinx.sty, put it into Python files
  to enable message extraction and translation.
* Use babel in the LaTeX output.
* Centralize locations for labels used in every builder.
 2008-08-10 10:00:20 +00:00
Georg Brandl
a7cfb52ab6 Add i18n support, thanks to Horst Gutmann. 2008-08-08 10:54:00 +00:00
Georg Brandl
432115123e Merged revisions 65529 via svnmerge from 
svn+ssh://pythondev@svn.python.org/doctools/branches/0.4.x

........
  r65529 | georg.brandl | 2008-08-04 22:19:30 +0000 (Mon, 04 Aug 2008) | 6 lines

  Revert r65499 which was not well thought out. Instead, put
  the whole build dir in exclude_trees by default in quickstart.

  Also, revisit application cleanup and make it consistently use
  less setup time while still trying to leave to traces.
........
 2008-08-04 22:20:44 +00:00
Georg Brandl
b4f71aa642 Merged revisions 65283,65303,65316-65317,65372-65375,65377,65380,65483-65485,65494 via svnmerge from 
svn+ssh://pythondev@svn.python.org/doctools/branches/0.4.x

........
  r65283 | georg.brandl | 2008-07-29 10:07:26 +0000 (Tue, 29 Jul 2008) | 2 lines

  Update ez_setup.py.
........
  r65303 | benjamin.peterson | 2008-07-30 12:35:34 +0000 (Wed, 30 Jul 2008) | 1 line

  add a with_testapp decorator for test functions that passes the TestApp instance in a cleans up after it
........
  r65316 | benjamin.peterson | 2008-07-30 23:12:07 +0000 (Wed, 30 Jul 2008) | 1 line

  make the app for test_markup global to the module
........
  r65317 | benjamin.peterson | 2008-07-30 23:31:29 +0000 (Wed, 30 Jul 2008) | 1 line

  make TestApp.cleanup more aggressive
........
  r65372 | georg.brandl | 2008-08-01 19:11:22 +0000 (Fri, 01 Aug 2008) | 2 lines

  Add more tests, fix a few bugs in image handling.
........
  r65373 | georg.brandl | 2008-08-01 19:28:33 +0000 (Fri, 01 Aug 2008) | 2 lines

  Fix oversight.
........
  r65374 | benjamin.peterson | 2008-08-01 19:36:32 +0000 (Fri, 01 Aug 2008) | 1 line

  fix one broken test
........
  r65375 | georg.brandl | 2008-08-01 19:41:11 +0000 (Fri, 01 Aug 2008) | 2 lines

  Fix the handling of non-ASCII input in quickstart.
........
  r65377 | georg.brandl | 2008-08-01 19:48:24 +0000 (Fri, 01 Aug 2008) | 2 lines

  Allow REs in markup checks.
........
  r65380 | georg.brandl | 2008-08-01 20:31:18 +0000 (Fri, 01 Aug 2008) | 2 lines

  Don't rely on mtimes being different for changed files.
........
  r65483 | georg.brandl | 2008-08-04 09:01:40 +0000 (Mon, 04 Aug 2008) | 4 lines

  Add an "encoding" option to literalinclude.

  Add tests for include directives.
........
  r65484 | georg.brandl | 2008-08-04 09:11:17 +0000 (Mon, 04 Aug 2008) | 2 lines

  Add changelog entry.
........
  r65485 | georg.brandl | 2008-08-04 09:21:58 +0000 (Mon, 04 Aug 2008) | 2 lines

  Fix markup.
........
  r65494 | georg.brandl | 2008-08-04 16:34:59 +0000 (Mon, 04 Aug 2008) | 2 lines

  Correctly use HTML file suffix in templates.
........
 2008-08-04 17:01:15 +00:00
Georg Brandl
97558dcc06 Add "env-updated" and "missing-reference" events. 
Write inventory file as part of the HTML build.
 2008-08-04 09:54:45 +00:00
Georg Brandl
6c2f991be0 Merged revisions 65138,65145-65146,65268-65273 via svnmerge from 
svn+ssh://pythondev@svn.python.org/doctools/branches/0.4.x

........
  r65138 | georg.brandl | 2008-07-19 15:42:35 +0200 (Sat, 19 Jul 2008) | 2 lines

  #3416: fix missing parameter.
........
  r65145 | georg.brandl | 2008-07-19 20:01:25 +0200 (Sat, 19 Jul 2008) | 2 lines

  Now that we don't ship Jinja anymore by default the comment can go.
........
  r65146 | georg.brandl | 2008-07-19 20:01:51 +0200 (Sat, 19 Jul 2008) | 2 lines

  Reread documents with globbed toctrees when files are removed/added.
........
  r65268 | georg.brandl | 2008-07-29 10:21:33 +0200 (Tue, 29 Jul 2008) | 2 lines

  Fix by Markus Gritsch to place correct links to headings.
........
  r65269 | georg.brandl | 2008-07-29 10:21:59 +0200 (Tue, 29 Jul 2008) | 2 lines

  Make the writer's settings public.
........
  r65270 | georg.brandl | 2008-07-29 10:22:28 +0200 (Tue, 29 Jul 2008) | 2 lines

  Export test_root.
........
  r65271 | georg.brandl | 2008-07-29 10:22:47 +0200 (Tue, 29 Jul 2008) | 2 lines

  Add a markup test.
........
  r65272 | georg.brandl | 2008-07-29 10:27:19 +0200 (Tue, 29 Jul 2008) | 2 lines

  Bump version number.
........
  r65273 | georg.brandl | 2008-07-29 11:05:37 +0200 (Tue, 29 Jul 2008) | 2 lines

  Correct rendering of ``samp``.
........
 2008-07-29 09:07:37 +00:00
Georg Brandl
ae2570c269 Merged revisions 64808,65013,65076,65100-65101,65119,65121-65123 via svnmerge from 
svn+ssh://pythondev@svn.python.org/doctools/branches/0.4.x

........
  r64808 | georg.brandl | 2008-07-08 21:39:33 +0200 (Tue, 08 Jul 2008) | 2 lines

  Allow relocation of source and doctree dir.
........
  r65013 | georg.brandl | 2008-07-16 15:25:30 +0200 (Wed, 16 Jul 2008) | 2 lines

  Remove curious quote.
........
  r65076 | georg.brandl | 2008-07-17 22:43:01 +0200 (Thu, 17 Jul 2008) | 2 lines

  Add a test for sphinx.quickstart.
........
  r65100 | georg.brandl | 2008-07-18 14:41:54 +0200 (Fri, 18 Jul 2008) | 2 lines

  Fix phony targets.
........
  r65101 | georg.brandl | 2008-07-18 14:55:03 +0200 (Fri, 18 Jul 2008) | 2 lines

  Fix problems in "make check".
........
  r65119 | georg.brandl | 2008-07-18 23:06:42 +0200 (Fri, 18 Jul 2008) | 2 lines

  Emit a more precise error message in autodoc.
........
  r65121 | georg.brandl | 2008-07-18 23:41:35 +0200 (Fri, 18 Jul 2008) | 2 lines

  Warn if a toctree-included document doesn't contain a title.
........
  r65122 | georg.brandl | 2008-07-18 23:51:28 +0200 (Fri, 18 Jul 2008) | 2 lines

  Don't use \samp{} for code with whitespaces, only for :samp:`code`.
........
  r65123 | georg.brandl | 2008-07-19 00:49:46 +0200 (Sat, 19 Jul 2008) | 2 lines

  Put inheritance info always on its own line.
........
 2008-07-18 22:55:36 +00:00
Georg Brandl
17e7e61778 Merged revisions 64703-64708,64710-64712 via svnmerge from 
svn+ssh://pythondev@svn.python.org/doctools/branches/0.4.x

........
  r64703 | georg.brandl | 2008-07-04 19:24:00 +0200 (Fri, 04 Jul 2008) | 2 lines

  Fix linkcheck builder crash for malformed URLs.
........
  r64704 | georg.brandl | 2008-07-04 19:32:40 +0200 (Fri, 04 Jul 2008) | 2 lines

  Add 0.5 compatibility for more admonitions.
........
  r64705 | georg.brandl | 2008-07-04 19:38:37 +0200 (Fri, 04 Jul 2008) | 2 lines

  Remove silly "rubric" restriction in latex writer.
........
  r64706 | georg.brandl | 2008-07-04 19:41:44 +0200 (Fri, 04 Jul 2008) | 2 lines

  Document rubric:: Footnotes behavior.
........
  r64707 | georg.brandl | 2008-07-04 19:45:28 +0200 (Fri, 04 Jul 2008) | 2 lines

  Fix XHTML.
........
  r64708 | georg.brandl | 2008-07-04 19:50:56 +0200 (Fri, 04 Jul 2008) | 2 lines

  More XHTML fixes.
........
  r64710 | georg.brandl | 2008-07-04 19:59:56 +0200 (Fri, 04 Jul 2008) | 2 lines

  Copy the html_logo to the output static dir.
........
  r64711 | georg.brandl | 2008-07-04 20:37:43 +0200 (Fri, 04 Jul 2008) | 2 lines

  Fix latex code for module names with underscores that have platforms.
........
  r64712 | georg.brandl | 2008-07-04 20:46:40 +0200 (Fri, 04 Jul 2008) | 2 lines

  Fix a crash with nonlocal image URIs.
........
 2008-07-04 18:49:39 +00:00
Georg Brandl
c1bedfc105 Add general docstring processing support with a new event in autodoc. 2008-06-22 21:02:50 +00:00
Georg Brandl
326ca06e1b Fix image handling. 2008-06-18 10:06:22 +00:00
Georg Brandl
b2eb896d7e Increment env version after the image handling change. 2008-06-17 10:22:04 +00:00
Georg Brandl
7d4ce97ec3 Add default_role configuration value. 2008-06-17 10:06:37 +00:00
Georg Brandl
b05861454c Add image format handling. 2008-06-15 14:31:16 +00:00
Georg Brandl
d67511466d #3096: sort "unused" warnings by docname. 2008-06-12 21:57:31 +00:00
Georg Brandl
bd4166c2d6 Add maxdepth for TOCs. 2008-06-12 21:56:06 +00:00
Georg Brandl
e8bb912a9c Factor out toctree resolution and add an option to ignore 
sublevel document headings.
 2008-06-12 21:48:27 +00:00
Armin Ronacher
70a54d2264 env is set now to nodes after unpickling. 2008-06-08 18:17:20 +00:00
Georg Brandl
f4d5c0a380 Add a test suite skeleton, a first test for sphinx.config, and fix a bug in config. 2008-06-05 08:58:43 +00:00
Georg Brandl
7e80f60412 Fix the handling of extensions' config values. 2008-06-04 20:25:27 +00:00
Georg Brandl
a5523402eb Add a preliminary text writer, mainly for producing pydoc-compatible topic help. 2008-06-01 15:27:16 +00:00
Georg Brandl
869552d616 Refer to a RFC base URL that actually works. 2008-05-31 22:54:10 +00:00
Georg Brandl
c7110a4199 More logical "next"/"previous" links. 2008-05-31 22:52:42 +00:00
Georg Brandl
5eaf2eb29a Add exclude_trees config value. 2008-05-24 16:28:06 +00:00
Georg Brandl
407a0c47c1 Some pylint nits. 2008-05-04 16:17:31 +00:00
Georg Brandl
7ad49d5756 Add exclude_dirs config value. 2008-05-02 09:15:59 +00:00
Georg Brandl
ea5f9d7de7 Allow any master document structure when writing the HTML help contents file. 2008-05-02 09:00:09 +00:00
Georg Brandl
b2aedf951d Ignore classes in conf.py. 2008-04-22 17:41:12 +00:00
Georg Brandl
be080234bb Support Sphinx.add_transform(). 2008-04-13 08:20:11 +00:00
Georg Brandl
ea2f87fc03 Allow the config to act as an extension. 2008-04-06 17:38:55 +00:00
Georg Brandl
b016896c1c Don't swallow toc entries when resolving subtrees. 2008-04-06 16:47:28 +00:00
Georg Brandl
9fb011bd2a Fix the case where a toctree doesn't contain anything. 2008-04-06 13:32:15 +00:00
Georg Brandl
b8369b5c81 Allow new titles in the toctree. 2008-03-30 06:36:20 +00:00
Georg Brandl
8057b0f80e Rebuild all HTML files in case of a template change. 
Also, record image docnames in order to be able to delete image records from the env.
 2008-03-25 15:22:25 +00:00
Georg Brandl
ba47f283f6 Support the image directive. 2008-03-25 12:32:03 +00:00
Georg Brandl
6433cca6a8 Record deps from autodoc. 2008-03-25 10:31:13 +00:00
Georg Brandl
55aacf998a Handle errors more gracefully. 2008-03-25 10:20:09 +00:00
Georg Brandl
10e231bf12 Add a dependency system for handling .. include, .. literalinclude 
and later .. image dependencies.
 2008-03-25 10:16:51 +00:00
Georg Brandl
93d39ac065 Don't error out on reading an empty file. 2008-03-24 09:42:28 +00:00
Georg Brandl
0de9d7db7a Don't try to build copied sources if source suffix is .txt. 2008-03-23 18:26:24 +00:00
Georg Brandl
fb3fa0708b Bump ENV_VERSION after introduction of CodeBlocksHandler. 2008-03-23 06:36:08 +00:00
Georg Brandl
e77d39cb0b Remove leftover code that does not work. 2008-03-23 06:33:04 +00:00
Georg Brandl
b82b162729 * sphinx.ext.doctest: Replace <BLANKLINE> in doctest blocks by 
real blank lines for presentation output.
* sphinx.environment: Move doctest_blocks out of block_quotes to
  support indented doctest blocks.
 2008-03-22 21:10:35 +00:00
Georg Brandl
637b1379bc Fix a few overlong lines, and use \t instead of literal tabs. 2008-03-21 15:27:21 +00:00
Georg Brandl
5d253d4293 Don't warn for unknown keywords. Give Python refs a link title. 2008-03-16 11:10:03 +00:00
Georg Brandl
910e488e39 * Allow registering arbitrary cross-referencing directives/roles. 
* Allow labels anywhere, and allow giving an explicit caption in :ref: links.
* Some fixes to the sphinxdoc style.
* Add an option to show author information in the output.
* Search user-defined templates in the order they occur in the config
  (thanks Nick).
 2008-03-09 18:18:41 +00:00
Georg Brandl
a95a40c748 Add some labels by default; create a master doc in quickstart. 2008-03-08 21:23:54 +00:00
Georg Brandl
8dc8280c3c Ignore nonexisting config settings. 2008-02-10 10:59:05 +00:00
Georg Brandl
a1e379d46c Add setup.py, add quickstart script. 2008-02-09 23:09:36 +00:00
Georg Brandl
b2ec05e690 More refactoring, this time allowing different file extensions 
and a different master file. Also fix environment warning reporting
and improve handling of error conditions.
 2008-02-01 20:44:17 +00:00
Georg Brandl
4f7a8f3f96 More refactoring: 
* Move refcounting into an addon module.
* Rename the extension manager to Application and use it throughout.
* Fix some bugs found by pylint.
* Add "ifconfig" addon.
 2008-01-27 20:23:25 +00:00
Georg Brandl
923987c0e1 Bump env version because of new config class. 2008-01-21 22:36:32 +00:00
Georg Brandl
50da49fab4 Further refactorings, add extensibility API. 2008-01-21 20:20:37 +00:00
Georg Brandl
b09e628b0f A few refactorings in Sphinx. 2008-01-16 20:27:25 +00:00
Georg Brandl
db0bbcb136 Update copyright years and change license to BSD. 2008-01-11 14:18:19 +00:00
Georg Brandl
350143494d Checkin my holiday work: 
- Add "changes" builder to quickly get an overview over all "versionadded/changed/deprecated" directives for a certain version
- Cross-reference keywords
- Fix some problems in the webapp and the latex writer
 2007-12-29 10:58:10 +00:00
Georg Brandl
e77b466281 Further fixes. All produced latex documents now run through pdflatex without errors. 2007-12-16 23:14:24 +00:00
Georg Brandl
fbe9ed59cb Several improvements to the latex builder. 2007-12-16 19:36:23 +00:00
Georg Brandl
d6deb877df Implement index entries, production lists and the glossary. 2007-12-16 12:20:41 +00:00
Georg Brandl
ef49fadf8c - rename webify/unwebify to canonical/os_path 
- build all documents correctly, including howtos
- pack ACKS content into an .. acks directive, to
  make it possible to render it into a comma-separated
  list in latex
 2007-12-07 20:27:52 +00:00
Georg Brandl
3d74adea25 Add beginnings of a LaTeX writer. This is in no way usable code yet. 2007-12-05 21:11:36 +00:00
Georg Brandl
cfa8045490 Apply Tim Golden's patch from #1520, which resolves confusion between 
file paths and relative URIs so that building on Windows is flawlessly
possible.
 2007-12-03 22:38:25 +00:00
Georg Brandl
50e7330d4a Add nucular as a possible full text indexer. 2007-11-01 09:53:26 +00:00
Georg Brandl
da8a4264ed Add an envvar directive too. Link from :envvar: and :option: to the relevant directives. 2007-10-20 17:50:45 +00:00
Georg Brandl
2ca4b5a9b0 Fix wrong invalidation of parent files. 2007-09-06 15:02:32 +00:00
Georg Brandl
32aa42f067 Fix index subitem generation. 2007-08-31 08:47:16 +00:00
Georg Brandl
12cfdea91f Add glossary directive and :term: role for crossreferencing into the glossary. 2007-08-17 06:27:35 +00:00
Brett Cannon
aeb2e1e3bc Fix bug where a default tuple did not have enough value to unpack. 2007-08-16 01:50:19 +00:00
Georg Brandl
d302c52646 Add a way to mark deprecated modules, and show this information in the module index. 
Also, generate a useful "title" attribute for module crossreferences.
 2007-08-15 18:42:00 +00:00
Georg Brandl
11cab438b8 Allow a leading dot in x-reference roles, marking reversed search order for targets. 2007-08-15 18:05:01 +00:00
Georg Brandl
3bdaa933d7 List added files separately. 2007-08-14 09:57:25 +00:00
Georg Brandl
79f1a1eecb Add module names even to names in classes. Add a config option for that. 
Add a :samp: role for highlighting text inside literal code.
Fix the time module docs.
 2007-08-06 10:49:52 +00:00
Georg Brandl
6ea0df4f60 Disable enumerated lists introduced by alphabetic or roman numerals. 2007-08-03 08:15:50 +00:00
Georg Brandl
d60ca8d49d Initial import of the doc tools. 2007-07-23 09:02:25 +00:00