Difference between revisions of "LSL Editing Primer/es"

From Second Life Wiki
Jump to navigation Jump to search
m
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{Multi-lang}}
{{Multi-lang}}
{{LSL Header}}
{{LSL Header{{#var:lang}}}}


__TOC__
__TOC__
Line 382: Line 382:


[[Template:LSL Function]]<br/>
[[Template:LSL Function]]<br/>
Esta plantilla provee una estructura para reescribir las funciones de documentación y incluye varias secciones.
Esta plantilla provee una estructura para reescribir las funciones de documentación e incluye varias secciones.


*No quite la información.
*No quite la información.
Line 508: Line 508:
[[Template:LSL Constant|LSL_Constant]]
[[Template:LSL Constant|LSL_Constant]]
Esta plantilla provee una estructura para reescribir la documentación de constantes e incluye varias secciones. Secciones sin usar típicamente se ocultan.  
Esta plantilla provee una estructura para reescribir la documentación de constantes e incluye varias secciones. Secciones sin usar típicamente se ocultan.  
Consulte [[Template:LSL Constant|LSL_Constant]] para una explicación detallada de su sintaxis y atributos.
Consulte [[Template:LSL Constant|LSL_Constant]] para una explicación detallada de su sintaxis y atributos.

Latest revision as of 16:31, 24 October 2008

En esta sección del Portal LSL del wiki hay varias plantillas en uso para uniformar la apariencia y hacer la edición más fácil.

Plantillas Generales

Hay varias plantillas universales y los nombres de plantillas más usados son cortos para facilidad de uso.

Nombre Descripción ejemplo
{{LSLC|category|sort}} Añade una página al grupo
Use en vez de [[Category:LSL name|name]]
clasificar (sort) es opcional.
{{LSLGC|category|text}} Une a una Categoría LSL
Use en vez de [[:Category:LSL category|text]]
si text se omite entonces vuelve al valor predeterminado de category
{{LSLGC|Math/3D|3D Math Functions}}
3D Math Functions
{{LSLGC|Math}}
Math
{{HoverText|word|description}} Cuando mueve el cursor sobre esta área muestra una casilla que contiene description. {{HoverText|monkeys|A species of mammal}}
monkeys
{{LSL_Header}} Usado en páginas que no usan una plantilla que le incluya. Como categorías y esta página. {{LSL Header}}
{{LSL_Hex|hex|int}} Un texto suspdendido (HoverText) para hex que muestra el int con una descripción corta uniforme.
Si int se excluye o esta vacia entonces int se calcula de hex.
{{LSL Hex|0x100|256}}
0x100
{{LSL Hex|0x100}}
0x100
{{!}} Usado en vez de | cuando se integran en los parámetros de la plantilla. {{!}}
|
{{=}} Usado en vez de = cuando necesitas un símbolo de igual en el texto que no interfiera con los parámetros de la plantilla. {{=}}
=

Tablas Integradas

Una de las desventajas en MediaWiki es la dificultad integrando tablas como parámetros para las plantillas. Hay varias alternativas para lidiar con esta situación.

  1. Escribe la tabla en HTML usando las etiquetas <table> & </table>, <tr> & </tr>, <th> & </th>, <td> & </td>. Si escoge esta opción debe cerrar sus etiquetas correctamente (o MediaWiki hará cosas extrañas).
  2. Use la sintaxis de MediaWiki para las tablas y sustituya cada acontecimiento (que no se esté usando como un separador de plantilla) de '|' con '{{!}}'
  3. Envuelva la tabla con etiquetas <div></div> (no funciona siempre).
  • Fíjese que puede tener que jugar con el espacio en blanco para lograr que MediaWiki lo muestre correctamente.


Método HTML
Antes Después Integrado
{|{{Prettytable}}
! Permisos
! Valor
! Descripción
|- 
| [[PERM_ALL]]
| {{LSL Hex|0x7FFFFFFF|2147483647}}
| Mover/Modificar/Copiar/Transferir permisos
|- 
| [[PERM_COPY]]
| {{LSL Hex|0x00008000|32768}}
| Copiar permiso
|- 
| [[PERM_MODIFY]]
| {{LSL Hex|0x00004000|16384}}
| Modificar permiso
|- 
| [[PERM_MOVE]]
| {{LSL Hex|0x00080000|524288}}
| Mover permiso
|- 
| [[PERM_TRANSFER]]
| {{LSL Hex|0x00002000|8192}}
| Transferir permiso
|}
<table {{Prettytable}}><tr>
<th> Permisos</th>
<th> Valor</th>
<th> Descripción</th>
</tr><tr>
<td> [[PERM_ALL]]</td>
<td> {{LSL Hex|0x7FFFFFFF|2147483647}}</td>
<td> Mover/Modificar/Copiar/Transferir permisos</td>
</tr><tr>
<td> [[PERM_COPY]]</td>
<td> {{LSL Hex|0x00008000|32768}}</td>
<td> Copiar permiso</td>
</tr><tr>
<td> [[PERM_MODIFY]]</td>
<td> {{LSL Hex|0x00004000|16384}}</td>
<td> Modificar permiso</td>
</tr><tr>
<td> [[PERM_MOVE]]</td>
<td> {{LSL Hex|0x00080000|524288}}</td>
<td> Mover permiso</td>
</tr><tr>
<td> [[PERM_TRANSFER]]</td>
<td> {{LSL Hex|0x00002000|8192}}</td>
<td> Transferir permiso</td>
</tr></table>

Tabla dentro de Tabla:

Permisos Valor Descripción
PERM_ALL 0x7FFFFFFF Mover/Modificar/Copiar/Transferir permisos
PERM_COPY 0x00008000 Copiar permiso
PERM_MODIFY 0x00004000 Modificar permiso
PERM_MOVE 0x00080000 Mover permiso
PERM_TRANSFER 0x00002000 Transferir permiso

Tabla como parámetro de plantilla:

Permisos Valor Descripción
PERM_ALL 0x7FFFFFFF Mover/Modificar/Copiar/Transferir permisos
PERM_COPY 0x00008000 Copiar permiso
PERM_MODIFY 0x00004000 Modificar permiso
PERM_MOVE 0x00080000 Mover permiso
PERM_TRANSFER 0x00002000 Transferir permiso
Método de Pipe Replacement
Antes Después Integrado
{|{{Prettytable}}
! Permisos
! Valor
! Descripción
|- 
| [[PERM_ALL]]
| {{LSL Hex|0x7FFFFFFF|2147483647}}
| Mover/Modificar/Copiar/Transferir permisos
|- 
| [[PERM_COPY]]
| {{LSL Hex|0x00008000|32768}}
| Copiar permiso
|- 
| [[PERM_MODIFY]]
| {{LSL Hex|0x00004000|16384}}
| Modificar permiso
|- 
| [[PERM_MOVE]]
| {{LSL Hex|0x00080000|524288}}
| Mover permiso
|- 
| [[PERM_TRANSFER]]
| {{LSL Hex|0x00002000|8192}}
| Transferir permiso
|}
{{{!}}{{Prettytable}}
! Permisos
! Valor
! Descripción
{{!}}- 
{{!}} [[PERM_ALL]]
{{!}} {{LSL Hex|0x7FFFFFFF|2147483647}}
{{!}} Mover/Modificar/Copiar/Transferir permisos
{{!}}- 
{{!}} [[PERM_COPY]]
{{!}} {{LSL Hex|0x00008000|32768}}
{{!}} Copiar permiso
{{!}}- 
{{!}} [[PERM_MODIFY]]
{{!}} {{LSL Hex|0x00004000|16384}}
{{!}} Modificar permiso
{{!}}- 
{{!}} [[PERM_MOVE]]
{{!}} {{LSL Hex|0x00080000|524288}}
{{!}} Mover permiso
{{!}}- 
{{!}} [[PERM_TRANSFER]]
{{!}} {{LSL Hex|0x00002000|8192}}
{{!}} Transferir permiso
{{!}}}

Tabla dentro de Tabla:

Permisos Valor Descripción
PERM_ALL 0x7FFFFFFF Mover/Modificar/Copiar/Transferir permisos
PERM_COPY 0x00008000 Copiar permiso
PERM_MODIFY 0x00004000 Modificar permiso
PERM_MOVE 0x00080000 Mover permiso
PERM_TRANSFER 0x00002000 Transferir permiso

Tabla como parámetro de plantilla:

Permisos Valor Descripción
PERM_ALL 0x7FFFFFFF Mover/Modificar/Copiar/Transferir permisos
PERM_COPY 0x00008000 Copiar permiso
PERM_MODIFY 0x00004000 Modificar permiso
PERM_MOVE 0x00080000 Mover permiso
PERM_TRANSFER 0x00002000 Transferir permiso
Método Div Tag (no funciona siempre)
Antes Después Integrado
{|{{Prettytable}}
! Permisos
! Valor
! Descripción
|- 
| [[PERM_ALL]]
| {{LSL Hex|0x7FFFFFFF|2147483647}}
| Mover/Modificar/Copiar/Transferir permisos
|- 
| [[PERM_COPY]]
| {{LSL Hex|0x00008000|32768}}
| Copiar permiso
|- 
| [[PERM_MODIFY]]
| {{LSL Hex|0x00004000|16384}}
| Modificar permiso
|- 
| [[PERM_MOVE]]
| {{LSL Hex|0x00080000|524288}}
| Mover permiso
|- 
| [[PERM_TRANSFER]]
| {{LSL Hex|0x00002000|8192}}
| Transferir permiso
|}
<div>
{|{{Prettytable}}
! Permisos
! Valor
! Descripción
|- 
| [[PERM_ALL]]
| {{LSL Hex|0x7FFFFFFF|2147483647}}
| Mover/Modificar/Copiar/Transferir permisos
|- 
| [[PERM_COPY]]
| {{LSL Hex|0x00008000|32768}}
| Copiar permiso
|- 
| [[PERM_MODIFY]]
| {{LSL Hex|0x00004000|16384}}
| Modificar permiso
|- 
| [[PERM_MOVE]]
| {{LSL Hex|0x00080000|524288}}
| Mover permiso
|- 
| [[PERM_TRANSFER]]
| {{LSL Hex|0x00002000|8192}}
| Transferir permiso
|}
</div>

Tabla dentro de Tabla:

Permisos Valor Descripción
PERM_ALL 0x7FFFFFFF Mover/Modificar/Copiar/Transferir permisos
PERM_COPY 0x00008000 Copiar permiso
PERM_MODIFY 0x00004000 Modificar permiso
PERM_MOVE 0x00080000 Mover permiso
PERM_TRANSFER 0x00002000 Transferir permiso

Funciones

Además de las plantillas generales hay solo una plantilla con función específica.


Template:LSL Function
Esta plantilla provee una estructura para reescribir las funciones de documentación e incluye varias secciones.

  • No quite la información.
  • La orden de las variables no importa.
  • Muchas variables, si no se declaran, causarán que la sección pertinente se esconda (no todas las secciones se esconden)
  • Variables sin usar no necesitan ser incluidas pero es mejor no removerlas para ayudar a editores futuros.
  • Sírvase poner cabezera a todos los mensajes generados por la plantilla.
  • Si piensa que debe añadirse una sección sírvase añadirla a LSL Function Style (y se añadirán prontamente a la plantilla).

Consulte LSL_Function para una explicación detallada de su sintaxis y atributos.

Base Example: llFrand
{{LSL_Function
|func
|func_id
|func_sleep
|sort
|func_desc
|func_footnote
|return_type
|return_text
|p1_type|p1_name|p1_desc
|p2_type|p2_name|p2_desc
|p3_type|p3_name|p3_desc
|p4_type|p4_name|p4_desc
|p5_type|p5_name|p5_desc
|p6_type|p6_name|p6_desc
|p7_type|p7_name|p7_desc
|p8_type|p8_name|p8_desc
|p9_type|p9_name|p9_desc
|p10_type|p10_name|p10_desc
|p11_type|p11_name|p11_desc
|p12_type|p12_name|p12_desc
|constants
|spec
|caveats
|examples
|helpers
|also_header
|also_functions
|also_tests
|also_articles
|also_events
|also_footer
|notes
|mode
|deprecated
|permission
|negative_index
|cat1
|cat2
|cat3
|cat4
|cat5
|cat6
|location
}}
{{LSL_Function
|sort=Frand
|func=llFrand
|func_id=8
|func_sleep=0.0
|func_energy=10.0
|p1_type=float
|p1_name=mag
|p1_desc=Any valid float value
|return_type=float
|return_text=that is pseudo random number in the range [0.0,mag) or (mag, 0.0].
|spec=returns a pseudo random number in range [0.0, mag) or (mag, 0.0], depending upon the sign of mag.
|caveats=The random number generator is not a source of entropy.
|examples=<lsl>
default
{
    touch_start(integer total_number)
    {
        // When touched, say "Heads" with probability 0.5, 
        // otherwise, say "Tails."
        if ( llFrand(1.) < .5)
            llSay(0, "Heads");
        else
            llSay(0, "Tails");
    }
}
</lsl>
|helpers
|also_header
|also_functions
|also_tests
|also_events
|also_articles
|also_footer
|notes=
The random number generator is not a source of entropy.

The sequence of random numbers are shared across the entire process, and not independently seeded.
Therefore, the pseudo random number generation is not suitable for any application which requires
completely predictable or completely unpredictable results.
|cat1=Math
|cat2
|cat3
|cat4
}}

Eventos

Ademas de las plantillas generales hay una sola plantilla para eventos específicos.

LSL_Event Esta plantilla provee una estructura para reescribir la documentación de eventos e incluye varias secciones. Secciones sin usar típicamente se ocultan.

Consulte LSL_Event para una explicación detallada de su sintaxis y atributos.

Constantes

Solo hay una plantilla con constante específica.

LSL_Constant Esta plantilla provee una estructura para reescribir la documentación de constantes e incluye varias secciones. Secciones sin usar típicamente se ocultan.

Consulte LSL_Constant para una explicación detallada de su sintaxis y atributos.