Manual:Pywikibot/protect.py/es

protect.py es un script que facilita la protección de páginas en masa. Es un script simple que le da un gran poder sobre el la protección de casi todas partes de su wiki. Sin embargo, dado que los wikis generalmente se consideran "enciclopedias" que cualquiera "puede editar", es necesario pensar en las razones por las que desea utilizar este script. Dentro de algunas comunidades wiki, particularmente la propia Wikipedia, el uso indebido de este script podría resultar en la revocación de sus derechos administrativos.

Cuándo utilizarlo
Antes de utilizar este script, debe comprender a fondo las políticas de su wiki sobre la protección de páginas. Si su wiki aún no ha discutido su filosofía de protección de páginas, es una buena idea tener esa discusión y escribir algún tipo de política antes de usar este script. Su comunidad debe comprender lo que está haciendo con su bot. El mal uso de ese bot, es decir, usarlo para proteger todas las páginas de un wiki, es muy fácil de hacer con este script, pero generalmente se consideraría un abuso de los poderes administrativos en la mayoría de las comunidades wiki. Recuerde: puede evitar que todos los que no sean administradores editen todas las páginas de su wiki a través de solo un comando con este script.

Los usos "razonables" típicos son:


 * proteger toda una categoría de plantillas, porque cambiar esas plantillas tendría un impacto significativo en la wiki
 * proteger las páginas de ayuda o políticas de la edición general, porque no desea que las "reglas" de su wiki estén sujetas a vandalismo
 * evitar que se cambien los nombres de las páginas, es decir, "mover las páginas bloqueadas", pero seguir permitiendo que se editen libremente

Sintaxis
El script se invoca escribiendo:

Los parámetros disponibles incluyen:

-page:      Protect specified page -cat:       Protect all pages in the given category. -nosubcats: Don't protect pages in the subcategories. -links:     Protect all pages linked from a given page. -file:      Protect all pages listed in a text file. -ref:       Protect all pages referring from a given page. -images:    Protect all images used on a given page. -expiry:    Supply a custom protection expiry, defaults to infinite. -always:    Don't prompt to protect pages, just do it. -summary:   Supply a custom edit summary. -unprotect:  Actually unprotect pages instead of protecting -edit:PROTECTION_LEVEL Set edit protection level to PROTECTION_LEVEL -move:PROTECTION_LEVEL Set move protection level to PROTECTION_LEVEL


 * 1) Without support ##
 * 2) -create:PROTECTION_LEVEL Set move protection level to PROTECTION_LEVEL ##

Values for PROTECTION_LEVEL are: sysop, autoconfirmed, none. If an operation parameter (edit, move or create) is not specified, default protection level is 'sysop' (or 'none' if -unprotect).

Uso
A continuación se muestran algunos ejemplos concretos de usos típicos.

Bloqueo completo de todo en una categoría
Primero, considere el caso de una categoría llamada $categoría. Todo en esta categoría es una plantilla que requiere otra plantilla para funcionar. Por sí solo, ninguna plantilla de esta categoría hace "nada". Pero si se cambia la plantilla, tendrá un efecto en cadena para otras plantillas, que a su vez podrían trasladarse a otras páginas. Así que definitivamente queremos proteger estas plantillas de daños. ¡Son los componentes básicos de nuestra wiki! Así es como lo haces.

Fácil. No hay opciones más que el nombre de la categoría y un resumen. La secuencia de comandos asumirá que desea mover y editar bloquear la plantilla, por lo que no necesita hacer nada más.

Bloqueo contra traslados
Ahora, imagine que tiene una wiki sobre un programa de televisión. Su comunidad ha decidido una nomenclatura estándar para nombrar las páginas sobre episodios de ese programa. Nunca habrá una necesidad previsible de cambiar esa nomenclatura y, de todos modos, se requeriría una gran discusión comunitaria para hacerlo. Por lo tanto, desea proteger las páginas para que no sean trasladadas (cambien de nombre). Esta es la forma de hacerlo:

Tenga en cuenta algunas cosas aquí.


 * No necesitamos poner el nombre de la categoría entre comillas, porque es solo una palabra. (Por cierto, esto es cierto para casi todos los guiones de Pywikibot).
 * El resumen debe estar entre comillas dobles, porque hemos incluido un apóstrofe en el texto del resumen.
 * El parámetro  debe definirse en   si queremos que todos puedan editar el artículo, porque   y   todo predeterminado en
 * Definir  en esta instancia no tendría ningún efecto, porque las páginas de una categoría ya están creadas

Trabajando desde un archivo de texto
Ahora para un caso más complicado. Imagine que desea proteger las plantillas "más utilizadas" en su wiki. Este es un uso perfectamente razonable, ya que cambiar una plantilla que tiene 10,000 transclusiones tendrá un impacto significativo en tu wiki. Con razón, no quiere que ese cambio se produzca por capricho. Entonces, primero iría a Special:MostLinkedTemplates y extraería la lista en un archivo de texto llamado. Asegurándose de que  se haya guardado en la carpeta   en su computadora, entonces podrá escribir algo como esto:

Protection expiry
To enable expiry of protection place input inside double quotes as strings understandable by MediaWiki (see: API:Protect). Relative periods and absolute dates are acceptable

Custom summaries advisable
If you fail to use the  parameter, an automated summary will be inserted for you. But that summary won't tell your community why you've taken the action. Because protecting pages is generally considered antithetical to the spirit of wiki editing, it's usually important to leave behind a summary that explains why you've taken this unusual action. Remember, when your users attempt to edit or move the page, they'll get a message which includes your bot's edit summary. In most cases, this summary should be as explicit as possible about the reason why your users can't do what they want to do.

If you've put up a full block — that is, sysop-only editing — you'll probably also want to include a link to a page where users can leave feedback on how to improve the locked article. Often, this is the talk page, but on wikis that don't have the talk page functionality enabled, it might be a good idea to drop in a link to a forum or other feedback page.

Limitations
This script has no ability to affect the protection level of anything in the Special namespaces.