Hi all,

for the past days I have been working on a proposal for a new site skin for the 
PLC4X website.
It’s currently still quite ugly, but I have been concentrating on restructuring 
things and learning bootstrap.

But before working more on this, I wanted to discuss some ideas I had.

I would like to get rid of the menu we currently have as for me it’s sort of 
not that good to get an overview.
Instead I would like to split up the project into 4 sections:

  *   Home (Flashy, Shiny, landing page that people from the industry might 
find appealing)
  *   Users (Information Users would be looking for with information on how to 
use the API and all of the integration modules and the tools (scraper, 
connection-pool, opm))
  *   Devlopers (Information for people that want to build PLC4X, build own 
driver and contribute to the project
  *   Apache (Information on Apache – this is required and not optional (I 
think))

This is not that much different than it was before (I removed the “protocols” 
section this might be better located in the developer section and ideally most 
of its content could be generated in the future with a asciidoc generation 
template)

What I did do, is change the top navigation menu into a very simple 4-button 
menu to select the section of the website.
If a section has a sub-menu, a static navigation menu with all of its options 
is displayed left of the page content (or above in mobile mode)
If there is no sub-menu, the page is shown without a navigation menu and the 
content spreads to 100% width of the browser window (this is I think a 
requirement for these modern never-ending scroll-down-forever pages.

I think only the home and possibly the apache page should be one of these 
hand-crafted HTML pages. The content needs to be created for maximum impression 
at the user and will hopefully be quite static.
The other pages would be generated the way we have been doing all the time. I 
think our current tooling is the ideal compromise of expressiveness and 
simplicity.

I wouldn’t want to introduce and integrate yet another tool. After all, all of 
these tools just handle the visual presentation and not the content and content 
is what we need to work on.

You can check what I have been doing by going to the build-tools repo cd into 
the plc4x-site-skin directory and run “mvn clean install -P run-its” … a copy 
of the current site content is an integration test for the skin.
So after running that build, you can see the result in 
plc4x-site-skin/target/its/plc4x-website/target/site.


What do you think?

Chris

Reply via email to