Forum: Reference Library - entries, requests, etc.

Discussing: Preferred Practices in Resources

Preferred Practices in Resources

Note: This thread was formerly known as Useful Tools and Templates. Hi, I have set up a few small but helpful HTML templates to use for different types of entries in the Resources Library, and I though I'd share them with you in this thread. Please feel free to share any tools or templates you have, too, or to ask questions about any of the ones already posted. - Barbara



Template - Bio Entry for a Character

This is an HTML template that creates all the standard sections for a Bio entry that describes a Character, along with a Table of Contents that hyperlinks to each section title. Note: many of these sections are similar to, and also appear in, the Bio entries for Races; for help with what type of quotations to place in each section, see the Suggested Format of the Bio Entries for Races post. To use this template, copy and paste it into an empty text file, replace all the { with < , then fill in your text. Note: the way this is set up now, there will be two blank lines between the TOC (Table of Contents) and the first section title ("Description"). If you wish to reduce that to one blank line, remove the line break between the {a href="#Note1... line and the {b>{a name="Description"... line. I usually leave two blank lines before each section title (at least, if the entry is more than a couple screens long), and one blank line after. For an example that actually uses each of these sections, see the Bio for Beorn. If you have any questions or suggestions, let me know! - Barbara {br />{b>{a name="TOC">Table of Contents:{/a>{blockquote>{a href="#Description">Description{/a> {a href="#Skills">Skills{/a> {a href="#History">History{/a> {a href="#Language">Language{/a> {a href="#Etymology">Etymology{/a> {a href="#Note1">Notes{/a>{/blockquote>{/b> {b>{a name="Description">Description{/a>{/b> {b>{a name="Skills">Skills{/a>{/b> {b>{a name="History">History{/a>{/b> {b>{a name="Language">Language{/a>{/b> {b>{a name="Etymology">Etymology{/a>{/b> {b>{a name="Note1">Notes{/a>{/b>



Sample - Hyperlinking to a section within another entry

Say you have an entry like Beorn's, which uses the linkable section names as illustrated above. And say you wish to link from another entry to one of the sections within Beorn's entry, say the Etymology section. Here's how you do it (notice the # preceding the section title): (Replace all the { with < ). A normal link to Beorn: {a href="../resources/bios_view.cfm?SCID=207">Beorn{/a> (Beorn) A link to the Etymology section of Beorn's entry (note the # preceding the section title): {a href="../resources/bios_view.cfm?SCID=207#Etymology">Beorn{/a> (Beorn's etymology) - Barbara



Template - Numbered and hyperlinked footnotes

If you want to create an entry with multiple footnotes, and wish to hyperlink to the corresponding notes, you can do it like this (copy the template, and change all the { to <): Edit 1: Corrected position of {b> (bold) tag 22Nov04. Edit 2: Converted to superscripts 14Jan05. Blah blah blah{sup>{a href="#Note1">1{/a>{/sup> blahdy blahdy blahdy{sup>{a href="#Note2">2{/a>{/sup> and so on and so on ad nauseum{sup>{a href="#Note3">3{/a>{/sup>... {a name="Note1">{b>Notes{/b> 1{/a> (Text of Note 1) {a name="Note2">2{/a> (Text of Note 2) {a name="Note3">3{/a> (Text of Note 3) ----------------------------- After you replace the { with <, the result will look something like this: Blah blah blah1 blahdy blahdy blahdy2 and so on and so on ad nauseum3... Notes 1 (Text of Note 1) 2 (Text of Note 2) 3 (Text of Note 3)



Template - Bio Entry for a Race

This HTML template creates all the standard sections for a Bio entry that describes a Race (Dwarf, Elf, Hobbit, etc.), along with a Table of Contents that hyperlinks to each section title. Edit: 20Jan05: Added section descriptions. Edit: 23Jan05: Added suggested subsection titles. Edit: 14Apr05: Added missing sections to the TOC. To use this template, copy and paste it into an empty text file, replace all the { with < , then fill in your text. See the Template - Character Bio post for a note on spacing between sections. {br />{b>{a name="TOC">Table of Contents:{/a>{blockquote>{a href="#Description">Description{/a> {a href="#DescPA">— Physical Appearance{/a> {a href="#DescCT">— Character Traits{/a> {a href="#DescCB">— Cultural Beliefs{/a> {a href="#DescRO">— Relations with Others{/a> {a href="#Origins">Origins{/a> {a href="#Skills">Skills{/a> {a href="#History">History{/a> {a href="#HistT">— Time of the Trees{/a> {a href="#Hist1">— First Age{/a> {a href="#Hist2">— Second Age{/a> {a href="#Hist3">— Third Age{/a> {a href="#Hist4">— Fourth Age{/a> {a href="#Language">Language{/a> {a href="#Etymology">Etymology{/a> {a href="#Note1">Notes{/a>{/blockquote>{/b> {b>{a name="Description">Description{/a>{/b> {b>{a name="DescPA">Description: Physical Appearance{/a>{/b> {b>{a name="DescCT">Description: Character Traits{/a>{/b> {b>{a name="DescCB">Description: Cultural Beliefs{/a>{/b> {b>{a name="DescRO">Description: Relations with Others{/a>{/b> Quotations describing the race in general, including any distinguishing characteristics -- ways that they are: "short and broad, long and strong in the arm; their skins were swart or sallow, and their hair was dark as were their eyes...", "The Dwarves are a tough, thrawn race for the most part, secretive, laborious...", "many savage tribes from the East (of old corrupted by Morgoth)...", "The first Elves that Men met in the world were Avari, some of whom were friendly to them, but the most avoided them or were hostile (according to the tales of Men)...". {b>{a name="Origins">Origins{/a>{/b> Quotations describing how the race began, its kinship, and its ancient migrations: "By the starlit mere of Cuiviénen, the Elves rose from the sleep of Ilúvatar...", "The Northmen appear to have been most nearly akin to the House of Hador...", "The Edain were the descendants of peoples who in the Dark Ages had resisted Morgoth and had wandered ever westward from their homes far away in the East seeking the Great Sea..." {b>{a name="Skills">Skills{/a>{/b> Quotations about abilities, crafts, expertise, or competencies that distinguish this race from others -- things that they do: "the Noldor devised tools for the cutting and shaping of gems, and carved them in many forms...", "the Northmen delighted in horses and in all feats of horsemanship...", "They journeyed in great wains, and their chieftains fought in chariots.", "their younger women were also gained in arms and fought fiercely in defence of their homes...". {b>{a name="History">History{/a>{/b> {b>{a name="HistT">History: Time of the Trees{/a>{/b> {b>{a name="Hist1">History: First Age{/a>{/b> {b>{a name="Hist2">History: Second Age{/a>{/b> {b>{a name="Hist3">History: Third Age{/a>{/b> {b>{a name="Hist4">History: Fourth Age{/a>{/b> Quotations (in chronological sequence, with dates or estimates) describing important events in the history of the race: "1601 Hobbits are granted land beyond Baranduin by Argeleb II.", "1636 When the Great Plague passed more than half of the Northmen had perished, and their horses also." {b>{a name="Language">Language{/a>{/b> Quotations describing the language(s) of the race: "East of the Misty Mountains, even far to the north, the Common Speech was known; though there, as beside the Long Lake or in Dale, or among the Beornings and the Woodmen of the west-eaves of Mirkwood, Men also retained their own tongues in daily use.", "The Dwarven language, Khuzdul, was seldom learned by those of other race." {b>{a name="Etymology">Etymology{/a>{/b> Quotations describing the origins of the name(s) of the race or of items associated with the race: "The name Beorn (from which Beornings derived) is actually an Old English word for 'man, warrior,' but originally meant 'bear'; it is a cognate with the Old Norse björn, 'bear.'", "The name (Quenya noldo, Sindarin Golodh) meant 'The Wise' (but wise in the sense of possessing knowledge, not in the sense of possessing sagacity, sound judgement).", "The Quenya word Silmarilli is said to derive from the name silima that Fëanor gave to the substance from which they were made." {b>{a name="Note1">Notes{/a>{/b> Quotations that expand upon some of the information contained within that Race's entry (see the Numbered and Hyperlinked Footnotes post for a template): "2 The Númenórean ranga was slightly longer than our yard..."



Template - Event Entry for a Battle

This is a general-purpose military event template, useful for battles, wars, invasions, sieges, attacks, etc. I have inserted descriptions of each section and sample quotations in place of the text in each section. For a large event (e.g. the Battle of the Pelennor), I usually have one event called "Battle of the Pelennor: Overview", which follows as much of this template as possible with the information available. Then, I create sub-events, such as Witch-king Slain by Éowyn and Merry in the Battle of the Pelennor, each of which begins with the comment: "An event in the Battle of the Pelennor; see that entry for an overview:" Links to all the sub-events appear in the Timeline section of the Overview event. Edit: 19Jan05: Changed "The Enemy" to "The Combatants" To use this template, copy it to a text file, replace all the { with <, and replace the descriptive text with the quotations that you have compiled. {br />{b>{a name="TOC">Table of Contents:{/a>{blockquote>{a href="#Enemy">The Combatants{/a> {a href="#EnemyAF">— Attacking Forces{/a> {a href="#EnemyDF">— Defensive Forces{/a> {a href="#Timeline">The Timeline{/a> {a href="#Prelude">The Prelude{/a> {a href="#Description">The Battle{/a> [or War, Invasion, Siege...] {a href="#Aftermath">The Aftermath{/a> {a href="#Note1">Notes{/a>{/blockquote>{/b> {b>{a name="Enemy">The Combatants{/a>{/b> {b>{a name="EnemyAF">Attacking Forces{/a>{/b> {b>{a name="EnemyDF">Defensive Forces{/a>{/b> A description of each of the opposing forces in the battle, including their numbers and armament: "the Haradrim who occupied Ithilien...", "battalions of Orcs of the Eye, and countless companies of Men...", "troll-men and Variags and orcs that hated the sunlight", "the Southrons were bold men and grim...", "a great fleet manned by the corsairs of Umbar...", "the Dunlendings saw their chance...", "allies of Sauron that had long threatened the borders...", "five hundred grim dwarves clad in hauberks of steel mail...", "In its right hand was a blade; in its left it held a whip of many thongs.", "they were only rudely armed, and had no great number of horses for riding...". {b>{a name="Timeline">The Timeline{/a>{/b> A chronological summary (quoted from the Tale of Years, if possible) of the sequence of events before, during, and after the battle (mainly useful for overviews of multi-day or -year events, like wars, sieges, or invasions, or an event group, like a battle and a subsequent siege); includes links to other events in a related series (note: this example is an actual entry from the Battles of Dale and Erebor in the War of the Ring): March 3019 17 Battle of Dale. King Brand and King Dáin Ironfoot fall. Many Dwarves and Men take refuge in Erebor and are besieged. ... [See: Battle of Dale] [See: Brand, King of Dale, slain in the Battle of Dale] [See: Dáin II Ironfoot, King under the Mountain, slain in the Battle of Dale] [See: Siege of Erebor] 27 Bard II and Thorin III Stonehelm drive the enemy from Dale. [See: Bard II becomes King of Dale] [See: Thorin III Stonehelm becomes King under the Mountain] The Return of the King, LoTR Appendix B, The Tale of Years: The Third Age {b>{a name="Prelude">The Prelude{/a>{/b> The prior events, actions, attitudes, alliances, or other changes precipitating the battle, preparing for it, or influencing its outcome, either immediately or over time: "they were stirred up by the emissaries of Sauron...", "Thrór slain by an Orc in Moria...", "Cirion sent north for help...", "warning that the Wainriders were plotting to raid Calenardhon", "a revolt of those enslaved was being prepared...", "eager for a share of the spoil...", "determined to avenge the defeat of his father...", "after the Great Plague, the forts were abandoned to chieftains of mixed Dunlendish blood...", "less than a year ago they won back the crossings...", "it took three years to muster all their strength...", "The eagles must have gathered from all the eyries of the North...", "divided his forces into a northern army and a southern...", "fortified the isle of Cair Andros...", "the wains bear away to refuge the aged, the children, and the women...". {b>{a name="Description">The Battle{/a>{/b> [or War, Invasion, Siege...] A description of the action, participants, terrain, and tactics during the battle: "Ere long the vanguard swirled round the spur's end and came rushing in...", "Many Dwarves and Men take refuge in Erebor and are besieged...", "the army had been driven across the Limlight, and was then suddenly assailed by the Orc-host that pressed it towards the Anduin...", "Rocks were hurled down from on high by the goblins above...", "the army of Gondor was saved from annihilation through the rearguard defence of Marhari...", "they were drawn up on two great hills of blasted stone and earth...", "a great host of foes was arrayed on the slopes above them...", "all his arrows but one were spent...", "Dáin fell, standing over the body of King Brand before the Gate of Erebor...", "Beorn tossed wolves and goblins from his path like feathers...", "the enemy broke and were soon in disordered flight...", "the horsemen of Marhwini harried the fugitives and inflicted great loss upon them in their long rout over the plains...". {b>{a name="Aftermath">The Aftermath{/a>{/b> The military, political, social, or geographical consequences of the battle, either immediate or longer term: "not one living foe was left within the circuit of the Rammas...", "Barely half of their number could still stand or had hope of healing...", "the evil realm was brought to naught", "After the deaths of Ondoher and both his sons, Arvedui laid claim to the crown of Gondor...", "the Rohirrim lived in perpetual alliance with Gondor...", "word had gone out that the king was indeed come among them...", "Most of the Northmen were reduced to servitude, and all their former lands were occupied...", "Cirion ceded Calenardhon to Eorl and his people...", "the sea roared in through many chasms...", "the frontiers of Gondor were for that time withdrawn to the Anduin...". {a name="Note1">{b>Notes{/b> Comments or quotations that expand upon some of the information contained within the entry (see the Numbered and Hyperlinked Footnotes post for a template): "1. The year is canon, but the date is an estimate.", "2. The Númenórean ranga was slightly longer than our yard...", "3. Here Beorn exhibits some of the qualities of the legendary Old Norse berserker...".



Hierarchy of sources

Hierarchy of sources for dates, maps and etymology Note : In any instance where Christopher Tolkien points out an error noted in a 'higher' source, his correction would prevail. LotR The Hobbit Silmarillion Unfinished Tales HoME volumes in reverse order The portions that have particular implications for Resource assistants entering data: For dates: The LotR appendices dates take precedence over UT and Peoples of Middle-earth. The War of the Jewels, HoME 11, and The Peoples of Middle-earth, HoME 12, should take precedence over The Lost Road, HoME 5. Where The Silmarillion has dates, they should be used, but most dates for First Age events will have to come from other sources. Within any volume, such as The War of the Jewels, The Tale of Years, the furthest down the alphabet is the latest, and therefore preferred, version. Thus version D2 is accepted over D1, and any D over C, etc. For maps: Those in LotR, Hobbit, Silmarillion, and UT take precedence. Anything added (and which doesn't contradict the above) can be accepted from other HoME volumes, such as The Treason of Isengard, HoME 7. "Pictures by J.R.R. Tolkien" and "J.R.R. Tolkien: Artist and Illustrator" which have Tolkien's drawings vary quite a bit - any map contradicting LotR would be problematic, but augmenting LotR maps is fine. Etymology: RotK Appendix F, The Silmarillion, Unfinished Tales, and HoME 5, The Lost Road, all are good sources. Tolkien's "Guide to Names in The Lord of the Rings" which was in early versions of "A Tolkien Compass," and explained the meaning of many names, is also a good source. Tolkien's sources take precedence over all others, and his internal contradictions, where present, should be mentioned. Other reputable linguistic sources may be quoted if identified, but quotes from Tolkien are preferred. Examples would be the work of David Salo, Ardalambion, and others. Be very careful with sources, as there is much 'invented' by those eager for more words to use. Misc: "Letters of JRR Tolkien" will vary by date of the letter. A few non-Tolkien sources, such as "The Annotated Hobbit" and "The Atlas of Middle-earth" are good starting points, but the material should be checked against the source - they should supplement but not contradict Tolkien's words. Quotes from or reference to these are acceptable, but as noted above, Tolkien's words are preferred when possible. Such books as The Complete Guide to Middle-earth, written by Robert Foster have errors; anything in there must be carefully checked against Tolkien sources. The same is true of the Encyclopedia of Arda and some other online Tolkien encyclopedias, as their accuracy varies. Quotes from these should not be used.




Based on Elena Tiriel/Barbara's wonderful work compiling these in a spreadsheet, I created a story with Citations for Tolkien's writings. All HASA members are welcome to make use these citations in resource library entries or their own work. If you copy the citations with the < and > brackets and paste them into your resource library entry or story, they will appear with the correct italic formatting in the entry or story without you having to hand code the HTML markup yourself. The citations are not exhaustive where HoMe and, I think, UT are concerned. I will try to keep the HASA story updated as we add new citations, but Barbara's master copy of the spreadsheet will usually be more up to date than this story.



In Forums

Discussion Info

Intended for: General Audience

This forum is open to all HASA members. It is read-only for the general public.

Membership on HASA is free and it takes only a few minutes to join. If you would like to participate, please click here.

If you are already a member, please log in to participate.

« Back to Reference Library - entries, requests, etc.