Takeshi KOMIYA
175a7e6212
Update CHANGES for PR #5924
2019-02-11 12:43:39 +09:00
Takeshi KOMIYA
7f7d34def7
Merge pull request #5924 from arxanas/githubpages-cname
...
githubpages: support custom domains
2019-02-11 12:41:57 +09:00
Takeshi KOMIYA
3442d1b5b6
Merge pull request #6050 from tk0miya/6046_invalid_latex_elements
...
Fix #6046 : LaTeX: ``TypeError`` is raised when invalid latex_elements given
2019-02-11 12:35:45 +09:00
Takeshi KOMIYA
ad517af81c
Merge branch 'master' into 5459_autodoc_default_options_accepts_True
2019-02-11 12:34:59 +09:00
Takeshi KOMIYA
11a398b1b0
Merge pull request #6052 from tk0miya/5394_meaningful_annotations_for_mock
...
Display meaningful names in type annotations for mocked objects
2019-02-11 12:32:45 +09:00
Waleed Khan
33c8b1d952
githubpages: support custom domains
...
Github Pages allows you to link a custom domain to your Github Pages
site by adding a `CNAME` file at the top-level of your `docs` directory.
The `githubpages` extension already inserts a `.nojekyll` file in the
`docs` directory, so it's a good place to add support for this `CNAME`
file as well.
2019-02-10 16:39:41 -08:00
Takeshi KOMIYA
8812131a57
Merge pull request #6022 from tk0miya/5196_linkcheck_should_check_remote_image
...
Close #5196 : linkcheck also checks remote images exist
2019-02-11 02:05:14 +09:00
Takeshi KOMIYA
b0148c6921
Closes #5459 : autodoc: autodoc_default_options accepts True as a value
2019-02-11 02:03:09 +09:00
Takeshi KOMIYA
0f6398efbb
Close #5394 : autodoc: Display readable names in type annotations for mocked objects
2019-02-11 01:48:21 +09:00
Takeshi KOMIYA
a6ef8190ce
Add testcase for mocked objects in autodoc
2019-02-11 01:46:38 +09:00
Takeshi KOMIYA
453ed5e29a
Merge branch 'master' into 5394_meaningful_annotations_for_mock
2019-02-11 01:38:26 +09:00
Takeshi KOMIYA
9ecf45e6ba
Fix #6026 : LaTeX: A cross reference to definition list does not work
2019-02-11 00:06:58 +09:00
Takeshi KOMIYA
3a237f7f4d
Merge pull request #6017 from tk0miya/4550_align_figures_to_center
...
Close #4550 : All tables and figures without ``align`` option are displayed to center
2019-02-10 20:54:24 +09:00
Takeshi KOMIYA
7aaae7760a
Merge pull request #6023 from tk0miya/refactor_htmlhelp
...
Refactor htmlhelp builder
2019-02-10 20:50:10 +09:00
Takeshi KOMIYA
2f7e27810b
Fix #6046 : LaTeX: `TypeError
` is raised when invalid latex_elements given
2019-02-10 19:47:41 +09:00
Stephen Finucane
b1ebdcd3c6
doc: Add "recipe" tutorial
...
This is based on a post from opensource.com [1] and demonstrates how one
can use indexes for cross-referencing and domains to group these indexes
along with domains and roles. The source code was taken from [2] after
getting the license changed [3].
[1] https://opensource.com/article/18/11/building-custom-workflows-sphinx
[2] https://github.com/ofosos/sphinxrecipes
[3] https://github.com/ofosos/sphinxrecipes/issues/1
Signed-off-by: Stephen Finucane <stephen@that.guru>
2019-02-09 17:58:30 +00:00
Stephen Finucane
93081e2fce
doc: Use 'literalinclude' directive for examples
...
This avoid duplication and could conceivably let us test this stuff in
code later on.
Signed-off-by: Stephen Finucane <stephen@that.guru>
2019-02-09 17:58:30 +00:00
Stephen Finucane
513d99c316
docs: Rework "todo" tutorial
...
Adopt the same format as was recently added in the "hello world"
tutorial, making this more of a walkthrough as expected from tutorials.
Signed-off-by: Stephen Finucane <stephen@that.guru>
2019-02-09 17:58:30 +00:00
Stephen Finucane
7bce985ac9
docs: Rework the "helloworld" tutorial
...
Nothing to drastic going on here, but this format works better for other
tutorials we're adding.
Signed-off-by: Stephen Finucane <stephen@that.guru>
2019-02-09 17:58:30 +00:00
Takeshi KOMIYA
dce1ccff67
Merge pull request #6045 from tk0miya/test_with_docutils-0.12
...
Do test with docutils-0.12
2019-02-09 16:09:10 +09:00
Takeshi KOMIYA
1a96f2b2cb
Do test with docutils-0.12
2019-02-09 15:48:33 +09:00
Takeshi KOMIYA
3791013c08
quickstart: Simplify generated conf.py (master_doc)
2019-02-09 15:00:27 +09:00
Takeshi KOMIYA
d4df28c643
quickstart: Simplify generated conf.py (source_suffix)
2019-02-09 15:00:27 +09:00
Takeshi KOMIYA
d129f447c3
quickstart: Simplify generated conf.py (version and release)
2019-02-09 15:00:27 +09:00
Takeshi KOMIYA
d08903d9b9
quickstart: Simplify generated conf.py (EPUB)
2019-02-09 15:00:27 +09:00
Takeshi KOMIYA
319adefa9f
epub: `epub_title
defaults to the
project
` option
2019-02-09 15:00:27 +09:00
Takeshi KOMIYA
77b1d713a8
quickstart: Simplify generated conf.py (language)
2019-02-09 15:00:27 +09:00
Takeshi KOMIYA
7415f64eab
refactor: htmlhelp: Generate .hhc file from template
2019-02-09 14:56:51 +09:00
Takeshi KOMIYA
28b0b744b6
refactor: htmlhelp: Generate .hhp file from template
2019-02-09 14:56:51 +09:00
Takeshi KOMIYA
264a4e8380
refactor: htmlhelp: Copy .stp file from template
2019-02-09 14:56:51 +09:00
Takeshi KOMIYA
91b6b46a7e
Merge pull request #6044 from tk0miya/refactor_test_docutils
...
test: Give freshenv=True to test_docutilsconf for windows environment
2019-02-09 14:55:47 +09:00
Takeshi KOMIYA
47058cd175
test: Give freshenv=True to test_docutilsconf for windows environment
2019-02-09 14:44:37 +09:00
Takeshi KOMIYA
a844ce0f2f
Merge pull request #6038 from tk0miya/refactor_test_docutilsconf
...
refactor: test-docutilsconf
2019-02-09 02:05:09 +09:00
Takeshi KOMIYA
1d5e3cba0e
refactor: test-docutilsconf
...
Use options for reST parser instead of HTML4 writer's.
2019-02-09 00:49:49 +09:00
Takeshi KOMIYA
25027945f5
Close #4550 : All tables and figures without `align
` option are displayed to center
2019-02-08 01:39:41 +09:00
Takeshi KOMIYA
500bf85443
Merge branch 'master' into 5196_linkcheck_should_check_remote_image
2019-02-08 00:10:14 +09:00
Takeshi KOMIYA
5cca8407b5
Merge pull request #6031 from tk0miya/separate_dirhtml_package
...
Move DirectoryHTMLBuilder to sphinx.builders.dirhtml package
2019-02-07 23:39:37 +09:00
Takeshi KOMIYA
cf6d1eb820
Merge pull request #6030 from tk0miya/refactor_conftest
...
refactor: tests/conftest.py
2019-02-07 23:38:48 +09:00
Takeshi KOMIYA
55100dce26
refactor: tests/conftest.py
2019-02-07 22:14:06 +09:00
Takeshi KOMIYA
e24220d504
Merge pull request #6029 from tk0miya/clear_SPHINX_TEST_TEMPDIR_before_testing
...
test: clear SPHINX_TEST_TEMPDIR before testing
2019-02-07 13:43:28 +09:00
Timotheus Kampik
71fa87b7a1
Merge pull request #6032 from vedranmiletic/documentation-fixes
...
Add more EXAMPLES
2019-02-06 22:09:17 +01:00
Timotheus Kampik
877bcc2390
refine proposed changes to EXAMPLES
...
* Clarify: _Eve_ is not the programming language
* Remove docutils, as the documentation example is built from a fork
* Fix syntax glitch
* Remove two examples that have not (yet) attracted significant traction
2019-02-06 21:55:25 +01:00
Vedran Miletić
6fa4c81058
Add more EXAMPLES
2019-02-06 21:23:20 +01:00
Takeshi KOMIYA
dd371a59de
Move DirectoryHTMLBuilder to sphinx.builders.dirhtml package
2019-02-07 02:06:39 +09:00
Takeshi KOMIYA
9ac06520b9
test: clear SPHINX_TEST_TEMPDIR before testing
2019-02-07 01:28:45 +09:00
Takeshi KOMIYA
952d76dabb
Merge pull request #5996 from tk0miya/show_tempdir_header_on_testing
...
Show tempdir header on testing (refs: #5902 )
2019-02-07 01:22:40 +09:00
Timotheus Kampik
dc0120be35
Merge pull request #6018 from TimKam/6016-keep-search-results-position-fixed
...
#6016 add placeholder for search summary
2019-02-05 22:46:28 +01:00
Timotheus Kampik
8f7d5d20e1
#6016 add change summary
2019-02-05 22:26:52 +01:00
Timotheus Kampik
fea44e86b8
Merge branch 'master' into 6016-keep-search-results-position-fixed
2019-02-05 22:24:58 +01:00
Jean-François B
ed86ada661
Merge pull request #5992 from jfbu/latex_safe_graphics
...
LaTeX: safer image inclusion
2019-02-05 18:03:07 +01:00