Annex B. Resources The following resources are available to help develop SMT specifications. Resources with heading backslash refer to the IDTA Teams drive. Table 1. Resources used in the document Resource Description [R1] Process Description. Registration of Asset Administration Shell Submodel templates for Digital Twins. Industrial Digital Twin Association (IDTA). V1.0 https://industrialdigitaltwin.org/en/wp-content/uploads/sites/2/2022/01/2021-12-01_IDTA_Process-Submodels_V1.0.pdf [R2] IDTA comments template \IDTA - WG2 - Submodels\Submodel-Development\00_Templates\03 IDTA Submodel Spec Comments Template.xlsx [R3] AASX Package Explorer https://github.com/eclipse-aaspe/aaspe/releases Previous releases can be found here: https://github.com/admin-shell-io/aasx-package-explorer/releases [R4] IDTA GitHub Asset Administration Shell Identifiers https://github.com/admin-shell-io/id [R5] Help file for [R3] to import/ export tables https://github.com/eclipse-aaspe/aaspe/tree/main/src/AasxPluginExportTable/help [R6] Predefined concepts for AASX Package Explorer https://github.com/eclipse-aaspe/aaspe/tree/main/src/AasxPredefinedConcepts [R7] PlantUML https://plantuml.io [R8] ISO/IEC 19505-2:2012, Information technology — Object Management Group Unified Modeling Language (OMG UML) — Part 2: Superstructure [R9] Semantic Aspect Meta Model (SAMM) https://eclipse-esmf.github.io/samm-specification/snapshot/index.html https://projects.eclipse.org/projects/dt.esmf [R10] Homepage: “AsciiDoc”. https://asciidoc.org [R11] IDTA GitHub repository for Submodel templates. https://github.com/admin-shell-io/submodel-templates [R12] AsciiDoc tools: https://docs.asciidoctor.org https://pandoc.org https://docs.asciidoctor.org/asciidoctor/latest/migrate/ms-word/ https://www.vertopal.com/en/convert/docx-to-asciidoc https://tableconvert.com/asciidoc-generator [R13] AsciiDoc templates, header & style files for SMT specifications. https://industrialdigitaltwin.sharepoint.com/:f:/r/sites/IDTA-SubmodelsPrivateTrack/Freigegebene%20Dokumente/Workstream%20%E2%80%9EProcess%E2%80%9C/02%20Best%20practice%20How%20to%20write%20a%20SMT/AsciiDoc_Template_files?csf=1&web=1&e=oPW0cy Convert Word to AsciiDoc: https://github.com/admin-shell-io/word2asciidoc [R14] Command lines for docker containers for rendering AsciiDoc to HTML / PDF (using some of the files in [R13]): For HTML: docker run -it -v .:/documents/ asciidoctor/docker-asciidoctor asciidoctor -r asciidoctor-diagram -a toc=left -a stylesheet=asciidoc-style-idta.css *.adoc For PDF with line numbers: docker run -it -v .:/documents/ asciidoctor/docker-asciidoctor asciidoctor-pdf -r asciidoctor-diagram -r ./extended.rb -a toc=macro -a pdf-theme=my-theme.yml -a env-pdf *.adoc