This project provides an inline macro which dot:leader["left", "right"] which inserts leaders between the values.

Dot . . . . . . . . . . . . . . . . . . . . . . . . Leaders

Current Version: 1.1.0 | View Changelog

It currently supports three backends:

• Asciidoctor (Ruby) - backend-html5

• Asciidoctor-PDF (Ruby) - backend-pdf

• Asciidoctor.js - backend-webview-html5 - See Asciidoctor.js Dot Leader Inline Macro

PDF

HTML5

Asciidoctor.js

Markup And Usage Manual

Markup examples, rendered output examples, and extensive compatibility information is provided for multiple output formats in multiple formats:

• dot_leader_example.pdf

• dot_leader_example.html

• Or clone the project and open the dot_leader_example.adoc file with Visual Studio Code’s Asciidoc’s preview window.

Asciidoctor and Asciidoctor-PDF (Ruby) Installation and Usage

The asciidoctor-dot-leader is available as a Ruby Gem.

https://rubygems.org/gems/asciidoctor-dot-leader

Complete these steps to use:

1. Install the required Gems:

   gem install asciidoctor
   gem install asciidoctor-dot-leader
   

2. Render the document:

   asciidoctor -r asciidoctor-dot-leader dot_leader_example.adoc
   

3. [For PDF] Install Asciidoctor-PDF:

   gem install asciidoctor-pdf
   

4. [For PDF] Render the PDF:

   asciidoctor-pdf -r asciidoctor-dot-leader dot_leader_example.adoc
   

Ruby GEM Build Instructions (for 白一百 baiyibai)

gem build asciidoctor-dot-leader.gemspec
gem install ./asciidoctor-dot-leader-1.1.0.gem

Asciidoctor.js Dot Leader Inline Macro

This project provides an inline macro, dot:leader["left", "right"], which inserts dot leaders between the provided values.

Target Application

This has only been tested with the Microsoft Visual Studio Code’s AsciiDoc extension’s Preview function which uses the backend-webview-html5.

Usage

Complete these steps to enable the dot:leader[] macro:

1. Install the library.

2. Create an .asciidoctor/lib/ folder in the root of the asciidoctor project.

3. Set up the target project directory to use the extension by using either of these methods:

   1. Copy the .dot_leader.js file to the .asciidoctor/lib/ folder.

   2. Create a .dot_leader_linker.js file in the .asciidoctor/lib/ folder and copy and modify this content to it:

      module.exports = require('../../asciidoctorjs-extension/dot_leader.js')
      
      // TODO: Install locally and test if it works
      // module.exports = require('asciidoctor-dot-leader')

4. Enable the AsciiDoc Extension’s ability to use extensions in the Preview function using either of these methods:

   1. Set this configuration flag:

      "asciidoc.extensions.registerWorkspaceExtensions": true

   2. Enable the Asciidoc > Extensions: Register Workspace Extensions option.

5. Open a document containing dot:leader[] inline macros, and press the Preview button.

Todo

There are a few items which need fixing:

• HTML5

  • ❏ Include .css automatically?

• webview-html5 (Asciidoctor.js) for Microsoft Visual Studio Code and possibly others

  • ❏ Release on npm

Copyright

Copyright © 2025-present 白一百 baiyibai Free use of this software is granted under the terms of the MIT License.

• The image The «Public Domain Mark» icon from Creative Commons with transparent background. is in the public domain and taken from:
  https://commons.wikimedia.org/wiki/File:Cc-public_domain_mark.svg

• The CSS taken from https://www.w3.org/Style/Examples/007/leaders.en.html.

For the full text of the license, see the LICENSE file.