2024.01.21
テーマ：英語のお勉強日記
カテゴリ：DITA
From Zero to Hero in DITA XML Content Writing
DITA XMLコンテンツ執筆で無からヒーローへ
By Bénédicte Rivory
ベネディクト・リヴォリー著
July 25th, 2023
2023年7月25日
DITA XML is a powerful standard for creating technical documentation. Whether you are managing product documentation, training content, quick-start guides, or tutorials, DITA XML can dramatically improve the quality of your documentation and deliver the best possible user experience.
DITA XML は、技術文書を作成するための強力な標準です。製品ドキュメント、トレーニングコンテンツ、クイックスタートガイド、チュートリアルのいずれを管理する場合でも、DITA XMLはドキュメントの品質を劇的に向上させ、可能な限り最高のユーザー体験を提供します。
However, learning how to create DITA XML content is a skill that has to be learned: delivering high-quality technical documentation has to be earned! Here are the key steps you need to follow to create DITA XML content like an expert.
しかし、DITA XMLコンテンツの作成方法を学ぶことは、高品質の技術文書を配信することを獲得する必要があるスキルです。ここでは、エキスパートのようにDITA XMLコンテンツを作成するために必要な主な手順を紹介します。
Get to grips with DITA XML environment
DITA XML環境を理解する
DITA XML is a complete and specific standard, tailored to the needs of users. So you need to start by understanding the basics!
DITA XML は、ユーザーのニーズに合わせて調整された、完全で具体的な標準です。ですから、まずは基本を理解することから始める必要があります。
This includes understanding the different types of DITA elements, how they are used, and how they are properly structured. There are many resources available to help you familiarize yourself with the DITA XML standard, including Learning DITA courses, DITA XML community, and a glossary of specific terms.
これには、さまざまなタイプのDITA要素、その使用方法、および適切な構造の理解が含まれます。DITA XML 標準の理解に役立つリソース は、DITA の学習コース、DITA XML コミュニティー、特定の用語集など、多数用意されています。
Once you have a basic knowledge of the DITA XML standard, you can start learning how to apply it to your technical writing projects, and let the magic happen:
DITA XML標準の基本的な知識を身に付けたら、それを技術執筆プロジェクトに適用する方法を学び始め、魔法のような現象を起こすことができます。
Creating a DITA map
DITAマップ作成
Creating topics
トピック作成
Structuring your content
コンテンツの構造化
Reviewing content
コンテンツの見直し
Customizing your documentation
ドキュメントの仕立て
Publishing to an output format
出力フォーマットに出版
It’s essential to familiarize yourself with the standard before starting content writing. This will enable you to better understand the following steps, establish your workflow, and create well-structured documentation.
コンテンツの作成を開始する前に、標準に慣れることが不可欠です。これにより、次の手順をよりよく理解し、ワークフローを確立し、適切に構造化されたドキュメントを作成できます。
Arm yourself with the necessary tools for DITA XML
DITA XML に必要なツールを身に付ける
Once you have acquired a basic understanding of DITA XML, you’ll need to equip yourself with the tools you need to create and manage technical content! The most popular tools are:
DITA XMLの基本的な理解を習得したら、技術コンテンツの作成と管理に必要なツールを身に付ける必要があります。最も一般的なツールは次のとおりです。
l Oxygen XML Editor: An ultra-powerful, highly versatile XML editor that supports DITA and provides good coverage of all XML technologies.
Oxygen XML エデイター: DITAをサポートし、すべてのXMLテクノロジーを十分にカバーする、非常に強力で汎用性の高いXMLエディターです。
l DITA-OT (DITA Open Toolkit): A free, open-source toolkit that can be used to create, manage, and publish DITA XML content.
DITA-OT (DITA オープンツールキット): DITA XML コンテンツの作成、管理、公開に使用できる無料のオープンソースツールキットです。
―――――――――――――――――続く――――――――――――――――――
下記URLから続きを読むことができます。また、図付きの元のレイアウトで読める原文ファイルも入手可能。今月1か月分のファイルは100円で取り寄せられますが、次の月からは300円に値上げします。
https://note.com/tongansunmi/n/n00b5ce471090?sub_rt=share_pb
==============================
インターネット・コンピュータランキング
==============================
ネットサービスランキング
==============================
|
|
|
|
