Watch
1
0
Fork
You've already forked myjournal-go-course
0
Go lernen am Praxisprojekt: eine Journal-App als Webanwendung, Kapitel für Kapitel. Ohne Framework, nur Standardbibliothek, SQLite und classless.css.
  • Go 69.7%
  • CSS 23.6%
  • Go Template 6.5%
  • HTML 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
cblte c03be2c954 Fix stale handleInfo step and release Ctrl+C after shutdown starts
handleInfo already logs its error since the chapter 2 fix, so chapter 15
now replaces twelve identical pairs instead of treating it separately.

run calls stop() right after the select, so a second Ctrl+C during a
hanging shutdown terminates the program immediately.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 07:23:36 +01:00
course Fix stale handleInfo step and release Ctrl+C after shutdown starts 2026-11-18 07:23:36 +01:00
.gitignore Set up the course as an mdBook 2026-10-23 23:42:28 +02:00
book.toml Set up the course as an mdBook 2026-10-23 23:42:28 +02:00
PLAN.md Add course scaffold and chapter 0: setup 2026-10-08 17:33:49 +02:00
README.md Add chapters 14 and 15: packages, methods, interfaces; middleware, logging, shutdown 2026-11-17 16:57:26 +01:00

MyJournal: Go-Praxiskurs

Ein Kurs in Kapiteln: Go lernen, indem man eine Journal-App als Webanwendung baut. Ohne Framework, mit der Standardbibliothek, SQLite und classless.css.

So funktioniert der Kurs

  • Die Kapitel liegen als Markdown in course/. Du liest ein Kapitel und tippst den Code selbst, in einem eigenen Projektordner außerhalb dieses Repos (im Kurs: ~/dev-go/myjournal-code).
  • Jedes Kapitel besteht aus kleinen Schritten. Nach jedem Schritt gibt es einen Zwischenstand, den du im Browser oder Terminal prüfen kannst.
  • Es gibt genau eine Code-Linie: Kapitel N+1 beginnt exakt mit dem Stand, mit dem Kapitel N endet. Es gibt keine Übungen, die den Code verzweigen. Am Ende jedes Kapitels sicherst du deinen Stand mit einem Commit und einem Git-Tag (kapitel-01, kapitel-02, …).
  • Zu jedem Kapitel gibt es einen Referenzordner course/chapter-NN/ mit dem vollständigen Stand am Kapitelende. Er hat ein eigenes go.mod und läuft für sich: cd course/chapter-01 && go run .. Nutze ihn zum Abgleich, wenn etwas nicht läuft. Dieses Repo enthält nur den Kurs, deinen eigenen Code nicht.

Als Buch lesen

Der Kurs lässt sich mit mdBook als Buch mit Navigation und Suche anzeigen:

mdbook serve --open

Das Buch ist dann unter http://localhost:3000 erreichbar und lädt bei Änderungen an den Kapiteln automatisch neu. mdbook build erzeugt die statischen Seiten im Ordner book/. Installation: brew install mdbook oder cargo install mdbook, siehe Installationsanleitung.

Konventionen

  • Code auf Englisch: Bezeichner, Dateinamen, Routen, Tabellen- und Spaltennamen in der Datenbank.
  • Kommentare und Texte in der Oberfläche auf Deutsch.
  • Sicherheit von Anfang an: Auto-Escaping in Templates, Platzhalter in SQL, schreibende Aktionen nur per POST.

Kapitel

Fertig:

  1. Einrichtung
  2. Die Go-Werkbank & Hello Server (Code: course/chapter-01/)
  3. Go Basics im Web (Code: course/chapter-02/)
  4. Templates & classless.css (Code: course/chapter-03/)
  5. Tests & Werkzeuge (Code: course/chapter-04/)
  6. SQLite und database/sql (Code: course/chapter-05/)
  7. Das Formular „Neuer Eintrag“ (Code: course/chapter-06/)
  8. Formular verarbeiten, prüfen und speichern (Code: course/chapter-07/)
  9. Detailansicht, Empty State und 404 (Code: course/chapter-08/)
  10. Markdown mit goldmark (Code: course/chapter-09/)
  11. Pagination (Code: course/chapter-10/)
  12. Bearbeiten und Löschen (Code: course/chapter-11/)
  13. Quick Capture (Code: course/chapter-12/)
  14. Tags (Code: course/chapter-13/)
  15. Pakete, Methoden, Interfaces (Code: course/chapter-14/)
  16. Middleware, Logging, sauberes Herunterfahren (Code: course/chapter-15/)

Geplant (vorläufig):

  1. On This Day
  2. Suche
  3. Statistik
  4. Login und Sessions
  5. Datei-Uploads
  6. Konfiguration, embed, go build, eine Binary
  7. Bonus: Desktop-Fenster mit Wails

Fremder Code

classless.css stammt von classless.de (GitHub) und steht unter der MIT-Lizenz.