diff options
| -rw-r--r-- | documentation/Makefile | 5 | ||||
| -rw-r--r-- | documentation/conf.py | 7 |
2 files changed, 2 insertions, 10 deletions
diff --git a/documentation/Makefile b/documentation/Makefile index 402ad986ae..cb8d4dea85 100644 --- a/documentation/Makefile +++ b/documentation/Makefile | |||
| @@ -61,12 +61,9 @@ epub: $(PNGs) | |||
| 61 | $(SOURCEDIR)/set_versions.py | 61 | $(SOURCEDIR)/set_versions.py |
| 62 | @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) | 62 | @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
| 63 | 63 | ||
| 64 | # Note: we need to pass buf_size here (which is also configurable from | ||
| 65 | # texmf.cnf), to avoid following error: | ||
| 66 | # Unable to read an entire line---bufsize=200000. Please increase buf_size in texmf.cnf. | ||
| 67 | latexpdf: $(PDFs) | 64 | latexpdf: $(PDFs) |
| 68 | $(SOURCEDIR)/set_versions.py | 65 | $(SOURCEDIR)/set_versions.py |
| 69 | buf_size=10000000 $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) | 66 | @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
| 70 | 67 | ||
| 71 | all: html epub latexpdf | 68 | all: html epub latexpdf |
| 72 | 69 | ||
diff --git a/documentation/conf.py b/documentation/conf.py index 4e69213f8c..3969494377 100644 --- a/documentation/conf.py +++ b/documentation/conf.py | |||
| @@ -159,14 +159,9 @@ html_last_updated_fmt = '%b %d, %Y' | |||
| 159 | # Remove the trailing 'dot' in section numbers | 159 | # Remove the trailing 'dot' in section numbers |
| 160 | html_secnumber_suffix = " " | 160 | html_secnumber_suffix = " " |
| 161 | 161 | ||
| 162 | # We need XeTeX to process special unicode character, sometimes the contributor | ||
| 163 | # list from the release note contains those. | ||
| 164 | # See https://docs.readthedocs.io/en/stable/guides/pdf-non-ascii-languages.html. | ||
| 165 | latex_engine = 'xelatex' | ||
| 166 | latex_use_xindy = False | ||
| 167 | latex_elements = { | 162 | latex_elements = { |
| 168 | 'passoptionstopackages': '\\PassOptionsToPackage{bookmarksdepth=5}{hyperref}', | 163 | 'passoptionstopackages': '\\PassOptionsToPackage{bookmarksdepth=5}{hyperref}', |
| 169 | 'preamble': '\\usepackage[UTF8]{ctex}\n\\setcounter{tocdepth}{2}', | 164 | 'preamble': '\\setcounter{tocdepth}{2}', |
| 170 | } | 165 | } |
| 171 | 166 | ||
| 172 | # Make the EPUB builder prefer PNG to SVG because of issues rendering Inkscape SVG | 167 | # Make the EPUB builder prefer PNG to SVG because of issues rendering Inkscape SVG |
