ACM et Git

Added by Vincent Danjean over 4 years ago

Bonjour,

Nous utilisons AMC dans une équipe pédagogique (4 à 6 enseignants) où nous stockons nos documents sous Git.
Est-ce qu'il y a quelque part une documentation expliquant quels sont les documents à sauver sous git et ceux qui sont auto(re)générés ?
Dans mon premier essai, je pense avoir tout mis sauf les *.aux *.log mais ce n'est pas très satisfaisant (plein de fichiers sont autogénérés et causent des conflits inutiles en cas d'édition parallèle).
Est-ce que d'autres ont déjà expérimenté cet usage ?

Cordialement,
Vincent Danjean


Replies (5)

RE: ACM et Git - Added by Jean-Marc Gervais over 4 years ago

Bonjour Vincent,

Il me semble que Projet / Exporter comme modèle est là pour sauvegarder l'essentiel. Il faut penser à inclure en plus tout élément externe comme les fichiers images si l'on en fait usage (en option, dans la fenêtre qui suit ce choix de menu). J'ai pris l'habitude d'inclure le pdf du sujet et/ou du "catalogue" pour pouvoir visualiser rapidement le rendu hors AMC. Par la suite, on peut créer un nouveau fichier à partir du modèle, donc toute info. utile doit y figurer.
À expérimenter pour (in)valider : je rappelle que je ne suis pas du tout expert à ce sujet.

Du coup, ma réponse est un peu hors-sujet, pour stocker sous dépôt Git les fichiers individuellement. Mais en farfouillant l'archive ainsi créée, ça devrait indiquer ce qui est nécessaire ou non.
Je dirais donc: le_sujet.tex, options.xml, description.xml (+ éventuelles images ou autres intégrées).

RE: ACM et Git - Added by Jean-Marc Gervais over 4 years ago

Bonjour ! Vincent, je suis bien conscient d'avoir répondu de manière bien vague, mais la question m'intéresse aussi et je suis prêt à y réfléchir un peu, au regard de ma petite expérience.

La question de départ est-elle résolue ? Sinon, davantage de précisions seront peut-être nécessaires sur les données à stocker / partager.

Si l'idée est d'utiliser une forge, un dépôt Git, y déposer le sujet .tex me semble suffisant (quand il n'y a pas d'inclusion d'élément externe comme des images, etc.) Mais ça ne permet pas de conserver les "réglages" associés, les résultats d'un groupe, etc. Est-ce ce qui est attendu ?

Cordialement.

RE: ACM et Git - Added by Vincent Danjean over 4 years ago

Mettre le sujet .tex sous git, je suis d'accord, ça ne pose aucun problème.
Mais l'idée était de partager avec git un peu plus que cela pour :
- permettre à des collègues de reprendre et continuer le QCM là où on en est (sujet distribué, copies notées, mail envoyés, ...)
- avoir des points de retours facile en cas d'erreur (mauvais fichier d'élève introduit, ...)

En pratique, AMC utilise des fichiers binaires (BdD sqlite de mémoire) qui passeront mal sous git (pas de fusion, ...)
La solution qu'on a pris pour l'instant, c'est de mettre ces fichiers binaires sous git avec le sujet et les fichiers xml, et de s'entendre entre nous pour savoir qui travaille dessus.
On espère que tous les autres fichiers sont autogénérés à partir de ceux sauvés, mais on n'en est pas certain.

Un point dommage d'AMC : on ne peut pas facilement ouvrir un projet dans le répertoire courant (auto-multilple-choice ./projet ne marche pas) :
il faut cliquer sur 'ouvrir un projet' puis 'choix du répertoire contenant les projets' (étape est potentiellement pénible) puis choisir le projet en question.
Mais ceci est orthogonal à la problématique du projet sous Git.

Merci pour les idées/conseils.
Vincent

RE: ACM et Git - Added by Alexis Bienvenüe over 4 years ago

On espère que tous les autres fichiers sont autogénérés à partir de ceux sauvés, mais on n'en est pas certain.

On peut les fabriquer en effet, mais on ne pourra pas demander à AMC de refabriquer le document sujet sans effacer la BdD layout. Donc à mon avis ça vaut le coup de mettre aussi le DOC-sujet.pdf sous git.
C'est vrai que les BdD SQLite ne sont pas vraiment adaptée à git. On pourrait imaginer la solution suivante (sans possibilité de retour en arrière par pas) :
  • on ne met sous git que les fichiers sources (après tout si on ne change pas de version d'AMC on peut tout récupérer à partir de lui et des scans)
  • les répertoires projets sont simplement synchronisés (syncthing ou similaire)

auto-multilple-choice ./projet ne marche pas

C'est plutôt auto-mutiple-choice gui --p ./projet

il faut cliquer sur 'ouvrir un projet' puis 'choix du répertoire contenant les projets' (étape est potentiellement pénible)

C'est un peu mieux fichu avec la version de développement.

RE: ACM et Git - Added by Jean-Marc Gervais over 4 years ago

OK, j'avais mal cerné les attentes, désolé (idem pour le délai de réaction !)

Malheureusement, j'ai regardé un peu (sans avoir trop de temps à y consacrer j'avoue) et je n'ai rien trouvé de probant :-( !

Cordialement.

(1-5/5)