Re: docutils/rST vs direct html

It also fits inline program documentation easier than direct HTML or 
many other types of markup.

Another plus is that the syntax rules are so easy, it is a low barrier 
for collaborators to contribute.

Another consideration is that HTML might not be the target output.

On 1/26/2014 3:50 PM, Roberto Alsina wrote:
> On 26/01/14 16:31, Malik Rumi wrote:
>> Hello all,
>>
>> This is my first post. I just joined because I was led here by the
>> instructions for getting admindocs working on django. I looked around,
>> followed some links, and think I learned a lot. But I do have a question.
>>
>> My question is, why is rST any better than just putting the text in a
>> text editor and marking it up with html directly? Why would you chose
>> to use rST (or any 'lightweight markup language') instead? And I ask
>> that in all serious, trying to understand, as opposed to tying to
>> cause controversy.
>>
>>
>> Thanks for enlightening this newby.
>>
>>
>
> +---------------------+-------------------------------+
> | This is a table.    | It's not a big table. but it's|
> |                     | mine.                         |
> +---------------------+-------------------------------+
>
> <table><tr><td>This is a table</td><td>It's not a big
> table but it's mine</td></tr></table>
>
> ------------------------------------------------------------------------------
> CenturyLink Cloud: The Leader in Enterprise Cloud Services.
> Learn Why More Businesses Are Choosing CenturyLink Cloud For
> Critical Workloads, Development Environments & Everything In Between.
> Get a Quote or Start a Free Trial Today.
> http://pubads.g.doubleclick.net/gampad/clk?id=119420431&iu=/4140/ostg.clktrk
> _______________________________________________
> Docutils-users mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>

-- 
----------------------------------------------------------
Pete R. Jemian, Ph.D.                <[email protected]>
Beam line Controls and Data Acquisition, Group Leader
Advanced Photon Source,   Argonne National Laboratory
Argonne, IL  60439                   630 - 252 - 3189
-----------------------------------------------------------
    Education is the one thing for which people
       are willing to pay yet not receive.
-----------------------------------------------------------



------------------------------------------------------------------------------
CenturyLink Cloud: The Leader in Enterprise Cloud Services.
Learn Why More Businesses Are Choosing CenturyLink Cloud For
Critical Workloads, Development Environments & Everything In Between.
Get a Quote or Start a Free Trial Today.
http://pubads.g.doubleclick.net/gampad/clk?id=119420431&iu=/4140/ostg.clktrk