I’ve made a _little_ progress, I’ve converted the content to asciidoc and arranged it in Antora structure, made playbook and UI projects, and fixed the command line errors, and made a global index. I put up a preview at https://felix-preview.s3-us-west-2.amazonaws.com/documentation/auto-index.html <https://felix-preview.s3-us-west-2.amazonaws.com/documentation/auto-index.html>.
There’s lots more to do. If anyone is interested in looking or helping I can push my local repos to GitHub or even set up Apache git repos for the projects and push to them. David Jencks > On Aug 30, 2020, at 12:01 PM, David Jencks <[email protected]> wrote: > > I started on a migration, I’ll post more when I have more. > > David Jencks > >> On Aug 25, 2020, at 12:09 AM, Karl Pauls <[email protected]> wrote: >> >> That would be great - the location is: >> >> http://svn.apache.org/repos/asf/felix/site/ >> >> regards, >> >> Karl >> >> On Tue, Aug 25, 2020 at 1:23 AM David Jencks <[email protected]> >> wrote: >>> >>> 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] >>> >> >> >> -- >> Karl Pauls >> [email protected] >
