Cutlery/calibre
1
0
Fork 0
mirror of https://github.com/kovidgoyal/calibre.git synced 2025-07-09 03:04:10 -04:00
Code Issues Packages Projects Releases Wiki Activity

Ignore errors in translations of template lang docs

Browse Source
This commit is contained in:
Kovid Goyal 2024-11-29 09:06:09 +05:30
parent d9de854a72
commit 262cc42c5a
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C
2 changed files with 29 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
manual/custom.py
View File

@ -18,6 +18,10 @@ def info(*a):
getLogger(__name__).info(*a) getLogger(__name__).info(*a)
def warn(*a):
getLogger(__name__).warn(*a)
include_pat = re.compile(r'^.. include:: (\S+.rst)', re.M) include_pat = re.compile(r'^.. include:: (\S+.rst)', re.M)
@ -45,14 +49,24 @@ def formatter_funcs():
return ans return ans
def ffdoc(m): def ffdoc(language, m):
func_name = m.group(1) func_name = m.group(1)
try:
return formatter_funcs()['doc'][func_name] return formatter_funcs()['doc'][func_name]
except Exception as e:
if language in ('en', 'eng'):
raise
warn(f'Failed to process template language docs for in the {language} language with error: {e}')
def ffsum(m): def ffsum(language, m):
func_name = m.group(1) func_name = m.group(1)
try:
return formatter_funcs()['sum'][func_name] return formatter_funcs()['sum'][func_name]
except Exception as e:
if language in ('en', 'eng'):
raise
warn(f'Failed to process template language summary docs for in the {language} language with error: {e}')
def source_read_handler(app, docname, source): def source_read_handler(app, docname, source):
@ -65,8 +79,8 @@ def source_read_handler(app, docname, source):
src = re.sub(r'(\s+generated/)en/', r'\1' + app.config.language + '/', src) src = re.sub(r'(\s+generated/)en/', r'\1' + app.config.language + '/', src)
if docname == 'template_lang': if docname == 'template_lang':
try: try:
src = re.sub(r':ffdoc:`(.+?)`', ffdoc, src) src = re.sub(r':ffdoc:`(.+?)`', partial(ffdoc, app.config.language), src)
src = re.sub(r':ffsum:`(.+?)`', ffsum, src) src = re.sub(r':ffsum:`(.+?)`', partial(ffsum, app.config.language), src)
except Exception: except Exception:
import traceback import traceback
traceback.print_exc() traceback.print_exc()
@ -360,7 +374,7 @@ def generate_docs(language):
def template_docs(language): def template_docs(language):
from template_ref_generate import generate_template_language_help from template_ref_generate import generate_template_language_help
raw = generate_template_language_help(language) raw = generate_template_language_help(language, getLogger(__name__))
update_cli_doc('template_ref', raw, language) update_cli_doc('template_ref', raw, language)

8
manual/template_ref_generate.py
View File

@ -50,7 +50,7 @@ functions.
''' '''
def generate_template_language_help(language): def generate_template_language_help(language, log):
from tempfile import TemporaryDirectory from tempfile import TemporaryDirectory
from calibre.db.legacy import LibraryDatabase from calibre.db.legacy import LibraryDatabase
@ -75,7 +75,13 @@ def generate_template_language_help(language):
func = categories[cat_name][name] func = categories[cat_name][name]
a(f"\n\n.. _ff_{name}:\n\n{name}\n{'^'*len(name)}\n\n") a(f"\n\n.. _ff_{name}:\n\n{name}\n{'^'*len(name)}\n\n")
a(f'.. class:: {func.__class__.__name__}\n\n') a(f'.. class:: {func.__class__.__name__}\n\n')
try:
a(ffml.document_to_rst(func.doc, name)) a(ffml.document_to_rst(func.doc, name))
except Exception as e:
if language in ('en', 'eng'):
raise
log.warn(f'Failed to process template language docs for {name} in the {language} language with error: {e}')
a(' TRANSLATION INVALID')
a('\n\n') a('\n\n')
db.close() db.close()
del db del db