Aidez Wikitravel à s'améliorer en contribuant à un article ! Apprenez comment!

Wikitravel:Règles concernant les scripts : Différence entre versions

De Wikitravel
Aller à : Navigation, rechercher
m (Scripts inadaptés : traduction)
(traduction des liens et textes)
Ligne 1 : Ligne 1 :
Comme la plupart des taches informatiques répétitives, Wikitravel peut profiter de l'utilisation de programmes en script pour lire et écrire des pages. Cette page décrit les règles concernant l'utilisation de tels scripts sur Wikitravel : ce que nous aimons, ce qui nous dérange et comment faire un script qui fonctionne sur Wikitravel.
+
Comme la plupart des taches informatiques, Wikitravel peut profiter de l'utilisation de programmes en script pour lire et écrire des pages. Cette page décrit les règles concernant l'utilisation de tels scripts sur Wikitravel : ce que nous aimons, ce qui nous dérange et comment faire un script qui fonctionne sur Wikitravel.
  
 
==Pour et contre==
 
==Pour et contre==
  
Scripts are nice for the following reasons:
+
Les scripts sont pratiques pour les raisons suivantes :
  
*'''Repetitive work'''. Using a script can make repetitive tasks a lot easier to do. The script program does the work, instead of someone -- or a lot of someones -- having to do it by hand.
+
*'''Travail répétitif'''. Créer un script pour faire des taches répétitives peut faciliter la vie. Le script fait le travail à la place d'une personne qui aurait dû le faire à la main.
*'''Accurate work'''. Well-written scripts don't make common typos, spelling mistakes, etc. A script will do the same task over and over pretty well.
+
*'''Travail soigné'''. Les scripts bien écrits ne font pas de fautes de frappes ou d'orthographes, etc. Un script fera le même travail mais sûrement mieux.
  
But scripts have the following problems:
+
Mais les scripts génèrent aussi les problèmes suivants :
  
 
*'''Unintended consequences'''. If you have a bug in your script, you muck up a whole lot of pages, and either we have to correct those problems by hand, or we have to create another script to clean up after it.
 
*'''Unintended consequences'''. If you have a bug in your script, you muck up a whole lot of pages, and either we have to correct those problems by hand, or we have to create another script to clean up after it.
Ligne 18 : Ligne 18 :
 
==Règles==
 
==Règles==
  
For these reasons, we have the following rules for running scripts against Wikitravel:
+
Pour toutes ces raisons, tous les scripts tournant sur Wikitravel doivent respecter les règles suivantes :
  
#Scripts have to be approved by the Wikitravel administrators. To create a script that runs against Wikitravel, post the name and reason for the script on [[Wikitravel:Script nominations|Script nominations]]. Explain why we need the script, why it can't be done by hand, and what the script will do. If 2 administrators voice their support for the script within 7 days, and none oppose it in that period, the script can be run.
+
#Scripts have to be approved by the Wikitravel administrators. To create a script that runs against Wikitravel, post the name and reason for the script on [[Wikitravel:Nominations des scripts|Script nominations]]. Explain why we need the script, why it can't be done by hand, and what the script will do. If 2 administrators voice their support for the script within 7 days, and none oppose it in that period, the script can be run.
#Scripts should be in accordance with our [[Wikitravel:policies and guidelines|policies and guidelines]] and [[Wikitravel:manual of style|manual of style]]. For example, a script that reformats all restaurant listings on the site should make them look like [[Wikitravel:restaurant listings|our preferred form]] rather than something else. If you think we should use that something else, get the policy or style guideline changed ''first''.
+
#Scripts should be in accordance with our [[Wikitravel:Recommandations et règles à suivre|policies and guidelines]] and [[Wikitravel:Manuel de style|manual of style]]. For example, a script that reformats all restaurant listings on the site should make them look like [[Wikitravel:Listes de restaurants|our preferred form]] rather than something else. If you think we should use that something else, get the policy or style guideline changed ''first''.
 
#Each script has to run with its own user name. All edits made to the site need to be marked with this user name.
 
#Each script has to run with its own user name. All edits made to the site need to be marked with this user name.
 
#The user page for the script's user name should describe what the script does.
 
#The user page for the script's user name should describe what the script does.
#Scripts have to check two pages, <nowiki>[[Wikitravel:Script policy/Run]]</nowiki> and <nowiki>[[User:</nowiki>''name of script''<nowiki>/Run]]</nowiki>, before making ''each edit''. Both these pages have to contain exactly the word "yes" before the edit should be saved. This allows any Wikitraveller to turn off all scripts, or individual scripts, just by changing the contents of one or the other page.
+
#Scripts have to check two pages, <nowiki>[[Wikitravel:Règles concernant les scripts/Run]]</nowiki> and <nowiki>[[User:</nowiki>''name of script''<nowiki>/Run]]</nowiki>, before making ''each edit''. Both these pages have to contain exactly the word "yes" before the edit should be saved. This allows any Wikitraveller to turn off all scripts, or individual scripts, just by changing the contents of one or the other page.
 
#Scripts should make less than one change per minute. This keeps them from hogging up the Web server resources.
 
#Scripts should make less than one change per minute. This keeps them from hogging up the Web server resources.
 
#If possible, scripts should be run against a test version of Wikitravel before running against the live site. (We may set up a test server, with a mirror of the live site, for this purpose.)
 
#If possible, scripts should be run against a test version of Wikitravel before running against the live site. (We may set up a test server, with a mirror of the live site, for this purpose.)

Version du 4 décembre 2004 à 15:32

Comme la plupart des taches informatiques, Wikitravel peut profiter de l'utilisation de programmes en script pour lire et écrire des pages. Cette page décrit les règles concernant l'utilisation de tels scripts sur Wikitravel : ce que nous aimons, ce qui nous dérange et comment faire un script qui fonctionne sur Wikitravel.

Pour et contre

Les scripts sont pratiques pour les raisons suivantes :

  • Travail répétitif. Créer un script pour faire des taches répétitives peut faciliter la vie. Le script fait le travail à la place d'une personne qui aurait dû le faire à la main.
  • Travail soigné. Les scripts bien écrits ne font pas de fautes de frappes ou d'orthographes, etc. Un script fera le même travail mais sûrement mieux.

Mais les scripts génèrent aussi les problèmes suivants :

  • Unintended consequences. If you have a bug in your script, you muck up a whole lot of pages, and either we have to correct those problems by hand, or we have to create another script to clean up after it.
  • Unilateral. The writer of a script can make a whole bunch of pages that work exactly the way they want them to. If someone else wants them to work another way, they have to write another script.
  • Suck up resources. Bots take up bandwidth and other resources on the server that could be used by people hand-editing a file.
  • Unnecessary. Many problems that people want to make scripts for are unnecessary. The time and energy the person would have to put into creating, debugging, and running the script could be spread across a number of people doing the same task by hand. This would be less unilateral, and may actually be faster.
  • No new knowledge. In general, scripts just re-adjust the formatting or presentation of knowledge on Wikitravel. Unless they're importing information from another database, there's nothing new added. We could better spend that time and energy adding actual travel information to the guide.

Règles

Pour toutes ces raisons, tous les scripts tournant sur Wikitravel doivent respecter les règles suivantes :

  1. Scripts have to be approved by the Wikitravel administrators. To create a script that runs against Wikitravel, post the name and reason for the script on Script nominations. Explain why we need the script, why it can't be done by hand, and what the script will do. If 2 administrators voice their support for the script within 7 days, and none oppose it in that period, the script can be run.
  2. Scripts should be in accordance with our policies and guidelines and manual of style. For example, a script that reformats all restaurant listings on the site should make them look like our preferred form rather than something else. If you think we should use that something else, get the policy or style guideline changed first.
  3. Each script has to run with its own user name. All edits made to the site need to be marked with this user name.
  4. The user page for the script's user name should describe what the script does.
  5. Scripts have to check two pages, [[Wikitravel:Règles concernant les scripts/Run]] and [[User:name of script/Run]], before making each edit. Both these pages have to contain exactly the word "yes" before the edit should be saved. This allows any Wikitraveller to turn off all scripts, or individual scripts, just by changing the contents of one or the other page.
  6. Scripts should make less than one change per minute. This keeps them from hogging up the Web server resources.
  7. If possible, scripts should be run against a test version of Wikitravel before running against the live site. (We may set up a test server, with a mirror of the live site, for this purpose.)

Scripts inadaptés

Les scripts qui ne se conforment pas à ces règles seront bloqués pour lédition des pages -- même si ils fonctionnent correctement.

Variantes

Actions

Enseignants

Autres langues