[Gimp-user] Gimp Manual format.

2009-06-18 Thread John Culleton
Is the Gimp online manual also available in another format? 
Currently I am printing out the html pages a small batch at a time.
That's a tedious process.  A printed version or even a version in a 
single electronic file would save a lot of time.  A printed and 
bound  version would be  handier to use than a ring binder of 8.5 x 
11 pages.   Once I printed out the 880 pages of the Kylander Manual  
but that dated back to version 1 or thereabouts.  That was as I 
recall in a single file.  Therefore I could print it out using poor 
man's duplexing,  (even pages first, then reload the paper stack 
and print odds.) 
-- 
John Culleton
Create Book Covers with Scribus/e-book $5.95
http://www.booklocker.com/books/4055.html
___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user


Re: [Gimp-user] Gimp Manual format.

2009-06-18 Thread Michaela Baulderstone
I agree! A PDF version would be fantastic
Anyone interested in the job?

-Original Message-
From: gimp-user-boun...@lists.xcf.berkeley.edu
[mailto:gimp-user-boun...@lists.xcf.berkeley.edu] On Behalf Of John Culleton
Sent: Thursday, 18 June 2009 11:36 PM
To: Gimp-user@lists.xcf.berkeley.edu
Subject: [Gimp-user] Gimp Manual format.


Is the Gimp online manual also available in another format? 
Currently I am printing out the html pages a small batch at a time.
That's a tedious process.  A printed version or even a version in a 
single electronic file would save a lot of time.  A printed and 
bound  version would be  handier to use than a ring binder of 8.5 x 
11 pages.   Once I printed out the 880 pages of the Kylander Manual  
but that dated back to version 1 or thereabouts.  That was as I 
recall in a single file.  Therefore I could print it out using poor 
man's duplexing,  (even pages first, then reload the paper stack 
and print odds.) 
-- 
John Culleton
Create Book Covers with Scribus/e-book $5.95
http://www.booklocker.com/books/4055.html
___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user


___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user


Re: [Gimp-user] Gimp Manual format.

2009-06-18 Thread Jay Smith
 -Original Message-
 From: gimp-user-boun...@lists.xcf.berkeley.edu
 [mailto:gimp-user-boun...@lists.xcf.berkeley.edu] On Behalf Of John Culleton
 Sent: Thursday, 18 June 2009 11:36 PM
 To: Gimp-user@lists.xcf.berkeley.edu
 Subject: [Gimp-user] Gimp Manual format.
 
 
 Is the Gimp online manual also available in another format? 
 Currently I am printing out the html pages a small batch at a time.
 That's a tedious process.  A printed version or even a version in a 
 single electronic file would save a lot of time.  A printed and 
 bound  version would be  handier to use than a ring binder of 8.5 x 
 11 pages.   Once I printed out the 880 pages of the Kylander Manual  
 but that dated back to version 1 or thereabouts.  That was as I 
 recall in a single file.  Therefore I could print it out using poor 
 man's duplexing,  (even pages first, then reload the paper stack 
 and print odds.) 

On 06/18/2009 10:40 AM, Michaela Baulderstone wrote:
 I agree! A PDF version would be fantastic
 Anyone interested in the job?


I know nothing of the workflow that results in the current HTML manual
format.  It would seem to me that producing one or more other formats
should come out of that same workflow.  I cannot imagine the labor would
be justified to do a one-time-only current-state PDF version that would
be almost instantly out of date.  That probably means that the authoring
 workflow and environment needs to be considered.  This type of
documentation is one of the prime beneficiaries of single-source,
multiple-output authoring tools.  I have not kept up on the current
state of those tools and I am especially not aware of their status and
capabilities in the open-source arena.  However, I do know that there
are a variety of approaches, each with their strengths and weaknesses.

Jay
___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user


Re: [Gimp-user] Gimp Manual format.

2009-06-18 Thread DJ
Hi,

 Is the Gimp online manual also available in another format?
 Currently I am printing out the html pages a small batch at a time.
 That's a tedious process.  A printed version or even a version in a
 ...

This might be cheaper than paper, ink, electricity, your time, and a
potential option:

GIMP User Manual: GNU Image Manipulation Program : Photo Retouching,
Image Composition and Image Authoring (Paperback)
by GIMP DocumentationTeam (Author), $30.05
http://www.amazon.com/GIMP-User-Manual-Manipulation-Composition/dp/1441419322/


 ..

 I agree! A PDF version would be fantastic

This was from the Gimp FAQ:
 http://www.gimp.org/docs/userfaq.html#Manual
 Is there a user manual?
 Yes. It is available in HTML form, and in PDF.

But it seems the PDF is 2.4, not 2.6.

 I know nothing of the workflow that results in the current HTML manual
 format.  It would seem to me that producing one or more other formats
 should come out of that same workflow.  I cannot imagine the labor would

I'm in the same boat, so I hope I'm stepping lightly.

There are tools on Linux to convert from various formats. And Windows
too. I'm think'n download the documentation, or it might already be
installed as part of Gimp's help, and run it through one of these
tools to create a PDF format from html.

For the raw Gimp documentation, I'd just like to mention Asciidoc. It
allows you to write documents in text and process them (python) into
html, docbook, pdf, and more. I've followed the google support list
and there was a thread about an author using it for an OReilly book,
who also created a web site. If it would help, in any fashion, the
link is: http://www.methods.co.nz/asciidoc/

-- 
__ 
DJ   


___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user


Re: [Gimp-user] Gimp Manual format.

2009-06-18 Thread John Culleton
On Thursday 18 June 2009 11:05:44 am Jay Smith wrote:
  -Original Message-
  From: gimp-user-boun...@lists.xcf.berkeley.edu
  [mailto:gimp-user-boun...@lists.xcf.berkeley.edu] On Behalf Of
  John Culleton Sent: Thursday, 18 June 2009 11:36 PM
  To: Gimp-user@lists.xcf.berkeley.edu
  Subject: [Gimp-user] Gimp Manual format.
 
 
  Is the Gimp online manual also available in another format?
  Currently I am printing out the html pages a small batch at a
  time. That's a tedious process.  A printed version or even a
  version in a single electronic file would save a lot of time. 
  A printed and bound  version would be  handier to use than a
  ring binder of 8.5 x 11 pages.   Once I printed out the 880
  pages of the Kylander Manual but that dated back to version 1
  or thereabouts.  That was as I recall in a single file. 
  Therefore I could print it out using poor man's duplexing, 
  (even pages first, then reload the paper stack and print odds.)

 On 06/18/2009 10:40 AM, Michaela Baulderstone wrote:
  I agree! A PDF version would be fantastic
  Anyone interested in the job?

 I know nothing of the workflow that results in the current HTML
 manual format.  It would seem to me that producing one or more
 other formats should come out of that same workflow.  I cannot
 imagine the labor would be justified to do a one-time-only
 current-state PDF version that would be almost instantly out of
 date.  That probably means that the authoring workflow and
 environment needs to be considered.  This type of documentation
 is one of the prime beneficiaries of single-source,
 multiple-output authoring tools.  I have not kept up on the
 current state of those tools and I am especially not aware of
 their status and capabilities in the open-source arena.  However,
 I do know that there are a variety of approaches, each with their
 strengths and weaknesses.

 Jay
 ___
 Gimp-user mailing list
 Gimp-user@lists.XCF.Berkeley.EDU
 https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user

All manuals are out of date. The fact that a manual is instantly 
updateable does not guarantee that all sections will be fully 
updated concurrently with the latest stable Gimp.  There are only 
so  many skilled hands to do it.  In terms of paper books I work 
primarily from _Grokking the Gimp_ (2000) and the newer but sill 
obsolete _Artist's Guide to Gimp Effects_ (2007).  The html manual 
is the most up to date best we have at the  moment, and represents 
a huge work effort on the part of many people. 

But even within its present constraints the html manual can be 
improved by renaming the html files for the beginning  section 
covered in numeric order. Some are named that way but most are not. 
One segment of Chapter 3, six segments of chapter 5 and two each 
for chapters 11 and 12 are so named.  The rest have descriptive 
names. 

An index would also help. 
-- 
John Culleton
Create Book Covers with Scribus/e-book $5.95
http://www.booklocker.com/books/4055.html
___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user


Re: [Gimp-user] Gimp Manual format.

2009-06-18 Thread Sven Neumann
Hi,


On Thu, 2009-06-18 at 10:05 -0400, John Culleton wrote:
 Is the Gimp online manual also available in another format?

That's a question for the gimp-docs mailing-list.


Sven


___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user


Re: [Gimp-user] Gimp Manual format.

2009-06-18 Thread Sven Neumann
Hi,

On Thu, 2009-06-18 at 17:17 -0400, John Culleton wrote:

 An index would also help. 

What's wrong with http://docs.gimp.org/2.6/en/gimp-help-index.html ?


Sven


___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user


Re: [Gimp-user] Gimp Manual format.

2009-06-18 Thread Sven Neumann
Hi,

On Thu, 2009-06-18 at 11:05 -0400, Jay Smith wrote:

 I know nothing of the workflow that results in the current HTML manual
 format.  It would seem to me that producing one or more other formats
 should come out of that same workflow.

Indeed. The manual is written in Docbook/XML and you can get a variety
of output formats from that source. If you checkout the gimp-help-2
repository from git.gnome.org (I suggest to do a shallow clone due to
the immense size of the project), then you will get the Docbook/XML
sources, the images and a build system that spits out HTML and
optionally PDF or ODF.

Here's what I did to get a PDF version of the english user manual:

 git clone --depth=0 git://git.gnome.org/gimp-help-2
 cd gimp-help-2
 ./autogen.sh
 LINGUAS=en make
 LINGUAS=en make pdf-local

And to check the result:

 pdfinfo pdf/en/gimp.pdf 

Title:  GNU Image Manipulation Program
Subject:
Keywords:   
Author: 
Creator:DBLaTeX-0.2.10-1
Producer:   pdfTeX-1.40.3
CreationDate:   Thu Jun 18 23:57:05 2009
ModDate:Thu Jun 18 23:57:05 2009
Tagged: no
Pages:  849
Encrypted:  no
Page size:  595.276 x 841.89 pts (A4)
File size:  39395416 bytes
Optimized:  no
PDF version:1.4


Sven


___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user


Re: [Gimp-user] Gimp Manual format.

2009-06-18 Thread Ken Warner
http://html-pdf-converter.com/
PDF Converter, HTML to PDF Converter For Free

Michaela Baulderstone wrote:
 I agree! A PDF version would be fantastic
 Anyone interested in the job?
 
 -Original Message-
 From: gimp-user-boun...@lists.xcf.berkeley.edu
 [mailto:gimp-user-boun...@lists.xcf.berkeley.edu] On Behalf Of John Culleton
 Sent: Thursday, 18 June 2009 11:36 PM
 To: Gimp-user@lists.xcf.berkeley.edu
 Subject: [Gimp-user] Gimp Manual format.
 
 
 Is the Gimp online manual also available in another format? 
 Currently I am printing out the html pages a small batch at a time.
 That's a tedious process.  A printed version or even a version in a 
 single electronic file would save a lot of time.  A printed and 
 bound  version would be  handier to use than a ring binder of 8.5 x 
 11 pages.   Once I printed out the 880 pages of the Kylander Manual  
 but that dated back to version 1 or thereabouts.  That was as I 
 recall in a single file.  Therefore I could print it out using poor 
 man's duplexing,  (even pages first, then reload the paper stack 
 and print odds.) 
___
Gimp-user mailing list
Gimp-user@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-user