原文・訳文重複箇所の更新をマージするのが二度手間

[harupong]

v1との違い

訳出時の原文を訳文にもすべて埋め込むようにしたので、最新の原文との差異を確認しやすくなった。

課題： コードブロック部分、Asciidoc markup 部分のマージが二度手間

• コメントアウトされた原文
• 原文をコピペした訳文

で、同じ内容のテキストが重複して登場するため二度手間になるのは当たり前なのですが、なんとかできるならそうしたい、という話です。

例 1c03a04

• gitコマンドアウトプットから不要なスペースの削除が3ヶ所
• Asciidocのアンカー行の移動が1ヶ所

が導入されたが、修正箇所がすべて**「コメントアウトされた原文をそのまま訳文としてコピペした部分」**であるため、同じ修正を原文と訳文双方に繰り返す必要があり二度手間。

解決策

行単位、段落単位で「コメントアウトされた原文をそのまま訳文としてコピペした部分」については、原文コメントアウト&コピペ訳文をやめて、「原文のみ」にする。マージしやすくなる。

残る課題

インラインの Asciidoc markup は如何ともし難いので、二度手間も仕方ない。

[harupong]

たとえば、

//////////////////////////
[[_viewing_history]]
=== Viewing the Commit History
//////////////////////////
[[_viewing_history]]
=== コミット履歴の閲覧

こういう部分については、

[[_viewing_history]]
//////////////////////////
=== Viewing the Commit History
//////////////////////////
=== コミット履歴の閲覧

こうしたほうが重複が減って嬉しいな、という解決策です。

[m-takagi]

それでいいのではないかと思います。

あとは、コマンドの出力結果（↓　こんなやつ）をどうするかですが、

//////////////////////////
[source,console]
----
$ git checkout experiment
$ git rebase master
First, rewinding head to replay your work on top of it...
Applying: added staged command
----
//////////////////////////
[source,console]
----
$ git checkout experiment
$ git rebase master
First, rewinding head to replay your work on top of it...
Applying: added staged command
----

これも、わざわざコメントアウト＆コピペする必要もなさそうですねえ。

[harupong]

どちらも不要ですね :disappointed: 前もって想定できた話で、後出しで申し訳ないのですが、

• 原文・訳文が同一内容の行・節は原文埋め込み不要（例：コードブロック、Asciidoc のアンカー）

の方針に変更したいと思います。第6章からこれでお願いできますか？ :bow:

既訳の1～3章のほうはこちらで処置しておきます。