Battlestar Wiki:Template List/XML Templates/Instructions

This article is actively undergoing a major edit for 'Typing Intructions'. As a courtesy, please do not edit this article while this message is displayed. The person who added this notice is Shane.

To help you through the editing of this process this page breaks down the sections of the XML document, and how everything should be formated.

The XML Document

The XML document holds all the templates, sections (catagories), and any addistionial values that many be needed for the website in question, however there are only so many options that the Wikipedia Toolbar can handle.

First of all, the XML document always starts with this line:

<?xml version="1.0" encoding="UTF-8" ?>

Secondly, everything is always encompassed by:

<site>
    ....Everything else....
</site>

With these basic elements, you can start putting the basic settings in the XML document.

Basic Setup

The first "block" that every XML document must have is the overview block.

	<overall>
		<name>Battlestar Wiki</name>
		<type>mediawiki</type>
		<icon>bsgicon.png</icon>
		<lang>en</lang>
	</overall>

• Name - The full name of the wiki
• Type - The type of wiki that it operates.
• Icon - For future
• Lang - The lanagues installed. Seperated by comma's (,).

Lang Setup

Each language has their own block.

	<en>
            ... Data ...
	</en>

The "overall" block for each langauge is as follows:

	<en>
		<settings>
			<fullname>English</fullname>
			<loc>http://www.battlestarwiki.org/en</loc>
		</settings>
                ... Template & Category Value ...
	</en>

If the host (i.e. http://www.battlestarwiki.org) is not unique for each language when viewing the Wiki, you must enter the "edit" url. For this wiki, and for the English side, the url is located above.

Sections

To have different sections withing the "popup" menu, follow this format:

		<sections>
			<section>
				<label>Citations</label>
				<area>cit</area>
			</section>
			<section>
				<label>Endnote/Footnote References</label>
				<area>endfoot</area>
				<parent>cit</parent>
			</section>
                        .... More Sections Here ....
		</sections>

• Label - Short Label of the Section
• Area - A unique ID for this section.
• Parent - Optionial; If this is set, this must equal something to area and must be placed after the orginal section is placed. (as shown above).

Templates

		<templates>
			<template>
				<id>note</id>
				<label>Note</label>
				<text>{{note|%idname}}</text>
				<cat>cit</cat>
				<tooltip>Used in the endnote/footnote section ...</tooltip>
				<idname>What is the reference ID? ...</idname>
			</template>
			<template>
				<id>rdmblog</id>
				<label>From RDM Blog</label>
				<text>{{From RDM blog}}</text>
				<cat>cit</cat>
				<tooltip>Used to cite RDM's blog.</tooltip>
			</template>
			<template>
				<id>userdata</id>
				<label>User Data</label>
				<text>{{User Data|
				|photo= %image
				|name= %name
				|age= %age
				|location= %location
				|email= %email
				|gmail= %gmail
				|aim= %aim
				|callsign= %callsign
				|parents= %parents
				|siblings= %siblings
				|children= %childern
				|marital status= %maritalstatus
				|occupation= %occupation
				|rank=  %rank
				|admin= %admin
				}}</text>
				<cat>dblocks</cat>
				<tooltip>User data block</tooltip>
			</template>
		</templates>

Re-imagined Series definition: initial skills training; can refer to basic military indoctrination, and arms and ground training ^{(TRS: "Fragged")}; and basic flight training ^{(TRS: "Miniseries")}

Re-imagined Series definition: a nickname used as a substitute for an aviator's given name in wireless communications and in conversation