RSS/Atom feed Twitter
Site is read-only, email is disabled

Fwd: Documentation language, HTML gen

This discussion is connected to the gimp-docs-list.gnome.org mailing list which is provided by the GIMP developers and not related to gimpusers.com.

This is a read-only list on gimpusers.com so this discussion thread is read-only, too.

3 of 3 messages available
Toggle history

Please log in to manage your subscriptions.

Fwd: Documentation language, HTML gen "Bortny 18 Aug 12:43
  Fwd: Documentation language, HTML gen Marco Ciampa 18 Aug 13:14
   Fwd: Documentation language, HTML gen "Bortny 18 Aug 15:51
"Bortny
2011-08-18 12:43:23 UTC (over 13 years ago)

Fwd: Documentation language, HTML gen

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
Marco Ciampa
2011-08-18 13:14:14 UTC (over 13 years ago)

Fwd: Documentation language, HTML gen

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
"Bortny
2011-08-18 15:51:22 UTC (over 13 years ago)

Fwd: Documentation language, HTML gen

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