feature: Set up templated views and blog support

This commit is contained in:
Keith Solomon
2025-04-20 15:39:22 -05:00
parent 463250eb7b
commit 3fe75e9ad5
20 changed files with 580 additions and 255 deletions

2
.gitignore vendored Normal file
View File

@@ -0,0 +1,2 @@
node_modules/
bak/

View File

@@ -0,0 +1,20 @@
---
title: Go SSG - Another Blog Post
description: A longer summary of the post. Lorem ipsum dolor set amit.
date: 2025-04-19
categories:
- go
- anger
---
# Why isn't this working?! 😭
This is my first Go SSG blog post.
This project is a simple static site generator written in Go. It is designed to be easy to use and extend, allowing you to create a static website quickly and efficiently.
It supports features like:
- Markdown content
- Customizable templates
- Simple configuration

View File

@@ -2,8 +2,19 @@
title: Go SSG - My First Blog Post
description: A short summary of the post.
date: 2025-04-19
categories:
- progrmming
- go
---
# *Tap Tap Tap* Is this thing on?
This is my first blog post!
This is my first Go SSG blog post.
This project is a simple static site generator written in Go. It is designed to be easy to use and extend, allowing you to create a static website quickly and efficiently.
It supports features like:
- Markdown content
- Customizable templates
- Simple configuration

230
main.go
View File

@@ -1,3 +1,4 @@
package main
import (
@@ -7,6 +8,7 @@ import (
"io/ioutil"
"os"
"path/filepath"
"regexp"
"strings"
"time"
@@ -14,26 +16,27 @@ import (
"gopkg.in/yaml.v3"
)
// NavItem represents a navigation link
type NavItem struct {
Title string
URL string
}
// PageMeta holds front matter metadata
type PageMeta struct {
Title string `yaml:"title"`
Description string `yaml:"description"`
Date string `yaml:"date"`
Slug string // we'll set this ourselves from filename
Title string `yaml:"title"`
Description string `yaml:"description"`
Date string `yaml:"date"`
Categories []string `yaml:"categories"`
Slug string
}
var slugRegex = regexp.MustCompile(`[^a-z0-9]+`)
func main() {
contentDir := "./content"
outputDir := "./public"
templateFile := "./templates/layout.html"
tpl, err := template.ParseFiles(templateFile)
// Load all templates in the templates folder
tpl, err := template.New("").Funcs(templateFuncs()).ParseGlob("templates/*.html")
if err != nil {
fmt.Printf("Template parsing error: %v\n", err)
return
@@ -45,7 +48,6 @@ func main() {
return
}
// Collect nav info early
var nav []NavItem
for _, file := range files {
if filepath.Ext(file.Name()) == ".md" {
@@ -54,77 +56,63 @@ func main() {
if name != "index" {
url = "/" + name + "/"
}
nav = append(nav, NavItem{
Title: strings.Title(name),
URL: url,
})
nav = append(nav, NavItem{Title: strings.Title(name), URL: url})
}
}
// Add blog to the main nav
nav = append(nav, NavItem{
Title: "Blog",
URL: "/blog/",
})
// Add blog to main nav
nav = append(nav, NavItem{Title: "Blog", URL: "/blog/"})
// Generate index.html for each static page markdown file
// Static page rendering
for _, file := range files {
if filepath.Ext(file.Name()) != ".md" {
continue
if filepath.Ext(file.Name()) == ".md" {
name := strings.TrimSuffix(file.Name(), filepath.Ext(file.Name()))
title := strings.Title(name)
mdPath := filepath.Join(contentDir, file.Name())
rawContent, err := ioutil.ReadFile(mdPath)
if err != nil {
fmt.Printf("Failed to read %s: %v\n", file.Name(), err)
continue
}
meta, content := parseFrontMatter(rawContent)
htmlContent := blackfriday.Run(content)
if meta.Title == "" {
meta.Title = title
}
var outPath string
if name == "index" {
outPath = filepath.Join(outputDir, "index.html")
} else {
subDir := filepath.Join(outputDir, name)
os.MkdirAll(subDir, os.ModePerm)
outPath = filepath.Join(subDir, "index.html")
}
outFile, err := os.Create(outPath)
if err != nil {
fmt.Printf("Failed to create %s: %v\n", outPath, err)
continue
}
tpl.ExecuteTemplate(outFile, "static_page", map[string]interface{}{
"Title": meta.Title,
"Description": meta.Description,
"Date": meta.Date,
"Categories": meta.Categories,
"Content": template.HTML(htmlContent),
"Nav": nav,
"Year": time.Now().Year(),
"PageTemplate": "static",
})
fmt.Printf("Generated: %s\n", outPath)
}
name := strings.TrimSuffix(file.Name(), filepath.Ext(file.Name()))
mdPath := filepath.Join(contentDir, file.Name())
rawContent, err := ioutil.ReadFile(mdPath)
if err != nil {
fmt.Printf("Failed to read %s: %v\n", file.Name(), err)
continue
}
meta, content := parseFrontMatter(rawContent)
htmlContent := blackfriday.Run(content)
// Determine output path
var outPath string
if name == "index" {
outPath = filepath.Join(outputDir, "index.html")
} else {
subDir := filepath.Join(outputDir, name)
os.MkdirAll(subDir, os.ModePerm)
outPath = filepath.Join(subDir, "index.html")
}
outFile, err := os.Create(outPath)
if err != nil {
fmt.Printf("Failed to create %s: %v\n", outPath, err)
continue
}
// Fall back to filename for title if none provided
if meta.Title == "" {
meta.Title = strings.Title(name)
}
data := map[string]interface{}{
"Title": meta.Title,
"Description": meta.Description,
"Date": meta.Date,
"Content": template.HTML(htmlContent),
"Nav": nav,
"Year": time.Now().Year(),
}
err = tpl.Execute(outFile, data)
if err != nil {
fmt.Printf("Template execution failed for %s: %v\n", file.Name(), err)
continue
}
fmt.Printf("Generated: %s\n", outPath)
}
// Generate blog index
var blogPosts []PageMeta
categoryMap := make(map[string][]PageMeta)
blogDir := filepath.Join(contentDir, "blog")
blogFiles, _ := ioutil.ReadDir(blogDir)
@@ -144,12 +132,16 @@ func main() {
meta, content := parseFrontMatter(rawContent)
html := blackfriday.Run(content)
meta.Slug = slug
if meta.Title == "" {
meta.Title = strings.Title(slug)
}
for _, cat := range meta.Categories {
slug := slugify(cat)
categoryMap[slug] = append(categoryMap[slug], meta)
}
outPath := filepath.Join(outputDir, "blog", slug, "index.html")
os.MkdirAll(filepath.Dir(outPath), os.ModePerm)
@@ -159,47 +151,54 @@ func main() {
continue
}
err = tpl.Execute(outFile, map[string]interface{}{
"Title": meta.Title,
"Description": meta.Description,
"Date": meta.Date,
"Content": template.HTML(html),
"Nav": nav,
"Year": time.Now().Year(),
tpl.ExecuteTemplate(outFile, "blog_post_page", map[string]interface{}{
"Title": meta.Title,
"Description": meta.Description,
"Date": meta.Date,
"Categories": meta.Categories,
"Content": template.HTML(html),
"Nav": nav,
"Year": time.Now().Year(),
"PageTemplate": "blog_post",
})
if err != nil {
fmt.Printf("Template error for blog post %s: %v\n", file.Name(), err)
continue
}
blogPosts = append(blogPosts, meta)
}
err = buildBlogIndex(blogPosts, tpl, outputDir, nav)
if err != nil {
fmt.Println("Failed to build blog index:", err)
buildBlogIndex(blogPosts, tpl, outputDir, nav)
for catSlug, posts := range categoryMap {
outDir := filepath.Join(outputDir, "blog", "category", catSlug)
os.MkdirAll(outDir, os.ModePerm)
outPath := filepath.Join(outDir, "index.html")
outFile, err := os.Create(outPath)
if err != nil {
fmt.Printf("Failed to create category page for %s: %v\n", catSlug, err)
continue
}
tpl.ExecuteTemplate(outFile, "category_page", map[string]interface{}{
"Title": "Category: " + strings.Title(strings.ReplaceAll(catSlug, "-", " ")),
"Posts": posts,
"Nav": nav,
"Year": time.Now().Year(),
"PageTemplate": "category_page",
})
fmt.Printf("Generated category: /blog/category/%s/\n", catSlug)
}
fmt.Println("✅ Site generation complete.")
}
// parseFrontMatter splits raw markdown into meta + content
func parseFrontMatter(raw []byte) (PageMeta, []byte) {
var meta PageMeta
// Normalize line endings
raw = bytes.ReplaceAll(raw, []byte("\r\n"), []byte("\n"))
// Only try to parse if the file starts with "---\n"
if bytes.HasPrefix(raw, []byte("---\n")) {
// Split after the first two "---\n" lines
parts := bytes.SplitN(raw, []byte("---\n"), 3)
if len(parts) >= 3 {
// parts[0] = empty (before first ---)
// parts[1] = YAML content
// parts[2] = remaining markdown content
if len(parts) == 3 {
err := yaml.Unmarshal(parts[1], &meta)
if err != nil {
fmt.Printf("⚠️ Failed to parse front matter: %v\n", err)
@@ -208,26 +207,39 @@ func parseFrontMatter(raw []byte) (PageMeta, []byte) {
}
}
// If there's no front matter, return raw as-is
return meta, raw
}
// buildBlogIndex generates the blog index page
func buildBlogIndex(posts []PageMeta, tpl *template.Template, outputDir string, nav []NavItem) error {
func buildBlogIndex(posts []PageMeta, tpl *template.Template, outputDir string, nav []NavItem) {
outPath := filepath.Join(outputDir, "blog", "index.html")
os.MkdirAll(filepath.Dir(outPath), os.ModePerm)
outFile, err := os.Create(outPath)
if err != nil {
return err
fmt.Println("Failed to create blog index:", err)
return
}
data := map[string]interface{}{
"Title": "Go SSG - Blog",
"Posts": posts,
"Nav": nav,
"Year": time.Now().Year(),
}
return tpl.Execute(outFile, data)
fmt.Printf("Rendering blog index: %d posts\n", len(posts))
tpl.ExecuteTemplate(outFile, "blog_index_page", map[string]interface{}{
"Title": "Blog Index",
"Posts": posts,
"Nav": nav,
"Year": time.Now().Year(),
"PageTemplate": "blog_index",
})
}
func slugify(s string) string {
s = strings.ToLower(s)
s = slugRegex.ReplaceAllString(s, "-")
return strings.Trim(s, "-")
}
func templateFuncs() template.FuncMap {
return template.FuncMap{
"lower": strings.ToLower,
"slugify": slugify,
"urlquery": template.URLQueryEscaper,
}
}

View File

@@ -1,40 +1,43 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Go SSG - About</title>
<meta name="description" content="More About My Go SSG Site.">
</head>
<body>
<header>
<nav>
<ul>
<header>
<nav>
<ul>
<li><a href="/about/">About</a></li>
<li><a href="/">Index</a></li>
<li><a href="/blog/">Blog</a></li>
</ul>
</nav>
</header>
</ul>
</nav>
</header>
<main>
<small>Published: 2025-04-19</small>
<h1>About</h1>
<article>
<h1>Go SSG - About</h1>
<h1>About</h1>
<p>Experimenting with Go. Seems pretty cool so far!</p>
</article>
</main>
</main>
<footer>
<p>&copy; 2025 Keith Solomon - Go SSG</p>
</footer>
<footer>
<p>&copy; 2025 Keith Solomon</p>
</footer>
</body>
</html>

View File

@@ -0,0 +1,68 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Go SSG - Another Blog Post</title>
</head>
<body>
<header>
<nav>
<ul>
<li><a href="/about/">About</a></li>
<li><a href="/">Index</a></li>
<li><a href="/blog/">Blog</a></li>
</ul>
</nav>
</header>
<main>
<article>
<h1>Go SSG - Another Blog Post</h1>
<p><small>2025-04-19</small></p>
<p>
Categories:
<a href="/blog/category/go/">go</a>
,
<a href="/blog/category/anger/">anger</a>
</p>
<h1>Why isn&rsquo;t this working?! 😭</h1>
<p>This is my first Go SSG blog post.</p>
<p>This project is a simple static site generator written in Go. It is designed to be easy to use and extend, allowing you to create a static website quickly and efficiently.</p>
<p>It supports features like:</p>
<ul>
<li>Markdown content</li>
<li>Customizable templates</li>
<li>Simple configuration</li>
</ul>
</article>
</main>
<footer>
<p>&copy; 2025 Keith Solomon - Go SSG</p>
</footer>
</body>
</html>

View File

@@ -0,0 +1,42 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Category: Anger</title>
</head>
<body>
<header>
<nav>
<ul>
<li><a href="/about/">About</a></li>
<li><a href="/">Index</a></li>
<li><a href="/blog/">Blog</a></li>
</ul>
</nav>
</header>
<main>
<h1>Category: Anger</h1>
<ul>
<li><a href="/blog/another-blog-post/">Go SSG - Another Blog Post</a><br>A longer summary of the post. Lorem ipsum dolor set amit.</li>
</ul>
</main>
<footer>
<p>&copy; 2025 Keith Solomon - Go SSG</p>
</footer>
</body>
</html>

View File

@@ -0,0 +1,44 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Category: Go</title>
</head>
<body>
<header>
<nav>
<ul>
<li><a href="/about/">About</a></li>
<li><a href="/">Index</a></li>
<li><a href="/blog/">Blog</a></li>
</ul>
</nav>
</header>
<main>
<h1>Category: Go</h1>
<ul>
<li><a href="/blog/another-blog-post/">Go SSG - Another Blog Post</a><br>A longer summary of the post. Lorem ipsum dolor set amit.</li>
<li><a href="/blog/my-first-blog-post/">Go SSG - My First Blog Post</a><br>A short summary of the post.</li>
</ul>
</main>
<footer>
<p>&copy; 2025 Keith Solomon - Go SSG</p>
</footer>
</body>
</html>

View File

@@ -0,0 +1,42 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Category: Progrmming</title>
</head>
<body>
<header>
<nav>
<ul>
<li><a href="/about/">About</a></li>
<li><a href="/">Index</a></li>
<li><a href="/blog/">Blog</a></li>
</ul>
</nav>
</header>
<main>
<h1>Category: Progrmming</h1>
<ul>
<li><a href="/blog/my-first-blog-post/">Go SSG - My First Blog Post</a><br>A short summary of the post.</li>
</ul>
</main>
<footer>
<p>&copy; 2025 Keith Solomon - Go SSG</p>
</footer>
</body>
</html>

View File

@@ -1,50 +1,44 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Go SSG - Blog</title>
<title>Blog Index</title>
</head>
<body>
<header>
<nav>
<ul>
<header>
<nav>
<ul>
<li><a href="/about/">About</a></li>
<li><a href="/">Index</a></li>
<li><a href="/blog/">Blog</a></li>
</ul>
</nav>
</header>
</ul>
</nav>
</header>
<main>
<h1>Blog Index</h1>
<ul>
<li><a href="/blog/another-blog-post/">Go SSG - Another Blog Post</a><br>A longer summary of the post. Lorem ipsum dolor set amit.</li>
<li><a href="/blog/my-first-blog-post/">Go SSG - My First Blog Post</a><br>A short summary of the post.</li>
</ul>
</main>
<section>
<h2>Blog Posts</h2>
<ul>
<li>
<a href="/blog/my-first-blog-post/">Go SSG - My First Blog Post</a>
<small>2025-04-19</small><br>
A short summary of the post.
</li>
</ul>
</section>
</main>
<footer>
<p>&copy; 2025 Keith Solomon - Go SSG</p>
</footer>
<footer>
<p>&copy; 2025 Keith Solomon</p>
</footer>
</body>
</html>

View File

@@ -1,40 +1,68 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Go SSG - My First Blog Post</title>
<meta name="description" content="A short summary of the post.">
</head>
<body>
<header>
<nav>
<ul>
<header>
<nav>
<ul>
<li><a href="/about/">About</a></li>
<li><a href="/">Index</a></li>
<li><a href="/blog/">Blog</a></li>
</ul>
</nav>
</header>
</ul>
</nav>
</header>
<main>
<small>Published: 2025-04-19</small>
<h1><em>Tap Tap Tap</em> Is this thing on?</h1>
<article>
<h1>Go SSG - My First Blog Post</h1>
<p><small>2025-04-19</small></p>
<p>This is my first blog post!</p>
<p>
Categories:
<a href="/blog/category/progrmming/">progrmming</a>
,
<a href="/blog/category/go/">go</a>
</p>
<h1><em>Tap Tap Tap</em> Is this thing on?</h1>
</main>
<p>This is my first Go SSG blog post.</p>
<p>This project is a simple static site generator written in Go. It is designed to be easy to use and extend, allowing you to create a static website quickly and efficiently.</p>
<p>It supports features like:</p>
<ul>
<li>Markdown content</li>
<li>Customizable templates</li>
<li>Simple configuration</li>
</ul>
</article>
</main>
<footer>
<p>&copy; 2025 Keith Solomon - Go SSG</p>
</footer>
<footer>
<p>&copy; 2025 Keith Solomon</p>
</footer>
</body>
</html>

View File

@@ -1,40 +1,43 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Go SSG - Home</title>
<meta name="description" content="My Go SSG Site.">
</head>
<body>
<header>
<nav>
<ul>
<header>
<nav>
<ul>
<li><a href="/about/">About</a></li>
<li><a href="/">Index</a></li>
<li><a href="/blog/">Blog</a></li>
</ul>
</nav>
</header>
</ul>
</nav>
</header>
<main>
<small>Published: 2025-04-19</small>
<h1>Welcome</h1>
<article>
<h1>Go SSG - Home</h1>
<h1>Welcome</h1>
<p>This is your first static site built with Go!</p>
</article>
</main>
</main>
<footer>
<p>&copy; 2025 Keith Solomon - Go SSG</p>
</footer>
<footer>
<p>&copy; 2025 Keith Solomon</p>
</footer>
</body>
</html>

28
templates/base.html Normal file
View File

@@ -0,0 +1,28 @@
{{ define "base" }}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>{{ .Title }}</title>
</head>
<body>
{{ template "header" . }}
<main>
{{- if eq .PageTemplate "blog_index" -}}
{{ template "blog_index_content" . }}
{{- else if eq .PageTemplate "static" -}}
{{ template "static_content" . }}
{{- else if eq .PageTemplate "blog_post" -}}
{{ template "blog_post_content" . }}
{{- else if eq .PageTemplate "category_page" -}}
{{ template "category_content" . }}
{{- else -}}
<p>Unknown PageTemplate: {{ .PageTemplate }}</p>
{{- end -}}
</main>
{{ template "footer" . }}
</body>
</html>
{{ end }}

View File

@@ -0,0 +1,14 @@
{{ define "blog_index_page" }}
{{ template "base" . }}
{{ end }}
{{ define "blog_index_content" }}
<h1>Blog Index</h1>
<ul>
{{ range .Posts }}
<li><a href="/blog/{{ .Slug }}/">{{ .Title }}</a><br>{{ .Description }}</li>
{{ else }}
<li>No posts found.</li>
{{ end }}
</ul>
{{ end }}

View File

@@ -0,0 +1,22 @@
{{ define "blog_post_page" }}
{{ template "base" . }}
{{ end }}
{{ define "blog_post_content" }}
<article>
<h1>{{ .Title }}</h1>
{{ if .Date }}<p><small>{{ .Date }}</small></p>{{ end }}
{{ if .Categories }}
<p>
Categories:
{{ range $i, $cat := .Categories }}
{{ if $i }}, {{ end }}
<a href="/blog/category/{{ $cat | slugify }}/">{{ $cat }}</a>
{{ end }}
</p>
{{ end }}
{{ .Content }}
</article>
{{ end }}

View File

@@ -0,0 +1,12 @@
{{ define "category_page" }}
{{ template "base" . }}
{{ end }}
{{ define "category_content" }}
<h1>{{ .Title }}</h1>
<ul>
{{ range .Posts }}
<li><a href="/blog/{{ .Slug }}/">{{ .Title }}</a><br>{{ .Description }}</li>
{{ end }}
</ul>
{{ end }}

5
templates/footer.html Normal file
View File

@@ -0,0 +1,5 @@
{{ define "footer" }}
<footer>
<p>&copy; {{ .Year }} Keith Solomon - Go SSG</p>
</footer>
{{ end }}

11
templates/header.html Normal file
View File

@@ -0,0 +1,11 @@
{{ define "header" }}
<header>
<nav>
<ul>
{{ range .Nav }}
<li><a href="{{ .URL }}">{{ .Title }}</a></li>
{{ end }}
</ul>
</nav>
</header>
{{ end }}

View File

@@ -1,46 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>{{ .Title }}</title>
{{ if .Description }}<meta name="description" content="{{ .Description }}">{{ end }}
</head>
<body>
<header>
<nav>
<ul>
{{ range .Nav }}
<li><a href="{{ .URL }}">{{ .Title }}</a></li>
{{ end }}
</ul>
</nav>
</header>
<main>
{{ if .Date }}<small>Published: {{ .Date }}</small>{{ end }}
{{ .Content }}
{{ if .Posts }}
<section>
<h2>Blog Posts</h2>
<ul>
{{ range .Posts }}
<li>
<a href="/blog/{{ .Slug }}/">{{ .Title }}</a>
{{ if .Date }} <small>{{ .Date }}</small>{{ end }}<br>
{{ .Description }}
</li>
{{ end }}
</ul>
</section>
{{ end }}
</main>
<footer>
<p>&copy; {{ .Year }} Keith Solomon</p>
</footer>
</body>
</html>

View File

@@ -0,0 +1,10 @@
{{ define "static_page" }}
{{ template "base" . }}
{{ end }}
{{ define "static_content" }}
<article>
<h1>{{ .Title }}</h1>
{{ .Content }}
</article>
{{ end }}