Creating headers might be easy, but it's painful to manage indentation of paragraphs in large documents. The MoinMoin syntax for headers is better: it simply adds "=" before and after the header. Want a subsection? Add "==", instead. Headers in RestructuredText are even worse; it requires many keystokes to enter exactly the same amount of characters as the text of the header. The MoinMoinMarkup looks very promising, if only I could make it work...


comments:

(new) Headers in StructuredText --Simon Michael, Mon, 15 Mar 2004 23:07:01 -0800 reply
Tip: you only need to indent the first line following an STX heading.

well, its definitely not intuitive -- Mon, 22 Mar 2004 00:59:21 -0800 reply
well, i really think asciidoc sucks too. (favorite right now is txt2tags). str.txt. requires :

could be more intuitive. I think for intutive, it should be analogous to how people write (format) a text document, what comes natural. What does most people do? I think many:

The header things is not as clearcut. But I have never seen anyone format a header by indenting the paragraph after it (except of course, the ones that also insert one or more linefeeds). Usual things that people do is either surround the line they want as a header with equal signs, dashes or asterisks or just put some on the left side.

Once you get used to it it's ok, and you stop questioning. But if you try some others and keep a open mind I think that there are some problems with how it works today and there is definitely room for improvement, in order to truly make it intuitive. mawi

Other wiki like formatings.. -- Mon, 29 Mar 2004 15:47:02 -0800 reply
I will agree structured text isn't intuiive. One i found more intuitive (maybe because I've used it a lot) is the swiki formating. As a comment take a look at the swiki formatting rules. http://minnow.cc.gatech.edu/swiki Maybe something good would be adding a new formating option for swiki like formationg?

Go MediaWiki? -- Sun, 13 Feb 2005 10:30:58 -0800 reply
Syntax is quite good and everybody ist used to it, because of Wikipedia. I really would prefer a Wiki in Zope, but people just don't understand this structured text thing. it's a nice idea in theory, but for wiki it sucks.

what we really need are an intermediate format the pages a re stored which can be transformed to different wiki markups.

and CamelCase sucks too -- Sun, 13 Feb 2005 10:32:42 -0800 reply
really!!!!!!

Go MediaWiki? --Bob McElrath?, Sun, 13 Feb 2005 15:53:12 -0800 reply
It does no good to bitch about stx. There are literally hundreds of text markup languages. ZWiki provides stx, moinmoin, wikiwikiweb, html, and reStructuredText. I have a textile plugin if anyone wants that. If you want a MediaWiki? plugin, write one.

P.S. you don't have to use CamelCase either, you can use [square brackets].

StructuredText DOES suck. -- Fri, 18 Feb 2005 18:18:12 -0800 reply
Bob, I would LOVE to have your textile plugin.