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é.

# Exécutez-le

# Cliquez sur _Generate_.

# Bouger la souris dans tous les sens.

# Sauvegardez votre clé publique et votre clé privé là où vous saurez les retrouver. Pensez à remplir le champ _comment_ avec quelque chose qui vous identifie. Cela permettra de distinguer les clés ssh sur le serveur. {{note(Donnez leur un nom qui vous permette de les distinguer. Par exemple, key pour votre clé privé et key.pub pour votre clé publique.)}}

{{important(Les clés générées par puttygen ne sont compatibles qu’avec putty)}}

Maintenant, vous devez placer ces clés sur le serveur. Pour cela :

# Connecter vous au serveur avec putty

# Créer un dossier .ssh (s’il n’existe pas) <code>mkdir ~/.ssh</code>

# Ouvrez le fichier authorized_keys (ou créez le) : <code>nano -w ~/.ssh/authorized_keys</code>

# Copiez/Collez votre clé publique dedans *sur une seule ligne*

# Sauvegardez

Ensuite, pour vous connecter au serveur à l’aide de ces clés avec le client putty :

# Ouvrir putty

# Dans Connexion > SSH > Auth, renseignez votre clé privée.

# Connecté vous au serveur comme d’habitude.

h2. Installer git

h3. Sous Linux

Git devrait être présent dans les dépôts de votre distribution. Installez-le comme un autre logiciel.

h3. Sous Windows

Il faut tout d’abord installer git. Télécharger msysgit par "ici":http://code.google.com/p/msysgit/. Installez le avec les paramètres par défaut.

Afin de vous faciliter la vie, installez également TortoiseGit. C’est une interface à git grâce à laquelle vous pourrez utiliser vos clés ssh plus facilement. Téléchargez le logiciel "ici":http://code.google.com/p/tortoisegit/ et installez-le avec les options par défaut. Pour le configurer, faîtes un clic droit, puis allez dans _TortoiseGit > Settings_. Entrez le chemin vers msysgit comme demandé puis sauvegardez.

Pour cloner un dépôt :

# Allez là où vous désirez le cloner

# Clique droit, puis clone

# Entrez le chemin du dépôt

# Cocher _Load Putty key_ et entrez le chemin de votre clé privé dans ce champ.

# Vous êtes opérationnel.

Liens complémentaires :

* http://www.siteduzero.com/informatique/tutoriels/gerez-vos-codes-source-avec-git/installer-et-configurer-git

* http://melusine.eu.org/syracuse/G/git-windows/

h2. Pour cloner le dépôt

# Placez-vous 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

h3. Les branches

TODO

h3. Les tags

Pour recherche une version plus facilement, vous pouvez tagger un commit avec <code>git tag NOMTAG IDCOMMIT</code>. Vous pourrez ensuite vous référer à ce commit à l’aide de NOMTAG.

{{note(Par défaut les tags ne sont pas envoyés lors d’un push. Utilisez _git push --tag_)}}

h3. La recherche

Grâce à la commande <code>git grep "PATTERN"</code>, vous pouvez recherche dans vos fichiers sources.

h3. Ignorer des fichiers

Si vous désirez que certains fichiers ne soient pas pris en compte par git (fichier de sauvegarde de votre éditeur de texte par exemple), créez un fichier .gitignore dans le dossier de votre dépôt. Ajoutez dans ce fichier le nom des fichiers à ignorer (1 par ligne).

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