Moving the discussion of Make links/styles/images relative [1] and its
associated PR [2] to the dev list.
So using a root variable in the md files has the same effect of putting a bunch
of ../ in the links. At least users wouldn't see these ../ when they hover over
links (tested Chrome, Firefox, and Safari). Also to get the links to work
properly in the Jenkins workspace you need to append index.html. So you wind up
have to prepend {{ page.root }} and append /index.html to every link. Not
pretty but it's a viable working solution.
Another option might be to copy the site to S3 or Cloud Files for preview. But
that involves saving the credentials in the BuildHive job. Access is restricted
to the GitHub admins on https://github.com/jclouds/jclouds.github.com/ so it's
secure but I'm still a bit hesitant to put creds out there. I'd be willing to
try it out though.
Another option is a bit of JavaScript/jQuery that runs when the page loads as
Matt suggested. I'd definitely be interested in this if we can make it work as
it would side step the problem of the above solutions.
We can discuss this at the meetup. The important part is that we come out of
that discussion with a actionable solution and document it here on the dev list.
Thanks,
Everett
[1] https://issues.apache.org/jira/browse/JCLOUDS-169
[2] https://github.com/jclouds/jclouds.github.com/pull/148
