diff options
| -rw-r--r-- | org/tests_for_document_abstraction_shell_scripts.org | 150 | ||||
| -rw-r--r-- | test/reference/abstraction/live-manual.ja.ssp | 1788 | ||||
| -rw-r--r-- | test/reference/abstraction/live-manual.pl.ssp | 112 | ||||
| -rwxr-xr-x | test/test-ocn-alignment.sh | 143 |
4 files changed, 1138 insertions, 1055 deletions
diff --git a/org/tests_for_document_abstraction_shell_scripts.org b/org/tests_for_document_abstraction_shell_scripts.org index 793d69f..41ce11e 100644 --- a/org/tests_for_document_abstraction_shell_scripts.org +++ b/org/tests_for_document_abstraction_shell_scripts.org @@ -962,23 +962,26 @@ fi # test-ocn-alignment.sh # # The languages of a document share their object numbering, and spine warns -# when they stop doing so. This checks that the warning appears where it -# should and, just as importantly, nowhere else. -# -# The sample set is the fixture, and it is a good one because it contains -# both answers: -# -# live-manual ten languages, two of which diverge. -# ja has two fewer numbered objects than en. A missing -# translation of a short paragraph; everything below it -# is renumbered. -# pl has the same count, but the object at ocn 313 is a -# paragraph in en and a heading in pl. A heading given as -# running text, or running text given as a heading. -# everything else single language, or aligned. Silent. -# -# A check that only ever fires is as useless as one that never does, so the -# silence over the other documents is asserted too. +# when they stop doing so. This checks both halves of that: that the sample +# set is silent, and that a document whose languages really do diverge is +# reported. +# +# Two fixtures, because one cannot say both things: +# +# the sample set every document aligned, so nothing is reported at +# all. This is the half that would fail if a change +# made the check cry wolf, and the half that changed on +# 2026-09-18 when live-manual's ja and pl translations +# were mended. Until then ja was two objects short of +# en and pl had a stray heading at ocn 313, and this +# script asserted those two by name. +# +# a broken copy live-manual copied out of the sample set with one +# paragraph removed from one language, which is a count +# divergence and must be reported. Built here rather +# than relied upon, so that mending a translation +# cannot quietly leave the check untested. A check that +# never fires proves as little as one that always does. # # It also asserts that --strict turns the warning into a non-zero exit, and # that without --strict the run still succeeds: a document with a diverging @@ -1050,70 +1053,105 @@ if [ "$RUN_RC" -ne 0 ]; then head -5 "$OUT_DIR/run.err" fi -# what it said -if ! grep -q "^WARNING ocn alignment: live-manual$" "$OUT_DIR/run.err"; then - fail "no ocn alignment warning for live-manual" +# it must say nothing at all: every document in the set is aligned +n_docs=$(grep -c "^WARNING ocn alignment: " "$OUT_DIR/run.err" || true) +if [ "$n_docs" != "0" ]; then + fail "$n_docs document(s) reported over the sample set, expected none" + grep -A 3 "^WARNING ocn alignment: " "$OUT_DIR/run.err" | head -12 | sed 's/^/ /' +fi + +# --strict over the whole set therefore passes too +set +e +$SPINE_BIN --show-abstraction --skip-output --strict \ + --output="$OUT_DIR/strict-ok" "$SAMPLES_DIR"/live-manual \ + > "$OUT_DIR/strict-ok.out" 2> "$OUT_DIR/strict-ok.err" +STRICT_OK_RC=$? +set -e +if [ "$STRICT_OK_RC" -ne 0 ]; then + fail "--strict exited $STRICT_OK_RC on a document whose languages agree" + head -5 "$OUT_DIR/strict-ok.err" fi -if ! grep -q "^ \[ja\] differs from \[en\]$" "$OUT_DIR/run.err"; then - fail "ja not reported as differing from en" + +# and now the other half: a document that really does diverge. +# +# Built here, from a copy, by removing one paragraph from one language. The +# sample set no longer contains a divergence, and a check that never fires +# proves as little as one that always does. +echo "Breaking a copy, to see the check fire ..." +BROKEN="$OUT_DIR/broken" +mkdir -p "$BROKEN" +cp -a "$SAMPLES_DIR/live-manual" "$BROKEN/live-manual" +TARGET="$BROKEN/live-manual/media/text/de/about_manual.ssi" +if [ ! -f "$TARGET" ]; then + echo "ERROR: fixture not found: $TARGET" >&2 + exit 2 fi -if ! grep -q "numbered objects: en 1019, ja 1017 (-2)" "$OUT_DIR/run.err"; then - fail "ja's object count difference not reported as -2" +# the first paragraph after the first heading, whole: a numbered object, so +# removing it renumbers everything below it in this language and no other. +# +# The whole of it, to the blank line that ends it. Dropping a single line of +# a wrapped paragraph leaves the paragraph there, one line shorter, and the +# object count unchanged: the first version of this fixture did that and the +# check correctly said nothing. +awk ' + BEGIN { state = 0 } + state == 0 && /^[A-Za-z]/ && !/^[0-9A-D]~/ && !/^:[A-D]~/ && !/^%/ && !/^@/ \ + { state = 1; next } + state == 1 && /^[[:space:]]*$/ { state = 2; next } + state == 1 { next } + { print } +' "$TARGET" > "$TARGET.new" && mv "$TARGET.new" "$TARGET" + +set +e +$SPINE_BIN --show-abstraction --skip-output \ + --output="$OUT_DIR/broken-out" "$BROKEN/live-manual" \ + > "$OUT_DIR/broken.out" 2> "$OUT_DIR/broken.err" +BROKEN_RC=$? +set -e +if [ "$BROKEN_RC" -ne 0 ]; then + fail "the run over the broken copy exited $BROKEN_RC; a warning must not fail a run" + head -5 "$OUT_DIR/broken.err" fi -if ! grep -q "^ \[pl\] differs from \[en\]$" "$OUT_DIR/run.err"; then - fail "pl not reported as differing from en" +if ! grep -q "^WARNING ocn alignment: live-manual$" "$OUT_DIR/broken.err"; then + fail "the removed paragraph was not reported" + head -5 "$OUT_DIR/broken.err" | sed 's/^/ /' fi -if ! grep -q "ocn 313: para in en, heading:2 in pl" "$OUT_DIR/run.err"; then - fail "pl's substituted heading at ocn 313 not reported" +if ! grep -q "^ \[de\] differs from \[en\]$" "$OUT_DIR/broken.err"; then + fail "de not reported as differing from en" fi - -# and what it did not say: exactly one document warned about, exactly two -# languages of it -n_docs=$(grep -c "^WARNING ocn alignment: " "$OUT_DIR/run.err" || true) -if [ "$n_docs" != "1" ]; then - fail "$n_docs documents warned about, expected 1" - grep "^WARNING ocn alignment: " "$OUT_DIR/run.err" | sed 's/^/ /' +if ! grep -q "numbered objects: en .*, de .* (-1)" "$OUT_DIR/broken.err"; then + fail "de's object count not reported as one short" + grep "numbered objects" "$OUT_DIR/broken.err" | sed 's/^/ /' fi -n_langs=$(grep -c "^ \[.*\] differs from " "$OUT_DIR/run.err" || true) -if [ "$n_langs" != "2" ]; then - fail "$n_langs languages reported, expected 2 (ja and pl)" - grep "^ \[.*\] differs from " "$OUT_DIR/run.err" | sed 's/^/ /' +# only the language that was broken +n_langs=$(grep -c "^ \[.*\] differs from " "$OUT_DIR/broken.err" || true) +if [ "$n_langs" != "1" ]; then + fail "$n_langs languages reported on the broken copy, expected 1 (de)" + grep "^ \[.*\] differs from " "$OUT_DIR/broken.err" | sed 's/^/ /' fi -# --strict makes the same run fail +# and --strict makes that a failed run set +e $SPINE_BIN --show-abstraction --skip-output --strict \ - --output="$OUT_DIR/strict" "$SAMPLES_DIR"/live-manual \ - > "$OUT_DIR/strict.out" 2> "$OUT_DIR/strict.err" + --output="$OUT_DIR/broken-strict" "$BROKEN/live-manual" \ + > "$OUT_DIR/broken-strict.out" 2> "$OUT_DIR/broken-strict.err" STRICT_RC=$? set -e if [ "$STRICT_RC" -eq 0 ]; then fail "--strict exited 0 on a document whose languages diverge" fi -# and does not fail a document whose languages agree, or one that has only -# the one language -set +e -$SPINE_BIN --show-abstraction --skip-output --strict \ - --output="$OUT_DIR/strict-ok" "$SAMPLES_DIR"/the_wealth_of_networks.yochai_benkler \ - > "$OUT_DIR/strict-ok.out" 2> "$OUT_DIR/strict-ok.err" -STRICT_OK_RC=$? -set -e -if [ "$STRICT_OK_RC" -ne 0 ]; then - fail "--strict exited $STRICT_OK_RC on a single language document" - head -5 "$OUT_DIR/strict-ok.err" -fi - rm -rf "$OUT_DIR" if [ "$FAILURES" -eq 0 ]; then - echo "PASS: ja and pl reported on live-manual, silent elsewhere, --strict fails" + echo "PASS: the sample set is aligned, a broken copy is reported, --strict fails" exit 0 else echo "FAIL: $FAILURES check(s)" exit 1 fi #+END_SRC + ** 6. test acceptance db to pod #+HEADER: :tangle ../test/test-acceptance-db-to-pod.sh diff --git a/test/reference/abstraction/live-manual.ja.ssp b/test/reference/abstraction/live-manual.ja.ssp index ac388fd..fa0db66 100644 --- a/test/reference/abstraction/live-manual.ja.ssp +++ b/test/reference/abstraction/live-manual.ja.ssp @@ -4,7 +4,7 @@ @source { language: ja languages: en ca de es fr it ja pl pt_BR ro - digest: 205366BB690824DB455DDD766CACD2ABACD38D9ECA7A3BB797321C0152A9FDC6 + digest: 06AFB533C5CDCC27A5C42346F113C2F87B1274300D592CC39437198DDF7FC8CD } @meta { @@ -45,8 +45,8 @@ [1] heading :A .part: body .section: body -.last_descendant: 1017 -.children: 2 3 72 106 107 157 296 329 355 368 497 527 615 630 651 652 680 737 783 803 820 821 911 912 +.last_descendant: 1019 +.children: 2 3 72 106 107 157 296 329 355 368 497 527 615 630 651 652 680 737 783 803 822 823 913 914 .ancestors: 1 0 0 0 0 0 0 0 .ancestors_collapsed: 1 0 0 0 0 0 0 0 .dom_status: 1 0 0 0 0 0 0 0 @@ -1399,7 +1399,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥リポジトリを複数処理┝┤#816├ +| ┥リポジトリを複数処理┝┤#818├ [0] toc .part: frontmatter @@ -1407,7 +1407,7 @@ .is_of_type: para .indent: 1 1 .has: links -| ┥例┝┤#820├ +| ┥例┝┤#822├ [0] toc .part: frontmatter @@ -1415,7 +1415,7 @@ .is_of_type: para .indent: 1 1 .has: links -| ┥例┝┤#821├ +| ┥例┝┤#823├ [0] toc .part: frontmatter @@ -1423,7 +1423,7 @@ .is_of_type: para .indent: 4 4 .has: links -| ┥例┝┤#822├ +| ┥例┝┤#824├ [0] toc .part: frontmatter @@ -1431,7 +1431,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥例の使用┝┤#824├ +| ┥例の使用┝┤#826├ [0] toc .part: frontmatter @@ -1439,7 +1439,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥チュートリアル 1: デフォルトイメージ┝┤#828├ +| ┥チュートリアル 1: デフォルトイメージ┝┤#830├ [0] toc .part: frontmatter @@ -1447,7 +1447,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥チュートリアル 2: ウェブブラウザユーティリティ┝┤#837├ +| ┥チュートリアル 2: ウェブブラウザユーティリティ┝┤#839├ [0] toc .part: frontmatter @@ -1455,7 +1455,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥チュートリアル 3: 私的イメージ┝┤#845├ +| ┥チュートリアル 3: 私的イメージ┝┤#847├ [0] toc .part: frontmatter @@ -1463,7 +1463,7 @@ .is_of_type: para .indent: 6 6 .has: links -| ┥最初の改訂┝┤#848├ +| ┥最初の改訂┝┤#850├ [0] toc .part: frontmatter @@ -1471,7 +1471,7 @@ .is_of_type: para .indent: 6 6 .has: links -| ┥2回目の改訂┝┤#862├ +| ┥2回目の改訂┝┤#864├ [0] toc .part: frontmatter @@ -1479,7 +1479,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥VNC 公衆クライアント┝┤#874├ +| ┥VNC 公衆クライアント┝┤#876├ [0] toc .part: frontmatter @@ -1487,7 +1487,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥128MB USB メモリ向けの基本イメージ┝┤#888├ +| ┥128MB USB メモリ向けの基本イメージ┝┤#890├ [0] toc .part: frontmatter @@ -1495,7 +1495,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥地域化した GNOME デスクトップとインストーラ┝┤#899├ +| ┥地域化した GNOME デスクトップとインストーラ┝┤#901├ [0] toc .part: frontmatter @@ -1503,7 +1503,7 @@ .is_of_type: para .indent: 1 1 .has: links -| ┥付録┝┤#911├ +| ┥付録┝┤#913├ [0] toc .part: frontmatter @@ -1511,7 +1511,7 @@ .is_of_type: para .indent: 1 1 .has: links -| ┥スタイルガイド┝┤#912├ +| ┥スタイルガイド┝┤#914├ [0] toc .part: frontmatter @@ -1519,7 +1519,7 @@ .is_of_type: para .indent: 4 4 .has: links -| ┥スタイルガイド┝┤#913├ +| ┥スタイルガイド┝┤#915├ [0] toc .part: frontmatter @@ -1527,7 +1527,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥著者向けガイドライン┝┤#914├ +| ┥著者向けガイドライン┝┤#916├ [0] toc .part: frontmatter @@ -1535,7 +1535,7 @@ .is_of_type: para .indent: 6 6 .has: links -| ┥言語特性┝┤#917├ +| ┥言語特性┝┤#919├ [0] toc .part: frontmatter @@ -1543,7 +1543,7 @@ .is_of_type: para .indent: 6 6 .has: links -| ┥手順┝┤#950├ +| ┥手順┝┤#952├ [0] toc .part: frontmatter @@ -1551,7 +1551,7 @@ .is_of_type: para .indent: 5 5 .has: links -| ┥翻訳者向けガイドライン┝┤#989├ +| ┥翻訳者向けガイドライン┝┤#991├ [0] toc .part: frontmatter @@ -1559,7 +1559,7 @@ .is_of_type: para .indent: 6 6 .has: links -| ┥翻訳の手がかり┝┤#993├ +| ┥翻訳の手がかり┝┤#995├ } @@ -13041,7 +13041,7 @@ [803] heading :B .part: body .parent: 1 -.last_descendant: 819 +.last_descendant: 821 .children: 804 .ancestors: 1 803 0 0 0 0 0 0 .ancestors_collapsed: 1 803 0 0 0 0 0 0 @@ -13061,8 +13061,8 @@ [804] heading :1 .part: body .parent: 803 -.last_descendant: 819 -.children: 816 +.last_descendant: 821 +.children: 818 .ancestors: 1 803 0 0 804 0 0 0 .ancestors_collapsed: 1 803 804 0 0 0 0 0 .dom_status: 4 4 0 0 1 0 0 0 @@ -13079,7 +13079,7 @@ .segment_html_is: git-repositories .segment_epub_is: git-repositories .heading_ancestors_text: Live システムマニュアル|Gitリポジトリ|||Gitリポジトリ||| -.lev4_subtoc: 5~ ┥リポジトリを複数処理┝┤#816├ +.lev4_subtoc: 5~ ┥リポジトリを複数処理┝┤#818├ | Gitリポジトリ [805] para @@ -13108,7 +13108,19 @@ .segment_epub_is: git-repositories | ░$░git░clone░git://live-systems.org/git/live-manual.git -[807] code +[807] para +.part: body +.parent: 804 +.ancestors: 1 803 0 0 804 0 0 0 +.ancestors_collapsed: 1 803 804 0 0 0 0 0 +.parent_lev: 4 +.is_of_type: para +.sha256: E34C246FB759D8B8AA2AF9999B23AA3519832A35675076E016771881EF31294D +.segment_html_is: git-repositories +.segment_epub_is: git-repositories +| Or, + +[808] code .part: body .parent: 804 .ancestors: 1 803 0 0 804 0 0 0 @@ -13120,7 +13132,19 @@ .segment_epub_is: git-repositories | ░$░git░clone░https://live-systems.org/git/live-manual.git -[808] code +[809] para +.part: body +.parent: 804 +.ancestors: 1 803 0 0 804 0 0 0 +.ancestors_collapsed: 1 803 804 0 0 0 0 0 +.parent_lev: 4 +.is_of_type: para +.sha256: E34C246FB759D8B8AA2AF9999B23AA3519832A35675076E016771881EF31294D +.segment_html_is: git-repositories +.segment_epub_is: git-repositories +| Or, + +[810] code .part: body .parent: 804 .ancestors: 1 803 0 0 804 0 0 0 @@ -13132,7 +13156,7 @@ .segment_epub_is: git-repositories | ░$░git░clone░http://live-systems.org/git/live-manual.git -[809] para +[811] para .part: body .parent: 804 .ancestors: 1 803 0 0 804 0 0 0 @@ -13144,7 +13168,7 @@ .segment_epub_is: git-repositories | のどれかを実行します。書き込み権限のある複製には ⑆■┨git@live-systems.org:/リポジトリ┣■という形式のアドレスを使います。 -[810] para +[812] para .part: body .parent: 804 .ancestors: 1 803 0 0 804 0 0 0 @@ -13156,7 +13180,7 @@ .segment_epub_is: git-repositories | なので、繰り返しますが live-manual をssh経由で複製するには -[811] code +[813] code .part: body .parent: 804 .ancestors: 1 803 0 0 804 0 0 0 @@ -13168,7 +13192,7 @@ .segment_epub_is: git-repositories | ░$░git░clone░git@live-systems.org:live-manual.git -[812] para +[814] para .part: body .parent: 804 .ancestors: 1 803 0 0 804 0 0 0 @@ -13180,7 +13204,7 @@ .segment_epub_is: git-repositories | と入力する必要があります。gitツリーは複数の異なるブランチでできています。⑆*┨debian┣* 及び ⑆*┨debian-next┣* ブランチは最終的には新しいリリースそれぞれに収録される実際の作業を収録しているため特に注目すべきです。 -[813] para +[815] para .part: body .parent: 804 .ancestors: 1 803 0 0 804 0 0 0 @@ -13192,7 +13216,7 @@ .segment_epub_is: git-repositories | 既存のリポジトリのどれかを複製した後は ⑆*┨debian┣* ブランチにいるでしょう。これはプロジェクトの最新リリースの状態を確認するには適切ですが、作業開始前に必ず ⑆*┨debian-next┣* ブランチに切り替える必要があります。切り替えには -[814] code +[816] code .part: body .parent: 804 .ancestors: 1 803 0 0 804 0 0 0 @@ -13204,7 +13228,7 @@ .segment_epub_is: git-repositories | ░$░git░checkout░debian-next -[815] para +[817] para .part: body .parent: 804 .ancestors: 1 803 0 0 804 0 0 0 @@ -13216,12 +13240,12 @@ .segment_epub_is: git-repositories | を実行します。⑆*┨debian-next┣* ブランチは常に fast-forward とは限らず、あらゆる変更が ⑆*┨debian┣* ブランチにマージされる前にまずはこにコミットされます。例えて言えばテストの場のようなものです。このブランチで作業していてサーバにある変更を取得する必要がある場合は ⑆■┨git pull --rebase┣■ を実行する必要があります。それにより、サーバから取得するときにローカルでの変更が反映され、その変更が最上位に配置されます。 -[816] heading :2 +[818] heading :2 .part: body .parent: 804 -.last_descendant: 819 -.ancestors: 1 803 0 0 804 816 0 0 -.ancestors_collapsed: 1 803 804 816 0 0 0 0 +.last_descendant: 821 +.ancestors: 1 803 0 0 804 818 0 0 +.ancestors_collapsed: 1 803 804 818 0 0 0 0 .dom_status: 4 4 0 0 4 1 0 0 .dom_status_collapsed: 4 4 4 1 0 0 0 0 .heading_lev_collapsed: 3 @@ -13235,11 +13259,11 @@ .heading_ancestors_text: Live システムマニュアル|Gitリポジトリ|||Gitリポジトリ|リポジトリを複数処理|| | リポジトリを複数処理 -[817] para +[819] para .part: body -.parent: 816 -.ancestors: 1 803 0 0 804 816 0 0 -.ancestors_collapsed: 1 803 804 816 0 0 0 0 +.parent: 818 +.ancestors: 1 803 0 0 804 818 0 0 +.ancestors_collapsed: 1 803 804 818 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 1C127E0D87BDCCD42B2CE33EEF5EEEB62F4E3375F4F8F2D19A80B490258D9BE5 @@ -13247,11 +13271,11 @@ .segment_epub_is: git-repositories | Live システムのリポジトリを複数複製してすぐに、最新コードの確認、パッチ作成、あるいは翻訳での貢献等のために ⑆*┨debian-next┣* ブランチに切り替えたい場合、複数のリポジトリを扱いやすくするための ⑆■┨mrconfig┣■ ファイルをgitサーバで提供していることを紫知っておくべきでしょう。これを使うには ⑆/┨mr┣/ パッケージをインストールする必要があります。その後、 -[818] code +[820] code .part: body -.parent: 816 -.ancestors: 1 803 0 0 804 816 0 0 -.ancestors_collapsed: 1 803 804 816 0 0 0 0 +.parent: 818 +.ancestors: 1 803 0 0 804 818 0 0 +.ancestors_collapsed: 1 803 804 818 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: F2D87B10E44EA74E37E748CCFD616338A5B20CD15427FB4DF3F44EC64087F499 @@ -13259,11 +13283,11 @@ .segment_epub_is: git-repositories | ░$░░mr░bootstrap░http://live-systems.org/other/mr/mrconfig -[819] para +[821] para .part: body -.parent: 816 -.ancestors: 1 803 0 0 804 816 0 0 -.ancestors_collapsed: 1 803 804 816 0 0 0 0 +.parent: 818 +.ancestors: 1 803 0 0 804 818 0 0 +.ancestors_collapsed: 1 803 804 818 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: CFE8056CA57949FDA1D102500F9AE84EAE5A8104C0E91F690BD86B461E16AE8A @@ -13272,12 +13296,12 @@ .segment_epub_is: git-repositories | を実行します。このコマンドは自動的に複製し、プロジェクトにより作成される Debian パッケージの開発用リポジトリである ⑆*┨debian-next┣* ブランチを取得します。これには、中でも live-images リポジトリがあり、プロジェクトが一般用途向けに公開しているビルド済みイメージで利用される設定を収録しています。このリポジトリの使い方に関するさらなる情報については、{Git経由で公開されている設定の複製}#clone-configuration-via-git を見てください。 -[820] heading :B +[822] heading :B .part: body .parent: 1 -.last_descendant: 820 -.ancestors: 1 820 0 0 0 0 0 0 -.ancestors_collapsed: 1 820 0 0 0 0 0 0 +.last_descendant: 822 +.ancestors: 1 822 0 0 0 0 0 0 +.ancestors_collapsed: 1 822 0 0 0 0 0 0 .dom_status: 4 3 0 0 2 2 0 0 .dom_status_collapsed: 4 3 2 2 0 0 0 0 .heading_lev_collapsed: 1 @@ -13291,13 +13315,13 @@ .heading_ancestors_text: Live システムマニュアル|例|||||| | 例 -[821] heading :B +[823] heading :B .part: body .parent: 1 -.last_descendant: 910 -.children: 822 -.ancestors: 1 821 0 0 0 0 0 0 -.ancestors_collapsed: 1 821 0 0 0 0 0 0 +.last_descendant: 912 +.children: 824 +.ancestors: 1 823 0 0 0 0 0 0 +.ancestors_collapsed: 1 823 0 0 0 0 0 0 .dom_status: 4 3 0 0 0 0 0 0 .dom_status_collapsed: 4 3 0 0 0 0 0 0 .heading_lev_collapsed: 1 @@ -13311,13 +13335,13 @@ .heading_ancestors_text: Live システムマニュアル|例|||||| | 例 -[822] heading :1 +[824] heading :1 .part: body -.parent: 821 -.last_descendant: 910 -.children: 824 828 837 845 874 888 899 -.ancestors: 1 821 0 0 822 0 0 0 -.ancestors_collapsed: 1 821 822 0 0 0 0 0 +.parent: 823 +.last_descendant: 912 +.children: 826 830 839 847 876 890 901 +.ancestors: 1 823 0 0 824 0 0 0 +.ancestors_collapsed: 1 823 824 0 0 0 0 0 .dom_status: 4 4 0 0 1 0 0 0 .dom_status_collapsed: 4 4 1 0 0 0 0 0 .heading_lev_collapsed: 2 @@ -13332,22 +13356,22 @@ .segment_html_is: examples .segment_epub_is: examples .heading_ancestors_text: Live システムマニュアル|例|||例||| -.lev4_subtoc: 5~ ┥例の使用┝┤#824├ -.lev4_subtoc: 5~ ┥チュートリアル 1: デフォルトイメージ┝┤#828├ -.lev4_subtoc: 5~ ┥チュートリアル 2: ウェブブラウザユーティリティ┝┤#837├ -.lev4_subtoc: 5~ ┥チュートリアル 3: 私的イメージ┝┤#845├ -.lev4_subtoc: 6~ ┥最初の改訂┝┤#848├ -.lev4_subtoc: 6~ ┥2回目の改訂┝┤#862├ -.lev4_subtoc: 5~ ┥VNC 公衆クライアント┝┤#874├ -.lev4_subtoc: 5~ ┥128MB USB メモリ向けの基本イメージ┝┤#888├ -.lev4_subtoc: 5~ ┥地域化した GNOME デスクトップとインストーラ┝┤#899├ +.lev4_subtoc: 5~ ┥例の使用┝┤#826├ +.lev4_subtoc: 5~ ┥チュートリアル 1: デフォルトイメージ┝┤#830├ +.lev4_subtoc: 5~ ┥チュートリアル 2: ウェブブラウザユーティリティ┝┤#839├ +.lev4_subtoc: 5~ ┥チュートリアル 3: 私的イメージ┝┤#847├ +.lev4_subtoc: 6~ ┥最初の改訂┝┤#850├ +.lev4_subtoc: 6~ ┥2回目の改訂┝┤#864├ +.lev4_subtoc: 5~ ┥VNC 公衆クライアント┝┤#876├ +.lev4_subtoc: 5~ ┥128MB USB メモリ向けの基本イメージ┝┤#890├ +.lev4_subtoc: 5~ ┥地域化した GNOME デスクトップとインストーラ┝┤#901├ | 例 -[823] para +[825] para .part: body -.parent: 822 -.ancestors: 1 821 0 0 822 0 0 0 -.ancestors_collapsed: 1 821 822 0 0 0 0 0 +.parent: 824 +.ancestors: 1 823 0 0 824 0 0 0 +.ancestors_collapsed: 1 823 824 0 0 0 0 0 .parent_lev: 4 .is_of_type: para .sha256: 865FC3A0BF14E91338CAAAFFD56DE05F77D576070753403B9AC3590B36CB18E8 @@ -13355,12 +13379,12 @@ .segment_epub_is: examples | この章では特定の Live システム活用事例向けの見本ビルドについて触れます。自分用の Live システムイメージのビルドが初めてであれば、まず3つのチュートリアルを順に調べてみることを勧めます。それぞれで他の例の利用、理解を支援する新しい技術を学ぶようになっているためです。 -[824] heading :2 +[826] heading :2 .part: body -.parent: 822 -.last_descendant: 827 -.ancestors: 1 821 0 0 822 824 0 0 -.ancestors_collapsed: 1 821 822 824 0 0 0 0 +.parent: 824 +.last_descendant: 829 +.ancestors: 1 823 0 0 824 826 0 0 +.ancestors_collapsed: 1 823 824 826 0 0 0 0 .dom_status: 4 4 0 0 4 1 0 0 .dom_status_collapsed: 4 4 4 1 0 0 0 0 .heading_lev_collapsed: 3 @@ -13375,11 +13399,11 @@ .heading_ancestors_text: Live システムマニュアル|例|||例|例の使用|| | 例の使用 -[825] para +[827] para .part: body -.parent: 824 -.ancestors: 1 821 0 0 822 824 0 0 -.ancestors_collapsed: 1 821 822 824 0 0 0 0 +.parent: 826 +.ancestors: 1 823 0 0 824 826 0 0 +.ancestors_collapsed: 1 823 824 826 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 98ED950B0FB1CEA974D22713CE00C74FF71E03244C7A50980C74C6F978FB2C1C @@ -13388,11 +13412,11 @@ .segment_epub_is: examples | 提示している例を利用するためには、ビルドするために{要件}#requirements に記載されている要件一覧に合致するシステムと、{live-build のインストール}#installing-live-build で説明しているように live-build がインストールされていることが必要となります。 -[826] para +[828] para .part: body -.parent: 824 -.ancestors: 1 821 0 0 822 824 0 0 -.ancestors_collapsed: 1 821 822 824 0 0 0 0 +.parent: 826 +.ancestors: 1 823 0 0 824 826 0 0 +.ancestors_collapsed: 1 823 824 826 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: CC611A715A8FBA7843BF0045AC67098EAF1FB2D40558E0CC5949F07445F3C273 @@ -13401,11 +13425,11 @@ .segment_epub_is: examples | 簡潔にするため、ここに挙げる例ではビルドで利用するローカルミラーを指定していないことに注意してください。ローカルミラーを利用するとダウンロード速度をかなり高速化できます。{ビルド時に利用するディストリビューションのミラー}#distribution-mirrors-build-time で説明しているように、⑆■┨lb config┣■ を使った場合はオプションを指定することができます。ビルドシステムのデフォルト値を ⑆■┨/etc/live/build.conf┣■ でセットするともっと便利になります。このファイルを単純に作成し、対応する ⑆■┨LB_MIRROR_*┣■ 変数に望ましいミラーをセットしてください。ビルドで利用する他のミラーは全て、これにより設定した値をデフォルト値として使います。例えば: -[827] code +[829] code .part: body -.parent: 824 -.ancestors: 1 821 0 0 822 824 0 0 -.ancestors_collapsed: 1 821 822 824 0 0 0 0 +.parent: 826 +.ancestors: 1 823 0 0 824 826 0 0 +.ancestors_collapsed: 1 823 824 826 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: C544C3489C562A527F31E3D46B7798DFF1324763822E736FAB20D1ABB9B1C6CE @@ -13415,12 +13439,12 @@ | ░LB_MIRROR_CHROOT_SECURITY="http://mirror/debian-security/" | ░LB_MIRROR_CHROOT_BACKPORTS="http://mirror/debian-backports/" -[828] heading :2 +[830] heading :2 .part: body -.parent: 822 -.last_descendant: 836 -.ancestors: 1 821 0 0 822 828 0 0 -.ancestors_collapsed: 1 821 822 828 0 0 0 0 +.parent: 824 +.last_descendant: 838 +.ancestors: 1 823 0 0 824 830 0 0 +.ancestors_collapsed: 1 823 824 830 0 0 0 0 .dom_status: 4 4 0 0 4 3 0 0 .dom_status_collapsed: 4 4 4 3 0 0 0 0 .heading_lev_collapsed: 3 @@ -13435,11 +13459,11 @@ .heading_ancestors_text: Live システムマニュアル|例|||例|チュートリアル 1: デフォルトイメージ|| | チュートリアル 1: デフォルトイメージ -[829] para +[831] para .part: body -.parent: 828 -.ancestors: 1 821 0 0 822 828 0 0 -.ancestors_collapsed: 1 821 822 828 0 0 0 0 +.parent: 830 +.ancestors: 1 823 0 0 824 830 0 0 +.ancestors_collapsed: 1 823 824 830 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 2B6321ECAD1EF5051C56102EEB1A90649C944545E06E96CAFEDC3E78693B2969 @@ -13447,11 +13471,11 @@ .segment_epub_is: examples | ⑆*┨事例:┣* 簡単な最初のイメージを作成して live-build の基礎を学びます。 -[830] para +[832] para .part: body -.parent: 828 -.ancestors: 1 821 0 0 822 828 0 0 -.ancestors_collapsed: 1 821 822 828 0 0 0 0 +.parent: 830 +.ancestors: 1 823 0 0 824 830 0 0 +.ancestors_collapsed: 1 823 824 830 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: DEECE5784195D8A96864576C8E14B9BE9059E809E75F870D2ECAF2A50B9D0B16 @@ -13459,11 +13483,11 @@ .segment_epub_is: examples | このチュートリアルでは、live-build を利用した最初の演習としてbase パッケージ (Xorg は含まない) と Live システムを支援するパッケージだけを収録する、デフォルトの ISO hybrid 形式の Live システムイメージをビルドします。 -[831] para +[833] para .part: body -.parent: 828 -.ancestors: 1 821 0 0 822 828 0 0 -.ancestors_collapsed: 1 821 822 828 0 0 0 0 +.parent: 830 +.ancestors: 1 823 0 0 824 830 0 0 +.ancestors_collapsed: 1 823 824 830 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 9669DC7CC5914BF1F68466674A79F31E96F4C3081D12E872E2EA0DF381F9CF57 @@ -13471,11 +13495,11 @@ .segment_epub_is: examples | これ以上簡単にすることはなかなかできないでしょう: -[832] code +[834] code .part: body -.parent: 828 -.ancestors: 1 821 0 0 822 828 0 0 -.ancestors_collapsed: 1 821 822 828 0 0 0 0 +.parent: 830 +.ancestors: 1 823 0 0 824 830 0 0 +.ancestors_collapsed: 1 823 824 830 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: F20B382A4D7C1277DC82F5BC6AB23E77B20DC824AD3BCE88C1CA9B5BE0126A31 @@ -13483,11 +13507,11 @@ .segment_epub_is: examples | ░$░mkdir░tutorial1░;░cd░tutorial1░;░lb░config -[833] para +[835] para .part: body -.parent: 828 -.ancestors: 1 821 0 0 822 828 0 0 -.ancestors_collapsed: 1 821 822 828 0 0 0 0 +.parent: 830 +.ancestors: 1 823 0 0 824 830 0 0 +.ancestors_collapsed: 1 823 824 830 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: E83D685101DB5E7E513C0DF000F3195ECD34D4533E96DCE6A30C9D08A980752D @@ -13495,11 +13519,11 @@ .segment_epub_is: examples | 何か望むことがあれば ⑆■┨config/┣■ ディレクトリの内容を調べてください。ここには概略の設定があり、すぐ独自化もできますが、ここではそのままでデフォルトのイメージをビルドします。 -[834] para +[836] para .part: body -.parent: 828 -.ancestors: 1 821 0 0 822 828 0 0 -.ancestors_collapsed: 1 821 822 828 0 0 0 0 +.parent: 830 +.ancestors: 1 823 0 0 824 830 0 0 +.ancestors_collapsed: 1 823 824 830 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 69BE992B5B310A24EF283661075A2AD674E6DEA15BCEB5B265A87ED2D50E49A4 @@ -13507,11 +13531,11 @@ .segment_epub_is: examples | スーパーユーザでイメージをビルドし、そのログを ⑆■┨tee┣■ により保存します。 -[835] code +[837] code .part: body -.parent: 828 -.ancestors: 1 821 0 0 822 828 0 0 -.ancestors_collapsed: 1 821 822 828 0 0 0 0 +.parent: 830 +.ancestors: 1 823 0 0 824 830 0 0 +.ancestors_collapsed: 1 823 824 830 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: F56DADBE38650805A8F6ACD6FBE1F7D3C4A8071734212646D60F09F50EEE75ED @@ -13519,11 +13543,11 @@ .segment_epub_is: examples | ░#░lb░build░2>&1░|░tee░build.log -[836] para +[838] para .part: body -.parent: 828 -.ancestors: 1 821 0 0 822 828 0 0 -.ancestors_collapsed: 1 821 822 828 0 0 0 0 +.parent: 830 +.ancestors: 1 823 0 0 824 830 0 0 +.ancestors_collapsed: 1 823 824 830 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 9E6D88FC84EF4E6951B4DB3BB214C0507FE34AE2332E724B741AB4830231CE12 @@ -13532,12 +13556,12 @@ .segment_epub_is: examples | すべてがうまくいくとして、しばらくすると現在のディレクトリに ⑆■┨live-image-i386.hybrid.iso┣■ が出来上がります。この ISO hybrid イメージは ┥Qemu でのISOイメージのテスト┝┤#testing-iso-with-qemu├ や ┥VirtualBox でのISOイメージのテスト┝┤#testing-iso-with-virtualbox├ で説明しているように仮想マシンで直接、あるいは{物理メディアへのISOイメージ書き込み}#burning-iso-image や ┥USBメモリへの ISO hybrid イメージのコピー┝┤#copying-iso-hybrid-to-usb├ で説明しているように光学メディアやUSBフラッシュ機器に書き込んだイメージ、それぞれからブートできます。 -[837] heading :2 +[839] heading :2 .part: body -.parent: 822 -.last_descendant: 844 -.ancestors: 1 821 0 0 822 837 0 0 -.ancestors_collapsed: 1 821 822 837 0 0 0 0 +.parent: 824 +.last_descendant: 846 +.ancestors: 1 823 0 0 824 839 0 0 +.ancestors_collapsed: 1 823 824 839 0 0 0 0 .dom_status: 4 4 0 0 4 3 0 0 .dom_status_collapsed: 4 4 4 3 0 0 0 0 .heading_lev_collapsed: 3 @@ -13552,11 +13576,11 @@ .heading_ancestors_text: Live システムマニュアル|例|||例|チュートリアル 2: ウェブブラウザユーティリティ|| | チュートリアル 2: ウェブブラウザユーティリティ -[838] para +[840] para .part: body -.parent: 837 -.ancestors: 1 821 0 0 822 837 0 0 -.ancestors_collapsed: 1 821 822 837 0 0 0 0 +.parent: 839 +.ancestors: 1 823 0 0 824 839 0 0 +.ancestors_collapsed: 1 823 824 839 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 5DB64526EF89A1BB85C7F5627DA8674B2AA320B95CDAD4B8B5F5A2C8060F2883 @@ -13564,11 +13588,11 @@ .segment_epub_is: examples | ⑆*┨事例:┣* ウェブブラウザユーティリティイメージを作成し、独自化の適用方法を学びます。 -[839] para +[841] para .part: body -.parent: 837 -.ancestors: 1 821 0 0 822 837 0 0 -.ancestors_collapsed: 1 821 822 837 0 0 0 0 +.parent: 839 +.ancestors: 1 823 0 0 824 839 0 0 +.ancestors_collapsed: 1 823 824 839 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 2053A5088F382FE3E65E700D72860B53F570432D449C4A70CD205384969FE92B @@ -13576,11 +13600,11 @@ .segment_epub_is: examples | このチュートリアルでは Live システムイメージを独自化する方法の紹介として、ウェブブラウザユーティリティとしての利用に適するイメージを作成します。 -[840] code +[842] code .part: body -.parent: 837 -.ancestors: 1 821 0 0 822 837 0 0 -.ancestors_collapsed: 1 821 822 837 0 0 0 0 +.parent: 839 +.ancestors: 1 823 0 0 824 839 0 0 +.ancestors_collapsed: 1 823 824 839 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: 77AA322196DC99C1B3E55A846AFAE24EDDEDFC9C769F6F212754873FDA9AC32F @@ -13591,11 +13615,11 @@ | ░$░lb░config | ░$░echo░"task-lxde-desktop░iceweasel"░>>░config/package-lists/my.list.chroot -[841] para +[843] para .part: body -.parent: 837 -.ancestors: 1 821 0 0 822 837 0 0 -.ancestors_collapsed: 1 821 822 837 0 0 0 0 +.parent: 839 +.ancestors: 1 823 0 0 824 839 0 0 +.ancestors_collapsed: 1 823 824 839 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: ED4879F2C5577E7CF6A8F0F206D82C859708CD4AE639FC3D0EB71A494BD96D89 @@ -13603,11 +13627,11 @@ .segment_epub_is: examples | この例で LXDE を選択しているのは最小限のデスクトップ環境を提供するという私達の目的を反映しています。念頭に置いているこのイメージの目的はただ一つ、ウェブブラウザだけだからです。もっと細かく、⑆■┨config/includes.chroot/etc/iceweasel/profile/┣■ でのウェブブラウザ向けデフォルト設定やウェブ上の様々な種類の内容を表示するための追加のサポートパッケージを提供することはできますが、それは読み手の演習として残しておきます。 -[842] para +[844] para .part: body -.parent: 837 -.ancestors: 1 821 0 0 822 837 0 0 -.ancestors_collapsed: 1 821 822 837 0 0 0 0 +.parent: 839 +.ancestors: 1 823 0 0 824 839 0 0 +.ancestors_collapsed: 1 823 824 839 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: E6607938A154E7AC1A75E4AC499EFE6B14FA9F174DE14769D3AE3FEDEB5AD924 @@ -13616,11 +13640,11 @@ .segment_epub_is: examples | ┥チュートリアル 1┝┤#tutorial-1├ と同様、ここでもスーパーユーザでイメージをビルドし、ログを残します: -[843] code +[845] code .part: body -.parent: 837 -.ancestors: 1 821 0 0 822 837 0 0 -.ancestors_collapsed: 1 821 822 837 0 0 0 0 +.parent: 839 +.ancestors: 1 823 0 0 824 839 0 0 +.ancestors_collapsed: 1 823 824 839 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: F56DADBE38650805A8F6ACD6FBE1F7D3C4A8071734212646D60F09F50EEE75ED @@ -13628,11 +13652,11 @@ .segment_epub_is: examples | ░#░lb░build░2>&1░|░tee░build.log -[844] para +[846] para .part: body -.parent: 837 -.ancestors: 1 821 0 0 822 837 0 0 -.ancestors_collapsed: 1 821 822 837 0 0 0 0 +.parent: 839 +.ancestors: 1 823 0 0 824 839 0 0 +.ancestors_collapsed: 1 823 824 839 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 465E7884926DA203DAF8CAF51F9E7F27CA556009CAA84A9886A8FCF059747F8A @@ -13641,13 +13665,13 @@ .segment_epub_is: examples | ここでも{チュートリアル 1}#tutorial-1 と同様、イメージがうまくできているか検証し、テストします。 -[845] heading :2 +[847] heading :2 .part: body -.parent: 822 -.last_descendant: 873 -.children: 848 862 -.ancestors: 1 821 0 0 822 845 0 0 -.ancestors_collapsed: 1 821 822 845 0 0 0 0 +.parent: 824 +.last_descendant: 875 +.children: 850 864 +.ancestors: 1 823 0 0 824 847 0 0 +.ancestors_collapsed: 1 823 824 847 0 0 0 0 .dom_status: 4 4 0 0 4 3 0 0 .dom_status_collapsed: 4 4 4 3 0 0 0 0 .heading_lev_collapsed: 3 @@ -13662,11 +13686,11 @@ .heading_ancestors_text: Live システムマニュアル|例|||例|チュートリアル 3: 私的イメージ|| | チュートリアル 3: 私的イメージ -[846] para +[848] para .part: body -.parent: 845 -.ancestors: 1 821 0 0 822 845 0 0 -.ancestors_collapsed: 1 821 822 845 0 0 0 0 +.parent: 847 +.ancestors: 1 823 0 0 824 847 0 0 +.ancestors_collapsed: 1 823 824 847 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: BB6A99676FD0B02EAC98B1F1B74A6A4825B23685E972A0F7A4873047B006B3AD @@ -13674,11 +13698,11 @@ .segment_epub_is: examples | ⑆*┨事例:┣* プロジェクトを作成して個人用イメージをビルドします。USBメモリを使って好みのソフトウェアを自由に収録し、要求や設定を変更しながらこのイメージを続けて改訂します。 -[847] para +[849] para .part: body -.parent: 845 -.ancestors: 1 821 0 0 822 845 0 0 -.ancestors_collapsed: 1 821 822 845 0 0 0 0 +.parent: 847 +.ancestors: 1 823 0 0 824 847 0 0 +.ancestors_collapsed: 1 823 824 847 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 4B6FD9DD44167FF9BD6A36E05508B1D4852B49DCD90D0D70C21B8FA2153F604C @@ -13687,12 +13711,12 @@ .segment_epub_is: examples | この個人用イメージを何度も改訂し、変更を追跡しておいて実験的に試してみてうまくいかなかったときには差し戻せるようにしたいため、人気のある⑆■┨git┣■バージョン管理システムに設定を残します。{設定管理}#managing-a-configuration で説明している ⑆■┨auto┣■ スクリプトによる自動設定を経由した最善の実践も利用します。 -[848] heading :3 +[850] heading :3 .part: body -.parent: 845 -.last_descendant: 861 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 847 +.last_descendant: 863 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .dom_status: 4 4 0 0 4 4 1 0 .dom_status_collapsed: 4 4 4 4 1 0 0 0 .heading_lev_collapsed: 4 @@ -13706,11 +13730,11 @@ .heading_ancestors_text: Live システムマニュアル|例|||例|チュートリアル 3: 私的イメージ|最初の改訂| | 最初の改訂 -[849] code +[851] code .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: 706D5CEFF16EF53692D1D9F94662D84A4D6231DEDEA329F53EED17D868C702E6 @@ -13720,11 +13744,11 @@ | ░$░cp░/usr/share/doc/live-build/examples/auto/*░tutorial3/auto/ | ░$░cd░tutorial3 -[850] para +[852] para .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 00061B9DBF1301373134DB21CEF95434C3ED56DEC4D1473547C2E9FFF5729487 @@ -13732,11 +13756,11 @@ .segment_epub_is: examples | ⑆■┨auto/config┣■ を以下のように変更します: -[851] code +[853] code .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: 04D0A1BF077636741534F3AD1D9145A524FB7E4941C04989402A78AB97B9232F @@ -13749,11 +13773,11 @@ | ░░░░░--linux-flavours░686-pae░\ | ░░░░░"${@}" -[852] para +[854] para .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 79D0A252611F692938B24EFE085D382B7DC5E09F440DE645F6299DC343C9EC9B @@ -13761,11 +13785,11 @@ .segment_epub_is: examples | ⑆■┨lb config┣■ を実行して設定ツリーを生成し、生成された ⑆■┨auto/config┣■ スクリプトを使います: -[853] code +[855] code .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: D052A66FFF5B340360FA18AA739D50C8C2CCE81819382B39CAEC27BA75E53644 @@ -13773,11 +13797,11 @@ .segment_epub_is: examples | ░$░lb░config -[854] para +[856] para .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 4CBEA64DC864566D48568C82CAA3604890AD0D8F77F4858B51468C512146B41D @@ -13785,11 +13809,11 @@ .segment_epub_is: examples | ここでローカルパッケージ一覧を設定します: -[855] code +[857] code .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: F451DB0940D685E0F9E4B94DBDE22DF7772B6F5C9323A86C0909C1CD919E4A34 @@ -13797,11 +13821,11 @@ .segment_epub_is: examples | ░$░echo░"task-lxde-desktop░iceweasel░xchat"░>>░config/package-lists/my.list.chroot -[856] para +[858] para .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 4644355625E3158211F3414D65FCA3AF87791A42FBDCA57787C062BA24764BBA @@ -13809,11 +13833,11 @@ .segment_epub_is: examples | まず、⑆■┨--architectures i386┣■ により必ず ⑆■┨amd64┣■ ビルドシステムでほとんどのマシンでの利用に適応する32ビット版をビルドするようにします。次に、相当に古いシステムでのこのイメージの利用を想定しないため ⑆■┨--linux-flavours 686-pae┣■ を使います。⑆/┨lxde┣/ のタスクメタパッケージを選択して最小限のデスクトップを揃えます。最後に、好みのパッケージの初期値として ⑆/┨iceweasel┣/ と ⑆/┨xchat┣/ を追加しています。 -[857] para +[859] para .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 05DD9FB0D81AC44300582512F82AA1DF1210ACAE75FEEE2A0A8BAAE6A464AEC1 @@ -13821,11 +13845,11 @@ .segment_epub_is: examples | そして、イメージをビルドします: -[858] code +[860] code .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: 0ACA62CAA08819FF07AB8E28B0180F050ED97F92C36B362DAED3CC27A9CD6284 @@ -13833,11 +13857,11 @@ .segment_epub_is: examples | ░#░lb░build -[859] para +[861] para .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 5E39958B90A1D1607C2D603132AF7E07EB4B0AE6C7ABA778282D9E6A22616734 @@ -13845,11 +13869,11 @@ .segment_epub_is: examples | 最初の2つのチュートリアルとは異なり、⑆■┨2>&1 | tee build.log┣■ は ⑆■┨auto/build┣■ に書かれているため打ち込む必要がなくなっていることに注意してください。 -[860] para +[862] para .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 61546E78E8D6D133069B1F13613B5C80DB00113E196CA7B174736A0882820D0B @@ -13858,11 +13882,11 @@ .segment_epub_is: examples | (┥チュートリアル 1┝┤#tutorial-1├ にあるように) イメージをテストしてうまく機能する確信を得たら⑆■┨git┣■リポジトリを初期化し、作成したばかりの auto スクリプトだけを追加し、最初のコミットを行います: -[861] code +[863] code .part: body -.parent: 848 -.ancestors: 1 821 0 0 822 845 848 0 -.ancestors_collapsed: 1 821 822 845 848 0 0 0 +.parent: 850 +.ancestors: 1 823 0 0 824 847 850 0 +.ancestors_collapsed: 1 823 824 847 850 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: 4FC400D7C0CC0BBE10B1597C8F8936FC2FE866B2C5A1645D815CF041A888D340 @@ -13873,12 +13897,12 @@ | ░$░git░add░. | ░$░git░commit░-m░"Initial░import." -[862] heading :3 +[864] heading :3 .part: body -.parent: 845 -.last_descendant: 873 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 847 +.last_descendant: 875 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .dom_status: 4 4 0 0 4 4 3 0 .dom_status_collapsed: 4 4 4 4 3 0 0 0 .heading_lev_collapsed: 4 @@ -13892,11 +13916,11 @@ .heading_ancestors_text: Live システムマニュアル|例|||例|チュートリアル 3: 私的イメージ|2回目の改訂| | 2回目の改訂 -[863] para +[865] para .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 72C6A72A6B57D6FF2207595278677940C076F4D1E15E79F3AA19F4D7FB83D8AA @@ -13904,11 +13928,11 @@ .segment_epub_is: examples | この改訂では、最初のビルドをきれいにし、⑆/┨vlc┣/ パッケージを設定に追加して再ビルド、テストコミットを行います。 -[864] para +[866] para .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 247EDB924ED10F8FC23D1F7E2C4519AD3017E18AB47F15C3F5F69E1423C2E8B5 @@ -13916,11 +13940,11 @@ .segment_epub_is: examples | ⑆■┨lb clean┣■ コマンドは前のビルドで生成したファイルを、パッケージを再びダウンロードせずに済むようにキャッシュを除いて全てきれいにします。これにより以降の ⑆■┨lb build┣■ が全段階で再び実行され、必ず新しい設定でファイルを再生成するようになります。 -[865] code +[867] code .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: AC83BBD086C9EE36A52EA44CF438A4985DA6875A392E2D2D2AB6563F3211B33E @@ -13928,11 +13952,11 @@ .segment_epub_is: examples | ░#░lb░clean -[866] para +[868] para .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 4F14674D5C728E45DC95BFD2BFC24CE5B7D72B4390C8B434AB7B7F448EE800DD @@ -13940,11 +13964,11 @@ .segment_epub_is: examples | ⑆/┨vlc┣/ パッケージを ⑆■┨config/package-lists/my.list.chroot┣■ のローカルパッケージ一覧に追記します: -[867] code +[869] code .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: 179B08DE9FEA0F8A338C57A53FACC6286E3D6A053D95FD9FB81130B8FF24D850 @@ -13952,11 +13976,11 @@ .segment_epub_is: examples | ░$░echo░vlc░>>░config/package-lists/my.list.chroot -[868] para +[870] para .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: A46012F17F8B1E843FB6C417123CA5CA1A3A5A27EBEB0464B0AEC2A8439BB272 @@ -13964,11 +13988,11 @@ .segment_epub_is: examples | 再びビルドします: -[869] code +[871] code .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: B17162DE9D8D529CB439A11FB3A79BA666856F9DFDFA8E392E9BB4FF53B598EF @@ -13976,11 +14000,11 @@ .segment_epub_is: examples | #░lb░build -[870] para +[872] para .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 922C3C0B0DFA3D7AD3899769C2FF6388A18FF78536C552D52A96ADEDB68B3B64 @@ -13988,11 +14012,11 @@ .segment_epub_is: examples | テストして満足したら次の改訂としてコミットします: -[871] code +[873] code .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: BE38B9529AF60851717DF7321D788C03805217655D2D9E44FA23D7E6E96990DE @@ -14000,11 +14024,11 @@ .segment_epub_is: examples | ░$░git░commit░-a░-m░"Adding░vlc░media░player." -[872] para +[874] para .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 96672118D34C6CF241448FC26A65D30AD32C4B667DAEB0E857927973D84AD83E @@ -14012,11 +14036,11 @@ .segment_epub_is: examples | もちろん、⑆■┨config/┣■ 以下のサブディレクトリにファイルを追加する等により設定をもっと複雑に変更することも可能です。新しい改訂版をコミットする際、⑆■┨config┣■ の最上位にある、⑆■┨LB_*┣■ 変数を設定しているファイルもビルドされてできたもので、⑆■┨lb clean┣■ と、対応する ⑆■┨auto┣■ スクリプトを経由して再作成した ⑆■┨lb config┣■ により常に整理されるものなので、手で編集したりコミットすることのないように注意してください。 -[873] para +[875] para .part: body -.parent: 862 -.ancestors: 1 821 0 0 822 845 862 0 -.ancestors_collapsed: 1 821 822 845 862 0 0 0 +.parent: 864 +.ancestors: 1 823 0 0 824 847 864 0 +.ancestors_collapsed: 1 823 824 847 864 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: EB1491A1FA5FE8DADB332CDC9BD3E3103A562C6C05EF0F117971C3364476BDB9 @@ -14024,12 +14048,12 @@ .segment_epub_is: examples | 一連のチュートリアルもこれで終わりです。もっと多様な独自化はできますが、ここまでの簡単な例で見てきた少しの機能を使うだけでも、イメージはほぼ無限の異なる組み合わせを作成することができます。この節の残りの例では、収集してきた Live システムのユーザの経験を元にした他の事例についていくつか触れます。 -[874] heading :2 +[876] heading :2 .part: body -.parent: 822 -.last_descendant: 887 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 824 +.last_descendant: 889 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .dom_status: 4 4 0 0 4 3 2 0 .dom_status_collapsed: 4 4 4 3 2 0 0 0 .heading_lev_collapsed: 3 @@ -14043,11 +14067,11 @@ .heading_ancestors_text: Live システムマニュアル|例|||例|VNC 公衆クライアント|| | VNC 公衆クライアント -[875] para +[877] para .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: FF67316DBC536F86C823B9FBF14AF237CD708712ED9E1717D2433383C99A5439 @@ -14055,11 +14079,11 @@ .segment_epub_is: examples | ⑆*┨事例:┣* live-build を使って、ブートすると直接 VNC サーバに接続するイメージを作成します。 -[876] para +[878] para .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 3F2C1822792DCA1BB1E7710DDB190E66DA144F14933F94364F0CA3DD317852C8 @@ -14068,11 +14092,11 @@ .segment_epub_is: examples | ビルド用ディレクトリを作ってそこに概略設定を作成し、推奨パッケージを無効にして最小限のシステムを作成します。それから初期パッケージ一覧を2つ作成します: 1つ目は live-build により提供される ⑆■┨Packages┣■ というスクリプト (┥生成されるパッケージ一覧┝┤#generated-package-lists├ 参照) により生成し、2つ目では ⑆/┨xorg┣/、⑆/┨gdm3┣/、⑆/┨metacity┣/、⑆/┨xvnc4viewer┣/ を収録します。 -[877] code +[879] code .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: C7732AA531F27F19004C90C7DC177D7DAD4675FFA91D0C9CCEF61BD72C10D63C @@ -14084,11 +14108,11 @@ | ░$░echo░'!░Packages░Priority░standard'░>░config/package-lists/standard.list.chroot | ░$░echo░"xorg░gdm3░metacity░xvnc4viewer"░>░config/package-lists/my.list.chroot -[878] para +[880] para .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 29B29D01D9D0BA5E502BEE4948390D3383FD687A8EE52999389B13F22B615A21 @@ -14097,11 +14121,11 @@ .segment_epub_is: examples | ┥APT の調整による容量の節約┝┤#tweaking-apt-to-save-space├ で説明しているように、イメージが適切に機能するためには推奨パッケージを再びいくらか追加する必要があるかもしれません。 -[879] para +[881] para .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 983DFC93BE3D2ADA21FD5DA6D29BB44E7B2B5CF09CE3E5A9A8D87549228BCEB2 @@ -14109,11 +14133,11 @@ .segment_epub_is: examples | 推奨パッケージ一覧を調べるための簡単な方法として ⑆/┨apt-cache┣/ の利用があります。例えば: -[880] code +[882] code .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: 31D9208E8D5F6F87BD7FECA7B9326C1B57F91A69B745B3156D1A0C784A1F01F6 @@ -14121,11 +14145,11 @@ .segment_epub_is: examples | ░$░apt-cache░depends░live-config░live-boot -[881] para +[883] para .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: A098BADD0BBC7A72068254D0CEE6EA72A3AF3E279BBB8A8471A0EDA0ED4A3302 @@ -14133,11 +14157,11 @@ .segment_epub_is: examples | この例では live-config 及び live-boot により推奨されるパッケージを複数、再び収録する必要があることがわかっています: 自動ログインが機能するためには ⑆■┨user-setup┣■、システムをシャットダウンするための不可欠なプログラムとして ⑆■┨sudo┣■。他に、イメージをRAMにコピーできるようになる ⑆■┨live-tools┣■ や Live メディアを最終的に取り出す ⑆■┨eject┣■ を追加しておくと便利でしょう。それを反映すると: -[882] code +[884] code .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: DB3EFAA9E7E122668590738EE5873570926F3AEC8D998394B956773E2D8D5641 @@ -14145,11 +14169,11 @@ .segment_epub_is: examples | ░$░echo░"live-tools░user-setup░sudo░eject"░>░config/package-lists/recommends.list.chroot -[883] para +[885] para .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: A2346666711D2CE69E6E2C642D2308C906361B4126B291A54A2A1EA56E5EB3AF @@ -14157,11 +14181,11 @@ .segment_epub_is: examples | その後ディレクトリ ⑆■┨/etc/skel┣■ を ⑆■┨config/includes.chroot┣■ に作成し、その中にデフォルトユーザ向けの独自の ⑆■┨.xsession┣■ を置きます。このファイルは ⑆/┨metacity┣/ を立ち上げて ⑆/┨xvncviewer┣/ を起動し、⑆■┨192.168.1.2┣■ にあるサーバのポート ⑆■┨5901┣■ に接続します: -[884] code +[886] code .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: 6935F324717CAF7AA631A7D4D10ED07B0758DED01D73C39DF9017A2F63EF16FE @@ -14177,11 +14201,11 @@ | ░exit | ░EOF -[885] para +[887] para .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 3AD2A4D16B3C8CDC0834A869DF3C683BA90C8004CBA4D26B8B5030C23C3057C9 @@ -14189,11 +14213,11 @@ .segment_epub_is: examples | イメージをビルドします: -[886] code +[888] code .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: 0ACA62CAA08819FF07AB8E28B0180F050ED97F92C36B362DAED3CC27A9CD6284 @@ -14201,11 +14225,11 @@ .segment_epub_is: examples | ░#░lb░build -[887] para +[889] para .part: body -.parent: 874 -.ancestors: 1 821 0 0 822 874 0 0 -.ancestors_collapsed: 1 821 822 874 0 0 0 0 +.parent: 876 +.ancestors: 1 823 0 0 824 876 0 0 +.ancestors_collapsed: 1 823 824 876 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: CA06CCC321BFEA62A78DFEDE1BF90E7567C598A6E851F7EA7680E25417788462 @@ -14213,12 +14237,12 @@ .segment_epub_is: examples | 楽しみましょう。 -[888] heading :2 +[890] heading :2 .part: body -.parent: 822 -.last_descendant: 898 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 824 +.last_descendant: 900 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .dom_status: 4 4 0 0 4 3 0 0 .dom_status_collapsed: 4 4 4 3 0 0 0 0 .heading_lev_collapsed: 3 @@ -14232,11 +14256,11 @@ .heading_ancestors_text: Live システムマニュアル|例|||例|128MB USB メモリ向けの基本イメージ|| | 128MB USB メモリ向けの基本イメージ -[889] para +[891] para .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: DB7517C7CECCB1863EE30E9523FF6D900B5726964847A7B4F9FD245A29B23AD8 @@ -14244,11 +14268,11 @@ .segment_epub_is: examples | ⑆*┨事例:┣* 128MB USB メモリに収まるように構成要素をいくらか削除して、収まることがわかるように容量を少し空けたデフォルトのイメージの作成。 -[890] para +[892] para .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: EBDC543D8E79C293B1A0FE9945B29DC17A836AE458575471FFB3BBE467D76503 @@ -14256,11 +14280,11 @@ .segment_epub_is: examples | 特定のメディア容量に収まるようにイメージを最適化する場合、イメージのサイズと機能はトレードオフになることを理解する必要があります。この例では削るだけにしているので 128MB のメディアサイズ内に何か追加する余地をできるだけ残していますが、⑆/┨localepurge┣/ パッケージによるロケールの完全削除や収録しているパッケージ内の一貫性は何も壊していません。また、その他の「押し付ける」ような最適化もしていません。特に注目すべきなのは、最小限のシステムを最初から作成するために ⑆■┨--debootstrap-options┣■ を利用している点です。 -[891] code +[893] code .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: 98E7ECD7430EEC04050BA59AD544365B90395FDD389A69BFC6016951AAD6E870 @@ -14268,11 +14292,11 @@ .segment_epub_is: examples | ░$░lb░config░--apt-indices░false░--apt-recommends░false░--debootstrap-options░"--variant=minbase"░--firmware-chroot░false░--memtest░none -[892] para +[894] para .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: DED51FCFEB2E2358F63249AEC0A8D8BF303F0EFCFE2B883E2ACDC99D819A6953 @@ -14281,11 +14305,11 @@ .segment_epub_is: examples | イメージを適切に機能させるためには、最低でも ⑆■┨--apt-recommends false┣■ オプションにより外されていた推奨パッケージを2つ追加しなおす必要があります。{APTの調整による容量の節約}#tweaking-apt-to-save-space を見てください。 -[893] code +[895] code .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: 9BE6257F0C17A9D79DE016A1FCA209A01BE31BAEE997D8951319165B35EFEE4B @@ -14293,11 +14317,11 @@ .segment_epub_is: examples | ░$░echo░"user-setup░sudo"░>░config/package-lists/recommends.list.chroot -[894] para +[896] para .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 81085E0B31AFB4BEDB6826989CBCE523A6BDE416F1659108E382AE219CE426B8 @@ -14305,11 +14329,11 @@ .segment_epub_is: examples | ここで、普通の方法でイメージをビルドしてみます: -[895] code +[897] code .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: F56DADBE38650805A8F6ACD6FBE1F7D3C4A8071734212646D60F09F50EEE75ED @@ -14317,11 +14341,11 @@ .segment_epub_is: examples | ░#░lb░build░2>&1░|░tee░build.log -[896] para +[898] para .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 180B893F579768215F3DADD4D47AD5C6C84F88BA3321DB1179FD4B3B2698ECE5 @@ -14330,11 +14354,11 @@ .segment_epub_is: examples | これを書いている時点の著者のシステムでは、上記の設定により 110MB のイメージができました。これを{チュートリアル 1}#tutorial-1 のデフォルト設定で作成された 192MB のイメージと都合良く比較してみましょう。 -[897] para +[899] para .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: F30799BB6B596C3FB75065207E07950B86734CEBCF2D02C9064214D36D20992D @@ -14342,11 +14366,11 @@ .segment_epub_is: examples | ⑆■┨--apt-indices false┣■ によりAPTの索引を省くことでかなりの容量を節約していますが、その代わりに Live システムで ⑆/┨apt┣/ を使う前に ⑆■┨apt-get update┣■ を実行する必要があります。⑆■┨--apt-recommends false┣■ により推奨パッケージを除外することで、本来あるはずのパッケージをいくらか除外する代わりにいくらか追加で容量を節約します。⑆■┨--debootstrap-options “--variant=minbase”┣■ で最初から最小限のシステムを構成します。⑆■┨--firmware-chroot false┣■ でファームウェアパッケージを自動的に収録しないようにすることでもさらに容量をいくらか節約します。そして最後に、⑆■┨--memtest none┣■ によりメモリテスターのインストールを抑制します。 -[898] para +[900] para .part: body -.parent: 888 -.ancestors: 1 821 0 0 822 888 0 0 -.ancestors_collapsed: 1 821 822 888 0 0 0 0 +.parent: 890 +.ancestors: 1 823 0 0 824 890 0 0 +.ancestors_collapsed: 1 823 824 890 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 7E36BD9824592571E0098EBC973FEADD5B056539C85EE36856135B1304A97C61 @@ -14354,12 +14378,12 @@ .segment_epub_is: examples | ⑆*┨注意:┣* 最小限のシステムの構成はフックを使って、例えば ⑆■┨/usr/share/doc/live-build/examples/hooks┣■ にある ⑆■┨stripped.hook.chroot┣■ でも実現できます。これは容量をさらに少し減らし、62MB のイメージを生成します。しかしこれはその実現のために、システムにインストールしたパッケージから文書その他のファイルを削除しています。これはそうしたパッケージの完全性を破壊し、ヘッダで警告しているように思わぬ結果をもたらすかもしれません。それが、この目標のために推奨するのが最小限の ⑆/┨debootstrap┣/ を利用する方法になっている理由です。 -[899] heading :2 +[901] heading :2 .part: body -.parent: 822 -.last_descendant: 910 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 824 +.last_descendant: 912 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .dom_status: 4 4 0 0 4 3 0 0 .dom_status_collapsed: 4 4 4 3 0 0 0 0 .heading_lev_collapsed: 3 @@ -14373,11 +14397,11 @@ .heading_ancestors_text: Live システムマニュアル|例|||例|地域化した GNOME デスクトップとインストーラ|| | 地域化した GNOME デスクトップとインストーラ -[900] para +[902] para .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: D090D4FB104D949576FEB62C3CF860963BA2BB47B697D2510BAE93B05721C62E @@ -14385,11 +14409,11 @@ .segment_epub_is: examples | ⑆*┨事例:┣* GNOME デスクトップのイメージを作成し、スイス用の地域化とインストーラを収録する -[901] para +[903] para .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: B9D1E0111EAC71E55E00BE5E9B42F22DE82F401E9A09E0996F844D87D44CB3F4 @@ -14397,11 +14421,11 @@ .segment_epub_is: examples | 好みのデスクトップを使った i386 アーキテクチャ向けの iso-hybrid イメージを作りたい。ここでは GNOME を使用して、GNOME 用の標準の Debian インストーラによりインストールされるのと同一のパッケージを全て収録します。 -[902] para +[904] para .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 5D78610F5F477BFDB844A05E1F47FD842FEA800E2C73C5BE3DC15592012C56C5 @@ -14409,11 +14433,11 @@ .segment_epub_is: examples | 最初の問題は適切な言語用タスクの名前を判断する方法です。現在 live-build はこれを支援できません。運良くこれを試行錯誤で見つけられるかもしれませんが、そのためのツールがあります。⑆■┨grep-dctrl┣■ を利用して tasksel-data にあるタスクの説明を見つけることができます。そのため、準備としてこの両方が揃っていることを確認してください: -[903] code +[905] code .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: C08FFB7C035A29E309F7640C6AA3BA9F253D266D0F3F5EEB0524C9933513540A @@ -14421,11 +14445,11 @@ .segment_epub_is: examples | ░#░apt-get░install░dctrl-tools░tasksel-data -[904] para +[906] para .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 1622A2EE1F33289C08E1B745D0474A7406E3CFCC61D7F1B03161853154664CCE @@ -14433,11 +14457,11 @@ .segment_epub_is: examples | これで適切なタスクを検索できるようになりました。まず、 -[905] code +[907] code .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: 19C8302C48A57F77C7E77A3BB719EC94AB78BDB670F1B74739DFC1A201AD910B @@ -14446,11 +14470,11 @@ | ░$░grep-dctrl░-FTest-lang░de░/usr/share/tasksel/descs/debian-tasks.desc░-sTask | ░Task:░german -[906] para +[908] para .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 3E934E129F0470B98D4CFBEFAA147493CB8B91DC8098707A460338AFCA7CBDEE @@ -14458,11 +14482,11 @@ .segment_epub_is: examples | というコマンドにより、呼ばれたタスクが、簡単に言うとここではドイツだということがわかります。次は関連タスクを見つけます: -[907] code +[909] code .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: 83C73070111FE947B5945E947D6DF8CD81BF39BB63DFEF72BD00DB162573567C @@ -14472,11 +14496,11 @@ | ░Task:░german-desktop | ░Task:░german-kde-desktop -[908] para +[910] para .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: ADFE61B73D4A521C785ED270896C83CEE0E106B389D280F3B6177EF58EAA65B5 @@ -14485,11 +14509,11 @@ .segment_epub_is: examples | ブート時に ⑆*┨de_CH.UTF-8┣* ロケールを生成して ⑆*┨ch┣* のキーボードレイアウトを選択します。一緒に見ていきましょう。{メタパッケージの利用}#using-metapackages から、タスクのメタパッケージには先頭に ⑆■┨task-┣■ が付くことを思いだしてください。こういった言語のブートパラメータを指定し、それから優先度が標準のパッケージと発見したタスクの全メタパッケージをパッケージ一覧に追加するだけです: -[909] code +[911] code .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: block .sha256: 33536913F40D13F3219D23E2AE8578589D877E9CB5E9A54EB6BEAD2581CB788C @@ -14505,11 +14529,11 @@ | ░$░echo░task-gnome-desktop░task-german░task-german-desktop░>>░config/package-lists/desktop.list.chroot | ░$░echo░debian-installer-launcher░>>░config/package-lists/installer.list.chroot -[910] para +[912] para .part: body -.parent: 899 -.ancestors: 1 821 0 0 822 899 0 0 -.ancestors_collapsed: 1 821 822 899 0 0 0 0 +.parent: 901 +.ancestors: 1 823 0 0 824 901 0 0 +.ancestors_collapsed: 1 823 824 901 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 2C65E3965E314C940D77FB27E455BF83E96BB9656715D084FCBC8384308CC9B1 @@ -14517,12 +14541,12 @@ .segment_epub_is: examples | のようになります。インストーラを Live デスクトップから立ち上げるために ⑆/┨debian-installer-launcher┣/ パッケージを収録していることに注意してください。さらに、インストーラを立ち上げる機能が適切に動作するために現在必要な ⑆■┨586┣■ 用のカーネルがデフォルトで収録されます。 -[911] heading :B +[913] heading :B .part: body .parent: 1 -.last_descendant: 911 -.ancestors: 1 911 0 0 0 0 0 0 -.ancestors_collapsed: 1 911 0 0 0 0 0 0 +.last_descendant: 913 +.ancestors: 1 913 0 0 0 0 0 0 +.ancestors_collapsed: 1 913 0 0 0 0 0 0 .dom_status: 4 3 0 0 2 2 0 0 .dom_status_collapsed: 4 3 2 2 0 0 0 0 .heading_lev_collapsed: 1 @@ -14536,13 +14560,13 @@ .heading_ancestors_text: Live システムマニュアル|付録|||||| | 付録 -[912] heading :B +[914] heading :B .part: body .parent: 1 -.last_descendant: 912 -.children: 913 -.ancestors: 1 912 0 0 0 0 0 0 -.ancestors_collapsed: 1 912 0 0 0 0 0 0 +.last_descendant: 914 +.children: 915 +.ancestors: 1 914 0 0 0 0 0 0 +.ancestors_collapsed: 1 914 0 0 0 0 0 0 .dom_status: 4 3 0 0 0 0 0 0 .dom_status_collapsed: 4 3 0 0 0 0 0 0 .heading_lev_collapsed: 1 @@ -14556,13 +14580,13 @@ .heading_ancestors_text: Live システムマニュアル|スタイルガイド|||||| | スタイルガイド -[913] heading :1 +[915] heading :1 .part: body -.parent: 912 -.last_descendant: 913 -.children: 914 989 -.ancestors: 1 912 0 0 913 0 0 0 -.ancestors_collapsed: 1 912 913 0 0 0 0 0 +.parent: 914 +.last_descendant: 915 +.children: 916 991 +.ancestors: 1 914 0 0 915 0 0 0 +.ancestors_collapsed: 1 914 915 0 0 0 0 0 .dom_status: 4 4 0 0 1 0 0 0 .dom_status_collapsed: 4 4 1 0 0 0 0 0 .heading_lev_collapsed: 2 @@ -14576,20 +14600,20 @@ .segment_html_is: style-guide .segment_epub_is: style-guide .heading_ancestors_text: Live システムマニュアル|スタイルガイド|||スタイルガイド||| -.lev4_subtoc: 5~ ┥著者向けガイドライン┝┤#914├ -.lev4_subtoc: 6~ ┥言語特性┝┤#917├ -.lev4_subtoc: 6~ ┥手順┝┤#950├ -.lev4_subtoc: 5~ ┥翻訳者向けガイドライン┝┤#989├ -.lev4_subtoc: 6~ ┥翻訳の手がかり┝┤#993├ +.lev4_subtoc: 5~ ┥著者向けガイドライン┝┤#916├ +.lev4_subtoc: 6~ ┥言語特性┝┤#919├ +.lev4_subtoc: 6~ ┥手順┝┤#952├ +.lev4_subtoc: 5~ ┥翻訳者向けガイドライン┝┤#991├ +.lev4_subtoc: 6~ ┥翻訳の手がかり┝┤#995├ | スタイルガイド -[914] heading :2 +[916] heading :2 .part: body -.parent: 913 -.last_descendant: 988 -.children: 917 950 -.ancestors: 1 912 0 0 913 914 0 0 -.ancestors_collapsed: 1 912 913 914 0 0 0 0 +.parent: 915 +.last_descendant: 990 +.children: 919 952 +.ancestors: 1 914 0 0 915 916 0 0 +.ancestors_collapsed: 1 914 915 916 0 0 0 0 .dom_status: 4 4 0 0 4 1 0 0 .dom_status_collapsed: 4 4 4 1 0 0 0 0 .heading_lev_collapsed: 3 @@ -14603,11 +14627,11 @@ .heading_ancestors_text: Live システムマニュアル|スタイルガイド|||スタイルガイド|著者向けガイドライン|| | 著者向けガイドライン -[915] para +[917] para .part: body -.parent: 914 -.ancestors: 1 912 0 0 913 914 0 0 -.ancestors_collapsed: 1 912 913 914 0 0 0 0 +.parent: 916 +.ancestors: 1 914 0 0 915 916 0 0 +.ancestors_collapsed: 1 914 915 916 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: EA0D3B6AD9DBEA891244C324073AA6748DC648BFFC017F03363398B96F17E92D @@ -14615,11 +14639,11 @@ .segment_epub_is: style-guide | この節では Live マニュアル向けの技術的文書を記述する際に一般的に考慮すべき事項を扱います。言語特性と推奨手順に分かれています。 -[916] para +[918] para .part: body -.parent: 914 -.ancestors: 1 912 0 0 913 914 0 0 -.ancestors_collapsed: 1 912 913 914 0 0 0 0 +.parent: 916 +.ancestors: 1 914 0 0 915 916 0 0 +.ancestors_collapsed: 1 914 915 916 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 01F9AFCBFC6DF99D85228DC905BE33F8FCFD3FAE7CF8AB3730B4376B164BF101 @@ -14628,12 +14652,12 @@ .segment_epub_is: style-guide | ⑆*┨注意:┣* 著者はまず{この文書への貢献}#how-to-contribute を読んでください -[917] heading :3 +[919] heading :3 .part: body -.parent: 914 -.last_descendant: 949 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 916 +.last_descendant: 951 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .dom_status: 4 4 0 0 4 4 1 0 .dom_status_collapsed: 4 4 4 4 1 0 0 0 .heading_lev_collapsed: 4 @@ -14647,11 +14671,11 @@ .heading_ancestors_text: Live システムマニュアル|スタイルガイド|||スタイルガイド|著者向けガイドライン|言語特性| | 言語特性 -[918] para +[920] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 046CB06BC7A98B4119BBEE89BAFC938FC647358A5F1BFEDA01A25A89424D3C17 @@ -14660,11 +14684,11 @@ .segment_epub_is: style-guide | ⑆/┨平易な英語を使う┣/ -[919] para +[921] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 4BBC27D160AC5F0AAED0FA44A055EC5775613B114A93427643D7C094353CC018 @@ -14672,11 +14696,11 @@ .segment_epub_is: style-guide | 読み手は英語が母国語ではない人の割合が高いことに留意してください。そのため、一般的規則として短く有意な文章を使い、引き続いて終止符を打ってください。 -[920] para +[922] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: FD1B25B154394AE448BCF0FA4B71B7853149D2E74951BF513E97F04A3C325AA1 @@ -14684,11 +14708,11 @@ .segment_epub_is: style-guide | これは単純で幼稚な書き方をするように言っているわけではありません。英語が母国語ではない人にとって理解しにくい複雑な従属文にすることを可能な限り避けましょうという提案です。 -[921] para +[923] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 88C1FCB1AE5301082B25B758C9B7FCACD350CC51FF5DD79806AF4EEE4D6B770C @@ -14697,11 +14721,11 @@ .segment_epub_is: style-guide | ⑆/┨英語の方言┣/ -[922] para +[924] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 0225E401E51FF3385E8C9718FD1348846CE69A6613704B07FB228E56FE04F678 @@ -14709,11 +14733,11 @@ .segment_epub_is: style-guide | 最も広く使われている英語の方言はイギリス英語とアメリカ英語なので、ほとんどの著者が非常に高い率でこのどちらかを使っています。共同作業環境下で理想的なのは「国際英語」ですが、既存の全ての方言からどれを使うのが最善なのか決定するのは不可能とは言いませんが非常に困難です。 -[923] para +[925] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: C018FB2A87A0B32DE7D175E6393516D282FF91844228FBC3BC02838F0AEB4B4D @@ -14721,11 +14745,11 @@ .segment_epub_is: style-guide | 誤解を生まずに複数の方言を混在させることもできるとは思いますが、一般論として一貫性を持たせるようにすべきで、また、イギリス英語やアメリカ英語、その他の英語の方言からどれを使うか自分の裁量で決める前に、他の人がどのように書いているのかを調べてそれを真似るようにしてください。 -[924] para +[926] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: B460B09BB4BF2194379528179975699AAD5A73A209BB2EE0FC3F1A31989A205E @@ -14734,11 +14758,11 @@ .segment_epub_is: style-guide | ⑆/┨バランス良く┣/ -[925] para +[927] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 16509E5E5CA94C91D16F685CA6C8366AE34CF37B0702640A6F261DA6938354FE @@ -14746,11 +14770,11 @@ .segment_epub_is: style-guide | 偏見を持たないようにしてください。Live マニュアルに全く関係のない思想への言及を引用することは避けてください。技術的文献は可能な限り中立であるべきです。科学的文献では中立こそが自然です。 -[926] para +[928] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 7433C356EF4CA41FB66D7B29857390298B90A098396A30C0325431275275D056 @@ -14759,11 +14783,11 @@ .segment_epub_is: style-guide | ⑆/┨政治的に正しく┣/ -[927] para +[929] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: CFBCCD1782258909DE972588F8DCE45FC8CE499519A2A6C87A227BDEA6AE4ADB @@ -14771,11 +14795,11 @@ .segment_epub_is: style-guide | 性差を表す言葉を可能な限り避けるようにしてください。個人の第三者を持ち出す必要がある場合は「he (彼)」や「she (彼女)」、あるいは「s/he や s(he) 彼(女)」などと複雑にするよりも「they (彼ら)」を使うのが好ましいです。 -[928] para +[930] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: ACFEB66EA5F00362F47BBD066BA512A4AFF2511498B7128B1A51E7BD89F148D7 @@ -14784,11 +14808,11 @@ .segment_epub_is: style-guide | ⑆/┨簡潔に┣/ -[929] para +[931] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 8C9BA7AC091A222C605B80C7E04AD48233BB75A6F83142BA3F972D3B061373F1 @@ -14796,11 +14820,11 @@ .segment_epub_is: style-guide | 要点を直接述べ、回りくどい表現を使わないようにしてください。必要な情報は十分に提示ながらも、必要以上の余計な情報を提示するのはやめてください。これは不要な詳細を説明しないようにということです。読み手には理解力があります。読み手の側にいくらか前提知識があることを仮定してください。 -[930] para +[932] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: AFD222C0B1F484CAEE890A7AA42863EA8338C60F8E545086792DBF26A0130E72 @@ -14809,11 +14833,11 @@ .segment_epub_is: style-guide | ⑆/┨翻訳作業を最小限に┣/ -[931] para +[933] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 27AE3B92BA659C36BB6C86A3B3C752C274CB6F8DE4F0E10431AF18378A3343BA @@ -14821,11 +14845,11 @@ .segment_epub_is: style-guide | 書かれたものは他の複数の言語に翻訳されることになるということに留意してください。これは無意味あるいは冗長な情報を追加するとその分余計な作業をする人が出てくるということを意味します。 -[932] para +[934] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: E244F62EE419186413B85105C21C5C6CFB5927A6EE7C15EEB78D3B3A785806D2 @@ -14834,11 +14858,11 @@ .segment_epub_is: style-guide | ⑆/┨一貫性を┣/ -[933] para +[935] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 89F965F377FD05B662686D4898CABC5908B78C2AFCB6133E2BF0188B347C3D20 @@ -14846,11 +14870,11 @@ .segment_epub_is: style-guide | 前にも提案しましたが、共同作業の文書を標準化して全体を完全に統一することはほぼ不可能です。しかし、文書を書く際に全体を通して他の著者と一貫した書き方をすることを歓迎します。 -[934] para +[936] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: C71EBF5F2092F90B87856DC19200713E31B66DBF5CEBA5AEDE38AD80F445ADD7 @@ -14859,11 +14883,11 @@ .segment_epub_is: style-guide | ⑆/┨結束性を┣/ -[935] para +[937] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 51E3343ADC9208D03AECD5EE683B44FB68E407195FB944F64E4ED16048E4858B @@ -14871,11 +14895,11 @@ .segment_epub_is: style-guide | 必要なだけ文脈形成句を使い、文章に結束性を持たせて明確にしてください (文脈形成句は接続語句等の言語標識です)。 -[936] para +[938] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 392860BF1CB278AAD00C7D64D1A1F515F940B8D2CEACF35514094A99485922FA @@ -14884,11 +14908,11 @@ .segment_epub_is: style-guide | ⑆/┨記述的に┣/ -[937] para +[939] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: F9AE72F2FE4B72A38FF162677CEB72919E183BF904A0005A5FB96A9B295D3A82 @@ -14896,11 +14920,11 @@ .segment_epub_is: style-guide | 標準的な「changelog」形式で文を単に羅列するよりも段落を使って要点を説明する方が好ましいです。描写してください! 読み手はそれを歓迎するでしょう。 -[938] para +[940] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 143FB86BA174ED3DE534441977B905CAB5B334370F4BE547E8C87604C162ECE3 @@ -14909,11 +14933,11 @@ .segment_epub_is: style-guide | ⑆/┨辞書┣/ -[939] para +[941] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 9993F334E48F078D907325C2BC6539D76C3769474818F1CD126E32B0D693AE05 @@ -14921,11 +14945,11 @@ .segment_epub_is: style-guide | 英語で特定の概念を表現する方法がわからないときは辞書や百科事典でその語の意味を調べてください。ただし、辞書は最高の友ですが正しい使い方を知らなければ最悪の敵にもなることに留意してください。 -[940] para +[942] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: E4FD384154F42B42BBE5AEA290FB6F7A4610EAD445096FB9FFE91A8A68ED5225 @@ -14933,11 +14957,11 @@ .segment_epub_is: style-guide | 英語には最大の語彙が存在する言語の一つです (100万語以上)。この語の多くは他の言語から取り入れられたものです。単語の意味を二カ国語の辞書で調べる際、英語が母国語ではない人は母国語の言葉により似ているものを選択する傾向があります。このことにより、英語ではあまり自然に聞こえない、過度に形式ばった文体になりがちです。 -[941] para +[943] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 3787B065BF096CBC860512B39145C54769885CD7C60EEC80A6E7E47160D123E0 @@ -14945,11 +14969,11 @@ .segment_epub_is: style-guide | 原則として、ある概念が複数の異なる同義語により表現できるとき、辞書で最初に提示された語を選択するのが良い判断となるでしょう。疑問がある場合はゲルマン起源の語 (通常単音節の語) を選択すると多くの場合正しいとなります。この2つの技ではどちらかというとくだけた表現になるかもしれないという点には注意が必要ですが、少なくとも広く使われていて通常受け入れられる語を選択することになります。 -[942] para +[944] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 35B2A98D40576E9A7CA2E02D6D63ECB699FEA2877EE1973E8D00B810E8080BC1 @@ -14957,11 +14981,11 @@ .segment_epub_is: style-guide | 共起辞書の利用を勧めます。通常合わせて利用する語がわかるようになると極めて役に立ちます。 -[943] para +[945] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 87FFA7A748E41F89220C3C131A61BC14163F1AB9A7F435336DD74B8F677EE052 @@ -14969,11 +14993,11 @@ .segment_epub_is: style-guide | 繰り返しますが、他の人の作業から学ぶことが最良の実践です。検索エンジンを使って他の著者が特定の表現をどのように使っているか確認することは大きな手助けとなるでしょう。 -[944] para +[946] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 3B2F3D7A63C683770F5091D5A436FC97A3230DF9391C13BED783D1DA63659630 @@ -14982,11 +15006,11 @@ .segment_epub_is: style-guide | ⑆/┨空似言葉や熟語その他の慣習的な表現┣/ -[945] para +[947] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 6A7D1AD92F98193398B43B41BB19C2A0CE5E7B855BFA528B9C573FFDA9DE2074 @@ -14994,11 +15018,11 @@ .segment_epub_is: style-guide | 空似言葉に気をつけてください。外国語の熟練度を問わず、2つの言語で同じように見える語だけれどもその意味や使い方が全く異なる「空似言葉」という罠にはまることがあることは避けられません。 -[946] para +[948] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: BCA12B81F17F7863995F7C6D8CE032414F36854FED04C3686DE99A32AC3A3B2E @@ -15006,11 +15030,11 @@ .segment_epub_is: style-guide | 熟語は可能な限り避けてください。「熟語」は個々の語が持っていた意味とは完全に異なる意味を表すことがあります。熟語は英語が母国語の人でさえ理解しにくいこともあります! -[947] para +[949] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 67213BB10381D2CB5D0F196F0A171145D9482D551DEB5DFA5E6FF19323DB3EA7 @@ -15019,11 +15043,11 @@ .segment_epub_is: style-guide | ⑆/┨俗語や省略、短縮表現等は避けましょう┣/ -[948] para +[950] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 00BC61BA6B9F57662EAA2A14B980226E7AC58283523F0B92E3170B7ED1AC0A4B @@ -15031,11 +15055,11 @@ .segment_epub_is: style-guide | 平易な、日常的な英語の使用を勧めるとはいっても、技術的文献は言語を正式に記録する類のものです。 -[949] para +[951] para .part: body -.parent: 917 -.ancestors: 1 912 0 0 913 914 917 0 -.ancestors_collapsed: 1 912 913 914 917 0 0 0 +.parent: 919 +.ancestors: 1 914 0 0 915 916 919 0 +.ancestors_collapsed: 1 914 915 916 919 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 668A2B949DA4CA911AA034180F8A9F00623859BD7329F51576D5C7008180BBE7 @@ -15043,12 +15067,12 @@ .segment_epub_is: style-guide | 俗語や通常使わない解釈困難な省略表現、特に母国語での表現を模倣するような短縮表現は避けてください。IRCや、家族や仲間内で使うような特有の表現での記述はしないでください。 -[950] heading :3 +[952] heading :3 .part: body -.parent: 914 -.last_descendant: 988 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 916 +.last_descendant: 990 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .dom_status: 4 4 0 0 4 4 3 0 .dom_status_collapsed: 4 4 4 4 3 0 0 0 .heading_lev_collapsed: 4 @@ -15062,11 +15086,11 @@ .heading_ancestors_text: Live システムマニュアル|スタイルガイド|||スタイルガイド|著者向けガイドライン|手順| | 手順 -[951] para +[953] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 372F283CF679EEBBF8AA613B7C152A7D9A93F6B3DDA053C214118661B5CEC016 @@ -15075,11 +15099,11 @@ .segment_epub_is: style-guide | ⑆/┨書く前にテストを┣/ -[952] para +[954] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 5C8BB1FB130BF0478339F5572E41395702FAD5FD2607362FDC7EEC5C15C1544F @@ -15087,11 +15111,11 @@ .segment_epub_is: style-guide | 著者が Live マニュアルに追加する前に例をテストして、全て確実に説明通りに動作するようにすることは重要です。きれいな chroot やVM環境でのテストが良い起点となるでしょう。他に、それから異なるハードウェアを使っている異なるマシンでテストを実施し、起きるであろう問題を発見することができれば理想でしょう。 -[953] para +[955] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 61615A183D935A6677224AC69D7047D8AD3DAA279F21385EDF1B98C53935C4FF @@ -15100,11 +15124,11 @@ .segment_epub_is: style-guide | ⑆/┨例┣/ -[954] para +[956] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: D426752B4F84A9A2DCA9554E7B12E29EA4E0093AE4B793C42EE1662657384EFC @@ -15112,11 +15136,11 @@ .segment_epub_is: style-guide | 例示するときはできるだけ具体的にするようにしてください。例は結局例でしかありませんから。 -[955] para +[957] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 76DFEE8C6C0644BB301633A017EAF0FE86FA5AE9B9249B7D4CEB513917110F59 @@ -15124,11 +15148,11 @@ .segment_epub_is: style-guide | 抽象的な表現で読み手を混乱させるよりも、特定の状況でのみ適用できるような書き方をする方がより良いことはよくあります。この場合は提示した例の効果を簡単に説明することもできます。 -[956] para +[958] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 214C2A28113E409BCCED4B6C43F070A45FE1E3C268B50F951A498F7DE78A68FE @@ -15136,11 +15160,11 @@ .segment_epub_is: style-guide | 使い方を誤ればデータ消失や類似の望ましくない影響を及ぼす可能性のある、潜在的に危険なコマンド類の使用を例示する場合等、例外がいくらかあります。この場合は起こりうる副作用について十分な説明を提供すべきです。 -[957] para +[959] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 592A6AB9ABA0822CE657A6D50BCB27C200F3BF6EB508CB8C8C6362EEAEED1EE1 @@ -15149,11 +15173,11 @@ .segment_epub_is: style-guide | ⑆/┨外部リンク┣/ -[958] para +[960] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 2341145535AD7DC6462D8EB7F741FDFCF4E2D18F43CDA740697AEB02012210EF @@ -15161,11 +15185,11 @@ .segment_epub_is: style-guide | 外部サイトへのリンクは、そのサイトにある情報が特別な点を理解するために決定的な効果が期待できる場合にのみ利用すべきです。その場合でも、外部サイトへのリンクは可能な限り少なくしてください。インターネット上のリンクはその内容がほとんどが変更される可能性があるもので、その結果機能しないリンクができたり、論拠を不完全な状態にしてしまうことになります。 -[959] para +[961] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 37BAD471C6304712544137FDBB5673C3CD4059AB2A5D1A46F7CEE045E3A7BF7F @@ -15173,11 +15197,11 @@ .segment_epub_is: style-guide | 他に、インターネットに接続せずにそのマニュアルを読んでいる人にはそのリンクを追う機会がありません。 -[960] para +[962] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 5BBE8BE7EE90E186C96B266D592A099944E53D1328AE7D2F0B27C6221E7F85CF @@ -15186,11 +15210,11 @@ .segment_epub_is: style-guide | ⑆/┨商標の主張やマニュアルの公開にあたって採用したライセンスに違反するものは避ける┣/ -[961] para +[963] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 9C65E0875026EC9A311C4C1AAB15B40957D59950D0E725852AF88D0B80A332E2 @@ -15198,11 +15222,11 @@ .segment_epub_is: style-guide | 商標の主張は可能な限り避けてください。記述した文書は他の下流のプロジェクトで使うことになるかもしれないことに留意してください。つまり、ある種の特定の内容を追加することは事態を複雑にすることになります。 -[962] para +[964] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: CD113C3159F5371F2EE2AEE47815B6274D4D3587DF512285990014E0E9EC7B53 @@ -15210,11 +15234,11 @@ .segment_epub_is: style-guide | live-manual は GNU GPL の条件下で使用を許可しています。これには、合わせて公開する (著作権のある画像やロゴを含むあらゆる種類の) 内容の配布物に適用する意味合いがいくつかあります。 -[963] para +[965] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 7D6E97385C4C799869D9BFF8BA9FF4E80F7405CEAE303795AF9B732330101D90 @@ -15223,11 +15247,11 @@ .segment_epub_is: style-guide | ⑆/┨まず草稿を書き、改訂、変更して改善し、必要なら作り直す┣/ -[964] para +[966] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 00E17C571E5997F10159A2705D9489D9A05BA1B7A237E74F2A2AA7DF23A1F736 @@ -15235,11 +15259,11 @@ .segment_epub_is: style-guide | - 案を引き出しましょう! まず論理的に順を追って考えを整理する必要があります。 -[965] para +[967] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: EB81965AFA48E80AE0453F6C7392B81AF6986FF213A548BFDA060351900FC466 @@ -15247,11 +15271,11 @@ .segment_epub_is: style-guide | - 頭の中で何とか形ができたら最初の草稿を書きます。 -[966] para +[968] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: A638D191D5B54CA6C8201DEF75F718F3C7939C82B1BB41AA95AB1F08E43AF0C3 @@ -15259,11 +15283,11 @@ .segment_epub_is: style-guide | - 文法や書式、つづりを直します。リリースの正しい名前は ${testing} や sid で、これをコード名として参照するときは大文字にすべきではないことに留意してください。「spell」ターゲットを使って、つまり⑆■┨make spell┣■でつづりの誤りがないか確認できます。 -[967] para +[969] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 5214123A92683D90492DE2ADECB475B250AF06299EFEB947B27568FEFC3E91AC @@ -15271,11 +15295,11 @@ .segment_epub_is: style-guide | - 記述を改善し、必要な部分があれば書き直します。 -[968] para +[970] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 0C5455CF1893EB4D3578B3C9EACC1CFF27A37E5440DDA65B2C551D8C175A152E @@ -15284,11 +15308,11 @@ .segment_epub_is: style-guide | ⑆/┨章┣/ -[969] para +[971] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 2CBB06EFB2A465F0E6322DC778B2C0CE32E05E8643AAACBBD11C2615C21560F4 @@ -15296,11 +15320,11 @@ .segment_epub_is: style-guide | 章や副題には慣習的な番号の付け方をしてください。例えば 1、1.1、1.1.1、1.1.2 ... 1.2、1.2.1、1.2.2 ... 2、2.1 ... などというようにです。以下のマークアップを見てください。 -[970] para +[972] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 3E66BB318C3F23216F0D071EB298D7DEB9F9D7323045CD0DA175EF3594FE7B6D @@ -15308,11 +15332,11 @@ .segment_epub_is: style-guide | 説明するのに一連の手順や段階を列挙する必要がある場合は、First (最初に)、second (2つ目に)、third (3つ目に) ... というように序数を使ったり、First (最初に)、Then (それから)、After that (その後)、Finally (最後に)、... あるいは箇条書きすることもできます。 -[971] para +[973] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 6E232C7049E6EFEEB548B33237C7AE42D0E1228D9E71385E5AF97C0812465B69 @@ -15321,11 +15345,11 @@ .segment_epub_is: style-guide | ⑆/┨マークアップ┣/ -[972] para +[974] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 1D789D1F1C1D47ABE12463C5CE5B40631479293E0D16ED7AD13C9A2D120ED0F1 @@ -15335,11 +15359,11 @@ .segment_epub_is: style-guide | 大事なことを言い忘れましたが、live-manual では ┥SiSU┝┤0├ を使ってテキストファイルを処理し、複数の形式の出力を生成しています。{SiSU マニュアル}http://www.sisudoc.org/sisu/en/html/sisu_manual/markup.html を眺めてそのマークアップ方法をよく理解することを勧めます。代わりに -[973] code +[975] code .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: 505124636978BAD1E23CDBD028827E10E67B6164B01A3E07594A390F0F36ABF2 @@ -15347,11 +15371,11 @@ .segment_epub_is: style-guide | ░$░sisu░--help░markup -[974] para +[976] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 52FA6FDEE1C39B8164F5D2662352C56FB11BC945C765A4B17994AD47E8A67CD6 @@ -15359,11 +15383,11 @@ .segment_epub_is: style-guide | と入力する方法もあります。マークアップをいくらか例示してみます。有用だということはわかるかもしれません。 -[975] para +[977] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 69C1B54DADAE62D3D25FE660A9F51171FA6A582269D5D85887671D7C0C673294 @@ -15371,11 +15395,11 @@ .segment_epub_is: style-guide | - 文字列の強調/太字: -[976] code +[978] code .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: 72534B1FC3335D7DB31A398AFAD0752093725A4B6235AAFC64906BD97F1F571B @@ -15383,11 +15407,11 @@ .segment_epub_is: style-guide | *{foo}*░または░!{foo}! -[977] para +[979] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: FB34C76A174541EF6DB914BD4B7C969FD9B9BC5DFC5689DD7090B0E1169411A8 @@ -15395,11 +15419,11 @@ .segment_epub_is: style-guide | は「⑆*┨foo┣* または ⑆!┨foo┣!」となります。これは特定のキーワードを強調するのに使います。 -[978] para +[980] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 03FD6EED8737B6D23A3C155B9B2B474A2FA4C504120BA8F2A9CA9529DBD88549 @@ -15407,11 +15431,11 @@ .segment_epub_is: style-guide | - 斜体: -[979] code +[981] code .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: DEF0527F015DC45F5EB0C647CAD32903FB26C186B967212E43540E04E9D4ABFD @@ -15419,11 +15443,11 @@ .segment_epub_is: style-guide | /{foo}/ -[980] para +[982] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 97E0166844B9487D8753D32D4640F619810A4F452B8EE17E5978C18C1E634F93 @@ -15431,11 +15455,11 @@ .segment_epub_is: style-guide | は ⑆/┨foo┣/ となります。これは例えば Debian パッケージの名前に使います。 -[981] para +[983] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: EF6FAB90C808E35D296699088A7968434AC0DC65FB2CE7B0D20BD5F6FBD60042 @@ -15443,11 +15467,11 @@ .segment_epub_is: style-guide | - 等幅: -[982] code +[984] code .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: 575F7976E39491E63BF70D4FAFEB29A106CE498384D35D2A49F7D252DDD8301F @@ -15455,11 +15479,11 @@ .segment_epub_is: style-guide | #{foo}# -[983] para +[985] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: E47349C62CC191D9328A4FDDBCFCBC6F7E5FAF500FF5EC8043063A4CAB63FFB2 @@ -15467,11 +15491,11 @@ .segment_epub_is: style-guide | は ⑆■┨foo┣■ となります。これは例えばコマンドの名前に使います。また、キーワードやパスのようなものの一部を強調するのにも使います。 -[984] para +[986] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: DC081ED1600BE41A13769B3CFCB7CBF21CEF03AC85063B73AB13260DBC08DD25 @@ -15479,11 +15503,11 @@ .segment_epub_is: style-guide | - コードブロック: -[985] code +[987] code .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: D24F161E2FC3674647701633BF5A73CECEBDC8447100598BEB7E9E171C465B72 @@ -15496,11 +15520,11 @@ | | ░}code -[986] para +[988] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: DE77C92E700013835C3FC5AD8F581A6C050FA5F015B75F694FE41715CFB4847E @@ -15508,11 +15532,11 @@ .segment_epub_is: style-guide | は -[987] code +[989] code .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: block .sha256: F13504310C2660D2C546091B01CA391E6F60F5AC1B05B941B7318C92DFEAE86A @@ -15521,11 +15545,11 @@ | ░$░foo | ░#░bar -[988] para +[990] para .part: body -.parent: 950 -.ancestors: 1 912 0 0 913 914 950 0 -.ancestors_collapsed: 1 912 913 914 950 0 0 0 +.parent: 952 +.ancestors: 1 914 0 0 915 916 952 0 +.ancestors_collapsed: 1 914 915 916 952 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 46C89C5282B3E1B09C31F27A1D424A6362A7485187024D639EC951AF0544C0FD @@ -15533,13 +15557,13 @@ .segment_epub_is: style-guide | となります。タグの開始には ⑆■┨code{┣■ を、終了には ⑆■┨}code┣■ を使います。コードの各行には先頭に空白が必要だということを必ず覚えておいてください。 -[989] heading :2 +[991] heading :2 .part: body -.parent: 913 -.last_descendant: 989 -.children: 993 -.ancestors: 1 912 0 0 913 989 0 0 -.ancestors_collapsed: 1 912 913 989 0 0 0 0 +.parent: 915 +.last_descendant: 991 +.children: 995 +.ancestors: 1 914 0 0 915 991 0 0 +.ancestors_collapsed: 1 914 915 991 0 0 0 0 .dom_status: 4 4 0 0 4 3 2 0 .dom_status_collapsed: 4 4 4 3 2 0 0 0 .heading_lev_collapsed: 3 @@ -15554,11 +15578,11 @@ .heading_ancestors_text: Live システムマニュアル|スタイルガイド|||スタイルガイド|翻訳者向けガイドライン|| | 翻訳者向けガイドライン -[990] para +[992] para .part: body -.parent: 989 -.ancestors: 1 912 0 0 913 989 0 0 -.ancestors_collapsed: 1 912 913 989 0 0 0 0 +.parent: 991 +.ancestors: 1 914 0 0 915 991 0 0 +.ancestors_collapsed: 1 914 915 991 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 1403D0C4AB8E34CDE66482AE6B2C3C70D52B50E415F40B2850595CE44B394124 @@ -15566,11 +15590,11 @@ .segment_epub_is: style-guide | この節では Live マニュアルの内容を翻訳する際に一般的に考慮すべき事項を扱います。 -[991] para +[993] para .part: body -.parent: 989 -.ancestors: 1 912 0 0 913 989 0 0 -.ancestors_collapsed: 1 912 913 989 0 0 0 0 +.parent: 991 +.ancestors: 1 914 0 0 915 991 0 0 +.ancestors_collapsed: 1 914 915 991 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: C1D4FF3E7D4C6D74E6C1F7CCAE2EE8973DC1E7955347097B6C7A527C2F59809C @@ -15578,11 +15602,11 @@ .segment_epub_is: style-guide | 一般的な推奨事項として、翻訳者は自分の言語に適用される翻訳規則を既に読んで理解しておくべきです。通常、翻訳用のグループやメーリングリストが Debian の品質標準に合致する翻訳物を作成する方法についての情報を提供しています。 -[992] para +[994] para .part: body -.parent: 989 -.ancestors: 1 912 0 0 913 989 0 0 -.ancestors_collapsed: 1 912 913 989 0 0 0 0 +.parent: 991 +.ancestors: 1 914 0 0 915 991 0 0 +.ancestors_collapsed: 1 914 915 991 0 0 0 0 .parent_lev: 5 .is_of_type: para .sha256: 7DCC6600134020D643CA60434F35D87826B889044F99FCA331242B851B82D3CC @@ -15591,12 +15615,12 @@ .segment_epub_is: style-guide | ⑆*┨注意:┣* 翻訳者は{この文書への貢献}#how-to-contribute も読むべきです。特に{翻訳}#translation 節を -[993] heading :3 +[995] heading :3 .part: body -.parent: 989 -.last_descendant: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 991 +.last_descendant: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .dom_status: 4 4 0 0 4 4 1 0 .dom_status_collapsed: 4 4 4 4 1 0 0 0 .heading_lev_collapsed: 4 @@ -15610,11 +15634,11 @@ .heading_ancestors_text: Live システムマニュアル|スタイルガイド|||スタイルガイド|翻訳者向けガイドライン|翻訳の手がかり| | 翻訳の手がかり -[994] para +[996] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: B738B4D59CECC1A6A246B45FAFF2223B83332CCDB9C757EEFDF6D9CFBCD2A789 @@ -15623,11 +15647,11 @@ .segment_epub_is: style-guide | ⑆/┨コメント┣/ -[995] para +[997] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 5EEB3469010656A5878E31789F45A3CF5DE15C02AAD4B929996CF8E5ECBB0D17 @@ -15635,11 +15659,11 @@ .segment_epub_is: style-guide | 翻訳者の役割は元の著者により書かれた語や文、段落、そして文章の意味を可能な限り忠実に目標の言語で伝えることです。 -[996] para +[998] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 30324FE1B639962B94B55239E965A45BED0F0FE2D3DF951B40E1C373BB56E320 @@ -15647,11 +15671,11 @@ .segment_epub_is: style-guide | そのため、個人的なコメントや自分の余計な情報の追加は控えるべきです。同一の文書について作業している他の翻訳者に向けてコメントを追加したい場合はそのために用意されている場があります。これは ⑆*┨po┣* ファイルの番号記号 ⑆*┨#┣* に続く文字列のヘッダです。ほとんどの視覚的な翻訳用プログラムで自動的にこれをコメントの種類に属するものとして処理します。 -[997] para +[999] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 83601002FF7038BF254369195872BFD6C65A03E1C904EC566361E9C882DA0818 @@ -15660,11 +15684,11 @@ .segment_epub_is: style-guide | ⑆/┨TN, Translator's Note (翻訳者によるメモ)┣/ -[998] para +[1000] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 4C713757CC2651D65A0B67339417E90AD5FB62164BFCE996EABB95563A5DC353 @@ -15672,11 +15696,11 @@ .segment_epub_is: style-guide | 完全に受け入れられるとはいえ、翻訳済みテキストの括弧「()」内に語や表現を含めることは、ややこしい語や表現の意味を読み手にとってより明確にする場合にのみ行ってください。翻訳者は括弧内に「(訳注)」等と記載して、その追記が翻訳者によるものであることを明確にすべきです。 -[999] para +[1001] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 605B2525EC03498DB629BC577BD0423E4560EBA9E3980E6CCFA5CAD41A3F01AD @@ -15685,11 +15709,11 @@ .segment_epub_is: style-guide | ⑆/┨非人称の文を┣/ -[1000] para +[1002] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 2F6DAA4AE6A94DBD2F9A3CAE6B5EFFB73AE952AD8EB22CA669F29FD5337F1CD3 @@ -15697,11 +15721,11 @@ .segment_epub_is: style-guide | 英語で書かれた文書は「you」を非人称として幅広く使います。他の言語にはこの特徴を共有しないものもあります。このことで、元の文が読み手に対して直接呼びかけているかのような誤った印象を実際にはそうではないのに与えてしまうかもしれません。翻訳者はこの点に注意して、可能な限り正確に自分の言語に反映する必要があります。 -[1001] para +[1003] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 4304499928C2B13BD5C34803685C8F148788B978489377059E5CE23C97D504C9 @@ -15710,11 +15734,11 @@ .segment_epub_is: style-guide | ⑆/┨空似言葉┣/ -[1002] para +[1004] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: C92E749A929BADA1F2B1436E4735ED2C0BBD99C18489AF4B82ABF94782CF6287 @@ -15722,11 +15746,11 @@ .segment_epub_is: style-guide | 前に説明した「空似言葉」の罠は特に翻訳者に当てはまります。疑いがあれば、その疑わしい空似言葉の意味を再点検してください。 -[1003] para +[1005] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 6E232C7049E6EFEEB548B33237C7AE42D0E1228D9E71385E5AF97C0812465B69 @@ -15735,11 +15759,11 @@ .segment_epub_is: style-guide | ⑆/┨マークアップ┣/ -[1004] para +[1006] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: F2205EB9DF6B4091BCF19CEFA1EDAD479C8A456ED057B76F4051A1D1F1B5F5EF @@ -15747,11 +15771,11 @@ .segment_epub_is: style-guide | 最初は⑆*┨pot┣*ファイル、後には⑆*┨po┣*ファイルについて作業する翻訳者は多数のマークアップ機能を文字列に確認できるでしょう。文は翻訳できるものである限り翻訳できますが、それが元の英語版と全く同一のマークアップを採用しているということは極めて重要です。 -[1005] para +[1007] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: C2D74F08B39D5E5A393A322433C056B9B1ABDAFD7607F070CF170F166E26D874 @@ -15760,11 +15784,11 @@ .segment_epub_is: style-guide | ⑆/┨コードブロック┣/ -[1006] para +[1008] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: CAA451BA206632987B460489AAF177C78D11CB86C8BFAB5348176C26C908FF00 @@ -15772,11 +15796,11 @@ .segment_epub_is: style-guide | コードブロックは通常翻訳できませんが、翻訳にそれを含めることが、翻訳率 100% を達成する唯一の方法です。コードが変更されると翻訳者による介入が必要となるため最初は余計な作業になりますが、長期的に見るとこれが .po ファイルの整合性を確認したときに何が既に翻訳済みで何が未翻訳なのか識別する最善の方法です。 -[1007] para +[1009] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 2E45DF329242BB2F11CDAACB3D7286A1B3B5BC7133D982973682A97D0E8950A8 @@ -15785,11 +15809,11 @@ .segment_epub_is: style-guide | ⑆/┨改行┣/ -[1008] para +[1010] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 9616E358249ABA302C0AD4F3961841E9107D7E2C033BF33BE12FA0EC99558EB0 @@ -15797,11 +15821,11 @@ .segment_epub_is: style-guide | 翻訳文には元の文と全く同じだけの改行が必要です。元のファイルに改行があるときは注意して「Enter」キーを押すか⑆*┨\n┣*を打ち込んでください。改行は例えばコードブロック中でよく使われます。 -[1009] para +[1011] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 8DE40C41DB6A005BF129C4A867C19A0B73E8F3220C5745B84792DA0DF8DE12F3 @@ -15809,11 +15833,11 @@ .segment_epub_is: style-guide | 勘違いしないでください。これは翻訳文を英語版と同一の長さにする必要がある、ということではありません。それはほぼ不可能です。 -[1010] para +[1012] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: B6DF932889F555A11C7114B1184198B136E4052121A02F2AE52E312C08D99091 @@ -15822,11 +15846,11 @@ .segment_epub_is: style-guide | ⑆/┨翻訳できない、してはいけない文字列┣/ -[1011] para +[1013] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 8DD96E94F528DD692355A4F396567E2B64133D0B31E56559EE12F01FBD2E74B4 @@ -15834,11 +15858,11 @@ .segment_epub_is: style-guide | 翻訳者が決して翻訳すべきでないもの: -[1012] para +[1014] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 8FF5F0839780682846BC3DD930EF35B37DA6C2C432A17F2D586A2FA75BD68A49 @@ -15846,11 +15870,11 @@ .segment_epub_is: style-guide | - リリースのコード名 (小文字で書くべき) -[1013] para +[1015] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 8EF90EF0F96DE83DB5A5133DDCE83B5C8B7312F57786D073756988B853B51488 @@ -15858,11 +15882,11 @@ .segment_epub_is: style-guide | - プログラムの名前 -[1014] para +[1016] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: F54F6473EA5CFB2C6B5E21363E9C0F5B8BCE2ECB64405000E1BD2BB99B7F6B5E @@ -15870,11 +15894,11 @@ .segment_epub_is: style-guide | - 例示するコマンド -[1015] para +[1017] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 1BA99847F192844401F7EFC718765A29C02F0A21C3C02C0B0C353A791C8BA5AB @@ -15882,11 +15906,11 @@ .segment_epub_is: style-guide | - メタ情報 (前後にコロンが置かれることが多い ⑆*┨:メタ情報:┣*) -[1016] para +[1018] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: DAC4C8B0CCC243EEB92EB5568A50FC511804C16F40CC25D826668392B522079F @@ -15894,11 +15918,11 @@ .segment_epub_is: style-guide | - リンク -[1017] para +[1019] para .part: body -.parent: 993 -.ancestors: 1 912 0 0 913 989 993 0 -.ancestors_collapsed: 1 912 913 989 993 0 0 0 +.parent: 995 +.ancestors: 1 914 0 0 915 991 995 0 +.ancestors_collapsed: 1 914 915 991 995 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: A6E6C55A5586AD05526D9390AEEF9D1BD352AAB75FF84872FE9A7BB8E6D32CB7 diff --git a/test/reference/abstraction/live-manual.pl.ssp b/test/reference/abstraction/live-manual.pl.ssp index d1ae605..196862d 100644 --- a/test/reference/abstraction/live-manual.pl.ssp +++ b/test/reference/abstraction/live-manual.pl.ssp @@ -4,7 +4,7 @@ @source { language: pl languages: en ca de es fr it ja pl pt_BR ro - digest: 35524F78E9442197333F3DCA772852F1D7EC4B94570F4C3A92D07816C0CC2817 + digest: 7BE28ADF47E9906129EA7AC3A2075730AB4121099CB5AC88E52C3532F96CB2D9 } @meta { @@ -28,7 +28,7 @@ } @doc_has { - inline_links: 114 + inline_links: 115 inline_notes_reg: 0 inline_notes_star: 0 tables: 0 @@ -557,14 +557,6 @@ .part: frontmatter .ocn_off: true .is_of_type: para -.indent: 5 5 -.has: links -| ┥Wcięcia┝┤#313├ - -[0] toc -.part: frontmatter -.ocn_off: true -.is_of_type: para .indent: 6 6 .has: links | ┥Polecenie ⑆■┨lb build┣■┝┤#319├ @@ -5765,7 +5757,7 @@ .part: body .parent: 296 .last_descendant: 328 -.children: 299 313 323 327 +.children: 299 323 327 .ancestors: 1 296 0 0 297 0 0 0 .ancestors_collapsed: 1 296 297 0 0 0 0 0 .dom_status: 4 4 0 0 1 0 0 0 @@ -5784,7 +5776,6 @@ .heading_ancestors_text: Podręcznik Systemów Live|Przegląd narzędzi|||Przegląd narzędzi||| .lev4_subtoc: 5~ ┥Pakiet live-build┝┤#299├ .lev4_subtoc: 6~ ┥Polecenie ⑆■┨lb config┣■┝┤#309├ -.lev4_subtoc: 5~ ┥Wcięcia┝┤#313├ .lev4_subtoc: 6~ ┥Polecenie ⑆■┨lb build┣■┝┤#319├ .lev4_subtoc: 6~ ┥Polecenie ⑆■┨lb clean┣■┝┤#321├ .lev4_subtoc: 5~ ┥Pakiet live-boot┝┤#323├ @@ -5806,8 +5797,8 @@ [299] heading :2 .part: body .parent: 297 -.last_descendant: 312 -.children: 309 +.last_descendant: 322 +.children: 309 319 321 .ancestors: 1 296 0 0 297 299 0 0 .ancestors_collapsed: 1 296 297 299 0 0 0 0 .dom_status: 4 4 0 0 4 1 0 0 @@ -5943,7 +5934,7 @@ [309] heading :3 .part: body .parent: 299 -.last_descendant: 312 +.last_descendant: 318 .ancestors: 1 296 0 0 297 299 309 0 .ancestors_collapsed: 1 296 297 299 309 0 0 0 .dom_status: 4 4 0 0 4 4 1 0 @@ -6000,32 +5991,25 @@ | ░P:░Creating░config░tree░for░a░debian/stretch/i386░system | ░P:░Symlinking░hooks... -[313] heading :2 +[313] para .part: body -.parent: 297 -.last_descendant: 322 -.children: 319 321 -.ancestors: 1 296 0 0 297 313 0 0 -.ancestors_collapsed: 1 296 297 313 0 0 0 0 -.dom_status: 4 4 0 0 4 3 2 0 -.dom_status_collapsed: 4 4 4 3 2 0 0 0 -.heading_lev_collapsed: 3 -.parent_lev: 4 +.parent: 309 +.ancestors: 1 296 0 0 297 299 309 0 +.ancestors_collapsed: 1 296 297 299 309 0 0 0 +.parent_lev: 6 .is_of_type: para -.sha256: B0BBE91CE148E33A1EF11F3DDA196AA65FD664B8608254EBC0695998C1C476A6 -.segment: overview-of-tools -.segment_epub: overview-of-tools +.sha256: F782CB88C3A54269FA96B9A8C30377D80CD5C498FBB682DAF837321997332293 +.has: links .segment_html_is: overview-of-tools .segment_epub_is: overview-of-tools -.heading_ancestors_text: Podręcznik Systemów Live|Przegląd narzędzi|||Przegląd narzędzi|Wcięcia|| -| Wcięcia +| Using ⑆■┨lb config┣■ without any arguments would be suitable for users who need a very basic image, or who intend to provide a more complete configuration via ⑆■┨auto/config┣■ later (see ┥Managing a configuration┝┤#managing-a-configuration├ for details). [314] para .part: body -.parent: 313 -.ancestors: 1 296 0 0 297 313 0 0 -.ancestors_collapsed: 1 296 297 313 0 0 0 0 -.parent_lev: 5 +.parent: 309 +.ancestors: 1 296 0 0 297 299 309 0 +.ancestors_collapsed: 1 296 297 299 309 0 0 0 +.parent_lev: 6 .is_of_type: para .sha256: E70FC218F3777BFCCE35E57DF06E7C314F94DDC90254D70C0E79987C39C87028 .segment_html_is: overview-of-tools @@ -6034,10 +6018,10 @@ [315] code .part: body -.parent: 313 -.ancestors: 1 296 0 0 297 313 0 0 -.ancestors_collapsed: 1 296 297 313 0 0 0 0 -.parent_lev: 5 +.parent: 309 +.ancestors: 1 296 0 0 297 299 309 0 +.ancestors_collapsed: 1 296 297 299 309 0 0 0 +.parent_lev: 6 .is_of_type: block .sha256: F66A0BC43542593190BB3117AC09F041CDBFAE760EE7CCF7062F6A41E22477CD .segment_html_is: overview-of-tools @@ -6046,10 +6030,10 @@ [316] para .part: body -.parent: 313 -.ancestors: 1 296 0 0 297 313 0 0 -.ancestors_collapsed: 1 296 297 313 0 0 0 0 -.parent_lev: 5 +.parent: 309 +.ancestors: 1 296 0 0 297 299 309 0 +.ancestors_collapsed: 1 296 297 299 309 0 0 0 +.parent_lev: 6 .is_of_type: para .sha256: C95991806FFB5410BD9103C8684FF8337D47696DF88FE5D8FD239934748B598F .segment_html_is: overview-of-tools @@ -6058,10 +6042,10 @@ [317] code .part: body -.parent: 313 -.ancestors: 1 296 0 0 297 313 0 0 -.ancestors_collapsed: 1 296 297 313 0 0 0 0 -.parent_lev: 5 +.parent: 309 +.ancestors: 1 296 0 0 297 299 309 0 +.ancestors_collapsed: 1 296 297 299 309 0 0 0 +.parent_lev: 6 .is_of_type: block .sha256: DD1C5401A3EE4D3C9BDB0CD0466C0921EFD048A4DFBB50AD1304C76DD599A5CF .segment_html_is: overview-of-tools @@ -6070,10 +6054,10 @@ [318] para .part: body -.parent: 313 -.ancestors: 1 296 0 0 297 313 0 0 -.ancestors_collapsed: 1 296 297 313 0 0 0 0 -.parent_lev: 5 +.parent: 309 +.ancestors: 1 296 0 0 297 299 309 0 +.ancestors_collapsed: 1 296 297 299 309 0 0 0 +.parent_lev: 6 .is_of_type: para .sha256: ADA85AA84482ECB1E2740784F5B52DA5E1AA06EEA4E33EAEBF5396DD8A18DE16 .segment_html_is: overview-of-tools @@ -6082,12 +6066,12 @@ [319] heading :3 .part: body -.parent: 313 +.parent: 299 .last_descendant: 320 -.ancestors: 1 296 0 0 297 313 319 0 -.ancestors_collapsed: 1 296 297 313 319 0 0 0 -.dom_status: 4 4 0 0 4 4 1 0 -.dom_status_collapsed: 4 4 4 4 1 0 0 0 +.ancestors: 1 296 0 0 297 299 319 0 +.ancestors_collapsed: 1 296 297 299 319 0 0 0 +.dom_status: 4 4 0 0 4 4 3 0 +.dom_status_collapsed: 4 4 4 4 3 0 0 0 .heading_lev_collapsed: 4 .parent_lev: 5 .is_of_type: para @@ -6097,14 +6081,14 @@ .segment_epub: overview-of-tools .segment_html_is: overview-of-tools .segment_epub_is: overview-of-tools -.heading_ancestors_text: Podręcznik Systemów Live|Przegląd narzędzi|||Przegląd narzędzi|Wcięcia|Polecenie ⑆■┨lb build┣■| +.heading_ancestors_text: Podręcznik Systemów Live|Przegląd narzędzi|||Przegląd narzędzi|Pakiet live-build|Polecenie ⑆■┨lb build┣■| | Polecenie ⑆■┨lb build┣■ [320] para .part: body .parent: 319 -.ancestors: 1 296 0 0 297 313 319 0 -.ancestors_collapsed: 1 296 297 313 319 0 0 0 +.ancestors: 1 296 0 0 297 299 319 0 +.ancestors_collapsed: 1 296 297 299 319 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 250C8FEB8C7C6049388E4322DB93432C21D87584563A9F8796578EAC2B88834A @@ -6114,10 +6098,10 @@ [321] heading :3 .part: body -.parent: 313 +.parent: 299 .last_descendant: 322 -.ancestors: 1 296 0 0 297 313 321 0 -.ancestors_collapsed: 1 296 297 313 321 0 0 0 +.ancestors: 1 296 0 0 297 299 321 0 +.ancestors_collapsed: 1 296 297 299 321 0 0 0 .dom_status: 4 4 0 0 4 4 3 0 .dom_status_collapsed: 4 4 4 4 3 0 0 0 .heading_lev_collapsed: 4 @@ -6129,14 +6113,14 @@ .segment_epub: overview-of-tools .segment_html_is: overview-of-tools .segment_epub_is: overview-of-tools -.heading_ancestors_text: Podręcznik Systemów Live|Przegląd narzędzi|||Przegląd narzędzi|Wcięcia|Polecenie ⑆■┨lb clean┣■| +.heading_ancestors_text: Podręcznik Systemów Live|Przegląd narzędzi|||Przegląd narzędzi|Pakiet live-build|Polecenie ⑆■┨lb clean┣■| | Polecenie ⑆■┨lb clean┣■ [322] para .part: body .parent: 321 -.ancestors: 1 296 0 0 297 313 321 0 -.ancestors_collapsed: 1 296 297 313 321 0 0 0 +.ancestors: 1 296 0 0 297 299 321 0 +.ancestors_collapsed: 1 296 297 299 321 0 0 0 .parent_lev: 6 .is_of_type: para .sha256: 333EED99EAA56AB5AFE84B46C4BCCF9B8168408492AB9E83A9B33E07987343A6 diff --git a/test/test-ocn-alignment.sh b/test/test-ocn-alignment.sh index f00a8ec..728ee53 100755 --- a/test/test-ocn-alignment.sh +++ b/test/test-ocn-alignment.sh @@ -2,23 +2,26 @@ # test-ocn-alignment.sh # # The languages of a document share their object numbering, and spine warns -# when they stop doing so. This checks that the warning appears where it -# should and, just as importantly, nowhere else. +# when they stop doing so. This checks both halves of that: that the sample +# set is silent, and that a document whose languages really do diverge is +# reported. # -# The sample set is the fixture, and it is a good one because it contains -# both answers: +# Two fixtures, because one cannot say both things: # -# live-manual ten languages, two of which diverge. -# ja has two fewer numbered objects than en. A missing -# translation of a short paragraph; everything below it -# is renumbered. -# pl has the same count, but the object at ocn 313 is a -# paragraph in en and a heading in pl. A heading given as -# running text, or running text given as a heading. -# everything else single language, or aligned. Silent. +# the sample set every document aligned, so nothing is reported at +# all. This is the half that would fail if a change +# made the check cry wolf, and the half that changed on +# 2026-09-18 when live-manual's ja and pl translations +# were mended. Until then ja was two objects short of +# en and pl had a stray heading at ocn 313, and this +# script asserted those two by name. # -# A check that only ever fires is as useless as one that never does, so the -# silence over the other documents is asserted too. +# a broken copy live-manual copied out of the sample set with one +# paragraph removed from one language, which is a count +# divergence and must be reported. Built here rather +# than relied upon, so that mending a translation +# cannot quietly leave the check untested. A check that +# never fires proves as little as one that always does. # # It also asserts that --strict turns the warning into a non-zero exit, and # that without --strict the run still succeeds: a document with a diverging @@ -90,64 +93,98 @@ if [ "$RUN_RC" -ne 0 ]; then head -5 "$OUT_DIR/run.err" fi -# what it said -if ! grep -q "^WARNING ocn alignment: live-manual$" "$OUT_DIR/run.err"; then - fail "no ocn alignment warning for live-manual" +# it must say nothing at all: every document in the set is aligned +n_docs=$(grep -c "^WARNING ocn alignment: " "$OUT_DIR/run.err" || true) +if [ "$n_docs" != "0" ]; then + fail "$n_docs document(s) reported over the sample set, expected none" + grep -A 3 "^WARNING ocn alignment: " "$OUT_DIR/run.err" | head -12 | sed 's/^/ /' fi -if ! grep -q "^ \[ja\] differs from \[en\]$" "$OUT_DIR/run.err"; then - fail "ja not reported as differing from en" + +# --strict over the whole set therefore passes too +set +e +$SPINE_BIN --show-abstraction --skip-output --strict \ + --output="$OUT_DIR/strict-ok" "$SAMPLES_DIR"/live-manual \ + > "$OUT_DIR/strict-ok.out" 2> "$OUT_DIR/strict-ok.err" +STRICT_OK_RC=$? +set -e +if [ "$STRICT_OK_RC" -ne 0 ]; then + fail "--strict exited $STRICT_OK_RC on a document whose languages agree" + head -5 "$OUT_DIR/strict-ok.err" fi -if ! grep -q "numbered objects: en 1019, ja 1017 (-2)" "$OUT_DIR/run.err"; then - fail "ja's object count difference not reported as -2" + +# and now the other half: a document that really does diverge. +# +# Built here, from a copy, by removing one paragraph from one language. The +# sample set no longer contains a divergence, and a check that never fires +# proves as little as one that always does. +echo "Breaking a copy, to see the check fire ..." +BROKEN="$OUT_DIR/broken" +mkdir -p "$BROKEN" +cp -a "$SAMPLES_DIR/live-manual" "$BROKEN/live-manual" +TARGET="$BROKEN/live-manual/media/text/de/about_manual.ssi" +if [ ! -f "$TARGET" ]; then + echo "ERROR: fixture not found: $TARGET" >&2 + exit 2 fi -if ! grep -q "^ \[pl\] differs from \[en\]$" "$OUT_DIR/run.err"; then - fail "pl not reported as differing from en" +# the first paragraph after the first heading, whole: a numbered object, so +# removing it renumbers everything below it in this language and no other. +# +# The whole of it, to the blank line that ends it. Dropping a single line of +# a wrapped paragraph leaves the paragraph there, one line shorter, and the +# object count unchanged: the first version of this fixture did that and the +# check correctly said nothing. +awk ' + BEGIN { state = 0 } + state == 0 && /^[A-Za-z]/ && !/^[0-9A-D]~/ && !/^:[A-D]~/ && !/^%/ && !/^@/ \ + { state = 1; next } + state == 1 && /^[[:space:]]*$/ { state = 2; next } + state == 1 { next } + { print } +' "$TARGET" > "$TARGET.new" && mv "$TARGET.new" "$TARGET" + +set +e +$SPINE_BIN --show-abstraction --skip-output \ + --output="$OUT_DIR/broken-out" "$BROKEN/live-manual" \ + > "$OUT_DIR/broken.out" 2> "$OUT_DIR/broken.err" +BROKEN_RC=$? +set -e +if [ "$BROKEN_RC" -ne 0 ]; then + fail "the run over the broken copy exited $BROKEN_RC; a warning must not fail a run" + head -5 "$OUT_DIR/broken.err" fi -if ! grep -q "ocn 313: para in en, heading:2 in pl" "$OUT_DIR/run.err"; then - fail "pl's substituted heading at ocn 313 not reported" +if ! grep -q "^WARNING ocn alignment: live-manual$" "$OUT_DIR/broken.err"; then + fail "the removed paragraph was not reported" + head -5 "$OUT_DIR/broken.err" | sed 's/^/ /' fi - -# and what it did not say: exactly one document warned about, exactly two -# languages of it -n_docs=$(grep -c "^WARNING ocn alignment: " "$OUT_DIR/run.err" || true) -if [ "$n_docs" != "1" ]; then - fail "$n_docs documents warned about, expected 1" - grep "^WARNING ocn alignment: " "$OUT_DIR/run.err" | sed 's/^/ /' +if ! grep -q "^ \[de\] differs from \[en\]$" "$OUT_DIR/broken.err"; then + fail "de not reported as differing from en" fi -n_langs=$(grep -c "^ \[.*\] differs from " "$OUT_DIR/run.err" || true) -if [ "$n_langs" != "2" ]; then - fail "$n_langs languages reported, expected 2 (ja and pl)" - grep "^ \[.*\] differs from " "$OUT_DIR/run.err" | sed 's/^/ /' +if ! grep -q "numbered objects: en .*, de .* (-1)" "$OUT_DIR/broken.err"; then + fail "de's object count not reported as one short" + grep "numbered objects" "$OUT_DIR/broken.err" | sed 's/^/ /' +fi +# only the language that was broken +n_langs=$(grep -c "^ \[.*\] differs from " "$OUT_DIR/broken.err" || true) +if [ "$n_langs" != "1" ]; then + fail "$n_langs languages reported on the broken copy, expected 1 (de)" + grep "^ \[.*\] differs from " "$OUT_DIR/broken.err" | sed 's/^/ /' fi -# --strict makes the same run fail +# and --strict makes that a failed run set +e $SPINE_BIN --show-abstraction --skip-output --strict \ - --output="$OUT_DIR/strict" "$SAMPLES_DIR"/live-manual \ - > "$OUT_DIR/strict.out" 2> "$OUT_DIR/strict.err" + --output="$OUT_DIR/broken-strict" "$BROKEN/live-manual" \ + > "$OUT_DIR/broken-strict.out" 2> "$OUT_DIR/broken-strict.err" STRICT_RC=$? set -e if [ "$STRICT_RC" -eq 0 ]; then fail "--strict exited 0 on a document whose languages diverge" fi -# and does not fail a document whose languages agree, or one that has only -# the one language -set +e -$SPINE_BIN --show-abstraction --skip-output --strict \ - --output="$OUT_DIR/strict-ok" "$SAMPLES_DIR"/the_wealth_of_networks.yochai_benkler \ - > "$OUT_DIR/strict-ok.out" 2> "$OUT_DIR/strict-ok.err" -STRICT_OK_RC=$? -set -e -if [ "$STRICT_OK_RC" -ne 0 ]; then - fail "--strict exited $STRICT_OK_RC on a single language document" - head -5 "$OUT_DIR/strict-ok.err" -fi - rm -rf "$OUT_DIR" if [ "$FAILURES" -eq 0 ]; then - echo "PASS: ja and pl reported on live-manual, silent elsewhere, --strict fails" + echo "PASS: the sample set is aligned, a broken copy is reported, --strict fails" exit 0 else echo "FAIL: $FAILURES check(s)" |