LSL Editing Primer/ko

From Second Life Wiki
Jump to: navigation, search

LSL 포털위키에는 시각적인 표준화를 추구하고 편집을 용이하게 하기 위한 몇 가지의 틀이 있다.

일반 틀

전역틀은 가장 자주 쓰이며 타자를 쉽게 하기 위해 짧게 이름지어졌다.

이름 설명 예제
{{LSLC|분류|정렬}} 페이지에 그룹을 더한다.
[[Category:LSL name|name]]대신 사용한다.
정렬은 선택사항.
{{LSLGC|분류|글월}} LSL 분류로 연결한다.
[[:Category:LSL category|글월]]대신 사용한다.

글월이 생략될 경우 분류로 자동 대치된다.

{{LSLGC|Math/3D|3D 수학함수}}
3D 수학함수
{{LSLGC|Math}}
Math
{{HoverText|단어|설명}} '단어'위에 커서를 가져가면 설명이 담긴 풍선도움말이 뜬다. {{HoverText|원숭이|포유류의 한 종}}
원숭이
{{LSL_Header}} 페이지에 포함된 틀을 이용하지 않을 때 사용된다. 이를테면 분류나 현재 페이지. {{LSL Header}}
{{LSL_Hex|16진수|정수}} 16진수에 간략한 표준 설명과 함께 정수로 풍선도움말이 나타나게 한다.
만약 정수 부분이 제외되거나 비어있을 경우, 16진수에서 변환된 정수가 나타난다.
{{LSL Hex|0x100|256}}
0x100
{{LSL Hex|0x100}}
0x100
{{!}} 틀 매개변수에 포함시킬 때 |대신 사용한다. {{!}}
|
{{=}} 글월 속의 등호 부호가 틀의 매개변수들과 엉키지 않게 하기 위해 =대신 사용한다. {{=}}
=

표 삽입

미디어위키의 결점 중 하나는 표를 틀의 매개변수로 삽입하는 작업이 까다롭다는 것이다. 여기 몇 가지 방법이 있다.

  1. 표를 HTML 태그 <table> & </table>, <tr> & </tr>, <th> & </th>, <td> & </td> 등으로 작성한다. 태그를 올바로 닫게 주의를 기울여야한다(그렇지않으면 미디어위키는 이상한 결과를 초래할 것이다).
  2. 표에 대한 MediaWiki 구문법을 사용하고 (틀 분리기로 사용되지 않게 하기 위해) 모든 '|'을 '{{!}}'으로 대치한다.
  3. 표를 <div></div> 태그로 감싼다(항상 작동하지는 않는다).
  • 미디어위키가 제대로 출력되려면 공백을 적절히 사용해야함에 유의할 것.


HTML 방법
적용전 적용후 삽입
{|{{Prettytable}}
! Permissions
! Value
! Description
|- 
| [[PERM_ALL]]
| {{LSL Hex|0x7FFFFFFF|2147483647}}
| Move/Modify/Copy/Transfer permissions
|- 
| [[PERM_COPY]]
| {{LSL Hex|0x00008000|32768}}
| Copy permission
|- 
| [[PERM_MODIFY]]
| {{LSL Hex|0x00004000|16384}}
| Modify permission
|- 
| [[PERM_MOVE]]
| {{LSL Hex|0x00080000|524288}}
| Move permission
|- 
| [[PERM_TRANSFER]]
| {{LSL Hex|0x00002000|8192}}
| Transfer permission
|}
<table {{Prettytable}}><tr>
<th> Permissions</th>
<th> Value</th>
<th> Description</th>
</tr><tr>
<td> [[PERM_ALL]]</td>
<td> {{LSL Hex|0x7FFFFFFF|2147483647}}</td>
<td> Move/Modify/Copy/Transfer permissions</td>
</tr><tr>
<td> [[PERM_COPY]]</td>
<td> {{LSL Hex|0x00008000|32768}}</td>
<td> Copy permission</td>
</tr><tr>
<td> [[PERM_MODIFY]]</td>
<td> {{LSL Hex|0x00004000|16384}}</td>
<td> Modify permission</td>
</tr><tr>
<td> [[PERM_MOVE]]</td>
<td> {{LSL Hex|0x00080000|524288}}</td>
<td> Move permission</td>
</tr><tr>
<td> [[PERM_TRANSFER]]</td>
<td> {{LSL Hex|0x00002000|8192}}</td>
<td> Transfer permission</td>
</tr></table>

표 속의 표:

Permissions Value Description
PERM_ALL 0x7FFFFFFF Move/Modify/Copy/Transfer permissions
PERM_COPY 0x00008000 Copy permission
PERM_MODIFY 0x00004000 Modify permission
PERM_MOVE 0x00080000 Move permission
PERM_TRANSFER 0x00002000 Transfer permission

표를 틀의 매개변수로:

Permissions Value Description
PERM_ALL 0x7FFFFFFF Move/Modify/Copy/Transfer permissions
PERM_COPY 0x00008000 Copy permission
PERM_MODIFY 0x00004000 Modify permission
PERM_MOVE 0x00080000 Move permission
PERM_TRANSFER 0x00002000 Transfer permission
막대 대치 방법
실행전 실행후 삽입
{|{{Prettytable}}
! Permissions
! Value
! Description
|- 
| [[PERM_ALL]]
| {{LSL Hex|0x7FFFFFFF|2147483647}}
| Move/Modify/Copy/Transfer permissions
|- 
| [[PERM_COPY]]
| {{LSL Hex|0x00008000|32768}}
| Copy permission
|- 
| [[PERM_MODIFY]]
| {{LSL Hex|0x00004000|16384}}
| Modify permission
|- 
| [[PERM_MOVE]]
| {{LSL Hex|0x00080000|524288}}
| Move permission
|- 
| [[PERM_TRANSFER]]
| {{LSL Hex|0x00002000|8192}}
| Transfer permission
|}
{{{!}}{{Prettytable}}
! Permissions
! Value
! Description
{{!}}- 
{{!}} [[PERM_ALL]]
{{!}} {{LSL Hex|0x7FFFFFFF|2147483647}}
{{!}} Move/Modify/Copy/Transfer permissions
{{!}}- 
{{!}} [[PERM_COPY]]
{{!}} {{LSL Hex|0x00008000|32768}}
{{!}} Copy permission
{{!}}- 
{{!}} [[PERM_MODIFY]]
{{!}} {{LSL Hex|0x00004000|16384}}
{{!}} Modify permission
{{!}}- 
{{!}} [[PERM_MOVE]]
{{!}} {{LSL Hex|0x00080000|524288}}
{{!}} Move permission
{{!}}- 
{{!}} [[PERM_TRANSFER]]
{{!}} {{LSL Hex|0x00002000|8192}}
{{!}} Transfer permission
{{!}}}

표 속의 표:

Permissions Value Description
PERM_ALL 0x7FFFFFFF Move/Modify/Copy/Transfer permissions
PERM_COPY 0x00008000 Copy permission
PERM_MODIFY 0x00004000 Modify permission
PERM_MOVE 0x00080000 Move permission
PERM_TRANSFER 0x00002000 Transfer permission

표를 틀의 매개변수로:

Permissions Value Description
PERM_ALL 0x7FFFFFFF Move/Modify/Copy/Transfer permissions
PERM_COPY 0x00008000 Copy permission
PERM_MODIFY 0x00004000 Modify permission
PERM_MOVE 0x00080000 Move permission
PERM_TRANSFER 0x00002000 Transfer permission
Div 태그 방법 (항상 작동하지는 않는다)
실행전 실행후 삽입
{|{{Prettytable}}
! Permissions
! Value
! Description
|- 
| [[PERM_ALL]]
| {{LSL Hex|0x7FFFFFFF|2147483647}}
| Move/Modify/Copy/Transfer permissions
|- 
| [[PERM_COPY]]
| {{LSL Hex|0x00008000|32768}}
| Copy permission
|- 
| [[PERM_MODIFY]]
| {{LSL Hex|0x00004000|16384}}
| Modify permission
|- 
| [[PERM_MOVE]]
| {{LSL Hex|0x00080000|524288}}
| Move permission
|- 
| [[PERM_TRANSFER]]
| {{LSL Hex|0x00002000|8192}}
| Transfer permission
|}
<div>
{|{{Prettytable}}
! Permissions
! Value
! Description
|- 
| [[PERM_ALL]]
| {{LSL Hex|0x7FFFFFFF|2147483647}}
| Move/Modify/Copy/Transfer permissions
|- 
| [[PERM_COPY]]
| {{LSL Hex|0x00008000|32768}}
| Copy permission
|- 
| [[PERM_MODIFY]]
| {{LSL Hex|0x00004000|16384}}
| Modify permission
|- 
| [[PERM_MOVE]]
| {{LSL Hex|0x00080000|524288}}
| Move permission
|- 
| [[PERM_TRANSFER]]
| {{LSL Hex|0x00002000|8192}}
| Transfer permission
|}
</div>

표 속의 표:

Permissions Value Description
PERM_ALL 0x7FFFFFFF Move/Modify/Copy/Transfer permissions
PERM_COPY 0x00008000 Copy permission
PERM_MODIFY 0x00004000 Modify permission
PERM_MOVE 0x00080000 Move permission
PERM_TRANSFER 0x00002000 Transfer permission

함수

일반 틀 이외에 단 하나의 함수 명세 틀이 있다.

Template:LSL Function
이 틀은 함수의 문서화를 위한 구조를 제공하며 일련의 구분자를 포함한다.

  • 정보를 삭제하지 말 것.
  • 변수의 순서는 상관없다.
  • 대부분의 변수는 지정되지 않을 경우 문서화 명세에서 항목 자체가 감추어진다(모든 항목이 감춰지지는 않는다).
  • 사용되지 않는 변수들은 포함될 필요가 없지만 앞으로의 편집을 위하여 삭제되지 않는 편이 낫다.
  • 틀로 생성되는 글월들은 글머리에 위치시킬 것.
  • 특정한 항목을 더 추가해야 한다고 생각한다면 LSL Function Style에 추가하라(그러면 틀에 바로 추가될 것이다).

구문법과 속성들에 대한 보다 자세한 설명은 Template:LSL Function을 직접 참조하라.

기본 예제: 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
}}

사건

일반 틀 이외에 단 하나의 사건 명세 틀이 있다.

Template:LSL Event
이 틀은 사건의 문서화를 위한 구조를 제공하며 일련의 구분자를 포함한다. 사용되지 않은 항목은 대체로 보기에서 감추어진다.

구문법과 속성들에 대한 보다 자세한 설명은 Template:LSL Event을 직접 참조하라.

상수

일반 틀 이외에 단 하나의 상수 명세 틀이 있다.

Template:LSL Constant
이 틀은 상수의 문서화를 위한 구조를 제공하며 일련의 구분자를 포함한다. 사용되지 않은 항목은 대체로 보기에서 감추어진다.

구문법과 속성들에 대한 보다 자세한 설명은 Template:LSL Constant을 직접 참조하라.