템플릿

이것은 GitBook 에서 가능한 템플릿 기능의 개요입니다. GitBook 은 NunjucksJinja2 구문을 사용합니다..

탈출

특별한 템플릿 태그를 출력하고 싶다면, raw 를 사용하고 그 안에 명시하세요. 일반 텍스트로 출력될 것입니다.

{% raw %}
  이것은 {{ 처리되지 않을 것 }} 입니다
{% endraw %}

변수

변수는 이 책의 문맥에서 값을 찾습니다.

변수는 book.json 파일에 정의되어있습니다:

{
    "variables": {
        "myVariable": "Hello World"
    }
}

변수 표시

book.json 에 명시된 변수는 book 범위에서 접근할 수 있습니다:

{{ book.myVariable }}

이것은 책 변수에서 myVariable 을 찾고 그것을 표시합니다. 그들의 속성을 조회하기 위해 변수 이름은 점을 가질 수 있습니다. 또한 대괄호 구문을 사용할 수 있습니다.

{{ book.foo.bar }}
{{ book["bar"] }}

값이 정의되지 않았으면 아무것도 표시되지 않습니다. 다음은 foo 가 정의되지 않으면 아무 결과도 나타내지 않습니다: {{ foo }}, {{ foo.bar }}, {{ foo.bar.baz }}.

문맥 변수

몇몇 변수는 현재 파일 또는 GitBook 인스턴스에 대한 정보를 얻을 수 있습니다.

이름 설명
file.path 책과 연관된 파일의 경로
file.mtime 파일의 마지막 수정된 날짜

태그

태그는 템플릿의 섹션에 대한 작업을 수행하는 특별한 블록입니다.

If

if 는 조건을 확인하여 내용을 선택적으로 보여줍니다. 그것은 프로그래밍 언어의 if 와 같이 동작합니다.

{% if variable %}
  참입니다
{% endif %}

variable 이 정의되있고 평가가 true 이면, "참입니다" 가 표시됩니다. 그외에는 아무것도 발생하지 않습니다.

elif 와 else 를 통해 다른 조건을 명시할 수 있습니다:

{% if hungry %}
  나는 배가고파요
{% elif tired %}
  나는 지쳤어요
{% else %}
  난 괜찮아요!
{% endif %}

for

for 는 배열과 사전을 반복합니다.

book.json 의 변수를 살펴봅시다:

{
    "variables": {
        "authors": [
            { "name": "Samy" },
            { "name": "Aaron" }
        ]
    }
}
# 저자


{% for author in book.authors %}
  - {{ author.name }}
{% endfor %}

위의 예제는 표시 값으로 authors 의 각 항목의 name 속성을 사용하여 모든 저자를 나열합니다.

include

Include 는 내용 참조 글에 자세히 나와있습니다.