Re: [documentation-dev] Math Guide now on wiki

2009-08-10 Thread Clayton
Jean Hollis Weber wrote:
 The documentation wiki now has a Math Guide listed. I copied Chapter 16
 (Math Objects) of the Writer Guide and labelled it Math Guide. It's
 still missing a lot of the equation examples (which appear in the PDF),
 but at least people should be able to find and identify it now.
 
 If someone has the time and interest to fix the missing examples and/or
 check the Math Forum to see what needs to be covered in the Guide that
 isn't there, please do so.

What belongs in place of text like:

  inline:Object52.png (1)

an equation? A missing example?

C.
-- 
Clayton Cornell   ccorn...@openoffice.org
OpenOffice.org Documentation Project co-lead
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany

-
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org



Re: [documentation-dev] Math Guide now on wiki

2009-08-10 Thread Clayton
Jean Hollis Weber wrote:
 The documentation wiki now has a Math Guide listed. I copied Chapter 16
 (Math Objects) of the Writer Guide and labelled it Math Guide. It's
 still missing a lot of the equation examples (which appear in the PDF),
 but at least people should be able to find and identify it now.
 
 If someone has the time and interest to fix the missing examples and/or
 check the Math Forum to see what needs to be covered in the Guide that
 isn't there, please do so.

Spotted a problem with transcluding the pages... if you browse the Math
doc, everything looks fine.. the TOC works, the breadcrumbs work etc.
If you edit and save you end up at the root/source of the transcluded
page.  That means you're dropped out of the Documentation/OOo3 User
Guides/Math Guide/ subpage structure, and the doc TOC is missing.

Not sure yet what the right solution is for this...

C.
-- 
Clayton Cornell   ccorn...@openoffice.org
OpenOffice.org Documentation Project co-lead
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany

-
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org



Re: [documentation-dev] Math Guide now on wiki

2009-08-10 Thread Clayton
Clayton wrote:
 Jean Hollis Weber wrote:
 The documentation wiki now has a Math Guide listed. I copied Chapter 16
 (Math Objects) of the Writer Guide and labelled it Math Guide. It's
 still missing a lot of the equation examples (which appear in the PDF),
 but at least people should be able to find and identify it now.

 If someone has the time and interest to fix the missing examples and/or
 check the Math Forum to see what needs to be covered in the Guide that
 isn't there, please do so.
 
 What belongs in place of text like:
 
   inline:Object52.png (1)
 
 an equation? A missing example?

Ok, I figured it out :-) A quick look at the PDF and it all became clear.

C.
-- 
Clayton Cornell   ccorn...@openoffice.org
OpenOffice.org Documentation Project co-lead
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany

-
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org



Re: [documentation-dev] Math Guide now on wiki

2009-08-10 Thread Jean Hollis Weber

Clayton wrote:


Spotted a problem with transcluding the pages... if you browse the Math
doc, everything looks fine.. the TOC works, the breadcrumbs work etc.
If you edit and save you end up at the root/source of the transcluded
page.  That means you're dropped out of the Documentation/OOo3 User
Guides/Math Guide/ subpage structure, and the doc TOC is missing.

Not sure yet what the right solution is for this...


Why do you consider this a problem? People will be reading the pages through the 
Documentation/OOo3 User Guides/Math Guide/ subpage structure (or the Writer 
Guide, or the Getting Started Guide), where they will see the TOC relevant to 
wherever they are. It's only after editing that you don't see the TOC. And very 
few people ever do any editing of the user guides on the wiki.


BTW, there are other parts of the user guides that are done that way, too.

--Jean

-
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org



Re: [documentation-dev] Math Guide now on wiki

2009-08-10 Thread T. J. Frazier

Clayton wrote:

Jean Hollis Weber wrote:

Clayton wrote:

Spotted a problem with transcluding the pages... 


It's only a problem when you're editing.  It caught me up... I spent
some time trying to figure out what was going on :-)  Every time I'd
edit I'd loose the TOC and I'd end up in a completely different place
than I started at... had me baffled until I clued in that I was editing
a transcluded page.

Thanks for the warning. Editing an entire page shows what's going on, 
but editing a section can get confusing, very quickly. OTOH, you only 
have to do it once :-) . . .


BTW, your math changes in Formula_layout all use brace-stuff-brace, 
which gives non-italicized rendering (I'm assuming that this notation is 
actually short for \mbox{stuff}, but what I don't know about math 
covers a very large wiki page on MW). For the examples in question, I 
suggest that a more mathy rendering would be better.


And, thanks for the negative space fixes after \simeq. It looks 
better. I'll keep my eyes open for that.

--
/tj/


-
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org



Re: [documentation-dev] Math Guide now on wiki

2009-08-10 Thread T. J. Frazier

Clayton wrote:


Feel free to adjust the math syntax... that was just my first attempt at
it to try and make it read at least close to the intended output.
Cleanup is still needed. :-)


OK, take a look: http://wiki.services.openoffice.org/wiki/Formula_layout

I figured we'd better coordinate, because we were editing that page at 
the same time. When I gave up on \begin{array} (it was giving me 
horrible Cannot Parse error messages, in red), and cancelled my edit, 
the .png refs were gone! :-O

--
/tj/



-
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org



Re: [documentation-dev] Math Guide now on wiki

2009-08-10 Thread Clayton
T. J. Frazier wrote:
 Clayton wrote:

 Feel free to adjust the math syntax... that was just my first attempt at
 it to try and make it read at least close to the intended output.
 Cleanup is still needed. :-)
 
 OK, take a look: http://wiki.services.openoffice.org/wiki/Formula_layout
 
 I figured we'd better coordinate, because we were editing that page at
 the same time. When I gave up on \begin{array} (it was giving me
 horrible Cannot Parse error messages, in red), and cancelled my edit,
 the .png refs were gone! :-O

Hehe, either we have too many editors or not enough :-)

I'm not in there editing anymore.  I know all about the horrible red
error messages... I got a lot of those in the process of building up
what formulas I did add/edit.  I'm not so sure the exact syntax for the
array thing.  I base what I know about Wiki math on these pages:
http://www.mediawiki.org/wiki/Manual:Math
and
http://meta.wikimedia.org/wiki/Help:Formula

C.
-- 
Clayton Cornell   ccorn...@openoffice.org
OpenOffice.org Documentation Project co-lead
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany

-
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org