ShibataProjects2 の履歴(No.20)

リソース
プリンシプル
プロセス
- git operation
  - xelatex / tcolorboxes (out) issues
v3 to v4 diffs

リソース†

↑

プリンシプル†

LFS301
- EN final [on master] = v8.0
- JP final [on japanese] = (based on EN )
LFS307

LFS303
301 master(latest) と 307 master(latest) の比較
- summary.txt
- 301_to_307_diffs.txt

↑

プロセス†

↑

LFS301 コンパイルエラー†

common の最新版を使ってリビルドを試みたがエラーになった
- Makefile のリンク先を common/Makefile_oneclass から common/Makefile_oneclass_JAPANESE に変更したら解決した
- JP 専用 Makefile には xelatex を使用する指示が入っているなど JP 版ビルド用に修正が入っていた
- 上記で Malefile を単純に以前使った日本語専用に先祖帰りさせたが、これだと common 側の更新が反映されない → 後々 COVER のビルドで問題が出た
- 301 時点での「共用 Makefile」と「日本語専用 Makefile」の差分をみて、それを最新の common の Makefile に反映したものを、新日本語専用にする必要がある

↑

LFS307-JP の作成†

~~make でエラー~~
- Makefile は LFS301-JP では日本語専用のものを使っていたが、307 では共通のものを利用することにした。
  - 日本語は xetex で生成するという記述が共通版最新に反映されていた
  - その他の Makefile の更新が非常に多いのでバックポートは不可能と判断

日本語が含まれるファイルが ASCII 形式だったのを UTF-8 に変換

munakata@muna-Linux:~/LFS/LFS307-JP$ file LFS307-JP.tex
LFS307-JP.tex: LaTeX 2e document, ASCII text, with escape sequences
munakata@muna-Linux:~/LFS/LFS307-JP$ nkf -w --overwrite LFS307-JP.tex
munakata@muna-Linux:~/LFS/LFS307-JP$ file LFS307-JP.tex
LFS307-JP.tex: LaTeX 2e document, Unicode text, UTF-8 text

この段階で前英語テキストの状態で Make して pdf が出来ることを確認（一部のキャプションが日本語になった）
~~カバーレター（表紙など）の日本語が表示されなかったので make clean して再ビルドしたらエラーになった~~
- Makefile を共通の最新に変更したら、make clean からのフルブルドでもエラーはなくなった。

↑

introduction の反映†

LFS307 の introduction は common のファイルを参照するのではなく、CHAPS 以下にあるファイルを参照している。
LFS301 でも同じなので、301 と 307 の英語のファイルを比較したところ、全く変更はないことがわかった。
なので、301-JP で使っていた introducrtion の日本語ファイルをそのまま 307-JP にコピーした。

ただし、change と nodistro は LFS301ｰJP には無かったので翻訳ファイルが無く、現状英語のまま。(20230405)

munakata@muna-Linux:~/LFS/LFS301$ git branch 
  japanese
  japanese-wip2
* master

munakata@muna-Linux:~/LFS/LFS307-JP$ cat CHAPS/introduction/index.tex 
\chapter{Introduction}

\lflogo
\minitoc

\clearpage

\input{lf}
\input{training}
\input{certification}
\input{badging}
\input{exercises}
\input{change}

\ifdefined\elearningcourse
   \input{elearning}
\fi

%%\input{customintro}

\ifdefined\nodistro
   \input{nodistro}
\else
   \input{distributions}
   \input{labs}
\fi

munakata@muna-Linux:~/LFS/LFS301$ cd ../LFS307-JP/
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/lf.tex ../LFS301/CHAPS/LFS301_introduction/lf.tex 
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/training.tex ../LFS301/CHAPS/LFS301_introduction/training.tex 
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/certification.tex ../LFS301/CHAPS/LFS301_introduction/certification.tex 
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/badging.tex ../LFS301/CHAPS/LFS301_introduction/badging.tex 
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/exercises.tex ../LFS301/CHAPS/LFS301_introduction/exercises.tex 
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/change.tex ../LFS301/CHAPS/LFS301_introduction/change.tex 
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/elearning.tex ../LFS301/CHAPS/LFS301_introduction/elearning.tex 
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/nodistro.tex ../LFS301/CHAPS/LFS301_introduction/nodistro.tex 
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/distributions.tex ../LFS301/CHAPS/LFS301_introduction/distributions.tex 
munakata@muna-Linux:~/LFS/LFS307-JP$ diff CHAPS/introduction/labs.tex ../LFS301/CHAPS/LFS301_introduction/labs.tex

上記で diff で差が出ないのは怪しい。DeepL の翻訳と比較するといくつかのファイルで更新の痕跡が見られる。
自己レス：差がないのは 301時点で introduction の内容が更新されていたから。301-JP にはこの更新後の内容が反映されていなかった。
LFS301 の introduction が本当にローカルを参照しているのか（まぁローカルにファイルはあるわけだが）確認が必要。
一方で common の introduction の変更履歴は以下のようになっていて、最近更新されたファイルは差分を確認する必要がある。

file	last change	used in 307
change.tex	9 months ago	yes
courses.tex	last year	no
distro.inc	last year	yes
distro.tex	2 years ago	yes
documentation.tex	2 years ago	no
index.tex	6 months ago	-
legalcrap.tex	9 months ago	no
nodistro.tex	5 months ago	yes
platform.tex	4 years ago	no
readyfor.tex	2 years ago	no
register.tex	4 years ago	no
virtualmachine.tex	7 months ago	no
whoweare.tex	2 years ago	no
whoyouare.tex	2 years ago	no

LFS301 配下の introduction ファイルと、最新の common/LFS_introduction のファイルには差がなかった。

301時代の終盤（LFS301_ というファイルに変わったあたり）で introduction のファイルが変更されている可能性もある。

munakata@muna-Linux:~/LFS/LFS301$ diff CHAPS/LFS301_introduction/lf.tex ../common/LFS_introduction/lf.tex 
munakata@muna-Linux:~/LFS/LFS301$ diff CHAPS/LFS301_introduction/training.tex ../common/LFS_introduction/training.tex

301 時代から common の introduction を参照しているので、差がないのは当たり前だった。
```
0 lrwxrwxrwx 1 munakata munakata   26  4月  5 15:26 LFS301_introduction -> ../common/LFS_introduction
```
では何時変更がはいったのか？　⇒ 忘れたが 301-JP の intro 和訳はもらった気がするので、その時点でずれていたのか？
301-JP の introduction 日本語訳には以下のコメントがある。誰か別の人が以前のソースを自動翻訳した痕跡であるのは明らかだ。
```
% This file was generated with po4a. Translate the source file.%
```

301/307 と 301-JP/307-JP の introduction の差分 |common/LFS_introduction の構成　｜ LFS301-JP (=307JP 現状）｜更新があるか

input{lf}	←	updated
input{training}	←	updated
input{certification}	←	Updated
input{badging}	←	Updated
input{exercises}	←	Identical
input{change}	←	New
input{elearning}	←	Identical
input{distributions}	←	Updated
input{labs}	←	Updated

何れにしても変更はマイナーなので、対象ファイルを個別に調査して反映することにする（2023/04/06)

↑

Closing の反映†

こちらはファイルが１つ（それも柴田さんから提供してもらった、日本語コースの共通ファイル）なので、それをそのまま利用する
元々の common からのリンクは切って、別にローカルファイルを置いた。

↑

Identical なファイルのコピー†

基本は問題なし
labs で２つ include ファイルが無いというエラーが出た。
何故 identical だと判定されたか（labs.tex について）調査が必要だろう

↑

git operation†

munakata@muna-Linux:~/LFS/LFS307-JP$ git branch -a
* japanese-wip
  remotes/origin/HEAD -> origin/master
  remotes/origin/coop
  remotes/origin/lee
  remotes/origin/lee2022
  remotes/origin/master
  remotes/origin/staging

munakata@muna-Linux:~/LFS/LFS307-JP$ git remote -v
origin	https://github.com/lftraining/LFS307 (fetch)
origin	https://github.com/lftraining/LFS307 (push)

munakata@muna-Linux:~/LFS/LFS307-JP$ git push origin japanese-wip
Username for 'https://github.com': hmunak
Password for 'https://hmunak@github.com': 
Enumerating objects: 230, done.
Counting objects: 100% (230/230), done.
Delta compression using up to 8 threads
Compressing objects: 100% (144/144), done.
Writing objects: 100% (146/146), 114.37 KiB | 7.62 MiB/s, done.
Total 146 (delta 42), reused 0 (delta 0), pack-reused 0
remote: Resolving deltas: 100% (42/42), completed with 16 local objects.
To https://github.com/lftraining/LFS307
  0e1115c..0e632bc  japanese-wip -> japanese-wip

↑

xelatex / tcolorboxes (out) issues†

https://tex.stackexchange.com/questions/188174/xelatex-and-tcolorbox-incompatibility

↑

v3 to v4 diffs†

munakata@muna-Linux:~/LFJ/LFS307-JP$ git diff 0e11 940b --name-only --diff-filter=M | grep CHAPS ( 37 files modified)
CHAPS/apt/apt.tex
* CHAPS/containers/basics.tex [#c34b91e3]
* CHAPS/containers/docker.tex [#c758086a]
* CHAPS/containers/index.tex [#f07654cf]
* CHAPS/containers/labs.tex [#b107dfee]
CHAPS/firewall/interfaces.tex
CHAPS/firewall/nat.tex
CHAPS/firewall/zones.tex
CHAPS/fsfeatures/mount.tex
CHAPS/fslayout/home.tex
CHAPS/fslayout/media.tex
CHAPS/groups/group.tex
* CHAPS/init/index.tex [#cea34c21]
* CHAPS/init/init.tex [#xfb61fb8]
* CHAPS/init/labs.tex [#g5a7f8d8]
* CHAPS/init/systemd.tex [#yc01ac73]
CHAPS/kernel-udev/labs.tex
CHAPS/kernel-udev/udev.tex
CHAPS/memmon/memmon.tex
CHAPS/netbasics/addresses.tex
* CHAPS/netconfig/bonding.tex [#d375f77f]
* CHAPS/netconfig/configfiles.tex [#t566b61b]
* CHAPS/netconfig/diagnostics.tex [#z8268b78]
* CHAPS/netconfig/dns.tex [#n780b8ba]
* CHAPS/netconfig/index.tex [#q4a99887]
* CHAPS/netconfig/interfaces.tex [#l64ded57]
* CHAPS/netconfig/labs.tex [#jdb8f7c1]
* CHAPS/netconfig/networkmanager.tex [#r8b438c4]
* CHAPS/netconfig/routing.tex [#j7dc0636]
CHAPS/processes/future.tex
CHAPS/user-environment/index.tex
CHAPS/user-environment/labs.tex
CHAPS/users/accounts.tex
CHAPS/users/labs.tex
CHAPS/users/passwords.tex
CHAPS/users/ssh.tex
CHAPS/vfs/avail.tex

munakata@muna-Linux:~/LFJ/LFS307-JP$ git diff 0e11 940b --name-only --diff-filter=A | grep CHAPS (11 files added)
* CHAPS/containers/cowsay.tex [#of079b72]
* CHAPS/containers/docker-compose.tex [#t8bcac82]
* CHAPS/containers/reprobuild-1024.png [#i94d4f3d]
* CHAPS/containers/reprobuild.tex [#a2d5e24c]
* CHAPS/git-started/commands.tex [#h7e09bfe]
* CHAPS/git-started/example.tex [#fe05643c]
* CHAPS/git-started/getsources.tex [#r59a1283]
* CHAPS/git-started/index.tex [#fcffd3a3]
* CHAPS/git-started/lab.tex [#w9c8adb8]
* CHAPS/git-started/revision.tex [#o9ead616]
* CHAPS/init/dbus.service.inc [#x6209a6d]

munakata@muna-Linux:~/LFJ/LFS307-JP$ git diff 0e11 940b --name-only --diff-filter=D | grep CHAPS (26 files deleted)
* CHAPS/GIT_EXAMPLE/commands.tex [#e09de738]
* CHAPS/GIT_EXAMPLE/example.tex [#k85cb4cf]
* CHAPS/GIT_EXAMPLE/index.tex [#tbb44fef]
* CHAPS/GIT_EXAMPLE/lab.tex [#p4777265]
* CHAPS/GIT_EXAMPLE/labs/lab_gitexample.sh [#c146d0c6]
* CHAPS/GIT_EXAMPLE/mastermain.tex [#q05063b0]
* CHAPS/GIT_EXAMPLE/signoff.tex [#va7c2d4a]
* CHAPS/GIT_INTRO/available.tex [#e877e817]
* CHAPS/GIT_INTRO/dco.tex [#hf8ebfa3]
* CHAPS/GIT_INTRO/distrib.tex [#h0fd1a33]
* CHAPS/GIT_INTRO/documentation.tex [#b3c4199a]
* CHAPS/GIT_INTRO/git.tex [#aee1026b]
* CHAPS/GIT_INTRO/graphics.tex [#a34de45a]
* CHAPS/GIT_INTRO/guitable.inc [#y6a62d41]
* CHAPS/GIT_INTRO/index.tex [#yfb9e41b]
* CHAPS/GIT_INTRO/lab.tex [#yb88e34c]
* CHAPS/GIT_INTRO/revision.tex [#fa9ce830]
* CHAPS/GIT_INTRO/revtable.inc [#jac3ca94]
* CHAPS/containers/U20-04-podman.inc [#ke96ab4a]
* CHAPS/containers/labs-docker.inc [#g55a0fb7]
* CHAPS/containers/labs/LFS-class.conf [#o46a49d4]
* CHAPS/containers/labs/Ubuntu-20.04-podman-repo.sh [#ne5435da]
* CHAPS/containers/podman.tex [#sf7cf881]
* CHAPS/init/labs/fake2.service [#da74ce46]
* CHAPS/netconfig/ipifconfig.tex [#m3690f2b]
CHAPS/user-environment/keys.tex