Workaround required (using ++ in link:)

[maartenvandewaarsenburg]

In some places I generate Asciidoc files out of miscellaneous data.

From the following generated Asciidoc link, Ascidoctor generates an HTML paragraph in stead of an HTML anchor.

Asciidoc link: "link:/Support/Tutorials/Code_Integration_Tutorial/Using_Dezyne_in_your_C++_environment.html[Using Dezyne in your C++ environment]"

HTML text: "link:/Support/Tutorials/Code_Integration_Tutorial/Using_Dezyne_in_your_C_environment.html[Using Dezyne in your C environment]"

As you can see, Asciidoctor interpretes the plusses in the URL as well as in the link text.

How do I need to format the Asciidoc link to get the correct HTML anchor tag? I can manipulate the URL differently from the link text.

For your information; I use Asciidoctor 1.5.5 on Ubuntu 18.04.

[abelsromero]

Not sure this is the most appropriate solution, but this is the only that worked for me.

Using the passthrough instead of + notation like this:

link:pass:[/Support/Tutorials/Code_Integration_Tutorial/Using_Dezyne_in_your_C++_environment.html][pass:[Using Dezyne in your C++ environment]]

[maartenvandewaarsenburg]

Perfect!

[mojavelinux]

++ is a reserved character sequence in AsciiDoc (and a very strong one). The solution is to an attribute reference.

Since C++ is such a common term in tech, there's a built-in attribute for it named cpp.

link:/Support/Tutorials/Code_Integration_Tutorial/Using_Dezyne_in_your_{cpp}_environment.html[Using Dezyne in your {cpp} environment]

The reason this works is because attribute substitutions happen after ++ is interpreted. For other strategies, see https://asciidoctor.org/docs/user-manual/#complex-urls

If you're writing about some other ++ language, such as SQL++, then what I recommend is defining ++ as the attribute pp.

:pp: ++

Now I can write about SQL{pp}.

(we might consider just making this a built-in attribute).

-Dan

On Mon, May 28, 2018 at 2:08 AM, maartenvandewaarsenburg [via Asciidoctor :: Discussion] <[hidden email]> wrote:

In some places I generate Asciidoc files out of miscellaneous data.

From the following generated Asciidoc link, Ascidoctor generates an HTML paragraph in stead of an HTML anchor.

Asciidoc link: "link:/Support/Tutorials/Code_Integration_Tutorial/Using_Dezyne_in_your_C++_environment.html[Using Dezyne in your C++ environment]"

HTML text: "link:/Support/Tutorials/Code_Integration_Tutorial/Using_Dezyne_in_your_C_environment.html[Using Dezyne in your C environment]"

As you can see, Asciidoctor interpretes the plusses in the URL as well as in the link text.

How do I need to format the Asciidoc link to get the correct HTML anchor tag? I can manipulate the URL differently from the link text.

For your information; I use Asciidoctor 1.5.5 on Ubuntu 18.04.

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/Workaround-required-using-link-tp6354.html

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

... [show rest of quote]

--

[maartenvandewaarsenburg]

@mojavelinux (Dan):
That's a very valuable remark you make. And I will certainly use it in handwritten Asciidoc.

But as, in this case, the Asciidoc is generated from data I have to deal with, I'll use abelsromero's suggestion.

Do you agree or can I get into trouble?

[mojavelinux]

For generated content, the pass macro is a very handy tool. You can't go wrong.

-Dan

On Mon, May 28, 2018 at 3:37 AM, maartenvandewaarsenburg [via Asciidoctor :: Discussion] <[hidden email]> wrote:

@mojavelinux (Dan):
That's a very valuable remark you make. And I will certainly use it in handwritten Asciidoc.

But as, in this case, the Asciidoc is generated from data I have to deal with, I'll use abelsromero's suggestion.

Do you agree or can I get into trouble?

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/Workaround-required-using-link-tp6354p6359.html

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

--