Outils pour utilisateurs

Outils du site


public:documentation

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
Dernière révision Les deux révisions suivantes
public:documentation [2019/08/05 15:30]
slh@ens-lyon.fr [Générateurs de site statique]
public:documentation [2019/08/28 16:22]
slh@ens-lyon.fr [Générateurs de site statique]
Ligne 261: Ligne 261:
     * [[https://​jekyllrb.com|site web]]     * [[https://​jekyllrb.com|site web]]
     * [[https://​github.com/​jekyll/​jekyll|logiciel]]     * [[https://​github.com/​jekyll/​jekyll|logiciel]]
-    * créer un site Jekyll +    * markdown 
-      * [[https://gitlab.in2p3.fr/projects/​new#​create-from-template-pane|créer un projet sur Gitlab]] +      * [[https://kramdown.gettalong.org/syntax.html|syntaxe]] (kramdown) 
-      puis [Create from template+        * [[https://​kramdown.gettalong.org/​quickref.html|Quick Reference]
-      * puis '​Pages/​Jekyll' ​[Use template+      * [[https://​github.com/​adam-p/​markdown-here/​wiki/​Markdown-Cheatsheet|Markdown Cheatsheet]
-      ​* puis régler '​_config.yml'​ avec : +      * [[https://about.gitlab.com/handbook/​product/​technical-writing/​markdown-guide|Markdown Style Guide for about.GitLab.com]]
-        * title: +
-        * email: +
-        * description:​ +
-        * baseurl: +
-        * url: +
-    ​* [[https://kramdown.gettalong.org/syntax.html|syntaxe]] (Kramdown)+
     * thèmes     * thèmes
       * [[https://​github.com/​planetjekyll/​awesome-jekyll-themes]]       * [[https://​github.com/​planetjekyll/​awesome-jekyll-themes]]
Ligne 280: Ligne 274:
       * [[http://​xdesigns.net/​2016/​04/​jekyll-themes|The 40+ Best Free Jekyll Themes]]       * [[http://​xdesigns.net/​2016/​04/​jekyll-themes|The 40+ Best Free Jekyll Themes]]
     * plugins     * plugins
-      * [[https://​github.com/​planetjekyll/​awesome-jekyll-plugins]]+      * [[https://​github.com/​planetjekyll/​awesome-jekyll-plugins|awesome-jekyll-plugins]]
     * [[https://​shopify.github.io/​liquid|Liquid]]     * [[https://​shopify.github.io/​liquid|Liquid]]
 +      * [[https://​shopify.github.io/​liquid/​filters|filtres]]
 +      * [[https://​github.com/​Shopify/​liquid/​wiki/​Liquid-for-Designers|Liquid-for-Designers]]
 +  * Beautiful Jekyll
 +    * [[https://​deanattali.com/​beautiful-jekyll|site web]]
 +    * [[https://​github.com/​daattali/​beautiful-jekyll#​readme|projet github]]
 +  * Gitlab
 +    * [[https://​docs.gitlab.com/​ee/​user/​project/​pages|Pages]]
 +
 +==== Procédures Jekyll ====
 +
 +== Installer jekyll en local ==
 +
 +<​code>​
 +sudo apt-get install ruby2.3-dev
 +sudo apt-get install ruby-bundler
 +sudo gem install jekyll
 +# plugins utiles
 +sudo gem install jekyll-paginate
 +sudo gem install jekyll-sitemap
 +sudo gem install jekyll-target-blank
 +sudo gem install jekyll-last-modified-at
 +sudo gem install jekyll-analytics
 +# pour chaque plugin, ajouter une ligne de la forme " ​ - jekyll-paginate"​ au champ "​plugins:"​ du fichier "​_config.yml"​
 +</​code>​
 +
 +== Mise à jour de jekyll pour installer des nouveaux gems ==
 +
 +<​code>​
 +sudo bundle install
 +</​code>​
 +
 +=== A. récupérer un site jekyll distant sous git ===
 +
 +<​code>​
 +git clone https://​gitlab.in2p3.fr/​sheiden/​textometrie.org
 +</​code>​
 +
 +== Affichage local ==
 +
 +<​code>​
 +bundle exec jekyll serve
 +</​code>​
 +
 +== Mettre à jour un projet jekyll local depuis le projet git distant ===
 +
 +<​code>​
 +git pull origin master
 +</​code>​
 +
 +== Mettre à jour un projet jekyll distant après édition du site local ===
 +
 +<​code>​
 +git checkout master
 +git add .
 +git commit -m "​updated some pages"
 +git push origin HEAD:master
 +# contrôles avant push
 +git status -s
 +</​code>​
 +
 +=== B. créer un site jekyll distant avec les Pages de Gitlab ===
 +
 +  * [[https://​gitlab.in2p3.fr/​projects/​new#​create-from-template-pane|créer un projet sur Gitlab]]
 +  * puis [Create from template]
 +  * puis '​Pages/​Jekyll'​ [Use template]
 +  * puis régler '​_config.yml'​ avec :
 +    * title: %%"​Textométrie // TXM"%%
 +    * email: %%"​textometrie @ groupes.renater.fr"​%%
 +    * baseurl: %%"/​textometrie.org"​%%
 +    * url: %%"​https://​sheiden.pages.in2p3.fr"​%%
 +    * plugins: %%[éventuels]%%
 +  * le pipeline automatique de génération du site s'​active (ou on l'​active à la main - seul pipeline défini dans le projet)
 +  * le site est disponible à une adresse gitlab
 +
 +=== C. créer un site jekyll local sous git ===
 +
 +== Créer un site jekyll local comme projet git ===
 +
 +<​code>​
 +# réglage git
 +git config --global user.email serge.heiden@ens-lyon.fr
 +git config --global credential.helper cache
 +git config --global credential.helper 'cache --timeout=3600'​
 +# crée projet
 +cd ~/git
 +git init textometrie.org
 +cd textometrie.org
 +git checkout --orphan website
 +# crée site
 +jekyll new .
 +git add .
 +touch README
 +git add README
 +# push git
 +git remote add origin git@gitlab.in2p3.fr:​sheiden/​textometrie.org.git
 +git commit -m "​install textometrie.org website"​
 +git push origin HEAD:​website
 +# contrôles avant commit
 +git remote -v
 +git remote show origin
 +</​code>​
 +
 +== Augmenter un site jekyll en beautiful-jekyll ===
 +
 +<​code>​
 +cd ~/​git/​textometrie.org
 +cp -r ~/​Téléchargements/​beautiful-jekyll-master/​* .
 +</​code>​
 +
public/documentation.txt · Dernière modification: 2019/10/17 13:13 par slh@ens-lyon.fr