닥북 XSL 매개변수 설정

닥북 XSL 매개변수를 설정하는 방법

닥북 XSL은 문서 변환 방식 또는 출력물의 모습을 제어하는 다양한 매개변수들을 제공한다. 설정할 수 있는 매개변수들은

에서 찾을 수 있다.

커스텀 XSL 스크립트에서 설정

기본적인 내용은 닥북 XSL 커스텀화를 보라. 여기서는 닥북 한국이 제공하는 dbk-*.xsl 을 이용하는 방법을 이야기한다.

방법은 간단하다. 원하는 dbk-*.xsl 파일을 편집기로 열고, </xsl:stylesheet> 이전에 다음과 같은 형태의 구문을 추가하면 된다.

<xsl:param name="매개변수 이름" select="값"/>

여기서 중요한 것은, 값이 문자열인 경우에는 작은 따옴표로 한 번 더 감싸 주어야 한다는 점이다. 예를 들면

<xsl:param name="generate.toc" select="'book toc'"/>

xsltproc 실행 시 설정

xsltproc 실행 시 --parm 매개변수이름 값 또는 --stringparam 매개변수이름 값 형태의 옵션을 추가한다. --param으로 문자열 값을 지정할 때에는 값을 반드시 따옴표로 감싸야 한다. --stringparam의 경우에는 그럴 필요가 없다. 단 빈칸이 포함된 문자열 값이라면 역시 따옴표로 감싸야 한다.

예(실제로는 한 줄로 입력해야 함)

xsltproc --stringparam generate.toc "book toc,title"
--param toc.section.depth 2
%DOCBOOK_HOME%\stylesheet\dbk-html-chunk.xsl test.xml

runlua xslt 명령의 설정 파일을 통한 설정

이름=값 형태의 줄들로 된 설정 파일(보통의 텍스트 파일)을 만들어 두고 runlua xslt 실행 시 -c 옵션으로 그 파일을 지정하면 된다.

예를 들어 다음과 같은 내용을 담은 myhtml.conf 라는 파일을 만들어 두고,

#로 시작하는 줄은 주석
# 목차 관련
toc.section.depth=2
section.autolabel=1
# css
html.stylesheet.type = text/css
html.stylesheet = dbk.css
css.decoration = 0

다음과 같이 실행하면 된다.

runlua xslt -c myhtml.conf {dbk-html-chunk} test.xml

제일 위로