diff --git a/README.md b/README.md index 63187b1..f99a56c 100644 --- a/README.md +++ b/README.md @@ -41,6 +41,8 @@ buildbroken-blog-archive/ ├── hugo.toml # Hugo-Konfiguration ├── content/ │ ├── _index.md # Startseite (About-Text liegt hier, kein eigenes /about/) +│ ├── categories/ # pro Kategorie eine _index.md mit Einleitungstext +│ ├── tags/ # pro Tag eine _index.md mit Einleitungstext │ └── posts/ # wird vom Parser mit *.md befüllt ├── layouts/ # eigenes Theme, angelehnt an das Original-Design │ ├── _default/baseof.html @@ -149,12 +151,50 @@ Das Layout erzeugt für jede Seite automatisch SEO-Metadaten (zentral in - Open-Graph- und Twitter-Card-Tags (`og:type` article/website, `og:image` Banner, `twitter:card` summary_large_image) - ``: Tag- und Kategorie-Seiten werden differenziert (`MVC (Tag)` vs. `MVC (Kategorie)`), Länge auf ~60 Zeichen begrenzt +Für die Startseite wird ein eigener `<title>` über `params.homeTitle` in +`hugo.toml` konfiguriert (statt nur dem bloginfo `title`). Die Description +der Startseite kommt aus `params.description`. + Außerdem: - Eigene `layouts/_default/404.html`, die via `assets.not_found_handling: "404-page"` von Cloudflare ausgeliefert wird - `robots.txt` verweist auf `sitemap.xml` (Hugo-generiert) - Content-Bilder in `content/posts/*.md` tragen `alt`-Attribute; der dekorative Banner hat bewusst leeres `alt=""` +## Kategorien & Tags + +Kategorie- und Tag-Seiten können individuelle Einleitungstexte haben. Dafür +legt man in `content/categories/<name>/_index.md` bzw. `content/tags/<name>/_index.md` +eine Datei mit Front Matter und Body-Text an: + +```markdown +--- +title: "Clean Code Developing" +--- + +Die Grundlage unserer Arbeit: SOLID, DRY, Refactoring und professionelle Software-Entwicklung. +``` + +Der `title` in der Front Matter bestimmt die `<h2>`-Überschrift auf der Seite. +**Wichtig:** Die Groß-/Kleinschreibung muss korrekt sein (z.B. `C#`, `MVC`, +`Visual Studio`), da Hugo den slug automatisch kleinschreibt (URL: `/tags/c#/`). + +Der Body-Text wird als `<div class="archive-intro">` zwischen Überschrift und +Artikelliste gerendert (via `layouts/_default/term.html`). Ohne Body-Text +wird kein `<div>` generiert — die Seiten funktionieren auch ohne Einleitungstexte. + +Aktuelle Kategorien (17): Architektur, BarCamp, Clean Code Developing, How-To, +MVC, Open Space, Pattern, prio.conference, Release, Scrum, StupidDB, Tipps, +Unit Testing, Veranstaltung, Visual Studio Addins, Webanwendungen, Webservice. + +Aktuelle Tags (43): Addin, Architektur, ASP-Classic, Assemblies, Assembly, +Basics, Buch, Buchempfehlung, C#, CCD, Clean Code, Coding, Community, +Contract-First, Datenbank, Datenschutz, Facebook, HowTo, HTML, MVC, MVP, +NoSQL, Open Space, Patterns, Plug-In, prio.conference, Refaktorisierung, +Reflection, Schemalos, SCRUM, Social Web, Sonne, Sourcecode, StupidDB, +Unit Tests, Veranstaltung, Visual Studio, Webapplication, WebCamp, WebCast, +Webservice, WinForms, Wordpress. + ## Layout anpassen Alle Design-Änderungen passieren zentral in `layouts/_default/*.html` und