Hi,

 

I would like to move from our gradle/jbake cms website to antora/asciidoc
website. 

Current website is stuck on apache infra, on my infra, on githubactio but
works well on my wsl. We try a revert with no luck.

 

Antonio did a suggestion using antora

 

We mostly have asciidoc file so aim was to keep the content almost the same
markup. (some attributes needs migration, and some xref need proper
redirect).

- More logs available out of the box to have internal missing page. (for
template and for document)

- Extensible via script, currently tested to build atom rss feed.

 

As preview I tried to migrate website-repo to antora like infra keeping
history (maybe we could git-blame-ignore some of the commit later)

 

template repository

https://github.com/apache/netbeans-antora-ui

 

main execution + extensions 

https://github.com/apache/netbeans-antora

 

documentation splitted 

https://github.com/apache/netbeans-antora-site (blogs + main information)

https://github.com/apache/netbeans-antora-wiki (wiki pages)

https://github.com/apache/netbeans-antora-tutorials (kb and tutorials)

 

 

A jenkins build to build the documentation publishing in zip that can be
downloaded for showcase.

https://ci-builds.apache.org/job/Netbeans/job/netbeans-antora-website/

 

I you wanna try localy. clone all the previous repository under a common
subfolder. (mkdir test; cd test;git clone here.)

move to netbeans-antora-ui and run gulp bundle. (npm need installation)

move to netbeans-antora run npx antora antora-local-playbook.yml

 

 

Other Apache project seems to have also antora live. causeway,aries,felix
and seems working for them.

Major change will be to carefuly handle our htaccess to migrate smoothly.

 

 

This thread will be open for at least 72h under lazy consensus. Any -1 point
here if you have better alternative, or if you have a fix for current build.

 

Best Regards

Eric

 

Reply via email to