Re: website pointers

[Romain Manni-Bucau]

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 :

> I like the first a bit better.
>
> LieGrue,
> strub
>
> > Am 06.04.2018 um 15:49 schrieb Romain Manni-Bucau  >:
> >
> > up?
> >
> >
> > Romain Manni-Bucau
> > @rmannibucau |  Blog | Old Blog | Github | LinkedIn | Book
> >
> > 2018-03-26 17:17 GMT+02:00 Romain Manni-Bucau :
> > 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 :
> > 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 :
> > Yes John, this thread is about having technical inputs to do it.
> >
> > Le 19 mars 2018 18:51, "John D. Ament"  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 <
> rmannibu...@gmail.com> 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
> >
> >
> >
>
>

Re: website pointers

[Mark Struberg]

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 :
> 
> 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 :
> I like the first a bit better.
> 
> LieGrue,
> strub
> 
> > Am 06.04.2018 um 15:49 schrieb Romain Manni-Bucau :
> >
> > up?
> >
> >
> > Romain Manni-Bucau
> > @rmannibucau |  Blog | Old Blog | Github | LinkedIn | Book
> >
> > 2018-03-26 17:17 GMT+02:00 Romain Manni-Bucau :
> > 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 :
> > 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 :
> > Yes John, this thread is about having technical inputs to do it.
> >
> > Le 19 mars 2018 18:51, "John D. Ament"  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  
> > 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
> >
> >
> >
> 
>