Re: [CMake] cmake manpage in pdf with section (subsection, etc) bookmarks and hyperlinks?

2012-08-13 Thread Eric Noulard
2012/8/13 Peng Yu :
>>   $ docbook2pdf cmake-help.docbook
>
> I got error message like the following on ubuntu.
>
> openjade:/home/pengy/cmake-help.docbook:13:14:E: end tag for
> "itemizedlist" which is not finished
> openjade:/home/pengy/cmake-help.docbook:21:14:E: end tag for
> "itemizedlist" which is not finished
> openjade:/home/pengy/cmake-help.docbook:30:14:E: end tag for
> "itemizedlist" which is not finished

Yes it looks like an itemizedlist should at least contain one "itemlist":
http://www.docbook.org/tdg/en/html/itemizedlist.html

When I manually fix this I get plenty more errors.


-- 
Erk
Le gouvernement représentatif n'est pas la démocratie --
http://www.le-message.org
--

Powered by www.kitware.com

Visit other Kitware open-source projects at 
http://www.kitware.com/opensource/opensource.html

Please keep messages on-topic and check the CMake FAQ at: 
http://www.cmake.org/Wiki/CMake_FAQ

Follow this link to subscribe/unsubscribe:
http://www.cmake.org/mailman/listinfo/cmake


Re: [CMake] cmake manpage in pdf with section (subsection, etc) bookmarks and hyperlinks?

2012-08-13 Thread Peng Yu
>   $ docbook2pdf cmake-help.docbook

I got error message like the following on ubuntu.

openjade:/home/pengy/cmake-help.docbook:13:14:E: end tag for
"itemizedlist" which is not finished
openjade:/home/pengy/cmake-help.docbook:21:14:E: end tag for
"itemizedlist" which is not finished
openjade:/home/pengy/cmake-help.docbook:30:14:E: end tag for
"itemizedlist" which is not finished

...


cmake version 2.8.5


-- 
Regards,
Peng
--

Powered by www.kitware.com

Visit other Kitware open-source projects at 
http://www.kitware.com/opensource/opensource.html

Please keep messages on-topic and check the CMake FAQ at: 
http://www.cmake.org/Wiki/CMake_FAQ

Follow this link to subscribe/unsubscribe:
http://www.cmake.org/mailman/listinfo/cmake


Re: [CMake] cmake manpage in pdf with section (subsection, etc) bookmarks and hyperlinks?

2012-08-13 Thread Michael Wild
On 08/13/2012 04:18 PM, Peng Yu wrote:
> Hi,
> 
> I use the following command to generate the pdf file from cmake
> manpage. But the pdf file does not have bookmarks. Does anybody know a
> way to generated the manual in pdf with bookmarks and possibly
> hyperlinks?
> 
> man -t "$f" | ps2pdf - > $f.pdf
> 
> 

Install dblatex and then run

cmake --help-full cmake-doc.docbook

to generate DocBook XML output which you then can process with your
favourite tool-chain (e.g. dblatex or the xmlto convenience wrapper).

However, it seems that the XML output does not validate (at least with
CMake 2.8.6 that is...). xmllint really chokes badly on it.

Michael
--

Powered by www.kitware.com

Visit other Kitware open-source projects at 
http://www.kitware.com/opensource/opensource.html

Please keep messages on-topic and check the CMake FAQ at: 
http://www.cmake.org/Wiki/CMake_FAQ

Follow this link to subscribe/unsubscribe:
http://www.cmake.org/mailman/listinfo/cmake


Re: [CMake] cmake manpage in pdf with section (subsection, etc) bookmarks and hyperlinks?

2012-08-13 Thread Eric Noulard
2012/8/13 Peng Yu :
> Hi,
>
> I use the following command to generate the pdf file from cmake
> manpage. But the pdf file does not have bookmarks. Does anybody know a
> way to generated the manual in pdf with bookmarks and possibly
> hyperlinks?
>
> man -t "$f" | ps2pdf - > $f.pdf

If you want to generate a single pdf, cmake itself can already generate:

html:
  $ cmake --help-full cmake-help.html
docbook:
  $ cmake --help-full cmake-help.docbook

Then you may try:
  $ htmldoc -f cmake-help.pdf --webpage cmake-help.html
or
  $ docbook2pdf cmake-help.docbook

the docbook version is upsetting my docbook processor (openjade)
with a lot of syntax error.
I don't really use docbook so I don't know who is the culprit
between openjade and the cmake generated docbook document.

The html version is processed correctly your have proper hyperlinks,
but you don't get PDF bookmarks.

-- 
Erk
Le gouvernement représentatif n'est pas la démocratie --
http://www.le-message.org
--

Powered by www.kitware.com

Visit other Kitware open-source projects at 
http://www.kitware.com/opensource/opensource.html

Please keep messages on-topic and check the CMake FAQ at: 
http://www.cmake.org/Wiki/CMake_FAQ

Follow this link to subscribe/unsubscribe:
http://www.cmake.org/mailman/listinfo/cmake


[CMake] cmake manpage in pdf with section (subsection, etc) bookmarks and hyperlinks?

2012-08-13 Thread Peng Yu
Hi,

I use the following command to generate the pdf file from cmake
manpage. But the pdf file does not have bookmarks. Does anybody know a
way to generated the manual in pdf with bookmarks and possibly
hyperlinks?

man -t "$f" | ps2pdf - > $f.pdf


-- 
Regards,
Peng
--

Powered by www.kitware.com

Visit other Kitware open-source projects at 
http://www.kitware.com/opensource/opensource.html

Please keep messages on-topic and check the CMake FAQ at: 
http://www.cmake.org/Wiki/CMake_FAQ

Follow this link to subscribe/unsubscribe:
http://www.cmake.org/mailman/listinfo/cmake