sqzass
English

템플릿 데이터

템플릿이 읽을 수 있는 모든 것

모든 페이지에서 site와 page 두 객체를 쓸 수 있습니다.

site
site.title sqzass.toml에서.
site.description sqzass.toml에서.
site.origin 스킴과 호스트만. 페이지 URL이 서브경로를 이미 품고 있어서 {{ site.origin }}{{ page.url }}이 절대 URL입니다.
site.base_path 서브경로 아래 사이트일 때의 경로 접두사, 루트면 빈 값. 템플릿이 직접 쓰는 URL에만 필요합니다.
site.language 지금 렌더 중인 페이지의 언어.
site.sections 이 언어의 최상위 섹션들.
site.highlight_css 생성된 하이라이트 스타일시트 URL. 구문 강조가 꺼져 있으면 없습니다.
site.search 이 언어의 검색 색인 URL. [search] enabled = false면 없습니다.
site.feed 이 언어의 Atom 피드 URL. 날짜 있는 페이지가 하나도 없으면 없습니다. 피드를 참고하세요.

site.sections에는 현재 언어의 트리만 담깁니다. 내비게이션이 안전한 이유가 이것입니다. 번역되지 않은 페이지는 여기 없으므로 그 링크를 그릴 수가 없습니다. 각 섹션은 title, description, url, weight, pages, subsections를 갖고, pages의 각 항목은 title, description, url, weight를 갖습니다.

page
page.title
page.description
page.url /ko/start/installation/
page.permalink 절대 URL — origin + url.
page.content 렌더된 HTML. | safe가 필요합니다.
page.weight, page.draft, page.language front matter 그대로.
page.toc 저자가 목차를 원했는지.
page.toc_entries 목차 자체 — {level, id, title, children}, 중첩된 형태.
page.translations 이 페이지가 존재하는 언어만. 비어 있으면 전환 UI를 그리지 않으면 됩니다.
page.section 이 페이지가 속한 섹션. 최상위 페이지에는 없고, 섹션 인덱스에도 없습니다 — 섹션은 자기 안에 있지 않으니까요.
page.prev, page.next 같은 섹션 안에서의 이웃 페이지. 같은 이유로 섹션 인덱스에는 없습니다.
page.children 섹션의 자식 페이지들. 일반 페이지에서는 비어 있습니다.
page.is_section
page.date 발행 날짜를 조각으로 — year, month, day, date, iso. 없으면 없습니다. 피드를 참고하세요.
page.extra 직접 정의한 [extra] 테이블.

page.children은 두 가지입니다

루트 _index.md에서는 최상위 섹션들이 담기고, 그 밖의 섹션에서는 그 섹션의 자식 페이지들 뒤에 하위 섹션들이 붙습니다. 둘 다 목록 템플릿이 필요로 하는 것이고, 이름만 봐서는 알 수 없습니다.

{% for child in page.children %}
<a href="{{ child.url }}">{{ child.title }}</a>
{%- if child.description %}<p>{{ child.description }}</p>{% endif %}
{% endfor %}

일반 페이지에서는 빈 목록입니다.

page.toc_entries

{level, id, title, children}이고 상대적 깊이로 중첩됩니다. h2 다음에 h4가 와도 중첩되며, 레벨이 연속이라고 가정하지 않습니다. toc = true든 아니든 모든 페이지에서 수집됩니다. front matter의 toc는 저자의 의사이고, 데이터는 어느 쪽이든 있으니 템플릿이 판단하면 됩니다.

그리는 데는 재귀 매크로가 필요합니다.

{% macro toc_list(entries) %}
<ul>
  {%- for e in entries %}
  <li><a href="#{{ e.id }}">{{ e.title }}</a>
    {%- if e.children %}{{ toc_list(e.children) }}{% endif %}
  </li>
  {%- endfor %}
</ul>
{% endmacro %}

{% if page.toc and page.toc_entries %}{{ toc_list(page.toc_entries) }}{% endif %}

asset()

asset("css/main.css")은 그 파일이 실제로 쓰인 해시 붙은 URL을 돌려줍니다.

<link rel="stylesheet" href="{{ asset("css/main.css") }}">

수집되지 않은 파일을 요청하면 에러입니다. 스타일시트 이름을 바꿨을 때 모든 방문자에게 조용히 404를 내는 대신 빌드가 실패합니다.

슬래시는 이스케이프하지 않습니다

Jinja2는 다섯 글자를 이스케이프합니다. 일부 포팅 구현은 /까지 이스케이프하는데, 그러면 모든 페이지의 모든 URL이 href="https:&#x2f;&#x2f;…"가 됩니다. sqzass는 Jinja2 본래의 동작을 되돌려 두었으므로 URL이 URL로 나옵니다.

없는 키는 빌드를 멈춥니다

undefined value: page.descriptoin

설명이 있어야 할 자리에 빈 문자열이 들어가는 대신입니다. 템플릿을 참고하세요.