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/01/11 14:31]
slh@ens-lyon.fr
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 253: Ligne 258:
  
   * [[http://​www.famfamfam.com/​lab/​icons/​silk/​preview.php|filtrage d'​icone famfamfam par nom]]   * [[http://​www.famfamfam.com/​lab/​icons/​silk/​preview.php|filtrage d'​icone famfamfam par nom]]
 +
 +====== Sites web ======
 +
 +===== Générateurs de site statique =====
 +
 +  * Jekyll
 +    * [[https://​jekyllrb.com|site web]]
 +    * [[https://​github.com/​jekyll/​jekyll|logiciel]]
 +    * markdown
 +      * [[https://​kramdown.gettalong.org/​syntax.html|syntaxe]] (kramdown)
 +        * [[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]]
 +    * thèmes
 +      * [[https://​github.com/​planetjekyll/​awesome-jekyll-themes]]
 +      * [[https://​jekyllthemes.io/​free]]
 +      * [[https://​jekyll-themes.com/​free]]
 +      * [[http://​themes.jekyllrc.org]]
 +      * [[https://​drjekyllthemes.github.io]]
 +      * [[http://​xdesigns.net/​2016/​04/​jekyll-themes|The 40+ Best Free Jekyll Themes]]
 +    * 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.1547213484.txt.gz · Dernière modification: 2019/01/11 14:31 par slh@ens-lyon.fr