ShibataProjects2 の履歴(No.10)

リソース
プリンシプル
プロセス
- git operation

リソース†

↑

プリンシプル†

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