To continue on a bit... and provide some relevant info for maintaining the Apache XML Graphics site, here's the file system for the important bits...
* content lives in `site/trunk/content` * templates live in `site/trunk/templates` * css lives in `site/trunk/content/css` * JavaScript files (*.js) live in `site/trunk/content/js` * Batik nav lives in `site/trunk/templates/batik-sidenav.mdtext` * FOP nav lives in `site/trunk/templates/fop-sidenav.mdtext` * XML Graphics Commons nav lives in `site/trunk/templates/xgc-sidenav.mdtext` Header stuff is in their respective `*-top.html` files. I'll work on a page that explains this, which will take the place of ye olde deployment docs... trunk$ pwd /_repos/apache/xmlgraphics/site/trunk trunk$ ls templates/ - batik-sidenav.mdtext - batik-top.html - bottom.html - fop-sidenav.mdtext - fop-top.html - sidenav.mdtext - single_narrative.html - skeleton.html - xgc-sidenav.mdtext - xgc-top.html trunk$ ls content - batik/ - charter.mdtext - commons/ - css/ - fop/ - images/ - index.mdtext - js/ - legal.mdtext - mail.mdtext - repo.mdtext - sitemap.html - team.mdtext Kind regards, Clay Leeds -- <[email protected]> - <http://ourlil.com/> My religion is simple. My religion is kindness. - HH The 14th Dalai Lama of Tibet On Mon, Nov 26, 2012 at 8:50 PM, The Web Maestro <[email protected]>wrote: > Just as a point of Reference, I thought I'd provide fresh documentation on > updating the Apache XML Graphics Project web site: > > http://xmlgraphics.apache.org/ > > Here's the CMS Reference Documentation page for ASF-CMS: > > http://www.apache.org/dev/cmsref.html > > The mdtext files are converted to html with python > markdown<http://freewisdom.org/projects/python-markdown/> > . > > The markup syntax is described in > http://daringfireball.net/projects/markdown/syntax > > The following extensions are enabled for the CMS: > > - headerid <http://freewisdom.org/projects/python-markdown/HeaderId> > - tables <http://freewisdom.org/projects/python-markdown/Tables> > - abbr <http://freewisdom.org/projects/python-markdown/Abbreviations> > - def_list<http://freewisdom.org/projects/python-markdown/Definition_Lists> > - toc<http://freewisdom.org/projects/python-markdown/Table_of_Contents> > - codehilite<http://freewisdom.org/projects/python-markdown/CodeHilite> > - footnotes <http://freewisdom.org/projects/python-markdown/Footnotes> > - > elementid<https://svn.apache.org/repos/infra/websites/cms/build/mdx_elementid.py> > > The extensions are part of the 'Markdown Extra' syntax documented in > http://michelf.com/projects/php-markdown/extra/ > And of course... > > For complete details, please see Updating the Infrastructure web > site<http://www.apache.org/dev/infra-site.html> > and Reference Manual <http://www.apache.org/dev/cmsref.html>. A video > tutorial is available at http://s.apache.org/cms-tutorial. > > If you just want to get started editing a page: > > - Install the bookmarklet from the cms<https://cms.apache.org/#bookmark> > page. > You only have to do this once. > - Navigate to the page you wish to edit (on the live site, not in the > cms). > - Click the bookmarklet. There will be a short pause while the CMS > system is initialised for you. > - Click on Edit (to skip this step hack the bookmarklet to add an > 'action=edit' param to the bookmarklet's query string) > - The page editor should then be displayed. > - Click Submit to save your edit to the workarea > - Click Commit to save the updated file to SVN and trigger a staged > build. (to skip this step click on the "Quick Commit" checkbox in the > Edit form). > - The results should appear shortly on the > staging<http://www.staging.apache.org/dev/cms.html> site. > (You may have to force the page to refresh in order to see the updated > content) > - Once you are happy with the updated page, click on Publish Site to > deploy. > > ------------------------------ > > Kind regards, > > Clay Leeds > -- > <[email protected]> - <http://ourlil.com/> > My religion is simple. My religion is kindness. > - HH The 14th Dalai Lama of Tibet >
