respecでの複数ページに分割しての編集

 shimonoです

 前回のcallの宿題について、木田さんといろいろ試験をしながらやっていたのですが、
・部分的に文章を作成していく方向であることを考えて、複数ページ(htmlファイル)に分割して編集する方針とする
・英語・日本語を一つのページにまとめることは目標とせず、ひとまずは、最終成果物は2つ分けたものとする
・分割のレベルはこれから検討、2.のレベルで分割するのか、2.2のレベルで分割するのか (章によりそうですが)
・github actionを利用して複数ファイルをまとめて出力したものを生成するように努力する (そのままだと表示に結構時間がかかる)
という提案をするかな、というところに落ち着きました。



 以下詳細

 複数html構成のサンプルのファイルは
https://github.com/himorin/w3c-memo/tree/main/tools/samples/respec-multipage-lang

にあります。united.html, sep-*.htmlがrespecを使って最終生成するためのファイル、それ以外のsection-*
が各部分のコンテンツのファイル、日英別々のファイルで、です。

en版: https://himorin.github.io/w3c-memo/tools/samples/respec-multipage-lang/sep-en.html

ja版: https://himorin.github.io/w3c-memo/tools/samples/respec-multipage-lang/sep-ja.html

en/ja統合: https://himorin.github.io/w3c-memo/tools/samples/respec-multipage-lang/united.html


 現在のjlreqのように段落ごとに日英を入れ込むようにするとその最小単位でファイルを全部分割することに
なるのでちとあり得ないだろうけれど、sectionあたりで分割して読み込むようにしたら何とかそれなりにまと
まった形になるか?と思っていたのですが、最終的な解決策は見つけられませんでした。
・そもそも日英を入れ子にするような構造をincludeだけで表現しようとすると日・英間遷移カ所で分けることになる
・1.1 (en) -> 1.2 (en) -> 1.1 (ja) -> 1.2 (ja) のような構造はカウンタリセットで可能かもしれないがあまりに不格好
・↑を回避するには最小の<section><hX>で分割するしかないが細かすぎないか?
・入れ子構造をjsで後処理する(かrespecにフックを掛ける)のはあり得るかもしれないが、メンテナンスコストが大きすぎる
というような課題が残ります。


 いかがでしょうか?

Received on Wednesday, 24 August 2022 06:20:41 UTC