Documentation on Blowfish

Bienvenue sur Blowfish

Mon, 01 Jan 0001 00:00:00 +0000

Blowfish regorge de fonctionnalités.

L’objectif initial de Blowfish était de développer un thème simple et léger. Le thème est un fork de Congo et étend sa vision initiale.

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Suivez simplement la procédure standard Hugo Démarrage Rapide pour être opérationnel rapidement.

Des instructions d’installation détaillées sont disponibles ci-dessous. Des instructions pour mettre à jour le thème sont également disponibles.

Installation
#

Ces instructions vous permettront de démarrer avec Hugo et Blowfish à partir d’un état complètement vierge. La plupart des dépendances mentionnées dans ce guide peuvent être installées à l’aide du gestionnaire de paquets de votre choix pour votre plateforme.

Premiers Pas

Mon, 01 Jan 0001 00:00:00 +0000

Cette section suppose que vous avez déjà installé le thème Blowfish.

Nous venons de lancer un outil CLI pour vous aider à démarrer avec Blowfish. Il vous aidera avec l’installation et la configuration. Installez l’outil CLI globalement en utilisant :

Configuration

Mon, 01 Jan 0001 00:00:00 +0000

Blowfish est un thème hautement personnalisable et utilise certaines des dernières fonctionnalités de Hugo pour simplifier sa configuration.

Le thème est livré avec une configuration par défaut qui vous permet de démarrer avec un blog ou un site web statique de base.

Mise en page de la page d'accueil

Mon, 01 Jan 0001 00:00:00 +0000

Blowfish offre une mise en page de page d’accueil entièrement flexible. Il y a deux modèles principaux à choisir avec des paramètres supplémentaires pour ajuster le design. Alternativement, vous pouvez également fournir votre propre modèle et avoir un contrôle total sur le contenu de la page d’accueil.

Shortcodes

Mon, 01 Jan 0001 00:00:00 +0000

En plus de tous les shortcodes Hugo par défaut, Blowfish en ajoute quelques-uns supplémentaires pour des fonctionnalités avancées.

Alert
#

alert affiche son contenu sous forme de boîte de message stylisée dans votre article. C’est utile pour attirer l’attention sur des informations importantes que vous ne voulez pas que le lecteur manque.

Front Matter

Mon, 01 Jan 0001 00:00:00 +0000

En plus des paramètres front matter Hugo par défaut, Blowfish ajoute un certain nombre d’options supplémentaires pour personnaliser la présentation des articles individuels. Tous les paramètres front matter du thème disponibles sont listés ci-dessous.

Auteurs multiples

Mon, 01 Jan 0001 00:00:00 +0000

Certains sites web ont plus d’un auteur contribuant au contenu et nécessitent donc plus qu’un seul auteur par défaut pour l’ensemble du site. Pour ces cas d’utilisation, Blowfish permet aux utilisateurs d’étendre la liste des auteurs en utilisant la fonctionnalité d’auteurs multiples.

Partials

Mon, 01 Jan 0001 00:00:00 +0000

Analytics
#

Blowfish offre une prise en charge intégrée de Fathom Analytics, Google Analytics et Umami Analytics. Fathom est une alternative payante à Google Analytics qui respecte la vie privée des utilisateurs.

Vignettes

Mon, 01 Jan 0001 00:00:00 +0000

Vignettes
#

Blowfish a été amélioré pour faciliter l’ajout de support visuel à vos publications. Pour ce faire, il vous suffit de placer un fichier image (presque tous les formats sont supportés mais nous recommandons .png ou .jpg) commençant par feature* dans le répertoire principal de votre article, comme illustré dans l’exemple ci-dessous.

Exemples de contenu

Mon, 01 Jan 0001 00:00:00 +0000

Si vous avez lu la documentation dans l’ordre, vous devriez maintenant connaître toutes les fonctionnalités et configurations disponibles dans Blowfish. Cette page est conçue pour tout rassembler et offrir quelques exemples pratiques que vous pourriez vouloir utiliser dans votre projet Hugo.

Séries

Mon, 01 Jan 0001 00:00:00 +0000

Blowfish propose une fonctionnalité permettant de regrouper un ensemble d’articles sous une “série”. Placer un article dans une série affichera les autres articles de la série sur chaque page individuelle et permettra une navigation rapide entre eux. Vous pouvez voir un exemple ci-dessus.

Personnalisation avancée

Mon, 01 Jan 0001 00:00:00 +0000

Il existe de nombreuses façons d’apporter des modifications avancées à Blowfish. Lisez ci-dessous pour en savoir plus sur ce qui peut être personnalisé et la meilleure façon d’atteindre le résultat souhaité.

Hébergement & Déploiement

Mon, 01 Jan 0001 00:00:00 +0000

Il existe de nombreuses façons de déployer votre site web Hugo construit avec Blowfish. Le thème est conçu pour être flexible dans presque tous les scénarios de déploiement.

Blowfish utilise des URLs relatives tout au long du thème. Cela permet aux sites d’être facilement déployés dans des sous-dossiers et sur des hôtes comme GitHub Pages. Il n’y a généralement pas de configuration spéciale requise tant que le paramètre baseURL a été configuré dans le fichier hugo.toml.

Firebase : Vues & Likes

Mon, 01 Jan 0001 00:00:00 +0000

Afin de pouvoir prendre en charge les données dynamiques sur votre site web, nous avons ajouté le support pour intégrer Firebase. Cela vous permettra d’utiliser la fonctionnalité de vues sur les listes et les articles.

Documentation on Blowfish

Bienvenue sur Blowfish

Installation

Installation #

Premiers Pas

Configuration

Mise en page de la page d'accueil

Shortcodes

Alert #

Front Matter

Auteurs multiples

Partials

Analytics #

Vignettes

Vignettes #

Exemples de contenu

Séries

Personnalisation avancée

Hébergement & Déploiement

Firebase : Vues & Likes

Installation
#

Alert
#

Analytics
#

Vignettes
#