debian/cdesktop
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial import of the CDE 2.1.30 sources from the Open Group.

Browse Source
This commit is contained in:
Peter Howkins
2012-03-10 18:21:40 +00:00
commit 83b6996daa
18978 changed files with 3945623 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/BEntity.sgm Normal file
View File

@@ -0,0 +1,22 @@
<!-- $XConsortium: BEntity.sgm /main/1 1996/12/17 05:46:13 cde-hit $ -->
<!ENTITY infoapg.fig.1 SYSTEM "./infoAPg/graphics/infostr.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.2 SYSTEM "./infoAPg/graphics/docsrc.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.3 SYSTEM "./infoAPg/graphics/multss.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.4 SYSTEM "./infoAPg/graphics/bkcase.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.5 SYSTEM "./infoAPg/graphics/blddir.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.6 SYSTEM "./infoAPg/graphics/newlib.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.7 SYSTEM "./infoAPg/graphics/addbkcas.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.8 SYSTEM "./infoAPg/graphics/repbkcas.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.9 SYSTEM "./infoAPg/graphics/tlkitmod.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.10 SYSTEM "./infoAPg/graphics/docuhier.cgm" NDATA CGM-BINARY>

3
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/Title.tmpl Normal file
View File

@@ -0,0 +1,3 @@
/* $XConsortium: Title.tmpl /main/1 1996/09/22 13:54:15 rws $ */
/* TOC title, only what's between quotes should be modified. */
title = "共通デスクトップ環境 インフォメーション・システム設計者およびプログラマのためのガイド"

99
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/adbook.sgm Normal file
View File

@@ -0,0 +1,99 @@
<!-- $XConsortium: adbook.sgm /main/1 1996/12/17 05:46:35 cde-hit $ -->
<!DOCTYPE DOCBOOK PUBLIC "-//HaL and O'Reilly//DTD DocBook V2.2.1//EN" [
<!ENTITY CDEcopyright "<GlossTerm Role=nogloss>Common Desktop Environment 1.x Internal Release</GlossTerm>
&copy; Copyright 1996 Digital Equipment Corp.
&copy; Copyright 1996 Fujitsu Limited
&copy; Copyright 1996 Hewlett-Packard Company
&copy; Copyright 1996 Hitachi, Ltd.
&copy; Copyright 1996 International Business Machines Corp.
&copy; Copyright 1996 Novell, Inc.
&copy; Copyright 1996 Sun Microsystems, Inc.">
<!ENTITY headerFix "&empty;">
<!ENTITY AbstractBullet "&bullet;">
<!ENTITY empty "">
<!ENTITY newline SDATA "[newlin]">
<!ENTITY emdash "&mdash;">
<!ENTITY bullet "&bull;">
<!ENTITY dquote "&rdquor;">
<!ENTITY sigspace "&nbsp;">
<!ENTITY vellipsis "&vellip;">
<!ENTITY tm "&trade;">
<!ENTITY a.m. "AM">
<!ENTITY cents "&cent;">
<!ENTITY date SDATA "[date]">
<!ENTITY div "&divide;">
<!ENTITY ellipsis "&hellip;">
<!ENTITY endash "&ndash;">
<!ENTITY geq "&ge;">
<!ENTITY leq "&le;">
<!ENTITY minutes "&prime;">
<!ENTITY neq "&ne;">
<!ENTITY p.m. "PM">
<!ENTITY pellipsis "....">
<!ENTITY pm "&plusmn;">
<!ENTITY seconds "&Prime;">
<!ENTITY squote "&rsquor;">
<!ENTITY sterling "&pound;">
<!ENTITY time SDATA "[time]">
<!ENTITY vblank SDATA "[vblank]">
<!ENTITY ProductName "CDE Desktop">
<!ENTITY infoapg.fig.1 SYSTEM "./graphics/infostr.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.2 SYSTEM "./graphics/docsrc.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.3 SYSTEM "./graphics/multss.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.4 SYSTEM "./graphics/bkcase.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.5 SYSTEM "./graphics/blddir.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.6 SYSTEM "./graphics/newlib.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.7 SYSTEM "./graphics/addbkcas.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.8 SYSTEM "./graphics/repbkcas.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.9 SYSTEM "./graphics/tlkitmod.cgm" NDATA CGM-BINARY>
<!ENTITY infoapg.fig.10 SYSTEM "./graphics/docuhier.cgm" NDATA CGM-BINARY>
<!ENTITY % local.notations "| XPM | XBM | XWD">
<!NOTATION xpm SYSTEM "XPM">
<!NOTATION xbm SYSTEM "XBM">
<!NOTATION xwd SYSTEM "XWD">
<!ENTITY preface SYSTEM "./preface.sgm">
<!ENTITY overview SYSTEM "./ch01.sgm">
<!ENTITY struct SYSTEM "./ch02.sgm">
<!ENTITY prebuild SYSTEM "./ch03.sgm">
<!ENTITY build SYSTEM "./ch04.sgm">
<!ENTITY admin SYSTEM "./ch05.sgm">
<!ENTITY trouble SYSTEM "./ch06.sgm">
<!ENTITY undss SYSTEM "./ch07.sgm">
<!ENTITY createss SYSTEM "./ch08.sgm">
<!ENTITY archform SYSTEM "./ch09.sgm">
<!ENTITY useform SYSTEM "./ch10.sgm">
<!ENTITY tocform SYSTEM "./ch11.sgm">
<!ENTITY glossary SYSTEM "./glossary.sgm">
]>
<docbook>
<book>
&preface;
&overview;
&struct;
&prebuild;
&build;
&admin;
&trouble;
&undss;
&createss;
&archform;
&useform;
&tocform;
&glossary;
</book>
</docbook>

76
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/book.sgm Normal file
View File

@@ -0,0 +1,76 @@
<!-- $XConsortium: book.sgm /main/1 1996/12/17 05:46:45 cde-hit $ -->
<!DOCTYPE Book PUBLIC "-//HaL and O'Reilly//DTD DocBook//EN" [
<!ENTITY % ISOpublishing PUBLIC "ISO 8879-1986//ENTITIES Publishing//EN">
%ISOpublishing;
<!ENTITY % ISOnumeric PUBLIC "ISO 8879-1986//ENTITIES Numeric and Special Graphic//EN">
%ISOnumeric;
<!ENTITY % ISOdiacritical PUBLIC "ISO 8879-1986//ENTITIES Diacritical Marks//EN">
%ISOdiacritical;
<!ENTITY % ISOgeneraltech PUBLIC "ISO 8879-1986//ENTITIES General Technical//EN">
%ISOgeneraltech;
<!ENTITY % ISOalatin1 PUBLIC "ISO 8879-1986//ENTITIES Added Latin 1//EN">
%ISOalatin1;
<!ENTITY % ISOalatin2 PUBLIC "ISO 8879-1986//ENTITIES Added Latin 2//EN">
%ISOalatin2;
<!ENTITY % ISOgreek PUBLIC "ISO 8879-1986//ENTITIES Greek Symbols//EN">
%ISOgreek;
<!ENTITY % ISOboxandline PUBLIC "ISO 8879-1986//ENTITIES Box and Line Drawing//EN">
%ISOboxandline;
<!ENTITY % BEntities SYSTEM "./infoAPg/BEntity.sgm">
%BEntities;
<!ENTITY % local.notations "| XPM | XBM | XWD">
<!NOTATION XPM SYSTEM "XPM">
<!NOTATION XBM SYSTEM "XBM">
<!NOTATION XWD SYSTEM "XWD">
<!ENTITY preface SYSTEM "./infoAPg/preface.sgm">
<!ENTITY overview SYSTEM "./infoAPg/ch01.sgm">
<!ENTITY struct SYSTEM "./infoAPg/ch02.sgm">
<!ENTITY prebuild SYSTEM "./infoAPg/ch03.sgm">
<!ENTITY build SYSTEM "./infoAPg/ch04.sgm">
<!ENTITY admin SYSTEM "./infoAPg/ch05.sgm">
<!ENTITY trouble SYSTEM "./infoAPg/ch06.sgm">
<!ENTITY undss SYSTEM "./infoAPg/ch07.sgm">
<!ENTITY createss SYSTEM "./infoAPg/ch08.sgm">
<!ENTITY archform SYSTEM "./infoAPg/ch09.sgm">
<!ENTITY useform SYSTEM "./infoAPg/ch10.sgm">
<!ENTITY tocform SYSTEM "./infoAPg/ch11.sgm">
<!ENTITY glossary SYSTEM "./infoAPg/glossary.sgm">
]>
<!-- ____________________________________________________________________________ -->
<Book>
<Title>共通デスクトップ環境 インフォメーション・システム設計者およびプログラマのためのガイド</Title>
&preface;
&overview;
&struct;
&prebuild;
&build;
&admin;
&trouble;
&undss;
&createss;
&archform;
&useform;
&tocform;
&glossary;
</Book>

184
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch01.sgm Normal file
View File

@@ -0,0 +1,184 @@
<!-- $XConsortium: ch01.sgm /main/4 1996/10/11 09:23:23 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<Chapter id="infoapg.div.1">
<Title id="n0Crl2IBiWmBt8oL">構築過程およびツールについて</Title>
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary>
<Secondary>構築</Secondary><Tertiary>過程概要</Tertiary></IndexTerm>
<Para>
本節では、オンラインのインフォメーション・ライブラリを作成するために実行する構築過程についての簡潔な概要を示します。また、構築を実行するために、インフォメーション・マネージャで適用できるソフトウェア・ツールについても説明します。
</Para>
<Para>
インフォメーション・マネージャでオンラインのインフォメーション・ライブラリを構築するには、構築するブックのための SGML に準拠した一連の文書を用意しなければなりません。これには、適切な文書型定義 (DTD)、ブックのソース・ドキュメント、各ブックの目次 (TOC)、ブックのオンライン形式と印刷形式を管理するスタイル・シート、およびソース・ドキュメントを編成するブックケース規定が含まれます。
</Para>
<Para>
ブックに関連する文書型定義は、インフォメーション・マネージャ設計様式を使用しなければなりません。文書型定義に、これらの設計様式を適用する方法については、<Link Linkend="nWGeMZBc9og24aK">「設計様式の使用」を参照してください。
</Link>.
</Para>
<Sect1>
<Title id="n4Crl2IBiWmBt8oL">過程概要</Title>
<IndexTerm><Primary>ソフトウェア・ツール</Primary><Secondary>過程概要</Secondary></IndexTerm>
<Para>
SGML のソースからインフォメーション・マネージャのブラウザ・ファイルを作成、管理する一般的な過程は、次の節で説明しています。
</Para>
<ItemizedList>
<ListItem>
<Para>
<Link Linkend="sidr7JBU3pBt8oL">「構築準備」</Link>この節では、次のことを説明しています。
</Para>
<ItemizedList>
<ListItem>
<Para>インフォメーション・マネージャでブラウズ可能なブックの検証と構築を正常に行う必要があるファイルの説明。これらには、次のものがあります。
</Para>
<ItemizedList>
<ListItem>
<Para>ブックを作成する SGML 文書。
</Para>
</ListItem>
<ListItem>
<Para>各ブックのハイパーテキスト目次 (TOC)。
</Para>
</ListItem>
<ListItem>
<Para>スタイル・シート。
</Para>
</ListItem>
<ListItem>
<Para>ブックケース規定。
</Para>
</ListItem>
</ItemizedList>
</ListItem>
<ListItem>
<Para>有効なハイパーテキスト目次 (TOC) を作成するための手続き。
</Para>
</ListItem>
<ListItem>
<Para>インフォメーション・マネージャによるスタイル・シートの利用方法およびブックケース規定におけるスタイル・シートの指定方法に関する記述。
</Para>
</ListItem>
<ListItem>
<Para>ブックケース規定を作成する手続き。
</Para>
</ListItem>
<ListItem>
<Para>ブックケース規定の例
</Para>
</ListItem>
</ItemizedList>
</ListItem>
<ListItem>
<Para>
<Link Linkend="fi1SgFBr-1698oL">「インフォメーション・ライブラリの構築」
</Link>.
この節では、次のことを説明しています。
</Para>
<ItemizedList>
<ListItem>
<Para>
SGML 文書の<Link Linkend="KyEB2dBpuI9X3cS">「検証」</Link>。
</Para>
</ListItem>
<ListItem>
<Para>
新規インフォメーション・ライブラリの<Link Linkend="xXk7ubBtGL9X3cS">「構築」</Link>
</Para>
</ListItem>
<ListItem>
<Para>
既存ライブラリへのブックケースの<Link Linkend="n7Ktl2IBUXmBt8oL">「追加」</Link>
</Para>
</ListItem>
<ListItem>
<Para>
既存ライブラリのブックケースの<Link Linkend="pOUExiBLxJ9X3cS">「置換」</Link>
</Para>
</ListItem>
<ListItem>
<Para>
構築されたブックケース中のスタイル・シートの<Link Linkend="WmNvZbBE6K9X3cS">「更新」</Link>
</Para>
</ListItem>
</ItemizedList>
</ListItem>
<ListItem>
<Para>
<Link Linkend="B7XKbKBcgmg24aK">「ブックケースの管理」</Link>.
この節では、インフォメーション・ライブラリにおけるブックケースのコピー、削除、一覧表示、名称変更、および再調整の方法について説明しています。
</Para>
</ListItem>
</ItemizedList>
</Sect1>
<Sect1>
<Title id="n3Crl2IBiWmBt8oL">ツール概要</Title>
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary>
<Secondary>構築</Secondary><Tertiary>ツール概要</Tertiary></IndexTerm>
<IndexTerm><Primary>ソフトウェア・ツール</Primary><Secondary>概要</Secondary></IndexTerm>
<Para>
インフォメーション・マネージャを使用してライブラリを構築するには、次のことを行います。
</Para>
<ItemizedList>
<ListItem>
<Para><filename>dtinfoTOC.dtd(5)</filename> に基づいた各ブックのハイパーテキスト目次を作成します。
</Para>
<Para>
<Link Linkend="n8aJ92dBIsI9X3cS">「目次の作成」</Link>を参照してください。
</Para>
</ListItem>
<ListItem>
<Para>構築する SGML 文書の <filename>dtinfoStyle.dtd(5)</filename> に基づいた有効なインフォメーション・マネージャのスタイル・シートを提供あるいは作成します。
</Para>
<Para>
<Link Linkend="tgmdnkb6vm9x3cs">「インフォメーション・マネージャのスタイル・シート」</Link>を参照してください。
</Para>
</ListItem>
<ListItem>
<Para><filename>dtinfoBook.dtd(5)</filename> に基づいたブックケース規定を作成します。
</Para>
<Para>
<Link Linkend="TcQg4bBSxI9X3cS">「ブックケース規定の作成」</Link>を参照してください。
</Para>
</ListItem>
<ListItem>
<Para><Command>dtinfogen build</Command> コマンドを使用して、ブラウザで表示可能なインフォメーション・ライブラリを構築します。
</Para>
<Para>
<Link Linkend="fi1SgFBr-1698oL">「インフォメーション・ライブライの構築」</Link>を参照してください。
</Para>
</ListItem>
</ItemizedList>
<Para>
すでに構築されているインフォメーション・マネージャのライブラリについては、次に示すことができます。
</Para>
<ItemizedList>
<ListItem>
<Para><Command>dtinfogen update</Command> コマンドを使用して、データベースを再構築せずに、文書データベースに存在するスタイル・シートまたはスタイル・シート情報を置き換えることができます。
</Para>
<Para>
<Link Linkend="WmNvZbBE6K9X3cS">「構築されたブックケースのスタイル・シートの更新」</Link> を参照してください。
</Para>
</ListItem>
<ListItem>
<Para><Command>dtinfogen build</Command> コマンドを使用して、ライブラリのブックケースの追加や置換を行うことができます。
</Para>
<Para>
<Link Linkend="n7Ktl2IBUXmBt8oL">「既存ライブラリへのブックケースの追加」</Link>および
<Link Linkend="pOUExiBLxJ9X3cS">「既存ライブラリのブックケースの置換」</Link>を参照してください。
</Para>
</ListItem>
<ListItem>
<Para><Command>dtinfogen admin</Command> コマンドを使用して、ライブラリのブックケースのコピー、名称変更、一覧表示、および再調整を行うことができます。
</Para>
<Para>
<Link Linkend="B7XKbKBcgmg24aK">「ブックケースの管理」</Link>を参照してください。
</Para>
</ListItem>
</ItemizedList>
</Sect1>
</Chapter>

168
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch02.sgm Normal file
View File

@@ -0,0 +1,168 @@
<!-- $XConsortium: ch02.sgm /main/4 1996/10/11 09:23:31 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<Chapter id="infoapg.div.2">
<Title id="GCgdOlB-xG9X3cS">SGML およびインフォメーション・マネージャの文書構造</Title>
<IndexTerm><Primary>文書構造</Primary></IndexTerm>
<Para>
この章では、インフォメーション・マネージャのオンライン文書モデルに関係する SGML の概念と用語について、簡潔かつ非常に高水準の内容を示します。また、インフォメーション・マネージャによるオンライン表現のための SGML 文書の構成方法についても説明します。これには、次の３つのトピックがあります。
</Para>
<ItemizedList>
<ListItem>
<Para>
<Link Linkend="OCgdOlB-xG9X3cS">「SGML による情報の構造化方法」</Link>
</Para>
</ListItem>
<ListItem>
<Para>
<Link Linkend="GI.RgFBe.1698oL">「インフォメーション・マネージャによるオンライン情報の構成方法」</Link>
</Para>
</ListItem>
</ItemizedList>
<Para>
構築過程について学びたい場合は、
<Link Linkend="sidr7JBU3pBt8oL">「構築準備」</Link>
を直接参照してください。
</Para>
<Sect1>
<Title id="OCgdOlB-xG9X3cS">「SGML による情報の構造化方法」</Title>
<Para>
SGML (Standard Generalized Markup Language) は、文書内の情報の構造を定義するための国際的な標準です。これは、文書の要素を識別し、正規マークアップ言語を使用して、これらの要素の相互関係を記述することによって行います。
</Para>
<Para>
要素は、章、段落、表、グラフィックなどのような SGML 文書の論理的な構築単位です。
SGML 標準 (<CiteTitle>ISO 8879</CiteTitle>) で記述されているように、「文書は、文書の内容を形成する要素のツリーの最上位ノードである文書要素を含む論理的な構築物」です。
</Para>
<Para>
この論理的な要素の階層構造は、ファイル、ファイルの一部分、グラフィック、および他のデータを含む物理的なエンティティの集まりから形成されます。これらの物理的なエンティティは、与えられた文書から文書型定義 (DTD) によって定義される論理的な構造を構築する過程において、引き出されます。
</Para>
<Para>
文書型定義の簡潔な説明を次に示します。
</Para>
<Sect2>
<Title id="aCgdOlB-xG9X3cS">文書型定義</Title>
<Para>
与えられた文書に含まれる要素の型、その順序、および頻度を規定する規則は、文書型定義 (DTD) と呼ばれる特別な SGML 文書において定義されます。
</Para>
<Para>
文書型定義には、与えられた型の文書で使用できる要素の一覧とともに、文書のクラスを保持する形成規則があります。
</Para>
<Para>
たとえば、文書型定義は、文書が少くともひとつの章、要約梗概、および索引から構成されなければならないことを要求します。
</Para>
<Para>
さらに、たとえば「章はタイトルをともなって開始され、その後にひとつまたは複数の段落が続き、それぞれは順序付けされたリスト、項目にマークのあるリスト、表、グラフィックなどを含むことができる」というように、これらの要素の関係および内容についても定義します。
</Para>
<Para>
与えられた文書型および要素がもつことができる属性に合致する要素の定義過程を通じて、文書型定義は文書の構造を記述します。
</Para>
<Para>SGML 規格に関する詳細については
<Link Linkend="Q3yRgFBsz1698oL">「関連文書」</Link>を参照してください。
</Para>
</Sect2>
</Sect1>
<Sect1>
<Title id="GI.RgFBe.1698oL">「インフォメーション・マネージャによるオンライン情報の構成方法」</Title>
<Para>
インフォメーション・マネージャのブックリスト・ウィンドウでオンライン情報を表示する場合、関係するトピックについてのブックのひとつまたは複数の<FirstTerm>ブックケース</FirstTerm>の集まりが表示されます。この集まりは、<FirstTerm>インフォメーション・ライブラリ</FirstTerm>として参照されます。各ブックケースには、ひとつまたは複数の<FirstTerm>ブック</FirstTerm>が含まれます。
</Para>
<Para>
この節では、インフォメーション・マネージャのオンライン情報の構造について説明します。図<Link Linkend="pIfh7JBpooBt8oL">「オンライン情報の構造」</Link>は、インフォメーション・マネージャのライブラリ構造を示しています。
</Para>
<Sect2>
<Title id="UIfh7JBpooBt8oL">オンライン情報の構造</Title>
<IndexTerm><Primary>オンライン情報</Primary><Secondary>～の構造</Secondary></IndexTerm>
<Para>
インフォメーション・マネージャのインフォメーション・ライブラリ (infolib) は、インフォメーション・システム・ツールキットと呼ばれるソフトウェア・ツールのセットによって、SGML 準拠の文書から作成されます。SGML 文書には、各ブックケースのブックを形成するすべてのテキスト、表、グラフィック、および他の関係する要素が含まれます。インフォメーション・マネージャのツールは、入力として SGML を受け取り、内部的にハイパーテキストでリンクされたデータベースに編成します。これは、ライブラリ内の情報のうち、指定された部分の抽出を、非常に効果的に行います。
<IndexTerm><Primary>SGML 文書</Primary></IndexTerm>
</Para>
<Para>
インフォメーション・マネージャのインフォメーション・ライブラリの各ブックには、ハイパーテキストの目次 (TOC) およびひとつまたは複数のセクションが含まれます。ハイパーテキスト目次 (TOC)<IndexTerm><Primary>目次</Primary></IndexTerm> は、インフォメーション・マネージャのあるオンライン・ブックへのエントリ・ポイントです。目次は、文書の構造を記述し、セクションに含まれる特定の情報を文書全体にわたって検索するときの支援となる対話的な電子地図として働きます。オンライン文書本文中のセクションに移動するには、目次中の望むセクションのタイトルを単純に選択するだけです。
</Para>
<Para>
セクションは、インフォメーション・マネージャのオンライン・ブックにおける情報の最小単位です。これは、まず第一にテキストですが、グラフィックや表を含むこともできます。
</Para>
<Para>
インフォメーション・マネージャは、ハイパーテキスト・リンク<IndexTerm><Primary>ハイパーテキスト・リンク</Primary></IndexTerm>を通じて、ブックのセクションを目次へ接続します。目次の各エントリには、その値がオンライン文書中のセクションにマップされる一意のハイパーテキスト・リファレンスがあります。
</Para>
<Para>
これらの目次ハイパーテキスト・リンクは、インフォメーション・マネージャにみられる多くの高度な文書検索機能を提供します。これには、分解可能なブックリスト、グラフィカル・ロケーション・マップ、および階層構造の印刷も含まれます。
</Para>
</Sect2>
<Sect2>
<Title id="fIfh7JBpooBt8oL">オンライン情報の階層構造</Title>
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary><Secondary>インフォメーション階層構造</Secondary></IndexTerm>
<Para>
インフォメーション・マネージャで構造化されるオンライン情報の階層構造は、次のものから構成されます。
</Para>
<VariableList>
<VarListEntry>
<Term>インフォメーション・ライブラリ</Term>
<ListItem>
<Para>
ブックケースの集まりです。
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>ブックケース</Term>
<ListItem>
<Para>
スタイル・シートおよびブックの集まりです。ブックケースにも、ツールキットによって作成された全テキストの検索インデックスがあります。
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>ブック</Term>
<ListItem>
<Para>
ハイパーテキスト目次 (TOC) の下で編成されたひとつまたは複数のセクション
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>セクション</Term>
<ListItem>
<Para>
ブックにおける情報の最小単位です。各セクションは、目次で参照され、ブラウザの読み込みウィンドウで表示可能です。
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Figure>
<Title id="pIfh7JBpooBt8oL">オンライン情報の構造</Title>
<GRAPHIC id="gr54" entityref="infoapg.fig.1"></graphic>
</Figure>
<Para>
インフォメーション・システム・ツールキットで文書を正確に構造化するためには、インフォメーション・マネージャ設計様式を、文書の文書型定義に適用しなければなりません。文書型定義へのインフォメーション・マネージャ設計様式の適用が、既存の文書インスタンスを損なうことはありません。
</Para>
<Para>
インフォメーション・マネージャとともにリリースされる文書型定義、<filename>dtinfoBook.dtd</filename>、<filename>dtinfoTOC.dtd</filename>、<filename>dtinfoStyle.dtd</filename>、および <filename>docbook.dtd</filename> には、すでにこれらの設計様式が含まれています。
</Para>
<Para>ユーザの文書の文書型定義へのインフォメーション・マネージャ設計様式の適用方法については、
<Link linkend="infoapg.div.10">「設計様式の使用」</LINK>を参照してください。
</Para>
<para>
関連情報については、以下を参照してください。
</para>
<ItemizedList>
<ListItem>
<Para>
<Link Linkend="n1Pih7JBbpoBt8oL">「必要なファイル」</Link>
</Para>
</ListItem>
<ListItem>
<Para>
<Link Linkend="jI.RgFBe.1698oL">「注釈の構築」</Link>
</Para>
</ListItem>
</ItemizedList>
</sect2>
</Sect1>
</Chapter>

888
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch03.sgm Normal file
View File

@@ -0,0 +1,888 @@
<!-- $XConsortium: ch03.sgm /main/4 1996/10/11 09:23:39 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<chapter id="infoapg.div.3">
<title id="sidr7JBU3pBt8oL">構築準備</title>
<indexterm><primary>ブック・ソース</primary><secondary>準備</secondary>
</indexterm>
<para>
インフォメーション・システム・ツールキットのツールは、インフォメーション・マネージャで表示可能なドキュメントを構築するために、大量の異なる SGML ファイルを処理します。この節では、インフォメーション・マネージャでドキュメントを構築するときに必要なファイルについて説明します。
<indexterm><primary>インフォメーション・ライブラリ</primary><secondary>構築
</secondary><tertiary>必要なファイル</tertiary></indexterm>
</para>
<sect1>
<title id="n1Pih7JBbpoBt8oL">必要なファイル</title>
<indexterm><primary>構築要件</primary>
<secondary>必要なファイル</secondary></indexterm>
<para>
インフォメーション・マネージャでブラウズ可能なブックを構築するには、次のファイルを用意しなければなりません。
</para>
<itemizedlist>
<listitem>
<para>
<link linkend="jbQg4bBSxI9X3cS">「ブック・ソース・ドキュメント」</link>
これらの SGML に準拠したドキュメントには、ブックのテキストおよびその SGML マークアップが含まれます。
</para>
</listitem>
<listitem>
<para>
<link linkend="n3NGoZbBosJ9X3cS">「目次ファイル」</link>
インフォメーション・マネージャのブックのそれぞれは、<filename>dtinfoTOC.dtd(5)</filename> に準拠したハイパーテキスト目次 (TOC) を必要とします。ハイパーテキスト目次 (TOC) は、<command>dtinfogen tocgen</command> コマンドを使用して作成することができます。
</para>
</listitem>
<listitem>
<para>
<link linkend="j3fa6XBbiK9X3cS">「スタイル・シート」</link>
スタイル・シートは、ブックのフォーマット作成を管理します。インフォンメーション・マネージャでは、ブックのオンライン形式および印刷出力形式の両方について、スタイル・シートを指定することができます。スタイル・シートは、<filename>dtinfoStyle.dtd(5)</filename> に準拠していなければなりません。
</para>
</listitem>
<listitem>
<para>
<link linkend="r58-aZBwFK9X3cS">「ブックケース規定」</link>
<filename>dtinfoBook.dtd(5)</filename> に準拠するブックケース規定には、構築過程において、インフォメーション・マネージャによって必要とされるすべての SGML エンティティが含まれるか、その参照が作成されます。ブックケース規定は、単一のブックでも、多くのブックを含むインフォメーション・マネージャの完全なインフォメーション・ライブラリでも、その構築で使用することができます。
</para>
<para>
<link linkend="TcQg4bBSxI9X3cS">「ブックケース規定の作成」</link>
は、このドキュメントの作成方法について記述します。<link linkend="XcQg4bBSxI9X3cS">「ブックケース規定の例」</link>で例を示しています。
</para>
</listitem>
</itemizedlist>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<title id="jbQg4bBSxI9X3cS">ブック・ソース</title>
<indexterm><primary>ブック・ソース</primary></indexterm>
<indexterm><primary>必要なファイル</primary>
<secondary>ブック・ソース</secondary></indexterm>
<para>
ブックケースの各ブックには、少くともひとつの SGML に準拠したドキュメントが必要です。単一の SGML ドキュメントが完全なブックになることもあります。また、完全なブックを形成する数個のドキュメントのうちのひとつのみになることもあります。
</para>
<para>
SGML ブック・ソースには、ひとつであっても数個あっても、ブックのテキスト（内容）およびその SGML マークアップがあります。エンティティ参照の使用により、ドキュメント・ソースは、別のファイルや外部のシステム・ユニットにある外部テキストおよび非テキストのエンティティへの参照も作成します。
</para>
<para>
エンティティ参照によって、指定されたエンティティが、SGML ドキュメントの参照ポイントに埋め込まれます。
</para>
<para>
文書型定義 (DTD) は、SGML ドキュメント・ソースと関連付けられていなければなりません。文書型定義は、タイトル、段落、リスト、表、グラフィックなどのような要素の構造的な関係性を定義します。
</para>
<para>
ほとんどの場合、文書型定義は、SGML ドキュメントの外部にあり、通常は各 SGML 準拠ドキュメントの先頭にある DOCTYPE 宣言により、SGML ドキュメントから参照されます。以下の例 <link linkend="mhgjriBo9H9X3cS">「DOCTYPE 宣言」</link> を参照してください。
</para>
<para>
図 <link linkend="kADiOlB78H9X3cS">「SGML ドキュメント・ソース」</link> は、インフォメーション・マネージャのブックを作成するときに使用できるドキュメント（ハイパーテキスト目次と外部エンティティを含みます）間の関係を示しています。
</para>
<figure>
<title id="kADiOlB78H9X3cS">SGML ドキュメント・ソース</title>
<graphic id="gr55" entityref="infoapg.fig.2"></graphic>
</figure>
<para>
SGML 宣言は、SGML のパーサによって必要とされます。これは、具体的なドキュメントで有効な文字セットと SGML の区切記号を規定します。<filename>dtinfo.decl(5)</filename> は、インフォメーション・マネージャによって使用される SGML 宣言です。
<indexterm><primary>宣言</primary><secondary>SGML</secondary></indexterm>
<indexterm><primary>SGML 宣言</primary></indexterm>
</para>
<para>
インフォメーション・マネージャの宣言 <filename>dtinfo.decl(5)</filename> を、置き換えたり上書きしたりすることはできません。すなわち、インフォメーション・マネージャの SGML 宣言の OMITTAG は YES に設定されているため、文書型定義の要素宣言は、省略されたタグの最小化パラメータ（たとえば、<computeroutput>&ldquo;-o&rdquo; または &ldquo;--&rdquo;</computeroutput>）を含まなければなりません。詳細については、<citetitle pubwork="Book">International Standards Organization (ISO) 8879</citetitle> の <citetitle pubwork="Book">Element Declaration</citetitle> を参照してください。
</para>
<note>
<para>
インフォメーション・マネージャの SGML 宣言 <filename>dtinfo.decl</filename> は、インフォメーション・マネージャとともに提供され、<command>dtinfogen build</command>、<command>dtinfogen validate</command>、および <command>dtinfogen update</command> コマンドを起動したときには、自動的に参照されます。
</para>
</note>
<figure>
<title id="mhgjriBo9H9X3cS">DOCTYPE 宣言の例</title>
<programlisting>
&lt;!DOCTYPE Chapter PUBLIC
&ldquo;-//HaL and O'Reilly//DTD DocBook//EN&rdquo;
[
&lt;!ENTITY % ISOlist PUBLIC
&ldquo;-//Common Desktop Environment//ENTITIES ISO Catalog//EN&rdquo;>
%ISOlist;
%ISOlat1;
%ISOnum;
%ISOpub;
%ISOtech;
&lt;!ENTITY % halpubs SYSTEM &ldquo;hal.gml&rdquo; >
%halpubs;
]>
&lt;CHAPTER ID=&rdquo;CH-1015-3-1&rdquo; LABEL=&rdquo;3&rdquo;>&lt;TITLE>Working in the
X Environment&lt;/TITLE>
&lt;TITLEABBREV>Working in the X Environment&lt;/TITLEABBREV>
&lt;HIGHLIGHTS>
&lt;PARA>This chapter shows you how to begin working
productively in the X environment. It describes how to:
&lt;/PARA>
&hellip;
</programlisting>
</figure>
<note>
<para>
SGML 準拠ドキュメントの作成方法を記述した書籍の一覧については、
<link linkend="Q3yRgFBsz1698oL">「関連文書」</link>
を参照してください。
</para>
</note>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<title id="n3NGoZbBosJ9X3cS">目次</title>
<indexterm><primary>目次</primary></indexterm>
<para>
インフォメーション・マネージャのインフォメーション・ライブラリの一部として構築する各ブックには、ハイパーテキスト目次 (TOC) が必要です。ハイパーテキスト・リンクは、目次のセクション・タイトルを、それらのタイトルが参照する実際のオンラインのセクションに接続します。
<indexterm><primary>必要なファイル</primary>
<secondary>目次</secondary></indexterm>
</para>
<para>
インフォメーション・マネージャでは、目次は、ブックへのエントリ・ポイントとして表示されます。すなわち、デフォルトのブックへの線形パス（ユーザがあたかもブックのハードコピー版を読んでいるかのように参照できるパス）を確立します。ユーザが、目次中のセクション・タイトルを選択（その上でクリック）すると、ブラウザはリンクをたどって、ユーザのウィンドウにオンラインのセクションを表示します。
</para>
<para>
また、インフォメーション・マネージャにおいては、目次は、オンライン・ドキュメント内の案内の支援という重要な機能により、強力なハイパーテキストのナビゲーション・ツールでもあります。たとえば、目次によって提供される情報を利用して、インフォメーション・マネージャのグラフィカル・マップは、ブック内におけるセクションの相対的な位置を表示することができます。また、目次を利用してインフォメーション・マネージャのブック・リスト・ウィンドウの複雑なブック・リストは、ブックの構造に関する階層的な情報を提供します。
</para>
<para>
目次で必要なハイパーテキスト・リンクを設定するためには、インフォメーション・マネージャが、ユーザのドキュメント・ソース内のセクションを識別できなければなりません。これは、ユーザのブックの文書型定義へのインフォメーション・マネージャ設計様式の適用によって行われます。
</para>
<note>
<para>
ブックの目次を作成する前に、目次内でセクションとして参照されるべき文書型定義中の各要素を識別するために、インフォメーション・マネージャ設計様式を適用しなければなりません。これにより、インフォメーション・マネージャの目次ジェネレータが、セクションのタイトルとその一意のセクションIDの値を引き出すことが可能になります。
（<link linkend="S3CTVcBfQJ9X3cS">「目次の設計様式」</link>を参照してください。）
</para>
</note>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="n8aJ92dBIsI9X3cS">目次の作成</title>
<indexterm><primary>目次</primary>
<secondary>作成</secondary></indexterm>
<para>
各ブックのための目次を作成するには、<command>dtinfogen tocgen</command> コマンドを使用します。
</para>
<sect3>
<title id="Sb4E8eBmqJ9X3cS">dtinfogen tocgen の実行</title>
<para>ここでは、目次の生成のために <command>dtinfogen tocgen</command> を使用する例を示します。<command>dtinfogen&nbsp;tocgen</command> を実行する前に、ブックのソース・ファイルが次のようになっていることを確認してください。
</para>
<itemizedlist>
<listitem>
<para>
インフォメーション・マネージャ設計様式が適用される文書型定義を含むか、あるいは文書型定義への参照を取り込んでいること。
</para>
</listitem>
<listitem>
<para>
文書型定義に基づく有効な SGML マークアップを含むこと。
</para>
</listitem>
</itemizedlist>
<para>
この例の基本的な <command>dtinfogen tocgen</command> コマンド行を次に示します。
</para>
<programlisting>
dtinfogen tocgen -T <replaceable>/usr/pers</replaceable> -f <replaceable>TOC.file</replaceable> -id <replaceable>asg.toc</replaceable> -title <replaceable>&ldquo;Acoustic Sound Generators&rdquo;</replaceable> <replaceable>pref.sgm</replaceable> <replaceable>ch01.sgm</replaceable> <replaceable>ch02.sgm</replaceable> <replaceable>ch03.sgm</replaceable> <replaceable>appx.sgm</replaceable>
</programlisting>
<para>
各オプションの意味は以下のとおりです。
</para>
<variablelist>
<varlistentry>
<term><option>-T</option> <replaceable>/usr/pers</replaceable></term>
<listitem>
<para>
構築過程で、一時的ファイルが置かれるディレクトリを指定します。デフォルトは、環境変数 <systemitem class="environvar">TMPDIR</systemitem> が使用されます。変数 <systemitem class="environvar">TMPDIR</systemitem> が設定されていない場合は、<filename>/usr/tmp</filename> が使用されます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-f</option> <replaceable>TOC.file</replaceable></term>
<listitem>
<para>
<command>dtinfogen tocgen</command> プロセスの出力が行われるファイル名を指定します。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-id</option> <replaceable>asg.toc</replaceable></term>
<listitem>
<para>
新規に作成された目次ファイル内の目次識別子を指定します。<option>-id</option> の英数字の値（この場合 <replaceable>asg.toc</replaceable>）は、目次ファイルを目次が生成されたブック・ソース・ファイルの特定のセットと関連付けます。各ライブラリ内のブックケース間で一意の値を使用しなければなりません。
</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-title</option>
<replaceable>&ldquo;Acoustic Sound Generators&rdquo;</replaceable></term>
<listitem>
<para>
目次のタイトルを指定します。<option>-title</option> の値（この場合 <replaceable>&ldquo;Acoustic Sound Generators&rdquo;</replaceable>）が、新規に作成された目次ファイルのタイトルになります。
</para>
<para>
目次のタイトルは、それが関連するブッックの目次を識別します。インフォメーション・マネージャのウィンドウに表示されると、この名前が目次ノードのタイトルとして現われます。
</para>
<para>
名前の提供で <option>-title</option> フラグを使用しない場合、生成後に目次ファイルを開き、デフォルトの文字列 <computeroutput>$Title = &ldquo;Table of Contents&rdquo;</computeroutput> を適切なタイトルに置き換えることもできます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>pref.sgm</replaceable> <replaceable>ch01.sgm</replaceable>
<replaceable>ch02.sgm</replaceable> <replaceable>ch03.sgm</replaceable>
<replaceable>appx.sgm</replaceable></term>
<listitem>
<para>
目次のセクション・タイトルの一覧が生成されるドキュメント・エンティティの名前を指定します。
</para>
<para>
ドキュメント・エンティティは、その内容がオンライン・ブックに現われる順序で、コマンド行から入力されるべきです。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
<command>dtinfogen tocgen</command> プログラムは、インフォメーション・マネージャ設計様式が適用されたことを検証し、ドキュメント・エンティティをその文書型定義に対して検証します。
</para>
<para>
検証が正常に行われた後、<command>dtinfogen tocgen</command> は、ブック・ソース・ファイルと生成された目次ファイルから、セクションのタイトルとセクションの識別子を抽出します。
</para>
<para>
ブック・ソース・ファイルのセクションの追加や削除を行う場合には、目次を再生成しなければなりません。
</para>
</sect3>
</sect2>
</sect1>
<!--(((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<title id="j3fa6XBbiK9X3cS">スタイル・シートの使用</title>
<indexterm><primary>必要なファイル</primary>
<secondary>スタイル・シート</secondary></indexterm><indexterm>
<primary>スタイル・シート</primary><secondary>～の使用</secondary></indexterm>
<para>
スタイル・シートは、インフォメーション・マネージャにおけるブックのフォーマットされた表現形式を管理します。単一のスタイル・シートを使用して、インフォメーション・マネージャから印刷されたときのブックの印刷出力形式、およびインフォメーション・マネージャにおけるブックのオンライン表示形式の両方
を指定することができます。
</para>
<para>
また、単一のスタイル・シートを使用してブックケース内の複数のドキュメントのフォーマット方法を記述したり、複数のスタイル・シートを使用して同一のブックケース内の異なるドキュメント・タイプを処理することもできます。
</para>
<itemizedlist>
<listitem>
<para>図 <link linkend="JmNvZbBE6K9X3cS">「複数のスタイル・シートの使用方法」</link> は、ブック内のブックとセクションによる異なるスタイル・シートの使用方法を示しています。
</para>
</listitem>
<listitem>
<para>
<link linkend="n2PY0rbBgJJ9X3cS">「異なるレベルでのスタイル・シートの指定」</link> では、スタイル・シートが、ブックケースのレベル、ブックのレベル、およびセクションのレベルで、どのように指定されるかを説明しています。
</para>
</listitem>
<listitem>
<para><link linkend="bPY0rbBgJJ9X3cS">「複数のスタイル・シートを使用したブックケースの例」</link> は、３つのブックにフォーマット形式の情報を提供する４つのスタイル・シートを使用するブックケース規定の例を示しています。
</para>
</listitem>
</itemizedlist>
<para>
インフォメーション・データベースを一度構築すれば、<command>dtinfogen update</command>
<indexterm><primary>インフォメーション・マネージャ</primary><secondary>コマンド</secondary><tertiary>dtinfogen update</tertiary></indexterm>
コマンドを使用して、新規のスタイル・シート情報によるセクションの再フォーマットを行うことができます。
<link linkend="WmNvZbBE6K9X3cS">「構築されたブックケースのスタイル・シートの更新」</link>を参照してください。
</para>
<para>スタイル・シートの詳細については、
<link linkend="BtCmaaB0ang24aK">「スタイル・シートの作成」</link>を参照してください。
</para>
<figure>
<title id="JmNvZbBE6K9X3cS">複数のスタイル・シートの使用方法</title>
<graphic id="gr56" entityref="infoapg.fig.3"></graphic>
</figure>
<para>
図に示すように、デフォルトのスタイル・シート <replaceable>Style01</replaceable> は、別のスタイル・シートがブックのレベルまたはセクションのレベルで使用されない限り、ブックケース中のすべてのブックをフォーマットするために使用されます。デフォルトのスタイル・シートではないスタイル・シートが指定された場合、それが定義された特定のブックまたはセクションのフォーマットを行うときのみ有効となります。このとき、処理は、別のスタイル・シートが指定されない限り、デフォルトのスタイル・シートによって続行されます。
</para>
<!--))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="n5mNvZbBE6K9X3cS">スタイル・シートの定義</title>
<indexterm><primary>スタイル・シート</primary>
<secondary>定義</secondary></indexterm>
<para>
インフォメーション・マネージャのライブラリでは、各ブックケースのためのデフォルトのスタイル・シートを定義しなければなりません。（<link linkend="TcQg4bBSxI9X3cS">「ブックケース規定の作成」</link>を参照してください。）
</para>
<sect3>
<title id="n2PY0rbBgJJ9X3cS">異なるレベルでのスタイル・シートの指定</title>
<para>
各スタイル・シートは、スタイル・シートのドキュメント自身の先頭で指定する一意の名前をもたなければなりません。ブックケースで使用されるすべてのスタイル・シートは、ブックケース規定の先頭にあるエンティティ宣言を使用して定義することができます。次に示すのは、スタイル・シートのセットのためのエンティティ宣言の例です。
</para>
<programlisting>
[
&lt;!-- Style sheets -->
&lt;!ENTITY Style01 SYSTEM &ldquo;InfoMgrRN/style01.sty&rdquo; >
&lt;!ENTITY Style02 SYSTEM &ldquo;Perl/perl.sty&rdquo; >
&lt;!ENTITY PrefSty SYSTEM &ldquo;Preface/pref.sty&rdquo; >
&lt;!ENTITY IDXSty SYSTEM &ldquo;Index/IDX.sty&rdquo; >
...............
...............
...............
]
</programlisting>
<para>
宣言されたスタイル・シートは、エンティティ参照を使用して、ブックケース規定の内部から参照されます。
<link linkend="bPY0rbBgJJ9X3cS">「複数のスタイル・シートを使用したブックケースの例」</link>では、すべてのエンティティ宣言とスタイル・シートのエンティティ参照とともに完全なブックケース規定を示しています。
</para>
<sect4>
<title id="SmNvZbBE6K9X3cS">ブックケースのレベルでのスタイル・シートの指定</title>
<indexterm><primary>スタイル・シート</primary>
<secondary>ブックケースのレベル</secondary></indexterm>
<para>
デフォルトのスタイル・シートは、ブックケースのレベルで指定されます。エンティティ参照は、そのブックケースのために定義された他のすべてのスタイル・シートに対して行われます。
</para>
<para>
BOOKCASE 要素の開始タグは、ブックケースの内容の一覧表記を開始します。これには、使用されるスタイル・シートと処理される SGML ドキュメントが含まれます。
</para>
<para>
ブックケースの最初のステートメント <computeroutput>&lt;BOOKCASE StyleSheet=style01></computeroutput> は <replaceable>style01</replaceable> をデフォルトのスタイル・シートとして命名します。BOOKCASENAME および BOOKCASEDESC 要素が指定された後、エンティティ参照が、ブックケースの内容をフォーマットするときに使用されるすべてのスタイル・シートのエンティティに対して作成されます。次に例を示します。
</para>
<programlisting>
&lt;BOOKCASE StyleSheet=Style01>
&lt;BOOKCASENAME>INFOMGR&lt;/>
&lt;BOOKCASEDESC>Info Manager Release Notes&lt;/>
&lt;!-- Include the style sheets. -->
&amp;Style01;
&amp;Style02;
&amp;PrefSty;
&amp;IDXSty;
</programlisting>
<para>
各エンティティ参照のアンパサンドとセミコロン、
<computeroutput>&amp;Style01;</computeroutput>、
<computeroutput>&amp;Style02;</computeroutput>、
<computeroutput>&amp;PrefSty;</computeroutput>、および
<computeroutput>&amp;IDXSty;</computeroutput> は、エンティティ参照の開始・終了区切記号です。
</para>
</sect4>
<sect4>
<title id="TmNvZbBE6K9X3cS">ブックのレベルでのスタイル・シートの指定</title>
<indexterm><primary>スタイル・シート</primary>
<secondary>ブックのレベル</secondary></indexterm>
<para>
BOOKCASE 要素で指定されるデフォルトのスタイル・シートは、別のスタイル・シートがブックのレベルまたはセクションのレベルで指定されない限り、ブックケースの各ブックのために使用されます。
</para>
<para>
BOOK 要素の開始タグは、ブックの内容の一覧表記を開始し、（デフォルトのスタイル・シートではない場合に）使用されるスタイル・シートを参照します。次に例を示します。
</para>
<programlisting>
&lt;/BOOK>
&lt;!-- Perl Manual -->
&lt;BOOK StyleSheet=Style02>
</programlisting>
<para>
このステートメントは、<computeroutput>Style02</computeroutput> が <citetitle>Perl Manual</citetitle> SGML ソースをフォーマットするために使用されることを示しています。
</para>
<para>
ブックのソース・ファイルが処理された後、次の BOOK 要素の開始タグは、別のスタイル・シートが指定されない限り、最初の BOOKCASE 要素の開始タグで指定されたデフォルトのスタイル・シートの値に、スタイル・シートを再設定します。
</para>
</sect4>
<sect4>
<title id="VmNvZbBE6K9X3cS">セクションのレベルでのスタイル・シートの指定</title>
<indexterm><primary>スタイル・シート</primary>
<secondary>セクションのレベル</secondary></indexterm>
<para>
セクション・レベルのスタイル・シートは、ブックケース・ファイルのブック要素の一覧表記内では指定されません。代わりに、インフォメーション・マネージャ設計様式を使用して、ブックの文書型定義 (DTD) において指定されます。インフォメーション・マネージャ設計様式は、指定されたスタイル・シートのフォーマット形式が適用されるブックの特定のセクション・レベルの要素を識別します。
</para>
<para>
関連情報については、以下を参照してください。
</para>
<itemizedlist>
<listitem>
<para>
<link linkend="BtCmaaB0ang24aK">「スタイル・シートの作成」</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="vSMTMZBRyng24aK">「設計様式の理解」</link>
</para>
</listitem>
</itemizedlist>
</sect4>
</sect3>
</sect2>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="bPY0rbBgJJ9X3cS">複数のスタイル・シートを使用したブックケースの例</title>
<para>
次に示すのは、３つのブックを定義し、４つのスタイル・シートを使用するブックケース規定の例です。このスタイル・シートのエンティティ、
<computeroutput>&amp;PrefSty;</computeroutput> および
<computeroutput>&amp;IDXSty;</computeroutput> は、ブックの文書型定義で参照されます。
</para>
<programlisting>
&lt;!DOCTYPE Bookcase PUBLIC
&ldquo;-//Common Desktop Environment//DTD DtInfo Bookcase Description//EN&rdquo;
[
&lt;!-- Style sheets -->
&lt;!ENTITY style01 SYSTEM &ldquo;InfoMgrRN/style01.sty&rdquo; >
&lt;!ENTITY style02 SYSTEM &ldquo;Perl/perl.sty&rdquo; >
&lt;!ENTITY PrefSty SYSTEM &ldquo;Preface/pref.sty&rdquo; >
&lt;!ENTITY IDXSty SYSTEM &ldquo;Index/IDX.sty&rdquo; >
&lt;!ENTITY TOCSTY SYSTEM &ldquo;TOC/TOC.sty&rdquo; >
&lt;!-- Book documents declared as SUBDOC -->
&lt;!ENTITY tocfile SYSTEM &ldquo;Small/small.toc&rdquo; SUBDOC >
&lt;!ENTITY ch03 SYSTEM &ldquo;Small/ch03.sgm&rdquo; SUBDOC >
&lt;!ENTITY xlsc SYSTEM &ldquo;Small/xlsc.sgm&rdquo; SUBDOC >
&lt;!ENTITY rnotes.TOC SYSTEM &ldquo;InfoMgrRN/rnotes.TOC&rdquo; SUBDOC >
&lt;!ENTITY rnotes.N SYSTEM &ldquo;InfoMgrRN/rnotes.N&rdquo; SUBDOC >
&lt;!ENTITY perl.TOC SYSTEM &ldquo;Perl/perl.TOC&rdquo; SUBDOC >
&lt;!ENTITY copytrade.N SYSTEM &ldquo;Perl/copytrade.N&rdquo; SUBDOC >
&lt;!ENTITY about.N SYSTEM &ldquo;Perl/02about.N&rdquo; SUBDOC >
&lt;!ENTITY intro.N SYSTEM &ldquo;Perl/1intro.N&rdquo; SUBDOC >
&lt;!ENTITY start.N SYSTEM &ldquo;Perl/2start.N&rdquo; SUBDOC >
&lt;!ENTITY datatypes.N SYSTEM &ldquo;Perl/3datatypes.N&rdquo; SUBDOC >
&lt;!ENTITY form.N SYSTEM &ldquo;Perl/4form.N&rdquo; SUBDOC >
&lt;!ENTITY commands.N SYSTEM &ldquo;Perl/5commands.N&rdquo; SUBDOC >
&lt;!ENTITY perl.NDX SYSTEM &ldquo;Perl/perl.NDX&rdquo; SUBDOC >
&lt;!ENTITY comments.N SYSTEM &ldquo;Perl/comments.N&rdquo; SUBDOC >
]>
&lt;BOOKCASE StyleSheet=style01>
&lt;BOOKCASENAME>Information Manager&lt;/>
&lt;BOOKCASEDESC>Information Manager Release Notes&lt;/>
&lt;!-- Include the four style sheets. -->
&amp;style01;
&amp;style02;
&amp;PrefSty;
&amp;IDXSty;
&lt;!-- *****BOOK 1 - Small example book***** -->
&lt;BOOK>
&lt;TITLE>DocBook DTD Examples&lt;/>
&lt;SHORTTITLE>SGML Examples&lt;/>
&lt;TAB TabLoc=&rdquo;RE-1015-XLSCLIENTS-1&rdquo;>Manpage&lt;/>
&lt;TOCFILE>&amp;tocfile;&lt;/TOCFILE>
&lt;FILE>&amp;ch03;&lt;/FILE>
&lt;FILE>&amp;xlsc;&lt;/FILE>
&lt;/BOOK>
&lt;!-- *****BOOK 2 - Information Manager Release Notes***** -->
&lt;BOOK>
&lt;TITLE>Information Manager Release Notes&lt;/>
&lt;SHORTTITLE>Info Manager Notes&lt;/>
&lt;TAB TabLoc=&rdquo;7M6zf5B0CM9X3cS&rdquo;>Contents&lt;/>
&lt;TAB TabLoc=&rdquo;wP3zf5B-BM9X3cS&rdquo;>Features&lt;/>
&lt;TAB TabLoc=&rdquo;yP3zf5B-BM9X3cS&rdquo;>To Do&lt;/>
&lt;TAB TabLoc=&rdquo;mJ6G0CB1LG9I8gW&rdquo;>Link Demos&lt;/>
&lt;TAB TabLoc=&rdquo;0K6zf5B-BM9X3cS&rdquo;>Figures&lt;/>
&lt;TOCFILE>&amp;rnotes.TOC;&lt;/>
&lt;FILE>&amp;rnotes.N;&lt;/>
&lt;/BOOK>
&lt;!-- *****BOOK 3 - Perl Manual***** -->
&lt;BOOK StyleSheet=style02>
&lt;TITLE>Perl Manual&lt;/>
&lt;TAB TabLoc=&rdquo;Xmhyf5Bu6M9X3cS&rdquo;>Contents&lt;/>
&lt;TAB TabLoc=&rdquo;3tpQGzASEYy94aK&rdquo;>About This Book&lt;/>
&lt;TAB TabLoc=&rdquo;Oo9fP6B59WwA0YK&rdquo;>Index&lt;/>
&lt;TAB TabLoc=&rdquo;DNph.0BBMXwA0YK&rdquo;>Comments&lt;/>
&lt;TOCFILE>&amp;perl.TOC;&lt;/>
&lt;FILE>&amp;copytrade.N;&lt;/>
&lt;FILE>&amp;about.N;&lt;/>
&lt;FILE>&amp;intro.N;&lt;/>
&lt;FILE>&amp;start.N;&lt;/>
&lt;FILE>&amp;datatypes.N;&lt;/>
&lt;FILE>&amp;form.N;&lt;/>
&lt;FILE>&amp;commands.N;&lt;/>
&lt;FILE>&amp;perl.NDX;&lt;/>
&lt;FILE>&amp;comments.N;&lt;/>
&lt;/BOOK>
&lt;/BOOKCASE></programlisting>
<note>
<para>この例のブックケース規定は、インフォメーション・マネージャとともに提供される <filename>dtinfoBook.dtd</filename> に準拠しています。
</para>
</note>
</sect2>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<title id="r58-aZBwFK9X3cS">ブックケース規定</title>
<indexterm><primary>ブックケース規定</primary></indexterm>
<indexterm><primary>必要なファイル</primary>
<secondary>ブックケース規定</secondary></indexterm>
<para>
ブックケースを構築してインフォメーション・ライブラリにするには、ブックケース規定を使用して、インフォメーション・マネージャのツールに何を構築するかを伝えます。
</para>
<para>
もっとも単純な形式のブックケース規定には、ブックケース名とブックケース記述、各ブックのフォーマットを記述するスタイル・シート、およびブックに準拠する SGML ドキュメントのための SUBDOC エンティティ参照があります。
</para>
<para>
ブックケース規定にブックのドキュメントを取り込むには、SGML SUBDOC エンティティ宣言
<indexterm><primary>SGML</primary>
<secondary>SUBDOC エンティティ宣言</secondary></indexterm>
を使用しなければなりません。
ブックケース規定の構造は、<filename>dtinfoBook.dtd</filename> で定義されています。
</para>
<para>
ブックケース規定を作成する一般的な手続きは、<link linkend="TcQg4bBSxI9X3cS">「ブックケース規定の作成」</link>で説明しています。
</para>
<para>
ブックケース規定で明記しなければならない情報には、次のものがあります。
</para>
<variablelist>
<varlistentry>
<term>ブックケース名</term>
<listitem>
<para>
この名前は、インフォメーション・マネージャおよび内部検索エンジンによって使用されます。これは、英数字で８文字以内かつブックケース内で一意でなければなりません。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ブックケース記述</term>
<listitem>
<para>
これは、ブックケースに準拠するブックの説明または形式です。
<citetitle>UNIX Administration Guides</citetitle> や
<citetitle>Scientific Papers on Acoustic Sound Generation</citetitle>
は典型的な例です。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ひとつまたは複数のスタイル・シート</term>
<listitem>
<para>
スタイル・シートには、SGML ドキュメントがオンラインと印刷の両方の形式でどのようにフォーマットされるかを定義するフォーマット指示の集まりがあります。ブックケース規定のすべてのブックのためのデフォルトのスタイル・シートとして、ひとつのスタイル・シートを指定しなければなりません。
</para>
<para>
ブックケース規定でスタイル・シートを取り込んだり、ブックケース規定の先頭のエンティティ宣言によってそれらを参照することができます。
<link linkend="XcQg4bBSxI9X3cS">「ブックケース規定の例」</link>を参照してください。
</para>
<para>
単一のブックケース規定において、インフォメーション・マネージャが複数のスタイル・シートをどのように処理するかを理解するには、
<link linkend="j3fa6XBbiK9X3cS">「スタイル・シートの使用」</link>
を参照してください。
</para>
<para>
スタイル・シートの作成の詳細については、
<link linkend="BtCmaaB0ang24aK">「スタイル・シートの作成」</link>
を参照してください。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ひとつまたは複数のブック</term>
<listitem>
<para>
ブックケースの各ブックで指定する必要がある情報には、以下のものがあります。
</para>
<variablelist>
<varlistentry>
<term>ブック・タイトル</term>
<listitem>
<para>
ブックケースの各ブックの正式なタイトルです。ブック・タイトルの長さは、技術的に無制限です。しかしながら、タイトルは長さで50文字以内にすべきです。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ブック・タイトルの省略形</term>
<listitem>
<para>
オプションで指定する各ブック・タイトルの省略形です。
タイトルの省略形は、インフォメーション・マネージャの検索エンジンによって使用されます。技術的には、タイトルの省略形の長さは無制限ですが、20文字を超えないようにすべきです。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>タブ情報</term>
<listitem>
<para>
タブは、インフォメーション・マネージャのウィンドウに表示されます。これは、バインダのタブの模擬であり、ユーザがオンライン・ブックの別のセクションにすばやく移動することを可能にします。
</para>
<para>
ブックケース規定で指定するタブ情報には、ブラウザ・インタフェースで使用可能なブック内の名前とセクションの識別子があります。
</para>
<para>
タブはオプションであり、ひとつまたは複数のタブをブックケースの各ブックに指定することが可能です。各タブのテキストの長さおよび与えられたブックのタブ数は、技術的に無制限です。しかしながら、<literal>内容</literal>、<literal>はじめに</literal>、<literal>索引</literal>などのように、相対的に短いタブ名を使用し、表示するタブ数を制限することによって、オンライン上での読みやすさは向上します。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>目次 (TOC)</term>
<listitem>
<para>
ブックケース規定において定義される各ブックは、インフォメーション・マネージャの <filename>dtinfoTOC.dtd</filename> に準拠するハイパーテキスト目次がなければなりません。
</para>
<para>
<command>dtinfogen tocgen</command> コマンドを使用して、インフォメーション・マネージャの目次を作成することができます。
<link linkend="n8aJ92dBIsI9X3cS">「目次の作成」</link>を参照してください。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ブック・ソース・ドキュメント</term>
<listitem>
<para>
次に示すのは、各ブックを形成する SGML 準拠ドキュメントのエンティティです。
</para>
<para>
これらのドキュメントは、別の文書型定義に合致する可能性があるため、構築過程においてソース情報を引き出すために、SGML SUBDOC エンティティを使用しなければなりません。
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
<para>
図 <link linkend="xJDiOlB78H9X3cS">「ブックケース規定」</link> は、ブックケース規定とインフォメーション・ライブラリを構築するときに使用される他のドキュメントとの関係を示しています。
</para>
<figure>
<title id="xJDiOlB78H9X3cS">ブックケース規定</title>
<graphic id="gr57" entityref="infoapg.fig.4"></graphic>
</figure>
<sect2>
<title id="TcQg4bBSxI9X3cS">ブックケース規定の作成</title>
<indexterm><primary>ブックケース規定</primary>
<secondary>作成</secondary></indexterm>
<para>
ブックケース規定を作成するには、次のようにします。
</para>
<orderedlist>
<listitem>
<para>
<command>vi</command>、<command>emacs</command> のようなエディタや適切に構成された SGML エディタを使用して、ブック構築領域内で新規のファイルを開きます。必要ならば、以下に示す <link linkend="XcQg4bBSxI9X3cS">「ブックケースの例」</link> やこのマニュアルに含まれるブックケース規定の例をコピーし、目的にしたがって修正することもできます。
</para>
</listitem>
<listitem>
<para>
ファイルの先頭で、ブックケースの文書型定義を指定します。次に例を示します。
</para>
<programlisting>
&lt;!DOCTYPE Bookcase PUBLIC
&ldquo;-//Common Desktop Environment//DTD DtInfo Bookcase Description//EN&rdquo;
[
</programlisting>
<para>
DOCTYPE 宣言の末尾にあるオープン・ブレイス（[）は、エンティティ宣言のセットが続くことを指示しています。
<filename>dtinfoBook.dtd(5)</filename> マニュアル・ページを参照してください。
</para>
</listitem>
<listitem>
<para>
エンティティ宣言を使用して、使用するスタイル・シートを指定します。
エンティティ宣言を使用して、複数のスタイル・シートを定義することもできます。
</para>
<programlisting>
&lt;!-- Style sheets -->
&lt;!ENTITY style01 SYSTEM &ldquo;style01.sty&rdquo; >
</programlisting>
</listitem>
<listitem>
<para>
SGML SUBDOC エンティティを使用して、ブックに合致したドキュメントを指定します。これには、目次も含まれます。
</para>
<programlisting>
&lt;!-- Book files declared as SUBDOC -->
&lt;!ENTITY tocfile SYSTEM &ldquo;small.toc&rdquo; SUBDOC >
&lt;!ENTITY ch03 SYSTEM &ldquo;ch03.sgm&rdquo; SUBDOC >
&lt;!ENTITY xlsc SYSTEM &ldquo;xlsc.sgm&rdquo; SUBDOC >
</programlisting>
</listitem>
<listitem>
<para>
使用するすべてのエンティティを指定した後、クローズ・ブレイス（]）とクローズ宣言区切記号（>）でエンティティ宣言を閉じます。
</para>
<programlisting>]></programlisting>
</listitem>
<listitem>
<para>
SGML 開始タグ &lt;BOOKCASE> を入力し、ブックケースで使用するデフォルトのスタイル・シートを指定します。
</para>
<programlisting>
&lt;BOOKCASE StyleSheet=sty1>
</programlisting>
<para>
この例では、BOOKCASE 要素の属性 <replaceable>StyleSheet</replaceable> には、値 <systemitem>sty1</systemitem> が指定されています。これは、スタイル・シート・ファイル <filename>style01.sty</filename> 内の STYLESHEET 要素の名前です。
</para>
<para>
エンティティのサブセット宣言において、複数のスタイル・シートが宣言されている場合、ブックケースのデフォルトのスタイル・シートとして、それらのうちのひとつを指定することができます。
</para>
</listitem>
<listitem>
<para>
BOOKCASENAME 要素と BOOKCASEDESC 要素、およびその内容を入力します。この場合は、それぞれ、<replaceable>SMALL</replaceable> と <replaceable>Demonstration small bookcase</replaceable> です。
</para>
<para>
BOOKCASENAME は、英数字８文字を超えることはできません。また、ピリオドを含むことはできません。
</para>
<para>
次に、エンティティ参照を使用して、取り込まれるべきスタイル・シートを指定します。この場合は、<computeroutput>style01</computeroutput> です。
</para>
<programlisting>
&lt;BOOKCASENAME>SMALL&lt;/>
&lt;BOOKCASEDESC>Demonstration small bookcase&lt;/>
&amp;style01;
</programlisting>
<para>
ブックケースのすべてのスタイル・シートを参照した後、ブックケースを形成するブックの指定を開始します。
</para>
<note>
<para>
識別子の参照を使用して、異なるブックケースやブックケース内の異なるブックに、別々のスタイル・シートを割り当てることができます。
<link linkend="j3fa6XBbiK9X3cS">「スタイル・シートの使用」</link>を参照してください。
スタイル・シートの作成の詳細については、<link linkend="BtCmaaB0ang24aK">「スタイル・シートの作成」</link>を参照してください。
</para>
</note>
</listitem>
<listitem>
<para>
BOOK 要素の開始タグ、TITLE 要素とSHORTTITLE 要素、およびその内容を入力して、構築するブックを指定します。
</para>
<programlisting>
&lt;BOOK>
&lt;TITLE>DocBook DTD Examples&lt;/>
&lt;SHORTTITLE>SGML Examples&lt;/>
</programlisting>
</listitem>
<listitem>
<para>
ブックにバインダ・タブを設定している場合は、情報を記述します。
</para>
<para>
各タブについて、TAB 要素の開始タグ（TabLoc 属性とその値を必要とします）、タブがブラウザに表示されたときに現われるテキスト（この場合は、&ldquo;Manpage&rdquo;）を指定しなければなりません。
</para>
<programlisting>
&lt;TAB TabLoc=&ldquo;RE-1015-XLSCLIENTS-1&rdquo;>Manpage&lt;/>
</programlisting>
</listitem>
<listitem>
<para>
ブックケース規定の先頭の SUBDOC エンティティ宣言によって参照される目次ドキュメントを含めるために、&lt;TOCFILE> タグを使用します。
</para>
<programlisting>
&lt;TOCFILE>&amp;tocfile;&lt;/TOCFILE>
</programlisting>
</listitem>
<listitem>
<para>
ブックケース規定の先頭の SUBDOC エンティティ宣言によって参照されるブック・ドキュメントを含めるために、&lt;FILE> タグを使用します。
</para>
<programlisting>
&lt;FILE>&amp;ch03;&lt;/FILE>
&lt;FILE>&amp;xlsc;&lt;/FILE>
</programlisting>
<para>
また、&lt;FILE> タグの単一のセットで、複数のブック・ドキュメントの一覧を記述することもできます。次に例を示します。
</para>
<programlisting>
&lt;FILE>&amp;ch03; &amp;xlsc;&lt;/FILE>
</programlisting>
</listitem>
<listitem>
<para>
このブックのためのすべてドキュメントを参照した後、&lt;/BOOK> 終了タグを使用して、このブックを閉じます。
</para>
<programlisting>
&lt;/BOOK>
</programlisting>
<para>
ブックケースに含まれる各ブックについて、手順８から手順11を繰り返します。
</para>
</listitem>
<listitem>
<para>
すべてのブックを指定した後、&lt;/BOOKCASE> 終了タグを使用して、ブックケース規定を閉じます。
</para>
<programlisting>
&lt;/BOOKCASE>
</programlisting>
</listitem>
</orderedlist>
<para>
完全なブックケースの例を
<link linkend="XcQg4bBSxI9X3cS">「ブックケース規定の例」</link>に示します。
</para>
<!--)))))))))))))))))))))))))))))))))))))-->
<sect3>
<title id="XcQg4bBSxI9X3cS">ブックケース規定の例</title>
<indexterm><primary>ブックケース規定</primary>
<secondary>例</secondary></indexterm>
<para>
次に示すのは、小さなブックケース規定の例です。これは、単一のブックを含むひとつのブックケースを定義し、単一のスタイル・シートを使用しています。
</para>
<para>
以下の例におけるスタイル・シートは、エンティティ参照によって参照されますが、スタイル・シート <computeroutput>STYLE01</computeroutput> の完全なテキストは、ブックケース規定に含まれます。
</para>
<programlisting>
&lt;!DOCTYPE Bookcase PUBLIC
&ldquo;-//Common Desktop Environment//DTD DtInfo Bookcase Description//EN&rdquo;
[
&lt;!-- Style sheets -->
&lt;!ENTITY style01 SYSTEM &ldquo;style01.sty&rdquo; >
&lt;!-- Book files declared as SUBDOC -->
&lt;!ENTITY tocfile SYSTEM &ldquo;small.toc&rdquo; SUBDOC >
&lt;!ENTITY ch03 SYSTEM &ldquo;ch03.sgm&rdquo; SUBDOC >
&lt;!ENTITY xlsc SYSTEM &ldquo;xlsc.sgm&rdquo; SUBDOC >
]>
&lt;BOOKCASE StyleSheet=sty1>
&lt;BOOKCASENAME>SMALL&lt;/>
&lt;BOOKCASEDESC>Demonstration small bookcase&lt;/>
&amp;style01;
&lt;BOOK>
&lt;TITLE>DocBook DTD Examples&lt;/>
&lt;SHORTTITLE>SGML Examples&lt;/>
&lt;!-- Tab information -->
&lt;TAB TabLoc=&rdquo;RE-1015-XLSCLIENTS-1&rdquo;>Manpage&lt;/>
&lt;TOCFILE>&amp;tocfile;&lt;/TOCFILE>
&lt;FILE>&amp;ch03;&lt;/FILE>
&lt;FILE>&amp;xlsc;&lt;/FILE>
&lt;/BOOK>
&lt;/BOOKCASE>
</programlisting>
<note>
<para>
このブックケース規定の例は、インフォメーション・マネージャとともに提供される <filename>dtinfoBook.dtd</filename> に準拠しています。
</para>
</note>
</sect3>
</sect2>
</sect1>
</chapter>

600
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch04.sgm Normal file
View File

@@ -0,0 +1,600 @@
<!-- $XConsortium: ch04.sgm /main/4 1996/10/11 09:23:48 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<chapter id="infoapg.div.4">
<title id="fi1SgFBr-1698oL">インフォメーション・ライブラリの構築</title>
<indexterm><primary>インフォメーション・ライブラリ</primary>
<secondary>構築</secondary></indexterm>
<para>
この章では、SGML ドキュメントを検証してインフォメーション・マネージャでブラウズ可能なライブラリを構築するための <command>dtinfogen</command> サブコマンドの使用方法、およびブックケースのスタイル・シート情報を更新する方法について説明します。
</para>
<para>
<command>dtinfogen validate</command> コマンドを使用して、SGML ブック・ドキュメントおよびブックケース規定を検証します。検証は、構築のための準備期間に有用です。
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary>
<tertiary>dtinfogen validate</tertiary></indexterm>
</para>
<para>
<command>dtinfogen build</command> コマンドを使用して、SGML の検証実行はもとより、新規インフォメーション・ライブラリの構築、既存インフォメーション・ライブラリへのブックケース追加、および既存ライブラリの更新を行います。
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary>
<tertiary>dtinfogen build</tertiary></indexterm>
</para>
<para>
インフォメーション・ライブラリを一度構築すれば、<command>dtinfogen update</command> コマンドを使用して、ライブラリに関連するスタイル・シート情報を更新することができます。これらの手続きは、次で説明しています。
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary>
<tertiary>dtinfogen update</tertiary></indexterm>
</para>
<itemizedlist>
<listitem>
<para>
<link linkend="KyEB2dBpuI9X3cS">「SGML ドキュメントの検証」</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="ki1SgFBr-1698oL">「ライブラリのブックケースの構築、追加、および置換」</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="WmNvZbBE6K9X3cS">「構築されたブックケースのスタイル・シートの更新」</link>
</para>
</listitem>
</itemizedlist>
<para>
コマンドの構文およびこれらのコマンドの例については、<command>dtinfogen(1)</command> マニュアル・ページを参照してください。
</para>
<sect1>
<title id="WxGm7JBlsoBt8oL">新規ライブラリ構築の前に</title>
<indexterm><primary>インフォメーション・ライブラリ</primary>
<secondary>構築</secondary><tertiary>前提条件</tertiary></indexterm>
<para>
インフォメーション・マネージャの新規インフォメーション・ライブラリを構築する前に、次に示すことを行う必要があります。
</para>
<itemizedlist>
<listitem>
<para>
外部エンティティ参照をユーザのシステム・ファイルにマップするときに使用されるメソッドを指定します。次のうちのいずれかで行うことができます。
</para>
<itemizedlist>
<listitem>
<para>
外部エンティティ参照の適切な環境変数を設定します。
</para>
</listitem>
<listitem>
<para>
<command>dtinfogen build</command> コマンドの <option>-m</option> オプションを使用して、適切なカタログ・ファイルを指定します。
</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
必要な SGML 準拠ドキュメントがすべて揃っているか確認します。これには、ブックケースの各ブックのための文書型定義、ハイパーテキスト目次、およびスタイル・シートが含まれます。<link linkend="ByGm7JBlsoBt8oL">「dtinfogen validate の実行」</link> で説明しているように、<command>dtinfogen validate</command> コマンドを使用して、SGML ドキュメントを検証することができます。
</para>
</listitem>
<listitem>
<para>
<link linkend="ki1SgFBr-1698oL">「ライブラリのブックケースの構築、追加、およぴ更新」</link> で説明しているように、<command>dtinfogen build</command> のオプションを理解します。
</para>
</listitem>
</itemizedlist>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<title id="n9yEB2dBpuI9X3cS">環境変数の設定</title>
<indexterm><primary>環境変数</primary></indexterm>
<para>
ユーザが、<citetitle>SGML Open Technical Resolution 9401:1994</citetitle> の外部エンティティ参照に関する推奨を使用しているかどうかに依存して、以下の環境変数のひとつまたは両方を設定するか、<command>dtinfogen</command> コマンドの <option>-m</option> オプションを使用する必要があります。
</para>
<variablelist>
<varlistentry>
<term><systemitem class="environvar">SGML_CATALOG_FILES</systemitem></term>
<listitem>
<para>
<citetitle>SGML Open Technical Resolution 9401:1994</citetitle> の外部エンティティ管理に関連する推奨にしたがっている場合は、この環境変数を設定してください。この環境変数の値は、SGML エンティティ宣言の一覧表記とファイル・マッピング識別子がある <filename>catalog</filename> または <filename>CATALOG</filename>（大文字、小文字どちらでも使用することができます）の位置を指定します。
</para>
<para>
環境変数を設定しない場合は、適切な <command>dtinfogen</command> コマンドの <option>-m</option> オプションを使用して、パブリックな識別子とエンティティ名をシステム・ファイルにマップすることができます。
詳細については、<filename>catalog(5)</filename> マニュアル・ページを参照してください。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><systemitem class="environvar">SGML_PATH</systemitem></term>
<listitem>
<para>
外部エンティティ参照をシステム・ファイルにマップするときに、この環境変数を設定します。
</para>
<para>詳細については、<command>dtinfogen(5)</command> マニュアル・ページを参照してください。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>関連情報については、以下に示す文献を参照してください。
</para>
<itemizedlist>
<listitem>
<para>
<citetitle>SGML Open Technical Resolution 9401:1994</citetitle>
</para>
</listitem>
</itemizedlist>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<title id="KyEB2dBpuI9X3cS">SGML ドキュメントの検証</title>
<indexterm><primary>SGML ドキュメント</primary>
<secondary>検証</secondary></indexterm>
<para>
インフォメーション・ライブラリを構築する前に、適切な文書型定義にしたがっているか確認するために、SGML ドキュメントを検証しなければなりません。 </para>
<para>
<command>dtinfogen validate</command>
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary>
<tertiary>dtinfogen validate</tertiary></indexterm>
コマンドを使用して、ブックケース規定、個別のドキュメント、および他の SGML 準拠ドキュメントの SGML 検証を行うことができます。検証過程において、<command>dtinfogen validate</command> は、次に示すことを実行します。
</para>
<itemizedlist>
<listitem>
<para>
SGML にしたがっていることを検証するために、入力ドキュメントの文書型定義をチェックします。
</para>
</listitem>
<listitem>
<para>
入力ドキュメントの SGML マークアップが、ドキュメントの文書型定義で定義されているマークアップ言語と整合性があることを検証します。
</para>
</listitem>
</itemizedlist>
<para>
無効なドキュメントを検出した場合には、<command>dtinfogen validate</command> プログラムによってエラー・メーセージが出力されます。インフォメーション・ライブラリを構築するときに使用されるファイルのエラーは、データが構築される前に、すべて修正されなければなりません。
</para>
<sect2>
<title id="ByGm7JBlsoBt8oL">dtinfogen validate の実行</title>
<indexterm><primary>インフォメーション・ライブラリ</primary>
<secondary>ドキュメントの検証</secondary></indexterm>
<para>
次に示す例の基本的なコマンド行（これは、単一ブックケースのインフォメーション・ライブラリの検証を実行します）は、以下のとおりです。
</para>
<programlisting>
<userinput>dtinfogen validate ch03.sgm ch04.sgm ch05.sgm</userinput>
</programlisting>
<para>以下に、引き数の説明を示します。</para>
<para>
<filename>ch03.sgm ch04.sgm ch05.sgm</filename>
</para>
<para>
検証すべき SGML ドキュメントを指定します。<command>dtinfogen validate</command> コマンドは、いかなる有効な SGML 準拠ドキュメントに対しても実行することができます。
</para>
<para>
ドキュメントが無効な場合は、エラー・メッセージが返されます。例のファイル <filename>ch05.sgm</filename> に対して返されたエラーの型の例を、次に示します。これには、不足あるいは無効のエンティティ宣言があります。
</para>
<programlisting>
%: <userinput>dtinfogen validate</userinput>
nsgmls:ch05.sgm:12:1:E: cannot open "hal.gml" (No such file or directory)
nsgmls:ch05.sgm:20:1:E: general entity "tab" not defined and no default entity
..............................
..............................
..............................
dtinfogen: command failed: nsgmls -sg /usr/dt/infolib/C/SGML/dtinfo.decl ch05.sgm
ch05.sgm
</programlisting>
</sect2>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<title id="ki1SgFBr-1698oL">ライブラリのブックケースの構築、追加、および置換</title>
<indexterm><primary>インフォメーション・ライブラリ</primary>
<secondary>構築</secondary>
<tertiary>dtinfogen build</tertiary>
</indexterm>
<para>
本節では、ブックケースの新規インフォメーション・ライブラリへの構築、既存のインフォメーション・ライブラリへのブックケースの追加、および既存のライブラリのインフォメーション・データベースの更新を行うための <command>dtinfogen build</command> コマンドの使用方法について説明します。
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary><tertiary>dtinfogen build</tertiary>
</indexterm>
</para>
<sect2>
<title id="jI.RgFBe.1698oL">構築にあたって考慮すること</title>
<indexterm><primary>インフォメーション・ライブラリ</primary>
<secondary>構築にあたって考慮すること</secondary></indexterm>
<para>
ブックとブックケースをいくつでも含むすべてのサイズのインフォメーション・ライブラリを構築することができます。次に示すインフォメーション・ライブラリ（これに限られるわけではありません）を構築することができます。
</para>
<itemizedlist>
<listitem>
<para>
ひとつまたは複数のブックから成る単一のブックケース
</para>
</listitem>
<listitem>
<para>
それぞれがひとつまたは複数のブックから成る複数のブックケース
</para>
</listitem>
</itemizedlist>
<para>
インフォメーション・ライブラリを設計するときには、インフォメーション・マネージャにおけるその表現とユーザによるその表示を考慮しなければなりません。多くのユーザは、オンラインのマニュアルに慣れていないかもしれないからです。
</para>
<para>
インフォメーションの構造とインフォメーションの検索機能は、オンラインのインフォメーション・ライブラリの設計にあたって、もっとも重要な要素の一部です。ユーザが、容易に、ブックの構造を下ったり、ブックケースのブックを設定できるようにしなければなりません。さらに、明確なハイパーテキスト・リンクと効果的な検索機構によって、望む情報をすばやく見つけることができるようにしなければなりません。
</para>
<sect3>
<title id="SKUExiBLxJ9X3cS">ライブラリの構成</title>
<para>
インフォメーション・マネージャには、非常に強力な検索機能があります。しかしながら、ユーザのインフォメーション・ライブラリの構成は、検索過程の効果に影響します。
</para>
<para>
一般に、インフォメーション・ライブラリのブックケースが少ければ少いほど、また、各ブックケースに含まれるブックが少ければ少いほど、構築過程の進捗は高速になります。また、このようなインフォメーション・ライブラリ構造は、すばやく、容易に更新することができます。
</para>
<para>
残念ながら、ブックケース数が増加すると、情報に関してその内容を検索するブラウザ機能については、このようなライブラリ構造は非効果的になります。
</para>
<para>
その一方、その内容が相対的に大量のブックを含む少量のブックケースから構成されるインフォメーション・ライブラリは、構築とその後の更新により長い時間を要するようになります。しかし、このようなライブラリ構造の検索時間は、顕著に短縮されます。
</para>
</sect3>
<sect3>
<title id="aKUExiBLxJ9X3cS">構築スペース</title>
<para>
インフォメーション・ライブラリを構築する前に、十分なスペースを構築過程が行われる適切な場所に確保しなければなりません。
</para>
<para>
構築が完了すると、インフォメーション・ライブラリは、構築の元になったソースとほぼ同じ容量のスペースを占めます。しかしながら、構築過程そのものについては、一時的ファイルの記憶領域として、最大３倍の追加スペースが必要です。この追加スペースは、構築完了時に自動的に削除される一時的な構築スペースとして確保しなければなりません。一時的な構築スペースのデフォルトは、<filename>/usr/tmp</filename> に確保されます。
</para>
<para>
<filename>/usr/tmp</filename> で使用可能なディスク・スペースが、元のドキュメント・ソースのサイズの３倍よりも小さい場合、<command>dtinfogen build</command> コマンドの <option>-T</option> オプションを使用して、一時的な構築ファイルのために別の場所を指定するか、 <systemitem class="environvar">TMPDIR</systemitem> 環境変数を設定しなければなりません。
</para>
<caution>
<para>
インフォメーション・マネージャの現在のバージョンには、ユーザが同じインフォメーション・ライブラリの構築や修正を同時に行うことを回避する同時使用のロック機構がありません。<command>dtinfogen build</command> コマンドを実行するときには、他の <command>dtinfogen</command> やインフォメーション・マネージャのプロセスが、インフォメーション・ライブラリにアクセスしないことを確認するため、事前に注意を払ってください。<command>dtinfogen</command> コマンドの同時使用は、インフォメーション・マネージャの失敗をもたらします。
</para>
</caution>
</sect3>
</sect2>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<title id="n4Ofh7JBpooBt8oL">インフォメーション・ライブラリの編成</title>
<para>
インフォメーション・ライブラリを構築すると、ブラウザで表示可能なファイルが、図 <link linkend="n9Ofh7JBpooBt8oL">「構築ディレクトリ構造」</link> で示される構造で編成されます。
</para>
<figure>
<title id="n9Ofh7JBpooBt8oL">構築ディレクトリ構造</title>
<graphic id="gr58" entityref="infoapg.fig.5"></graphic>
</figure>
<sect2>
<title id="zOfh7JBpooBt8oL">構築ディレクトリ構造</title>
<indexterm><primary>インフォメーション・マネージャの構築ディレクトリ</primary>
<secondary>ディレクトリ構造</secondary></indexterm>
<para>
構築ディレクトリ構造を、以下に示します。
</para>
<variablelist>
<varlistentry>
<term><replaceable>BC</replaceable><filename>.dbd</filename></term>
<listitem>
<para>
このファイルは、ブックケース <replaceable>BC</replaceable> のためのドキュメント・データベースです。これには、すべてのコンパイルされたテキスト、グラフィック、および表のデータが含まれます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>BC</replaceable><filename>.dbi</filename></term>
<listitem>
<para>
このファイルには、ブックケース <replaceable>BC</replaceable> のための索引データが含まれます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>BC</replaceable><filename>.sch</filename></term>
<listitem>
<para>
このファイルには、データベースの構造が記述されています。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><filename>dtsearch</filename> directory</term>
<listitem>
<para>
このディレクトリには、全文検索エンジンに関係するすべてのファイルが含まれます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><filename>bookcase.map</filename></term>
<listitem>
<para>
このファイルは、ブックケースをライブラリ内に編成します。<command>dtinfogen admin</command> コマンドを使用して、このファイルを修正することができます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>LIB</replaceable><filename>.oli</filename></term>
<listitem>
<para>
<replaceable>LIB</replaceable> のために使用される文字列は、ライブラリにそのファイル名を与えます。
</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
<!--(((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<title id="xXk7ubBtGL9X3cS">新規ライブラリの構築</title>
<para>
新規のインフォメーション・ライブラリ構築のための基本的な <command>dtinfogen build</command> コマンド行の例を、次に示します。
</para>
<programlisting>
dtinfogen build <option>-T</option> <replaceable>/k1/local/daver/</replaceable> <option>-l</option> <replaceable>InfoLib1 DCE.bc INFOMGR.bc PROG.bc</replaceable>
</programlisting>
<para>
各オプションの意味を、以下に示します。
</para>
<variablelist>
<varlistentry>
<term><option>-T</option> <replaceable>/k1/local/daver</replaceable></term>
<listitem>
<para>
構築過程で生成される一時的なファイルが置かれる場所を指定します。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-l</option> <replaceable>InfoLib1</replaceable></term>
<listitem>
<para>
インフォメーション・ライブラリを含むディレクトリの名前を指定します。構築後、<filename>InfoLib1</filename> には、続くコマンド行の引き数で指定される３つのブックケースが含まれます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>DCE.bc INFOMGR.bc PROG.bc</replaceable></term>
<listitem>
<para>
ブックケース規定ファイルのファイル名を指定します。各ブックケース規定には、構築されるひとつまたは複数のブックの名前が含まれます。コマンド行では、任意の数のブックケースのファイル名を指定することができます。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
<command>dtinfogen build</command> コマンドは、ブックケース規定のそれぞれで指定されたドキュメントをブラウザで表示可能なフォーマットに変換し、それらを新規に作成されたインフォメーション・ライブラリのディレクトリ <filename>InfoLib1</filename> に置きます。
</para>
<para>
３つのブックケースの名前を（それぞれのブックケースの BOOKCASENAME 要素で指定されるように）それぞれ <systemitem>DCE</systemitem>、<systemitem>INFOMGR</systemitem>、および <systemitem>PROG</systemitem> とすると、<filename>InfoLib1</filename> ディレクトリ下に、ブックケースのディレクトリ <filename>DCE</filename>、<filename>INFOMGR</filename>、および <filename>PROG</filename> が生成されます。その一方、各ブックケースには、その BOOK 要素で指定されるドキュメント・データベース（ブック）が含まれます。
</para>
<para>
図 <link linkend="wKUExiBLxJ9X3cS">「新規ライブラリの作成」</link> は、新規に構築される <filename>InfoLib1</filename> ライブラリを示しています。
</para>
<figure>
<title id="wKUExiBLxJ9X3cS">新規ライブラリの作成</title>
<graphic id="gr59" entityref="infoapg.fig.6"></graphic>
</figure>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<title id="n7Ktl2IBUXmBt8oL">既存ライブラリへのブックケース追加</title>
<indexterm><primary>ブックケース</primary>
<secondary>追加</secondary>
<tertiary>dtinfogen build</tertiary></indexterm>
<para>
インフォメーション・マネージャの新規インフォメーション・ライブラリ作成に加えて、<command>dtinfogen build</command> を使用して、既存のインフォメーション・ライブラリにまだ構築されていないブックケースを追加することもできます。以下に示す例では、引き数 <option>-l</option>&nbsp;<replaceable>InfoLib1</replaceable> が、新規のインフォメーション・ライブラリではなく、既存のインフォメーション・ライブラリの名前であることを仮定しています。
</para>
<programlisting>
dtinfogen build <option>-l</option> <replaceable>InfoLib1 ORA.bc</replaceable></programlisting>
<para>
以下に説明を示します。
</para>
<variablelist>
<varlistentry>
<term><option>-l</option> <replaceable>InfoLib1</replaceable></term>
<listitem>
<para>
これは、既存のインフォメーション・ライブラリを含むディレクトリの名前です。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>ORA.bc</replaceable></term>
<listitem>
<para>
これは、その内容を <filename>InfoLib1</filename> インフォメーション・ライブラリに追加するブックケース規定ファイルの名前です。コマンド行では、任意の数のブックケース規定名を指定することができます。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
<command>dtinfogen build</command>
これは、ブックケース規定ファイル <filename>ORA.bc</filename> のブック・ドキュメントを、ブラウザで表示可能なフォーマットに変換し、それらを既存のインフォメーション・ライブラリのディレクトリ <filename>InfoLib1</filename> に追加します。
</para>
<para>
追加されるブックケースの名前を（その BOOKCASENAME 要素で指定されるように）<systemitem>ORA</systemitem> と仮定すると、<filename>InfoLib1</filename> ディレクトリには、ブックケースのディレクトリ <systemitem>DCE</systemitem>、<systemitem>INFOMGR</systemitem>、<systemitem>PROG</systemitem> および <systemitem>ORA</systemitem> が生成されます。
</para>
<para>
図 <link linkend="bMUExiBLxJ9X3cS">「既存のライブラリへのブックケース追加」</link> は、更新された <filename>InfoLib1</filename> ライブラリを示しています。
</para>
<note>
<para>
追加されるブックケースは、インフォメーション・マネージャのブック・リスト中の既存のブックケースのリストの末尾に追加されます。<command>dtinfogen admin</command>
コマンドを使用して、構築後にリストの再調整を行うことができます。
<command>dtinfogen(1)</command> マニュアル・ページを参照してください。
</para>
</note>
<figure>
<title id="bMUExiBLxJ9X3cS">既存のライブラリへのブックケース追加</title>
<graphic id="gr60" entityref="infoapg.fig.7"></graphic>
</figure>
</sect1>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<title id="pOUExiBLxJ9X3cS">既存のライブラリのブックケースの置換</title>
<indexterm><primary>ブックケース</primary>
<secondary>置換</secondary><tertiary>dtinfogen build</tertiary>
</indexterm>
<para>
インフォメーション・ライブラリの作成および既存のライブラリへのブックケース追加に加えて、<command>dtinfogen build</command> コマンドで、ライブラリの指定されたブックケースを置換することもできます。以下に示す例では、<command>dtinfogen build</command> プロセスが、ブックケース <systemitem>INFOMGR</systemitem> および <systemitem>PROG</systemitem> の再構築と <filename>InfoLib1</filename> インフォメーション・ライブラリにある同じ名前の既存ブックケースの上書きを行うために使用されています。
</para>
<programlisting>
dtinfogen build <option>-l</option> <replaceable>InfoLib1 INFOMGR.bc PROG.bc</replaceable></programlisting>
<para>
各オプションの説明を、以下に示します。
</para>
<variablelist>
<varlistentry>
<term><option>-l</option> <replaceable>InfoLib1</replaceable></term>
<listitem>
<para>
これは、既存のインフォメーション・ライブラリがあるディレクトリの名前です。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>INFOMGR.bc PROG.bc</replaceable></term>
<listitem>
<para>
これは、その内容で、インフォメーション・ライブラリ <filename>InfoLib1</filename> を更新するために再構築するブックケース規定ファイルのファイル名です。コマンド行では、任意の数のブックケース規定のファイル名を指定することができます。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
<command>dtinfogen build</command> は、ブックケース規定ファイル <filename>INFOMGR.bc</filename> および <filename>PROG.bc</filename> のブックを再構築し、それらを既存のインフォメーション・ライブラリのディレクトリ <filename>InfoLib1</filename> に置きます。
</para>
<para>
そのブックケース名が（それぞれの BOOKCASENAME 要素で指定されているように）<systemitem>INFOMGR</systemitem> および <systemitem>PROG</systemitem> である新規に構築されたブックケースは、同じ名前をもつ既存のブックケースを上書きします。
</para>
<para>
図 <link linkend="n1PUExiBLxJ9X3cS">「既存ライブラリのブックケースの置換」</link> は、更新された <filename>InfoLib1</filename> ライブラリを示しています。
</para>
<figure>
<title id="n1PUExiBLxJ9X3cS">既存ライブラリのブックケースの置換</title>
<graphic id="gr61" entityref="infoapg.fig.8"></graphic>
</figure>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<title id="WmNvZbBE6K9X3cS">構築されたブックケースのスタイル・シートの更新</title>
<indexterm><primary>スタイル・シート</primary>
<secondary>更新</secondary></indexterm>
<indexterm><primary>インフォメーション・マネージャ</primary>
<secondary>コマンド</secondary><tertiary>dtinfogen update</tertiary></indexterm>
<para>
インフォメーション・マネージャでは、そのデータベースを再構築せずに、既存のブックケースのフォーマット指定を変更することができます。この機能によって、異なる読者や製造要件に合致するように、フォーマット属性を変更しなければならないブックを処理するときに、柔軟な対処が可能になります。
</para>
<para>
<command>dtinfogen update</command> コマンドを使用して、フォーマットを管理するスタイル・シート情報を更新することによって、既存のインフォメーション・ライブラリのブックの再フォーマットを行います。
</para>
<para>
<command>dtinfogen update</command> によって、スタイル・シートを更新してその変更の結果をすばやく確認したり、あるスタイル・シートを別のものに置き換えて関連するドキュメントの再フォーマットをすばやく行うことができます。
</para>
<para>
<command>dtinfogen update</command> を実行すると、スタイル・シートの変更によって影響を受けるドキュメントあるいはドキュメントのセクションのみが再フォーマットされます。
</para>
<para>
<command>dtinfogen update</command> を実行して、インフォメーション・ライブラリのドキュメントを再フォーマットする前に、次のことを行います。
</para>
<itemizedlist>
<listitem>
<para>
スタイル・シートに対して行った変更が有効なものであることを確認します。<command>dtinfogen update</command> コマンドは、更新過程において、スタイル・シートのファイルを検証します。
</para>
</listitem>
<listitem>
<para>
<command>dtinfogen update</command> を実行するときに、外部エンティティ参照を処理するための適切な環境変数の設定、あるいは、<option>-m</option> オプションの使用による適切なカタログ・ファイルの指定を行います。
</para>
</listitem>
</itemizedlist>
<caution>
<para>
スタイル・シートを更新しているときには、インフォメーション・マネージャや <command>dtinfogen admin</command> プロセスを実行してはいけません。
</para>
</caution>
<sect2>
<title id="CDdVddBydG9X3cS">dtinfogen update の実行</title>
<para>
次に示す例の基本的なコマンド行は以下のとおりです。この例は、指定されたスタイル・シートを使用するドキュメントあるいはドキュメントのセクションを再フォーマットするものです。
</para>
<programlisting>
dtinfogen update <option>-l</option> <replaceable>InfoLib1</replaceable> <option>-b</option> <replaceable>INFOMGR style1.sty</replaceable></programlisting>
<para>各オプションの意味を、以下に示します。
</para>
<variablelist>
<varlistentry>
<term><option>-l</option> <replaceable>InfoLib1</replaceable></term>
<listitem>
<para>
これは、既存のインフォメーション・ライブラリがあるディレクトリの名前です。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-b</option> <replaceable>INFOMGR</replaceable></term>
<listitem>
<para>
これは、指定されたスタイル・シートで再フォーマットされるセクションを含むブックケースの名前（その BOOKCASENAME 要素で指定されているように）です。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>style1.sty</replaceable></term>
<listitem>
<para>
これは、<command>dtinfogen update</command> のプロセスにおいて、適用されるスタイル・シートのファイル名です。使用するスタイル・シートは、<link linkend="tgmdnkb6vm9x3cs">「インフォメーション・マネージャのスタイル・シートの理解」</link> で説明しているように <filename>StyleSheet.dtd</filename> に準拠していなければなりません。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
<command>dtinfogen update</command> のプロセスを実行した後、変更の効果を確認するために、インフォメーション・マネージャのブック・リスト・ウィンドウを使用してインフォメーション・ライブラリを開くことができます。
</para>
<para>
関連情報については、以下を参照してください。
</para>
<itemizedlist>
<listitem>
<para><command>dtinfogen(1)</command> マニュアル・ページ</para>
</listitem>
<listitem>
<para><link linkend="TcQg4bBSxI9X3cS">「ブックケース規定の作成」</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="j3fa6XBbiK9X3cS">「スタイル・シートの使用」</link></para>
</listitem>
<listitem>
<para>
<link linkend="tgmdnkb6vm9x3cs">「インフォメーション・マネージャのスタイル・シートの理解」</link>
</para>
</listitem>
</itemizedlist>
</sect2>
</sect1>
</chapter>

523
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch05.sgm Normal file
View File

@@ -0,0 +1,523 @@
<!-- $XConsortium: ch05.sgm /main/4 1996/10/11 09:23:56 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<Chapter id="infoapg.div.5">
<Title id="B7XKbKBcgmg24aK">ブックケースの管理</title>
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary>
<Secondary>ブックケースの管理</Secondary></IndexTerm>
<Para>
ブックケースをインフォメーション・ライブラリに構築した後、それを再構築せずに、ライブラリを形成するブックケースについて、数種類の管理機能を実行することができます。機能を以下に示します。
</Para>
<ItemizedList>
<ListItem>
<Para><Link Linkend="K7XKbKBcgmg24aK">「別のライブラリからのブックケースのコピー
」</Link></Para>
</ListItem>
<ListItem>
<Para><Link Linkend="B8XKbKBcgmg24aK">「ライブラリのブックケースの削除」</Link></Para>
</ListItem>
<ListItem>
<Para><Link Linkend="M8XKbKBcgmg24aK">「ライブラリのブックケースの一覧表示」</Link></Para>
</ListItem>
<ListItem>
<Para><Link Linkend="n0cWdbKB-zmg24aK">「ライブラリのブックケースの名称変更」</Link></Para>
</ListItem>
<ListItem>
<Para><Link Linkend="vbWdbKB-zmg24aK">「ライブラリのブックケースの再調整」</Link></Para>
</ListItem>
</ItemizedList>
<Para>
<Link Linkend="n7Ktl2IBUXmBt8oL">「既存のライブラリへのブックケースの追加」</Link>も参照してください。
</Para>
<!--(((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<Title id="n01cq1dBePI9X3cS">dtinfogen admin の実行</Title>
<IndexTerm><Primary>インフォメーション・マネージャ・ツールキット</Primary><Secondary>コマンド</Secondary>
<Tertiary>dtinfogen admin</Tertiary></IndexTerm>
<Para>
<command>dtinfogen admin</command> は、実行する管理操作を選択できるメニューを表示する対話的なプログラムです。<Command>dtinfogen admin</Command> コマンドを実行するには、コマンド行で、次のように入力します。
</Para>
<ProgramListing>
<UserInput>dtinfogen admin</UserInput>
</ProgramListing>
<Para>
リターン・キーを押すと、次のメニューが表示されます。
</Para>
<LiteralLayout>
1) 別のライブラリからのブックケースのコピー
2) ブックケースの削除
3) ライブラリのブックケースの一覧表示
4) ブックケースの名称変更
5) ライブラリのブックケースの再調整
6) 終了
実行する機能を選択してください。[1-6]
</LiteralLayout>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<Title id="K7XKbKBcgmg24aK">別のライブラリからのブックケースのコピー</Title>
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary><Secondary>～間のブックケースのコピー</Secondary></IndexTerm>
<IndexTerm><Primary>ブックケース</Primary><Secondary>別のライブラリからのコピー</Secondary></IndexTerm>
<Para>
別のライブラリからブックケースをコピーする場合、<command>dtinfogen admin</command> は、コピー先のライブラリのブックケースに対してコピーしようとするブックケースを検証します。これにより、ライブラリ内のセクションIDの重複を避け、データベースのバージョンが互換であることを確実にします。
</Para>
<Para>
コピーしようとするブックケースがすでにコピー先のライブラリに存在すると、<Command>dtinfogen admin</Command> は、ブックケースを置換するかどうかを、ユーザに問い合わせます。
</Para>
<Para>
別のライブラリからブックケースをコピーするには、次のようにします。
</Para>
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
</Para>
<Para>
次のメニューが表示されます。
</Para>
<LiteralLayout>
1) 別のライブラリからのブックケースのコピー
2) ブックケースの削除
3) ライブラリのブックケースの一覧表示
4) ブックケースの名称変更
5) ライブラリのブックケースの再調整
6) 終了
実行する機能を選択してください。[1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
コマンド行で、<UserInput>1</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
ブックケースをコピーしたいライブラリへのパスを入力してください。
相対パス、絶対パスどちらでも入力することができます。
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
ブックケースをコピーしたいインフォメーション・ライブラリへのパスを入力します。
たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、ユーザが指定したライブラリで有効なブックケースを表示します。例を以下に示します。
</Para>
<LiteralLayout>
/lit/wolfe で有効なブックケースは、次のとおりです。
1) Life [Life Works]
2) Essays [Essays from Life]
3) Poems [Collections of Poems]
コピーしたいブックケースに関連する番号を入力してください。[1-3]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
プロンプトに続いて、コピーしたいブックケースに対応する番号を入力します。<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
<Replaceable>[Life]</Replaceable> が指定されました。
このブックケースをコピーしてもよろしいですか？
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
指定したブックケースをコピーするには、<UserInput>Y</UserInput> (大文字、小文字どちらでも使用できます) を入力します。
</Para>
</ListItem>
<ListItem>
<Para>
ブックケースをコピーしたいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/destiny</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、ユーザが指定したライブラリで有効なブックケースを表示します。
</Para>
<LiteralLayout>
/lit/destiny で有効なブックケースは、次のとおりです。
1) Child [School Days]
2) Reports [Reports from School]
ブックケースは、ここに示されている順番でブラウザのブック・リストに表示されます。
占有したいブックケースの位置に対応する番号を入力してください。[1-2]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
占有したいブックケースの位置に対応する番号を入力します。
</Para>
<Para>
すでに別のブックケースが選択した位置を占有している場合、コピーしようとするブックケースはその位置を占め、元のブックケースはリストのひとつ下に移動します。
</Para>
<Para>
<command>dtinfogen admin</command> は、ライブラリのブックケースを更新された順序で表示します。例を次に示します。
</Para>
<LiteralLayout>
更新後のブックケースの順番は、次のとおりです。
1) Child [School Days]
2) Reports [Reports from School]
3) Life [Life Works]
これでよろしいですか？[ynq]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
この位置にブックケースをコピーするには、<UserInput>Y</UserInput> を入力します。<command>dtinfogen admin</command> は、ライブラリへの追加を保存し、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>
</sect1>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<Title id="B8XKbKBcgmg24aK">ライブラリのブックケースの削除</Title>
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary><Secondary>～のブックケースの削除</Secondary></IndexTerm>
<IndexTerm><Primary>ブックケース</Primary><Secondary>ライブラリの～の削除</Secondary></IndexTerm>
<Para>
<command>dtinfogen admin</command> によるブックケースの削除の手続きは、ライブラリへのブックケースのコピーの手続きと似ています。ライブラリからブックケースを削除する場合、そのデータベースは、インフォメーション・ライブラリから削除されます。
</Para>
<Para>
ライブラリを指定すると、<Command>dtinfogen admin</Command> は、そのライブラリでみつかったブックケースの一覧を表示します。ユーザは、削除したいブックケースを指定するだけです。指定した情報が無効な場合、<Command>dtinfogen admin</Command> は、指定したブックケースを削除する前に、確認を求めてきます。
</Para>
<Para>
ライブラリからブックケースを削除するには、次のようにします。
</Para>
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
</Para>
<Para>
次のメニューが表示されます。
</Para>
<LiteralLayout>
1) 別のライブラリからのブックケースのコピー
2) ブックケースの削除
3) ライブラリのブックケースの一覧表示
4) ブックケースの名称変更
5) ライブラリのブックケースの再調整
6) 終了
実行する機能を選択してください。[1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
ブックケースを削除するには、<UserInput>2</UserInput> を入力します。
</Para>
<Para>
<Command>dtinfogen admin</Command> は、次のように表示してきます。
</Para>
<LiteralLayout>
ブックケースを削除したいライブラリへのパスを入力してください。
相対パス、絶対パスどちらでも入力することができます。
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
ブックケースを削除したいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<Command>dtinfogen admin</Command> は、指定されたライブラリで有効なブックケースを表示してきます。
</Para>
<LiteralLayout>
/lit/wolfe で有効なブックケースは、次のとおりです。
1) Life [Life Works]
2) Essays [Essays from Life]
3) Poems [Collections of Poems]
削除するブックケースに対応する番号を入力してください。
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
プロンプトに続いて、削除したいブックケースに対応する番号を入力します。
<Command>dtinfogen admin</Command> は、次のように表示してきます。
</Para>
<LiteralLayout>
<Replaceable>[Essays]</Replaceable> が指定されました。
このブックケースを本当に削除してもよろしいですか？
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
指定したブックケースを削除するには、<UserInput>Y</UserInput> を入力します。<Command>dtinfogen admin</Command> はブックケースを削除し、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<Title id="M8XKbKBcgmg24aK">ライブラリのブックケースの一覧表示</Title>
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary><Secondary>～のブックケースの一覧表示</Secondary></IndexTerm>
<IndexTerm><Primary>ブックケース</Primary><Secondary>ライブラリの～の一覧表示</Secondary></IndexTerm>
<Para>
処理するライブラリを識別するときに、ライブラリのブックケースの一覧を表示したいことがあります。
</Para>
<Para>
ライブラリのブックケースの一覧を表示するには、次のようにします。
</Para>
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
1) 別のライブラリからのブックケースのコピー
2) ブックケースの削除
3) ライブラリのブックケースの一覧表示
4) ブックケースの名称変更
5) ライブラリのブックケースの再調整
6) 終了
実行する機能を選択してください。[1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
ブックケースの一覧を表示するには、<UserInput>3</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
ブックケースの一覧を表示したいライブラリへのパスを入力してください。
相対パス、絶対パスどちらでも入力することができます。
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
ブックケースの一覧を表示したいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、指定されたライブラリで有効なブックケースを表示してきます。例を次に示します。
</Para>
<LiteralLayout>
/lit.wolfe で有効なブックケースは、次のとおりです。
1) Life [Life Works]
2) Essays [Essays from Life]
3) Poems [Collections of Poems]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
インフォメーション・ライブラリのブックケースの一覧を表示した後、<command>dtinfogen admin</command> は、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<Title id="n0cWdbKB-zmg24aK">ライブラリのブックケースの名称変更</Title>
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary><Secondary>～のブックケースの名称変更</Secondary></IndexTerm>
<IndexTerm><Primary>ブックケース</Primary><Secondary>ライブラリの～の名称変更</Secondary></IndexTerm>
<Para>
ブラウザが、インフォメーション・マネージャのブック・リストに表示するブックケース名を変更することができます。ブックケースの名称を変更するには、次のようにします。
</Para>
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
1) 別のライブラリからのブックケースのコピー
2) ブックケースの削除
3) ライブラリのブックケースの一覧表示
4) ブックケースの名称変更
5) ライブラリのブックケースの再調整
6) 終了
実行する機能を選択してください。[1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
ブックケースの名称を変更するには、<UserInput>4</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
名称を変更したいブックケースがあるライブラリへのパスを入力してください。
相対パス、絶対パスどちらでも入力することができます。
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
名称を変更したいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、指定されたライブラリで有効なブックケース
を表示してきます。
</Para>
<LiteralLayout>
/lit/wolfe で有効なブックケースは、次のとおりです。
1) Life [Life Works]
2) Essays [Essays from Life]
3) Poems [Collections of Poems]
名称を変更したいブックケースに対応する番号を入力してください
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
プロンプトに続いて、名称を変更したいブックケースに対応する番号を入力します。<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
<Replaceable>[Poems]</Replaceable> が指定されました。
このブックケースの名称を、本当に変更しますか？
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
指定したブックケースの名称を変更するには、<UserInput>Y</UserInput> を入力します。<command>dtinfogen admin</command> は、ブックケースの新規タイトルを問い合わせてきます。
</Para>
<LiteralLayout>
<Replaceable>[Poems]</Replaceable> の新しい名前を入力してください。
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
ブックケースの新規タイトルを入力します。<command>dtinfogen admin</command> は、次のように新規タイトルを表示してきます。
</Para>
<LiteralLayout>
入力された名前は <Replaceable>[Old Poems]</Replaceable> です。
この名前でよろしいですか？
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
この新規タイトルでよければ、<UserInput>Y</UserInput> を入力します。<command>dtinfogen admin</command> は新規タイトルを保存し、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<Title id="vbWdbKB-zmg24aK">ライブラリのブックケースの再調整</Title>
<IndexTerm><Primary>インフォメーション・ライブラリ</Primary><Secondary>～のブックケースの再調整</Secondary></IndexTerm>
<IndexTerm><Primary>ブックケース</Primary><Secondary>ライブラリの～の再調整</Secondary></IndexTerm>
<Para>
ライブラリ構築後に、インフォメーション・マネージャのブック・リストで、ブックケースを異なる順序で表示させたいときがあります。また、<Command>dtinfogen build</Command> を使用してブックケースを追加し、それを別の位置に移動させたいときがあります。<Command>dtinfogen admin</Command> を使用して、ライブラリのブックケースの順序を変更することができます。
</Para>
<Para>
ライブラリ内のブックケースを再調整するには、次のようにします。
</Para>
<OrderedList>
<ListItem>
<Para>
コマンド行で、<UserInput>dtinfogen admin</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
1) 別のライブラリからのブックケースのコピー
2) ブックケースの削除
3) ライブラリのブックケースの一覧表示
4) ブックケースの名称変更
5) ライブラリのブックケースの再調整
6) 終了
実行する機能を選択してください。[1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
ライブラリのブックケースを再調整するには、<UserInput>5</UserInput> を入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
再調整したいライブラリへのパスを入力してください。
相対パス、絶対パスどちらでも入力することができます。
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
再調整したいインフォメーション・ライブラリへのパスを入力します。たとえば、<UserInput>/lit/wolfe</UserInput> のように入力します。
</Para>
<Para>
<command>dtinfogen admin</command> は、指定されたライブラリで有効なブックケースを表示してきます。
</Para>
<LiteralLayout>
/lit/wolfe で有効なブックケースは、次のとおりです。
1) Life [Life Works]
2) Essays [Essays from Life]
3) Poems [Collections of Poems]
移動したいブックケースに対応する番号を入力してください。
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
プロンプトに続いて、移動したいブックケースに対応する番号を入力します。<command>dtinfogen admin</command> は、次のように表示してきます。
</Para>
<LiteralLayout>
<Replaceable>[Poems]</Replaceable> が指定されました。
このブックケースを本当に移動してもよろしいですか？
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
指定したブックケースをライブラリの別の位置に移動するには、<UserInput>Y</UserInput> を入力します。<command>dtinfogen admin</command> は、移動を選択したブックケースが含まれないライブラリの現在の順序を表示してきます。例を次に示します。
</Para>
<LiteralLayout>
[Poems] を含めない順序は、次のとおりです。
1) Life [Life Works]
2) Essays [Essays from Life]
ブラウザのブック・リストで、ブックケースはここで示した順番に表示されます。
占有したいブックケースの位置に対応する番号を入力してください。
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
占有したいブックケースの位置に対応する番号を入力してください。
</Para>
<Para>
選択した位置を別のブックケースがすでに占有していた場合には、移動したブックケースがその位置を占め、元のブックケースはリストのひとつ下の位置に移動します。
</Para>
<Para>
<Command>dtinfogen admin</Command> は、ライブラリの新しいブックケースの順序を表示してきます。例を次に示します。
</Para>
<LiteralLayout>
指定されたブックケースの順番は次のとおりです。
1) Poems [Collections of Poems]
2) Life [Life Works]
3) Essays [Essays from Life]
これでよろしいですか？[ynq]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
再調整された順序でよければ、<UserInput>Y</UserInput> を入力します。<Command>dtinfogen admin</Command> は、新規の順序を保存し、メイン・メニューに戻ります。
</Para>
</ListItem>
</OrderedList>
</sect1>
</Chapter>

446
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch06.sgm Normal file
View File

@@ -0,0 +1,446 @@
<!-- $XConsortium: ch06.sgm /main/4 1996/10/11 09:24:03 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<Chapter id="infoapg.div.6">
<Title id="n0W3SgFBd02698oL">トラブルシューティング</Title>
<IndexTerm><Primary>トラブルシューティング</Primary></IndexTerm>
<Para>
本節では、以下に示すものの結果として、インフォメーション・マネージャのツールで発生する問題について説明します。
</Para>
<ItemizedList>
<ListItem>
<Para>
構築エラー: このエラーは、次の過程で発生します。
<Command>dtinfogen build</Command>
<Command>dtinfogen tocgen</Command>
<Command>dtinfogen update</Command>
</Para>
</ListItem>
<ListItem>
<Para>
スタイル・シート・エラー: このエラーは、次の過程で発生します。
<Command>dtinfogen build</Command>
<Command>dtinfogen update</Command>
</Para>
</ListItem>
<ListItem>
<Para>
ライブラリ管理エラー: このエラーは、次の過程で発生します。
<Command>dtinfogen admin</Command>
</Para>
</ListItem>
</ItemizedList>
<Para>
詳細については、<filename>dtinfogen(1)</filename> マニュアル・ページを参照してください。
</Para>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<Title id="DW3SgFBd02698oL">構築エラー</Title>
<Para>
次に示すエラー・メッセージは、一般に構築過程に関連するものであり、次のプログラムのいずれかによって生成されます。
<Command>dtinfogen build</Command>
<Command>dtinfogen tocgen</Command>
<Command>dtinfogen update</Command>
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 宣言されていないスタイル・シート名 NAME が、ブックケース規定でみつかりました。
</computeroutput>
</literallayout>
<para>
このエラーは、スタイル・シート <Replaceable>NAME</Replaceable> が、ブックケース
で指定されているが、どこにも宣言されていないことを意味します。
</Para>
<Para>
スタイル・シートを明示的に取り込まなければなりません。スタイル・シートを取り込むひとつの方法は、エンティティ参照の使用です。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 無効な目次 (ToC) がみつかりました。
</computeroutput>
</literallayout>
<para>
このエラーは、インフォメーション・マネージャが、同一のブック内で複数の目次 (TOC) をみつけたことを意味します。
</Para>
<Para>
各ブックには、ただひとつの目次 (TOC) が許されます。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) メモリー不足です。
</computeroutput>
</literallayout>
<para>
このエラーは、構築を続行するためのメモリーが不十分であることを意味しています。
</Para>
<Para>
構築過程のためのメモリーを増やさなければなりません。構築過程のためのメモリー確保の詳細については、
<Link Linkend="jI.RgFBe.1698oL">「構築において考慮すること」</Link>を参照してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 目次 (ToC) の検証に失敗しました。
</computeroutput>
</literallayout>
<para>
このエラーは、目次 (TOC) の検証が失敗したことを意味しています。
</Para>
<Para>
エラーが発生した箇所の詳細については、構築ログをチェックしてください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 目次 (Toc) ファイル = <Replaceable>FILE</Replaceable>
" の行 = <Replaceable>LINE</Replaceable>
" にある IDREF = <Replaceable>LINK</Replaceable>
" は、無効なセクションを指しています。
</computeroutput>
</literallayout>
<para>
このエラーは、目次 (TOC) ファイル <Replaceable>FILE</Replaceable> の 行 <Replaceable>LINE</Replaceable> にあるハイパーテキスト・リンク <Replaceable>LINK</Replaceable> には、リンク先のセクションがないことを意味しています。
</Para>
<Para>
リンク先セクションとして、一意のIDを指定してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) ファイル = <Replaceable>FILE</Replaceable>
" の行 = <Replaceable>LINE</Replaceable>
" にあるセクションID = <Replaceable>ID</Replaceable>
" には、目次 (TOC) ファイル = <Replaceable>TOCFILE</Replaceable>.
" の値 = <Replaceable>ID</Replaceable>
" に対応するリンクがありません。
</computeroutput>
</literallayout>
<para>
このエラーは、目次 (TOC) ファイル <Replaceable>TOCFILE</Replaceable> から、ファイル <Replaceable>FILE</Replaceable> のセクション <Replaceable>ID</Replaceable> へのリンクが存在しないことを示しています。
</Para>
<Para>
目次 (TOC) ファイル <Replaceable>TOCFILE</Replaceable> をチェックし、目次に値 <Replaceable>ID</Replaceable> のリンクを追加してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) ファイル = <Replaceable>FILENAME1</Replaceable>
" の行 = <Replaceable>LINE1</Replaceable>
でみつかった重複ID = <Replaceable>ID</Replaceable>
" は、ファイル = <Replaceable>FILE2</Replaceable>
" の行 = <Replaceable>LINE2</Replaceable>.
" でみつかったID = <Replaceable>ID</Replaceable>
" と衝突しています。
</computeroutput>
</literallayout>
<para>
このエラーは、インフォメーション・マネージャが、ファイル <Replaceable>FILE1</Replaceable> と <Replaceable>FILE2</Replaceable> の両方で、重複したIDの値 <Replaceable>ID</Replaceable> をみつけたことを意味しています。
</Para>
<Para>
各IDの値は、一意でなければなりません。一意にするために、適切なIDの値に変更してください。新規の値で、目次 (TOC) ファイルを更新することを忘れないでください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) ファイル = <Replaceable>FILE1</Replaceable>
" の行 = <Replaceable>LINE1</Replaceable>
でみつかった重複したセクションID = <Replaceable>ID</Replaceable>
" は、ファイル = <Replaceable>FILE2</Replaceable>
" の行 = <Replaceable>LINE2</Replaceable>.
" でみつかったID = <Replaceable>ID</Replaceable>
" と衝突しています。
</computeroutput>
</literallayout>
<para>
このエラーは、インフォメーション・マネージャが、ファイル <Replaceable>FILE1</Replaceable> と <Replaceable>FILE2</Replaceable> の両方で、重複したセクションIDの値 <Replaceable>ID</Replaceable> をみつけたことを意味しています。
</Para>
<Para>
各セクションIDの値は、一意でなければなりません。一意にするために、適切なIDの値に変更してください。新規の値で、目次 (TOC) ファイルを更新することを忘れないでください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) ファイル = <Replaceable>FILE1</Replaceable>
" の行 = <Replaceable>LINE</Replaceable>
" で指定されたブック = <Replaceable>bookName</Replaceable>
" のタブID = <Replaceable>TabId</Replaceable>
" は、ブックでみつかったどのセクションIDも指していません。
</computeroutput>
</literallayout>
<para>
これは、 <Replaceable>bookName</Replaceable> にある タブIDの値 <Replaceable>TabId</Replaceable> が、<Replaceable>bookName</Replaceable> と一致するファイルでみつからなかったことを意味しています。
</Para>
<Para>
すべてのタブは、ブックの有効なセクションを指していなければなりません。タブIDが、有効なセクションを指していることを確認してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) スタイル・シートの検証に失敗しました。
</computeroutput>
</literallayout>
<para>
このエラーは、スタイル・シートで構文エラーがみつかったことを意味しています。
</Para>
<Para>
スタイル・シートの構文エラーを修正してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) グラフィカル・オブジェクトのIDがみつかりません。
object.
</computeroutput>
</literallayout>
<para>
このエラーは、グラフィカル・オブジェクトにIDがなかったことを意味しています。グラフィカル・オブジェクトに、空でないIDを指定してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 用語ファイルがありません。
</computeroutput>
</literallayout>
<para>
このエラーは、検索可能な用語情報のための一時的ファイルを作成するディスク・スペースが不十分なことを意味しています。
</Para>
<Para>
構築を実行するための十分なディスク・スペースを確保していることを検証してください。
</Para>
</sect1>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<Title id="n7eNaekBIaXwA0YK">スタイル・シートのエラー</Title>
<Para>
次に示すエラー・メッセージは、スタイル・シート関連のものです。スタイル・シートの作成と使用については、
<Link Linkend="tgmdnkb6vm9x3cs">「インフォメーション・マネージャのスタイル・シートの理解」</link>
および<Link Linkend="btcmaab0ang24ak">「スタイル・シートの作成」</link>
を参照してください。
</para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 自動数字割り付け: ID属性がありません。
</computeroutput>
</literallayout>
<para>
このエラーは、自動数字割り付けのためのID属性がみつからなかったことを意味しています。自動数字割り付けのためのID属性を指定してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 自動数字割り付け: Type属性がありません。
</computeroutput>
</literallayout>
<para>
このエラーは、自動数字割り付けのためのType属性がみつからなかったことを意味しています。自動数字割り付けのためのType属性を指定してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 自動数字割り付け: Initial属性がありません。
</computeroutput>
</literallayout>
<para>
このエラーは、自動数字割り付けのためのInitial属性がみつからなかったことを意味しています。自動数字割り付けのためのInitial属性を指定してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 自動数字割り付け: Delta属性がありません。
</computeroutput>
</literallayout>
<para>
このエラーは、自動数字割り付けのためのDelta属性がみつからなかったことを意味しています。自動数字割り付けのためのDelta属性を指定してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 自動数字割り付け: Reset属性がありません。
</computeroutput>
</literallayout>
<para>
このエラーは、自動数字割り付けのためのReset属性がみつからなかったことを意味しています。自動数字割り付けのためのReset属性を指定してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 自動数字割り付け: Counter属性がありません。
</computeroutput>
</literallayout>
<para>
このエラーは、自動数字割り付けのためのCounter属性がみつからなかったことを意味しています。自動数字割り付けのためのCounter属性を指定してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) スタイル・シートの名前が指定されていません。
</computeroutput>
</literallayout>
<para>
このエラーは、スタイル・シート名がないことを意味しています。スタイル・シート名を指定ください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) <Replaceable>EXPR</Replaceable> の構文エラーです。
</computeroutput>
</literallayout>
<para>
このエラーは、インフォメーション・マネージャ設計様式のために指定された式 <Replaceable>EXPR</Replaceable> で構文エラーがみつかったことを意味しています。
</Para>
<Para>
文書型定義で式 <Replaceable>EXPR</Replaceable> を検索し、インフォメーション・マネージャ設計様式のための構文を修正してください。
</Para>
</sect1>
<!--))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<Title id="L4E7gLBYimg24aK">ライブラリ管理メッセージ</Title>
<Para>
次に示すエラー・メッセージは、<Command>dtinfogen admin</Command> コマンドに関連するものです。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) <Replaceable>InfoLibPath</Replaceable> は有効なインフォメーション・ライブラリではありません。
</computeroutput>
</literallayout>
<para>
このエラーは、指定された <Replaceable>InfoLibPath</Replaceable> が無効なパスになっているか、インフォメーション・ライブラリそのものが無効であることを意味しています。正しいパス名を入力するか、選択した <Replaceable>InfoLibPath</Replaceable> の下に <Filename>*.oli</Filename> という名前のファイルがあるかどうかチェックしてください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 検証でエラーは発生したため、コピーは実行されませんでした。
</computeroutput>
</literallayout>
<para>
このエラーは、<Command>dtinfogen admin</Command> の検証処理の段階で問題がみつかり、ブックケースがコピー先のライブラリにコピーされなかったことを意味しています。問題は、バージョンの不一致または重複したIDによるものである可能性があります。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) データのバージョンの不一致です。
" <Replaceable>checkBase</Replaceable> バージョン = #
" <Replaceable>installBase</Replaceable> バージョン = #
</computeroutput>
</literallayout>
<para>
このエラーは、コピーしようとしているブックケース (<Replaceable>checkbase</Replaceable>) とインフォメーション・ライブラリ（インストールされたベース）に存在するブックケースに、<Command>dtinfogen admin</command> によって、バージョンの不一致がみつかったことを意味しています。同じバージョンの構築ツールで、ブックケースを再構築してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) <Replaceable>BookCaseName</Replaceable> で重複したIDの値 [<Replaceable>ID</Replaceable>] がみつかりました。
</computeroutput>
</literallayout>
<para>
このエラーは、コピーしようとしているブックケースとコピー先のブックケース <Replaceable>BookCaseName</Replaceable> のID <Replaceable>ID</Replaceable> の重複が、<Command>dtinfogen admin</Command> によってみつかったことを意味しています。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 選択された位置は無効です。ブックケースの有効な位置を指定してください。
</computeroutput>
</literallayout>
<para>
このエラーは、特定のブックケースのために指定された位置が範囲外であることを意味しています。ブックケースの有効な位置を指定してください。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) <Replaceable>InfoLibPath</Replaceable> から <Replaceable>BookCaseName</Replaceable> を削除できません。
</computeroutput>
</literallayout>
<para>
このエラーは、<Command>dtinfogen admin</Command> が、インフォメーション・ライブラリ <Replaceable>InfoLibPath</Replaceable> からブックケース <Replaceable>BookCaseName</Replaceable> を削除できなかったことを意味しています。当該ブックケース変更のための正当なアクセス権があることを確認してください。また、当該ブックケースがインフォメーション・ライブラリに存在しないか、ブックケースへのパスが無効である可能性もあります。
</Para>
<para>
次にエラー・メッセージとその意味を示します。
</para>
<literallayout>
<computeroutput>
(エラー) 選択された番号は無効です。1から6の番号を指定してください。
</computeroutput>
</literallayout>
<para>
このエラーは、選択された番号が範囲外であることを意味しています。
</Para>
</sect1>
</Chapter>

502
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch07.sgm Normal file
View File

@@ -0,0 +1,502 @@
<!-- $XConsortium: ch07.sgm /main/4 1996/10/11 09:24:11 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<chapter id="infoapg.div.7">
<title id="tgmdnkb6vm9x3cs">インフォメーション・マネージャのスタイル・シートの理解</title>
<IndexTerm><Primary>スタイル・シート</Primary><Secondary>理解</Secondary></IndexTerm>
<para>
スタイル・シートは、文書型定義における要素のオンラインおよび印刷フォーマットの属性を定義することによって、インフォメーション・マネージャのブラウザによるドキュメントの表示形式を制御します。インフォメーション・マネージャのスタイル・シートは、スタイル・シート文書型定義 <filename>dtinfoStyle.dtd</filename> に準拠していなければなりません。
</para>
<para>
スタイル・シートは、ブックケース規定ドキュメントの一部として指定されます。インフォメーション・マネージャでインフォメーション・ライブラリを構築するには、ブックケースのレベルで、デフォルトのスタイル・シートを参照しなければなりません。詳細については、<filename>dtinfoBook.dtd(5)</filename> マニュアル・ページ、<link linkend="n0Crl2IBiWmBt8oL">「構築過程とツール」</link>、および <link linkend="j3fa6XBbiK9X3cS">「スタイル・シートの使用」</link> を参照してください。
</para>
<para>
スタイル・シートの作成に関する特定の情報については、以下を参照してください。
</para>
<itemizedlist>
<listitem>
<para>
<link linkend="whpipbbc3h9x3cs">「スタイル・シートの構造」</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="btcmaab0ang24ak">「スタイル・シートの作成」</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="suwh3wbmhwy94ak">「スタイル機能」</link>
</para>
</listitem>
</itemizedlist>
<!-- ))))))))))))))))))))))))))))))))))))))))))))) -->
<sect1>
<title id="whpipbbc3h9x3cs">スタイル・シートの構造</title>
<IndexTerm><Primary>スタイル・シートの構造</Primary></IndexTerm>
<para>
スタイル・シートは、<systemitem>AutoNumber</systemitem> 宣言から成り、この後に <systemitem>Path</systemitem> ステートメントおよびスタイル規定が続きます。
</para>
<para>
スタイル・シートは、ブックケース、ブック、およびセクションのレベルで指定することができます。ブックケース以下のレベルでスタイル・シートを指定しない場合、そのレベルのスタイルは、それが含む要素から継承されます。要素にスタイル・シートが指定されていない場合、テキストは、グローバルな Xresources ファイルで指定されているデフォルト値、14ポイントの Helvetica で、インフォメーション・マネージャの表示ウィンドウに表示されます。印刷のときのデフォルトのフォントは、12ポイントの Helvetica です。
</para>
<note>
<para>
継承に関する詳細についていは、
<link linkend="pgqaykbbgsg24ak">「継承の理解」</link> を参照してください。
</para>
</note>
<para>
各スタイル・シートには、あるブックケースのドキュメントの範囲内で、一意の名前がなければなりません。インフォメーション・マネージャは、スタイル・シート名を、ブックケースおよびそのブックとセクションそれぞれにおける参照として使用します。
</para>
<para>
スタイル・シートの作成は、基本的には、要素選択の問題です。これは、<link linkend="jipipbbc3h9x3cs"><systemitem>Path</systemitem></link> ステートメントを通じて行うもので、名前、コンテキスト、および属性によって選択します。それから、<systemitem>Path</systemitem> にタイポグラフィック・プロパティを割り当てます。
</para>
<itemizedlist>
<listitem>
<para>
パスのない <systemitem>Select</systemitem> 機能を使用して、属性値、絶対位置、あるいは相対位置によって要素を選択することができます。
</para>
</listitem>
<listitem>
<para>
スタイル・シートの <systemitem>Path</systemitem> ステートメントを使用して、<systemitem>Online</systemitem> あるいは <systemitem>Print</systemitem> (ハード・コピー) 機能で、フォーマット対象の要素を識別することもできます。
</para>
</listitem>
<listitem>
<para>
<systemitem>Online</systemitem> および <systemitem>Print</systemitem> 機能の設定は、次に示す <link linkend="cwccmncd70hp2ol">「印刷固有の機能」</link> を除いて、機能、記述、および規定と合致します。
</para>
<itemizedlist>
<listitem>
<para>
<link linkend="n4kpipbbc3h9x3cs">Medium</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="r74dmncp70hp2ol">PageBreak</link>
</para></listitem>
</itemizedlist>
</listitem>
</itemizedlist>
<para>
次に、Chapter 属性のフォーマット属性を指定するスタイル・シート構文の部分的な例を示します。これは、ある種のドキュメントにおいては、<systemitem>DTINFO.Section</systemitem> 設計様式を使用する最大の要素です。スタイル・シートの最初の <systemitem>Path</systemitem> として、最大の <systemitem>DTINFO.Section</systemitem> を指定することは、デフォルトのレンダリング属性を設定するとき、有用なことがあります。
</para>
<literallayout>
&lt;Path>
Chapter&lt;/Path>
&lt;online>
&lt;wrap word>
&lt;margin left=20 right=20>
&lt;font fallback=sans weight=medium slant=roman size=14>
&lt;family name=helvetica charset="iso8859-1">
&lt;/font>
&lt;/online>
</literallayout>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect2>
<title id="jipipbbc3h9x3cs">パスの指定</title>
<IndexTerm><Primary>パスの指定</Primary></IndexTerm>
<para>
パス・ステートメントは、もっとも外側の要素からスタイル・シートで指定された機能によって影響を受けるある要素までの階層的なパスを指定します。与えられた階層構造において、特定の要素を識別するには、その要素への最少限の一意なパスを指定するだけです。
</para>
<para>
パスは、常に、コンテキストにおいて要素または要素クラスと一致する最初のパス指定によって解決されます。特別な要素 <systemitem>Select</systemitem> ステートメントと同じようにワイルドカード文字を使用して、フォーマット対象の特定の要素を識別することができます。<systemitem>Select</systemitem> ステートメントについては、<link linkend="n6jmj9jbj6ng24ak">「Select ステートメントの使用」</link> で、説明しています。
</para>
<para>
次に示す図では、Chapter 要素には、その後に２つの Paragraph 要素とひとつの Section 要素が続く Title があります。また、Section 要素には、Title と２つの Paragraph 要素があります。
</para>
<Figure>
<Title id="n1mievocfe0hp2ol">単純なドキュメント階層構造</Title>
<GRAPHIC id="gr71" entityref="infoapg.fig.10"></graphic>
</Figure>
<para>
この図に基づく Section 要素の完全なパスは、以下のようになります。
</para>
<programlisting>
&lt;Path> Chapter Section &lt;/Path>
</programlisting>
<note>
<para>
ダイアグラムの階層構造には、ただひとつの Section 要素があるため、Section 要素を識別するには、要素名だけで十分です。
</para>
</note>
<para>
Section 要素内に含まれる Paragraph 要素を識別するパスは、以下のようになります。
</para>
<programlisting>
&lt;Path>Chapter Section Paragraph &lt;/Path>
</programlisting>
<para>
スタイル・シートにおいて、パスを指定する場合、２つのワイルドカードが使用可能です。
</para>
<itemizedlist>
<listitem>
<para>
疑問符 ( <literal>?</literal> ) は、生起するすべての単一要素を示します。
</para>
</listitem>
<listitem>
<para>
アスタリスク ( <literal>*</literal> ) は、生起する要素を０個を含むいくつでも示します。
</para>
</listitem>
</itemizedlist>
<para>
上の図に基づくと、次に示す２つのステートメントは、同じ要素を指定します。
</para>
<programlisting>
&lt;Path> Chapter Section Title &lt;/Path>
</programlisting>
<programlisting>
&lt;Path> Chapter ? Title &lt;/Path>
</programlisting>
<para>
しかしながら、上記の２つの PATH ステートメントとは異なり、次の PATH ステートメントは、セクションに含まれる Title ステートメント以外も選択します。
</para>
<programlisting>
&lt;Path> Chapter * Title &lt;/Path>
</programlisting>
</sect2>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<title id="n6jmj9jbj6ng24ak">Select ステートメントの使用</title>
<IndexTerm><Primary>select ステートメント</Primary></IndexTerm>
<para>
<systemitem>Select</systemitem> ステートメントによって、異なるスタイルを、異なるコンテキストの同じ要素に適用することが可能になります。たとえば、<systemitem>Select</systemitem> を使用することによって、フォーマット属性の異なるセットを、特定の型のヘッド（リスト内の副次的な編成か、警告の一部か）に続くかどうかに依存して、段落要素に適用することができます。これは、<systemitem>Select</systemitem> ステートメントによって、要素の属性値またはその位置による要素の特定のインスタンスとの一致を行うことができるために、可能です。
</para>
<para>
<systemitem>Path</systemitem> 内の各要素は、それ自身の <systemitem>Select</systemitem> ステートメントをもつことができます。<systemitem>Select</systemitem> ステートメントは、単純な比較演算子、「等しい」(==)、「等しくない」(!=)、およびブール演算子、「および」 (&#38;&#38;) と「または」(||) を使用します。
</para>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="lkb3nlchsaznuzs">属性による要素の識別</title>
<para>
要素の属性値を使用して、要素を識別することができます。たとえば、Paragraph 要素が、次に示すような開始タグをもっていたとしましょう。
</para>
<programlisting>
&lt;PARAGRAPH label="UNIque">
</programlisting>
<para>
この場合、Paragraph 要素へのパスは、以下のように指定することができます。
</para>
<programlisting>
&lt;PATH>Paragraph &lt;Select>@label == "UNIque"&lt;/Select>
&lt;/PATH>
</programlisting>
<para>
この方法では、"@" 文字の後の属性名として、どのような要素属性でも使用することができます。同じように、次のステートメントにより、同じ Paragraph 要素を明示的に排除することも可能です。
</para>
<programlisting>
&lt;PATH>Paragraph &lt;Select>@label != "UNIque"&lt;/Select>
&lt;/PATH>
</programlisting>
</sect2>
<!--(((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect2>
<title id="azp3nlcmsaznuzs">位置による要素の識別</title>
<para>
要素の階層構造における要素の相対位置または絶対位置に基づくモデルを使用して、位置による要素の識別を行うことができます。その識別キーワードによって２つの方法があります。
</para>
<itemizedlist>
<listitem>
<para>
解析木における要素の絶対位置。<systemitem>"Position"</systemitem> キーワードを使用します。
</para>
</listitem>
<listitem>
<para>
兄弟位置間の要素の相対位置。<systemitem>"Sibling"</systemitem> キーワードを使用します。
</para>
</listitem>
</itemizedlist>
<para>
これら２つのモデルは、どのような <systemitem>Path</systemitem> ステートメントであっても、いっしょに使用することができます。いずれも、値として数値を必要としますが、特別な値 <systemitem>"#LAST"</systemitem> を使用して、要素のリストにおける最後の要素を指定することもできます。以下に示す文書型定義フラグメントとドキュメント・インスタンス・フラグメントの例は、２つの可能な絶対位置および相対位置による要素の選択モデルを示しています。続くサンプルの <systemitem>Path</systemitem> ステートメントは、２つのモデルを使用して、特定の要素項目を選択するためのこれらの選択機構の利用方法を示しています。
</para>
<example>
<title id="itzl.ocz40hp2ol">文書型定義フラグメントとドキュメント・インスタンス・フラグメント</title>
<literallayout>
&lt;!ELEMENT List - - (Title?,Item+)>
&lt;!ATTLIST List Type (Bulleted|Numbered) "Bulleted">
&lt;!ELEMENT Title - - #PCDATA >
&lt;!ELEMENT Item - - #PCDATA >
INSTANCE A: INSTANCE B:
&lt;List Type="Numbered"> &lt;List Type="Numbered">
&lt;Item>Fee&lt;/item> &lt;Title>Fee Fie Foe Fum&lt;/item>
&lt;Item>Fie&lt;/item> &lt;Item>Fee&lt;/item>
&lt;Item>Foe&lt;/item> &lt;Item>Fie&lt;/item>
&lt;Item>Fum&lt;/item> &lt;Item>Foe&lt;/item>
&lt;/List> &lt;Item>Fum&lt;/item>
&lt;/List>
</literallayout>
</example>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect3>
<title id="n7ch3nlcwsaznuzs">絶対位置モデル</title>
<para>
<systemitem>SELECT</systemitem> ステートメントの <systemitem>"Position"</systemitem> キーワードを使用することにより、解析木におけるその絶対位置に基づいて、要素を選択することができます。
</para>
<para>
上で示した文書型定義フラグメントとドキュメント・インスタンス・フラグメントの例では、コンテント・モデルにより、オプションの Title 要素が可能ですが、インスタンス A では、オプションの Title 要素を使用していません。次に示すパスは、インスタンス A の最初の Item 要素を識別します。
</para>
<programlisting>
&lt;PATH> List &lt;Select>@Type == "Numbered"&lt;/Select> Item &lt;Select>position == 1 &lt;/Select>
&lt;/PATH>
</programlisting>
<para>
先行するパスが、インスタンス B のために使用されたとすれば、インフォメーション・マネージャは、最初の Item 要素を見つけることができません。なぜなら、その解析木における絶対位置は２番目であり、その直近の Title の後だからです。
</para>
<para>
次に示すパスは、インスタンス A の残りの Item 要素を選択します。
</para>
<programlisting>
&lt;PATH> List &lt;Select>@Type == "Numbered"&lt;/Select> Item &lt;Select>position != 1 &lt;/Select>
&lt;/PATH>
</programlisting>
<para>
先行するパスが、インスタンス B において使用されたとすれば、すべての Item 要素が一致することになります。
</para>
</sect3>
<!-- (((((((((((((((((((((((((((((((((((((((((((( -->
<sect3>
<title id="jrj3nlcbsaznuzs">相対位置モデル</title>
<para>
<systemitem>Select</systemitem> ステートメントの <systemitem>"Sibling"</systemitem> キーワードを使用することにより、解析木における類似の兄弟への相対的な位置に基づいて、要素を選択することができます。このモデルは、類似の要素グループにおいて、最初の要素と最後の要素を選択するための直接的なメソッドを提供します。
</para>
<para>
次に示すステートメントにより、インスタンス A あるいはインスタンス B のどちらかの最初の要素を識別することができます。
</para>
<programlisting>
&lt;PATH> List &lt;Select>@Type == "Numbered"&lt;/Select> Item &lt;Select> sibling == 1 &lt;/Select>
&lt;/PATH>
</programlisting>
<para>
次に示すパスは、両インスタンスの最後の Item 要素を識別します。
</para>
<programlisting>
&lt;PATH> List &lt;Select>@Type == "Numbered"&lt;/Select> Item &lt;Select> sibling == "#LAST" &lt;/Select>
&lt;/PATH>
</programlisting>
</sect3>
</sect2>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="n62r3nlcgsaznuzs">選択式のグループ化</title>
<para>
次に示す比較演算子を使用することにより、<systemitem>Select</systemitem> 式をグループ化して、最初でも最後でもない要素を識別することができます。
</para>
<itemizedlist>
<listitem>
<para>
&#38;&#38; -- 「論理積」演算子。
すべての式が真ならば、真です。
</para>
</listitem>
<listitem>
<para>
|| -- 「論理和」演算子。
いずれかの式が真ならば、真です。
</para>
</listitem>
</itemizedlist>
<para>
グループ化演算子が提供されていない場合でも、自然な左から右への論理は、類似の結果をもたらします。次に示すパスは、インスタンス B のための複合的な <systemitem>Select</systemitem> ステートメントを示しています。
</para>
<programlisting>
&lt;PATH> List &lt;Select>@Type == "Numbered"&lt;/Select> Item &lt;Select>sibling != 1 &#38;&#38; position != "#LAST" &lt;/Select>
&lt;/PATH>
</programlisting>
<para>
上で説明したように、<systemitem>Select</systemitem> ステートメントの内容は、位置または属性値のいずれかを指定することができます。そして、ひとつ以上の <systemitem>Select</systemitem> が、<systemitem>Path</systemitem> ステートメントにおいて（各要素名ごとにひとつ）出現することができます。次に、<systemitem>Select</systemitem> ステートメントの使用に関する他のガイドラインを示します。
</para>
<variablelist>
<varlistentry>
<term>position == <replaceable>n</replaceable></term>
<listitem>
<para>
要素の文字列における相対位置が、<replaceable>n</replaceable> に等しければ、その要素を選択します。たとえば、<userinput>position == 3</userinput> は、その位置が 3 に等しい要素を選択します。
先行する空白は必須であり、その後に <userinput>==</userinput> が続かなければなりません。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>position != <replaceable>n</replaceable></term>
<listitem>
<para>
要素の文字列における相対位置が、<replaceable>n</replaceable> に<emphasis>等しくなければ</emphasis>、その要素を選択します。たとえば、<userinput>position != 3</userinput> は、その位置が 3 に<emphasis>等しくない</emphasis>要素を選択します。
先行する空白は必須であり、その後に <userinput>!=</userinput> が続かなければなりません。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>@<replaceable>attribute</replaceable> == <replaceable>"string"</replaceable></term>
<listitem>
<para>
<replaceable>attribute</replaceable> が <replaceable>string</replaceable> に等しい要素を選択します。たとえば、<userinput>@label == "chapter"</userinput> は、値 "chapter" の Label 属性をもつ要素を選択します。
先行する空白は必須であり、その後に <userinput>==</userinput> が続かなければなりません。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>@<replaceable>attribute</replaceable> != "<replaceable>string</replaceable>"</term>
<listitem>
<para>
<replaceable>attribute</replaceable> が <replaceable>string</replaceable> に<emphasis>等しくない</emphasis>要素を選択します。たとえば、<userinput>@label != "chapter"</userinput> は、値 "chapter" <emphasis>でない</emphasis> Label 属性をもつ要素を選択します。
先行する空白は必須であり、その後に <userinput>!=</userinput> が続かなければなりません。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
次の例は、値 "chapter" の Label 属性をもつ Title 要素を指定します。
</para>
<programlisting>
&lt;Path> * title &lt;Select>@label == "chapter"&lt;/Select>
&lt;/Path>
</programlisting>
<note>
<para>
インフォメーション・マネージャは、ワイルドカードによる選択をサポートしていません。たとえば、<userinput>&lt;Path> * &lt;Select>@label == "Chapter" &lt;/Select>&lt;/Path></userinput> は、サポートしていません。
</para>
</note>
</sect2>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="zqw3nlcmsaznuzs">要素の階層構造と DTINFO.Section</title>
<para>
スタイル・シートにおいては、ソースの文書型定義によって定義される要素の階層構造が、フォーマットを必要とする唯一の要素の階層構造であるとは、必ずしも限りません。<systemitem>DTINFO.Section</systemitem> の設計様式が適用される各要素は、ユーザが指定しなければならない独立した要素の階層構造の根を形成します。すなわち、図 <link linkend="n1mievocfe0hp2ol">「単純なドキュメントの階層構造」</link> における要素のパスは、<systemitem>DTINFO.Section</systemitem> が Chapter 要素にのみ適用されていれば、真です。
</para>
<para>
しかしながら、<systemitem>DTINFO.Section</systemitem> が、Chapter と Section の両方に適用されると、Section 要素に含まれる Paragraph 要素のための最小限の一意なパスは、以下のようになります。
</para>
<programlisting>
&lt;Path> Section Paragraph
&lt;/Path>
</programlisting>
<para>
同様に、Chapter 要素に含まれる Paragraph 要素のためのパスは、以下のようになります。
</para>
<programlisting>
&lt;Path> Chapter Paragraph
&lt;/Path>
</programlisting>
</sect2>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<title id="pgqaykbbgsg24ak">継承の理解</title>
<para>
スタイル・シートの機能には、含んでいる親の要素から継承されるものもあります。以下に示す短いスタイル・シートの例が示すように、スタイル・シートが親または子の要素に別のフォーマット属性を指定するまで、子の要素は継承可能なフォーマット属性を表示します。親のスタイル指定が変更されると、そのすべての子の要素は、同じ変更を継承します。
</para>
<para>
例のスタイル・シートは、要素 SECT1、SECT1 TITLE、および PARA のための <systemitem>Path</systemitem> ステートメントを示しています。<systemitem>Font</systemitem>、<systemitem>Family</systemitem>、および <systemitem>Margin</systemitem> が SECT1 要素で設定され、SECT1 に含まれる別の要素（SECT1 TITLE と PARA）によって継承されることに注意してください。２番目の <systemitem>Path</systemitem> ステートメントでは、すべての SECT1 TITLE 要素のフォント・サイズおよびウェイトの値が、18-point、medium にリセットされています。これらの新規の値は、PARA が SECT1 の子であり SECT1 TITLE の子ではないため、PARA によって継承されません。
</para>
<example>
<title id="vpgq.occ50hp2ol">短いスタイル・シートの例</title>
<literallayout>
&lt;STYLESHEET Name=General>
&lt;path>
SECT1 &lt;/path>
&lt;Online>
&lt;Font Fallback=sans Weight=medium Slant=roman Size=14>
&lt;Family Name=helvetica Charset=iso8859-1>
&lt;Margin Left=20 Right=20 Top=30 Bottom=30>
&lt;/Online>
&lt;path> SECT1 TITLE &lt;/path>
&lt;Online>
&lt;Font Weight=bold Size=18>
&lt;/Online>
&lt;path>
PARA &lt;/path>
&lt;Online>
&lt;Linebreak both>
&lt;Layout ASpace=6 BSpace=6>
&lt;/Online>
&lt;/STYLESHEET>
</literallayout></example>
<para>
継承されるスタイル指定は、以下のとおりです。
</para>
<itemizedlist>
<listitem>
<para><link linkend="rrn5xmc0gwwa0yk">Font</link></para>
</listitem>
<listitem>
<para><link linkend="ujpipbbc3h9x3cs">HighLight</link></para>
</listitem>
<listitem>
<para><link linkend="djpipbbc3h9x3cs">Ignore</link></para>
</listitem>
<listitem>
<para><link linkend="jjpipbbc3h9x3cs">Layout</link></para>
</listitem>
<listitem>
<para><link linkend="xjpipbbc3h9x3cs">Margin</link></para>
</listitem>
<listitem>
<para><link linkend="n4kpipbbc3h9x3cs">Medium</link></para>
</listitem>
</itemizedlist>
<para>
継承されないスタイル指定は、以下のとおりです。
</para>
<itemizedlist>
<listitem>
<para><link linkend="dq2emncz70hp2ol">Border</link></para>
</listitem>
<listitem>
<para><link linkend="yrddmncb70hp2ol">Cell</link></para>
</listitem>
<listitem>
<para><link linkend="qjpipbbc3h9x3cs">ColFormat</link></para>
</listitem>
<listitem>
<para><link linkend="n0jpipbbc3h9x3cs">LineBreak</link>
</para>
</listitem>
<listitem>
<para><link linkend="r74dmncp70hp2ol">PageBreak</link></para>
</listitem>
<listitem>
<para><link linkend="n4llcmnc770hp2ol">Position</link></para>
</listitem>
<listitem>
<para><link linkend="n9kpipbbc3h9x3cs">Prefix and Suffix</link></para>
</listitem>
<listitem>
<para><link linkend="w9jdmnch70hp2ol">Row</link></para>
</listitem>
<listitem>
<para><link linkend="n0sodmncn70hp2ol">Table</link></para>
</listitem>
<listitem>
<para>TGroup</para>
</listitem>
</itemizedlist>
</sect1>
</chapter>

1595
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch08.sgm Normal file
View File

File diff suppressed because it is too large Load Diff

57
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch09.sgm Normal file
View File

@@ -0,0 +1,57 @@
<!-- $XConsortium: ch09.sgm /main/4 1996/10/11 09:24:29 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<Chapter id="infoapg.div.9">
<Title id="vSMTMZBRyng24aK">設計様式の理解</Title>
<IndexTerm><Primary>設計様式</Primary>
<Secondary>理解</Secondary></IndexTerm>
<Para>
インフォメーション・マネージャを使用して、SGML ドキュメントのセットから、インフォメーション・ライブラリのブックの集まりであるブックケースを構築します。これらのドキュメントの中には、スタイル・シートのように、SGML 文書型が、インフォメーション・マネージャとともに配布される SGML 文書型定義 (DTD) によって定義されるものがあります。他のものについては、ブックの内容のように、どのような文書型定義 (DTD) でも使用することが可能です。
</Para>
<Para>
多くの SGML アプリケーションが、さまざまな文書型定義の要素に付与されるべきセマンティクス理解の問題に直面します。これを処理するために、インフォメーション・マネージャは、設計様式を提供します。
</Para>
<Para>
設計様式は、あるアプリケーションによって統一的に処理されるべき要素を含むクラスに与えられる名前です。設計様式は、ベース・クラスを定義します。このとき、特定の文書型定義において定義される特定の SGML の要素は、サブクラスとして扱われます。設計様式を実装するには、インフォメーション・マネージャの設計様式と対応する標準の SGML 属性で、文書型定義を記述します。ほとんどの場合、設計様式は、<SystemItem>FIXED</SystemItem> キーワードを使用し、すべてのドキュメント中のすべての要素のインスタンスに特定の属性値を設定することによって、定義されます。
</Para>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<Sect1>
<Title id="kZLOUiBgsK9X3cS">設計様式の単純な例</Title>
<Para>
インフォメーション・マネージャがインフォメーションを正確に管理できるように、既存の文書型定義を修正しなければなりません。たとえば、インフォメーション・マネージャは、「タイトル (title)」を使用します。これにより、インフォメーション・マネージャの表示ウィンドウのさまざまなウィンドウに表示される内容を決定します。もちろん、どのような特定の文書型定義においても、タイトル・オブジェクトの汎用識別子の選択に制限はありません。これは、<SystemItem>head</SystemItem>、<SystemItem>h1</SystemItem>、<SystemItem>title</SystemItem> などのように呼ばれます。アプリケーションがこれらのタイトル・オブジェクトを識別できるようにするために、文書型定義に属性 <SystemItem>DTINFO.Title</SystemItem> を適用します。特定の要素が <SystemItem>head</SystemItem> という名前であるとした場合の例を次に示します。
</Para>
<ProgramListing>
&lt;!ELEMENT HEAD - - (PCDATA) >
&lt;!ATTLIST HEAD
DTINFO.Title NAME #FIXED "#CONTENT">
</ProgramListing>
<Para>
アプリケーションがドキュメントを処理しているとき、要素 <SystemItem>HEAD</SystemItem> の各インスタンスは、<SystemItem>DTINFO.Title</SystemItem> と名付けられた属性と関連付けられます。アプリケーションは、このことを認識することができ、タイトルがあるものとして要素の内容を処理することができます。
</Para>
<Note>
<Para>
設計様式の適用は、SGML インスタンスの検証性に影響を与えません。文書型定義への設計様式適用の詳細については、<Link Linkend="nWGeMZBc9og24aK">「設計様式の利用」</Link> を参照してください。
</Para>
</Note>
</Sect1>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<Sect1>
<Title id="zZLOUiBgsK9X3cS">設計様式のツールキット・モデルへの適合方法</Title>
<Para>
図 <Link Linkend="dPkT9aB7Wng24aK">「ツールキット・モデル」</Link> は、インフォメーションの異なる部分が、構築過程において、どのように対話するかを示しています。図　の共有領域は、設計様式を処理する構築の一部分を表現しています。
</Para>
<Figure>
<Title id="dPkT9aB7Wng24aK">ツールキット・モデル</Title>
<GRAPHIC id="gr53" entityref="infoapg.fig.9"></graphic>
</Figure>
<Para>
インフォメーション・マネージャによって提供される文書型定義の下におけるブックケース開発の詳細については、<Link Linkend="TcQg4bBSxI9X3cS">「ブックケース・ドキュメントの作成」</Link> を参照してください。<Filename>dtinfoStyle.dtd</Filename> に準拠するスタイル・シートのドキュメント作成の詳細については、<Link Linkend="btcmaab0ang24ak">「スタイル・シートの作成」</Link> を参照してください。
</Para>
</Sect1>
</Chapter>

859
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch10.sgm Normal file
View File

@@ -0,0 +1,859 @@
<!-- $XConsortium: ch10.sgm /main/4 1996/10/11 09:24:36 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<chapter id="infoapg.div.10">
<title id="nWGeMZBc9og24aK">設計様式の利用</title>
<indexterm><primary>文書型定義 (DTD)</primary>
<secondary>～への設計様式の適用</secondary></indexterm>
<para>
SGML ドキュメントは、特定の文書型定義 (DTD) に準拠します。インフォメーション・マネージャに文書型定義で定義された要素の処理方法を理解させるには、文書型定義の基本的な要素に属性を適用します。これらの属性は、インフォメーション・マネージャの設計様式に対応します。これらは、インフォメーション・マネージャが解釈し、ドキュメントからオンラインのライブラリを構築するセマンティクスです。
</para>
<note>
<para>
この節の例は、DocBook DTD のバージョン 2.2.1 のものです。
</para>
</note>
<para>
インフォメーション・マネージャの設計様式は、インフォメーション・マネージャにおけるドキュメントの編成モデルに基づいています。インフォメーション・マネージャは、インフォメーション・ライブラリをグループ化して、そのタイトルがハイパーテキスト目次になっているセクションのブックを含むブックケースにします。これには、表やグラフィックのような特定の要素へのアクセスが含まれます。
</para>
<para>
ブックケース、ブック、セクション、タイトル、リンク、表、およびグラフィックは、ブラウザがインフォメーションを管理するために識別しなければならない重要な要素の例です。インフォメーション・マネージャは、このような種類のインフォメーションのそれぞれに対応する設計様式を提供します。インフォメーション・マネージャでこれらを識別するには、文書型定義に対応する設計様式を適用します。特に、識別したい属性をもつ各要素に、属性を追加します。文書型定義の保守を容易にするには、インフォメーション・マネージャによって提供されるパラメータ・エンティティ参照を使用します。
</para>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<title id="VyBTVcBfQJ9X3cS">パラメータ・エンティティ参照の使用</title>
<para>
インフォメーション・マネージャは、インフォメーション・マネージャ設計様式を使用する簡易な（そして推奨の）方法として、パラメータ・エンティティ参照を提供します。インフォメーション・マネージャ設計様式のエンティティ名は、<filename>/usr/dt/infolib/&lt;lang>/SGML/dtinfo.af</filename> に格納されています。完全な属性を入力するのではなく、属性リストでパラメータ・エンティティ参照を使用することによって、文書型定義への変更を最少限にして、インフォメーション・マネージャの最新の機能を利用することができます。次に、例を示します。
</para>
<itemizedlist>
<listitem>
<para>
完全な属性を適用するには、次のようにします。
</para>
<literallayout>
&lt;!ELEMENT caption - - ((%inlinechar.gp;)+) >
&lt;!ATTLIST caption
%commonatts;
DTINFO.TITLE CDATA #FIXED &ldquo;#CONTENT&rdquo;
>
</literallayout>
</listitem>
<listitem>
<para>
パラメータ・エンティティ参照を使用するには、次のようにします。
</para>
<literallayout>
&lt;!ELEMENT caption - - ((%inlinechar.gp;)+) >
&lt;!ATTLIST caption
%commonatts;
%DTINFO.Title; &ldquo;#CONTENT&rdquo;
>
</literallayout>
</listitem>
</itemizedlist>
<para>
文書型定義の編集の詳細については、
<link linkend="EzilaaBwXng24aK">「設計様式の適用」</link>
<link linkend="fyBTVcBfQJ9X3cS">「DTINFO 設計様式の記述」</link> を参照してください。
</para>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<title id="fyBTVcBfQJ9X3cS">DTINFO 設計様式の記述</title>
<para>
設計様式の記述は、記述された設計様式と連携して共通に使用される関連様式を識別します。関連様式は、その対応する属性名を使用して、マニュアル中で識別されます。この節では、以下に示すことを説明します。
</para>
<itemizedlist>
<listitem><para><link linkend="orilaaBwXng24aK">「セクション様式」</link></para>
</listitem>
<listitem><para><link linkend="KtilaaBwXng24aK">「値様式」</link></para>
</listitem>
<listitem><para><link linkend="fsilaaBwXng24aK">「スコープ様式」</link></para>
</listitem>
<listitem><para><link linkend="nyilaaBwXng24aK">「ハイパーテキスト様式」</link></para>
</listitem>
<listitem><para><link linkend="draW.aB80og24aK">「スタイル様式」</link></para>
</listitem>
</itemizedlist>
<para>
目次、ブックケース規定、およびスクラッチのスタイル・シートの作成は容易ですが、既存のブックケース、スタイル・シート、および目次の文書型定義に、インフォメーション・マネージャの設計様式を適用することができます。詳細については、ブックケース様式、スタイル・シート様式、および <link linkend="S3CTVcBfQJ9X3cS">「目次の設計様式」</link> を参照してください。
</para>
<note>
<para>
これらの設計様式は、ほとんどの <command>dtinfogen</command> のサブコマンドの使用前に、適用しなければなりません。
</para>
</note>
<!--)))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="QnDu4iB6dmg24aK">値の理解</title>
<para>
データ値をとるインフォメーション・マネージャ設計様式では、単純な機能言語が、要素内容、属性値、およびリテラルの連携を形成する機構を提供します。引き数は、表 <link linkend="UtilaaBwXng24aK">「値の作成の構文」</link> で定義されています。
</para>
<table>
<Title id="UtilaaBwXng24aK">値の作成の構文</title>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colwidth="156*">
<colspec colwidth="372*">
<tbody>
<row>
<entry align="left" valign="top"><literal>構文</literal></entry>
<entry align="left" valign="top"><literal>意味</literal>
</entry>
</row>
<row>
<entry align="left" valign="top">attr()</entry>
<entry align="left" valign="top">attr() は引き数として使用される属性名の値を返します。IMPLIED 属性は、空の文字列を返します。attr() は、現在の要素についてのみ参照します。
</entry>
</row>
<row>
<entry align="left" valign="top">concat()</entry>
<entry align="left" valign="top">concat() は、文字列の引き数（リテラル、要素内容、属性値、または他の機能の値）を連結します。
</entry>
</row>
<row>
<entry align="left" valign="top">firstof()</entry>
<entry align="left" valign="top">firstof() は、その引き数中の最初の空でない文字列を返します。これは、その引き数によって定義される可能性の順序から値を選択します。
</entry>
</row>
<row>
<entry align="left" valign="top"><replaceable>要素名</replaceable>
</entry>
<entry align="left" valign="top"><replaceable>要素名</replaceable>は、現在の要素の内容モデルのメンバである要素の名前を、値として使用します。
</entry>
</row>
<row>
<entry align="left" valign="top"><replaceable>リテラル文字列</replaceable>
</entry>
<entry align="left" valign="top"><replaceable>リテラル文字列</replaceable>は、リテラル文字列指定するために、引用符 '...' または "..." のいずれかを使用します。
</entry>
</row>
<row>
<entry align="left" valign="top">#CONTENT</entry>
<entry align="left" valign="top">#CONTENT は、現在の要素内容のすべてを値として使用します。
</entry>
</row>
</tbody>
</tgroup>
</table>
<note>
<para>
表で説明されている構文を組み合わせて、値を作成することができます。また、必要に応じて、リテラル文字列を追加することもできます。
</para>
</note>
<para>
次に、設計様式で値を指定する例を示します。
</para>
<literallayout>
DTINFO.Title CDATA #FIXED
"concat( attr(Label), RefTitle, ManVolNum )"
DTINFO.Graphic CDATA #FIXED
"firstof( attr(Fileref), attr(Other), #CONTENT )"
</literallayout>
</sect2>
<!-- ))))))))))))))))))))))))))))))))))))))))))))))))))))))))))) -->
<sect2>
<title id="orilaaBwXng24aK">セクション様式</title>
<indexterm><primary>設計様式</primary>
<secondary>セクション様式</secondary></indexterm>
<para>
インフォメーション・マネージャに、SGML ファイルの構造を理解させるには、セクション設計様式を適用しなければなりません。様式の値の使用と意味は、その様式の型に依存します。たとえば、章のタイトルに指定されると、値はハイパーテキスト目次に表示されます。<systemitem>DTINFO.Graphic</systemitem> では、値はグラフィック・データを含むファイルの名前です。これらの関係性は、表 <link linkend="GiaW.aB80og24aK">「様式の値の意味」</link> で説明しています。
</para>
<table>
<title id="GiaW.aB80og24aK">様式の値の意味</title>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colwidth="160*">
<colspec colwidth="368*">
<tbody>
<row>
<entry align="left" valign="top"><literal>セクション様式</literal></entry>
<entry align="left" valign="top"><literal>値様式の意味、適用時</literal>
</entry>
</row>
<row>
<entry align="left" valign="top">DTINFO.Section</entry>
<entry align="left" valign="top">セクションの値は、インフォメーション・マネージャの表示ウィンドウに表示されるものです。デフォルト値は #CONTENT です。
</entry>
</row>
<row>
<entry align="left" valign="top">DTINFO.Title</entry>
<entry align="left" valign="top">DTINFO.Section のタイトルの値は、インフォメーション・マネージャのブック・リストに表示されます。
</entry>
</row>
<row>
<entry align="left" valign="top">DTINFO.Graphic</entry>
<entry align="left" valign="top">グラフィックの値は、グラフィック・データを含むファイル名です。この値は、エンティティ参照からも引き出されます。
</entry>
</row>
<row>
<entry align="left" valign="top">DTINFO.Ignore</entry>
<entry align="left" valign="top">この情報は、データベースあるいは 全テキスト索引 (FulText Index) に格納されません。（したがって表示されません。）
</entry>
</row>
<row>
<entry align="left" valign="top">DTINFO.ShortTitle</entry>
<entry align="left" valign="top">短縮タイトルの値は、表示ウィンドウにおいて、タイトルの一部分が切り詰められるところで使用されます。
</entry>
</row>
</tbody>
</tgroup>
</table>
<variablelist>
<varlistentry>
<term><systemitem>DTINFO.Section</systemitem></term>
<listitem>
<para>
<systemitem>DTINFO.Section</systemitem> 様式を、章のようなインフォメーションの一部分を分離するコンテナ要素に適用します。<systemitem>DTINFO.Section</systemitem> を使用して、インフォメーション・マネージャの表示ウィンドウに、インフォメーションの単位として、どの要素を表示するかを定義します。<command>dtinfogen</command> は、<systemitem>DTINFO.Section</systemitem> を使用して、階層構造を引き出すことができます。
</para>
<para>
エンティテ名: <systemitem>DTINFO.Section</systemitem>
</para>
<para>
属性テンプレート:
<systemitem>DTINFO.Section CDATA FIXED &ldquo;#CONTENT&rdquo;</systemitem>
</para>
<para>
関連様式:
<systemitem>DTINFO.ID</systemitem> (必須), <systemitem>DTINFO.Scope</systemitem>, <systemitem>DTINFO.ShortTitle</systemitem>, <systemitem>DTINFO.Style</systemitem>, <systemitem>DTINFO.Title</systemitem> (必須), <systemitem>DTINFO.Value</systemitem></para>
<para>
例:
</para>
<literallayout>
&lt;!ELEMENT Preface - - (DocInfo?, Title, TitleAbbrev?, (%sect1.gp;)) >
&lt;!ATTLIST Preface
%commonatts;
%DTINFO.Section; &ldquo;#CONTENT&rdquo;
%DTINFO.Style; &ldquo;sty1&rdquo;
%DTINFO.Title; &ldquo;#CONTENT&rdquo;
%DTINFO.ID; &ldquo;attr(id)&rdquo;
>
</literallayout>
</listitem>
</varlistentry>
<varlistentry><term><systemitem>DTINFO.Title</systemitem></term>
<listitem>
<para>
通常は、章のタイトル、ヘッダ、キャプション、図のタイトル、表のタイトル、および例のタイトルなど、どのようなタイトルであっても <systemitem>DTINFO.Title</systemitem> を適用します。
</para>
<para>
エンティティ名: <systemitem>DTINFO.Title</systemitem>
</para>
<para>
属性テンプレート: <systemitem>DTINFO.Title CDATA #FIXED</systemitem>
</para>
<para>
関連様式: <systemitem>DTINFO.Scope</systemitem>, <systemitem>DTINFO.Value</systemitem></para>
<para>
例:
</para>
<literallayout>
&lt;!ELEMENT RefMeta - - (RefEntryTitle, ManVolNum?,RefMiscInfo*) >
&lt;!ATTLIST RefMeta
%commonatts;
%DTINFO.Title; #&ldquo;CONTENT&rdquo;
%DTINFO.Value; &ldquo;concat( RefEntryTitle, ManVolNum)&rdquo;
>
</literallayout>
</listitem>
</varlistentry>
<varlistentry>
<term><systemitem>DTINFO.ShortTitle</systemitem></term>
<listitem>
<para>
既存の文書型定義にタイトルの省略形があれば、その要素に <systemitem>DTINFO.ShortTitle</systemitem> を適用します。この要素の内容は、決して表示ウィンドウに表示されませんが、ダイアログのリスト項目として現われる可能性があります。内容は、全テキスト索引 (FulText Index) に現われません。
</para>
<para>
エンティティ名: <systemitem>DTINFO.ShortTitle</systemitem></para>
<para>
属性テンプレート: <systemitem>DTINFO.ShortTitle CDATA #FIXED</systemitem></para>
<para>
関連様式: <systemitem>DTINFO.Value</systemitem></para>
<para>
例:
</para>
<literallayout>
&lt;!ELEMENT TitleAbbrev - - ((%inlinechar.gp;)+) >
&lt;!ATTLIST TitleAbbrev
%commonatts;
%DTINFO.ShortTitle; &ldquo;#CONTENT&rdquo;
>
</literallayout>
</listitem>
</varlistentry>
<varlistentry>
<term><systemitem>DTINFO.Graphic</systemitem></term>
<listitem>
<para>
グラフィック、数学の式、またはある種の表を指示する要素に <systemitem>DTINFO.Graphic</systemitem> を適用します。
</para>
<para>
エンティティ名: <systemitem>DTINFO.Graphic</systemitem></para>
<para>
属性テンプレート: <systemitem>DTINFO.Graphic CDATA #FIXED</systemitem></para>
<para>
関連様式: <systemitem>DTINFO.Scope</systemitem>, <systemitem>DTINFO.ID</systemitem>.</para>
<para>
例:
</para>
<literallayout>
&lt;!ELEMENT Graphic - - CDATA>
&lt;!ATTLIST Graphic
Entityref ENTITY #IMPLIED
Fileref CDATA #IMPLIED
Format NOTATION
%notationtypes; #IMPLIED
Id ID #IMPLIED
%DTINFO.Graphic; &ldquo;#CONTENT&rdquo;
%DTINFO.ID; &ldquo;:attr( ID )&rdquo;
%DTINFO.Scope.Graphic;
></literallayout>
</listitem>
</varlistentry>
<!-- ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((-->
<VARLISTENTRY>
<Term><SystemItem>DTINFO.Table</SystemItem></Term>
<listitem>
<para>
<comment>We may not support DTINFO.Table - so it may be commented
out in future documentation.</comment>
CALS の表モデルにしたがって、SGML でエンコードされた表を指示する要素は、<SystemItem>DTINFO.Table</SystemItem> 属性を受け付けるべきです。そうでなければ、<SystemItem>DTINFO.Graphic</SystemItem> を受け付けるべきです。
</para>
<para>
エンティティ名: <SystemItem>DTINFO.Table</SystemItem></para>
<para>
属性テンプレート: <SystemItem>DTINFO.Table CDATA #FIXED</SystemItem></para>
<para>
関連様式: <SystemItem>Scope.Table</SystemItem></para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT InformalTable - - ((%tblcontent.gp;)) -(Table|InformalTable)&gt;
&lt;!ATTLIST InformalTable
%commonatts;
Colsep %yesorno; #IMPLIED
Frame (Top|Bottom|Topbot|All|Sides|None) #IMPLIED
Orient (Port | Land) #IMPLIED
Pgwide %yesorno; #IMPLIED
Rowsep %yesorno; #IMPLIED
Tabstyle NMTOKEN #IMPLIED
%DTINFO.Table; &ldquo;#CONTENT&rdquo;
%DTINFO.Scope.Table;
&gt;
</LITERALLAYOUT>
</ListItem>
</VarListEntry>
<varlistentry>
<term><systemitem>DTINFO.Ignore</systemitem></term>
<listitem>
<para>
表示したくないインフォメーションを含む要素に <systemitem>DTINFO.Ignore</systemitem> を適用します。要素に有用なハイパーテキスト・インフォメーションがある場合は、構築過程において使用されます。たとえば、<systemitem>DTINFO.Value</systemitem> を指定して、ハイパーテキストの値を作成することができます。
</para>
<para>
エンティティ名: <systemitem>DTINFO.Ignore</systemitem></para>
<para>
属性テンプレート: <systemitem>DTINFO.Ignore CDATA #FIXED</systemitem></para>
<para>
関連様式: <systemitem>DTINFO.Value</systemitem></para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT InternalComment - - ((%inlinechar.gp;)+)>
&lt;!ATTLIST InternalComment
%DTINFO.Ignore; &ldquo;#CONTENT&rdquo;
%DTINFO.Value; &ldquo;#CONTENT&rdquo;
>
</literallayout>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect2>
<title id="KtilaaBwXng24aK">値様式</title>
<indexterm><primary>設計様式</primary>
<secondary>セクションの値様式</secondary></indexterm>
<para>
<systemitem>DTINFO.Value</systemitem> 様式は、設計様式の戻り値を定義します。<systemitem>DTINFO.Value</systemitem> は、最上位の要素への値を返します。たとえば、要素 <replaceable>foo</replaceable> が内容モデル <replaceable>a?</replaceable>、<replaceable>b</replaceable> をもち、<replaceable>foo</replaceable> は設計様式 <systemitem>DTINFO.Title firstof &ldquo;(a,b)&rdquo;</systemitem> を使用する、と仮定しましょう。<replaceable>a</replaceable> の値は、その <systemitem>Label</systemitem> 属性とその内容を連結することによって形成されます。この形成は、<systemitem>DTINFO.Value</systemitem> を使用して処理し、<replaceable>foo</replaceable> に与えることができます。
</para>
<para>
値設計様式は、以下のとおりです。
</para>
<variablelist>
<varlistentry>
<term><systemitem>DTINFO.Value</systemitem></term>
<listitem>
<para>
<systemitem>DTINFO.Value</systemitem> 属性は、設計様式の戻り値を指定します。<systemitem>DTINFO.Value</systemitem> の値は、値として使用されるストリームを作成する機能言語です。値は、暗黙の連結の様式をとります。引き数は、表 <link linkend="UtilaaBwXng24aK">「値の作成の構文」</link> で定義しています。
</para>
<para>
エンティティ名: <systemitem>DTINFO.Value</systemitem></para>
<para>
属性テンプレート: <systemitem>DTINFO.Value CDATA #FIXED &ldquo; <replaceable>Value</replaceable>&rdquo;</systemitem></para>
<para>
関連様式: すべてのセクション様式</para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT RefMeta - - (RefEntryTitle, ManVolNum?,RefMiscInfo*) >
&lt;!ATTLIST RefMeta
%commonatts;
%DTINFO.Title;
%DTINFO.Value; &ldquo;concat( RefEntryTitle,'(`,
ManVolNum,')')&rdquo;
>
</literallayout>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="fsilaaBwXng24aK">スコープ様式</title>
<indexterm><primary>設計様式</primary>
<secondary>スコープ様式</secondary></indexterm>
<para>
インフォメーション・マネージャでは、ユーザが検索の範囲を定義することができます。どのブックを検索範囲に含めるかブラウザに指示したり、ブック、テキスト本体、例、索引、グラフィック、表、タイトル、またはそれらの組み合わせから成るすべてのコンポーネントの検索可否を指定したりすることができます。スコープ設計様式は、インフォメーション・マネージャの検索範囲に、どの要素を含めるかを決定します。たとえば、全テキスト索引 (FulText Index) 内で、どのスコープ情報に索引を付与するかを決定します。スコープは、<systemitem>DTINFO.Scope</systemitem> が適用される要素内に含まれるどのような要素にも適用されます。
</para>
<para>
スコープ様式を要素に適用するには、<systemitem>DTINFO.Scope</systemitem> 属性を５種類の値のいずれかで適用します。要素にスコープ様式を適用しない場合、データはデフォルトのスコープ <systemitem>Body Text</systemitem> をもちます。
</para>
<para>
<systemitem>DTINFO.Scope</systemitem> として指定可能な値は、Example、Graphic、Index、Table および Title であり、次に示すエンティティによって表現されます。
</para>
<variablelist>
<varlistentry><term><systemitem>DTINFO.Scope.Example</systemitem></term>
<listitem>
<para>
<systemitem>DTINFO.Scope</systemitem> 属性を、値 <systemitem>Example</systemitem> で、例をその一部とする検索範囲に含めたいデータをもつ要素に適用します。
</para>
<para>
エンティティ名: <systemitem>DTINFO.Scope.Example</systemitem></para>
<para>
属性テンプレート: <systemitem>DTINFO.Scope Name #FIXED Example</systemitem></para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT Example - - (Title, TitleAbbrev?, (%para.gp; |
%list.gp; | %object.gp;)+) >
&lt;!ATTLIST Example
%commonatts;
Label CDATA #IMPLIED
%DTINFO.Scope.Example;
>
</literallayout>
</listitem>
</varlistentry>
<varlistentry>
<term><systemitem>DTINFO.Scope.Graphic</systemitem></term>
<listitem>
<para>
<systemitem>DTINFO.Scope</systemitem> 属性を、値 <systemitem>Graphic</systemitem> で、グラフィックをその一部とする検索範囲に含めたい要素に適用します。この設計様式により、あるグラフィック型の内部に含まれるどのような文字列も、検索による抽出および索引付けが可能になります。
</para>
<para>
エンティティ名: <systemitem>DTINFO.Scope.Graphic</systemitem></para>
<para>
属性テンプレート: <systemitem>DTINFO.Scope Name #FIXED Graphic</systemitem></para>
<para>
関連様式: <systemitem>DTINFO.Graphic</systemitem>, <systemitem>DTINFO.ID</systemitem>, <systemitem>DTINFO.Value</systemitem></para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT Graphic - - CDATA>
&lt;!ATTLIST Graphic
Entityref ENTITY #IMPLIED
Fileref CDATA #IMPLIED
Format NOTATION
%notationtypes #IMPLIED
Id ID #IMPLIED
%DTINFO.Graphic;
%DTINFO.ID; &ldquo;attr( Id )&rdquo;
%DTINFO.Scope.Graphic;
%DTINFO.Value; &ldquo;attr( Fileref )&rdquo;
>
</literallayout>
</listitem>
</varlistentry>
<varlistentry><term><systemitem>DTINFO.Scope.Index</systemitem></term>
<listitem>
<para>
<systemitem>DTINFO.Scope</systemitem> 属性を、値 <systemitem>Index</systemitem> で、索引をその一部とする検索範囲に含めたい要素に適用します。
</para>
<para>
エンティティ名: <systemitem>DTINFO.Scope.Index</systemitem></para>
<para>
属性テンプレート: <systemitem>DTINFO.Scope Name #FIXED Index</systemitem></para>
<para>
関連様式: <systemitem>DTINFO.Section</systemitem></para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT (SetIndex | Index) - - (DocInfo?, (Title,
TitleAbbrev?)?, (%component.gp;)*, (IndexDiv+ |
IndexEntry+)) >
&lt;!ATTLIST (SetIndex | Index)
%commonatts;
%DTINFO.Section;
DTINFO.Scope.Index;
>
</literallayout>
</listitem>
</varlistentry>
<varlistentry><term><systemitem>DTINFO.Scope.Table</systemitem></term>
<listitem>
<para>
<systemitem>
DTINFO.Scope</systemitem> 属性を、値 <systemitem>Table</systemitem> で、表をその一部とする検索範囲に含めたい要素に適用します。この設計様式により、CALS SGML の表モデル内部のどのような文字列にも検索のための索引付けが行われます。
</para>
<para>
エンティティ名: <systemitem>DTINFO.Scope.Table</systemitem>
</para>
<para>
属性テンプレート: <systemitem>DTINFO.Scope Name #FIXED Table</systemitem>
</para>
<para>
関連様式: <systemitem>DTINFO.Table</systemitem></para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT InformalTable - - ((%tblcontent.gp;)) -(Table|InformalTable)>
&lt;!ATTLIST InformalTable
%commonatts;
Colsep %yesorno; #IMPLIED
Frame (Top|Bottom|Topbot|All|Sides|None) #IMPLIED
Orient (Port | Land) #IMPLIED
Pgwide %yesorno; #IMPLIED
Rowsep %yesorno; #IMPLIED
Tabstyle NMTOKEN #IMPLIED
%DTINFO.Table;
%DTINFO.Scope.Table;
></literallayout>
</listitem>
</varlistentry>
<varlistentry><term><systemitem>DTINFO.Scope.Title</systemitem></term>
<listitem>
<para>
<systemitem>DTINFO.Scope</systemitem> 属性を、値 <systemitem>Title</systemitem> で、タイトルをその一部とする検索範囲に含めたい要素に適用します。
</para>
<para>
エンティティ名: <systemitem>DTINFO.Scope.Title</systemitem></para>
<para>
属性テンプレート: <systemitem>DTINFO.Scope Name #FIXED Title</systemitem></para>
<para>
関連様式: <systemitem>DTINFO.Title</systemitem>,
<systemitem>DTINFO.Value</systemitem></para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT RefMeta - - (RefEntryTitle, ManVolNum?, RefMiscInfo*) >
&lt;!ATTLIST RefMeta
%commonatts;
%DTINFO.Title;
%DTINFO.Scope.Title;
%DTINFO.Value; &ldquo;concat( RefEntryTitle, ManVolNum)&rdquo;
>
</literallayout>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="nyilaaBwXng24aK">ハイパーテキスト様式</title>
<indexterm><primary>設計様式</primary>
<secondary>ロケーション様式</secondary></indexterm>
<para>
ハイパーテキスト設計様式に対応する属性は、<systemitem>DTINFO.ID</systemitem> と <systemitem>DTINFO.IDREF</systemitem> です。これらの属性への値の設定については、表 <link linkend="UtilaaBwXng24aK">「値の作成の構文」</link> を参照してください。
</para>
<note>
<para>
SGML 参照の具体的な構文は、<systemitem>DTINFO.ID</systemitem> と <systemitem>DTINFO.IDREF</systemitem> の値が、1024文字を超えてはならず、英数字で始まらなければならない、と規定しています。
</para>
</note>
<variablelist>
<varlistentry><term><systemitem>DTINFO.ID</systemitem></term>
<listitem>
<para>
<systemitem>DTINFO.ID</systemitem> 属性を、リンク先を指定する要素に適用します。
</para>
<para>
エンティティ名: <systemitem>DTINFO.ID</systemitem></para>
<para>
属性テンプレート: <systemitem>DTINFO.ID CDATA #FIXED &ldquo;<replaceable>Value</replaceable>&rdquo;</systemitem></para>
<para>
関連様式: すべて</para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT Anchor - O EMPTY >
!ATTLIST Anchor
Id ID #REQUIRED
Pagenum CDATA #IMPLIED
Remap CDATA #IMPLIED
Role CDATA #IMPLIED
XRefLabel CDATA #IMPLIED
%DTINFO.ID; &ldquo;attr( Id )&rdquo;
>
</literallayout>
<note>
<para>
各 <systemitem>DTINFO.ID</systemitem> の値は一意でなければなりません。
</para>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term><systemitem>DTINFO.IDREF</systemitem></term>
<listitem>
<para>
<systemitem>DTINFO.IDREF</systemitem> 属性を、<systemitem>DTINFO.IDREF</systemitem> の値として指定された位置へ移動するためのホット・スポットとして使用されるデータを含む要素に適用します。
</para>
<para>
エンティティ名: <systemitem>DTINFO.IDREF</systemitem>
</para>
<para>
属性テンプレート: <systemitem>DTINFO.IDREF CDATA #FIXED &ldquo;<replaceable>Value</replaceable>&rdquo;</systemitem></para>
<para>
関連様式: すべて</para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT Link - - ((%inlinechar.gp;)+) >
&lt;!ATTLIST Link
Endterm IDREF #IMPLIED
Linkend IDREF #REQUIRED
Type CDATA #IMPLIED
%DTINFO.IDREF; &ldquo;attr( Linkend )&rdquo;
>
</literallayout>
<note>
<para>
<systemitem>DTINFO.IDREF</systemitem> の値は、既存の <systemitem>DTINFO.ID</systemitem> の値にすべきです。
</para>
</note>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect2>
<title id="draW.aB80og24aK">スタイル様式</title>
<indexterm><primary>設計様式</primary>
<secondary>スタイル様式</secondary></indexterm>
<para>
スタイル設計様式に対応する属性は、以下のとおりです。
</para>
<variablelist>
<varlistentry>
<term><systemitem>DTINFO.Style</systemitem></term>
<listitem>
<para>
インフォメーション・マネージャ設計様式、<systemitem>DTINFO.Style</systemitem> を、すでに構造様式 <systemitem>DTINFO.Section</systemitem> を適用し、その継承されたスタイル・シートを上書きしたい要素に適用します。
<systemitem>DTINFO.Style</systemitem> は、<systemitem>DTINFO</systemitem> 設計様式である <systemitem>Bookcase</systemitem>、<systemitem>Book</systemitem> および <systemitem>DTINFO.Section</systemitem> の要素にのみ使用することができます。
</para>
<para>
<systemitem>DTINFO.Style</systemitem> の値は、スタイル・シートの名前（スタイル・シートの <systemitem>DTINFO.ID</systemitem> 設計様式の値）であり、ブックケース規定ドキュメントで指定されたスタイル・シートとして解決されなければなりません。スタイル・シートは、それらが新規のスタイル・シートで上書きされない限り、すべての副次的なセクションによって継承されなければなりません。
</para>
<note>
<para>
<systemitem>DTINFO.Style</systemitem> の内容はスタイル・シート名のIDと一致する文字列（要素ではない）であるため、<userinput>%DTINFO.Style; &ldquo;&lsquo;sty1&rsquo;&rdquo;</userinput> または様式 <userinput>%DTINFO.Style &ldquo;concat(&lsquo;sty1&rsquo;)&rdquo;</userinput> のように、２回引用符で囲まなければなりません。
</para>
</note>
<para>
エンティティ名: <systemitem>DTINFO.Style</systemitem>
</para>
<para>
属性テンプレート:
<systemitem>DTINFO.Style CDATA #FIXED &ldquo;<replaceable>Value</replaceable>&rdquo;</systemitem></para>
<para>
関連様式: <systemitem>DTINFO.Section</systemitem></para>
<para>
例:</para>
<literallayout>
&lt;!ELEMENT Preface - - (DocInfo?, Title, TitleAbbrev?, (%sect1.gp;)) >
&lt;!ATTLIST Preface
%commonatts;
%DTINFO.Section;
%DTINFO.Style; &ldquo;&lsquo;sty1&rsquo;&rdquo;
>
</literallayout>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<title id="EzilaaBwXng24aK">設計様式の適用</title>
<indexterm><primary>設計様式</primary>
<secondary>既存の文書型定義への適用</secondary></indexterm>
<para>
ここで説明する手続きによって、文書型定義に設計様式を適用します。文書型定義の要素に設計様式を適用する時期については、<link linkend="fyBTVcBfQJ9X3cS">「DTINFO 設計様式の記述」</link> を参照してください。
</para>
<note>
<para>
設計様式の属性の適用は、ドキュメント・インスタンスを無効にするわけではなく、ドキュメント・インスタンスの修正も必要としません。
</para>
</note>
<orderedlist>
<listitem>
<para>
文書型定義の先頭で、エンティティ宣言を追加し、インフォメーション・マネージャ設計様式のステートメントを使用します。
</para>
<literallayout>
&lt;!ENTITY % DOCBOOK PUBLIC
&ldquo;-//Common Desktop Environment//ENTITIES DtInfo Architectural Forms//EN&rdquo;
>
%DOCBOOK;
</literallayout>
</listitem>
<listitem>
<para>
文書型定義を解析し、何を表示したいのかを理解します。
</para>
</listitem>
<listitem>
<para>
コンテナ要素およびそれぞれに対応する <link linkend="orilaaBwXng24aK">「セクション様式」</link> を識別します。たとえば、図のキャプションの要素は、<systemitem>Title</systemitem> 様式に対応します。
</para>
</listitem>
<listitem>
<para>
修正している要素の属性リストにおいて、パラメータ・エンティティ参照または完全な属性を入力します。
</para>
<para>
パラメータ・エンティティ参照を使用します。
</para>
<literallayout>
&lt;!ELEMENT caption - - ((%inlinechar.gp;)+) >
&lt;!ATTLIST caption
%commonatts;
%DTINFO.Title; &ldquo;#CONTENT&rdquo;
>
</literallayout>
<para>
To use the complete attribute:
</para>
<literallayout>
&lt;!ELEMENT caption - - ((%inlinechar.gp;)+) >
&lt;!ATTLIST caption
%commonatts;
DTINFO.Title CDATA #FIXED &ldquo;#CONTENT&rdquo;
>
</literallayout>
<note>
<para>
設計様式のなかには、関連する様式を必須とするものがあります。たとえば、<systemitem>DTINFO.Section</systemitem> 様式には、<systemitem>DTINFO.Title</systemitem> と <systemitem>DTINFO.ID</systemitem> が必須です。詳細については、<link linkend="fyBTVcBfQJ9X3cS">「DTINFO 設計様式の記述」</link> を参照してください。
</para>
</note>
</listitem>
<listitem>
<para>
対象とする要素について、<link linkend="nyilaaBwXng24aK">「ハイパーテキスト様式」</link> を適用するかどうかを決定します。
</para>
<literallayout>
&lt;!ELEMENT Graphic - - CDATA>
&lt;!ATTLIST Graphic
Entityref ENTITY #IMPLIED
Fileref CDATA #IMPLIED
Format NOTATION
%notationtypes #IMPLIED
Id ID #IMPLIED
%DTINFO.Graphic;
%DTINFO.ID; &ldquo;attr( Id )&rdquo;
>
</literallayout>
<note>
<para>
最低限、
<systemitem>DTINFO.Section</systemitem>、
<systemitem>DTINFO.Title</systemitem>、および
<systemitem>DTINFO.ID</systemitem> 様式
を適用した後、ブックケースを構築することができます。
</para>
</note>
</listitem>
<listitem>
<para>
対象とする要素について、<link linkend="KtilaaBwXng24aK">「データ様式」</link> を適用するかどうかを決定します。
</para>
<literallayout>
&lt;!ELEMENT Graphic - - CDATA>
&lt;!ATTLIST Graphic
Entityref ENTITY #IMPLIED
Fileref CDATA #IMPLIED
Format NOTATION
%notationtypes #IMPLIED
Id ID #IMPLIED
%DTINFO.Graphic;
%DTINFO.ID; &ldquo;attr( Id )&rdquo;
%DTINFO.Value; &ldquo;attr( Fileref )&rdquo;
>
</literallayout>
</listitem>
<listitem>
<para>
対象とする要素について、<link linkend="fsilaaBwXng24aK">「スコープ様式」</link> を適用するかどうかを決定します。
</para>
<literallayout>
&lt;!ELEMENT Graphic - - CDATA>
&lt;!ATTLIST Graphic
Entityref ENTITY #IMPLIED
Fileref CDATA #IMPLIED
Format NOTATION
%notationtypes #IMPLIED
Id ID #IMPLIED
%DTINFO.Graphic;
%DTINFO.Scope.Graphic;
%DTINFO.ID; &ldquo;attr( Id )&rdquo;
%DTINFO.Value; &ldquo;attr( Fileref )&rdquo;
>
</literallayout>
</listitem>
<listitem>
<para>
<systemitem>DTINFO.Section</systemitem> 設計様式を適用した要素について、このセクションによって継承されたものではないスタイル・シートを使用するかどうかを決定します。別のスタイル・シートを使用するには、<link linkend="draW.aB80og24aK">「スタイル様式」</link> を適用します。
</para>
<literallayout>
&lt;!ELEMENT Preface - - (DocInfo?, Title, TitleAbbrev?, (%sect1.gp;)) >
&lt;!ATTLIST Preface
%commonatts;
%DTINFO.Section;
%DTINFO.Style; &ldquo;sty1&rdquo;
>
</literallayout>
</listitem>
<listitem>
<para>
設計様式を必要とする各要素について、手順４から７を繰り返します。
</para>
</listitem>
</orderedlist>
</sect1>
</chapter>

121
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/ch11.sgm Normal file
View File

@@ -0,0 +1,121 @@
<!-- $XConsortium: ch11.sgm /main/4 1996/10/11 09:24:44 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<chapter id="infoapg.div.11">
<Title id="S3CTVcBfQJ9X3cS">目次の設計様式</Title>
<IndexTerm><Primary>設計様式</Primary>
<Secondary>目次</Secondary></IndexTerm>
<Para>
すでに SGML フォーマットの目次ドキュメント・インスタンスがある場合は、新規の目次を作成する必要はありません。代わりに、既存の目次の文書型定義の要素にインフォメーション・マネージャ設計様式を適用して、インフォメーション・マネージャに目次情報の処理方法を指示することができます。
</Para>
<Note>
<Para>
インフォメーション・マネージャの <Filename>dtinfoTOC.dtd</Filename> に準拠する SGML 目次作成の詳細については、<Link Linkend="n8aJ92dBIsI9X3cS">「目次の作成」</Link> を参照してください。
</Para>
</Note>
<Para>
次に示す属性を、既存の目次の文書型定義に追加することができます。
</Para>
<VariableList>
<VarListEntry>
<Term><SystemItem>DTINFO.TOC</SystemItem></Term>
<ListItem>
<Para>
<SystemItem>DTINFO.TOC</SystemItem> を目次を指示する要素に適用します。
</Para>
<Para>
エンティティ名: <SystemItem>DTINFO.TOC</SystemItem>
</Para>
<Para>
属性テンプレート:
<SystemItem>DTINFO.TOC CDATA #FIXED</SystemItem>
</Para>
<Para>
関連様式:
<SystemItem>DTINFO.Scope</SystemItem>
<SystemItem>DTINFO.Value</SystemItem>
<SystemItem>DTINFO.ID</SystemItem>
</Para>
<Para>
例:
</Para>
<LiteralLayout>
&lt;!ELEMENT TOC - - ( Title, TitleAbbrev?, TOCfront*,
(TOCpart+ | TOCchap+), TOCback* ) &gt;
&lt;!ATTLIST TOC
Id ID #REQUIRED
%DTINFO.TOC; &ldquo;&num;CONTENT&rdquo;
%DTINFO.ID; &ldquo;attr( Id )&rdquo;--&gt;
&gt;
</LiteralLayout>
<Comment><SystemItem>DTINFO.TOCEntry</SystemItem></Comment>
<Para>
<SystemItem>DTINFO.TOCEntry</SystemItem> を、ブックの目次のエントリを指す要素に適用します。
</Para>
<Para>
エンティティ名: <SystemItem>DTINFO.TOCEntry</SystemItem>
</Para>
<Para>
属性名:
<SystemItem>DTINFO.TOCEntry CDATA #FIXED</SystemItem>
</Para>
<Para>
関連様式:
<SystemItem>DTINFO.Scope</SystemItem>
<SystemItem>DTINFO.Value</SystemItem>
<SystemItem>DTINFO.ID</SystemItem>
</Para>
<Para>
例:
</Para>
<LiteralLayout>
&lt;!ELEMENT TOCpart - - ( TOCentry+, TOCchap* ) &gt;
&lt;!ATTLIST TOCpart
Id ID #IMPLIED
%DTINFO.ID; &ldquo;attr( Id )&rdquo;
%DTINFO.TOCEntry; #CONTENT&rdquo;
&gt;
</LiteralLayout>
<Comment><SystemItem>DTINFO.TOCLevel</SystemItem></Comment>
<PARA>
<SystemItem>DTINFO.TOCLevel</SystemItem> を、ブックの目次のエントリを指す要素に適用します。
</PARA>
<PARA>
エンティティ名:
<SystemItem>DTINFO.TOCLevel</SystemItem></PARA>
<PARA>
属性テンプレート:
<SystemItem>DTINFO.TOCLevel CDATA &num;FIXED
</SystemItem></PARA>
<PARA>
関連様式:
<SystemItem>DTINFO.Scope</SystemItem>
<SystemItem>DTINFO.Value</SystemItem>
<SystemItem>DTINFO.ID</SystemItem>
</PARA>
<PARA>
例:
</PARA>
<LITERALLAYOUT>
&lt;!ELEMENT TOCpart - - ( TOCentry+, TOCchap* ) &gt;
&lt;!ATTLIST TOCpart
Id ID #IMPLIED
%DTINFO.ID; &ldquo;attr( Id )&rdquo;
%DTINFO.TOCLevel;
&gt;
</LiteralLayout>
</ListItem>
</VarListEntry>
</VariableList>
</Chapter>

171
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/glossary.sgm Normal file
View File

@@ -0,0 +1,171 @@
<!-- $XConsortium: glossary.sgm /main/2 1996/09/22 15:10:34 rws $ -->
<!-- (c) Copyright 1996 Digital Equipment Corporation. -->
<!-- (c) Copyright 1996 Hewlett-Packard Company. -->
<!-- (c) Copyright 1996 International Business Machines Corp. -->
<!-- (c) Copyright 1996 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1996 Novell, Inc. -->
<!-- (c) Copyright 1996 FUJITSU LIMITED. -->
<!-- (c) Copyright 1996 Hitachi. -->
<Glossary Id="sz6BJNB1DI9X3cS">
<Title>用語集</Title>
<GlossEntry>
<GlossTerm>GUI</GlossTerm>
<glossdef>
<para>
Graphical User Interface の省略形です。アプリケーションのルック＆フィールです。
</para>
</glossdef>
</GlossEntry>
<Glossentry><GlossTerm>SGML</GlossTerm>
<glossdef>
<para>
Standard Generalized Markup Language (ISO 8879) の省略形です。
SGML は、インフォメーション・マネージャのドキュメントの入力と格納のフォーマットです。
</para>
</glossdef>
</Glossentry>
<GlossEntry>
<GlossTerm>dtinfogen</GlossTerm>
<glossdef>
<para>
オンライン・ドキュメントのコンパイルと表示のシステムです。
</para>
</glossdef>
</GlossEntry>
<Glossentry>
<GlossTerm>インフォメーション・マネージャ</GlossTerm>
<glossdef>
<para>
ドキュメントの入力、作成、マークアップ、および表示のための統括的なシステムです。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>インフォメーション・ライブラリ</GlossTerm>
<glossdef>
<para>
インフォメーション・マネージャのライブラリで入手可能なオンライン・ブックケースの完全なセットです。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>修正された文書型定義</GlossTerm>
<glossdef>
<para>
設計様式が適用されたドキュメント・ソースのための文書型定義です。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>スタイル・シート</GlossTerm>
<glossdef>
<para>
オンライン表示と印刷のためのドキュメントの出力形式を定義するファイルです。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>セクション</GlossTerm>
<glossdef>
<para>
表示ウィンドウ内に表示されるドキュメントのひとつの単位です。平均すると、セクションは１画面または２画面の表示量であり、数画面以上を占めることは通常ありません。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>設計様式</GlossTerm>
<glossdef>
<para>
SGML 要素のクラスまたは属性のセットのためのテンプレートです。
</para>
</glossdef>
</Glossentry>
<GlossEntry>
<GlossTerm>属性</GlossTerm>
<glossdef>
<para>
要素の特定の機能と関連する名付けられた値です。
</para>
</glossdef>
</GlossEntry>
<GlossEntry>
<GlossTerm>ドキュメント・インスタンス</GlossTerm>
<glossdef>
<para>
ドキュメント内容と SGML マークアップを含むドキュメントの SGML ソースです。
</para>
</glossdef>
</GlossEntry>
<Glossentry>
<GlossTerm>表示ウィンドウ</GlossTerm>
<glossdef>
<para>
ブックのテキスト、表、およびグラフィックを表示するインフォメーション・マネージャのウィンドウです。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>ブック</GlossTerm>
<glossdef>
<para>
インフォメーション・マネージャでは、電子的なブックのことです。ハイパーテキスト目次 (TOC) にしたがって処理されたセクションの集まりです。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>ブックケース</GlossTerm>
<glossdef>
<para>
関連するトピックについての電子的なブックのグループです。単一の全文索引によって関連付けられたインフォメーション（通常は数個の関連するブック）の論理的なセットです。ブックケースとスタイル・シートは、インフォメーション・ライブラリの構築が可能なインフォメーションの最小の集まりを表現します。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>ブックケース規定</GlossTerm>
<glossdef>
<para>
インフォメーション・マネージャのインフォメーション・ライブラリを構築するために必要なブック・ファイル、スタイル・シート、および他の SGML エンティティを含むあるいは指定する SGML ドキュメントです。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>ブックケース文書型定義</GlossTerm>
<glossdef>
<para>
インフォメーション・マネージャのブックを構築するときに使用される規定ファイルの構造を定義する文書型定義です。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>ブック・リスト</GlossTerm>
<glossdef>
<para>
インフォメーション・マネージャから使用可能なブックケースとブックのリストです。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>ブラウザ</GlossTerm>
<glossdef>
<para>
オンライン・インフォメーションの表示と管理を可能にするインフォメーション・マネージャのオンライン・システムです。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>文書型定義 (DTD)</GlossTerm>
<glossdef>
<para>
Document Type Definition の省略形です。ドキュメントのマークアップを確立する正規の構築規定です。文書型定義は、SGML を文書型に適用するためのインフォーマルなガイドラインと規則も含んでいます。
</para>
</glossdef>
</Glossentry>
<Glossentry>
<GlossTerm>目次 (TOC)</GlossTerm>
<glossdef>
<para>
インフォメーション・マネージャのオンライン・ブック・タイトルのセクションを編成するハイパーテキスト目次（hypertext table of contents の省略形）です。
</para>
</glossdef>
</Glossentry>
</Glossary>

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/addbkcas.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/bkcase.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/blddir.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/docsrc.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/docuhier.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/infostr.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/multss.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/newlib.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/repbkcas.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/CDR/tlkitmod.cdr Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/addbkcas.cgm Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/bkcase.cgm Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/blddir.cgm Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/docsrc.cgm Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/docuhier.cgm Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/infostr.cgm Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/multss.cgm Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/newlib.cgm Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/repbkcas.cgm Normal file
View File

Binary file not shown.

BIN
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/graphics/tlkitmod.cgm Normal file
View File

Binary file not shown.

186
cde/doc/ja_JP.dt-eucJP/guides/infoAPg/preface.sgm Normal file
View File

@@ -0,0 +1,186 @@
<!-- $XConsortium: preface.sgm /main/4 1996/10/03 10:50:52 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<preface id="InfoAPG.Pref">
<title>はじめに</title>
<Para>
<CiteTitle>共通デスクトップ環境 インフォメーション・システム設計者およびプログラマのためのガイド</CiteTitle>では、次のことを説明しています。
</para>
<itemizedlist>
<listitem>
<para>
SGML に準拠した文書を作成して、インフォメーション・マネージャで表示することができる形式にするための情報を提供します。
</para>
</listitem>
<listitem>
<para>
スタイル・シートの作成および使用方法について説明します。
</para>
</listitem>
<listitem>
<para>
設計様式について説明した後、SGML 文書をインフォメーション・マネージャで表示できる形式にするために、それらを 文書型定義 (DTD) に適用する方法を説明します。
</para>
</listitem>
</itemizedlist>
<Note>
<Para>
インフォメーション・マネージャを正しく使用するためには、SGML のソースを Standard Generalized Markup Language [SGML (ISO-8879)] の規定による一般化されたマークアップで作成しなければなりません。
</Para>
</Note>
<sect1 id="InfoAPG.Pref.div.1">
<Title>対象読者</Title>
<Para>
このガイドは、SGML 文書を作成、検証、および構築して、CDE インフォメーション・マネージャで表示可能なオンラインのインフォメーション・ライブラリにする、という作業を行うテクニカル・ライタ、管理者、および発行者を対象としています。読者は、SGML を理解しており SGML 文書型定義 (DTD) の編集ができなければなりません。
</Para>
</Sect1>
<sect1 id="InfoAPG.Pref.div.2">
<title>このマニュアルの構成</title>
<para>このマニュアルの内容の説明を、以下に示します。</para>
<ItemizedList>
<listitem>
<para>
第１章「構築過程とツールについて」では、インフォメーション・マネージャの構築過程の概要を、関連する文書とコマンドの簡潔な説明とともに述べます。
</para>
</listitem>
<listitem>
<para>
第２章「SGML およびインフォメーション・マネージャ文書の構造」では、SGML の概念およびインフォメーション・マネージャのオンライン・インフォメーション構造について、簡潔な概要を述べます。
</para>
</listitem>
<listitem>
<para>
第３章「構築準備」では、インフォメーション・ライブラリを構築するために必要な SGML のコンポーネントについて説明します。
</para>
</listitem>
<listitem>
<para>
第４章「インフォメーション・ライブラリの構築」では、<command>dtinfogen</command> コマンドによるインフォメーション・ライブラリの構築と更新の過程について説明します。
</para>
</listitem>
<listitem>
<para>
第５章「ブックケースの管理」では、ライブラリのブックケースのコピー、削除、再調整、名称変更、および列挙による既存のインフォメーション・ライブラリの変更方法について説明します。
</para>
</listitem>
<listitem>
<para>
第６章「トラブルシュート」では、トラブルシュートに関するアドバイスを述べ、構築エラー、スタイル・シート・エラー、およびライブラリ管理メッセージについて説明します。
</para>
</listitem>
<listitem>
<para>
第７章「スタイル・シートの理解」では、DtInfo スタイル・シートのモデルについて説明し、スタイル・シート構造の開発、要素パス指定の設定、および「選択」機能の使用について一般的なガイドラインを述べます。また、要素の継承についても説明します。
</para>
</listitem>
<listitem>
<para>
第８章「スタイル・シートの作成」では、有効なスタイル・シートの機能について説明し、その属性と値を定義します。また、スタイル・シートを作成するための指示を述べ、スタイル・シートにおいて機能がどのように使われるかを示す例を掲載します。
</para>
</listitem>
<listitem>
<para>
第９章「設計様式の理解」では、インフォメーション・マネージャの設計様式について説明し、それらがインフォメーション・マネージャの構築過程とツールのモデルにおいて、どのように使われるかを示します。
</para>
</listitem>
<listitem>
<para>
第１０章「設計様式の使用」では、インフォメーション・マネージャの設計様式および文書型定義 (DTD) におけるその適用方法について説明します。
</para>
</listitem>
<listitem>
<para>
第１１章「目次の設計様式」では、インフォメーション・マネージャに目次情報の処理方法を伝えられるように、目次の文書型定義 (DTD) の要素に設計様式を適用する方法について説明します。
</para>
</listitem>
</itemizedlist>
</sect1>
<sect1 id="Q3yRgFBsz1698oL">
<title>関連文書</title>
<Para>SGML に関する情報については、以下の文書を参照してください。</Para>
<ItemizedList>
<ListItem>
<Para>ISO 8879:
<CiteTitle Pubwork=Book>1986 Information Processing - Text and Office
Systems - Standard Generalized Markup Language
(SGML)</CiteTitle> Geneva, 15 October 1986.
</Para>
</ListItem>
<ListItem>
<Para>
<CiteTitle Pubwork=Book>The SGML Handbook</CiteTitle>, C.F. Goldfarb, Clarendon Press,
Oxford University Press, 1990.
</Para>
</ListItem>
<ListItem>
<Para>
<CiteTitle Pubwork=Book>Practical SGML, Second Edition</CiteTitle>, Eric van Herwijnen,
Kluwer Academic Publishers, 1994.
</Para>
</ListItem>
<ListItem>
<Para>
SGML Open Home Page, http://www.sgmlopen.org/sgml/docs/index.html
</Para>
</ListItem>
</ItemizedList>
</Sect1>
<sect1 id="InfoAPG.Pref.div.4">
<title>DocBook SGML マークアップが意味するもの</title>
<para>このマニュアルは、DocBook 文書型定義 (DTD) を使用して、SGML (Structured Generalized Markup Language) で書かれています。さまざまな意味要素のための DocBook マークアップを、以下の表に示します。
</para>
<table id="InfoAPG.Pref.tbl.1" frame="Topbot">
<title>DocBook SGML マークアップ</title>
<tgroup cols="3" colsep="0" rowsep="0">
<colspec colwidth="1.65in">
<colspec colwidth="2.63in">
<colspec colwidth="2.92in">
<thead>
<row>
<entry align="left" valign="bottom"><para><literal>マークアップの形式
</literal></para></entry>
<entry align="left" valign="bottom"><para><literal>意味要素
</literal></para></entry>
<entry align="left" valign="bottom"><para><literal>例
</literal></para></entry></row>
</thead>
<tbody>
<row>
<entry align="left" valign="top"><para><command>AaBbCc123</command></para></entry>
<entry align="left" valign="top"><para>コマンド名</para></entry>
<entry align="left" valign="top"><para>ファイルの一覧を表示するには <command>ls</command> コマンドを使用します。</para></entry>
</row>
<row>
<entry align="left" valign="top"><para><literal>AaBbCc123</literal></para></entry>
<entry align="left" valign="top"><para>オプション名</para></entry>
<entry align="left" valign="top"><para>すべてのファイルの一覧を表示するには <command>ls</command> <literal>&minus;a</literal> を使用します。</para></entry>
</row>
<row>
<entry align="left" valign="top"><para><symbol role="Variable">AaBbCc123</symbol></para></entry>
<entry align="left" valign="top"><para>コマンド行の位置指定: 実際の名前または値に置換されます。
</para></entry>
<entry align="left" valign="top"><para>ファイルを削除するには <command>rm </command> <symbol role="Variable">filename</symbol> を入力します。</para></entry>
</row>
<row>
<entry align="left" valign="top"><para><filename>AaBbCc123</filename></para></entry>
<entry align="left" valign="top"><para>ファイル名およびディレクトリ名
</para></entry>
<entry align="left" valign="top"><para><filename>.login</filename> ファイルを編集します。
</para></entry>
</row>
<row>
<entry align="left" valign="top"><para><emphasis>AaBbCc123</emphasis></para></entry>
<entry align="left" valign="top"><para>本のタイトル、新規の単語または用語、強調表示された単語
</para></entry>
<entry align="left" valign="top"><para><emphasis>ユーザーズ・ガイド</emphasis>の第６章を読んでください。
これらは、<emphasis>class</emphasis> オプションと呼ばれます。
これを行うには、<emphasis>root でなければなりません</emphasis>。
</para></entry>
</row></tbody></tgroup></table>
</sect1>
</preface>