Documenten on Martijn's Noteshttps://1552afcb.notes-6if.pages.dev/docs/Recent content in Documenten on Martijn's NotesHugonlCopyright © 2016-2026 van den <span class='bold-rotate'>B</span>oom. All Rights Reserved.Migreren naar v1https://1552afcb.notes-6if.pages.dev/docs/migration/Mon, 20 Jun 2022 17:46:31 +0800https://1552afcb.notes-6if.pages.dev/docs/migration/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

]]>Problemen oplossenhttps://1552afcb.notes-6if.pages.dev/docs/troubleshooting/Sat, 19 Mar 2022 13:46:41 +0800https://1552afcb.notes-6if.pages.dev/docs/troubleshooting/In dit artikel worden enkele veelvoorkomende problemen opgesomd, zodat u deze eenvoudig kunt oplossen.

CSS-weergave onjuist

CSS leegmaken

Het probleem wordt waarschijnlijk veroorzaakt door postcss. HBS heeft de volgende configuratie nodig om in te stellen: postcss vertrouwt op het bestand hugo_stats.json voor het verwijderen van ongebruikte CSS.

1[build]
2  writeStats = true

js.Build: Kan afhankelijkheden niet oplossen

 1Start building sites … 
 2hugo v0.94.0-63B23660+extended linux/amd64 BuildDate=2022-03-10T09:46:36Z VendorInfo=gohugoio
 3ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "bootstrap/js/src/offcanvas"
 4ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "bootstrap/js/src/modal"
 5ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "bootstrap/js/src/tab"
 6ERROR 2022/03/19 14:03:50 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/js/collapse/collapse.ts:1:38": Could not resolve "bootstrap/js/src/collapse"
 7ERROR 2022/03/19 14:03:50 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/js/toc/index.ts:1:27": Could not resolve "bootstrap/js/dist/offcanvas"
 8ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "@fortawesome/free-solid-svg-icons"
 9ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "@fortawesome/free-regular-svg-icons"
10ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "@fortawesome/free-brands-svg-icons"
11ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "workbox-routing"
12ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "workbox-strategies"
13ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "workbox-cacheable-response"
14ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "workbox-expiration"
15ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "workbox-precaching"
16ERROR 2022/03/19 14:03:50 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/search/search.ts:1:21": Could not resolve "mustache"
17ERROR 2022/03/19 14:03:50 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/search/search.ts:1:17": Could not resolve "mark.js/dist/mark.js"
18ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "bootstrap/js/src/offcanvas"
19ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "bootstrap/js/src/modal"
20ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "bootstrap/js/src/tab"
21ERROR 2022/03/19 14:03:50 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/js/collapse/collapse.ts:1:38": Could not resolve "bootstrap/js/src/collapse"
22ERROR 2022/03/19 14:03:50 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/js/toc/index.ts:1:27": Could not resolve "bootstrap/js/dist/offcanvas"
23ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "bootstrap/js/src/offcanvas"
24ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "bootstrap/js/src/modal"
25ERROR 2022/03/19 14:03:50 js.Build failed: Could not resolve "bootstrap/js/src/tab"
26ERROR 2022/03/19 14:03:50 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/js/collapse/collapse.ts:1:38": Could not resolve "bootstrap/js/src/collapse"
27ERROR 2022/03/19 14:03:50 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/js/toc/index.ts:1:27": Could not resolve "bootstrap/js/dist/offcanvas"
28ERROR 2022/03/19 14:03:51 js.Build failed: Could not resolve "bootstrap/js/src/offcanvas"
29ERROR 2022/03/19 14:03:51 js.Build failed: Could not resolve "bootstrap/js/src/modal"
30ERROR 2022/03/19 14:03:51 js.Build failed: Could not resolve "bootstrap/js/src/tab"
31ERROR 2022/03/19 14:03:51 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/js/collapse/collapse.ts:1:38": Could not resolve "bootstrap/js/src/collapse"
32ERROR 2022/03/19 14:03:51 js.Build failed: "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/js/toc/index.ts:1:27": Could not resolve "bootstrap/js/dist/offcanvas"
33ERROR 2022/03/19 14:03:51 TOCSS: failed to transform "viewer/scss/index.scss" (text/x-scss): SCSS processing failed: file "stdin", line 1, col 1: File to import not found or unreadable: viewerjs/dist/viewer. 
34ERROR 2022/03/19 14:03:51 JSBUILD: failed to transform "main/js/bundle.ts" (application/typescript): Could not resolve "bootstrap/js/src/dropdown"
35ERROR 2022/03/19 14:03:51 JSBUILD: failed to transform "icons/index.js" (application/javascript): Could not resolve "@fortawesome/fontawesome-svg-core"
36ERROR 2022/03/19 14:03:51 JSBUILD: failed to transform "service-worker/bundle.ts" (application/typescript): Could not resolve "workbox-core"
37ERROR 2022/03/19 14:03:51 JSBUILD: failed to transform "viewer/js/index.ts" (application/typescript): Could not resolve "viewerjs"
38Error: Error building site: JSBUILD: failed to transform "search/index.ts" (application/typescript): "/home/razonyang/Projects/razonyang/hugo-theme-bootstrap/assets/search/search.ts:1:17": Could not resolve "fuse.js"

Dit komt door het ontbreken van CSS- en JS-afhankelijkheden:

]]>Inhoud toevoegenhttps://1552afcb.notes-6if.pages.dev/docs/content/Sat, 04 Dec 2021 10:43:39 +0800https://1552afcb.notes-6if.pages.dev/docs/content/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:

]]>Afbeeldingsviewerhttps://1552afcb.notes-6if.pages.dev/docs/image-viewer/Fri, 03 Dec 2021 20:46:50 +0800https://1552afcb.notes-6if.pages.dev/docs/image-viewer/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 voelhttps://1552afcb.notes-6if.pages.dev/docs/look-and-feel/Fri, 03 Dec 2021 19:42:57 +0800https://1552afcb.notes-6if.pages.dev/docs/look-and-feel/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 webapphttps://1552afcb.notes-6if.pages.dev/docs/pwa/Fri, 03 Dec 2021 19:39:01 +0800https://1552afcb.notes-6if.pages.dev/docs/pwa/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.

]]>Doe meehttps://1552afcb.notes-6if.pages.dev/docs/get-involved/Sat, 27 Nov 2021 19:54:29 +0800https://1552afcb.notes-6if.pages.dev/docs/get-involved/Wij luisteren graag naar uw mening en feedback en heten u van harte welkom om mee te doen.

Gemeenschap

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.

]]>Beeldverwerkinghttps://1552afcb.notes-6if.pages.dev/docs/image-processing/Sun, 15 Aug 2021 14:19:06 +0800https://1552afcb.notes-6if.pages.dev/docs/image-processing/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)

Formaat wijzigen

Specificeer de hoogte en de behoudverhouding

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

Formaat wijzigen

]]>