After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 317406 - Printable tutorial would be useful.
Printable tutorial would be useful.
Status: RESOLVED FIXED
Product: gtkmm
Classification: Bindings
Component: reference documentation
2.6.x
Other All
: Normal trivial
: ---
Assigned To: gtkmm-forge
gtkmm-forge
Depends on:
Blocks:
 
 
Reported: 2005-09-28 08:12 UTC by Bartek Kostrzewa
Modified: 2007-06-06 16:18 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Bartek Kostrzewa 2005-09-28 08:12:14 UTC 
It would be very useful to have access to a printable version of the tutorial
either as a single-page html file or a pdf or ps file. Working on one screen the
documentation is very tiresome as it requires switching workspaces or
applications all the time while doing the examples. If I had any idea how to use
the xml file to create a single file book I'd do it myself. (I've spent one hour
now looking for appropriate documentation but I couldn't find any, sorry.)
Comment 1 Murray Cumming 2005-09-29 10:18:35 UTC 
Yes, it would be nice.
Comment 2 Murray Cumming 2005-11-10 08:24:56 UTC 
There's a thing called docbook-utils-pdf, though I haven't tried using it. It
would be nice if you could experiment with that, and maybe create a patch to
make gtkmm's build create a pdf when it creates the html.
Comment 3 Jonathon Jongsma 2005-12-07 05:18:48 UTC 
I'm looking into this a little bit.  I've gotten a pdf built from the docbook
tutorial source, but it needs quite a bit of work before it's of acceptable
quality.  There are several places where code samples or screenshot images are
too wide for the page and just get chopped at the edge of the page.  Also, the
links are displayed in the pdf, but the paths don't make any sense in a book
format (e.g. ../../../examples/book/input).
I'm using the docbook2pdf utility to convert to pdf, but docbook2pdf complains
about XIncludes in the XML file so I've had to process it with `xmllint
--xinclude` to do the inclusions before running it through docbook2pdf.  The pdf
is currently ~265 pages and 1.4MB
Comment 4 Murray Cumming 2005-12-19 09:33:50 UTC 
I suggest that you contact the gnome-doc people on one of their mailing lists if you need help. This should be a fairly generic GNOME documentation system issue.
Comment 5 Jonathon Jongsma 2007-06-06 16:18:44 UTC 
I've committed preliminary support for this now.  The output is not perfect, but it is now possible to generate a PDF of the tutorial by simply typing `make pdf`.  The pdf is not yet built by default because it is not perfect and it takes quite a long time to build.  If there are issues with the generated PDF (e.g. lines too long, pages split at weird places, etc), we should probably open new bugs to get those issues fixed.  Closing this bug.