Since it is embedded in natural language any syntax needs to be reasonably unique so it will not occur naturally in text and it must not clash with other existing syntax.
In my opinion none of the suggested alternatives to macro syntax sufficiently meets that criterion. [] are part of the macro syntax, () occur all the time in text (like this) and "" quoted text is another existing syntax. I don't agree with Dan about the order (who cares if it matches the HTML tag order, I'm trying to not know about the HTML :) and agree with your point about having the natural language first is more user friendly. But so far no suitable alternative to macro syntax has been proposed. Cheers Lex On 9 September 2014 08:53, Ondra Žižka <[email protected]> wrote: > Hi Dan, > > I may have rare PoV, but IMO being aligned with makros doesn't make it a > good syntax. > > Links are the most used elements in the document, and if done wrong, can > severely impair readability of the source text. > Using the link:{...} approach adds additional effort to thing that should be > trivial - linking. 95 % of links in normal docs just need a label and URL. > The label is what is important to make it readable, the URL is just data. > > Not having it as easy as possible demotivates people from linking, making > documentation worse. > > Hence I suggest to add support for alternative link syntax, which put the > text in front, and the human unreadable URL to the back. > > Thanks for considering. > Ondra > > > > On Saturday, September 6, 2014 9:52:08 AM UTC+2, Ondra Žižka wrote: >> >> Links currently look like: >> >> link:<URL>[Label] >> >> That is not much readable, esp. if the URL gets long. >> It would be nice if AsciiDoc could handle one of the common formats: >> >> "Label label":<URL> >> [Label|<URL>] >> [Label](<URL>) >> >> (sorted by my order of preference). >> >> Thanks for considering. >> Ondra > > -- > 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.
