5
私はラケットの落書き/ lpに小さなサンプルプログラムを書こうとしています。プロジェクトのソースはGithubです。未解決のリンク不安定/ lp文書
私が経験している問題は、織ったhtmlのリンクが壊れていることです。私はプロジェクトのためにgh-page.として提供しました。
「Sribble LPexample.scrbl」コマンドを使用して文書を出力する場合、私は次の警告を得る：
2013 blog > scribble LPexample.scrbl
[Output to LPexample.html]
Warning: some cross references may be broken due to undefined tags:
(dep ((lib "2htdp/image.rkt") ellipse))
(mod-path "racket")
(dep ((lib "2htdp/image.rkt") beside/align))
(dep ((lib "2htdp/image.rkt") rectangle))
(mod-path "scribble/lp")
を、出力ファイルが壊れたリンクの下に赤い下線を配置します。
描画されるファイルは、LPexample.scrblです。それはかなり簡単です：
#lang scribble/manual
@require[scribble/lp-include]
@title{Literate Programming Example}
// snip
@lp-include["LPexample.rkt"]
壊れたリンクをソース文芸的プログラミング文書のセクションは、ライン69から86までです：
which weaves to this:
@chunk[<blue_square>
(rectangle 100 100 "solid" "blue")]
can be composed into other functions this way:
@verbatim|{
@chunk[<blue_square>
(beside/align "bottom"
(ellipse 20 70 "solid" "lightsteelblue")
<blue_square>)]}|
which weaves out to:
@chunk[<example_body>
(beside/align "bottom"
(ellipse 20 70 "solid" "lightsteelblue")
<blue_square>)]
私はもちろん、ラケットのドキュメントを掘りしてきました。しかし、実際にはまっすぐなかんぬき/芯か落書き/マニュアルを使用した文書を相互にリンクするための良い例はなく、落書き/ lpを気にすることはありません。
また、Racketのドキュメントのソースを掘り下げてみましたが、ガイドとリファレンス用のスクリーブルファイルは、非常に多くのカスタム関数とマクロと依存関係を使用しています。シンプルな "ああそう、それはやっている方法だ"を掘り起こすために。