Re: [asciidoc-discuss] asciidoc titles format
Dag Wieers wrote: > On Sun, 4 Feb 2007, Stuart Rackham wrote: > >> Dag Wieers wrote: >> >>> I always liked the way asciidoc did titles by putting a line under them. >>> Nevertheless the '= title' way of doing it is incompatible with most >>> wiki's syntax. A title in wiki's is usually '= title ='. >>> >>> Would it be possible to allow both, so that asciidoc is compatible with >>> both ways of doing it ? >> I'm not familiar with the trailing ='s syntax, is it a common Wiki >> convention? It would be easy to make trailing ='s optional i.e. the >> following would be equivalent: >> >> == My Title >> == My Title == >> >> Is this what you're suggesting? > > Yes. MoinMoin apparently uses it and looking at the wikimatrix.org > website, you see others use that as well. (DokuWiki, Giki, IkeWiki, > JAMWiki, miniWiki, MoniWiki, OpenWikiNG, etc, etc...). There are more who > do the trailing = than not. > > And since it's so easy to allow it... OK, I've implemented this for the next release. > > >>> Frankly, I don't know what the rationale is for doing it like this. >> I had a couple of requests for this (you either like it or hate it), the >> actual syntax follows the Ruby RDoc documentation format. > > That's fine. If you look at wikimatrix.org, it's scary how much different > syntaxes people invented for essentially the same thing :) > > If the syntax would be replacable in wiki's and one could hook up asciidoc > in place of the internal parser. Now that would be useful. > > Kind regards, > -- dag wieers, [EMAIL PROTECTED], http://dag.wieers.com/ -- > [all I want is a warm bed and a kind word and unlimited power] > Cheers, Stuart ___ Asciidoc-discuss mailing list [email protected] http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss
Re: [asciidoc-discuss] asciidoc titles format
On Sun, 4 Feb 2007, Stuart Rackham wrote: > Dag Wieers wrote: > > > I always liked the way asciidoc did titles by putting a line under them. > > Nevertheless the '= title' way of doing it is incompatible with most > > wiki's syntax. A title in wiki's is usually '= title ='. > > > > Would it be possible to allow both, so that asciidoc is compatible with > > both ways of doing it ? > > I'm not familiar with the trailing ='s syntax, is it a common Wiki > convention? It would be easy to make trailing ='s optional i.e. the > following would be equivalent: > > == My Title > == My Title == > > Is this what you're suggesting? Yes. MoinMoin apparently uses it and looking at the wikimatrix.org website, you see others use that as well. (DokuWiki, Giki, IkeWiki, JAMWiki, miniWiki, MoniWiki, OpenWikiNG, etc, etc...). There are more who do the trailing = than not. And since it's so easy to allow it... > > Frankly, I don't know what the rationale is for doing it like this. > > I had a couple of requests for this (you either like it or hate it), the > actual syntax follows the Ruby RDoc documentation format. That's fine. If you look at wikimatrix.org, it's scary how much different syntaxes people invented for essentially the same thing :) If the syntax would be replacable in wiki's and one could hook up asciidoc in place of the internal parser. Now that would be useful. Kind regards, -- dag wieers, [EMAIL PROTECTED], http://dag.wieers.com/ -- [all I want is a warm bed and a kind word and unlimited power] ___ Asciidoc-discuss mailing list [email protected] http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss
Re: [asciidoc-discuss] asciidoc titles format
Dag Wieers wrote: > Hi, > > I always liked the way asciidoc did titles by putting a line under them. > Nevertheless the '= title' way of doing it is incompatible with most > wiki's syntax. A title in wiki's is usually '= title ='. > > Would it be possible to allow both, so that asciidoc is compatible with > both ways of doing it ? I'm not familiar with the trailing ='s syntax, is it a common Wiki convention? It would be easy to make trailing ='s optional i.e. the following would be equivalent: == My Title == My Title == Is this what you're suggesting? > > Frankly, I don't know what the rationale is for doing it like this. I had a couple of requests for this (you either like it or hate it), the actual syntax follows the Ruby RDoc documentation format. > > Kind regards, > -- dag wieers, [EMAIL PROTECTED], http://dag.wieers.com/ -- > [all I want is a warm bed and a kind word and unlimited power] > > ___ > Asciidoc-discuss mailing list > [email protected] > http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss > Cheers, Stuart ___ Asciidoc-discuss mailing list [email protected] http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss
