Commit Graph
1462 Commits
Author SHA1 Message Date
Yoshiki Shibukawa 0ef331a4c7 fix sphinx document's template not to have link to genindex for epub result 2016-08-23 08:02:54 +09:00
Takeshi KOMIYA 69d1dfaade Use epub3 builder by default. And the old epub builder is renamed to epub2. 2016-08-22 21:39:44 +09:00
Takeshi KOMIYA d45c5f8e82 #2725: latex builder: allow to use user-defined template file (experimental) 2016-08-17 22:52:42 +09:00
Takeshi KOMIYA 8a9459b308 Merge branch 'stable' 2016-08-09 23:19:11 +09:00
Yoshiki Shibukawa 90b3c79895 fix html entity to fix epub error 2016-08-09 16:58:56 +09:00
Yoshiki Shibukawa 8f162a132e fix epub warning in Sphinx's document 2016-08-09 16:58:56 +09:00
Yoshiki Shibukawa 59ebeb7f1f fix epub3 toc.xhtml, epub date format to satisfy spec 2016-08-09 16:58:56 +09:00
Jakob Lykke Andersen 1b251797bb Merge branch 'master' into cpp-concepts 2016-08-07 18:37:31 +02:00
Takeshi KOMIYA a9da999d71 Merge branch 'stable' 2016-08-08 00:40:42 +09:00
Jakob Lykke Andersen 678630a59b C++, add support for removing index text prefixes
Closes sphinx-doc/sphinx#1958.
2016-08-06 00:53:50 +02:00
Jakob Lykke Andersen c85e60a5ac C++, increase support for attributes.
User-defined attributes and simple C++11 style attributes.
Closes sphinx-doc/sphinx#2682.
2016-08-06 00:08:02 +02:00
Ashley Whetter cfd4e51802 Python domain can now link container types automatically
Google types now greedily match the closing parenthesis.

Also removed name from returns section in Google docstrings.
Instead, everything before the colon is treated as the type.
2016-08-03 17:09:40 +01:00
Eric Knibbe 56ee02114a remove extra colons in C++ domain examples 2016-08-02 15:22:50 -04:00
Yoshiki Shibukawa d842a4cbc8 Turn off viewcode extension by default 2016-07-28 15:38:38 +09:00
Takeshi KOMIYA d651613583 Merge pull request #2772 from tk0miya/good_default_settings_for_latexpdfja
better default LaTeX settings for Japanese
2016-07-21 01:06:08 +09:00
Takeshi KOMIYA f2a7eeca60 Merge pull request #2774 from tk0miya/latex_engine
Add `latex_engine` to switch the LaTeX engine by conf.py
2016-07-21 01:05:51 +09:00
Takeshi KOMIYA 80bfc55795 Merge branch 'stable' 2016-07-21 00:20:25 +09:00
Takeshi KOMIYA c698fab338 Merge pull request #2786 from shibukawa/fix/epub
Reduce epub checker warnings/errors for epub3 builder.
2016-07-20 23:30:59 +09:00
Yoshiki Shibukawa b7b1ac1c4d add preferred instruction to download role description 2016-07-19 23:35:49 +09:00
Yoshiki Shibukawa 702004acfc fix document download roles. download roles works only on html. 2016-07-19 23:15:35 +09:00
Takeshi KOMIYA 1a575f4666 Update CHANGES and docs 2016-07-19 11:03:38 +09:00
Yoshiki Shibukawa 06a861703d Reduce epub checker warnings/errors for epub3 builder.
Fix DOCTYPE to html5 and change extension from .html to .xhtml.

Sphinx's documents result:

  before: 95 warnings& 1238 errors
  after: 623 errors
2016-07-17 09:53:04 +09:00
Takeshi KOMIYA 253eef9e6a #2680: sphinx.ext.todo now emits warnings if todo_emit_warnings enabled 2016-07-16 00:59:02 +09:00
Takeshi KOMIYA 2aace8d54b Use jreport to the docclass for Japanese howto documents 2016-07-15 23:34:51 +09:00
Takeshi KOMIYA fc9c9e04ee better default LaTeX settings for Japanese 2016-07-15 22:36:49 +09:00
Ville Skyttä 302c695048 Run *.png through zopflipng -m
Before: 2334583 bytes
After:  2136324 bytes
2016-07-07 18:34:18 +03:00
Ville Skyttä f1316a0bb3 Run *.jpg through jpegoptim -s
Before: 28408 bytes
After:  25206 bytes
2016-07-07 18:34:18 +03:00
Ville Skyttä 7cfbc2a702 Fix style checks 2016-07-07 16:48:12 +03:00
Takeshi KOMIYA 31c6beb578 Merge pull request #2454 from mgeier/html-sourcelink-txt
Add option html_sourcelink_suffix
2016-07-06 01:43:18 +09:00
Rob Ruana 8eecdbd715 [Napoleon] Removes Python 2/3 compatible type annotation doc example, because they aren't current supported by Sphinx 2016-07-02 11:43:55 -04:00
Takeshi KOMIYA e3c3e4f0cb Merge branch 'stable' 2016-07-02 16:39:13 +09:00
jfbu 067d3cabf0 latex, make use of `\small` for code listings customizable 2016-06-30 11:20:30 +02:00
jfbu f30a8d5a36 fix a mark-up typo in doc/install.rst 2016-06-30 11:10:58 +02:00
jfbu a20533540b Add a sentence in doc/config.rst on `'pxunit'` key 2016-06-29 20:55:07 +02:00
jfbu d76e9d48a5 Update doc/rest.rst 2016-06-26 23:13:32 +09:00
jfbu fc2202fd2a latex, replace `'pixelsize' by more precise 'pxunit'` name 2016-06-25 10:32:48 +02:00
jfbu f6b0ae903d latex, allow image dimensions using px unit (96px=1in)
New key ``'pixelsize'`` in ``latex_elements`` dictionary.
2016-06-24 20:36:35 +02:00
Rob Ruana 2b60fc2027 Fixes #2688: [Napoleon] Updates to Napoleon documentation to fix intersphinx links and demonstrate PEP 484 type annotations 2016-06-23 15:25:46 -04:00
jfbu 5bd76815ff Added an item about sphinxVerbatim to doc/latex.rst 2016-06-22 22:30:58 +02:00
jfbu 12ade10d55 New latex.rst for extended documentation of LaTeX's customizing. 2016-06-20 09:23:41 +02:00
jfbu 2cec5a25b2 Merge branch 'stable'
Conflicts:
	sphinx/domains/cpp.py
	sphinx/texinputs/sphinx.sty
	tests/test_build_latex.py
2016-06-15 18:29:58 +02:00
jfbu 5510653d6e Fix #2629. Add new config option `latex_keep_old_macro_names`
The cause of the issue was a clash about ``\titleref`` macro being already
defined in memoir class context. To avoid similar problems, this makes
the text styling macros

  ``\strong``, ``\code``, ``\bfcode``, ``\email``, ``\tablecontinued``,
  ``\titleref``, ``\menuselection``, ``\accelerator``, ``\crossref``,
  ``\termref``, ``\optional``,

also available with ``\sphinx`` prefix, with a conf.py boolean option to
let sphinx.sty only define ``\sphinx``-prefixed macros. As default value
is False, backwards compatibility is maintained.

On this occasion, some internal non-public macros have been renamed with
prefix ``\spx@``. The command

    find . -name '*.sty' -exec grep -l \\\\spx@ {} \;

has been executed in TeXLive 2015 and 2016 installations to check no
package defines macros starting with ``\spx@``.

Some internal macros having public names (because they are written by
latex.py into the body of the latex document) have been renamed to have
``\sphinx`` prefix. The macros in sphinx.sty starting with \py@, or \DU,
or \PYG have not been modified. Similarly ``\release``, ``\version``,
``\releasename``, etc... have not been renamed.
2016-06-15 08:53:24 +02:00
Rob Ruana ff34d02beb Fix #2537: [Napoleon] Corrects minor formatting issue on example NumPy Attributes section 2016-06-12 14:55:39 -06:00
Rob Ruana 32a852c1f1 Update #2374: [Napoleon] clarifies documentation of napoleon_include_init_with_doc conf value 2016-06-11 18:28:48 -06:00
Takeshi KOMIYA a35399a0aa Merge branch 'stable' 2016-06-10 20:55:05 +09:00
jfbu 7d3bddd4e3 Convert text into links at bottom of tutorial.rst and top of config.rst 2016-06-09 15:34:59 +02:00
jfbu c51282530c Merge branch 'stable' 2016-06-08 11:38:33 +02:00
Matthias Geier 5559150578 Change html_sourcelink_txt -> html_sourcelink_suffix 2016-06-07 15:17:12 +02:00
Matthias Geier 86615e1f09 Add option html_sourcelink_txt 2016-06-07 15:15:39 +02:00
jfbu f38665b58c Display correctly the Builtin themes in the PDF build of Sphinx doc
Add longtable as class, which will allow pagebreaks in pdf output.
2016-06-06 14:42:58 +02:00