MadCap Flare V6 クイック スタート ガイド

Transcription

1 クイック スタート ガイド Version 6.0 エクセルソフト 株 式 会 社

2 はじめに はじめに このたびは MadCap Software 社 製 品 をご 利 用 いただき 誠 にありがとうございます このクイック スタート ガイドでは 初 めてこの 製 品 を 使 用 される 方 を 対 象 に インストールの 手 順 およ びサンプル プロジェクトの 使 用 方 法 について 説 明 しています 2010 年 3 月 ii

3 目 次 目 次 1. MadCap Flare 概 要 はじめに FLARE のワークフロー インストール インストールに 必 要 な 環 境 インストール ファイルのダウンロード...6 インストールの 開 始 Flare の 実 行 入 門 ウィザードの 実 行...13 サンプル プロジェクトのビルド...13 シングルソースからマルチ 出 力 (HTML HELP)...19 シングルソースからマルチ 出 力 (WEBHELP モバイル) トピックの 編 集 キーワードの 追 加 目 次 の 編 集 お 問 い 合 わせ iii

4 1. MadCap Flare 概 要 1. MadCap Flare 概 要 1.1. はじめに MadCap Flare V6 は パワフルな XML ベースのプロフェッショナル 仕 様 のコンテンツ オーサリン グとパブリッシング ソフトウェア 製 品 です テクニカル ライターおよびドキュメントの 専 門 家 がマル チ チャンネル パブリッシング 用 のコンテンツを 作 成 し 管 理 することができます 複 雑 なデジタル 印 刷 パブリッシング デスクトップ パブリッシング ヘルプ システム Web ベースのオンライン パブ リッシングなどのプロジェクトを 作 成 する 場 合 MadCap Flare は プロフェッショナルなヘルプ オー サリングとコンテンツ 開 発 ツールのすべてを 提 供 します PDF XPS Word FrameMaker(* 注 1) DITA 統 合 されたナビゲーション 付 きの XHTML (クロスブ ラウザ クロスプラットフォーム) Microsoft HTML ヘルプ モバイル プラットフォーム(iPhone OS Windows Mobile Android BlackBerry) DotNet Help を MadCap Flare を 使 用 してパブリッシュで きます (* 注 1) 日 本 語 版 FrameMaker はサポート 対 象 外 とします Flare は 日 本 語 版 FrameMaker 8.0 またはそれ 以 上 をインポートできますが 目 次 の 取 り 込 みができないことがあります インポート 後 Flare 内 で 手 動 により 作 成 する 必 要 があります また 日 本 語 ファイル 名 フォルダ 名 はサポートされ ません (なお Flare v6 での 日 本 語 FrameMaker ファイルの 検 証 は 引 き 続 き 行 っています ) MadCap Flare の 用 途 : 会 社 の 規 定 および 手 順 書 リファレンス ガイド イラスト 付 きのガイドブック ナレッジベース ハードウェアおよび 保 守 マニュアル ソフトウェア ドキュメント 従 業 員 ハンドブック 状 況 依 存 オンライン ヘルプ ユーザー マニュアル 他 多 数 MadCap 製 品 を Flare に 統 合 すると Flare の 機 能 をさらに 強 力 に 拡 張 できます: Feedback サーバーは 作 成 したドキュメントのユーザー 利 用 に 関 するレポートを 提 供 します Mimic Capture Echo は マルチメディア パブリッシング 統 合 を 提 供 します MadCap Lingo でローカライズが 可 能 になります Analyzer は 効 果 的 で 一 貫 したプロジェクトの 改 良 を 提 案 し オーサリングの 作 業 速 度 が 向 上 します X-Edit 寄 稿 モードを 使 用 したコンテンツの 寄 稿 または X-Edit レビューモードを 使 用 したコメ ントの 追 加 4

5 1. MadCap Flare 概 要 1.2. Flare のワークフロー MadCap Flare は 古 いコンテンツをすべてインポートできます Microsoft Word ドキュメント HTML ドキュメント RoboHelp プロジェクト さらには HTML ヘルプ プロジェクトもインポートし ます MadCap Flare は HTML の XHTML への 直 接 変 換 など XML フォーマットにすべて 変 換 します 5

6 2. インストール 2. インストール 2.1. インストールに 必 要 な 環 境 推 奨 システム 1024 MB メモリ (RAM) 420 MB の 空 きディスク 容 量 Intel Pentium 4 以 上 を 推 奨 32 bit および 64 bit Windows: Windows XP (SP2 またはそれ 以 降 ) Windows Vista Windows 7 Microsoft.NET Framework 3.5 SP1 Microsoft SQL Compact Edition 3.5 SP1 Microsoft Word 2003 またはそれ 以 上 ( 最 新 の Service Pack 適 用 ) (Word Output 用 ) Adobe FrameMaker version 6.0 またはそれ 以 上 (Distiller 込 み) (FrameMaker 出 力 と FrameMaker 出 力 からの PDF 用 ) ただし 日 本 語 版 FrameMaker はサポート 対 象 外 とします (* 注 1) Microsoft Internet Explorer 7.0 またはそれ 以 降 Adobe Acrobat Reader Java Runtime Environment (JRE) (Adobe AIR コンパイル 用 ) Adobe AIR アウトプット 表 示 用 のオプション: Adobe AIR Runtime 2.2. インストール ファイルのダウンロード MadCap Flare のインストール ファイルは 評 価 版 と 同 じファイルです ライセンスキーを 入 力 し ないと 評 価 版 として 動 作 します 評 価 版 の 製 品 は 以 下 の 通 りです: 評 価 期 間 は 30 日 間 です 評 価 版 で 出 力 される 内 容 はランダムに 文 字 が 置 換 ( 文 字 化 け)します インストール ファイルは 次 のサイトからダウンロードできます エクセルソフト 株 式 会 社 の 評 価 版 ダウンロードページ 6

7 2. インストール インストールの 開 始 ダウンロードしたファイルをダブルクリックすると インストールが 開 始 します 画 面 の 指 示 に 従 いイン ストール 処 理 をしてください 1. インストールファイル (SetupMadCapFlare0600.exe) をダブルクリックすると 一 時 ファイルダに 解 凍 するダイアログが' 表 示 されます [Unzip] ボタンをクリックします Unzip( 解 凍 ) をクリックします 一 時 解 凍 フォルダを 指 定 します 2. MadCap Flare V6 の Setup ウィザードが 表 示 されますので 画 面 の 指 示 に 従 ってインストール 操 作 を 進 めます [Instant Messaging (インスタント メッセージ)] ダイアログが 表 示 されたら 必 要 に 応 じて Flare 製 品 で 有 効 にするか 無 効 にするか 選 択 します 7

8 2. インストール 3. Microsoft SQL Server Compact Edition 3.5 SP1 がシステムにインストールされていない 場 合 インストールするかどうか 確 認 画 面 が 表 示 されます 表 示 されたる 場 合 は [はい] を 選 択 して Microsoft SQL Server Compact 3.5 SP1 のインストールに 進 みます Microsoft SQL Server Compact 3.5 SP1 のインストールが 完 了 したら [OK] をクリックして Flare V6 のインストールを 続 行 します 8

9 2. インストール 4. Flare V6 のインストールが 完 了 したら Flare を 起 動 します 最 初 にユーザーインターフェース の 言 語 を 選 択 します 英 語 フランス 語 ドイツ 語 日 本 語 の 中 から 選 択 します Japanese( 日 本 語 ) のユーザー インターフェースを 選 択 します 5. [MadCap Flare V6 を 登 録 ] ダイアログが 表 示 されます 評 価 版 として 利 用 する 場 合 は [ソフ トウェアを 試 用 ]を 選 択 します 購 入 してライセンスキーを 受 け 取 っている 場 合 [ライセンスキー が 有 る] を 選 択 します 購 入 している 場 合 評 価 版 として 利 用 する 場 合 評 価 版 は 30 日 間 利 用 でき ランダムに 出 力 結 果 が 文 字 化 けしますが ソース ファイルは 文 字 化 けしていませんので 製 品 版 を 購 入 した 際 に 使 用 できます 9

10 2. インストール 6. 製 品 版 を 購 入 してライセンスキーを 受 け 取 っている 場 合 手 入 力 では 誤 ったコードを 入 力 する 可 能 性 が 高 いため メールで 受 け 取 ったキーをコピーしては 貼 り 付 けてください 入 力 ミスを 防 ぐため ライセンスコードを コピー&ペースト 7. 登 録 方 法 を 選 択 します 登 録 方 法 を 選 択 します 10

11 2. インストール (1) インターネットで 登 録 MadCap Software 社 のライセンス 管 理 サーバーに 自 動 接 続 し 認 証 後 に 折 り 返 し 確 認 メール が 送 信 されますので メールを 確 認 して [Complete Registration ( 登 録 完 了 )] のリンクをクリック してください ( 自 動 返 信 のメール 例 ) [Complete Registration ( 登 録 完 了 )] を クリックします ブラウザに 登 録 完 了 の 画 面 が 表 示 されます 完 了 画 面 を 確 認 したら ブラウザを 閉 じます 11

12 2. インストール (2) 電 話 で 登 録 登 録 する E メールを 入 力 します 申 請 後 に 発 行 された 登 録 コードを コピー 入 力 します E メール ライセンスコード ID を 弊 社 までご 連 絡 ください 登 録 コード(Registration code) の 発 行 手 続 きをします 登 録 コード 発 行 は 米 国 MadCap Software 社 で 行 いますので 2 日 ほどかか ります ご 連 絡 先 : 下 記 のお 問 い 合 わせページから[ 製 品 価 格 &ライセンス]を 選 択 し 上 記 の 必 要 事 項 をコメント 欄 に 記 載 してください 発 行 された 登 録 コードを 上 記 のダイアログにコピーして[ 完 了 ]ボタンをクリックします (3) 後 で 登 録 Flare を 登 録 せずに 利 用 できますが 登 録 が 完 了 するまでは 下 記 の 項 目 を 利 用 できません テクニカル サポートへのお 問 い 合 わせ コマンド ライン コンパイル 機 能 製 品 アップグレードなどの 重 要 な 通 知 の 受 け 取 り 8. これで インストールは 完 了 です 12

13 3. Flare の 実 行 3. Flare の 実 行 3.1. 入 門 ウィザードの 実 行 Flare を 実 行 すると 最 初 に [ 入 門 ウィザード]ダイアログが 表 示 されます Flare の 操 作 概 要 のチュー トリアル ビデオ サンプル プロジェクトを 開 く 新 規 プロジェクトの 開 始 Word や 他 のヘルプ プロ ジェクトをインポートすることができます サンプル プロジェクトのビルド サンプル プロジェクトを 使 用 して クロス プラットフォーム 対 応 の Web ヘルプをビルドしてみます 1. [ 入 門 ウィザード] から [サンプル プロジェクトを 開 く] を 選 択 します 次 に [Application Help Sample] を 選 択 し プロジェクト 名 と 保 存 場 所 を 指 定 します Application Help Sample を 選 択 します プロジェクト 名 と 保 存 場 所 を 指 定 します 13

14 3. Flare の 実 行 2. [プロジェクトを 作 成 ] を 選 択 します [プロジェクトを 作 成 ] を 選 択 します 3. サンプル ファイルが 読 み 込 まれ プロジェクトが 生 成 されます Flare の 左 側 のウィンドウには プロジェクト オーガナイザ コンテンツ エクスプローラ が 表 示 され 中 央 のウィンドウにはス タートページ トピックページなどの 編 集 画 面 が 表 示 されます Welcome.htm トピック コンテンツ エクスプローラ スタートページ 14

15 3. Flare の 実 行 4. 上 記 のメイン 画 面 の 右 側 から [コンテンツ エクスプローラ] を 選 択 します 表 示 されたトピック のツリー 表 示 から Welcome.htm をダブルクリックして トピックを 中 央 の 作 業 ウィンドウに 表 示 します この 編 集 ウィンドウで 直 接 コンテンツ を 編 集 できます XML ベースのタグ 構 造 を 表 示 5. 次 に 左 のウィンドウから [プロジェクト オーガナイザ] を 選 択 し ターゲットが MyWebHelp (プラ イマリ) であることを 確 認 します MyWebHelp は 分 かりやすい 名 前 に 変 更 することもできます プロジェクト オーガナイザ 15

16 3. Flare の 実 行 6. 次 にプロジェクトの 言 語 設 定 と 各 ターゲットごとの 言 語 設 定 を 指 定 します この 言 語 設 定 が 正 し く 指 定 されていないと 日 本 語 の 検 索 およびビルドが 正 しく 実 行 されません メニューから [プロジェクト] - [プロジェクトのプロパティ] を 選 択 し プロジェクトの 言 語 から Japanese (Japan) を 選 択 します 16

17 3. Flare の 実 行 7. 次 に 左 のウィンドウのプロジェクト オーガナイザのターゲットから MyWebhelp (プライマリ) を ダブルクリックして [ターゲット エディタ] から[ 言 語 ] タブを 選 択 し 言 語 リストから [Japanese (Japan)] を 選 択 します 8. これで プロジェクトの 基 本 設 定 は 完 了 です 次 に WebHelp を 生 成 するために このターゲッ トをビルドします メニューから[ビルド] - [プライマリをビルド] を 選 択 します 17

18 3. Flare の 実 行 9. [ビルド 状 況 ] ダイアログが 表 示 されます 完 了 したら [ 出 力 の 表 示 ] をクリックして 生 成 された WebHelp を 表 示 します 生 成 された WebHelp がブラウザで 表 示 されます ターゲットで 設 定 した 言 語 でメニュー 項 目 ( 目 次 キーワードなど)がアコーディオンタブに 表 示 されます 18

19 3. Flare の 実 行 シングルソースからマルチ 出 力 (HTML Help) Flare は 同 じプロジェクト ソースから 異 なる 形 式 の 出 力 を 生 成 することができます まず Microsoft HTML Help (CHM ヘルプ) を 生 成 します 1. ターゲットの 中 から MyHtmlHelp をダブルクリックして ターゲット エディタを 開 き [ 言 語 タブ] を 選 択 し Japanese (Japan) を 選 択 します 2. 次 にターゲットの MyHtmlHelp を 右 クリックし ポップアップ メニューから[ビルド] を 選 択 し HTML Help を 生 成 します ダブルクリックして HTML Help ターゲットの 言 語 設 定 で Japanese (Japan) を 選 択 します 右 クリック メニューから [ビルド] を 選 択 します 生 成 された HTML Help を 表 示 します 19

20 3. Flare の 実 行 シングルソースからマルチ 出 力 (WebHelp モバイル) Flare V6 では iphone Android BlackBerry などのモバイルデバイス 用 の 出 力 も 生 成 可 能 です 1. ターゲットの 中 から MyWebHelpMobile をダブルクリックして ターゲット エディタを 開 き [ 言 語 タブ] を 選 択 し Japanese (Japan) を 選 択 します 次 にターゲットの MywebHelpMobile を 右 クリックし ポップアップ メニューから[ビルド] を 選 択 し モバイル 用 WebHelp を 生 成 します ダブルクリックして MyWebHelpMobile ターゲット の 言 語 設 定 で Japanese (Japan) を 選 択 します 右 クリック メニューから [ビルド] を 選 択 します WebHelp モバイルのプレビュー 画 面 20

21 3. Flare の 実 行 3.2. トピックの 編 集 [コンテンツ エクスプローラ] で 編 集 するトピックをダブルクリックすると メイン 画 面 に [XML エディ タ] が 開 き そのトピックが 表 示 されます この XML エディタで 直 接 トピックを 編 集 します 表 示 レイアウトの 選 択 (Web 用 / 印 刷 用 ) ダブルクリックして トピックを XML エディタで 表 示 します または トピックを 右 クリックして [プログラムから 開 く] - [ 内 部 テキストエディタ] を 選 択 して テキスト ベースで 直 接 XML ファイル 上 のタグを 編 集 することもできます (XML ファイルのタグなどを 熟 知 している 場 合 にご 利 用 ください ) 21

22 3. Flare の 実 行 3.3. キーワードの 追 加 [ 索 引 ウィンドウ] を 選 択 して トピックのキーワード 挿 入 箇 所 にカーソルを 置 き キーワードを 追 加 し ます 22

23 3. Flare の 実 行 3.4. 目 次 の 編 集 [プロジェクト オーガナイザ] で [ 目 次 ] を 開 き [Primary TOC (マスター)] をダブルクリックします 目 次 エディタが 開 き 目 次 を 編 集 できます 編 集 したい 目 次 項 目 を 選 択 し 右 クリック メニューで [プロパティ] を 選 択 します 23

24 3. Flare の 実 行 [プロパティ] ダイアログで 目 次 にリンクするトピック ファイルなどを 編 集 します プロジェクトをビルドします 以 上 で クイックスタートガイドは 終 了 です MadCap Flare v6 には 豊 富 な 機 能 が 盛 り 込 まれています 詳 細 は Getting Started Guide (PDF) または オンラインヘルプを 参 照 してください 24

25 4. お 問 い 合 わせ 4. お 問 い 合 わせ エクセルソフト 株 式 会 社 ではテクニカル サポートを 下 記 のお 問 い 合 わせ 窓 口 より 承 っております エクセルソフト 株 式 会 社 東 京 都 港 区 芝 5 丁 目 1 番 9 号 豊 前 屋 ビル 4 階 [email protected] 25