package server
import (
"html/template"
"io/fs"
"net/http"
"regexp"
"strings"
"gitlab.com/Timfa/bluegit/docs"
"gitlab.com/Timfa/bluegit/internal/i18n"
"gitlab.com/Timfa/bluegit/internal/markdown"
)
// helpDocs is de volgorde in /help. Een vertaling heet ..md
// (bv. runner.en.md); het origineel is Nederlands.
var helpDocs = []struct{ Slug, File string }{
{"runners", "runner"},
{"agents", "agents"},
{"ci", "CI"},
{"beheer", "BEHEER"},
{"ingress", "INGRESS"},
{"auth", "AUTH"},
{"aur", "AUR"},
{"migratie", "MIGRATIE"},
{"architecture", "ARCHITECTURE"},
}
// HelpDoc is één pagina in de lijst of op het scherm.
type HelpDoc struct {
Slug string
Title string
Summary string
HTML template.HTML
Fallback bool // niet beschikbaar in de gekozen taal
On bool
}
var mdLink = regexp.MustCompile(`\[([^\]]+)\]\([^)]*\)`)
var helpLink = regexp.MustCompile(`href="/help/([A-Za-z0-9_-]+)\.md(#[^"]*)?"`)
// helpSource: eerst de gekozen taal, dan Engels (behalve voor NL), dan het origineel.
func helpSource(file string, lang i18n.Lang) (string, bool) {
var try []string
if lang != i18n.NL {
try = append(try, file+"."+string(lang)+".md")
if lang != i18n.EN {
try = append(try, file+".en.md")
}
}
try = append(try, file+".md")
for i, name := range try {
b, err := fs.ReadFile(docs.FS, name)
if err != nil {
continue
}
exact := (i == 0 && lang != i18n.NL) || (lang == i18n.NL)
return string(b), !exact
}
return "", false
}
func helpSlugFor(file string) string {
for _, d := range helpDocs {
if strings.EqualFold(d.File, file) {
return d.Slug
}
}
return strings.ToLower(file)
}
func helpMeta(src string) (title, summary string) {
var para []string
for _, line := range strings.Split(src, "\n") {
t := strings.TrimSpace(line)
if title == "" {
if strings.HasPrefix(t, "# ") {
title = strings.TrimSpace(t[2:])
}
continue
}
if t == "" || strings.HasPrefix(t, "#") || strings.HasPrefix(t, "```") || strings.HasPrefix(t, "|") {
if len(para) > 0 {
break
}
continue
}
para = append(para, t)
}
summary = mdLink.ReplaceAllString(strings.Join(para, " "), "$1")
summary = strings.ReplaceAll(strings.ReplaceAll(summary, "`", ""), "**", "")
if r := []rune(summary); len(r) > 160 {
summary = string(r[:157]) + "…"
}
return
}
// renderHelp maakt HTML en zet links naar andere docs om naar /help/.
func renderHelp(src string) template.HTML {
out := markdown.Render(src, "/help/", "", "")
out = helpLink.ReplaceAllStringFunc(out, func(m string) string {
sub := helpLink.FindStringSubmatch(m)
return `href="/help/` + helpSlugFor(sub[1]) + sub[2] + `"`
})
return template.HTML(out)
}
func helpList(lang i18n.Lang, current string) []HelpDoc {
var out []HelpDoc
for _, d := range helpDocs {
src, fb := helpSource(d.File, lang)
if src == "" {
continue
}
t, sum := helpMeta(src)
out = append(out, HelpDoc{Slug: d.Slug, Title: t, Summary: sum, Fallback: fb, On: d.Slug == current})
}
return out
}
func (s *Server) helpIndex(w http.ResponseWriter, r *http.Request) {
v := s.view(w, r, "title.help")
v.Page = "help"
v.Help = true
v.HelpDocs = helpList(s.langOf(r), "")
s.render(w, "help", v)
}
func (s *Server) helpPage(w http.ResponseWriter, r *http.Request) {
lang := s.langOf(r)
slug := strings.ToLower(r.PathValue("doc"))
for _, d := range helpDocs {
if d.Slug != slug {
continue
}
src, fb := helpSource(d.File, lang)
if src == "" {
break
}
t, _ := helpMeta(src)
v := s.view(w, r, t)
v.Page = "help"
v.Help = true
v.HelpDocs = helpList(lang, slug)
v.HelpDoc = &HelpDoc{Slug: slug, Title: t, HTML: renderHelp(src), Fallback: fb}
s.render(w, "help", v)
return
}
http.NotFound(w, r)
}