On 10/12/2010 04:45, Jean Hollis Weber wrote:
On Tue, 2010-10-12 at 10:30 +0200, Clayton wrote:
On 10/12/10 09:20, Nino Novak wrote:
On Tuesday 12 October 2010 08:58, Clayton wrote:
I think TJ's suggestion to add it to App A of the GSG is a good idea.
just to throw in a question...
I wonder whether it's worth the effort of rewriting info from the App
Help.
On the one side, the UG can be printed on paper nicely. On the other
it's additional effort and rises the need of keeping the two sources in
sync.
Is there any possibility of using the App Help sources for generating UG
text in an automated way?
I talked to Uwe about this. He says that it's probably a whole lot easier to
simply copy/paste - once for each keyboard shortcut page from OOo on a Mac, and
once from OOo on any other OS.
The keyboard shortcuts help files are scattered in various locations within the
help, and can be extracted out of the jar file.
The issue: http://documentation.openoffice.org/issues/show_bug.cgi?id=56321
explains how the filename for a each application help page can be found.
If someone is brave enough to parse the raw XML contained in the help jar files
and separate out the various inline switches, it could be possible to extract
the information... but it's a fairly complex operation to do it this way.
The last time I worked with the App Help files, I used the ".xhp" files
from unpacking the source tarball; they were conveniently isolated in a
simple directory structure. Since I was only after the title line,
parsing the XML was fairly simple. If we need it, we can probably do it.
But, as Jean points out below, do we need it?
Copy and paste is what we did for what's in the keyboard shortcuts
chapter now, followed by some editing. But see my note on the "question
about Mac versus other platforms thread" -- do we actually need that
level of detail?
Probably not. A Tip for Mac users, in the various appendices, could
point to the App Help as Clayton suggested ("search on ... "). I think
somebody got clever: no Mac stuff is visible on that page, on my WV
installation.
--Jean
--
/tj/
---------------------------------------------------------------------
To unsubscribe, e-mail: authors-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: authors-h...@documentation.openoffice.org
