Docs on Martijn's Notes

Windows Server 2022 Home Lab — AD DS, DNS, CA en Beveiligde RDP

Thu, 02 Apr 2026 10:00:00 +0200

Dit artikel beschrijft de volledige opbouw van een twee-server Windows Server 2022 home lab in Proxmox VE. Samen leveren de twee virtuele machines Active Directory Domain Services, DNS, Group Policy en een Certificate Authority (ADCS). RDP-verbindingen worden beveiligd met PKI-certificaten, zodat de Mac Mini M1 als beheerstation zonder certificaatwaarschuwingen verbinding maakt.

Dit is deel 3 van de serie over het opbouwen van een Windows DevOps lab in Proxmox. In deel 1 beschrijf ik hoe je een VM aanmaakt en in deel 2 hoe je de template voorbereidt.

Windows Server 2022 in Proxmox — Template Voorbereiding

Tue, 31 Mar 2026 10:00:00 +0200

Download als Word document

Dit is deel 2 van de serie over het opbouwen van een Windows DevOps lab in Proxmox. In deel 1 heb ik beschreven hoe je de VM aanmaakt. In dit artikel bereid ik de VM voor als herbruikbare Proxmox template. Alle toekomstige VMs — de CA server, member servers en andere rollen — worden vanuit deze template gekloond.

Belangrijk: Start de VM na Sysprep nooit opnieuw op. Als je dat doet wordt de generalisatie verbruikt en moet de template opnieuw worden opgebouwd.

Windows Server 2022 in Proxmox — Een VM Aanmaken

Mon, 30 Mar 2026 10:00:00 +0200

Download als Word document

In dit artikel beschrijf ik stap voor stap hoe ik een Windows Server 2022 VM aanmaak in Proxmox VE 9.1.6. De handleiding is gebaseerd op praktijkervaring en bevat alle correcties en lessen die ik onderweg heb opgedaan. Dit is deel 1 van een serie over het opbouwen van een volledig Windows DevOps lab in Proxmox.

Laboratoriumomgeving

Onderdeel	Waarde
Proxmox host	macpro2013.local — Mac Pro 2013 Trashcan
Proxmox versie	9.1.6
RAM	128 GB
Opslag	3.6 TB NVMe (local-lvm pool)
Netwerkbridge	vmbr0 — intern lab netwerk (192.168.178.x)
Proxmox WebUI	https://192.168.178.205:8006

Waarom een CA nodig is — de SSL waarschuwing

Wie de Proxmox WebUI via macpro2013.local opent in Safari krijgt meteen een certificaatwaarschuwing. Proxmox gebruikt standaard een zelfondertekend certificaat.

Windows Server 2022 — Active Directory en DNS installatie

Fri, 27 Mar 2026 00:00:00 +0100

In dit artikel beschrijf ik stap voor stap hoe ik Active Directory Domain Services (AD DS) en DNS heb geïnstalleerd op een Windows Server 2022 Datacenter VM in een VMware Fusion lab omgeving. Het resultaat is een volledig functionele domeincontroller voor het domein lab.local, als basis voor een Windows DevOps lab.

Omgeving

Onderdeel	Waarde
Virtualisatie	VMware Fusion (macOS)
Gastbesturingssysteem	Windows Server 2022 Datacenter (Desktop Experience)
Hostnaam	DC01
Domeinnaam	lab.local
NetBIOS naam	LAB
Lab-netwerk adapter	Ethernet1 — 172.16.37.10 (vast IP)
Internet adapter	Ethernet0 — DHCP via VMware NAT

Stap 1 — Netwerk instellen

Voordat Active Directory wordt geïnstalleerd, heeft de domeincontroller een vast (statisch) IP-adres nodig. AD DS en DNS zijn afhankelijk van een stabiel adres.

Windows Packet Capturing voor LDAPS Analyse

Sun, 18 Jan 2026 20:19:01 +0100

LDAPS-connectiviteit Problemen Oplossen: Gebruik Ingebouwde Windows-tools om Firewall-naleving te Controleren

Naarmate organisaties overstappen naar een veiligere infrastructuur, is de migratie van standaard LDAP (Poort 389) naar LDAPS (Poort 636) een cruciale stap. Deze overgang brengt echter vaak “stille” fouten aan het licht, waarbij een netwerkfirewall de initiële verbinding wel toestaat, maar de daaropvolgende SSL/TLS-handshake blokkeert.

Bij Van den Boom Online begrijpen we dat een soepele gebruikerservaring begint bij een robuuste backend. In deze handleiding laten we zien hoe u packet capturing uitvoert met uitsluitend ingebouwde Windows-tools om te controleren of uw verkeer de bestemming bereikt of wordt tegengehouden door beveiligingsapparatuur.

Installeer Ansible AWX 24.6.1 in Minikube op Ubuntu 24.04.2 LTS in een enkele VM

Wed, 02 Jul 2025 13:35:25 +0200

Create a Ubuntu Virtual Machine with:
32 GB RAM
8 cores
120 GB HD

Stap-voor-stap: Installeer AWX 24.6.1 on Minikube (Ubuntu 24.04.2 LTS)

🔧 1. Voorzien van nieuwste software

1$ sudo apt update && sudo apt upgrade -y
2$ sudo apt install -y curl wget apt-transport-https ca-certificates gnupg lsb-release software-properties-common
3$ sudo timedatectl set-timezone Europe/Amsterdam

📦 2. Installeer Docker (Minikube backend)

 1$ curl -fsSL https://get.docker.com | sudo bash
 2$ sudo usermod -aG docker $USER
 3$ newgrp docker  # Activate group without reboot
 4
 5Enable en start Docker:
 6$ sudo systemctl enable docker
 7$ sudo systemctl start docker
 8
 9Test:
10$ docker run hello-world

🧱 3. Installeer Minikube

Installeer Red Hat Ansible Automation Platform 2.5 in een enkele VM

Sun, 29 Jun 2025 23:10:08 +0200

Let op: het is me nog niet gelukt om dit na een reboot weer netjes automatisch op te laten starten!
Misschien is het beter om het te installeren in Minikube?

Maak een Red Hat 9 Virtual Machine met:
32 GB RAM
8 cores
120 GB HD

1$ sudo hostnamectl hostname aap.vandenboom.local

Download the Ansible Automation Platform 2.5 Containerized Setup Bundle from: https://access.redhat.com/downloads/content/480/ver=2.5/rhel---9/2.5/x86_64/product-software

 1$ tar zxvf ansible*.tar.gz
 2
 3$ sudo vim /etc/hosts
 4localhost aap.vandenboom.local
 5
 6$ ping aap.vandenboom.local
 7
 8$ sudo dnf install -y podman git python3-pip rsync tar jq unzip
 9
10$ podman login registry.redhat.io
11
12$ sudo dnf install ansible-core wget
13
14$ python3 -m pip install virtualenv
15$ pip3 install ansible
16
17$ vim inventory
18Edit the settings as seen below
19
20$ time ansible-playbook -i inventory ansible.containerized_installer.install -K

Dit is de inhoud van het bestand: ./inventory

Een vergelijking van het resource gebruik van Kubernetes en OpenShift

Sat, 29 Mar 2025 15:15:43 +0100

Als je Kubernetes vergelijkt met OpenShift (de Kubernetes-gebaseerde platform van Red Hat), dan zijn er een paar belangrijke verschillen die invloed hebben op hoe ze omgaan met resourceverbruik en systeembronnen. Hoewel OpenShift gebouwd is op Kubernetes, zijn er verschillende toegevoegde functionaliteiten en verschillen die de resourcebehoeften beïnvloeden:

Extra Functionaliteiten in OpenShift OpenShift biedt meer out-of-the-box functionaliteit dan Kubernetes. Dit kan leiden tot een hogere overhead, maar ook tot meer gebruiksgemak en integratie:

Beveiliging: OpenShift voegt extra beveiligingslagen toe, zoals Security Context Constraints (SCC) en SELinux-beperkingen, wat extra resources kan vereisen voor de beveiliging van containers en applicaties.

De uitspraak 'pas op met Kubernetes, het verstookt je resources'

Sat, 29 Mar 2025 15:00:43 +0100

De uitspraak “pas op met Kubernetes, het verstookt je resources” verwijst naar het feit dat Kubernetes, hoewel een krachtige en flexibele oplossing voor het orkestreren van containerized applicaties, relatief veel systeembronnen (zoals CPU, geheugen en opslag) kan verbruiken.

Dit komt door verschillende factoren:

Kubernetes heeft een overhead: Kubernetes zelf draait als een cluster van verschillende componenten, zoals de API-server, scheduler, controller manager, en meer. Deze componenten draaien op de control plane en moeten beheerd worden. Dit voegt extra overhead toe aan je systeem, wat betekent dat de resources die Kubernetes zelf gebruikt, bovenop de applicaties die je daadwerkelijk runt, komen.

Golang / Go: De Slimme Programmeertaal voor Efficiënte Software en Concurrency

Sat, 22 Mar 2025 21:00:43 +0100

Concurrency klinkt misschien als een technisch begrip, maar het komt erop neer dat een programma meerdere taken tegelijk uitvoert, alsof het aan het multitasken is. Stel je voor dat je bezig bent met koken: terwijl je pasta op het vuur staat, zet je de wasmachine aan en laad je je telefoon op. Hoewel je niet alles op exact hetzelfde moment doet, gebeurt het wel vloeiend naast elkaar. Software die concurrency ondersteunt werkt net zo: een programma kan bijvoorbeeld tegelijkertijd bestanden downloaden, berekeningen maken en gegevens naar een server sturen. Dit multitasken maakt het gebruik van computerkracht efficiënter en zorgt voor snellere en soepelere prestaties.

Implementeer op het DigitalOcean-appplatform

Sun, 21 Jan 2024 15:00:19 +0800

Vereisten

DigitalOcean-account

Dockerbestand maken

Maak de Dockerfile aan in de hoofdmap van uw site.

Onze starter sjabloon bevat al de Dockerfile.

 1###############
 2# Build Stage #
 3###############
 4FROM hugomods/hugo:exts as builder
 5
 6COPY . /src
 7
 8ENV HUGO_ENV=production
 9
10# Base URL
11ARG HUGO_BASEURL=
12ENV HUGO_BASEURL=${HUGO_BASEURL}
13
14# Module Proxy
15ARG HUGO_MODULE_PROXY=
16ENV HUGO_MODULE_PROXY=${HUGO_MODULE_PROXY}
17
18# NPM mirrors, such as https://registry.npmmirror.com
19ARG NPM_CONFIG_REGISTRY=
20ENV NPM_CONFIG_REGISTRY=${NPM_CONFIG_REGISTRY}
21
22# Install dependencies
23RUN npm ci
24
25# Build site
26RUN hugo --minify --gc --enableGitInfo
27
28# Set the fallback 404 page if defaultContentLanguageInSubdir is enabled, please replace the `en` with your default language code.
29# RUN cp ./public/en/404.html ./public/404.html
30
31###############
32# Final Stage #
33###############
34FROM hugomods/hugo:nginx
35COPY --from=builder /src/public /site

De /site is de uitvoermap van statische bestanden, die later zal worden gebruikt.

App maken

Navigeer naar DigitalOcean Dashboard -> Left Panel -> Apps -> Create App en vul het formulier als volgt in.

Financieringswidget

Sun, 29 Jan 2023 19:44:19 +0800

De financieringswidget, ook wel de “buy me a coffee”-widget, biedt lezers een manier om een maker te ondersteunen.

Schakelaar

Sat, 21 Jan 2023 23:22:11 +0800

De toggle shortcode is vergelijkbaar met de code-toggle, maar is algemener.

Gebruik

1{{< toggle myToggleName >}}
2  
3  {{< toggle-item myToggleItemName >}}
4    CONTENT HERE, MARKDOWN and SHORTCODE are support.
5  {{< /toggle-item >}}
6
7  ...
8
9{{< /toggle >}}

De myToggleName MOET uniek zijn per pagina.
De myToggleItemName MOET uniek zijn per schakelaar.

Voorbeeld

Foo

Balk

1echo "Hallo wereld"

1console.log("hallo wereld")

1SELECTEER "Hallo wereld"

Algolia

Sun, 27 Nov 2022 19:53:12 +0800

Het zoeken door de client zal langzamer en langzamer worden naarmate de inhoud groeit. Het is redelijk om een zoekservice op afstand te hebben om zoekopdrachten van een grote site af te handelen.

Algolia is een populaire zoekservice die een gratis abonnement biedt (10.000 records, 10.000 verzoeken per maand). Na het lezen van dit artikel leert u hoe u Algolia configureert en automatisch indexbestanden uploadt.

Voorbereidingen

Eerst moet u een Algolia-account aanmaken en vervolgens uw aanvraag aanmaken.

IFrame-kortcode

Sat, 19 Nov 2022 13:00:48 +0800

Een gedetailleerde beschrijving van iframe-shortcode.

Gebruik

1{{< iframe "URL" >}}

of via benoemde parameters

1{{< iframe 
2    src="URL"
3    trigger=manual
4    loadButtonText="load_video"
5>}}

Parameter	Standaard	Beschrijving
`src`	-	De iframe-URL. Vereist.
`trigger`	`auto`	Stel het in als `manual` als u het iframe handmatig wilt laden.
`lazyLoading`	`true`
`loadButtonText`	`load`	De tekst van de laadknop, i18n, wordt ondersteund.
`loadInfo`	-	De informatie die onder de laadknop wordt weergegeven. Prijsverlaging wordt ondersteund.
`fullscreen`	`true`	Toon/Verberg de knop Volledig scherm.

Voorbeelden

OpenStreetMap

Spel

Houd er rekening mee dat het iframe het spel van andere sites zal laden.

Spelshortcode

Tue, 15 Nov 2022 21:16:48 +0800

Een gedetailleerde beschrijving van de game-shortcode.

Gebruik

1{{< game "GAME_URL" >}}

of via benoemde parameters

Parameter	Standaard	Beschrijving
`src`	-	De game-URL. Vereist.
`trigger`	`auto`	Stel het in als `manual` als je het spel handmatig wilt laden.
`loadInfo`	-	De informatie die onder de laadknop wordt weergegeven. Prijsverlaging wordt ondersteund.

1{{< game
2    src="GAME_URL"
3    trigger=manual
4    loadInfo="The Game Information."
5>}}

Voorbeelden

Automatisch laden

Handmatig laden

The Game Information.

Indeling van de landingspagina

Thu, 15 Sep 2022 10:46:23 +0800

In dit artikel zullen we het hebben over de lay-out van de landingspagina. Mogelijk bent u hierin geïnteresseerd als u de pagina’s op Markdown-manier gaat aanpassen.

Wat is het?

De lay-out van de landingspagina is slechts een skeletcontainer, de hoofdtekst bestaat uit drie delen: bovenste app-balk, pagina-inhoud en voettekst.

Voordelen

Schrijven van inhoud in Markdown.
Herbruikbare shortcodes.

Hoe gebruik je het?

Het is vrij eenvoudig om het te gebruiken. Geef gewoon type op als landing en sidebar als false op de voorkant van de pagina, de rest draait helemaal om uw inhoud.

Repository-widget

Fri, 09 Sep 2022 21:06:19 +0800

De repository-widget toont de commit-informatie over de huidige pagina. Dit is handig voor gebruikers die de broncode willen bekijken of bewerken.

Implementeren op GitLab-pagina's

Sat, 27 Aug 2022 10:30:23 +0800

In dit artikel wordt uitgelegd hoe u sites kunt implementeren op GitLab-pagina’s met behulp van GitLab CI.

Werkstroom

Maak .gitlab-ci.yml aan in de hoofdmap van uw site met de volgende inhoud:

 1image: registry.gitlab.com/pages/hugo/hugo_extended:latest
 2
 3variables:
 4  HUGO_ENV: production
 5
 6default:
 7  before_script:
 8    - apk add --update --no-cache git go npm
 9    - npm install
10
11test:
12  script:
13    - hugo --gc --minify
14  rules:
15    - if: $CI_COMMIT_REF_NAME != $CI_DEFAULT_BRANCH
16
17pages:
18  script:
19    - hugo --gc --minify
20  artifacts:
21    paths:
22      - public
23  rules:
24    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH

Het bovenstaande voorbeeld implementeert alleen de standaardvertakking naar GitLab Pages en voert een test uit op de rest van de vertakkingen.

Implementatieoverzicht

Wed, 27 Jul 2022 18:00:25 +0800

In deze sectie gaan we het hebben over de belangrijkste implementatiepunten om de meeste problemen tijdens de implementatie te voorkomen.

Bouwhulpmiddelen

Zoals Vereisten al zei, moet u deze tools instellen in uw implementatieomgeving.

Afhankelijkheden installeren

We gebruiken NPM voor het beheren van de afhankelijkheden van het thema. Het is noodzakelijk om de afhankelijkheden in de implementatieomgeving te installeren, omdat we MOET NIET de map node_modules vastleggen.

Lay-outs overschrijven

Wed, 27 Jul 2022 16:05:37 +0800

Volgens de Hugo Layouts Opzoekvolgorde is het gemakkelijk om de lay-outs en gedeeltelijke indelingen van Hugo en het thema te overschrijven. Het is handig voor gebruikers die bepaalde dingen van bepaalde lay-outs of gedeeltelijke lay-outs willen aanpassen.

Gebruik

Maak gewoon een lay-out of een gedeeltelijk bestand met dezelfde bestandsnaam die u onder de hoofdmap van de site wilt overschrijven.

Dit is hoe onze Haken werkt.

We kunnen bijvoorbeeld de paritale startpagina layouts/index.html overschrijven door onze eigen hoofdmap te maken.

Plakkerige Widgets

Wed, 27 Jul 2022 08:54:43 +0800

Wanneer een pagina erg lang is, verdwijnt de zijbalk bij het scrollen en ziet de pagina er minder netjes uit. Dit artikel beschrijft hoe je plakkerige widgets kunt gebruiken om dit probleem te voorkomen.

Meertalige modus

Wed, 27 Jul 2022 08:06:06 +0800

HBS ondersteunt standaard meerdere talen, zoals Engels, Vereenvoudigd Chinees, Traditioneel Chinees, Frans, Russisch, enz.

U kunt uw eigen vertalingen toevoegen op: knuffel-thema-bootstrap/i18n

Ondersteunde talen

Language	Code
English	`en`
Simplified Chinese	`zh-hans`(Recommended), `zh-cn`
Traditional Chinese	`zh-hant`(Recommended), `zh-tw`, `zh-hk`
Spanish	`es`
Arabic	`ar`
German	`de`
French	`fr`
Indonesian	`id`
Japanese	`ja`
Polish	`pl`
Portuguese	`pt`
Russian	`ru`
Ukrainian	`uk`
Uzbek	`uz`

Configuratie

config/_default/language.toml

CSS opschonen

Mon, 25 Jul 2022 12:06:00 +0800

De PurgeCSS is een geweldige tool die ongebruikte CSS van uw site verwijdert. In deze sectie gaan we dieper in op hoe de PurgeCSS werkt en waar we op moeten letten.

Hoe het werkt?

Voor PurgeCSS moet de volgende configuratie worden ingesteld.

config.toml

Prestatie

Sat, 23 Jul 2022 18:30:48 +0800

In dit artikel gaan we het hebben over hoe u de prestaties van uw sites kunt verbeteren.

De eenvoudigste manier om de prestaties te verbeteren is door de bestandsgrootte te verkleinen, zodat de overdracht sneller verloopt.

Milieu

Het thema is afhankelijk van de production-omgeving om de JavaScript- en CSS-items te verkleinen en ongebruikte CSS te verwijderen.

Standaardomgeving	Waarde
`hugo`	`production`
`hugo server`	`development`

Over het algemeen hoeft u geen wijzigingen aan te brengen, tenzij u van plan bent de hugo server in een production-omgeving te gebruiken. U kunt de standaardomgeving wijzigen met de vlag -e.

Evenementen

Sat, 23 Jul 2022 17:33:59 +0800

In deze artikelen worden enkele aangepaste gebeurtenissen vermeld die door het thema worden uitgezonden. U kunt deze gebeurtenissen bekijken via gebeurtenislisteners.

Kleurmodusgebeurtenis

HBS zal een aangepaste gebeurtenis uitzenden met de naam hbs:mode als de kleurmodus wordt gewijzigd. Het is handig om de stijl van uw widget aan te passen aan de themakleurmodus. De ingebouwde uitingen en Giscus-commentaarengines vertrouwen op deze gebeurtenis om hun thema aan te passen aan licht of donker.

SCSS-variabelen

Sat, 23 Jul 2022 17:23:28 +0800

Dankzij assets/main/scss/_variables.scss hebben we de mogelijkheid om de standaard SCSS-variabelen van thema en Bootstrap te wijzigen.

Waarom SCSS-variabelen?

Hoewel we de CSS kunnen overschrijven via assets/main/scss/_custom.scss, zal dit uiteindelijk de grootte van de CSS-bundel vergroten, maar de SCSS-variabele doet dit in de meeste gevallen niet.

Er is bijvoorbeeld een standaardanimatie voor het logo bij het aanwijzen van de muis.

1.top-app-bar .logo:hover {
2    transform: rotate(-5deg) scale(1.1);
3}

Het kan het uitschakelen via aangepaste SCSS.

Tekstshortcodes

Fri, 15 Jul 2022 01:00:43 +0800

In dit artikel zullen we enkele shortcodes voor tekst onderzoeken, zoals uitlijning, transformatie en selectie.

Teksttransformatie

kleine letters.

TEKST IN HOOFDLETTERS.

CapiTaliZed-tekst.

Tekstuitlijning

Lijn de tekst uit naar het begin.

Lijn de tekst uit in het midden.

Lijn de tekst uit tot het einde.

Tekstselectie

Deze paragraaf wordt volledig geselecteerd wanneer er door de gebruiker op wordt geklikt.

Deze paragraaf kan niet worden geselecteerd wanneer er door de gebruiker op wordt geklikt.

Een Docker-image bouwen

Wed, 13 Jul 2022 10:30:29 +0800

In dit artikel wordt gedetailleerd beschreven hoe u een Docker-image bouwt.

Principe

Gebruik Hugo om de site te bouwen en statische bestanden te genereren.
Gebruik Nginx als server om verzoeken af te handelen.

Dockerbestand

Maak een Dockerfile in de hoofdmap van de site.

 1###############
 2# Build Stage #
 3###############
 4FROM razonyang/hugo as builder
 5
 6WORKDIR /src
 7COPY . /src
 8
 9ARG HUGO_ENV=production
10ENV HUGO_ENV=${HUGO_ENV}
11
12# Base URL
13ARG HUGO_BASEURL=/
14ENV HUGO_BASEURL=${HUGO_BASEURL}
15
16# Module Proxy
17ARG HUGO_MODULE_PROXY=
18ENV HUGO_MODULE_PROXY=${HUGO_MODULE_PROXY}
19
20# NPM mirrors, such as https://registry.npmmirror.com
21ARG NPM_CONFIG_REGISTRY=
22ENV NPM_CONFIG_REGISTRY=${NPM_CONFIG_REGISTRY}
23
24# Install dependencies
25RUN npm install
26RUN npm install -g @fullhuman/postcss-purgecss rtlcss
27
28# Build site
29RUN hugo --minify --gc --enableGitInfo
30
31# Set the fallback 404 page if defaultContentLanguageInSubdir is enabled, please replace the `en` with your default language code.
32# RUN cp ./public/en/404.html ./public/404.html
33
34###############
35# Final Stage #
36###############
37FROM nginx
38COPY --from=builder /src/public /app
39COPY deploy/nginx/default.conf /etc/nginx/conf.d/default.conf

Er zijn twee fasen in de build: een build-fase en een release-fase. De releasefase bevat alleen de gegenereerde statische bestanden, waardoor de grootte van de Docker-image zo klein mogelijk blijft.
Als u defaultContentLanguageInSubdir heeft ingeschakeld, verwijder dan de opmerkingen en wijzig deze indien nodig.
De parameter HUGO_BASEURL wordt gebruikt om de baseURL van de site op te geven tijdens het bouwen, en wordt over het algemeen gebruikt wanneer de baseURL afwijkt van de configuratie, dus u kunt deze zelf verwijderen als u deze niet nodig heeft.
HUGO_MODULE_PROXY en NPM_CONFIG_REGISTRY zijn optionele buildparameters die kunnen worden verwijderd als ze niet nodig zijn.

Nginx

Maak een deploy/nginx/default.conf in de hoofdmap van de site:

Implementeren op GitHub-pagina's

Wed, 13 Jul 2022 10:30:23 +0800

In dit artikel wordt uitgelegd hoe u sites kunt implementeren op GitHub-pagina’s met behulp van GitHub Actions.

Werkstroom

Maak .github/workflows/gh-pages.yml aan in de hoofdmap van de site.

 1name: GitHub Pages
 2on:
 3  push:
 4    branches:
 5      - main
 6permissions:
 7  contents: write
 8jobs:
 9  build-and-deploy:
10    concurrency: ci-${{ github.ref }}
11    runs-on: ubuntu-latest
12    steps:
13      - name: Checkout 🛎️
14        uses: actions/checkout@v3
15        with:
16          submodules: true
17          fetch-depth: 0
18
19      - name: Setup Node
20        uses: actions/setup-node@v3
21        with:
22          node-version: '16'
23
24      - name: Cache dependencies
25        uses: actions/cache@v2
26        with:
27          path: ~/.npm
28          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
29          restore-keys: |
30            ${{ runner.os }}-node-            
31
32      - name: Install dependencies
33        run: npm install
34
35      - name: Setup Hugo
36        uses: peaceiris/actions-hugo@v2
37        with:
38          hugo-version: 'latest'
39          extended: true
40
41      - name: Build
42        run: hugo --minify --gc --enableGitInfo
43
44      - name: Deploy 🚀
45        uses: peaceiris/actions-gh-pages@v3
46        with:
47          github_token: ${{ secrets.GITHUB_TOKEN }}
48          publish_dir: ./public

Zie ook Starterssjabloon GitHub-pagina’s Workflow。

Implementeer op Cloudflare-pagina's

Tue, 12 Jul 2022 20:06:24 +0800

In dit artikel wordt uitgelegd hoe u uw site kunt implementeren op Cloudflare-pagina’s.

Een project maken

We beginnen met het maken van een Git-project en het invullen van de juiste informatie.

Bouwopdracht

1npm i && hugo --gc --minify --enableGitInfo -b https://hbs-skeleton.pages.dev

npm i is een snelkoppeling naar npm install, waarmee de afhankelijkheden worden geïnstalleerd die worden gebruikt tijdens het bouwen van de site.
-b https://hbs-skeleton.pages.dev specificeert baseURL, vervang dit alstublieft zelf. U kunt het ook opslaan in een configuratiebestand in plaats van het op te geven in de build-opdracht.

Omgevingsvariabelen

Naam	Waarde
`HUGO_VERSION`	`0.147.9`
`NODE_VERSION`	`16`

404 Pagina

Cloudflare is slim genoeg om de best passende 404-pagina’s te gebruiken, zelfs voor meertalige sites, en werkt zonder aanvullende configuraties.

Implementeren in Netlify

Tue, 12 Jul 2022 14:20:49 +0800

Dit artikel laat zien hoe u uw site kunt implementeren op Netlificeren.

Netlify-configuratie

Maak een netlify.toml in de hoofdmap van de site:

 1[build]
 2  publish = "public"
 3
 4[build.environment]
 5  NODE_VERSION = "17.6.0"
 6  HUGO_VERSION = "0.147.9"
 7  HUGO_ENABLEGITINFO = "true"
 8  GO_VERSION = "1.17.7"
 9
10[context.production]
11  command = "npm install && hugo --minify"
12
13[context.production.environment]
14  HUGO_ENV = "production"
15
16[[headers]]
17  for = "/*"
18  [headers.values]
19    Referrer-Policy = "strict-origin-when-cross-origin"
20    X-Content-Type-Options = "nosniff"
21    X-Frame-Options = "deny"
22    X-XSS-Protection = "1; mode=block"
23
24[[redirects]]
25  from = "/:lang/*"
26  to = "/:lang/404.html"
27  status = 404
28
29[[redirects]]
30  from = "/*"
31  to = "/en/404.html" # Replace the "en" to your default language code if "defaultContentLanguageInSubdir" is enabled, otherwise use "/404.html" instead.
32  status = 404

Zie ook Starterssjabloon Netlify-configuratie.

Upgrade

Sat, 25 Jun 2022 22:15:02 +0800

In dit artikel wordt uitgelegd hoe u het thema correct kunt upgraden.

Versies

Voordat u een upgrade uitvoert, is het noodzakelijk om te introduceren wat een versie is. Naast de relatief stabiele versies vermeld in Releases, kunt u een branch gebruiken zoals master, develop, of zelfs een bepaalde commit kiezen.

Dit artikel gebruikt de tijdelijke aanduiding [version] om de versie weer te geven. Vervang deze gewoon door de versie waarnaar u wilt upgraden.

Migreren naar v1

Mon, 20 Jun 2022 17:46:31 +0800

Volg en bekijk wijzigingen in de themabronbestanden en documentatie om u te helpen bij de migratie van v0.* naar v1.

Als u niet zeker weet hoe u moet upgraden, raadpleeg dan de Upgrade handleiding.

v1.0

Het oudere UI-ontwerp is bevroren op de v0 branch die alleen bugfixes accepteert. U kunt het oudere UI-ontwerp met die vertakking blijven gebruiken.

Afhankelijkheden

Bootstrap gestoten van v5.1 naar v5.2.

gebruikersinterface

Het instellingenpaneel verwijderd uit de bovenste app-balk.
De sociale links toegevoegd aan de bovenste app-balk.
Documenten-navigatieschakelaar op de bovenste app-balk op een klein scherm geplaatst.

Lay-outs

layouts/_default/archive.html verwijderd, vervang layout = archive door layout = archives vooraan.
Hernoemd naar layouts/partials/docs/catalog.html naar layouts/partials/docs/nav.html.

SCSS

Verouderd $variable-prefix, gebruik in plaats daarvan $prefix.
Gebruik ingebouwde CSS-variabelen van Bootstrap in plaats van door thema gedefinieerde CSS-variabelen.

Documenten

BREAKING CHANGE gebruik navWeight in plaats van weight voor het sorteren van pagina’s in docs nav.

Shortcodes

Waarschuwingskortcode

BREAKING CHANGE verander de syntaxis van alert, zie ook Syntaxis van waarschuwingskortcodes.

Codeschakelaar

Mon, 13 Jun 2022 16:54:28 +0800

De code-toggle shortcode genereert codeblokken van verschillende formaten volgens de configuratiecode van elk ondersteund formaat.

Formaten

JSON, TOML en YAML worden ondersteund.

Gebruik

1{{< code-toggle >}}
2CODE IN ANY SUPPORTED FORMAT
3{{}}

Met een bestandsnaam:

1{{< filename="config" code-toggle >}}
2CODE IN ANY SUPPORTED FORMAT
3{{}}

Voorbeeld

1{{< code-toggle filename="params" >}}
2{
3    "logo": "/images/logo.png",
4    "customCSS": ["foo.css", "bar.css"],
5    "codeBlock": {
6        "maxLines": 10
7    }
8}
9{{}}

params.toml

Invoering

Mon, 13 Jun 2022 16:32:09 +0800

Doelen

Prestaties
Vriendelijke gebruikerservaring
SEO

Kenmerken

Hugo Pijpen: gebruikt om CSS- en JS-middelen te genereren.
PurgeCSS: verwijder ongebruikte CSS.
Flexibel en configureerbaar.
Snelle en goede gebruikerservaring: de score van Google PageSpeed-inzichten is meer dan 95.
RTL-ondersteuning: Arabische demosite.
Gebouwd bovenop Bootstrap 5.
Lettertype Geweldige pictogrammen.
Responsief.
PWA, ook wel progressieve webapps genoemd.
Verschillende paletten: blue, blue-gray, brown, cyan, green, indigo, orange, pink, purple, red, teal, yellow.
Een Documentenindeling voor het publiceren van projectdocumentatie, notities, digitale tuinen, zetlkastens etc.
Licht/donker-modus.
Lettergrootteschakelaar.
Meertalig (I18N).
Lokaal zoeken.
DocSearch.
Berichten vastzetten.
Voettekstmenu.
Codeblokpaneel: kopieer code, regelnummer, regelomloop en uitbreiding.
Codeschakelaar
Broodkruimel.
Archief.
Afbeeldingsviewer.
Beeldverwerking: afbeeldingen verkleinen en uitlijnen.
Bronnen Lazy Loading: image en iframe.
Syntaxisaccentuering.
Beloningswidget, AKA Buy Me a Coffee: elk platform dat QR-code ondersteunt, wordt ondersteund.
Inhoudsopgave.
Opmerkingen: Disqus, Utterances, Giscus en Staticman kunnen kant-en-klaar worden gebruikt, u kunt ook integreren met andere commentaardiensten.
Aangepaste activa: aangepaste CSS en JS.
Haken: biedt de mogelijkheid om aangepaste code op de pagina toe te voegen.
Sociale banden.
Diverse Shortcodes.
Twitter-kaarten en Open Graph.
Creative Commons-licentie.
Contactformulier.
Nummering van koppen automatisch.

Vereisten

Mon, 13 Jun 2022 16:32:09 +0800

Zorg ervoor dat u aan de vereisten voldoet voordat u het thema installeert.

Configuratie

HBS vereist dat de volgende configuraties worden ingesteld.

config.toml

1[build]
2  writeStats = true
3[taxonomies]
4  author = 'authors'
5  category = 'categories'
6  series = 'series'
7  tag = 'tags'

config.yaml

Galerij Shortcode

Fri, 25 Mar 2022 00:00:00 +0000

Dit artikel laat zien hoe u de gallery shortcode gebruikt.

Gebruik

1{{< gallery images="images/foo.png,images/bar.png" >}}

Installeer via Hugo Module

Sat, 26 Feb 2022 17:10:39 +0200

Dit artikel verwijst naar de moderne, up-to-date installatiemethode om het thema lokaal te installeren als Hugo-module.

Proxy (optioneel)

Als u zich zonder VPN op het vasteland van China bevindt, kan het downloaden van de Hugo-module mislukken.

Hiervoor zijn twee proxy’s: GOPROXY.CN en GOPROXY.IO.

1$ export HUGO_MODULE_PROXY=https://goproxy.cn

Houd er rekening mee dat Hugo de GOPROXY env var niet respecteert. Gebruik in plaats daarvan HUGO_MODULE_PROXY.

U kunt ook module.proxy instellen in plaats van env var.

Documentenindeling

Wed, 12 Jan 2022 10:56:34 -0800

In dit artikel verkennen we de lay-out docs, die kan worden gebruikt om projectdocumentatie, persoonlijke notities en meer te schrijven.

Als u de lay-out docs op andere secties(notes) gaat gebruiken, kijk dan eens op de pagina Inhoud.

Indeling

De lay-out docs bestaat van begin tot eind uit drie secties: documentnavigatiebalk, documentinhoud en zijbalk.

Inhoudsstructuur

 1$ tree content/docs 
 2├── _index.md
 3├── installation
 4│   ├── _index.md
 5│   ├── linux
 6│   │   ├── _index.md
 7│   │   ├── archlinux
 8│   │   │   └── index.md
 9│   │   └── ubuntu
10│   │       └── index.md
11│   └── windows
12│       └── index.md
13└── introduction
14    └── index.md

Eigendom	Typ	Beschrijving
`name`	Tekenreeks	De naam van het menu.
`identifier`	Tekenreeks	De ID van het menu.
`weight`	Nummer	Het gewicht van het menu dat werd gebruikt voor het sorteren in oplopende volgorde.
`parent`	Tekenreeks	De `identifier` van het bovenliggende menu-item.
`url`	Tekenreeks	De URL van het menu.
`pre`	Tekenreeks	De leidende tekenreeks vóór de menunaam.
`post`	Tekenreeks	De afsluitende tekenreeks na de menunaam.
`params`	Voorwerp	Menuparameters.
`params.divider`	Booleaans	`true` betekent deler.
`params.icon`	Tekenreeks	Het pictogram HTML.
`params.description`	Tekenreeks	De beschrijving alleen voor de vervolgkeuzemenu’s op de bovenste app-balk.

Zie ook Eigenschappen menu-item.

Veelgestelde vragen Indeling

Tue, 07 Dec 2021 21:46:43 +0800

De Veelgestelde vragen pagina is een verzameling veelgestelde vragen.

Vereisten

We moeten een pagina maken met de naam faq/index.md in de map content.

1+++
2title = "Frequently Asked Questions"
3layout = "faq"
4+++

Gegevens

De gegevens worden opgeslagen in de map data, de mapstructuur is als volgt:

1data
2  /en
3    /faq
4      foo.json
5      bar.json
6  /zh-cn
7    /faq
8      foo.json
9      bar.json

Zoals u kunt zien, classificeren we de vragen op basis van hun taal. En elk bestand vertegenwoordigt een groep vragen, die hetzelfde formaat heeft:

Aan de slag

Sat, 04 Dec 2021 10:43:39 +0800

Inhoud toevoegen

Sat, 04 Dec 2021 10:43:39 +0800

Hoofdsecties

De parameter mainSections wordt gebruikt om pagina’s te filteren, standaard is dit ["posts", "docs"].

1mainSections = ["blog", "posts", "docs", "notes"]

Voorzaak

Front Matter is de plaats waar we metagegevens en parameters van de pagina plaatsen, zoals titel, datum enzovoort.

Formaten

Hugo ondersteunt drie formaten voorwerk: YAML, TOML en JSON.

TOML: geïdentificeerd door het openen en sluiten van +++.
YAML: geïdentificeerd door het openen en sluiten van ---.
JSON: een enkel JSON-object omgeven door { en }, gevolgd door een nieuwe regel.

Laten we TOML als voorbeeld nemen:

Installeer via Git Submodule

Sat, 04 Dec 2021 10:43:39 +0800

Dit artikel verwijst naar de traditionele installatiemethode om het thema lokaal te klonen als Git-submodule. Hoewel deze installatiemethode nog steeds veel wordt gebruikt, raden we aan om het thema te installeren als Hugo-module.

Maak een nieuwe site vanuit het niets

1$ git clone https://github.com/razonyang/hugo-theme-bootstrap-skeleton myblog
2$ cd myblog
3$ git submodule add https://github.com/razonyang/hugo-theme-bootstrap themes/hugo-theme-bootstrap
4$ sed -i "s/theme:.*/theme: hugo-theme-bootstrap/g" config/_default/config.yaml
5$ rm go.mod go.sum
6$ hugo mod npm pack
7$ npm install
8$ hugo server

Als u Windows gebruikt, gebruik dan xcopy .\themes\hugo-theme-bootstrap\exampleSite /E.

Afbeeldingsviewer

Fri, 03 Dec 2021 20:46:50 +0800

Afbeeldingenviewer is een afbeeldingengalerij. Deze wordt weergegeven wanneer u op een niet-koppelbare afbeelding klikt.

Het biedt ook veel hulpmiddelen, zoals inzoomen, uitzoomen en roteren.

De auteuravatar werd standaard gefilterd.

Siteparameters

Image Viewer is standaard ingeschakeld. U kunt dit uitschakelen door de parameter viewer in te stellen als false.

Opties

U kunt de opties aanpassen door assets/viewer/js/options.ts te maken.

1const options = {
2    className: "image-viewer",
3    // ...
4};
5export default options;

Beschikbare opties staan vermeld op Viewer.js-opties.

Kijk en voel

Fri, 03 Dec 2021 19:42:57 +0800

Standaard heeft een site die dit thema gebruikt de standaardlettertypen, kleuren en algemene uitstraling. Het standaardschema kan echter niet iedereen tevreden stellen, maar maak je geen zorgen, je kunt eenvoudig de standaardinstellingen van het thema, zoals paletkleuren, lettertypen en syntaxisaccentuering, overschrijven.

Favicons

HBS genereert pictogrammen in meerdere formaten op basis van het bestand assets/favicon.webp (hogere prioriteit) of assets/favicon.png. Sla gewoon uw eigen favicon-afbeelding op als hetzelfde pad om de standaardinstellingen te overschrijven.

Progressieve webapp

Fri, 03 Dec 2021 19:39:01 +0800

PWA’s(Progressieve webapps) zijn webapps die zijn ontwikkeld met behulp van een aantal specifieke technologieën en standaardpatronen, zodat ze kunnen profiteren van zowel web- als native app-functies.

HBS biedt enkele basisfuncties, zoals het installeren van de site op het startscherm, het vooraf cachen van bestanden en het offline beschikbaar zijn.

Siteparameters

Ten eerste moeten we de parameter pwa specificeren, zelfs als deze leeg is.

Archiefindeling

Fri, 03 Dec 2021 11:16:51 +0800

De archiefpagina is een verzameling berichten gegroepeerd op jaar.

Vereisten

De pagina’s worden niet automatisch gemaakt, we moeten eerst archiefsecties maken:

1$ tree content/archives
2├── 2021
3│   ├── _index.md
4├── 2022
5│   ├── _index.md
6├── _index.md

De inhoud van die bestanden bevat alleen een title parameter.

Siteparameters

Naam	Typ	Standaard	Beschrijving
`archive`	Voorwerp	-	Archief.
`archive.dateFormat`	Tekenreeks	`Jan 2`	Datumformaat archiveren.
`archive.monthFormat`	Tekenreeks	`January`	Archiefmaandformaat, b.v. `1`, `01`, `Jan` en `January`.
`archive.basePath`	Tekenreeks	`/archives`

Zoek lay-out

Fri, 03 Dec 2021 11:16:51 +0800

Het kan voor lezers moeilijk zijn om een artikel op te halen als er veel artikelen op uw site staan. Daarom hebben we de zoekfunctie toegevoegd.

Vereisten

Het enige wat u hoeft te doen is een pagina aanmaken met de naam search/_index.md in de map content.

1+++
2title = "Search"
3+++

Siteparameters

Naam	Typ	Standaard	Beschrijving
`search`	Voorwerp	-	Zoekconfiguratie.
`search.paginate`	Geheel getal	`10`	Paginering.
`search.indexPaginate`	Geheel getal	`1000`	Paginering van indexbestanden.
`search.indexPreload`	Booleaans	`true`	Of de zoekindexen vooraf moeten worden geladen.
`search.maxResults`	Nummer	`100`	Het maximale aantal zoekresultaten.
`search.resultContentCharactersCount`	Geheel getal	`240`	Het maximale aantal tekens van de resultaatinhoud voor weergave.
`search.shortcut`	Array	`["/"]`	De zoeksnelkoppeling, d.w.z. `["Control", "/"]`, schakelt deze uit door een lege array `[]`.
`search.fuse`	Voorwerp	-	Fuse.js-opties.
`search.fuse.ignoreLocation`	Booleaans	`true`
`search.fuse.location`	Geheel getal	-
`search.fuse.isCaseSensitive`	Booleaans	-
`search.fuse.minMatchCharLength`	Geheel getal	-
`search.fuse.threshold`	Dubbel	-
`search.fuse.distance`	Geheel getal	-
`search.fuse.useExtendedSearch`	Booleaans	-

Auteurswidget

Fri, 03 Dec 2021 11:10:19 +0800

De auteurswidget bevindt zich in de zijbalk en dient om jezelf kort voor te stellen.

Beloningswidget

Fri, 03 Dec 2021 11:10:19 +0800

De beloningswidget, ook wel de “buy me a coffee”-widget, biedt lezers een manier om een maker te ondersteunen via donaties of fooien.

Deze widget is echter beperkt tot QR-codeafbeeldingen. Bekijk ook de financieringswidget.

Sociale Links

Thu, 02 Dec 2021 16:27:45 +0800

De parameter social is een set sleutel-waardeparen van sociale links die platforms koppelen aan hun gebruikersidentificatie. Het ondersteunt vele populaire sociale platforms, zoals Twitter, Facebook, Reddit en GitHub. Dit artikel geeft een overzicht van alle ondersteunde platforms en hoe je ze gebruikt.

Contactformulier

Tue, 30 Nov 2021 23:56:00 +0800

We kunnen ons e-mailadres op sociale banden zetten, zodat lezers contact met ons kunnen opnemen. Helaas worden e-mails min of meer als spam behandeld en zelfs gefilterd. Daarom brengen we een functie genaamd contactformulier.

Vereisten

We moeten een contactpagina maken met de naam contact/index.md in de map content, zodat we toegang kunnen krijgen tot het contactformulier.

1+++
2title = "Contact Us"
3layout = "contact"
4+++

Eenmaal aangemaakt, verschijnt de link in de profielwidget.

Aangepaste activa

Sun, 28 Nov 2021 16:00:49 +0800

Als aanpasbaar thema biedt het de mogelijkheid om assets aan te passen, of het nu gaat om het aanpassen van CSS en JS of het introduceren van CSS en JS van derden.

Interne activa

Maak en bewerk eenvoudigweg de bestanden assets/main/scss/_variables.scss, assets/main/scss/_custom.scss en assets/main/js/custom.ts.

Deze bestanden worden gebundeld in één om HTTP-verzoeken te verminderen.

Externe activa

Alle externe CSS- en JS-bronnen kunnen worden geïmporteerd met de parameters customCSS en customJS.

Doe mee

Sat, 27 Nov 2021 19:54:29 +0800

Wij luisteren graag naar uw mening en feedback en heten u van harte welkom om mee te doen.

Gemeenschap

Functieverzoek
Bugrapport
Discussies: stel vragen, deel ideeën enz.

Draag bij

Alle bijdragen zijn welkom, zoals documenten, bugfixes en nieuwe functies.

Regels

Met het oog op het onderhoudsgemak stellen wij enkele regels op.

Conventionele commitspecificatie

Volg de Conventionele commit-specificatie.

Haken

Sat, 27 Nov 2021 19:54:29 +0800

Als flexibel thema zou het de mogelijkheid moeten hebben om code aan te passen en diensten van derden te integreren. Daarom hebben we een functie geïntroduceerd die hook heet.

In dit artikel introduceren we alle haken en geven we enkele gebruiksscenario’s.

Overzicht

Haak	Beschrijving
`head-end`	Vóór het einde van
`body-begin`	Volg de
`body-end`	Vóór het einde van
`main-begin`	Boven de
`main-end`	Volg de
`list-begin`	Bovenaan de berichtenlijst
`list-end`	Volg de berichtenlijst
`sidebar-begin`	Helemaal bovenaan de zijbalk
`sidebar-end`	Voordat het zijbalkeinde
`content-begin`	Boven de inhoud van het bericht
`content-end`	Volg de berichtinhoud
`comments-begin`	Boven de reacties
`comments-end`	Volg de reacties
`footer-begin`	Helemaal bovenaan de voettekst
`footer-end`	Voordat de voettekst eindigt
`post-panel-begin`	Helemaal bovenaan het postpaneel
`post-panel-end`	Vóór het einde van het paalpaneel
`docs/sidebar-begin`	Helemaal bovenaan de `docs` zijbalk
`docs/sidebar-end`	Voordat de `docs` zijbalk eindigt
`docs/nav-begin`	Helemaal bovenaan de navigatie
`docs/nav-end`	Voordat de navigatie eindigt
`contact/form-field-begin`	Helemaal bovenaan het contactformulierveld
`contact/form-field-end`	Voordat het contactformulierveld eindigt
`search/sidebar-begin`	Helemaal bovenaan de `search` zijbalk
`search/sidebar-end`	Voordat de `search` zijbalk eindigt

Gebruik

Het is gemakkelijk om een hook te gebruiken, wat je moet doen is een HTML-bestand maken met dezelfde naam als hook in de map layouts/partials/hooks.

Reactiewidget

Sat, 27 Nov 2021 19:54:29 +0800

Disqus, Utterances en Giscus reactiewidgets worden direct ondersteund. Dit artikel laat zien hoe je ze configureert en zelfs je eigen reactiewidgets aanmaakt.

Paginaparameters

Sat, 27 Nov 2021 19:53:24 +0800

Paginaparameters bevinden zich in pagina’s Voorste zaak.

Naam	Typ	Standaard	Beschrijving
Pagina
`title`	Tekenreeks	-	Paginatitel.
`description`	Tekenreeks	-	Paginabeschrijving.
`keywords`	Array	-	Trefwoorden van de pagina.
`comment`	Booleaans	`true`	Of opmerkingen moeten worden ingeschakeld. Het werkt niet als `comment` globaal is uitgeschakeld.
`toc`	Booleaans	`true`	Of TOC moet worden ingeschakeld. Het werkt niet als `toc` globaal is uitgeschakeld.
`math`	Booleaans	`false`	Of wiskunde moet worden ingeschakeld.
`diagram`	Booleaans	`false`	Of diagram moet worden ingeschakeld.
`reward`	Booleaans	`true`	Of beloning moet worden ingeschakeld.
`breadcrumb`	Booleaans	`true`	Of broodkruimels moeten worden ingeschakeld.
`breadcrumbDivider`	Tekenreeks	`/`	Broodkruimelverdeler.
`readingTime`	Booleaans	`true`	Of de leestijd moet worden weergegeven.
`postDate`	Booleaans	`true`	Of de berichtdatum moet worden weergegeven in de bericht-metasectie.
`copyright`	Booleaans	`true`	Of de copyrightsectie moet worden weergegeven.
`carousel`	Booleaans	`false`	Toon op carrousel.
`nav`	Booleaans	`true`	Schakel de navigatie in/uit.
`sidebar`	Booleaans	`true`	Toon/Verberg de zijbalk.
`index`	Booleaans	`true`	Indexeer deze pagina in de klantenzoekmachine of niet.
Creative Commons-licentie
`creativeCommons`	Voorwerp	-
`creativeCommons.by`	Booleaans	`true`	De eer moet aan u, de maker, worden gegeven.
`creativeCommons.nc`	Booleaans	`true`	Alleen niet-commercieel gebruik van uw werk is toegestaan.
`creativeCommons.nd`	Booleaans	`true`	Er zijn geen afgeleiden of aanpassingen van uw werk toegestaan.
`creativeCommons.sa`	Booleaans	`true`	Aanpassingen moeten onder dezelfde voorwaarden worden gedeeld.
Metatag
`metaRobots`	Tekenreeks	-	Leeg betekent dat het is uitgeschakeld.
`pinned`	Booleaans	`false`	Berichten vastzetten.
`pinnedWeight`	Nummer	-	Een lager gewicht krijgt een hogere prioriteit.
`featuredPostCount`	Geheel getal/Booleaans	`5`	Het aantal uitgelichte berichten dat in de zijbalk wordt weergegeven. Schakel uit door deze in te stellen op `false`.
`recentPostCount`	Geheel getal/Booleaans	`5`	Het aantal recente berichten dat in de zijbalk wordt weergegeven. Schakel uit door deze in te stellen op `false`.
`relatedPostCount`	Geheel getal/Booleaans	`5`	Het aantal gerelateerde berichten. Schakel uit door deze in te stellen op `false`.
`featuredImageAlt`	Tekenreeks	-	De alternatieve tekst voor uitgelichte afbeeldingen, terugval naar paginatitel indien niet aanwezig.
`numberifyHeadings`	Booleaans	`true`	Wanneer `false` worden de koppen niet genummerd.

Siteconfiguratie

Sat, 27 Nov 2021 19:53:24 +0800

De siteconfiguratie bevindt zich standaard in config/_default/config.toml.

Naam	Typ	Standaard	Beschrijving
`title`	Tekenreeks	-	Titel van de site.
`baseURL`	Tekenreeks	-	Basis-URL van de site.
`copyright`	Tekenreeks	-	Auteursrecht van sites. De tijdelijke aanduiding `{year}` wordt vervangen door het huidige jaar.
`defaultContentLanguage`	Tekenreeks	`en`	Standaardtaal van de site.
`defaultContentLanguageInSubdir`	Booleaans	`false`
`paginate`	Geheel getal	`10`
`paginatePath`	Tekenreeks	`page`
`enableRobotsTXT`	Booleaans	`true`
`disqusShortname`	Tekenreeks	-	Disqu korte naam.
`services`	Voorwerp	-
`services.googleAnalytics`	Voorwerp	-	Google Analytics ondersteunt alleen GA4.
`services.googleAnalytics.ID`	Tekenreeks	-	Meting-ID.
`author`	Voorwerp	-	Auteurwidget.

Zie ook Alle configuratie-instellingen.

Siteparameters

Sat, 27 Nov 2021 19:53:24 +0800

De locatieparameters bevinden zich standaard in config/_default/params.toml.

Naam	Typ	Standaard	Beschrijving
`sass_transpiler`	tekenreeks	`libsass`	`dartsass` wordt aanbevolen, omdat `libsass` verouderd is.
Pagina
`mainSections`	Array	`["posts"]`	Hoofdsecties
`titleCase`	Booleaans	`false`	Titel met hoofdletter of niet
`titleSeparator`	Tekenreeks	`-`	Titelscheidingsteken
`backgroundImage`	Array	`[]`	Achtergrondafbeelding, zoals `['/images/bg.png']`, `['/images/bg-light.png', '/images/bg-dark.png']`.
`comment`	Booleaans	`true`	Of opmerkingen moeten worden ingeschakeld
`toc`	Booleaans	`true`	Of TOC moet worden ingeschakeld
`tocWordCount`	Geheel getal	`280`	TOC wordt alleen weergegeven als het aantal woorden van het bericht groter is dan deze waarde.
`tocPosition`	Tekenreeks	`sidebar`	Beschikbare waarden: `sidebar` en `content`, alleen de indeling `posts` wordt beïnvloed.
`breadcrumb`	Booleaans	`true`	Of broodkruimels moeten worden ingeschakeld
`dateFormat`	Tekenreeks	`Jan 2, 2006`	Datumformaat. Kijk op Hugo datum- en tijdsjabloonreferentie voor meer informatie.
`poweredBy`	Booleaans	`true`	Of het nu gaat om een show powered by.
`readingTime`	Booleaans	`true`	Of de leestijd moet worden weergegeven.
`postDate`	Booleaans	`true`	Of de berichtdatum moet worden weergegeven in de bericht-metasectie.
`math`	Booleaans	`false`	Of wiskunde wereldwijd moet worden ingeschakeld.
`diagram`	Booleaans	`false`	Of het diagram globaal moet worden ingeschakeld.
`logo`	Tekenreeks/Boolean	`images/logo.webp`	Logo-afbeelding. Schakel het logo uit door het in te stellen op `false`.
`brand`	Tekenreeks	-	Merk tekst.
`description`	Tekenreeks	-	Sitebeschrijving.
`keywords`	Tekenreeks	-	Trefwoorden voor sites.
`color`	Tekenreeks	-	Kleurmodus, `light`, `dark` of `auto`. Standaard ingesteld op `auto`.
`palette`	Tekenreeks	-	Standaardpalet. Dit wordt van kracht nadat u de cookie heeft gewist.
`palettes`	Array	ALLE	Beschikbare paletten. U kunt het uitschakelen door het in te stellen op leeg `[]`.
`carouselPostCount`	Geheel getal	`5`	Het aantal berichten dat wordt weergegeven op de startpaginacarrousel.
`featuredPostCount`	Geheel getal/Booleaans	`5`	Het aantal uitgelichte berichten dat in de zijbalk wordt weergegeven. Schakel uit door deze in te stellen op `false`.
`recentPostCount`	Geheel getal/Booleaans	`5`	Het aantal recente berichten dat in de zijbalk wordt weergegeven. Schakel uit door deze in te stellen op `false`.
`relatedPostCount`	Geheel getal/Booleaans	`5`	Het aantal gerelateerde berichten. Schakel uit door deze in te stellen op `false`.
`categoryCount`	Geheel getal/Booleaans	`10`	Het aantal categorieën dat wordt weergegeven in de zijbalk. Schakel uit door deze in te stellen op `false`.
`tagCount`	Geheel getal/Booleaans	`10`	Het aantal tags dat in de zijbalk wordt weergegeven. Schakel uit door deze in te stellen op `false`.
`seriesCount`	Geheel getal	`10`	Het aantal series weergegeven in de zijbalk.
`taxonomyPaginate`	Geheel getal	`10`
`taxonomyPostCount`	Geheel getal	`3`	Het aantal berichten van de taxonomie. Schakel het uit door het op false te zetten.
`taxonomySortingMethod`	Tekenreeks	-	Taxonomieën sorteren op `popularity`, standaard alfabetisch sorteren.
`countTaxonomyPosts`	Booleaans	`false`	Tel berichten van taxonomie.
`sidebarTaxonomies`	Array	`["series", "categories", "tags"]`	De taxonomieën in de zijbalk.
`fullWidth`	Booleaans	`false`	Volledige breedte.
`fullWidthInSections`	Voorwerp	-	Geef de volledige breedte op voor bepaalde secties, zoals `posts`, `docs`.
`fixedHeader`	Booleaans	`true`	Zet de vaste header aan/uit.
`reward`	Voorwerp	-	Beloningswidget, oftewel Koop een koffiewidget voor mij.
`externalLinkIcon`	Booleaans	`true`	Of de pictogrammen na de externe links moeten worden weergegeven.
`share`	Voorwerp	-	Deelknoppen
`share.addThis`	Tekenreeks	-	Voeg dit toe’s `pubid`.
`fontSize`	Voorwerp	Lettergroottes	Reageer of verwijder deze parameter om de schakelaar voor de lettergrootte uit te schakelen.
`fontSize.small`	Tekenreeks	`.9rem`	Kleine lettergrootte.
`fontSize.extraSmall`	Tekenreeks	`.8rem`	Extra kleine lettergrootte.
`fontSize.large`	Tekenreeks	`1.1rem`	Grote lettergrootte.
`fontSize.extraLarge`	Tekenreeks	`1.2rem`	Extra grote lettergrootte.
`social`	Voorwerp	-	Sociale banden.
`socialAnimation`	Booleaans	`true`	Verwijder animatie uit sociale links als `false`.
`socialColor`	Booleaans	`true`	Verwijder kleur uit sociale links als `false`.
`socialShare`	Booleaans	`true`	Schakel de ingebouwde knop voor sociaal delen in/uit.
`searchBar`	Booleaans	`true`	Ingebouwde zoekbalk in-/uitschakelen.
`archive`	Voorwerp	-	Archief.
`search`	Voorwerp	-	Zoekopdracht.
`docsearch`	Voorwerp	-	DocSearch
`docsearch.container`	Tekenreeks	`.search-button`
`docsearch.appId`	Tekenreeks	-
`docsearch.indexName`	Tekenreeks	-
`docsearch.apiKey`	Tekenreeks	-
`docsearch.debug`	Booleaans	`false`
`docsearch.*`	Booleaans/tekenreeks/nummer	-	https://docsearch.algolia.com/docs/api/
`algolia`	Voorwerp	-	Zie Algolia
Bovenste app-balk
`topAppBar`	Voorwerp	-
`topAppBar.social`	Voorwerp	-	Sociale banden.
`topAppBar.colorToggle`	Booleaans	`true`	Schakel de kleur-/modusschakelaar in/uit.
`topAppBar.coloredInDark`	Booleaans	`false`	Gekleurd in donkere modus.
`topAppBar.dropdownMenuToggle`	Booleaans	`true`	Verberg de vervolgkeuzemenuschakelaar.
`topAppBar.expandBreakpoint`	tekenreeks	`xxl`	Vouw inhoud boven dit breekpunt uit, b.v. `lg`, `xl`, `xxl`.
Webmastersiteverificatie
`siteVerification`	Voorwerp	-
`siteVerification.google`	Tekenreeks	-	Googlen
`siteVerification.bing`	Tekenreeks	-	Bing
`siteVerification.baidu`	Tekenreeks	-	Baidu
`siteVerification.baiduUnion`	Tekenreeks	-	Baidu-unie
`siteVerification.so`	Tekenreeks	-	Qihoo 360
`siteVerification.sogou`	Tekenreeks	-	Sogou
`siteVerification.shenma`	Tekenreeks	-	Shenma
Analytics
`analytics`	Voorwerp	-	Analytics-configuratie.
`analytics.baidu`	Tekenreeks	-	Baidu-analyse.
`analytics.plausible`	Tekenreeks	-	Plausibele Analytics-domeinen. Meerdere domeinen gescheiden door een komma.
`analytics.plausibleScript`	Tekenreeks	`https://plausible.io/js/script.js`	Geef het zelf-hostende Plausible Analytics-script op of uitgebreid script.
`googleAdsense`	Tekenreeks	-	Google Adsense.
`customCSS`	Array	-	Zie ook aangepaste activa.
`customJS`	Array	-	Zie ook aangepaste activa.
`utterances`	Voorwerp	-	Uitingen-configuratie.
`giscus`	Voorwerp	-	Giscus-configuratie.
Creative Commons-licentie
`creativeCommons`	Voorwerp	-
`creativeCommons.by`	Booleaans	`true`	De eer moet aan u, de maker, worden gegeven.
`creativeCommons.nc`	Booleaans	`true`	Alleen niet-commercieel gebruik van uw werk is toegestaan.
`creativeCommons.nd`	Booleaans	`true`	Er zijn geen afgeleiden of aanpassingen van uw werk toegestaan.
`creativeCommons.sa`	Booleaans	`true`	Aanpassingen moeten onder dezelfde voorwaarden worden gedeeld.
Codeblok
`codeBlock`	Voorwerp	-
`codeBlock.maxLines`	Geheel getal	`7`
`codeBlock.lineNos`	Booleaans	`true`	`true`/`false` staat voor het standaard tonen/verbergen van de regelnummers.
Plaats
`post`	Voorwerp	-
`post.excerpt`	Tekenreeks	`Description`	De beschrijving zal als uittreksel worden gebruikt als deze niet leeg is. Om samenvattingen als uittreksel te gebruiken, moet u deze expliciet instellen als empty string.
`post.excerptMaxLength`	Geheel getal	`320`
`post.copyright`	Booleaans	`true`	Of de copyrightsectie bij elk bericht moet worden weergegeven.
`post.plainifyExcerpt`	Booleaans	`true`	Formatteer het fragment in HTML als `false`.
`post.featuredImage`	Booleaans	`false`	Toon de uitgelichte afbeelding boven de inhoud.
`post.numberifyHeadings`	Booleaans	`false`	Tel koppen automatisch.
`post.numberifyHeadingsEndLevel`	Nummer	`6`	De diepte van de te tellen rubrieken.
`post.numberifyHeadingsSeparator`	Tekenreeks	-	Het scheidingsteken tussen nummer en kopteksten.
`post.tocStyleType`	Tekenreeks	`none`	De CSS-eigenschap `list-style-type` van de inhoudsopgave.
`post.imageTitleAsCaption`	Booleaans	`false`	Gebruik de titel van de afbeelding als bijschrift.
`post.panel`	Booleaans	`true`	Schakel het postpaneel in/uit.
`post.nav`	Booleaans	`true`	Schakel de navigatie in/uit.
`post.readMoreFromContent`	Booleaans	`false`	De paginapositie na het klikken op de knop Lees meer, lees meer van de inhoud indien waar. Standaard naar het begin van de pagina. Het ondersteunt alleen de handmatige samenvattingen die zijn gesplitst via `

Configuratiestructuur

Sat, 27 Nov 2021 19:53:24 +0800

Zoals de voorbeeldsite laat zien, gebruiken we Configuratiemap om de organisatie- en omgevingsspecifieke instellingen eenvoudiger te maken. Dit is vooral handig op meertalige sites.

 1├── _default
 2│   ├── config.toml
 3│   ├── config.zh-hans.toml
 4│   ├── config.zh-hant.toml
 5│   ├── languages.toml
 6│   ├── markup.toml
 7│   ├── menu.toml
 8│   ├── menu.zh-hans.toml
 9│   ├── menu.zh-hant.toml
10│   ├── params.toml
11│   ├── params.zh-hans.toml
12│   ├── params.zh-hant.toml
13│   ├── server.toml
14└── production
15    ├── config.toml
16    └── params.toml

Hugo ondersteunt meerdere configuratieformaten: TOML, YAML en JSON, wijzig dit naar wens.

Diagram Handleiding

Wed, 01 Sep 2021 11:36:50 +0800

Dit artikel biedt een voorbeeld van het gebruik van diagrammen in Hugo-inhoudsbestanden.

Zie ook Mermaid.

Beeldverwerking

Sun, 15 Aug 2021 14:19:06 +0800

Dit artikel biedt enkele gebruiksscenario’s om te laten zien hoe u afbeeldingen kunt vergroten of verkleinen, bijsnijden, passen, vullen en uitlijnen.

Het formaat van afbeeldingen wijzigen

We gebruiken de URL-query van de afbeelding om het formaat van afbeeldingen te wijzigen. Bijvoorbeeld:

Specificeer de breedte en de behoudverhouding

1![Resize](featured-sample.webp?width=300px)

Specificeer de hoogte en de behoudverhouding

1![Resize](featured-sample.webp?height=200px)

Markdown Syntaxgids

Mon, 09 Nov 2020 00:00:00 +0000

Koppen

De volgende HTML

—
elementen vertegenwoordigen zes niveaus van sectiekoppen.
is het hoogste niveau,
het laagste.

H1

H2

H3

H4

H5

H6

Alinea

Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.

Waarschuwingskortcode

Thu, 22 Oct 2020 00:00:00 +0000

Dit artikel laat zien hoe u de alert shortcode gebruikt.

Belangrijk

Sinds v1.8.0 kunt u waarschuwingen aanmaken zonder shortcode, zie blokquote-waarschuwingen.

Syntaxis

Inline

1{{< alert [type] >}}INLINE ALERT{{< /alert >}}

Blokkeren

1{{< alert [type] >}}
2BLOCK ALERT
3{{< /alert >}}

De parameter type is optioneel. Standaard ingesteld op info, beschikbare waarden: info, success, warning en danger.

Met kop

1{{< alert [type] >}}
2{{< alert-heading >}}Well Done!{{< /alert-heading >}}
3ALERT MESSAGE
4{{< /alert >}}

Met Markdown-syntaxis

1{{% alert warning %}}
2Alert Shortcode with Markdown Syntax:
3```bash
4$ echo 'Een voorbeeld van een alert-shortcode met de Markdown-syntaxis'
5```
6{{% /alert %}}

Alert Shortcode with Markdown Syntax:

Mediashortcodes

Thu, 22 Oct 2020 00:00:00 +0000

Een gedetailleerde beschrijving van mediashortcodes, zoals Bilibili, Tencent, Youku, iQiyi en Netease Music.

Bilibili

1{{< bilibili "video id" >}}

Tencent

1{{< tencentvideo "vid" >}}

Youku

1{{< youku "XNTQwMTgxMTE2" >}}

iQiyi

1{{< iqiyi "vid" "tvid" >}}

Netease-muziek

1{{< neteasemusic "id" [auto [type]] >}}

Parameter	Beschrijving
`auto`	De `auto` bepaalt of er automatisch wordt afgespeeld. Booleaans en optioneel, standaard `false`.
`type`	De `type`-parameter is optioneel. Standaard ingesteld op `2`.

asciinema

1{{< asciinema id >}}

Online IDE-shortcodes

Thu, 22 Oct 2020 00:00:00 +0000

Een gedetailleerde beschrijving van online IDE-shortcodes, zoals JSFiddle, CodePen, JSRun.

JSFiddle

1{{< jsfiddle "user/id" >}}

CodePen

1{{< codepen "id" >}}

JSRun

1{{< jsrun "id" >}}

Samenvatting

1{{< gist razonyang f82a9399c2f682df36432f0ef828c451 >}}