BlogAMore

Blogging and more, ein einfaches Theme für Hugo, mit dem einfach Blogging-Webseiten erstellt werden können und noch weitere Webseiten mit dargestellt werden.

Dieses Theme wurde für meine eigene Webseite entworfen und dort verwendet.

Features

• Responsive design
• Seitenleiste

Installation

In deinen Projektverzeichnis nachfolgenden Befehl ausführen:

git clone https://gitea.marcodn.de/mdn/blogamore.git themes/blogamore

Wenn Sie keine größeren Änderungen planen, aber das Thema verfolgen und aktualisieren möchten, können Sie es als git Submodul mit dem folgenden Befehl hinzufügen:

git submodule add https://gitea.marcodn.de/mdn/blogamore.git themes/blogamore

Als nächstes öffnen Sie config.toml in der Basis der Hugo-Site und stellen sicher, dass die Theme-Option auf BlogAMore gesetzt ist:

theme = "BlogAMore"

Konfiguration

config.toml Beispiel

baseURL = '/'
languageCode = 'de-DE'
title = 'Blogging and more'
paginate = 12
theme = "BlogAMore"

[taxonomies]
  tag = "tags"
  category = "categories"
  skill = "skills"
  # Weitere Kategorien die benötigt werden
  mood = "moods"

[markup]
  [markup.highlight]
    noClasses = false 

[permalinks]
  # Blog immer über Jahreszahl gruppieren
  blog = "/blog/:year/:slug"

[Params]
  # Beschreibung das Webseitenbesitzers, für die Seitenleiste
  avatar = "/img/author.jpg"
  author = "Beispiel Autor"
  description = "Eine Beschreibung des Autors, als kurze Zusammenfassung"

  # Dateiname der den aktuellen Commit-Hash entält, sowie die Basis-url des Repo, damit im Footer der aktuelle Hash angezeigt wird, die Datei muss dann am besten über das Published-Script erzeugt werden
  gitHashFile = "commit_id.txt"
  gitRepoUrl = "http://example.com"

  # Zusätzliche CSS und JS-Dateien
  custom_css = []
  custom_js = []

[Params.Blog]
  # Definition der Taxonomie an der Seitenleiste dargestellt werden sollen
  tags = "tags"
  categories = "categories"

[Params.KnowHow]
  skills = "skills"

[Params.Social]
  # Links zur erreichbarkeit des Autors
  Email         = "email@example.com"
  Phone         = "+49 (0) 1234 56789"
  VoIP          = "main_kontakt@main_voip_anbieter.de"
  Github        = "username"
  Twitter       = "username"
  LinkedIn      = "username"
  matrix        = "@mdn:synapse.marcodn.de"
  RSS           = "/blog/index.xml"

[menu]
  # Definition des Hauptmenüs (Die Icons sind via Pre definiert, hierbei wird [FeatherIcons](https://feathericons.com) verwendet)
  [[menu.main]]
    name = "Posts"
    pre = "pen-tool"
    url = "/posts/"
    weight = 100
  [[menu.main]]
    name = "Blog"
    pre = "pen-tool"
    url = "/blog/"
    weight = 200
  [[menu.main]]
    name = "Tags"
    pre = "tag"
    url = "/tags/"
    weight = 300

Kopieren Sie die Beispielkonfiguration nicht in der vorliegenden Form. Verwenden Sie nur die Parameter, die Sie benötigen.

Für weitere Informationen über alle verfügbaren Standardkonfigurationseinstellungen lesen Sie bitte Alle Hugo-Konfigurationseinstellungen.

Dateiaufbau

cooming soon...

Zum erstellen der Index-Seite für die Jahresarchive, geben Sie bitte folgenden Befehl an:

hugo new --kind archive blog/2022/_index.md

Hierbei ist bitte der Hauptordner, sowie der Jahresordner an die entsprechenden anzupassen.

Beispiele für die Hauptseite

cooming soon...

Beispiel für einen Blogeintrag

---
title: "Beispiel Eintrag"
date: 2019-11-07T19:28:01+01:00
publishDate: 2019-11-10
lastmod: 2019-12-06
draft: true
featured: true
author: "mdn"
slug: "first" # Definition des Dateinamens
tags: [ "tag1" ]
categories: [ "cat1" ]
---

hier die Zusammenfassung

<!--more-->

Und hier der weitere Artikel

Hierfür kann auch die Vorlage für Blog verwendet werden.

Beispiel für eine Beschreibung zur Taxonomy

Zum erstellen der Datei mit der ein Term in der Taxonomy beschrieben werden kann, wird folgender Befehl verwendet (Taxonomy und Term müssen entsprechend angepasst werden):

hugo new tags/tag1/_index.md

In der Datei kann nun die Beschreibung und der Titel angepasst werden. Sollte man eigene Taxonomies verwenden, wird geraten eine eigene Vorlage zu definieren. Diese ist unte archetypes zu definieren, der Name ist die Pluralform mit ".md" am Ende und es sollte folgenden Inhalt haben:

---
title: {{ $term := path.Base .File.Dir }}"{{ replace $term "-" " " | title }}"
description: "Dies ist eine Beschreibung für {{ $term | title }}"
date: {{ now.Format "2006-01-02" }}
---

Weiteres

Haben Sie einen Fehler gefunden oder eine Idee für ein neues Feature? Schicken Sie mir bitte eine Mail an ... Oder erstellen Sie direkt einen Pull Request

Lizenz

Diese Thema ist unter der LGPLv3 Lizenz freigegeben.