Re: [api-dev] Offline copy of Developers Guide

2009-01-16 Thread ccornell - OpenOffice.org

On 01/15/09 18:29, Jason Cooper wrote:

Yea, I know. That's what I've been doing. An official, more easily
downloadable version would just be even nicer.

On 1/15/09, Clayton ccorn...@openoffice.org wrote:

Jason Cooper wrote:

I'm glad to hear that this is being worked on. I also have a need for an
offline version, since my workplace doesn't have internet access.

Don't forget that the tools are already in place on the Wiki for you to
make your own Collections of the chapters you need,.  You don't have to
wait on me to make the generic chapter versions.  You can already build
your own PDFs or ODT documents from the existing Wiki documents.



I would like to provide a static (and maybe even OOo branded) set of 
the core documents in PDF and ODT with each *major* version release. 
The contents won't be 100% up-to-date as time passes after the release, 
but it will be current with the OOo release they are linked to.  This is 
possible now, and I will aim at doing this for the OOo3.1 release.


C.
--
Clayton Cornell   ccorn...@openoffice.org
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany

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



Re: [api-dev] Offline copy of Developers Guide

2009-01-16 Thread Juergen Schmidt

ccornell - OpenOffice.org wrote:

On 01/15/09 18:29, Jason Cooper wrote:

Yea, I know. That's what I've been doing. An official, more easily
downloadable version would just be even nicer.

On 1/15/09, Clayton ccorn...@openoffice.org wrote:

Jason Cooper wrote:
I'm glad to hear that this is being worked on. I also have a need 
for an

offline version, since my workplace doesn't have internet access.

Don't forget that the tools are already in place on the Wiki for you to
make your own Collections of the chapters you need,.  You don't have to
wait on me to make the generic chapter versions.  You can already build
your own PDFs or ODT documents from the existing Wiki documents.



I would like to provide a static (and maybe even OOo branded) set of 
the core documents in PDF and ODT with each *major* version release. The 
contents won't be 100% up-to-date as time passes after the release, but 
it will be current with the OOo release they are linked to.  This is 
possible now, and I will aim at doing this for the OOo3.1 release.

thanks Clayton, that sounds really useful for all offline readers

Juergen



C.



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



[api-dev] Offline copy of Developers Guide

2009-01-15 Thread ashok _
I am in a country with rather poor internet access, and ever since the
developer's guide moved to the wiki :

http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/OpenOffice.org_Developers_Guide

I have had serious accessibility issues - earlier releases of the SDK
used to include a PDF copy of the developers guide, unfortunately this
PDF copy is still on OOo v2.3.

Is it possible to have a offline dump of the developer's guide wiki so
i can set it up locally  / or an updated pdf version so i can use it
locally ?

thanks

Ashok

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



Re: [api-dev] Offline copy of Developers Guide

2009-01-15 Thread Juergen Schmidt

ashok _ wrote:

I am in a country with rather poor internet access, and ever since the
developer's guide moved to the wiki :

http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/OpenOffice.org_Developers_Guide

I have had serious accessibility issues - earlier releases of the SDK
used to include a PDF copy of the developers guide, unfortunately this
PDF copy is still on OOo v2.3.

Is it possible to have a offline dump of the developer's guide wiki so
i can set it up locally  / or an updated pdf version so i can use it
locally ?
i don't know how good it is but you can try the following. You can 
create a PDF based on collections. The DevGuide provides predefined 
collections for all top level chapters.


For example
- click on First Steps
- move to the bottom
- click on download as PDF collection
- on the left side you will find Create a book
- click on Load Collection
- override existing collections if necessary or append  - play with it
- on the next page you will find on the right side a download button and 
before you click the download button select the PDF format

- this way you should be able to create PDF for each chapter

as i mentioned i don't know how good the quality is but as far as i know 
the documentation project is working on that.


Juergen




thanks

Ashok

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




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



Re: [api-dev] Offline copy of Developers Guide

2009-01-15 Thread Clayton
 I am in a country with rather poor internet access, and ever since the
 developer's guide moved to the wiki :

 http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/OpenOffice.org_Developers_Guide


 I have had serious accessibility issues - earlier releases of the SDK
 used to include a PDF copy of the developers guide, unfortunately this
 PDF copy is still on OOo v2.3.

 Is it possible to have a offline dump of the developer's guide wiki so
 i can set it up locally  / or an updated pdf version so i can use it
 locally ?
 i don't know how good it is but you can try the following. You can
 create a PDF based on collections. The DevGuide provides predefined
 collections for all top level chapters.
 
 For example
 - click on First Steps
 - move to the bottom
 - click on download as PDF collection
 - on the left side you will find Create a book
 - click on Load Collection
 - override existing collections if necessary or append  - play with it
 - on the next page you will find on the right side a download button and
 before you click the download button select the PDF format
 - this way you should be able to create PDF for each chapter
 
 as i mentioned i don't know how good the quality is but as far as i know
 the documentation project is working on that.

Yes, we are working on it.  The steps Juergen outlined will work for now.

The plan is to provide easy links for people to download individual
chapters as PDF and ODT, and possibly as an entire book (which would be
a huge single download).

The limitation is, the Collection is static.  This means that a
Collection that is valid today, is not going to be valid tomorrow
(people are adding and removing content all the time).  We need to find
a way to dynamically generate or respin the Collection once per week (or
some other schedule) so that the Collection picks up the changes in the
document structure.

So... immediate plan.  I have to finish up with the recent Wiki engine
update (some issues with the upgrade need to be taken care of first). I
will then start working on adding a Download as a Collection link to
the bottom of the FIRST PAGE in EACH chapter of the Developer's Guide.
You will be able to click this link and generate a PDF or ODT document
for the current chapter you are viewing.

Mid term - I will try to find a way (with some help from the community
here) to script things (using a cron job and the MediaWiki API?) to
auto-rebuild the Collections on some schedule to keep the Collections up
to date.  Manually maintaining the Collections for this large document
is not practical.

C.
-- 
Clayton Cornell   ccorn...@openoffice.org
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany

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



Re: [api-dev] Offline copy of Developers Guide

2009-01-15 Thread Jason Cooper
I'm glad to hear that this is being worked on. I also have a need for an
offline version, since my workplace doesn't have internet access.

Jason


On 1/15/09, Clayton ccorn...@openoffice.org wrote:

  I am in a country with rather poor internet access, and ever since the
  developer's guide moved to the wiki :
 
  
 http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/OpenOffice.org_Developers_Guide
 
 
 
  I have had serious accessibility issues - earlier releases of the SDK
  used to include a PDF copy of the developers guide, unfortunately this
  PDF copy is still on OOo v2.3.
 
  Is it possible to have a offline dump of the developer's guide wiki so
  i can set it up locally  / or an updated pdf version so i can use it
  locally ?
  i don't know how good it is but you can try the following. You can
  create a PDF based on collections. The DevGuide provides predefined
  collections for all top level chapters.
 
  For example
  - click on First Steps
  - move to the bottom
  - click on download as PDF collection
  - on the left side you will find Create a book
  - click on Load Collection
  - override existing collections if necessary or append  - play with it
  - on the next page you will find on the right side a download button and
  before you click the download button select the PDF format
  - this way you should be able to create PDF for each chapter
 
  as i mentioned i don't know how good the quality is but as far as i know
  the documentation project is working on that.

 Yes, we are working on it.  The steps Juergen outlined will work for now.

 The plan is to provide easy links for people to download individual
 chapters as PDF and ODT, and possibly as an entire book (which would be
 a huge single download).

 The limitation is, the Collection is static.  This means that a
 Collection that is valid today, is not going to be valid tomorrow
 (people are adding and removing content all the time).  We need to find
 a way to dynamically generate or respin the Collection once per week (or
 some other schedule) so that the Collection picks up the changes in the
 document structure.

 So... immediate plan.  I have to finish up with the recent Wiki engine
 update (some issues with the upgrade need to be taken care of first). I
 will then start working on adding a Download as a Collection link to
 the bottom of the FIRST PAGE in EACH chapter of the Developer's Guide.
 You will be able to click this link and generate a PDF or ODT document
 for the current chapter you are viewing.

 Mid term - I will try to find a way (with some help from the community
 here) to script things (using a cron job and the MediaWiki API?) to
 auto-rebuild the Collections on some schedule to keep the Collections up
 to date.  Manually maintaining the Collections for this large document
 is not practical.

 C.
 --
 Clayton Cornell   ccorn...@openoffice.org
 StarOffice - Sun Microsystems, Inc. - Hamburg, Germany

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




-- 
Cause I'm due for a miracle, I'm waiting for a sign,
I'll stare straight into the sun and I won't close my eyes,
Til I understand or go blind.


Re: [api-dev] Offline copy of Developers Guide

2009-01-15 Thread Clayton
Jason Cooper wrote:
 I'm glad to hear that this is being worked on. I also have a need for an
 offline version, since my workplace doesn't have internet access.

Don't forget that the tools are already in place on the Wiki for you to
make your own Collections of the chapters you need,.  You don't have to
wait on me to make the generic chapter versions.  You can already build
your own PDFs or ODT documents from the existing Wiki documents.

C.
-- 
Clayton Cornell   ccorn...@openoffice.org
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany

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



Re: [api-dev] Offline copy of Developers Guide

2009-01-15 Thread Jason Cooper
Yea, I know. That's what I've been doing. An official, more easily
downloadable version would just be even nicer.

On 1/15/09, Clayton ccorn...@openoffice.org wrote:

 Jason Cooper wrote:
  I'm glad to hear that this is being worked on. I also have a need for an
  offline version, since my workplace doesn't have internet access.

 Don't forget that the tools are already in place on the Wiki for you to
 make your own Collections of the chapters you need,.  You don't have to
 wait on me to make the generic chapter versions.  You can already build
 your own PDFs or ODT documents from the existing Wiki documents.

 C.
 --
 Clayton Cornell   ccorn...@openoffice.org
 StarOffice - Sun Microsystems, Inc. - Hamburg, Germany

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




-- 
Cause I'm due for a miracle, I'm waiting for a sign,
I'll stare straight into the sun and I won't close my eyes,
Til I understand or go blind.