英文:
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
.
通过集体智慧和协作来改善编程学习和解决问题的方式。致力于成为全球开发者共同参与的知识库,让每个人都能够通过互相帮助和分享经验来进步。
评论