5
라켓의 낙서/lp에 작은 예제 프로그램을 작성하려고합니다. 프로젝트의 출처는 Github입니다.scribble/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>)]
. 그러나 실제로 scribble/lp를 염두에 두지 말고 똑 바른 낙서/코어 또는 낙서/수동을 사용하여 문서를 교차 연결하는 경우에도 좋은 예가 없습니다.
나는 또한 Racket 설명서의 소스를 파헤 치려고했지만 가이드 및 참조 용 낙서 파일은 너무 많은 사용자 지정 함수와 매크로 및 종속성을 사용하여 주변에서 충분히 두뇌를 확보 할 수 없습니다 단순한 "오 이런 식으로 끝내는 법"을 파헤 쳤다.