@alandefreitas/asciidoctor-boost-links v0.0.1

This extension creates links to Boost libraries and tools with inline Asciidoc syntax.

boost:core[]

This will render as if the equivalent AsciiDoc code was used:

https://www.boost.org/libs/core[Boost.Core]

When processed by Asciidoc, this renders as \"Boost.Core\":

<a href="https://www.boost.org/libs/core">Boost.Core</a>

The extension supports Boost libraries and tools.

Configuration {#_configuration}

npm {#_npm}

Install this extension

npm i -D @alandefreitas/asciidoctor-boost-links

AsciiDoc {#_asciidoc}

To use this extension with the asciidoctor javascript library, you need to include the extension in the Asciidoctor object.

import BoostLinksExtension from '@alandefreitas/asciidoctor-boost-links'
const processor = Asciidoctor()
processor.Extensions.register(BoostLinksExtension)
const result = processor.convert(`boost:core[]`)

Antora Playbook {#_antora_playbook}

To use this extension with Antora, include the extension in the asciidoc.extensions array in the antora-playbook.yaml file.

asciidoc:
  extensions:
    - '@alandefreitas/asciidoctor-boost-links'

Features {#_features}

Links to Libraries {#_links_to_libraries}

The extension helps you create links to Boost libraries. The format is very similar to the syntax for URLs in Asciidoc. However, the extension will automatically convert the library name to the appropriate URL and display the library name if the positional argument is not provided.

boost:core[]

This will render as if the equivalent AsciiDoc code was used:

https://www.boost.org/libs/core[Boost.Core]

When processed by Asciidoc, this renders as \"Boost.Core\":

<a href="https://www.boost.org/libs/core">Boost.Core</a>

Boost Tools {#_boost_tools}

Boost tools, such as Boost.Docca, have different link formats. The extension will identify the tool and render the link accordingly.

boost:docca[]

This will render as if the equivalent AsciiDoc code was used:

https://www.boost.org/tools/docca[Boost.Docca]

When processed by Asciidoc, this renders as \"Boost.Docca\":

<a href="https://www.boost.org/tools/docca">Boost.Docca</a>

Unknown libraries {#_unknown_libraries}

Unknown libraries render as if the library exists:

boost:a[]

This will render as if the equivalent AsciiDoc code was used:

https://www.boost.org/libs/a[Boost.A]

When processed by Asciidoc, this renders as \"Boost.A\":

<a href="https://www.boost.org/libs/a">Boost.A</a>

Positional arguments {#_positional_arguments}

Positional arguments allow you to specify the text to display in the link.

boost:boostdep[Dependencies]

This will render as if the equivalent AsciiDoc code was used:

https://www.boost.org/tools/boostdep[Dependencies]

When processed by Asciidoc, this renders as \"Dependencies\":

<a href="https://www.boost.org/tools/boostdep">Dependencies</a>

Forwarding attributes {#_forwarding_attributes}

If any attributes are passed to the link, they will be forwarded to the generated link.

boost:quickbook[Quickbook,window=_blank]

This will render as if the equivalent AsciiDoc code was used:

https://www.boost.org/tools/quickbook[Quickbook,window=_blank]

When processed by Asciidoc, this renders as \"Quickbook,window=_blank\":

<a href="https://www.boost.org/tools/quickbook" target="_blank" rel="noopener">Quickbook</a>

It also works when no text is provided:

boost:utility[window=_blank]

This will render as if the equivalent AsciiDoc code was used:

https://www.boost.org/libs/utility[Boost.Utility,window=_blank]

When processed by Asciidoc, this renders as \"Boost.Utility,window=_blank\":

<a href="https://www.boost.org/libs/utility" target="_blank" rel="noopener">Boost.Utility</a>

Exceptions to Pascal Case {#_exceptions_to_pascal_case}

A few libraries and tools have exceptions to the Pascal Case rule (the \"Boost.LibraryName\" format). These exceptions are defined when requested by library authors or when the Pascal Case format is problematic. The extension will identify these exceptions and render the link accordingly.

boost:build[]

This will render as if the equivalent AsciiDoc code was used:

https://www.boost.org/tools/build[B2]

When processed by Asciidoc, this renders as \"B2\":

<a href="https://www.boost.org/tools/build">B2</a>

Or Boost.URL, where the library name is an acronym:

boost:url[]

This will render as if the equivalent AsciiDoc code was used:

https://www.boost.org/libs/url[Boost.URL]

When processed by Asciidoc, this renders as \"Boost.URL\":

<a href="https://www.boost.org/libs/url">Boost.URL</a>