Hello,

Based on recent comments, I made a branch for using Jekyll on the leading site. 
It's a branch, we can discard it. The migration took me 1.5h, excluding this 
e-mail - not much wasted.

https://github.com/apache/logging-site/tree/jekyll

This is not yet auto-deployed, but if nobody opposes it, I will move on, merge, 
and autodeploy.

Here is some info:

Jekyll supports data files like this:
https://github.com/apache/logging-site/blob/jekyll/_data/projects.yml

In the future, one could modify those data files directly from GitHub UI to 
update a status or a team member. It would be autodeployed then. The code for 
the output is also simple:

https://github.com/apache/logging-site/blob/jekyll/index.html

The amount of HTML has decreased. In addition, I was able to use Flexbox, which 
is built-in to browsers (no more slow Bootstrap in this case)

We also can make use of SCSS now, which can use advanced CSS (in this case only 
nesting):
https://github.com/apache/logging-site/blob/jekyll/css/site.scss#L44

The current team list could be moved to a data file, too, but I left it as adoc 
to showcase that this Jekyll page can work with adoc as well:
https://github.com/apache/logging-site/blob/jekyll/team-list.adoc

If you want to work with Jekyll, you can run the scripts:

./run-docker-build.sh (only one time; Docker needs to be installed)
./run-jekyll.sh (when you want to work)

This way, you can build locally and check. However, you don't need to do this 
to update tiny things quickly.

Please let me know if you want to object; otherwise, I would love to move this 
forward.

If we, at some later point in time, move on to something like Antora, I will 
gladly help to migrate; however, since we are using adoc for this website as 
well, it should be straightforward.

As soon as I have a go for this, I will prepare a blog section announcing the 
latest releases and preparing everything for some announcements we had in mind 
on the PMC list.

Kind regards,
Christian

Reply via email to