I _might_ be able to do a migration to Antora soon. I’ve been working on one for Aries.
IIUC a CMS site is somewhere in svn…. does anyone know the address for the Felix site? David Jencks > On Aug 24, 2020, at 1:56 AM, Karl Pauls <[email protected]> wrote: > > 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 <[email protected]> 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 <[email protected]> >>> 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 <[email protected]> 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 <[email protected]> >>>> wrote: >>>> >>>>> Hi, >>>>> >>>>> On Tue, Aug 4, 2020 at 6:30 PM Raymond Auge >>>>> <[email protected]> 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 >>>> [email protected] >>>> >>> >>> >>> -- >>> *Raymond Augé* <http://www.liferay.com/web/raymond.auge/profile> >>> (@rotty3000) >>> Senior Software Architect *Liferay, Inc.* <http://www.liferay.com> >>> (@Liferay) >> > > > -- > Karl Pauls > [email protected]
