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
public:documentation [2019/08/01 17:40]
slh@ens-lyon.fr [Générateurs de site statique]
public:documentation [2019/10/17 13:13] (Version actuelle)
slh@ens-lyon.fr [Environnement Sourceforge]
Ligne 107: Ligne 107:
  
   * [[:​documentation:​documentation_linux|Linux]]   * [[:​documentation:​documentation_linux|Linux]]
 +
 +====== Environnement Huma-Num ======
 +
 +  * [[https://​sharedocs.huma-num.fr|Sharedocs]]
 +    * logiciel utilisé [[https://​docs.filerun.com|FileRun]]
  
 ====== Environnement Sourceforge ====== ====== Environnement Sourceforge ======
Ligne 261: Ligne 266:
     * [[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 278: Ligne 277:
       * [[http://​themes.jekyllrc.org]]       * [[http://​themes.jekyllrc.org]]
       * [[https://​drjekyllthemes.github.io]]       * [[https://​drjekyllthemes.github.io]]
 +      * [[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/​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.1564674002.txt.gz · Dernière modification: 2019/08/01 17:40 par slh@ens-lyon.fr