Re: [libreoffice-documentation] Need volunteer to compile Calc Guide

2011-05-24 Thread John Cleland

Hi Jean

Files uploaded to reviewed section.

What is the next priority.

Regards

John

-Original Message- 
From: Jean Hollis Weber

Sent: Saturday, May 21, 2011 10:18 PM
To: documentation@libreoffice.org
Subject: Re: [libreoffice-documentation] Need volunteer to compile Calc 
Guide


John,

Yesterday I moved all the Calc Guide chapters into Published, except for
Graphics (which is checked out), so you've got the right ones. Sorry
about the timing; wasn't thinking.

Yes, please upload the updated ODM, and the ODT and PDF files for the
book, into the Reviewed section. Thanks!

--Jean

On Sat, 2011-05-21 at 17:43 +0100, John Cleland wrote:

Hi Jean

The  review directory seems empty apart from the graphics in Calc chapter,
so I used the published chapters.  If this is correct.

I have followed the guide and updated the odm file and produced a PDF 
file.


Should I upload the files into the review section.

Thanks

John


-Original Message- 
From: Jean Weber

Sent: Thursday, May 12, 2011 12:10 PM
To: documentation@libreoffice.org
Subject: Re: [libreoffice-documentation] Need volunteer to compile Calc
Guide

You mean, other than in "Producing LibreOffice User Guides" in English
> Resources on Alfresco? No, I think that's it; I don't think I've got
anything more detailed. BTW, some of the early parts of "Producing..."
are important, especially the info about adjusting LibO memory
settings.

--Jean

On Thu, May 12, 2011 at 21:10, John Cleland  
wrote:

> Hi
>
> I am willing to do this.  Are there any instructions other than in the
> email.
>
> Regards
>
> John
>
> -Original message-
> From: Jean Hollis Weber 
> To: LibreOffice Documentation 
> Sent: Thu, 12 May 2011, 11:53:40 GMT+01:00
> Subject: [libreoffice-documentation] Need volunteer to compile Calc 
> Guide

>
> We need a volunteer to compile a full book from the Calc Guide chapters.
> If you wait for me to get to it, it might not appear for quite awhile
>
> The instructions are somewhere in "Producing LibreOffice User Guides" in
> English > Resources on Alfresco.
>
> The master document and all the chapters are in English > Documentation
>> Calc Guide > Reviewed.
>
> Anyone willing to give this a try? I'm available to answer questions.
> What we've done quite successfully at OOo is for someone to put the book
> together and then make a PDF "Release Candidate" of that book for others
> to check for things like incorrect cross-references (a legacy of some
> gremlin in the OOo chapters from which these are derived). So you won't
> be alone!
>
> --Jean
>




--
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be 
deleted 


--
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Need volunteer to compile Calc Guide

2011-05-24 Thread Jean Hollis Weber
On Tue, 2011-05-24 at 09:23 +0100, John Cleland wrote:
> Hi Jean
> 
> Files uploaded to reviewed section.
> 
> What is the next priority.
> 
> Regards
> 
> John

Thanks, John! However, I see only the PDF there, not the ODT. You did
make an ODT as well, didn't you?

Did you discover any problems with the cross-references after the book
was compiled? We have serious problems with incorrect x-refs in some
books but not in others.

Next priority is reviewing the Impress Guide. We need as many people
working on that as possible.

--Jean


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


[libreoffice-documentation] Intro: Shawn Beasley

2011-05-24 Thread Shawn Beasley
Dear Documentation Team,

I would love to help out any way I can, but I need some direction ;) I was 
thinking about contributing some user videos to go along with the 
documentation. Learning by reading, doing, and seeing is my philosophy. Anyway, 
if anyone is there that can discuss this with me, I would be more than pleased.

Although some videos are  rougher than others, please look at my channel for an 
example. http://www.youtube.com/user/diginin1974 I do three types of videos:

60 Second videos for short, and sometimes, important tips and tricks
3-5 Minute instructional videos
7-10 Minute promotional videos

The concept is simple, I would work with your (as a community service, of 
course) team to compose a CI wrapper that would always be the same. We would 
choose the topics, and get to work. I found youtube to be a great place for 
this, and would love to open an official channel for this puropse. Currently 
there are 1,130 results referencing LibreOffice. Very respectable. Gotta love 
your community :) Let me know if anyone is interested in working on this with 
me.

Love to hear from you,

Shawn Beasley a.k.a Dig"IT"al_Ninja/diginin
-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted



[libreoffice-documentation] PING John Cleland: Calc Guide

2011-05-24 Thread Jean Hollis Weber
John,
I've spotted some problems in the PDF of the Calc Guide. The copyright
page has not been updated to include all the Contributors' names, and
the individual chapters are showing their copyright pages and table of
contents pages, which are supposed to be suppressed. 

It's possible the fields that do the suppressing have been lost during
the rebranding process, but the guide name on the first pages of the
chapters is being suppressed, so there may be a different cause to the
other problem. Sometimes, for no reason I can determine, the copyright
and TOC pages don't get suppressed, so I have to manually remove them
once I've made an ODT of the full book.

A random check of some pages shows incorrect x-refs as well -- the bane
of our lives with these books.

--Jean




-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


[libreoffice-documentation] Re: PING John Cleland: Calc Guide (correction to previous note)

2011-05-24 Thread Jean Hollis Weber
Earlier, I wrote:
> ...The copyright page has not been updated to include all the Contributors' 
> names...

I now realise I'm wrong about that; sorry.

The other problems I mentioned definitely need fixing.

--Jean


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Need volunteer to compile Calc Guide

2011-05-24 Thread John Cleland
Hi

I uploaded 3 files odt odm and pdf but could not see any of them.  I assumed it 
was a moderation feature.  Will try again tonight

Regards 

John

Connected by MOTOBLURâ„¢

-Original message-
From: Jean Hollis Weber 
To: documentation@libreoffice.org
Sent: Tue, 24 May 2011, 09:36:56 GMT+01:00
Subject: Re: [libreoffice-documentation] Need volunteer to compile Calc Guide

On Tue, 2011-05-24 at 09:23 +0100, John Cleland wrote:
> Hi Jean
> 
> Files uploaded to reviewed section.
> 
> What is the next priority.
> 
> Regards
> 
> John

Thanks, John! However, I see only the PDF there, not the ODT. You did
make an ODT as well, didn't you?

Did you discover any problems with the cross-references after the book
was compiled? We have serious problems with incorrect x-refs in some
books but not in others.

Next priority is reviewing the Impress Guide. We need as many people
working on that as possible.

--Jean


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Need volunteer to compile Calc Guide

2011-05-24 Thread Jean Hollis Weber
On Tue, 2011-05-24 at 11:00 +0100, John Cleland wrote:
> Hi
> 
> I uploaded 3 files odt odm and pdf but could not see any of them.  I assumed 
> it was a moderation feature.  Will try again tonight
> 
> Regards 
> 
> John

The PDF is there; at least, I can see it. I don't know why the others
aren't showing up. I don't know much about how Alfresco works.

--Jean


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Need volunteer to compile Calc Guide

2011-05-24 Thread John Cleland

Hi Jean

Ok will try again tonight.

Will look at the manually remove the contents and copyright pages manually 
and look at how to add the fields back in the odm if they are missing.


Are there instructions on how to do this in the writer guide?

I looked at the links the previous time I compiled this and they seemed to 
work.  Will try again, if this does not work will edit the links manually in 
the odt file.


Regards


John

-Original Message- 
From: Jean Hollis Weber

Sent: Tuesday, May 24, 2011 11:09 AM
To: documentation@libreoffice.org
Subject: Re: [libreoffice-documentation] Need volunteer to compile Calc 
Guide


On Tue, 2011-05-24 at 11:00 +0100, John Cleland wrote:

Hi

I uploaded 3 files odt odm and pdf but could not see any of them.  I 
assumed it was a moderation feature.  Will try again tonight


Regards

John


The PDF is there; at least, I can see it. I don't know why the others
aren't showing up. I don't know much about how Alfresco works.

--Jean


--
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be 
deleted 


--
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Need volunteer to compile Calc Guide

2011-05-24 Thread Jean Hollis Weber
On Tue, 2011-05-24 at 11:19 +0100, John Cleland wrote:
> Hi Jean
> 
> Ok will try again tonight.
> 
> Will look at the manually remove the contents and copyright pages manually 
> and look at how to add the fields back in the odm if they are missing.
> 
> Are there instructions on how to do this in the writer guide?
> 
> I looked at the links the previous time I compiled this and they seemed to 
> work.  Will try again, if this does not work will edit the links manually in 
> the odt file.
> 
> Regards
> 
> 
> John
> 

There are instructions in the Writer Guide about the field and the
hidden sections, but you also need to know the contents of the field and
the condition statement. This is written up somewhere, but offhand I
can't remember where. In the book template, perhaps. Anyway, I'll add it
here:

The copyright and TOC pages are in sections controlled by a condition
statement MD!=0 that picks up from the first paragraph in the ODM an
invisible field named MD which is set to 1. This causes the section to
be hidden. Sometimes it fails, for no reason I can see.

First thing to check: go into Tools > Options > LibreOffice Writer >
Formatting Aids and make sure "Hidden text", "Fields: Hidden text" and
"Fields: Hidden paragraphs" are all UNticked. I can't recall if there
are any other options like that lurking somewhere.

BTW, I just opened the orginal ODM and updated all links, and the
copyright and TOC pages are hidden as they should be. 

The incorrect x-refs are scattered through the book; most x-refs are
correct, but some are not. It's a thorough pain to find and fix the
incorrect ones. I normally do this in the full-book ODT after unlinking
(embedding) all the chapter files, because I've found that fixing them
in the individual chapter files and then recompiling the book often
doesn't work -- some of the wretched x-refs go wrong again. I think a
bug may have been filed at OOo about this, but it's hard to reproduce
reliably, especially in a smallish sample file.

--Jean


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Anyone for the Open Help Conference?

2011-05-24 Thread Shaun McCance
On Wed, 2011-05-18 at 19:15 -0500, Jeremy Cartwright wrote:
> On Wed, 18 May 2011 16:52:32 +1000
> Jean Hollis Weber  wrote:
> 
> > Is there anyone on the team who would be able to attend this
> > conference on behalf of the LibreOffice Docs team?
> 
> I might be able to attend. I would be interested in learning more about
> what would be involved.

Hi Jeremy,

I'm the main organizer of the conference. The first day is
traditional presentations. There's still a presentation slot
available if you'd like to talk about LibreOffice (and you
get a free book from XML Press for speaking).

The second day is open discussions, plus an open collaboration
session where we can all get a hands-on experience with how
other open source teams work.

The conference has a focus on discussions. The presentations
are short, with long breaks. We want to encourage people to
talk to each other and share their experiences.

If you have any questions about the conference, let me know.

Thanks,
Shaun



-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Anyone for the Open Help Conference?

2011-05-24 Thread Jean Hollis Weber
On Tue, 2011-05-24 at 11:16 -0400, Shaun McCance wrote:
> On Wed, 2011-05-18 at 19:15 -0500, Jeremy Cartwright wrote:
> > On Wed, 18 May 2011 16:52:32 +1000
> > Jean Hollis Weber  wrote:
> > 
> > > Is there anyone on the team who would be able to attend this
> > > conference on behalf of the LibreOffice Docs team?
> > 
> > I might be able to attend. I would be interested in learning more about
> > what would be involved.
> 
> Hi Jeremy,
> 
> I'm the main organizer of the conference. The first day is
> traditional presentations. There's still a presentation slot
> available if you'd like to talk about LibreOffice (and you
> get a free book from XML Press for speaking).
> 
> The second day is open discussions, plus an open collaboration
> session where we can all get a hands-on experience with how
> other open source teams work.
> 
> The conference has a focus on discussions. The presentations
> are short, with long breaks. We want to encourage people to
> talk to each other and share their experiences.
> 
> If you have any questions about the conference, let me know.
> 
> Thanks,
> Shaun

Shaun, thanks for the info. The conference sounds great, and something I
would love to attend myself if I lived in North America.

Unfortunately, Jeremy advised me yesterday that he is now unable to
attend the conference.

--Jean




-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Impress Guide Reviwing`

2011-05-24 Thread Chad Lines
Just FYI, I'm reviewing the first Chapter of the Impress Guide
(0501IG3-IntroducingImpress.odt). I'm not able to check it out because of
permissions issues in Alfresco, but I've already contacted Dave about it,
and I'm sure it will be cleared up pretty quick. But since I'm not able to
check it out at this time, I thought I'd give everyone a heads up. :)

On Mon, May 23, 2011 at 8:12 PM, Chad Lines  wrote:

> Thanks for the clarification, Jean. I have read the document on producing
> user guides, and intend to reference it constantly through my first few
> reviews.
>
>
>
>
>
>
>
>
>
>
>
>
> On Mon, May 23, 2011 at 1:19 PM, Jean Hollis Weber wrote:
>
>> On Mon, 2011-05-23 at 09:58 -0700, Chad Lines wrote:
>> > Good Morning Everyone,
>> >
>> > I noticed that the Impress Guide has a lot of drafts and no reviews.
>> Being
>> > new, I thought that this might be a good place to get started but I
>> wanted
>> > to make sure that I'm not going to be infringing on work that anyone
>> else is
>> > doing with that guide. If anyone has any comments, concerns, objections,
>> > suggestions, etc. please let me know! Also, I'm interested in how long
>> > reviewing is generally expected to take, just so I have some reference,
>> so
>> > if anyone wouldn't mind giving me just a rough estimate, it would be
>> very
>> > much appreciated!
>> >
>> > Thanks everyone! I'm very excited to be working on this with you all!
>>
>>
>> Chad, it's great to have you on the team. When someone is working on a
>> chapter, they are supposed to check it out so it shows a "working copy"
>> in the Drafts folder. Any chapter not checked out is available for
>> someone to review.
>>
>> Most chapters of the Impress Guide need in-depth reviewing for accuracy
>> and usability. The main question at this point is: do the instructions
>> (originally written for OOo Impress) work with LibreOffice Impress? Are
>> there any features in LibO but not in OOo that are relevant to this
>> chapter and need to be written about (bearing in mind that we don't try
>> to cover everything). And even when things are complete and correct, the
>> screenshots may be out of date.
>>
>> How long is reviewing expected to take? That depends a lot on the
>> chapter and how much work is involved in following the instructions to
>> see if they work. My guess is a first pass through a typical chapter can
>> take anywhere from 1 to 8 hours, perhaps more if a lot of recapturing
>> and/or relabelling of screenshots is involved. BTW, if you are unable to
>> redo pictures, that's okay; just flag the ones that need work and
>> someone else will do them. Obviously, if you've only got an hour or two
>> a day to work on this, then it could take a week to finish a chapter.
>>
>> If life intervenes and it looks like you won't be able to finish within
>> a week, please upload what you've done, even if you keep the file
>> checked out, and let us know that you've been delayed. Or check it back
>> in and say you're unable to finish it within a reasonable time. This
>> happens to all of us.
>>
>> I assume you've read the document on producing LibO user guides (found
>> in Resources), which describes what to do or not do when reviewing,
>> creating and inserting graphics, and so on.
>>
>> --Jean
>>
>>
>>
>>
>> --
>> Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
>> Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
>> List archive: http://listarchives.libreoffice.org/www/documentation/
>> All messages sent to this list will be publicly archived and cannot be
>> deleted
>>
>
>

-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted



Re: [libreoffice-documentation] Intro: Shawn Beasley

2011-05-24 Thread Jean Hollis Weber
On Tue, 2011-05-24 at 11:09 +0200, Shawn Beasley wrote:
> Dear Documentation Team,
> 
> I would love to help out any way I can, but I need some direction ;) I was 
> thinking about contributing some user videos to go along with the 
> documentation. Learning by reading, doing, and seeing is my philosophy. 
> Anyway, if anyone is there that can discuss this with me, I would be more 
> than pleased.
> 
> Although some videos are  rougher than others, please look at my channel for 
> an example. http://www.youtube.com/user/diginin1974 I do three types of 
> videos:
> 
> 60 Second videos for short, and sometimes, important tips and tricks
> 3-5 Minute instructional videos
> 7-10 Minute promotional videos
> 
> The concept is simple, I would work with your (as a community service, of 
> course) team to compose a CI wrapper that would always be the same. We would 
> choose the topics, and get to work. I found youtube to be a great place for 
> this, and would love to open an official channel for this puropse. Currently 
> there are 1,130 results referencing LibreOffice. Very respectable. Gotta love 
> your community :) Let me know if anyone is interested in working on this with 
> me.
> 
> Love to hear from you,
> 
> Shawn Beasley a.k.a Dig"IT"al_Ninja/diginin

Shawn,

I'm sure many others will agree with me when I say we would very much
like to have user videos about LibO, to go along with the written
documentation. I would like to be involved, but unfortunately I don't
have the time to do more than comment on proposals, if that. I hope some
of the other team members have the time and interest to work with you.
We can also advertise on some of the other lists, where we might find
some more people who are keen on videos but have not joined the Docs
team.

--Jean


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Intro: Shawn Beasley

2011-05-24 Thread Shawn Beasley
Jean,

Thanks for the reply.

On May 25, 2011, at 4:40 , Jean Hollis Weber wrote:

>> ...
>> The concept is simple, I would work with your (as a community service, of 
>> course) team to compose a CI wrapper that would always be the same. We would 
>> choose the topics, and get to work. I found youtube to be a great place for 
>> this, and would love to open an official channel for this puropse. Currently 
>> there are 1,130 results referencing LibreOffice. Very respectable. Gotta 
>> love your community :) Let me know if anyone is interested in working on 
>> this with me.
>> 
> ...
> I'm sure many others will agree with me when I say we would very much
> like to have user videos about LibO, to go along with the written
> documentation. I would like to be involved, but unfortunately I don't
> have the time to do more than comment on proposals, if that. I hope some
> of the other team members have the time and interest to work with you.
> We can also advertise on some of the other lists, where we might find
> some more people who are keen on videos but have not joined the Docs
> team.

Just keep me in mind. In the mean time I will look at the documentation and see 
if I can pick some subject matter out myself. We can then review this on the 
list to discuss how things are working out for everyone, and get opinions about 
things to do better :) When we have a small team, then we can work on the 
branding. Until then.

///shawn
-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted



Re: [libreoffice-documentation] Impress Guide Image Rebranding

2011-05-24 Thread Jean Hollis Weber
On Fri, 2011-05-20 at 02:27 -0600, Elliot Turner wrote:
> Not only did I mess up on the table, I'm looking at the numbering and for
> some reason the documents have merged all number lists into one massive
> number list. I'm so sorry this happened. I'll go back and fix them.
> Hopefully, I'll figure out what I did wrong.


None of the Impress Guide files are checked out, so I'm assuming you're
working on something else at the moment. I've just done some work on
Chapter 7 and will continue through the others, unless I hear from you
differently. I sure hope I'm not duplicating something you're doing!

--Jean


-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted