Asciidoctor :: Discussion - Re: Tables using asciidoc column styles do not render cross references?

Re: Tables using asciidoc column styles do not render cross references?

Posted by mojavelinux on Oct 23, 2013; 7:28am
URL: https://discuss.asciidoctor.org/Tables-using-asciidoc-column-styles-do-not-render-cross-references-tp846p849.html

Aha! You've identified a use case that isn't tested...and isn't working :)

It's important to understand that AsciiDoc table cells are parsed using a nested invocation of the Asciidoctor API. In other words, there's a parent-child relationship between the two tree structures. The child has visibility and, in some cases, write access to data in the parent.

The internal reference table is clearly something that should be shared. However, right now, it isn't. That's why it's not seeing the reference.

I'll get this filed and fixed for Asciidoctor 1.5.0.

There are two other workarounds you can use until then. The first is an explicit title at the point of the reference:

<<more-info,More Info>>

The other option is to revert the table cell type to default just for that individual cell. That can be done using the 'd' cell spec.

d|See <<more-info>>

Here are the full list of cell style specifiers: https://github.com/asciidoctor/asciidoctor/blob/master/lib/asciidoctor/table.rb#L21

I hope that clears things up a bit.

Cheers,

-Dan

On Tue, Oct 22, 2013 at 9:04 PM, rwinch [via Asciidoctor :: Discussion] <[hidden email]> wrote:

It seems that columns that use asciidoc styles [1] do not render cross references. For example,

= Example

This works <<more-info>>

[cols="1,1a"]
|===
|Name |Value

|Name A
| Does not work <<more-info>>

|Name B
|Values as bullets

* a
* b

|===

= More Info

Seems this is a valid workaround?

[cols="1,1"]
|===
|Name |Value

|Name A
| Works <<more-info>>

|Name B
a|Values as bullets

* a
* b

|===

Is this expected? Is this similar to the footnotes issue[2]? I tried using the pass macro to no avail. What does one do
if they need bullets inside a cell that also needs a cross reference?

[1] http://asciidoctor.org/docs/user-manual/#column-specifiers
[2] http://discuss.asciidoctor.org/Footnotes-and-cross-references-in-Asciidoctor-0-1-4-td671.html

Thanks!
Rob

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Tables-using-asciidoc-column-styles-do-not-render-cross-references-tp846.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Dan Allen | http://google.com/profiles/dan.j.allen