Guidance for FHIR IG Creation
0.1.0 - CI Build
Guidance for FHIR IG Creation, published by HL7 International - FHIR Management Group. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/FHIR/ig-guidance/ and changes regularly. See the Directory of published versions
Each page in the default language, whether markdown or XML, can have a translated copy in the translation folder.
input, inside the translation folder for that language. A page at input/pagecontent/overview.md is
translated by input/translations/nl/pagecontent/overview.md. Markdown and XML pages work the same way.The language must be declared with i18n-lang, and the folder with translation-sources. See
Setting up the IG.
Narrative translation is a whole-page copy, not a string-by-string file. That makes it easy to start, but nothing marks what changed in the source afterwards, so keep the translated pages in step with the source pages yourself.
The publisher renders each page once per language. For the default language it uses the page in
input/pagecontent. For each other language it takes the page's path relative to input, looks for that
path inside the translation-sources folder whose name ends with the language code, and uses the file if it
exists. This is why the folder must end with the language code, and why the pagecontent subfolder is
repeated inside it. Template chrome around the page, such as headings and footer text,
comes from the template's own PO files.