GS Macro Chapter replacement

It's correct for me, when I open it in the browser directly from the
link on http://wiki.documentfoundation.org/Documentation
or when I download it and open it.

Sounds like a problem at your end at this point.

--Jean

Lol, that would be interesting. I can try it from a few different machine
tomorrow. Err, today. Ooops, i had better try to sleep. It so late it's gone
past being early again!
Regards from
Tom :slight_smile:

I suppose that I have good news and bad news... Hey, it is the same news..... It works for me and looks fine.

I do take exception to a few items that were done while converting this from OOo to LO (as it were); and perhaps a few dumb things that I may have done, but, I won't bother to go back and check. Note, I only looked at the PDF.

The last page recommends that the user goes here for help:
http://wiki.services.LibreOffice/wiki/Documentation/BASIC_Guide

I see two issues with this. First, the link showed in the text does not exist. Second, if you look at the link associated with this text, it takes you to something other than what the text states, name, http://wiki.services.openoffice.org/wiki/Documentation/BASIC_Guide. If LO has a site, then point to it. If LO does not have a site, then leave the OOo site. My guess is that this was simply a global text search and replace. [note to self, try to not do this, then I would look really silly]. Note, on closer inspection, at least four links have been incorrectly set by this. Oh, I see another in Table 1 on page 18.

I found the very last text a bit amusing for this chapter:

Printed and eBook materials
The following books are available for download:

And then, nothing is listed. Just a wee bit amusing. Unclear what should go there, but, some of the previous links may be useful.

The screen shots showing OpenOffice.org macros rather than Libreoffice macros in screen shots of the macro organizer are probably fine, but, they are wrong. Lots of work to fix those... One example is Figure 6.

A glaring omission in the document is that it does not mention that LO requires that recording macros must be enabled (Tools > Options > LibreOffice > General and then check "Enable experimental (unstable) features). That is not required in OOo.

Any idea when the extensions library for LO will be online? It is referenced, but it takes you to a WIKI.

In retrospect, I should have just grabbed the ODT file, tracked changes, and started typing.... DUH! but I think that my computer time is finished for most of the rest of the evening.

Thanks for reporting these problems, Andrew.

Evidently the person who final-checked that file before publishing it
(probably me) did an unusually poor job. I will fix most of it, but I
may have to ask you questions about the screenshots.

I don't know about the timing of the LO extension library. I know it's
been under development for some time, but I don't know the latest info
about it.

--Jean

Andrew - thanks for the input.
Jean - if you need a hand with checking this I could help out a bit.
regards to you both
Martin

I will definitely take you up on that offer! In fact, if you wanted to
grab the file and make all the corrections Andrew noted and check on the
unclear things and fix the screenshots, I'm sure both he and I would be
delighted to have you do so. :wink:

P.S. thanks for all you work on the Draw Guide update! We couldn't have
done it without you.

Cheers, Jean

All,

...

> Any idea when the extensions library for LO will be online? It is
> referenced, but it takes you to a WIKI.

...

I don't know about the timing of the LO extension library. I know
it's been under development for some time, but I don't know the
latest info about it.

The new extensions repository[1] is still under development but will
probably soon replace[2] the wiki page.

[1] http://extensions2.libreoffice.org/
[2] http://listarchives.libreoffice.org/global/website/msg05737.html

Nino

Ok, downloaded the GS chapter from Signor Alfresco, printed it and will
look at it over the weekend.

regards
Martin

Excellent....

I can try to make the fixes myself this weekend if you desire. Screen shots might be a problem since I am on Fedora with the latest version of gnome. Unsure how to generate a screen shot that would match anything else. Probably not as obvious if I ignore the main window bar, however.

Slowly trying to plug-away at an updated version of OOME as well. There does not seem to be enough time in the day.

Did I mention that I do not like the LO color scheme? Something about the green feels very busy. Never felt that way about the blue in OOo. Odd. Nice twist for marking things such as tips, by the way. Off to work with me now.

Andrew, if you and/or Martin can do the job of updating the chapter,
that would be best. I really don't have time. Don't worry about matching
the appearance of screenshots, and as you say differences are less
obvious when you leave off the title bar.

--Jean

Hi :slight_smile:
Don't worry about screen-shots while editing text. It seems to be easier to do
all the screen-shots in one go and editing in a separate session. Perhaps
people are getting so good at it that they make it look easy. Either way don't
worry about it now.

Don't the Ubuntu themes work on Fedora?
http://wiki.documentfoundation.org/Documentation/Production#Sample_screenshots
Marc Pare managed to find something similar for Mageia so if you are desperate
you might have some luck too.

I love the green. It's rich, warm and friendly. I lived in a desert for quite
a while. After the rains things grow extremely fast and keep growing fast as
long as they can and then die under the merciless blue sky.

Back in England i had a weird feeling that i might get smothered by the greenery
here. I don't suppose you live in a desert?

Regards from
Tom :slight_smile:

Jean
I did the edit and uploaded the revised doc into the Documentation,
Getting Started Guide, Reviewed Folder, for wont of a better place to put
it.

I hope I picked up the ideas of Andrew ok.

regards
Martin

Thanks, Martin. A quick look suggests that a few links still need
correcting, and the contact email for the LO docs group is out of date
(as it is in all the chapters that were published before the list
addresses changed), but those are editorial details that I or someone
can deal with later, if Andrew doesn't catch them too.

I see you have done the figure updates as well as some text, so that's a
big help.

Andrew, over to you to see if Martin's got it right.

--Jean

Ummm, well, ummm. I do not have any access to the LO Alfresco stuff, so, if someone can send the file to me until I work out that little detail....

I'll set up an account for you and also send the file to you. Give me 10
minutes. --Jean

Jean
Regarding links:
I tested out the ones Andrew mentioned, plus some others, and if they did
not exist under libreoffice I reverted back to the ooo version.
Also a correction of one link (had an additional space in it :=), and
deletion of another where I got a 404).

I am testing out Natty/Unity on a laptop here, so I installed the silver
theme from our authors site to make the screenshots.

Glad if Andrew puts his imprimatur on it; I thought the subtitle should be
expanded to ".... and beyond" as it covers more detail than just the
recorder.

Ok, I missed the email address correction, sorry.

It was a nice little refresher on a few things for me as well.

I wonder what is next on the list? ;=)

kind regards from a grey rainy day here in Kanton Zug
Martin

Thanks, I have the file, and I logged in and changed my password.

Sorry to be a bother, but I do not know my way around well, and, I could not find the document that tells me how things should look, and, I do not want to change things if I am not sure that they should be done. So, where is the "do it this way" documentation? I am sorry for all the questions, but, this is my first LO document so I assume that the documents are as they should be and that everyone knows more than I.

For example:

QUESTION:
A newly inserted figure (that is nicely done, by the way), does NOT contain a caption and is not in a frame. My instinct is to add a caption and place the figure in a frame, because it looks like this is true for all other figures. My assumption is that either (1) there is a reason this does not need to be done like the others, (2) Martin forgot, (3) Martin did not know better, or, the most likely yet, (4) Martin did everything perfectly, and Jean pulled it out and removed the caption to test me :slight_smile:

QUESTION:
With OpenOffice.org, I always wrote OOo. For LibreOffice, should I use LibO rather than LO?

QUESTION:
In the document, I found new text that reads similar to:

click Tools → Options → LibreOffice → General and tick the box <Italics>Enable experimental (unstable) features</Italics>.

I expected to see:

use <OOoMenuPath>Tools → Options → LibreOffice → General</OOoMenuPath> and tick the box <OOoMenuPath>Enable experimental (unstable) features<OOoMenuPath>.

If I wanted Italics, I expected to use the <OOoEmphasis> style.

COMMENTS FOR MARTIN:

Martin, your new figures look great and it seems that you paid good attention to detail. I will change wording where it is not sufficiently precise; for example, when you state that the "Writer Library" is selected, it is really the Writer Module in the Martin Library. Without checking, my guess is that I introduced this error in the original.

Sorry to be a bother, but I do not know my way around well, and, I could
not find the document that tells me how things should look, and, I do
not want to change things if I am not sure that they should be done. So,
where is the "do it this way" documentation? I am sorry for all the
questions, but, this is my first LO document so I assume that the
documents are as they should be and that everyone knows more than I.

The "Documentation Contributors' Guide" is still being written. The
existing chapters are in two places: on the wiki (linked from this page)
http://wiki.documentfoundation.org/Documentation/Development#First_steps_with_the_Documentation_team

and on Alfresco under English Content > Documentation > Resources, where
you will also find the current chapter template (don't get the book
template by mistake; there are some differences).

Ignore the chapter titled "Using LibreOffice's Alfresco website" as it
is very out of date and bears only occasional resemblance to the current
website; David will update it when he finished tweaking the current
site.

For example:

QUESTION:
A newly inserted figure (that is nicely done, by the way), does NOT
contain a caption and is not in a frame. My instinct is to add a caption
and place the figure in a frame, because it looks like this is true for
all other figures. My assumption is that either (1) there is a reason
this does not need to be done like the others, (2) Martin forgot, (3)
Martin did not know better, or, the most likely yet, (4) Martin did
everything perfectly, and Jean pulled it out and removed the caption to
test me :slight_smile:

Not this time! I haven't touched the file. However, to answer the
question, figure captions are not always necessary (this is discussed in
one or another of the chapters of the Contributors' Guide) but in the
case most likely Martin forgot.

QUESTION:
With OpenOffice.org, I always wrote OOo. For LibreOffice, should I use
LibO rather than LO?

We have been avoiding using an abbreviation, as there has been no real
consensus about what abbreviation to use. Some books, such as the
Getting Started guide, were done before we had sorted out some of the
consistency issues, so you'll find it both internally inconsistent and
not consistent with some of the other books. This will get sorted out in
time.

QUESTION:
In the document, I found new text that reads similar to:

click Tools → Options → LibreOffice → General and tick the box

<Italics>Enable experimental (unstable) features</Italics>.

I expected to see:

use <OOoMenuPath>Tools → Options → LibreOffice → General</OOoMenuPath>
and tick the box <OOoMenuPath>Enable experimental (unstable)
features<OOoMenuPath>.

You are correct. But we don't use "tick the box"; in this case I would
say "...and select the <OOoMenuPath>Enable experimental (unstable)

features<OOoMenuPath> option.

If I wanted Italics, I expected to use the <OOoEmphasis> style.

That is correct.

COMMENTS FOR MARTIN:

Martin, your new figures look great and it seems that you paid good
attention to detail. I will change wording where it is not sufficiently
precise; for example, when you state that the "Writer Library" is
selected, it is really the Writer Module in the Martin Library. Without
checking, my guess is that I introduced this error in the original.

Thanks, Andrew!

--Jean

Not this time! I haven't touched the file. However, to answer the
question, figure captions are not always necessary (this is discussed in
one or another of the chapters of the Contributors' Guide) but in the
case most likely Martin forgot.

(or it was too late at night....)

> If I wanted Italics, I expected to use the <OOoEmphasis> style.

That is correct.

>
> COMMENTS FOR MARTIN:
>
> Martin, your new figures look great and it seems that you paid good
> attention to detail. I will change wording where it is not
> sufficiently precise; for example, when you state that the "Writer
> Library" is selected, it is really the Writer Module in the Martin
> Library. Without checking, my guess is that I introduced this error in
> the original.

Thanks, Andrew!

--Jean

Thanks to both of you for picking up stuff which I either overlooked or
was not aware of.... Sorry for any confusion.

And thanks for pointing out the Module/Library wording Andrew.

Any errors in the document are I guess now mine!!!! *gr*

I often tell my MD that I found his "obvious mistake" in letters or
reports he gets me to proof - in this case I did not put any of those in!

kind regards
Martin