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


Reply via email to