scheme - 球拍涂鸦不显示超链接

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 页面没有任何错误，但它没有显示带有任何超链接语句的 URL：

Testing Hyperlinks

1 URLs
Getting started:

Getting started:

Getting started:

生成的 html 文件包含以下链接：

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

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

Answer 1

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

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

呈现的 HTML 将如下所示：

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

如果要排版链接到其自身内容的文字 URL，请改用该url函数。