Re: [libreoffice-documentation] Getting Started Guide for LO v5.0

2016-03-19 Thread Olivier Hallot
Hello Jean

I just uploaded the LO5.1 GS Preface in the 5.1 LO Draft folder. On
reading it, I noticed that under the FAQ section, the 1st question still
refers to LibreOffice 4.4.

Regards

Olivier

Em 04/03/2016 00:02, Jean Weber escreveu:
> I have now compiled and uploaded the ODT and PDF of the full book
> Getting Started Guide for LO v5.0, to both ODFAuthors and the
> Publications wiki. I'll soon add it to the get-help/docs page on the
> website.
> 
> I'm working on the print version and should have that published within
> a day or so and will add links to it from wiki and get-help/docs.
> 
> As soon as I've finished all that, I expect someone to find a major
> error or several. That's the way it usually works!
> 
> Cheers, Jean
> 

-- 
Olivier Hallot
Comunidade LibreOffice
http://ask.libreoffice.org/pt-br

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Fwd: [libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-29 Thread Jean Weber
Sorry, this was supposed to go to the list.


-- Forwarded message --
From: Jean Weber jeanwe...@gmail.com
Date: Fri, May 29, 2015 at 9:11 PM
Subject: Re: [libreoffice-documentation] Getting Started Guide for LO v5.0?
To: Milos Sramek msrame...@gmail.com


On Fri, May 29, 2015 at 5:48 PM, Milos Sramek msrame...@gmail.com wrote:
 On 2015-05-28 09:38, toki wrote:


 On 28/05/2015 07:20, Jean Weber wrote:

 Content updating should proceed using the new template so that the style 
 names of the new files are correct.


 This is when find and replace for character styles would be nice to
 have. OTOH, for the documentation I've been looking at, the writer has
 used direct formatting, and not character styles.

 Some time ago all guides used both character styles and lot of direct
 formatting. Because of translating, I have removed direct formatting
 from Getting Started and  also from the Writer Guide - so there should
 be no direct formatting now (unless something went wrong).

 I can do that also with other guides. It should be done in two steps:
 First manually replace direct formatting to style (e.g., search for the
 font weight attribute and then apply the OOOMenuPath or
 OOOStrongEmphasis style - according to context). Second, remove the
 remaining direct formatting (usually not visible an useful) by a script.

 Milos

When I put the files into the new template, changing the paragraph
styles to the new names was easy. I started changing the character
styles from OOoXX to the new names of the character styles, but I
did not do them all. So some chapters are a bit of a mess right now,
with some old character styles remaining, some changed to new names,
some with no style applied, and some manual character formatting.

I think that some of the places where we used character styles really
do not need to have any formatting applied, but that is a separate
discussion that I do not have the energy to pursue right now. Also,
there was some inconsistency in use: PeterS sometimes used italics for
items that I and others did not, for example the names of dialogs and
x-refs to chapter titles. Ideally we would make all this consistent,
but with limited resources it seems to me a lot more important to make
sure the content is up to date.

One of the chapters of the Contributors Guide, and/or the template
itself, lists what items should be in which character style. However,
I don't remember if those documents have been updated to cover the new
style names.

--Jean

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-28 Thread Alan Cook
So how do we find out what's new in v5.0? Just start working through a 
chapter from the old guide using 5.0 to see if anything doesn't work the 
same way?


On 5/27/2015 11:55 PM, Jean Weber wrote:

As you probably know, the next version of LibreOffice (due out in late
July) will be version 5.0. A Beta1 version is available; it is in
dev-configuration and will install alongside your existing LibreOffice
installation. (Beta2 is due out next week.)

https://wiki.documentfoundation.org/ReleasePlan/5.0#5.0.0_release
https://wiki.documentfoundation.org/ReleaseNotes/5.0

We really should publish at least the Getting Started Guide for v5.0
reasonably close to the time the program is released, don't you agree?

The most recent GS book is for v4.2. I had put all the chapters into a
new template in preparation for people to update content for v4.4; I
did a trivial amount of updating on a few chapters; PeterS and I
updated Chapter 9, but AFAIK nothing else ever got done.

At this point we should skip GS v4.4 and try to do a book for v5.0.
You could start with the chapters here (which are in the new template:
http://www.odfauthors.org/libreoffice/english/getting-started/draft-lo-4.4
Update them and return them to
http://www.odfauthors.org/libreoffice/english/getting-started/draft-lo-5.0
And be sure to put your initials and the date in the relevant boxes on
the Task List, so others know that you've checked out or returned a
chapter.
https://wiki.documentfoundation.org/Documentation/Development/UserGuideTasks#Getting_Started_Guide

If you need some guidance,
https://wiki.documentfoundation.org/Documentation/Development#First_steps_with_the_Documentation_team

And if you'd like to take over the role of leader, coordinator,
herder of cats for Documentation, *please* do so.

--Jean Weber




--
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-28 Thread toki
On 28/05/2015 13:38, Marcus Mackaku wrote:

 Why do we not rather create one standard template for all versions or that 
 can be used across all versions?

A little more than a decade ago, somebody, probably Jean, made a
template for OpenOffice.org Documentation. Over time, that template has
been modified, to fit current practices, and document output.

By way of example:
* In LibO4.4.draft.ott, the modifications made it easier to export
content to ePub format, with minimal presentation markup loss;
* The cover page was changed, when _The Document Foundation_ was created;
* I _think_ that the same template is used, with Apache branding, rather
than OOo or LibO branding. (I'm not sure about this, because the Apache
documentation does not cover the current version of AOO;


_Maak je mooiste werkstuk met LibreOffice Writer_ uses the lightly
modified _LibreOffice handleidingen_. Dutch (The Netherlands) is the
default language, rather that English (US).

The Base documentation in German uses an older version of the template,
with a minor modification -- German (Germany) as the default language,
rather than English (US).

Both of those documents use a different font than the current
LibO4.4.draft, but I don't know if that is because the fonts changed
with LibO4.4.draft, or if the the default fonts for English don't work
as well for Dutch and German text.

jonathon


-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-28 Thread Dave Barton
Alan Cook wrote:
 So how do we find out what's new in v5.0? Just start working through a
 chapter from the old guide using 5.0 to see if anything doesn't work the
 same way?

https://wiki.documentfoundation.org/ReleaseNotes/5.0




-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-28 Thread toki


On 28/05/2015 04:55, Jean Weber wrote:
 We really should publish at least the Getting Started Guide for v5.0
 reasonably close to the time the program is released, don't you agree?

Is the LO4.4 chapter template (draft) going to be the standard template
for LibO v5?

jonathon


-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-28 Thread toki


On 28/05/2015 07:20, Jean Weber wrote:

 Content updating should proceed using the new template so that the style 
 names of the new files are correct.

Thanks.

###

This is when find and replace for character styles would be nice to
have. OTOH, for the documentation I've been looking at, the writer has
used direct formatting, and not character styles.

jonathon




-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-28 Thread Marcus Mackaku
Why do we not rather create one standard template for all versions or that
can be used across all versions?

On Thu, May 28, 2015 at 9:38 AM, toki toki.kant...@gmail.com wrote:



 On 28/05/2015 07:20, Jean Weber wrote:

  Content updating should proceed using the new template so that the style
 names of the new files are correct.

 Thanks.

 ###

 This is when find and replace for character styles would be nice to
 have. OTOH, for the documentation I've been looking at, the writer has
 used direct formatting, and not character styles.

 jonathon




 --
 To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
 Problems?
 http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
 Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
 List archive: http://listarchives.libreoffice.org/global/documentation/
 All messages sent to this list will be publicly archived and cannot be
 deleted




-- 
Marcus Kgosi
marcuskg...@gmail.com

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


Re: [libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-28 Thread Dave Barton
Marcus Mackaku wrote:

 On Thu, May 28, 2015 at 9:38 AM, toki toki.kant...@gmail.com wrote:

 On 28/05/2015 07:20, Jean Weber wrote:

 Content updating should proceed using the new template so that the style
 names of the new files are correct.

 Thanks.

 ###

 This is when find and replace for character styles would be nice to
 have. OTOH, for the documentation I've been looking at, the writer has
 used direct formatting, and not character styles.

 jonathon

 Why do we not rather create one standard template for all versions or that
 can be used across all versions?

For many years we have used one standard template for all versions and
will continue to do so. The template referred to in this thread is a
much needed update of that original template. It is proposed that from
version 5 of the guides Jean's draft template should be applied to
updated and new chapters.

Dave



-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


[libreoffice-documentation] Getting Started Guide for LO v5.0?

2015-05-27 Thread Jean Weber
As you probably know, the next version of LibreOffice (due out in late
July) will be version 5.0. A Beta1 version is available; it is in
dev-configuration and will install alongside your existing LibreOffice
installation. (Beta2 is due out next week.)

https://wiki.documentfoundation.org/ReleasePlan/5.0#5.0.0_release
https://wiki.documentfoundation.org/ReleaseNotes/5.0

We really should publish at least the Getting Started Guide for v5.0
reasonably close to the time the program is released, don't you agree?

The most recent GS book is for v4.2. I had put all the chapters into a
new template in preparation for people to update content for v4.4; I
did a trivial amount of updating on a few chapters; PeterS and I
updated Chapter 9, but AFAIK nothing else ever got done.

At this point we should skip GS v4.4 and try to do a book for v5.0.
You could start with the chapters here (which are in the new template:
http://www.odfauthors.org/libreoffice/english/getting-started/draft-lo-4.4
Update them and return them to
http://www.odfauthors.org/libreoffice/english/getting-started/draft-lo-5.0
And be sure to put your initials and the date in the relevant boxes on
the Task List, so others know that you've checked out or returned a
chapter.
https://wiki.documentfoundation.org/Documentation/Development/UserGuideTasks#Getting_Started_Guide

If you need some guidance,
https://wiki.documentfoundation.org/Documentation/Development#First_steps_with_the_Documentation_team

And if you'd like to take over the role of leader, coordinator,
herder of cats for Documentation, *please* do so.

--Jean Weber

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted