页面树结构
Skip to end of metadata
Go to start of metadata

锚点(Anchors)被用来在页面中使用一些特殊的链接。锚点通常被用来在一个很长的页面中在不同块中进行导航,或者你希望在页面的顶部使用页面内导航。

锚点在阅读模式下是不可见的。

你可以通过下面 2 步来使用锚点:

  1. 在页面中新建一个锚点。
  2. 为这个锚点创建一个连接。

创建一个锚点

在你希望新建锚点的地方使用锚点宏。

  1. 添加一个锚点宏到页面中。
    1. 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
    2. 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
    3. 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert来将需要的宏插入到页面中。
  2. 为你的锚点输入名字。例如你可以使用 'bottom' 或者 'important information'。请查看下面描述的锚点名称('Anchor Name')参数。这里我们不建议使用中文字符作为锚点参数,因为涉及到页面编码的问题,有些页面编码格式可能不能被浏览器识别。在中文环境下,如果要使用锚点的话, 请使用英文名称。同时,新建的锚点的名称中间不要有空格,空格在 URL 转换的时候可能会带来一些麻烦。

本页内容:

宏选项(parameters)

宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example)。


参数名称

默认值

参数说明

锚点名称(Anchor Name)

没有默认值(None)

这个地方输入的锚点名称将会在新建链接的时候被使用。

  • 锚点的名称可以包括空间。当 Confluence 为这个锚点构建链接的时候,将会自动移除空间。
  • 锚点的名称是大小写敏感的。在为锚点创建连接的时候,你必须使用与锚点宏中名称大小写一致的名称。

为一个锚点新建一个链接

你可以使用下面的方式链接到一个锚点:

  • 在 Confluence 站点中的页面。这个链接可以在和 锚点同一个页面中创建,也可以在同一个空间的其他页面中创建,或者 Confluence 站点的其他页面(不在同一个空间中)。
  • 其他 Web 页面或者其他 Confluence 站点,需要使用特殊的 URL 格式。

为了链接在 Confluence 同一个站点中的锚点

  1. 选择一些文本或者位置,这个地方是你希望插入链接的地方。
  2. 在工具栏中选择 链接(Link)或者使用快捷键 (Ctrl+K)。
  3. 选择 高级选项(Advanced )然后输入锚点的名称,可用的锚点名称,请参考下表中的说明。

    锚点位置

    链接到锚点的句法

    示例

    同一个页面#anchor name

    #bottom

    #important information

    同一个空间的页面page name#anchor name

    My page#bottom

    My page#important information

    不同空间的页面spacekey:page name#anchor name

    DOC:My page#bottom

    DOC:My page#important information

    锚点的名称是大小写敏感的。在为锚点创建连接的时候,你必须使用与锚点宏中名称大小写一致的名称。

  4. 输入或者修改 链接文本( Link Text)这个部分的内容是会在页面中显示的。如果这个地方你不输入任何内容,那么本页面的名字或者 URL 将会在这里被使用。
  5. 选择 插入(Insert)

屏幕截图:链接对话框中的高级选项 ('Advanced' )。

为了链接到其他页面的锚点或者 Confluence 站点以外的锚点:

使用下面的完整 URL 格式:

有关完整 URL 的说明:

  • 页面的名字将会在 URL 中的 # 符合后面重复。第二次出现的名字将会合并成一个单词,所有的字符中间的空格将会被删除。
  • 在页面名称和锚点名称中间使用连字符(-)进行连接。
  • 锚点名称在完整 URL 中是作为一个单词出现的,锚点名称中的所有空格也会被删除。
  • 锚点名称是大小写敏感的。在为锚点创建连接的时候,你必须使用与锚点宏中名称大小写一致的名称。

说明

  • 页面内容表:考虑使用 内容列表(Table of Contents)宏 来链接页面的内容列表。这个宏将会显示页面的内容列表,然后当标题进行修改后也可以进行自动更新。如果你希望对页面的内容进行列表显示,强烈建议使用这个方法,这样可以避免页面标题修改后导致页面内链接错误。
  • 连接到标题: 你可以在页面中直接链接到标题。请查看 使用链接 页面中的详细说明。但是你需要注意的时候,当你的页面的标题修改后,你的链接到标题的链接将会损坏。使用锚点链接将会避免这个错误,因此不建议直接链接到标题。
  • 站点欢迎信息:当你添加一个锚点到页面中,并且希望使用这个作为站点的欢迎信息,你只能从其他页面中链接到这个锚点,页面的内部链接将不能正确工作。
  • 模板:当你对一个模板进行预览的时候,链接到这个模板上的锚点将会显示链接错误。但是,如果你开始使用这个模板的时候,链接是可以正确显示的。




  • 无标签