Actually, I think it makes more sense to just upgrade the current HTML generator code to use HTML 5 markup. There's no need to keep some old "HTML 4" version, IMHO, as all modern browsers support (at least a sensible subset) of HTML 5 (even IE), and with a little testing it's possible to make HTML5 pages work even on ancient browsers (like ancient IE versions).
Patches are welcome :)
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Anonymous
-
2013-09-24
I was wondering about a HTML interface with jQuery and div tags. Any way to collapse/expand the navigation bar would be nice too, even by URL (supported by HTML), example: http://documentation/index.html?hidenavigation=true works with a little JavaScript URL parser and the documentation is shown with navigation bar collapsed.
The behavior of anchors is not affected by the URL keeping the current functionality: http://documentation/index.html?hidenavigation=true#NameOfFunction //still working
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I was wondering about a HTML interface with jQuery and div tags.
I would be open to using JS in HTML docs, yes. We already include jQuery anyway (for tipue search), so we could make more use of it.
My only requirement is that the JS should be an "extra", docs should look and work correctly even with JS turned off in a browser. But that's very possible to do with jQuery.
IOW, contributions are welcome :)
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
After think some days about this subject, I realized that HTML5 doesn't bring benefits for a while. I mean, what HTML5 tags should PasDoc use to show identifiers and etc? That can be done with HTML4. I propose an innovation with jQuery, as I said previously, and some improvements like using divs instead of tables and show/hide navigation feature.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Sorry. Please change the title to "HTML-5 support".
Actually, I think it makes more sense to just upgrade the current HTML generator code to use HTML 5 markup. There's no need to keep some old "HTML 4" version, IMHO, as all modern browsers support (at least a sensible subset) of HTML 5 (even IE), and with a little testing it's possible to make HTML5 pages work even on ancient browsers (like ancient IE versions).
Patches are welcome :)
Yeap, tonight I'll make a patch to solve it! :)
I was wondering about a HTML interface with jQuery and div tags. Any way to collapse/expand the navigation bar would be nice too, even by URL (supported by HTML), example:
http://documentation/index.html?hidenavigation=true works with a little JavaScript URL parser and the documentation is shown with navigation bar collapsed.
The behavior of anchors is not affected by the URL keeping the current functionality:
http://documentation/index.html?hidenavigation=true#NameOfFunction //still working
I would be open to using JS in HTML docs, yes. We already include jQuery anyway (for tipue search), so we could make more use of it.
My only requirement is that the JS should be an "extra", docs should look and work correctly even with JS turned off in a browser. But that's very possible to do with jQuery.
IOW, contributions are welcome :)
After think some days about this subject, I realized that HTML5 doesn't bring benefits for a while. I mean, what HTML5 tags should PasDoc use to show identifiers and etc? That can be done with HTML4. I propose an innovation with jQuery, as I said previously, and some improvements like using divs instead of tables and show/hide navigation feature.
If I had a little more time, I would send a patch implementing it using Bootstrap(*).
Currently, Bootstrap a nice and modern library for web (and doc :) ) development.
(*) - http://getbootstrap.com