excluding certain commits

changed some metadata properties to be able to publish on Zenodo

.github/tex/packages.doc.txt

@@ -0,0 +1,53 @@
+## -- engine used to compile (pdflatex)
+latex-bin
+latexmk
+
+## -- direct dependencies
+tikz-trackschematic
+koma-script
+pgf
+xkeyval
+etoolbox
+adjustbox
+booktabs
+xltabular
+tools
+marginnote
+babel-english
+vhistory
+carlisle
+xcolor-solarized
+enumitem
+listings
+siunitx
+amsmath
+hyperref
+bookmark
+preprint
+
+## -- lwarp dependencies
+lwarp
+ifptex
+
+## -- indirect dependencies
+standalone
+epstopdf-pkg
+ltablex
+collectbox
+geometry
+environ
+xpatch
+infwarerr
+catchfile
+ltxcmds
+etexcmds
+letltxmacro
+newunicodechar
+upquote
+kvoptions
+kvsetkeys
+comment
+xstring
+microtype
+psnfss
+collection-fontsrecommended

.github/tex/packages.test.txt

@@ -0,0 +1,19 @@
+## -- engine used to compile (pdflatex)
+latex-bin
+
+## -- direct dependencies
+pgf
+xkeyval
+etoolbox
+adjustbox
+booktabs
+xltabular
+tools
+
+## -- indirect dependencies
+standalone
+epstopdf-pkg
+ltablex
+collectbox
+geometry
+environ

.github/tex/packages.upload.txt

@@ -0,0 +1,2 @@
+## -- upload
+ctan-o-mat

.github/tex/profile.basic.txt

@@ -0,0 +1,13 @@
+# .github/tex/basic.profile.txt
+# used for paolobrasolin/setup-texlive-action@v1
+# Install the scheme:
+#
+#    basic scheme (<minimal> and latex)
+#
+selected_scheme scheme-basic
+# Omit documentation files:
+tlpdbopt_install_docfiles 0
+# Omit source files:
+tlpdbopt_install_srcfiles 0
+# Avoid doing backups:
+tlpdbopt_autobackup 0

.github/tex/profile.full.txt

@@ -0,0 +1,13 @@
+# .github/tex/full.profile.txt
+# used for paolobrasolin/setup-texlive-action@v1
+# Install the scheme:
+#
+#    full scheme (everything)
+#
+selected_scheme scheme-full
+# Omit documentation files:
+tlpdbopt_install_docfiles 0
+# Omit source files:
+tlpdbopt_install_srcfiles 0
+# Avoid doing backups:
+tlpdbopt_autobackup 0

.github/tex/profile.medium.txt

@@ -0,0 +1,13 @@
+# .github/tex/medium.profile.txt
+# used for paolobrasolin/setup-texlive-action@v1
+# Install the scheme:
+#
+#    medium scheme (<small> + more packages and languages)
+#
+selected_scheme scheme-medium
+# Omit documentation files:
+tlpdbopt_install_docfiles 0
+# Omit source files:
+tlpdbopt_install_srcfiles 0
+# Avoid doing backups:
+tlpdbopt_autobackup 0

.github/tex/profile.minimal.txt

@@ -0,0 +1,13 @@
+# .github/tex/minimal.profile.txt
+# used for paolobrasolin/setup-texlive-action@v1
+# Install the scheme:
+#
+#   minimal scheme (plain only)
+#
+selected_scheme scheme-minimal
+# Omit documentation files:
+tlpdbopt_install_docfiles 0
+# Omit source files:
+tlpdbopt_install_srcfiles 0
+# Avoid doing backups:
+tlpdbopt_autobackup 0

.github/tex/profile.small.txt

@@ -0,0 +1,13 @@
+# .github/tex/small.profile.txt
+# used for paolobrasolin/setup-texlive-action@v1
+# Install the scheme:
+#
+#    small scheme (<basic> + xetex, metapost, and a few languages)
+#
+selected_scheme scheme-small
+# Omit documentation files:
+tlpdbopt_install_docfiles 0
+# Omit source files:
+tlpdbopt_install_srcfiles 0
+# Avoid doing backups:
+tlpdbopt_autobackup 0

.github/tex/tikz-trackschematic.pkg

@@ -0,0 +1,125 @@
+% This is a description file for ctan-o-mat.
+% It manages uploads of a package to 
+% CTAN -- the Comprehensive TeX Archive Network.
+%
+% The syntax is roughly oriented towards (La)TeX.
+% Two form of the macros are used. The simple macros take one argument
+% in braces. Here the argument may not contain embedded macros.
+%
+% The second form uses an environment enclosed in \begin{}/\end{}.
+% In the long text fields logo macros can be used.
+%
+% You should enter your values between the begin and the end of the
+% named type.
+% -------------------------------------------------------------------------
+% This field contains the CTAN id of the package.
+% The value is optional.
+% The value is restricted to 32 characters.
+\pkg{tikz-trackschematic}
+% -------------------------------------------------------------------------
+% This field contains the version of the package.
+% The value is optional.
+% The value is restricted to 32 characters.
+\version{}%%[SCRIPT]
+% -------------------------------------------------------------------------
+% This field contains the name of the author(s).
+% The value is optional.
+% The value is restricted to 128 characters.
+\author{Martin Scheidt}
+% -------------------------------------------------------------------------
+% This field contains the email address of the uploader.
+% The value is an email address.
+% The value is restricted to 255 characters.
+\email{m.scheidt@tu-braunschweig.de}
+% -------------------------------------------------------------------------
+% This field contains the name of the uploader.
+% The value is restricted to 255 characters.
+\uploader{Martin Scheidt (via github actions)}
+% -------------------------------------------------------------------------
+% This field contains the directory on CTAN.
+% The value is optional.
+% The value is restricted to 255 characters.
+\ctanPath{/graphics/pgf/contrib/tikz-trackschematic}
+% -------------------------------------------------------------------------
+% This field contains the license.
+% The value is optional.
+% The value is restricted to 2048 characters.
+% Multiple values are allowed.
+\license{isc}
+% -------------------------------------------------------------------------
+% This field contains the URL of the home page.
+% The value is optional.
+% The value is a URL.
+% The value is restricted to 255 characters.
+% Multiple values are allowed.
+\home{https://www.railtoolkit.org/projects/tikz-trackschematic/}
+% -------------------------------------------------------------------------
+% This field contains the URL of the bug tracker.
+% The value is optional.
+% The value is a URL.
+% The value is restricted to 255 characters.
+% Multiple values are allowed.
+\bugtracker{https://github.com/railtoolkit/tikz-trackschematic/issues}
+% -------------------------------------------------------------------------
+% This field contains the support channel.
+% The value is optional.
+% The value is a URL.
+% The value is restricted to 255 characters.
+% Multiple values are allowed.
+\support{}
+% -------------------------------------------------------------------------
+% This field contains the version management.
+% The value is optional.
+% The value is a URL.
+% The value is restricted to 255 characters.
+% Multiple values are allowed.
+\repository{https://github.com/railtoolkit/tikz-trackschematic}
+% -------------------------------------------------------------------------
+% This field contains the developer's channel.
+% The value is optional.
+% The value is a URL.
+% The value is restricted to 255 characters.
+% Multiple values are allowed.
+\development{}
+% -------------------------------------------------------------------------
+% This field contains the update indicator; true for update.
+% The value is optional.
+% The value is restricted to 8 characters.
+\update{true}
+% -------------------------------------------------------------------------
+% This field contains the topics id.
+% The value is optional.
+% The value is restricted to 1024 characters.
+% Multiple values are allowed.
+\topic{}
+% -------------------------------------------------------------------------
+% This field contains the text for the mail announcement.
+% The value is optional.
+% The value is restricted to 8192 characters.
+\begin{announcement}
+ %RELEASE-NOTES%%[SCRIPT]
+\end{announcement}
+% -------------------------------------------------------------------------
+% This field contains the one-liner for the package.
+% The value is optional.
+% The value is restricted to 128 characters.
+\summary{A TikZ library for creating track diagrams in railways}
+% -------------------------------------------------------------------------
+% This field contains the descriptive abstract for the package.
+% The value is optional.
+% The value is restricted to 4096 characters.
+\begin{description}
+  This TikZ library is a toolbox of symbols geared primarily towards creating track schematic for either research or educational purposes. It provides a TikZ frontend to some of the symbols which may be needed to describe situations and layouts in railway operation. The library is divided into sublibraries: topology, trafficcontrol, vehicles, constructions, electrics, symbology, and measures.
+\end{description}
+% -------------------------------------------------------------------------
+% This field contains the note to the CTAN upload managers.
+% The value is optional.
+% The value is restricted to 2048 characters.
+\begin{note}
+  Uploaded automatically by ctan-o-mat (via github actions)
+\end{note}
+% -------------------------------------------------------------------------
+% This field contains the archive file.
+% The value is the file name of the archive to be uploaded.
+% It may have a relative or absolute directory.
+\file{}%%[SCRIPT]

.github/workflows/cffvalidating.yaml

@@ -0,0 +1,25 @@
+### github action to publish a new CITATION.cff 
+##
+name: "cff validation"
+
+## Controls when the workflow will run
+on:
+  push:
+    paths:
+      - CITATION.cff
+
+  ## Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  validate:
+    name: "validate"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out a copy of the repository
+        uses: actions/checkout@v3
+
+      - name: Validate a CITATION.cff from a subdirectory
+        uses: citation-file-format/cffconvert-github-action@2.0.0
+        with:
+          args: "--infile ./CITATION.cff --validate"

.github/workflows/debug.yaml

@@ -0,0 +1,82 @@
+### github action to publish a debug
+##
+name: "debug"
+
+## Controls when the workflow will run
+on:
+  # push:
+  #   branches: [ github-action ]
+
+  ## Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+## A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+  debug:
+    # needs: create_package
+    # The type of runner that the job will run on
+    runs-on: ubuntu-latest
+
+    # Steps represent a sequence of tasks that will be executed as part of the job
+    steps:
+      - name: "checkout"
+        # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+        uses: actions/checkout@v3
+
+      # # download artifact in folder artifact/
+      # - uses: actions/download-artifact@v3
+
+      # - name: "install ghostscript"
+      #   run: sudo apt-get install -y ghostscript
+      
+      ###### multiple options for a TeX environment
+      #   ##
+      # - name: "setup TeX Live (via apt-get)"
+      #   # old TeX Live version: 2019
+      #   run: |
+      #     sudo apt-get update -y || sudo apt-get update -y || sudo apt-get update -y
+      #     sudo apt-get install -y texlive-latex-base || sudo apt-get install -y texlive-latex-base || sudo apt-get install -y texlive-latex-base
+      #   ##
+      # - name: "setup TeX Live (via DanySK)"
+      #   # old TeX Live version: 2019
+      #   uses: DanySK/setup-texlive-action@master
+      #   with:
+      #     requirements-file: .github/tex/packages.test.txt
+      #   ##
+      # - name: "setup TeX Live (via teatimeguest)"
+      #   uses: teatimeguest/setup-texlive-action@v2
+      #   with:
+      #     package-file: .github/tex/packages.test.txt
+      #   ##
+      - name: "setup TeX Live (via paolobrasolin)"
+        uses: paolobrasolin/setup-texlive-action@v1
+      #   with:
+      #     profile-path:  ${{ github.workspace }}/.github/tex/profile.minimal.txt
+      #     packages-path: ${{ github.workspace }}/.github/tex/packages.doc.txt
+      - run: tlmgr install ctan-o-mat
+
+      # - name: "install tikz-trackschematic"
+      #   run: ./build.sh --non-interactive --install-dev
+
+      # - name: "test tikz-trackschematic"
+      #   run: ./build.sh --non-interactive --test --verbose
+
+      #   ## create varibale ${{ steps.tag.outputs.tag }}
+      # - name: "get tag"
+      #   id: tag
+      #   uses: dawidd6/action-get-tag@v1
+      #   with:
+      #     # Optionally strip `v` prefix
+      #     strip_v: false
+
+      # - name: "create tikz-trackschematic package"
+      #   run: ./build.sh --non-interactive --release ${{ steps.tag.outputs.tag }}
+
+        ## opening a debug console
+      - name: Setup upterm session
+        env:
+          ZENODO_ACCESS_TOKEN: ${{ secrets.ZENODO_ACCESS_TOKEN }}
+          ZENODO_SANDBOX_ACCESS_TOKEN: ${{ secrets.ZENODO_SANDBOX_ACCESS_TOKEN }}
+        uses: lhotari/action-upterm@v1
+        with:
+          limit-access-to-actor: true

.github/workflows/release.yaml

@@ -0,0 +1,189 @@
+### github action to make and publish a release
+##
+name: release
+
+## Controls when the workflow will run
+on:
+  ## Triggers the workflow on push or pull request events but only for the master branch
+  push:
+    tags:
+      - "v*"
+
+## A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+  create_package:
+    name: "create a TeX Live package for tikz-trackschematic"
+    outputs:
+      version: ${{ steps.tag.outputs.tag }}
+    runs-on: ubuntu-latest
+    steps:
+      # 1. get varibale tag and put it in ${{ steps.tag.outputs.tag }}
+      - name: "get tag"
+        id: tag
+        uses: dawidd6/action-get-tag@v1
+        with:
+          # Optionally strip `v` prefix
+          strip_v: false
+
+      # 2. checkout the repo
+      - name: "checkout"
+        uses: actions/checkout@v3
+
+      # 3. install TeX Live
+      - name: "install ghostscript"
+        run: sudo apt-get install -y ghostscript
+        
+      - name: "setup TeX Live (via paolobrasolin)"
+        uses: paolobrasolin/setup-texlive-action@v1
+        with:
+          profile-path:  ${{ github.workspace }}/.github/tex/profile.minimal.txt
+          packages-path: ${{ github.workspace }}/.github/tex/packages.doc.txt
+
+      # 4. (re-)compile the documentation
+      - name: "update tikz-trackschematic documentation before release"
+        run: ./build.sh --non-interactive --memory-increase --compile-doc
+
+      # 5. create package and release notes
+      - name: "create tikz-trackschematic package"
+        run: ./build.sh --non-interactive --release ${{ steps.tag.outputs.tag }}
+
+      # 6. upload artifact to share it with other jobs
+      - uses: actions/upload-artifact@v3
+        with:
+          path: |
+            tikz-trackschematic-${{ steps.tag.outputs.tag }}.zip
+            release-note-${{ steps.tag.outputs.tag }}.md
+          if-no-files-found: error # 'warn' or 'ignore' are also available, defaults to `warn`
+      - uses: actions/upload-artifact@v3
+        with:
+          path: .github/tex/tikz-trackschematic.pkg
+          if-no-files-found: error # 'warn' or 'ignore' are also available, defaults to `warn`
+      - uses: actions/upload-artifact@v3
+        with:
+          path: .github/zenodo/metadata.json
+          if-no-files-found: error # 'warn' or 'ignore' are also available, defaults to `warn`
+
+  publish_github:
+    needs: create_package
+    name: "publish on github"
+    runs-on: ubuntu-latest
+    steps:
+      # 1. download artifact in folder artifact/
+      - uses: actions/download-artifact@v3
+
+      # 2. creating a new release
+      - name: "create release"
+        id: create_release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # This token is provided by Actions, you do not need to create your own token
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: Release ${{ github.ref }}
+          body_path: artifact/release-note-${{needs.create_package.outputs.version}}.md
+          draft: false
+          prerelease: false
+
+      # 3. upload package to new release
+      - name: "upload release asset"
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: artifact/tikz-trackschematic-${{needs.create_package.outputs.version}}.zip
+          asset_name: tikz-trackschematic-${{needs.create_package.outputs.version}}.zip
+          asset_content_type: application/zip
+
+      # 4. publish release on github
+      - name: "publish release"
+        uses: StuYarrow/publish-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          id: ${{ steps.create_release.outputs.id }}
+
+  publish_CTAN:
+    needs: create_package
+    name: "publish on CTAN"
+    runs-on: ubuntu-latest
+    steps:
+      # 1. download artifact in folder artifact/ and move it one level up
+      - uses: actions/download-artifact@v3
+      - run: |
+          mv ./artifact/tikz-trackschematic-${{needs.create_package.outputs.version}}.zip ./
+      
+      # 2. install ctan-o-mat
+      - name: "setup TeX Live (via paolobrasolin)"
+        uses: paolobrasolin/setup-texlive-action@v1
+      - run: tlmgr install ctan-o-mat
+
+      # 3. upload new release to CTAN
+      - name: CTAN submit
+        run: ctan-o-mat --verbose --submit artifact/tikz-trackschematic.pkg
+
+  publish_zenodo:
+    needs: create_package
+    name: "publish on zenodo"
+    outputs:
+      doi: ${{ steps.zenodraft.outputs.doi }}
+    runs-on: ubuntu-latest
+    steps:
+      # 1. download artifact in folder artifact/ and move it one level up
+      - uses: actions/download-artifact@v3
+      - run: |
+          mv ./artifact/tikz-trackschematic-${{needs.create_package.outputs.version}}.zip ./
+
+      # 2. install zenodraft
+      - name: "install zenodraft"
+        run: npm install -g zenodraft
+
+      # 3. upload new release to zenodo
+      - name: "uploading to zenodo"
+        id: zenodraft
+        env:
+          ZENODO_ACCESS_TOKEN: ${{ secrets.ZENODO_ACCESS_TOKEN }}
+          COLLECTION: 5539844
+        run: |
+          ID=$(zenodraft deposition create version $COLLECTION)
+          zenodraft file add $ID tikz-trackschematic-*.zip
+          zenodraft metadata update $ID artifact/metadata.json
+          zenodraft deposition publish $ID
+          echo "::set-output name=doi::$(zenodraft deposition show prereserved $ID)"
+
+  update_citation:
+    needs: [create_package, publish_zenodo]
+    name: "updating CITATION.cff"
+    runs-on: ubuntu-latest
+    steps:
+      # 1. checkout the repo
+      - name: "checkout"
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.head_ref }}
+      
+      # 2. update CITATION.cff
+      - run: ./build.sh --update-cite ${{needs.publish_zenodo.outputs.doi}}
+      
+      # 3. push the change back to master
+      - name: push
+        uses: stefanzweifel/git-auto-commit-action@v4
+        with:
+          commit_message: "DOI updated to ${{needs.create_package.outputs.version}} (via github action)"
+          branch: master
+          file_pattern: CITATION.cff
+          commit_user_name: railtoolkit
+          commit_user_email: railtoolkit@ownx.net
+    
+  publish_twitter:
+    needs: [create_package, publish_zenodo]
+    name: "tweet about it!"
+    runs-on: ubuntu-latest
+    steps:
+    - uses: devigned/go-twitter-action@v1
+      with:
+        message: "The version ${{needs.create_package.outputs.version}} of TikZ-trackschematic is available! DOI: https://doi.org/${{needs.publish_zenodo.outputs.doi}}"
+        apiKey: ${{ secrets.TWITTER_API_KEY }}
+        apiKeySecret: ${{ secrets.TWITTER_API_SECRET }}
+        accessToken: ${{ secrets.TWITTER_ACCESS_TOKEN }}
+        accessTokenSecret: ${{ secrets.TWITTER_ACCESS_SECRET }}

.github/workflows/testing.yaml

@@ -0,0 +1,63 @@
+# This is a basic workflow to help you get started with Actions
+
+name: "continuous integration test"
+
+# Controls when the workflow will run
+on:
+  # Triggers the workflow on push or pull request events but only for the master branch
+  push:
+    branches: [ master ]
+    paths-ignore:
+      - 'CHANGELOG.md'
+      - 'CITATION.cff'
+      - 'CODE_OF_CONDUCT.md'
+      - 'CONTRIBUTING.md'
+      - 'LICENSE'
+      - 'README.md'
+      - '.github/workflows/cffvalidation.yaml'
+      - '.github/workflows/debug.yaml'
+      - '.github/workflows/release.yaml'
+      - '.github/workflows/zenodo.yaml'
+      - '.github/zenodo/*'
+  pull_request:
+    branches: [ master ]
+    paths-ignore:
+      - 'CHANGELOG.md'
+      - 'CITATION.cff'
+      - 'CODE_OF_CONDUCT.md'
+      - 'CONTRIBUTING.md'
+      - 'LICENSE'
+      - 'README.md'
+      - '.github/workflows/cffvalidation.yaml'
+      - '.github/workflows/debug.yaml'
+      - '.github/workflows/release.yaml'
+      - '.github/workflows/zenodo.yaml'
+      - '.github/zenodo/*'
+    
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+  # This workflow contains a single job called "build"
+  test:
+    # The type of runner that the job will run on
+    runs-on: ubuntu-latest
+
+    # Steps represent a sequence of tasks that will be executed as part of the job
+    steps:
+      - name: "checkout"
+        # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+        uses: actions/checkout@v3
+
+      - name: "install ghostscript"
+        run: sudo apt-get install -y ghostscript
+        
+      - name: "setup TeX Live (via paolobrasolin)"
+        uses: paolobrasolin/setup-texlive-action@v1
+        with:
+          profile-path:  ${{ github.workspace }}/.github/tex/profile.basic.txt
+          packages-path: ${{ github.workspace }}/.github/tex/packages.test.txt
+
+      - name: "test tikz-trackschematic"
+        run: ./build.sh --non-interactive --test --verbose

.github/workflows/zenodo.yaml

@@ -0,0 +1,126 @@
+name: zenodo sandbox test
+on:
+  # # Trigger when you publish a release via GitHub's release page
+  # release:
+  #   types:
+  #     - published
+
+  # # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  create_package:
+    name: "create a TeX Live package"
+    outputs:
+      version: ${{ steps.tag.outputs.tag }}
+    runs-on: ubuntu-latest
+    steps:
+      # set varibale ${{ steps.tag.outputs.tag }}
+      - name: "get tag"
+        id: tag
+        run: echo "::set-output name=tag::v0.7.0"
+
+      # checkout the repo
+      - name: "checkout"
+        uses: actions/checkout@v3
+
+      # create package and release notes
+      - name: "create tikz-trackschematic package"
+        run: ./build.sh --non-interactive --release ${{ steps.tag.outputs.tag }}
+
+      # upload artifact to share it with other jobs
+      - uses: actions/upload-artifact@v3
+        with:
+          path: |
+            tikz-trackschematic-${{ steps.tag.outputs.tag }}.zip
+            release-note-${{ steps.tag.outputs.tag }}.md
+          if-no-files-found: error # 'warn' or 'ignore' are also available, defaults to `warn`
+      - uses: actions/upload-artifact@v3
+        with:
+          path: .github/tex/tikz-trackschematic.pkg
+          if-no-files-found: error # 'warn' or 'ignore' are also available, defaults to `warn`
+      - uses: actions/upload-artifact@v3
+        with:
+          path: .github/zenodo/metadata.json
+          if-no-files-found: error # 'warn' or 'ignore' are also available, defaults to `warn`
+
+  # publish_zenodo:
+  #   needs: create_package
+  #   name: "publish on zenodo sandbox"
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     # checkout the repo
+  #     - name: "checkout"
+  #       uses: actions/checkout@v3
+
+  #     # download artifact in folder artifact/
+  #     - uses: actions/download-artifact@v3
+  #     - run: |
+  #         mv ./artifact/tikz-trackschematic-*.zip ./
+  #         mv ./artifact/metadata.json ./
+
+  #     - name: "uploading to zenodo sandbox"
+  #       env:
+  #         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  #         # ZENODO_ACCESS_TOKEN: ${{ secrets.ZENODO_ACCESS_TOKEN }}
+  #         ZENODO_SANDBOX_ACCESS_TOKEN: ${{ secrets.ZENODO_SANDBOX_ACCESS_TOKEN }}
+  #       uses: zenodraft/action@0.10.0
+  #       with:
+  #         # collection: 5539844
+  #         collection: 1047380
+  #         filenames: tikz-trackschematic-v0.7.0.zip
+  #         upsert-doi: true
+  #         upsert-location: identifiers[1]
+  #         metadata: metadata.json
+  #         publish: true
+  #         sandbox: true
+  #         verbose: true
+
+  publish_zenodo:
+    needs: create_package
+    name: "publish on zenodo sandbox"
+    outputs:
+      doi: ${{ steps.zenodraft.outputs.doi }}
+    runs-on: ubuntu-latest
+    steps:
+      # download artifact in folder artifact/
+      - uses: actions/download-artifact@v3
+      - run: |
+          mv ./artifact/tikz-trackschematic-${{needs.create_package.outputs.version}}.zip ./
+
+      - name: "install zenodraft"
+        run: npm install -g zenodraft
+
+      - name: "uploading to zenodo sandbox"
+        id: zenodraft
+        env:
+          ZENODO_SANDBOX_ACCESS_TOKEN: ${{ secrets.ZENODO_SANDBOX_ACCESS_TOKEN }}
+          COLLECTION: 1047380
+        run: |
+          ID=$(zenodraft --sandbox deposition create in-existing-collection $COLLECTION)
+          zenodraft --sandbox file add $ID tikz-trackschematic-*.zip
+          zenodraft --sandbox metadata update $ID artifact/metadata.json
+          zenodraft --sandbox deposition publish $ID
+          echo "::set-output name=doi::$(zenodraft --sandbox deposition show prereserved $ID)"
+
+  update_citation:
+    needs: publish_zenodo
+    name: "updates CITATION.cff"
+    runs-on: ubuntu-latest
+    steps:
+      # 1. checkout the repo for zenodraft/action@0.10.0 to work
+      - name: "checkout"
+        uses: actions/checkout@v3
+      
+      - run: ./build.sh --update-cite ${{needs.publish_zenodo.outputs.doi}}
+      
+      - name: push
+        uses: github-actions-x/commit@v2.8
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          push-branch: 'master'
+          force-add: 'true'
+          files: CITATION.cff
+          commit-message: 'updated DOI (via github action)'
+          name: Martin Scheidt
+          email: m.scheidt@tu-bs.de

.github/zenodo/metadata.json

@@ -0,0 +1,32 @@
+{
+  "title": "TikZ-trackschematic",
+  "version": "%%[SCRIPT]",
+  "publication_date": "%%[SCRIPT]",
+  "creators": [
+    {
+      "orcid": "0000-0002-9384-8945", 
+      "affiliation": "TU Braunschweig", 
+      "name": "Scheidt, Martin"
+    }
+  ], 
+  "description": "A TikZ library for creating track diagrams in railways. The TikZ-trackschematic library is a toolbox of symbols geared primarily towards creating track schematic for either research or educational purposes. It provides a TikZ frontend to some of the symbols which maybe needed to describe situations and layouts in railway operation.",
+  "keywords": [
+    "tex", 
+    "tikz", 
+    "railway", 
+    "railroad", 
+    "tracks", 
+    "schematics"
+  ],
+  "license": {
+    "id": "ISC"
+  },
+  "language": "eng",
+  "access_right": "open", 
+  "upload_type": "software",
+  "communities": [
+    {
+      "identifier": "railtoolkit"
+    }
+  ]
+}

.gitignore

@@ -244,6 +244,9 @@ TSWLatexianTemp*
 Output
 .tex
 
+# Testing
+.testing
+
 ## -- macOS ignore
 # General
 .DS_Store
@@ -274,4 +277,6 @@ Temporary Items
 .apdisk
 
 # Archives for upload
-*.zip
+artifact
+tikz-trackschematic-*.zip
+release-note-*.md

CHANGELOG.md

@@ -0,0 +1,174 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Categories: Added, Changed, Deprecated, Removed, Fixed, and Security.
+
+## [Unreleased]
+
+### Todo
+
+  * i18n option
+
+
+## Version [0.7.1] - 2022-06-02
+
+### Changed
+  
+  * handeling color background and foreground with native xcolor alias "\colorlet{}{}" instead of pgf macro
+
+
+## Version [0.7.0] - 2022-04-02
+
+### Added
+ 
+ * unified build script for development
+
+### Changed
+  
+  * revised symbol and syntax for balises
+  * the track loop was separated from the balises
+  * replaced "\gettikzxy" with "\path let" syntax
+  * label placement for derailers
+
+### Fixed
+
+  * wrong option for labels in vehicles
+  * foreground of sidetrack (alias)
+  * PackageWarning Error in development mode
+
+
+## Version [0.6.3] - 2022-02-15
+
+### Added
+
+  * anchor for SVG export
+  * automated testing and releasing
+  * separate changelog
+
+### Fixed
+
+  * documented (slip-)turnout option: points=moving
+  * spelling error in documentation
+  * URL to signalschablone
+
+
+## Version [0.6.2] - 2021-10-15
+
+### Fixed
+
+  * runaway argument
+  * developer mode always on 
+
+
+## Version [0.6.1] - 2021-09-30
+
+### Added
+
+  * added citation information
+
+### Removed
+  
+  * removed package requirement lmodern
+
+### Fixed
+
+  * minor correction in manual
+
+
+## Version [0.6] - 2021-01-02
+
+### Added
+
+  * created an encapsulating package for future flexibility
+  * added symbols for direction control, track marking, pylons and electric wiring
+
+### Changed
+
+  * changed symbol for friction bufferstop;
+  * changed load command to \usepackage{tikz-trackschematic}
+
+
+## Version [0.5.1] - 2020-02-10
+  
+### Added
+
+  * added symbols "braking point" and "danger point"
+
+### Changed
+ 
+  * modified symbol "end of movement authority"
+
+
+## Version [0.5] - 2020-01-14
+
+### Added
+
+  * documentation
+
+### Changed
+
+  * new improved syntax for topology
+
+
+## Version [0.4] - 2019-07-21
+
+### Added
+
+  * added document for symbology
+
+### Changed
+
+  * renamed overview to snippets
+  * reworked library for common tikz library layout
+
+
+## Version [0.3] - 2019-04-04
+
+### Added
+
+  * added shunting movements
+  * added points to turnouts
+  * added moving trains
+  * defined and used color foreground and background
+
+### Changed
+
+  * moved snippet folder to root folder
+
+
+## Version [0.2] - 2018-12-19
+
+### Added
+
+  * added transmitters
+
+### Changed
+
+  * reorganized src library
+  * minor improvements
+
+
+## Version [0.1] - 2018-09-14
+
+### Added
+
+  Basic concept of a library with railway topology symbols and some examples.
+
+
+[Unreleased]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.7.1...master
+[0.7.1]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.7.0...v0.7.1
+[0.7.0]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.6.3...v0.7.0
+[0.6.3]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.6.2...v0.6.3
+[0.6.2]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.6.1...v0.6.2
+[0.6.1]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.6...v0.6.1
+[0.6]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.5.1...v0.6
+[0.5.1]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.5...v0.5.1
+[0.5]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.4...v0.5
+[0.4]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.3...v0.4
+[0.3]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.2...v0.3
+[0.2]: https://github.com/railtoolkit/tikz-trackschematic/compare/v0.1...v0.2
+[0.1]: https://github.com/railtoolkit/tikz-trackschematic/releases/tag/v0.1

CITATION.cff

@@ -0,0 +1,57 @@
+# YAML 1.2
+# This CITATION.cff file was generated with cffinit.
+# Visit https://bit.ly/cffinit to generate yours today!
+---
+cff-version: 1.2.0
+title: tikz-trackschematic
+message: 'If you use this software, please cite both the proceedings from preferred-citation and the software itself.'
+type: software
+authors:
+  - given-names: Martin
+    family-names: Scheidt
+    email: m.scheidt@tu-bs.de
+    orcid: 'https://orcid.org/0000-0002-9384-8945'
+    affiliation: TU Braunschweig
+identifiers:
+  - type: doi
+    value: 10.5281/zenodo.5539844
+    description: 'Collection of archived snapshots of all versions of the library'
+  - type: doi
+    value: 10.5281/zenodo.6607601
+    description: Current version
+url: https://www.railtoolkit.org/projects/tikz-trackschematic
+repository: https://github.com/railtoolkit/tikz-trackschematic
+repository-code: https://repository.ivev.bau.tu-bs.de/martin/tikz-trackschematic
+repository-artifact: https://ctan.org/pkg/tikz-trackschematic
+abstract: >-
+  'A TikZ library for creating track diagrams in
+  railways. The tikz-trackschematic library is a
+  toolbox of symbols geared primarily towards
+  creating track schematic for either research or
+  educational purposes. It provides a TikZ frontend
+  to some of the symbols which maybe needed to
+  describe situations and layouts in railway
+  operation.'
+keywords:
+  - tex
+  - symbology
+  - railway
+  - railroad
+  - operational scenarios
+  - graphical description
+license: ISC
+version: v0.7.1
+date-released: 2022-06-02
+preferred-citation:
+  authors:
+    - family-names: Scheidt
+      given-names: Martin
+      orcid: https://orcid.org/0000-0002-9384-8945
+    - family-names: Pachl
+      given-names: Jörn
+  doi: 10.24355/dbbs.084-202204140847-0
+  title: 'TikZ-trackschematic library: a symbology towards a universal graphical description for operational scenarios in railway research'
+  type: proceedings
+  year: 2022
+  publisher:
+    name: "RailBeijing 2021 - the 9th International Conference on Railway Operations Modelling and Analysis (ICROMA). 3.-7. November , 2021"

CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at [INSERT EMAIL ADDRESS]. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# Contributing
+
+When contributing to this repository, please first discuss the change you wish to make via issue,
+email, or any other method with the owners of this repository before making a change. 
+
+Please note we have a code of conduct, please follow it in all your interactions with the project.
+
+# Enhancing and developing the tikz-trackschematic library
+
+1. The tikz-trackschematic should be regularly installed via TeX Live to modify the library. The distributed package comes with a development switch.
+2. Run the build script with `sudo ./build.sh --install-dev`. This will soft link the local files out of src folder into your TeX Live installation.
+3. The TeX command `\usepackage[dev]{tikz-trackschematic}` will load the linked src folder instead of the distributed package from TeX Live.
+4. After implementing your modification run `./build.sh --test` to check for any breaking changes.
+
+# Pull Request Process
+
+1. Ensure any install or build dependencies are removed before the end of the layer when doing a 
+   build.
+2. Update the CHANGELOG.md with details of changes to the interface, this includes new environment 
+   variables, exposed ports, useful file locations and container parameters.
+3. The versioning scheme we use is [SemVer](http://semver.org/). Increase the version numbers in the following files to the new version that this Pull Request would represent:
+    1. CHANGELOG.md
+    2. doc/versionhistory.tex
+4. You may merge the Pull Request in once you have the sign-off of two other developers, or if you 
+   do not have permission to do that, you may request the second reviewer to merge it for you.
+5. The following versioning steps will be taken care of by the maintainer:
+    1. git repo with tag
+    2. sync Overleaf project

LICENSE

@@ -1,6 +1,6 @@
 ISC License
 
-Copyright (c) 2018 - 2020, Martin Scheidt \<m.scheidt@tu-bs.de\>
+Copyright (c) 2018 - 2022, Martin Scheidt \<m.scheidt@tu-bs.de\>
 
 Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 

README.md

@@ -1,79 +1,69 @@
 # TikZ-trackschematic
 
+[![License: ISC](https://img.shields.io/badge/license-ISC-green.svg)](https://opensource.org/licenses/ISC) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.5539844.svg)](https://doi.org/10.5281/zenodo.5539844) [![CI test](https://github.com/railtoolkit/tikz-trackschematic/actions/workflows/testing.yaml/badge.svg)](https://github.com/railtoolkit/tikz-trackschematic/actions/workflows/testing.yaml)
+
 ------------
 
 # Installation
 
+
 The tikz library is contained in the files:
+* tikz-trackschematic.sty
 * tikzlibrarytrackschematic.code.tex,
 * tikzlibrarytrackschematic.topology.code.tex,
 * tikzlibrarytrackschematic.trafficcontrol.code.tex,
 * tikzlibrarytrackschematic.vehicles.code.tex,
-* tikzlibrarytrackschematic.constructions.code.tex, and
-* tikzlibrarytrackschematic.messures.code.tex.
-These files should be copied wherever TeX can find it, for example in your TEXMF folder. The library can then be loaded through the command \usetikzlibrary{trackschematic} in any tex file.
+* tikzlibrarytrackschematic.constructions.code.tex,
+* tikzlibrarytrackschematic.symbology.code.tex,
+* tikzlibrarytrackschematic.electrics.code.tex, and
+* tikzlibrarytrackschematic.measures.code.tex.
+
+These files should be copied wherever TeX can find it, for example in your $TEXMF folder.
+
+Alternatively, the tikz library is provided by CTAN as "[tikz-trackschematic](https://ctan.org/pkg/tikz-trackschematic)" and is thus part of the TeX Live distribution or can be installed via MiKTeX.
+
+The library can then be loaded through the command
+```TeX
+\usepackage{tikz-trackschematic}
+```
+in any LaTeX file.
+
+The library can also be used in [Overleaf](https://www.overleaf.com/read/crrxfcdzbhbd).
 
 ------------
 
-# Usage
+# Minimal working example
 
 ```TeX
-\documentclass[tikz]{standalone}
-\usetikzlibrary{trackschematic}
-\begin{document}
+\documentclass{standalone} % LaTeX
+\usepackage{tikz-trackschematic} % loading the library
 
+\begin{document}
   \begin{tikzpicture}
 
+    % TikZ command: specify coordinates
     \coordinate (A)   at (0,0);
     \coordinate (B)   at (6,0);
     \coordinate (T)   at (5,0);
 
+    % draw a track
     \maintrack (A) -- (B);
-    \train[forward] at (T) label (train);
+
+    % place a train on the track
+    \train[forward] at (T) label ();
 
   \end{tikzpicture}
-
 \end{document}
 ```
+results in:
+
+![train on a track](https://raw.githubusercontent.com/railtoolkit/tikz-trackschematic/master/doc/examples/minimal_working_example.png "train on a track")
 
 ------------
 
-# History
+# Symbology and meaning
 
-## Version 0.5.1
-  
-  * modified symbol "end of movement authority"
-  * added symbols "braking point" and "danger point"
-
-## Version 0.5
-  
-  * new improved syntax for topology
-  * documentation
-
-## Version 0.4
-
-  * added document for symbology
-  * renamed overview to snippets
-  * reworked library for common tikz library layout
-
-## Version 0.3
-
-  * moved snippet folder to root folder
-  * added shunting movements
-  * added points to turnouts
-  * added moving trains
-  * defined and used color foreground and background
-
-
-## Version 0.2
-
-  * added transmitters
-  * reorganized src library
-  * minor improvements
-
-## Version 0.1
-
-  Basic concept of a library with railway topology symbols and some examples.
+Please consult the [symbology table](https://github.com/railtoolkit/tikz-trackschematic/blob/master/doc/symbology-table.pdf) for further information regarding meaning of the symbols.
 
 ------------
 
@@ -82,6 +72,7 @@ These files should be copied wherever TeX can find it, for example in your TEXMF
   * rethink syntax
   * provide option for internationalziation (i18n)
   * rewrite library with better coding skills
+  * include support for glossaries package
 
 ------------
 
@@ -93,9 +84,9 @@ These files should be copied wherever TeX can find it, for example in your TEXMF
 
 # License
   
-  ISC License
+  [![Open Source Initiative Approved License logo](https://opensource.org/files/OSIApproved_100X125.png "Open Source Initiative Approved License logo")](https://opensource.org)
 
-  Copyright (c) 2018 - 2020, Martin Scheidt \<m.scheidt@tu-bs.de\>
+  Copyright (c) 2018 - 2022, Martin Scheidt \<m.scheidt@tu-bs.de\> (ISC License)
 
   Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 

create_ctan-package.sh

@@ -1,26 +0,0 @@
-#!/usr/bin/env sh
-
-echo "specify version ( e.g. v0.5 ):"
-read VERSION
-
-mkdir tikz-trackschematic-$VERSION
-cp README.md tikz-trackschematic-$VERSION/README.md
-cp doc/tikz-trackschematic-documentation.sty  tikz-trackschematic-$VERSION/tikz-trackschematic-documentation.sty
-cp doc/manual.pdf  tikz-trackschematic-$VERSION/tikz-trackschematic.pdf
-cp doc/manual.tex  tikz-trackschematic-$VERSION/tikz-trackschematic.tex
-cp doc/snippets.pdf  tikz-trackschematic-$VERSION/tikz-trackschematic-snippets.pdf
-cp doc/snippets.tex  tikz-trackschematic-$VERSION/tikz-trackschematic-snippets.tex
-mkdir tikz-trackschematic-$VERSION/tikz-trackschematic-examples
-mkdir tikz-trackschematic-$VERSION/tikz-trackschematic-snippets
-cp -R doc/examples/*  tikz-trackschematic-$VERSION/tikz-trackschematic-examples
-cp -R doc/snippets/*  tikz-trackschematic-$VERSION/tikz-trackschematic-snippets
-cp src/tikzlibrarytrackschematic.code.tex tikz-trackschematic-$VERSION/tikzlibrarytrackschematic.code.tex
-cp src/tikzlibrarytrackschematic.constructions.code.tex tikz-trackschematic-$VERSION/tikzlibrarytrackschematic.constructions.code.tex
-cp src/tikzlibrarytrackschematic.messures.code.tex tikz-trackschematic-$VERSION/tikzlibrarytrackschematic.messures.code.tex
-cp src/tikzlibrarytrackschematic.topology.code.tex tikz-trackschematic-$VERSION/tikzlibrarytrackschematic.topology.code.tex
-cp src/tikzlibrarytrackschematic.trafficcontrol.code.tex tikz-trackschematic-$VERSION/tikzlibrarytrackschematic.trafficcontrol.code.tex
-cp src/tikzlibrarytrackschematic.vehicles.code.tex tikz-trackschematic-$VERSION/tikzlibrarytrackschematic.vehicles.code.tex
-
-zip -r tikz-trackschematic-$VERSION.zip tikz-trackschematic-$VERSION/*
-rm -rf tikz-trackschematic-$VERSION/*
-rmdir tikz-trackschematic-$VERSION

dev-install.sh

@@ -1,18 +0,0 @@
-#!/usr/bin/env sh
-
-echo "specify path for installation!"
-echo "( e.g. /usr/local/texlive/2019/texmf-dist/tex/latex ):"
-read INSTALLPATH
-
-DIR=$(pwd -P)
-
-DEVDIR="tikz-trackschematic-dev"
-
-mkdir $INSTALLPATH/$DEVDIR
-
-ln -s $DIR/src/tikzlibrarytrackschematic.code.tex $INSTALLPATH/$DEVDIR/tikzlibrarytrackschematic-dev.code.tex
-ln -s $DIR/src/tikzlibrarytrackschematic.constructions.code.tex $INSTALLPATH/$DEVDIR/tikzlibrarytrackschematic-dev.constructions.code.tex
-ln -s $DIR/src/tikzlibrarytrackschematic.messures.code.tex $INSTALLPATH/$DEVDIR/tikzlibrarytrackschematic-dev.messures.code.tex
-ln -s $DIR/src/tikzlibrarytrackschematic.topology.code.tex $INSTALLPATH/$DEVDIR/tikzlibrarytrackschematic-dev.topology.code.tex
-ln -s $DIR/src/tikzlibrarytrackschematic.trafficcontrol.code.tex $INSTALLPATH/$DEVDIR/tikzlibrarytrackschematic-dev.trafficcontrol.code.tex
-ln -s $DIR/src/tikzlibrarytrackschematic.vehicles.code.tex $INSTALLPATH/$DEVDIR/tikzlibrarytrackschematic-dev.vehicles.code.tex

doc/examples/minimal_working_example.tex

@@ -0,0 +1,16 @@
+\documentclass{standalone}
+
+% loading the library
+\usepackage{tikz-trackschematic}
+
+\begin{document} % LaTeX
+  \begin{tikzpicture} % TikZ
+
+    % draw a track with (x,y) coordinates
+    \maintrack (0,0) -- (6,0);
+
+    % place a train on the track
+    \train[forward] at (5,0) label ();
+
+  \end{tikzpicture}
+\end{document}

doc/examples/station_berg.tex

@@ -1,15 +1,15 @@
 %!TEX TS-program = pdflatexmk
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \documentclass[tikz,border=2]{standalone}
-\usetikzlibrary{trackschematic}
+\usepackage{tikz-trackschematic} % loading the library
 
 \begin{document}
   \begin{tikzpicture}[font=\sffamily]
   { % station names
-    \tikzset{every node/.style={\foreground!50!\background}};
+    \tikzset{every node/.style={foreground!50!background}};
     \node[right,align=left] at ( 2,1.3) {to and from\\ Arnau};
     \node                   at (21,3.3) {{\LARGE Bf Berg}};
     \node[left,align=right] at (38,1.3) {to and from\\ Chamstadt};
@@ -134,7 +134,7 @@
     \platform[side=right] at (P2);
     \platform[side=left ] at (P1);
   }
-  { %% messures
+  { %% measures
     % hectometer posts
     \tikzset{hectometer base={(HM)},orientation=right};
     \hectometer[] at (S1)      label ( 7.200);

doc/examples/station_chamstadt.tex

@@ -1,15 +1,15 @@
 %!TEX TS-program = pdflatexmk
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \documentclass[tikz,border=2]{standalone}
-\usetikzlibrary{trackschematic}
+\usepackage{tikz-trackschematic} % loading the library
 
 \begin{document}
   \begin{tikzpicture}[font=\sffamily]
   { % station names
-    \tikzset{every node/.style={\foreground!50!\background}};
+    \tikzset{every node/.style={foreground!50!background}};
     \node[right,align=left] at ( 5,1.3) {to and from\\ Berg};
     \node                   at (21,3.9) {{\LARGE Bf Chamstadt}};
     \node[left,align=right] at (37.5,1.3) {to and from\\ Dornroda};
@@ -145,7 +145,7 @@
     \platform[side=right] at (P2);
     \platform[side=left ] at (P1);
   }
-  { %% messures
+  { %% measures
     % hectometer posts
     \tikzset{hectometer base={(HM1)},orientation=right};
     \hectometer[] at (S01)    label ( 7.200);
@@ -161,8 +161,8 @@
     \hectometer[] at (S09)    label ( 9.900);
     \hectometer[] at (S11)    label (10.900);
     
-    \messureline (S09) -- ++(0,1.7) -- (S10);
-    \messureline (S11) -- ++(0,2.2) -- (S12);
+    \measureline (S09) -- ++(0,1.7) -- (S10);
+    \measureline (S11) -- ++(0,2.2) -- (S12);
 
     \tikzset{hectometer base={(HM2)},orientation=left};
     \hectometer[] at (14  ,1) label ( 8.500);

doc/snippets/balise_forward_with_signal.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);
@@ -11,4 +11,4 @@
 \maintrack (A) -- (B);
 
 \routesignal[forward] at (S) label ();
-\balise[] at (S) label ();
+\balise[forward] at (S) label ();

doc/snippets/balise_switched.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A)  at (0,0);
@@ -11,5 +11,5 @@
 
 \maintrack (A) -- (B);
 
-\balise[forward]               at (T1) label ();
-\balise[forward,position=left] at (T2) label ();
+\balise[forward,switched]  at (T1) label ();
+\balise[backward,switched] at (T2) label ();

doc/snippets/balises.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A)  at (0,0);
@@ -11,5 +11,5 @@
 
 \maintrack (A) -- (B);
 
-\balise[]              at (T1) label ();
-\balise[position=left] at (T2) label ();
+\balise[forward]  at (T1) label ();
+\balise[backward] at (T2) label ();

doc/snippets/bend_train.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A1) at (0  ,-0.5);

doc/snippets/block_clearing_point_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A)  at (0,0);

doc/snippets/block_clearing_point_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A)  at (0,0);

doc/snippets/block_signal_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/block_signal_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/block_signal_with_shunt_signal_backward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (S) at (3,0);
+
+\maintrack (A) -- (B);
+
+\signal[block,shunting,backward] at (S) label (S1);

doc/snippets/block_signal_with_shunt_signal_forward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (S) at (3,0);
+
+\maintrack (A) -- (B);
+
+\signal[block,shunting,forward] at (S) label (S1);

doc/snippets/braking_point_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/braking_point_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/bridge.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/bridge_track_beneath.tikz

@@ -1,8 +1,9 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
 \coordinate (A1) at (0, 0);
 \coordinate (B1) at (6, 0);
 \coordinate (A2) at (2,-1);

doc/snippets/bufferstop_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (3,0);

doc/snippets/bufferstop_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/clearing_point.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A)  at (0,0);

doc/snippets/combined_signal_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/danger_point_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/danger_point_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/derailer_left_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/derailer_left_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/derailer_right_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/derailer_right_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/diamond_crossing_left.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/diamond_crossing_right.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/direction_control.tikz

@@ -0,0 +1,12 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A)  at (0,0);
+\coordinate (DC) at (3,0);
+\coordinate (B)  at (6,0);
+
+\maintrack (A) -- (B);
+\directioncontrol[bidirectional]  at (DC);

doc/snippets/direction_control_backward.tikz

@@ -0,0 +1,12 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A)  at (0,0);
+\coordinate (DC) at (3,0);
+\coordinate (B)  at (6,0);
+
+\maintrack (A) -- (B);
+\directioncontrol[backward]  at (DC);

doc/snippets/direction_control_forward.tikz

@@ -0,0 +1,12 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A)  at (0,0);
+\coordinate (DC) at (3,0);
+\coordinate (B)  at (6,0);
+
+\maintrack (A) -- (B);
+\directioncontrol[forward]  at (DC);

doc/snippets/distant_pantograph_down_backward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (E) at (3,0);
+
+\maintrack (A) -- (B);
+
+\distantpantographdown[backward] at (E) label (dP);

doc/snippets/distant_pantograph_down_forward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (E) at (3,0);
+
+\maintrack (A) -- (B);
+
+\distantpantographdown[forward] at (E) label (dP);

doc/snippets/distant_power_off_backward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (E) at (3,0);
+
+\maintrack (A) -- (B);
+
+\distantpoweroff[backward] at (E) label (dP);

doc/snippets/distant_power_off_forward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (E) at (3,0);
+
+\maintrack (A) -- (B);
+
+\distantpoweroff[forward] at (E) label (dP);

doc/snippets/distant_signal_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/distant_signal_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/distant_speed_signal_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/distant_speed_signal_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/double-slip_turnout_left.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/double-slip_turnout_right.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/end_of_movement_authority_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/end_of_movement_authority_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/friction_bufferstop_backward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (3,0);

doc/snippets/friction_bufferstop_forward.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/hectometer.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A)  at (0,0);

doc/snippets/hump.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/individual_balises.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A)  at (0,0);
@@ -11,5 +11,5 @@
 
 \maintrack (A) -- (B);
 
-\balise[backward]               at (T1) label ();
-\balise[backward,position=left] at (T2) label ();
+\balise[forward,along={0,1,2,3}]  at (T1) label (A);
+\balise[backward,along={0,1,2,3}] at (T2) label (B);

doc/snippets/individual_balises_mixed.tikz

@@ -0,0 +1,27 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A)  at (0,0);
+\coordinate (B)  at (6,0);
+\coordinate (T1) at (2,0);
+\coordinate (T2) at (4,0);
+
+\maintrack (A) -- (B);
+
+\balise[
+  forward,
+  along={0,1,3},
+  along switched={2},
+  oppose={0,2},
+] at (T1) label (A);
+\balise[
+  backward,
+  along={0,1,3},
+  along switched={2},
+  oppose={0,2,3},
+  oppose switched={1},
+  index % show index number
+] at (T2) label (B);

doc/snippets/interlocking.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (I) at (3,0);

doc/snippets/level_crossing_double.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A1) at (0,-0.5);

doc/snippets/level_crossing_double_full_closure.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A1) at (0,-0.5);

doc/snippets/level_crossing_single.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/level_crossing_without_barrier.tikz

@@ -0,0 +1,12 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (X) at (3,0);
+
+\secondarytrack (A) -- (B);
+\levelcrossing[] at (X);

doc/snippets/main_line.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A1) at (0,-0.5);

doc/snippets/main_track.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/measure_line.tikz

@@ -1,10 +1,12 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);
 \coordinate (B) at (6,0);
 
-\messureline (A) -- (B);
+\measureline (A) -- (B);
+\trackclosure at (A);
+\trackclosure at (B);

doc/snippets/measure_line_with_hectometer.tikz

@@ -0,0 +1,28 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A1) at (0,0);
+\coordinate (X1) at (3,0);
+\coordinate (B1) at (6,0);
+
+\coordinate (A2) at (0,3);
+\coordinate (X2) at (2,3);
+\coordinate (X3) at (5,3);
+\coordinate (B2) at (6,3);
+
+\coordinate (hb) at (0,-2);
+
+\maintrack (A1) -- (B1);
+\maintrack (A2) -- (B2);
+
+\measureline (A2) -- (A1);
+\measureline (X2) -- ++(0,-1) -- ++(1,-1) -- (X1);
+\measureline (X3) -- ++(0,-1) -- ++(1,-1) -- (B1);
+
+\tikzset{hectometer base={(hb)},orientation=right}
+\hectometer[] at (A)  mileage (0.000);
+\hectometer[] at (X1) mileage (4.000);
+\hectometer[] at (B)  mileage (6.000);

doc/snippets/pantograph_down_backward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (E) at (3,0);
+
+\maintrack (A) -- (B);
+
+\pantographdown[backward] at (E) label (down);

doc/snippets/pantograph_down_forward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (E) at (3,0);
+
+\maintrack (A) -- (B);
+
+\pantographdown[forward] at (E) label (down);

doc/snippets/pantograph_up_backward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (E) at (3,0);
+
+\maintrack (A) -- (B);
+
+\pantographup[backward] at (E) label (up);

doc/snippets/pantograph_up_forward.tikz

@@ -0,0 +1,13 @@
+%!TEX TS-program = pdflatexmk
+%!TEX root = ../snippets.tex
+
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
+% Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+\coordinate (A) at (0,0);
+\coordinate (B) at (6,0);
+\coordinate (E) at (3,0);
+
+\maintrack (A) -- (B);
+
+\pantographup[forward] at (E) label (up);

doc/snippets/parked_vehicle.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);

doc/snippets/parked_vehicles.tikz

@@ -1,7 +1,7 @@
 %!TEX TS-program = pdflatexmk
 %!TEX root = ../snippets.tex
 
-% Copyright (c) 2018 - 2020, Martin Scheidt (ISC license)
+% Copyright (c) 2018 - 2022, Martin Scheidt (ISC license)
 % Permission to use, copy, modify, and/or distribute this file for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
 \coordinate (A) at (0,0);