SA-MP Forums

Go Back   SA-MP Forums > Non-English > Languages > Español/Spanish > Lanzamientos/Releases

 
 
Thread Tools Display Modes
Old 21/04/2014, 03:39 AM   #1
TheChaoz
High-roller
 
TheChaoz's Avatar
 
Join Date: Dec 2009
Location: Argentina
Posts: 4,656
Reputation: 239
Default Wiki

Wiki




Introducción
Como todos o casi todos ustedes sabrán, desde hace mucho tiempo existe la wiki de SA-MP, sitio en el cual se encuentra toda (o casi toda) la información sobre funciones y callbacks nativas, ejemplos, etc. Dicha pagina web comenzó a ser traducida hace mucho, pero debido a que se cerro el registro de cuentas nuevas, solo muy pocos podían tener acceso a esta pagina para editar/crear contenido.
Hace poco, por problemas que no vienen al caso, las cuentas existentes (todas sin excepción) fueron eliminadas. Una vez que se terminaron de arreglar los problemas, se cambio la normativa, ya no seria necesario tener una cuenta en la wiki, si no que podría utilizarse la cuenta de este foro (la cual claro debe cumplir algunos requisitos) y de esta forma, se podría editar contenido de la wiki mucho mas fácil (ademas de que habría muchos mas colaboradores). Por este motivo (como ya tuve algunas preguntas sobre la wiki) decidí crear este tutorial con el fin de informar sobre formatos, y algunas nociones básicas para que puedan comenzar si es que así lo desean.


Importante: Si estas leyendo esto y piensas crear/editar contenido, te aclaro de entrada lo siguiente: LA WIKI ES EN INGLES cualquier template, categoría, pagina, etc. que sea creada debe tener un nombre en ingles, y si es una traducción o su idioma de contenido es en español, debe tener el "_ES" al final SIN EXCEPCIÓN.


Indice
  • Introducción
  • Indice
  • Preferencias (Introductorio)
    • Idioma
    • Tema
    • Edición
  • El formato
    • Paginas
    • Contenido & Templates
      • ¿Qué es un template?
      • ¿Para qué utilizar templates?
      • ¿Cómo utilizo un template?
      • ¿Qué templates existen?
      • ¿Puedo crear mi propio template?
    • Categorías
      • ¿Qué es una categoría?
      • ¿Cómo indico que una pagina pertenece a una categoría?
      • ¿Qué categorías existen?
      • ¿Puedo crear mi propia categoría?
  • Paginas
    • Aclaraciones
    • Editando una pagina
      • ¿Cómo edito una pagina?
      • ¿Qué tener en cuenta a la hora de editar?
    • Creando paginas
      • ¿Cómo creo una pagina?
    • Arreglando errores
      • Errores de formato y posibles acciones
      • Errores de contenido
  • Miselaneo
    • Vigilar
    • Historial
  • Final



Preferencias (Introductorio)
En esta sección del tutorial veremos como configurar nuestra cuenta. Para hacerlo, ingresaremos desde el margen superior izquierdo haciendo click en "preferences" (ver imagen).
Esta pagina no solo nos permite editar nuestras preferencias, si no también nos muestra algunos datos de nuestro usuario como el nombre e id (ver imagen).

Nota: Para aplicar los cambios realizados debemos hacer click en "Save" o "Grabar preferencias" (segun idioma seleccionado).


Idioma
Desde la pagina principal de preferencias seleccionamos el idioma deseado desde 'languages' (ver imagen).


Tema
El tema afecta como nosotros veremos la wiki, el mismo puede ser cambiado desde 'Piel' (ver imagen).


Edición
Las opciones de edición suelen ser muy útiles para ahorrar tiempo o evitar búsqueda de temas que editamos/creamos en algun momento, entre muchas otras utilidades (ver imagen).



El formato


Paginas
La wiki tiene un formato, el cual debe cumplirse para que exista una armonía en el contenido, links, templates, etc. Esto es por motivos de orden y estética visual, ya que si cada pagina fuera diferente, seria mas complejo entender o buscar información puntual. Así como también si existieran 20 templates para la misma acción, la edición de la wiki seria un desastre. Por eso, para que sea mas simple y ordenada tanto la edición, como la revisión y la lectura, los formatos son unicos.
Dado que muchos de ustedes realizaran traducciones, el formato para el link de una pagina en español es: "NombrePaginaEnIngles_ES". Notese que es case-sensitive (sensible a mayusculas), por lo que el "_ES" es único y no es ni "_eS", ni "_Es" ni "_es". Cambiar esta terminación llevara a conflictos entre links y no es bueno. (Inicialmente yo por ejemplo desconocía este formato y utilizaba "_Es"; como consecuencia todas las paginas (contenido, templates, categorias, etc.) que cree debí moverlos a "_ES", y créanme que es bastante tedioso hacer esto). Análogamente los nombres siempre van en mayúscula al comienzo de cada palabra, ej: "RelatedFunctions", ambas palabras comienzan en mayúscula.


Contenido & Templates
Cuando se edita el contenido de la wiki, como ya mencione anteriormente existen templates.

¿Qué es un template?
Un template es una "función" (generalmente indicada con símbolos o símbolos y palabras) la cual le da un formato al texto que se coloca dentro de la misma si es que acepta algún parámetro.

¿Para qué utilizar templates?
Los templates ahorran mucho trabajo, pues su única finalidad es ahorrar código y homogeneizar el contenido de la wiki.

¿Cómo utilizo un template?
Muy simple el formato para cualquier utilizar cualquier template es:
Code:
{{NombreDelTemplate|Parametro1|Parametro2|...}}
Ejemplo:
Supongamos que quieres agregar una nota (como la siguiente: imagen).

El codigo para la misma seria el siguiente:
Code:
{{Note ES|El parámetro opcional ''forcesync'' (el cual por defecto es 0), en la mayoría de los casos no es necesario, ya que los jugadores sincronizan las animaciones por si mismos.}}
¿Qué templates existen?
Los templates pueden ser creados por cualquier usuario, pero como dije antes, se debe evitar crear contenido repetido, no es lógico que haya 2 templates que realicen la misma acción.
Existen varias listas de templates separados por categorías (notese que las primeras 2 se encuentran en la ultima lista). Las mismas son:
  • FunctionTemplates_ES: Lista de templates para funciones en español (utilizados para la lista de funciones relacionadas).
  • CallbackTemplates_ES: Lista de templates para callbacks en español (utilizados para la lista de callbacks relacionados).
  • Templates: Lista de todos los templates de estilo (Ver notal al final de esta lista).

Nota: En esta lista encontraran que no existe una traducción para todos los templates en ingles, esto se debe a que algunos templates solo diferirían en el nombre del mismo pues no tienen contenido propio ej: "{{Param}}"; en estos casos se deben utilizar estos templates ya que no existe motivo para crear uno que solo difiera en el nombre.

¿Puedo crear mi propio template?
Si, pero antes de hacerlo revisa que no exista uno o una combinación de templates que realice lo que quieres. Si no existe puedes crearlo, pero ten en cuenta:
  • El template debe ser lo mas abarcativo posible y al mismo tiempo concreto. No intentes hacer un template que muchas cosas o no hará ninguna bien.
  • Si el template existe en ingles y necesitas traducirlo, basate en el existente en ingles para crear su traducción y utiliza el acrónimo "_ES" al final.
  • No te olvides de colocarlo en la categoría que corresponda.
  • No crees un template que solo sera utilizado una sola vez, pues no habria sentido.
  • Si no tienes demasiada idea de como hacerlo, no lo hagas o pide ayuda a alguien que entienda mas que vos y pueda ayudarte.


Categorias

¿Qué es una categoría?
Las categorías son paginas que se utilizan para juntar contenido de características similares (ej: Funciones agregadas en una versión particular).
Estas son paginas casi comunes, solo que delante del nombre de las mismas se coloca "Category:".

¿Cómo indico que una pagina pertenece a una categoría?
Para indicar que una pagina pertenece a X categoría, basta con colocar dentro de dicha pagina: "[[Category:X]]".

Ejemplo:
Para indicar que una pagina corresponde a la categoría de funciones en español, se debe agregar: "[[Category:Scripting Functions ES]]".

Nota: Noten que por cuestión de orden, siempre que se agrega la pertenencia de una pagina a una categoría se lo hace al final (o si se sabe lo que se hace en un template, ej: 0.3Added_ES, este template agregara según su contenido a la categoría correspondiente pues se hizo dinámico).

¿Qué categorías existen?
Al igual que los templates, las categorías, también pueden ser creadas por cualquier usuario, pero nuevamente debe evitarse la creación de 2 categorías con el mismo fin y diferente nombre ya que no se sabría donde buscar.
Para ver las categorías existentes pueden acceder a Categorías.

¿Puedo crear mi propia categoría?
Si, pero antes de hacerlo revisa que no exista una igual o similar a la que quieres crear. Si no existe puedes crearla, pero ten en cuenta:
  • Una categoría se utilizara para agrupar contenido, piensa bien que contenido corresponde a dicha categoría antes de crearla para darle un nombre apropiado.
  • En caso de traducciones: Si la categoría no existe en ingles, difícilmente debería existir en español.



Paginas


Aclaraciones
Para evitar problemas quiero hacer algunas aclaraciones antes de comenzar:
  • Si no sabes lo que editas NO EDITES.
  • Si no sabes lo que creas NO CREES.
  • Si no tienes en claro cual es el error exactamente, NO EDITES.
  • Si estas editando porque alguien lo dijo y tu no lo crees o no estas seguro, NO EDITES.
  • Si no vas a respetar el formato de la wiki o no conoces el mismo, NO EDITES NI CREES.
  • Si piensas cambiar algo porque no te gusta como esta dicho (pero el contenido es correcto), NO EDITES o consulta a alguien que tenga mas conocimientos que tu para que responda tu inquietud.
  • Si tienes algún ejemplo mejor que el que esta (si es que existe alguno), no borres el/los existentes, agrega el tuyo, para que haya mas variedad.
  • No deshagas el trabajo y esfuerzo de alguien mas solo porque tienes conflictos con dicho usuario.

Importante: La wiki al igual que el foro tiene administradores, ellos pueden expulsar y prohibir edición de contenido si un usuario hace las cosas mal. Esta en cada usuario hacer las cosas bien e informar sobre abusos de otros usuarios.


Editando paginas

¿Cómo edito una pagina?
Lo primero para editar una pagina es acceder al link de la misma, luego se debe hacer click en "editar" (ver imagen).
Una vez que hacemos click, nos cargara el contenido de la pagina con el formato del mismo, allí podremos editar el contenido y luego lo guardamos.

Nota: Al editar, se presta la posibilidad de agregar un motivo de la edición realizada. Utilicen esto ya que cuando uno revisa las ediciones realizadas, es bueno saber que se modifico entre una versión y la anterior sin necesidad de mirar (diff, diferencias de código).

¿Qué tener en cuenta a la hora de editar?
  • Las aclaraciones descritas anteriormente.
  • El formato de la wiki.
  • El uso de templates.
  • Tener muy el claro el contenido que se esta editando.
  • Chequear 2 veces lo que se esta escribiendo (todos somos humanos y nos equivocamos, pero si se revisa el contenido escrito, se pueden evitar varios errores).


Creando paginas

¿Cómo creo una pagina?
Similar a la edición de una pagina, lo primero es acceder al link que tendrá nuestra pagina. Una vez que lo abrimos nos dirá que no existe contenido y nos dará un cuadro de texto para ingresar el contenido de esa pagina.
Una vez finalizada la edición, guardamos y ya esta.

¿Qué tener en cuenta a la hora de crear una pagina?
  • Las aclaraciones descritas anteriormente.
  • El formato de la wiki.
  • El uso de templates.
  • Tener muy el claro el tema sobre el cual se creara esa pagina.
  • Chequear 2 veces lo que se esta escribiendo (todos somos humanos y nos equivocamos, pero si se revisa el contenido escrito, se pueden evitar varios errores).


Arreglando errores

Errores de formato y posibles acciones
  • Error en el link (pagina comun):
    Si el error esta en el link de la pagina, lo que debemos hacer es MOVER la pagina al link correcto según el formato (NUNCA COPIAR EL CONTENIDO DE LA PAGINA AL LINK CORRECTO Y ELIMINAR EL CONTENIDO DEL LINK VIEJO).

  • Error en el link (categorías, templates):
    Se realiza la misma acción que con un error en el link de una pagina comun, pero ademas deben buscarse todas las paginas que utilizan dicho template/categoría y corregirlas.

  • Error de formato:
    Podemos editar la pagina y corregir el formato al que corresponda.

Errores de contenido
Basta simplemente con arreglar el contenido para eliminar los datos erroneos.

Nota: Para mover una pagina se accede al link que se quiere mover y luego hacer click en "trasladar" (ver imagen). Luego escribir el nuevo nombre que se le dará a la pagina y agregar una descripción indicando el motivo del movimiento de la pagina.



Miselaneo


Vigilar
La opción vigilar (ver imagen) se utiliza para agregar una pagina a nuestra lista de vigilancia. Es decir que cualquier cambio que se realice en dicha pagina se nos informara.


Historial
El historial de una pagina (ver imagen) se utiliza para ver quienes editaron la pagina, quien la creo que cambios se realizaron en la misma.

Final
Bueno básicamente eso es todo lo básico de la wiki, el resto es practica. Cualquier duda que tengan como siempre estoy a su total disposición, realice como muchos saben la mayor parte de la traducción y me llevo bastante armar los formatos.
Aquí dejo agrupada la información mas importante a la hora de editar/crear paginas:
  • FunctionTemplates_ES: Lista de templates para funciones en español (utilizados para la lista de funciones relacionadas).
  • CallbackTemplates_ES: Lista de templates para callbacks en español (utilizados para la lista de callbacks relacionados).
  • Templates: Lista de todos los templates de estilo (Ver notal al final de esta lista).
  • Categorías.
__________________

Last edited by TheChaoz; 21/04/2014 at 08:28 PM. Reason: Fixed example.
TheChaoz is offline  
Old 21/04/2014, 03:52 AM   #2
OTACON
Banned
 
Join Date: Dec 2010
Location: mongolia
Posts: 5,175
Reputation: 569
Default Respuesta: Wiki

muy buena explicacion chaoz, para evitar futuros problemas.
saludos.

PD: seria mejor que lo coloques en 'Adheridos' para que no se pierda y este a la mano para los nuevos. ya se que no pueden editar pero para que esten informados.
OTACON is offline  
Old 21/04/2014, 03:54 AM   #3
TheChaoz
High-roller
 
TheChaoz's Avatar
 
Join Date: Dec 2009
Location: Argentina
Posts: 4,656
Reputation: 239
Default Respuesta: Wiki

Antes de que comiencen a crear temas en la wiki, podrían comenzar por aquí:
http://wiki.sa-mp.com/wiki/Category:...g_Callbacks_Es
o
http://wiki.sa-mp.com/wiki/NPC:Main_Page_ES
Como aclare en el post (y fue mi error) cree muchas paginas con la terminología "_Es" y no "_ES". Por falta de tiempo nunca termine de moverlas y en el link que allí deje, quedan varias. Estas paginas no solo deben ser movidas, si no que su formato debe ser corregido para que queden como las demás.

No digo esto para que lo hagan, si no para que no dupliquen paginas que ya existen.
__________________
TheChaoz is offline  
Old 21/04/2014, 03:56 AM   #4
Swedky
Banned
 
Join Date: Jun 2013
Location: Argentina.
Posts: 2,076
Reputation: 827
Default Respuesta: Wiki

En la categoría NPC, en las funciones, vi que todos terminan en '_Es', eso debe arreglarse, no? Yo me tomaría un tiempito para hacerlo en ese caso.

Y gracias por tomarte el tiempo haciendo este tuto. (:


EDIT: Ah, ok, entendido .
Swedky is offline  
Old 21/04/2014, 04:00 AM   #5
TheChaoz
High-roller
 
TheChaoz's Avatar
 
Join Date: Dec 2009
Location: Argentina
Posts: 4,656
Reputation: 239
Default Respuesta: Wiki

Si enzo, ahora lo agrego al post que hice mas arriba. Gracias por recordarmelo.
__________________
TheChaoz is offline  
Old 21/04/2014, 04:39 AM   #6
DesingMyCry
High-roller
 
Join Date: Dec 2010
Posts: 1,204
Reputation: 150
Default Respuesta: Wiki

No es por ser egoista, pero creo no debiste haber publicado esto. Por algo se cerraron los registros en la página, no crees? Estabamos bien con los actuales...
__________________
DesingMyCry is offline  
Old 21/04/2014, 11:52 AM   #7
adri1
Banned
 
Join Date: Oct 2010
Posts: 1,928
Reputation: 955
Default Respuesta: Wiki

Volvieron a abrir los registros??

EDIT: Ya vi como funciona.


Quote:
Originally Posted by DesingMyCry View Post
No es por ser egoista, pero creo no debiste haber publicado esto. Por algo se cerraron los registros en la página, no crees? Estabamos bien con los actuales...
La wiki está hecha para que sea creada por todos los usuarios.

Last edited by adri1; 21/04/2014 at 12:28 PM.
adri1 is offline  
Old 21/04/2014, 01:03 PM   #8
BecksLennon
Huge Clucker
 
BecksLennon's Avatar
 
Join Date: Jul 2012
Location: Argentina, Buenos Aires
Posts: 359
Reputation: 114
Default Respuesta: Wiki

Muy buen tuto, menos mal que lo hiciste chaoz y a avisaste si no mucho nos íbamos a mandar cagadas, Como enzo que siempre las hace :P

PD: Mentira enzo, te quero :P
BecksLennon is offline  
Old 21/04/2014, 03:17 PM   #9
Daniel_Ruiz
Huge Clucker
 
Daniel_Ruiz's Avatar
 
Join Date: Sep 2011
Location: Detras Tuyo O.o
Posts: 480
Reputation: 6
Default Respuesta: Wiki

Quote:
Originally Posted by DesingMyCry View Post
No es por ser egoista, pero creo no debiste haber publicado esto. Por algo se cerraron los registros en la página, no crees? Estabamos bien con los actuales...
Jajaj Ademas todo estaba en ingles y era un lio entender las funciones a hora sera mejor entenderlas. Buen post.
Daniel_Ruiz is offline  
Old 21/04/2014, 07:17 PM   #10
DesingMyCry
High-roller
 
Join Date: Dec 2010
Posts: 1,204
Reputation: 150
Default Respuesta: Wiki

Hacia alusión a que siempre llega a la fiesta personajes que van solo a molestar...
__________________
DesingMyCry is offline  
 

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


Similar Threads
Thread Thread Starter Forum Replies Last Post
Samp members wiki. Your own wiki page on sampmembers.wikia.com. Invite everyone! RajatPawar Everything and Nothing 13 16/01/2013 08:27 PM
SA:MP wiki www. MP2 General 9 21/11/2011 01:38 PM
Limits help? http://wiki.sa-mp.com/wiki/Limits Kar General 2 26/08/2011 11:36 AM
Creating a .PDF file from http://wiki.sa-mp.com/wiki/ LZLo Everything and Nothing 41 04/08/2011 05:36 PM
[WIKI] How am i able to add information to the Sa-Mp Wiki? Carlos_Leone General 3 28/03/2009 01:53 PM


All times are GMT. The time now is 10:05 AM.


Powered by vBulletin® Version 3.8.6
Copyright ©2000 - 2018, Jelsoft Enterprises Ltd.