Documentos on Martijn's Notes

Migrando a v1

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

Realice un seguimiento y revise los cambios en la documentación y los archivos fuente del tema para ayudarle a migrar de v0.* a v1.

Si no está seguro de cómo actualizar, consulte la guía Actualización.

##v1.0

El diseño de interfaz de usuario anterior está congelado en la rama v0 que solo acepta correcciones de errores. Puedes seguir usando el diseño de interfaz de usuario anterior con esa rama.

Dependencias

Bootstrap pasó de v5.1 a v5.2.

interfaz de usuario

Se eliminó el panel de configuración de la barra superior de aplicaciones.
Se agregaron los enlaces sociales en la barra superior de la aplicación.
Se colocó el interruptor de navegación de Documentos en la barra superior de aplicaciones en una pantalla pequeña.

Diseños

Se eliminó layouts/_default/archive.html, reemplace layout = archive con layout = archives al frente.
Renombrado layouts/partials/docs/catalog.html a layouts/partials/docs/nav.html.

SCSS

$variable-prefix en desuso, utilice $prefix en su lugar.
Utilice variables CSS integradas en Bootstrap en lugar de variables CSS definidas por temas.

Documentos

BREAKING CHANGE usa navWeight en lugar de weight para ordenar páginas en la navegación de documentos.

Códigos cortos

Código corto de alerta

BREAKING CHANGE cambia la sintaxis de alert, ver también Sintaxis de código corto de alerta.

Solución de problemas

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

Este artículo enumera algunos problemas comunes para que pueda resolverlos fácilmente.

CSS renderizado incorrectamente

El problema probablemente se debe a postcss, HBS necesita configurar la siguiente configuración, postcss confía en el archivo hugo_stats.json para purgar el CSS no utilizado.

1[build]
2  writeStats = true

js.Build: No se pudieron resolver las dependencias

 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"

Se debe a la falta de dependencias de CSS y JS:

Agregar contenido

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

Secciones principales

El parámetro mainSections se utiliza para filtrar páginas; el valor predeterminado es ["posts", "docs"].

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

Asunto frontal

Front Matter es el lugar donde colocamos los metadatos y parámetros de la página, como el título, la fecha, etc.

Formatos

Hugo admite tres formatos de portada: YAML, TOML y JSON.

TOML: identificado abriendo y cerrando +++.
YAML: identificado abriendo y cerrando ---.
JSON: un único objeto JSON rodeado por { y }, seguido de una nueva línea.

Tomemos TOML como ejemplo:

Visor de imágenes

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

El visor de imágenes es una galería de imágenes que se mostrará cuando haga clic en una imagen que no se puede vincular.

También proporciona muchas herramientas, como acercar, alejar y rotar.

El avatar del autor fue filtrado por defecto.

Parámetros del sitio

El Visor de imágenes estaba activado de forma predeterminada, puede desactivarlo configurando el parámetro viewer como false.

Opciones

Puede modificar las opciones creando assets/viewer/js/options.ts.

Mira y siente

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

De forma predeterminada, un sitio que utiliza este tema tiene las fuentes, los colores y la apariencia general predeterminados. Sin embargo, el esquema predeterminado no puede satisfacer a todos, pero no se preocupe, puede anular fácilmente los valores predeterminados del tema, como los colores de la paleta, las fuentes y el resaltado de sintaxis.

favicons

HBS genera iconos en varios tamaños según el archivo assets/favicon.webp (mayor prioridad) o assets/favicon.png. Simplemente guarde su propia imagen de favicon con la misma ruta para anular los valores predeterminados.

Aplicación web progresiva

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

Las PWA(Aplicaciones web progresivas) son aplicaciones web desarrolladas utilizando una serie de tecnologías específicas y patrones estándar que les permiten aprovechar las funciones de las aplicaciones web y nativas.

HBS proporciona algunas funciones básicas, como instalación del sitio en la pantalla de inicio, archivos de caché previo y disponibilidad sin conexión.

Parámetros del sitio

En primer lugar, debemos especificar el parámetro pwa, incluso si está vacío.

Complicarse

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

Estaremos encantados de escuchar sus opiniones y comentarios, y le invitamos a participar.

Comunidad

Solicitud de función
Informe de error
Discusiones: hacer preguntas, compartir ideas, etc.

Contribuir

Cualquier contribución es bienvenida, como documentos, corrección de errores y nuevas funciones.

Reglas

Para facilitar el mantenimiento, elaboramos algunas reglas.

Especificación de confirmaciones convencionales

Siga el Especificación de confirmaciones convencionales.

Procesamiento de imágenes

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

Este artículo ofrece algunos casos de uso para mostrar cómo cambiar el tamaño, recortar, ajustar, rellenar y alinear imágenes.

Cambiar el tamaño de las imágenes

Usamos la consulta URL de la imagen para cambiar el tamaño de las imágenes. Por ejemplo:

Especificar el ancho y conservar la proporción

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

Especifique la altura y mantenga la proporción

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