diff --git a/docs/index.md b/docs/README.md
similarity index 100%
rename from docs/index.md
rename to docs/README.md
diff --git a/docs/docs.go b/docs/docs.go
index b83996b..7cf477e 100644
--- a/docs/docs.go
+++ b/docs/docs.go
@@ -3,126 +3,162 @@ package docs
import (
"bytes"
"embed"
- "fmt"
+ "html/template"
"io"
+ "log"
"net/http"
"strings"
- "github.com/Depado/bfchroma/v2"
- "github.com/alecthomas/chroma/v2/formatters/html"
- bf "github.com/russross/blackfriday/v2"
+ toc "github.com/abhinav/goldmark-toc"
+ chromahtml "github.com/alecthomas/chroma/formatters/html"
+ "github.com/digineo/texd"
+ "github.com/microcosm-cc/bluemonday"
+ "github.com/yuin/goldmark"
+ highlighting "github.com/yuin/goldmark-highlighting"
+ "github.com/yuin/goldmark/extension"
+ "github.com/yuin/goldmark/parser"
+ "github.com/yuin/goldmark/renderer/html"
+ "github.com/yuin/goldmark/text"
"gopkg.in/yaml.v3"
)
-//go:embed docs.yml *.md **/*.md
+//go:embed *.md **/*.md
var sources embed.FS
+//go:embed docs.yml
+var config []byte
+
+//go:embed docs.html
+var rawLayout string
+var tplLayout = template.Must(template.New("layout").Parse(rawLayout))
+
type page struct {
Title string
Breadcrumbs []string
- Body string
+ TOC *toc.TOC
+ CSS []byte
+ Body []byte
File string
Route string
Children []*page
}
+type pageRoutes map[string]*page
-var root = func() page {
- structure, err := sources.Open("docs.yml")
- if err != nil {
- panic(err)
- }
- defer structure.Close()
-
+var root, routes = func() (page, pageRoutes) {
var menu page
- dec := yaml.NewDecoder(structure)
+ dec := yaml.NewDecoder(bytes.NewReader(config))
dec.KnownFields(true)
if err := dec.Decode(&menu); err != nil {
panic(err)
}
- menu.init()
- return menu
+ r := make(pageRoutes)
+ menu.init(r)
+ return menu, r
}()
-func (pg *page) init(crumbs ...string) {
+func (pg *page) init(r pageRoutes, crumbs ...string) {
if pg.File != "" {
- if r := strings.TrimSuffix(pg.File, ".md"); r == "index" {
+ if r := strings.TrimSuffix(pg.File, ".md"); r == "README" {
pg.Route = ""
} else {
pg.Route = "/" + r
}
-
+ r[pg.Route] = pg
pg.parseFile()
}
if pg.Title != "" {
- pg.Breadcrumbs = append(pg.Breadcrumbs, pg.Title)
+ pg.Breadcrumbs = append([]string{pg.Title}, crumbs...)
}
for _, child := range pg.Children {
- child.init(pg.Breadcrumbs...)
+ child.init(r, pg.Breadcrumbs...)
}
}
+var sanitize = func() func(io.Reader) *bytes.Buffer {
+ p := bluemonday.UGCPolicy()
+ p.AllowAttrs("class").Globally()
+ return p.SanitizeReader
+}()
+
func (pg *page) parseFile() {
- body, err := sources.ReadFile(pg.File)
+ raw, err := sources.ReadFile(pg.File)
if err != nil {
panic(err)
}
- r := bfchroma.NewRenderer(
- bfchroma.WithoutAutodetect(),
- bfchroma.ChromaOptions(
- html.WithLineNumbers(true),
+ var css, body bytes.Buffer
+ md := goldmark.New(
+ goldmark.WithParserOptions(
+ parser.WithAutoHeadingID(),
+ ),
+ goldmark.WithRendererOptions(
+ html.WithUnsafe(),
+ ),
+ goldmark.WithExtensions(
+ extension.GFM,
+ highlighting.NewHighlighting(
+ highlighting.WithCSSWriter(&css),
+ highlighting.WithStyle("github"),
+ highlighting.WithFormatOptions(
+ chromahtml.WithLineNumbers(true),
+ chromahtml.WithClasses(true),
+ ),
+ ),
),
- bfchroma.Extend(bf.NewHTMLRenderer(bf.HTMLRendererParameters{
- Flags: bf.CommonHTMLFlags & ^bf.UseXHTML & ^bf.CompletePage,
- })),
- )
- parser := bf.New(
- bf.WithExtensions(bf.CommonExtensions),
- bf.WithRenderer(r),
)
- ast := parser.Parse(body)
- var buf bytes.Buffer
- var inH1 bool
-
- ast.Walk(func(node *bf.Node, entering bool) bf.WalkStatus {
- switch node.Type {
- case bf.Heading:
- inH1 = entering && node.HeadingData.Level == 1 && pg.Title == ""
- case bf.Text:
- if inH1 {
- pg.Title = string(node.Literal)
- }
- case bf.Link:
- if entering && bytes.HasPrefix(node.LinkData.Destination, []byte("./")) {
- node.LinkData.Destination = bytes.TrimSuffix(node.LinkData.Destination, []byte(".md"))
- }
+ doc := md.Parser().Parse(text.NewReader(raw))
+ tree, err := toc.Inspect(doc, raw)
+ if err != nil {
+ panic(err)
+ }
+ if pg.Title == "" {
+ if len(tree.Items) > 0 {
+ pg.Title = string(tree.Items[0].Title)
}
- return r.RenderNode(&buf, node, entering)
- })
-
- pg.Body = buf.String()
-}
-
-func (pg *page) Dump(w io.Writer) {
- fmt.Fprintf(w, "- %s (%s)\n", pg.Title, pg.Route)
- fmt.Fprintln(w, pg.Body)
- fmt.Fprintln(w)
-
- for _, c := range pg.Children {
- c.Dump(w)
}
+ if err := md.Renderer().Render(&body, raw, doc); err != nil {
+ panic(err)
+ }
+ pg.TOC = tree
+ pg.CSS = css.Bytes()
+ pg.Body = sanitize(&body).Bytes()
}
func Handler() http.Handler {
+ type pageVars struct {
+ Version string
+ Title string
+ CSS template.CSS
+ Content template.HTML
+ }
+
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
- w.Header().Set("Content-Type", "text/plain; charset=utf-8")
- w.Header().Set("X-Content-Type-Options", "nosniff")
- w.WriteHeader(http.StatusOK)
+ pg := routes[r.URL.Path]
+ if pg == nil {
+ http.NotFound(w, r)
+ return
+ }
- fmt.Fprintf(w, "%#v\n\n", r.URL)
+ var buf bytes.Buffer
+ err := tplLayout.Execute(&buf, &pageVars{
+ Version: texd.Version(),
+ Title: strings.Join(pg.Breadcrumbs, " ยท "),
+ CSS: template.CSS(pg.CSS),
+ Content: template.HTML(pg.Body),
+ })
+
+ if err != nil {
+ log.Println(err)
+ code := http.StatusInternalServerError
+ http.Error(w, http.StatusText(code), code)
+ return
+ }
- root.Dump(w)
+ w.Header().Set("Content-Type", "text/html; charset=utf-8")
+ w.Header().Set("X-Content-Type-Options", "nosniff")
+ w.WriteHeader(http.StatusOK)
+ _, _ = buf.WriteTo(w)
})
}
diff --git a/docs/docs.html b/docs/docs.html
new file mode 100644
index 0000000..d864afc
--- /dev/null
+++ b/docs/docs.html
@@ -0,0 +1,39 @@
+
+
+
+
+
+
+ {{ .Title }}
+
+
+
+
+
+
+
+
+
+
+ {{ .Content }}
+
+
-