develooper Front page | perl.module-authors | Postings from October 2021

Conversion text in documentation

Thread Next
Andrea Tosoni
October 26, 2021 17:57
Conversion text in documentation
Message ID:

I'm Andrea Tosoni.

Some years ago I started to write some perl scripts because I don't like to
re-made the same thing many times, especially when I have to write
documentation (I'm a hardware designer).

In these years, scripts have become perl modules that work almost fine.

I started from POD idea: merge code and documentation. I added the
possibility to load parameters from an external file or by constants
defined in my code (VHDL or Verilog or some other language). I can also
calculate fields and iterate on lists or similar basic programming
operations.The markup is very easy. Documentation can be split in many
source files without order and it's merged at the end.

I also added the possibility to load images (vectorial images for the
moment) and create tables.

Today my output is a Framemaker file (in my company it is the tool for
official documentation) but I think to add the possibility to export in
Latex (because I like) and Word (because I have to support it).

I don't know if these modules can help somebody else.

Today I have to rework to remove deprecated modules, increase test coverage
and add some missing functionalities and this can be the moment to
organize in official modules, if you think that can be useful.

Thank you for reading my mail.

Best regards,

                        Andrea Tosoni

Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About