On Thu, 13 Sep 2018 at 17:37, Richard JE Cooke
<[email protected]> wrote:
>
> Thanks for the reply.  I wasn't aware there were different versions.  How 
> would you show round brackets in the Python one please?

I'm not sure you can change them in the Python version.  Back when I
was at school the Harvard rules used [] but clearly its changed since
then (its been a while :) .

>
> Is there a list somewhere of other versions?  Or better, a canonical language 
> description that all versions support?

The Asciidoc Python implementation was the first implementation of
Asciidoc.  This is the ML for that implementation, so its called the
Asciidoc ML since that was the only version at the time, I guess the
developer saw no point in including the implementation language in the
title.

The Asciidoc implementation in Python 2 is basically in end of life as
Python 2 will EOL 2019.  And the original developer has retired.
Asciidoctor was developed to address some use-cases that a Python
implementation can't (github rendering for example) and has now become
the main implementation for day to day use, in my case because its way
faster.  If you are just starting its the one to use at this time.

As always with active projects new ideas and extensions come up.  To
its great credit, Asciidoctor placed significant emphasis on being
able to process old Asciidoc documents in compatibility mode, whilst
still looking forward.  There is also a Python 3 port of the Python 2
implementation which is fairly new but seems to be working fine.

There is an awareness in the community that whilst multiple
implementations are good, we don't want to get into a markdown
situation, where everybody had his own version (and in markdowns case
their cats and dogs had their own versions too).  It is intended to
develop an implementation independent definition for the Asciidoc
markup language, it just needs effort to be available to do it.  But
how much of the presentational things like references in brackets that
will cover is not yet considered.

>
> Also, what makes you think this is a Python group?  I can't see anything 
> about Python in the group description or name.

See above.

Cheers
Lex
>
>
>
> On Thursday, September 13, 2018 at 12:41:30 AM UTC+2, Lex Trotman wrote:
>>
>> Your link is to the Asciidoctor manual, this is the Asciidoc Python
>> list.  If you are using the Asciidoctor implementation it would be
>> best to ask on one of their communication channels
>> https://asciidoctor.org/ for a quick response, only a few
>> Asciidoctorists watch this list.
>>
>> Cheers
>> Lex
>> On Thu, 13 Sep 2018 at 04:09, Richard JE Cooke
>> <[email protected]> wrote:
>> >
>> > The manual here shows links as square brackets, but I need round for 
>> > Harvard citations. Is there a way to change this setting please?
>> >
>> > --
>> > 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 https://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 https://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 https://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/d/optout.

Reply via email to