AdminProjet: retour_exp_fp.html

File retour_exp_fp.html, 42.8 KB (added by pinsard, 15 years ago)
Line 
1<?xml version="1.0" encoding="utf-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml">
4  <head>
5    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6    <title>Retour d'expérience</title>
7    <link rel="stylesheet" href="../../style.css" type="text/css" />
8    <link rel="stylesheet" href="../../fp.css" type="text/css" />
9    <link rev="made" href="mailto:Francoise.Pinsard at locean-ipsl.upmc.fr" />
10    <meta name="generator" content="DocBook XSL Stylesheets V1.71.1" />
11    <meta name="keywords" content="trac, forge, svn" />
12    <meta xmlns="" name="robots" content="noindex,nofollow,noarchive" />
13  </head>
14  <body>
15    <div class="article" lang="en" xml:lang="en">
16      <div xmlns="" class="titlepage">
17        <div>
18          <div>
19            <h2 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="id892265"></a>Retour d'expérience</h2>
20          </div>
21          <div>
22            <div xmlns="http://www.w3.org/1999/xhtml" class="authorgroup">
23              <div class="author">
24                <h3 class="author"><span class="firstname">Françoise</span> <span class="surname">Pinsard</span></h3>
25                <code class="email">&lt;<a href="mailto:Francoise.Pinsard_at_locean-ipsl.upmc.fr">Francoise.Pinsard_at_locean-ipsl.upmc.fr</a>&gt;</code>
26              </div>
27            </div>
28          </div>
29        </div>
30        <hr />
31      </div>
32      <div class="toc">
33        <p>
34          <b>Table of Contents</b>
35        </p>
36        <dl>
37          <dt>
38            <span class="sect1">
39              <a href="#creationnouveauprojet">1. Création d'un nouveau projet</a>
40            </span>
41          </dt>
42          <dd>
43            <dl>
44              <dt>
45                <span class="sect2">
46                  <a href="#travail_forge">1.1.
47Travail sur <code class="systemitem">forge.ipsl.jussieu.fr</code>
48</a>
49                </span>
50              </dt>
51              <dd>
52                <dl>
53                  <dt>
54                    <span class="sect3">
55                      <a href="#travail_forge_projet">1.1.1. Création du projet</a>
56                    </span>
57                  </dt>
58                  <dt>
59                    <span class="sect3">
60                      <a href="#travail_forge_utilisateurs">1.1.2. Création et association d'utilisateurs</a>
61                    </span>
62                  </dt>
63                  <dt>
64                    <span class="sect3">
65                      <a href="#travail_trac">1.1.3.
66Travail sur <span class="application">trac</span>
67</a>
68                    </span>
69                  </dt>
70                  <dd>
71                    <dl>
72                      <dt>
73                        <span class="sect4">
74                          <a href="#travail_trac_config">1.1.3.1.
75Configuration de <span class="application">trac</span>
76</a>
77                        </span>
78                      </dt>
79                      <dt>
80                        <span class="sect4">
81                          <a href="#travail_trac_permission">1.1.3.2.
82Autorisations
83</a>
84                        </span>
85                      </dt>
86                      <dt>
87                        <span class="sect4">
88                          <a href="#travail_trac_wiki">1.1.3.3.
89Wiki
90</a>
91                        </span>
92                      </dt>
93                      <dt>
94                        <span class="sect4">
95                          <a href="#travail_trac_roadmap">1.1.3.4.
96Roadmap
97</a>
98                        </span>
99                      </dt>
100                    </dl>
101                  </dd>
102                  <dt>
103                    <span class="sect3">
104                      <a href="#travail_svn">1.1.4.
105Travail sur <span class="application">svn</span>
106</a>
107                    </span>
108                  </dt>
109                  <dd>
110                    <dl>
111                      <dt>
112                        <span class="sect4">
113                          <a href="#travail_svn_organisation">1.1.4.1.
114Organisation de l'arborescence de base de <span class="application">svn</span>
115</a>
116                        </span>
117                      </dt>
118                      <dt>
119                        <span class="sect4">
120                          <a href="#travail_svn_import">1.1.4.2.
121Importation du travail original de Frédéric
122</a>
123                        </span>
124                      </dt>
125                      <dt>
126                        <span class="sect4">
127                          <a href="#travail_svn_ws">1.1.4.3.
128Organisation pour contribution
129</a>
130                        </span>
131                      </dt>
132                    </dl>
133                  </dd>
134                </dl>
135              </dd>
136              <dt>
137                <span class="sect2">
138                  <a href="#non_travail_forge">1.2. Travail non réalisé sur <code class="systemitem">forge.ipsl.jussieu.fr</code></a>
139                </span>
140              </dt>
141              <dd>
142                <dl>
143                  <dt>
144                    <span class="sect3">
145                      <a href="#logo">1.2.1. changement de logo</a>
146                    </span>
147                  </dt>
148                  <dt>
149                    <span class="sect3">
150                      <a href="#listedediffusion">1.2.2. Liste de diffusion</a>
151                    </span>
152                  </dt>
153                  <dt>
154                    <span class="sect3">
155                      <a href="#descriptionmilestone">1.2.3. Description des milestones</a>
156                    </span>
157                  </dt>
158                </dl>
159              </dd>
160            </dl>
161          </dd>
162        </dl>
163      </div>
164      <div class="sect1" lang="en" xml:lang="en">
165        <div xmlns="" class="titlepage">
166          <div>
167            <div>
168              <h2 xmlns="http://www.w3.org/1999/xhtml" class="title" style="clear: both"><a id="creationnouveauprojet"></a>1. Création d'un nouveau projet</h2>
169            </div>
170          </div>
171        </div>
172        <p>
173Vous trouverez dans la section suivante les étapes que j'ai suivi pour créer et configurer le projet <a href="http://forge.ipsl.jussieu.fr/geomag/" target="_top">GEOMAG</a> sur <code class="systemitem">forge.ipsl.jussieu.fr</code>
174à partir d'un ensemble de sources existants.
175</p>
176        <p>
177Il s'agit de notes de travail réalisé au cours de novembre 2006 aprÚs qqes mois
178passés à me faire la main sur le projet  <a href="http://forge.ipsl.jussieu.fr/saxo/" target="_top">SAXO</a>.
179</p>
180        <p>
181J'espÚre que ce document vous aidera à demarrer vos nouveaux projets.
182</p>
183        <div class="sect2" lang="en" xml:lang="en">
184          <div xmlns="" class="titlepage">
185            <div>
186              <div>
187                <h3 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_forge"></a>1.1. 
188Travail sur <code class="systemitem">forge.ipsl.jussieu.fr</code>
189</h3>
190              </div>
191            </div>
192          </div>
193          <div class="sect3" lang="en" xml:lang="en">
194            <div xmlns="" class="titlepage">
195              <div>
196                <div>
197                  <h4 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_forge_projet"></a>1.1.1. Création du projet</h4>
198                </div>
199              </div>
200            </div>
201            <p>
202Olivier Thauvin a crée le projet GEOMAG avec moi comme contact et
203administrateur sous le compte <code class="systemitem">pinsard</code> <sup>[<a id="id973362" href="#ftn.id973362">1</a>]</sup>.
204</p>
205            <p>
206Je modifie le mot de passe du compe <code class="systemitem">geomag@forge.ipsl.jussieu.fr</code> associé à ce projet
207aprÚs avoir sélectionné le projet
208<span class="guibutton">geomag</span>
209dans la colonne de gauche de la page
210<a href="https://forge.ipsl.jussieu.fr/admin/" target="_top">https://forge.ipsl.jussieu.fr/admin/</a>.
211</p>
212            <div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;">
213              <h3 class="title"><a id="motdepassegeomag"></a>mot de passe <code class="systemitem">geomag@forge.ipsl.jussieu.fr</code></h3>
214              <p>
215Le changement de mot de passe du compe <code class="systemitem">geomag@forge.ipsl.jussieu.fr</code> associé à ce projet
216aprÚs avoir sélectionné le projet
217<span class="guibutton">geomag</span>
218dans la colonne de gauche de la page
219<a href="https://forge.ipsl.jussieu.fr/admin/" target="_top">https://forge.ipsl.jussieu.fr/admin/</a> doit être accompagné par la modification dans
220<code class="filename">/ipsl/forge/projet/geomag/trac/conf/trac.ini</code> de la ligne
221de connection à la base de données
222</p>
223              <pre class="programlisting">
224database = postgres://<em class="replaceable"><code>projet</code></em>:<em class="replaceable"><code>motdepasse</code></em>@forge.ipsl.jussieu.fr/<em class="replaceable"><code>projet</code></em>_trac
225</pre>
226              <p>
227sous peine de problÚme d'accÚs à la page <a href="http://forge.ipsl.jussieu.fr/geomag" target="_top">http://forge.ipsl.jussieu.fr/geomag</a>.
228</p>
229            </div>
230            <p>
231Toujours dans cette page de gestion de projet, je complÚte cette création en remplissant les champs
232<span class="guilabel">Url:</span> et <span class="guilabel">Description</span>.
233On constate que la description apparaît dans la page d'accueil
234<a href="http://forge.ipsl.jussieu.fr/" target="_top">http://forge.ipsl.jussieu.fr/</a>.
235</p>
236          </div>
237          <div class="sect3" lang="en" xml:lang="en">
238            <div xmlns="" class="titlepage">
239              <div>
240                <div>
241                  <h4 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_forge_utilisateurs"></a>1.1.2. Création et association d'utilisateurs</h4>
242                </div>
243              </div>
244            </div>
245            <p>
246Olivier Thauvin a créé des comptes pour chaque administrateur de projet.
247Les administrateurs peuvent à leur tour créer des comptes pour les
248les personnes qu'ils souhaitent via le bouton
249<span class="guibutton">créer un utilisateur</span>
250en se connectant à <a href="https://forge.ipsl.jussieu.fr/admin/" target="_top">https://forge.ipsl.jussieu.fr/admin/</a>.
251En tant qu'administrateur du projet GEOMAG, je crée ainsi le compte de Frédéric
252<code class="systemitem">fvi</code>.
253</p>
254            <p>
255Les administrateurs peuvent associer des utilisateurs à leur projet
256via le bouton
257<span class="guibutton"><em class="replaceable"><code>projet</code></em></span>
258dans la colonne de gauche de la page
259<a href="https://forge.ipsl.jussieu.fr/admin/" target="_top">https://forge.ipsl.jussieu.fr/admin/</a> puis en choisissant
260un utilisateur dans la partie “<span class="quote">Ajouter un utilisateur</span>”.
261J'associe ainsi <code class="systemitem">fvi</code> au projet
262<span class="guibutton">geomag</span>.
263</p>
264          </div>
265          <div class="sect3" lang="en" xml:lang="en">
266            <div xmlns="" class="titlepage">
267              <div>
268                <div>
269                  <h4 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_trac"></a>1.1.3. 
270Travail sur <span class="application">trac</span>
271</h4>
272                </div>
273              </div>
274            </div>
275            <div class="sect4" lang="en" xml:lang="en">
276              <div xmlns="" class="titlepage">
277                <div>
278                  <div>
279                    <h5 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_trac_config"></a>1.1.3.1. 
280Configuration de <span class="application">trac</span>
281</h5>
282                  </div>
283                </div>
284              </div>
285              <p>
286Lors de la création du projet un fichier
287<code class="filename">/ipsl/forge/projets/<em class="replaceable"><code>projet</code></em>/trac/conf/trac.ini</code> donnant au projet une configuration par défaut choisie par
288Olivier est créé.
289</p>
290              <p>
291On doit modifier les lignes suivantes :
292</p>
293              <pre class="programlisting">
294link = http://trac.edgewall.com/
295descr = My example project
296</pre>
297              <p>
298en mettant la même chose que dans l'url et la description du projet sous
299<a href="http://forge.ipsl.jussieu.fr/" target="_top">http://forge.ipsl.jussieu.fr/</a> (cf. <a href="#travail_forge_projet" title="1.1.1. Création du projet">Section 1.1.1, “Création du projet”</a>).
300</p>
301              <p>
302On pourra aussi associer un logo<sup>[<a id="id973637" href="#ftn.id973637">2</a>]</sup>, une mailing list, des notification sur les tickets, etc, mais ++ pas d'urgence
303</p>
304              <div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;">
305                <h3 class="title"><a id="copieavantmodif"></a>Copie avant modification</h3>
306                <p>
307Il peut être prudent de copier la version courante du fichier de configuration
308avant de faire une modification. On peut procéder ainsi
309</p>
310                <pre class="screen">
311<code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="filename">trac/conf/</code></code></em></code></strong>
312<code class="prompt">$</code> <strong class="userinput"><code><code class="varname">fileorig</code>=<code class="filename">trac.ini</code></code></strong>
313<code class="prompt">$</code> <strong class="userinput"><code><span><strong class="command">cp</strong></span> <em class="parameter"><code><code class="envar">${fileorig}</code></code></em> <em class="parameter"><code><code class="filename"><code class="envar">${fileorig}</code>_$(date -u +"%Y%m%d%H%M%S")</code></code></em></code></strong>
314</pre>
315                <p>
316</p>
317              </div>
318              <p>
319Voir l'avertissement concernant le changement de <a href="#motdepassegeomag" title="mot de passe geomag@forge.ipsl.jussieu.fr">mot de passe <code class="systemitem">geomag@forge.ipsl.jussieu.fr</code></a>.
320</p>
321            </div>
322            <div class="sect4" lang="en" xml:lang="en">
323              <div xmlns="" class="titlepage">
324                <div>
325                  <div>
326                    <h5 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_trac_permission"></a>1.1.3.2. 
327Autorisations
328</h5>
329                  </div>
330                </div>
331              </div>
332              <p>
333Des permissions sont accordées par défaut lors de la création du projet.
334</p>
335              <p>
336Il faut les modifier pour éviter en particuliers des spams sur les tickets.
337</p>
338              <p>
339On commence par créer un “<span class="quote">groupe</span>” <span class="token">developper</span>
340en tapant la commande suivante pour chaque contributeur (utilisateur déclaré
341dans <a href="#travail_forge_utilisateurs" title="1.1.2. Création et association d'utilisateurs">Section 1.1.2, “Création et association d'utilisateurs”</a>) au projet :
342</p>
343              <pre class="screen">
344<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>add</code></em> <em class="parameter"><code><em class="replaceable"><code>utilisateur</code></em></code></em> <em class="parameter"><code>developper</code></em></code></strong>
345</pre>
346              <p>
347</p>
348              <p>
349Puis on supprime les accÚs aux actions sensibles aux inconnus et on n'autorise ces mêmes actions qu'aux contributeurs :
350</p>
351              <pre class="screen">
352<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>remove</code></em> <em class="parameter"><code>anonymous</code></em> <em class="parameter"><code>WIKI_CREATE</code></em></code></strong>
353<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>remove</code></em> <em class="parameter"><code>authenticated</code></em> <em class="parameter"><code>WIKI_CREATE</code></em></code></strong>
354<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>remove</code></em> <em class="parameter"><code>anonymous</code></em> <em class="parameter"><code>WIKI_MODIFY</code></em></code></strong>
355<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>remove</code></em> <em class="parameter"><code>authenticated</code></em> <em class="parameter"><code>WIKI_MODIFY</code></em></code></strong>
356<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>remove</code></em> <em class="parameter"><code>anonymous</code></em> <em class="parameter"><code>TICKET_MODIFY</code></em></code></strong>
357<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>remove</code></em> <em class="parameter"><code>anonymous</code></em> <em class="parameter"><code>TICKET_CREATE</code></em></code></strong>
358<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>add</code></em> <em class="parameter"><code>developper</code></em> <em class="parameter"><code>WIKI_CREATE</code></em></code></strong>
359<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>add</code></em> <em class="parameter"><code>developper</code></em> <em class="parameter"><code>WIKI_MODIFY</code></em></code></strong>
360<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>add</code></em> <em class="parameter"><code>developper</code></em> <em class="parameter"><code>WIKI_DELETE</code></em></code></strong>
361<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>add</code></em> <em class="parameter"><code>authenticated</code></em> <em class="parameter"><code>TICKET_CREATE</code></em></code></strong>
362<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>add</code></em> <em class="parameter"><code>authenticated</code></em> <em class="parameter"><code>TICKET_MODIFY</code></em></code></strong>
363<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>add</code></em> <em class="parameter"><code>developper</code></em> <em class="parameter"><code>MILESTONE_ADMIN</code></em></code></strong>
364</pre>
365              <p>
366</p>
367              <p>
368Cette organisation facilite l'ajout d'un utilisateur. Il n'y a que son adhésion
369au “<span class="quote">groupe</span>” <span class="token">developper</span> Ã  faire.
370</p>
371              <p>
372On peut vérifier que la sortie de la commande suivante :
373</p>
374              <pre class="screen">
375<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>permission</code></em> <em class="parameter"><code>list</code></em></code></strong>
376</pre>
377              <p>
378donne bien
379</p>
380              <pre class="screen">
381<code class="computeroutput">
382User           Action
383------------------------------
384anonymous      BROWSER_VIEW
385anonymous      CHANGESET_VIEW
386anonymous      FILE_VIEW
387anonymous      LOG_VIEW
388anonymous      MILESTONE_VIEW
389anonymous      REPORT_SQL_VIEW
390anonymous      REPORT_VIEW
391anonymous      ROADMAP_VIEW
392anonymous      SEARCH_VIEW
393anonymous      TICKET_VIEW
394anonymous      TIMELINE_VIEW
395anonymous      WIKI_VIEW
396authenticated  TICKET_CREATE
397authenticated  TICKET_MODIFY
398developer      MILESTONE_ADMIN
399developer      WIKI_CREATE
400developer      WIKI_DELETE
401developer      WIKI_MODIFY
402<em class="replaceable"><code>utilisateur</code></em>    developer
403</code>
404</pre>
405              <p>
406
407</p>
408            </div>
409            <div class="sect4" lang="en" xml:lang="en">
410              <div xmlns="" class="titlepage">
411                <div>
412                  <div>
413                    <h5 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_trac_wiki"></a>1.1.3.3. 
414Wiki
415</h5>
416                  </div>
417                </div>
418              </div>
419              <p>
420La page <span class="token">WikiStart</span> Ã  la création du projet renseigne sur
421<span class="application">trac</span>.
422On doit remplacer cette page avec les informations concernant le projet.
423Ce remplacement peut se faire dans un premier temps par la modification clicodromique en étant loggué sous <a href="http://forge.ipsl.jussieu.fr/geomag/" target="_top">http://forge.ipsl.jussieu.fr/geomag/</a> avec le menu <span class="guilabel">loggin</span>.
424</p>
425            </div>
426            <div class="sect4" lang="en" xml:lang="en">
427              <div xmlns="" class="titlepage">
428                <div>
429                  <div>
430                    <h5 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_trac_roadmap"></a>1.1.3.4. 
431Roadmap
432</h5>
433                  </div>
434                </div>
435              </div>
436              <p>
437La “<span class="quote">roadmap</span>” est l'ensemble des étapes d'un projet.
438Quatre étapes nommées “<span class="quote">milestone<em class="replaceable"><code>x</code></em></span>” sont définies à la création du projet.
439</p>
440              <p>
441Il faut définir et renseigner les étapes du projet <span class="token">geomag</span> soit par clicodrome sur la page <a href="http://forge.ipsl.jussieu.fr/geomag/roadmap/" target="_top">http://forge.ipsl.jussieu.fr/geomag/roadmap/</a> soit avec la commande <span><strong class="command">trac-admin</strong></span>.
442</p>
443              <div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;">
444                <h3 class="title">Ordre des étapes</h3>
445                <p>
446On ne maîtrise pas l'ordre des étapes avec <strong class="userinput"><code>trac-admin <em class="replaceable"><code>path</code></em> milestone</code></strong>. Elles apparaissent dans l'ordre alphanumérique.
447</p>
448              </div>
449              <p>
450</p>
451              <pre class="screen">
452<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>milestone</code></em> <em class="parameter"><code>rename</code></em> <em class="parameter"><code>milestone1</code></em> <em class="parameter"><code>"GEOMAG sur trac"</code></em></code></strong>
453<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>milestone</code></em> <em class="parameter"><code>rename</code></em> <em class="parameter"><code>milestone2</code></em> <em class="parameter"><code>"sources fvi sous svn"</code></em></code></strong>
454<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>milestone</code></em> <em class="parameter"><code>rename</code></em> <em class="parameter"><code>milestone3</code></em> <em class="parameter"><code>"code indépendant utilisateur et machine"</code></em></code></strong>
455<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>milestone</code></em> <em class="parameter"><code>rename</code></em> <em class="parameter"><code>milestone4</code></em> <em class="parameter"><code>"adaptation 1/4 de degré"</code></em></code></strong>
456</pre>
457              <p>
458</p>
459              <p>
460On peut ajouter des étapes tout de suite :
461</p>
462              <pre class="screen">
463<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>milestone</code></em> <em class="parameter"><code>add</code></em> <em class="parameter"><code>"Belles documentations"</code></em></code></strong>
464<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>milestone</code></em> <em class="parameter"><code>add</code></em> <em class="parameter"><code>"utilisation de la version de référence de SAXO"</code></em></code></strong>
465</pre>
466              <p>
467</p>
468              <p>
469On pourra vérifier l'ensemble de étapes du projet avec la commande suivante :
470</p>
471              <pre class="screen">
472<code class="prompt">geomag@forge$</code> <strong class="userinput"><code><span><strong class="command">trac-admin</strong></span> <em class="parameter"><code><code class="filename">/ipsl/forge/projets/geomag/trac</code></code></em> <em class="parameter"><code>milestone</code></em> <em class="parameter"><code>list</code></em></code></strong>
473</pre>
474              <p>
475</p>
476              <div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;">
477                <h3 class="title">Description d'une milestone</h3>
478                <p>
479La création des milestones via le clicodrome sur la page <a href="http://forge.ipsl.jussieu.fr/geomag/roadmap/" target="_top">http://forge.ipsl.jussieu.fr/geomag/roadmap/</a> permet d'ajouter une description
480ce que je ne sais pas faire avec <span><strong class="command">trac-admin</strong></span>.
481</p>
482              </div>
483            </div>
484          </div>
485          <div class="sect3" lang="en" xml:lang="en">
486            <div xmlns="" class="titlepage">
487              <div>
488                <div>
489                  <h4 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_svn"></a>1.1.4. 
490Travail sur <span class="application">svn</span>
491</h4>
492                </div>
493              </div>
494            </div>
495            <div class="sect4" lang="en" xml:lang="en">
496              <div xmlns="" class="titlepage">
497                <div>
498                  <div>
499                    <h5 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_svn_organisation"></a>1.1.4.1. 
500Organisation de l'arborescence de base de <span class="application">svn</span>
501</h5>
502                  </div>
503                </div>
504              </div>
505              <p>
506Le dépÃŽt <span class="application">svn</span> Ã  la création est vide.
507Il faut créer les répertoires conventionnels <code class="filename">trunk</code>, <code class="filename">branches</code> et <code class="filename">tags</code> :
508</p>
509              <pre class="screen">
510<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="filename">/tmp/</code></code></em></code></strong>
511<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">mkdir</strong></span> <em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/</code></code></em></code></strong>
512<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/</code></code></em></code></strong>
513<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>svn+ssh://pinsard@forge.ipsl.jussieu.fr/ipsl/forge/projets/geomag/svn/</code></em> <em class="parameter"><code><code class="filename">geomag_ws</code></code></em></code></strong>
514<code class="computeroutput">Checked out revision 0.</code>
515<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/geomag_ws/</code></code></em></code></strong>
516<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">mkdir</code> <em class="parameter"><code><code class="filename">trunk</code></code></em></code></strong>
517<code class="computeroutput">A         trunk</code>
518<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">mkdir</code> <em class="parameter"><code><code class="filename">branches</code></code></em></code></strong>
519<code class="computeroutput">A         branches</code>
520<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">mkdir</code> <em class="parameter"><code><code class="filename">tags</code></code></em></code></strong>
521<code class="computeroutput">A         tags</code>
522<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">commit</code> \</code></strong>
523<strong class="userinput"><code><code class="option">--message</code> <em class="parameter"><code>"create tags, branches and trunk directories"</code></em></code></strong>
524<code class="computeroutput">
525Adding         branches
526Adding         tags
527Adding         trunk
528
529Committed revision 1.
530</code>
531</pre>
532              <p>
533</p>
534              <p>
535On peut vouloir choisir de continuer à travailler dans ce “<span class="quote">working space</span>” mais comme il est dans <code class="filename">/tmp/</code>, je préfÚre le détruire :
536</p>
537              <pre class="screen">
538<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span></code></strong>
539<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">rm</strong></span> <code class="option">-fr</code> <em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/</code></code></em></code></strong>
540</pre>
541              <p>
542</p>
543            </div>
544            <div class="sect4" lang="en" xml:lang="en">
545              <div xmlns="" class="titlepage">
546                <div>
547                  <div>
548                    <h5 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_svn_import"></a>1.1.4.2. 
549Importation du travail original de Frédéric
550</h5>
551                  </div>
552                </div>
553              </div>
554              <p>
555Pour mémoire le travail de Frédéric sur ORCA 2 ° est sous
556<code class="systemitem">cerbere</code>:<code class="filename">/usr/work/sur/fvi/OPA/geomag/</code>.
557</p>
558              <p>
559Cette arborescence n'est pas entiÚrement à importer dans le dépot
560<span class="application">svn</span> car elle contient un
561“<span class="quote">cadavre</span>” <span class="application">CVS</span> de
562<span class="application">SAXO</span> et de <span class="application">INTERP2</span>.
563Elle contient aussi des fichiers qui n'ont pas grand chose à faire là comme un
564répertoire vide <code class="filename">interp</code>,
565<code class="filename">toto</code>, <code class="filename">.Xdefaults</code>,
566un fichier <code class="filename">Br_ORCA2.nc.bz2</code>
567version compressée de <code class="filename">Br_ORCA2.nc</code>, etc.
568</p>
569              <p>
570Je passe donc par une arborescence intermédiaire :
571</p>
572              <pre class="screen">
573<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">mkdir</strong></span> <code class="option">-p</code> <em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/src/</code></code></em></code></strong>
574<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">cp</strong></span> <code class="option">-rp</code> <em class="parameter"><code><code class="filename">/usr/work/sur/fvi/OPA/geomag/</code></code></em> <em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/src/</code></code></em></code></strong>
575<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">find</strong></span> <em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/src/</code></code></em> <code class="option">-name</code> <em class="parameter"><code><code class="filename">CVS</code></code></em> <em class="parameter"><code>-exec rm -r {} \;</code></em></code></strong>
576<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/src/</code></code></em></code></strong>
577<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">rm</strong></span> <code class="option">-r</code> <em class="parameter"><code><code class="filename">interp</code></code></em> <em class="parameter"><code><code class="filename">toto</code></code></em> <em class="parameter"><code><code class="filename">.Xdefaults</code></code></em> <em class="parameter"><code><code class="filename">README~</code></code></em> <em class="parameter"><code><code class="filename">Br_ORCA2.nc.bz2</code></code></em></code></strong>
578</pre>
579              <p>
580</p>
581              <p>
582Je passe donc par une arborescence intermédiaire :
583</p>
584              <pre class="screen">
585<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <em class="parameter"><code>import</code></em> \</code></strong>
586<strong class="userinput"><code><code class="option">--message</code> <em class="parameter"><code>"initial import from /usr/work/fvi/OPA/geomag/"</code></em> \</code></strong>
587<strong class="userinput"><code><em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/src/</code></code></em> \</code></strong>
588<strong class="userinput"><code><em class="parameter"><code>svn+ssh://pinsard@forge.ipsl.jussieu.fr/ipsl/forge/projets/geomag/svn/trunk</code></em></code></strong>
589</pre>
590              <p>
591</p>
592              <p>
593L'importation est terminée. On peut vérifier si on a bien tout dans le dépÃŽt <span class="application">svn</span> :
594</p>
595              <pre class="screen">
596<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <em class="parameter"><code>list</code></em> <em class="parameter"><code>http://forge.ipsl.jussieu.fr/geomag/svn/trunk</code></em></code></strong>
597</pre>
598              <p>
599</p>
600              <p>
601On peut donc détruire le répertoire intermédiaire puisque ce n'est pas un “<span class="quote">working space</span>” :
602</p>
603              <pre class="screen">
604<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span></code></strong>
605<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">rm</strong></span> <code class="option">-fr</code> <em class="parameter"><code><code class="filename">/tmp/pour_geomag_svn/src/</code></code></em></code></strong>
606</pre>
607              <p>
608
609</p>
610            </div>
611            <div class="sect4" lang="en" xml:lang="en">
612              <div xmlns="" class="titlepage">
613                <div>
614                  <div>
615                    <h5 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="travail_svn_ws"></a>1.1.4.3. 
616Organisation pour contribution
617</h5>
618                  </div>
619                </div>
620              </div>
621              <p>
622Le dépÃŽt <span class="application">svn</span> Ã©tant maintenant en place, on peut le récupérer sur son poste de travail sous forme de “<span class="quote">working space</span>” en tant que contributeur.
623</p>
624              <p>
625Je choisis de travailler sous mon <code class="envar">${HOME}</code> du LOCEAN pour que la sauvagarde CCR prenne en compte mon “<span class="quote">working space</span>” :
626</p>
627              <pre class="screen">
628<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">cd</strong></span> <em class="parameter"><code><code class="filename">/usr/home/fplod/incas/geomag/</code></code></em></code></strong>
629<code class="prompt">fplod@aedon$</code> <strong class="userinput"><code><span><strong class="command">svn</strong></span> <code class="option">checkout</code> <em class="parameter"><code>svn+ssh://pinsard@forge.ipsl.jussieu.fr/ipsl/forge/projets/geomag/svn/trunk/</code></em> <em class="parameter"><code><code class="filename">geomag_ws</code></code></em></code></strong>
630</pre>
631              <p>
632</p>
633              <p>
634Le travail de mise à jour peut commencer 

635</p>
636            </div>
637          </div>
638        </div>
639        <div class="sect2" lang="en" xml:lang="en">
640          <div xmlns="" class="titlepage">
641            <div>
642              <div>
643                <h3 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="non_travail_forge"></a>1.2. Travail non réalisé sur <code class="systemitem">forge.ipsl.jussieu.fr</code></h3>
644              </div>
645            </div>
646          </div>
647          <div class="sect3" lang="en" xml:lang="en">
648            <div xmlns="" class="titlepage">
649              <div>
650                <div>
651                  <h4 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="logo"></a>1.2.1. changement de logo</h4>
652                </div>
653              </div>
654            </div>
655            <p>
656Nous n'avons pas de logo pour GEOMAG mais si on en avait un on pourrait le mettre sur les pages
657forge.
658</p>
659            <p>
660Soit le logo dans un fichier <code class="filename">logo.png</code>, il faut le déposer dans
661<code class="filename">/ipsl/forge/projet/geomag/trac/htdocs/</code> et modifier dans <code class="filename">/ipsl/forge/projet/geomag//trac/conf/trac.ini</code> la ligne renseignant le logo
662</p>
663            <pre class="programlisting">
664icon = site/logo.png
665</pre>
666            <p>
667</p>
668            <p>
669Pour mémoire, on peut imposer n'importe quelle taille à une image, cepandant on notera que la
670version du logo qui apparait à coté de l'URL dans le navigateur est trÚs petite donc on ne
671peut pas faire des logos trÚs complexe sous peine d'être illisible.
672</p>
673            <p>
674++ taille idéale ou taille de l'image par défaut
675</p>
676          </div>
677          <div class="sect3" lang="en" xml:lang="en">
678            <div xmlns="" class="titlepage">
679              <div>
680                <div>
681                  <h4 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="listedediffusion"></a>1.2.2. Liste de diffusion</h4>
682                </div>
683              </div>
684            </div>
685            <p>
686Pour l'instant nous n'avons pas juger utile de créer une ou plusieurs listes de diffusion associées à ce projet.
687</p>
688            <p>
689En conséquence, il n'y a pas de configuration spécifique de <span class="application">svn</span> pour recevoir des mails aprÚs un <code class="literal">commit</code> ni de configuration spécifique de <span class="application">trac</span> pour recevoir des mails
690aprÚs la création ou la modification d'un ticket.
691</p>
692          </div>
693          <div class="sect3" lang="en" xml:lang="en">
694            <div xmlns="" class="titlepage">
695              <div>
696                <div>
697                  <h4 xmlns="http://www.w3.org/1999/xhtml" class="title"><a id="descriptionmilestone"></a>1.2.3. Description des milestones</h4>
698                </div>
699              </div>
700            </div>
701            <p>
702Pour l'instant on se contente du titre pour donner une idée du pb mais on
703pourrait être plus précis en ajoutant une description (pourquoi, comment, priorité, etc.)
704</p>
705          </div>
706        </div>
707      </div>
708      <div class="footnotes">
709        <br />
710        <hr width="100" align="left" />
711        <div class="footnote">
712          <p><sup>[<a id="ftn.id973362" href="#id973362">1</a>] </sup>Mon compte <code class="systemitem">pinsard@forge.ipsl.jussieu.fr</code> a été créé à l'occasion de la création du projet <a href="https://forge.ipsl.jussieu.fr/saxo/" target="_top">SAXO</a>.</p>
713        </div>
714        <div class="footnote">
715          <p>
716            <sup>[<a id="ftn.id973637" href="#id973637">2</a>] </sup>
717            <a href="#logo" title="1.2.1. changement de logo">Section 1.2.1, “changement de logo”</a>
718          </p>
719        </div>
720      </div>
721    </div>
722  </body>
723</html>