Hi: To transform multiple documents to a single document, wouldn't the easiest method be putting it in a .zip or tarball?
Anyway, I looked into doing something like this, and personally am leaning toward XML if doing this in the future. I think it would be best if you simply translate documents to some sort of internal Perl object representation, with Parser modules, then have a way to convert those Perl objects back to other documents. But that's probably just because of my recent work with SQL::Translator, that works by doing just that. Good luck! Cheers, Jonathan On Fri, Jan 9, 2009 at 7:36 PM, nadim khemir <[email protected]> wrote: > Hi, I have a little idea for a module and I'd like to get your input. > > When I run a project, be it a single perl module or full scale project with > tens of modules and lots of documentation (user manual, requirements, > analysis and design documents, ...) I always have a problem with structuring > the documents together. The documents themselfs are no problems, only how > they refere to each other and how to navigate in the structure. > > I've used wikis in the passed with various degrees of success depending on the > setup and size of the project. > > Lately, I've been using git much more and I'm trying to have the projects self > contained. This eliminates wikis that are too often have their own version > control and keep things in a specific database and needs a server setup. > > I have looked at other type of wikis of wich Ikiwiki was close to what I want > but not really the right thing. > > I believe that what is needed is just a way to structure the documents > together and have a presentation layer. It might be useful to have the > possibility to modify those documents through a wiki interface but that's not > my main goal. > > My idea is to create set of module to: > > - search in the current project documents to be aggregated > - apply a set of filters, eg: transform a DB to a txt file or multiple files > in a single file > - create the aggregation structure > - render the structure in a specific format, HTML, PDF, ... > > If you have used the excellent > http://search.cpan.org/~lyokato/Pod-ProjectDocs-0.36/bin/pod2projdocs, I want > to do the same thing but on any document that might be relevant. > > Some of the documents will be written in wiki description language and I plan > to support multiple languages (through the filters). > > What do you think about this idea? > Is there already something out there? > Would you like to join this project? > What would you like to see in it? > > Cheers, Nadim. > > > > > > > > >
