Difference between revisions of "LSL Portal Guidelines/ko"

From Second Life Wiki
Jump to navigation Jump to search
(New page: {{Multi-lang}} {{LSL Header/ko}} <div style="float:right;">__TOC__</div> 이 페이지는 LSL Wiki의 상세한 편집과 글을 쓰실때의 기본 가이드라인을 정의해 놓은 ...)
 
 
Line 1: Line 1:
{{Multi-lang}}
{{Multi-lang}}{{LSL Header/ko}}
{{LSL Header/ko}}
<div style="float:right;">__TOC__</div>
<div style="float:right;">__TOC__</div>
이 페이지는 LSL 위키를 편집하고 글을 쓸 때의 기본 지침을 정의해 놓은 것이다.


이 페이지는 LSL Wiki의 상세한 편집과 글을 쓰실때의 기본 가이드라인을 정의해 놓은 것입니다.
== LSL 포털에 대하여 ==
<h4>사명</h4>
:"LSL에 관한 정확한 문서화를 제공한다."{{Footnote|[[LSL Portal/ko|LSL 포털]] 환영문에서 발췌.|LSL 포털 환영문에서 발췌.|handle=1}}


== 가이드 ==
<h4>목표</h4>
:"모든 수준의 개발자들에게 도움이 될 수 있는 문서를 제공한다."{{Footnote|handle=1}}


* [[LSL Editing Primer/ko | LSL 편집 입문 ]] - 템플릿과 문법에 관한 정보입니다.
== 안내 ==


== 스타일 ==
* [[LSL Editing Primer/ko|LSL 편집 입문]] - 서식과 구문법에 관한 정보입니다.
* [[Korean_Refined_Words|세컨드라이프 국어순화어]] - 올바른 한국어 사용을 위한 자료.


# [[LSL Category Style]] - LSL함수 혹은 다른 컨텐츠의 카테고리 그룹을 사용할 때에 사용됩니다.
== 양식 ==
# [[LSL Function Style]] - 모든 LSL 함수의 정확한 스펙을 위하여 사용됩니다.
# [[LSL Topic Style]] - LSL을 사용할 때에 흥미로운 토픽(XML-RPC,사원수(四元數),기타등등)을 위하여 사용됩니다.
# [[LSL Constants Style]] - 정수에 대한 문서화에 이용됩니다.


== 가이드 라인 ==
# [[LSL Category Style]] - LSL 함수나 다른 목차들의 범주화를 위한 양식.
# [[LSL Function Style]] - LSL 함수의 완전한 명세를 기술하기 위한 양식.
# [[LSL Topic Style]] - LSL과 관련있는 흥미로운 주제에 대해 따로 기술할 때 사용(XML-RPC, 사원수 등).
# [[LSL Constants Style]] - 정수의 문서화를 위한 양식.


* LSL 포털 혹은 카테고리의 페이지에 사양으로 헤더 부분에 'LSL'을 붙이지 않으면 않됩니다.
== 지침 ==
* 다른 헤더에 LSL과 추가 될 수 있는 문서에 있어서 모든 LSL의 페이지는 다른 부분과 일치 될 때까지 LSL의 접두어는 없애도록 합니다.
 
.
* LSL 포털 자체와 그 분류를 위한 페이지들은 접두어 'LSL'로 시작되어야 한다.
* 질문의 경우 discussion의 페이지나 혹은 talk에 글을 써주시고, 코멘트 부분에 <code><nowiki>-- </nowiki></code>)사용하여
* 그 외 혹시 존재할지도 모르는, LSL 접두어로 시작되는 다른 문서들은 문서화에 대한 다른 규칙이 합의되기 전 까지는 LSL접두어를 모두 삭제하도록 한다.
서명하여 주시기 바랍니다.
* 질문은 개별 쪽의 talk/discussion에 작성하고 서명한다(<code><nowiki>-- ~~~~</nowiki></code>을 삽입하면 자동으로 서명된다).
* wiki에 기능의 제안 글을 쓰시기 전에, 우선[https://jira.secondlife.com/ Jira]에 제안되어 있지 않은가 참조하여 주시기 바랍니다.
* 기능 제안에 대한 글을 쓰기 전에 [https://jira.secondlife.com/ Jira]에 이미 제안된 내용인지를 먼저 확인하라.
* 스크립트 소스를 올리실 때에는 그 소스가 에러없이 컴파일 되어야 하며, 충분히 함수나 혹은 기능에 대한 설명이 추가되어야 합니다.
* 스크립트를 올릴 때는 오류없이 제대로 컴파일되는지, 그리고 충분히 본보기로 내보일 특징이 있고 기능적인지를 검토해야한다. 코드 조각은 스크립트 내부에 넣었을 때 문제없이 컴파일되어야 한다(코드 조각 자체에 오류가 없어야 한다).
또한, 글(코드의 내용들이 Internal Error가 없도록)내용이 스크립트에 포함될 때에 코드들은 정상적으로 컴파일 되어야 합니다.
* 스크립트는 일관성 있는 양식으로 작성되어야 한다. 들여쓰기를 잘 지키는 것이 중요하다.
* 스크립트 소스의 내용은 공백과 스타일이 모두 통일 되어야 합니다.
* 최근의 웹브라우저들은 적당한 철자 확인 도구를 제공한다. 제출하기 전에 글월의 맞춤법이 올바른지 확인해야 한다.
* 예전 브라우저의 경우 연결확인 기능이 유효한지 체크하여야 합니다. 모든 컨텐츠는 연결이 확인 되어야 합니다.
* 한국어 화면을 작성/번역할 때에는 올바른 문장 및 어휘를 사용해야한다. [[Korean_Refined_Words|세컨드라이프 국어순화어]]를 참고할 것.

Latest revision as of 04:28, 5 March 2009

이 페이지는 LSL 위키를 편집하고 글을 쓸 때의 기본 지침을 정의해 놓은 것이다.

LSL 포털에 대하여

사명

"LSL에 관한 정확한 문서화를 제공한다."[1]

목표

"모든 수준의 개발자들에게 도움이 될 수 있는 문서를 제공한다."[1]

안내

양식

  1. LSL Category Style - LSL 함수나 다른 목차들의 범주화를 위한 양식.
  2. LSL Function Style - LSL 함수의 완전한 명세를 기술하기 위한 양식.
  3. LSL Topic Style - LSL과 관련있는 흥미로운 주제에 대해 따로 기술할 때 사용(XML-RPC, 사원수 등).
  4. LSL Constants Style - 정수의 문서화를 위한 양식.

지침

  • LSL 포털 자체와 그 분류를 위한 페이지들은 접두어 'LSL'로 시작되어야 한다.
  • 그 외 혹시 존재할지도 모르는, LSL 접두어로 시작되는 다른 문서들은 문서화에 대한 다른 규칙이 합의되기 전 까지는 LSL접두어를 모두 삭제하도록 한다.
  • 질문은 개별 쪽의 talk/discussion에 작성하고 서명한다(-- ~~~~을 삽입하면 자동으로 서명된다).
  • 기능 제안에 대한 글을 쓰기 전에 Jira에 이미 제안된 내용인지를 먼저 확인하라.
  • 스크립트를 올릴 때는 오류없이 제대로 컴파일되는지, 그리고 충분히 본보기로 내보일 특징이 있고 기능적인지를 검토해야한다. 코드 조각은 스크립트 내부에 넣었을 때 문제없이 컴파일되어야 한다(코드 조각 자체에 오류가 없어야 한다).
  • 스크립트는 일관성 있는 양식으로 작성되어야 한다. 들여쓰기를 잘 지키는 것이 중요하다.
  • 최근의 웹브라우저들은 적당한 철자 확인 도구를 제공한다. 제출하기 전에 글월의 맞춤법이 올바른지 확인해야 한다.
  • 한국어 화면을 작성/번역할 때에는 올바른 문장 및 어휘를 사용해야한다. 세컨드라이프 국어순화어를 참고할 것.