Anuncios | Example Hugo site with Toph themehttps://justwheel.github.io/toph-hugo-theme/es/categories/announcements/Honorary biography page of Septima Clark, a Civil Rights Movement pioneer and activist.Hugo -- gohugo.ioesSeptima Poinsette ClarkMon, 01 Jan 0001 00:00:00 +0000Blogging con AsciiDoc en Tophhttps://justwheel.github.io/toph-hugo-theme/es/blog/asciidoc-blogging/Mon, 23 Mar 2026 00:00:00 +0000https://justwheel.github.io/toph-hugo-theme/es/blog/asciidoc-blogging/

Toph trata a AsciiDoc como un formato de contenido de primera clase. Todo lo que funciona con Markdown también funciona con AsciiDoc: insignias de taxonomía, metadatos de publicaciones, imágenes de portada, anclas de encabezado y navegación.

¿Por qué AsciiDoc?

AsciiDoc ofrece funciones que Markdown no tiene:

  • Tabla de contenido nativa con el atributo de documento :toc:

  • Bloques de admonición (NOTE, TIP, WARNING, IMPORTANT, CAUTION)

  • Directivas de inclusión para reutilizar contenido entre páginas

  • Soporte integrado para tablas complejas y listas anidadas

Si ya te sientes cómodo escribiendo en AsciiDoc, Toph atenderá tus necesidades sin compromisos.

Crear una publicación en AsciiDoc

Crea un archivo con la extensión .adoc en tu directorio de blog:

hugo new blog/my-post.adoc

Añade el front matter en YAML al principio del archivo, seguido del contenido en AsciiDoc:

---
title: "Título de mi publicación"
date: 2026-01-15
draft: false
categories:
  - "tech"
tags:
  - "hugo"
  - "asciidoc"
author: "Nombre del autor"
description: "Un breve resumen de la publicación."
---

Tu contenido en AsciiDoc comienza aquí.

Tabla de contenido

Para habilitar una tabla de contenido, añade el atributo :toc: después del front matter:

---
title: "Título de mi publicación"
toc: true
---
:toc:

== Primera sección

El CSS de Toph da estilo a la tabla de contenido generada por AsciiDoc de forma idéntica a la opción toc: true del front matter de Markdown. Ambos formatos producen el mismo resultado visual.

Anclas de encabezado

Aparecen enlaces de anclaje en los que se puede hacer clic (🔗) al pasar el cursor sobre todos los encabezados de sección. Para Markdown, esto se gestiona mediante un render hook. Para AsciiDoc, Toph inyecta el mismo marcado de anclaje mediante el procesamiento de plantillas. Ambos formatos producen resultados idénticos.

Más información

]]>Hola Mundo: Presentando los Blogs en Tophhttps://justwheel.github.io/toph-hugo-theme/es/blog/hello-world/Sun, 22 Mar 2026 00:00:00 +0000https://justwheel.github.io/toph-hugo-theme/es/blog/hello-world/¡Nos complace anunciar que el tema Toph de Hugo ahora es compatible con blogs! Toph comenzó como un tema ligero de biografía y portafolio, pero se ha convertido en una plataforma de publicación capaz. Aquí tienes un recorrido rápido por las novedades.

Compatibilidad con taxonomías 🔗

Las publicaciones se pueden organizar con categorías y etiquetas. Las categorías son agrupaciones amplias que se muestran como tarjetas de estilo revista en la página de categorías. Las etiquetas son más granulares y se muestran como una nube de palabras visual en la página de etiquetas.

Para usarlas, añade categories y tags al front matter de tu publicación:

categories: ["announcements"]
tags: ["toph", "blogging", "hugo"]

Metadatos de la publicación 🔗

Cada publicación de blog muestra automáticamente su fecha de publicación, autor, tiempo de lectura y número de palabras. Las categorías y etiquetas aparecen como insignias enlazadas debajo de la barra de metadatos. Si tu sitio tiene enableGitInfo: true, aparece una fecha de “Actualizado” cuando la publicación se modifica después de su publicación.

Archivo del blog 🔗

El archivo del blog agrupa las publicaciones por año y mes en un diseño de acordeón colapsable. El año y mes más recientes están expandidos de forma predeterminada, manteniendo el archivo fácil de explorar incluso a medida que crece.

Publicaciones recientes en la página de inicio 🔗

Las cinco publicaciones de blog más recientes aparecen automáticamente en la página de inicio. La última publicación se destaca en una tarjeta grande, con las siguientes cuatro en una cuadrícula compacta debajo. No se necesita configuración: si existen publicaciones de blog, aparecen.

Al final de cada publicación, los enlaces de anterior y siguiente permiten a los lectores moverse entre publicaciones sin volver al archivo.

Primeros pasos 🔗

Crea una nueva publicación de blog con el arquetipo integrado de Hugo:

hugo new blog/my-first-post.md

Esto genera una nueva publicación con los campos correctos en el front matter. Establece draft: false cuando estés listo para publicar, y reconstruye tu sitio.

Para más detalles, consulta el repositorio del tema Toph.

]]>