2.1.1 インストールオプション

1. アドイン登録／解除アイコンをデスクトップへ設定する

本オプション・チェックボックスにチェックすると、Microsoft Wordのリボンにアドインを登録するプログラムと、そのアドイン登録を解除するプログラムのふたつのアイコンがデスクトップに配置されます。

アドインの登録と登録解除については、「第4章アドインの利用方法」を参照してください。

2. インストール完了後に、ReadMeファイルを読む

本オプションのチェックボックスにチェックすると、インストールが完了したとき、インストーラに同梱されているReadMe.txtファイルをメモ帳で画面に表示します。

2.2.1 評価版

評価版は本製品のWebページから入手できます。

評価版のインストールが完了すると、インストール先のフォルダーに、30日間評価版のライセンス・データを内容とするライセンス・ファイルが設定されます。

評価版は機能制限がなく、正式版と同じ機能を使えます。但し、評価版の使用期間は30日間に限定されており、インストールしてから30日を過ぎるとコマンドライン版を起動することができなくなります。継続してお使いいただくには、アンテナハウスのオンラインショップで正式版をお求めいただく必要があります。

アンテナハウスのオンラインショップ

https://web.antenna.co.jp/shop/html/

2.2.2 正式ライセンス

本製品を購入された場合、正式ライセンスデータ（ライセンス・ファイル）とライセンス証書が提供されます。ライセンス・ファイル名は「xhwlic.dat」です。

正式ライセンスに切り替えるには、ライセンス・ファイルをコマンドライン版プログラム（Word2HTML.exe）と同じフォルダーにコピーしてください。

コマンドライン版プログラムのインストール先フォルダーのデフォルトは、次のとおりです。

C:\Program Files\Antenna House\xhw12

このフォルダーへの書き込みには管理者権限が必要なため正式ライセンス・ファイルをコピーしようとすると次の警告ダイアログが表示されます。

管理者権限をもっていない場合は、管理者にコピーを依頼してください。

3.4.1 デフォルト設定ファイル

デフォルト設定ファイルを使うとデフォルト動作を切り替えることができます。デフォルト設定ファイルのファイル名は、「def-settings.xml」で、ファイルの保存場所は次の2か所のどちらかです。

1. EXEファイル（Word2HTML.exe）と同じフォルダー
2. Roamingフォルダー

デフォルト設定ファイルをEXEファイルと同じフォルダーに置いた場合、全ユーザー共通のデフォルト値となります。

デフォルト設定ファイルをRoamingフォルダーに置くと、ユーザー毎に異なるデフォルト設定ファイルとなります。Roamingフォルダーのデフォルト設定ファイルのパスは、通常、次のとおりです。

C:\Users\USER\AppData\Roaming\AntennaHouse\xhw\1.2\def-settings.xml

デフォルト設定ファイル上記2か所の両方にあるときは、Roamingフォルダーにあるデフォルト設定ファイルの内容が優先されます。

デフォルト設定ファイルに、ON/OFFタイプの変換オプションの設定があるとき、同じ変換オプションを、アドインまたはコマンドラインのパラメータで指定すると、ON/OFFが反転するので注意してください。

変換オプションの「-savedefault」パラメータを指定すると、Roamingフォルダーにデフォルト設定ファイル（def-settings.xml）を作成できます。デフォルト設定ファイルはXML形式なのでテキスト・エディタで編集できます。

例えば、コマンドラインで次のように指定すると、①ブロックタグの終わりに改行を出力する（-endl）、②下線を<u>タグとして出力する（-underline t）が設定されたデフォルト設定ファイルが作成されます。

また、次のように指定すると、デフォルト設定ファイルの設定値をすべてクリアして、本プログラム自体のデフォルト設定に戻したデフォルト設定ファイルが作成されます。

次は変換オプション・パラメータとして「-clrsettings -savedefault」を指定して作成されるデフォルト設定ファイルです。デフォルト値のないパラメータは設定されません。

<?xml version="1.0"?>
<word-to-html-settings>
<enable-XHTML enable="false"/>
<viewport content=""/>
<enable-endl enable="false"/>
<enable-empty-paragraph enable="false"/>
<enable-non-reference-id enable="false"/>
<enable-image-width enable="false"/>
<enable-heading-strong enable="true"/>
<enable-embed-image enable="false"/>
<enable-mathml enable="false"/>
<xml-mathml enable="false"/>
<xml-omath enable="false"/>
<through-image enable="false"/>
<enable-pstyle enable="false"/>
<enable-citation enable="false"/>
<text-color enable="false"/>
<output-br enable="false"/>
<style-tag enable="true"/>
<space-indent enable="false"/>
<fil-images enable="false"/>
<italic out="n"/>
<underline out="n"/>
<linethrough out="n"/>
</word-to-html-settings>

3.4.2 変換オプション設定ファイル

変換オプション設定ファイルは、変換オプションのパラメータ値を保存するファイルです。

コマンドライン実行時に、変換オプション設定ファイル名を指定して読み込みます。

同じ設定による変換を繰り返すとき、変換オプションを設定ファイルに保存しておくと、次回から同一のオプションを指定する代わりに設定ファイルの指定で済みます。

変換オプション設定ファイルのファイル名は任意です。

変換オプション設定ファイルはコマンドライン実行時に、変換オプションの「-savesettings」で指定したファイルとして作成できます。

変換オプション設定ファイルはXML形式なので、パラメータ設定値をテキスト・エディタで修正できます。

3.4.3 設定ファイルの形式

設定ファイルはルート要素が「word-to-html-settings」で、変換オプションに設定する項目を子供の要素型名とするXMLファイルです。デフォルト設定ファイルと変換オプション設定ファイルの形式は同じです。各要素型名と変換オプションのパラメータの対応関係は次の表のとおりです。

4.1.1 アドイン登録

アドインを登録するには、Wordを終了した状態で、デスクトップの「HTML on Word」アドイン登録アイコンをクリックします。

インストールの際、デスクトップにアドイン登録アイコンを作成しなかった場合は、次のようにします。

1. 「HTML on Word」のインストール先フォルダーにコピーされている、アドイン登録用のプログラムを探す。
2. アドイン登録用プログラムファイル（install.vbs）をダブルクリックします。

4.1.2 アドイン登録解除

アドイン登録を解除するには、Wordを終了した状態で、デスクトップの「HTML on Word」アドイン登録解除アイコンをクリックします。

インストールの際、デスクトップにアドイン登録解除アイコンを作成しなかった場合は、次のようにします。

1. 「HTML on Word」インストール先フォルダーにコピーされているアドイン登録解除用のプログラムを探す。
2. アドイン登録解除用プログラムファイル（uninstall.vbs）をダブルクリックします。

4.4.1 変換結果を表示するアプリケーションの指定

「HTMLへ変換」が終了すると、Windowsで拡張子htmlに対応付けられているアプリケーションでHTMLファイルを表示します。

「HTMLへ変換」を最初に実行時するとき、Windowsで拡張子htmlに対応付けられているアプリケーションの中から、ファイルを表示するアプリケーション（ブラウザまたはエディタ）を選択するダイアログが表示されることがあります。

但し、Windowsの動作環境によっては、アプリケーション選択ダイアログが表示されないときもあります。このダイアログを表示しているのはMicrosoft Windowsであり、アドインでは表示・非表示の制御は行っていません。

Windowsで拡張子htmlに対応付けられているアプリケーションを変更するには、次のようにします。

1. エクスプローラでHTMLファイルを選択します。
2. 右クリック・メニューからプロパティを選択します。

3. プロパティのダイアログからプログラムの項の「変更」ボタンをクリックします。

4. 「今後のhtmlファイルを開く方法を選んでください。」ダイアログでアプリケーションを選択します。
5. 「OK」をクリックして、ダイアログを閉じます。

4.4.2 変換先フォルダーを変更

「HTMLへ変換」ボタンの下部をクリックすると「変換先フォルダーを変更」コマンドが表示されます。

変換結果を表示するフォルダーを選択して、「OK」を押します。

次回から、選択したフォルダーに変換結果が保存されます。

4.4.3 「指定したCSSを用いる」

HTMLファイルはCSSでレイアウトを変更できます。変換出力されるHTMLファイルに、このオプションで指定したCSSファイルへのリンクを設定します。

「指定したCSSを用いる」チェックボックスにチェックすると、CSSファイルを選択するダイアログが開くので、リンクしたいCSSファイルを選択してください。

本製品にはサンプルのCSSファイルが同梱されています。サンプルCSSファイルは、本製品をインストールしたフォルダーのCSSフォルダーにコピーされています。本製品に同梱されているCSSファイルのほか、ご自分で用意したCSSファイルをリンクできます。

リンク設定したCSSファイルは、変換先HTMLファイルと同じフォルダーにコピーされます。

4.4.4 「ブロックタグで改行する」

「ブロックタグで改行する」チェックボックスをオンにすると、各ブロック終了タグの後ろに改行を出力します。変換したHTMLファイルをブラウザで表示するときは差がでませんが、HTMLファイルをテキスト・エディタで表示してタグを確認したり、編集したりするときに便利です。

ブロックタグで改行しないHTMLファイル（デフォルト）と、ブロックタグで改行するにチェックして出力したHTMLファイルを、テキスト・エディタで読み込んで表示を比較すると次の図のようになります。

4.4.5 ヘルプ

「ヘルプ」ボタンをクリックすると、Webヘルプを表示します。ヘルプは、アンテナハウスのホームページにあります。URLは次のとおりです。

1. （日本語版）https://www.antenna.co.jp/xhw/help/ja/
2. （英語版）https://www.antenna.co.jp/xhw/help/en/

5.4.1 見出しスタイルとアウトラインレベル

5.4.2 見出しのアウトライン番号

見出しスタイルを指定した段落にアウトライン番号が付加されているとき、アウトライン番号を、class属性の値numberを指定した<span>タグで囲み、<h>タグの内容文字列として変換します。アウトライン番号と見出しのテキストの間に空きがあるときは空きを半角空白として出力、またはタブがあるときは、タブを削除して代わりに半角空白が1文字入ります。

5.4.3 箇条書き

Wordの箇条書きを指定した段落は、HTMLの箇条書き（番号なしリスト）（<ul>/<li>）に変換します。このときWord段落の行頭記号は削除されます。

5.4.4 段落番号と順序付きリスト

Wordの段落番号機能を使用して、段落先頭に番号を付与した段落（番号付きの段落）は次のように変換します。

1. 番号付きの段落の前後が番号付きでない段落または改行のとき、その番号付き段落をHTMLの段落（<p>タグ）として出力します。このとき段落番号は、class属性の値をnumberとして指定した<span>タグで囲ったうえで、通常の文字として出力します。
2. 番号付きの段落がふたつ以上連続するとき、HTMLの順序付きリスト（<ol>/<li>タグ）に出力します。
   1. 番号付き段落が階層化されていて、最初の段落と次の段落の階層が異なっていても隣り合っていれば連続しているものと判定します。
   2. Word文書で指定されている番号の種類を<ol>タグのclass属性の値として設定します。

5.4.5 段落スタイル名（オプション）

デフォルトでは段落スタイル名は出力しません。

変換オプションで「-pstyle」パラメータを指定すると、Wordの段落に段落スタイルが指定されているとき、段落スタイルの名前を<p>タグまたは<h>タグのclass属性の値として出力します。段落スタイル機能を使わずに段落書式を指定しているときにはclass属性の値は設定されません。

5.5.1 図の出力フォルダーとファイル名

1. docx文書に挿入された図はdocx文書から取り出され、そのパスがHTMLの<img>タグのsrc属性の値に設定されます。取り出した図ファイルを収めるフォルダーはデフォルトでは “image”です。変換オプションの「-fileimages」パラメータを指定すると、出力HTMLファイル毎に“出力ファイル名.images”フォルダーを作成します。ファイル名は自動生成の連番となります。
2. docx文書にリンクされた図は、リンク元のファイルのパスをHTMLの<img>タグのsrc属性の値に設定されます。リンクされた図ファイルの複製や移動は行いません。図のパスは出力HTMLファイルからの相対パスに変換します。元のdocx文書とリンクされた図のフォルダーが移動されている場合、パスを適切な相対パスにできないことがあります。

5.5.2 画像と図形の形式

デフォルトではイメージ画像はPNGまたはJPEG形式に変換し、オートシェイプやWordで挿入した線画図形、EMF、WMF形式の図形ファイルはSVG形式に変換して出力します。

変換オプションで「-throughimg」パラメータを指定するとGIF、EMF、WMF形式でWordに挿入された画像・図形はファイル形式を変換しないで、元の形式のまま図の出力フォルダーに保存します。

5.5.3 図の配置指定

Wordの図の配置で指定したレイアウトオプションの種類を<img>のclass属性として保存します。

変換元	オプション	クラス属性
行内		class="inline"
文字列の折り返し	文字列の折り返し共通	class="block"
	四角形	class="block square"
	狭く	class="block tight"
	内部	class="block through"
	上下	class="block top-bottom"
	背面	class="block behind"
	全面	class="block front"

【注意】

CSSでは図の配置がインラインかブロックかをdiplayプロパティで指定します。displayプロパティのデフォルト値はinlineなので、Wordで図の配置に文字列の折り返しを設定してもブラウザでは行内配置として表示される場合があります。このような場合には、CSSで次のように指定してください。

img.block {
display: block
}

5.5.4 文字列の折り返しを指定した図を出力する位置

文字列の折り返しを指定した図のためのimgタグを出力する位置は、見出し、段落ではアンカーを設定したブロックの終了タグの後ろです。しかし、箇条書きの項目では終了タグの直前になります。詳細は、6.4図のレイアウトの項を参照してください。

5.7.1 表の見出し行

表の見出しタグ（テーブルヘッダ：thead）を出力するには、表の先頭行に次のどちらかを設定します。

1. 表の先頭行を選択して、Wordのリボン「表ツール：レイアウト」の「タイトル行の繰り返し」をオンにする。
2. Wordのリボン「表ツール：テーブルデザイン」の「表スタイルのオプション」で「タイトル行」のみにチェックする。

変換元	HTML要素	説明
リボンの表ツール：レイアウト	<thead><tr><td>…</td></tr></thead>	表の先頭行が<thead>で囲まれます。 「タイトル行の繰り返し」をオンにすると、表がページを跨ったときに、各ページにタイトル行が繰り返し表示されます。これを避けたいときには、「タイトル行の繰り返し」をオフにして、テーブルデザインの表スタイルのオプションで「タイトル行」にチェックします。
リボンの表ツール：テーブルデザインの表スタイルのオプション

5.7.2 表の見出し列

表の先頭列を選択して、Wordのリボン「表ツール：テーブルデザイン」の「表スタイルのオプション」で「最初の列」のみにチェックすると先頭列のセルを見出しセルに設定します。

変換元	HTML要素	説明
リボンの表ツール：テーブルデザインの表スタイルのオプション	<tr><th>…</th></tr>	表の先頭列のセルが見出しセルのタグでマークアップされます。

5.8.1 フォントグループ

5.8.2 リンクと相互参照

6.1.1 Webページのコンテンツとレイアウト分離とは？

Webページのテキスト、画像、表、などの実質的な内容のことをコンテンツといいます。また、ブロックの配置の指定、ブロック周囲の空き、周囲を罫線で囲むかどうか、その色合い、表示するフォント、文字の大きさなどの見栄え体裁を指定することをレイアウトといいます。

Webページの制作ではコンテンツをHTMLの該当するタグでマークアップして表し、レイアウトをCSSで指定します。最新のHTMLでは、コンテンツとレイアウトを分離するのが基本原則とされています。

6.1.2 Wordはコンテンツとレイアウトが混然一体

これに対して、Wordで文書を編集するときは、テキストの書式や画像の配置などは、画面上で編集しながらテキストや画像に直接指定していく方式です。Wordは文書を印刷したときに画面上のレイアウトのとおりになる「WYSIWYG」という方式で、文書のレイアウトに対する考え方がHTMLとは根本的に異なります。

このためWordで作成した文書からWebページを作成するのは非常に困難です。Microsoft Wordには、リボン「ファイル」の「名前を付けて保存」で、保存するファイルの種類として、「Webページ」を選択すると、一見、ブラウザで表示できるWeb形式で保存できます。しかし、残念ながらWordで保存したWebページ形式は、そのままではまったく使いものになりません。

この原因は、Wordは編集時に画面で指定した印刷用の体裁や配置などのレイアウトをWebページで再現しようとするためです。

6.1.3 本製品は変換時にWordのレイアウト指定を原則無視

こうした問題を解決するために、本製品はWordで作成した文書のレイアウト指定をすべて捨ててコンテンツを純粋なHTMLのタグで表現します。

本製品を使いこなすには、まず、この基本をご理解いただく必要があります。

大前提として、WordでHTMLのタグを直接書くわけではありませんが、Word文書から変換した結果が適切なHTMLになるためには、HTMLのタグについての理解が欠かせません。そのうえで、現在編集しているWordのスタイル設定が、どのようなHTMLのタグに変換されるかを頭において、Word文書を編集する必要があります。

本章では、このような観点から、Word文書を編集する際に注意していただきたい事柄を説明します。

6.1.4 Word文書を作成するときに避けて欲しいこと

Wordの編集画面で、次のような編集操作を避けてください。

1. 行の先頭位置を空白文字で調整すること
2. 文章が続いている行の途中で改行すること。

例えば箇条書きの項目が2行に渡るとき、1行目の終わりに改行を入力し、2行目の先頭位置に空白を入れて行頭を整えるような編集をすると、紙への印刷やPDFにするときは問題ありませんが、HTMLにしたときは文章のつながりが崩れてしまいます。

6.2.1 Wordの見出しスタイルを設定する

Wordで見出しを付けるときは、Wordに組み込まれている「見出しスタイル」を適用してください。Wordの「見出しスタイル」は見出し１～見出し９まで用意されています。

Word2HTMLコンバータは、見出しスタイル１にHTMLの見出しランクタグh1を対応付けます。見出しスタイル２から同6までに見出しランクタグh2からh6を設定します。

【注意】Wordのテーマによっては、見出しスタイルにアウトラインレベル（後述）が設定されていないことがあります。Word文書でこのような見出しスタイルを使ったときは、見出しスタイルを設定しても、その段落に見出しランクタグは設定されません。

段落にアウトラインレベルが設定されているかどうかは、段落の上にカーソルを重ねて（ホバー）みることで判断できます。アウトラインレベルが設定されている段落には、カーソルをホバーしたとき段落の左側にマークが表示されます。

6.2.2 表題を設定する

Wordの組み込みスタイルのひとつに「表題」があります。表題スタイルには「アウトラインレベル１」が設定されていることがあります。Word文書で、段落にそのような表題スタイルを適用した場合、Word2HTMLコンバータの変換結果では、当該段落にh1タグが設定されます。

6.2.3 Wordの段落アウトラインレベルを設定する

Wordには段落のアウトラインレベルという機能があり、段落を9段階の階層化設定できます。また、アウトラインレベルを設定した段落はアウトライン編集段落のアウトラインレベルは、リボンの「ホーム」タブの「段落グループ」の「段落」ダイアログで設定します。

「段落」ダイアログは、段落グループの右下にある「」をクリックすると表示されます。

Word2HTMLコンバータは、アウトラインレベル１からアウトラインレベル6までをHTMLの見出しランクタグh1からh6に対応つけます。つまり、Wordでアウトラインレベル１を設定した段落は、HTMLの見出しランク1（h1）となります。

6.3.1 箇条書き

Wordのリボン「ホーム」にある「箇条書き」は、行頭に記号を付けた段落を作成します。

Wordでは行頭文字ライブラリによって、行頭記号の変更ができます。

この行頭記号の多くは、Word独自の特殊なフォントを使って表示されるためHTMLでは正しく表示されない場合があります。このためWord2HTMLコンバータは、行頭記号を削除したうえで、HTMLの順序なし箇条書きに変換します。HTMLでは行頭記号はCSSを使って設定してください。

なお、Wordで箇条書きを指定したブロックは、見かけ上はHTMLの順序なし箇条書きのように見えます。しかし、Wordの内部では、各項目が先頭に記号が付いた段落として書式化されています。Word2HTMLコンバータは、Wordの編集時に「箇条書き」を設定した箇所を分析して、HTMLの順序なし箇条書きに変換しています。段落の書式の指定方法によってはHTMLの順序なし箇条書きに変換できない場合があります。この場合は、段落の書式の変更を試してみてください。

6.3.2 段落番号

Wordのリボン「ホーム」の「段落番号」は、選択した番号形式で段落の行頭に自動番号付けする機能です。

段落番号を指定したブロックは、見かけ上はHTMLの順序付き箇条書きのように見えます。

しかし、Wordには番号付き箇条書きというスタイルはありません。Wordの段落番号を設定した段落は、ひとつひとつの段落項目の先頭に番号のついた段落として保存されています。

Word2HTMLコンバータは、Word編集時に「番号付き段落」を設定した箇所を、HTMLの順序付き箇条書きに変換するか、それとも番号付き段落に変換するかをプログラムで判定します。判定基準は次のとおりです。

• Word文書中で段落番号を設定した段落がふたつ続いたときに順序付き箇条書きとします。
• Word文書中に段落番号を設定した段落が単独で現れたときは、番号をその段落行頭の通常の文字に変換します。

この判定は必ずしもうまくいかないことがあるため、期待通りにならない場合は、Word上で段落を編集してみてください。

6.4.1 行内配置

行内配置では図を文字と文字の間にあたかもひとつの図形文字のように配置し、前後の文字と一緒に位置が移動します。行内配置の図はこのように（）HTMLでは文字の間に配置されます。

HTMLに変換した結果、imgタグにclass=”inline”の属性が設定されます。

6.4.2 文字列の折り返し

文字列の折り返しを指定した図は、Wordの編集画面で図を選択するとアンカーマーク表示されます。

A. 見出しや段落にアンカーマークがついた図は、見出しや段落の終了タグ直後に出力され、また、imgタグにclass=”block”の属性が設定されます。

次の例では、図のアンカーマークが見出しの先頭についています。

これをHTMLに変換すると次のように、見出しランクの終了タグと次の段落の開始タグの間に、imgタグを出力します。

次の例では、図のアンカーマークが段落の先頭についています。

これをHTMLに変換すると次のように、段落の終了タグの直後に、imgタグを出力します。

この例ではWordの画面上では段落のテキストが図の後ろにあるにも関わらず、HTMLに変換すると段落の後ろにimgタグが出力されます。Wordは紙の上に画像を配置するため、画像が1ページにうまく入りきらないとき、画像が次のページに配置されることがあります。このようなときもHTMLファイルに変換したときには、アンカーマークが付いた段落の後ろにimgタグが置かれます。

B. 箇条書きの項目にアンカーマークのついた図は、箇条書き項目の終了タグの直前にimgタグが出力されます。

次の例では、図のアンカーマークが箇条書きの最初の項目の先頭についています。

これをHTMLに変換すると次のように、最初の箇条書き項目の終了タグの直前に、imgタグを出力します。（箇条書きの項目の終了タグの後ろと次の箇条書きの項目の開始タグの間にimgタグを出すとHTMLの文法エラーになるためです。）

6.7.1 リンク

Wordのリボン「挿入」タブの「リンク」では外部のURLやWord内部へのリンクを設定できます。

6.7.2 相互参照

Wordのリボン「挿入」タブの「相互参照」ではWord内部で見出し、図、表、番号付き段落へのリンクを設定できます。

6.7.3 リンクの参照先

リンクの参照先は外部URLや文書内部のブックマークです。ブックマークはWordのリボン「挿入」タブのブックマークで追加、削除などの編集ができます。次にブックマークの例を示します。

上のダイアログには4つのブックマークが表示されており、ブックマークの種類は次のようになっています。

1. Wordで自動生成の目次を作成した目次の項目は「_Toc」から始まるブックマーク
2. 相互参照の参照先に「_Ref」から始まるブックマーク
3. 文書内部リンクの参照先に「_見出し２」
4. ブックマークダイアログで追加したブックマーク「bookmark」

HTMLに変換するとブックマークは<span id=”ブックマーク名”></span>に変換されます。