2.1.1 Installation options

① Create the add-in icons on the desktop

If you check the checkbox of this option, two icons will be created on the desktop: the program that install the add-in on the ribbon of Microsoft Word and the program that uninstall the add-in.

For the Installation/Uninstallation of add-in, refer to "Chapter 4 Add-in".

② View the ReadMe file after the installation

If you check the checkbox of this option, the ReadMe.txt file included in the installer will be displayed on the screen with Notepad when the installation is completed.

2.2.1 Evaluation version

The evaluation version can be obtained from the product’s web page.

When the installation of the evaluation version is completed, a license file containing the 30-day evaluation license data will be set in the installation folder.

There are no feature restrictions on the evaluation version, and you can use the same features as the official version. However, the usage period of the evaluation version is limited to 30 days, and you will not be able to start the command-line version 30 days after the installation. To continue using it, you need to purchase the official version from the Antenna House.

Antenna House – How to Order

https://www.antennahouse.com/purchase

2.2.2 Official license

When you purchase this product, the official license data (license file) and license certificate will be provided to you. The license file name is “xhwlic.dat”.

To switch to an official license, copy the license file to the same folder as the command-line version of the program (Word2HTML.exe).

The default installation folder for the command-line program is as follows:

C:\Program Files\Antenna House\xhw12

Writing to this folder requires administrator privileges, so if you try to copy the official license file, you will see the following warning dialog:

If you do not have administrator privileges, ask the administrator to copy it.

3.4.1 Default setting file

The default settings file allows you to switch the default operation. The file name of the default settings file is "def-settings.xml" and the file can be saved in either of the following two locations:

1. Same folder as the EXE file (Word2HTML.exe)
2. Roaming folder

If the default settings file is placed in the same folder as the EXE file, the default values will be the same for all users.

If the default settings file is placed in the Roaming folder, it will be a different default settings file for each user. The default setting file path for the Roaming folder is usually,

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

When default setting files are located in both two folders, the contents of the default setting file in the Roaming folder takes precedence.

Note that if the default setting file contains ON/OFF type conversion option settings, specifying the same conversion option as an add-in or command line parameter will invert ON/OFF.

When specify the "-savedefault" parameter of the conversion option you can create a default settings file (def-settings.xml) in the Roaming folder. The default settings file is in XML format and can be edited with a text editor.

For example, specifying the following on the command line will create a default setting file with the; (1) output line breaks at the end of block tags (-endl) and, (2) output underlines as <u> tags (-underline t).

In addition, the following specification will create a default settings file that clears all the settings in the default settings file and restores them to the default settings of the program itself.

The following is the default settings file created by specifying "-clrsettings -savedefault" as a conversion option parameter. Parameters with no default values will not be set.

<?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 Conversion option setting file

The conversion option setting file is a file that saves parameter values for conversion options.

It is read at command line execution by specifying the name of the conversion option setting file.

If you repeatedly convert using the same settings, you can save the conversion options in a settings file so that the next time you convert, you only need to specify the settings file instead of specifying the same options.

The file name of the conversion option setting file is optional.

The conversion option setting file can be created as a file specified by the "-savesettings" conversion option when the command line is executed.

The conversion option setting file is in XML format, so parameter values can be modified using a text editor.

3.4.3 Setting file format

The settings file is an XML file whose root element is "word-to-html-settings" and the items to be set for conversion options are the child element type names. The format of the default setting file and the conversion option setting file are the same. The correspondence between each element type name and the conversion option parameters is shown in the table below.

4.1.1 Add-in installation

To install an add-in, close Word and click the “Install HTML on Word add-in” icon on your desktop.

If you did not create an add-in installation icon on your desktop during installation, do the following:

1. Find the program for installing the add-in that is copied to the “HTML on Word” installation folder.
2. Double-click the add-in installation program file (install.vbs).

4.1.2 Add-in uninstallation

To uninstall an add-in, close Word and click the “Uninstall HTML on Word add-in” icon on your desktop.

If you did not create an add-in uninstallation icon on your desktop during installation, do the following:

1. Find the program for uninstalling the add-in that is copied to the “HTML on Word” installation folder.
2. Double-click the add-in uninstallation program file （uninstall.vbs）.

4.4.1 Application to display the conversion result

When "Convert to HTML" is completed, the HTML file will be displayed in the application associated with the extension html in Windows.

When "Convert to HTML" is executed for the first time, a dialog for selecting the application (browser or editor) to display the file from the applications associated with the extension html in Windows may be displayed.

However, depending on the operating environment of Windows, the application selection dialog may not be displayed. This dialog is displayed on Microsoft Windows, and the add-in does not control the display/non-display of this dialog.

To change the application associated with the html extension on Windows:

1. Select the HTML file in File Explorer.

2. Select Properties from the right-click menu

3. From the Properties dialog, click the "Change" button in the “Opens with” section.

4. Select the application in the "How do you want to open .html files from now on?"
5. Click “OK” to close the dialog.

4.4.2 Changing the conversion destination folder

Click the bottom of the "Convert to HTML" button to display the "Select destination folder" command.

Select the folder where you want to view the conversion results and click “OK”.

From the next time, the conversion result will be saved in the selected folder.

4.4.3 “Use specified CSS”

You can change the layout of the HTML file with CSS. Set the link to the specified CSS file with this option to the converted HTML file.

If you check the "Use specified CSS" checkbox, a dialog for selecting a CSS file will open. Select the CSS file you want to link to.

A sample CSS file is included with this product. The sample CSS file is copied to the CSS folder in the folder where this product is installed. In addition to the CSS file included with this product, you can link the CSS file you prepared.

The linked CSS file will be copied to the same folder as the converted HTML file.

4.4.4 “Line break with block tag”

If you check the "Line break at block tag" checkbox, a line break will be output after each block end tag. It makes no difference when viewing the converted HTML file in a browser, but it is useful when viewing the HTML file in a text editor to view and edit tags.

The following figure compares the display of an HTML file without line breaks in block tags (default) and the display of an output HTML file with the "Line break at block tag" checkbox checked, when read in a text editor.

4.4.5 Help

Click the “Help” button to display web help. Help can be found on the Antenna House web page. The URL is:

1. (Japanese)https://www.antenna.co.jp/xhw/help/ja/
2. (English)https://www.antenna.co.jp/xhw/help/en/

5.4.1 Heading styles and outline levels

5.4.2 Heading outline numbers

When an outline number is added to a paragraph for which a heading style is specified, the outline number is enclosed in a <span> tag with the class attribute value “number”, and converted to the content string of the <h> tag after specifying the class attribute value number for the outline number. If there is a space between the outline number and the heading text, the space is output as a single-byte space, or if there is a tab, the tab is deleted and a single-byte space is inserted instead.

5.4.3 Lists

Paragraphs with Word lists are converted to HTML lists (unordered lists) (<ul>/<li>). At this time, the bullet symbols in Word paragraphs are removed.

5.4.4 Paragraph numbering and ordered lists

Paragraphs that have been numbered at the beginning of a paragraph using Word's paragraph numbering feature (numbered paragraphs) are converted as follows:

1. When a numbered paragraph is preceded or followed by an unnumbered paragraph or line break, the numbered paragraph is output as an HTML paragraph (<p> tag). In this case, the paragraph number is enclosed in a <span> tag with the class attribute value specified as number, and then output as normal text.
2. When two or more numbered paragraphs are consecutive, they are output to an HTML ordered list (<ol>/<li> tags):

1. If numbered paragraphs are arranged in a hierarchy and the first and next paragraphs are adjacent to each other, even if they are at different levels, they are considered to be consecutive.
2. Sets the type of numbering specified in the Word document as the value of the class attribute of the <ol> tag.

5.4.5 Paragraph style name (optional)

By default, paragraph style names are not output.

If you specify “-pstyle” parameter as a conversion option, the name of the paragraph style is output as the value of the class attribute of the <p> or <h> tag when a paragraph style is specified in a Word paragraph. When paragraph formatting is specified without using the paragraph style feature, the value of the class attribute is not set.

5.5.1 Output folder and file name for illustrations

1. The illustrations inserted into the docx document are extracted from the docx document and the that paths are set to the value of the src attribute of the <img> tag in HTML. The default folder for extracted illustration files is "image". If the "-fileimages" parameter of the conversion option is specified, a folder named "destination_file_name.images" is created for each output HTML file. The file names are automatically generated with sequential numbers.
2. Illustrations linked to a docx document will have the path of the linked file set to the value of the src attribute of the <img> tag in HTML. Linked illustraion files will not be copied or moved. The illustration paths are converted to relative paths from the output HTML file. If the original docx document and the folder of the linked illustraions have been moved, the path may not be set to a proper relative path.
   Note that if the "-embedimg" parameter is specified, the images will be embedded in the HTML file.

5.5.2 Image and shape formats

By default, images are converted to PNG or JPEG format, and AutoShape, line shapes inserted in Word, and shape files in EMF and WMF formats are converted to SVG format for output.

If you specify the “-throughimg” parameter in the conversion option, images and shapes inserted into Word in GIF, EMF or WMF formats are saved to the illustration output folder in their original formats without file format conversion.

5.5.3 Layout Options

Saves the layout option type specified in Word format as the <img> class attribute.

Conversion source	Options	class attribute
In Line with Text		class="inline"
With Text Wrapping	Common for “With Text Wrapping”	class="block"
	Square	class="block square"
	Tight	class="block tight"
	Through	class="block through"
	Top and Bottom	class="block top-bottom"
	Behind Text	class="block behind"
	In Front of Text	class="block front"

[Notice]

In CSS, the display property specifies whether the figure layout is inline or block. Since the default value of the display property is inline, even if you set “With Text Wrapping” in the Layout Options in Word, it may be displayed as “In Line with Text” in the browser. In such a case, specify as follows in CSS:

img.block {
display: block
}

5.5.4 Position to output the figure with “With Text Wrapping” specified

The output position of the img tag for an illustration that specifies string wrapping is after the end tag of the block that sets the anchor in headings and paragraphs. However, in bulleted items, it is just before the end tag. For details, refer to “6.4 Layout of shapes”.

5.7.1 Table header row

To output the table header tag (table header: thead), set either of the following in the first row of the table.

1. Select the first row of the table and turn on "Repeat Header Rows" in "Table Tools: Layout" on the Word ribbon.
2. Check only "Header Row" in "Table Style Options" in "Table Tools: Table Design" on the Word ribbon.

5.7.2 Table header column

Select the first column of the table and check only "First Column" in "Table Style Options" in "Table Tools: Table Design" on the Word ribbon to set the cell of the first column as the header cell.

5.8.1 Font group

5.8.2 Links and cross-references

6.1.1 What is web page content and layout separation?

The actual contents of a web page, such as text, images, tables, etc., is called “contents”. In addition, the “layout” is to specify the layout of the block, the margin around the block, whether to surround it with a border, its color, the font to be displayed, the size of the characters and other appearances.

When creating a web page, the contents are marked up with the corresponding tags in HTML and the layout is specified by CSS. In latest HTML, the basic principle is to separate content from layout.

6.1.2 Word is a mixture of content and layout

On the other hand, when editing a document in Word, the text format and image layout are specified directly on the text or image while editing on the screen. Word takes a method called "WYSIWYG" that follows the layout on the screen when the document is printed, and the way of thinking about the document layout is fundamentally different from HTML.

This makes it very difficult to create a web page from a document created in Word. In Microsoft Word, if you select "Web Page" as the file type to save in "Save As" of "File" on the ribbon, you can save it in a Web format that can be displayed in a browser at first glance. Unfortunately, the web page format saved in Word is completely useless as it is.

The reason for this is that Word attempts to reproduce the layout including appearance and placement for printing specified on the screen during editing on the web page.

6.1.3 This product ignores Word layout specification in principle

In order to solve these problems, this product discards all layout specifications of documents created in Word and expresses the contents with pure HTML tags.

To master this product, you will need to first understand this basic.

As a general premise, you don't write HTML tags directly in Word, but understanding HTML tags is essential for the result of conversion from a Word document to be proper HTML. Then, you need to edit the Word document, keeping in mind that the Word styling you are currently editing will be converted to what HTML tags.

From this perspective, this chapter describes what you should be aware of when editing a Word document.

6.1.4 Things to avoid when creating Word documents

Avoid the following editing operations on the Word editing screen:

1. Adjust the start position of the line with a space character.
2. Start a new line in the middle of the line where the sentence continues.

For example, suppose you want to edit a bulleted item that spans two lines by entering a line break at the end of the first line and inserting a space at the beginning of the second line to align the beginning of the line. In this case, even if there is no problem when printing on paper or converting to PDF, but the connection of sentences will be broken when converting to HTML.

6.2.1 Set the Word heading style

When adding headings in Word, apply the "Heading Style" built into Word. Word's "Heading Style" is available from Heading 1 to Heading 9.

The Word2HTML converter associates HTML heading rank tag h1 with heading style 1. Set heading rank tags h2 to h6 for heading styles 2 to 6.

[Notice] Depending on the theme of Word, the outline level (described later) may not be set in the heading style. When you use such a heading style in a Word document, setting the heading style does not set a heading rank tag for that paragraph.

You can determine if a paragraph has an outline level by hovering the cursor over the paragraph. Paragraphs with an outline level will have mark on the left side of the paragraph when you hover over the cursor.

6.2.2 Set the title

One of Word's built-in styles is "Title". The title style may have the setting of "Outline Level 1". If you apply such a title style to a paragraph in a Word document, the Word2HTML converter will set the h1 tag on that paragraph.

6.2.3 Set the paragraph outline level in Word

Word has a feature called Paragraph Outline Level, which allows you to set paragraphs in 9 levels. Also, the outline level of the outline edit paragraph is set in the “Paragraph” dialog of the “Paragraph” group on the “Home” tab of the ribbon.

The “Paragraph” dialog is displayed by clicking the arrow mark at the bottom right of the paragraph group.

The Word2HTML converter maps outline levels 1 to 6 to HTML heading rank tags h1 to h6. In other words, a paragraph for which outline level 1 is set in Word will have HTML heading rank 1 (h1).

6.3.1 Bullets

”Bullets” in the “Home” tab on the Word ribbon creates paragraphs with symbols at the beginning of the line.

In Word, the Bullet Library allows you to change the look of the bullets.

Many of these bullets are displayed using a special Word font and may not be displayed correctly in HTML. For this reason, the Word2HTML converter removes the bullets and then converts them to HTML unordered bullets. In HTML, use CSS to set bullets.

Note that blocks with bullets specified in Word look like HTML unordered bullets. However, inside Word, each item is formatted as a paragraph with a bullet. The Word2HTML converter analyzes the parts where "bullets" are set when editing Word and converts them to HTML unordered bullets. Depending on how you specify the paragraph format, bullets may not be converted to HTML unordered bullets. In this case, try changing the paragraph format.

6.3.2 Numbering

"Numbering" in the “Home” tab on the Word ribbon is a function that automatically numbers the beginning of a paragraph in the selected numbering format.

Blocks with numbering look like HTML ordered bullets.

However, Word does not have a style of numbering bullets. Paragraphs with Word numbering are saved as paragraphs with numbers at the beginning of each paragraph item.

The Word2HTML converter programmatically determines whether to convert the specified "numbering paragraphs" to ordered bullets in HTML or numbering paragraphs. The judgment criteria are as follows:

• When consecutive two paragraphs with numbering are set in a Word document, the ordered bullets are set.
• When a single paragraph with numbering is set in a Word document, the number is converted to the normal character at the beginning of the paragraph.

This judgement may not always work, so if it doesn't work as expected, try editing the paragraph in Word.

6.4.1 In line with text

“In line with text” is to layout an image between characters as if it were single character, and the position moves together with the characters before and after. The image with “In line with text” specified is placed between characters like () in HTML.

As a result of converting to HTML, the attribute of class=”inline” is set in the img tag.

6.4.2 With text wrapping

Images with “With text wrapping” specified will have an anchor mark when edited in Word.

A. Images with anchor marks in headings and paragraphs are output just after the end tag of headings and paragraphs, and the attribute of class=”block” is set in the img tag.

In the following example, the image anchor mark is at the beginning of the heading.

Converting this to HTML will output an img tag between the end tag of the heading rank and the start tag of the next paragraph, as shown below.

In the following example, the image anchor mark is at the beginning of the paragraph.

Converting this to HTML will output an img tag just after the end tag of the paragraph, as shown below.

In this example, even though the paragraph text is at the back of the figure on the Word display, when converted to HTML, the img tag is output after the paragraph. Word places images on paper, so if an image doesn't fit well on one page, it may be placed on the next page. Even in such a case, when converting to an HTML file, the img tag will be placed after the paragraph with the anchor mark.

B. For images with an anchor mark on a bulleted item, the img tag is output just before the end tag of the bulleted item.

In the following example, the image anchor mark is at the beginning of the first item in the bulleted list.

Converting this to HTML will output the img tag just before the end tag of the first bulleted item, as shown below. (This is because if you put an img tag after the end tag of a bulleted item and between the start tag of the next bulleted item, an HTML syntax error will occur.)

6.7.1 Link

You can set an external URL or a link to the inside of Word in "Link" on the "Insert" tab on the Word ribbon.

6.7.2 Cross-reference

“Cross-references” on the “Insert” tab on the Word ribbon allow you to set links to headings, diagrams, tables, and paragraphs with numbering inside Word.

6.7.3 Link reference

Links can be referenced to external URLs or bookmarks inside the document. Bookmarks can be added, deleted, etc. in the “Bookmark” on the "Insert" tab of the Word ribbon. The following is an example of a bookmark.

Four bookmarks are displayed in the above dialog, and the bookmark types are as follows.

1. Items in the table of contents created by automatic generation on Word are bookmarks starting with "_Toc".
2. References set in “Cross-reference” start with "_Ref" bookmarks.
3. "_heading 2" at the reference of the document internal link.
4. "bookmark" is the bookmark added in the bookmark dialog

When converted to HTML, the bookmark will be converted to <span id=”bookmark name”></span>.