GitHub supports Jekyll out of the box. They have their own kind of gitpubsub cms. In our case, with or without maven and plugins, we would need to ask contributors to install ruby to build the website. Not a huge issue, but sometimes ruby doesn't play nice in certain os'es. As I use ruby in some projects, it won't affect me, but I think it could put off some contributors. Jbake has some advantage on this for being pure java, but the maven plugin had some hiatus, and there's no guarantee it will be maintained for a long time. And jbake has less examples and layouts than jekyll. We'd have to compromise, and pick our poison here. I'm fine with either solution, as I think these could attract more contributions IMO. Bruno
Sent from Yahoo Mail on Android On Tue, 24 Oct 2017 at 22:41, [email protected]<[email protected]> wrote: Super +1 to going to gitpubsub. I am agnostic (because I don't know enough to have a very informed opinion) about site processing tools. (I've had no problem using plain ol' Maven Site processing, but I never used it on very large projects, nothing with a site the size of Jena's.) I had not heard of Jekyll, so I went and looked at https://jekyllrb.com/ but it appears to be a Ruby product? Would we run it somehow via JRuby from within Maven? Or as an exec task? ajs6f Bruno P. Kinoshita wrote on 10/23/17 5:11 AM: >> Is there a git+CMS option? (or mirro git to SVN then ...) > > > More or less. It was enabled in 2015 > https://blogs.apache.org/infra/entry/git_based_websites_available > > You must have the web site in the asf-site branch. > No mirror to SVN as far as I know... > >> CMS may not be around forever, and while the markdown isn't all >standard, >> it's quite close. (e.g. the processor "Title:" stuff) > > OpenNLP had a few issues migrating to JBake, but a bit of IDE-fu + regex did > the trick. The difference with Jena, I think, is that Jena's documentation is > much more extensive, which means more pages to edit. But doable nevertheless. > >> I don't know what processor is behind CMS - python based? Home >> grown/modified? > > Home grown, like the old IRC bot/factoid code (written in Lua I think), the > Help Wanted app (Lua too I believe). The CMS is a mix of Perl and Python. > > Source code for the curious: https://svn.apache.org/repos/infra/websites/cms/ > >> I've use jekyll (choice based on choosing a commonly used system to >> >increase the longevity and stability of the choice). > > Jekyll is my preferred option as well, as there are heaps more documentation > / examples / templates to re-use. > > The work for OpenNLP is done in https://github.com/apache/opennlp-site, in > the master branch. Then, there is a job somewhere, set up by ASF Infra, that > pulls the master branch, runs `mvn clean package ...`, and then deploys the > resulting static files generated onto the asf-site branch. > > The site is served with the contents of that asf-site branch. One can build > locally pull requests with `mvn clean package ...` and preview the web site, > without having to wait and preview in the staging web site. Or even preview > in GitHub pages as well. > > The decision for JBake was already done when I joined, so I just helped with > a few issues. It works quite well though. But if ASF Infra is able to build a > Jekyll project, then we could use it instead. > > Bruno > > > > ________________________________ > From: Andy Seaborne <[email protected]> > To: [email protected] > Sent: Monday, 23 October 2017 3:09 AM > Subject: Re: github stuff Was: [2/2] jena git commit: JENA-1391: adding > isEmpty method to Dataset > > > > Is there a git+CMS option? (or mirro git to SVN then ...) > > CMS may not be around forever, and while the markdown isn't all > standard, it's quite close. (e.g. the processor "Title:" stuff) > > I don't know what processor is behind CMS - python based? Home > grown/modified? > > I've use jekyll (choice based on choosing a commonly used system to > increase the longevity and stability of the choice). > > Andy > > > On 16/10/17 19:51, Bruno P. Kinoshita wrote: >> A few months ago I helped setting up OpenNLP's new website building from >> github. >> >> The source is in an opennlp-site git repository, and is built with maven >> using the maven jbake static site generator. >> >> Before they were using the svn cms pubsub if I recall correctly. Maybe we >> could have something similar if others like this approach. >> >> CheersBruno >> >> Sent from Yahoo Mail on Android >> >> On Tue, 17 Oct 2017 at 2:12, [email protected]<[email protected]> wrote: >> Andy Seaborne wrote on 10/13/17 3:40 PM: >>> If anyone is interesting in following it up, I have read that Apache >>> projects can now use gitbox where by all work is on >>> Github, including the full PR cycle, and the ASF is mirrored back. To us, >>> it looks like the GH is the master and ASF >>> the mirror (IIRC its a bit more complicated under the hood for INFRA than >>> that). >>> >>> Andy >> >> That sounds good to me. Is this the sort of thing for which I could just >> file a ticket on INFRA and follow up with them? >> >> As long as we are digressing, you know what I would really love? Being able >> to do our docs/site in git/github. I'm >> pretty sure other Apache projects manage to do that... >> >> ajs6f >> >>
