jasper2

Jaspe2

Il s'agit d'un portage complet du thème par défaut de Ghost, Casper v2.1.9, pour les pages Jekyll/GitHub.

Démo en direct

Casper du fantôme // Jasper2

Caractéristiques

• Prise en charge prête à l'emploi de plusieurs auteurs (via _data/authors.yml )

• Informations complètes sur l'auteur, notamment : photo, biographie, site Web, Twitter, Facebook, etc.

• Description(s) des balises et couvertures personnalisées (via _data/tags.yml )

• Affichage des articles connexes au bas de chaque article

• Toutes les pages par défaut de Ghost : page(s) d'auteur, page(s) de balise, page(s) à propos, 404, etc.

• Pagination (défilement infini ou pagination standard, c'est-à-dire des publications sur plusieurs pages)

• Flux Atom par Jekyll-feed

• Bouton d'abonnement basculable (nécessite un service externe)

• Mise en évidence de la syntaxe du code avec highlight.js

• Prise en charge du suivi Google Analytics

• Prise en charge des commentaires Disqus (pas le standard Ghost)

Commencer

Déploiement

Il existe plusieurs alternatives à la création et au déploiement du site :

1. construisez le site avec GitHub Actions qui pousse les fichiers résultants (le contenu de _site/ ou ../jasper2-pages/ ) vers la branche gh-pages . C'est l'approche qui est actuellement utilisée. Voir jekyll_build.yml pour plus de détails.

2. générer le site localement (plus de détails ci-dessous) et transférer le code HTML résultant vers un référentiel Github, que les pages GitHub hébergent ensuite ;

3. construisez le site avec travis-ci (avec des goodies de jekyll-travis) en poussant automatiquement les fichiers HTML générés vers une branche gh-pages .

4. déployez le site Web statique avec des hébergeurs compatibles Jekyll, tels que https://www.netlify.com/, qui permettent le déploiement à partir du dépôt Github et publiez le site Web à l'aide de CDN. Netlify propose une offre de démarrage gratuite.

Pour l'option 2), clonez simplement ce référentiel ( master branch ), puis exécutez bundle exec jekyll serve dans le répertoire. Téléchargez le contenu _site/ (ou ../jasper2-pages/ ) résultant dans votre référentiel ( branche master si vous téléchargez en tant que page personnelle (par exemple nom d'utilisateur.github.io) ou branche gh-pages si vous téléchargez en tant que page de projet (comme pour la démo).

Pour l'option 3), vous devrez configurer travis-ci pour votre fork personnel. En bref, tout ce dont vous avez besoin est alors de modifier vos informations dans _config.yml afin de pouvoir accéder à votre dépôt github. Vous devrez également générer une clé sécurisée à ajouter à votre .travis.yml (vous pouvez trouver plus d'informations sur la façon de le faire dans ce fichier). Assurez-vous également de lire la documentation de jekyll-travis. Cette approche présente des avantages évidents dans la mesure où vous transférez simplement vos modifications de fichiers vers GitHub et que tous les fichiers HTML sont générés pour vous et transférés vers gh-pages . Vous saurez également si tout va toujours bien avec la création de votre site. N'hésitez pas à me contacter si vous rencontrez toujours des problèmes (voir ci-dessous pour le suivi des problèmes).

Pages d'auteur

Afin de générer correctement les pages d'auteur, vous devez renommer le champ auteur dans le début de chaque article pour qu'il corresponde à celui du nom d'utilisateur de chaque auteur tel que défini dans le fichier _data/authors.yml . Avec la dernière mise à jour, les blogs à auteurs multiples sont désormais pris en charge dès le départ.

Compilation de styles

Suivez la façon dont les styles Casper sont compilés comme décrit ici :

Les styles Jasper2 sont compilés à l'aide de Gulp/PostCSS pour polyfill les futures spécifications CSS. Vous aurez besoin de Node et Gulp installés globalement. Après cela, depuis le répertoire racine du thème :

 $ npm installer
$ gorgée

Vous pouvez maintenant éditer les fichiers /assets/css/ , qui seront automatiquement compilés en /assets/built/ .

Problèmes et contribution

Cette installation s'appuie bien avec Ruby v2.6.3 et Jekyll v3.9.0. Si vous rencontrez des problèmes, veuillez les enregistrer sur le suivi des problèmes.

N'hésitez pas à demander vos correctifs et correctifs.

Merci

Un grand merci à l'équipe Ghost pour tout le travail de conception. Un grand merci également à tous les contributeurs, qui aident à maintenir le projet en vie et à jour ?

Droit d'auteur et licence

Même licence que celle fournie par l'équipe de Ghost. Voir la licence du thème de Casper.

Copyright (C) 2015-2021 - Publié sous la licence MIT.

L'autorisation est accordée par la présente, gratuitement, à toute personne obtenant une copie de ce logiciel et des fichiers de documentation associés (le « Logiciel »), d'utiliser le Logiciel sans restriction, y compris, sans limitation, les droits d'utilisation, de copie, de modification, de fusion. , publier, distribuer, accorder des sous-licences et/ou vendre des copies du Logiciel, et permettre aux personnes à qui le Logiciel est fourni de le faire, sous réserve des conditions suivantes :

L'avis de droit d'auteur ci-dessus et cet avis d'autorisation doivent être inclus dans toutes les copies ou parties substantielles du logiciel.

LE LOGICIEL EST FOURNI « EN L'ÉTAT », SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU IMPLICITE, Y COMPRIS MAIS SANS LIMITATION LES GARANTIES DE QUALITÉ MARCHANDE, D'ADAPTATION À UN USAGE PARTICULIER ET DE NON-VIOLATION. EN AUCUN CAS LES AUTEURS OU LES TITULAIRES DES DROITS D'AUTEUR NE SERONT RESPONSABLES DE TOUTE RÉCLAMATION, DOMMAGES OU AUTRE RESPONSABILITÉ, QUE CE SOIT DANS UNE ACTION CONTRACTUELLE, DÉLIT OU AUTRE, DÉCOULANT DE, DE OU EN RELATION AVEC LE LOGICIEL OU L'UTILISATION OU D'AUTRES TRANSACTIONS DANS LE LOGICIEL.