Club Drupal

{{toc}}

h1. Wiki d'utilisation du projet multi-assos

Voir le lien [[Utilisation_de_Drupal_multi-site]]

h1. Wiki

Pour créer une nouvelle page, il suffit de se rendre à l’adresse de la page que l’on veut créer.

Pour créer une sous-page (ce qui permet d’avoir une relation parent/enfant entre les pages et de voir la relation dans _Index par titre_), créez les deux pages séparément. Ensuite, allez sur la page fille et cliquez sur renommer. Sélectionnez le nom de la page parent et sauvegardez.

Pour ajouter une table des matières, entrez <pre>{{toc}}</pre>

Vous pouvez aussi recevoir des notifications par mails en cliquant sur _watch_ ou _surveiller_.

Pour ajouter des notes, utilisez les balises suivantes :

<pre>

    {{note(text)}}

    {{tip(text)}}

    {{important(text)}}

    {{warning(text)}}

</pre>

h1. Dépôt git

Adresse du dépôt git : LOGIN@scm.centrale-marseille.fr:/srv/git/PROJET/default.git

Pour ajouter des utilisateurs au projet : il faut se rapprocher du CRI. Pour deux raisons :

* Les utilisateurs doivent être connus de Redmine

* Les utilisateurs doivent avoir les droits de commit. Ceci implique d’être dans le bon groupe Unix.

{{important(L’encodage par défaut du dépôt est UTF-8. Faîtes-y attention surtout si l’encodage de votre système est différent (Vous êtes sous Windows ou linux > 10 ans).)}}

h2. Les clés ssh

h3. Sous linux

L'accès au dépôt se fait par les clés ssh autorisées dans vos comptes de l'école. Vous pouvez également procéder de même pour vous connecter en ssh à vos comptes personnels ou d’association. Il faut juste adapter les dossiers et les machines.

Pour créer une paire de clé ssh, lancez la commande : <code>ssh-keygen</code>. Ceci crée deux fichiers dans votre ~/.ssh : id_rsa (votre clé privée à conserver précieusement) et id_rsa.pub (votre clé publique à transmettre).

Pour pouvoir utiliser votre clé publique ssh (~/.ssh/id_rsa.pub) dans le fichier authorized keys dans votre compte de l'école (eg : sur le sas) :

* si la clé est dans votre compte:

 * <code>cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_key</code>

* si elle est sur votre machine perso, *au choix* :

 * <code>ssh-copy-id login@sas1.ec-m.fr</code>

 * <code>cat ~/.ssh/id_rsa.pub | ssh LOGIN@sas1.ec-m.fr 'mkdir -m 700 -p ~/.ssh ; cat >> .ssh/authorized_keys'</code>

h3. Sous windows

Installer un client ssh. Par exemple "ppty":http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html. Allez sur "ce tuto":http://assos.centrale-marseille.fr/ginfo/content/utiliser-un-terminal-unix-comme-si-vous-%C3%A9tiez-au-cri pour plus de détails.

Ceci vous permet d’avoir une console. Le programme puttygen (disponible "ici":http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) vous permet de générer une paire de clé. Il suffit de l’exécuter et de suivre les instructions. Le champ passphrase est facultatif. Sauvegarder votre paire de clé dans un endroit sécurisé.

h2. Pour cloner le dépôt

# Se placer dans là où on veut cloner le dépôt

# Tapez : <code>git clone ssh://LOGIN@scm.centrale-marseille.fr/srv/git/PROJET/default.git .</code>

h2. Fonctionnalités à connaître et exemple d’utilisation

TODO

h2. Commandes basiques de git

* Pour récupérer les "nouveautés" : <code>git pull</code>

* Pour envoyer ses modifications : <code>git push</code>

* Pour ajouter un fichier au projet : <code>git add <le_fichier></code>

* Pour enregistrer les modifications : <code>git commit <le_fichier></code>

* Pour plus de détails : http://www.siteduzero.com/informatique/tutoriels/gerez-vos-codes-source-avec-git