|
|
| Line 1: |
Line 1: |
| {{navi}}{{note|The subject of this article is accessing, setting and naming developer versions. To learn about published {{rml}} versions and about our release policy, see [[dev:versions]].}} | | {{mirror}} |
| == Download railML ==
| |
| === Current stable release ===
| |
| | |
| In order to get the current stable {{rml}} package, go to the [http://www.railml.org/en/download.html''Download section''] on the [http://www.railml.org/ {{rml}} homepage] whilst logged on.
| |
| | |
| The package consists of an zip archive containing:
| |
| | |
| * XML Schema files in <tt>schema</tt> folder; and
| |
| * HTML documentation in <tt>documentation</tt> folder
| |
| | |
| XML example files can be found on {{site|http://www.railml.org/en/user/exampledata.html}}.
| |
| | |
| Current stable release is {{rml}} {{current}} resp. {{current|3}}.
| |
| | |
| === Older stable releases ===
| |
| | |
| Older officially released {{rml}} versions are archived at the [http://www.railml.org/ railML homepage]. Click ''Developers > Download'' or {{site|http://www.railml.org/en/download.html|use this direct link}}.
| |
| | |
| All schemes are zip archived.
| |
| | |
| === Developer unstable releases ===
| |
| | |
| Since railML 1.1 the development of railML can be publicly supervised through the public subversion repository located at {{site|https://svn.railml.org|railML's SVN|domain=svn}}.
| |
| Beginning on June 20<sup>th</sup>, 2016 the main branch is splitted to allow a parallel work for railML 2 and railML 3 development.
| |
| Therefore the structure is made like described below:
| |
| | |
| /
| |
| railML2/
| |
| [https://svn.railml.org/railML2/trunk/ trunk]/
| |
| branches/
| |
| tags/
| |
| railML3/
| |
| trunk/
| |
| branches/
| |
| tags/
| |
| | |
| ''Please note: The old server at {{external|http://www.assembla.com/spaces/railML|www.assembla.com}} is not longer in use since March 2014.''
| |
| | |
| {{external|http://subversion.apache.org|Subversion}} is an open source version control system. All code changes are registered with date and time together with its commiter and a commit log message.
| |
| | |
| ==== Routine downloads ====
| |
| | |
| If you want to keep track of all code commits, you should use a subversion client. A read only access to the schemes is available at {{site |http://svn.railml.org|railML's SVN|domain=svn}}, any write access is possible only for the railML coordinators.
| |
| | |
| * Change to your local railML folder.
| |
| * First time: checkout the current repository (all changes since version 1.1).
| |
| *:<pre>svn co https://svn.railml.org/</pre>
| |
| * Further: update your local repository copy as often as you want (all recent changes since last svn update).
| |
| *:<pre>svn up https://svn.railml.org/</pre>
| |
| | |
| You get railML files according to its [[#Subversion_repository_folders | repository folders]].
| |
| | |
| ==== Most recent snapshot ====
| |
| | |
| If you don't run an subversion client, you can nevertheless get a copy of the most recent developer version.
| |
| | |
| Simply click ''Developer version'' on the [http://www.railml.org/ {{rml}} homepage] to download an zip archive of repositories' [[#trunk | <tt>trunk</tt> folder]].
| |
| | |
| The zip archive contains:
| |
| | |
| * Current XML Schema files in <tt>schema</tt> folder
| |
| * Current XML example files in <tt>examples</tt> folder
| |
| * Current defect XML sample files for semantic validation purposes in <tt>defectSamples</tt> folder
| |
| * blank <tt>documentation</tt> folder
| |
| | |
| ==== Exchange a railML file based on unstable schemas ====
| |
| | |
| The following XML fragment shows how to exchange railML files using unstable railML schemas.
| |
| | |
| <pre>
| |
| <?xml version="1.0" encoding="UTF-8"?>
| |
| <railml version="2.1r416"
| |
| xmlns="http://www.railml.org/schemas/2011"
| |
| xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
| |
| xsi:schemaLocation="http://www.railml.org/schemas/2011 https://svn.railml.org/export/416/trunk/schema/railML.xsd">
| |
| ...
| |
| </railml>
| |
| </pre>
| |
| | |
| * Use the last released version number plus the current SVN number: {{Attr|version<nowiki>=</nowiki>"2.1r416"}}
| |
| * Use the last released namespace
| |
| ** as default namespace: {{Attr|xmlns<nowiki>="http://www.railml.org/schemas/2011"</nowiki>}}
| |
| ** as prefixed namespace: {{Attr|xmlns:rail<nowiki>="http://www.railml.org/schemas/2011</nowiki>"}} (not shown above)
| |
| * Use the appropriate web-based Schema location at railML.org: {{Attr|xsi:schemaLocation<nowiki>="http://www.railml.org/schemas/2011 https://svn.railml.org/export/416/trunk/schema/railML.xsd"</nowiki>}}
| |
| | |
| For local validation purposes, see [[CO:catalog|Local versus web-based validation (XML catalogs and XML namespaces)]]
| |
| | |
| For more information on how to use version numbers and namespaces, see [[CO:versions|Recommendations on version numbers]].
| |
| | |
| == Subversion repository folders ==
| |
| | |
| === trunk ===
| |
| | |
| The /trunk/ directory contains the source files that the next public and stable project release is based on.
| |
| | |
| === tags ===
| |
| | |
| The /tags/ directory contains snapshots of public and stable project versions that have been released.
| |
| | |
| === branches ===
| |
| | |
| The /trunk/ directory contains the source files that the next public and stable project release is based on.
| |
| | |
| Back to [[Hauptseite#Common_.28CO.29| Common overview]]
| |
| | |
| [[Category:GeneralDescription]]
| |
| [[category:Common Concept]]
| |