Le rapport d'activité est désormais écrit en markdown, ce qui est aussi le cas de ce README. Voici quelques informations sur markdown, et voici un example upgrade_tracker.md
Pour écrire en markdown vous pouvez utiliser emacs ou tout autre éditeur de texte dont vous êtes familier. Mais il sera plus confortable d'utiliser un éditeur capable d'interpréter le markdown pendant que vous tapez:
Nous écrirons en Français.
En vue de la préparation du dossier HCERES de l’année prochaine, un rapport d’activité de l’unité couvrant les années 2015-2017 est en cours de préparation. Pour cette édition, nous avons décidé de construire le RA par projet, ceci afin de minimiser les redites au sein du document entre les parties écrites par les équipes de recherche et celles écrites par les services techniques.
Nous nous dirigeons vers un format purement dématérialisé sur le site web du laboratoire, donc a priori nous n’avons pas de contrainte de place. Néanmoins en vue d’utiliser ce rapport d’activité comme input au dossier HCERES et dans une moindre mesure au dossier de renouvellement du Labex LIO, nous vous demandons de limiter le texte à environ 1 à 2 pages par projet auxquelles vous joindrez 1 ou 2 figures/photos pour illustration.
Pour les activités de CMS je vois les contributions suivantes auxquelles j’ai associé un(des) nom(s) de responsable(s) :
- Activités d’analyse de Physique : Roberto, Colin. Raphaël confirme qu'il souhaite environ une page par projet de physique
- Projet upgrade Tracker (CIC, Dee, FastTrack) : Sébastien, Luigi, Nick, Nicolas [cette contribution peut-être partagée en plusieurs contributions si vous préférez]
- Projet upgrade Muon-RPC : Imad, Laurent, Christophe
Les différentes parties, en particulier pour les projets, doivent être écrites de telle sorte d’inclure les contributions des services techniques.
Un premier draft de l’ensemble des contributions devra être disponible d’ici à la fin Juin.
Voici ce que je propose. La discussion est ouverte, contactez-moi directement si vous voyez un souci avec ça. En italiques, le nom des responsables de section qui intéragiront directement avec moi avec github. Ces personnes peuvent simplement récupérer le texte des autres contributeurs, et faire l'intégration pour eux.
page principale de notre section
- introduction globale : Rob (1/2 page)
- physique:
- Introduction: Rob (ou Colin) (1/2 page)
- CMS: Colin
- particle flow: Colin (1/2 page, 1 figure)
- jet energy corrections: Viola (1/2 page, 1 figure)
- fonctionnement : Gaelle (1/2 page, 1 figure)
- Bosons de Higgs additionnels: Colin
- H->gamma gamma: Suzanne (1/2 page, 1 figure)
- H->tau tau: Colin (1/2 page, 1 figure)
- top: Stéphane, Rob, Viola (1/2 page, 1 figure)
- Caractérisation du boson de Higgs: Maxime
- HH: Maxime (1/2 page, 1 figure)
- ttH: Nicolas (1/4 page, 1 figure)
- Vector-like quarks: Steph (1/2 page, 1 figure)
- upgrade:
- introduction: Maxime (1/2 page, éventuellement 1 figure physique)
- upgrade tracker: Seb / Nicolas (endcaps, concentrateur, déclenchement, 3 pages, 3 figures)
- upgrade mu-RPC: Imad (1 page, 3 figures)
Merci de vous tenir à la limite indiquée ci-dessus. 1 page correspond à environ 500 mots. Vous pouvez compter le nombre de mots d'un fichier en faisant:
wc upgrade_tracker.md
> 14 1801 12712 upgrade_tracker.md
Ce fichier fait donc 1801 mots pour l'instant, ce qui est presque bon (en effet, ce projet contient 3 sous-projets, et doit donc être décrit en moins de 1500 caractères).
Par exemple, la question de Higgs additionels et la nécessité de mesurer précisément les couplages de Yukawa ou lambda seront abordées dans la section d'introduction générale.
Mettez vos figures dans un sous-répertoire du répertoire Figures. Pour insérer une figure, faire:
*Fig 3: Vue d'un Dee (chaque disque est composé de quatre Dees)*
Les références sont directement insérées comme un lien vers un document public, comme par exemple l'article sur la reconstruction du flux de particules dans CMS.
Utilisez toujours votre spell-checker avant de partager vos documents
Elles n'ont sans doute pas lieu d'être dans un tel document. Si vous ne pouvez absolument pas faire sans, mettez votre formule en texte verbatim comme cela:
\eta = -{\rm log} ({\rm tan} \frac{\theta}{2})
Je ne sais pas encore comment faire, mais je sais qu'il existe des plugins pour interpréter une formule latex en markdown.
Les sections suivantes ne s'adressent qu'aux personnes devant utiliser Git. Les autres peuvent simplement prendre contact avec leur responsable de section pour leur donner leur texte et leur figure.
Il vous faut:
- installer git
- des connaissances basiques sur Git. Si ce n'est pas le cas suivez ce guide très simple et demandez de l'aide à Colin si besoin est.
À ne faire qu'une fois
- Allez sur mon repo github (cette page)
- Cliquez sur Clone or Download en haut à droite
- Copiez l'adresse https et tapez ceci dans la ligne de commande:
git clone <adresse>
cd rapport_activite_ipnl
Ceci clone ma version du repository, et vous obtenez un repo local qui vous appartient.
Le clonage initialise le repo local automatiquement, et vous n'avez donc pas à taper git init comme vous avez pu le voir dans le guide donné ci-dessus.
Créez un fichier vide
touch higgs_gamma_gamma.md
et ouvrez le dans votre éditeur.
écrivez quelques lignes, et committez dans votre repo local:
git commit -am 'initial version of the higgs to gamma gamma section'
Votre commit a été enregistré dans votre repo local, mais n'a pas encore été partagé avec nous. Pour l'instant, vos modifications restent donc privées.
Vous pouvez voir les commits dans votre repo comme cela:
git log
>
commit 9f371d7bd606659a56ecbaceeed9339de8a908cb
Author: Colin <[email protected]>
Date: Mon Jun 25 15:22:54 2018 +0200
first explanations
commit c58ffcf1b752c0b316c3b2b98a618d34b24aa156
Author: Colin Bernet <[email protected]>
Date: Mon Jun 25 14:59:19 2018 +0200
Initial commit
Maintenant, sélectionnez un commit id (le long nombre hexadécimal) de l'un des commits, ou au moins une partie au début de ce nombre, puis faites:
git show 9f371d7b
Committez souvent! Personnellement, je commite après avoir avancé dans mon plan détaillé, puis après chaque paragraphe.
Après avoir committé dans votre repo local, celui-ci contient des commits que vous souhaitez partager avec mon repo github.
Pour cela, la procédure est la suivante, nous allons couvrir tous les points en détail par la suite, et vous pouvez trouver plus d'infos ici.
- recupérer les dernier commits de mon repo github (ces commits ont pu être rajoutés par d'autres personnes)
- poussez votre branche master sur votre repo github
- faire une pull request de votre repo vers mon repo pour me transférer vos changements.
À ne faire qu'une fois
Pour l'instant, vous avez directement créé votre repo local sur votre ordinateur à partir de mon repo sur github. Nous allons maintenant créer votre propre repo github et le connecter à votre repo local.
Liens entre les repos git. Ce qui se trouve dans la bulle est sur github. Votre repo local est sur votre ordinateur. Pour l'instant, vous vous êtes contentés de cloner mon repo github pour créer votre repo local.
- allez sur mon repo github
- cliquez sur Fork tout en haut a droite. Cela crée votre repo github, et vous redirige dessus
- cliquez sur Clone or Download en haut à droite, et copiez le lien https vers votre repo.
- allez dans votre répertoire de travail, et faites:
git remote add my-repo <lien_https>
Vous pouvez obtenir la liste des repos remote (c'est à dire ceux qui sont connectés à voter repo local) en faisant:
git remote -v
Vous devriez voir le mien et le vôtre.
- récupérer ces commits depuis mon repo
git fetch origin
- mélangez ces modifications à votre version locale:
git merge origin/master
- assurez-vous que le texte est ok
- poussez vos commits vers votre repo github:
git push my-repo master
- allez sur votre repo github grâce à votre navigateur, et faites une pull request vers mon repo github. Les informations pour cela devraient vous être données automatiquement sur la page de votre repo.