Nice doc with Nav :)

[ia3andy]

Inspired by other extensions like:

@gastaldi I didn't find a way to test the nav locally

[ia3andy]

So, what exactly did you do to index? Just split it in two? The diffs don't show me what you did.

I:

• splitted
• added titles on each pages
• added manual fragments [#...]
• Created the Nav Manually

[FroMage]

Why manual fragments instead of the auto-generated ones?

[ia3andy]

Why manual fragments instead of the auto-generated ones?

So they don't change if the title changes as they are referenced

[FroMage]

OK, very good point :)

[ia3andy]

@FroMage did you approve?

[ia3andy]

(we can always switch to auto-generated if that become something)

[gastaldi]

To test the nav locally I think you'd need to run Antora to generate the website by changing the Antora playbook to point to your repository/branch

[FroMage]

To test the nav locally I think you'd need to run Antora to generate the website by changing the Antora playbook to point to your repository/branch

Actually it's worse than this. Now my generated index.html page contains nothing and I can't navigate and see the rest of the docs locally before I push anything.

How do I test my docs locally now?

[ia3andy]

To test the nav locally I think you'd need to run Antora to generate the website by changing the Antora playbook to point to your repository/branch

Actually it's worse than this. Now my generated index.html page contains nothing and I can't navigate and see the rest of the docs locally before I push anything.

How do I test my docs locally now?

I thought I broke something but yeah I think we need to have some nav generated locally

It seems to be nice: https://docs.quarkiverse.io/quarkus-renarde/dev/index.html

[FroMage]

Yeah, it looks nice, on the surface, BUT… now I have two navs: one at the left which is missing deeper levels and is not generated, and one at the right which is missing higher levels but is generated.

This is really bad UI. How can we fix this?

[gastaldi]

Yeah, I agree. We should somehow adapt the local generation to use Antora and its layout (as it's built in quarkiverse-docs)

[ia3andy]

@gastaldi @FroMage

I don't think it's BAD UI, people tend to see things differently. Still I think we should have a common experience, let's continue the discussion there where @holly-cummins has already started some comparison with other docs: https://github.com/quarkiverse/quarkiverse-docs/issues/102#issuecomment-1640558021

[ia3andy]

@gastaldi for some reason the config reference is not working, I think it wasn't already before my change any thoughts?

[gastaldi]

@ia3andy I browsed the sources and didn't find any interface with @ConfigMapping or @ConfigRoot, what do you mean?

[FroMage]

I seem to have also lost the favicon I recently added :(