John, see also my note on the original thread. Here's where to get the
existing how-to's.
http://documentation.openoffice.org/HOW_TO/index.html
Note: I think someone else is moving the Impress how-to's to the wiki; at
least one I'm sure ("First Steps in Impress") has been moved recently. And
I noted earlier that the two items under Math are already on the wiki in
slightly amended form (as Writer Guide Ch 16).
To upload things to the wiki, all you need is an account there.
The path or address for a how-to should be
http://wiki.services.openoffice.org/wiki/Documentation/How Tos/DocTitle
Pick any file on the old How-to page at Docs and check it against OOo2.3.
It's up to you whether to update as you go or do the easy ones first (those
needing minor changes only), or do the shorter ones first, or the ones that
interest you most.
Tell the list which ones you are doing and/or which ones you've inspected
and have deferred because they need major work. People can then let you
know if they are working on, or have already written, something that could
be used, to avoid duplication of effort. Always feel free to improve on
what others have done; for example, some translations into English may
benefit from some editing even if the content is otherwise up to date.
A related thought: some how-to's cover much the same topics that are in
various parts of the OOoAuthors user guides. I think it's good to have this
info as separate how-to's as well as being part of the larger book, but we
could reuse the information that's already written (either as is, or
slightly changed to fit the how-to format better), especially for any
how-to's that are very out of date. Reusing info might make the process of
updating go faster, too.
Back to practical matters: You could either update the SXW files and save
them to ODT, then export to MediaWiki, or just extract the contents and
update them on the wiki. I'd like to see the How-to's in ODT, PDF, and wiki
formats, but others on this list think the wiki is enough. If you do create
ODTs and/or PDFs, they can be put back on the Docs website, but if you
don't have CVS access then someone else will need to do this for you. That
is the topic of a separate note.
After exporting a how-to from ODT to Mediawiki, you'll need to clean up the
output, especially if it includes images (this mainly involves changing the
Image references), and you'll need to upload the images. Again, there may
be images already on the wiki that could be reused, simply by linking to
them. If not, the way I get the images is to unzip the ODT file and look in
the PICTURES directory. The images in there all have names in (I assume)
hexadecimal, but you should be able to view them and see which corresponds
to which figure in the document. Then when you upload them to the wiki,
give them a more meaningful (or at least shorter!) name.
Hope this helps. Others may have better hints for doing things. I'm new to
this move-to-the-wiki stuff myself, and would love to know faster and
easier ways to do it as I work my way through converting the stack of
OOoAuthors guides.
--Jean
John Downing wrote:
I'm willing to lend a hand by checking HowTos and moving valid ones
across or re-writing them if need be.
I'm a frequent OOo user and always learning how to do stuff better. The
modules I work with most are:
1) Writer,
2) Impress,
3) Database,
4) Calc,
in that order.
How should I go about it and what permissions do I need? In particular,
where do I access the old HowTos now that the Documentation site points
to the WiKi?
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
