Amira, You're link is correct. Where you are getting confused is that the PDF generator (specifically the DocBook XSL for Apache FOP) is not rendering the link the way you would expect it to appear. It puts the URL in square brackets after the linked text. It almost looks like it's not processing the link from the AsciiDoc source. I find this default formatting confusing as well.
There is a way to customize it. First, you can disable the URL from showing using the ulink.show parameter: a2x -f pdf --fop --xsltproc-opts="-param ulink.show 0" sample.adoc If you want the text to be another color (such as blue), you can add the following XML markup to docbook-xsl/fo.xsl (one of the files in the AsciiDoc distribution): <xsl:attribute-set name="xref.properties"> <xsl:attribute name="color">#0000FF</xsl:attribute> </xsl:attribute-set> I know this is really a pain to customize. I can't understand how else to learn how to customize the DocBook toolchain other than fishing through the XSL. On a link box, it's usually under /usr/share/sgml/docbook/xsl-stylesheets. -Dan On Tue, Jun 18, 2013 at 10:08 AM, Amira Mannaii <[email protected]>wrote: > Hi all, > i'm new to asciidoc and i'm trying to display a link so this is what i > wrote : > > http://www.oracle.com/technetwork/java/index.html[Community Source Code] > > But when i generate the pdf the link is not displayed correctly : here's > the result > > Community Source Code [http://www.oracle.com/technetwork/java/index.html] > > after a long search i found this : > 37. Some elements can’t be escaped with a single backslash > > There are a number of exceptions to the usual single backslash rule — > mostly relating to URL macros that have two syntaxes or quoting ambiguity. > Here are some non-standard escape examples: > AsciiDoc Renders > > \[email protected] > <\[email protected]> > \mailto:[\[email protected]] > > [email protected] <[email protected]> mailto:[ > [email protected]] > > \http://www.example.com > \\http://www.example.com[] > \\http://www.example.com[Foobar Limited] > > http://www.example.com http://www.example.com[] http://www.example.com[Foobar > Limited] > > A C\++ Library for C++ > \\``double-quotes'' > \*\*F**ile Open\... > > A C++ Library for C++ ``double-quotes'' **F**ile Open... > > The source of this problem is ambiguity across substitution types — the > first match unescapes allowing the second to substitute. A work-around for > difficult cases is to side-step the problem using the pass:[] passthrough > inline macro. > > So i added it like this : > > pass:[http://www.oracle.com/technetwork/java/index.html[Community Source > Code] ] > > But the problem persists . > > Any Help will be appreciated > > Many thanks > > > > -- > 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/groups/opt_out. > > > -- Dan Allen | http://google.com/profiles/dan.j.allen -- 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/groups/opt_out.
