----- "Miles Libbey" <mi...@yahoo-inc.com> wrote:

> Other parts of the new implementation that I think we'll need to add:
> 
> - a way to include a header and footer section.  If there becomes a
> need to change to a new CSS file/modify the search box; putting a new
> copywrite etc, changing in 1 file is much much nicer than in every
> file.  The current site uses SSI to achieve this -- many wiki
> languages have similar concepts, but I suppose that the text to html
> conversion script could also put them in.

This already exists in the form of a standard template:
https://svn.apache.org/repos/asf/trafficserver/site/branches/ats-cms/templates/

> - similarly, the navigation probably needs a bit more thought (as you
> point out).  The current SDK site has a file that has the file
> structure (ie, "URLs" is a subnode of the "HTTP Headers" chapter, and
> is generated via javascript.  The top navigation (next/previous) is
> done by hand in the individual file.

I'm not sure we can fix the <Prev | Next> issue ad hoc,
but I'm pretty sure it's *not* impossible to automate
the process of putting together the entire Navigation.
Maybe from that we can then automate the rebuild of Next/Prev links.

> - localization.  The current site doesn't have any way to localize. 
> Its great that the new one has a language tag on the file name.  In
> httpd land, once an english file is changed, a script goes through and
> finds the corresponding other language files and modifies them to
> indicate the english version has changed.  IMHO, this seems very
> clunky, relying on localizers to be able to diff files ... but its
> something. Is there a similar process in this new CMS?

I'm afraid this is one of the problems I have thought of, but
have not found a satisfying solution.
We could, maybe, do this as well in view.pm.
Toggling a [[outdated]] tag, which would generate a standard
phrase in $language that says: Please take a look at the English
version of this document as this here is outdated.

Thoughts?
Volunteers to take a whack at view.pm?
https://svn.apache.org/repos/asf/trafficserver/site/branches/ats-cms/lib/view.pm

> miles

And without further ado, I'll now start to migrate our content.

i

-- 
Igor Galić

Tel: +43 (0) 664 886 22 883
Mail: i.ga...@brainsware.org
URL: http://brainsware.org/

Reply via email to