Le premier intérêt de GIT, c'est d'abord un moyen de maîtriser le versioning chez soi. Pour les intégrateurs yacsiens, GIT permet ainsi de maintenir facilement des "forks" de Yacs, en production chez vos clients.
En effet un upgrade de Yacs écrase les modifications sur les sources. Nous verrons comment avec GIT reporter automatiquement nos modifications dans une nouvelle version des scripts de Yacs.
GIT se prononce "guitte".
Wikipédia :
" Le magazine PC World nous apprend que « quand on lui a demandé pourquoi il avait appelé son logiciel "git", qui est à peu près l'équivalent de « connard » en argot anglais, Linus Torvalds a répondu « Je ne suis qu'un égocentrique, donc j'appelle tous mes projets d'après ma propre personne. D'abord Linux, puis Git. » " "
Pré-requis
Il faut bien sûr avoir GIT installé sur votre machine. J'ai réalisé ce tutoriel sous Linux Mint ; GIT fait partie des dépôts classiques. Sous Linux, GIT se pilote principalement en ligne de commande.
Il faut configurer quelques options générales pour GIT, en commençant par
vous identifier. Ceci ajoutera votre nom à chaque commit, et sera bien utile dans le cas de développement à plusieurs.Il existe bien
d'autres configurations, je conseille la coloration (en ajoutant --global pour ne pas le refaire dans chaque répertoire de travail).GIT bases
Initializing working directory
GIT se déclenche au niveau d'un répertoire, pour tous les sous répertoires et fichiers contenus. C'est archi-simple : créer ou aller dans un répertoire de travail, ouvrir un terminal dedans et faire : [style=terminal]$ git init[/style] Réponse : [style=terminal] Initialized empty Git repository in /home/.../yourfolder/.git/[/style] GIT a créé un répertoire caché [i].git[/i] à la racine du répertoire de travail, et stockera ses données dedans. Aucun autre fichier n'est placé ailleurs.Adding Files
Si votre répertoire est vide, il faut créer ou copier des fichiers dedans. Faites cela avec votre moyen préféré. Pour l'exemple, j'ajoute ici un fichier testgit.html :testgit.html
page de test html testgit.html<html>
<head>
<title>Test pour GIT</title>
</head>
<body>
<h1>/(bb|[^b]{2})/</h1> <div>
<span>.-"""-.</span><span>/ _ _ \</span>
<span>?? ](_' `_)[ ??</span><span>`-. N ,-'</span>
<span>|===|</span><span>`---'</span>
</div>
</body>
</html><
Maintenant, toujours dans notre terminal, faisons juste pour voir : [style=terminal]$ git status[/style] Réponse : [style=terminal]# On branch master
#
# Initial commit
#
# Untracked files:
# (use "git add filename..." to include in what will be committed)
#
# testgit.html
nothing added to commit but untracked files present (use "git add" to track)[/style]
Git nous dit qu'un fichier est présent mais non indexé. [style=terminal]$ git add testgit.html
$ git status[/style] le nouveau fichier est maintenant suivi. il ne reste qu'a commiter. On peut ajouter tous les fichiers du répertoire avec "git add *"
Commit Changes
[style=terminal]$ git commit -m "ajout fichier testgit.html"[/style] tout commit doit être accompagné d'un message. l'option -m permet de fournir le message en ligne de commande. Sinon GIT ouvre un éditeur pour faire cette saisie (vim). Vous trouverez un tuturiel vidéo plus détaillé pour cette partie.
Branching
Maintenant nous allons faire de nouvelles modifications, mais dans une branche. Il est extrêmement facile avec GIT de créer une branche, puis de fusionner ses développements plus tard avec une autre branche. Aussi il ne faut pas hésiter à créer de multiples branches pour vos développements. On crée une branche ainsi : [style=terminal]$ git branch experience[/style] avec ici "experience", le nom de la branche. Vous pouvez visualiser les branches existantes ainsi : [style=terminal]$ git branch[/style] La branche avec une étoile est la branche active. La branche créée par défaut s'appelle master. On change de branche active ainsi : [style=terminal]$ git checkout experience[/style] Refaire [i]git branch[/i] pour voir. Au niveau des fichiers, rien ne s'est encore passé.Maintenant, faisons de nouvelles modifications, et même, ajoutons un fichier.
modifs sur testgit.html et ajout style.css
Un petit commit :
[style=terminal]$ git add style.css<html>
<head>
<title>Test pour GIT</title>
<link rel="stylesheet" type="text/css" href="style.css" media="all" />
</head>
<body>
<h1>/(bb|[^b]{2})/</h1> <div>
<span>.-"""-.</span><span>/ _ _ \</span>
<span>?? ](_' `_)[ ??</span><span>`-. N ,-'</span>
<span>|===|</span><span>`---'</span>
</div>
</body>
</html>
h1 {
text-align : center;
color : firebrick;
}
div {
margin : 40px
}
div span {
display : block;
text-align : center;
font-family : monospace;
}
$ git commit -a -m "adding a style sheet"[/style] Un [i]git status[/i] doit donner "working directory clean". [*] Visualiser votre page dans un navigateur et retournons sur la branche master : [style=terminal]$ git checkout master[/style] [*] Recharger la page dans votre navigateur... Surprise ?
[*] Regardez vos fichiers : le nouveau fichier a disparu, et le contenu de l'autre est revenu à l'état initial. [*] Retournez sur la branche experience (git branch experience) : les modifications réapparaissent.
En fonction de la branche active, GIT change dynamiquement le contenu de votre répertoire de travail.
Merging
Faisons d'abord des nouvelles modifications sur la branche master [style=terminal]$ git checkout master[/style]modifs sur test.html
et commitez-les :
[style=terminal]git commit -a -m "doctype declarations")[/style]<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Test pour GIT</title>
</head>
<body>
<h1>/(bb|[^b]{2})/</h1> <div>
<span>.-"""-.</span><span>/ _ _ \</span>
<span>?? ](_' `_)[ ??</span><span>`-. N ,-'</span>
<span>|===|</span><span>`---'</span>
</div>
</body>
</html>
Chaque branche contient maintenant des modifications uniques.
[*] Fusionnons experience dans master : [style=terminal]$ git merge experience[/style] [*]Contrôlez le résultat en rechargeant la page. [*]Dans le terminal, tapez "gitk" pour avoir un aperçu graphique de vos opérations.
Merging conflict
Bien sûr parfois GIT ne peut se dépatouiller tout seul avec des modifications contradictoires. Dans ce cas il signale un conflit et place un marquage spécial à l'intérieur du fichier. A vous de résoudre le conflit en éditant le fichier. Plusieurs commandes peuvent vous aider à visualiser les différences entre les versions. Voici un tutoriel branching & merging pour plus de détails (vidéo en fin de page)Voir aussi plus bas pour la résolution d'un conflit.
Upgrading a fork
Dans le cadre de cet exemple, supposons un projet démarré en Yacs, sur lequels vous avez dû effectuer quelques modifications dans les sources pour répondre à votre client. Une nouvelle version de yacs est sortie et vous souhaitez migrer. La mise à jour du serveur entraîne l'écrasement des fichiers et donc la perte de vos modifications. Il faut donc avoir consciencieusement noté chaque modification, et les reporter à la main dans les nouvelles versions des scripts, puis les uploader sur votre serveur après sa mise à jour. Cela peut être fastidieux...La méthode ci-dessous permet d'automatiser l'intégration de vos modifications dans les nouveaux scripts de Yacs.
Indexing a Yacs serveur
Dans un répertoire, placer les scripts d'un serveur Yacs. Pour cet exemple je me limite à quelques fichiers. C'est du vécu : ajouter aux catégories l'option de listage des utilisateurs par ordre alphabétique. Je pars d'une 9.11. On va migrer ensuite vers 10.5. Je donne les fichiers de chaque version en zip ici pour refaire les tests chez vous. [*]categories/view.php [*]shared/members.phpFichiers provennant de yacs9.11
indexez les fichiers [style=terminal]$ git add *[/style] puis commitez [style=terminal]$ git commit[/style] Vous pouvez étiqueter cet état de la branche avec le numéro de version [style=terminal]$ git tag v9.11[/style]
Branching to customize
[*]Créer une nouvelle branche pour votre projet spécifique [style=terminal]$ git branch MyClient$ git checkout MyClient[/style] [*]Modifiez les fichiers pour appliquer vos modifications (en un ou plusieurs commits) en l'occurence : dans shared/members.php, insertion d'une nouvelle fonction après la fonction list_users_by_post_for_anchor (L994)
listage des utilisateurs par nom
[*]Dans categorie/view.php, à la L789, changer :
/**
* list alphabetically users assigned to an anchor
*
* Only users matching following criteria are returned:
* - user is visible (active='Y')
* - user is restricted (active='R'), but surfer is a logged user
* - user is restricted (active='N'), but surfer is an associate
*
* @param the target anchor
* @param int the offset from the start of the list; usually, 0 or 1
* @param int the number of items to display
* @param string the list variant, if any
* @param string an id to avoid, if any
* @return NULL on error, else an ordered array with $url => ($prefix, $label, $suffix, $icon)
*
* @see categories/view.php
*/
function &list_users_by_names_for_anchor($anchor, $offset=0, $count=10, $variant=NULL, $to_avoid=NULL) {
global $context;
// locate where we are
if(!$variant)
$variant = $anchor;
// limit the scope of the request
$where = "users.active='Y'";
if(Surfer::is_logged())
$where .= " OR users.active='R'";
if(Surfer::is_associate())
$where .= " OR users.active='N'";
$where = '('.$where.')';
// avoid this one
if($to_avoid)
$where .= " AND (users.id != '".SQL::escape($to_avoid)."')";
// the list of users
$query = "SELECT users.* FROM ".SQL::table_name('members')." AS members"
.", ".SQL::table_name('users')." AS users"
." WHERE (members.anchor LIKE '".SQL::escape($anchor)."')"
." AND (members.member_type LIKE 'user')"
." AND (users.id = members.member_id)"
." AND ".$where
." ORDER BY users.full_name, users.nick_name LIMIT ".$offset.','.$count;
// use existing listing facility
$output =& Users::list_selected(SQL::query($query), $variant);
return $output;
}
implémentation option users_by_name
[*]Commitez :
[style=terminal]git commit -a -m "added alpha order option for listing users on catergories"[/style]// list items by date (default) or by title (option 'users_by_title')
$offset = ($zoom_index - 1) * USERS_LIST_SIZE;
$items =& Members::list_users_by_posts_for_anchor('category:'.$item['id'], $offset, USERS_LIST_SIZE, 'watch');
// list items by date (default) or by name (option 'users_by_name')
$offset = ($zoom_index - 1) * USERS_LIST_SIZE;
if(preg_match('/\busers_by_name\b/i', $item['options']))
$items =& Members::list_users_by_names_for_anchor('category:'.$item['id'], $offset, USERS_LIST_SIZE, 'watch');
else
$items =& Members::list_users_by_posts_for_anchor('category:'.$item['id'], $offset, USERS_LIST_SIZE, 'watch');
Vous avez donc : [*]une branche master, qui contient les scripts originaux de yacs. [*]une branche MyClient, avec vos modifications spécifiques.
Vous pouvez créer autant de branches "client" à partir de master, et les compléter à mesure des évolutions de chaque projet, en activant la branche appropriée. Un seul répertoire contient tous vos serveurs !
Vous pouvez copier votre répertoire de travail, toutes les informations de GIT seront également dupliquées puisqu'elles sont dans le répertoire .git, et pourront êtres manipulées de manière distincte de l'original.
Un intérêt est de placer votre répertoire de travail pour le faire également tourner sous XAMPP par exemple. Dans ce cas vous pouvez avoir besoin d'éliminer certains fichiers de l'indexation GIT, moyennant la déclaration d'un fichier [i].gitignore[/i].
Rebasing to upgrade
Une nouvelle version de Yacs est dispo ! [*]Commençons par mettre à jour la branche master : fichiers de 10.5 fichiers provenant de yacs 10.5 [style=terminal]$ git checkout master[/style] supprimez tout le contenu, puis copiez dedans l'intégralité de la nouvelle archive. Commitez... votre branche master est à jour ; une mise à jour par écrasement ne permet pas de supprimer les fichiers obsolètes - pas dans cet exemple bien sûr.[*] Maintenant il faut upgrader la branche MyClient. Nous voulons en fait reporter les modifications spécifiques sur les nouveaux scripts. C'est exactement ce que fait la commande "rebase" : elle initialise la branche selon la branche modèle, et applique les modifications dessus comme si c'était des patchs. C'est différent du merge, pas du point de vue du résultat produit sur le code, mais plutôt dans l'ordre dans lesquels les commits sont archivés.
[style=terminal]$ git checkout MyClient
$ git rebase master[/style]
Tout se passe bien pour shared/members.php, mais nous avons un conflit sur categories/view.php.
[style=terminal]First, rewinding head to replay your work on top of it...
Applying: added alpha order option for listing users on catergories
error: patch failed: categories/view.php:786
error: categories/view.php: patch does not apply
Using index info to reconstruct a base tree...
Falling back to patching base and 3-way merge...
Auto-merging categories/view.php
CONFLICT (content): Merge conflict in categories/view.php
Auto-merging shared/members.php
Failed to merge in the changes.
Patch failed at 0001 added alpha order option for listing users on categories
When you have resolved this problem run "git rebase --continue".
If you would prefer to skip this patch, instead run "git rebase --skip".
To restore the original branch and stop rebasing run "git rebase --abort".
[/style]
[*]Éditez le fichier en conflit. Rechercher "=====" pour tomber sur les marqueurs spéciaux de ligne en conflit. Nous voyons ceci :
conflict in view.php
d'abord GIT affiche la version d'origine, ici celle de la branche master, et sous les ==== le patch qu'il tentait d'appliquer (avec à la fin l'intitulé du message qui accompagnait le commit en question. Cela n'a pas marché car entre 9.11 et 10.5, les catégories ont gagné la capacité d'offrir le choix du layout utilisateur : au lieu d'imposer un layout en dur (watch), cela passe par une variable $layout. Il faut donc remplacer nos 'watch' par $layout. On efface ensuite ce qui est inutile (l'ancienne version, et les marqueurs)<<<<<<< HEAD:categories/view.php
$items =& Members::list_users_by_posts_for_anchor('category:'.$item['id'], $offset, USERS_LIST_SIZE, $layout);===
if(preg_match('/\busers_by_name\b/i', $item['options']))
$items =& Members::list_users_by_names_for_anchor('category:'.$item['id'], $offset, USERS_LIST_SIZE, 'watch');
else
$items =& Members::list_users_by_posts_for_anchor('category:'.$item['id'], $offset, USERS_LIST_SIZE, 'watch');
>>>>>>> added alpha order option for listing users on catergories:categories/view.php
[*]Maintenant pousuivons : [style=terminal]$ git add categories/view.php
$ git rebase --continue[/style]
Une fois cette opération terminée, la branche MyClient contient vos modifications appliquées sur la nouvelle version de Yacs. Vous pouvez mettre à jour votre serveur distant avec l'archive standard puis uploader les fichiers modifiés depuis votre répertoire de travail.
une solution encore plus propre serait de construire une archive de mise à jour spécifique à partir du script build.php de Yacs, mais cela c'est un autre tutoriel !
Conclusion
GIT rend déjà beaucoup de services "à la maison" avec un système de versioning très puissant et pourtant simple d'apparence. Ce tutoriel en donne un aperçu. Bien sûr il y aurait des cas particuliers. Que se passe-t-il par exemple si on ne souhaite plus reporter une modification ? Afin de pouvoir isoler vos modifications, il est plus sage de les indexer via des commits distincts. GIT permet ensuite d'annuler un commit précis.
Autres tutos :
Git dans une coquille de noix git readycomparaison GIT avec d'autres [i]subversion systems[/i]
Why git is better than X| Hosea |  on Nov. 25 2022 at 11:25 pm GMT |
| Terrence | on Oct. 6 2022 at 12:09 pm GMT |
| Patty | on Oct. 5 2022 at 11:40 pm GMT |
| Calvin | on Oct. 4 2022 at 01:27 am GMT |
| Emery | on Oct. 3 2022 at 11:49 pm GMT |
| Linnea | on Oct. 3 2022 at 10:52 pm GMT |
| Joanne | on Oct. 3 2022 at 05:26 am GMT |
| Porfirio | on Oct. 2 2022 at 10:43 pm GMT |
| Willard | on Oct. 1 2022 at 09:27 pm GMT |
| Belen | on Jul. 29 2022 at 03:29 pm GMT
|
| Enriqueta | on June 5 2022 at 12:27 pm GMT |
| Brandy | on Feb. 19 2022 at 04:12 pm GMT
|
| Lynette | on Feb. 8 2022 at 04:14 pm GMT |
| Victor | on Feb. 5 2022 at 11:08 pm GMT After that, you can make a bet online, even if you are on a train or on the shores of a lake. We recommend downloading the mobile application so that you can begin betting on games and in casinos. 1xbet can be found on a variety of smartphones and Android and IOS devices. You can access the program via tablets, smartphones, and Android TV Box. You can also get an additional bonus if you copy the code and enter it at the time of registering. for the computer 1xs _ 10220, for the mobile device 1xs _ 10221 1xbetbonuses.Com Download mobile bonus - 1xbetbonuses.com, |
| Dorthea | on Nov. 12 2021 at 08:37 pm GMT
|
| Celina | on Nov. 10 2021 at 08:06 pm GMT |
| Zane | on Oct. 19 2021 at 11:49 pm GMT |
| Lenore | on Oct. 18 2021 at 11:22 pm GMT |
| Diana | on Sep. 28 2021 at 09:05 pm GMT |
| Phoebe | on Sep. 28 2021 at 01:29 am GMT |
| Christine | on Sep. 26 2021 at 09:04 pm GMT |
| Emory | on Aug. 2 2021 at 04:15 pm GMT Totally free hookup girls wiki hookups online is the solution if you're tired with planning to pubs and organizations simply to be ignored, as well as more serious, laughed at. I am aware what it's like because I've been there. I had been individual and distressed back into the day -- I required a whole new spouse -- however i continued striving because I needed not any other choice. If you're a single guy who wants to hookup with attractive girls without planning to those locations in which the ladies are on your own, this report might just alter your lifestyle. It will explain why dating on-line is the perfect option if you're a masculine that is shy to method a wonderful female in a pub or club. |
| Merrill | on Jul. 24 2021 at 06:31 am GMT |
| Terrell | on June 19 2021 at 05:02 am GMT |
| Nola | on June 8 2021 at 07:59 pm GMT |
| Ricky | on June 2 2021 at 10:22 pm GMT |
| Levi | on June 2 2021 at 10:05 pm GMT |
| Karin | on June 2 2021 at 09:54 pm GMT |
| Geraldine | on June 2 2021 at 09:16 pm GMT |
| Kristian | on June 2 2021 at 09:02 pm GMT |
| Anitra | on June 2 2021 at 05:24 pm GMT |
| Andrea | on May 29 2021 at 08:25 am GMT Free of charge hookup females chat hookups online is the perfect solution if you're sick and tired of planning to bars and organizations only to be prevented, or perhaps even worse, laughed at. I know what it's like because I've been there. I found myself single and desperate during the day time -- I essential a whole new spouse -- however i continued striving because I needed not any other choice. If you're one particular guy who wishes to hookup with hot ladies without going to those spots in which the ladies are alone, this article may just alter your existence. It can make clear why internet dating online is the perfect substitute if you're a men who is too shy to strategy a wonderful female inside a bar or club. |
| Patty | on May 12 2021 at 10:45 am GMT |
| Maryanne | on May 6 2021 at 12:40 am GMT Do you know how to make your site mobile friendly? My web site looks weird when browsing from my iphone. I'm trying to find a theme or plugin that might be able to resolve this issue. If you have any suggestions, please share. Appreciate it! |
| Tracy | on May 1 2021 at 07:41 am GMT |
| Nicole | on May 1 2021 at 03:11 am GMT
|
| dgfdbgfbt | on Apr. 30 2021 at 07:49 am GMT |
| Jenifer | on Apr. 28 2021 at 09:44 pm GMT |
| Rene | on Mar. 16 2021 at 08:07 am GMT Cost-free hookup girls see page online is the solution if you're fed up with likely to cafes and organizations only to be prevented, and even even worse, laughed at. I am aware what it's like because I've been there. I had been solitary and desperate in the working day -- I necessary a fresh lover -- but I continued trying because I had hardly any other option. If you're just one person who wants to hookup with alluring women without planning to those spots where ladies are alone, than the article might just make positive changes to daily life. It is going to clarify why internet dating on the web is the greatest choice if you're a male who seems to be too shy to strategy a beautiful girl inside a bar or club. |
| Carroll | on Mar. 11 2021 at 12:37 am GMT
|
| Ian | on Mar. 10 2021 at 06:45 pm GMT |
| Werner | on Mar. 8 2021 at 06:27 pm GMT |
| Cheryle | on Mar. 8 2021 at 01:08 am GMT |
| Malinda | on Mar. 7 2021 at 01:31 am GMT |
| Diane | on Feb. 25 2021 at 05:53 pm GMT |
| Misty | on Feb. 25 2021 at 04:49 pm GMT |
| Isobel | on Feb. 24 2021 at 11:22 pm GMT |
| Jonathan | on Feb. 23 2021 at 05:20 am GMT |
| Charles | on Feb. 14 2021 at 01:00 am GMT
|
| Mathew | on Feb. 13 2021 at 04:34 am GMT |
