Generate docs into /develop/api/*
authorAndy Williams <andy@andywilliams.me>
Wed, 25 Oct 2017 17:17:17 +0000 (18:17 +0100)
committerAndy Williams <andy@andywilliams.me>
Wed, 25 Oct 2017 17:17:25 +0000 (18:17 +0100)
Also move root doc to start.txt for a better entry point

src/scripts/elua/apps/docgen/keyref.lua
src/scripts/elua/apps/docgen/util.lua
src/scripts/elua/apps/docgen/writer.lua
src/scripts/elua/apps/gendoc.lua

index a28e612..56311d9 100644 (file)
@@ -30,7 +30,7 @@ M.build = function()
         f:finish()
         local lf = writer.Writer({ "ref", lang, "keyword-link" })
         lf:write_raw("/", dutil.path_join(
-            dutil.nspace_to_path(dutil.get_root_ns()), "auto",
+            dutil.nspace_to_path(dutil.get_root_ns()),
             "ref", lang, "key", "{FNAME}"
         ))
         lf:write_nl()
index 48e375d..65968ac 100644 (file)
@@ -23,7 +23,7 @@ M.nspace_to_path = function(ns)
 end
 
 M.make_page = function(path, ext)
-    return M.path_join(doc_root, "auto", path .. "." .. ext)
+    return M.path_join(doc_root, path .. "." .. ext)
 end
 
 M.get_root_ns = function()
@@ -31,7 +31,7 @@ M.get_root_ns = function()
 end
 
 M.mkdir_r = function(dirn)
-    assert(cutil.file_mkpath(M.path_join(doc_root, "auto", dirn)))
+    assert(cutil.file_mkpath(M.path_join(doc_root, dirn)))
 end
 
 M.mkdir_p = function(path)
@@ -39,7 +39,7 @@ M.mkdir_p = function(path)
 end
 
 M.rm_root = function()
-    cutil.file_rmrf(M.path_join(doc_root, "auto"))
+    cutil.file_rmrf(doc_root)
 end
 
 M.init = function(root, rns)
index 67b6765..4690ed7 100644 (file)
@@ -73,7 +73,7 @@ local write_include = function(self, tp, name, flags)
     if type(name) == "table" then
         if name[#name] == true then
             name[#name] = nil
-            name = ":" .. root_nspace .. ":auto:"
+            name = ":" .. root_nspace .. ":"
                        .. table.concat(name, ":")
         elseif name[#name] == false then
             name[#name] = nil
@@ -272,7 +272,7 @@ writers["dokuwiki"] = util.Object:clone {
         if type(target) == "table" then
             if target[#target] == true then
                 target[#target] = nil
-                target = ":" .. root_nspace .. ":auto:"
+                target = ":" .. root_nspace .. ":"
                              .. table.concat(target, ":")
             elseif target[#target] == false then
                 target[#target] = nil
index 63ad69b..97c9715 100644 (file)
@@ -327,7 +327,7 @@ local build_reftable = function(f, title, ctitle, ctype, t, iscl)
 end
 
 local build_ref = function()
-    local f = writer.Writer("reference", "EFL Reference")
+    local f = writer.Writer("start", "EFL Reference")
     printgen("Generating reference...")
 
     f:write_editable({ "reference" }, "general")
@@ -1601,7 +1601,7 @@ getopt.parse {
             set_theme(opts["graph-theme"])
         end
         local rootns = (not opts["n"] or opts["n"] == "")
-            and "develop:efl" or opts["n"]
+            and "develop:api" or opts["n"]
         local dr
         if not opts["r"] or opts["r"] == "" then
             dr = "dokuwiki/data/pages"