[ Home | Freetime works | FreeBSD | KFUG ]

SGML-Tools 1.0.x 한글패치

SGML-Tools 1.0.x와 한글패치는 더 이상 관리되지 않고 모두 linuxdoc-tools로 이전합니다. 그쪽 페이지를 보세요.

SGML-Tools은 SGML과 Linuxdoc DTD에 기반한 문서작성 도구입니다. 이를 사용해서 LaTeX, HTML, GNU info, LyX, RTF, 그리고 ASCII텍스트 문서를 한 파일에서 만들어 낼 수 있습니다.

이 시스템은 Linux HOWTO를 비롯한 소프트웨어 문서를 작성하는데 적합합니다. 그러나 이 시스템은 Linux에만 관련된 것이 아니고, 여러 시스템에서 다양한 목적 으로 사용이 가능합니다.

한글 버전은, SGML-Tools 1.0.x버전와 현재 진행되고 있는 패치, 여기에 한글 출력에 필요한 패치를 더한 것입니다. 이 버전은 LaTeX, HTML, ASCII파일 출력에서 한글 출력을 지원합니다. 다른 출력을 지원하지 않는 것은 지원 여부를 알 수 없거나(rtf), 한글 문서작성이 불가능한 경우(LyX)가 있기 때문입니다. info은 8비트 출력이 되도록 info자체에 패치를 하면 볼 수 있습니다.

원래 이 프로그램은 Linuxdoc-SGML이라는 것이었으나, 현재는 SGML-Tools로 바뀌었습니다. 여기에 대해서는 나중에 자세히 설명할 일이 있겠지만, 이 패치는 기본적으로 Linuxdoc-SGML 한글패치에 기반한 것입니다.

설치

SGML-Tools의 설치는 매우 간단합니다. GNU configure로 작성되어 있으므로, 대부분 이렇게 설치하면 됩니다. 설치할때에는 doc디렉토리의 문서를 읽어보도록 하세요.

# gzip -cd sgml-tools-1.0.xk-xxxxxx.tar.gz
# cd sgml-tools-1.0.xk-xxxxxx
# ./configure
# make
# make install

각 포맷별 한글출력

LaTeX출력: 기본적으로 LaTeX2e출력, HLaTeX를 사용하도록 설계 되었습니다. hlatexp를 사용하신다면 --hlatexp옵션을 주시면 됩니다.
HTML: 큰 차이는 없지만, 이동에 필요한 링크(Prev, Back, TOC)에서 한글 출력을 얻을 수 있습니다.
ASCII 텍스트: 차례를 '차례'라고 표기하도록 하고, 한글 출력에 있어서 필터링 단계에서 한글이 깨지지 않도록 하였습니다. 이 문서를 more로 볼 때 절 제목이 제대로 나오지 않는 경우가 있는데, 이럴 때에는 more대신 less와 같은 것으로 보면 됩니다. 프린터로 출력하면 깨지는 경우가 있는데, 이럴 때에는 sgml2txt에 -f옵션을 주세요. 또한 때로 비정상적으로 빈 공간이 생길 수가 있는데, 이에 대한 해결책은 아직 없지만, -s옵션을 주시면 어느정도 막을 수 있습니다.

기본적으로 한글을 사용하도록 하였으므로, 각 변환 프로그램(sgml2latex, sgml2html, sgml2txt)에서 한글로 작성된 SGML문서를 통과시키려면, 그대로 사용하면 됩니다.

% sgml2txt nolja.sgml
% sgml2txt nolja               (.sgml을 가정합니다)
% sgml2html nolja.sgml
% sgml2latex nolja

다른 옵션도 함께 주는 일이 가능합니다.

패치 내용

일본어 SGML-Tools 패치에서 몇가지 점을 적용하였습니다.
- 텍스트 변환에서 필요없는 강조/이탤릭의 삭제
- <trans>와 <tdate>태그의 추가. 이것으로 번역자와 번역일을 표시할 수 있습니다. 현재 text버전과 html, latex버전에서 지원합니다. 사용법은 예제를 보시면 됩니다. 단 이 태그는 Linuxdoc DTD의 원래 태그가 아니므로, 영문 버전에서는 이 태그를 사용한 문서는 에러가 날 수 있습니다. 단순히 번역자의 편의를 위한 확장이라는 점을 명심하세요.
한국어(ko)와 euc-kr인코딩 추가: euc-kr인코딩은 말로만 추가하였을 뿐 이에 대해 특별한 처리는 하지 않습니다. 단지 8비트를 모두 통과시킬 뿐입니다.
텍스트, HTML, LaTeX출력 지원: LaTeX출력에는 HLaTeX 또는 hlatexp가 필요합니다. 주 테스트 HLaTeX 0.98에서 해 보았습니다.
기본 모드가 한국어입니다(language=ko, charset=euc-kr). 따라서 한글 SGML문서를 처리하기 위해 별도로 지정해야 할 것은 없습니다.

소스 구하기

소스는 ftp://ftp.kr.freebsd.org/pub/users/cjh/sgml-tools-ko/에서 구할 수 있습니다.

sgml-tools-1.0.9k-20000706.tar.gz (한글패치)

예제

SGML-Tools로 작성한 문서의 예는 페이지에서 보시기 바랍니다.

기타

Linuxdoc-SGML때 부터, 이 프로그램의 한글화 작업은 있어 왔습니다. 신동준(djshin@summer.snu.ac.kr)님의 1.4버전의 한글화 작업이 그것입니다. 그러나 1.4버전과 1.5버전간에 약 1년간의 긴 공백이 있고, 1.5버전에서는 다국어 지원을 위한 배려가 약간은(!)되어 있기 때문에, 새로 작업하는 것이 더 나았습니다. 그러나 그 아이디어 자체는 많이 영향을 받은 것입니다. 이후 Linuxdoc-SGML이 SGML-Tools로 변경됨에 따라, 새로 패치를 하였습니다. 많이 달라져서 완전히 새로 하는 것이나 다름이 없었습니다.

HTML이나 TXT변환의 경우 교차참조를 사용하면 제대로 HTML출력이 나오지 않습니다. 이것은 SGML-Tools 자체의 버그입니다. 이것은 샘플에서도 발생하는데, 홈페이지에 가도 그렇습니다. :<

Linuxdoc-SGML은 SGML-tools로 이름이 바뀌었습니다. 현재 버전은 Linuxdoc DTD버전이 1.0.x이고, DocBook버전이 2.0.x입니다. 이 유틸리티가 리눅스와는 관련이 없고(이것은 LDP(Linux Documentation Project)와 FreeBSD, 그리고 XFree86 Project에서 내부 문서관리의 포맷으로 쓰이고 있습니다) DocBook DTD로 전환하는 관계로 이름을 바꾸었다고 합니다. 1.0.x버전은 Linuxdoc-SGML의 버그수정 및 안정판이어서 Linuxdoc DTD를 사용하지만, 2.0버전은 Davenport DocBook DTD를 새로이 사용합니다. 하지만 아직 2.0에서는 한글을 쓸 수 없습니다.

SGML-Tools 1.0.x 한글패치

SGML-Tools 1.0.x와 한글패치는 더 이상 관리되지 않고 모두 linuxdoc-tools로 이전합니다. 그쪽 페이지를 보세요.

설치

각 포맷별 한글출력

패치 내용

소스 구하기

예제

기타

관련 링크