Sent: 2011-08-18 12:43:23 UTC (9 months ago)

From: "Bortny

Fwd: Documentation language, HTML gen

permalink

Dear Documentators!

I like your HTML manuals, and I very often use GIMP. I'm working as a
system administrator, and I want to create manuals like yours (eg.
this http://docs.gimp.org/en/preface.html#gimp-team).

I'm looking for the (programming) language / standard / syntax
information of the manual pages, and that software, what can generate
these nice HTML pages.

Can you tell me these informations?

Thanks,
Bortnyák Roland
_______________________________________________
Gimp-docs mailing list
Gimp-docs@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs

Sent: 2011-08-18 13:14:14 UTC (9 months ago)

From: Marco Ciampa

Fwd: Documentation language, HTML gen

permalink

On Thu, Aug 18, 2011 at 02:43:23PM +0200, Bortnyák Roland wrote:
> Dear Documentators!
>
> I like your HTML manuals, and I very often use GIMP. I'm working as a
> system administrator, and I want to create manuals like yours (eg.
> this http://docs.gimp.org/en/preface.html#gimp-team).
>
> I'm looking for the (programming) language / standard / syntax
> information of the manual pages, and that software, what can generate
> these nice HTML pages.
>
> Can you tell me these informations?

This manual is a mix of different technologies.

xml-docbook - for the manual structure and HTML/PDF conversion
xml2po - for the internationalization of the doc
make (via autoconf/automake) - for the test/updated of the po files/compilation

Please note that this approach could be seen as trying to kill mosquitos
with a bazooka for any doc less than 100 pages...

There could be many other (easier) way to the same.

See google for markdown for an example, or you can consider using a wiki
(like mediawiki) with an pdf/epub plugin.

Your mileage may vary.

--

Marco Ciampa

+--------------------+
| Linux User #78271 |
| FSFE fellow #364 |
+--------------------+
_______________________________________________
Gimp-docs mailing list
Gimp-docs@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs

Sent: 2011-08-18 15:51:22 UTC (9 months ago)

From: "Bortny

Fwd: Documentation language, HTML gen

permalink

Thanks dear Marco! I see, that is not for short documentations. I'll
countinue using LibreOffice, then PDF exporting.

Roland

> This manual is a mix of different technologies.
>
> xml-docbook - for the manual structure and HTML/PDF conversion
> xml2po      - for the internationalization of the doc
> make (via autoconf/automake) - for the test/updated of the po files/compilation
>
> Please note that this approach could be seen as trying to kill mosquitos
> with a bazooka for any doc less than 100 pages...
>
> There could be many other (easier) way to the same.
>
> See google for markdown for an example, or you can consider using a wiki
> (like mediawiki) with an pdf/epub plugin.
>
> Your mileage may vary.
>
> Marco Ciampa
_______________________________________________
Gimp-docs mailing list
Gimp-docs@lists.XCF.Berkeley.EDU
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs