DITA でオーサリングの実践を荷ほどき(第1部)(2) Getting Started始めにMost writers will be familiar with structures and templates, styling, categories and document identification, and crafting abstracts or briefs. DITA, as an open international standard, does take these aspects to a new level and constrain the writers to a certain level. The key is to understanding topic-based authoring (or modular documentation) will require the technical authors to:たいていの執筆者は構造とテンプレート、様式、カテゴリーとドキュメントid、と要約あるいは概要を作りあげることを精通しているでしょう。 DITAは、公開国際標準として、これらの様相を新しいレベルに導いて、執筆者をあるレベルに制約します。その秘訣はトピックベースのオーサリング(あるいはモジュール式のドキュメンテーション)が技術著者に下記を要求するであろうことを理解することです: Make a clear choice into what type of topic1must be written. どののタイプのトピックに書くべきかの明確な選択をする。 Use tags instead of styles to clarify the meaning of text segments. スタイルの代わりのタグをテキスト部分の意味を明確化するために使う。 Enrich the content with metadata that makes sense to identify not only the full output, but each content piece. 出力全体だけではなくそれぞれのコンテンツの断片も識別するために意味をなすメタデータでコンテンツの価値を高める。Understanding topicsトピックの理解Topic-based writing should be easy to grasp for authors who are familiar with:トピックベースの執筆は下記に馴染みがある著者にとって把握が容易であるべきです: Transversal ISO-IEC-IEEE 82079-1 2019 Preparation of information for use (instructions for use) of products — Part 1: Principles and general requirements standard, which separates content into instructions, conceptual information, and reference information. 横断的ISO-IEC-IEEE 82079-1 2019製品利用のための情報(使用のための指示)の準備- 第1部:原則と一般的要件標準。それはコンテンツを指示と、概念的な情報と参照情報に分離する Simplified Technical English – which separates instructions and conceptual information. 単純化された技術英語 -それは指示と概念的なインフォメーションを分離する。 Information mapping, which separates content into instructions, processes, descriptions… 情報のマッピング、それは、コンテンツを指示、プロセス、記述に分ける Web patterns and organizations’ templates (iFixIt, HowTo…) that provide structure for instructional information. 指示情報に構造を提供する Web パターンと組織のテンプレート(iFixIt, HowTo…)。Once the topic type is established, the writer follows the expected information derived from the type. This structure is based mostly on common sense and best practices from the technical communication field.トピックタイプが確立されると、執筆者はそのタイプから派生する期待される情報を追求します。 この構造は主として常識とテクニカルコミュニケーション分野からの最善事例に基づいています。