On 10/7/2010 09:20, Clayton wrote:
On 10/07/10 03:29, TJ Frazier wrote:
Trying to solve two problems at once—displaying the current version and
marking the History for easier access to old versions—led to a complex
solution like that script. However, there are much cheaper solutions to
both problems, taken one at a time.
The "find old versions" solution is essentially cost-free: find that
table of release dates for all versions, and tell the user to assume
that edits prior to the particular date should be included, but not
later edits, but consult the edit summaries.
Your remark about using a template to display the version led me to
think of where to display it. The obvious answer is on the first (title)
line of the TOC (we may run into a small width problem) where we're
already showing a "3". The big advantage here is that the template call
can be part of the chapter TOC templates, where the title is specified;
a small enough number to change manually, once.
Do we want a separate version template for each Guide? I think maybe so.
If we want to nail down the guides on the Wiki to a specific version it
may be easier to protect the 3.2 guides and start clean with 3.3. Not
sure... just one way since there really is no "version control" on Wikis
(not designed for that).
No, I don't think we need to nail down or protect the old versions. And
starting clean is a horrendous amount of work.
In theory, if all versions were so marked, we could even print a book
for any given version. In practice, a user should be able to find the
older version in the History tab for any particular page. We may want
a Help entry on how to do this, and a reference to that on the Doc page.
You "can" do this by linking the Book file to the specific page in the
history. it's messy to do this... but it's possible using current Wiki
tools.
Doesn't the book process do something like translating the page name to
an id-number? If we had a script, or could capture that part of the book
output, we could have a permanent way to generate a 3.2 book from the wiki.
C.
--
/tj/
---------------------------------------------------------------------
To unsubscribe, e-mail: authors-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: authors-h...@documentation.openoffice.org
