クイック スタート ガイド Version 10 エクセルソフト 株 式 会 社
はじめに このたびは MadCap Software 社 製 品 をご 利 用 いただき 誠 にありがとうございます このクイック スタート ガイドでは 初 めてこの 製 品 を 使 用 される 方 を 対 象 に サンプル プロジェクト の 使 用 方 法 について 説 明 しています 2014 年 4 月 ii
目 次 目 次 1. MadCap Flare 概 要... 4 1.1. はじめに... 4 1.2. FLARE のワークフロー... 5 2. インストール... 6 2.1. FLARE V10 インストールに 必 要 な 環 境... 6 2.2. インストール ファイルのダウンロード... 7 インストールの 開 始... 7 3. Flare の 実 行... 10 3.1. スタートページの 表 示... 10 新 規 プロジェクト 開 始 ウィザード... 10 リボン メニューとクラシック メニューのインターフェース 切 り 替 え... 17 シングルソースからマルチ 出 力 (HTML HELP)... 18 シングルソースからマルチ 出 力 (WEBHELP モバイル)... 19 3.2. トピックの 編 集... 20 3.3. キーワードの 追 加... 21 3.4. 目 次 の 編 集... 22 4. お 問 い 合 わせ... 24 iii
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 に 無 償 バンドルされます MadCap Mimic は ムービー 作 成 ツールです MadCap Lingo でローカライズが 可 能 になります Analyzer は 効 果 的 で 一 貫 したプロジェクトの 改 良 を 提 案 し オーサリングの 作 業 速 度 が 向 上 します Contributor 寄 稿 モードを 使 用 したコンテンツの 寄 稿 または Contributor レビューモードを 使 用 したコメントの 追 加 4
1. MadCap Flare 概 要 1.2. Flare のワークフロー MadCap Flare は 古 いコンテンツをすべてインポートできます Microsoft Word ドキュメント HTML ドキュメント RoboHelp プロジェクト さらには HTML ヘルプ プロジェクトもインポートします MadCap Flare は HTML の XHTML への 直 接 変 換 など XML フォーマットにすべて 変 換 します 5
2. インストール 2. インストール 2.1. Flare v10 インストールに 必 要 な 環 境 推 奨 システム 4096 MB 以 上 のメモリを 推 奨 670 MB 以 上 の 空 きディスク 容 量 Intel Pentium 4 以 上 を 推 奨 32 bit および 64 bit Windows: Windows 7 Windows 8; ( 必 要 なすべての 更 新 を 含 む) Microsoft.NET Framework 4.5.1 (Windows XP の 場 合 は 4.0) サーバーホスティング WebHelp Plus または サーバーベース HTML5 は.NET Framework が 必 要 ソース コントロール 統 合 のサポート: Microsoft Visual SourceSafe 2005, Team Foundation Server 2005, 2008, 2010, 2012 または 2013 (Non Cloud バージョン), Subversion 1.5.3, 1.6, 1.7 または 1.8, および Perforce 2013.1 ビルトインの MathML Equation Editor ( 等 式 エディタ) は Ghostscript および 32 ビット Java ランタイム 環 境 (JRE) version 7.51 が 必 要 サポートする SharePoint 統 合 のバージョン: SharePoint 2007, 2010, および 2013 (SharePoint 365 は 今 回 サポートされません) Distiller 付 き Adobe FrameMaker 7 から 12 (FrameMaker アウトプット/インポート および FrameMaker アウトプットからの PDF 用 )(*1) レビューパッケージ 送 信 用 (オプション): Microsoft Outlook 32 ビットのみ WebHelp アウトプットおよび HTML5 アウトプットは 次 のブラウザをサポートします: Internet Explorer 8 から 11, Firefox 27, および Google Chrome 32 レスポンシブ HTML5 アウトプットは IE 9 より 古 いバージョンをサポートしません 注 意 : コンパイル 時 間 の 減 少 および 最 適 なパフォーマンスのため 7200 rpm またはそれ 以 上 の ハードディスクを 推 奨 します MadCap 製 品 には Microsoft Windows が 必 要 です Windows を 実 行 可 能 にするプログラムを 使 用 し Mac 上 に Windows をインストールする 場 合 Mac 上 で 実 行 する Windows は 同 じような システム 要 件 となります (*1) 日 本 語 版 FrameMaker はサポート 対 象 外 とします Flare は 日 本 語 版 FrameMaker 8.0 ま たはそれ 以 上 をインポートできますが 目 次 の 取 り 込 みができません インポート 後 Flare 内 で 手 動 で 作 成 する 必 要 があります また 日 本 語 ファイル 名 フォルダ 名 はサポートされません 6
2. インストール 2.2. インストール ファイルのダウンロード MadCap Flare のインストール ファイルは 評 価 版 と 同 じファイルです ライセンスキーを 入 力 し ないと 評 価 版 として 動 作 します 評 価 版 には 次 の 制 限 があります: 評 価 期 間 は 30 日 間 です 評 価 版 で 出 力 される 内 容 はランダムに 文 字 が 置 換 ( 文 字 化 け)します インストール ファイルは 次 のサイトからダウンロードできます エクセルソフト 株 式 会 社 の 評 価 版 ダウンロードページ http://www.xlsoft.com/jp/products/madcap/download.html インストールの 開 始 ダウンロードしたファイルをダブルクリックすると インストールが 開 始 します 画 面 の 指 示 に 従 いイン ストール 処 理 をしてください 1. インストールファイル (SetupMadCapFlare10xx.exe) をダブルクリックすると 一 時 ファイルダに 解 凍 するダイアログが' 表 示 されます [Unzip] ボタンをクリックします Unzip ( 解 凍 )をクリックします 一 時 解 凍 フォルダを 指 定 します 2. MadCap Flare の Setup ウィザードが 表 示 されますので 画 面 の 指 示 に 従 ってインストール 操 作 を 進 めます Microsoft SQL Server Compact Edition 4.0 がシステムにインストールされていない 場 合 インス トールするかどうか 確 認 画 面 が 表 示 されます 表 示 さ れた 場 合 は [はい] を 選 択 して Microsoft SQL Server Compact 4.0 SP1 のインストールに 進 みます Microsoft SQL Server Compact 4.0 SP1 のインストールが 完 了 したら [OK] をクリックして MadCap Flare のインストールを 続 行 します 7
2. インストール 3. MadCap Flare のインストールが 完 了 したら MadCap Flare を 起 動 します 最 初 にユーザーイ ンターフェースの 言 語 を 選 択 します 英 語 フランス 語 ドイツ 語 日 本 語 の 中 から 選 択 します Japanese( 日 本 語 ) のユーザー インターフェースを 選 択 します 4. [MadCap Flare のライセンス 認 証 ] ダイアログが 表 示 されます 評 価 版 として 利 用 する 場 合 は [ 評 価 版 として 使 用 ]を 選 択 して [FINISH] ボタンをクリックします 評 価 版 は 30 日 間 利 用 でき ランダムに 出 力 結 果 が 文 字 化 けしますが ソース ファイルは 文 字 化 けしていませんので 製 品 版 を 購 入 した 際 に 使 用 できます 購 入 してライセンスキーを 受 け 取 っている 場 合 [ライセンスコードの 提 供 ] を 選 択 して ライセ ンスの 認 証 処 理 をして インストールしたマシンに Flare ライセンスを 登 録 します 購 入 している 場 合 評 価 版 として 利 用 する 場 合 8
2. インストール 5. 製 品 版 を 購 入 してライセンスキーを 受 け 取 っている 場 合 手 入 力 では 誤 ったコードを 入 力 する 可 能 性 が 高 いため メールで 受 け 取 ったライセンスキーをコピーしては 貼 り 付 けてください ライセンス 認 証 処 理 については 別 途 MadCap Flare v10 のライセンス 認 証 ガイドを 用 意 していますので ご 参 照 ください (1) インターネットで 自 動 認 証 する 場 合 自 動 的 に MadCap Software 社 のライセンス 管 理 サイトに 接 続 し ライセンスが 認 証 され 以 下 の 完 了 ダイアログが 表 示 されます 完 了 画 面 を 確 認 したら ダイアログを 閉 じます (2) 電 話 でライセンス 認 証 インターネット 接 続 ができない 場 合 手 動 によるライセンス 認 証 処 理 が 必 要 になります E メール ライセンスコード ID を 弊 社 までご 連 絡 ください ライセンス 認 証 コードの 発 行 手 続 き をします ライセンス 認 証 コード 発 行 は 米 国 MadCap Software 社 で 行 いますので 2 3 日 ほど かかります ご 連 絡 先 : 下 記 のお 問 い 合 わせページから[ 製 品 価 格 &ライセンス]を 選 択 し 上 記 の 必 要 事 項 をコメント 欄 に 記 載 してください http://www.xlsoft.com/jp/services/contact.html 発 行 されたライセンス 認 証 コードを 上 記 のダイアログにコピーして[ 完 了 ]ボタンをクリックします 6. 製 品 登 録 Flare のライセンス 認 証 が 完 了 すると 製 品 のアップグレード 情 報 を 受 け 取 るための 製 品 登 録 画 面 が 表 示 されます この 製 品 登 録 処 理 は 必 須 ではございません 製 品 のアップデート 情 報 は ヘルプ メニューからも 随 時 確 認 できます 7. これでインストールおよびライセンス 認 証 は 完 了 です 9
3. Flare の 実 行 3.1. スタートページの 表 示 Flare を 実 行 すると 最 初 に [スタートページ] が 表 示 されます 新 規 プロジェクトの 開 始 既 存 プロジェクトを 開 く Flare の 操 作 概 要 のチュートリアル ビデオを 見 る ことができます スタートページには テンプレート チュートリアル ヘルプソースのタブがあります テンプレート: Flare で 作 業 を 開 始 するとき テスト プロジェクトを 作 成 する 前 に テンプレートを 選 択 して どのようにプロジェクトが 構 築 されるかを 見 ることができます 各 種 テンプレートが 用 意 されて いますので 好 みのテンプレートを 選 択 してください チュートリアル: ビデオ チュートリアルが 多 数 用 意 されています 5 分 から 10 分 程 度 のチュートリア ルを 見 て Flare の 機 能 操 作 方 法 などを 理 解 できます ヘルプソース: オンラインヘルプ PDF ガイド 録 画 ウェイビナー ヘルプコミュニティ MadCap ブ ログなどにアクセスできます 新 規 プロジェクト 開 始 ウィザード 新 規 プロジェクト 開 始 ウィザードを 開 くには 次 のようないくつかの 方 法 があります メニューから [ファイル] [ 新 規 プロジェクト] を 選 択 する [スタートページ] の [テンプレート] タブからテンプレートを 選 択 する 10
メニューから 新 規 プロジェクトを 選 択 して サンプル トピックを 含 むテンプレート プロジェクトからクロ ス プラットフォーム 対 応 の HTML5 ヘルプをビルドしてみます 1. [ファイル] メニューから [ 新 規 プロジェクト] を 選 択 します [ 新 規 プロジェクト 開 始 ウィザード] ダイアログが 表 示 されます ここで プロジェクト 名 と 保 存 場 所 およびプロジェクトの 言 語 を 指 定 します 日 本 語 プロジェクトとして 作 成 する 場 合 は ここで 指 定 してください 2. 次 に サンプルとして [テンプレートから 新 規 ] グループから [Knowledge Base Template] を 選 択 します 3. 出 力 するターゲットを HTML5 形 式 にするため 利 用 可 能 ターゲットから [HTML5] を 選 択 11
します 4. サンプル ファイルが 読 み 込 まれ プロジェクトが 生 成 されます Flare の 左 側 のウィンドウには プロジェクト オーガナイザ コンテンツ エクスプローラ が 表 示 され 中 央 のウィンドウにはス タートページ トピックページなどの 編 集 画 面 が 表 示 されます 5. [プロジェクト オーガナイザ] から [ターゲット] の 中 に 追 加 された [HTML5 (プライマリ)] をダ ブルクリックして ターゲットの 詳 細 な 設 定 ができます 12
6. [コンテンツ エクスプローラ] からコンテンツ 内 のトピックをダブルクリックして トピックを 編 集 す ることができます 表 示 される XML エディタ 画 面 では XML ベースのタグ 構 造 も 表 示 されま す テキスト エディタ 画 面 では XML のソースが 表 示 されます どちらのエディタでも 編 集 が できます 7. サンプルのプロジェクトからプライマリ ターゲットとして 設 定 された HTML5 形 式 の WebHelp をビルドします [プロジェクト] メニューから [プライマリのビルド] を 選 択 します 13
8. ビルドが 完 了 したら [ビルド 状 況 ] ダイアログから [ 出 力 の 表 示 ] を 選 択 して 生 成 されたファ イルを 表 示 します 評 価 版 をご 利 用 の 場 合 は ここで 生 成 された 出 力 の 文 字 がランダムにスクランブルされているこ とを 示 す 警 告 メッセージが 表 示 されます 14
9. 生 成 された 結 果 を 表 示 します ブラウザの 表 示 サイズに 応 じて 自 動 的 に 表 示 が 変 わる レスポンシブ HTML5 アウトプット を Flare 10 ではサポートしています デスクトップ タブレットなどサイズの 異 なるアウトプットを 別 々に 生 成 する 必 要 がなくなります 15
10. なお プロジェクトの 言 語 設 定 と 各 ターゲットごとの 言 語 設 定 を 確 認 することを 忘 れないでくださ い この 言 語 設 定 が 正 しく 指 定 されていないと 日 本 語 の 検 索 およびビルドが 正 しく 実 行 されま せん メニューから [プロジェクト] - [プロジェクトのプロパティ] を 選 択 し プロジェクトの 言 語 から Japanese (Japan) を 選 択 します また 各 ターゲットをダブルクリックして [ターゲット エディタ] の [ 言 語 ] タブで 適 切 な 言 語 を 選 択 します 16
リボン メニューとクラシック メニューのインターフェース 切 り 替 え Flare では リボン UI 形 式 が 採 用 され リボン 機 能 クイック アクセス ツールバー 新 しい 入 門 ウィ ザードなどでオーサリングが 向 上 し 使 いやすくなりました 以 前 のバージョンのクラシックなメニュー との 切 り 替 えも 簡 単 にできます [ファイル] メニューの 一 番 下 にある [オプション] を 選 択 し [インターフェース] で[ツール ストリッ プ] 選 択 してください また リボン UI に 戻 す 場 合 は [ツール] メニューから [オプション] メ ニューを 選 択 して メニュースタイルを 切 り 替 えてください 17
シングルソースからマルチ 出 力 (HTML Help) Flare は 同 じプロジェクト ソースから 異 なる 形 式 の 出 力 を 生 成 することができます まず Microsoft HTML Help (CHM ヘルプ) を 生 成 します 1. ターゲットに HTML Help を 追 加 するため [プロジェクト オーガナイザ] ペインの [ターゲット] を 右 クリックし [ターゲットの 追 加 ] を 選 択 します 2. [ 出 力 形 式 ] から [HTML Help] を 選 択 し ターゲットのファイル 名 に 分 かりやすい 名 前 を 指 定 します ここでは CHM Help とします 3. 次 にターゲットの CHM Help を 右 クリックし ポップアップ メニューから[ビルド] を 選 択 し HTML Help を 生 成 します 18
シングルソースからマルチ 出 力 (WebHelp モバイル) Flare では iphone Android BlackBerry などのモバイルデバイス 用 の 出 力 も 生 成 可 能 です 1. 前 のセクションと 同 様 の 手 順 で ターゲットに [WebHelp Mobile] を 追 加 します 2. 次 にターゲットの WebHelp Mobile を 右 クリックし ポップアップ メニューから[ビルド] を 選 択 し モバイル 用 WebHelp を 生 成 します WebHelp モバイルのプレビュー 画 面 19
3.2. トピックの 編 集 [コンテンツ エクスプローラ] で 編 集 するトピックをダブルクリックすると メイン 画 面 に [XML エディ タ] が 開 き そのトピックが 表 示 されます この XML エディタで 直 接 トピックを 編 集 します 表 示 用 レイアウトの 選 択 (Web 用 / 印 刷 用 ) トピックをダブルクリックして XML エディタで 表 示 します または Flare では トピック 画 面 を 分 割 して ソース 画 面 を 表 示 する [テキスト エディタ] 画 面 と ビ ジュアルに XML を 編 集 できる [XML エディタ] 画 面 の 2 つの 画 面 を 同 時 に 表 示 することができ ます ソース 画 面 画 面 分 割 コントロール ビジュアルな 画 面 20
3.3. キーワードの 追 加 [ 表 示 ] リボンメニューから [ 索 引 ウィンドウ] を 選 択 して トピックのキーワード 挿 入 箇 所 にカーソル を 置 き キーワードを 追 加 します 21
3.4. 目 次 の 編 集 [プロジェクト オーガナイザ] で [ 目 次 ] を 開 き [Master (マスター)] をダブルクリックします 目 次 エディタが 開 き 目 次 を 編 集 できます 編 集 したい 目 次 項 目 を 選 択 し 右 クリック メニューで [プロパティ] を 選 択 します [プロパティ] ダイアログで 目 次 にリンクするトピック ファイルなどを 編 集 します 22
プロジェクトをビルドします 以 上 で クイックスタートガイドは 終 了 です MadCap Flare v10 には 豊 富 な 機 能 が 盛 り 込 まれています 詳 細 は Flare Key Features Guide (PDF) または オンラインヘルプを 参 照 してください 23
4. お 問 い 合 わせ 4. お 問 い 合 わせ エクセルソフト 株 式 会 社 ではテクニカル サポートを 下 記 のお 問 い 合 わせ 窓 口 より 承 っております http://www.xlsoft.com/jp/services/xl_form.html エクセルソフト 株 式 会 社 108-0078 東 京 都 港 区 三 田 3 丁 目 9 番 9 号 森 伝 ビル 6 階 http://www.xlsoft.com E-Mail : xlsoftkk@xlsoft.com 24