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) }