Réunion TWiki - documentalistes - 13/02/2014

Présents : Catherine Brunet, Mihaela Buga, Aline Eisele, Sylvain Guéhenneux, Emmanuelle Perret, Evelyne Son, Philippe Vonflie

OJ :

• l'accès au Wiki
• Ce qu'on trouve sur la Home Page générale du TWiki
• Les différentes sections de l'espace documentalistes
• La recherche dans le Twiki
• L'Edition dans le Twiki
• La procédure pour mettre à jour le TWiki

I. Accès au Twiki

Via la Home Page du [[http://cdsweb.u-strasbg.fr/index-fr.gml][CDS], lien tout en bas à gauche pour le Twiki ou mettre un bookmark sur " http://cds.u-strasbg.fr/twiki/bin/view/Main/WebHome".

• Identifiant = PrenomNom
• Mot de passe : pour le changer ou le réinitialiser (si on ne s'en souvient pas) : " http://cds.u-strasbg.fr/twiki/bin/view/TWiki/ChangePassword"

II. La Home Page du Twiki

La section "Documentaliste" se trouve au milieu à droite.

On accède déjà à des documents importants depuis cette page :

• Document des commandes de MAJ SIMBAD
• Document des commandes de MAJ VizieR
• Informations générales (pour tout le CDS) concernant l'équipe des doc' de choc : organigamme, suivi et le ReadMe expliqué à leurs utilisateurs...
• Vous pouvez y ajouter les documents que vous utilisez très souvent au besoin.

III. "L'espace documentalistes"

En cliquant sur le bouton violet "Documentalistes", on accède à "l'espace documentalistes" où l'on retrouve les 9 parties dont on avait déjà discutées et qui permettent d'organiser l'ensemble de nos documents.

On accède déjà à un certain nombre de documents particulièrement utilisés ou importants depuis cette Home Page Documentaliste.

Si on regarde chaque partie d'un peu plus près :

1. "Equipe biblio"

Comme l'indique la phrase d'introduction à cette section, il s'agit des info concernant l'ensemble des documentalistes.

On trouve dès la page d'accueil de l'espace documentaliste :

• des liens vers des pages : l'organigramme, le suivi annuel et une page d'explication des statuts SIMBAD (en cours de construction).
• un résumé des informations que l'on trouve dans cet espace.
• Comme pour la Home Page générale, vous pouvez y ajouter des liens que vous utilisez souvent.

En allant dans cette section (clic sur le bouton gris), on trouve :

• Une phrase d'introduction sur ce que contient la section.
• Un sommaire qui donne accès aux différentes rubriques.
• Ce qui peut nous intéresser le plus : la page qui liste les abbréviations des différents utilisateurs de SIMBAD et qui fait quoi, les définitions des statuts SIMBAD, les présentations sur les services du CDS qui ont été faites. (Pour le reste, jetez-y un oeil au moins une fois !)

2. "SIMBAD (mise à jour)"

Même chose que précédemment : la Home Page de l'espace Doc donne accès à un ensemble d'information que l'on peut trouver dans cette section ainsi qu'un lien direct vers :

• Les commandes de mise à jour pour SIMBAD
• Le manuel détaillé du bibliographe (document de Suzanne Laloé repris par Aline - sans doute à revoir pour qu'il colle plus à la création d'une référence biblio et en mettant toute la partie sur les commandes dans le document des commandes...)
• Lien vers les réunions =g=

En cliquant sur le bouton gris (ou dans la section déroulante des menus en haut de la page "Home" -> "SimbadDocumentaliste Web"), on arrive sur la page complète de cette partie.

Même chose, une petite phrase explicative en en-tête et différentes parties. Les documents les plus utiles sont sans doute le document des commandes de MAJ SIMBAD (3è moyen d'accès), il y a aussi un lien vers la page des programmes maison (findsdss, simref, astropos, intégrer une table (autre que celles de VizieR) dans Aladin)...

Voir pour le reste...

3. "RACCORD"

En direct depuis la Home Page Documentalistes :

• Manuel de Raccord
• Lien vers le projet du nouveau Raccord ("Sidonie" est approuvé par tout le monde mais déjà pris... Nous cherchons un nouveau nom !)

Dans la page complète de cette section : quelques trucs et astuces... Ajoutez ce qui vous semble utile !

4. DJIN

En accès direct :

• Manuel d'utilisation (fait par Magali)
• Lien vers les "réunions djinistes"

Pas grand chose de plus dans la section compète (voir quand même les infos au moins une fois, ça peut servir...)

A vous d'ajouter le reste !

5. VizieR

En direct depuis la home page doc' :

• Le ReadMe expliqué aux utilisateurs
• La page des unités avec quelques conversions pratiques (cf. case "compute" pour plus de renseignement sur une unité)
• "Procédure" est la procédure complète depuis la récupération d'une table jusqu'à son entrée dans VizieR
• "exemples" est le document des commandes de MAJ VizieR
• "Document d'ingestion par François" est le document complet pour l'ingestion des catalogues, les tracés de graphes, etc. dans VizieR
• La page sur les fichiers .FITS est celle qui donne ce qu'on veut faire avec ce type de format
• Accès à la page des réunions hebdomadaires

La section détaillée est découpée en parties (qui doivent encore être un peu travaillées) :

• Standards et documentation : donne les pages d'aide, les standards fournis aux usagers, etc. (dans l'idée => pour tous)
• Procédures : donne les différentes étapes pour ingérer des données dans VizieR
• Commandes en pratique : donne les exemples concrets des différents commandes
• Réunions...

6. Dictionnaire (de nomenclature)

Dans l'idée : y mettre tous les problèmes concernant l'identification des objets. En l'occurrence, "Règles à suivre" lorsque l'objet n'est pas dans le catalogue d'origine cité, les décodages lors des réunions Djinistes, correspondances "Nicknames"/SNe, etc.

7. Astrophysique

En accès direct depuis la Home Page :

• Gros travail de Mihaela sur les missions et les instruments qu'on peut retrouver par ordre alphabétique dès la Home Page Doc. Pour chaque instrument, il y a le lien vers son site, Wikipédia, les longueurs d'onde et des informations sur les cross-identifications possibles (vérifiées auprès des astronomes).
• On trouve aussi des liens directs vers les éclaircissements sur certains types d'objets (généralement les e-mail envoyés par Cécile pour préciser certaines choses)
• Le document de Pierre O. sur les qualités des redshifts.
• etc.

Dans la section complète, on retrouve évidemment les mêmes infos, plus des liens vers des sites de vulgarisation qui peuvent servir (conférences des Jardins des Sciences, astro-ph reader's digest, etc.)

On trouve également les missions par ordre chronologique pour voir lesquelles sont terminées ou en cours ("ongoing") et par longueur d'onde d'observation : IR, X, smm/mm/Rad

etc.

8. Informatique

La section "Informatique" donne surtout des liens externes vers les outils informatiques sauf la page qui concerne les programmes maison ("Tips prog")...

Depuis la Home Page Doc, on retrouve déjà un certains nombre de liens :

• La page "Tips prog" sous le lien "findsdss, gsc4sim..."
• La page d'exemple de requêtes SQL dans SIMBAD
• Le lien vers TOPCAT
• Le lien vers la page "grep, awk, sed" qui donne des exemples pour substituer, convertir, supprimer des chaînes de caractères dans un fichier
• etc.

Ce serait bien de voir, au moins une fois, ce qui peut vous intéresser... Et d'y ajouter ce qui vous paraît utile.

9. Liens utiles

Un beau sommaire fait par Sylvain vous donne directement les infos :

Il s'agit de liens vers des pages utiles concernant certains types d'objets (particulièrement intéressant pour les exoplanètes, les SNe, les OGLE et les GRB - allez voir !) et quelques autres sections...

III. La recherche sur le TWiki

Comme il commence à y avoir pas mal de chose sur ce TWiki (et malgré les beau découpage que l'on a fait par partie qui devrait vous permettre de vous y retrouver), on veut utiliser la fonction principale de tout Wiki : le moteur de recherche.

Vous pouvez faire une recherche rapide, à l'endroit où vous vous trouvez dans la zone "search" (tapper votre recherche + Entrée) mais ceci est l'équivalent du "Ctrl F"... Par contre, après avoir fait "Entrée", vous pouvez aller plus loin !

Exemple :

findsdss + Entrée : vous donne un résultat plus la zone de recherche avec le lien "Advanced search" et "Help". En cochant simplement la petite case "All public webs", vous élargissez votre recherche à tout le TWiki...

Vous avez alors une liste de Resultats dont chaque zone surlignée indique la section où le mot-clef a été trouvé.

Malheureusement, pour l'instant, il faut cliquer sur les différentes pages et re-faire un "Ctrl F" pour retrouver votre mot-clef (l'endroit où il a été trouvé n'est pas très explicite dans le résultat)...

Tester ! La page "Help" est bien faite et donne grosso-modo les indications pour construire votre requête (classique : + pour AND, "pour une expression", - pour exclure).

Vous avez accès à la fonction "Search" également depuis le menu déroulant en haut "Twiki web", il faut juste se souvenir de cocher "All public web" si on ne veut pas limiter la recherche à la section où on se trouve seulement.

IV. L'édition dans le Twiki

Pour les plus motivés - qui veulent partager leurs connaissances et participer à ce bel outil de travail collaboratif pour faire gagner du temps à leurs collègues lorsqu'ils rencontreront les mêmes problèmes qu'eux et pour afficher fièrement votre solution en ligne après moultes heures d'arrachage de cheveux - un point rapide sur les modes d'édition du Twiki.

Là encore, le plus simple est de pratiquer ! Et surtout, ne pas paniquer, ne pas s'énerver, penser au "Ctrl z" pour revenir en arrière ou à la page "retour arrière" du navigateur pour quitter sans sauvegarder sa page !

Bref, vous êtes prêts et zen : cliquer sur "Edit", en haut à droite de la page que vous voulez modifier.

Vous avez alors une zone de texte avec une barre d'outils au-dessus qui ressemble férocement à celle d'un document Word... (C'est fait exprès il paraît). Vous pouvez (dans l'ordre) : choisir un style de titre, mettre en gras, italique, changer de couleur, effacer le formatage que vous venez de faire avec la petite gomme (parce que gras+italique+couleur ça fait beaucoup...), mettre une puce devant ce que vous venez d'écrire pour avoir un beau retrait de paragraphe ou mettre un numéro, enlever cette puce ou numéro, insérer un hyperlien, enlever cet hyperlin et puis etc. (Il y a aussi le ctrl z derrière la flèche retour - bref).

Vous pouvez aussi agrandir votre zone de texte en cliquant en bas à droite du cadre et en le faisant glisser...

On fait "Save" lorsqu'on est satisfait ou que le texte est long pour éviter de le perdre...

Le petit marteau tout à la fin des outils proposés permet de passer à un autre mode d'édition (celui de l'ancien Wiki avec les balises : les <nop> pour ignorer les signes =, les <br> pour faire des retours à la lignes, etc.)...

Je vous déconseille l'édition HTML (juste avant) sauf si vous connaissez bien le langage et je vous conseille de sauvegarder votre page avant de changer de mode d'édition plutôt que de passer d'un mode à l'autre...

Pour les copier/coller, pensez à être déjà en mode édition et à l'endroit où vous voulez coller votre futur texte avant de le prendre dans la souris pour le coller sinon vous risquez d'avoir des problèmes... Mais heureusement, le "ctrl z" sera là !

Pour créer une nouvelle page, vous pouvez le faire :

• directement à partir d'une page existante : un nom qui comprend 2 majuscules se transforme automatiquement en page potentielle. Par exemple : PageTest apparaît en rouge surligné. Vous pouvez cliquer dessus pour créer la page (ou "Topic").
  • Pour que ce soit plus joli, il faudra construire un lien relatif pour que le texte affiché lorsque l'on clique sur le lien soit différent. Pour cela, on construit le lien (ça marche aussi pour les hyperliens normaux) avec un premier [ ] qui donne le lien et un deuxième [ ] qui donne le texte à afficher, le tout entre crochets derechef. Par exemple : [ [PageTest (ou url http)] [Page de test] ] (J'ai mis des blancs pour que vous voyez la syntaxe mais il ne faut pas en mettre pour que ça fonctionne !!).
• directement à partir du menu : à partir de votre section, l'onglet à côté de l'onglet "Home" propose "Create new topic". Il suffit alors de donner le nom de la page et d'indiquer son parent (et cocher la petite case au besoin pour que le bouton "Create" devienne cliquable.

Pensez aussi à prendre d'autres pages déjà créées en exemple...

Pour les plus motivés, il y a des pages d'aide ici : http://cds.u-strasbg.fr/twiki/bin/view/TWiki/

Pour ceux qui ne veulent pas s'embêter avec l'Edition, n'hésitez pas à demander à quelqu'un (Mihaela, moi...) d'intégrer une information qui vous paraît fondamentale et que vous ne trouvez pas sur le TWiki !

V. Procédure pour mettre à jour le Twiki

Afin de ne pas ajouter à la confusion qui naît forcément lorsque beaucoup d'information se retrouve au même endroit, on peut suivre des règles simples pour mettre à jour le TWiki :

1. Vérifier que l'information que vous voulez ajouter n'existe pas déjà. (cf. mode "Search")

2. L'ajouter dans la section qui vous paraît la plus pertinente.

• Si vous hésitez entre plusieurs sections, créer une page et ajoutez les liens vers cette page dans les différentes sections pertinentes.

3. Eviter de modifier les plans en place.

4. Envoyez un mail avec en sujet [TWiki_maj] (afin que chacun puisse créer un filtre dans son Thunderbird/Outlook pour trier ces messages s'il le souhaite) pour les modifications importantes. Par exemple, Subjet : "[TWiki_maj] : eclaircissement masers"... Comme ça le [TWiki_maj] permet de faire un filtre et le sujet est suffisamment clair pour qu'on sache tout de suite de quoi traite le message...

A vous de jouer !

Ceci ne remplace bien évidemment pas les discussions entre collègues, au contraire, discutons des problèmes rencontrés pour qu'ils soient de plus en plus facile à résoudre !

-- EmmanuellePerret - 2014-02-13