Configurando la sección de Publicaciones Destacadas

La sección de Publicaciones Destacadas sirve para mostrar las publicaciones que quieras. Para habilitar esta sección, crea un archivo featured-posts.yaml dentro del directorio data/es/sections e incluye el siguiente contenido: # Información de la sección section: name: Publicaciones DestacadAS # Título de la sección id: featured-posts # id del url de la sección *se requiere* enable: true # Booleano que determina si la sección está activada (predeterminado: false) weight: 6 # Orden de la sección (predeterminado: alfabeticamente seguida del peso) showOnNavbar: true # Booleano que determina si el enlace de esta sección debe aparecer en la barra de navegación hideTitle: true # Opcionalmente puede ocultar el título del menú (predeterminado: false) # publicaciones a destacar posts: - quickstart - update-v3-to-v4 - prepare-site

Cómo contribuir?

Maneras de contribuir Puedes contribuir a este tema de varias maneras. Código Los Pull Requests son bienvenidos y estaré encantado de revisarlos. Simplemente siga los siguientes principios: Manténgalo simple. Manténgalo consistente con el diseño. Utilice la menor cantidad de dependencias posible. Ten paciencia. Testeando y reportando errores Puedes reportar un bug También puedes pedir una característica Dar ideas y sugerencias Documentación También puedes contribuir con la documentación del tema: You can also contribute to the theme documentation by:

Cómo añadir un idioma sin soporte

Si desea traducir a un idioma si soporte, puede traducir los elementos de la interfaz de usuario. Crea el archivo i18n Para haerlo, debes crear el directorio i18n dentro de la raíz del sitio, el directorio dónde puede encontrar el archivo hugo.yaml, y directorios como data, content, etc. Luego, puedes crear el archivo <código_del_idioma>.toml dentro del directorio i18n. En este directorio puedes encontrar todos los códigos de idiomas con las banderas que aparecerán junto a ese idioma.

Añadiendo una nueva Sección

Si las secciones, plantillas y componentes existentes no cumplen con tus necesidades, puedes añadir nuevas secciones, plantillas y componentes a tu sitio web. Esta guía te enseñará cómo añadir una nueva sección a tu sitio. Paso 1: Cambia el archivo de Disposición Para añadir una nueva sección a tu sitio, necesitarás crear un archivo de disposicion en el directorio layouts/partials/sections. El archivo debería tener el nombre de la sección. Por ejemplo, si quieres añadir una sección contact con un formulario de contacto, crea un archivo llamado contact.html. Usa la siguiente plantilla para el archivo contact.html:

Personalización del CSS

Este tema te permite personalizar la apariencia de tu sitio y sus componentes sobrescribiendo el CSS predeterminado. Esta guía te enseñará cómo sobrescribir el esquema de colores del tema y la personalización de CSS de componentes individuales. Este tema usa Sass para generar el CSS. Si no está familiarizado con Sass, puedes aprender más sobre él aquí. Sobrescribe las variables de los colores Si quieres cambiar los colores por defecto del tema, pueds sobrescribir las variables de los colores. Para sobrescribir las variables de los colores del tema, necesitarás crear un archivo nombrado variables.scss dentro del directorio assets/styles de tu sitio. Después copia el contenido predeterminado del archivo variables.scss, y ponlo en tu archivo variables.scss. Aquí, solo la sección de $theme predeterminada de variables.scss es mostrada:

Migrar de la versión V3 a V4

Toha V4 ha introducido muchos cambios que pueden romper el tema, es decir, cambian cómo se usa y configura el tema. Esta guía ta ayudará a migrar de la versión del tema v3 a v4. Por favor, compruebe estas release notes para el registro de cambios completo. En esta guía, lo guiaré por los pasos para migrar de la versión 3 a la versión 4 del tema Toha. Esta guía se basa en la guía de migración escrita por Alexandre Neto en este issue. ¡Empecemos!

Inicio Rápido

¡Saludos! Gracias por decidirte utilizar este tema. En esta guía, te enseñaré cómo puedes empezar con este tema rápidamente. Aquí asumiré que quieres empezar de cero una página de Hugo utilizando este tema. Si ya estás usando Hugo para tu sitio, entonces ya sabes cómo utilizar un tema. En este caso, por favor, sigue este repositorio de ejemplo para más información. Requisitos Para ejecutar el tema localmente, debes tener las siguientes herramientas instaladas.

Habilitar Tema Oscuro

Para habilitar el modo oscuro en Toha v4.0.0, simplemente establece el campo darkMode.enable a true debajo de la sección params.features dentro del archivo hugo.yaml. Por ejemplo: params: features: darkMode: enable: true ¡Felicidades! Estas listo. Ahora puedes disfrutar del modo oscuro en tu sitio. El modo oscuro obedecerá a las preferencias del sistema del usuario.

Soporte Mermaid

Este tema soporta mermaid, desarrollado por mermaid-js. Para habilitar mermaid para una página, tienes que poner mermaid: true en tu página de front-matter. Por ejemplo, esta página tiene el siguiente front-matter: title: "Soporte Mermaid" date: 2022-03-14T06:15:35+06:00 menu: sidebar: name: Mermaid identifier: writing-post-mermaid parent: writing-post weight: 60 mermaid: true Después, puede usar el shortcode mermaid para añadir contenido de mermaid. Por ejemplo: {{< mermaid align="center">}} # su contenido de mermaid aquí {{< /mermaid >}} El shortcode de mermaid acepta los siguientes parámetros:

Comentarios

Comentarios Este tema tiene soporte para comentarios en las publicaciones. Actualmente, soporta las siguientes extensiones de comentarios: Disqus Valine Utterances Giscus Para una lista completa de las extensiones de comentarios soportadas, puede consultar el archivo de ejemplo hugo.yaml. Disqus Disqus es una extensión de comentarios popular. Después de acceder a Disqus necesitarás proveer tu shortname debajo de la sección params.features de tu archivo hugo.yaml, como a continuación: comment: enable: true services: disqus: shortName: ejemplo-de-sitio-de-toha Valine Valine resulta ser una extensión de comentarios chino. Puedes habilitar la extensión de comentarios valine añadiendo la sección valine debajo de la sección params.features de tu archivo hugo.yaml, como a continuación:

Enlaces de Soporte

Este tema soporta la adición de varios enlaces de soporte/donación en su sitio. Actualmente, los enlaces de soporte admitidos son: Ko-fi Buy Me a Coffee Para una lista completa de los enlaces de soporte admitidos, puede consultar el archivo de ejemplo hugo.yaml. Ko-fi Puedes añadir tu botón flotante Ko-fi en tu sitio web. Para añadir el botón flotante, añade la sección support debajo de la sección params.features del archivo hugo.yaml. support: enable: true services: kofi: user: <id de tu usuario de ko-fi> text: Tip Me textColor: '#f9fafc' backgroundColor: '#248aaa' Buy Me a Coffee Puedes añadir tu botón flotante “Buy Me a Coffee” en tu sitio web. Para añadir el botón flotante, añade la sección support debajo de la sección params.features del archivo hugo.yaml.

Link externo en la barra lateral