도움말:나무위키 출신 사용자들을 위한 문법 도움말
이 도움말은 L위키의 사용서입니다. 이 문서는 L위키 사용하는 과정이나 절차에 대해 안내합니다. L위키의 정책과 지침은 아니며, 공동체의 합의와 검토 등을 어느 정도 반영하고 있습니다. |
현재 작성 중인 문서입니다. |
L위키가 사용하고 있는 미디어위키 문법과 나무위키 문법은 공통된 부분이 몇몇 있지만 다른 부분이 꽤 있습니다. 이 문서는 나무위키 사용자가 L위키 문법의 적용을 도와주기 위해서 제작되었습니다.
HTML의 사용[편집 | 원본 편집]
나무위키는 HTML을 사용할때 {{{#!html (내용)}}}
식으로 HTML을 삽입하게 됩니다. L위키는 나무위키와 달리 {{{#!html (내용)}}}
같은 문법 없이 그대로 HTML을 삽입하도록 되어있습니다. 물론 모든 HTML 코드를 넣을 수 있는건 아니며, 나무위키와 달리 <iframe>...</iframe>
태그 삽입이 차단되어 있으며, 따라서 유튜브 영상을 임베드 할때는 유튜브 임베드 문법을 반드시 사용해야 합니다. 당연히 XSS 공격 등으로 악용하기 쉬운 <script>...</script>
등의 태그 삽입 또한 차단되어 있습니다.
L위키는 나무위키와 달리 HTML을 적극적으로 사용하게 되며 일부 서식은 HTML 태그를 그대로 사용하여 구현하게 되어 있습니다. 이는 HTML 사용을 비권장하는 나무위키와는 다른 점입니다. 대표적으로 취소선, 밑줄, 텍스트 색깔을 주는 것, 텍스트 크기 조절 등은 HTML 태그를 그대로 사용해서 구현하게 됩니다. 사실 이러한 점 때문에 HTML 사용에 관련된 설명이 먼저 있는 것입니다.
기본적인 서식[편집 | 원본 편집]
우선 텍스트를 굵게 하는 문법과 이텔릭체를 사용하는 문법은 나무위키와 동일합니다. 나무위키에서 하던 '''그대로'''
(결과물: 그대로) 하면 텍스트가 굵게 나옵니다. 이텔릭도 마찬가지로 나무위키에서 하던 ''그대로''
(결과물: 그대로) 하면 이텔릭체가 출력됩니다.
밑줄을 치는 것 부터는 달라집니다.
나무위키 문법 | L위키 등 미디어위키 기반 위키의 문법 | 결과 |
---|---|---|
__나무위키의 밑줄과 미디어위키에서의 밑줄 문법은 다릅니다.__
|
<u>나무위키의 밑줄과 미디어위키에서의 밑줄 문법은 다릅니다.</u>
|
나무위키의 밑줄과 미디어위키에서의 밑줄 문법은 다릅니다. |
여기서 미디어위키는 HTML 태그를 그대로 사용한다는 것을 알 수 있습니다. 전술하다시피 L위키 등의 미디어위키에서는 일부 텍스트 서식을 HTML 태그를 그대로 이용해서 주게 되어 있습니다. 나무위키에서 취소선 드립 등을 위해 쓰는 취소선 문법 역시 다릅니다.
나무위키 문법 | L위키 등 미디어위키 기반 위키의 문법 | 결과 |
---|---|---|
--L위키와 나무위키는-- 취소선을 구현하는 문법이 ~~다릅니다.~~
|
<s>L위키와 나무위키는</s> 취소선을 구현하는 문법이 <s>다릅니다.</s>
|
L위키에서는 위와 같이 <del>...</del>
또는 <s>...</s>
태그로 취소선을 구현하며 HTML을 아시는 분은 눈치채셨겠지만 HTML에서 취소선을 구현하는 태그입니다. HTML에서는 삭제를 나타내는 <del>...</del>
과 더 이상 정확하지 않거나 더 이상 관련성이 없는 콘텐츠를 나타내는 <s>...</s>
태그가 존재합니다. 대부분의 경우에는 취소선을 사용할때 <s>...</s>
태그를 사용하여 취소선을 나타내야 합니다.
글자 크기를 조절하고 싶은 경우에는 별도의 글자 크기 문법이 있는 나무위키와 달리 HTML 태그를 사용하여 글씨 크기를 조절하셔야 합니다.
한줄 강제 개행[편집 | 원본 편집]
L위키를 포함한 위키백과 등의 일반적인 미디어위키 기반 위키는 엔터 하나만으로 다음과 같이 한줄 강제 개행을 지원하지 않습니다.
입력한 내용 | 나무위키에서의 결과 | L위키에서의 결과 |
---|---|---|
L위키에서는 엔터를 한번 치더라도
한줄 강제개행이 되지 않습니다.
|
L위키에서는 엔터를 한번 치더라도 한줄 강제개행이 되지 않습니다. |
L위키에서는 엔터를 한번 치더라도 한줄 강제개행이 되지 않습니다. |
따라서 L위키에서 한줄 강제 개행을 하려면 반드시 다음과 같이 한줄 개행의 의미하는 HTML 태그인 <br>
태그를 사용하셔야 합니다.
입력한 내용 | L위키에서의 결과 |
---|---|
L위키에서 한줄 강제개행을 하려면<br>반드시 HTML의 br태그를 사용하여야 합니다.
|
L위키에서 한줄 강제개행을 하려면 반드시 HTML의 br태그를 사용하여야 합니다. |
다만 강제개행이 빈번히 일어나는 시 등을 인용할 경우 <poem>...</poem>
태그를 사용하여, <poem>...</poem>
태그 안에 있는 경우에는 개행 할 수 있습니다.
입력한 내용 | L위키에서의 결과 |
---|---|
<poem>
개행이 빈번한
시 등을 인용할때는
poem 태그를 사용하여
poem 태그 안에 있는 문자열은
엔터 한번에 개행이 가능합니다.
</poem>
|
개행이 빈번한 |
다만 L위키에서의 한줄 강제개행은 권장하지 않는 행위이며, 필요할 때만 한줄 강제개행을 사용하시기 바랍니다. <poem>...</poem>
태그 또한 남발하지 마시기 바라며, 시 등을 인용할때 등의 꼭 필요할때만 사용하시기 바랍니다.
또한, 시각편집기는 한줄 개행을 지원하지 않으며 시각편집기의 한줄 개행은 곧 두줄 개행임을 유념하여 편집하시기 바랍니다.
나무위키 매크로에 대응하는 문법[편집 | 원본 편집]
L위키 등의 미디어위키 기반 위키에서 나무위키의 매크로에 대응되는 요소는 특수 명령문 입니다. 특수 명령문의 종류는 크게 세 가지가 있으며, 나무위키는 어떠한 매크로든 [(매크로명)((파라미터))]
식으로 호출하나 L위키의 특수 명령문은 각 종류마다 호출하는 방법이 다릅니다. 특수 명령문의 종류는 다음과 같습니다.
- 작동 스위치(behavior switch): 밑줄로 호출하며, 목차 강제, 목차 숨김, 분류 숨기기 등의 문서가 표시되는 방법을 설정합니다. 매개 변수는 받지 않습니다. 두 개의 밑줄표로 둘러싸이고 대문자로 된 문자열을 가지는 경우가 보통입니다. 예시:
__FOO__
- 변수(variable): 두 개의 중괄호로 둘러싸이고 대문자로 된 문자열을 가지며, 시간, 서버, 문서, 통계 정보 등을 출력합니다. 틀과 이름이 겹칠 경우 우선 순위는 특수 변수입니다.
틀:지역일
문서가 있을 때{{지역일}}
을 쓸 경우 틀이 호출되지 않고 특수 변수가 호출되며, 틀을 부르려면{{틀:지역일}}
을 써야 합니다. 단, 일부 상황에서는 틀이 우선됩니다. 예시:{{FOO}}
. 보시다시피, 틀을 사용하는 것과 매우 닮았습니다. - 파서 함수(parser function): 중괄호로 호출하며, URL 처리, 이름공간 출력, 문자열 형식 처리 등을 수행합니다. 매개 변수를 받는지 여부는 파서 함수마다 다릅니다. 매개 변수를 받는 특수 변수 또한 기술적으로는 파서 함수입니다.
{{foo:...}}
나{{#foo:...}}
의 형태를 가집니다. 예시:{{#invoke:...}}
.
L위키에서 사용할 수 있는 특수 명령문 중 나무위키의 매크로에는 없는 새로운 기능이 있으며, {{#if:..}}
가 대표적인 예시입니다.. 반대로 ruby 같은 일부 나무위키 매크로는 대응하는 특수 명령문이 L위키에 없을 수도 있으며, 하지만 일부는 이를 구현하는 틀 등이 존재하는 경우도 있습니다. 아래는 나무위키 매크로에 대응하는 문법들 입니다.
나무위키쪽 매크로 | 대응되는 L위키 문법(특수 명령문이나 대응하는 틀 등) |
---|---|
[include((문서명))]
|
{{(문서명)}} 식으로 끼워넣을 문서명 좌우에 {{}} 을 두르시면 됩니다. include 매크로랑 다른 점은 이름공간 표기가 없을 경우 변수에 해당하는 특수 명령문이 없는 한 해당하는 틀을 끼워넣게 됩니다.
|
[age(YYYY-MM-DD)]
|
{{만 나이}}틀에 대응하며, {{만 나이|YYYY|MM|DD}} 식으로 사용하면 됩니다. 참고로 {{나이}}틀은 한국식 나이를 표기하며, 나무위키와 달리 L위키에서는 한국식 나이 표기가 가능합니다.
|
[목차] 또는 [tableofcontents]
|
__TOC__ 가 일대일 대응되는 문법이기는 하나 L위키에서는 일반적으로 사용되지 않습니다. 4개 이상의 문단이 생성이 될 경우 자동으로 목차가 만들어지기 때문입니다. __TOC__ 문법은 특수한 경우 사용되는 문법입니다.
|
[br]
|
<br> html 태그를 사용하시면 됩니다. 사실 나무위키쪽 [br] 문법 자체가 html의 <br> 태그를 넣아주는 역할을 합니다.
|
[clearfix]
|
{{-}}틀을 사용하게 되며 그냥 {{-}} 식으로 사용하시면 됩니다.
|