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

Transcription

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

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

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

4 1. MadCap Flare 概 要 1. MadCap Flare 概 要 1.1. はじめに MadCap Flare は パワフルな 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 での 日 本 語 FrameMaker ファイルの 検 証 は 引 き 続 き 行 っています ) MadCap Flare の 用 途 : 会 社 の 規 定 および 手 順 書 リファレンス ガイド イラスト 付 きのガイドブック ナレッジベース ハードウェアおよび 保 守 マニュアル ソフトウェア ドキュメント 従 業 員 ハンドブック 状 況 依 存 オンライン ヘルプ ユーザー マニュアル 他 多 数 MadCap 製 品 を Flare に 統 合 すると Flare の 機 能 をさらに 強 力 に 拡 張 できます: MadCap Capture は スクリンキャプチャー 用 のツールです Flare 9 に 無 償 バンドルされます MadCap Mimic は ムービー 作 成 ツールです MadCap Lingo でローカライズが 可 能 になります Analyzer は 効 果 的 で 一 貫 したプロジェクトの 改 良 を 提 案 し オーサリングの 作 業 速 度 が 向 上 します Contributor 寄 稿 モードを 使 用 したコンテンツの 寄 稿 または Contributor レビューモードを 使 用 したコメントの 追 加 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) (4096 MB 以 上 を 推 奨 ) 400 MB 以 上 の 空 きディスク 容 量 Intel Pentium 4 以 上 を 推 奨 32 bit および 64 bit Windows: Windows XP (SP2 またはそれ 以 降 ) Windows Vista (Service Pack 1) Windows Server 2003 Windows 7 Windows 8; ( 必 要 なすべての 更 新 を 含 む) Microsoft.NET Framework 4.0 またはそれ 以 降 Microsoft SQL Compact Edition 4.0 (Flare の 最 初 の 実 行 時 にインストールされます) Microsoft Internet Explorer 7.0 またはそれ 以 降 Adobe Acrobat Reader Java Runtime Environment (JRE) またはそれ 以 降 (Adobe AIR コンパイル 用 等 式 エ ディタの 利 用 のため) オプション:Microsoft Word 2003 またはそれ 以 上 最 新 のサービスパック 適 用 (Word 出 力 用 ) オプション:Microsoft Outlook 2003 またはそれ 以 上 (32bit のみ) (レビューパッケージ 送 信 用 ) オプション:Adobe FrameMaker version 7.0 またはそれ 以 上 (Distiller 付 き) (FrameMaker 出 力 および FrameMaker 出 力 からの PDF 用 ) (*1) オプション:Adobe AIR 出 力 のレビュー 用 : Adobe AIR Runtime オプション:バージョン 管 理 : Microsoft Visual SourceSafe 2005 Team Foundation Server または 2010 Subversion またはそれ 以 降 オプション: 等 式 エディタの 使 用 および 等 式 を 含 む PDF の 生 成 : Design Science Ghostscript WebHelp 出 力 用 のサポートされる Web ブラウザ: Internet Explorer 7.0 またはそれ 以 降 Firefox 3.5 またはそれ 以 降 Safari 4.0 またはそれ 以 降 Google Chrome HTML5 出 力 用 のサポートされる Web ブラウザ: Internet Explorer 8 またはそれ 以 降 Firefox 10 またはそれ 以 降 Google Chrome 13 またはそれ 以 降 (*1) ただし 日 本 語 版 FrameMaker はサポート 対 象 外 とします ( 日 本 語 版 FrameMaker 8.0 また はそれ 以 上 をインポートしますが 目 次 の 取 り 込 みができません インポート 後 Flare 内 で 手 動 によ り 作 成 する 必 要 があります また 日 本 語 ファイル 名 フォルダ 名 はサポートされません ) 6

7 2. インストール 2.2. インストール ファイルのダウンロード MadCap Flare のインストール ファイルは 評 価 版 と 同 じファイルです ライセンスキーを 入 力 し ないと 評 価 版 として 動 作 します 評 価 版 には 次 の 制 限 があります: 評 価 期 間 は 30 日 間 です 評 価 版 で 出 力 される 内 容 はランダムに 文 字 が 置 換 ( 文 字 化 け)します インストール ファイルは 次 のサイトからダウンロードできます エクセルソフト 株 式 会 社 の 評 価 版 ダウンロードページ インストールの 開 始 ダウンロードしたファイルをダブルクリックすると インストールが 開 始 します 画 面 の 指 示 に 従 いイン ストール 処 理 をしてください 1. インストールファイル (SetupMadCapFlare09xx.exe) をダブルクリックすると 一 時 ファイルダに 解 凍 するダイアログが' 表 示 されます [Unzip] ボタンをクリックします Unzip ( 解 凍 )をクリックします 一 時 解 凍 フォルダを 指 定 します 2. MadCap Flare の Setup ウィザードが 表 示 されますので 画 面 の 指 示 に 従 ってインストール 操 作 を 進 めます 7

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

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

10 2. インストール 5. 製 品 版 を 購 入 してライセンスキーを 受 け 取 っている 場 合 手 入 力 では 誤 ったコードを 入 力 する 可 能 性 が 高 いため メールで 受 け 取 ったライセンスキーをコピーしては 貼 り 付 けてください ライセンス 認 証 処 理 については 別 途 MadCap Flare v9 のライセンス 認 証 ガイドを 用 意 し ていますので ご 参 照 ください (1) インターネットで 自 動 認 証 する 場 合 自 動 的 に MadCap Software 社 のライセンス 管 理 サイトに 接 続 し ライセンスが 認 証 され 以 下 の 完 了 ダイアログが 表 示 されます 完 了 画 面 を 確 認 したら ダイアログを 閉 じます (2) 電 話 でライセンス 認 証 インターネット 接 続 ができない 場 合 手 動 によるライセンス 認 証 処 理 が 必 要 になります E メール ライセンスコード ID を 弊 社 までご 連 絡 ください ライセンス 認 証 コードの 発 行 手 続 き をします ライセンス 認 証 コード 発 行 は 米 国 MadCap Software 社 で 行 いますので 2 3 日 ほど かかります ご 連 絡 先 : 下 記 のお 問 い 合 わせページから[ 製 品 価 格 &ライセンス]を 選 択 し 上 記 の 必 要 事 項 をコメント 欄 に 記 載 してください 発 行 されたライセンス 認 証 コードを 上 記 のダイアログにコピーして[ 完 了 ]ボタンをクリックします 6. 製 品 登 録 Flare のライセンス 認 証 が 完 了 すると 製 品 のアップグレード 情 報 を 受 け 取 るための 製 品 登 録 画 面 が 表 示 されます この 製 品 登 録 処 理 は 必 須 ではございません 製 品 のアップデート 情 報 は ヘルプ メニューからも 随 時 確 認 できます 7. これでインストールおよびライセンス 認 証 は 完 了 です 10

11 3. Flare の 実 行 3.1. 入 門 ウィザードの 実 行 Flare を 実 行 すると 最 初 に [ 入 門 ウィザード] ダイアログが 表 示 されます 新 規 プロジェクトの 開 始 既 存 プロジェクトを 開 く Flare の 操 作 概 要 のチュートリアル ビデオを 見 ることができます サンプル プロジェクトのビルド New Project ( 新 規 プロジェクト) を 選 択 して サンプル トピックを 含 むテンプレート プロジェクトから クロス プラットフォーム 対 応 の HTML5 ヘルプをビルドしてみます 1. [ 入 門 ウィザード] から [New Project] を 選 択 します [ 新 規 プロジェクト 開 始 ウィザード] ダイア ログが 表 示 されます ここで プロジェクト 名 と 保 存 場 所 およびプロジェクトの 言 語 を 指 定 しま す 日 本 語 プロジェクトとして 作 成 する 場 合 は ここで 指 定 してください 11

12 2. 次 に サンプルとして [テンプレートから 新 規 ] グループから [Knowledge Base Template] を 選 択 します 3. 出 力 するターゲットを HTML5 形 式 にするため 利 用 可 能 ターゲットから [MyHTML5] を 選 択 します 4. サンプル ファイルが 読 み 込 まれ プロジェクトが 生 成 されます Flare の 左 側 のウィンドウには プロジェクト オーガナイザ コンテンツ エクスプローラ が 表 示 され 中 央 のウィンドウにはス タートページ トピックページなどの 編 集 画 面 が 表 示 されます 5. [プロジェクト オーガナイザ] から [ターゲット] の 中 に 追 加 された [MyHTML5 (プライマリ)] をダブルクリックして ターゲットの 詳 細 な 設 定 ができます 12

13 6. [コンテンツ エクスプローラ] からコンテンツ 内 のトピックをダブルクリックして トピックを 編 集 す ることができます 表 示 される XML エディタ 画 面 では XML ベースのタグ 構 造 も 表 示 されま す 7. サンプルのプロジェクトからプライマリ ターゲットとして 設 定 された HTML5 形 式 の WebHelp をビルドします [プロジェクト] メニューから [プライマリのビルド] を 選 択 します 13

14 8. ビルドが 完 了 したら [ビルド 状 況 ] ダイアログから [ 出 力 の 表 示 ] を 選 択 して 生 成 されたファ イルを 表 示 します 評 価 版 をご 利 用 の 場 合 は ここで 生 成 された 出 力 の 文 字 がランダムにスクランブルされているこ とを 示 す 警 告 メッセージが 表 示 されます 14

15 9. 生 成 された 結 果 を 表 示 します 15

16 10. なお プロジェクトの 言 語 設 定 と 各 ターゲットごとの 言 語 設 定 を 確 認 することを 忘 れないでくださ い この 言 語 設 定 が 正 しく 指 定 されていないと 日 本 語 の 検 索 およびビルドが 正 しく 実 行 されま せん メニューから [プロジェクト] - [プロジェクトのプロパティ] を 選 択 し プロジェクトの 言 語 から Japanese (Japan) を 選 択 します また 各 ターゲットをダブルクリックして [ターゲット エディタ] の [ 言 語 ] タブで 適 切 な 言 語 を 選 択 します 16

17 リボン メニューとクラシック メニューのインターフェース 切 り 替 え Flare 9 では リボン UI 形 式 が 採 用 され リボン 機 能 クイック アクセス ツールバー 新 しい 入 門 ウィザードなどでオーサリングが 向 上 し 使 いやすくなりました 以 前 のバージョンのクラシックなメ ニューとの 切 り 替 えも 簡 単 にできます [ファイル] メニューの 一 番 下 にある [オプション] を 選 択 し [インターフェース] で[ツール ストリッ プ] 選 択 してください また リボン UI に 戻 す 場 合 は [ツール] メニューから [オプション] メ ニューを 選 択 して メニュースタイルを 切 り 替 えてください 17

18 シングルソースからマルチ 出 力 (HTML Help) Flare は 同 じプロジェクト ソースから 異 なる 形 式 の 出 力 を 生 成 することができます まず Microsoft HTML Help (CHM ヘルプ) を 生 成 します 1. ターゲットに HTML Help を 追 加 するため [プロジェクト オーガナイザ] ペインの [ターゲッ ト] を 右 クリックし [ターゲットの 追 加 ] を 選 択 します 2. [ 出 力 形 式 ] から [HTML Help] を 選 択 し ターゲットのファイル 名 に 分 かりやすい 名 前 を 指 定 します ここでは CHM Help とします 3. 次 にターゲットの CHM Help を 右 クリックし ポップアップ メニューから[ビルド] を 選 択 し HTML Help を 生 成 します 18

19 シングルソースからマルチ 出 力 (WebHelp モバイル) Flare V8 では iphone Android BlackBerry などのモバイルデバイス 用 の 出 力 も 生 成 可 能 です 1. 前 のセクションと 同 様 の 手 順 で ターゲットに [WebHelp Mobile] を 追 加 します 2. 次 にターゲットの WebHelp Mobile を 右 クリックし ポップアップ メニューから[ビルド] を 選 択 し モバイル 用 WebHelp を 生 成 します WebHelp モバイルのプレビュー 画 面 19

20 3.2. トピックの 編 集 [コンテンツ エクスプローラ] で 編 集 するトピックをダブルクリックすると メイン 画 面 に [XML エディ タ] が 開 き そのトピックが 表 示 されます この XML エディタで 直 接 トピックを 編 集 します 表 示 用 レイアウトの 選 択 (Web 用 / 印 刷 用 ) トピックをダブルクリックして XML エディタで 表 示 します または Flare 9 では トピック 画 面 を 分 割 して ソース 画 面 を 表 示 する [テキスト エディタ] 画 面 と ビジュアルに XML を 編 集 できる [XML エディタ] 画 面 の 2 つの 画 面 を 同 時 に 表 示 することがで きます ソース 画 面 画 面 分 割 コントロール ビジュアルな 画 面 20

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

22 3.4. 目 次 の 編 集 [プロジェクト オーガナイザ] で [ 目 次 ] を 開 き [Master (マスター)] をダブルクリックします 目 次 エディタが 開 き 目 次 を 編 集 できます 編 集 したい 目 次 項 目 を 選 択 し 右 クリック メニューで [プロパティ] を 選 択 します [プロパティ] ダイアログで 目 次 にリンクするトピック ファイルなどを 編 集 します 22

23 プロジェクトをビルドします 以 上 で クイックスタートガイドは 終 了 です MadCap Flare v9 には 豊 富 な 機 能 が 盛 り 込 まれています 詳 細 は Flare Key Features Guide (PDF) または オンラインヘルプを 参 照 してください 23

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