Merge pull request #2772 from tk0miya/good_default_settings_for_latexpdfja

better default LaTeX settings for Japanese

CHANGES

@@ -30,6 +30,12 @@ Incompatible changes
 * QtHelpBuilder doens't generate search page (ref: #2352)
 * QtHelpBuilder uses ``nonav`` theme instead of default one
   to improve readability.
+* latex: To provide good default settings to Japanese docs, Sphinx uses ``jsbooks``
+  as a docclass by default if the `language` is ``ja``.
+* latex: To provide good default settings to Japanese docs, Sphinx uses
+  ``jreport`` and ``jsbooks`` as a docclass by default if the `language` is
+  ``ja``.
+
 
 Features added
 --------------

doc/config.rst

@@ -1719,6 +1719,11 @@ These options influence LaTeX output. See further :doc:`latex`.
 
    .. versionadded:: 1.0
 
+   .. versionchanged:: 1.5
+
+      In Japanese docs(`language` is ``ja``), ``'jreport'`` is used for
+      ``'howto'`` and ``'jsbooks'`` is used for ``'manual'`` by default.
+
 .. confval:: latex_additional_files
 
    A list of file names, relative to the configuration directory, to copy to the

sphinx/builders/latex.py

@@ -287,6 +287,11 @@ def setup(app):
     app.add_config_value('latex_font_size', '10pt', None)
     app.add_config_value('latex_elements', {}, None)
     app.add_config_value('latex_additional_files', [], None)
-    app.add_config_value('latex_docclass', {}, None)
+
+    japanese_default = {'manual': 'jsbook',
+                        'howto': 'jreport'}
+    app.add_config_value('latex_docclass',
+                         lambda self: japanese_default if self.language == 'ja' else {},
+                         None)
     # now deprecated - use latex_elements
     app.add_config_value('latex_preamble', '', None)