sqzass
English

첫 사이트 만들기

빈 디렉터리에서 화면에 뜨는 페이지까지

sqzass init mysite
sqzass serve -i mysite

이게 전부입니다. init이 파일 세 개를 쓰고, serve가 그걸 http://127.0.0.1:3000에 띄웁니다. 네 번째 단계는 없습니다.

무엇이 만들어졌나

mysite/
├── sqzass.toml
├── content/
│   └── _index.md
└── templates/
    └── page.html

세 개뿐입니다. 절반을 지워야 하는 스캐폴드는 출발점이 아니니까요. 요청하지 않은 .gitignore도, 예제 블로그 글도, sqzass가 자기 것이라고 여기는 디렉터리도 만들지 않습니다.

init은 이미 sqzass.toml이 있는 디렉터리에서는 실행을 거부합니다. 기존 사이트를 반쯤 덮어쓰는 일이 생길 수 없습니다.

sqzass.toml

키는 둘입니다. 나머지는 전부 기본값이 있고, 적지 않은 키는 그 기본값으로 동작합니다.

title    = "mysite"
base_url = "https://example.com"

content/_index.md

첫 페이지입니다. front matter는 +++ 펜스 사이의 TOML이고, 반드시 적어야 하는 필드는 title 하나뿐입니다.

+++
title = "mysite"
+++

안녕하세요.

templates/page.html

page.content는 이미 HTML이므로 | safe가 필요합니다. 템플릿은 기본적으로 이스케이프하며, 그 기본값 덕분에 본문에 섞인 < 하나가 마크업으로 둔갑하지 않습니다.

<!doctype html>
<html lang="{{ page.language }}">
<head>
<meta charset="utf-8">
<title>{{ page.title }}</title>
{%- if site.highlight_css %}
<link rel="stylesheet" href="{{ site.highlight_css }}">
{%- endif %}
</head>
<body>{{ page.content | safe }}</body>
</html>

site.highlight_css 줄은 빌드가 구문 테마에서 만들어 주는 스타일시트입니다. 빼면 코드 블록에 색이 없이 나옵니다.

빌드하기

sqzass build -i mysite

결과물은 mysite/public에 생깁니다. 모든 페이지는 <경로>.html이 아니라 <경로>/index.html로 쓰이므로 URL이 /about.html이 아니라 /about/이 됩니다. rewrite 규칙이 없는 호스트에서 왜 이게 중요한지는 콘텐츠 작성에 적어 두었습니다. sitemap과 robots.txt도 같이 나옵니다.

작업하기

sqzass serve는 파일이 바뀌면 다시 빌드합니다. 도는 동안 public/에는 아무것도 쓰지 않으므로, 빌드 중인 사이트가 반쯤 쓰인 파일을 내보내는 일이 없습니다. 페이지는 스스로 새로고침하고, CSS만 바뀐 변경은 스타일시트만 갈아 끼워 스크롤 위치를 유지합니다.

Note

개발 서버는 개발용 도구입니다. 캐싱도, 압축도, 접근 제어도 하지 않습니다. 프로덕션에서는 빌드된 디렉터리를 제대로 된 서버로 서빙하세요.

다음에 더할 것

페이지를 하나 더 만드는 건 파일을 하나 더 만드는 일입니다. content/about.md는 /about/이 되고, content/guide/_index.md는 그 옆의 파일들을 묶는 섹션을 시작합니다. 페이지가 가질 수 있는 필드는 front matter에 정리해 두었습니다.