[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Re: [rdf4j-dev] archive site (was: Re: release 2.0 (and 1.0) tomorrow)
|
For the documentation, I think that something based on sphinx or jekyll
will be much more enjoyable in the long run.
I like sphinx better but anything that supports changing the
documentation through pull requests is miles ahead of wordpress.
The main site ofc can remain in wordpress
--
Nikola
On Thu, Aug 18, 2016 at 12:07:04PM +1200, Jeen Broekstra wrote:
>
> Thanks for this Rick, that's very useful. Let's keep it here (I
> prefer not to move it to Eclipse). I've set up the CNAME, should
> trickle through in the next hour or so.
>
> I'm guessing we need a top-level index.html though, since currently
> http://swirrl.github.io/ gives me a 404? I'll also try and put up a
> PR for the old system and userdocs, so that we have everything in
> one place.
>
> As an aside: while we currently use our Wordpress site for RDF4J
> documentation, I'm happy to consider alternative setups if it makes
> maintenance/community editing easier.
>
> Cheers,
>
> Jeen
>
> On 17/08/16 23:52, Rick Moynihan wrote:
> >Hi all,
> >
> >This morning I got frustrated that the old javadocs aren't online.
> >So I've rebuilt them from maven going back to sesame-2.7.12
> >
> >You can temporarily find them here:
> >
> >https://swirrl.github.io/archive-sesame/
> >
> >If Jeen wants to set a CNAME record pointing at swirrl.github.io
> ><http://swirrl.github.io> we can host it on archive.rdf4j.org
> ><http://archive.rdf4j.org> or another subdomain. I've set things
> >up at github assuming this CNAME for now, but it's easily changed
> >if we'd prefer something else.
> >
> >https://help.github.com/articles/setting-up-a-custom-subdomain/
> >
> >Also happy to move the repo somewhere else, e.g. eclipse... In
> >the meantime I'm also happy to accept PRs for a restyled
> >index.html and more archive docs for historical versions.
> >
> >R.
> >
> >On 17 August 2016 at 11:53, Nikola Petrov <nikolavp@xxxxxxxxx
> ><mailto:nikolavp@xxxxxxxxx>> wrote:
> >
> > We host an old version of the documentation because we are still using
> > sesame in GraphDB. You can check the following links:
> >
> > http://graphdb.ontotext.com/sesame/system/index.html
> > <http://graphdb.ontotext.com/sesame/system/index.html> - system documentation
> > http://graphdb.ontotext.com/sesame/users/index.html
> > <http://graphdb.ontotext.com/sesame/users/index.html> - user guide
> > http://graphdb.ontotext.com/sesame/apidocs/index.html
> > <http://graphdb.ontotext.com/sesame/apidocs/index.html> - javadoc
> >
> > Note that those are only used so we can be able to link in our own public
> > documentation. So there might be links which are broken in the documents.
> > I hope that this is useful to someone.
> >
> > NB: Thanks for Jeen for the effort - he gave us something from his machine
> > with which were able to resurrect a version of the old docs.
> >
> > -- Nikola
> >
> >
> > On Wed, Aug 17, 2016 at 12:08 PM, Rick Moynihan <rick.m@xxxxxxxxxx
> > <mailto:rick.m@xxxxxxxxxx>> wrote:
> >
> > In that case it's probably a good idea to remove the broken archives link.
> >
> > What documentation do you think people would want for old
> >versions? The main thing I find useful are the javadocs,
> >so I was thinking I
> > might generate the javadocs for 2.8.9 (but I could do other versions
> > too) and host them on a spare server somewhere, which you could point
> > archives.rdf4j.org <http://archives.rdf4j.org> at.
> >
> > Alternatively we could probably host built versions of them in a
> > github pages repo.
> >
> > Thoughts?
> >
> > R.
> >
> > On 16 August 2016 at 23:18, Jeen Broekstra <jeen.broekstra@xxxxxxxxx
> > <mailto:jeen.broekstra@xxxxxxxxx>> wrote:
> >
> > On 17/08/16 09:51, Rick Moynihan wrote:
> >> Hi Jeen,
> >>
> >> Site's looking really good, the only thing I've noticed is that
> >> the archive link to the old sesame docs is broken.
> >
> > Yes, unfortunately it will stay that way - there was an accident
> > with the old site hosting compounded by not having any backups. So
> > it's gone :(
> >
> > Suffice to say I'm making sure the new site is properly backed up
> > on a regular basis.
> >
> > Jeen
> >
> > _______________________________________________
> > rdf4j-dev mailing list
> > rdf4j-dev@xxxxxxxxxxx <mailto:rdf4j-dev@xxxxxxxxxxx>
> > To change your delivery options, retrieve your password, or
> > unsubscribe from this list, visit
> > https://dev.eclipse.org/mailman/listinfo/rdf4j-dev
> > <https://dev.eclipse.org/mailman/listinfo/rdf4j-dev>
> >
> >
> >
> > _______________________________________________
> > rdf4j-dev mailing list
> > rdf4j-dev@xxxxxxxxxxx <mailto:rdf4j-dev@xxxxxxxxxxx>
> > To change your delivery options, retrieve your password, or
> > unsubscribe from this list, visit
> > https://dev.eclipse.org/mailman/listinfo/rdf4j-dev
> > <https://dev.eclipse.org/mailman/listinfo/rdf4j-dev>
> >
> >
> >
> > _______________________________________________
> > rdf4j-dev mailing list
> > rdf4j-dev@xxxxxxxxxxx <mailto:rdf4j-dev@xxxxxxxxxxx>
> > To change your delivery options, retrieve your password, or unsubscribe
> > from this list, visit
> > https://dev.eclipse.org/mailman/listinfo/rdf4j-dev
> > <https://dev.eclipse.org/mailman/listinfo/rdf4j-dev>
> >
> >
> >
> >
> >_______________________________________________
> >rdf4j-dev mailing list
> >rdf4j-dev@xxxxxxxxxxx
> >To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> >https://dev.eclipse.org/mailman/listinfo/rdf4j-dev
>
>
> _______________________________________________
> rdf4j-dev mailing list
> rdf4j-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> https://dev.eclipse.org/mailman/listinfo/rdf4j-dev