（マークアップ言語)を製造するユーザーズマニュアル[定休日]

https://stackoverflow.com/questions/371654

21-08-2019
|

質問

誰でもできるのでお勧めプログラムをユーザーマニュアルです。なマークアップ言語(のようなラテックスまたはDocBook)でも対話のようにScribus.としているの更新のマニュアルのソフトウェアすべきというのは、とても簡単で、初心者の迎えがいても高度な機能（リンクテキストから外部ソース/テーブル、取扱いmasterpages/テーマなど)。

についてオスカー

解決

技術出版ソフトウェア-観 FrameMaker その選択肢

もちろん、仕様書にラテックス、Framemakerやるリスクコミュニケーション、Framemakerワークフロー支援チームの5つのアナリストの製造仕様書、保険の引き受けます。同文書に卒業見込みの2,000ページです。多数年前（1992-1993)また、簡単にしtypesetter.

Framemaker設計のための技術文書とはで もしそうです。 も特徴の支援のための非常に大きな文書で複数の著者の人々はこのシステムな書類は以上100,000ます。それはとてもアクセスよりラテックスユーザーに知語処理ソフトウェアです。

主な特徴Framemaker:

書類複数ファイル: 引っぱることができと 'Book'複数の節に異なるファイルです。同文書でもっ源管理。
テキストのMIFの形式輸入/輸出: の輸入がややfinicky(この生成ワラテックスできる)ができ生成などのデータ辞書及び輸入していします。ファイルはテキストアンカー(下記参照できますのでを参照するリンクする安全輸入額.I この重要な機能スペックでのクロス-参考文献への直接リンクを生成します。
強力なタグ付け、割り出し、相互参照システム すべに基づくタグFramemakerやで適用のタグです。この字幕割り出し、条件付きテキストと適用スタイラギが簡単に 作品だけに.形を生成することができます指標との相互交流に基づくタグで複数の専門的な指標などの一覧データフィールド名から画面またはデータ辞書) 簡単にいかない。文書I 上記した4つのスを作成します。
安定した: Framemakerは専門家でない第二しょうことを言います。でもより安定した大型を提出する。人のた文書を書くのによく50～100 ページの単語が必要か公正なうこされることも示唆しています。
選択した): FMは、C APIにあり様々なスクリプティングのプラグイン (FrameScript や FMPython ているその最も広く使用）使用できる自動化する仕事にします。 Framemaker10 追加の支援のための、Javascriptに基づくスクリプティングツールという Extendscript, 殺され、公益が達成される移植からのスクリプティング施設 InDesign.
シングルソー: シングルからFM 文書を創り出すことができる、PDF、 Windowsのヘルプ(CHM）、HTMLおよび印刷書類も容易だ。のクロス-参考文献も解決ハイパーリンク.
グローバルスタイル制御: ができ簡単に設定スタイルのための書類適用するまでの全書きします。でも容易に行走行ヘッダとfootersと多くの柔軟性を有すしてトラック、バージョン章等

代替Framemaker

ラテックス/Lout: までに既に記載されているおすすマークアップ lanaguageが、テックスや Lout するために使用するシステムのための大構造化文書といます。
Ventura出版社: おそらく、みシステムFramemaker したい場合はそのようなユーザインタフェースな身体のパーツを "権限を与えます。で強力にサポート構造文書のXMLに基づいた文書交換フォーマットです。で現在所有しているか、または今後によるCorel員が積極的に推進します。

カップルのその他の技術的な出版ツールの市 Quicksilver （はじめとする Interleaf） ArborText.これら二つのアプリケーションやデータ-Interleafの市場リーダー分野の一点が非常に高価です。
Adobe Indesign: はAdobe 請求できない大きな文書でとInDesignの相互参照その他の大規模なドキュメントの特徴傾向にあると見なる Framemaker afficionados.があり、しかし、文字入力システムでという InCopy ことを明らかはこのような機能性にも大体の第三者プラグイン, あるい支援のタグ付けなどの施設です。InDesignでもスクリプティングAPI JavaScriptの通訳を行うイントロダクションです。

でIndesign, なんのコメントをどうものです。
DocBook: こん標準フォーマットのための構造化書類を大量に生態系のツールで書き込み及びレンダリング。の場合を使用しないラテックスまでれていないことが考えられたDocBook用同様の理由で。として Vinko Vrsalovic 指摘す(+1), このリンクくStackOverflow ポストから誰かを記述する利用 DocBook。そん使っDocBookっで多く編集にはこのポストにはこのWikiモードで誰か知DocBookがしたいことです。
単語の処理ソフトウェア: 言葉重大な欠点として技術的な出版ツールとなお勧めします。 OpenOffice はややより良い構造文書の機能によ言葉であるが、これはより良い選択の場合政治が求めます。doc として書面を交換フォーマットを妨げるより良いる。Wordperfect もかなり良いのか文書の大きなよ語と存在感のある複数の垂直市場などの法律事務所
Madcapソフトウェアのブレイズやフレア: これらの新しいキッズのブロック、ライブ約のスペース Framemaker.当社の創業元 eHelp（クリエイターのRoboHelp)従業員とはの開発を積極的に進め、複数のリリース。その提供して大幅に拡大し、に悪影響を与える行為、品質の個々の製品です。そうしてい合わせいただければ新しい製品による結果が"フィッティング、仕上げ"の問題います。ている．本稿では，選ばれた管理ソリューションを提ホイールなど、多くのよくよく壊れます。保存しばしばまとの出会い独自のレンダリングメカニズム例外をスローしました。ソース制御の統合はサクサク.例えば、移動または削除するグループのファイルに一つのソース制御コミット毎のファイルを削除します。大きなピ時いソース制御のメール通知を選択するフィルタ。こんにちは500しています。フレアをインポートすることができ語、Framemakerファイルの輸入から遠いのでシームレス.見込みの全てのコンテンツが計画を完全に再スタイリングをゼロから立ち上げました。フレアを始めとして多くの言葉のtendanciesいく背景のシーンにするとともに、そのユーザーが選択できます。HTMLの見何をどのような単語の出力に書き出したときにHTMLのカスタムタグおよび属性に深く入れ子にされたインラインのスタイル。テキストファイルをテキストエディタmaddening、例えば、カーソルのモデルは異なる他のソフトウェアで今まで使用します。

Framemaker前ラテックス

これら二つの主要なシステム利用していを大型商用アニメーションシステムの文書をとった結果なんです。

容易に学習 TeXき絶対制御が実際にこれを達成するためには、複雑なラテックス文書が破損することなくその他項目にな些細な、特に多数のマクロパッケージするものです。基本ラテックスなく、もの作り修正されたバージョンです。styファイルまだ企業から大企業、支店-営業所ッぁいない場合は、本当に深いテックスハッカー。できると思うがしてお過ごしく時間fiddling.

Framemakerきの制御のみの文書はそんなにハードを学ぶことができます。っハウススタイル、調整のレイアウト(きょうい）くとFramemaker.
や文字入力: 利用できるツールなど Lyx を提供 wordprocessorようなフラテックスは、これらの作業の場合だと、書きたいな身体の大きます。FramemakerのDTPに似たユーザーインターフェース作品の中の人々に親しにとってはwordproessing ソフトウェアです。こうした観点からあなたの実践ます。
孔の文書構造: Framemakerできる書類構造定義タグまたはXMLスキーマ(利用の場合構造Framemaker).ラテックスは、セット缶構造要素その柔軟性に優便利です。追加構造要素（例えばデータ辞書項目ができるとともに、マクロってオート番号はより困難にしており、ま必要ポ後のます。両方とも大きな技術でにLaTeXにな些細な例。

また、ラテックスがないこの施設へのテンプレートの文書構造の構造Framemakerます。ただし、これを達成型の効果DocBookし生LaTeXが望まれる。
容易に統合 I組み合わせでは、発電機のための非trivially 複雑なMIFのファイルあヒ.のMIFのパーサは非常に pernickety FM、どめいんとについては診断用として開発されました。ラテックス生産よりもはるかに優れておりエラーメッセージやはりかなり少なわ.

技術出版のソフトvs.レイアウトのソフトウェア

ページレイアウトのソフトウェア開始 Pagemaker その他の主要プレーヤーのこのスペースその他クォークXpess 今InDesign、詳しい情報は<url>/をご覧くだほうdeprecateに置き換え、Framemaker. Scribus, は、前述したとおり、生活スペースでこれらの製品です。

の場合の製造マニュアルの以下(い)く50～100ページのパッケージかい適切な仕事です。その設計のための広告やレイアウト-重出版の課題など、雑誌やその支援のための大きなドキュメントの並べ替えたFramemakerはかなり限られます。の重要課題とこれらの製品は、拡張性-してもうまく動かないので、大きます。

参考として記載していま際typeset200ページ（人の自伝をPagemaker.なので細粒のカーニングと制御可能なビットcopyfittingではまだまだ高いマニュアル過程について、レイアウト書籍サイズの書類です。この場合、本たばかりの直テキストがあまりいない相互参照や構造以外の執筆を担当しています。という複雑な技術的な仕様書やマニュアルこのサイズPagemakerすれば、ヒうことは不可能になくすことはできません。

技術出版に対す単語の処理ソフトウェア

この説明の点はこちらからダウンローのための大きなスペックを提出する。しかし、特定の波長に対応するように特に必要な書類の大：

割り出し、相互参照: これは実際の英語、非常に不安定です。Framemakerのタグ付け機能やラテックスのラベルうとして選択することができるaタグまたは名ラベル(予測可能な形式が必要です。のテキスト形式のタグのアンカーではのユーザインタフェースなどに使われています。の連携です。語りかけ、アンカーく不透明な容易に制御可能になります。に不器用なユーザー界面の不安定性製品は、この維持これらのヒ、しばしば不安定- 聞き手動で修正していきたいます。
分子を鋳型としたレイアウト: スタイル支援の言葉は非常に基本と番号がやや不安定です。FrameMakerは運転からのタグの適用スタイルに基づくタグです。グローバルスタイルの変化だけの作業 Framemakerようになる言葉です。
大型マルチファイルの書類: こんなこどの言葉がキーで特徴Framemakerやラテックスをまいた。再度、言葉の不安定性とまいに過ごす時間が多く後片付け後です。としてのの文書が大きくなり、の割合は時間を過ごしたこ仕事がquadratically- 傾向が破損例へ n （サイズの書類*時間固定サイズに比例する n あり（時間固定)
なぜ語なので不安定: 単語が多く、裏へ支援の初心者ユーザーの介入にレイアウトを行っております。でもなんフレームに基づく(テキストの流れを概念的に別途から文書レイアウトがしようとしている開発を実施様々なフレームのような挙動をすると確認ダイアログが出ます時は第二推測する複雑な文書では、間違ったものです。Framemaker'のユーザーとしての大人"ではなここでも滞在するします。

その他のワードプロセッサなどオープンオフィスやWordPerfectなぞくと同じようにの単語の一つである理由その ちょうど約あらゆる 言葉プロセッサー以外の単語なよりよい仕事の技術を提出する。
前闘う: 英語、中国語ができるスタッフを語、工程の確認お群集のファイルを、ドキュメント（イメージファイル等) が正しい前めに印刷できます。のプロシステムの訴えこの間違っていを与え、き、修正していきたいです。言葉まだ入れるのは嬉しい顔修理を試みものコンプライアンス-

その好例という言葉がありファイルリンクです。の場合コピー、ファイルやグラフィックを別のディレクトリを更新一グラフィックin situでは、言葉がいファイルの読み込みからパス(私の見たことがいこ）になるにはまだ更新されます。しかし、この挙動はありません、発展途上国で蔓延の濫用不安定なヒューリスティックにするというものです。
プリプレス支援: 出版システムにまで広がっているが、このプリプレス相のワークフロー.この意味この準備のために印刷できます。単語の処理ソフトウェアがないこの機能またはで非常に限られます。

なりすぎないように生まれることを期待し、多くのこの重要な違いは出版ソフトウェア傾向にあり扱いなど、あなたの希望をかなえる大人の同意なくこだわりを持っていたいときにスケールの自動化となる。一つ ができ 用語処理ソフトウェアのための大規模な文書が多くのデザインの決定に適応したカジュアルユーザー書きの短い文書が少ない点です。これらの適応を犠牲にしてフィットネス-インク上の大規模なドキュメント作成です。主な問題を見たいと語仕様書は、貧困層の割出書は、一般の不安定性の問題が私がいつもに戻し、固定となる。しかし、政治的配慮環境によって契約者という意味をはっとします。

一般的なコメントの技術文書ソフトウェア

Framemakerのある場合には、Adobe思いをoff信号セスしようとしている場合、そのdeprecateで、移動そのユーザーにInDesign.しかし、FM広く使用される航空宇宙、ソフトウェア工学サークルやくにはAdobe社の経営に直面し、メリルリンチmob れば、実際にEOLいのない信頼のおける移行パスです。かを読み込み、Adobe取得FMによるジョン-Warnockたが、追い出され、FMで犠牲になりの所ました。の結果として移動メンテナンスモードとはかなり低迷している。

Ventura出版社も去のニッチ市場がある程度が、少なくともCorelない二つの競合する製品ラインのAdobeいます。えなかっ可の代替FMであり政治的に受容可能な水準にPHBの種類などで販売して事業出版システム

QuicksilverとArbortextもう成り立たない可能性が予想され、製品は非常に高価なものとなります。私は使用しないのいずれかできない本当の判断をそのメリットがあります。

マークアップ言語システムが無料と非常に強力に取り組んでまいりました。Loutかもしれないがより働きやすいとしていることはないという感じでかなりのレベルレガシィ荷物がラテックスなんです。DocBookはも広く使用されないといったツールです。これらの技術を入れて大幅な絞りの"オタク'末Framemakerの市場シェア といメリット というものだったチャンクのご利用にはAdobe社の利益になる。い任これらの技術を出て、ログインが必く学びます。

すように評価するInDesign、選択されたセットプラグイン(集中の方のためのタグとクロス-ref/index）をもっていることにあります。最後に、一部の単語処理ソフトウェア(WordperfectとOpenOffice)する合理的なツールキットのための構造化文書の作業を大幅によりこのよMS-Word.

PostScript

あり、茄.しんのカップリプレスの機能これらの製品です。印刷、プリプレス技術の分野で自らの権利の範囲高額なミスをとるべきこまできた。Framemaker、InDesign,Ventura,QuickSilver,Arbortextとと思われる)のMadCap商品を楽しめるようになっているみたい施設にないプリプレスです。巨大なワープロソフトさせます。

て前記ラテックスが関与後処理のPSの出力のようなソフトウェア psutils またはレンダリング一式をPDFファイルをプリプレスのワークフローからあります。一般的な多くのプリプレス住宅での作業からPDF、PDF文書ツールのように蒸留器のインタフェース作成ツールの設計にはなっておりませんのでプリプレスです。なお、品質の出力から蒸留器傾向にあるように Ghostscript に基づくもののように PDFCreator.

なお、RGBの色空間のモニターしない直接的な地図をCYMK色空間での使用により印刷を押します。実際に乗色の特色写真-出によっては正しく表は少しむずかしていない場合は右のキットです。印刷の生産は、専門家ないと信じるに足る理由があいてんしています。のためのカジュアルユーザー I stade numa-daly magentaなどのこの15年後には関わってきましたが、業界として失敗 非常に 高価な直後に努めています。

ればならないかもしれませんがしたい色印刷、必校正モニター.効果を最大限に高めるためには、お客様は高忠実度のモニター様このからのHPです。を校正するために、モニターする"を参照してくださいセンサーが好きにはたまらないものに記載のこの見直し場合は、モニターは付いていません。ログラフィック-カードのようにこれから Nvidia, AMD または Matrox 施設への支援のガンマ補正;多くの消費者のものにとっても同じことです。が必要となりますので、取得キャリブレーションデータの押し切ったお肉をミンチにします利用の印刷は、プリプレスハウスに対する関係ではないかと思います。

前述のとおり、印刷メディアは技術それ自体が簡単に間違っていて、高額な修正しまっています。いない場合は100%であったお正権を取得し、色の証明のように Chromalin.これから実際の膜分離(となったことがなく、そのため非常に高価である)で正確な演出は、実際の色で、最終印刷します。このための数サンプルページで正確にフィードバックかどうかのキャリブレーション設定。

謝辞: 感謝 Aidanライアン拡大のためのMadcapます。

他のヒント

私はECソフトウェアから "ヘルプ＆マニュアルに" をお勧めします。あなたは、単一のソース文書から印刷されたマニュアル、PDF、Windowsのヘルプファイル（CHM）、およびHTMLのWebベースのヘルプを作成することができます。

私はのFrameMakerについて良いものを聞いたことがあります。私はそれを自分自身を使用していませんでしたが、それはまさにこのようなアプリケーションのために私にお勧めしてきました。

はAdobe FrameMakerは、実際のユーザーマニュアルを書くための古典的なツールです。私は、長い文書のすべての種類のためにそれを使用しました、そしてそれは非常によく動作します。 Adobeは、ユーザーが切り替えられないだろうと気づい前に、年間の腐敗するためにそれを残したのが残念。

MSWordのは、弾丸/ナンバリングのバグを取得するために2003年までかかりました、そして、彼らは最終的には、マスタドキュメントの作業を得た場合、私は知りません。

LaTeXのは、まだ合理的な代替手段です。フォーマットは、加工が容易であり、あなたはウィキからそれを生成することができます。

あなたがコラボレーションをしたい場合は、言語ベースのアプローチは、（XMLベースのものでも良いですが、LaTeXのは私の好みだろう - Docbookのは、ここではフラッグシップである）意味を成しません、あなたはバージョン管理でファイルを追跡している場合は特にシステムます。

バイナリまたは独自の形式で任意のソフトウェアのようなものを複雑にしたものは、ここであなたを助けにはなりません。

それはあなたが望む答えではない場合は申し訳ありません。

私はDocBook形式（またはラテックス）を使用して簡単に変換、正気の書式設定、素敵なバージョン管理を持っているsanestアプローチであることをOllivierに同意します。

幸いなことに、あなたがあなたのケーキを持っており、DocBookのエディタでもそれを食べるようにしようとすることができます。

このリストの上のものを試してみて、どんな満たしている場合、あなたのニーズを参照してください（I天国」 t）が任意に使用される。

私たちは、ECソフトウェアのnoreferrer">

オライリー（すべてのこれらの本を販売し、実際のものは...）使用するものに非常に素晴らしい解説ます：

オライリーツールチェーンの

これは、複雑に見えるかもしれませんが、あなたは多分あなたの書き込みしようとしているページの量に応じて、その中にいくつかの検討を置く必要があります。

のWord（またはお好みのワードプロセッサ）

私はすべてのユーザーマニュアルがWordで（ユーザーのヘルプファイルと混同しないように）します。彼らはPDF、RTF、DOCまたはHTMLに変換しさえしている必要があれば、私が判断することができます。マルチユーザの更新の問題を解決するために、私はすべてのそれらの楽しみの事を扱うソース管理にファイルを保存します。

のDocBookなどスコット・マイヤーを使用してのトレードオフの深さでの議論のための Fastwareプロジェクトのブログを参照してください。彼が考えているものの可能性と株式の多くを試してみました。

はAdobe InDesignのCS5.5は、相互参照およびそれ以前のバージョンよりも長い文書ではるかに優れています。それは非常に強力で習得して使用することは比較的容易です。機能セットは非常に豊富で、より多くのあなたはそれについてあなたがそれを行うことができます詳細を学びます。それは非常に強力なXML機能をサポートし、必要に応じてXMLをインポートおよびエクスポートすることができます。また、あなたは、単に文字と段落スタイルのフルセットを使用する場合は、自動化された方法であなたのXMLを作成することを可能にするスタイルにタグとタグにスタイルをマッピングすることができます。私は長年のためのプログラムを使用し、一回限りの広告への本から複数のプロジェクトを生産しています。これは、グラフィックデザインツールですが、書籍やマニュアル制作の多くの側面をサポートしています。あなたは、グラフィックス、画像やイラストをより懸念している場合、私はそれをお勧めします。 InDesignでは、インポートおよびエクスポートフォーマットの広い数をサポートしています。

のInDesign CS5.5を加え、EPUB（電子書籍）とAdobeのデジタル出版スイート（DPS）電子雑誌形式のインタラクティブなコンテンツと輸出の両方のサポートが改善されました。

FrameMakerは書籍、マニュアルや長い技術文書のための優れたツールです。あなたがそれらを使用する方法を学ぶために時間や傾きを持っている場合は、InDesignのより学ぶことは少し難しいですが、変数を構築し、ヘッダとフッタを実行するためのツールの豊かなセットを持っています。また、非常に強力なXMLの機能セットを持っているが、私は個人的にそれを使用していない。

残念ながら、FrameMakerはグラフィックデザインのためのサポートの欠如に苦しんでいます。カラーシステムは、非常にkludgey基づいており、スポット（PMS）の色を定義するのは難しいです。ストロークの色を追加し、色を埋めるような単純なものは、せいぜい初歩的です。たとえば、あなたはまだ色を埋めるオブジェクトは異なるのですストロークの色を選択することはできません。プログラムは、印刷機に実際にレーザ及びインクジェットプリンタに出力するように意図されていない。

本当にクールである一つの特徴は、ページに表示される段落スタイルに基づいて、マスターページを適用する機能です。 FrameMakerで段落/イラストの番号は私が今まで使用している他のプログラムよりも優れています。しかし、習得して使用することも困難である。

両方のプログラムは、PDFやPostScriptファイル形式への出力をサポートし、ハイパーリンクやインタラクティブなコンテンツを生成することができます。

ライセンス： CC-BY-SA と帰属

所属していません StackOverflow