닥북 한글 스타일시트 사용법

원하는 출력 형태에 따라 다음 중 하나를 선택한다.

dbk-html.xsl : html 출력용
dbk-html-chunk.xsl : 페이지가 나뉜 html 출력용
dbk-fo.xsl : fo 출력용. 이것은 인쇄를 위한 것으로 PDF로 변환된다.
dbk-htmlhelp.xsl : MS Windows에서 사용되는 도움말 파일로 출력용

좀더 자세한 사용법은 http://docbook.kldp.net/kldpstyle/kldp_xsl.html ?BrokenLink

DocBook SGML에 XSL 적용하기

xsltproc는 DocBook SGML 문서에 XSL을 적용할 수 있게 해준다. 특히 이를 사용하면 xhtml 출력을 할 수 있어서 좋다. xhtml 출력을 위해서는 DocBook XSL 스타일시트에 포함된 xhtml 출력용 스타일시트를 적용시키면 된다.

sgml 파일이 euc-kr 인코딩임을 xsltproc에 알려줄 방법이 특별히 없는 것 같으므로 iconv를 사용해 utf-8 인코딩으로 바꿔준다.

 iconv -f euc-kr -t utf-8   파일이름.sgml  > 파일이름.utf-8.sgml

 xsltproc --docbook --output 파일이름.html   스타일시트.xsl   파일이름.utf-8.sgml

--docbook 옵션은 문서가 DocBook SGML임을 알려준다.

xsltproc는 계속 개선되고 있으므로 항상 최신 버전을 사용해야 한다. 예를 들어 1.0.33 이전 버전에서는 valid하지 않은 xhtml을 출력하는 문제가 있었다.

<reference>
<title>자동 번호 붙임</title>
<refentry id="section.autolabel">
<refmeta>
<refentrytitle>section.autolabel</refentrytitle>
<refmiscinfo role="type">boolean</refmiscinfo>
</refmeta>
<refnamediv>
<refname>section.autolabel</refname>
<refpurpose>절 제목 앞에 번호를 붙일 것인가?</refpurpose>
</refnamediv>
<refsynopsisdiv>
<programlisting id="section.autolabel.frag">
<xsl:param name="section.autolabel" select="0"></xsl:param>
</programlisting>
</refsynopsisdiv>
<refsect1>
<title>설명</title>
<para>
참(0이 아닌 값)이면 절 제목 앞에 번호를 붙인다.
</para>
</refsect1>
</refentry>

제일 위로