On 24 November 2015 at 12:51, Dan Allen <[email protected]> wrote: > The "series of four or more repeated characters" is implemented in > Asciidoctor and I agree with that part. What I don't agree with is when the > ending delimiter is not congruent with the start delimiter. Allowing them to > differ is a bad practice in my opinion and congruency should be enforced. > This is no different than requiring balanced delimiters in programming > languages.
Not really a relevant comparison, no programming language delimiter is a sequence of the same character that has to be the same *length* to be a matching token. > I guess we can just agree to disagree about this. Asciidoctor is > not going to autofix malformed documents. > > If you're finding it too hard to match start to end delimiters, then I think > it's a sign that your delimiter lines are too long. That's exactly why I > strongly advocate for using 4 characters unless there is a good reason to > include more. Indeed I always use 4 :) But this enforcement does mean that an existing document may not process on asciidoctor, so the poor user who tried to generate the docs they just downloaded now has to make changes to something they know nothing about, just to get it to build. Document compatibility is not important for things that are regularly updated, for instance docs for a maintained software project, but it is extremely important for things that are not regularly/traditionally updated, like technical/scientific papers, isolated documents and books. The use-case of such documents combined with their longevity on the internet differs significantly from the software source model. The continuously updated model should not be applied to documents. This really surprised me because it seems to be a (maybe the only) blot on the otherwise exemplary compatibility of asciidoctor. Cheers Lex > > -Dan > > On Mon, Nov 23, 2015 at 3:01 PM, Lex Trotman <[email protected]> wrote: >> >> Sorry Dan, but what part of "(normally a series of four or more >> repeated characters)." did the Asciidoctor people not understand? >> Four or more, not the same. >> >> Now its certainly pretty if they are the same (at least if you can see >> them close together) but its a pain in the ass to ensure they are the >> same when they are not close together. >> >> Parsers should not enforce style suggestions, at most it should be a >> warning. >> >> Cheers >> Lex >> >> On 24 November 2015 at 06:18, Dan Allen <[email protected]> wrote: >> > >> > On Mon, Nov 23, 2015 at 1:08 PM, Manfred Moser >> > <[email protected]> >> > wrote: >> >> >> >> Your source also has to be a bit cleaner for asciidoc in terms of e.g. >> >> open and close sections for code using the same amount of dashes and so >> >> on. >> > >> > >> > Excellent point. Asciidoctor enforces that block delimiters be >> > equivalent. >> > Technically, this was understood because every example AsciiDoc document >> > in >> > AsciiDoc Python uses equivalent delimiters. We therefore considered it >> > to be >> > a bug in the parser that it was permitting the lengths to be different. >> > >> > -Dan >> > >> > >> > -- >> > Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen >> > >> > -- >> > You received this message because you are subscribed to the Google >> > Groups >> > "asciidoc" group. >> > To unsubscribe from this group and stop receiving emails from it, send >> > an >> > email to [email protected]. >> > To post to this group, send email to [email protected]. >> > Visit this group at http://groups.google.com/group/asciidoc. >> > For more options, visit https://groups.google.com/d/optout. >> >> -- >> You received this message because you are subscribed to the Google Groups >> "asciidoc" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To post to this group, send email to [email protected]. >> Visit this group at http://groups.google.com/group/asciidoc. >> For more options, visit https://groups.google.com/d/optout. > > > > > -- > Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen > > -- > You received this message because you are subscribed to the Google Groups > "asciidoc" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/asciidoc. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
