jekyll-theme-endless
A Jekyll Theme ready for AsciiDoc

Welcome to the Jekyll-theme "endless"

This is a well-documented, feature-rich theme for the static site generator Jekyll. It allows you to write posts not only in Markdown but also in AsciiDoc. By default, it produces a page like the one you see here (with a tag cloud, syntax highlighting, …​). It also provides a Docker image (with numerous pre-installed packages) that you can use for CI/CD pipelines, such as those on GitLab. To get an overview of the features, feel free to check out the showrooms for AsciiDoc and Markdown.

To easily set up a site using this theme, go to https://quickstart-blog.gitlab.io/ and follow the instructions.

To get further information on how to use and adapt this theme, read the documentation.

Some Features of this Theme

  • Tag Cloud and Tag Pages A tag cloud for easy topic navigation, with individual tag pages displaying a list of posts for each tag (0.3.0), including tag descriptions (0.10.0).

  • Mathematical Formulas Support for displaying mathematical formulas, ideal for technical and academic content. (0.14.0)

  • Text-Based Diagrams Diagrams can be added as code (PlantUML, Dot/GraphViz, Ditaa, etc.) to your pages and post using AsciiDoc’s diagram capabilities. (0.15.0)

  • Schema.org Annotations for Blog Posts Built-in Schema.org metadata for enhanced SEO and better content categorization by search engines. (0.12.0)

  • Glossary An automatically generated glossary for the tags you use, displaying their descriptions in a clear and organized manner. (0.16.0)

  • RSS Feed Automatic RSS feed generation to keep subscribers updated on new posts. (0.12.0)

  • Automatic Menu Generation Auto-generation of menu entries for pages, streamlining site navigation management. (0.0.0, 0.1.0)

  • Responsive Design with Bootstrap Mobile-friendly, fully responsive design utilizing Bootstrap for a consistent experience across devices. (0.1.0)

  • AsciiDoc-Ready for Posts and Pages Full support for writing posts and pages in AsciiDoc (0.0.0), including features like:

    • Code highlighting (with language display) using Rouge (0.5.0)

    • Admonitions (notes, warnings, tips, etc.) (0.6.0)

    • Tables, quotations, glossaries, and table of contents (0.7.0, 0.10.0)

    • See the AsciiDoc Showroom for examples and capabilities.

  • Comprehensive Documentation Extensive documentation covering all theme features and configuration options, including detailed guides for config files.

  • Complete Docker Image for CI/CD Pipelines Provides a Docker image that contains all essential tools and dependencies required for building and deploying your Jekyll site. (0.15.0)

  • Multiple Include Points Numerous built-in include points allowing additional content (such as ads, extra scripts, and blog navigation) to be added without modifying layout files, making customizations easy without re-implementing the layout. (0.12.0)

  • Several Blog Post List Layouts There are two layouts for blog post lists, and you can easily add your own designs. (0.13.0)