L'icône rouge permet de télécharger chaque page du wiki visitée au format PDF et la grise au format ODT →

Différences

Ci-dessous, les différences entre deux révisions de la page.

--- atelier:git-df:gitea [05/08/2019 07:36]
bendia [Profils et réglages]
+++ atelier:git-df:gitea [03/07/2020 19:41] (Version actuelle)
bendia [Les tickets] Ajout des mentions/fermetures depuis les commit
@@ Ligne 2: / Ligne 2: @@
   * Objet : Utilisation de Gitea pour les membres DF
-  * Niveau requis : {{tag>débutant}}
+  * Niveau requis : {{tag>débutant avisé}}
-  * Commentaires : Pour une utilisation basique de Gitea hébergé sur DF.
+  * Commentaires : Pour une utilisation basique de Gitea hébergé sur DF. Connaître des rudiments de //Git// est nécessaire.
   * Débutant, à savoir : [[:doc:systeme:git:git|Une introduction à Git, un système de gestion de version décentralisé ]]
-  * Suivi : {{tag>en-chantier à-tester à-placer}}
+  * Suivi : {{tag>à-compléter à-tester}}
     * Création par [[user>bendia]] 04/08/2019
     * Testé par <…> le <…> FIXME
-  * Commentaires sur le forum : [[:url-invalide | Lien vers le forum concernant ce tuto]] ((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !)) FIXME
+  * Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?id=26471 | Lien vers le forum concernant ce tuto]] ((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))
 Nota :
@@ Ligne 22: / Ligne 22: @@
   * Créer et gérer un wiki, pour documenter le code ou l'utilisation du logiciel par exemple
-Ce tuto n'a pas pour objectif d'expliquer l'utilisation de git, il existe pour cela de nombreux tuto, dont un livre sous licence CC((https://git-scm.com/book/fr/v2)). Il     ne traitera également pas de toutes les possibilités offertes par Gitea. FIXME SI certains veulent s'y lancer, pourquoi pas des tutos spécifiques pour des fonctions précises (genre les PR, qui doivent s’appeler //Demande d'ajout// ?
+Ce tuto n'a pas pour objectif d'expliquer l'utilisation de git, il existe pour cela de nombreux tuto, dont un livre sous licence CC((https://git-scm.com/book/fr/v2)). Il     ne traitera également pas de toutes les possibilités offertes par Gitea. FIXME SI certains veulent s'y lancer, pourquoi pas des tutos spécifiques pour des fonctions précises (genre les //hook// ?)
 ===== Le tableau de bord =====
@@ Ligne 72: / Ligne 72: @@
 {{ /file-R803e555615ac05130efda564c43668cd.png }}
-On peut copier directement l'adresse (ssh ou http) permettant de cloner le dépôt en haut à droite. On peut également télécharger ces fichiers dans une archive.
+  * {{/file-R4494b133e2dff4b39601c7a571418b48.png}} copier directement l'adresse (ssh ou http) permettant de cloner le dépôt
+  * {{/file-R49a9c43de3f81465e767e897a070a39d.png}} télécharger ces fichiers dans une archive.
+=== Sujets ===
+{{/file-R49a9c43de3f81465e767e897a070a39d.png}} Les sujets, sont des //tags// qu'on peut appliquer au dépôts, et qui permettrons de lister tous les dépôts ayant un même sujet dans l'explorateur. Par exemple, si on donne le langage dans lequel est codé l'application, on pourra lister tous les dépôts publics codés dans ce même langage.
 === Paramètres ===
-Le bouton //Paramètres// permet notamment d'activer ou désactiver le gestionnaire de ticket, le wiki, de modifier la visibilité du dépôt (publique/privé), d'ajouter des collaborateurs, de changer le propriétaire, de l'archiver ou le supprimer.
+{{/file-Ra297b12afff6e4cb6c7e08ae57f7cdc5.png}} permet notamment d'activer ou désactiver le gestionnaire de ticket, le wiki, de modifier la visibilité du dépôt (publique/privé), d'ajouter des collaborateurs, de changer le propriétaire, de l'archiver ou le supprimer.
 === Modifications de fichiers via l'interface web ===
-Il est possible d'éditer les fichiers présents avec le bouton d'édition, de créer un nouveau fichier, ou de téléverser des fichiers depuis sa machine. Ces actions donnerons lieu à des nouveaux //commits//.
+  * {{/file-R3548994fa0de58904abf8742aa1d48c3.png}} créer un nouveau fichier vide, ou de téléverser des fichiers
+  * Cliquez sur le nom d'un fichier l'affiche, il est alors modifiable directement en ligne avec le bouton {{/file-R914b6ff55e059e9e23759dc0b6bbcadb.png}}.
+Ces actions donnerons lieu à des nouveaux //commits//.
 ===== Les organisations =====
+Il s'agit d'un regroupement d'utilisateurs qui s'organise en équipe. Cela permet de gérer plus finement les droits sur chaque dépôt appartenant à //l'organisation// qu'un simple dépôt personnel collaboratif.
+{{/file-Re8dcc1640a4d52611b7bf76ac3f3b01f.png}} ou le bouton <key>+</key> du cadre //Organisation// pour créer une nouvelle //Organisation//.
+On se retrouve alors sur le tableau de bord de l'organisation. On peut alors créer des dépôts qui appartiendrons à l'organisation de la même manière que pour un utilisateur.
+{{/file-R6c218fffc8698d3e26c6ee3d80bbfd9e.png}} pour accéder à la page de l'organisation.
 ==== Les équipes ====
+{{ /file-Rf3ac3d2524984ce6e9065aced85dfda3.png?600  }}
+L'équipe //Owners// est automatiquement créée avec le créateur de l'organisation comme membre. Les membres de cette équipes ont tous les droits sur tous les dépôts appartenant à l'organisation. Ce sont les administrateurs de l'organisation.
+On peut ajouter de nouveaux membres à une équipe en cliquant sur son nom
+{{/file-R42ffd550012f9cf06177cf27200a29bc.png}} pour créer une nouvelle équipe.
+{{ /file-Re9eac9114bb9900511645cf11133b2b1.png?600 }}
+On peut alors ajouter des membres à l'équipe, et des dépôts sur lesquelles cette équipe aura des droits.
+<note important>Ne pas oublier cette dernière étape, sinon, l'équipe ne peut rien faire :-P</note>
 ==== Les droits ====
+{{ /file-Rf0b8be29053a49647ffecd3193728daa.png?600 }}
+Lors de la création d'une équipe, il faudra gérer les droits.
+  * //Accès en lecture// est utile pour donner un accès en lecture seule aux dépôts privés
+  * //Accès en écriture// se règle finement pour donner ces droits sur les différentes fonctions de //Gitea//, gestionnaire de ticket, wiki ... De cette façon, on peut par exemple créer une équipe capable de trier les tickets et maintenir le wiki, mais pas de pousser du code sur la branche.
+  * //Accès Administrateur// sans commentaires, c'est bien expliqué.
+===== Les tickets =====
+Le système de tickets s'apparente à un forum spécifique à chaque dépôt ayant pour but notamment de signaler des bugs, proposer des améliorations. Il se traduira donc souvent en tâches à effectuer. Plusieurs mécanismes permettent d'organiser ces tâches, comme les //étiquettes//, les //jalons//, la gestion des tickets qui en dépendent ou l'attribution des tickets.
+=== Les étiquettes ===
+Ces étiquettes vont permettre de classer les tickets par thème. Sur un nouveau dépôt, il faut créer les étiquettes. On peut générer un jeu d'étiquettes par défaut  avec ''Utiliser le jeu de label''.
+<note tip>Pour les administrateurs du serveur, on peu ajouter des jeux d'étiquettes dans ''custom/options/label'' qui respecte le format ''#hex-color label name ; label description'' :-)</note>
+{{ /file-R07f4b921f1e6c375b7a12222063c2966.png?600 }}
+Pour ceux qui en on les droits, on peut ensuite directement ajouter une étiquette lors de la création du ticket, ou une fois le ticket créé (même, par une autre utilisateur).
+Lorsqu'une tâche est terminée, il est possible de la fermer.
+On peut effectuer des recherches à partir de ces différents mécanismes pour trier les tickets, et ainsi déterminer l'ordre dans lequel effectuer ces tâches dans la liste des tickets en utilisant le menu déroulant de chaque colone.
+=== Les jalons ===
+Les jalons vont permettre de trier les tickets par objectifs. Par exemple, dse ticket d'amélioration qu'on souhaite voir faire partie de la version //Tartempion// de notre logiciel pourront recevoir le jalon ''Tartempion''. On peut donner des //Échéances// (date butoirs) aux //Jalons//.
+=== Affection ===
+Afin de savoir qui travaille sur un ticket, il est possible de les affecter à un ou plusieurs membres.
+=== Dépendance ===
+La réalisation d'une tâche peut dépendre de la réalisation d'une autre. On peut définir que le ticket actuel dépend d'un (ou plusieurs autres)
+Lorsqu'une tâche est terminée, il est possible de la fermer.
+On peut effectuer des recherches à partir de ces différents mécanismes pour trier les tickets, et ainsi déterminer l'ordre dans lequel effectuer ces tâches.
+=== Mention fermeture depuis un message de commit ===
+On peut mentionner et même fermer un ticket depuis un message de commit, il suffit de mettre son numéro précédé de ''#'' pour le mentionner, et ''close #numéro'' pour le fermer.
+<note tip>Pour ceux qui en ont les droits, toutes les affectations, étiquetage, jalonage peuvent s'effectuer soit sur le ticket lui-même, soit depuis la liste des tickets en utilisant la case à cocher</note>
+===== Le wiki =====
+On peut créer des pages au format Markdown. Il existe cependant un éditeur qui va générer les balises. Ce wiki est en lui même un dépôt git, et on peut donc parfaitement l'écrire en local sur sa machine.
+<note tip>Si une page est nommée ''Ma page'', l'URL générée est le nom de la page avec les espaces remplacés par des tiret ''-'' dans ''wiki''. C'est assez pratique pour générer des liens entre page du wiki, puisqu’un simple lien relatif suffit. Ainsi, si je veux créer un lien de la page //Home// vers la page //Ma Page//, il suffit de mettre ça dans //Home// <code>[[Lien vers ma page|Ma-page]]</code></note>
+===== Les versions =====
+Une //version// est une publication du code source du logiciel sous forme d'archive (zip et tar.gz). Pour publier une version, il suffit de se rendre dans l'onglet //Version// et de cliquer sur //Nouvelle version//.
+===== Les demandes d'ajout =====
+<note warning>Cette partie va traiter d'une fonctionnalité plus fortement imbriquées avec git et les branches notamment. Il faut donc être un minimum à l'aise avec ces notions</note>
+L'intérêt des logiciels libres, c'est que tout un chacun peut obtenir et modifier le code source. Il est donc tout à fait possible de cloner un dépôt modifier le logiciel, et proposer ses modifications à son mainteneur.
+=== Bifurquer ===
+Pour cela, il va falloir créer un nouveau dépôt dont vous serez propriétaire avec {{/file-R592aa7490252d235c3a0c63007f3b3c8.png}}
+Vous pouvez ensuite cloner puis travailler sur ce dépôt et y pousser vos modifications.
+=== Demander l'ajout ===
+Lorsque vous pensez votre modification prête à être ajoutée au code principal, vous pouvez donc faire une //Demande d'ajout// (ou demande de fusion) afin que le mainteneur puisse fusionner votre travail dans le dépôt principal. Cela créé automatiquement un //ticket// dans l'onglet //Demande d'ajout//.
+De son coté, le mainteneur va recevoir une notification, et va donc pouvoir décider si ces modifications peuvent être ajouter en autorisant la fusion. Le ticket est alors automatiquement fermé.

atelier/git-df/gitea.1564983377.txt.gz · Dernière modification: 05/08/2019 07:36 par bendia

Debian-facile

Différences

Pied de page des forums