tabi Télécharger - tabi Téléchargement du code source

tabi

Autres catégories

v3.1.0

Télécharger

? tabi

Un thème Zola accessible avec recherche, prise en charge multilingue, JavaScript en option, un score Lighthouse parfait et une documentation complète. Conçu pour les sites Web et les blogs personnels.

Conseil

Vous voulez commencer à bloguer tout de suite ? Utilisez le modèle tabi-start pour rendre un site complet opérationnel en quelques minutes.

Voir un aperçu en direct (et la documentation du thème) ici.

Explorez la section Sites utilisant tabi pour voir des applications du monde réel.

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

tabi

tabi a un score parfait à l'audit Lighthouse de Google :

Caractéristiques

Installation

Note

Le moyen le plus rapide de créer un nouveau site consiste à utiliser le modèle tabi-start. Cela vous donne une configuration complète de blog avec toute la configuration essentielle prête à l'emploi.

Installation manuelle

Pour ajouter du tabi à votre site Zola existant :

Initialisez un dépôt Git dans le répertoire de votre projet (si ce n'est pas déjà fait) :

 git init

Ajoutez le thème en tant que sous-module git :

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

Ou clonez le thème dans votre répertoire de thèmes :

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

Configuration requise

Activez le thème dans votre config.toml :

 theme = "tabi"

Définissez un title dans votre config.toml :

 title = "Your Site Title"

Configurez la mise en évidence des blocs de code dans votre config.toml :

[ markdown ]
highlight_code = true
highlight_theme = " css "

Créez un fichier content/_index.md . Ce fichier contrôle l'apparence et le comportement de votre page d'accueil. Choisissez l'une des options suivantes :
Option A : diffuser les publications de / :
```
 +++
title = "Home"
paginate_by = 5  # Show 5 posts per page.
+++
```
- Cela affichera les articles en content/ avec pagination.
Option B : diffuser les articles à partir d'un chemin différent (par exemple, 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.
+++
```
- Cela affichera les 5 derniers articles du blog/ de la section.
- Ne définissez pas paginate_by si vous choisissez cette option.
- Utilisez le chemin complet du fichier _index.md de la section. L'utilisation de section_path = "blog/" ne fonctionnera pas.

Avertissement

Ne définissez pas à la fois paginate_by et section_path dans content/_index.md .

Ces paramètres s’excluent mutuellement et l’utilisation des deux peut entraîner l’affichage d’aucune publication.

Si vous souhaitez une section d'introduction (voir capture d'écran ci-dessus), ajoutez ces lignes à content/_index.md :

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

Le contenu en dehors du texte préliminaire sera rendu entre le titre de l'en-tête et la liste des articles. Dans la capture d'écran ci-dessus, c'est le texte qui dit "tabi est un thème Zola rapide, léger et moderne…".

Si vous souhaitez un site multilingue, vous devrez configurer chaque langue. Dans config.toml , définissez le titre et les taxonomies pour chaque langue, comme :

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

Vous aurez besoin d'un _index.{language_code}.md par langue pour chaque section (par exemple /blog ou /projects) que vous souhaitez activer dans cette langue.

La même chose est vraie pour les publications individuelles, qui doivent avoir exactement le même nom que la langue par défaut, avec un .{code} supplémentaire avant l'extension (par exemple, la version espagnole de security.md serait security.es.md ).

Cette configuration permet au sélecteur de langue d'amener l'utilisateur à la traduction de l'URL actuelle. Si aucune traduction n'existe, la page 404 sera affichée, avec une explication dans chaque langue définie dans la configuration.

Pour en savoir plus sur la prise en charge multilingue, consultez la Foire aux questions.

Mise à jour du tabi

Si vous avez ajouté le thème en tant que sous-module git, exécutez :

git submodule update --remote themes/tabi

Si vous l'avez cloné :

 cd themes/tabi
git pull

Sites utilisant tabi

Site web	Créateur	Description	Source du site
osc.jardin	Oscar Fernández (welpo)	Science des données, psychologie et Zola	Source
sandip.live	Sandip G (homme de sable)	Startups, technologie et douceur de vivre	Source
seadve.github.io	Dave Patrick Caberto (SeaDve)	Blog personnel et portfolio avec CSS personnalisé	Source
mikufan.page	Nadia	Blog personnel	Source
tim-boettcher.online	Tim Bottcher	Perspectives et divagations d'un programmeur sourd-aveugle	Source
www.richtman.au	Ariel Richtman	Blog technique personnel	Source
Jeux Ponderosa	John Burak (JVimes)	Une société de jeux indépendante et conviviale	—
jmbhughes.com	Marcus Hughes (jmbhughes)	Blog personnel	Source
szabolcs.me	Szabolcs Fazekas (szabolcsf)	Blog personnel	Source

Vous utilisez du tabi ? N'hésitez pas à créer un PR et à ajouter votre site à cette liste.

Inspiration

Ce thème a été inspiré par :

shadharon — tabi a commencé comme un fork du thème de Syedzayyan
tailwind-nextjs-starter-blog
abréger

Soutien

Quelque chose ne fonctionne pas ? Vous avez une idée ? Faites-le-nous savoir !

Des questions ? → Démarrer une discussion
Vous avez trouvé un bug ? → Signalez-le ici
Demande de fonctionnalité ? → Dis-nous en plus !

Contribuer

S'il vous plaît, faites-le ! Nous apprécions les rapports de bugs, les améliorations des traductions ou de la documentation (même mineures), les demandes de fonctionnalités…

Jetez un œil aux directives de contribution pour en savoir plus.