[DG: Open Forum] Favorite Markup Language

[Steven Githens]

Sometimes I don't mind writing HTML for simple docs ( I used to use 
docbook, and that was way more painful ).  But I suppose HTML can mean a 
lot of things.  If you were going to roll a set of documentation with 
just HTML what stack of tools would you use?  I think the usage of even 
more than a couple HTML editors would mangle the documents with their 
own conventions. 

Usually, if you use Markdown or Restructured Text, in addition to the 
syntax it brings along the toolchain ( for example using Sphinx with 
Restructured Text ).  So I guess, it's a core markup plus a set of nice 
tools to make tables of contents and stuff too, although for this use 
case I was imagining a text editor being the authoring tool across the 
examples.

-s


Nate Angell wrote:
> I like this markup syntax called "HTML"...it's pretty widely used and
> there are some tools out there to help you use it.
>
> --
> Nate Angell
> Client Evangelist
>
> On Mon, Apr 26, 2010 at 10:15 AM, Steven Githens <swgithen at mtu.edu> wrote:
>   
>> Hi all,
>>
>> Just curious what you're favorite markup/wiki/formatting syntax is.
>> Markdown? Creole? Restructured Text? LaTeX?  Something else?  The
>> context here is mostly for writing instructions and technical
>> documentation for open source software.
>>
>> I've been using Restructured Text for my personal projects, and am
>> thinking about switching to Markdown or something similar.
>>
>> DISCUSS!
>>
>> Cheers,
>> Steve
>> _______________________________________________
>> openforum mailing list
>> openforum at collab.sakaiproject.org
>> http://collab.sakaiproject.org/mailman/listinfo/openforum
>>
>> TO UNSUBSCRIBE: send email to openforum-unsubscribe at collab.sakaiproject.org with a subject of "unsubscribe"
>>
>>