Documents on Martijn's Notes

Migration vers la v1

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

Suivez et examinez les modifications apportées aux fichiers sources du thème et à la documentation pour vous aider à migrer de v0.* vers v1.

Si vous ne savez pas comment effectuer la mise à niveau, consultez le guide Mise à niveau.

## v1.0

L’ancienne conception de l’interface utilisateur est figée sur la branche v0 qui n’accepte que les corrections de bugs. Vous pouvez continuer à utiliser l’ancienne conception de l’interface utilisateur avec cette branche.

Dépannage

Sat, 19 Mar 2022 13:46:41 +0800

Cet article répertorie certains problèmes courants afin que vous puissiez les résoudre facilement.

Rendu CSS incorrect

Le problème est probablement dû au postcss, HBS a besoin de configurer la configuration suivante, postcss s’appuie sur le fichier hugo_stats.json pour purger les CSS inutilisés.

1[build]
2  writeStats = true

js.Build : Impossible de résoudre les dépendances

 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"

Cela est dû au manque de dépendances CSS et JS :

Ajout de contenu

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

Sections principales

Le paramètre mainSections est utilisé pour filtrer les pages, par défaut ["posts", "docs"].

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

Questions préliminaires

Front Matter est l’endroit où nous mettons les métadonnées et les paramètres de la page, tels que le titre, la date, etc.

###Formats

Hugo prend en charge trois formats de présentation : YAML, TOML et JSON.

TOML : identifié par l’ouverture et la fermeture de +++.
YAML : identifié par l’ouverture et la fermeture de ---.
JSON : un seul objet JSON entouré de { et }, suivi d’une nouvelle ligne.

Prenons TOML comme exemple :

Visionneuse d'images

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

La visionneuse d’images est une galerie d’images, elle s’affichera lorsque vous cliquerez sur une image non pouvant être liée.

Il fournit également de nombreux outils, tels que le zoom avant, le zoom arrière et la rotation.

L’avatar de l’auteur a été filtré par défaut.

Paramètres du site

Image Viewer a été activé par défaut, vous pouvez le désactiver en définissant le paramètre viewer sur false.

##Options

Vous pouvez modifier les options en créant assets/viewer/js/options.ts.

Regardez et ressentez

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

Par défaut, un site utilisant ce thème a les polices, les couleurs et l’apparence générale par défaut. Cependant, le schéma par défaut ne peut pas satisfaire tout le monde, mais ne vous inquiétez pas, vous pouvez facilement remplacer les valeurs par défaut du thème, telles que les couleurs de la palette, les polices et la coloration syntaxique.

Icônes de favoris

HBS génère des icônes de plusieurs tailles en fonction du fichier assets/favicon.webp (priorité plus élevée) ou assets/favicon.png. Enregistrez simplement votre propre image de favicon sous le même chemin pour remplacer les valeurs par défaut.

Application Web progressive

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

Les PWA (Applications Web progressives) sont des applications Web développées à l’aide d’un certain nombre de technologies spécifiques et de modèles standard pour leur permettre de tirer parti des fonctionnalités du Web et des applications natives.

HBS fournit certaines fonctionnalités de base, telles que l’installation du site sur l’écran d’accueil, les fichiers de pré-cache et la disponibilité hors ligne.

Paramètres du site

Tout d’abord, nous devons spécifier le paramètre pwa, même s’il est vide.

Impliquez-vous

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

Nous sommes heureux d’écouter vos opinions et vos commentaires et vous invitons à vous impliquer.

Communauté

Demande de fonctionnalité
Rapport de bug
Discussions : posez des questions, partagez des idées etc.

Contribuer

Toutes les contributions sont les bienvenues, telles que la documentation, les corrections de bugs et les nouvelles fonctionnalités.

Règles

Compte tenu de la facilité d’entretien, nous établissons quelques règles.

Traitement d'images

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

Cet article propose quelques cas d’utilisation pour montrer comment redimensionner, recadrer, ajuster, remplir et aligner des images.

Redimensionner les images

Nous utilisons la requête URL de l’image pour redimensionner les images. Par exemple :

Spécifiez la largeur et conservez le rapport

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

Spécifiez la hauteur et le rapport de préservation

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

Spécifiez la largeur et la hauteur

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