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/23 18:23]
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 
-      * [[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: 
-        * email: 
-        * description:​ 
-        * baseurl: 
-        * url: 
     * markdown     * markdown
       * [[https://​kramdown.gettalong.org/​syntax.html|syntaxe]] (kramdown)       * [[https://​kramdown.gettalong.org/​syntax.html|syntaxe]] (kramdown)
         * [[https://​kramdown.gettalong.org/​quickref.html|Quick Reference]]         * [[https://​kramdown.gettalong.org/​quickref.html|Quick Reference]]
 +      * [[https://​github.com/​adam-p/​markdown-here/​wiki/​Markdown-Cheatsheet|Markdown Cheatsheet]]
       * [[https://​about.gitlab.com/​handbook/​product/​technical-writing/​markdown-guide|Markdown Style Guide for about.GitLab.com]]       * [[https://​about.gitlab.com/​handbook/​product/​technical-writing/​markdown-guide|Markdown Style Guide for about.GitLab.com]]
     * thèmes     * thèmes
Ligne 283: Ligne 279:
       * [[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://​github.com/​Shopify/​liquid/​wiki/​Liquid-for-Designers]]+      ​* [[https://​shopify.github.io/​liquid/​filters|filtres]] 
 +      ​* [[https://​github.com/​Shopify/​liquid/​wiki/​Liquid-for-Designers|Liquid-for-Designers]]
   * Beautiful Jekyll   * Beautiful Jekyll
     * [[https://​deanattali.com/​beautiful-jekyll|site web]]     * [[https://​deanattali.com/​beautiful-jekyll|site web]]
Ligne 291: Ligne 288:
   * Gitlab   * Gitlab
     * [[https://​docs.gitlab.com/​ee/​user/​project/​pages|Pages]]     * [[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.1566577437.txt.gz · Dernière modification: 2019/08/23 18:23 par slh@ens-lyon.fr