I heared good things about antora. So let's try it out ;) LieGrue, strub
> Am 07.04.2018 um 20:09 schrieb Romain Manni-Bucau <[email protected]>: > > Hi guys, > > planning to spend some time on this topic tomorrow, > > last year we spoke of jbake but in between Antora ([1]) went out. > > Assuming I hide the node part behind a maven plugin (like frontend maven > plugin which downloads node+deps transparently with correct caching etc...), > any objection to use antora instead of jbake? > > The rational is: > > 1. out of the box support of versioning (on the website but in our sources as > well based on tags or branches if we want to override something wrong in a > tag) > 2. asciidoctor rendering is fast (in order ruby is faster than js which is > faster than java...really significatively) > > I'm using it to generate my work doc > (https://talend.github.io/component-runtime/) and I'm quite happy of it. We > can even probably keep the default theme with just some colors/logo > customizations. > > > Wdyt? Does it sound like a good plan or an enthusiasm excess? Should I fall > back on a jbake based solution and we bake the versioning in a custom fashion? > > > > [1] https://docs.antora.org/antora/1.0/ > > > Romain Manni-Bucau > @rmannibucau | Blog | Old Blog | Github | LinkedIn | Book > > 2018-04-06 19:35 GMT+02:00 Mark Struberg <[email protected]>: > I like the first a bit better. > > LieGrue, > strub > > > Am 06.04.2018 um 15:49 schrieb Romain Manni-Bucau <[email protected]>: > > > > up? > > > > > > Romain Manni-Bucau > > @rmannibucau | Blog | Old Blog | Github | LinkedIn | Book > > > > 2018-03-26 17:17 GMT+02:00 Romain Manni-Bucau <[email protected]>: > > Here are 2 theme proposals - don't hesitate to do others, I just picked 2 I > > like with a MIT license so we can use it: > > > > 1. https://www.creative-tim.com/product/now-ui-dashboard : the menu is on > > the left but I guess it can work for most of our subprojects > > 2. https://www.creative-tim.com/product/now-ui-kit : more classical but > > maybe too much "UI" aspects not fitting well tech products > > > > I'm happy to start PoC-ing a maven plugin for our integration with the > > customization being options of the plugin (colors, title etc) once we agree > > on a theme > > > > > > > > > > Romain Manni-Bucau > > @rmannibucau | Blog | Old Blog | Github | LinkedIn | Book > > > > 2018-03-19 19:28 GMT+01:00 Romain Manni-Bucau <[email protected]>: > > ok, seems easier than I thought (not sure why I thought it was still a mix > > with confluence): > > https://svn.apache.org/repos/infra/websites/production/geronimo/content/ :) > > > > let's hack it now. What about picking a free bootstrap theme we can decline > > with colors (likely one for MP, one for "common container libs" - xbean for > > instance, one for direct EE (txmgr etc), ...)? > > Then we probably just do a small jbake wrapper - something like > > http://svn.apache.org/repos/asf/openwebbeans/meecrowave/trunk/meecrowave-doc/src/main/java/org/apache/meecrowave/doc/JBake.java > > - auto including our theme and switching the color from a maven plugin > > config to ensure we are ~uniform. > > > > wdyt? Any theme proposal? > > > > > > > > Romain Manni-Bucau > > @rmannibucau | Blog | Old Blog | Github | LinkedIn | Book > > > > 2018-03-19 19:01 GMT+01:00 Romain Manni-Bucau <[email protected]>: > > Yes John, this thread is about having technical inputs to do it. > > > > Le 19 mars 2018 18:51, "John D. Ament" <[email protected]> a écrit : > > We already talked about this last summer > > https://lists.apache.org/thread.html/f28d62c18e9274e9aa6dd455630b9ea9b962dac5d59eef876e07c237@%3Cdev.geronimo.apache.org%3E > > > > John > > > > On Mon, Mar 19, 2018 at 5:41 AM Romain Manni-Bucau <[email protected]> > > wrote: > > Hi guys, > > > > anyone able to help to rebrand the website? > > > > I propose to use static generators for the "mainstream" projects and bind > > them under a subcontext using the project name (dropping geronimo prefix if > > used, ex: /safeguarad, /xbean, /config). > > > > The root should contain the targets of the projects (umbrella goals) + asf > > standard stuff. > > > > Now I'm not familiar enough with current site deployment to move alone > > forward. > > > > > > So here are the questions: > > > > 1. anyone against it? > > 2. anyone able to help to start binding the new sites when available? > > > > > > Romain Manni-Bucau > > @rmannibucau | Blog | Old Blog | Github | LinkedIn | Book > > > > > > > >
