Editing Battlestar Wiki:Template List/XML Templates/Instructions

{{inuse|'Typing Intructions'|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:

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

Secondly, everything is always encompassed by:

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

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.

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

* 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.

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

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

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

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:

<pre>
		<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>
</pre>

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

== Templates ==

The accual templates is where it gets tricky, and where there can be many many options to deal with.

<pre>
		<templates>
			<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>
                        ... Insert More Template Blocks ...
		</templates>
</pre>

This is the first type of template.

* ID - Must be a '''''unique''''' ID.
* Label - A short label.
* Text - The template itself.
* Cat - '''Optionial'''; What section it falls under. If this is not put in, it goes in the upper level section that holds the catagories in the first place.
* Tooltip - '''Optionial'''; What tooltip will shopw up if you hover your mouse over the template label.