Files
UnrealEngineUWP/Engine/Documentation/Source/DocumentationGuidelines/Syntax/EpicMarkdownSyntax.KOR.udn
Sungjin Hong 9c5b93d0d8 #loc UE4DocKOR
[CL 2612859 by Sungjin Hong in Main branch]
2015-07-07 16:39:32 -04:00

596 lines
25 KiB
Plaintext

INTSourceChangelist:2598017
Availability:Docs
Keywords: 메타데이터는 문서 상단에 세미콜론으로 추가합니다.
Title: 에픽의 마크다운과 확장기능 문법 설명서
Crumbs:DocumentationGuidelines
Description:에픽의 커스텀 마크다운 확장기능을 사용하여 새로운 문서 소스 파일을 작성하는 법입니다.
[TOC (start:2 end:3)]
[REGION:note]
**주:** 이 문서 자체가 에픽의 마크다운으로 쓰여졌습니다. [소스 파일을 확인](DocumentationGuidelines\SyntaxSource) 하실 수 있습니다.
[/REGION]
## 개요
마크다운 에픽 버전은 [MarkdownSharp](http://code.google.com/p/markdownsharp/) 을 기반으로 합니다. MarkdownSharp 은 [Markdown](http://daringfireball.net/projects/markdown/) 을 기반으로 하여 [PHP Markdown Extra](http://michelf.com/projects/php-markdown/) 함수성을 약간 추가한 것입니다.
이 문서는 에픽의 함수성과 특히 Markdown Extra 에서 지원되고 있는 기능을 지원하기 위해 제작된 확장기능에 대한 안내서 역할을 합니다. 이 문법 안내서는 원래 [마크다운 문법](http://daringfireball.net/projects/markdown/syntax) 의 추록입니다.
## 에픽의 함수성
### 목차와 제목 자동 생성
제목(header)에서 공백을 제거한 부분이 북마크가 될 수 있도록 제목 생성 프로세스가 변경되었습니다. 같은 이름의 제목을 복수 지원하기 위해 하위 제목에는 2 부터 시작하는 색인이 덧붙습니다.
문서 상단에 \[TOC\] 태그를 대체하여 들여쓰기가 올바르게 된 제목 목록을 생성합니다.
\[TOC (start:기록시작레벨 end:기록끝레벨)\] 를 지정하면 목차에 포함시킬 제목 레벨을 설정할 수 있으며, start 와 end 는 옵션 변수입니다. 생략하면 start 에는 1, end 에는 6 이 주어집니다. 둘 다 설정하는 경우 start 뒤에 end 가 따라야 합니다.
제목의 첫 글자가 !! 인 경우 그 제목은 목차(Table of Contents)에 포함되지 않습니다.
#### 마크다운 문법
#제목
[TOC(start:2)]
#### HTML 출력
<h1 id="Heading1">제목</h1>
<ul><li><a href="#Heading">제목</a></ul>
#### 결과
여기 개략적으로 설명한 방법으로 만든 것이 바로 이 페이지 상단의 목차입니다. \[TOC\] (start:2 end:3)
### 문서 내부에서의 북마크 링크
문서 내부의 제목으로 링크를 걸 수도, 문서 내부에 링크로 연결되는 북마크를 놓을 수도 있습니다.
#### 마크다운 문법
파일 내부 제목으로의 링크 예제는 이렇습니다: [목차와 제목 자동 생성](#목차와제목자동생성). 제목 문구는 원래 문구에 있는 공백을 제거하면 됩니다. 게다가 같은 이름의 제목이 둘 이상 되는 경우 공백을 뺀 이름에 2, 3 식으로 숫자를 덧붙여 참조시키면 됩니다: [마크다운 문법 1](#마크다운문법) [마크다운 문법 2](#마크다운문법2) [마크다운 문법 3](#마크다운문법3)
문서 내부 사용자 지정 북마크로의 링크 예제는 이렇습니다: [북마크 1](#북마크1).
(북마크1) 북마크 문구는 줄의 처음에 와야 합니다.
#### HTML 출력
<p>파일 내부 제목으로의 링크 예제는 이렇습니다: <a href="#목차와제목자동생성">목차와 제목 자동 생성</a>. 제목 문구는 원래 문구에 있는 공백을 제거하면 됩니다. 게다가 같은 이름의 제목이 둘 이상 되는 경우 공백을 뺀 이름에 2, 3 식으로 숫자를 덧붙여 참조시키면 됩니다: <a href="#마크다운문법">마크다운 문법 1</a> <a href="#마크다운문법2">마크다운 문법 2</a> <a href="#마크다운문법3">마크다운 문법 3</a> </p>
<p>문서 내부 사용자 지정 북마크로의 링크 예제는 이렇습니다: <a href="#북마크1">북마크 1</a>.</p>
<p><a id="북마크1"/> 북마크 문구는 줄의 처음에 와야 합니다.</p>
#### 결과
파일 내부 제목으로의 링크 예제는 이렇습니다: [목차와 제목 자동 생성](#목차와제목자동생성). 제목 문구는 원래 문구에 있는 공백을 제거하면 됩니다. 게다가 같은 이름의 제목이 둘 이상 되는 경우 공백을 뺀 이름에 2, 3 식으로 숫자를 덧붙여 참조시키면 됩니다: `[마크다운 문법 1](#마크다운문법)` `[마크다운 문법 2](#마크다운문법2)` `[마크다운 문법 3](#마크다운문법3)`
문서 내부 사용자 지정 북마크로의 링크 예제는 이렇습니다: [북마크 1](#북마크1).
(#북마크1) 북마크 문구는 줄의 처음에 와야 합니다.
### 문서의 다른 페이지로 링크
다른 페이지로의 링크는 상대 링크로 합니다. 문서가 마크다운 루트 폴더에 있는 경우, 루트 폴더를 가리키는 것은 \%ROOT\% 입니다. 링크에는 언어가 지정되지 않지만, 현재 보고있는 언어의 파일을 그대로 링크한다 가정합니다.
#### 마크다운 문법
[UE4 홈](%ROOT%)
[언리얼 에디터 사용 안내서](Engine/UI)
#### HTML Output
<a href="./../../../INT\index.html">UE4 Home</a>
<a href="./../../../INT\Editor\index.html">언리얼 에디터 사용 안내서</a>
#### 결과
[UE4 홈](%ROOT%)
[언리얼 에디터 사용 안내서](Engine/UI)
### 로컬 이미지 링크하기
이미지 폴더를 가리킬 필요는 없습니다. 문서의 다른 페이지에 속하는 이미지일 경우에만 그 경로를 가리켜 주면 됩니다. 링크에 언어를 지정할 필요는 없습니다. 언어 폴더 이미지 디렉토리를 먼저 찾아본 다음 없으면 INT 이미지 폴더로 찾아갑니다.
#### 마크다운 문법
![로고](Logo_Epic-New.jpg)
![에디터 뷰포트](Engine/UI/LevelEditor\Viewports\viewport.png)
#### HTML 출력
<img alt="로고" src="./../../../images\EpicMarkdownDocGuides\EpicMarkdownExtension\Logo_Epic-New.jpg"/>
<img alt="에디터 뷰포트" src="./../../../images\Editor\viewport.png"/>
#### 결과
![로고](Logo_Epic-New.jpg)
![에디터 뷰포트](Engine/UI/LevelEditor\Viewports\viewport.png)
### 이미지 프로퍼티
약간의 이미지 포맷 관련 명령과 변환 기능도 제공했으면 좋겠다 싶었습니다.
(w: h: a: convert: type: quality: fill: )
* **w:** 표시할 이미지 폭입니다. 생략하면 높이가 지정되지 않은 이상 소스 이미지의 폭이 사용되며, 높이가 지정된 경우 소스 이미지의 종횡비에 맞는 폭이 사용됩니다.
* **h:** 표시할 이미지 높이입니다. 생략하면 폭이 지정되지 않은 이상 소스 이미지의 높이가 사용되며, 폭이 지정된 경우 소스 이미지의 종횡비에 맞는 높이가 사용됩니다.
* **a:** 이미지 정렬 스타일을 좌(left), 우(right), 없음(none) 으로 나타냅니다. 기본값은 없음(none) 입니다.
* **convert:** `false` 아니면 `true` 값으로, 이미지를 압축할 것인지/또는 다른 유형으로 변환할 것인지를 나타냅니다. 기본값은 true 이며, 애니메이션 GIF 처럼 소스 포맷이 중요하거나 퀄리티를 보존해야 하는 경우 false 로 설정하면 됩니다.
* **type:** 이미지를 변환할 유형입니다. `jpg`, `png`, `gif` 가 가능하며, 기본값은 `jpg` 입니다.
* **quality:** jpeg 압축률입니다 (`1`-`100`). 기본값은 `80` 입니다. 기본 압축률로 이미지가 깨질 정도로 부작용이 생기는 경우 이 값을 늘리면 도움이 됩니다.
* **fill:** 변환 포맷이 jpg 인 경우 이미지의 배경색을 나타내는 16 진수 (`#0088FF` 포맷의) 색입니다. 기본값은 `#FFFFFF` 입니다.
[REGION:note]
* 옵션은 순서가 중요합니다만, 각각은 선택적으로 생략할 수도 있고, 아예 이미지 정보 이후 괄호 스타일 전체를 생략해도 됩니다.
* 변환 파라미터가 없으면 app.config 의 기본값이 사용됩니다.
* 기존 마크다운 이미지 포함 메소드 Inline 과 Reference 둘 다 포맷 지원을 위해 확장시켰습니다.
* 이미지 정렬 스타일을 left 나 right 로 한 경우 원치않는 결과가 날 수 있는데, 예를 들어 새로운 섹션으로 옮겼더니 제목이 무관한 이미지 옆에 오게되는 것은 바람직하지 않습니다. 이 텍스트는 이미지 옆에 있는 단락입니다. "clear" [region](#Region) 스타일 시트를 붙여 좌우정렬을 초기화시키며, 1, 2 단계 제목과 hr 요소에는 좌우정렬이 적용되지 않습니다.
[/REGION]
#### 마크다운 문법
오른쪽 어울림만 지정한 상태로 ![에픽 로고](Logo_Epic-New.jpg "여기에 제목")(a:right) 폭과 높이는 비워둔 인라인 이미지입니다.
폭, 높이, 왼쪽 어울림이 적용된 ![에픽 로고][refepiclogo] 참조 이미지 입니다.
[refepiclogo]: Logo_Epic-New.jpg "여기에 제목"(w:50 h:50 a:left convert:true quality:75 fill:#000000)
이미지 옆 같은 절에 들어가는 문구입니다. 어울림 끝부분 뒤에는 특수 div 요소가 잇따릅니다.
[REGION:clear]
<!-- clear float -->
[/REGION]
#### HTML 출력
<p>오른쪽 어울림만 지정한 상태로 <img style="float: right;" title="여기에 제목" alt="에픽 로고" src="./../../../images\EpicMarkdownDocGuides\EpicMarkdownExtension\Logo_Epic-New.jpg"/> 폭과 높이는 비워둔 인라인 이미지입니다.</p>
<p>폭, 높이, 왼쪽 어울림이 적용된 <img width="50" height="50" style="float: left;" title="여기에 제목" alt="에픽 로고" src="./../../../images\EpicMarkdownDocGuides\EpicMarkdownExtension\Logo_Epic-New.jpg"/> 참조 이미지 입니다.</p>
<p>이미지 옆 같은 절에 들어가는 문구입니다. 어울림 끝부분 뒤에는 특수 div 요소가 잇따릅니다.</p>
[REGION:clear]
<!-- clear float -->
[/REGION]
#### 결과
오른쪽 어울림만 지정한 상태로 ![에픽 로고](Logo_Epic-New.jpg "여기에 제목")(a:right) 폭과 높이는 비워둔 인라인 이미지입니다.
폭, 높이 왼쪽 어울림이 적용된 ![에픽 로고][refepiclogo] 참조 이미지입니다.
[refepiclogo]: Logo_Epic-New.jpg "여기에 제목"(w:50 h:50 a:left convert:true quality:75 fill:#000000)
이미지 옆 같은 절에 들어가는 문구입니다. 어울림 끝부분 뒤에는 특수 div 요소가 잇따릅니다.
[REGION:clear]
<!-- clear float -->
[/REGION]
### 표
표(table)는 MultiMarkdown 이 매우 유연한 문법으로 포맷이 가능하도록 지원되었기에 에픽의 기반으로 삼았습니다.
* 콜론(:)은 제목줄에 있는 표 데이터의 정렬 방식을 나타내는 데 사용됩니다.
* 출의 처음과 끝에는 파이프가 있을 수도, 생략될 수도 있습니다.
* 캡션을 추가할 수 있습니다.
* 열 합치기가 가능합니다.
* 줄 합치기는 셀에 ^ 기호를 사용하면 됩니다.
#### 마크다운 문법
[표 1 - 제목이 위]
| | 그룹 ||
첫째 제목 | 둘째 제목 | 셋째 제목 |
------------ | :------------: | ------------: |
내용 | *긴 셀* ||
내용 | **셀** | 셀 |
새로운 절 | 추가 | 데이터 |
^ | 기타등등 ||
------------ | :------------: | ------------: |
내용 | *긴 셀* ||
내용 | **셀** | 셀 |
새로운 절 | 추가 | 데이터 |
^ | 기타등등 ||
[표 2 - 제목이 오른쪽]
| ------------ | :------------: | ------------: |
| 내용 | *긴 셀* ||
| 내용 | **셀** | 셀 |
| 새로운 절 | 추가 | 데이터 |
| ^ | 기타등등 ||
#### HTML 출력
<table>
<caption>표 1 - 제목이 위</caption>
<colgroup><col/>
<col align="center"/>
<col align="right"/>
</colgroup><thead>
<tr>
<th colspan="1"/>
<th colspan="2">그룹</th>
</tr>
<tr>
<th colspan="1">첫째 제목</th>
<th colspan="1">둘째 제목</th>
<th colspan="1">셋째 제목</th>
</tr>
</thead>
<tbody>
<tr>
<td colspan="1">내용</td>
<td align="center" colspan="2"><em>긴 셀</em></td>
</tr>
<tr>
<td colspan="1">내용</td>
<td align="center" colspan="1"><strong>셀</strong></td>
<td align="right" colspan="1">셀</td>
</tr>
<tr>
<td rowspan="2" colspan="1">새로운 절</td>
<td align="center" colspan="1">추가</td>
<td align="right" colspan="1">데이터</td>
</tr>
<tr>
<td align="center" colspan="2">기타등등</td>
</tr>
</tbody>
</table>
<table>
<caption>표 2 - 제목이 오른쪽</caption>
<colgroup><col/>
<col align="center"/>
<col align="right"/>
</colgroup><tbody>
<tr>
<th colspan="1">내용</th>
<td align="center" colspan="2"><em>긴 셀</em></td>
</tr>
<tr>
<th colspan="1">내용</th>
<td align="center" colspan="1"><strong>셀</strong></td>
<td align="right" colspan="1">셀</td>
</tr>
<tr>
<th rowspan="2" colspan="1">새로운 절</th>
<td align="center" colspan="1">추가</td>
<td align="right" colspan="1">데이터</td>
</tr>
<tr>
<td align="center" colspan="2">기타등등</td>
</tr>
</tbody>
</table>
#### 결과
[표 1 - 제목이 위]
| | 그룹 ||
첫째 제목 | 둘째 제목 | 셋째 제목 |
------------ | :-----------: | -----------: |
내용 | *긴 셀* ||
내용 | **셀** | 셀 |
새로운 절 | 추가 | 데이터 |
^ | 기타등등 ||
첫 열 위에 헤더 정보가 없어 가장 왼쪽에 있는 열을 제목으로 간주합니다.
[표 2 - 제목이 오른쪽]
| ------------ | :------------: | ------------: |
| 내용 | *긴 셀* ||
| 내용 | **셀** | 셀 |
| 새로운 절 | 추가 | 데이터 |
| ^ | 기타등등 ||
### 메타데이터
메타데이터에는 MultiMarkdowns 문법과 비슷하게 구현되며, 규칙은 다음과 같습니다.
* 메타데이터는 문서 최상단에 시작해야 하며, 빈 줄이 먼저 들어가서는 안됩니다.
* 메타데이터는 두 부분, 키와 값 짝으로 이루어집니다.
* 메타데이터 키는 줄의 처음부터 시작해야 합니다. 문자나 숫자로 시작한 다음, 문자, 숫자, 공백, 하이픈, 밑줄 등으로 구성하면 됩니다.
* 메타데이터 키의 끝은 콜론으로 지정합니다.
* 콜론 뒤에는 메타데이터 값이 오며, (새로운 줄 빼고) 어떤 글자로 몇 글자든 가능합니다.
* 메타데이터가 끝난 후에 나오는 빈 줄은, 나머지가 문서의 시작임을 알립니다.
모든 메타데이터는 문서의 헤더에 <meta name="키" content="값"/> html 블록으로 놓입니다.
위에 더해 일부 키는 특별한 함수성이 있습니다.
* Title 메타데이터는 Header 블록의 `<title>Title</title>` 로 사용됩니다.
* HtmlDocumentType 메타데이터는 html 생성시 include/templates 폴더의 어느 템플릿을 사용할 것인지 결정하는 데 사용됩니다. 없다면, default.html 템플릿 파일이 사용됩니다.
* DoIndex:false 는 색인기가 이 문서를 제외시켜 검색 결과에 나타나지 않도록 합니다. 모든 문서의 기본값은 true 입니다.
* ForcePublishFiles: 첨부파일과 이미지를 html 폴더로 강제 퍼블리시 시키는 데 사용합니다.
#### 마크다운 문법
Keywords: 메타데이터가 문서 상단에 세미콜론으로 추가됩니다.
Title: 문서의 타이틀을 나타내나, 이 메타데이터가 없는 경우 문서의 경로가 사용됩니다.
#### HTML 출력
<title>문서의 타이틀을 나타내나, 이 메타데이터가 없는 경우 문서의 경로가 사용됩니다.</title>
<meta name="Keywords" content="메타데이터가 문서 상단에 세미콜론으로 추가됩니다." />
<meta name="Title" content="문서의 타이틀을 나타내나, 이 메타데이터가 없는 경우 문서의 경로가 사용됩니다." />
#### 결과
문서의 타이틀 바가 title 메타 태그로 업데이트된 것을 볼 수 있습니다.
문서 소스를 보면 앞부분에 메타 데이터를 볼 수 있습니다.
### 정의 목록
정의 목록(definition list) 기능 지원을 위한 문법이 변환에 추가되었습니다. 정의 목록은 마크다운 표준 목록과 마찬가지로 똑같은 정렬과 삽입 규칙으로 작동됩니다.
#### 마크다운 문법
최상위 레벨에서의 정의 목록 요소:
$ 정의 1 : 설명 1
$ 정의 2 : 설명 2
* 목록 요소 1
1. 순서
1. 순서
* 목록 요소 2
$ 정의 3: 설명 3
삽입된 정의 목록 요소:
* 목록 요소 1
$ 정의 1 : 설명 1
$ 정의 2 : 설명 2
* 목록 요소 2
#### HTML 출력
<dl>
<dt>정의 1 </dt>
<dd>설명 1</dd>
<dt>정의 2 </dt>
<dd>설명 2
<br/>
<ul>
<li>목록 요소 1
<br/>
<ol>
<li>순서</li>
<li>순서</li>
</ol></li>
<li>목록 요소 2</li>
</ul></dd>
<dt>정의 3</dt>
<dd>설명 3</dd>
</dl>
<ul>
<li>목록 요소 1
<br/>
<dl>
<dt>정의 1 </dt>
<dd>설명 1</dd>
<dt>정의 2 </dt>
<dd>설명 2</dd>
</dl></li>
<li>목록 요소 2</li>
</ul>
#### 결과
최상위 레벨에서의 정의 목록 요소:
$ 정의 1 : 설명 1
$ 정의 2 : 설명 2
* 목록 요소 1
1. 순서
1. 순서
* 목록 요소 2
$ 정의 3: 설명 3
삽입된 정의 목록 요소:
* 목록 요소 1
$ 정의 1 : 설명 1
$ 정의 2 : 설명 2
* 목록 요소 2
### 부가 백슬래시 이스케이프
마크다운을 통한 이스케이프 캐릭터에 더해, 다음과 같은 이스케이프도 가능합니다:
> greater than
| pipe
% percent
## 사용된 마크다운 추가 함수
### 엄격한 두껍게와 이탤릭
`_이탤릭_` 과 `__두껍게__` 문법의 시작부분 왼쪽과 끝부분 오른쪽에는 공백이 있어야 합니다. 이것은 밑줄이_들어간_파일명 같은 곳에 사용되는 것을 잘못 인식하지 못하게 하기 위함입니다.
### 코드 블록 담장
#### 마크다운 문법
`~~~`
3 개 이상의 ~ 글자로 둘러싼 코드입니다.
`~~~`
#### HTML 출력
<pre class="prettyprint"><code>3 개 이상의 ~ 글자로 둘러싼 코드입니다.
</code></pre>
#### 결과
~~~
3 개 이상의 ~ 글자로 둘러싼 코드입니다.
~~~
### Region
Region (구역)은 기본적으로 스타일을 적용할 수 있는, HTML 의 div 영역입니다. region 지정 문법은 이렇습니다:
[REGION:stylename]
...
[/REGION]
HTML 생성시 이렇게 변환됩니다:
<div class="stylename">
...
</div>
그에 해당하는 스타일 규직을 css 파일에 만들어 주기도 해야합니다:
.stylename
{
background:#123456;
border:1px solid #654321;
}
#### 내장형 Region
note(참고, 주), tip(꼼수), warning(경고), quote(인용) 처럼 흔한 것에 쓰이는 region 스타일이 이미 있습니다.
[REGION:note]
note 입니다. 노랑 상자 안에 있으며, 좌상단에 노트 아이콘을 볼 수 있습니다.
[/REGION]
[REGION:note]
note 입니다. 노랑 상자 안에 있으며, 좌상단에 노트 아이콘을 볼 수 있습니다.
[/REGION]
[REGION:tip]
tip 입니다. 초록 상자 안에 있으며, 좌상단에 팁 아이콘을 볼 수 있습니다.
[/REGION]
[REGION:tip]
tip 입니다. 초록 상자 안에 있으며, 좌상단에 팁 아이콘을 볼 수 있습니다.
[/REGION]
[REGION:warning]
warning 입니다. 빨강 상자 안에 있으며, 좌상단에 경고 아이콘을 볼 수 있습니다.
[/REGION]
[REGION:warning]
warning 입니다. 빨강 상자 안에 있으며, 좌상단에 경고 아이콘을 볼 수 있습니다.
[/REGION]
[REGION:quote]
quote 입니다. 파랑 상자 안에 있으며, 좌상단에 인용 아이콘을 볼 수 있습니다.
[/REGION]
[REGION:quote]
quote 입니다. 파랑 상자 안에 있으며, 좌상단에 인용 아이콘을 볼 수 있습니다.
[/REGION]
### Object
Object 는 위에 설명한 Region 보다 유연한 다목적 시스템입니다. Region 이 스타일시트의 스타일에 상응하는 것과 마찬가지로, Object 는 ㅌ템플릿에 저장된 마크업 블록에 상응합니다. 이를 통해 임의의 마크업을 문서에 삽입할 수 있습니다.
Object 는 `OBJECT` 태그를 사용하여 생성됩니다. Object 이름은 콜론 (`:`) 으로 태그와 구분해서 지정합니다. Object 의 가장 기본적인 유형은:
[OBJECT:TemplateName][/OBJECT]
위의 템플릿에는 어떠한 종류의 HTML 마크업이나 자바스크립트도 포함 가능하며, 이것이 나중에 어느 문서든 Object 태그 대신 들어가게 됩니다.
#### 템플릿
템플릿이란 `Include/Template/Objects` 디렉토리에 저장되는 HTML 파일입니다. 템플릿 이름이 중요한데, 그것으로 Obejct 를 템플릿에 일치시키기 때문입니다. 다음의 예에서 `VideoPlayer` 라는 이름의 Object 는 `VideoPlayer.html` 템플릿에서 찾은 마크업으로 대체됩니다.
[OBJECT:VideoPlayer][/OBJECT] <-> VideoPlayer.html
#### 파라미터
Object 의 다목적성을 한층 부각시키기 위해서, 문서에 마크업을 삽입시키기 전, 템플릿에 정보와 콘텐츠를 전하여 마크업에 삽입시킬 수 있습니다. 이를 통해 똑같은 템플릿도 유연하게 사용할 수 있습니다. 문서에 그대로 들어가는 내용이 아니라, Object 는 이런 식으로 환경설정이 가능합니다.
사용할 수 있는 파라미터 유형은 두 가지, 보통과 리터럴(문자그대로) 입니다. 보통 파라미터는 페이지 안의 보통 콘텐츠로 분석됩니다. 즉 마크다운이 포함되면 마크다운으로 취급된다는 뜻입니다. 리터럴 파라미터는 전혀 분석되지 않습니다. 문서에 나타나는 그대로 템플릿에 복사해 넣을 뿐입니다.
템플릿에 파라미터를 전달하기 위해서는 Object 안에 `PARAM`, `PARAMLITERAL` 태그를 사용합니다. 파라미터 이름은 콜론 (`:`) 으로 태그와 분리하여 지정합니다. 파라미터의 가장 간단한 유형은:
[PARAM:ParamName]파라미터 데이터[/PARAM]
그리고
[PARAMLITERAL:ParamName]파라미터 데이터[/PARAMLITERAL]
각 파라미터의 데이터는 이후 템플릿에서 다음과 같은 형태를 취하는 파라미터 태그를 대체합니다:
{ParamName}
앞에서의 VideoPlayer Object 를 사용하는 예를 들자면:
[OBJECT:VideoPlayer]
[PARAM:title]정말 **끝내주는** 비디오[/PARAM]
[PARAMLITERAL:video]끝내주는비디오.mp4[/PARAMLITERAL]
[PARAM:related]
* [비디오 1](#Video1)
* [비디오 2](#Video2)
* [비디오 3](#Video3)
* [비디오 4](#Video4)
[/PARAM]
[/OBJECT]
VideoPlayer Object 에 대한 템플릿의 내용은 이렇습니다:
<div class="videoplayer">
<div class="title">{title}</div>
<video>
<source src="{video}" type="video/mp4">
</video>
<div class="related_links">
{related}
</div>
</div>
페이지의 HTML 결과물에서 VideoPlayer Object 는 다음과 같이 대체됩니다:
<div class="videoplayer">
<div class="title">정말 <strong>끝내주는</strong> 비디오</div>
<video>
<source src="끝내주는비디오.mp4" type="video/mp4">
</video>
<div class="related_links">
<ul>
<li><a href="#Video1">비디오 1</a></li>
<li><a href="#Video2">비디오 2</a></li>
<li><a href="#Video3">비디오 3</a></li>
<li><a href="#Video4">비디오 4</a></li>
</ul>
</div>
</div>
### Lightbox
링크를 `lightbox` [region](#Region) 으로 둘러싸면 페이지에 오버레이로 뜨는 라이트박스에 이미지와 다른 내용이 표시됩니다.
### 이미지 라이트박스
이미지의 경우 링크를 풀 사이즈로 가리켜야 페이지에 오버레이로 놓이는 반면, 링크의 _text_ 는 작은 버전이나 썸네일로 표시됩니다. [이미지 프로퍼티](#이미지프로퍼티) 를 사용하여 디스플레이 이미지의 크기를 제한시키는 식으로, 같은 이미지를 양쪽 모두에 사용할 수도 있습니다.
문법:
[REGION:lightbox]
[![](Engine/UI/LevelEditor/Editor.png)(w:480)](Engine/UI/LevelEditor/Editor.png)
[/REGION]
결과:
[REGION:lightbox]
[![](Engine/UI/LevelEditor/Editor.png)(w:480)](Engine/UI/LevelEditor/Editor.png)
[/REGION]
### 파일 INCLUDE 와 EXCERPT
어느 한 페이지의 전체 내용이나 일부분만 떼어서 다른 페이지에 포함시킬 수 있습니다.
전체 페이지를 포함시키는 문법은 이렇습니다:
[INCLUDE:Engine/Landscape]
이렇게 하면 전체 Landscape 페이지를 변환하여 그 줄이 들어있는 페이지에 삽입합니다.
페이지에 다음과 같은 문법으로 EXCERPT (발췌)를 정의합니다:
[EXCERPT:TerrainLayerCoords]
...
[/EXCERPT:TerrainLayerCoords]
이렇게 정의한 EXCERPT 를 포함시키는 문법은 다음과 같습니다:
[INCLUDE:Engine/Landscape/Materials#TerrainLayerCoords]
결과 (인용 구역 표시 부분):
[REGION:quote]
[INCLUDE:Engine/Landscape/Materials#TerrainLayerCoords]
[/REGION]