2

現在、私は Microsoft Word 2003 を使用してユーザー ガイドを管理しており、Web サイトからダウンロードできる PDF ファイルに変換しており、製品インストーラーに含まれています。

以下を実現する仕組みに移行したいと考えています。

  • クリック可能な TOC とフロント ページを含む PDF ファイルを生成します
  • 章/セクションごとに HTML5 準拠の出力を生成しますが、HTML スケルトンはありません。
  • ユーザー ガイドの JSON TOC を生成します (章/セクションの概要)

PDFファイルを配布物に同梱したいと考えています。

状況依存の目次 (現在の章のセクションを表示) と関連ドキュメントを表示する HTML ページを生成する単純な PHP スクリプトをいくつか作成したいと思います。

これを実現するための PHP スクリプトの開発に問題はありませんが、上記の出力を生成する方法を知りたいです。できれば既製の GUI を使用してドキュメントを入力したいと考えています。必要な変換を実行する XSLT2 スタイルシートを喜んで作成します。

私が求めているものを人々に理解してもらうために：

私の API ドキュメントをナビゲートすると、左側の目次が状況依存であることがわかります。ユーザー ガイドが同様の方法で機能することを望みます。

Prince の無料の代替手段はありますか:ページ付きメディア CSS のhttp://www.princexml.com/ ?

4

2 に答える 2

0

多くの調査と実験の後、DITA (Darwin Information Typing Architecture) を使用することにしました。私にとって DITA の最も優れた点は、ドキュメントをモジュール化して再利用可能にするトピックベースであることです。

DITA スキーマは比較的単純であり、優れた XML エディターを使用すると、利用可能な要素と属性について有益な洞察が得られます。

DITAMAP を使用して、目的に合わせて DITA 文書を組み合わせることができます。たとえば、最小限の情報しか含まれていない「クイック スタート ガイド」を配布し、本格的な「ユーザー ガイド」にはより詳細な情報が含まれている場合があります。すばらしい点は、両方のドキュメントで同じ情報を再利用できることです。さらに、ドキュメントはさまざまな配信形式で出力できます。

  • XHTML (単一ファイルまたはチャンク)
  • PDF
  • ドックブック

出力を配信形式に変換するプロセスは、DITA Open Toolkit (別名 DITA-OT) を使用して簡単に処理できます。このツールキットはhttp://dita-ot.sourceforge.netから入手できます。これは、提供されたアーカイブを解凍するだけでインストールされます。startcmd.batツールキットは、(Windows の場合) またはstartcmd.sh(Unix 系のシステムの場合)を実行することで簡単にアクセスできます。

PDF 出力のカスタマイズとブランディングは簡単な作業ではありません。XHTML 出力のカスタマイズは非常に簡単ですが、それでも XSL 変換の知識が必要です。プラグインを作成し、pluginsDITA-OTのフォルダー内に配置することで、カスタマイズを行うことができます。強調したいことの 1 つは、カスタマイズが行われたらant -f integrator.xml、変更が明らかになる前に呼び出す必要があるということです。この知識の欠如は、私に多くの混乱を引き起こしました!

生成された XHTML ファイルは非常にシンプルです (これは素晴らしいことです)。これにより、カスタマイズが容易になります。ただし、HTML5 DOCTYPE を追加するのは簡単ではありません。しかし、私のPHPスクリプトは中身だけを気にしているように見えるので、私の目的では、これは実際には問題ではありません<body>。

優れた WYSIWYG エディターを見つけることができませんでしたXML Mind は、非常に使いやすく、非常に優れた WYSIWYG エディターのようです。Aloha Editor (http://aloha-editor.org) のようなものを使用して、基本的な Web ベースのソリューションを作成するのはそれほど難しくないと思います。

PDF 出力をカスタマイズするのはかなり難しいように思われますが、すべてのドキュメントを単一の XHTML ページに生成し、CSS を使用してフォーマットし、最後に を使用して変換するのは非常に簡単wkhtmltopdfです。まだソリューションを決定していませんが、少なくともこれは、DITA-OT の XSL:FO スタイルシートをカスタマイズできない (またはカスタマイズする時間がない) 人にとって実行可能なオプションです。

追加:いくつかの検索の後、「Ditac」と呼ばれる DITA-OT に代わる別のオープン ソースがあることがわかりました。これは、はるかに使いやすく、はるかに優れた出力を生成します。このツールは、「XML Mind」の作成者によって作成されています。このツールはコマンド ライン ベースですが、「XML Mind」を使用するユーザーは機能豊富な GUI を利用できます。

http://www.xmlmind.com/ditac/

注：他の人に役立つ可能性があるため、以前の回答を残しました。

于 2012-07-27T23:35:08.163 に答える
0

多くのバリエーションを読むのにかなりの時間を費やした後、私は潜在的な解決策に出くわしました...

  1. WYSIWYG エディター用にPHP とhttp://aloha-editor.orgを使用して、非常に単純な「静的」CMS を作成します。おそらくhttps://github.com/chillitom/CefSharpを使用して、エディターをより関連性の高い GUI に直接埋め込むことができます。

  2. カスタム カバー、ヘッダー、およびフッターの .html ファイルを含む "wkhtmltoxdoc" を使用して、HTML5 ページを PDF に変換します。Plus は TOC ページを自動的に生成します。

  3. 「wkhtmltoxdoc」は、JSON に簡単に変換できる XML TOC も生成します。

私はまだ "wkhtmltoxdoc" を試していますが、かなり良さそうです! もちろん、もっと簡単な解決策がない限り...

追加した：

私の TOC ファイルは、手動で作成されたものと自動生成されたものを混在させる必要があるようです。H1-6 タグを取得し、ハッシュ リンクの一意の識別子を追加することで、単純な XSLT スタイルシートが自動的に空白を埋めることができる場合、Eclipse TOC スキーマの行に沿ったもので十分です。

したがって、この TOC は XSLT2 スタイルシートで使用でき、最終的に PHP スクリプトで使用するために JSON に変換できます。

私の既存のドキュメントのモックアップ抜粋:

<?xml version="1.0" encoding="UTF-8"?>
<toc>
    <topic label="Introduction" href="introduction.html"/>
    <topic label="Getting Started">
        <topic label="Installation" href="getting-started/installation.html"/>
        <topic label="User Interface" href="getting-started/ui/index.html">
            <topic label="Menu Commands" href="getting-started/ui/menu-commands.html"/>
            <topic label="Tile System Panel" href="getting-started/ui/tile-system-panel.html"/>
            <topic label="Brush Designer" href="getting-started/ui/brush-designer.html"/>
        </topic>
        <topic label="User Preferences" href="getting-started/user-preferences.html"/>
    </topic>
    <topic label="Creating a Tile System" href="creating-a-tile-system">
        <!-- ... -->
    </topic>
</toc>

Eclipse ドキュメントへの参照: http://help.eclipse.org/indigo/index.jsp?topic=%2Forg.eclipse.platform.doc.isv%2Freference%2Fextension-points%2Forg_eclipse_help_toc.html

于 2012-07-25T00:58:19.207 に答える