WWN Development Document

MS Word’s HTML : description, features, and problems

Word’s Navigation pane shows the table-of-contents (View : Show : Navigation pane).

This document was created by the WWN author for his own use in developing WWN. It is included in the WWN repo, as other developers may find it useful.

1 Word’s HTML: description and specs

· Cruft inside Microsoft Word HTML files - Zoompf Web Performance

o https://zoompf.com/blog/2010/01/cruft-inside-microsoft-word-html-files/

o Word includes an option that allows you to save a filtered HTML file. A filter HTML file will not contain any of this useless Microsoft Office specific data.

· What makes Microsoft-Word-generated HTML documents so large in code? - Stack Overflow

o https://stackoverflow.com/questions/30437400/what-makes-microsoft-word-generated-html-documents-so-large-in-code

· HTML and MS Word HTML Output | Metanorma

o https://www.metanorma.com/builder/ref/html/

o Describes Word's HTML structure

· About Microsoft Word HTML | Metanorma

o https://www.metanorma.com/builder/ref/ms-word-html/

o Describes limitations of Word's HTML

· a Microsoft document called "Microsoft Office HTML and XML Reference". It's a Windows .exe that unpacks to a .chm Help file. You can get it here

o Word html format: insert a custom TOC via field code - Stack Overflow

§ https://stackoverflow.com/questions/59689248/word-html-format-insert-a-custom-toc-via-field-code

o On my PC: D:\Documents\Professional-projects\My-web-site-development\Word-to-HTML\references\MS-Word-HTML-specs

2 Word's document-properties and HTML

· Summary

o I looked into which Word properties are included in the generated HTML

§ My hypothesis was that the Word properties could be set via VBA, as part of a script to generate HTML for Word document.

§ And, those Word properties would be put in HTML, e.g., in meta tags

o Experiment

§ I set all of the properties on Word's Info page

§ Title and Hyperlink Base might have been the only one that made it into the HTML

o Summary

§ I didn't keep good records of what properties got into the HTML, but this approach wasn't fruitful, except for Title and Hyperlink Base

· Document property: Hyperlink Base

o Specify a file path

o For relative hyperlinks, in generated HTML

§ By default, it's relative to location of document

§ If Hyperlink Base specified, it's relative to that path

o How to create absolute hyperlinks and relative hyperlinks in Word documents

§ https://support.microsoft.com/en-us/topic/how-to-create-absolute-hyperlinks-and-relative-hyperlinks-in-word-documents-d6339b5a-98ba-a483-bac5-95bd33ff5a80

o (1) How can I make a Word document with hyperlinks portable using the Hyperlink Base? - Quora

§ https://www.quora.com/How-can-I-make-a-Word-document-with-hyperlinks-portable-using-the-Hyperlink-Base

· Document properties (meta-data)

o html - How many keywords are ideal for the META keywords tag? - Stack Overflow

§ https://stackoverflow.com/questions/3812143/how-many-keywords-are-ideal-for-the-meta-keywords-tag

§ As a general rule, you should aim for the following character limits within each of your meta tags:

· Page title – 70 characters

· Meta description – 160 characters

· Meta keywords – No more than 10 keyword phrases

o View or change the properties for an Office file

§ https://support.microsoft.com/en-us/topic/view-or-change-the-properties-for-an-office-file-21d604c2-481e-4379-8e54-1dd4622c6b75

o How to Add Tags to Word Documents

§ https://www.lifewire.com/use-tags-to-organize-word-documents-3540109

· Experiments

o Files are in the directory: Word-to-HTML-experiments

§ helloworld.docx

· All Word properties set

§ helloworld--filtered.htm

· MS Word, saved as Web, filtered

§ helloworld.htm

· MS Word, saved as html

3 Investigating for Word features that do not render correctly to HTML

3.1 Need to look into

· Sources, may be useful

o Advice – Word to HTML

§ Word to HTML – Convert your text to clean code

· https://wordtohtml.net/content/

· NOTE: headings not rendered correctly for D:\Documents\Professional-projects\My-web-site-development\Word-to-HTML\Word-to-HTML-experiments\investigation--bullet-symbols\headings-and-bullets-01.docx

o Accessibility at Penn State | Cautions on Converting Word to HTML

§ https://accessibility.psu.edu/microsoftoffice/microsoftword/wordhtml/

o Convert Word to HTML

§ https://ww2.nscc.edu/lyle_l/Accessibility/convertWordtoHTML.html

o https://www.ferris.edu/it/howto/pdfs-docs/content_in_word.pdf

§ Describes common formatting problems

o https://word.uservoice.com/