Static doc pages - an update and a few questions

Static doc pages - an update and a few questions


Hi all -
I wanted to give you an update on adding the static doc pages like
Changelog, Roadmap, Dev guide and Theming to the site. Paul spent a
bunch of time with Maggie and I this morning and was able to
dynamically pull in the rendered jQuery.com wiki doc content by
writing a new PHP template that grabs fresh content every few minutes
from the wiki.
You can see the pages here, use the left nav to move between them:
http://ui-dev.jquery.com/documentation/Developer_Guide
We also pushed up the updated overview page with these links:
http://ui-dev.jquery.com/demos
NOTE: We're using absolute links in the navs because these are also
included in the /docs/ folder in the download and don't want to add
these files to the download. When browsing demos locally from a
download, these links will just open pages on the live site. The links
on the overview page now will give you a 404 because they are absolute
and point to the live UI site, not dev, and these updates are live
yet. Add -dev and they will look ok. For some reason, navigating in
the left nav resolves the URL correctly so maybe the same fix can be
applied to the overview page.
So the items left to do are mainly styling these page a bit to hide
the edit links and clean up the formatting. A couple issues:
1. We want to scope all these new style rules to these wiki doc pages
only but if you look at the markup of the page above, these sit in a
td with a class of "normal" and then inside a div with the same class.
Anyone know why? We would like the documentation_page.tpl file used
here to add an ID of "wikipage" or something short and unique that we
can key all our overrides off. Can someone figure out how to do this?
2. In web trunk/css, there are separate css files for demos and Paul
created a new file for documentation, but we're thinking this will be
more manageable if we add styles to a single file, base.css and just
scope our styles to the relevant section. Are people ok with us making
this change?
3. Since these static wiki doc pages don't actually "live" on the site
anywhere and are just pulled in, there doesn't seem to be a way to
preview any CSS tweaks locally. We can save these files down locally
to try and replicate the site but is there a better way?