Perhaps a little more explanation on how this module works:

The file: 
https://github.com/apache/plc4x-build-tools/blob/develop/plc4x-site-skin/src/main/resources/META-INF/maven/site.vm
 generally is the global template for all html files being generated.

https://github.com/apache/plc4x-build-tools/blob/develop/plc4x-site-skin/src/main/resources/META-INF/maven/site-macros.vm
 contains how individual blocks are being generated. However I don't think I 
really changed much here ... with the site.vm you can already do most of the 
interesting customizations.

In 
https://github.com/apache/plc4x-build-tools/tree/develop/plc4x-site-skin/src/main/resources/css
 you have all the CSS styling information and in 
https://github.com/apache/plc4x-build-tools/tree/develop/plc4x-site-skin/src/main/resources/images
 all the static imagery needed.

To make developing this as easy as possible I copied some of the website 
content of the project into an integration-test: 
https://github.com/apache/plc4x-build-tools/tree/develop/plc4x-site-skin/src/it/plc4x-website

So as soon as you build the module with the profile "run-its" enabled, Maven 
will automatically generate a website using the skin you're currently working 
on, and you can simply verify it looks nice by opening the "index.html" 

mvn -P run-its package



-----Original Message-----
From: Christofer Dutz <[email protected]> 
Sent: Mittwoch, 6. April 2022 11:11
To: [email protected]
Subject: Anyone willing to polish our website?

Hi all,

I just noticed that our website is not pulling the right image and link for the 
next ApacheCon so I guess we should fix this asap.

Personally, I would recommend that I duplicate what I did for the Apache PLC4X 
project, and we create our own Site Skin that we can customize as we see fit.
But I would need someone or some people to make it pretty for our project here.

Here's the module I built in PLC4X: 
https://github.com/apache/plc4x-build-tools/tree/develop/plc4x-site-skin

I think not manually creating a website in another language has the nice 
benefit of not having to learn another framework, and it's super easy to have 
our website automatically built and deployed by Jenkins. But I'm happy with any 
option you folks come up with ... as long as they actually finish the job and 
not just start it ;-)

What are your thoughts on this?

Chris


Reply via email to