Skip to content
Snippets Groups Projects
Commit caaf6026 authored by mazenovi's avatar mazenovi
Browse files

wip

parent 76e4004f
No related branches found
No related tags found
No related merge requests found
Pipeline #
# Pages personelles / blog pour le LIMOS avec [Pelican](http://docs.getpelican.com/en/stable/)
Pelican est un outil permettant de générer des fichiers html static à partir de fichiers écrits en markdown
## Installer les dépendances ## Installer les dépendances
...@@ -14,11 +11,6 @@ sudo pip install --editable . ...@@ -14,11 +11,6 @@ sudo pip install --editable .
bash develop_server.sh start bash develop_server.sh start
``` ```
## Personnaliser ## see also
https://github.com/getpelican/pelican-themes/tree/master/pelican-bootstrap3
https://help.farbox.com/pygments.html
## Deployer
## @TODO * [https://limos.isima.fr/~mazenod/blog-et-pages-perso-au-limos.html](https://limos.isima.fr/~mazenod/blog-et-pages-perso-au-limos.html)
- https://github.com/getpelican/pelican-plugins/tree/master/assets
Title: Les documentations cri et utilisateur pour l'ISIMA Title: Les documentations cri et utilisateur pour l'ISIMA
Date: 2017-05-16 10:20 Date: 2017-05-16 10:20
Status: Published Status: Published
Tags: doc, mkdocs Tags: doc, python, mkdocs
[TOC] [TOC]
......
Title: gitlab Title: gitlab.isima.fr
Date: 2017-05-16 10:20 Date: 2017-05-16 10:20
Status: Published Status: Published
Tags: www, dev Tags: www, dev
## Qu'est ce que gitlab?
## Ce que n'est pas gitlab ...
Un substitut de Dropbox! Gitlab est optimisé pour versionner des fichiers textes, d'une taille raisonnable ...
Eviter donc les dossiers de milliers d'images, les vidéos de plusieurs giga
## Pourquoi une nouvelle forge plutôt que [La forge universitaire](https://forge.clermont-universite.fr/)
* simplification de l'administration (private/internal/publi) plutôt que de constituer une équipe nominativement
* les groupes en mode super utilisateurs
### Merge requests
### Intégration continue
...@@ -3,6 +3,7 @@ Date: 2017-05-15 16:20 ...@@ -3,6 +3,7 @@ Date: 2017-05-15 16:20
Status: Published Status: Published
Tags: ispconfig, admin, www Tags: ispconfig, admin, www
Installation du module apache cas Installation du module apache cas
```bash ```bash
...@@ -31,7 +32,7 @@ sudo dpkg -L libapache2-mod-auth-cas ...@@ -31,7 +32,7 @@ sudo dpkg -L libapache2-mod-auth-cas
... ...
``` ```
on découvre un ficgier qui ressemble à un fichier de conf par défaut on découvre un fichier qui ressemble à un fichier de conf par défaut, qu'il suffit de compléter avec les paramètres manquants CASLoginURL & CASValidateURL
```bash ```bash
CASCookiePath /var/cache/apache2/mod_auth_cas/ CASCookiePath /var/cache/apache2/mod_auth_cas/
...@@ -49,5 +50,14 @@ CASValidateURL https://login.isima.fr/cas/serviceValidate ...@@ -49,5 +50,14 @@ CASValidateURL https://login.isima.fr/cas/serviceValidate
Require valid-user Require valid-user
</Directory> </Directory>
``` ```
l'utilisateur authentifié sera accessible en php vi la variable globale ```$_SERVER```
```bash
echo $_SERVER[HTTP_CAS_USER]; // will display authenticated username
```
Il est possible d'aller plus loin dans les permission en filtrant avec une requête LDAP
@TODO voir requête LDAP + parmaètres réupérables pour credential * https://httpd.apache.org/docs/2.4/fr/mod/mod_authnz_ldap.html
* http://stackoverflow.com/questions/8939487/how-to-support-require-group-foobar-in-mod-auth-cas
* http://stackoverflow.com/questions/2239069/how-do-i-retrieve-the-user-information-of-a-user-authenticated-with-apaches-mod#2239822
Title: Blog et pages perso au LIMOS
Date: 2017-05-17 10:20
Status: Published
Tags: doc, python, pages perso, blog
[TOC]
## Comment obtenir un espace web personnel?
Tout compte unix ayant un homedir sur le serveur de fichier glouglou peut se créer son espace web personnel en créant un répertoire ```public_html``` à la racine de son répertoire.
Tout le contenu de /home/path/to/username/public_html sera accessible via
* https://limos.isima.fr/~username
* https://fc.isima.fr/~username
* https://www.isima.fr/~username
* https://isima.fr/~username
## Comment faire ma page personnelle?
### Avec Pelican
Pelican est un module python qui permet à partir d'un code source (une arborescence de fichiers textes au format [markdown](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)) de générer des fichiers html statiques présentés dans une charte graphique fonctionnelle et unifiée.
#### Prérequis
* [python](https://www.python.org/) >= 2.6 ([installation](http://www.mkdocs.org/#installing-python))
* [pip](https://pypi.python.org/pypi/pip) ([installation](https://pip.pypa.io/en/stable/installing/))
* [git](https://git-scm.com/) ([installation](https://git-scm.com/book/fr/v1/D%C3%A9marrage-rapide-Installation-de-Git))
* un éditeur de texte : [atom.io](https://atom.io/) est recommandé
* savoir ce qu'est [markdown](https://guides.github.com/features/mastering-markdown/)
* la commande [pelican](http://docs.getpelican.com/en/stable/) et toutes ses dépendances installables via pip
#### Installation de l'environnment
```shell
sudo pip install --editable .
```
> N.B. notes le '.' après --editable !!
#### Récupérer son blog
La plus simple est probablement de forker [<i class="fa fa-gitlab" aria-hidden="true"></i> ce blog](https://gitlab.isima.fr/mazenovi/mazenod)
```bash
git clone git@gitlab.isima.fr:mazenovi/mazenod.git
```
##### Thèmes
Le thème LIMOS a été réalisé à partir du thème [pelican-bootstrap3](https://github.com/getpelican/pelican-themes/tree/master/pelican-bootstrap3)
##### Plugins
Les plugins pré installés sont
* [i18n_subsites](https://github.com/getpelican/pelican-plugins/tree/master/i18n_subsites) permet le multilinguisme complet du site
* [extract_toc]() qui permet la génération dynamique d'[ancres html](https://www.alsacreations.com/astuce/lire/5-lien-precis-page-ancre-anchor-diese.html) sur tous les titres (h1, h2, ...) et la génération automatique d'une table des matières pour les posts longs
* [math_render](https://github.com/getpelican/pelican-plugins/tree/master/render_math) permet d'insérer des forumles mathématique directement dans le corps des postets ou page
* [tipue_search](https://github.com/getpelican/pelican-plugins/tree/master/tipue_search) permet d'intégrer un moteur de recherche
* [tag_cloud](https://github.com/getpelican/pelican-plugins/tree/master/tag_cloud) permet de faire apparaître les tags et le nombre d'articles associés dans le menu de gauche
* à faire : [assets](https://github.com/getpelican/pelican-plugins/tree/master/assets) pour minifier et concaténer les fichiers css et js
##### Librairies incluses
Ce blog intègre
* [fontawesome](http://fontawesome.io).
* [bootsrap3](http://getbootstrap.com/)
* [jquery v2.2.1](https://jquery.com/)
#### Personnalisation
Toute la personnalisation du blog se fait dans le fichier ```pelicanconf.py```.
Les principales options sont les suivantes
* [aperçus des thèmes pygment pour la coloration syntaxique](https://help.farbox.com/pygments.html)
#### Modifer ou ajouter du contenu à son espace personnel avec Pelican
##### Coloration syntaxique
##### Equations mathématiques
##### Table des matières
##### Multi linguisme
### Tout seul
Si la solution ci dessus vous êtes libre d'organiser votre espace web personnel comme bon vous semble: pour des raisons de sécurité privilégiez les sites statiques. Si vous avez réellement besoin de traitement côté serveur, php est installé. Vous pouvez également bénéficer d'une base de données en effectuant une demande à [cri@isima.fr](mailto:cri@isima.fr)
Title: git 101
Date: 2017-05-16 10:20
Status: Published
Tags: www, dev
## Qu'est ce que git?
d'après la [page git sur <i class="fa fa-wikipedia-w" aria-hidden="true"></i> wikipédia](https://fr.wikipedia.org/wiki/Git)
> git est un logiciel de gestion de versions décentralisé. C'est un logiciel libre créé par Linus Torvalds, auteur du noyau Linux, et distribué selon les
> termes de la licence publique générale GNU version 2. En 2016, il s’agit du logiciel de gestion de versions le plus populaire qui est utilisé par plus de
> douze millions de personnes4.
## Pourquoi devrais je utiliser git?
Vous développez? vous écrivez des articles?
Vous avez deux préoccupations
1. ne pas perdre votre travail: vous avez besoin un endroit où le sauvegarder
2. garder un trace de l'historique de vos modifications: vous avez besoin d'une copie de référence et d'un moyen de gérer cette copie
3. collaborer de manière efficace avec d'autres personnes sur votre travail: vous avez besoin d'une gestion partagée de l'hitorique des modifications
git s'emploie à résoudre tout cela.
### SVN fait ca très bien ...
C'est vrai! On a pour habitude de dire que git n'est pas pire ;)
La différence majeure est la centralisation du repository. avec SVN le serveur de version doit toujours être accessible pour par exemple pouvoir remonter dasn l'historique des modification. Git lui est décentralisé c'est à dire que vous travaillerez toujour sur repository complet qui vous permettra de travailler sans le serveur qui vous sert de référence. Vous pourrez mettre à jour le repository après coup.
#### Github / gitlab
un deuxième argument pour utiliser git plutôt que SVN est l'adhésion qu'il a sucité au travers de projets devenus majeurs dans le paysage du logiciel libre et opensource. Github a vu le jour en 2006
## Concept de base
https://try.github.io/levels/1/challenges/25 https://try.github.io/levels/1/challenges/25
http://gitreal.codeschool.com/?utm_source=github&utm_medium=codeschool_option&utm_campaign=trygit http://gitreal.codeschool.com/?utm_source=github&utm_medium=codeschool_option&utm_campaign=trygit
...@@ -5,3 +43,5 @@ http://gitreal.codeschool.com/?utm_source=github&utm_medium=codeschool_option&ut ...@@ -5,3 +43,5 @@ http://gitreal.codeschool.com/?utm_source=github&utm_medium=codeschool_option&ut
http://themouette.github.io/slides-git/?theme=clermontech#/ http://themouette.github.io/slides-git/?theme=clermontech#/
https://speakerdeck.com/willdurand/git-and-github-and-open-source-clermontech-workshop-git https://speakerdeck.com/willdurand/git-and-github-and-open-source-clermontech-workshop-git
### GUI
...@@ -3,4 +3,12 @@ Date: 2017-05-16 10:20 ...@@ -3,4 +3,12 @@ Date: 2017-05-16 10:20
Status: Published Status: Published
Tags: www, dev Tags: www, dev
https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet ## Qu'est ce que markdown?
* https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
## Pourquoi markdown?
outil de conversion
* https://word-to-markdown.herokuapp.com/
* http://pandoc.org/
pandoc_reader @ 9ef0197e
Subproject commit 9ef0197eed5d141bf0f3b9a8468cd37ad3e5fbd7
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment