ntg-context - mailing list for ConTeXt users
 help / color / mirror / Atom feed
From: Aditya Mahajan <adityam@umich.edu>
To: Yatskovsky <yatskovsky@gmail.com>,
	 mailing list for ConTeXt users <ntg-context@ntg.nl>
Subject: Re: Software manual template request
Date: Mon, 31 Mar 2008 11:27:49 -0400 (EDT)	[thread overview]
Message-ID: <alpine.DEB.1.00.0803311124530.10612@nqv-yncgbc> (raw)
In-Reply-To: <1786062481.20080331025335@gmail.com>

On Mon, 31 Mar 2008, Vyatcheslav Yatskovsky wrote:

> Hello,
>
> Does anyone has a template for software manual? I have vague notion
> about how it should look like, but, well,  I'll know when I see it.
> ;o) Most modern manuals have common design elements; I wish I had
> an environment which captures the spirit.
>
> Needless to say, untouched LuaTex envinroment gives too much academic look.
>
> Can anyone kindly suggest something?

Most of the manuals of GNU software are written using texinfo. The 
advantage is that it is easy to get HTML and info output. There is also 
docbook, which offers some features for documenting code.

Both of them have fairly simple look, so it should be easy to create a 
ConTeXt module for them.

Aditya
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


  reply	other threads:[~2008-03-31 15:27 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <mailman.3960.1206900497.4340.ntg-context@ntg.nl>
2008-03-30 23:53 ` Vyatcheslav Yatskovsky
2008-03-31 15:27   ` Aditya Mahajan [this message]
2008-04-01  7:03     ` Taco Hoekwater
2008-04-01  8:18       ` luigi scarso

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=alpine.DEB.1.00.0803311124530.10612@nqv-yncgbc \
    --to=adityam@umich.edu \
    --cc=ntg-context@ntg.nl \
    --cc=yatskovsky@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).