yocto のリファレンスマニュアルをコンパイルして pdf 版を手に入れる

背景

yocto pdf manual というようなキーワードで検索しても古いバージョンしか見つからないので、
新しいバージョンの pdf を取得するために必要なビルド手順調べた。
https://www.google.com/search?q=yocto+pdf+manual&oq=yocto+pdf+manual

動作確認環境

ubuntu20.04 上と docker 上の ubuntu18.04 と GitHub Actions 上で確認した。

関連サイト

ビルド方法

以下ページでビルド方法の説明が書いてある。
https://git.yoctoproject.org/cgit.cgi/poky/tree/documentation/README?h=zeus

docker や GitHub Actions など 実際に試したデータ

https://github.com/m-tmatma/yocto-manual
にデータを置いている。

準備作業

sudo apt-get update
sudo apt-get install -y git-core \
    make xsltproc fop \
    python3 python3-dev python3-pip python3-setuptools python3-sphinx python3-yaml python3-sphinx-rtd-theme

ソース取得

以下の例では zeus

git clone -b zeus git://git.yoctoproject.org/poky

以下でも OK

git clone -b zeus https://git.yoctoproject.org/git/poky

ビルド

以下コマンドでビルドする

cd poky/documentation
make pdf DOC=ref-manual

poky/documentation/ref-manual/ref-manual.pdf に PDF ファイルが作成される。