Starting yesterday the Apache JackRabbit JCR website had an interesting problem. Someone must have made a change to the base template such that they had removed the SyntaxHighlighter code that needs to be appended to the header. I’ve opened an issue in their jira issue tracker.
Contents of JIRA Issue >>>>>>>> It started happening today. When I visit the website, for example: http://jackrabbit.apache.org/node-type-notation.html
All the artifacts that contain a “SCRIPT” of type syntaxhighlighter does not get displayed.
So basically all examples on the site fails to show up.
Example: Upon view-source, you will find artifacts like this:
None of the artifacts that are using “syntaxhighlighter” gets displayed. Which leaves the site almost useless when it comes to documentation.
Problem must have started today (April 19, 2010) since I was able to see them last night. >>>>>>>> Contents of JIRA Issue >>>>>>>>
But while I wait for a fix the site is pretty much unusable. Let me show you an example,
So essentially you have a website that has no examples, no configuration details, etc. While I wait for a fix (which can happen any day), I thought this is a good opportunity to whip out a Greasemonkey Script to fix the issue. So this article focuses on creating a GreaseMonkey script that addresses this issue in my browser while the site is broken.
Let’s first look at the problem:
Apache Jackrabbit site needs to include the following in their header tag:
Using GreaseMonkey, you can insert any script at any point in the document or site (from the browsers perspective). So here’s the script that does that:
// ==UserScript== // @name Apache JackRabbit Script // @namespace jackrabbit.apache.org // @description fixes the SyntaxHighlighter // @include http://jackrabbit.apache.org/* // ==/UserScript==
If you have GreeseMonkey installed in your FireFox browser, you can then click on the above link and GreeseMonkey will prompt you to approve the installation of the script. So you don’t need to do anything fancy. And you can uninstall it at anytime.
> > ### PS: If you are someone (or if you know of someone) who manages the Apache JackRabbit website, please fix the SyntaxHighlighter issue. We need the documentation! Thank You. > >
UPDATE from Sébastien Launay on Thurs., April 22, 2010 - Thank you for the information. Helps to know that someone out there is aware of the issue.
Thanks for reporting this issue.
The bug appears to be global to Apache projects websites and related to the confluence auto-export feature: https://issues.apache.org/jira/browse/INFRA-2638
– Sébastien Launay
Update - on Friday, April 23rd, 2010 - this bug has been resolved and verified. So no need for the patch with Grease Monkey.