球拍涂鸦不显示超链接

Question

我已尝试使用以下代码语句来显示 URL:

#lang scribble/base

@title{Testing Hyperlinks}

@section{URLs}

Getting started: @hyperlink["https://docs.racket-lang.org/scribble/getting-started.html"]

Getting started: @hyperlink{"https://docs.racket-lang.org/scribble/getting-started.html"}

Getting started: @(hyperlink "https://docs.racket-lang.org/scribble/getting-started.html")

使用命令“$ scribble hyperlinks.scrbl”生成的 html 页面没有任何错误，但它没有使用任何 hyperlink 显示 URLs声明：

Testing Hyperlinks

1 URLs
Getting started:

Getting started:

Getting started:

生成的 html 文件包含以下 link：

<p>Getting started:</p><p><a href="&quot;https://docs.racket-lang.org/scribble/getting-started.html&quot;"></a></p>

问题出在哪里，我该如何纠正这个错误？

Answer 1

hyperlink 函数期望实际文本内容与 link 本身分开提供。也就是说，你应该像这样使用它：

@hyperlink["http://example.com"]{some link}

渲染后的 HTML 将如下所示：

<a href="http://example.com">some link</a>

如果您想将 URL 排版为它自己的内容，请改用 url 函数。