Apache NetBeans website with antora

Apache NetBeans website with antora playbook

Infrastructure for Apache NetBeans website with antora

Basic structure

Several repository are used as content for the website:

• netbeans-antora-site contains blogs and community pages
• netbeans-antora-wiki contains wiki pages
• netbeans-antora-tutorials contains tutorials and kownledge database
• netbeans-antora-ui handle the UI, template and css

Tools

• Node.js
• Git

Extensions

• ‘lib/rssfeed.js’ to generate atom file for rss
• ‘@antora/lunr-extension’ for indexing and search

Building localy

mkdir antora
cd antora
git clone https://github.com/<username>/netbeans-antora.git
git clone https://github.com/<username>/netbeans-antora-site.git
git clone https://github.com/<username>/netbeans-antora-wiki.git
git clone https://github.com/<username>/netbeans-antora-tutorials.git
git clone https://github.com/<username>/netbeans-antora-ui.git
cd netbeans-antora
npx antora antora-local-playbook.yml

Apache guidelines for web sites

Apache provides different guidelines for project websites. Here are some:

Project-related non-apache.org domain names:: https://www.apache.org/foundation/marks/pmcs#nonapache

Apache Website Navigation Links Policy:: https://www.apache.org/foundation/marks/pmcs#navigation

Using svnpubsub or CMS for web site publishing, and using branches:: https://www.apache.org/dev/project-site.html#generated

Using .htaccess to configure the web server:: https://www.apache.org/dev/project-site.html#configure

How to manage my project's webpage:: https://www.apache.org/dev/project-site.html#intro