2012-12-10 3 views
10

SBT에서 Scaladoc, 특히 제목, 출력 디렉토리 및 클래스 경로를 구성하려고합니다. SBT Scaladoc Configuration

나는 build.sbt하려면 다음을 추가하여 제목을 정의하기 위해 관리 :

scalacOptions in (Compile, doc) ++= Opts.doc.title("Scala-Tools") 

나는 문서의 출력 디렉토리를 변경하는 방법을 알아낼 수 없습니다.

또한 클래스 패스에 jar를 추가하는 방법을 알 수 없습니다. classpath를 편집하려는 이유는 클래스를 참조 할 때 표준 스칼라 라이브러리가 scaladoc에 의해 선택되지 않는 것처럼 보이기 때문입니다. 즉, [[scala.Option]]은 "링크 할 멤버를 찾을 수 없습니다. "scala.Option"에 대해. "

예를 들어 SBT 구성의 형태로도 도움을 받으실 수 있습니다.

저는 스칼라 2.10-RC3과 SBT 0.12.1을 사용하고 있습니다.

답변

6

스칼라 라이브러리가 클래스 경로에 있습니다. 그렇지 않으면 scaladoc이 오류로 인해 쉽게 복구됩니다. 보이는 경고는 scaladoc이 Option으로 링크하는 방법을 모른다는 것을 의미합니다. 이를 위해서는 -external-urls 옵션이나 -doc-external-doc 옵션을 사용해야합니다. 곧 2.10.1에 대한 scaladoc -help의 출력을 보여줍니다

-doc-external-doc:<external-doc> comma-separated list of classpath_entry_path#doc_URL pairs describing external dependencies. 
-external-urls:<externalUrl(s)> (deprecated) comma-separated list of package_names=doc_URL for external dependencies, where package names are ':'-separated 

2.10.1까지이 솔루션은 밖으로 -external-uris을 사용하는 것입니다

-external-urls:scala=http://www.scala-lang.org/archives/downloads/distrib/files/nightly/docs/library/ 
+0

감사합니다 마크! 그러나이 솔루션을 사용하면 오류가 발생합니다.'[오류] 소스 파일 'http://www.scala-lang.org/archives/downloads/distrib/files/nightly/docs/library/'을 (를) 찾을 수 없습니다. – user510159

+0

또한,'scaladoc -help'를 보면 출력 디렉토리 (내 질문의 다른 부분)와 관련하여 아무 것도 찾을 수없는 것 같습니다. – user510159

+0

어떻게 전달하는지 보여 주어야합니다. 게시하기 전에 커맨드 라인에서 시도해 보았습니다. 오류 메시지는 소스 파일로 해석되고 있음을 암시하는 것 같습니다. 출력 디렉토리를 변경하는 것은 명령 행에서'-d' 옵션이지만 sbt는'docDirectory in Compile' (또는'in Test') 설정으로 처리합니다. 왜 출력 디렉토리를 바꾸고 싶습니까? –