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 [06/08/2019 15:39]
bendia [Le wiki]
+++ atelier:git-df:gitea [03/07/2020 19:41] (Version actuelle)
bendia [Les tickets] Ajout des mentions/fermetures depuis les commit
@@ Ligne 5: / Ligne 5: @@
   * 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 93: / Ligne 93: @@
 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}}.png}} ou le bouton <key>+</key> du cadre //Organisation// pour créer une nouvelle //Organisation//.
+{{/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.
@@ Ligne 158: / Ligne 158: @@
 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>
@@ Ligne 165: / Ligne 169: @@
 ===== 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
+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.1565098786.txt.gz · Dernière modification: 06/08/2019 15:39 par bendia

Debian-facile

Différences

Pied de page des forums