We work here to create the next NeTEX realisation guide.
The finalised version (as HTML) can be found here: https://opentdatach.github.io/netexRealisationGuideSwitzerland/.
The original markdown sources can be found here: markdown folder
none
- 2026-04: repo ready, moved to MD
- 2026-07: first draft ready (Release candidate 1)
- 2026-10: input from review incorporated and second review(Release candidate 2)
- 2026-12: ready for release, discussed with KI ADM and KIDS AG Solldaten (Release)
Source folders added to git:
| Folder | Content |
|---|---|
| src | The document sources of the realisation guide (with links) |
| src/templates | Template files to generade schematrons and elements in elements.md |
| src/examples | Valid XML examples based on use cases |
| jekyll | jekyll template folder (is copied to the site folder during the build). Jekyll is used to generate html for GitHub pages. |
| mgmt | Governance and organisation |
| tools | Python tools to build everything (see) |
| xsd | The NeTEx 2.0 XSD. This is a submodule. Way to check it out here |
The (build automation framework) generates target documents from source documents.
These target documents are written to site and according subfolders, excluded from git:
| Folder | Content |
|---|---|
| site | Destination folder for generated docs. The content of this older is deployed to github pages. |
| site/schematrons | Schematron files to be used to validate Swiss data files |
| site/xml-snippets | Simple element examples XML. |
| site/netex-html | xcore documentation of the NeTEX XSD. |
| site/tables | markdown tables of the relevant elements |
| site/templates | Templates files to publish |
| site/examples | Examples files to publish |
Contact: info.fachbus@sbb.ch