Skip to content

Improve usability of external links #752

Description

@xeniape

Handling of external links

  • Add an icon to indicate that one is leaving the Stackable documentation when clicking on it
  • Open external links in a new tab

Is it possible/needed to write an AsciiDoc plugin or something similar to accomplish this?

PRs

Activity

  1. changed the title [-]special handling of external links? do we wnat to add an icon and open them in a new tab always? can we write an asciidoc plugin or something for it?[/-] [+]Improve usability of external links[/+] on Jun 24, 2025
  2. xeniape commented on Aug 14, 2025

    @xeniape
    MemberAuthor

    This can easily be accomplished by using {external-link-icon}^ in links, for example used here already: https://github.com/stackabletech/spark-k8s-operator/blob/7a8c2eee00275f3198d329f0bd0a6655cc0ad32a/docs/modules/spark-k8s/pages/index.adoc?plain=1#L16
    This results in:

    Image

    external-link-icon is defined in antora-playbook.yml of the documentation repo.

  3. self-assigned this
    on Aug 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions