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

[Yuri Chornoivan]

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

> On Tuesday 02 August 2011 6:03:41 AM Yuri Chornoivan wrote:
>> написане 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 will ask the build system folks to make one, if possible.
>
> What would be the meinproc4 command to make pdf output?

This feature is not implemented in current meinproc4 (too many  
dependencies to produce high-quality PDF with TeX: full pdfLaTeX  
installation, kdestyle.sty, logo, etc.). xmlto and direct jadeTeX results,  
mmm... very unpleasant. ;)

Maybe buildpdf system can be integrated somehow with meinproc4 as  
soft-dependency?