HTML Markup instructions

Skip to end of metadata
Go to start of metadata

This will mark up text documents with HTML tags for the US-Mexico War project so that they can be included in web pages.
The source documents are on the library server Walnut: \\\Mexican_War <file:///\\\Mexican_War>  in the following folders

Template file: \\\Mexican_War\text-markup-template.html <file:///\\\Mexican_War\text-markup-template.html>  
Example source file: \\\Mexican_War\text-markup-example.docx <file:///\\\Mexican_War\text-markup-example.docx>  
Example marked up file: \\\Mexican_War\text-markup-example.html <file:///\\\Mexican_War\text-markup-example.html>  
Suggested methodology:
1.    Open the source document you will be working on (probably using Word since most if not all of the source documents are Word docs).
2.    Open text-markup-template.html in your editor of choice (Dreamweaver, TextPad, or whatever).
3.    SAVE AS the template file with the same filename as the source file except with .html as the extension instead of .doc/.docx. Put this saved file (e.g., sourcefilename.html) in the SAME FOLDER as its source file.
4.    Copy all of the text from the source file (e.g., CTRL-A, CTRL-C).
5.    Paste into the template file.
a.    If you are using Dreamweaver or other WYSIWYG HTML editor and using design view, just paste in and proceed to the next step below.
b.    If you are using TextPad or other text editor and/or using Source Code view, please paste in between the <div id=”textmarkup”> … </div> tags. I have a little line of text in there so you have something to highlight and paste over.
c.    Note: pasting into design view may allow Dreamweaver or your html editor to correctly guess what the html markup should be, so doing it that way may save you some work for the next step.
6.    Mark up the text.
a.    Add <p> … </p> around each paragraph.
b.    Wherever the source document has:
 i.    bold add <strong> ... </strong> around the bold words/letters/characters.
   ii.    italic add <em> … </em> around the italic words/letters/characters.
 iii.    underlining add <u> … </u> around the underlined words/letters/characters.
 iv.    Where there are bulleted lists, put <ul> … </ul> around the whole list, and mark each list item with <li> … </li>
 v.    Letters with accents/diacritics (e.g., á or à or ñ, etc.) change them to their HTML equivalent (e.g., á  or à or ñ (Dreamweaver can help here with its insert character tool, or see where you can copy/paste the html codes). Find and Replace might also be helpful here.
7.    Do other cleanup.
a.    For any superscript “th”, make it a plain “th” (remove the superscript). This would be, for example, with “ July 20th “.
b.    Find and replace any  “curly” or “fancy” single and double quotes with their “straight” (text) equivalents.
c.    Find and replace any endash characters with a single text hyphen (for example: - ).
d.    Find and replace any emdash characters with a two single text hyphens (for example: -- ).
e.    Find and replace any encoded elipses with a series of 3 text periods.
f.     Note: failing to do these will result in pages that have little diamonds with question marks in them. Do the cleanup now and we don’t have to do it later! :-p
g.    Note 2: I think these will cover most if not all what you’ll find in the documents. If you find other things, use your best judgment and/or email me to ask.
h.    Note 3: If you see things that look like typos or errors, make a note of them so that we can ask

Note: the development web site is on SPOCK at but we’re collecting the content files and pages on walnut prior to that. The final live site will be at


Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.