Difference between revisions of "XML Basics"
Blue dwarf (talk | contribs) m |
Blue dwarf (talk | contribs) |
||
| Line 15: | Line 15: | ||
</ACCOUNT> | </ACCOUNT> | ||
<ACCOUNT> | <ACCOUNT> | ||
| − | <NAME>CandyMan<NAME> | + | <NAME>CandyMan</NAME> |
<SETTINGS savePassowrd="1" autoLogin="0"/> | <SETTINGS savePassowrd="1" autoLogin="0"/> | ||
<ALIASLIST> | <ALIASLIST> | ||
| − | <ALIAS1>CandyMan</ | + | <ALIAS1>CandyMan</ALIAS1> |
| − | <ALIAS2>McCandyAndy</ | + | <ALIAS2>McCandyAndy</ALIAS2> |
</ALIASLIST> | </ALIASLIST> | ||
</ACCOUNT> | </ACCOUNT> | ||
| Line 41: | Line 41: | ||
There are two lines we haven't looked at yet, so let's look at those. | There are two lines we haven't looked at yet, so let's look at those. | ||
| − | The first one is the <nowiki>'</nowiki>'''<nowiki><!--Begin listing accounts--></nowiki>'''<nowiki>'</nowiki> line. This is what is known as a comment. Comments are used to help the user understand what a specific piece of the XML does, or someone else whose looking at the XML to understand it. Comments are ignored by the program, so if you are testing something which requires you to remove XML but you don't want to delete it, you can comment it out. Comments are NOT for old data though, if you are done with a bit of XML for good, remove it. | + | The first one is the <nowiki>'</nowiki>'''<nowiki><!--Begin listing accounts--></nowiki>'''<nowiki>'</nowiki> line. This is what is known as a comment. Comments are used to help the user understand what a specific piece of the XML does, or someone else whose looking at the XML to understand it. Comments are ignored by the program, so if you are testing something which requires you to remove XML but you don't want to delete it, you can comment it out. Comments are NOT for old data though, if you are done with a bit of XML for good, remove it. Comment |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Revision as of 10:52, 14 August 2012
XML stands for eXtensible Markup Language, it is a language that on its own doesn't actually do anything. It is used for storing and transferring data. XML has no preset tags and the syntax is quite simple to understand.
The following a is a simple bit of (made up) XML for, say two accounts for something.
<ACCOUNTLIST>
<ACCOUNT>
<NAME>Mr. Foo</NAME>
<SETTINGS savePassword="1" autoLogin="1"/>
<ALIASLIST>
<ALIAS1>Mr. Foo</ALIAS1>
<ALIAS1>Foobar</ALIAS1>
</ALIASLIST>
</ACCOUNT>
<ACCOUNT>
<NAME>CandyMan</NAME>
<SETTINGS savePassowrd="1" autoLogin="0"/>
<ALIASLIST>
<ALIAS1>CandyMan</ALIAS1>
<ALIAS2>McCandyAndy</ALIAS2>
</ALIASLIST>
</ACCOUNT>
</ACCOUNTLIST>
Now let's break that down, first of all, we can see that XML is made up of words which contain data called tags, so let's take a closer look at these.
The first tag is the ACCOUNTLIST tag. It is the root tag of this piece of xml, it is the tag that everything else comes under. XML files must have a root tag.
The second tag is the ACCOUNT tag, this tag is the one that has all the data for that specific account in, a bit like how all XML files have a root tag, this is the 'root' for that account.
The third tag is different from the first two, it contains data, in this case; a text string 'Mr. Foo', and is also closed straight away, unlike the first two.
The forth tag has something new in, 'savePassword="1" autoLogin="1"', savePassword and autoLogin are what's known as elements or attributes, these set information about a specific tag, or can be used instead of tags for neatness. These then have their own values, in this case both are 1. Double or single quotes can be used to enclose your value, but don't swap half way through your XML. Double quotes is the norm.
These tags are opened by typing '<>' around the tag name, eg '<ACCOUNT>', and are closed by putting a forward slash before the tagname, eg '</ACCOUNT>'. If a tag only needs to be present, or only has attributes and no data in it, it can't be closed by putting the forward slash before the closing pointy bracket, such as '<SETTINGS savePassword="1" autoLogin="1"/>'.
XML syntax must be correct, if there is something wrong like a tag you forgot to close, the application (SS2) will not work (or just save over it, if possible). Tags are case sensitive, like all XML is and they must be nested in the correct order and you can't close a tag until all of its children tags are closed. You can easily test your syntax by opening your XML file in a browser, if it's incorrect it'll tell you why and on what line.
There are two lines we haven't looked at yet, so let's look at those.
The first one is the '<!--Begin listing accounts-->' line. This is what is known as a comment. Comments are used to help the user understand what a specific piece of the XML does, or someone else whose looking at the XML to understand it. Comments are ignored by the program, so if you are testing something which requires you to remove XML but you don't want to delete it, you can comment it out. Comments are NOT for old data though, if you are done with a bit of XML for good, remove it. Comment
