Configuration on Martijn's Notes

Configuración del sitio

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

La configuración del sitio se encuentra en config/_default/config.toml de forma predeterminada.

Nombre	Tipo	Predeterminado	Descripción
`title`	Cadena	-	Título del sitio.
`baseURL`	Cadena	-	URL base del sitio.
`copyright`	Cadena	-	Derechos de autor del sitio. El marcador de posición `{year}` será reemplazado por el año actual.
`defaultContentLanguage`	Cadena	`en`	Idioma predeterminado del sitio.
`defaultContentLanguageInSubdir`	Booleano	`false`
`paginate`	Entero	`10`
`paginatePath`	Cadena	`page`
`enableRobotsTXT`	Booleano	`true`
`disqusShortname`	Cadena	-	Disqus nombre corto.
`services`	Objeto	-
`services.googleAnalytics`	Objeto	-	Google Analytics, solo admite GA4.
`services.googleAnalytics.ID`	Cadena	-	Identificación de medición.
`author`	Objeto	-	Widget de autor.

Véase también Todos los ajustes de configuración.

Parámetros de página

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

Los parámetros de la página se encuentran en Asunto frontal de la página.

Nombre	Tipo	Predeterminado	Descripción
Página
`title`	Cadena	-	Título de la página.
`description`	Cadena	-	Descripción de la página.
`keywords`	Matriz	-	Palabras clave de la página.
`comment`	Booleano	`true`	Ya sea para habilitar los comentarios. No funcionará si `comment` se ha desactivado globalmente.
`toc`	Booleano	`true`	Ya sea para habilitar TOC. No funcionará si `toc` se ha desactivado globalmente.
`math`	Booleano	`false`	Ya sea para habilitar las matemáticas.
`diagram`	Booleano	`false`	Ya sea para habilitar el diagrama.
`reward`	Booleano	`true`	Ya sea para habilitar la recompensa.
`breadcrumb`	Booleano	`true`	Ya sea para habilitar la ruta de navegación.
`breadcrumbDivider`	Cadena	`/`	Divisor de pan rallado.
`readingTime`	Booleano	`true`	Ya sea para mostrar el tiempo de lectura.
`postDate`	Booleano	`true`	Si se muestra la fecha de publicación en la metasección de publicación.
`copyright`	Booleano	`true`	Ya sea para mostrar la sección de derechos de autor.
`carousel`	Booleano	`false`	Mostrar en carrusel.
`nav`	Booleano	`true`	Activar/desactivar las navegaciones.
`sidebar`	Booleano	`true`	Mostrar/Ocultar la barra lateral.
`index`	Booleano	`true`	Indexar esta página en el buscador del cliente o no.
Licencia Creative Commons
`creativeCommons`	Objeto	-
`creativeCommons.by`	Booleano	`true`	El crédito debe ser otorgado a usted, el creador.
`creativeCommons.nc`	Booleano	`true`	Sólo se permite el uso no comercial de su trabajo.
`creativeCommons.nd`	Booleano	`true`	No se permiten derivados ni adaptaciones de su trabajo.
`creativeCommons.sa`	Booleano	`true`	Las adaptaciones deben compartirse en los mismos términos.
Metaetiqueta
`metaRobots`	Cadena	-	Vacío significa que lo apagas.
`pinned`	Booleano	`false`	Fijar publicaciones.
`pinnedWeight`	Número	-	El peso más bajo tiene mayor prioridad.
`featuredPostCount`	Entero/Booleano	`5`	La cantidad de publicaciones destacadas que se muestran en la barra lateral. Apáguelo configurándolo en `false`.
`recentPostCount`	Entero/Booleano	`5`	El número de publicaciones recientes que se muestran en la barra lateral. Apáguelo configurándolo en `false`.
`relatedPostCount`	Entero/Booleano	`5`	El número de publicaciones relacionadas. Apáguelo configurándolo en `false`.
`featuredImageAlt`	Cadena	-	El texto alternativo para las imágenes destacadas, retrocede al título de la página si no está presente.
`numberifyHeadings`	Booleano	`true`	Cuando `false`, los encabezados no se numerarán.

Parámetros del sitio

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

Los parámetros del sitio se encuentran en config/_default/params.toml de forma predeterminada.

Nombre	Tipo	Predeterminado	Descripción
`sass_transpiler`	cadena	`libsass`	Se recomienda `dartsass`, ya que `libsass` está en desuso.
Página
`mainSections`	Matriz	`["posts"]`	Secciones principales
`titleCase`	Booleano	`false`	Título en mayúscula o no
`titleSeparator`	Cadena	`-`	Separador de título
`backgroundImage`	Matriz	`[]`	Imagen de fondo, como `['/images/bg.png']`, `['/images/bg-light.png', '/images/bg-dark.png']`.
`comment`	Booleano	`true`	Si habilitar comentarios
`toc`	Booleano	`true`	Ya sea para habilitar TOC
`tocWordCount`	Entero	`280`	TOC se muestra solo si el recuento de palabras de la publicación es mayor que este valor.
`tocPosition`	Cadena	`sidebar`	Valores disponibles: `sidebar` y `content`, solo se ve afectado el diseño `posts`.
`breadcrumb`	Booleano	`true`	Ya sea para habilitar la ruta de navegación
`dateFormat`	Cadena	`Jan 2, 2006`	Formato de fecha. Consulte Referencia de plantillas de fecha y hora de Hugo para obtener más detalles.
`poweredBy`	Booleano	`true`	Ya sea para mostrar impulsado por.
`readingTime`	Booleano	`true`	Ya sea para mostrar el tiempo de lectura.
`postDate`	Booleano	`true`	Si se muestra la fecha de publicación en la metasección de publicación.
`math`	Booleano	`false`	Ya sea para habilitar las matemáticas a nivel mundial.
`diagram`	Booleano	`false`	Ya sea para habilitar el diagrama globalmente.
`logo`	Cadena/Booleano	`images/logo.webp`	Imagen del logotipo. Deshabilite el logotipo configurándolo en `false`.
`brand`	Cadena	-	Texto de marca.
`description`	Cadena	-	Descripción del sitio.
`keywords`	Cadena	-	Palabras clave del sitio.
`color`	Cadena	-	Modo de color, `light`, `dark` o `auto`. El valor predeterminado es `auto`.
`palette`	Cadena	-	Paleta predeterminada. Esto entrará en vigor después de borrar la cookie.
`palettes`	Matriz	TODOS	Paletas disponibles. Puede desactivarlo configurándolo en `[]` vacío.
`carouselPostCount`	Entero	`5`	El número de publicaciones que se muestran en el carrusel de la página de inicio.
`featuredPostCount`	Entero/Booleano	`5`	La cantidad de publicaciones destacadas que se muestran en la barra lateral. Apáguelo configurándolo en `false`.
`recentPostCount`	Entero/Booleano	`5`	El número de publicaciones recientes que se muestran en la barra lateral. Apáguelo configurándolo en `false`.
`relatedPostCount`	Entero/Booleano	`5`	El número de publicaciones relacionadas. Apáguelo configurándolo en `false`.
`categoryCount`	Entero/Booleano	`10`	El número de categorías que se muestran en la barra lateral. Apáguelo configurándolo en `false`.
`tagCount`	Entero/Booleano	`10`	El número de etiquetas que se muestran en la barra lateral. Apáguelo configurándolo en `false`.
`seriesCount`	Entero	`10`	El número de series que se muestran en la barra lateral.
`taxonomyPaginate`	Entero	`10`
`taxonomyPostCount`	Entero	`3`	El número de publicaciones de la taxonomía. Desactívelo configurándolo en falso.
`taxonomySortingMethod`	Cadena	-	Ordenar taxonomías por `popularity`, ordenar alfabéticamente de forma predeterminada.
`countTaxonomyPosts`	Booleano	`false`	Contar publicaciones de taxonomía.
`sidebarTaxonomies`	Matriz	`["series", "categories", "tags"]`	Las taxonomías en la barra lateral.
`fullWidth`	Booleano	`false`	Ancho completo.
`fullWidthInSections`	Objeto	-	Especifique el ancho completo para secciones particulares, como `posts`, `docs`.
`fixedHeader`	Booleano	`true`	Activar/desactivar el encabezado fijo.
`reward`	Objeto	-	Widget de recompensa, también conocido como Cómprame un widget de café.
`externalLinkIcon`	Booleano	`true`	Si mostrar los íconos después de los enlaces externos.
`share`	Objeto	-	Botones de compartir
`share.addThis`	Cadena	-	Agregar esto `pubid` de Agregar esto.
`fontSize`	Objeto	Tamaños de fuente	Comente o elimine este parámetro para deshabilitar el cambio de tamaño de fuente.
`fontSize.small`	Cadena	`.9rem`	Tamaño de fuente pequeño.
`fontSize.extraSmall`	Cadena	`.8rem`	Tamaño de fuente extra pequeño.
`fontSize.large`	Cadena	`1.1rem`	Tamaño de fuente grande.
`fontSize.extraLarge`	Cadena	`1.2rem`	Tamaño de fuente extra grande.
`social`	Objeto	-	Enlaces sociales.
`socialAnimation`	Booleano	`true`	Elimine la animación de los enlaces sociales si `false`.
`socialColor`	Booleano	`true`	Elimine el color de los enlaces sociales si `false`.
`socialShare`	Booleano	`true`	Activa o desactiva el botón integrado para compartir en redes sociales.
`searchBar`	Booleano	`true`	Activa o desactiva la barra de búsqueda integrada.
`archive`	Objeto	-	Archivo.
`search`	Objeto	-	Buscar.
`docsearch`	Objeto	-	Búsqueda de documentos
`docsearch.container`	Cadena	`.search-button`
`docsearch.appId`	Cadena	-
`docsearch.indexName`	Cadena	-
`docsearch.apiKey`	Cadena	-
`docsearch.debug`	Booleano	`false`
`docsearch.*`	Booleano/Cadena/Número	-	https://docsearch.algolia.com/docs/api/
`algolia`	Objeto	-	Ver Algolia
Barra superior de aplicaciones
`topAppBar`	Objeto	-
`topAppBar.social`	Objeto	-	Enlaces sociales.
`topAppBar.colorToggle`	Booleano	`true`	Activa/desactiva el cambio de color/modo.
`topAppBar.coloredInDark`	Booleano	`false`	Coloreado en modo oscuro.
`topAppBar.dropdownMenuToggle`	Booleano	`true`	Ocultar el menú desplegable.
`topAppBar.expandBreakpoint`	cadena	`xxl`	Expanda el contenido por encima de este punto de interrupción, p. `lg`, `xl`, `xxl`.
Verificación del sitio para webmasters
`siteVerification`	Objeto	-
`siteVerification.google`	Cadena	-	google
`siteVerification.bing`	Cadena	-	Bing
`siteVerification.baidu`	Cadena	-	Baidu
`siteVerification.baiduUnion`	Cadena	-	Unión Baidu
`siteVerification.so`	Cadena	-	Qihoo 360
`siteVerification.sogou`	Cadena	-	Sogou
`siteVerification.shenma`	Cadena	-	Shenma
Analítica
`analytics`	Objeto	-	Configuración analítica.
`analytics.baidu`	Cadena	-	Análisis de Baidu.
`analytics.plausible`	Cadena	-	Dominios de análisis plausibles. Múltiples dominios separados por coma.
`analytics.plausibleScript`	Cadena	`https://plausible.io/js/script.js`	Especifique el script de Plausible Analytics autohospedado o guión extendido.
`googleAdsense`	Cadena	-	Adsense de Google.
`customCSS`	Matriz	-	Véase también activos personalizados.
`customJS`	Matriz	-	Véase también activos personalizados.
`utterances`	Objeto	-	Declaraciones configuración.
`giscus`	Objeto	-	gisco configuración.
Licencia Creative Commons
`creativeCommons`	Objeto	-
`creativeCommons.by`	Booleano	`true`	El crédito debe ser otorgado a usted, el creador.
`creativeCommons.nc`	Booleano	`true`	Sólo se permite el uso no comercial de su trabajo.
`creativeCommons.nd`	Booleano	`true`	No se permiten derivados ni adaptaciones de su trabajo.
`creativeCommons.sa`	Booleano	`true`	Las adaptaciones deben compartirse en los mismos términos.
Bloque de código
`codeBlock`	Objeto	-
`codeBlock.maxLines`	Entero	`7`
`codeBlock.lineNos`	Booleano	`true`	`true`/`false` representa que muestra/oculta los números de línea de forma predeterminada.
Publicar
`post`	Objeto	-
`post.excerpt`	Cadena	`Description`	La descripción se usará como extracto si no está vacía; para usar resúmenes como extracto, deberá configurarlo como cadena vacía explícitamente.
`post.excerptMaxLength`	Entero	`320`
`post.copyright`	Booleano	`true`	Si mostrar la sección de derechos de autor en cada publicación.
`post.plainifyExcerpt`	Booleano	`true`	Formatee el extracto en HTML si `false`.
`post.featuredImage`	Booleano	`false`	Muestra la imagen destacada encima del contenido.
`post.numberifyHeadings`	Booleano	`false`	Cuente los encabezados automáticamente.
`post.numberifyHeadingsEndLevel`	Número	`6`	La profundidad de los títulos a contar.
`post.numberifyHeadingsSeparator`	Cadena	-	El separador entre número y encabezados.
`post.tocStyleType`	Cadena	`none`	Propiedad CSS `list-style-type` del TOC.
`post.imageTitleAsCaption`	Booleano	`false`	Utilice el título de la imagen como título.
`post.panel`	Booleano	`true`	Activa o desactiva el panel de publicaciones.
`post.nav`	Booleano	`true`	Activar/desactivar las navegaciones.
`post.readMoreFromContent`	Booleano	`false`	La posición de la página después de hacer clic en el botón Leer más, leer más del contenido si es verdadero. Por defecto, al principio de la página. Solo admite la división de resúmenes manuales a través de `

Estructura de configuración

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

Como se muestra en el sitio de ejemplo, utilizamos Directorio de configuración para mantener una organización más sencilla y configuraciones específicas del entorno; es especialmente útil en sitios multilingües.

 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 admite múltiples formatos de configuración: TOML, YAML y JSON, cámbielo a voluntad.