Re: Conversion text in documentation

Hi Andrea!

On Mon, 25 Oct 2021 21:41:21 +0200
Andrea Tosoni <[email protected]> wrote:

> Hello,
>=20
> I'm Andrea Tosoni.
>=20
> 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).
>=20
> In these years, scripts have become perl modules that work almost fine.
>=20

I read your message, but I don't understand what you wish to ask. What is t=
he
dilemma?=20

> 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.
>=20
> I also added the possibility to load images (vectorial images for the
> moment) and create tables.
>=20
> 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).
>=20
> I don't know if these modules can help somebody else.
>=20
> Today I have to rework to remove deprecated modules, increase test covera=
ge
> and add some missing functionalities and this can be the moment to
> organize in official modules, if you think that can be useful.
>=20
> Thank you for reading my mail.
>=20
> Best regards,
>=20
>                         Andrea Tosoni



--=20

Shlomi Fish       https://www.shlomifish.org/
https://shlomifishswiki.branchable.com/Self-Sufficiency/

Chuck Norris killed all the members of the Spanish Inquisition, so they won=
=E2=80=99t
come unexpectedly.
    =E2=80=94 http://www.shlomifish.org/humour/bits/facts/Chuck-Norris/

Please reply to list if it's a mailing list post - https://shlom.in/reply .