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

RFE: Optional Setting to enable compatibility with Asciidoc/Antora folder/path system #557

Closed
rgleason opened this issue Aug 13, 2021 · 7 comments

Comments

@rgleason
Copy link

I like this plugin for preview of adoc files however the linkage is not working for the
nav.doc file because the rest of the documents are then under another directory /pages/

Thus the links in the nav.adoc file do not work. Antora creates html pages with links that work, however this asciibrowser extension does not recognize the Antora system.

Please see this example and Issue
opencpn-manuals/development#27

The browser would be a much better tool if links in the nav.adocs worked with asciidoc/Antora
Thank you.

@rgleason rgleason changed the title Optional Setting to enable compatibility with Asciidoc/Antora folder/path system RFE: Optional Setting to enable compatibility with Asciidoc/Antora folder/path system Aug 13, 2021
@mojavelinux
Copy link
Member

This is a duplicate of #299.

@rgleason
Copy link
Author

Sorry, closing

@mojavelinux
Copy link
Member

Feel free to post more context to the linked issue. It doesn't specifically mention nav files, so I think it's worth noting there.

@rgleason
Copy link
Author

rgleason commented Aug 13, 2021

Antora uses nav.adoc files for the main index or outline. These often reside one directory above the other adoc files. Example: using GitHub/development/modules/ROOT/pages/
Also see https://github.com/opencpn-manuals/development for more details

nav.adoc - file
attachments - folder
images - folder
pages - folder

  • about.adoc (under pages) - asciidocbrowser nav.adoc links fail due to missing "/pages/"
  • info.adoc (under pages) - asciidocbrowser nav.adoc links fail due to missing "/pages/"

However we do not want to mess up the Antora output to html!!!

The links in nav.doc are not referencing the "/page/"

Example: github/development/modules/ROOT/about.adoc fails in the ascii browser extension

however these links work when Antora has run to output html and you use the html output.

@mojavelinux
Copy link
Member

Please post this comment to the linked issue please. Thanks!

@rgleason
Copy link
Author

Sorry

@mojavelinux
Copy link
Member

Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants