fix nim-lang#12998 nim doc regression

.gitignore

@@ -89,3 +89,5 @@ megatest.nim
 
 # ignore debug dirs generated by dsymutil on OSX
 *.dSYM
+
+nimdoc.out.css

compiler/docgen.nim

@@ -43,6 +43,7 @@ type
     destFile*: AbsoluteFile
     thisDir*: AbsoluteDir
     examples: string
+    wroteCss*: bool
 
   PDoc* = ref TDocumentor ## Alias to type less.
 
@@ -1060,6 +1061,8 @@ proc generateIndex*(d: PDoc) =
                                               d.conf.projectPath), IndexExt)
     writeIndexFile(d[], dest.string)
 
+const nimRepoDir = currentSourcePath / ".." / ".." # this should be exposed somewhere
+
 proc writeOutput*(d: PDoc, useWarning = false) =
   runAllExamples(d)
   var content = genOutFile(d)
@@ -1068,10 +1071,18 @@ proc writeOutput*(d: PDoc, useWarning = false) =
   else:
     template outfile: untyped = d.destFile
     #let outfile = getOutFile2(d.conf, shortenDir(d.conf, filename), outExt, "htmldocs")
-    createDir(outfile.splitFile.dir)
+    let dir = outfile.`$`.parentDir
+    createDir(dir)
     if not writeRope(content, outfile):
       rawMessage(d.conf, if useWarning: warnCannotOpenFile else: errCannotOpenFile,
         outfile.string)
+    else:
+      if not d.wroteCss:
+        let cssSource = nimRepoDir / "doc" / "nimdoc.css"
+        let cssDest = $d.conf.outDir / "nimdoc.out.css"
+          # renamed to make it easier to use with gitignore in user's repos
+        copyFile(cssSource, cssDest)
+        d.wroteCss = true
     d.conf.outFile = outfile.extractFilename.RelativeFile
 
 proc writeOutputJson*(d: PDoc, useWarning = false) =

config/nimdoc.cfg

@@ -237,7 +237,7 @@ doc.file = """<?xml version="1.0" encoding="utf-8" ?>
 
 <!-- CSS -->
 <title>$title</title>
-<link rel="stylesheet" type="text/css" href="nimdoc.css">
+<link rel="stylesheet" type="text/css" href="/nimdoc.out.css">
 
 <script type="text/javascript" src="dochack.js"></script>
 

koch.nim

@@ -24,7 +24,7 @@ when defined(i386) and defined(windows) and defined(vcc):
   {.link: "icons/koch-i386-windows-vcc.res".}
 
 import
-  os, strutils, parseopt, osproc, streams
+  os, strutils, parseopt, osproc
 
 import tools / kochdocs
 
@@ -45,6 +45,7 @@ Options:
   --help, -h               shows this help and quits
   --latest                 bundle the installers with a bleeding edge Nimble
   --stable                 bundle the installers with a stable Nimble (default)
+  --nim:path               use specified path for nim binary
 Possible Commands:
   boot [options]           bootstraps with given command line options
   distrohelper [bindir]    helper for distro packagers
@@ -605,6 +606,7 @@ when isMainModule:
       case normalize(op.key)
       of "latest": latest = true
       of "stable": latest = false
+      of "nim": nimExe = op.val.absolutePath # absolute so still works with changeDir
       else: showHelp()
     of cmdArgument:
       case normalize(op.key)

nimdoc/test_out_index_dot_html/expected/index.html

@@ -18,7 +18,7 @@
 
 <!-- CSS -->
 <title>foo</title>
-<link rel="stylesheet" type="text/css" href="nimdoc.css">
+<link rel="stylesheet" type="text/css" href="/nimdoc.out.css">
 
 <script type="text/javascript" src="dochack.js"></script>
 

nimdoc/test_out_index_dot_html/expected/theindex.html

@@ -18,7 +18,7 @@
 
 <!-- CSS -->
 <title>Index</title>
-<link rel="stylesheet" type="text/css" href="nimdoc.css">
+<link rel="stylesheet" type="text/css" href="/nimdoc.out.css">
 
 <script type="text/javascript" src="dochack.js"></script>
 

nimdoc/testproject/expected/subdir/subdir_b/utils.html

@@ -18,7 +18,7 @@
 
 <!-- CSS -->
 <title>utils</title>
-<link rel="stylesheet" type="text/css" href="nimdoc.css">
+<link rel="stylesheet" type="text/css" href="/nimdoc.out.css">
 
 <script type="text/javascript" src="dochack.js"></script>
 

nimdoc/testproject/expected/testproject.html

@@ -18,7 +18,7 @@
 
 <!-- CSS -->
 <title>testproject</title>
-<link rel="stylesheet" type="text/css" href="nimdoc.css">
+<link rel="stylesheet" type="text/css" href="/nimdoc.out.css">
 
 <script type="text/javascript" src="dochack.js"></script>
 

nimdoc/testproject/expected/theindex.html

@@ -18,7 +18,7 @@
 
 <!-- CSS -->
 <title>Index</title>
-<link rel="stylesheet" type="text/css" href="nimdoc.css">
+<link rel="stylesheet" type="text/css" href="/nimdoc.out.css">
 
 <script type="text/javascript" src="dochack.js"></script>
 

tools/kochdocs.nim

@@ -11,12 +11,15 @@ const
   webUploadOutput = "web/upload"
   docHackDir = "tools/dochack"
 
+var nimExe*: string
+
 proc exe*(f: string): string =
   result = addFileExt(f, ExeExt)
   when defined(windows):
     result = result.replace('/','\\')
 
 proc findNim*(): string =
+  if nimExe.len > 0: return nimExe
   var nim = "nim".exe
   result = "bin" / nim
   if existsFile(result): return
@@ -366,14 +369,11 @@ proc buildJS() =
 proc buildDocs*(args: string) =
   const
     docHackJs = "dochack.js"
-    css = "nimdoc.css"
   let
     a = nimArgs & " " & args
     docHackJsSource = docHackDir / docHackJs
     docHackJsDest = docHtmlOutput / docHackJs
 
-    cssSource = "doc" / css
-    cssDest = docHtmlOutput / css
   buildJS()                     # This call generates docHackJsSource
   let docup = webUploadOutput / NimVersion
   createDir(docup)
@@ -387,6 +387,3 @@ proc buildDocs*(args: string) =
   buildDoc(nimArgs, docHtmlOutput)
   copyFile(docHackJsSource, docHackJsDest)
   copyFile(docHackJsSource, docup / docHackJs)
-
-  copyFile(cssSource, cssDest)
-  copyFile(cssSource, docup / css)