如何编译Racket Doc源文件

huangapple go评论46阅读模式
英文:

How to compile Racket Doc source file

问题

我已下载了《Racket指南》的源代码,以了解其文档编写方式。我想进行一些更改,并查看在呈现的HTML中如何反映出来。

我需要帮助编译《Racket指南》的源代码。

你可以帮助我吗?

英文:

I have downloaded the source for Racket Guide to learn how it has been documented. I wanted to make changes and see how it reflects in the rendered html.

I need help in compiling the source for Racket Guide.

Could you please help me?

答案1

得分: 1

当你说你 "下载了源代码" 时,你是指什么?

设置Racket(及其文档)以进行修改的一种方法是:

$ git clone https://github.com/racket/racket
$ cd racket
$ make # 第一次运行可能会根据你的硬件花费很长时间。我的花了25分钟,启用了多线程。

这将构建整个Racket及其文档。然后,你可以修改文档。例如,要修改Racket指南,你应该更改pkgs/racket-doc/scribblings/guide中的内容。之后,再次运行make以呈现更改。你可以通过raco docs查看更新后的文档。

英文:

When you said you "downloaded the source", what do you mean by that?

One way to setup Racket (and its docs) for modification is to:

$ git clone https://github.com/racket/racket
$ cd racket
$ make # The first run could take long time depending on your hardware. Mine took 25 mins, with multithreading enabled.

This will build the entire Racket and its documentation. Then, you can modify the doc. For example, to modify the Racket Guide, you should change stuff in pkgs/racket-doc/scribblings/guide. After that, run make again to render the change. You can view the updated documentation via raco docs.

huangapple
  • 本文由 发表于 2023年6月26日 22:58:21
  • 转载请务必保留本文链接:https://go.coder-hub.com/76557867.html
匿名

发表评论

匿名网友

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen:

确定