On 9 May 2014 17:29, Jauco Noordzij <[email protected]> wrote:
> Hi,
>
> I found out about asciidoc yesterday and it looks like it is a really well
> designed implementation of txt -> pdf/html. Much better than the cobbled
> together markdown/jekyll/printcss we're using now.
>
> I'm trying to map all concepts that we use to asciidoc and there is one
> that's tantalizingly close yet just out of reach: inline <glossterm> items.
> In docbook I can mark an item as a glossterm and then have it linked
> automatically to a glossary item, or issue a warning if the link is not
> possible. We write documentation for clients with lots of jargon and linked
> glossaries are very important to get someone up to speed.
You can just use ordinary links <<entry_id, the glossary term>> to
link to glossary entries like:
[[entry_id]]
the glossary term:: blah blah blah
That should work in all backends, asciidoc generated HTML, or HTML and
PDF via docbook.
>
> How can I make asciidoc emit a <glossterm> tag? Can I add it using a macro
> or something? Can I embed docbook tags in my asciidoc?
You can of course define a macro to emit an inline glossterm. Thats
probably the best if you really want inline glossterms and are only
generating HTML via docbook. Note that you may still have to manually
handle the ids (which goes in the linkend attribute of the
<glossterm>), but maybe the toolchain can search for the term.
I would suggest that you check that the toolchain you are using
supports it for HTML and PDF by first trying a passthrough as Eduardo
suggests. This will also allow you to figure out exactly what docbook
you need to generate.
The macro:
gloss:entry_id[the glossary term]
would be defined in your document local asciidoc.conf like (WARNING UNTESTED):
[macros]
(?su)gloss:(?P<target>\S*?)\[(?P<term>.*?)\]=inline-glossterm
[inline-glossterm-inlinemacro]
<glossterm linkend={target}>{term}</glossterm>
>
> I couldn't find information on this in this group or in the documentation,
> but I might have been using the wrong terms in google :)
Thats because it isn't there.
Cheers
Lex
>
> --
> 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 http://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 http://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/d/optout.
