Difference between revisions of "Guidelines (Español)"

m (Added link to 'Help:i18n (Español)')
(Corrected errors of translation.)
 
Line 1: Line 1:
Además de las reglas que hay a continuación, mira la sección [[Help:i18n (Español)|Ayuda:i18n]] para que puedas realizar una correcta traducción a nuestro idioma de esta Wiki.
+
Además de las reglas que hay a continuación, se aconseja mirar la sección [[Help:i18n (Español)|Ayuda:i18n]] para poder realizar una correcta traducción a nuestro idioma.
  
 
----
 
----
  
'''¡Esta traducción no es necesarea! ¡En caso de duda, acudir al [[Guidelines|original]] en inglés!'''
+
'''¡Esta traducción no es necesaria! ¡En caso de duda, acudir al [[Guidelines|original]] en inglés!'''
  
Todos los usuarios registrados están autorizados para editar la sección wiki, pero se te pide por favor, que sigas las siguientes guías/reglas para mantener el formato de la wiki y así poder evitar confusiones. Si opinas que las guías/reglas deberían cambiar o podrían contener información adicional, por favor no dudes en ponerte en contacto con [[User:Rude|Rude]] (en inglés).
+
Todos los usuarios registrados están autorizados a editar la sección wiki, pero se pide por favor, que se sigan las siguientes reglas para mantener el formato del wiki y así poder evitar confusiones. Si opinas que las reglas deberían cambiar o podrían contener información adicional, por favor no dudes en ponerte en contacto con [[User:Rude|Rude]] (en inglés).
  
 
== Objetivo ==
 
== Objetivo ==
Line 19: Line 19:
 
== Conflicto de Nombres ==
 
== Conflicto de Nombres ==
  
Para evitar enlaces con demasiados paréntesis, las páginas de la documentación tienen títulos simples sin prefijos ni sufijos. Por ejemplo, el tipo [[Image]] puede hacer referencia de forma externa a través de http://love2d.org/wiki/Image.
+
Para evitar enlaces con demasiados paréntesis, las páginas de la documentación tienen títulos simples sin prefijos ni sufijos. Por ejemplo, el tipo [[Image|Imagen]] puede hacer referencia de forma externa a través de http://love2d.org/wiki/Image.
  
Esto en ocasiones pude generar un conflicto de nombres, en cuyo caso las páginas de la documentación siempre ganan. Por ejemplo, si creas un juego llamado ''Alucinante'' y después LÖVE decide exponer un nuevo tipo llamado ''Alucinante'' (no del todo improbable), entonces tu juego se moverá a otro título.
+
Esto en ocasiones puede generar un conflicto de nombres, en cuyo caso las páginas de la documentación siempre ganan. Por ejemplo, si creas un juego llamado ''Alucinante'' y después LÖVE decide exponer un nuevo tipo llamado ''Alucinante'' (no del todo improbable), entonces tu juego se moverá a otro título.
  
 
== Estilo ==
 
== Estilo ==
Si estamos hablando de tipos integrados en LÖVE, enlázalos. Por ejemplo, [[Image]] es un objeto que se puede visualizar en la pantalla.
+
Si estamos hablando de tipos integrados en LÖVE, enlázalos. Por ejemplo, [[Image|Imagen]] es un objeto que se puede visualizar en la pantalla.
  
Cuando hacemos referencia a variables y a código dentro de un sentencia regular, utiliza la etiqueta <nowiki><code></nowiki> para mejorar la experiencia de lectura. Por ejemplo: cuando agregas <code>foo</code> y <code>bar</code>, el resultado es <code>foobar</code>.
+
Cuando hacemos referencia a variables y a código dentro de un sentencia regular, utiliza la etiqueta <nowiki><code></nowiki> para mejorar la experiencia de lectura. Por ejemplo: cuando agregas <code>foo</code> y <code>bar</code>, el resultado es <code>foobar</code>.
  
 
== Documentación ==
 
== Documentación ==
Line 32: Line 32:
 
Las páginas de la documentación ''deben'' seguir la misma estructura, para que puedan ser comprendidas y utilizadas por los usuarios.
 
Las páginas de la documentación ''deben'' seguir la misma estructura, para que puedan ser comprendidas y utilizadas por los usuarios.
  
Todas las páginas de la documentación deben tener un vínculo (link) de semántica a sus padres en la sección ''Véase También''. Sin esto, el elemento no aparecerá en las listas automáticas a través de la wiki. Un vínculo semántico se añade así a una función, tipo o enumeración en [[love.audio]]:
+
Todas las páginas de la documentación deben tener un vínculo (link) de semántica a sus padres en la sección ''Véase También''. Sin esto, el elemento no aparecerá en las listas automáticas a través del wiki. Un vínculo semántico se añade así a una función, tipo o enumeración en [[love.audio]]:
  
 
<pre>
 
<pre>
Line 55: Line 55:
 
* Véase También
 
* Véase También
  
Todos los módulos deben estar asociados con [[:Category:Modules]].
+
Todos los módulos deben estar asociados con [[:Category:Modules|Categoría:Módulos]].
  
 
=== Tipos ===
 
=== Tipos ===
Line 69: Line 69:
 
* Véase También
 
* Véase También
  
Todos los tipos deben estar asociados con [[:Category:Types]].
+
Todos los tipos deben estar asociados con [[:Category:Types|Categoria:Tipos]].
  
 
=== Funciones ===
 
=== Funciones ===
Line 75: Line 75:
 
Para las funciones, todos los encabezados son ''requeridos'', excepto ''Notas'', ''Ejemplos'' y ''Véase También''. Esto significa que si una función no devuelve nada, debería decir explícitamente que no devuelve nada. Lo mismo ocurre con los argumentos.
 
Para las funciones, todos los encabezados son ''requeridos'', excepto ''Notas'', ''Ejemplos'' y ''Véase También''. Esto significa que si una función no devuelve nada, debería decir explícitamente que no devuelve nada. Lo mismo ocurre con los argumentos.
  
Del mismo modo, si no hay constructores de un tipo determinado (p. ej. [[Contact]]), esto debe mencionarse explícitamente.
+
Del mismo modo, si no hay constructores de un tipo determinado (p. ej. [[Contact|Contacto]]), esto debe mencionarse explícitamente.
  
 
Los elementos externos de la lista a continuación son encabezados de 'nivel 2' y los internos de 'nivel 3':
 
Los elementos externos de la lista a continuación son encabezados de 'nivel 2' y los internos de 'nivel 3':
Line 88: Line 88:
 
* Véase También
 
* Véase También
  
Si una función tiene sobrecargas (overloads), repetir los encabezados de la 'Función' por cada sobrecarga. Esto no es necesario para la adición de argumentos opcionales, simplemente indica el valor por defecto entre paréntesis en su lugar.
+
Si una función tiene sobrecargas (overloads), repite los encabezados de la 'Función' por cada sobrecarga. Esto no es necesario para la adición de argumentos opcionales, simplemente indica el valor por defecto entre paréntesis en su lugar.
  
Los argumentos y los valores de retorno deben ser presentados como una lista de definiciones, utilizando [[:Template:param]].
+
Los argumentos y los valores de retorno deben ser presentados como una lista de definiciones, utilizando [[:Template:param|Plantilla:param]].
  
Todos las funciones deben estar asociadas con [[:Category:Functions]].
+
Todos las funciones deben estar asociadas con [[:Category:Functions|Plantilla:Funciones]].
  
 
=== Enumeraciones ===
 
=== Enumeraciones ===
Line 104: Line 104:
 
Las constantes deben aparecer como una lista de definiciones.
 
Las constantes deben aparecer como una lista de definiciones.
  
Todos las enumeraciones deben estar asociadas con [[:Category:Enums]].
+
Todos las enumeraciones deben estar asociadas con [[:Category:Enums|Categoria:Enumeraciones]].
  
 
== Juegos ==
 
== Juegos ==
  
Para los juegos, puedes elegir tu propia estructura, pero siempre hay que añadir algunas propiedades semánticas a la página para que aparezca correctamente en la [[:Category:Games|lista de juegos]]:
+
Para los juegos, puedes elegir tu propia estructura, pero siempre hay que añadir algunas propiedades semánticas a la página para que aparezca correctamente en la [[:Category:Games|Categoria:Juegos]]:
  
 
<pre>
 
<pre>
Line 115: Line 115:
 
{{#set:Genre=Que tipo de juego es.}}
 
{{#set:Genre=Que tipo de juego es.}}
 
{{#set:LOVE Version=0.6.1}}
 
{{#set:LOVE Version=0.6.1}}
{{#set:Description=Una breve descripcion de tu juego.}}
+
{{#set:Description=Una breve descripción de tu juego.}}
 
{{#set:Screenshot=File:ImagenURL.png}}
 
{{#set:Screenshot=File:ImagenURL.png}}
 
</pre>
 
</pre>
Line 121: Line 121:
 
Las capturas de pantalla serán automáticamente cambiadas de tamaño para que se adapten a una resolución de 161x100 pixeles.
 
Las capturas de pantalla serán automáticamente cambiadas de tamaño para que se adapten a una resolución de 161x100 pixeles.
  
Pon tu juego en [[:Category:Games]] para que aparezca automáticamente en la página [[Games]]. Para ponerlo en la categoría correcta, debes añadir esta linea al final de la página:
+
Pon tu juego en [[:Category:Games|Categoria:Juegos]] para que aparezca automáticamente en la página [[Games|Juegos]]. Para ponerlo en la categoría correcta, debes añadir esta linea al final de la página:
  
 
<pre>
 
<pre>
[[Category:Games]]
+
[[Category:Games|Categoria:Juegos]]
 
</pre>
 
</pre>
  
También se recomienda que proporciones imágenes de tu juego.
+
También se recomienda proporcionar imágenes de tu juego.
  
 
== Librerías ==
 
== Librerías ==
Line 138: Line 138:
 
</pre>
 
</pre>
  
Pon tu librería en [[:Category:Libraries]] para que aparezca automáticamente en la página de [[Libraries]]. Para ponerla en la categoría correcta, debes añadir esta linea al final de la página:
+
Pon tu librería en [[:Category:Libraries|Categoria:Librerías]] para que aparezca automáticamente en la página de [[Libraries|Librerías]]. Para ponerla en la categoría correcta, debes añadir esta linea al final de la página:
  
 
<pre>
 
<pre>
[[Category:Libraries]]
+
[[Category:Libraries|Categoria:Librerías]]
 
</pre>
 
</pre>

Latest revision as of 22:58, 14 January 2012

Además de las reglas que hay a continuación, se aconseja mirar la sección Ayuda:i18n para poder realizar una correcta traducción a nuestro idioma.


¡Esta traducción no es necesaria! ¡En caso de duda, acudir al original en inglés!

Todos los usuarios registrados están autorizados a editar la sección wiki, pero se pide por favor, que se sigan las siguientes reglas para mantener el formato del wiki y así poder evitar confusiones. Si opinas que las reglas deberían cambiar o podrían contener información adicional, por favor no dudes en ponerte en contacto con Rude (en inglés).

Objetivo

Los principales objetivos del wiki son los siguientes:

  1. Documentar la API de LÖVE y proporcionar tutoriales.
  2. Proporcionar información acerca de juegos y librerías usadas en LÖVE.

Dicho esto, está totalmente permitido añadir cualquier tipo de información que no entre dentro de estas categorías.

Si deseas realizar cambios importantes en el wiki, como por ejemplo "el despliegue de una nueva estructura para los tipos predefinidos", no lo hagas. Debes hablar con Rude primero, de no ser así, existe una gran probabilidad de que los cambios que realices puedan ser revertidos/eliminados.

Conflicto de Nombres

Para evitar enlaces con demasiados paréntesis, las páginas de la documentación tienen títulos simples sin prefijos ni sufijos. Por ejemplo, el tipo Imagen puede hacer referencia de forma externa a través de http://love2d.org/wiki/Image.

Esto en ocasiones puede generar un conflicto de nombres, en cuyo caso las páginas de la documentación siempre ganan. Por ejemplo, si creas un juego llamado Alucinante y después LÖVE decide exponer un nuevo tipo llamado Alucinante (no del todo improbable), entonces tu juego se moverá a otro título.

Estilo

Si estamos hablando de tipos integrados en LÖVE, enlázalos. Por ejemplo, Imagen es un objeto que se puede visualizar en la pantalla.

Cuando hacemos referencia a variables y a código dentro de un sentencia regular, utiliza la etiqueta <code> para mejorar la experiencia de lectura. Por ejemplo: cuando agregas foo y bar, el resultado es foobar.

Documentación

Las páginas de la documentación deben seguir la misma estructura, para que puedan ser comprendidas y utilizadas por los usuarios.

Todas las páginas de la documentación deben tener un vínculo (link) de semántica a sus padres en la sección Véase También. Sin esto, el elemento no aparecerá en las listas automáticas a través del wiki. Un vínculo semántico se añade así a una función, tipo o enumeración en love.audio:

[[parent::love.audio]]

Todas las páginas de la documentación deben tener una descripción semántica, 'list-friendly'. Esto se consigue al añadir al final de la página lo siguiente:

{{#set:Description=Dibuja una [[Imagen]] en la pantalla.}}

Módulos

Los siguientes encabezados de 'nivel 2' están permitidos, pero solo se deben utilizar si contienen algo:

  • Tipos
  • Funciones
  • Enumeraciones
  • Notas
  • Ejemplos
  • Véase También

Todos los módulos deben estar asociados con Categoría:Módulos.

Tipos

Los siguientes encabezados de 'nivel 2' están permitidos, pero nuevamente, no las utilices y las dejes vacías:

  • Funciones
  • Enumeraciones
  • Supertipos
  • Subtipos
  • Notas
  • Ejemplos
  • Véase También

Todos los tipos deben estar asociados con Categoria:Tipos.

Funciones

Para las funciones, todos los encabezados son requeridos, excepto Notas, Ejemplos y Véase También. Esto significa que si una función no devuelve nada, debería decir explícitamente que no devuelve nada. Lo mismo ocurre con los argumentos.

Del mismo modo, si no hay constructores de un tipo determinado (p. ej. Contacto), esto debe mencionarse explícitamente.

Los elementos externos de la lista a continuación son encabezados de 'nivel 2' y los internos de 'nivel 3':

  • Constructores
  • Función
    • Sinopsis
    • Argumentos
    • Retornos
  • Notas
  • Ejemplos
  • Véase También

Si una función tiene sobrecargas (overloads), repite los encabezados de la 'Función' por cada sobrecarga. Esto no es necesario para la adición de argumentos opcionales, simplemente indica el valor por defecto entre paréntesis en su lugar.

Los argumentos y los valores de retorno deben ser presentados como una lista de definiciones, utilizando Plantilla:param.

Todos las funciones deben estar asociadas con Plantilla:Funciones.

Enumeraciones

Para las enumeraciones, estos encabezados están permitidos:

  • Constantes
  • Notas
  • Véase También

Las constantes deben aparecer como una lista de definiciones.

Todos las enumeraciones deben estar asociadas con Categoria:Enumeraciones.

Juegos

Para los juegos, puedes elegir tu propia estructura, pero siempre hay que añadir algunas propiedades semánticas a la página para que aparezca correctamente en la Categoria:Juegos:

{{#set:Name=Monkey Island}} (Debería ser el mismo que el titulo de la página)
{{#set:Author=User:Rude}}
{{#set:Genre=Que tipo de juego es.}}
{{#set:LOVE Version=0.6.1}}
{{#set:Description=Una breve descripción de tu juego.}}
{{#set:Screenshot=File:ImagenURL.png}}

Las capturas de pantalla serán automáticamente cambiadas de tamaño para que se adapten a una resolución de 161x100 pixeles.

Pon tu juego en Categoria:Juegos para que aparezca automáticamente en la página Juegos. Para ponerlo en la categoría correcta, debes añadir esta linea al final de la página:

[[Category:Games|Categoria:Juegos]]

También se recomienda proporcionar imágenes de tu juego.

Librerías

No hay reglas estrictas, pero al igual que en los juegos, debes añadir estas propiedades semánticas:

{{#set:LOVE Version=0.6.1}}
{{#set:Description=Una breve descripción de tu librería.}}

Pon tu librería en Categoria:Librerías para que aparezca automáticamente en la página de Librerías. Para ponerla en la categoría correcta, debes añadir esta linea al final de la página:

[[Category:Libraries|Categoria:Librerías]]