Diseños on Martijn's Notes

Diseño de página de destino

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

En este artículo, hablaremos sobre el diseño de la página de destino; puede que le interese si va a personalizar las páginas en modo Markdown.

¿Qué es?

El diseño de la página de destino es solo un contenedor esqueleto, el cuerpo consta de tres partes: barra superior de la aplicación, contenido de la página y pie de página.

Ventajas

Redacción de contenidos en Markdown.
Códigos cortos reutilizables.

¿Cómo usarlo?

Es bastante simple de usar, simplemente especifique type como landing y sidebar como false en la portada de la página, el resto es todo acerca de su contenido.

Diseño de documentos

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

En este artículo, exploraremos el diseño docs, que se puede utilizar para escribir documentación del proyecto, notas personales y más.

Si va a utilizar el diseño docs en otras secciones(notes), eche un vistazo a la página Contenido.

Diseño

El diseño docs consta de tres secciones, de principio a fin: barra de navegación del documento, contenido del documento y barra lateral.

Estructura de contenido

 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

Diseño de preguntas frecuentes

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

La página Preguntas frecuentes es una colección de preguntas frecuentes.

Requisitos previos

Necesitamos crear una página llamada faq/index.md en el directorio content.

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

Datos

Los datos se almacenan en el directorio data, la estructura del directorio es la siguiente:

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

Como puedes ver, clasificamos las preguntas según su idioma. Y cada archivo representa un grupo de preguntas, que tiene el mismo formato de la siguiente manera:

Diseño de archivo

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

La página de archivo es una colección de publicaciones agrupadas por año.

Requisitos previos

Las páginas no se crean automáticamente, primero debemos crear secciones de archivos:

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

El contenido de esos archivos solo contiene un parámetro title.

Parámetros del sitio

Nombre	Tipo	Predeterminado	Descripción
`archive`	Objeto	-	Archivo.
`archive.dateFormat`	Cadena	`Jan 2`	Formato de fecha de archivo.
`archive.monthFormat`	Cadena	`January`	Formato del mes de archivo, p. `1`, `01`, `Jan` y `January`.
`archive.basePath`	Cadena	`/archives`

Diseño de búsqueda

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

Puede resultar difícil para los lectores recuperar un artículo si hay muchos artículos en su sitio, por lo que agregamos la función de búsqueda.

Requisitos previos

Todo lo que necesita hacer es crear una página llamada search/_index.md en el directorio content.

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

Parámetros del sitio

Nombre	Tipo	Predeterminado	Descripción
`search`	Objeto	-	Configuración de búsqueda.
`search.paginate`	Entero	`10`	Paginación.
`search.indexPaginate`	Entero	`1000`	Paginación de archivos de índice.
`search.indexPreload`	Booleano	`true`	Si se deben precargar los índices de búsqueda.
`search.maxResults`	Número	`100`	El número máximo de resultados de búsqueda.
`search.resultContentCharactersCount`	Entero	`240`	El número máximo de caracteres del contenido del resultado para mostrar.
`search.shortcut`	Matriz	`["/"]`	El acceso directo de búsqueda, es decir, `["Control", "/"]`, deshabilítelo mediante una matriz vacía `[]`.
`search.fuse`	Objeto	-	Opciones de Fuse.js.
`search.fuse.ignoreLocation`	Booleano	`true`
`search.fuse.location`	Entero	-
`search.fuse.isCaseSensitive`	Booleano	-
`search.fuse.minMatchCharLength`	Entero	-
`search.fuse.threshold`	Doble	-
`search.fuse.distance`	Entero	-
`search.fuse.useExtendedSearch`	Booleano	-

Formulario de contacto

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

Podemos poner nuestra dirección de correo electrónico en enlaces sociales para que los lectores puedan contactarnos. Desafortunadamente, los correos electrónicos serán más o menos tratados como spam e incluso filtrados. Por lo tanto, traemos una función llamada formulario de contacto.

Requisitos previos

Necesitamos crear una página de contacto llamada contact/index.md en el directorio content, para que podamos acceder al formulario de contacto.

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

Una vez creado, el enlace aparecerá en el widget de perfil.