Function renderExerciseFile

cmd/sitegen/main.go:546–580

(path, name, lang string, md goldmark.Markdown)

}

func renderExerciseFile(path, name, lang string, md goldmark.Markdown) (exercise, error) {
	raw, err := os.ReadFile(path)
	if err != nil {
		return exercise{}, err
	}
	_, h1, body := splitChapter(raw)
	title := cleanExerciseTitle(h1)
	blurb := exerciseBlurb(body)
	difficulty := extractDifficulty(body)
	// Exercise pages sit under exercises/, parallel to how-to/, so a
	// reference to a follow_along chapter resolves the same way.
	rewritten := rewriteLinksFrom(body, "../chapters/")

	var buf bytes.Buffer
	if err := md.Convert([]byte(rewritten), &buf); err != nil {
		return exercise{}, err
	}

	slug := strings.TrimSuffix(name, ".md")
	num := ""
	if m := exerciseNumRe.FindStringSubmatch(slug); len(m) == 2 {
		num = m[1]
	}
	return exercise{
		Slug:       slug,
		Num:        num,
		Title:      title,
		Blurb:      template.HTML(renderInline(blurb)),
		Difficulty: difficulty,
		Body:       template.HTML(buf.String()),
		Lang:       lang,
		URL:        "exercises/" + slug + ".html",
		OtherURL:   slug + ".html",
	}, nil
}

var (
	// Pulls the leading "01-" out of "01-tool-retry-on-error".