tabi

? tabi

Un tema de Zola accesible con búsqueda, soporte en varios idiomas, JavaScript opcional, una puntuación perfecta de Lighthouse y documentación completa. Diseñado para blogs y sitios web personales.

Consejo

¿Quieres empezar a escribir blogs de inmediato? Utilice la plantilla tabi-start para poner en funcionamiento un sitio completo en minutos.

Vea una vista previa en vivo (y la documentación del tema) aquí.

Explore la sección Sitios que utilizan tabi para ver aplicaciones del mundo real.

tabi (旅, / t ɐ ˈ b i /): Viaje.

tabi tiene una puntuación perfecta en la auditoría Lighthouse de Google:

Características

• Establece cualquier idioma como predeterminado. Configure su sitio base en chino, español, francés, hindi… o cualquier otro idioma admitido. La interfaz del tema se traducirá en consecuencia.
• Integración con repositorios remotos en GitHub, GitLab, Gitea y Codeberg para el historial de confirmaciones y mostrar la fuente del sitio.
• Soporte de series para crear contenido secuencial como tutoriales, cursos e historias de varias partes.
• Temas oscuros y claros. El valor predeterminado es la configuración del sistema operativo, con un conmutador en la barra de navegación.
• Documentación exhaustiva. Consulte Dominar la configuración de tabi: una guía completa.
• Puntuación Perfect Lighthouse (rendimiento, accesibilidad, mejores prácticas y SEO).
• Soporte integral en varios idiomas. Añade tantos idiomas como desees.
• Soporte para comentarios usando giscus, expresiones, Hyvor Talk o Isso.
• Resaltado de sintaxis de código con colores basados ​​en Catppuccin Frappé.
• Soporte de sirena para crear diagramas y cuadros con texto.
• Búsqueda local con una interfaz accesible y multilingüe.
• Tarjeta de Twitter personalizada y etiquetas automáticas de Open Graph.
• Soporte KaTeX para notación matemática.
• Feed Atom estilizado y legible por humanos.
• Mapa del sitio estilizado y legible por humanos.
• Codificación de correo para protección contra spam.
• Todo JavaScript se puede desactivar por completo.
• Tabla de contenidos personalizable.
• Encabezados seguros personalizables.
• Botón Copiar para bloques de código.
• Botones de navegación rápida.
• Aviso de derechos de autor personalizado.
• URL canónicas personalizadas.
• Códigos cortos personalizados.
• Máscaras personalizables.
• Tarjetas de redes sociales.
• Diseño responsivo.
• Página de proyectos.
• Página de archivo.
• Publicaciones fijadas.
• Enlaces sociales.
• Etiquetas.

Instalación

Nota

La forma más rápida de crear un sitio nuevo es utilizar la plantilla tabi-start. Esto le brinda una configuración de blog completa con toda la configuración esencial lista para funcionar.

instalación manual

Para agregar tabi a su sitio Zola existente:

0. Inicialice un repositorio Git en el directorio de su proyecto (si aún no lo ha hecho):

 git init

1. Agregue el tema como un submódulo de git:

 git submodule add https://github.com/welpo/tabi.git themes/tabi

O clona el tema en tu directorio de temas:

 git clone https://github.com/welpo/tabi.git themes/tabi

Configuración requerida

2. Habilite el tema en su config.toml :

 theme = "tabi"

3. Establece un title en tu config.toml :

 title = "Your Site Title"

4. Configure el resaltado de bloques de código en su config.toml :

[ markdown ]
highlight_code = true
highlight_theme = " css "

5. Cree un archivo content/_index.md . Este archivo controla cómo se ve y se comporta su página de inicio. Elija una de las siguientes opciones:

   Opción A: publicar publicaciones desde / :

    +++
   title = "Home"
   paginate_by = 5  # Show 5 posts per page.
   +++
   

   • Esto mostrará publicaciones en content/ con paginación.

   Opción B: publicar publicaciones desde una ruta diferente (por ejemplo, blog/ ) :

    +++
   title = "Home"
   # Note we're not setting `paginate_by` here.
   
   [extra]
   section_path = "blog/_index.md"  # Where to find your posts.
   max_posts = 5  # Show 5 posts on the home page.
   +++
   

   • Esto mostrará las últimas 5 publicaciones del blog/ sección.
   • No configure paginate_by si elige esta opción.
   • Utilice la ruta completa al archivo _index.md de la sección. Usar section_path = "blog/" no funcionará.

Advertencia

No establezca tanto paginate_by como section_path en content/_index.md .

Estas configuraciones son mutuamente excluyentes y el uso de ambas puede resultar en que no se muestren publicaciones.

6. Si desea una sección de introducción (vea la captura de pantalla anterior), agregue estas líneas a content/_index.md :

 [extra]
header = {title = "Hello! I'm tabi~", img = "img/main.webp", img_alt = "Your Name" }

El contenido fuera de la portada se mostrará entre el título del encabezado y la lista de publicaciones. En la captura de pantalla anterior, el texto que dice "tabi es un tema de Zola rápido, liviano y moderno...".

7. Si desea un sitio multilingüe, deberá configurar cada idioma. En config.toml , configure el título y las taxonomías para cada idioma, como:

[ languages . es ]
title = " ~/tabi "
taxonomies = [{ name = " tags " , feed = true }]

Necesitará un _index.{language_code}.md por idioma para cada sección (por ejemplo, /blog o /projects) que desee habilitar en ese idioma.

Lo mismo ocurre con las publicaciones individuales, que deben tener exactamente el mismo nombre que el idioma predeterminado, con un .{code} adicional antes de la extensión (por ejemplo, la versión en español de security.md sería security.es.md ).

Esta configuración permite que el selector de idioma lleve al usuario a la traducción de la URL actual. Si no existe una traducción, se mostrará la página 404, con una explicación en cada idioma configurado en la configuración.

Para obtener más información sobre la compatibilidad multilingüe, consulte las Preguntas frecuentes.

Actualizando tabi

Si agregó el tema como un submódulo de git, ejecute:

git submodule update --remote themes/tabi

Si lo clonaste:

 cd themes/tabi
git pull

Sitios que utilizan tabi

Sitio web	Creador	Descripción	Fuente del sitio
osc.jardin	Óscar Fernández (welpo)	Ciencia de datos, psicología y Zola	Fuente
sandip.live	Sandip G (hombre de arena)	Startups, tecnología y la buena vida	Fuente
seadve.github.io	Dave Patrick Caberto (SeaDve)	Blog personal y portafolio con CSS personalizado	Fuente
mikufan.página	Nadia	Blog personal	Fuente
tim-boettcher.online	Tim Bottcher	Ideas y divagaciones de un programador sordociego	Fuente
www.richtman.au	Ariel Richtman	Blog de tecnología personal	Fuente
Juegos Ponderosa	John Burak (JVimes)	Una amigable compañía de juegos independientes	—
jmbhughes.com	Marcus Hughes (jmbhughes)	Blog personal	Fuente
szabolcs.me	Szabolcs Fazekas (szabolcsf)	Blog personal	Fuente

¿Usando tabi? Siéntase libre de crear un PR y agregar su sitio a esta lista.

Inspiración

Este tema fue inspirado por:

• shadharon - tabi comenzó como una bifurcación del tema de syedzayyan
• viento de cola-nextjs-starter-blog
• abreviar

Apoyo

¿Algo no funciona? ¿Tienes una idea? ¡Háganos saber!

• ¿Preguntas? → Iniciar una discusión
• ¿Encontraste un error? → Denúncialo aquí
• ¿Solicitud de función? → ¡Cuéntanos más!

Contribuyendo

¡Por favor hazlo! Agradecemos los informes de errores, las mejoras en las traducciones o la documentación (aunque sean menores), las solicitudes de funciones...

Eche un vistazo a las Pautas de contribución para obtener más información.

Licencia

El código está disponible bajo la licencia MIT.