21.04.2014, 03:39
(
Последний раз редактировалось TheChaoz; 21.04.2014 в 20:28.
Причина: Fixed example.
)
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
- Idioma
- 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?
- їQuй es un 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?
- їQuй es una categorнa?
- Paginas
- Paginas
- Aclaraciones
- Editando una pagina
- їCуmo edito una pagina?
- їQuй tener en cuenta a la hora de editar?
- їCуmo edito una pagina?
- Creando paginas
- їCуmo creo una pagina?
- їCуmo creo una pagina?
- Arreglando errores
- Errores de formato y posibles acciones
- Errores de contenido
- Errores de formato y posibles acciones
- Aclaraciones
- Miselaneo
- Vigilar
- Historial
- Vigilar
- 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:
Код:
{{NombreDelTemplate|Parametro1|Parametro2|...}}
Supongamos que quieres agregar una nota (como la siguiente: imagen).
El codigo para la misma seria el siguiente:
Код:
{{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.}}
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).
ї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.
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.
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.
.
