Tables using asciidoc column styles do not render cross references?

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

Tables using asciidoc column styles do not render cross references?

rwinch
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
Reply | Threaded
Open this post in threaded view
|

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

mojavelinux
Administrator
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>>


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



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

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

mojavelinux
Administrator
In reply to this post by rwinch


On Wed, Oct 23, 2013 at 1:28 AM, Dan Allen <[hidden email]> wrote:
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>>


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



--



--