Understanding XML - Revision history

XPModder at 16:38, 27 December 2024

2024-12-27T16:38:24Z

← Older revision		Revision as of 18:38, 27 December 2024
Line 296:		Line 296:
	<fruitTypeConverters><fruitTypeConverter name="FORAGEHARVESTER"><converter from="MAIZE" to="CHAFF" factor="7.8" /><converter from="GRASS" to="GRASS_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="WHEAT" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="BARLEY" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="OAT" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="CANOLA" to="CHAFF" factor="4.0" /><converter from="SUNFLOWER" to="CHAFF" factor="6.0" /><converter from="SOYBEAN" to="CHAFF" factor="4.0" /><converter from="SORGHUM" to="CHAFF" factor="4.0" /><converter from="POPLAR" to="WOODCHIPS" factor="3.0" /><converter from="RYE" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="SPELT" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="TRITICALE" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="MILLET" to="CHAFF" factor="4.0" /><converter from="LAVENDER" to="LAVENDER" factor="1.0" /><converter from="SESAME" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --></fruitTypeConverter><fruitTypeConverter name="MOWER"><converter from="GRASS" to="GRASS_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="MEADOW" to="GRASS_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="WHEAT" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="BARLEY" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="OAT" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="ALFALFA" to="ALFALFA_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="RYE" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="SPELT" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="TRITICALE" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="CLOVER" to="CLOVER_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="HORSEGRASS" to="HORSEGRASS_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="SESAME" to="STRAW" factor="1.0" windrowFactor="1.0" /></fruitTypeConverter></fruitTypeConverters>		<fruitTypeConverters><fruitTypeConverter name="FORAGEHARVESTER"><converter from="MAIZE" to="CHAFF" factor="7.8" /><converter from="GRASS" to="GRASS_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="WHEAT" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="BARLEY" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="OAT" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="CANOLA" to="CHAFF" factor="4.0" /><converter from="SUNFLOWER" to="CHAFF" factor="6.0" /><converter from="SOYBEAN" to="CHAFF" factor="4.0" /><converter from="SORGHUM" to="CHAFF" factor="4.0" /><converter from="POPLAR" to="WOODCHIPS" factor="3.0" /><converter from="RYE" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="SPELT" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="TRITICALE" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --><converter from="MILLET" to="CHAFF" factor="4.0" /><converter from="LAVENDER" to="LAVENDER" factor="1.0" /><converter from="SESAME" to="CHAFF" factor="4.0" windrowFactor="1.0" /> <!-- straw 1:1 conversion --></fruitTypeConverter><fruitTypeConverter name="MOWER"><converter from="GRASS" to="GRASS_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="MEADOW" to="GRASS_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="WHEAT" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="BARLEY" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="OAT" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="ALFALFA" to="ALFALFA_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="RYE" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="SPELT" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="TRITICALE" to="STRAW" factor="1.0" windrowFactor="1.0" /><converter from="CLOVER" to="CLOVER_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="HORSEGRASS" to="HORSEGRASS_WINDROW" factor="1.0" windrowFactor="1.0" /><converter from="SESAME" to="STRAW" factor="1.0" windrowFactor="1.0" /></fruitTypeConverter></fruitTypeConverters>
	</pre>		</pre>

			[[Category:General]]

XPModder at 16:37, 27 December 2024

2024-12-27T16:37:13Z

Show changes

XPModder at 16:12, 27 December 2024

2024-12-27T16:12:24Z

← Older revision		Revision as of 18:12, 27 December 2024
Line 55:		Line 55:
	XML does not distinguish between single-line and multi-line comments.		XML does not distinguish between single-line and multi-line comments.

	A comment begins with the string "<!--" and ends with "-->". Everything between these two will be seen as a comment regardless of how many or how few characters or lines this includes.		A comment begins with the string "<nowiki><!--</nowiki>" and ends with "<nowiki>--></nowiki>". Everything between these two will be seen as a comment regardless of how many or how few characters or lines this includes.

	Here are some examples of comments in xml:<blockquote><nowiki><!--</nowiki> This is a small single line comment -->		Here are some examples of comments in xml:<blockquote><nowiki><!--</nowiki> This is a small single line comment -->
Line 89:		Line 89:

	=== Tag contents ===		=== Tag contents ===
	In addition to attributes information can also be stored in the contents of a tag. This is only possible on pairs of opening and closing tags. To store information in the contents of a tag, the information is simply put between the opening and the closing tag like this:<blockquote><someTag>This is tag content. This can be as short or as long as you want.</someTag>		In addition to attributes information can also be stored in the contents of a tag. This is only possible on pairs of opening and closing tags. To store information in the contents of a tag, the information is simply put between the opening and the closing tag like this:<blockquote><someTag>This is tag content. This can be as short or as long as you want.</someTag><br>

	<someTag>It is even possible to have content and other tags <mixed in="with each other"/></someTag></blockquote>		<someTag>It is even possible to have content and other tags <mixed in="with each other"/></someTag></blockquote>

XPModder at 16:10, 27 December 2024

2024-12-27T16:10:58Z

@@ Line 17: / Line 17: @@
 Tags and attributes in XML generally follow the same naming convention:
-Names can be any arbitrary string as long as it consists only of letters a-z. Both lowercase and uppercase letters are allowed. Naming convention is to use only lowercase letters unless the name consists of multiple words, in which case the first letter of every word except for the first word is capitalized.
+Names can be any arbitrary string as long as it consists only of letters a-z and digits 0-9. Both lowercase and uppercase letters are allowed. Naming convention is to use only lowercase letters unless the name consists of multiple words, in which case the first letter of every word except for the first word is capitalized.
 Some examples for naming convention:
@@ Line 24: / Line 24: @@
 * fruit type -> fruitType
 * more then two words -> moreThenTwoWords
 === Tags ===
@@ Line 71: / Line 72: @@
 === Attributes ===

XPModder at 15:48, 27 December 2024

2024-12-27T15:48:48Z

← Older revision		Revision as of 17:48, 27 December 2024
Line 56:		Line 56:
	A comment begins with the string "<!--" and ends with "-->". Everything between these two will be seen as a comment regardless of how many or how few characters or lines this includes.		A comment begins with the string "<!--" and ends with "-->". Everything between these two will be seen as a comment regardless of how many or how few characters or lines this includes.

	Here are some examples of comments in xml:<blockquote><!-- This is a small single line comment -->		Here are some examples of comments in xml:<blockquote><nowiki><!--</nowiki> This is a small single line comment -->

	~~<!-- This is also all~~

	~~a comment~~

	~~regarless of~~

	~~how many~~

			<nowiki><!--</nowiki> This is also all<br>
			a comment<br>
			regarless of <br>
			how many<br>
	lines it is on -->		lines it is on -->

	<!-- Of course this		<nowiki><!--</nowiki> Of course this<br>
			<and even="all" of="this"><br>
	<and even="all" of="this">		<andThis/><br>
			</and><br>
	<andThis/>

	</and>

	this is part of the comment --></blockquote>		this is part of the comment --></blockquote>

	=== Attributes ===		=== Attributes ===

XPModder: Created page with "XML is a way of structuring information in a text file. The file ending .xml indicates that a files content is structured using XML, but a file can still be structured in XML even if it has a different file ending. Understanding the concept of XML, how information is structured and what individual parts are named is important for FS modding as the two most common files used in mods - xml and i3d files - are both structured in XML. Additionally many pages and tutorial..."

2024-12-27T15:45:37Z

Created page with "XML is a way of structuring information in a text file. The file ending .xml indicates that a files content is structured using XML, but a file can still be structured in XML even if it has a different file ending. Understanding the concept of XML, how information is structured and what individual parts are named is important for FS modding as the two most common files used in mods - xml and i3d files - are both structured in XML. Additionally many pages and tutorial..."

New page

XML is a way of structuring information in a text file.

The file ending .xml indicates that a files content is structured using XML, but a file can still be structured in XML even if it has a different file ending.

Understanding the concept of XML, how information is structured and what individual parts are named is important for FS modding as the two most common files used in mods - xml and i3d files - are both structured in XML. Additionally many pages and tutorials on this wiki regularly use names and phrases referring to specific components in an xml, so understanding what these terms mean can be important to understand the tutorials correctly.

If you are not familiar with XML and the terminology used when talking about it, please read this page carefully to be able to better understand XML and the terms used throughout this wiki.

XML structures information in a hierarchy with each element being able to contain information directly and contain additional elements inside it simultaneously.

Looking at any element A, if it contains other elements (B, C, D, etc) these are referred to as the '''children''' of the element A and element A is referred to as the '''parent''' of elements B, C, D, etc.

Note that in this structure, every element can have an unlimited number of children, but can only ever have ONE parent. Additionally a element can have no children at all, but every element, with exception of the root element and the xml element, has exactly one parent.

=== Naming convention ===
Tags and attributes in XML generally follow the same naming convention:

Names can be any arbitrary string as long as it consists only of letters a-z. Both lowercase and uppercase letters are allowed. Naming convention is to use only lowercase letters unless the name consists of multiple words, in which case the first letter of every word except for the first word is capitalized.
Some examples for naming convention:

* something -> something
* something big -> somethingBig
* fruit type -> fruitType
* more then two words -> moreThenTwoWords

=== Tags ===
The elements of a XML are called '''Tags'''.

There are three types of normal tags: Opening tags, Closing tags and Self-closing tags.

Additionally to those, some special tags like the xml version tag and the comment tag exist. These have their own subsections below.

Names of tags follow the naming convention explained above.

Opening tags without attributes merely consist of the tag name enclosed in angled brackets like this:<blockquote><tagName></blockquote>If a tag has attributes, those are in the opening tag behind the tag name and separated by spaces. See Attributes section below for more info on them.

Closing tags always only consist of the tag name, which has to be equal to that of the matching opening tag enclosed in angle brackets with a slash "/" directly after the opening angle bracket, which indicates that this is a closing tag. It looks like this:<blockquote></tagName></blockquote>Closing tags cannot contain attributes.

Self-closing tags are a special case and can be used instead of a pair of opening and closing tags when the tag has no children.

Self-closing tags can have attributes, but cannot have children.

A self-closing tag begins with a opening angle bracket "<" followed directly by the tag name and ends with a slash followed directly by a closing angle bracket "/>". Here is a simple example without attributes:<blockquote><tagName/></blockquote>

==== XML version tag ====
The XML version tag is a special kind of tag which is placed outside all other tags in the first line of a xml file. It looks like this:<blockquote><?xml version="1.0" encoding="utf-8"?></blockquote>It specifies the file as being a xml file and specifies the xml version and the encoding used for the contents of the file.

Note that the xml version tag has to be in the very first line of the file to be parsed correctly.

==== Comment tags ====
When creating large xml files, one may wish to comment something to make it easier to read for any person who may end up looking at the file. Comments are only meant for other people to read and are completely ignored by any program reading the file.

XML does not distinguish between single-line and multi-line comments.

A comment begins with the string "". Everything between these two will be seen as a comment regardless of how many or how few characters or lines this includes.

Here are some examples of comments in xml:<blockquote>



</blockquote>

=== Attributes ===