[kde-doc-english] Question on producing html and pdf versions of app manual

[Yuri Chornoivan]

написане Tue, 02 Aug 2011 03:49:49 +0300, Allen Winter <winter at kde.org>:

> On Monday 01 August 2011 5:08:11 PM Jack wrote:
>> About a year ago, one of the KMyMoney developers opened a bug
>> (https://bugs.kde.org/show_bug.cgi?id=245893) because the old automake
>> based build system apparently had a feature to generate HTML and PDF
>> versions of the manual, but the cmake version does not.  I know
>> meinproc4 can produce HTML output suitable for use as an online manual,
>> but I don't know of any easy way to create PDF or to create either as
>> part of the cmake process.  I'd appreciate any hints on either task.
>>
>
> if you pass -DKDE4_ENABLE_HTMLHANDBOOK=1 to cmake, then
> you'll get a make target generated called "htmlhandbook".
>
> then you should be able to run 'make htmlhandbook' in the docs/foo  
> subdirs.
> For example, cd kdepim/build/doc/korganizer; make htmlhandbook
> will generate the html for the KOrganizer handbook.
>
> something similar could be done for pdf output I suppose.

Hi!

Regretfully there is no PDF option in KDE4Macros.cmake.

I have managed to build PDF using the recipe by Burkhard Lück:

http://lists.kde.org/?l=kde-i18n-doc&m=131110974126121&w=2

The result can be found here:

http://ompldr.org/vOXEzZA/kmymoney46.pdf

But first some bugs should be fixed in KMyMoney docs.

1. Avoid using dot ( "." ) in file names. accwiz8.x.png should be renamed  
to something like accwiz8x.png (and details-accounts.docbook should be  
fixed accordingly).

2. To obtain proportional looking figures it is desirable to scale them  
all to 96 ppi. Script can be found here:  
http://websvn.kde.org/branches/work/doc/png-opt.sh?view=log

I have also tweaked enumerate list to make the PDF compilable by TeXLive  
2010 (maybe just my installation problem).

If someone needs step by step instructions I can give them.

Best regards,
Yuri