Table of content (:toc: attribute) on github

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

Table of content (:toc: attribute) on github

ge0ffrey
Does github support :toc:?

I have this at the top of my .adoc file on github:
= JBoss integration platform BOM
:toc:

but I don't see any table of content (TOC):
  https://github.com/jboss-integration/jboss-integration-platform-bom/blob/master/README.adoc
Reply | Threaded
Open this post in threaded view
|

Re: Table of content (:toc: attribute) on github

LightGuardjp
Administrator
Github is using version 0.1.0 or maybe 0.1.2 of Asciidoctor. I don't believe either of those versions supports :toc:.


On Thu, Oct 17, 2013 at 6:20 AM, ge0ffrey [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Does github support :toc:?

I have this at the top of my .adoc file on github:
= JBoss integration platform BOM
:toc:

but I don't see any table of content (TOC):
  https://github.com/jboss-integration/jboss-integration-platform-bom/blob/master/README.adoc


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Table-of-content-toc-attribute-on-github-tp815.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Reply | Threaded
Open this post in threaded view
|

Re: Table of content (:toc: attribute) on github

mojavelinux
Administrator
We're (patiently) waiting on the upgrade of Asciidoctor on GitHub to 0.1.4. You can follow the issue here:

https://github.com/github/markup/pull/201?source=cc

You can check which version of Asciidoctor GitHub is using in various places by adding the following attribute reference to your document.

{asciidoctor-version}

You don't need to save it, just click the Preview tab.

It's currently 0.1.0*

-Dan

* So much for continuous deployment ;)



On Thu, Oct 17, 2013 at 11:09 AM, LightGuardjp [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Github is using version 0.1.0 or maybe 0.1.2 of Asciidoctor. I don't believe either of those versions supports :toc:.


On Thu, Oct 17, 2013 at 6:20 AM, ge0ffrey [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Does github support :toc:?

I have this at the top of my .adoc file on github:
= JBoss integration platform BOM
:toc:

but I don't see any table of content (TOC):
  https://github.com/jboss-integration/jboss-integration-platform-bom/blob/master/README.adoc


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Table-of-content-toc-attribute-on-github-tp815.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--



If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Table-of-content-toc-attribute-on-github-tp815p816.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Reply | Threaded
Open this post in threaded view
|

Re: Table of content (:toc: attribute) on github

mojavelinux
Administrator
In reply to this post by ge0ffrey
Btw, to get it to work on GitHub after the upgrade, you'd still need to use the manual toc placement.

[source,asciidoc]
--
= JBoss integration platform BOM
:toc:
:toc-placement!:

toc::[]
--

You can read about the details here: http://asciidoctor.org/docs/user-manual/#manual-placement

Btw, I am starting to wonder whether we should enable the toc even when the header and footer are disabled. This is not the first time this request has come up.

-Dan


On Thu, Oct 17, 2013 at 6:20 AM, ge0ffrey [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Does github support :toc:?

I have this at the top of my .adoc file on github:
= JBoss integration platform BOM
:toc:

but I don't see any table of content (TOC):
  https://github.com/jboss-integration/jboss-integration-platform-bom/blob/master/README.adoc


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Table-of-content-toc-attribute-on-github-tp815.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--