Hello, this is not directly related to django, but I'm pretty sure
someone could help me here.
I'm building a complex Web site using Django of course, and I have to
start the documentation this week.
I'd like some suggestions about this.
I want to make the documentation available through the web and a PDF
file. Ususally I use OpenOffice for this task, because I don't need
publish on the web.
I think OO is not the best option here because it's not easy
synchronize the OO document with the web.
I've been looking for alternatives, and I found three:
These anotations are not 100% real, I've been looking only for a few
hours documentation about them, I don't know all the features of each
system yet.
* DocBook:
- Pros: Export to html and PDF
- Cons: Complex and complicated, exporting would require a lot of
work in the templates
* rest2web:
- Pros: Simple
- Cons: No PDF exporting
* Trac:
- Pros: I already use Trac for the tickets, and the wiki is very
usefull
- Cons: No PDF exporting.
What would you recommend me? I'm thinking about DocBook, but I'm
reluctant because is complicated and I don't know if I can easily
create a good template for the web and PDF and a combination of OO and
Trac would be hard to maintain as it need to be synchronized.
Thank you.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Django users" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/django-users?hl=en
-~----------~----~----~----~------~----~------~--~---
