Temaer i Hugo er forhåndsdesignede sett med maler og stilregler som gir et visuelt rammeverk for nettsteder bygget med Hugo. PaperMod er et populært Hugo-tema som fokuserer på lesbarhet, modernitet og tilpasningsvennlighet. Med et minimalistisk design og en rekke tilpasningsalternativer gjør PaperMod det enkelt å skape estetisk tiltalende statiske nettsteder med støtte for mørk modus, brede skjermer og annet avansert funksjonalitet.

Her beskrives et sett med enkle konfigurasjoner som gjøres for å få opp en grei basic funksjonalitet med PaperMod. Konfigurasjoner gjøres primært i hugo.yaml

Params

  • ShowCodeCopyButtons - gir en enkel mulighet for å kopiere innholdet av kodeblokker.
  • ShowBreadCrumbs - Viser hvor i “hierarkiet” en artikkel ligger, f.eks. Home > Posts
  • showPostNavLinks - Viser link i bunnen av en artikkel til forrige og neste artikkel, vist som previous og next.
  • ShowReadingTime - viser antall minutter det tar å lese artikkelen under tittelen, f.eks. 3 min.
  • showToc - viser “table of contents” i toppen av artikkelen basert på markdown headers.

Disse legges til i hugo.yaml som:

params:
  ShowBreadCrumbs: true
  ShowCodeCopyButtons: true
  showPostNavLinks: true
  ShowReadingTime: true
  showToc: true

Legge til en meny for kategorier og tags.

I hugo.yaml legger vi til følgende:

menu:
  main:
    - identifier: categories
      name: categories
      url: /categories/
      weight: 10
    - identifier: tags
      name: tags
      url: /tags/
      weight: 20

Menyelementene categories og tags vil da dukke opp øverst til høyre. For å legge til innhold kan du tagge artiklene med disse nøkkelordene, f.eks slik:

tags: ['hugo', 'papermod']
categories: ['teknologi']

Disse menyene vil nå fungere “ut av boksen”, og vil liste opp alle artikkeler med de forskjellige taggene eller kategoriene som blir spesifisert. Dette gjøres med den innebygde taxonomies funksjonaliteten til Hugo.

Legge til en arkiv meny

For PaperMod er det definert en layout archives.html for et arkiv, som sorterer arkivet på år og måned.

Så for å legge til en ny meny for arkiv gjør vi det på samme måte som for tags og categories, og legger til følgende som et nytt menyelement:

- identifier: archives
  name: archives
  url: /archives/
  weight: 30

I tillegg må vi opprette en fil content/archives.md med følgende innhold:

---
title: "Archives"
layout: "archives"
url: "/archives/"
summary: "archives"
type: "archives"
---

Du vil nå se en arkivmeny som viser alle dine artikler.