This release enhances documentation capabilities, making it easier to incorporate various visual elements directly within AsciiDoc files.

New feature

  • Added support for displaying Ascii diagrams using the Asciidoctor Diagram extension.

    • Multiple diagram types are now supported. Examples and additional links are available in the AsciiShowroom.

    • Ditaa: Ideal for creating ASCII-based block diagrams.

    • PlantUML: Great for UML diagrams such as class, sequence, and activity diagrams.

    • Graphviz: Suitable for creating flowcharts, state diagrams, and dependency graphs.

    • LilyPond: For beautifully typeset sheet music and musical notation.

  • Moved installation steps of required software form .gitlab-ci.yml to a dedicated Docker image (see Dockerfile in the documentation).

    • This change improves CI/CD efficiency by reducing pipeline run times, ensures consistency across builds, and simplifies maintenance by consolidating package dependencies into a single, reusable image.

    • Additionally, it enhances readability of the CI/CD configuration, focusing on core pipeline steps without repeated setup commands.

    • For the jekyll-theme-endless repository, this change may result in increased compute time, but for all other repositories, it will not, as they can easily use the image for their own CI/CD pipelines. Simply set image: "registry.gitlab.com/jekyll-theme-endless/jekyll-theme-endless.gitlab.io:latest" as the image in your pipeline configuration.

Updates, fixes and improvements

  • Improved styling of lists, STEM expressions and images.

  • Version 0.15.1: Added workarounds for 2 known issues

    • Distorted design when code blocks in admonition blocks exceed their width (0.13.X)

    • Overlap of code by the field that indicates the language in code blocks (0.10.X)

  • Version 0.15.2:

    • The example pages are delivered along with the theme gem. This allows you to copy, for example, the showrooms into your own project directory to use them as templates.

    • Added new insights about the keep_files-setting to the _config.yml.

    • Increased the spacing between the text and the right edge of the admonition block.

  • Version 0.15.3:

    • The display of the "list of recent posts" is now handled through the invocation of function_list-posts.html. This also resolves the issue where posts created on the same day were displayed in a different order in the recent posts list compared to the post navigation.

    • Bugfix: If a tag was accidentally entered multiple times in a post’s tag list

      • the tag was weighted higher in the tag cloud.

      • the post also appeared multiple times in the list of "posts tagged with this tag."

      • the tag was shown multiple times in the tag-list of the post

    • Added statistics to list posts with multiple tags.

  • Version 0.15.4:

    • Fixed warnings caused by (transitive) dependencies.

  • Version 0.15.5:

    • Increased versions of all dependencies in the gemspec.