2012-12-10 9 views
10

Próbuję skonfigurować Scaladoc w SBT, w szczególności tytuł, katalog wyjściowy i ścieżkę klas.Konfiguracja Scaladoc SBT

udało mi się określić tytuł, dodając następujący aby build.sbt:

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

nie mogę dowiedzieć się, jak zmienić katalog docelowy doc.

Nie mogę również dowiedzieć się, jak dodać słoiki do ścieżki klasy. Powodem, dla którego chcę edytować ścieżkę klas, jest to, że wygląda na to, że standardowa biblioteka Scala nie jest pobierana przez skaladoc, gdy odwołuję się do jej klas, tj. [[Scala.Opcja]] prowadzi do ostrzeżenia "Nie można znaleźć żadnego członka do połączenia dla "scala.Option". "

Każda pomoc, nawet w formie przykładowej konfiguracji SBT byłaby doceniona!

Używam Scala 2.10-RC3 i SBT 0.12.1.

Odpowiedz

6

Biblioteka Scala znajduje się na ścieżce klasy, w przeciwnym razie program skaladoc bardzo szybko wyskoczy z błędem. Ostrzeżenie, które widzisz, oznacza, że ​​skaladoc nie wie, jak połączyć się z Opcją. W tym celu należy użyć opcji -external-urls lub opcji -doc-external-doc w wersji 2.10.1. Wyjście scaladoc -help na nadchodzący 2.10.1 pokazuje:

-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 

Rozwiązanie aż 2.10.1 to jest użycie -external-uris:

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

Dzięki Mark! Jednak przy użyciu tego rozwiązania pojawia się błąd: '[plik źródłowy błędu] http://www.scala-lang.org/archives/downloads/distrib/files/nightly/docs/library/" nie można znaleźć " – user510159

+0

Ponadto, patrząc na 'skaladoc -help', nie mogę znaleźć niczego w katalogu wyjściowym (druga część mojego pytania). – user510159

+0

Powinieneś pokazać, jak to przekazujesz. Próbowałem go z linii poleceń przed wysłaniem i zadziałało. Komunikat o błędzie zdaje się sugerować, że jest interpretowany jako plik źródłowy. Jeśli chodzi o zmianę katalogu wyjściowego, jest to opcja '-d' w wierszu poleceń, ale sbt obsługuje ją za pomocą ustawienia' docDirectory in Compile' (lub 'in Test'). Dlaczego jednak chcesz zmienić katalog wyjściowy? –