On the matter of the topic at hand, I definitely support the idea of a
reified TOC for AsciiDoc Python. I've never understood why the TOC was done
in JavaScript, which is why I reified it in Asciidoctor.

-Dan

On Fri, Feb 12, 2016 at 9:41 PM, Dan Allen <[email protected]> wrote:

> Hi Keith!
>
> I'm thrilled to see AsciiDoc getting a run at the Linux documentation.
> Super cool.
>
> I'm curious why you're considering AsciiDoc Python instead of Asciidoctor.
> AsciiDoc Python served as the reference implementation for Asciidoctor, but
> for the most part has moved in maintenance mode for existing users.
> Asciidoctor is where AsciiDoc continues to evolve and supports many new
> features over the Python processor, one of whic is a reified TOC. It's also
> roughly 100x faster than AsciiDoc Python.
>
> Granted, Asciidoctor does not run on Python. The core is implemented in
> Ruby, though the same codebase is also available for JavaScript/Node as
> Asciidoctor.js and Java as AsciidoctorJ. It can also run on JRuby without
> AsciidoctorJ. (I'd like to eventually see an Asciidoctor.py, but we're not
> at that stage yet).
>
> If you have any questions with Asciidoctor, I encourage you to post to the
> Asciidoctor list. http://discuss.asciidoctor.org/
>
> Cheers,
>
> -Dan
>
> On Fri, Feb 12, 2016 at 8:44 PM, Lex Trotman <[email protected]> wrote:
>
>> You could also look at the Asciidoctor implementation, I don't think
>> it uses JS for the toc.
>>
>> On 13 February 2016 at 13:17, Keith Packard <[email protected]>
>> wrote:
>> > I'm trying to help out with linux documentation. Right now, that uses a
>> huge
>> > toolchain involving custom scripts and docbook. We'd like to use
>> asciidoc,
>> > but in its current form, you either get to retain a dependency on
>> docbook,
>> > along with all that entails, or the resulting html requires javascript
>> to
>> > add a table of contents and other similar navigational aids.
>> >
>> > Here's a set of patches which provide a general mechanism to divert
>> output
>> > from a conf file section into an attribute, and then to insert that
>> > attribute into any location of the document.
>> >
>> > --
>> > 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.
>>
>
>
>
> --
> Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen
>



-- 
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 https://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/d/optout.

Reply via email to