[GitHub] [netbeans-website] vieiro edited a comment on pull request #533: Update index.asciidoc links from html to ascidoc

[GitBox <gi...@apache.org>]

vieiro edited a comment on pull request #533:
URL: https://github.com/apache/netbeans-website/pull/533#issuecomment-792242471


   Why change the extensions from html to asciidoc? By doing so this will break the links in the website, won't it?
   
   For instance, "nb-glossary.asciidoc" gets converted to "https://netbeans.apache.org/tutorials/nbm-glossary.html" but not to "https://netbeans.apache.org/tutorials/nbm-glossary.asciidoc"
   
   If you want the links to work both in the github editor (where files end with asciidoc) and in the web (where file end with .html)then I suggest using the Asciidoctor "xref" for cross references https://asciidoctor.org/docs/asciidoc-writers-guide/#cross-references
   
   What I mean is that the proper links are 
   
   * `link:whatever.html[Text here]` with an html extension
   * `xref:whatever.asciidoc[Text here]` with an asciidoc extension.
   
   But a `link` with `asciidoc` extension will break links in the final result.
   
   You can test this by issuing a "./gradlew clean buildSite run" in your box and see the resulting links.
   
   
   


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org

For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists