Différences

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

--- issue89:command_conquer [2015/02/08 11:44] – [4] auntiee
+++ issue89:command_conquer [2015/02/08 11:55] (Version actuelle) – [8] auntiee
@@ Ligne 115: / Ligne 115: @@
 Lines 29-30 uses the trap command to empty the temporary folder when the script exits (including when the script is interrupted by the user or system – i.e. when you hit ctrl+c).**
-Les lignes 9 à 25 contiennent une instruction if qui vérifie s'il y a des arguments, sinon, elle affiche  les informations d'utilisation. Quand j'écris des scripts comme celui-ci, j'ai tendance à inclure également une vérification pour voir si l'argument est « -h », et/ou le compare à une liste des arguments acceptés. Dans ce cas, je vais sauter la vérification des arguments acceptés, car on va recevoir des noms de fichiers, et on peut difficilement avoir une liste complète pour la comparaison.
+Les lignes 9 à 25 contiennent une instruction if qui vérifie s'il y a des arguments, sinon, elle affiche les informations d'utilisation. Quand j'écris des scripts comme celui-ci, j'ai tendance à inclure également une vérification pour voir si l'argument est « -h », et/ou le comparer à une liste des arguments acceptés. Dans ce cas, je vais sauter la vérification des arguments acceptés, car on va recevoir des noms de fichiers et on peut difficilement avoir une liste complète pour la comparaison.
 Les lignes 27-28 créent un emplacement temporaire pour stocker les fichiers PDF pendant qu'ils sont en cours de traitement par le script (car on convertit le fichier PDF avec pdftotext pour utiliser grep sur les textes). C'est une pratique acceptée pour garder propres les résultats du script (c'est-à-dire ne pas laisser des fichiers partout dans votre dossier de départ).
@@ Ligne 127: / Ligne 127: @@
 Lines 46 – 54 is a for loop that checks the passed arguments for any beginning with a hyphen – as it is assumed it indicates an argument. If I were the one authoring this script, I would have opted for an array of acceptable options, and searched for them instead. If your filename starts with a hyphen, I would imagine the script would fail. However, it is pretty uncommon for a file to be named in such a way.**
-Les lignes 31 à 44 sont une boucle while qui demande à l'utilisateur des termes à rechercher, jusqu'à ce qu'il entre dans une chaîne vide. À ce moment-là, on passe à la suite du programme. Ce terme peut également être une expression régulière simple.
+Les lignes 31 à 44 sont une boucle while qui demande à l'utilisateur des termes à rechercher, jusqu'à ce qu'elle entre dans une chaîne vide. À ce moment-là, on passe à la suite du programme. Ce terme peut également être une expression régulière simple.
 Les lignes 46 à 54 sont une boucle for qui vérifie si les arguments passés commencent avec un tiret, car ils sont supposés indiquer un argument. Si j'étais l'auteur de ce script, j'aurais plutôt opté pour un tableau d'options acceptables, que j'aurais alors pu rechercher. Si un nom de fichier commence par un tiret, j'imagine que le script sera en échec. Cependant, il est assez rare qu'un fichier soit nommé de cette façon.
@@ Ligne 137: / Ligne 137: @@
 Lines 96-101 check if the number of matched PDF files exists. If not, there were no matches, and the program exits.**
-Les lignes 56 à 93 sont une boucle qui sert à inverser la vérification des lignes 46 à 54 (des arguments qui ne commencent pas par un tiret), et suppose que c'est un nom de fichier. Il commence alors une nouvelle ligne, affiche « pages correspondantes dans <nom de fichier> : <liste des pages> ». Au final, vous devriez avoir une liste de tous les fichiers PDF recherchés, ainsi qu'une liste de tous les numéros de page qui correspondent à l'un de vos termes de recherche. Les deux dernières lignes vous diront où les résultats ont été enregistrés et combien de fichiers PDF correspondant ont été trouvés. La recherche proprement dite est effectuée par conversion de chaque page du PDF en texte (en utilisant pdftotext), puis envoi vers grep à travers un « pipe » pour trouver les résultats. S'il y a une correspondance, il retournera le numéro de page, s'en souviendra dans la variable $sel et passera à la page suivante. Une fois terminée la boucle sur les pages, il incrémente le nombre de fichiers PDF correspondant (s'il y avait une correspondance), extrait les pages trouvées dans un fichier temporaire, réinitialise la liste des pages correspondant à la recherche, puis se souvient du nom d'origine du dernier PDF correspondant.
+Les lignes 56 à 93 sont une boucle for qui sert à inverser la vérification des lignes 46 à 54 (des arguments qui ne commencent pas par un tiret), et suppose que c'est un nom de fichier. Il commence alors une nouvelle ligne, affiche « pages correspondantes dans <nom de fichier> : <liste des pages> ». Au final, vous devriez avoir une liste de tous les fichiers PDF recherchés, ainsi qu'une liste de tous les numéros de page qui correspondent à l'un de vos termes de recherche. Les deux dernières lignes vous diront où les résultats ont été enregistrés et combien de fichiers PDF correspondant ont été trouvés. La recherche proprement dite est effectuée par conversion de chaque page du PDF en texte (en utilisant pdftotext), puis envoi vers grep à travers un « pipe » pour trouver les résultats. S'il y a une correspondance, il retournera le numéro de page, s'en souviendra dans la variable $sel et passera à la page suivante. Une fois terminée la boucle sur les pages, il incrémente le nombre de fichiers PDF correspondant (s'il y avait une correspondance), extrait les pages trouvées dans un fichier temporaire, réinitialise la liste des pages correspondant à la recherche, puis se souvient du nom d'origine du dernier PDF correspondant.
 Les lignes 96 à 101 vérifient si le nombre de fichiers PDF correspondant à la recherche existe. Sinon, il n'y avait aucun résultat, et le programme se termine.
@@ Ligne 149: / Ligne 149: @@
 I've skimmed over certain specifics of the script for two reasons – one being brevity, and the other being that figuring out exactly how a script works simply by reading it and running it is a good skill to have, especially if you plan on writing your own scripts or programs. If anyone has particular questions about a certain segment of the script, you're welcome to send me a quick email. If you have any other questions, suggestions, or requests, you're welcome to send me an email at lswest34+fcm@gmail.com.**
-Les lignes 102 à 112 couvrent le cas d'un fichier correspondant (et affichent « 1 fichier PDF correspondant », puis déplace le fichier temporaire dans le PDF final contenant les résultats, ce qui évite les problèmes avec pdfunite attendant plus d'un fichier), ainsi que les correspondances multiples. Lorsque plusieurs fichiers PDF correspondants existent, il utilisera pdfunite pour fusionner les fichiers dans le pdf -matches.
+Les lignes 102 à 112 couvrent le cas d'un fichier correspondant (et affichent « 1 fichier PDF correspondant », puis déplace le fichier temporaire dans le PDF final contenant les résultats, ce qui évite des problèmes avec pdfunite qui attendrait plus d'un fichier), ainsi que les correspondances multiples. Lorsque plusieurs fichiers PDF correspondants existent, il utilisera pdfunite pour fusionner les fichiers dans le pdf -matches.
 La ligne 113 - Cette ligne affiche simplement le nom du fichier résultant, pour que l'utilisateur puisse le trouver.
-J'ai passé certaines spécificités du script pour deux raisons : l'une étant la concision, et l'autre étant que déterminer exactement comment un script fonctionne simplement en le lisant et en l'exécutant est une bonne compétence à avoir, surtout si vous prévoyez d'écrire vos propres scripts ou programmes. Si quelqu'un a des questions particulières sur un certain morceau du script, qu'il m'envoie un courriel rapide. Si vous avez d'autres questions, des suggestions ou des demandes, vous êtes invités à m'envoyer un courriel à lswest34+fcm@gmail.com.
+Je ne me suis pas étendu sur certaines spécificités du script pour deux raisons : l'une étant la concision et l'autre étant que déterminer exactement comment un script fonctionne simplement en le lisant et en l'exécutant est une bonne compétence à avoir, surtout si vous prévoyez d'écrire vos propres scripts ou programmes. Si quelqu'un a des questions particulières sur un certain morceau du script, qu'il m'envoie un courriel rapide. Si vous avez d'autres questions, des suggestions ou des demandes, n'hésitez pas à m'envoyer un courriel à lswest34+fcm@gmail.com.