Hi, coming back to this issue. I did talk briefly (out of band) with Ray directly on the Monday after but unfortunately, he had other matters to attend to so this got lost a bit.
As far as I understand the situation we have to migrate our site away from the deprecated Apache CMS. There are various options but none are directly supported in the sense that we wouldn't have to work on our content. That said, it seems like we can use .asf.yml to have our site staged and published from our felix-dev git repo and our CGis etc should still be supported. What we need to replace is the templating engine. We can either switch to something we run ourself like Jbake or the Antora proposed by Ray (which would require to convert our markdown to asciidoc) or we can try to use Jekyll which is supported by github pages directly (AFAIU) and would accept at least some of our existing markdown (so some work would need to be done). Now, I personally don't have (much) time for this - hence, if need be, I would try to get some part of our site working with the existing templates using .asf.yml and github pages and we could try to get it all working eventually. However, if somebody volunteers to move everything (to something else or just in general) that would be much better. Is somebody willing and has the time to work on this in the next week or two? regards, Karl On Sat, Aug 8, 2020 at 12:39 AM David Jencks <david.a.jen...@gmail.com> wrote: > > Converting the Aries website to Antora seems to be fairly easy and quick, > most likely I could do much of that that here too. > > David Jencks > > > On Aug 6, 2020, at 6:32 AM, Raymond Auge <raymond.a...@liferay.com.INVALID> > > wrote: > > > > Hey Karl, > > > > The more time passes the less time I will have to do this work, but I'll > > leave it until you're around. > > > > - Ray > > > > On Thu, Aug 6, 2020 at 3:43 AM Karl Pauls <karlpa...@gmail.com> wrote: > > > >> Hi Ray, > >> > >> thanks a lot for picking this up! > >> > >> I’m mostly offline this week but would like to look at the options as well. > >> Can we wait until next week until a decision is made? > >> > >> > >> regards, > >> > >> Karl > >> > >> On Wednesday, August 5, 2020, Bertrand Delacretaz <bdelacre...@apache.org> > >> wrote: > >> > >>> Hi, > >>> > >>> On Tue, Aug 4, 2020 at 6:30 PM Raymond Auge > >>> <raymond.a...@liferay.com.invalid> wrote: > >>>> ...So far the Apache Aries project seems to be leaning toward choosing > >>> Antora > >>>> [1] for choice of static site building tool... > >>> > >>> I'm not really active in Felix so I'll let the PMC or whoever does the > >>> work decide. > >>> > >>> However, as per [2] it looks like Antora supports only Asciidoc as its > >>> input format, whereas the current Felix site content is in Markdown. > >>> > >>> This *might* represent more conversion work - however there are > >>> various flavors of Markdown, so even staying in that format will > >>> require some conversion work as well. For Sling we migrated from the > >>> Apache CMS to Jbake [3] and a number of things required fixing, even > >>> though we used Markdown in both cases. > >>> > >>> -Bertrand > >>> > >>> [1] https://docs.antora.org/antora/2.3/ > >>> [2] https://docs.antora.org/antora/2.3/page/ > >>> [3] https://issues.apache.org/jira/browse/SLING-6955 > >>> > >> > >> > >> -- > >> Karl Pauls > >> karlpa...@gmail.com > >> > > > > > > -- > > *Raymond Augé* <http://www.liferay.com/web/raymond.auge/profile> > > (@rotty3000) > > Senior Software Architect *Liferay, Inc.* <http://www.liferay.com> > > (@Liferay) > -- Karl Pauls karlpa...@gmail.com
