トランスクルージョン姉妹プロジェクト:データ項目ショートカット:H:TRANSHelp:Transcludeこのページでは、利用者が校正済みテキストを作業空間(IndexおよびPage名前空間)から、ウィキソース利用者が読めるMain空間に「トランスクルージョン」(参照読み込み)するのを手助けします。「Help:改ページ」も参照トランスクルージョンによって、コピー・ペーストしたり更新を同期したりする必要なく別ページの内容が表示されます。通常は文章を論理的かつ合理的な大きさの塊――ほとんどの場合は章または節――にグループ化するために使います。(1913).djvu/19の原文の一部と比べてみてください。(1913).djvuの個々のページは"Page:"名前空間に保存されており、トランスクルージョンを通じて本の章ごとにまとめられます。スキャンしたページから理解可能な章を作るのは、ウィキソースにおけるもっとも一般的なトランスクルージョンの用法です。このヘルプページではもっとも一般的なトランスクルージョンの方法を検討します。これだけで初めての文章を扱う際に十分役立ちます。次に、デジタルテキストを飛躍的に便利にするための、より発展的で特殊なトランスクルージョンの方法について議論します。最後に、2つのトランスクルージョンの方法の全機能を検討します。それでもなお、未解決の疑問やトランスクルージョンによる問題があれば、Wikisource:井戸端に質問してください。全ページをトランスクルージョンできる方法が2つあります。<pages/>機能と、より古い{{Page}}テンプレートです。ほとんどの場合<pages/>タグが最善のトランスクルージョン方法になりますが、今でもなお既存の文章を編集するときに古くなったテンプレートに遭遇するかもしれません。name.djvu"を作業するIndexの実際の名称に置き換えます。トランスクルージョンしたい最初のページが"x"です。トランスクルージョンしたい最後のページが"y"です。name.djvu"を作業するファイルの実際の名称に置き換えます。トランスクルージョンしたいページがファイル名に続くスラッシュ(/)の後の"x"です。元のスキャン画像の対応するページが"z"です。一度に1ページしかトランスクルージョンできない点に注意してください。Transclusion」も参照ページ全体をトランスクルージョンしたくないときがときにはあるでしょう。25.djvu/169をご覧ください。2つの章または論理的節が同じページに現れるときは、標準プレゼンテーション空間にページ全体ではなく関連箇所のみをトランクルージョンする必要があります。Plantsのようになります。名前空間内のアンカーによって印づけられます。それによりページの関連箇所がトランスクルージョン時に呼び出されます。/>で終わらせることもできます。註:sectionタグは引用符で"label"のように囲み、あいまいさをなくすことを推奨します。ラベルにつけるテキストは自由ですが、ページ上の文脈に適したラベルには利点がある可能性があります。英数字を使うのが通常推奨され、他の拡張的文字はトランスクルージョン時に問題を引き起こすかもしれません。ラベルはページ内の関連する節と別のものにする必要があり、そうすることで対象の節が適切に抽出されます。<poem>マーカーを使うときは、節の中で開始・終了するようにしてください。しなければ、節のトランスクルージョンが適切に機能しません。Main名前空間へのトランスクルージョン[編集]トランスクルージョンをアンカー地点で終わらせるため、<pages>にさらなる引数tosectionが必要になります。name.djvu"は取り組んでいるファイルの正確な名前に置き換えます。トランスクルージョンしたい最初のページが"x"です。トランスクルージョンしたい最後のページが"y"です。"label"は挿入したアンカー名で置き換えます。tosection=E169/>アンカー地点の章または節の最初のページを始めるには、fromsection引数が必要になります。name.djvu"は取り組んでいるファイルの正確な名前に置き換えます。トランスクルージョンしたい最初のページが"x"です。トランスクルージョンしたい最後のページが"y"です。"label"は挿入したアンカー名で置き換えます。/>連続する節がページの途中で終わるときは、追加的引数が両方一度に必要になるかもしれません。単一の節をトランスクルージョンする方法[編集]論理的な単一の節が単一のPage:のコンテンツ内で開始・終了しているときは、ページのコンテンツから関連する節のみをトランスクルージョンするのが望ましいです。Transclusionによって実現できます。繰り返しますが、ページのコンテンツの関連部の開始箇所と終了箇所をsectionタグで印づけ、それからトランスクルージョン時に、ページ全体でなく、マークした部分のみ呼び出されます。/>これが節Aの文章です。/>基本的方法が3つ、またそのそれぞれにいくつかの追加的ヴァリエーションがあります。それによって一の節のコンテンツ(単一ページ内)をトランスクルージョンすることができます。<pages>タグ機能、{{Page}}テンプレート、および#sectionタグ・パーサーです。<pages>タグが単一の節をトランスクルージョンする最善の方法です。構文は以下のとおりです。/>(この例において、ページ範囲が単一ページから成り立っています;20ページ)onlysectionがトランスクルージョンしたいコンテンツを含むsectionタグに割り当てられたラベル名です。上記がコミュニティ内で広く認められている推奨される設定です。有効だが非推奨[編集]テンプレート{{Page}}は、djvuファイル名"djvu"と表示するページの番号"#"の代わりに、以下のように使うことができます:{{Page|djvu/#|section=sectionA}}あるいは、記事名"article"(名前空間を除く)の代わりに、以下のような形で使うことができます:{{#section:Page:article|sectionA}}問題が生じた場合はWikisource:井戸端に質問してください。トランスクルージョンしたテキストに画像を追加する方法[編集]Main名前空間に写真またはその他の画像を置くための好ましい手段は、切り抜いた図画を分割した画像として、たとえばPNGまたはJPEGファイルとしてウィキメディア・コモンズにアップロードするというものです。subject.png|frameless|center]]ページ画像は書籍のウィキソースの名前空間に表示することもできます。Tree}}]]高度な使用法[編集]トランスクルージョンは、校正と検証を繰り返す必要なくテキストを別の方法で表示するためにも使えます。Tales(ケルト童話)で出版されたGuleesh(グリーシュ)の物語を提示しています。Tales上の前後の物語を表示し、また編者による序文および解説へのリンクもあります。別法として、en:Guleeshは同じ文章を単独の作品として提示しています。収録されていたかもしれない版の外で適切な題名を表示するのは、たまたまある雑誌に印刷されていた有名なエッセイをその雑誌のサブページとして表示する必要がないのと同様に、必要ありません。どちらも同じ検証済み文章をトランスクルージョンすることでできます。ウィキソース上の総意では個々の編集者が好きな様式を使うことを包括的に認めています。複雑なトランスクルージョンを使用することで、複数版の比較研究を表示することもできます。textでは1633年印刷版の詩を1896年印刷版と比較しています。このようなより複雑な種類のトランスクルージョンは実際のところ一般的ではありません。ここで使用した例は、トランスクルージョンと以前の校正ページ拡張機能で何ができるかを確かめるための実験です。名前空間から呼び出されます。<pages/>機能を使う[編集]ほとんどの場合、<pages/>タグがトランスクルージョンの最善の方法です。要求される引数はindex=1つだけです。この欄には必ず入力しなければならず、そうしなければ何も起こりません。name.djvu"/>。name.djvuはただのプレースホルダーで、校正中に使っているファイル名が入力されます。(1913).djvu"/>をサンドボックスにコピーして保存してください。これをタイプして入力しても同じ結果になります。index=Wind_in_the_Willows_(1913).djvu/>も試してみてください。これも全く同じ働きをします。(1913).djvu/>は機能しないでしょう。囲む必要もあり、そうしないと機能しないおそれがあります。index=欄は必ず入力しなければならない一方、他の引数を一切追加しない場合、この構文はファイルの目次しかトランスクルージョンしません。任意の引数の一部も入力すると必ず、目次が他のコマンドによって置換されます。これらの任意の引数の一部には、ペアとして一緒に使わないと機能しないものがあります。後ろの名目上の番号です。任意の引数は以下のとおりです。トランスクルージョンするページ番号を入力します。トランスクルージョンする最初のページを入力します。トランスクルージョンする最後のページを入力します。当該節の始めのページの最初のアンカーを入力します。当該節の終わりのページの最後のアンカーを入力します。トランスクルージョンするセクションをマークするために使ったアンカーを入力します。xページずつトランスクルージョンするときの増分を入力します。増分nずつ飛ばしながらページをトランスクルージョンします。/>では1ページ、3ページ、5ページ、7ページ、および9ページが表示されます。include以下のページを含めます。これにおいては、より自由な列挙が認められています。/>は2ページ、3ページ、4ページ、5ページ、および9ページを表示します。exclude以下のページを含めません。/>は1ページ、6ページ、7ページ、8ページ、および10ページを表示します。同一タグ内で全属性を使うことができます。/>は1ページ、5ページ、7ページ、9ページ、および31ページを表示します。註:グッド・プラクティスとして、<pages>タグ内の属性は引用符で囲むべきです。タグ内に引用符のないカラ属性がないのが重要で、そのためカラ属性を引用符で囲むか、必要ない任意の属性を削除するかしてください。表示-継承ライセンスのもとで利用できます。追加の条件が適用される場合があります。詳細については利用規約を参照してください。Cookieに関する声明モバイルビュ。