Commit Graph

1367 Commits

Author SHA1 Message Date
Yoshiki Shibukawa
0248416c65 Fix document for Kindle and add description about kindlegen 2016-09-01 12:46:12 +09:00
Takeshi KOMIYA
1da1a71511 Drop python 3.3 support 2016-08-30 00:43:15 +09:00
Takeshi KOMIYA
e64ee7e330 Merge branch 'stable' 2016-08-27 23:42:40 +09:00
Takeshi KOMIYA
5682dbf937 Fix #2892: Added `-a (--append-syspath) option to sphinx-apidoc` 2016-08-24 23:55:15 +09:00
Takeshi KOMIYA
bb46bf591d html_translator_class is now deprecated 2016-08-24 19:11:10 +09:00
Yoshiki Shibukawa
dd09457d7e fix document: rtd is optional from 1.4 2016-08-23 18:42:12 +09:00
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