On 21/02/2020 18:59, Roy Lenferink wrote:
3/ There is a "jena-site:release-docs" branch for javadoc
Let's say this has /javadoc
If we have the following configured in the gitwcsub.cfg (INFRA stuff)
/www/jena.apache.org: $gitbox/jena-site
This means that the 'asf-site' contains a 'content' folder with the actual site
content.
/www/jena.apache.org/content/documentation/javadoc:
$gitbox/jena-site:release-docs
This means that everything from the root of the release-docs branch will be
served on
jena.apache.org/documentation/javadoc
Excellent. Even better.
I would name it "javadoc" though. The name "released-docs" covers the
all the documentation to my mind.
To be clear : I think you are saying that the root of the :javadoc
branch will be like:
arq/ extras/ fuseki2-main/ jdbc/ permissions/ shacl/
tdb2/ elephas/ fuseki2/ geosparql/ jena/ rdfconnection/
tdb/ text/ index.md
not
javadoc/
The release-docs branch will contain an exact copy of the following:
https://svn.apache.org/repos/infra/websites/production/jena/content/documentation/javadoc/
...
6/ There is no "jena.staging.apache.org". It is replaced by people
running "hugo" locally to get "/target/content" : "hugo server" puts it
on http://localhost:1313
The staging domain is indeed gone. An alternative could be to use Netlify
(netlify has free plans for
OSS projects). Netlify will build pull requests and comment with a link to the
preview. Celix has this
enabled as well. See this pull request as example:
https://github.com/apache/celix-site/pull/7
(of course cgi scripts are not working but this is expected behavior)
But maybe with the new site build solution that INFRA is currently working on
the staging domain
will be re-introduced as well ;) This is something we probably will find out in
a couple of weeks.
So the only thing outstanding is the "Improve this page" link becoming
"Edit this page".
(as a bare minimum, if that needs any later tweaking, it could be a link
to text in getting_involved/__index.md explaining how to git-clone and
PR. Not as good, but it de-risks that element).
Sorry for the the details questions :-) but to be as smooth as possible,
details matter!
FYI: My time on Jena is a bit bursty at the moment.
Andy
