Commit Graph

12711 Commits

Author SHA1 Message Date
Takeshi KOMIYA
53c30c4aff Builder: refactor with progress_message() 2019-02-11 14:49:54 +09:00
Takeshi KOMIYA
66353b3330 latex: refactor with progress_message() 2019-02-11 14:49:54 +09:00
Takeshi KOMIYA
81208ad704 manpage: refactor with progress_message() 2019-02-11 14:49:54 +09:00
Takeshi KOMIYA
f82a266814 texinfo: refactor with progress_message() 2019-02-11 14:49:54 +09:00
Takeshi KOMIYA
29270c91f8
Merge pull request #6056 from tk0miya/fix_warnings_for_docs
docs: Update location of builders
2019-02-11 14:48:43 +09:00
Takeshi KOMIYA
e96ebc59aa Fix typo 2019-02-11 14:48:16 +09:00
Takeshi KOMIYA
1c91425776 Skip escaping navpoint because it's HTML safe 2019-02-11 14:28:52 +09:00
Takeshi KOMIYA
e799f94d24 Remove unused template variables 2019-02-11 14:06:02 +09:00
Takeshi KOMIYA
e0ca116057 docs: Update location of builders 2019-02-11 13:46:32 +09:00
Takeshi KOMIYA
89c3c4ab50 Fix #6046: LaTeX: `TypeError` is raised when invalid latex_elements given 2019-02-11 13:27:13 +09:00
Takeshi KOMIYA
057ef31182 Fix typo 2019-02-11 13:25:24 +09:00
Takeshi KOMIYA
54be6ae494
Merge pull request #6053 from tk0miya/5459_autodoc_default_options_accepts_True
Closes #5459: autodoc: autodoc_default_options accepts True as a value
2019-02-11 12:48:43 +09:00
Takeshi KOMIYA
37ce1eb3b3 docs: githubpage now supports CNAME file 2019-02-11 12:46:35 +09:00
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