You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cayenne.apache.org by "Thomas Bernhard (JIRA)" <de...@cayenne.apache.org> on 2007/10/26 18:54:50 UTC
[JIRA] Commented: (CAY-144) Documentation in PDF
[ https://issues.apache.org/cayenne/browse/CAY-144?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12567 ]
Thomas Bernhard commented on CAY-144:
-------------------------------------
Please reopen this issue.
Now that the docs are WIKI based, this PDF generation should be possible too.
It would be nice if each guide would be a PDF file:
Cayenne_Guide.pdf
Remote_Object_Persistence Guide.pdf
JPA_Guide.pdf
Modeler_Guide.pdf
Having nice PDFs would be a good replacement for the "missing" books.
> Documentation in PDF
> --------------------
>
> Key: CAY-144
> URL: https://issues.apache.org/cayenne/browse/CAY-144
> Project: Cayenne
> Issue Type: Improvement
> Components: Cayenne Documentation
> Affects Versions: 1.1 [LEGACY], 1.2 [STABLE]
> Reporter: Joe McDaniel
> Assignee: Andrus Adamchik
> Priority: Minor
>
> Getting a printed copy of the documentation is very painful -- there ought to be a .pdf version (or some other way) to print the whole document and to make it searchable.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
Re: [JIRA] Commented: (CAY-144) Documentation in PDF
Posted by Aristedes Maniatis <ar...@maniatis.org>.
On 27/10/2007, at 3:17 AM, Thomas Bernhard wrote:
> What about the authors of the WIKI?
> Confluence can't state that it can export nice PDF documents when they
> "leave much to be desired" :).
> I think there were even plug-ins for it to do various (PDF related
> too)
> issues.
Personally I can't see the real use for PDF when the html docs are
nicely interlinked and easy to read. However, if it is something
you'd like, then perhaps you could investigate some tools to convert
from html to pdf. That might be the best approach as it is would
utilise the style sheet work already done on the site.
Note that in the work done earlier this year on the web site included
style sheets specifically for printing. That's right, go and print
the front page of the Cayenne site and see how it turns out. Cool...
So perhaps you'd like to investigate some sort of xslt transform or
ghostscript process to get the pdfs you want. If you come up with
something that can be automated, I'm sure we'd find a way to have pdf
downloads available from the Cayenne site.
Cheers
Ari Maniatis
-------------------------->
Aristedes Maniatis
phone +61 2 9660 9700
PGP fingerprint 08 57 20 4B 80 69 59 E2 A9 BF 2D 48 C2 20 0C C8
Re: [JIRA] Commented: (CAY-144) Documentation in PDF
Posted by Thomas Bernhard <tb...@yahoo.com>.
Andrus Adamchik wrote:
>
> The formatting of the wiki export leaves much to be desired. I am all
> for providing PDF, but somebody needs to dedicate some time to figure
> out how to make it work.
>
What about the authors of the WIKI?
Confluence can't state that it can export nice PDF documents when they
"leave much to be desired" :).
I think there were even plug-ins for it to do various (PDF related too)
issues.
Tom.
--
View this message in context: http://www.nabble.com/-JIRA--Commented%3A-%28CAY-144%29-Documentation-in-PDF-tf4698539.html#a13431673
Sent from the Cayenne - Dev mailing list archive at Nabble.com.
Re: [JIRA] Commented: (CAY-144) Documentation in PDF
Posted by Andrus Adamchik <an...@objectstyle.org>.
The formatting of the wiki export leaves much to be desired. I am all
for providing PDF, but somebody needs to dedicate some time to figure
out how to make it work.
Andrus
On Oct 26, 2007, at 7:54 PM, Thomas Bernhard (JIRA) wrote:
> Thomas Bernhard commented on CAY-144:
> -------------------------------------
>
> Please reopen this issue.
> Now that the docs are WIKI based, this PDF generation should be
> possible too.
> It would be nice if each guide would be a PDF file:
> Cayenne_Guide.pdf
> Remote_Object_Persistence Guide.pdf
> JPA_Guide.pdf
> Modeler_Guide.pdf