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

[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  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

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

[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  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

[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  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."

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

[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

[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  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

[Clayton]

>> I am in a country with rather poor internet access, and ever since the
>> developer's guide moved to the wiki :
>>
>> 
>>
>>
>> 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

[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 :



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

[api-dev] Offline copy of Developers Guide

[ashok _]

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



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