Racket Scribble无法显示超链接

Question

我尝试了以下代码语句来显示一个URL：

```html

我尝试了以下代码语句来显示一个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>

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

- rnso

Answer 1

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

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

最终呈现的HTML将如下所示：

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

如果你想排版文字URL，并将其链接到自己的内容，请使用url函数。

- Alexis King

---

是的，它可以工作。不过文档非常技术化，没有简单的示例。 - rnso

是的，特别是涂鸦文档缺少很多示例，而且更奇怪的是，它们必须用s表达式符号表示每个函数，但通常您会使用at表达式符号。 - Alex Knauth