Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Don't include any gentext in XREFs #3

Open
sandersk opened this issue Jan 3, 2014 · 0 comments
Open

Don't include any gentext in XREFs #3

sandersk opened this issue Jan 3, 2014 · 0 comments

Comments

@sandersk
Copy link
Contributor

sandersk commented Jan 3, 2014

If no gent ext is specified in AsciiDoc for an XREF, can we leave the text nodes of HTMLBook XREF elements empty when converting to HTMLBook. In other words, can we convert this:

See <<the_id>>

to:

See <a data-type="xref" href="#the_id"/>

Instead of what we're doing now, which appears to be:

See <a data-type="xref" href="#the_id">[#the_id]</a>

Downstream, the HTMLBook XSL stylesheets will handle adding the appropriate gentext if an XREF has no text node, so I think it makes most sense to defer to having it handled there, so we can avoid replicating existing functionality.

If AsciiDoc XREFs do have gentext specified, we should preserve that, though. For example, if you've got:

See <<the_id, Awesome Chapter>>

It should be converted to:

See <a data-type="xref" href="#the_id">Awesome Chapter</a>

Let me know if you have any questions about this.

Thanks,
Sanders

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant