훅

훅은 사용자 정의 콜백으로 프로세스의 동작을 보강하거나 변경하는 방법입니다.

훅의 목록

전역 파이프라인과 연관된 것

페이지 파이프라인과 연관된 것

페이지 분석을 확장하는데 템플릿 사용을 권장합니다.

페이지 객체

{
    // 구문 분석기 이름
    "type": "markdown",

    // 책 루트에 대한 파일의 상대 경로
    "path": "page.md",

    // 파일의 절대 경로
    "rawpath": "/usr/...",

    // 개요에서 페이지의 제목
    "title": "",

    // 페이지의 내용
    // "page:before" 의 마크다운/Asciidoc
    // "page" 의 HTML
    "content": "# Hello"
}

제목 추가 예시

page:before 훅에서, page.content 는 마크다운/AsciiDoc 내용입니다.

{
    "page:before": function(page) {
        page.content = "# 제목\n" +page.content;
        return page;
    }
}

몇몇 HTML 을 대체하는 예시

page 훅에서, page.content 는 마크다운/AsciiDoc 변환으로 생성된 HTML 입니다.

{
    "page": function(page) {
        page.content = page.content.replace("<b>", "<strong>")
            .replace("</b>", "</strong>");
        return page;
    }
}

비동기 작업

훅 콜백은 비동기로 처리하고 프로미스를 반환할 수 있습니다.

예시:

{
    "init": function() {
        return writeSomeFile()
        .then(function() {
            return writeAnotherFile();
        });
    }
}