質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

90.49%

  • HTML

    9250questions

    HTMLとは、ウェブ上の文書を記述・作成するためのマークアップ言語のことです。文章の中に記述することで、文書の論理構造などを設定することができます。ハイパーリンクを設定できるハイパーテキストであり、画像・リスト・表などのデータファイルをリンクする情報に結びつけて情報を整理します。現在あるネットワーク上のほとんどのウェブページはHTMLで作成されています。

  • XML

    665questions

    XMLは仕様の1つで、マークアップ言語群を構築するために使われています。

  • PDF

    260questions

    PDF(Portable Document Format)とはISOによって国際標準として制定されている電子ドキュメント用の拡張子です。

DITAに対する認識が合っているか教えてください。

解決済

回答 1

投稿

  • 評価
  • クリップ 1
  • VIEW 412

HearthXml

score 32

最近になってDITA(Darwin Information Typing Architecture)を触ることになって色々調べたのですが、
DITAに対して間違った認識をしているのか不安になったのでアウトプットしてみました。
何か間違っているところがあれば指摘してください。
また、DITAで押さえておくべきことなどがあったら教えてください。お願いします。

  • DITAのメリット
  1. 一つのソースから複数の形式のファイルを生み出せること
    DITAエディタでDITAソースを作成し、シナリオを指定することでソースをwebhelp(html)やPDFなどに変えたものを出力できるので、
    ドキュメント作成の時間を減らすことができる。
  2. デザインの型があるのでドキュメント作成が簡単になる
    タスク、参照情報、用語集といったトピック(htmlのようなタグがあらかじめ書いてあるだけ)を利用することで、
    デザインについて悩まなくて済む。
  • DITAとは
  1. DITAという様式で書かれたxml
  2. ドキュメント作成用の道具
  • 日本でDITAが流行らない理由
  1. ドキュメント作成はExcelやWordで十分だから。
  2. 歴史が浅いから。
  3. ドキュメント作成にしか使い道がないので面白くないから。
  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

回答 1

checkベストアンサー

+1

分かる範囲ですが、

>2.デザインの型があるのでドキュメント作成が簡単になる

タスク、参照情報、用語集といったトピックは、デザインの型ではなく、「情報の型」です.
つまり、「タスク」はこのような構造で書きましょう、「参照情報」はこのような構造で書きましょう、といったものです.
これにより、複数の編集者による記述スタイルの"バラツキ"を無くすことができ、ドキュメントの構造、文章の表現や用語が統一され、その結果として、読者の理解を助けることにつながります.
また、作成する側はトピック単位での管理になるため、再利用や翻訳といった点で有効に活用できます.

もちろん、情報の型に紐付けされたデザインを適用することになりますので、「デザインについて悩まなくて済む」のですが、逆に編集者が指定できるデザインは限られたもののみ(太字・斜体など)になります.


>・日本でDITAが流行らない理由
これは正解がありませんので、あくまで推測になりますが、

  • 仕様やタグを理解しないとオーサリングできない
  • 日本語の参考資料が少ない
  • 書きたいように記述できない(情報型に合わせる必要がある)
  • 見た目が凝ったデザインにできない
  • 既存のドキュメント資産を活かしてDITAに移行するのは簡単ではない
  • 仕様策定やドキュメントの分析といった作業が必要なためそこそこ時間がかかる
  • 導入コストがかかる(トピック管理にCMSの導入が必要になるケースも少なくない)
  • 前述のような作業が必要なので、本格稼働するまでに時間がかかる

など.書き出すときりがない感じになってしまいました.

ご存知かと思いますが、日本語では以下の「DITAコンソーシアムジャパン」のサイトなどが参考になると思います.
DITAコンソーシアムジャパン

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2017/11/23 00:54

    返信遅れて申し訳ございません。
    DITAコンソーシアムジャパンは知りませんでした。
    ありがとうございます。

    キャンセル

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 90.49%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる

関連した質問

  • 受付中

    レスポンシブサイトのコーディングについて

    レスポンシブサイトのヘッダーで、古いデザインのサイトを作っているのですが、 古いデザインはヘッダーにロゴ、h1、問いあわせ、文字拡大ボタンなどが、二列になってぎゅうぎゅうに詰まって

  • 解決済

    teratail,dotinstallのようなスマホのみデザインが切り替わる仕組み

    teratail,dotinstallのサイトはそれぞれPC, スマートフォンでデザインが切り替わります。 PC上でウィンドウを小さくしても表示はPC表示のままで、スマホでアクセ

  • 受付中

    javascriptの切り分け

    http://kakunin.coresv.com/test1130/ のギャラリーの画像を読み込む部分は必要なくて ギャラリーの動きだけを切り分けたいのですが、どの部分を変更すれ

  • 解決済

    Railsのfields_forのオプションとか使い方について

    宜しくお願い致します。   Ruby on Railsを使って開発をしております。 複数レコードの一括更新をしたく参考になる情報を探した所、 http://j-caw

  • 解決済

    【Django】formで入力した値がmodelに保存されない。

    (例)Djangoでフォームの学習をしているのですが、formから値を入力すると、{% csrf_token %}を入れてるにも関わらず403エラーがでます。 発生している問

  • 解決済

    pythonにおけるリストの数え上げ

    初歩的な質問です。 counter関数を使って単語の要素を数え上げたいのですが、counter関数を使うとリストがランダムに構築されてしまうことを防ぎ、出現順に要素を数え上げたい

  • 解決済

    ソフトの外観の定義を保存する方法

    趣味でプログラミングをやっています。 ソフトを GUI で作成するとします。 その場合、外観を整える必要がありますね。 すぐにできる場合は そのまま着手すればいい

  • 解決済

    自分用のライブラリ記録

    趣味で C/C++でやっています。 ( 今回はあまり言語は関係ないですが。一応。 ) 皆さんは自分用のライブラリを組んだ場合、 Documentation というのでし

同じタグがついた質問を見る

  • HTML

    9250questions

    HTMLとは、ウェブ上の文書を記述・作成するためのマークアップ言語のことです。文章の中に記述することで、文書の論理構造などを設定することができます。ハイパーリンクを設定できるハイパーテキストであり、画像・リスト・表などのデータファイルをリンクする情報に結びつけて情報を整理します。現在あるネットワーク上のほとんどのウェブページはHTMLで作成されています。

  • XML

    665questions

    XMLは仕様の1つで、マークアップ言語群を構築するために使われています。

  • PDF

    260questions

    PDF(Portable Document Format)とはISOによって国際標準として制定されている電子ドキュメント用の拡張子です。