vy commented on PR #14:
URL: https://github.com/apache/logging-site/pull/14#issuecomment-3699147935

   > 2. **Static files (DOAP, VDR, XSD)**
   >    These are machine-consumed entry points and their URLs **should** 
remain stable and canonical (e.g. 
`https://logging.apache.org/cyclonedx/vdr.xml`). Using Antora attachments 
changes/obscures those URLs, so I don’t think attachments are the right fit 
here.
   >    Using [**UI supplemental static 
files**](https://docs.antora.org/antora/latest/playbook/ui-supplemental-files/#static-files)
 seems more appropriate.
   
   I had already considered the UI supplemental files route, but refrained from 
it due to two major drawbacks:
   
   1. You need to explicitly provide every single file in `antora-playbook.yaml 
> ui.supplemental_files` object
   2. You need to change [the UI output 
directory](https://docs.antora.org/antora/latest/playbook/ui-output-dir/) — I 
find this a disruptive change (we deviate from Antora defaults) for a very 
small issue
   
   Nevertheless, I implemented this in 6d30d6e9. Though later on, in e9f718b2, 
I switched to `maven-resources-plugin` to copy static content, and this doesn't 
suffer from the aforementioned shortcomings.
   
   > 3. **Blog not in navigation**
   >    The blog is currently missing from the nav. We should either add a 
`blog/index.adoc` page or include the existing blog entries in the navigation.
   
   Fixed in bc1f7c68.
   


-- 
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.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to