PDF version

[Gerard]

At the moment we have an HTML version of the Quick Guide, but just wondering, is there a need of any other formats as well?

Do you guys think we should have a PDF and/or CHM format as well? Or is 1 version (HTML) sufficient?

[jvanessen]

If it is one page of HTML text, its not neccesary, if multiple pages then one PDF file is easy for printing or viewing. not CHM.... ODF is more in style of the pioneers :)

[dracheflieger]

Adobe has released the PDF specs to AIIM for ISO adoption (http://www.linux-watch.com/news/NS7542722606.html)

[Charles]

Here's the HTML version for the record: http://docs.pcbsd.org/guide/
I think this is enough and better than PDF, if we wanted another version, .chm would be cool, but I think it's not necessary. Having to maintain 2 or 3 different versions is not ideal either. Just my personal opinion :wink:

[TerryP]

as long as it embedds in konqi, thus HTML is fine but a PDF or single html page version would be nice for download (off the site). For people not using PC-BSD & wanting to read the QG.

[fgibbs]

Hi All,

As a member of the Documentation Team, I'd be glad to assist if you all agree that the addition of a PDF version would be beneficial. Where I understand the maintenance of more than one document might be more time-consuming, I volunteer to maintain this formatted version as changes are made to the HTML version: all I would need to know would be the specifics of the change(s). And I agree, for those of us on and off line frequently, a quick download of one document would make for leisurely reading and editing while travelling.

Please let me know your thoughts and I'll defer the final decision to Charles, Gerard, and Company. Cheers-

Fred

[dracheflieger]

A good addition for someone not yet having installed the OS

[Gerard]

OK, we'll maintain a .PDF version as well then

[Tommy89]

maybe nice a PDF documentation....so i can study it everywhere :D

[TerryP]

A 'Single HTML file' would be better.

PDF Readers are not even included out of the box on Windows machines unless its done by your systems vendor (Dell, Getaway e.t.c.)

[Charles]

I agree, I'd like a Word version as well, and also a DocBook version. An Excel and a PNG version would be cool too :P :D

[Dingens]

I agree, I'd like a Word version as well, and also a DocBook version. An Excel and a PNG version would be cool too :P :D :P

[TerryP]

Why not just use a given 'Standard Format' for the source. And use software to convert it to desired format foo ?

So, write one copy, generate a few others in diff formats.


I'd suggest ether GNU Textinfo (info) or Dockbook because you can geenrate other formats easy. Basically your choice of Notepad or HTML style writing it.

Textinfo can make: plain text, info, HTML, DVI, PDF, XML and DocBook.

DocBook can intern be used to create: HTML, PDF, man pages and HTML Help files.