rescenic.github.io

Thème Purelog pour Jekyll

Un modèle réactif et bien conçu pour vous aider à démarrer votre prochain blog ou site Web.
Explorer les documents »

Voir la démo · Signaler un bug · Demander une fonctionnalité

À propos du projet

Purelog est un thème de barre latérale réactif pour le populaire générateur JAMstack Jekyll qui utilise uniquement le framework minimal Pure.css (d'où son nom !), tout en suivant les meilleures pratiques possibles en matière d'accessibilité et d'optimisation des moteurs de recherche.

J'ai créé ceci après avoir terminé Watery (sur lequel ce thème est construit), afin d'ajouter plus de fonctionnalités et de design tout en restant aussi léger que possible.

Ce projet s'adresse à ceux qui recherchent un thème intéressant pour Jekyll qui possède des fonctionnalités que l'on ne trouve pas couramment ailleurs, notamment des sections distinctes dédiées aux blogs, à la prise de notes et aux entrées de journal quotidiennes.

Caractéristiques

Voici quelques fonctionnalités intéressantes de ce thème Jekyll :

• Un _BLANK_config.yml entièrement personnalisable et vide pour faciliter la mise en route.
• Une fonction de recherche rapide sur site utilisant Simply Jekyll Search.
• Collections personnalisées pour différents types de matériel (prise de notes, rédaction de journal, etc.)
• Une page d'archives générée automatiquement qui affiche toutes les entrées de toutes les collections.
• Génération automatique de pages de balises et de catégories.
• Avoir une collection _pages pour une organisation plus facile.
• Une biographie de l'auteur à la fin de chaque article. (Situé dans _inclues/author.html )
• Prise en charge complète de Rouge pour la coloration syntaxique. (Utilise actuellement base16.solarized.light )
• Flux RSS généré automatiquement, plan du site, fonctionnalités d'accessibilité et optimisation des moteurs de recherche.

Installation

Conditions préalables

Jekyll nécessite les éléments suivants :

• Ruby version 2.5.0 ou supérieure
• RubyGemmes
• GCC et Faire

Voir Exigences pour les guides et les détails.

Instructions

1. Installez tous les prérequis.
2. Installez les gemmes jekyll et bundler.

 gem install jekyll bundler

3. Clonez ce référentiel.

 git clone https://github.com/rescenic/rescenic.github.io.git

4. Accédez à votre nouveau répertoire.

 cd rescenic.github.io

5. Installez les gemmes à partir du Gemfile .

 bundle install

6. Créez le site et rendez-le disponible sur un serveur local.

 bundle exec jekyll serve --livereload

7. Accédez à http://localhost:4000

Si vous rencontrez des erreurs au cours de ce processus, vérifiez que vous avez installé tous les prérequis dans Exigences.

Si vous rencontrez toujours des problèmes, consultez Dépannage.

Commencer

Une fois que Jekyll est opérationnel, quelques étapes seulement sont nécessaires pour vous approprier ce thème :

1. Remplissez le fichier de configuration _BLANK_config.yml et remplacez le _config.yml actuel
2. Supprimez le dossier example_posts dans _posts , _notes , _journals et commencez à écrire le vôtre !
3. Modifiez ou supprimez les pages de _pages comme bon vous semble.
4. (Facultatif) Modifiez ou supprimez ce README.md avec des informations sur votre propre projet ou blog.
5. (Facultatif) Modifiez les fichiers CSS dans le dossier assets pour personnaliser le site.

Feuille de route

Il y a plusieurs fonctionnalités que je prévois encore de créer et d'intégrer, notamment :

• Créer une gemme thématique
• Ajoutez des boutons simples et automatiques pour "Déployer sur Netlify", Heroku, etc.
• Ajouter des contrôles d'intégration continus de Travis
• Ajouter une documentation supplémentaire pour créer des collections personnalisées et des pages générées automatiquement
• Ajouter plus d'exemples de publications et d'articles

Consultez les problèmes ouverts pour une liste des fonctionnalités proposées (et des problèmes connus).

Contribuer

Les contributions sont ce qui fait de la communauté open source un endroit si formidable pour apprendre, inspirer et créer. Toutes les contributions que vous apportez sont grandement appréciées .

1. Forkez le projet
2. Créez votre branche de fonctionnalités ( git checkout -b feature/AmazingFeature )
3. Validez vos modifications ( git commit -m 'Add some AmazingFeature' )
4. Pousser vers la branche ( git push origin feature/AmazingFeature )
5. Ouvrir une demande de tirage

Licence

Distribué sous licence MIT. Vous pouvez utiliser ce projet comme bon vous semble sans avoir besoin de donner l'attribution.

Voir LICENSE pour plus d’informations.

Ressources

Lors de la création de ce thème, je suis tombé sur de nombreuses ressources utiles et difficiles à trouver. Si vous souhaitez approfondir Jekyll, consultez-les :

• Sauter dans Jekyll : https://dev.to/brennan/jumping-into-jekyll-4o9h
• Aide-mémoire Jekyll : https://devhints.io/jekyll
• Cours sur Jekyll : https://learn-the-web.algonquindesign.ca/topics/jekyll/
• Jekyll pour les designers : http://simpleprimate.com/jekyll-for-designers/index.html
• Copyright dynamique sur Jekyll : https://michaelsoolee.com/jekyll-copyright/
• Création du fil d'Ariane dans Jekyll : https://jekyllcodex.org/without-plugin/breadcrumbs/
• Afficher tous les éléments de TOUTES les collections : https://stackoverflow.com/questions/31171041/listing-all-collections-in-jekyll

Autres ressources

• Pour les aperçus de démarques : https://jaspervdj.be/lorem-markdownum/
• Étude de cas sur les performances des polices Web : https://www.keycdn.com/blog/web-font-performance
• Un .gitignore étendu : https://miguelmota.com/bytes/extensive-gitignore/

Crédit

Pure.css a été créé par le groupe Pure CSS.

Simple Jekyll Search a été créé par Christian Fei.

Diverses notes et idées ont été tirées de Simply Jekyll de Raghuveer S..