Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Antora assembler simplification #910

Draft
wants to merge 9 commits into
base: release/3.2
Choose a base branch
from

Commits on Sep 13, 2024

  1. First pass for simplification of complex partials

    Run
        perl -ni -e 'print unless /^(\s*$|\/\/)/' \
             modules/ROOT/pages/_partials/_show_glossary_links.adoc
             ...
    
    on the main abstracted partials. This is so that when antora-assembler inlines them,
    they won't have extra newlines and // comment lines that confuse the output.
    
    Additionally, manually add a comment to the block_tabbed_code partials, so that
    the source of includes can be tracked.
    osfameron committed Sep 13, 2024
    Configuration menu
    Copy the full SHA
    60e8bf0 View commit details
    Browse the repository at this point in the history
  2. simplify script

    run:
    
      ./simplify/simplify.sh
    
    This assumes that docs-site and docs-sync-gateway are siblings in the file tree.
    
    This sample only updates the android/database.adoc page for now
    (it builds everything, and all the rest should work in exactly the same way,
    I just haven't wired that part together yet.)
    osfameron committed Sep 13, 2024
    Configuration menu
    Copy the full SHA
    c59cc35 View commit details
    Browse the repository at this point in the history

Commits on Oct 1, 2024

  1. Run improved simplify script on all modules

    * Extract `process` call to run on all modules, and all asciidoc files
    
    * {tabs} declarations get mangled
      (possibly same issue as https://gitlab.com/antora/antora-assembler/-/issues/17 ?)
      We now de-munge these
    osfameron committed Oct 1, 2024
    Configuration menu
    Copy the full SHA
    b4552b4 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    9bd2a19 View commit details
    Browse the repository at this point in the history
  3. demunge plantuml

    osfameron committed Oct 1, 2024
    Configuration menu
    Copy the full SHA
    4256e0a View commit details
    Browse the repository at this point in the history
  4. improve demunging

    osfameron committed Oct 1, 2024
    Configuration menu
    Copy the full SHA
    5ccd834 View commit details
    Browse the repository at this point in the history
  5. update modules

    osfameron committed Oct 1, 2024
    Configuration menu
    Copy the full SHA
    aa71985 View commit details
    Browse the repository at this point in the history
  6. demunge additional tabs anchors

    these auto-generated anchors break tabs
    osfameron committed Oct 1, 2024
    Configuration menu
    Copy the full SHA
    79d3d15 View commit details
    Browse the repository at this point in the history
  7. fix tabs

    osfameron committed Oct 1, 2024
    Configuration menu
    Copy the full SHA
    f78181e View commit details
    Browse the repository at this point in the history