openframeworks/ofSite — pull request #201 by workergnome (2013-09-03 01:16:13+00:00)
Title: Updates for documentation viewer.

While working on the documentation for the ofRectangle class I ran into a bunch of issues with the Javascript navigation. For instance, trying to navigate to any method with non-alphanumeric characters in it doesn't work, or that the back button breaks while navigating through the documentation.

I've gone through and fixed as much as I could. I don't know what has been discussed before, and don't want to rehash things that I don't know about—is it better to break this into a bunch of smaller pull requests?

Additionally, I haven't been able to test the javascript changes in IE, since I don't have a Windows machine. It does work in current Mac versions of Safari, Opera, Firefox, and Chrome, and I did put in fallbacks where I could.

__Style changes:__
* Removed a duplicated definition.
* Updated the style for unordered lists within documentation.
* lightened the carat for missing documentation.

__Template changes:__
* Updated the named anchors so the links and the anchors match. (The anchors were missing the `show_`).
* added a data-lookup parameter to class methods, functions, and variables. This is to deal with the fact that many of the common characters in method names (like == or +) are not allowed in class names, which meant that trying to go to those methods didn't work.
* added a data-item-type parameter to class methods, functions, and variables. This allows the page title formatting for each to vary based on item type.

__Javascript changes:__
* Got rid of the unused columnize call.
* Changed the documentation search from using class name to using data-lookup parameters.
* Made the page title change dynamically based on the current method, not just the current class.
* Fixed the behavior of the back button—it now will correctly go through the on-page navigation, as opposed to doing nothing, but going back through all the anchors.
* extracted duplicate code into functions, added some documentation.