From dev-return-98547-archive-asf-public=cust-asf.ponee.io@geronimo.apache.org Mon Apr 9 02:37:38 2018 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx-eu-01.ponee.io (Postfix) with SMTP id 31DD4180638 for ; Mon, 9 Apr 2018 02:37:37 +0200 (CEST) Received: (qmail 94624 invoked by uid 500); 9 Apr 2018 00:37:36 -0000 Mailing-List: contact dev-help@geronimo.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: dev@geronimo.apache.org List-Id: Delivered-To: mailing list dev@geronimo.apache.org Received: (qmail 94614 invoked by uid 99); 9 Apr 2018 00:37:36 -0000 Received: from mail-relay.apache.org (HELO mailrelay1-lw-us.apache.org) (207.244.88.152) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 09 Apr 2018 00:37:36 +0000 Received: from mail-qk0-f182.google.com (mail-qk0-f182.google.com [209.85.220.182]) by mailrelay1-lw-us.apache.org (ASF Mail Server at mailrelay1-lw-us.apache.org) with ESMTPSA id 1FFAD2AF1 for ; Mon, 9 Apr 2018 00:37:34 +0000 (UTC) Received: by mail-qk0-f182.google.com with SMTP id b198so7535628qkg.9 for ; Sun, 08 Apr 2018 17:37:34 -0700 (PDT) X-Gm-Message-State: ALQs6tCdvtlcPMt4pegNXGfJjUG6ddAht5Rwui0oflmA/NGvkRYX9RFm eb2wYI5sloEvgGRfP53eXuWd3R6QAQfyBVITRrI= X-Google-Smtp-Source: AIpwx4/m8kBLoUopg+fBEtxdg+CLStcoq+HKamzLSqp2Ci35umGGhJsZ5+u0Y8OWoLYbshIc1QAPMXClHWRrF9/Jg3A= X-Received: by 10.55.43.94 with SMTP id r91mr46552693qkh.214.1523234253469; Sun, 08 Apr 2018 17:37:33 -0700 (PDT) MIME-Version: 1.0 References: <43D71D46-3A0F-4C2F-BB87-1856E081F38A@yahoo.de> <0E51DD84-94A9-4B89-BB51-7D75928E8E9E@yahoo.de> In-Reply-To: From: "John D. Ament" Date: Mon, 09 Apr 2018 00:37:23 +0000 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: website pointers To: dev@geronimo.apache.org Content-Type: multipart/alternative; boundary="001a1147b0f09680d605695f9c1d" --001a1147b0f09680d605695f9c1d Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable We need to run a custom maven plugin to run antora for the website? What about the work that was already done to write the website in asciidoc? John On Sun, Apr 8, 2018 at 12:38 PM Romain Manni-Bucau wrote: > Hi guys, > > here is the first draft: > https://github.com/rmannibucau/geronimo-antora-maven-plugin > the project demo is available at > https://github.com/rmannibucau/geronimo-site-tester > > For now it uses a very simple setup but it should be a good start to let > us play a bit. > > Side question: should I import it @G? Do I request a new git repo > (geronimo-antora-maven-plugin)? > > > > Romain Manni-Bucau > @rmannibucau | Blog > | Old Blog > | Github > | LinkedIn > | Book > > > 2018-04-07 21:33 GMT+02:00 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 < >> rmannibucau@gmail.com>: >> > >> > 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 cachin= g >> 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 somethi= ng >> wrong in a tag) >> > 2. asciidoctor rendering is fast (in order ruby is faster than js whic= h >> 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 cust= om >> 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 < >> rmannibucau@gmail.com>: >> > > >> > > 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 w= e >> 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 >> =C3=A9crit : >> > > We already talked about this last summer >> https://lists.apache.org/thread.html/f28d62c18e9274e9aa6dd455630b9ea9b96= 2dac5d59eef876e07c237@%3Cdev.geronimo.apache.org%3E >> > > >> > > John >> > > >> > > On Mon, Mar 19, 2018 at 5:41 AM Romain Manni-Bucau < >> rmannibucau@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 >> > > >> > > >> > > >> > >> > >> >> > --001a1147b0f09680d605695f9c1d Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
We need to run a custom maven plugin to run antora for the= website?=C2=A0 What about the work that was already done to write the webs= ite in asciidoc?

John

=
On Sun, Apr 8, 2018 at 12:38 PM Romain Manni-Bucau <rmannibucau@gmail.com> wrote:<= br>
Hi guys,

<= /div>
the project demo is availa= ble at=C2=A0https://github.com/rmannibucau/geronimo-site-tester<= /div>

For now it uses a very simple setup but it should = be a good start to let us play a bit.

Side questio= n: should I import it @G? Do I request a new git repo (geronimo-antora-mave= n-plugin)?


=

Romain M= anni-Bucau
@rmannibucau | =C2=A0Blog=C2=A0| Old Blog |=C2=A0Github=C2=A0| LinkedIn=C2=A0| Book

2018-04-07 = 21:33 GMT+02:00 Mark Struberg <struberg@yahoo.de>:
I heared good things about antora. So let's tr= y it out ;)

LieGrue,
strub

> Am 07.04.2018 um 20:09 schrieb Romain Manni-Bucau <rmannibucau@gmail.com>: >
> 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 mav= en 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 sou= rces as well based on tags or branches if we want to override something wro= ng in a tag)
> 2. asciidoctor rendering is fast (in order ruby is faster than js whic= h is faster than java...really significatively)
>
> I'm using it to generate my work doc (https://ta= lend.github.io/component-runtime/) and I'm quite happy of it. We ca= n even probably keep the default theme with just some colors/logo customiza= tions.
>
>
> 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 |=C2=A0 Blog | Old Blog | Github | LinkedIn | Book
>
> 2018-04-06 19:35 GMT+02:00 Mark Struberg <struberg@yahoo.de>:
> I like the first a bit better.
>
> LieGrue,
> strub
>
> > Am 06.04.2018 um 15:49 schrieb Romain Manni-Bucau <rmannibucau@gmail.com&g= t;:
> >
> > up?
> >
> >
> > Romain Manni-Bucau
> > @rmannibucau |=C2=A0 Blog | Old Blog | Github | LinkedIn | Book > >
> > 2018-03-26 17:17 GMT+02:00 Romain Manni-Bucau <rmannibucau@gmail.com>:<= br> > > Here are 2 theme proposals - don't hesitate to do others, I j= ust picked 2 I like with a MIT license so we can use it:
> >
> > 1. https://www.creative-tim.com/produ= ct/now-ui-dashboard : the menu is on the left but I guess it can work f= or 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) onc= e we agree on a theme
> >
> >
> >
> >
> > Romain Manni-Bucau
> > @rmannibucau |=C2=A0 Blog | Old Blog | Github | LinkedIn | Book > >
> > 2018-03-19 19:28 GMT+01:00 Romain Manni-Bucau <rmannibucau@gmail.com>:<= br> > > ok, seems easier than I thought (not sure why I thought it was st= ill 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 contain= er libs" - xbean for instance, one for direct EE (txmgr etc), ...)? > > Then we probably just do a small jbake wrapper - something like <= a href=3D"http://svn.apache.org/repos/asf/openwebbeans/meecrowave/trunk/mee= crowave-doc/src/main/java/org/apache/meecrowave/doc/JBake.java" rel=3D"nore= ferrer" target=3D"_blank">http://svn.apache.org/repos/asf/openwebbeans/meec= rowave/trunk/meecrowave-doc/src/main/java/org/apache/meecrowave/doc/JBake.j= ava - auto including our theme and switching the color from a maven plu= gin config to ensure we are ~uniform.
> >
> > wdyt? Any theme proposal?
> >
> >
> >
> > Romain Manni-Bucau
> > @rmannibucau |=C2=A0 Blog | Old Blog | Github | LinkedIn | Book > >
> > 2018-03-19 19:01 GMT+01:00 Romain Manni-Bucau <rmannibucau@gmail.com>:<= br> > > Yes John, this thread is about having technical inputs to do it.<= br> > >
> > Le 19 mars 2018 18:51, "John D. Ament" <johndament@apache.org>= ; a =C3=A9crit :
> > We already talked about this last summer h= ttps://lists.apache.org/thread.html/f28d62c18e9274e9aa6dd455630b9ea9b962dac= 5d59eef876e07c237@%3Cdev.geronimo.apache.org%3E
> >
> > John
> >
> > On Mon, Mar 19, 2018 at 5:41 AM Romain Manni-Bucau <rmannibucau@gmail.com&= gt; 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 goa= ls) + asf standard stuff.
> >
> > Now I'm not familiar enough with current site deployment to m= ove alone forward.
> >
> >
> > So here are the questions:
> >
> > 1. anyone against it?
> > 2. anyone able to help to start binding the new sites when availa= ble?
> >
> >
> > Romain Manni-Bucau
> > @rmannibucau |=C2=A0 Blog | Old Blog | Github | LinkedIn | Book > >
> >
> >
>
>


--001a1147b0f09680d605695f9c1d--