cd (OpenModelicaのレポジトリがあるディレクト)/OpenModelica/doc/UsersGuide
pip install -r source/requirements.txt

sudo add-apt-repository ppa:inkscape.dev/stable-daily
sudo apt-get update
sudo apt-get install inkscape
sudo apt-get install pandoc

FileNotFoundError: [Errno 2] No such file or directory: 'pandoc': 'pandoc'

$make html  
cd source && ./tracreleases.py
sphinx-build -b html -t nomathjax -d build/doctrees   source build/html
TypeError: 'NoneType' object is not callable
～
Build finished. The HTML pages are in build/html.

(中略)
copying images... [ 54%] media/omnotebook-mathematical-modeling-with-characteristic-equation.copying images... [100%] media/datareconciliation_csv_report.png
Makefile:136: recipe for target 'latexpdf' failed
make: *** [latexpdf] Error 2

! LaTeX Error: File `textalpha.sty' not found.

tlmgr install textalpha.sty

! Package fontenc Error: Encoding file `lgrenc.def' not found.

! LaTeX Error: File `textalpha.sty' not found.
! Package inputenc Error: Unicode char α (U+3B1)
(inputenc)                not set up for use with LaTeX.

! Package inputenc Error: Unicode char θ (U+3B8)
(inputenc)                not set up for use with LaTeX.

! LaTeX Error: Unknown graphics extension: .svg.

Transcript written on OpenModelicaUsersGuide.log.
Latexmk: Missing input file: 'textalpha.sty' from line
  '! LaTeX Error: File `textalpha.sty' not found.'

Latexmk: Errors, so I did not complete making targets
Makefile:29: recipe for target 'OpenModelicaUsersGuide.pdf' failed
make[1]: *** [OpenModelicaUsersGuide.pdf] Error 12
make[1]: Leaving directory '/(OpenModelicaのリポジトリ)/OpenModelica/doc/UsersGuide/build/latex'
Makefile:136: recipe for target 'latexpdf' failed
make: *** [latexpdf] Error 2

locale_dirs = ['local']
gettext_compact = False

make gettext
sphinx-intl update -p build/gettext -l ja
#エラー内容
TypeError: category must be a Warning subclass, not 'str'

'preamble': """
\usepackage{bookmark}
""",

```修正後
'preamble': r"""
\usepackage{bookmark}
""",

$make -e SPHINXOPTS="-D language='ja'" latexpdf

! Package fontenc Error: Encoding file `lgrenc.def' not found.  
(fontenc)                You might have misspelt the name of the encoding.  

sudo apt-get install texlive-lang-greek

! LaTeX Error: Unknown graphics extension: .svg.

pdf: latex
    $(MAKE) addedPdfs
    cp source/ProfilingTest_*.pdf build/latex/.
    sed -i "s/usepackage.utf8..inputenc./usepackage[utf8x]{inputenc}/" build/latex/OpenModelicaUsersGuide.tex
    sed -i -e "/^ *\\\\DeclareUnicodeCharacter/d" build/latex/OpenModelicaUsersGuide.tex
    # sphinx seems to only handle .* extension for images?
    sed -i "s,{\(media/[A-Za-z_0-9.-]*\)[.][*],{`pwd`/source/\1.pdf,g" build/latex/OpenModelicaUsersGuide.tex
    sed -i "s,{ProfilingTest_prof[.]\([^.]*\)[.]thumb}[.]svg,{`pwd`/source/ProfilingTest_prof-\1-thumb}.pdf,g" build/latex/OpenModelicaUsersGuide.tex
    (cd build/latex && latexmk -pdf OpenModelicaUsersGuide.tex)
source/logo.pdf: source/logo.svg
    inkscape -f $< -A $@
source/media/systemoverview.pdf: source/media/systemoverview.svg
    inkscape -f $< --export-pdf $@
%.pdf: %.svg
    inkscape -f $< --export-pdf $@
    FNAME=`echo $@ | sed "s/[.]/-/g" | sed "s/-pdf/.pdf/g"`; if test "$$FNAME" != "$@"; then cp -a "$@" "$$FNAME"; fi
source/openmodelica.bib: resolve-crossref.py ../bibliography/openmodelica.bib
    ./resolve-crossref.py "../bibliography/openmodelica.bib" source/openmodelica.bib
source/interface.inc: interface.mos
    @mkdir -p tmp
    $(OPENMODELICA_ROOT)/build/bin/omc -g=MetaModelica -d=nogen interface.mos
    mv interface.inc $@

$make -e SPHINXOPTS="-D language='ja'" latexpdf

! LaTeX Error: This file needs format `pLaTeX2e'    
               but this is `LaTeX2e'.

修正前   (cd build/latex && latexmk -pdf OpenModelicaUsersGuide.tex)
修正後   (cd build/latex && $(MAKE) all-pdf)

make -e SPHINXOPTS="-D language='ja'" pdf

正しい状態
>>> getInstallationDirectoryPath() + "/share/doc/omc/testmodels/"
"«OPENMODELICAHOME»/share/doc/omc/testmodels/"

文字化け状態
>>> getInstallationDirectoryPath() + "/share/doc/omc/testmodels/"
"^^c2^^abOPENMODELICAHOME^^c2^^bb/share/doc/omc/testmodels/"

正しい状態　→　文字化け
©　→　Âl’
®　→　Âo
ö　→　Ã ˝

正しい状態　→　不具合
Linköpings　→　Link ö pings

PATH="$PATH:/usr/local/texlive/2020/bin/x86_64-linux"

$ uplatex --version
e-upTeX 3.14159265-p3.8.3-u1.26-191112-2.6 (utf8.uptex) (TeX Live 2020)
kpathsea version 6.3.2
ptexenc version 1.3.8
Copyright 2020 D.E. Knuth.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the e-upTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the e-upTeX source.
Primary author of e-upTeX: Peter Breitenlohner.