Différences

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

--- issue76:c_c [2014/01/19 20:35] – fredphil91
+++ issue76:c_c [2014/01/26 12:19] (Version actuelle) – andre_domenech
@@ Ligne 1: / Ligne 1: @@
+==== à relire =====
+**
 Over the last couple of issues, I asked for input from the readers on commands that they find useful, and a short description of what they do. Now, I have nearly three A4 pages of commands in the Google Doc I created for this. To anyone who contributed – thank you! There were a surprising number of commands (or variations) that I hadn't ever come across before. If anyone would like recognition on the title page of the PDF, you can either email me at lswest34+cli-cookbook@gmail.com, or open an issue on the GitHub (or just fork the repository!). For the actual article this month, I will briefly explain how to set up and use LaTeX on Ubuntu, for anyone who wishes to contribute to the PDF (using LaTeX), but isn't yet comfortable with LaTeX.
+**
+Au cours des deux derniers numéros, j'ai demandé aux lecteurs de partager les commandes qu'ils trouvent utiles et une brève description de ce qu'elles font. Maintenant, j'ai presque trois pages A4 de commandes dans le document Google Doc que j'ai créé pour cela. À tous ceux qui ont contribué  : merci ! Il y a un nombre surprenant de commandes (ou variantes) que je n'avais jamais rencontrées auparavant. Si vous souhaitez être désigné sur la page de titre du fichier PDF, vous pouvez m'envoyer un e-mail à lswest34+cli-cookbook@gmail.com, ou ouvrir une discussion sur GitHub (ou simplement dupliquer le référentiel). Pour l'article de ce mois-ci, j'expliquerai brièvement comment configurer et utiliser LaTeX sous Ubuntu, pour toute personne qui souhaite contribuer au PDF (à l'aide de LaTeX), mais qui n'est pas encore à l'aise avec LaTeX.
+**
 First off, the Cookbook is now located on GitHub, here: https://github.com/lswest/cli-cookbook
 It's a public repository, so anyone who wants to contribute needs only to fork the repository, make those changes, and then send me a pull request. I will reserve the right to veto the inclusion of any commands if they seem to me to be either unnecessary duplicates of existing commands, or else are purely malicious (by this I mean commands that will result in loss of data, without any feasible security usage). For those of you not comfortable with git (or LaTeX), and without the inclination to learn, you can suggest changes and updates using the issue tracker on the repository.
+**
+Tout d'abord, le manuel se trouve maintenant sur GitHub, ici : https://github.com/lswest/cli-cookbook
+C'est un dépôt public, donc quiconque veut contribuer a seulement besoin de dupliquer le référentiel, d'apporter ses modifications et de m'envoyer alors une demande de mise en ligne. Je me réserve le droit de veto sur l'inclusion de toute commande si elle me semble être un doublon inutile de commandes existantes, ou bien est purement malveillante (j'entends par là des commandes qui se traduiraient par la perte de données, sans aucune sécurité). Pour ceux d'entre vous qui ne sont pas à l'aise avec git (ou LaTeX) et ne veulent pas apprendre, vous pouvez suggérer des modifications et des mises à jour en utilisant le gestionnaire d'anomalies du référentiel.
+**
 Installing LaTeX
@@ Ligne 13: / Ligne 30: @@
 or
-sudo apt-get install texlive-full
+sudo apt-get install texlive-full«»
 Installing the IDE
@@ Ligne 19: / Ligne 36: @@
 I recommend using an IDE when working with LaTeX for the first time, though you can, of course, compile .tex documents using the command-line. However, the IDE makes figuring out shortcuts and commands much easier.
+**
+Installation de LaTeX
+L'installation de base de LaTeX est fournie par texlive, mais une installation complète est incluse dans texlive-full. Tous les deux peuvent être installés avec apt-get, comme indiqué ci-dessous :
+sudo apt-get install texlive
+ou
+sudo apt-get install texlive-full
+Installer l'EDI
+Je recommande d'utiliser un EDI [Environnement de Développement Intégré] lorsque vous travaillez avec LaTeX pour la première fois, même si vous pouvez, bien sûr, compiler les documents .tex en utilisant la ligne de commande. Toutefois, l'EDI rend la compréhension des raccourcis et des commandes plus facile.
+**
 My preferred IDE is Texmaker, which can be found in the official repository. You can install it with
@@ Ligne 27: / Ligne 62: @@
 Install extra packages
 I used a few extra packages to fancy up the Cookbook (with links and code formatting). The extra packages are: fancyvrb and hyperref. Everything else should be included in a typical LaTeX installation. These packages are contained in texlive-latex-recommended and texlive-latex-base. If you installed just texlive instead of the full installation, you will most likely need to install these separately.
+**
+Mon EDI préféré est Texmaker, qui se trouve dans le dépôt officiel. Vous pouvez l'installer avec :
+sudo apt-get install texmaker
+Si votre version d'Ubuntu (ou votre distribution préférée) ne le propose pas officiellement, vous pouvez le trouver ici : http://www.xm1math.net/texmaker/download.html#linux. Comme pour toutes choses sous Linux, il y a plus de choix que juste Texmaker, mais mes explications seront basées sur lui.
+Installer des paquets supplémentaires
+J'ai utilisé quelques paquets supplémentaires pour rendre le Cookbook plus sympa (avec des liens et la mise en forme du code). Les paquets supplémentaires sont : fancyvrb et hyperref. Tout le reste devrait être inclus dans une installation typique de LaTeX. Ces paquets sont contenus dans texlive-latex-recommanded et texlive-latex-base. Si vous n'avez installé que texlive au lieu de l'installation complète, vous devrez probablement les installer séparément.
+**
 Fork the GitHub repository
@@ Ligne 37: / Ligne 85: @@
 This will create a folder called cli-cookbook and fill it with the files you need. Once that's done, open up the .tex file in Texmaker.
+**
+Dupliquer le dépôt sur GitHub
+Pour faire cela, vous aurez besoin d'un compte github et git doit être installé. Sur mon dépôt, vous devriez voir un bouton « fork ». En cliquant sur celui-ci vous créez un dépôt sur votre compte qui est une copie du mien. La deuxième étape consiste à cloner l'embranchement (le référentiel lié à votre compte). Pour ce faire, vous pouvez taper ce qui suit dans un terminal :
+git clone https://github.com/username/cli-cookbook.git
+Remplacez username par votre nom d'utilisateur. Ou bien, vous pouvez simplement copier l'URL HTTPS de clone situé sur la page de GitHub (de votre branche de référentiel).
+Cela créera un dossier nommé cli-cookbook et le remplira avec les fichiers dont vous avez besoin. Une fois cela fait, ouvrez le fichier .tex avec Texmaker.
+**
 Editing the file
@@ Ligne 61: / Ligne 121: @@
 [...]
+**
-This will create a section called Photo Editing, and two subsections called Using Photon to create albums, and Organizing Albums. The \hyperref statement will replace that section of code with the section number of the Photon subsection (i.e. 13.1). Clicking on the link will take you to the page where that section appears.
+Modification du fichier
+Habituellement lors de la création d'un fichier, vous devrez créer le préambule (\usepackage, \documentclass, \begin{document}, etc.). Mais comme vous travaillez à partir de mon fichier, tout cela a déjà été fait.
+Si vous souhaitez ajouter une nouvelle section (disons, par exemple, que vous souhaitez ajouter une section pour les commandes d'édition de photos), vous taperez ce qui suit :
+\section{Name}
+Le Name sera l'en-tête que vous souhaitez qu'elle ait (ex: Retouche Photo). Si vous voulez qu'elle soit divisée en sous-sections, la commande est : \subsection{} ; \subsubsection{} crée, assez étonnamment, une sous-section de la sous-section. Si vous prévoyez de faire allusion plus tard à cette section, vous devez lui assigner une étiquette. À la fin, ça pourrait ressembler à ceci :
+[...]
+\section{Photo Editing}
+\subsection{Using Photon to create albums}
+\label{photon}
+\subsection{Organizing Albums}
+As seen in \hyperref[photon]{\ref*{photon}}
+[...]
-===== à relire =====
 **
+This will create a section called Photo Editing, and two subsections called Using Photon to create albums, and Organizing Albums. The \hyperref statement will replace that section of code with the section number of the Photon subsection (i.e. 13.1). Clicking on the link will take you to the page where that section appears.
 Adding code
 I made this step slightly more complicated than it needs to be, in order to get the best result. You need to encompass your code like so:
-\begin{Verbatim}[commandchars=\\\{\}]
+<nowiki>\begin{Verbatim}[commandchars=\\\{\}]
 // Code goes here
-\end{Verbatim}
+\end{Verbatim}</nowiki>
 The Verbatim environment won't wrap text, so you'll need to manually keep an eye on the length of the code once the PDF is compiled. If you have multiple commands after each other, I place a blank line between each step. If you stick to my formatting system, you'll also want to mark the unchanging parts of a command with a red color. Any user input I leave black. So it would look like this:
-\begin{Verbatim}[commandchars=\\\{\}]
+<nowiki>\begin{Verbatim}[commandchars=\\\{\}]
 \codeHighlight{//unchanging code} //user input \codeHighlight{//more unchanging code}
-\end{Verbatim}
+\end{Verbatim}</nowiki>
-As you can imagine, this will result in //unchanging code //user input //more unchanging code. Logically, you'll want to swap out the text for what you want to say.
+As you can imagine, this will result in <nowiki>//unchanging code //user input //more unchanging code</nowiki>. Logically, you'll want to swap out the text for what you want to say.
 **
-Ajout de code
+Cela créera une section appelée Photo Editing et deux sous-sections appelées Using Photon to create albums (L'utilisation de Photon pour créer des albums) et Organizing Albums. L'argument \hyperref remplacera cette section du code par le numéro de section de la sous-section Photon (c'est-à-dire 13.1). Cliquer sur le lien vous amènera à la page où cette section est affichée.
-J'ai complexifié cette étape plus qu'elle ne doit être, afin d'obtenir le meilleur résultat. Vous devez inclure votre code comme suit :
+L'ajout de code
-\begin{Verbatim}[commandchars=\\\{\}]
+J'ai fait en sorte que cette étape soit un peu plus compliquée que nécessaire, pour que le résultat soit meilleur. Vous devez entourer votre code comme ceci :
-// Mettre ici le code
+<nowiki>\begin{Verbatim}[commandchars=\\\{\}]
-\end{Verbatim}
+// Mettez le code ici :
-L'environnement Verbatim ne va pas faire de retour à la ligne automatique, ainsi vous devrez vérifier à la main la longueur du code, une fois que le fichier PDF est compilé. Lorsqu'on a plusieurs commandes après l'autre, je place une ligne vide entre chaque étape. Si vous suivez bien mon système de mise en forme, vous devrez marquer les éléments inchangés d'une commande avec une couleur rouge. Je laisse en noir toutes les entrée des utilisateurs. Donc, çà ressemblerait à ceci :
+\end{Verbatim}</</nowiki>
-\begin{Verbatim}[commandchars=\\\{\}]
+L'environnement Verbatim ne renvoie pas automatiquement le texte à la ligne suivante, ce qui veut dire que vous devez surveiller la longueur du code une fois le PDF compilé. Si vous avez de multiples commandes, l'une après l'autre, je mets une ligne vierge entre chaque étape. Si vous voulez adopter mon système de formatage, vous devez mettre en rouge les parties d'une commande qui ne changent pas. Je laisse toute entrée utilisateur en noir. Ainsi, il ressemblera à ceci :
-\codeHighlight{//code inchangé} //entrée utilisateur \codeHighlight{//encore du code inchangé}
+<nowiki>\begin{Verbatim}[commandchars=\\\{\}]
-\end{Verbatim}
+\codeHighlight{//unchanging code} //user input \codeHighlight{//more unchanging code}
-Comme vous pouvez l'imaginer, cela se traduira par //code inchangé //entrée utilisateur //encore du code inchangé. Logiquement, vous aurez envie de remplacer ce texte par ce que vous voulez dire.
+\end{Verbatim}</nowiki>
+Comme vous pouvez le supposer, le résultat sera <nowiki>//code non modifié //entrée utilisateur //encore du code non modifié</nowiki>. Logiquement, vous voudrez replacer le texte par ce que vous voulez ajouter.
 **
@@ Ligne 116: / Ligne 202: @@
 If any errors crop up, you'll need to read the error information to find the correct section of the file and see what could be wrong. I find the most common issue is a lack/overabundance of braces.
+Return the changes to original repository
+First, open a terminal and change directory to your local copy of the repository.
+cd ~/cli-cookbook/
 **
-Compilation du PDF
+Compiler le PDF
-Une fois que vous avez fait vos modifications et êtes prêt à compiler le fichier PDF, appuyez sur la flèche bleue à côté de “Quick Build” [Construction rapide] dans la barre supérieure de Texmaker. Si vous voulez le faire à la main, vous pouvez exécuter cette commande :
+Une fois les modifications faites et que vous voulez compiler le PDF, appuyez sur la flèche bleue à côté de « Quick Build » dans la barre du haut de Texmaker. Si vous voulez le faire à la main, vous pouvez exécuter cette commande :
 pdflatex cli-cookbook.tex
-Si des erreurs surviennent, vous devrez lire les messages d'erreur pour trouver la section appropriée du fichier et voir ce qui pourrait être erroné. J'ai trouvé que le problème le plus courant est un manque/surabondance d'accolades
+Si des notifications d'erreur s'affichent, il faudra bien lire les informations sur l'erreur afin de trouver la bonne section du fichier et voir ce qui ne va pas. Je trouve que le problème le plus fréquent est le manque/la surabondance de crochets.
+Le renvoi des modification au dépôt d'origine
-**
+Ouvrez un terminal et changez de répertoire pour celui votre copie locale du dépôt.
-Return the changes to original repository
-First, open a terminal and change directory to your local copy of the repository.
 cd ~/cli-cookbook/
+**
 Now, you need to add the newly added/changed files:
@@ Ligne 149: / Ligne 240: @@
 **
-Renvoyer les modifications dans le référentiel original
+Il faut maintenant ajouter les fichiers qui sont nouveaux/modifiés :
-Tout d'abord, ouvrez un terminal et allez dans le répertoire de votre copie locale du référentiel.
-cd ~/cli-cookbook/
-Maintenant, vous devez ajouter les fichiers récemment ajoutés/modifiés :
 git add -A
-Puis vous devez valider les changements
+Puis il faut valider les modifications :
-git commit -m “Update message” -a
+git commit -m "Update message" -a
-Remplacez la section “Update message” avec un bref résumé de ce que vous avez ajouté. Gardez le message entre guillemets !
+Remplacez la section « Update message » avec un court résumé de ce que vous avez ajouté. Avec les guillemets autour de votre message !
 git push origin master
-Cela remet les modifications dans votre copie de mon référentiel. Si vous renommez les branches, vous devez savoir en quoi vous avez changé l'origine et les noms de maîtres. Par défaut, cette commande devrait fonctionner.
+Cela renvoie les modifications vers votre copie de mon référentiel. Si vous renommez les branches, vous aurez besoin de savoir les noms de l'origine et de master que vous avez choisis. Par défaut, cette commande devrait fonctionner.
@@ Ligne 192: / Ligne 277: @@
 **
-Maintenant pour envoyer une demande de récupération au référentiel original:
+Envoyez une requête pull véritable au référentiel original :
-• visiter votre référentiel sur la page de github.
+  * Allez voir votre dépôt sur la page github.
+  * Cliquez sur « compare and review » (l'icône verte avec deux flèches qui forment une boucle).
-• Cliquez sur « Compare and review » (l'icône verte avec deux flèches formant une boucle).
+  * Sélectionnez les bons dépôt et branche (par exemple, lswest:master et username:master).
-• Choisir les bons référentiel et branche (lswest:master et username:master, par exemple).
+  * Relisez vos modifications.
-• Relire vos modifications.
+  * Cliquez sur « Click to create a pull request for this comparison ».
-• Cliquez sur « Click to create a pull request for this comparison ». [Cliquez pour créer une demande de récupération pour cette comparaison]
+  * Tapez un titre et une description.
-• Entrez un titre et une description.
+  * Cliquez sur « Send pull request ».
-• Cliquez sur « Send pull request ».
+À ce stade là, la balle est dans mon camp et je dois relire la modification proposée et la fusionner ou la fermer.
-À partir de ce point, la balle est maintenant dans mon camp et j'ai besoin d'examiner le changement proposé et de le fusionner ou de le fermer.
+Si vous voulez en savoir davantage sur LaTeX grâce à cet article, faites-le moi savoir et je reviendrai à ce sujet une autre fois. Même chose pour git et github, si vous voulez plus de renseignements à leur sujet, dites-le moi ! Vous pouvez m'envoyer d'autres questions, commentaires ou suggestions à lswest34+fcm@gmail.com.
-Si cet article a aiguisé votre appétit sur LaTeX, faites le moi savoir et je reviendrai sur ce sujet une autre fois. Même chose avec git et github : si vous en voulez plus, faites le moi savoir ! D'autres questions, commentaires ou suggestions peuvent m'être adressées à lswest34+fcm@gmail.com.