Jekyll

Cette page a démarré sur Jekyll

Cet article est une ébauche. Vous pouvez aider le wiki IndieWebCamp à l'améliorer et le compléter.

Jekyll est un logiciel Ruby qui vous aide à créer des sites "Simples, statiques et adaptés au blog" ("Simple, blog-aware, static sites"). Il est simple dans le sens où il fait une chose bien. Il compile les fichiers HTML et markdown à l'intérieur d'un site web statique.

La courbe d'apprentissage est raide ceux qui ne sont pas habitués au HTML. Néanmoins, il y a un modèle de personnes à migrer de WordPress vers Jekyll et beaucoup de personnes sur l'IRC ont l'expérience de le mettre en oeuvre.

Il est devenu populaire par l'offre GitHub de pouvoir construire et héberger gratuitement votre site web motorisé par jekyll. Bien que GitHub puisse être une forme de silo pouvant héberger facilement un site web, Jekyll n'a aucune dépendance à GitHub. Les projets comme jekyll-hook peuvent aider à répliquer le workflow de publication que GitHub offre sur votre propre serveur.

Voir aussi : projects-fr#Jekyll

Pours

• Il est git friendly !
• C'est un moyen génial de se perfectionner sur les sites web HTML, CSS et autres technologies et standards web.
• Open source et gratuit !
• Grande communauté et équipe de développement active
• Vous permet de créer presque tous les types de sites web statiques que vous voulez.
• Dispose d'un système de plugin puissant
• Facile à auto-héberger
• Les pages statiques simples sont le résultat de votre dur labeur.
• Hébergement gratuit sur gh-pages ou amazon S3

Contres

• Le moteur de gabarit liquid n'a pas un grand amour pour le HTML CHIC
• Cela prend un moment d'apprendre les pour et contre de ce qui peut être créé.
• Les pages statiques restreignent vos options pour participer au web en temps-réel
• POSSEr est délicat avec Jekyll.
• Apprendre à utiliser la chaîne Ruby est vraiment difficile pour les débutants et personnes non techniques
• Options minimales pour envoyer des webmentions. Les Webmentions doivent être envoyées après la construction du site du fait du besoin de faire exister l'URL

Outils en rapport

• Pagoda - un éditeur hébergé, mobile pour les pages jekyll
• jekyll hook - Un serveur équivalent au gh-pages pour l'auto-hébergement
• Prose.io - Un éditeur pour les repositories github. Lui-même auto-hébergé sur les pages GH et tourne presque entièrement côté client dans le navigateur. en savoir plus
• gitpub un client micropub expérimental basé sur git qui tourne avec Jekyll
• jekmentions - un endpoint webmention spécifiquement conçu pour les sites Jekyll sur les pages GitHub qui commette les webmentions reçues vers une Jekyll collection.
• Un fix rapide et sale pour les lignes blanches dans Jekyll - Un script tacky (voir le bas du post du blog) qui retire les lignes blanches superflues (à moins qu'elles ne soient entre des blocs de pre ou code) à partir d'un site construit.
• Jekyll-IndieWeb Un installateur Jekyll pour démarrer avec un marquage microformat, incluant le support de h-card et la réception de webventions. Chantier en cours…
• ... Ajoutez en au fur et à mesure que vous en trouvez.

Exemples IndieWeb

Les membres de la communauté IndieWeb qui utilisent Jekyll sur leurs sites primaires

• Calum Ryan (2015) sur [1]
• Ben Ward (2011) sur benward.me
• Bret Comnes (2013) sur bret.io
• Pelle Wessman (2014) sur voxpelli.com using GitHub Pages. Supports eg. Webmention and Micropub.
• Will Norris (2011, 2014) on willnorris.com (switched away from WordPress).
• Rudy Jahchan : sur rudyjahchan.com (moved from WordPress)
• Leonardo Zangrando (2013): on lionzan.me
• Alan Leal (2014) : sur Leal.IO en utilisant GitHub Pages
• atomicules sur atomicules.co.uk
• Tristan Thomas sur tristanthomas.me (using Sandstorm.io)
• River MacLeod sur mm0hai.net
• Michael Bishop on miklb.com
• ...Beaucoup d'autres. Ajoutez-vous !

Autres exemples notables

• Github utilise jekyll pour son propre blog et plus récemment ses documents de support.
• TravisCI l'utilise pour son stie web de documentation (source).
• ...

Problèmes

Quelque chose ne fonctionne pas sur ma boîte locale

Something is not working on my local box.

Assurez-vous :

• Update rvm (ruby)
• d'installer la gem liquid
• gem install jekyll

gem install jekyll hangs indefinitely

"gem install jekyll" hangs indefinitely

Note :

• gem install jekyll peut durer très longtemps. Il peut sembler s'interrompre mais laissez-le tourner. Allez marcher ou faire une sieste

Demandes

• Ce serait élégant de documenter étape par étape un exemple des solutions et problèmes rencontrés avec POSSE dans une installation typique.

Voir aussi

• stockage fichier
• projets
• GitHub
• WordPress