[Typo3-typo3org] documentation.typo3.org
Michael Scharkow
mscharkow at gmx.net
Thu Apr 14 09:25:08 CEST 2005
Robert Lemke wrote:
>
> In my opinion we should find a solution for the documentation site with OO.org
> as the source and if that works, like Peter K. said, maybe in 1 year from
> now, we can maybe switch to DocBook.
Okay, let's leave docbook for the sake of argument, because as Mathias
pointed out, we might not need it at all.
> The question which remains always when we think about a combination of tools
> like timtaw, DocBook and the Documents Suite is: What format is capable of
> handling all our needs? Just imagine these examples workflows / situations:
>
> - Write a manual in Open Office, upload to TYPO3.org, the TDR converts it to
> PDF and HTML
This is ugly (because most likely it involves having oo on the server)
but can be done without too much hassle. +1 from me
> - Edit an existing manual in the backend by editing ordinary content
> elements, export to Open Office and DocBook
This is really my main issue: 1. Who needs this? Why rewrite Openoffice
in TYPO3? We don't write our extensions in T3, why should we write docs
this way?
> - Import content from a MS Word file into the TYPO3 page tree, edit one
> chapter in the frontend by using the timtaw wiki, export the document
> into PDF and MS Word
This sucks as well. I don't expect this to work reliably given the
almost endless possibilities to screw up a word (or oowriter) file. And
this would require a complete interchange format which works in *both*
directions.
> - Write a manual by using the (non-existing) DocBook Editor Backend Module,
> export to HTML, PDF and some custom XML by using XSLT
There's probably a good reason why nobody has written a docbook online
*editor* ;)
> There are many ways to work with documents and my never answered question
> since a two years now is: What format should we use internally so we don't
> loose the semantics while converting between the different formats we need?
My answer: There is none, and it will be a lot of work to create one
which can be spent better IMHO.
> I still think that the combination of Documents Suite, timtaw, TYPO3 BE
> editing and DocBook is a killer feature - if we find an interchange format.
> Maybe it's some XML application like the OASIS Open Office 2.0? DocBook?
I think this is mainly killing developers' time. Sorry.
Greetings,
Michael
More information about the TYPO3-team-typo3org
mailing list