Diferencia entre revisiones de «Ayuda:Resumen»

Revisión actual - 11:50 15 abr 2019

Traducciones

Cómo preparar una página para traducción

Para preparar una página para traducción es necesario ser miembro del grupo "traductor".

Editar la página que se quiere preparar para traducción.
Poner al comienzo de la página la etiqueta <languages />. Esta etiqueta mostrará la lista de traducciones de la página, una vez que la página haya sido traducida.
Encerrar con etiquetas <translate></translate> todo el texto que se desee traducir (generalmente toda la página, excepto quizás la ficha inicial).
Guardar los cambios.
Clickear en el botón "Marcar esta página para traducción" que debería aparecer en la parte superior de la página.
Verificar que el software haya reconocido correctamente las unidades de texto a ser traducidas y hacer click en Aceptar.

¡Listo! Este proceso inserta etiquetas del estilo  al comienzo de cada párrafo de la página a ser traducida. Estas etiquetas permiten a la wiki identificar cada párrafo y por lo tanto no se deben modificar manualmente nunca.

Cada vez que se edite la página, la wiki nos pedirá que volvamos a repetir el proceso de marcado. Por eso, no se recomienda marcar las páginas para traducción mientras están en desarrollo activo.

Cómo traducir una página

Una vez que la página haya sido preparada para la traducción, los usuarios que son miembros del grupo "traductor" pueden iniciar las traducciones.

Visitar la página y hacer click en el botón "Traducir esta página" en la parte superior de la página.
En el menú de arriba a la derecha, seleccionar el idioma al cual se desea traducir la página.
Realizar las traducciones párrafo por párrafo. Los cambios se guardan automáticamente.
Visitar la página para verificar que las traducciones estén disponibles.

Cómo cambiar los textos de menús

Algunos de los enlaces y textos en el menu principal se pueden editar desde MediaWiki:Sidebar. El contenido de la página tiene la siguiente estructura:

* navigation
** Portada | Portada
** Especial:CambiosRecientes | Cambios recientes
** Especial:Aleatoria | Página aleatoria
** https://www.mediawiki.org/wiki/Help:Contents | Ayuda

El primer elemento, "navigation", no se debe modificar. Los demás elementos corresponden a los elementos del menú principal y se pueden modificar a voluntad. La primera parte de cada elemento (la parte antes de la barra vertical) es el título de la página enlazada. La segunda parte es el texto que se muestra para el enlace. Así por ejemplo, si se desea agregar un enlace a la página especial que lista todas las categorías de la wiki, basta con agregar lo siguiente al final de la lista:

** Especial:Categorías | Categorías

También se pueden agregar enlaces a sitios fuera de la wiki, cambiando el título de la página por una URL. Por ejemplo, para agregar un enlace al sitio principal de Banrepcultural, basta con agregar:

** http://www.banrepcultural.org | Banrepcultural

Administración de usuarios

Cómo crear un grupo con determinados permisos

Para crear un grupo de usuarios con uno o varios permisos especiales, basta con agregar a LocalSettings.php:

$wgGroupPermissions['nombre-del-grupo']['nombre-del-permiso'] = true;

Por ejemplo, para crear un grupo "traductor" con los permisos "translate" (permiso de traducir páginas) y "pagetranslation" (permiso de marcar páginas para traducción), basta con agregar:

$wgGroupPermissions['traductor']['translate'] = true;
$wgGroupPermissions['traductor']['pagetranslation'] = true;

Para más detalles, véase mw:Manual:User rights.

Cómo asignar usuarios a grupos

Para agregar un usuario a un grupo, hay que ser administrador y visitar Especial:PermisosUsuarios.

Plantillas

Cómo agregar campos a la Plantilla:Ficha

Para agregar un campo a la Plantilla:Ficha, la mejor manera es editar la plantilla, duplicar un campo ya existente (con copy-paste) y luego modificar el campo duplicado. Una vez hecho esto, también conviene actualizar la documentación de la plantilla para documentar el nuevo parámetro.

Cómo agregar documentación a una plantilla

La documentación de las plantillas debe ir inmediatamente después del código de la plantilla, encerrada con etiquetas <noinclude></noinclude> Estas etiquetas impiden que la documentación se transcluya junto con el resto de la plantilla. Por ejemplo, al editar la Plantilla:Ficha, la documentación está inmediatamente despúes del código que constituye la plantilla propiamente dicha, encerrada con etiquetas <noinclude></noinclude>.

Cómo agregar un lenguaje nuevo

Visitar Especial:Versión para verificar que las extensiones UniversalLanguageSelector y CLDR están ambas instaladas y activadas.
Agregar una línea como la siguiente a LocalSettings.php por cada lenguaje que se quiera agregar: $wgExtraLanguageNames['wy'] = 'Wayuunaiki';
Editar el archivo extensions/UniversalLanguageSelector/data/LanguageNameIndexer.php y quitar la línea $wgExtraLanguageNames = [];
Ejecutar el siguiente comando via SSH: php extensions/UniversalLanguageSelector/data/LanguageNameIndexer.php
Editar MediaWiki:Common.js y agregar una copia del siguiente código por cada lenguaje que se quiera agregar, modificando los valores 'wy' y 'Wayuunaiki' por lo que corresponda:

mw.loader.using( [ 'ext.uls.mediawiki' ] ).done( function () {

	// These three lines are needed if languages/i18n/wy.json doesn't exist
	var wy = $.extend( {}, mw.config.get( 'wgULSLanguages' ), { 'wy': 'Wayuunaiki' } ); 
	mw.config.set( 'wgULSLanguages', wy );
	$.fn.uls.defaults.languages = wy;

	// This is needed if langauge isn't yet in the ULS language database
	$.uls.data.addLanguage( 'wy', { script: 'Latn', regions: [ 'AM' ], autonym: 'Wayuunaiki' } );
});

iframes

Para insertar contenido de otros sitios web es necesario utilizar el código del iframe con la siguiente estructura:

<iframe key="youtube" path="https://www.youtube.com/embed/P_Cp46TwS8o" width="560" height="315" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen/>

En esta sintaxis el key es el nombre para identificar el dominio en este caso es "youtube" y el de banrepcultural.org es "banrepcultural" y el path es el mismo atributo src="..." del Iframe normal.

Sitios habilitados

Banrepcultural.org - Key: banrepcultural
Youtube.com - Key: youtube
Facebook - Key: facebook
Instagram - Key: instagram
Twitter - Key: twitter

@@ Línea 3: / Línea 3: @@
 === Cómo preparar una página para traducción ===
-Para preparar una página para traducción es necesario ser miembro del grupo "traductores".
+Para preparar una página para traducción es necesario ser miembro del grupo "traductor".
 # Editar la página que se quiere preparar para traducción.
@@ Línea 18: / Línea 18: @@
 === Cómo traducir una página ===
-Una vez que la página haya sido preparada para la traducción, los usuarios que son miembros del grupo "traductores" pueden iniciar las traducciones.
+Una vez que la página haya sido preparada para la traducción, los usuarios que son miembros del grupo "traductor" pueden iniciar las traducciones.
 # Visitar la página y hacer click en el botón "Traducir esta página" en la parte superior de la página.
@@ Línea 25: / Línea 25: @@
 # Visitar la página para verificar que las traducciones estén disponibles.
-== Cómo agregar un lenguaje nuevo ==
+== Cómo cambiar los textos de menús ==
+Algunos de los enlaces y textos en el menu principal se pueden editar desde [[MediaWiki:Sidebar]]. El contenido de la página tiene la siguiente estructura:
+<pre>
+* navigation
+** Portada | Portada
+** Especial:CambiosRecientes | Cambios recientes
+** Especial:Aleatoria | Página aleatoria
+** https://www.mediawiki.org/wiki/Help:Contents | Ayuda
+</pre>
+El primer elemento, "navigation", no se debe modificar. Los demás elementos corresponden a los elementos del menú principal y se pueden modificar a voluntad. La primera parte de cada elemento (la parte antes de la barra vertical) es el título de la página enlazada. La segunda parte es el texto que se muestra para el enlace. Así por ejemplo, si se desea agregar un enlace a la página especial que lista todas las categorías de la wiki, basta con agregar lo siguiente al final de la lista:
+<pre>
+** Especial:Categorías | Categorías
+</pre>
+También se pueden agregar enlaces a sitios fuera de la wiki, cambiando el título de la página por una URL. Por ejemplo, para agregar un enlace al sitio principal de Banrepcultural, basta con agregar:
+<pre>
+** http://www.banrepcultural.org | Banrepcultural
+</pre>
 == Administración de usuarios ==
@@ Línea 31: / Línea 53: @@
 === Cómo crear un grupo con determinados permisos ===
-Para crear un grupo de usuarios con uno o varios permisos especiales, basta con agregar lo siguiente a LocalSettings.php:
+Para crear un grupo de usuarios con uno o varios permisos especiales, basta con agregar a LocalSettings.php:
   $wgGroupPermissions['nombre-del-grupo']['nombre-del-permiso'] = true;
@@ Línea 46: / Línea 68: @@
 Para agregar un usuario a un grupo, hay que ser administrador y visitar [[Especial:PermisosUsuarios]].
-== Cómo cambiar los textos de menús ==
+== Plantillas ==
+=== Cómo agregar campos a la [[Plantilla:Ficha]] ===
+Para agregar un campo a la [[Plantilla:Ficha]], la mejor manera es [http://enciclopedia.banrepcultural.org/index.php?title=Plantilla:Ficha&action=edit editar la plantilla], '''duplicar un campo ya existente''' (con copy-paste) y luego modificar el campo duplicado. Una vez hecho esto, también conviene actualizar la documentación de la plantilla para documentar el nuevo parámetro.
+=== Cómo agregar documentación a una plantilla ===
+La documentación de las plantillas debe ir inmediatamente después del código de la plantilla, encerrada con etiquetas <code><nowiki><noinclude></noinclude></nowiki></code> Estas etiquetas impiden que la documentación se transcluya junto con el resto de la plantilla. Por ejemplo, al [http://enciclopedia.banrepcultural.org/index.php?title=Plantilla:Ficha&action=edit editar la Plantilla:Ficha], la documentación está inmediatamente despúes del código que constituye la plantilla propiamente dicha, encerrada con etiquetas <code><nowiki><noinclude></noinclude></nowiki></code>.
-Algunos de los enlaces y textos en el menu principal se pueden editar desde [[MediaWiki:Sidebar]]. El contenido de la página tiene la siguiente estructura:
+== Cómo agregar un lenguaje nuevo ==
+# Visitar [[Especial:Versión]] para verificar que las extensiones [[mw:Extension:UniversalLanguageSelector|UniversalLanguageSelector]] y [[mw:Extension:CLDR|CLDR]] están ambas instaladas y activadas.
+# Agregar una línea como la siguiente a LocalSettings.php por cada lenguaje que se quiera agregar: <code>$wgExtraLanguageNames['wy'] = 'Wayuunaiki';</code>
+# Editar el archivo <code>extensions/UniversalLanguageSelector/data/LanguageNameIndexer.php</code> y quitar la línea <code>$wgExtraLanguageNames = [];</code>
+# Ejecutar el siguiente comando via SSH: <code>php extensions/UniversalLanguageSelector/data/LanguageNameIndexer.php</code>
+# Editar [[MediaWiki:Common.js]] y agregar una copia del siguiente código por cada lenguaje que se quiera agregar, modificando los valores 'wy' y 'Wayuunaiki' por lo que corresponda:
 <pre>
-* navigation
+mw.loader.using( [ 'ext.uls.mediawiki' ] ).done( function () {
-** Portada | Portada
-** Especial:CambiosRecientes | Cambios recientes
-** Especial:Aleatoria | Página aleatoria
-** https://www.mediawiki.org/wiki/Help:Contents | Ayuda
-</pre>
-El primer elemento, "navigation", no se debe modificar. Los demás elementos corresponden a los elementos del menú principal y se pueden modificar a voluntad. La primera parte de cada elemento (la parte antes de la barra vertical) es el título de la página enlazada. La segunda parte es el texto que se muestra para el enlace. Así por ejemplo, si se desea agregar un enlace a la página especial que lista todas las categorías de la wiki, basta con agregar lo siguiente al final de la lista:
+	// These three lines are needed if languages/i18n/wy.json doesn't exist
+	var wy = $.extend( {}, mw.config.get( 'wgULSLanguages' ), { 'wy': 'Wayuunaiki' } );
+	mw.config.set( 'wgULSLanguages', wy );
+	$.fn.uls.defaults.languages = wy;
-<pre>
+	// This is needed if langauge isn't yet in the ULS language database
-** Especial:Categorías | Categorías
+	$.uls.data.addLanguage( 'wy', { script: 'Latn', regions: [ 'AM' ], autonym: 'Wayuunaiki' } );
+});
 </pre>
-También se pueden agregar enlaces a sitios fuera de la wiki, cambiando el título de la página por una URL. Por ejemplo, para agregar un enlace al sitio principal de Banrepcultural, basta con agregar:
+==iframes==
+Para insertar contenido de otros sitios web es necesario utilizar el código del iframe con la siguiente estructura:
 <pre>
-** http://www.banrepcultural.org | Banrepcultural
+<iframe key="youtube" path="https://www.youtube.com/embed/P_Cp46TwS8o" width="560" height="315" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen/>
 </pre>
-== Cómo agregar campos a la [[Plantilla:Ficha]] ==
+En esta sintaxis el '''key''' es el nombre para identificar el dominio en este caso es "youtube" y el de banrepcultural.org es "banrepcultural" y el '''path''' es el mismo atributo src="..." del Iframe normal.
-Para agregar un campo a la [[Plantilla:Ficha]], la mejor manera es [http://enciclopedia.banrepcultural.org/index.php?title=Plantilla:Ficha&action=edit editar la plantilla], '''duplicar un campo ya existente''' (con copy-paste) y luego modificar el campo duplicado. Una vez hecho esto, también conviene actualizar la documentación de la plantilla para documentar el nuevo parámetro.
-== Cómo agregar documentación a una plantilla ==
-La documentación de las plantillas debe ir inmediatamente después de la plantilla, encerrada con etiquetas <code><nowiki><noinclude></noinclude></nowiki></code> Estas etiquetas impiden que la documentación se transcluya junto con el resto de la plantilla. Por ejemplo, al [http://enciclopedia.banrepcultural.org/index.php?title=Plantilla:Ficha&action=edit editar la Plantilla:Ficha], la documentación está inmediatamente despúes del wikitexto que constituye la plantilla propiamente dicha, encerrada con etiquetas <code><nowiki><noinclude></noinclude></nowiki></code>.
+===Sitios habilitados===
+# Banrepcultural.org - '''Key:''' banrepcultural
+# Youtube.com - '''Key:''' youtube
+# Facebook - '''Key:''' facebook
+# Instagram - '''Key:''' instagram
+# Twitter - '''Key:''' twitter