Merge pull request #66 from OpenSimulationInterface/antora/improve_local_builds

Antora/improve local builds

Author: philipwindecker

.gitignore

@@ -1,4 +1,5 @@
 vpython/
 _build/
 .vscode/
-_templates/
+_templates/
+local_build_tools/*.html

content/_config.adoc

@@ -36,7 +36,7 @@ ifndef::include-only-once[]
 // :images_osi-sensor-model-packaging: ../../osi-sensor-model-packaging/doc/images
 :doc_open_simulation_interface: open-simulation-interface/doc/
 :doc_osi-sensor-model-packaging: osi-sensor-model-packaging/doc/
-:images_open_simulation_interface: ../../open-simulation-interface/doc/images
+:images_open_simulation_interface: ../images
 // Since a document spanning multiple repos is rendered here, the pathing regarding images is a bit involved.
 // We create a variable for every repo that is included. It point to the repo in question.
 // If the subrepo is rendered seperatly, then the variable is set to just "./images" with ifdef.
@@ -54,3 +54,10 @@ endif::[]
 ifdef::env-gitlab[]
 :relfilesuffix: .adoc
 endif::[]
+
+ifdef::local[]
+:doc_open_simulation_interface: ../../open-simulation-interface/doc/
+:doc_osi-sensor-model-packaging: ../../osi-sensor-model-packaging/doc/
+:images_open_simulation_interface: ../images
+:data-uri:
+endif::[]

content/index.adoc

@@ -43,11 +43,13 @@ include::./general_docs/versioning.adoc[leveloffset=+2]
 include::./general_standard/relations_to_other_standards.adoc[leveloffset=+2]
 
 // START: including the documentation of other osi repositories
-
+:imagesdir: {doc_open_simulation_interface}images
 include::{doc_open_simulation_interface}open-simulation-interface_user_guide.adoc[leveloffset=+1]
 
+:imagesdir: {doc_osi-sensor-model-packaging}images
 include::{doc_osi-sensor-model-packaging}osi-sensor-model-packaging_spec.adoc[leveloffset=+1]
 
+:imagesdir: ./images
 // osi-validation and osi-visualizer are considered supplementary tooling that is not normative. They are therefore not part of the ASAM standard release.
 // include::./osi-validation/doc/osi-validator_user_guide.adoc[leveloffset=+1,opts=optional]
 

local_build_tools/compose.yml

@@ -5,4 +5,6 @@ services:
     image: asciidoctor/docker-asciidoctor
     volumes:
       - ../:/documents
-    entrypoint: asciidoctor --failure-level WARN -r asciidoctor-kroki -a mathjax -r asciidoctor-bibtex --trace content/index.adoc -o local_build_tools/HTML_content_local_build.html
+      - ../../open-simulation-interface:/open-simulation-interface
+      - ../../osi-sensor-model-packaging:/osi-sensor-model-packaging
+    entrypoint: asciidoctor -a local=true --failure-level WARN -r asciidoctor-kroki -a mathjax -r asciidoctor-bibtex --trace content/index.adoc -o local_build_tools/HTML_content_local_build.html