From 8e462d82325829d6385f870dfda6d5b47f8bdbbf Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Wed, 1 Oct 2014 21:54:46 +0530 Subject: [PATCH] More fixes for sphinx generated multi-language cross ref problem --- manual/conversion.rst | 2 +- manual/custom.py | 6 +++--- manual/news.rst | 2 +- manual/template_ref_generate.py | 6 +++--- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/manual/conversion.rst b/manual/conversion.rst index 4aa12ce216..b43f2867f8 100644 --- a/manual/conversion.rst +++ b/manual/conversion.rst @@ -17,7 +17,7 @@ use the edited ebook as input for conversion into other formats in |app|. This document will refer mainly to the conversion settings as found in the conversion dialog, pictured below. All these settings are also available via -command line interface to conversion, documented at :ref:`ebook-convert`. In +command line interface to conversion, documented at :doc:`generated/|lang|/ebook-convert`. In |app|, you can obtain help on any individual setting by holding your mouse over it, a tooltip will appear describing the setting. diff --git a/manual/custom.py b/manual/custom.py index b77d879803..d3b9d7191e 100644 --- a/manual/custom.py +++ b/manual/custom.py @@ -53,7 +53,7 @@ CLI_INDEX=''' ''' CLI_PREAMBLE='''\ -.. _{cmd}: +.. _{cmdref}: ``{cmd}`` =================================================================== @@ -227,7 +227,7 @@ def cli_docs(app): usage = usage[1:] usage = [i.replace(cmd, ':command:`%s`'%cmd) for i in usage] usage = '\n'.join(usage) - preamble = CLI_PREAMBLE.format(cmd=cmd, cmdline=cmdline, usage=usage) + preamble = CLI_PREAMBLE.format(cmd=cmd, cmdref=cmd + '-' + app.config.language, cmdline=cmdline, usage=usage) if cmd == 'ebook-convert': generate_ebook_convert_help(preamble, app) elif cmd == 'calibredb': @@ -247,7 +247,7 @@ def generate_docs(app): def template_docs(app): from template_ref_generate import generate_template_language_help - raw = generate_template_language_help() + raw = generate_template_language_help(app.config.language) update_cli_doc('template_ref', raw, app) def setup(app): diff --git a/manual/news.rst b/manual/news.rst index c6c6d46a99..be3b3d513e 100644 --- a/manual/news.rst +++ b/manual/news.rst @@ -300,7 +300,7 @@ If you're satisfied with your recipe, and you feel there is enough demand to jus .. seealso:: - :ref:`ebook-convert` + :doc:`generated/|lang|/ebook-convert` The command line interface for all ebook conversion. diff --git a/manual/template_ref_generate.py b/manual/template_ref_generate.py index 054088981d..7178949b4b 100644 --- a/manual/template_ref_generate.py +++ b/manual/template_ref_generate.py @@ -7,7 +7,7 @@ __copyright__ = '2008, Kovid Goyal ' from collections import defaultdict PREAMBLE = '''\ -.. _templaterefcalibre: +.. _templaterefcalibre-{}: Reference for all built-in template language functions ======================================================== @@ -58,7 +58,7 @@ The python implementation of the template functions is passed in a Metadata obje ''' -def generate_template_language_help(): +def generate_template_language_help(language): from calibre.utils.formatter_functions import formatter_functions funcs = defaultdict(dict) @@ -74,7 +74,7 @@ def generate_template_language_help(): func_cat = getattr(func, 'category') funcs[func_cat][func_sig] = class_name - output = PREAMBLE + output = PREAMBLE.format(language) cats = sorted(funcs.keys()) for cat in cats: output += CATEGORY_TEMPLATE.format(category=cat, dashes='-'*len(cat))