HTML Markup instructions

Version 1 by Julie A Williams
on Jan 18, 2012 10:10.

compared with
Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (33)

View Page History
Julie and Scott,
 
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 JUNIPER: \\juniper.uta.edu\Mexican_War <file:///\\juniper.uta.edu\Mexican_War> &nbsp;in the following folders: (items -marked- are from the pilot project)
The source documents are on the library server Walnut: \\walnut.uta.edu\Mexican_War <[file:///\\walnut.uta.edu\Mexican_War|file:///\\juniper.uta.edu\Mexican_War]> &nbsp;in the following folders


· &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-&nbsp;--\translations\MONTEREY-
-· &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--\translations\POLKOS-
-· &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--\text\transcriptions-
-· &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--\contextual_info (the two Word documents in this folder, plus the subfolders listed below)-
-· &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--\contextual_info\Monterey Revised Precis-
-· &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--\contextual_info\Polkos Revised Precis-
-· &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--\contextual_info\Revised Mexican Bios-
-· &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--\contextual_info\Revised U.S. Bios-

+Template file+: \\juniper.uta.edu\Mexican_War\text-markup-template.html <file:///\\juniper.uta.edu\Mexican_War\text-markup-template.html> &nbsp;
+Example source file+: \\juniper.uta.edu\Mexican_War\text-markup-example.docx <file:///\\juniper.uta.edu\Mexican_War\text-markup-example.docx> &nbsp;
+Example marked up file+: \\juniper.uta.edu\Mexican_War\text-markup-example.html <file:///\\juniper.uta.edu\Mexican_War\text-markup-example.html> &nbsp;
+Template file+: \\walnutr.uta.edu\Mexican_War\text-markup-template.html <[file:///\\walnut.uta.edu\Mexican_War\text-markup-template.html|file:///\\juniper.uta.edu\Mexican_War\text-markup-template.html]> &nbsp;
+Example source file+: \\walnut.uta.edu\Mexican_War\text-markup-example.docx <[file:///\\juniper.uta.edu\Mexican_War\text-markup-example.docx]> &nbsp;
+Example marked up file+: \\walnut.uta.edu\Mexican_War\text-markup-example.html <[file:///\\juniper.uta.edu\Mexican_War\text-markup-example.html]> &nbsp;
&nbsp;
&nbsp;
+Suggested methodology+:
1. &nbsp;&nbsp;&nbsp;*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. &nbsp;&nbsp;&nbsp;*Open text-markup-template.html* in your editor of choice (Dreamweaver, TextPad, or whatever).
3. &nbsp;&nbsp;&nbsp;*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. &nbsp;&nbsp;&nbsp;*Copy all of the text from the source file* (e.g., CTRL-A, CTRL-C).
5. &nbsp;&nbsp;&nbsp;*Paste into the template file.*
a. &nbsp;&nbsp;&nbsp;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. &nbsp;&nbsp;&nbsp;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. &nbsp;&nbsp;&nbsp;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. &nbsp;&nbsp;&nbsp;*Mark up the text.*
a. &nbsp;&nbsp;&nbsp;Add <p> … </p> around each paragraph.
b. &nbsp;&nbsp;&nbsp;Wherever the source document has:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;i. &nbsp;i. &nbsp;&nbsp;&nbsp;*bold* add <strong> ... </strong> around the bold words/letters/characters.
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ii. &nbsp; &nbsp;ii. &nbsp;&nbsp;&nbsp;_italic_ add <em> … </em> around the italic words/letters/characters.
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;iii. &nbsp;iii. &nbsp;&nbsp;&nbsp;+underlining+ add <u> … </u> around the underlined words/letters/characters.
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;iv. &nbsp;iv. &nbsp;&nbsp;&nbsp;Where there are bulleted lists, put <ul> … </ul> around the whole list, and mark each list item with <li> … </li>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;v. &nbsp;v. &nbsp;&nbsp;&nbsp;Letters with accents/diacritics (e.g., á or à or ñ, etc.) change them to their HTML equivalent (e.g., &aacute; á &nbsp;or &agrave; à or &ntilde; ñ (Dreamweaver can help here with its insert character tool, or see [http://tlt.its.psu.edu/suggestions/international/bylanguage/spanish.html#htmlcodes|http://tlt.its.psu.edu/suggestions/international/bylanguage/spanish.html#htmlcodes] where you can copy/paste the html codes). Find and Replace might also be helpful here.
7. &nbsp;&nbsp;&nbsp;*Do other cleanup*.
a. &nbsp;&nbsp;&nbsp;For any superscript “th”, make it a plain “th” (remove the superscript). This would be, for example, with “ July 20th “.
b. &nbsp;&nbsp;&nbsp;Find and replace any&nbsp; “curly” or “fancy” single and double quotes with their “straight” (text) equivalents.
c. &nbsp;&nbsp;&nbsp;Find and replace any endash characters with a single text hyphen (for example: - ).
d. &nbsp;&nbsp;&nbsp;Find and replace any emdash characters with a two single text hyphens (for example: \-\- ).
e. &nbsp;&nbsp;&nbsp;Find and replace any encoded elipses with a series of 3 text periods.
f. &nbsp;&nbsp;&nbsp;&nbsp;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. &nbsp;&nbsp;&nbsp;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. &nbsp;&nbsp;&nbsp;Note 3: If you see things that look like typos or errors, make a note of them so that we can ask


Questions about the instructions, the template, or the marking up? Email me\! (even when I’m on vacation)
Questions about which files are the actual source documents? Ask Christy.
Note: the development web site is on SPOCK at spock.uta.edu/usmexicowar but we’re collecting the content files and pages on walnut prior to that. The final live site will be at [http://www.uta.edu/library/usmexicowar|http://library.uta.edu/usmexicowar]
&nbsp;
Note: the development web site is on SPOCK at spock.uta.edu/usmexicowar but we’re collecting the content files and pages on JUNIPER prior to that. The final live site will be at [http://library.uta.edu/usmexicowar|http://library.uta.edu/usmexicowar]
&nbsp;
Thank you\!
&nbsp;
&nbsp;
\--Sarah
&nbsp;