Skip to content

Commit 46f44fc

Browse files
authored
Merge pull request #860 from fgren/patch-5
Add additional instructions for scaladoc
2 parents 61c4c1b + ecadfc5 commit 46f44fc

File tree

2 files changed

+10
-1
lines changed

2 files changed

+10
-1
lines changed

compendium/postchapters/document.tex

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,15 @@ \subsection{Generera dokumentation}
171171
Du genererar dokumentation enklast med hjälp av körverktyget \code{scala-cli}.
172172
I terminalen skriv \\\code{scala-cli doc . -o api}
173173

174-
När \code{scala-cli} är färdig med att generera dokumentationen så meddelas vilken katalog som dokumentationen ligger i. Du läser dokumentationen genom att öppna filen \texttt{index.html} i en webbläsare.
174+
När \code{scala-cli} är färdig med att generera dokumentationen så meddelas vilken katalog som dokumentationen ligger i. För att länkarna inom dokumentationen ska fungera krävs antingen att du kör en lokal webbserver i katalogen eller att du använder ett program för att konvertera länkarna till lokala sådana.
175+
176+
\subsubsection{Använda en lokal webbserver}
177+
Om du har Python 3 installerat på din dator har du en inkluderad webbserver. Du startar denna i terminalen med \code{python -m http.server} när du står i dokumentationens katalog. För att öppna dokumentationen besöker du sedan \url{http://localhost:8000} i din webbläsare.
178+
179+
\subsubsection{Använda ett program för att konvertera länkar}
180+
Om du inte har Python installerat kan du köra ett Scala-program som byter ut alla länkar till lokala sådana, vilket gör att de går att öppna direkt. Detta kan laddas ner från \\
181+
\url{https://github.com/dixine55/Scaladoc-Local-Version-Patcher/blob/main/scaladocPatch.scala}. \\
182+
Placera programmet i dokumentationsmappen och kör det med \code{scala-cli run .} när du är i dokumentationens mapp. Du öppnar sedan dokumentationen genom filen \texttt{index.html} i din webbläsare. \\
175183

176184
Mer att läsa om att generera dokumentation finns här: \\
177185
\url{https://scala-cli.virtuslab.org/docs/commands/doc}

contributors.tex

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@
2626
Erik Bjäreholt,
2727
Erik Grampp,
2828
Evelyn Beck,
29+
Felix Ohrgren,
2930
Fredrik Danebjer,
3031
Fritjof Bengtsson,
3132
Gustav Cedersjö,

0 commit comments

Comments
 (0)