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
15,508 Commits 2 Branches 219 Tags 163 MiB
ec3754bd94
Commit Graph

398 Commits

Author SHA1 Message Date
Takeshi KOMIYA
b0b3f5a677 deprecate PyClassmember class 2019-04-07 22:41:10 +09:00
Takeshi KOMIYA
df05d9254d Merge branch '2.0' 2019-04-07 19:29:52 +09:00
Takeshi KOMIYA
9e2aba54d3 Make EventManager portable 
So far, we need to bypass application object for modules to emit
a event.  This make EventManager portable and easy to pass event
emitter.  This brings modules less coupled with application object.
 2019-04-06 15:36:50 +09:00
Takeshi KOMIYA
452e5dcf21 Deprecate StandardDomain.process_*() 2019-04-06 14:14:18 +09:00
Takeshi KOMIYA
885d35e374 Add CitationDomain for citation processing 2019-03-30 23:12:08 +09:00
Takeshi KOMIYA
87c6335b46 Move transforms for citations to sphinx.domains.citation 2019-03-30 20:31:10 +09:00
Takeshi KOMIYA
61098a0ae2 Drop features and APIs deprecated in 1.8 2019-03-30 14:50:37 +09:00
Takeshi KOMIYA
a990f9ff72 Add ObjectDescription.get_field_type_map() 
Conceal caching mechanism of Field classes to ObjectDescription class.
This deprecates DocFieldTransformer.preprocess_field_types().
 2019-03-23 17:27:22 +09:00
Takeshi KOMIYA
86d5d2113e Deprecate imports for compatibility 2019-03-17 18:30:50 +09:00
Takeshi KOMIYA
b5959ca230
Add SphinxPostTransform class (#6154) 
* Add SphinxPostTransform

* Apply SphinxPostTransform to latex transforms
 2019-03-17 18:27:00 +09:00
Takeshi KOMIYA
2606002bb4
Merge pull request #6125 from tk0miya/doc-enhance_extension_dev_i18n 
doc: Enhance documentation about internalization of external extension (refs: #5991)
 2019-03-10 01:16:06 +09:00
Takeshi KOMIYA
d4ac7217a8 Move list of deprecated API to extdev/deprecated.rst 2019-03-09 19:32:24 +09:00
Takeshi KOMIYA
4ca5924d49
Merge pull request #6129 from tk0miya/refactor_util.nodes 
Refactor util.nodes
 2019-03-07 01:20:06 +09:00
Takeshi KOMIYA
259c2bb8a6 refactor: Rename find_source_node() to get_node_source() 2019-03-03 14:42:23 +09:00
Takeshi KOMIYA
b3b5a595a9 docs: Update docs for i18n 2019-03-02 19:45:42 +09:00
Takeshi KOMIYA
4b15b6659f Move ext-i18n section to extdev/i18n.rst 2019-03-02 19:04:24 +09:00
Takeshi KOMIYA
ea1eec75dc Merge branch 'master' into doc-enhance_extension_dev_i18n 2019-03-02 19:00:25 +09:00
Takeshi KOMIYA
0d7bc86e7b refactor: move NoUri to sphinx.errors 2019-03-02 16:21:44 +09:00
Takeshi KOMIYA
8d0d75fea7
Merge pull request #6110 from tk0miya/refactor_catalog 
Refactor catalog detection and compilation
 2019-02-27 23:36:14 +09:00
Takeshi KOMIYA
fb8838ee53 refactor: Use CatalogRepository instead of find_catalog_source_file() 2019-02-27 22:47:08 +09:00
Takeshi KOMIYA
5f8f902b63 Rename find_catalog() to docname_to_domain() 2019-02-27 21:44:16 +09:00
Takeshi KOMIYA
af51e9825a refactor: Move implementation of mock to sphinx.ext.autodoc.mock 2019-02-27 21:42:23 +09:00
Takeshi KOMIYA
19b52c6eaa Replace :autolink: roles by class based implementation 2019-02-27 16:02:49 +09:00
Takeshi KOMIYA
1ca210aab1 Separate json and pickle to sphinxcontrib package 2019-02-17 22:31:50 +09:00
Takeshi KOMIYA
3ec032fa39 Replace :file: and :samp: roles by class based implementation 2019-02-16 12:37:46 +09:00
Takeshi KOMIYA
ea4d8ca08d Replace :guilabel: and :menuselection: roles by class based implementation 2019-02-16 02:30:28 +09:00
Takeshi KOMIYA
065ece6f4c docs: Add SphinxRole and ReferenceRole 2019-02-16 01:55:46 +09:00
Takeshi KOMIYA
9cb40436ed Replace :pep: and :rfc: roles by class based implementation 2019-02-16 00:34:24 +09:00
Takeshi KOMIYA
a6d345f95d Replace :index: role by class based implementation 2019-02-16 00:05:13 +09:00
Takeshi KOMIYA
3b49f9fe3d Separate htmlhelp to sphinxcontrib package 2019-02-15 01:44:32 +09:00
Takeshi KOMIYA
549a763195
Merge pull request #6025 from tk0miya/refactor_roles2 
Introduce SphinxRole class as a base class of roles
 2019-02-14 01:09:28 +09:00
Takeshi KOMIYA
2efc1065c0 Deprecate sphinx.util.pycompat:sys_encoding 2019-02-11 16:41:19 +09:00
Takeshi KOMIYA
b25deb259e refactor: Move NoneType to sphinx.util.typing 2019-02-11 16:41:19 +09:00
Takeshi KOMIYA
d40ce68c7b refactor: Move terminal_safe() to sphinx.util.console 2019-02-11 16:41:19 +09:00
Takeshi KOMIYA
ac70a4dd91 Replace :abbr: role by class based implementation 2019-02-06 01:20:58 +09:00
Takeshi KOMIYA
c4397318d3 Separate applehelp to sphinxcontrib package 2019-02-06 00:44:37 +09:00
Vincent Férotin
98fd02e262 doc: Enhance documentation about internalization of external extension. 2019-01-28 15:48:50 +01:00
Takeshi KOMIYA
2bd69350a7 Separate devhelp to sphinxcontrib package 2019-01-20 03:03:50 +09:00
Takeshi KOMIYA
6be9d2a08e Separate qthelp to sphinxcontrib package 2019-01-19 16:34:06 +09:00
Takeshi KOMIYA
20bf74c637 Separate jsmath to sphinxcontrib package 2019-01-13 14:07:12 +09:00
Takeshi KOMIYA
6429c9e23c
Merge branch 'master' into refactor_singlehtml 2019-01-12 21:17:16 +09:00
Takeshi KOMIYA
8b6acc05c4
Merge pull request #5909 from tk0miya/refactor_epub2 
refactor: Convert Epub3Builder.validate_config_values() to a function
 2019-01-12 18:22:00 +09:00
Takeshi KOMIYA
354e765eef refactor: Convert Epub3Builder.validate_config_values() to a function 2019-01-12 18:05:28 +09:00
Takeshi KOMIYA
b08a7c4757 Move SingleFileHTMLBuilder to sphinx.builders.singlehtml package 2019-01-11 01:59:56 +09:00
Takeshi KOMIYA
e82f5ddb55 The arguments of Epub3Builder.build_navigation_doc() is deprecated. 2019-01-09 00:10:36 +09:00
Takeshi KOMIYA
b6c422ac86 The arguments of EpubBuilder.build_epub() is deprecated. 2019-01-09 00:10:36 +09:00
Takeshi KOMIYA
64533e142c The arguments of EpubBuilder.build_toc() is deprecated. 2019-01-09 00:10:36 +09:00
Takeshi KOMIYA
d437f39bc4 The arguments of EpubBuilder.build_content() is deprecated. 2019-01-09 00:10:36 +09:00
Takeshi KOMIYA
f000df8bfb The arguments of EpubBuilder.build_container() is deprecated. 2019-01-09 00:10:36 +09:00
Takeshi KOMIYA
0f972e8bbf The arguments of EpubBuilder.build_mimetype() is deprecated 2019-01-09 00:10:36 +09:00
Takeshi KOMIYA
39c0380c4d refactor: deprecate some pycompat functions 2019-01-07 22:54:37 +09:00
Takeshi KOMIYA
353c3e9fd6
Merge pull request #5415 from tk0miya/5410_replace_open_file_by_open 
refactor: Repalce HTMLHelpBuilder.open_file() by standard open()
 2019-01-07 00:59:03 +09:00
Takeshi KOMIYA
56f4b27faa Deprecate LaTeXTranslator.generate_numfig_format() 2019-01-04 23:06:34 +09:00
Takeshi KOMIYA
45d04703fe latex: Move ExtBabel to sphinx.builders.latex.util package 2019-01-04 23:06:34 +09:00
Takeshi KOMIYA
3c7b4e77e0 refactor: Repalce HTMLHelpBuilder.open_file() by standard open() 2019-01-03 02:05:32 +09:00
jfbu
b62bf0e0fc Redo spelling fix lost in merge (contents moved to other file) 
modified:   doc/extdev/index.rst
 2018-12-28 16:03:26 +01:00
jfbu
32d57b8637 Merge branch '1.8' 
resolved Conflicts:
	doc/development/tutorials/todo.rst
	sphinx/locale/__init__.py
	sphinx/search/zh.py
 2018-12-28 12:50:20 +01:00
jfbu
1e07cb10fc Fix various spelling typos 2018-12-27 13:06:33 +01:00
Takeshi KOMIYA
55a89196e4
Merge pull request #5678 from ArtFlag/docs/extension-tutorials 
Docs: Extension tutorial portal + helloworld example
 2018-12-23 22:55:24 +09:00
ArtFlag
35b62e21c9 Move content from the todo tutorial to the extdev/index 2018-12-22 11:38:12 +01:00
jfbu
f8389f5181 [DOC] Make link to list of deprecated APIs in CHANGES an internal link 2018-12-20 21:18:37 +01:00
Takeshi KOMIYA
6fe57436a8
Merge pull request #5839 from jdufresne/description 
Deprecate unused Exception attributes
 2018-12-20 10:15:06 +09:00
ArtFlag
870e2bbc1c move files to new directory 2018-12-19 17:35:17 +01:00
Takeshi KOMIYA
d0f5862597 Replace EnvironmentError and IOError by OSError 
Since python 3.3, EnvironmentError and IOError were merged into
OSError.
 2018-12-19 19:26:50 +09:00
Jon Dufresne
e9eaf41a58 Deprecate unused Exception attributes 
The attributes were used only for the string representation, but that is
also the default behavior of the Exception class. Observe:

>>> str(Exception('foo'))
'foo'
>>> print(Exception('foo'))
foo
 2018-12-18 18:32:16 -08:00
Takeshi KOMIYA
9574607578
Merge pull request #5827 from tk0miya/refactor_io3 
Refactor sphinx.io
 2018-12-18 23:28:50 +09:00
Jon Dufresne
43ff640b58 Deprecate quickstart.term_decode() and remove internal uses 
Per the Python 3 docs, input() always returns a string:

https://docs.python.org/3/library/functions.html#input

> The function then reads a line from input, converts it to a
> string (stripping a trailing newline), and returns that.

The stubs from typeshed say the same:

5c69373890/stdlib/3/builtins.pyi (L835)

Here is the implementation from CPython with also shows a call to
PyUnicode_Decode on the result:

https://github.com/python/cpython/blob/3.7/Python/bltinmodule.c#L1960-L2143

As the value is always a string, there is nothing to decode. Therefore
the call to term_decode() unnecessary and can safely be removed.

With this in mind, must adjust quickstart tests to be more
representative.
 2018-12-17 06:44:17 -08:00
Takeshi KOMIYA
f3350b8b7d Deprecate SphinxFileInput.supported 2018-12-17 22:26:29 +09:00
Takeshi KOMIYA
636ca67528 Deprecate SphinxBaseFileInput 2018-12-17 22:08:00 +09:00
Takeshi KOMIYA
de49b991f6 refactor: Use simple Input class 2018-12-17 22:07:56 +09:00
Takeshi KOMIYA
71a7ce1453
Merge branch 'master' into string-classes 2018-12-17 18:58:32 +09:00
Jon Dufresne
c4baa7234e Deprecate the old IndexBuilder.feed() method signature 
The method signature changed in commit
d27386cc95 (Jun 8, 2016).
 2018-12-16 13:52:56 -08:00
Jon Dufresne
80861d105b Deprecate sphinx.config.string_classes; remove all internal uses 
With only a single text type across supported Python versions, the
string_classes is no longer necessary.

Internally, all uses were converted to the value `[str]`. For
.add_config_value() uses that also supply a default string, the type is
inferred.
 2018-12-16 11:35:06 -08:00
Takeshi KOMIYA
6461ea233b
Merge pull request #5793 from tk0miya/pretty_changes 
Pretty changes
 2018-12-16 23:13:37 +09:00
Takeshi KOMIYA
1bf9a7eac5 Deprecate LaTeXTranslator.collect_footnotes() 2018-12-16 21:52:30 +09:00
Takeshi KOMIYA
cdb36fbbf6 Sort deprecated APIs by version 2018-12-16 21:51:33 +09:00
Takeshi KOMIYA
048cfb5e0a Deprecate UnicodeMixin 2018-12-16 21:51:18 +09:00
Jon Dufresne
49d3a3c0c1 Replace ENOENT errno checks with Python 3 FileNotFoundError 
The error is more specific and self documenting.

This removes the last use of sphinx.util.osutil.ENOENT, so it is now
deprecated for removal. sphinx.util.osutil.EEXIST was already unused so
that is deprecated as well.
 2018-12-15 09:02:55 -08:00
Takeshi KOMIYA
6b24c069c3 Deprecate sphinx.util.inspect.Parameter 2018-12-15 21:44:17 +09:00
Takeshi KOMIYA
08bc847964 Deprecate abbreviation node (refs: #5720) 2018-12-15 20:13:04 +09:00
Takeshi KOMIYA
d898da697d Refactor Autosummary directive by DocumenterBridge 2018-12-10 22:36:44 +09:00
Jon Dufresne
3a96ce6591 Deprecate unused and untested sphinx.util functions 
sphinx.util.attrdict: Last use removed in
b09e628b0f.

sphinx.util.PeekableIterator: Last use removed in
85b8a451a6.
 2018-12-09 14:54:50 -08:00
Takeshi KOMIYA
c8ce761a73 deprecate SphinxRSTFileInput 2018-12-05 23:11:16 +09:00
Takeshi KOMIYA
1a50d34520 refactor `mock()` to based on PEP-451 implementation 2018-12-04 23:57:01 +09:00
Takeshi KOMIYA
b837a5aec0 refactor TexinfoTranslator; Replace _make_visit_admonition() 2018-12-04 01:40:15 +09:00
Takeshi KOMIYA
f5b7d24003 refactor LaTeXTranslator; Replace _make_visit_admonition() 2018-12-04 01:40:14 +09:00
Takeshi KOMIYA
97615beda2 refactor TextTranslator; Replace _make_depart_admonition() 2018-12-04 01:40:14 +09:00
Arthur
adc1d2b59d
Merge branch 'master' into docs/extension-tutorials 2018-11-30 10:33:20 +01:00
Takeshi KOMIYA
f7317651a1 Refactor sphinx.search 2018-11-30 18:03:20 +09:00
ArtFlag
8479876798 Add a helloworld tutorial 2018-11-29 00:14:31 +01:00
ArtFlag
83e9e1378c Create a tutorial portal 2018-11-28 17:27:12 +01:00
Jon Dufresne
555960d668 Deprecate and drop internal use of force_decode() 
In the Python 3 only code base, this function is no longer necessary.
The type of values is well understood and deliberate. Code should avoid
arbitrary mixing of bytes & str.

By removing force_decode() calls from docstring values, can deprecate
the now unused 'encoding' arguments to various autodoc methods.
 2018-11-13 07:16:39 -08:00
Jon Dufresne
6fbf4a2f99 Deprecate sphinx.util.pycompat.u 
It is now simply a constant equal to the empty string. Provides no
further utility.
 2018-11-12 16:31:27 -08:00
Jon Dufresne
27a6787d63 Remove use of six.binary_type 
Remove type checks for cases that don't apply to Python 3.

For remaining uses, use bytes instead
 2018-11-11 19:09:47 -08:00
Takeshi KOMIYA
dcc4ac55bb latex: Move \pageautorefname to sphinxmessages.sty 2018-11-01 22:47:15 +09:00
Takeshi KOMIYA
ca8bc8ca49 refactor: Deprecate app._setting_up_extension 2018-10-17 11:56:11 +09:00
Takeshi KOMIYA
4ed5c51cff logging: Add prefixed_warnings() helper 2018-10-17 11:21:22 +09:00
Takeshi KOMIYA
491d0406df Deprecate get_matching_docs() 2018-10-16 10:34:59 +09:00
Takeshi KOMIYA
eaec3bd916 Add sphinx.project; a manipulator for project and documents 2018-10-16 10:34:58 +09:00
Takeshi KOMIYA
e7e07fd697 Merge branch '1.8' 2018-10-16 09:57:54 +09:00
Jon Dufresne
05ac246eff Deprecate Python2 compat shim sphinx.util.osutil.walk() 
Code should use os.walk() instead, which works with either str or bytes.
All internal calls use str.
 2018-10-05 12:39:50 -07:00
Takeshi KOMIYA
0e4c23fc35 Deprecate string style base for env.doc2path() 2018-09-22 23:22:11 +09:00
Takeshi KOMIYA
8bd2f921f9 Deprecate suffix for env.doc2path() 2018-09-22 23:21:34 +09:00
Takeshi KOMIYA
3a2418a827 refactoring: Drop PY2 and PY3 flags 2018-09-22 21:27:59 +09:00
jfbu
6f08c09ecb Improve Table of Deprecated APIs for LaTeX output (docs) 2018-09-22 11:44:04 +02:00
Takeshi KOMIYA
98648325aa Merge branch '1.8' 2018-09-22 17:16:24 +09:00
Takeshi KOMIYA
ae12f357c7 Fix #5463: mathbase: math_role and MathDirective was disappeared in 1.8.0 2018-09-21 23:44:11 +09:00
Takeshi KOMIYA
efdc95ef8b Merge branch '1.8' 2018-09-13 00:53:09 +09:00
Takeshi KOMIYA
b2b833d39e Update CHANGES for PR #5403 2018-09-10 20:45:16 +09:00
Takeshi KOMIYA
02afc357ef Merge branch '1.8' 2018-09-09 19:26:48 +09:00
Takeshi KOMIYA
8e729b419e Fix #5399: Sphinx crashes if unknown po file exists 2018-09-08 22:21:59 +09:00
Takeshi KOMIYA
a7cab001d9 Drop APIs deprecated in 2.0 2018-09-03 00:31:33 +09:00
Takeshi KOMIYA
864ded3d8a
Merge pull request #5343 from tk0miya/5340_update_docs 
docs: Fix wrong descriptions for logging APIs
 2018-08-26 11:30:51 +09:00
Takeshi KOMIYA
0a485740a8 docs: Fix wrong descriptions for logging APIs 2018-08-25 10:59:04 +09:00
Takeshi KOMIYA
328ff6eeae Fix i18n: warnings for translation catalogs have wrong line numbers 2018-08-22 21:01:50 +09:00
Takeshi KOMIYA
3d9e2cf831 Add autodoc_default_options 2018-08-18 18:22:16 +09:00
Takeshi KOMIYA
03d083e784 Move VersionChanges directive to sphinx.domains.changeset 2018-08-02 01:51:51 +09:00
Takeshi KOMIYA
25bfa1692a refactor: Move repository of changesets to domain from env 2018-08-02 01:51:50 +09:00
Takeshi KOMIYA
5fd62810b9
Merge pull request #5229 from tk0miya/refactor_latex2 
Check latex_elements at config-inited event
 2018-07-30 23:16:02 +09:00
Takeshi KOMIYA
5520969b39
Merge pull request #5228 from tk0miya/move_make_mode_to_sphinx.cmd 
Move make mode to sphinx.cmd
 2018-07-30 23:11:26 +09:00
Takeshi KOMIYA
90246b82b5 Check latex_elements at config-inited event 2018-07-29 22:43:13 +09:00
Takeshi KOMIYA
c8a66b73cf Update CHANGES 2018-07-29 22:24:56 +09:00
Takeshi KOMIYA
7218fe9dca Deprecate whole of sphinx.ext.mathbase 2018-07-29 12:32:46 +09:00
Takeshi KOMIYA
104bd42f51
Merge branch 'master' into refactor_highlighter 2018-07-29 11:21:36 +09:00
Takeshi KOMIYA
dd65d00f29 Implement math_renderer framework 2018-07-28 18:20:11 +09:00
Takeshi KOMIYA
f3019ee197 Apply :confval:trim_doctest_flags to all builders (cf. text, manpages) 2018-07-21 13:54:51 +09:00
Takeshi KOMIYA
4f296c5e67 Refactor: Run highlightlang on resolving phase 2018-07-21 13:54:09 +09:00
Takeshi KOMIYA
0c277f3ff0 `sphinx.highlighting.PygmentsBridge.unhighlight()` is deprecated 2018-07-21 01:50:23 +09:00
Matthias Geier
e1772bafda
DOC: Fix typo: add_source_parsers() -> add_source_parser() 2018-07-17 10:00:05 +02:00
Takeshi KOMIYA
d3cc565749
Merge branch 'master' into 4976_location_for_logger.info 2018-07-16 17:18:24 +09:00
Takeshi KOMIYA
910be1e2a2 Close #4976: `SphinxLoggerAdapter.info() now supports location` parameter 2018-06-26 01:02:37 +09:00
Daniel Hahler
8f94429a21 doc: fix func/meth references to Sphinx 2018-06-25 08:25:56 +02:00
Roy Wellington Ⅳ
d66e663f28 Fix minor typo of "them" 2018-06-13 11:25:21 -07:00
Jean-François B
95a8099913
Merge branch 'master' into latex_remove_shorthandoff_variable 2018-06-08 19:53:46 +02:00
jfbu
359854fa78 Postpone to 3.0 removal of ExtBabel.get_shorthandoff() 2018-06-07 18:29:24 +02:00
Takeshi KOMIYA
b914327317 Reorder deprecated APIs (app) 2018-06-08 00:51:00 +09:00
Takeshi KOMIYA
e081b1f154 Reorder deprecated APIs (env) 2018-06-08 00:51:00 +09:00
Takeshi KOMIYA
a2c4ed6614 Fix wrong module name in CHANGES 2018-06-08 00:51:00 +09:00
jfbu
b41b1dac5c Deprecate sphinx.writers.latex.ExtBabel.get_shorthandoff() 
This partially reverts d17f3955a5
 2018-06-06 19:16:14 +02:00
Takeshi KOMIYA
158d7d2fd3 docs: Fix location of attributes 2018-06-05 22:57:04 +09:00
Takeshi KOMIYA
72011465ad
Merge pull request #5020 from tk0miya/5018_update_docs 
Fix #5018: wrong signature of env-merge-info and env-check-consistency
 2018-05-29 01:25:46 +09:00
Takeshi KOMIYA
1deceda6da
Merge branch 'master' into 3606_load_mathjax_async 2018-05-28 23:04:13 +09:00
Takeshi KOMIYA
3c6be1b5b3
Merge pull request #5008 from tk0miya/refactor_latex2 
Refactor latex writer
 2018-05-28 22:59:40 +09:00
Takeshi KOMIYA
814abfd020 Fix #5018: wrong signature of env-merge-info and env-check-consistency 2018-05-28 21:38:16 +09:00
Takeshi KOMIYA
f3168d9894 Rename app.add_javascript() to add_js_file() 2018-05-24 23:59:49 +09:00
Takeshi KOMIYA
8fd34b88d3 add_javascript() allows keyword arguments as attributes for <script> tag 2018-05-24 23:59:49 +09:00
Takeshi KOMIYA
297ea8070f Update docs 2018-05-24 23:55:12 +09:00
Takeshi KOMIYA
c8e38fbe3e Refactor: Add DocumentTargetTransform to simplify LaTeX writer 2018-05-24 00:23:50 +09:00
Takeshi KOMIYA
489d86d470 Refactor: Add captioned_literal_block node to simplify LaTeX writer 2018-05-23 22:50:46 +09:00
Takeshi KOMIYA
e6c51bd535 refactor: Move math_reference node to sphinx.builders.latex.nodes 
The node is only used in latex builder.  So this makes it builder-
specific node.
 2018-05-20 15:13:59 +09:00