diff --git a/examples/archive/Fes.toml b/bak.examples/archive/Fes.toml similarity index 100% rename from examples/archive/Fes.toml rename to bak.examples/archive/Fes.toml diff --git a/bak.examples/archive/archive/2025/seal.png b/bak.examples/archive/archive/2025/seal.png new file mode 100644 index 0000000..0ae7980 Binary files /dev/null and b/bak.examples/archive/archive/2025/seal.png differ diff --git a/bak.examples/archive/www/index.lua b/bak.examples/archive/www/index.lua new file mode 100644 index 0000000..8819249 --- /dev/null +++ b/bak.examples/archive/www/index.lua @@ -0,0 +1,8 @@ +local fes = require("fes") +local site = fes.fes() + +site.title = "archive" + +site:h1("Hello, World!") + +return site diff --git a/examples/hello/Fes.toml b/bak.examples/bus/Fes.toml similarity index 76% rename from examples/hello/Fes.toml rename to bak.examples/bus/Fes.toml index 31606c1..f6aab67 100644 --- a/examples/hello/Fes.toml +++ b/bak.examples/bus/Fes.toml @@ -1,5 +1,5 @@ [app] -name = "hello" +name = "bus" version = "0.0.1" authors = ["vx-clutch"] \ No newline at end of file diff --git a/bak.examples/bus/www/index.lua b/bak.examples/bus/www/index.lua new file mode 100644 index 0000000..a24a0b3 --- /dev/null +++ b/bak.examples/bus/www/index.lua @@ -0,0 +1,15 @@ +local fes = require("fes") +local site = fes.fes() + +site.title = "bus" +site.copyright = fes.util.copyright("https://git.vxserver.dev/fSD/", "fSD") + +site:h1("URL: " .. fes.bus.url) + +local params = fes.bus.params + +for key, val in pairs(params) do + site:h2(key .. ": " .. val) +end + +return site diff --git a/bak.examples/canonical/Fes.toml b/bak.examples/canonical/Fes.toml new file mode 100644 index 0000000..24430e8 --- /dev/null +++ b/bak.examples/canonical/Fes.toml @@ -0,0 +1,5 @@ +[app] + +name = "canonical" +version = "0.0.1" +authors = ["vx-clutch"] diff --git a/bak.examples/canonical/include/header.lua b/bak.examples/canonical/include/header.lua new file mode 100644 index 0000000..9c87ed0 --- /dev/null +++ b/bak.examples/canonical/include/header.lua @@ -0,0 +1,16 @@ +local header = {} + +header.render = function(std) + return table.concat({ + std.center(std.h1("Canonical")), + std.center(table.concat({ + std.nav("example"), + std.nav("example"), + std.nav("example"), + std.nav("example"), + std.nav("example"), + })) + }) +end + +return header diff --git a/bak.examples/canonical/www/404.lua b/bak.examples/canonical/www/404.lua new file mode 100644 index 0000000..304c8ee --- /dev/null +++ b/bak.examples/canonical/www/404.lua @@ -0,0 +1,17 @@ +local fes = require("fes") +local std = fes.std +local u = fes.util + +local site = fes.fes() + +site.title = "404 Page Not Found" +site.copyright = u.copyright("https://git.vxserver.dev/fSD/", "fSD") + +site:banner(std.h1(std.center("Canonical"))) + +site:note(table.concat({ + std.center(std.h1("404 Page Not Found")), + std.center(std.p("The page you are looking for is not here. " .. std.a("/", "Go home?"))), +})) + +return site diff --git a/bak.examples/canonical/www/index.lua b/bak.examples/canonical/www/index.lua new file mode 100644 index 0000000..480d637 --- /dev/null +++ b/bak.examples/canonical/www/index.lua @@ -0,0 +1,17 @@ +local fes = require("fes") +local std = fes.std + +local site = fes.fes() + +site.title = "Canonical" +site.copyright = fes.util.copyright("https://git.vxserver.dev/fSD", "fSD") + +site:banner(fes.app.header.render(std)) + +site:note(table.concat({ + std.h1("Canonical"), + std.p("This is the example for the canonical 'fes' site, by canonical is meant a format and " .. std.external("https://git.vxserver.dev/fSD/fes/src/branch/master/examples/canonical/www/index.lua", "code") .. " that resembles the typical use case of the Microframework"), + std.p("This page also serves as a test for the integrity of a 'fes' build, given that it uses plenty crucial features to show everything from the HTML to CSS as well as the interactivity of certain elements."), +})) + +return site diff --git a/bak.examples/error/Fes.toml b/bak.examples/error/Fes.toml new file mode 100644 index 0000000..8327ff6 --- /dev/null +++ b/bak.examples/error/Fes.toml @@ -0,0 +1 @@ +dhasjkdhaskjdhaskhdajkshjk diff --git a/bak.examples/error/www/index.lua b/bak.examples/error/www/index.lua new file mode 100644 index 0000000..e0e2cf7 --- /dev/null +++ b/bak.examples/error/www/index.lua @@ -0,0 +1,9 @@ +local fes = require("fes") +local site = fes.fes() + +site.title = "error" + +UNIX is very simple +GNU's Not UNIX + +return site diff --git a/examples/advanced/Fes.toml b/bak.examples/favicon/Fes.toml similarity index 72% rename from examples/advanced/Fes.toml rename to bak.examples/favicon/Fes.toml index 65bc6af..a974584 100644 --- a/examples/advanced/Fes.toml +++ b/bak.examples/favicon/Fes.toml @@ -1,5 +1,5 @@ [app] -name = "advanced" +name = "favicon" version = "0.0.1" authors = ["vx-clutch"] \ No newline at end of file diff --git a/bak.examples/favicon/static/image/favicon.ico b/bak.examples/favicon/static/image/favicon.ico new file mode 100644 index 0000000..9db4ded Binary files /dev/null and b/bak.examples/favicon/static/image/favicon.ico differ diff --git a/bak.examples/favicon/www/index.lua b/bak.examples/favicon/www/index.lua new file mode 100644 index 0000000..53e3d27 --- /dev/null +++ b/bak.examples/favicon/www/index.lua @@ -0,0 +1,9 @@ +local fes = require("fes") +local site = fes.fes() + +site.title = "favicon" +site.favicon = "static/image/favicon.ico" + +site:h1("Hello, World!") + +return site diff --git a/bak.examples/hello-world/Fes.toml b/bak.examples/hello-world/Fes.toml new file mode 100644 index 0000000..a2376b5 --- /dev/null +++ b/bak.examples/hello-world/Fes.toml @@ -0,0 +1,5 @@ +[app] + +name = "hello-world" +version = "0.0.1" +authors = ["vx-clutch"] diff --git a/examples/hello/www/index.lua b/bak.examples/hello-world/www/index.lua similarity index 85% rename from examples/hello/www/index.lua rename to bak.examples/hello-world/www/index.lua index 73a4954..4720737 100644 --- a/examples/hello/www/index.lua +++ b/bak.examples/hello-world/www/index.lua @@ -1,6 +1,7 @@ local fes = require("fes") local site = fes.fes() +site.title = "Hello, World!" site.copyright = fes.util.copyright("https://git.vxserver.dev/fSD", "fSD") site:h1("Hello, World!") diff --git a/examples/error/Fes.toml b/bak.examples/json/Fes.toml similarity index 76% rename from examples/error/Fes.toml rename to bak.examples/json/Fes.toml index 9cd794b..e519140 100644 --- a/examples/error/Fes.toml +++ b/bak.examples/json/Fes.toml @@ -1,5 +1,5 @@ [app] -name = "error" +name = "json" version = "0.0.1" authors = ["vx-clutch"] \ No newline at end of file diff --git a/bak.examples/json/www/index.lua b/bak.examples/json/www/index.lua new file mode 100644 index 0000000..980e6d7 --- /dev/null +++ b/bak.examples/json/www/index.lua @@ -0,0 +1,34 @@ +local fes = require("fes") +local site = fes.fes() + +site.title = "JSON" +site.copyright = fes.util.copyright("https://git.vxserver.dev/fSD", "fSD") + +local json_pre = [[ +{ + "userId": 1, + "id": 1, + "title": "delectus aut autem", + "completed": false +} +]] + +local json = fes.middleware.json_decode(json_pre) + +site:h1("JSON") + +site:note(fes.util.cc({ + fes.std.h2("Before"), + fes.std.code(json_pre), +})) +site:note(fes.util.cc({ + fes.std.h2("After"), + fes.std.ul({ + json["userId"], + json["id"], + json["title"], + json["completed"], + }) +})) + +return site diff --git a/bak.examples/multi-page/Fes.toml b/bak.examples/multi-page/Fes.toml new file mode 100644 index 0000000..219e8bc --- /dev/null +++ b/bak.examples/multi-page/Fes.toml @@ -0,0 +1,5 @@ +[app] + +name = "multi-page" +version = "0.0.1" +authors = ["vx-clutch"] diff --git a/bak.examples/multi-page/www/index.lua b/bak.examples/multi-page/www/index.lua new file mode 100644 index 0000000..cab9342 --- /dev/null +++ b/bak.examples/multi-page/www/index.lua @@ -0,0 +1,16 @@ +local fes = require("fes") +local site = fes.fes() + +site.title = "Home" +site.copyright = fes.util.copyright("https://git.vxserver.dev/fSD", "fSD") + +site:h1("Home") +site:note( + fes.std.ul({ + fes.std.a("page1"), + fes.std.a("page2"), + fes.std.a("sub/subpage"), + }) +) + +return site diff --git a/bak.examples/multi-page/www/page1.lua b/bak.examples/multi-page/www/page1.lua new file mode 100644 index 0000000..3b2c7c6 --- /dev/null +++ b/bak.examples/multi-page/www/page1.lua @@ -0,0 +1,15 @@ +local fes = require("fes") +local site = fes.fes() + +site.title = "Page 1" +site.copyright = fes.util.copyright("https://git.vxserver.dev/fSD", "fSD") + +site:h1("Page 1") +site:note( + fes.std.ul({ + fes.std.a("/", "home"), + fes.std.a("page2"), + }) +) + +return site diff --git a/bak.examples/multi-page/www/page2.lua b/bak.examples/multi-page/www/page2.lua new file mode 100644 index 0000000..535bf68 --- /dev/null +++ b/bak.examples/multi-page/www/page2.lua @@ -0,0 +1,15 @@ +local fes = require("fes") +local site = fes.fes() + +site.title = "Page 2" +site.copyright = fes.util.copyright("https://git.vxserver.dev/fSD", "fSD") + +site:h1("Page 2") +site:note( + fes.std.ul({ + fes.std.a("/", "home"), + fes.std.a("page1"), + }) +) + +return site diff --git a/examples/advanced/www/index.lua b/bak.examples/multi-page/www/sub/subpage.lua similarity index 64% rename from examples/advanced/www/index.lua rename to bak.examples/multi-page/www/sub/subpage.lua index 41bea09..f13a917 100644 --- a/examples/advanced/www/index.lua +++ b/bak.examples/multi-page/www/sub/subpage.lua @@ -1,15 +1,14 @@ local fes = require("fes") -local std = fes.std - - local site = fes.fes() +site.title = "Subpage" site.copyright = fes.util.copyright("https://git.vxserver.dev/fSD", "fSD") -site:h1("Hello, World!") - +site:h1("Subpage") site:note( - fes.app.foo.render() + fes.std.ul({ + fes.std.a("/", "Home"), + }) ) return site diff --git a/bak.examples/simple/Fes.toml b/bak.examples/simple/Fes.toml new file mode 100644 index 0000000..8027800 --- /dev/null +++ b/bak.examples/simple/Fes.toml @@ -0,0 +1,5 @@ +[app] + +name = "simple" +version = "0.0.1" +authors = ["vx-clutch"] diff --git a/examples/simple/www/index.lua b/bak.examples/simple/www/index.lua similarity index 100% rename from examples/simple/www/index.lua rename to bak.examples/simple/www/index.lua diff --git a/examples/simple/Fes.toml b/bak.examples/static/Fes.toml similarity index 75% rename from examples/simple/Fes.toml rename to bak.examples/static/Fes.toml index b3008f5..46996a2 100644 --- a/examples/simple/Fes.toml +++ b/bak.examples/static/Fes.toml @@ -1,5 +1,5 @@ [app] -name = "simple" +name = "static" version = "0.0.1" authors = ["vx-clutch"] \ No newline at end of file diff --git a/bak.examples/static/static/foo b/bak.examples/static/static/foo new file mode 100644 index 0000000..115e5b7 --- /dev/null +++ b/bak.examples/static/static/foo @@ -0,0 +1 @@ +this is some neat data diff --git a/examples/error/www/index.lua b/bak.examples/static/www/index.lua similarity index 57% rename from examples/error/www/index.lua rename to bak.examples/static/www/index.lua index 79ec327..9e2e206 100644 --- a/examples/error/www/index.lua +++ b/bak.examples/static/www/index.lua @@ -1,6 +1,8 @@ local fes = require("fes") local site = fes.fes() -This is what an error looks like +site.title = "static" + +site:h1("Hello, World!") return site diff --git a/doc/Fes.toml b/doc/Fes.toml new file mode 100644 index 0000000..fb06900 --- /dev/null +++ b/doc/Fes.toml @@ -0,0 +1,9 @@ +[site] + +name = "doc" +version = "0.0.1" +authors = ["vx-clutch"] + +[fes] +version = "1.0.0" +CUSTOM_CSS = diff --git a/doc/www/index.lua b/doc/www/index.lua new file mode 100644 index 0000000..afc9282 --- /dev/null +++ b/doc/www/index.lua @@ -0,0 +1,70 @@ +local fes = require("fes") +local site = fes.site_builder() + +site.title = "Fes Documentation" +site.copyright = fes.std.copyright() .. " " .. fes.std.external("https://git.vxserver.dev/fSD", "fSD") + +site:h1("Fes Documentation") +site:note([[ +This is the documentation for the Fes +Microframework. This documentation serves as +a starting point and in its current state is +not comprehensive. Furthermore, you should +note that Fes is not production grade or +stable, use at your own caution. +]]) + +site:muted("Before reading this you should consult the " .. +fes.std.external("https://git.vxserver.dev/fSD/fes", "README")) + +local docs = {} + +local template = [[ +%s +
+ + %s +
+ %s +
+]] +function docs:func(fn, signature, desc) + table.insert(self, string.format(template, fn, signature, desc)) + return self +end + +docs:func("site_builder", "fes.site_builder() -> site", "returns a site object, a required element for this framework.") +docs:func("custom", "site:custom(content)", "adds a raw string into the site object") +docs:func("h1", "site:h1(content)", "adds a h1 tag to the site object.") +docs:func("h2", "site:h2(content)", "adds a h2 tag to the site object.") +docs:func("h3", "site:h3(content)", "adds a h3 tag to the site object.") +docs:func("h4", "site:h4(content)", "adds a h4 tag to the site object.") +docs:func("h5", "site:h5(content)", "adds a h5 tag to the site object.") +docs:func("h6", "site:h6(content)", "adds a h6 tag to the site object.") +docs:func("p", "site:p(content)", "adds a paragraph tag to the site object.") +docs:func("note", "site:note(content)", "adds a fes note to the site object. A note is a box used for important information or emphasis.") +docs:func("muted", "site:muted(content)", "adds a fes muted block to the site object. A muted block makes text smaller and less noticable, it is useful for small usage notes.") +docs:func("a", "site:a(link, content)", "adds an anchor tag to the site object. By default, if no 'content' is passed is just displays the link") +docs:func("external", "site:external(link, content)", "similarly to 'site:a', it adds an anchor tag to the site object but opens it in a new tab. By default, if no 'content' is passed is just displays the link") +docs:func("ul", "site:ul(items)", "creates an unordered list from passed table, usally 'std.li()'.") +docs:func("ol", "site:ol(items)", "creates an ordered list from passed table, usally 'std.li()'.") +docs:func("li", "site:li(content)", "adds a list entry to the site object") +docs:func("code", "site:code(content)", "adds a code block to the site object.") +docs:func("blockquote", "site:blockquote(content)", "adds a block quote to the site object.") +docs:func("hr", "site:hr()", "adds a horizontal line to the site object.") +docs:func("divider", "site:divider()", "adds a divider to the site object.") +docs:func("img", "site:img(src, alt)", "adds an image to the site object.") +docs:func("table", "site:table(headers, rows)", "adds a table to the site object.") +docs:func("div", "site:div(content, classs)", "adds a custom div to the site object. Custom classes are to be defined in the .css file pointed to by the CUSTOM_CSS variable in Fes.toml") +docs:func("span", "site:span(content, classs)", "adds a custom span to the site object. Custom classes are to be defined in the .css file pointed to by the CUSTOM_CSS variable in Fes.toml") +docs:func("strong", "site:strong(content)", "adds bold text to the site object.") +docs:func("em", "site:em(content)", "adds italicized text to the site object.") +docs:func("br", "site:br()", "adds a break into the document") +docs:func("links", "site:links(link_list)", "adds a formated list of links into the site object.") +docs:func("lead", "site:lead(content)", "adds an instance of the lead class into the site object. This is used in combonation with 'site:note' to create a heading within it.") +docs:func("small", "site:small(content)", "adds a div with class 'small'. The small class changed the size of text within.") +docs:func("highlight", "site:highlight(content)", "adds an instance of the 'highlight' class into the site object. Text with the 'highlight' class will be emphasized") + +site:note(table.concat(docs, "")) + +return site diff --git a/examples/advanced/include/foo.lua b/examples/advanced/include/foo.lua deleted file mode 100644 index ee67099..0000000 --- a/examples/advanced/include/foo.lua +++ /dev/null @@ -1,7 +0,0 @@ -local foo = {} - -foo.render = function() - return "This was called from a foo function" -end - -return foo diff --git a/examples/archive/archive/2025.12.07/seal.png b/examples/archive/archive/2025.12.07/seal.png deleted file mode 100644 index 74634c2..0000000 Binary files a/examples/archive/archive/2025.12.07/seal.png and /dev/null differ diff --git a/examples/archive/www/index.lua b/examples/archive/www/index.lua deleted file mode 100644 index 7f8630d..0000000 --- a/examples/archive/www/index.lua +++ /dev/null @@ -1,17 +0,0 @@ -local fes = require("fes") -local std = fes.std - -local site = fes.fes() - -site.copyright = fes.util.copyright("https://git.vxserver.dev/fSD", "fSD") - -site:h1("Hello, World!") - -site:note(fes.util.cc { - std.h2("Files"), - std.ul { - std.a("/archive", "to the file room!"), - } -}) - -return site diff --git a/go.mod b/go.mod index 881eb58..300d287 100644 --- a/go.mod +++ b/go.mod @@ -9,7 +9,6 @@ require ( github.com/mattn/go-colorable v0.1.13 // indirect github.com/mattn/go-isatty v0.0.20 // indirect github.com/pelletier/go-toml/v2 v2.2.4 // indirect - github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c // indirect github.com/yuin/gopher-lua v1.1.1 // indirect golang.org/x/sys v0.25.0 // indirect ) diff --git a/go.sum b/go.sum index b33b5de..ea99386 100644 --- a/go.sum +++ b/go.sum @@ -11,12 +11,9 @@ github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWE github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/pelletier/go-toml/v2 v2.2.4 h1:mye9XuhQ6gvn5h28+VilKrrPoQVanw5PMw/TB0t5Ec4= github.com/pelletier/go-toml/v2 v2.2.4/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY= -github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c h1:+mdjkGKdHQG3305AYmdv1U2eRNDiU2ErMBj1gwrq8eQ= -github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c/go.mod h1:7rwL4CYBLnjLxUqIJNnCWiEdr3bn6IUYi15bNlnbCCU= github.com/yuin/gopher-lua v1.1.1 h1:kYKnWBjvbNP4XLT3+bPEwAXJx262OhaHDWDVOPjL46M= github.com/yuin/gopher-lua v1.1.1/go.mod h1:GBR0iDaNXjAgGg9zfCvksxSRnQx76gclCIb7kdAd1Pw= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.1.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.25.0 h1:r+8e+loiHxRqhXVl6ML1nO3l1+oFoWbnlu2Ehimmi34= golang.org/x/sys v0.25.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= diff --git a/main.go b/main.go index 2d95708..47c0eab 100644 --- a/main.go +++ b/main.go @@ -2,7 +2,7 @@ package main import ( "embed" - "errors" + _ "embed" "flag" "fmt" "os" @@ -10,7 +10,6 @@ import ( "github.com/fatih/color" "fes/src/config" - "fes/src/doc" "fes/src/new" "fes/src/server" ) @@ -26,63 +25,30 @@ func init() { } func main() { - flag.Usage = func() { - fmt.Fprintf(flag.CommandLine.Output(), "Usage: %s [options] \n", os.Args[0]) - fmt.Println("Commands:") - fmt.Println(" new Create a new project") - fmt.Println(" doc Open documentation") - fmt.Println(" run Start the server") - fmt.Println("Options:") - flag.PrintDefaults() - } flag.Parse() + if len(os.Args) < 3 { + fmt.Println("Usage: fes ") + os.Exit(1) + } if *config.Color { color.NoColor = true } - args := flag.Args() - if len(args) < 1 { - flag.Usage() - os.Exit(1) - } - - cmd := args[0] - var dir string - if cmd == "new" || cmd == "run" { - if len(args) < 2 { - fmt.Fprintf(os.Stderr, "Error: %s requires \n", cmd) - flag.Usage() - os.Exit(1) - } - dir = args[1] - } + cmd := os.Args[1] + dir := os.Args[2] switch cmd { case "new": if err := new.Project(dir); err != nil { - fmt.Fprintln(os.Stderr, "Error:", err) - os.Exit(1) - } - case "doc": - if err := doc.Open(); err != nil { - fmt.Fprintln(os.Stderr, "Error:", err) - os.Exit(1) + panic(err) } case "run": if err := server.Start(dir); err != nil { - if errors.Is(err, os.ErrNotExist) { - fmt.Fprintf(os.Stderr, "%s does not exist\n", dir) - fmt.Fprintf(os.Stderr, "Try: fes new %s\n", dir) - os.Exit(1) - } else { - fmt.Fprintln(os.Stderr, "Error:", err) - os.Exit(1) - } + panic(err) } default: - fmt.Fprintf(os.Stderr, "Unknown command: %s\n", cmd) - flag.Usage() + fmt.Println("Unknown command:", cmd) os.Exit(1) } } diff --git a/src/doc/doc.go b/src/doc/doc.go deleted file mode 100644 index a48d46f..0000000 --- a/src/doc/doc.go +++ /dev/null @@ -1,25 +0,0 @@ -package doc - -import ( - "fmt" - "os" - "path/filepath" - - "github.com/pkg/browser" -) - -func Open() error { - fmt.Println("Opening documentation in browser") - - tmpFile := filepath.Join(os.TempDir(), "doc.html") - content := `
-This feature is not implemented yet. It will be once the doc site
-is up and running, for now read through the core/ files and examples.
-
` - - if err := os.WriteFile(tmpFile, []byte(content), 0644); err != nil { - return err - } - - return browser.OpenFile(tmpFile) -} diff --git a/src/new/new.go b/src/new/new.go index 71ad79e..2fa1b0f 100644 --- a/src/new/new.go +++ b/src/new/new.go @@ -48,21 +48,16 @@ func Project(dir string) error { if err := os.Chdir(dir); err != nil { return err } - - name := getName() - write("www/index.lua", `local fes = require("fes") local site = fes.fes() --- site.copyright = fes.util.copyright("https://example.com", "%s") - site:h1("Hello, World!") -return site`, name) +return site`) write("Fes.toml", `[app] name = "%s" version = "0.0.1" -authors = ["%s"]`, dir, name) +authors = ["%s"]`, dir, getName()) return nil } diff --git a/src/server/server.go b/src/server/server.go index 396fe9f..b17d174 100644 --- a/src/server/server.go +++ b/src/server/server.go @@ -12,7 +12,6 @@ import ( "strings" "time" - "fes/src/config" "github.com/fatih/color" "github.com/gomarkdown/markdown" "github.com/gomarkdown/markdown/html" @@ -20,13 +19,16 @@ import ( "github.com/pelletier/go-toml/v2" lua "github.com/yuin/gopher-lua" "html/template" + "fes/src/config" ) +/* structure of all data passed to page via fes.bus */ type reqData struct { path string params map[string]string } +/* loads directories to routes */ func handleDir(entries []os.DirEntry, dir string, routes map[string]string, base string, isStatic bool) error { for _, entry := range entries { path := filepath.Join(dir, entry.Name()) @@ -70,6 +72,7 @@ func basePath(base string) string { return base } +/* fixes empty TOML keys (e.g., key=) */ func fixMalformedToml(content string) string { re := regexp.MustCompile(`(?m)^(\s*\w+\s*=\s*)$`) return re.ReplaceAllStringFunc(content, func(match string) string { @@ -82,6 +85,7 @@ func fixMalformedToml(content string) string { }) } +/* converts markdown to html */ func markdownToHTML(mdText string) string { extensions := parser.CommonExtensions | parser.AutoHeadingIDs | parser.NoEmptyLineBeforeBlock p := parser.NewWithExtensions(extensions) @@ -92,6 +96,7 @@ func markdownToHTML(mdText string) string { return string(markdown.Render(doc, renderer)) } +/* load Lua include modules used in core/ into their table */ func loadIncludeModules(L *lua.LState, includeDir string) *lua.LTable { app := L.NewTable() ents, err := os.ReadDir(includeDir) @@ -104,12 +109,6 @@ func loadIncludeModules(L *lua.LState, includeDir string) *lua.LTable { } base := strings.TrimSuffix(e.Name(), ".lua") path := filepath.Join(includeDir, e.Name()) - if _, err := os.Stat(path); err != nil { - tbl := L.NewTable() - tbl.RawSetString("error", lua.LString(fmt.Sprintf("file not found: %s", path))) - app.RawSetString(base, tbl) - continue - } if err := L.DoFile(path); err != nil { tbl := L.NewTable() tbl.RawSetString("error", lua.LString(err.Error())) @@ -119,7 +118,7 @@ func loadIncludeModules(L *lua.LState, includeDir string) *lua.LTable { val := L.Get(-1) L.Pop(1) tbl, ok := val.(*lua.LTable) - if !ok || tbl == nil { + if !ok { tbl = L.NewTable() } app.RawSetString(base, tbl) @@ -127,6 +126,7 @@ func loadIncludeModules(L *lua.LState, includeDir string) *lua.LTable { return app } +/* load and execute lua scripts with core and user modules */ func loadLua(luaDir string, entry string, cfg *config.MyConfig, requestData reqData) (string, error) { L := lua.NewState() defer L.Close() @@ -197,7 +197,8 @@ func loadLua(luaDir string, entry string, cfg *config.MyConfig, requestData reqD } } - mod.RawSetString("app", loadIncludeModules(L, filepath.Join(".", "include"))) + includeDir := filepath.Join(luaDir, "include") + mod.RawSetString("app", loadIncludeModules(L, includeDir)) if cfg != nil { site := L.NewTable() @@ -252,6 +253,7 @@ func loadLua(luaDir string, entry string, cfg *config.MyConfig, requestData reqD return "", nil } +/* generate html index page for archive directories */ func generateArchiveIndex(fsPath string, urlPath string) (string, error) { info, err := os.Stat(fsPath) if err != nil { @@ -342,6 +344,7 @@ func generateArchiveIndex(fsPath string, urlPath string) (string, error) { return b.String(), nil } +/* start http server with features */ func Start(dir string) error { if err := os.Chdir(dir); err != nil { return fmt.Errorf("failed to change directory to %s: %w", dir, err)