如何在AsciiDoc中创建外部链接引用而不重复多次URL?

时间:2018-04-22 19:15:31

标签: asciidoc asciidoctor

在降价时我可以写:

[example1][myid]

[example2][myid]

[myid]: http://example.com

所以我不必多次重新输入完​​整的外部链接。

AsciiDoc中是否有类似的功能?对Asciidoctor实施特别感兴趣。

到目前为止,我只能找到:

  • <<>>
  • 的内部交叉引用
  • 我认为我看到了:myid:类型的替换功能,但我再也找不到它了。然而,我并没有看到如何为每个链接使用不同的文本。

2 个答案:

答案 0 :(得分:2)

可能你的意思是这样的:

用户指南第28.1章。设置配置条目

... 属性条目可提高清晰度并消除重复 AsciiDoc3宏中的URL和文件名通常很长 - 它们会破坏段落流并且可读性受损。如果重复使用相同的名称,则问题会因冗余而复杂化。属性条目可用于使您的文档更易于阅读和编写,以下是一些示例:

:1:         http://freshmeat.net/projects/asciidoc3/
:homepage:  http://asciidoc3.org[AsciiDoc3 home page]
:new:       image:./images/smallnew.png[]
:footnote1: footnote:[A meaningless latin term]

Using previously defined attributes: See the {1}[Freshmeat summary]
or the {homepage} for something new {new}. Lorem ispum {footnote1}.

...

BTW,现在有一个100%的Python3端口:https://asciidoc3.org

答案 1 :(得分:1)

我认为你正在寻找这个(两者都可以正常工作),

https://www.google.com[Google]

link: https://google.com[Google]

参考: Ascii Doc User Manual Link

<小时/> 更新#1 :在asciidoc

中使用链接和变量

声明变量

:url: https://www.google.com  

使用上述格式

使用变量功能
  1. 使用&#39; 与标签链接&#39;

    {url}[Google]
    
  2. 使用相对链接

    link:{url}[Google]