OSDir

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: website pointers


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