[ Home | Freetime works | FreeBSD | KFUG ]

Linuxdoc-SGML 1.6b 한글패치

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

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

한글패치

설치

# ./install

# ./install.quick

설치하는 곳과 플래그 이름, Perl의 위치는 다음과 같습니다.

실행 바이너리 : /usr/local/bin
라이브러리    : /usr/local/share/linuxdoc-sgml-h
관련문서      : /usr/local/doc/linuxdoc-sgml-1.6bh1
Perl의 위치   : /usr/local/bin/perl
컴파일 옵션   : -O

각 포맷별 한글출력

LaTeX출력

기본적으로 LaTeX2e출력, HLaTeX-0.95를 사용하도록 설계 되었습니다. htexp와 같은 다른 종류의 버전에 대해서는 고려하지 않았습니다. 따라서 다른 종류의 한글 TeX을 쓴다면 프로그램을 고쳐야 합니다.

HTML

큰 차이는 없지만, 이동에 필요한 링크(Prev, Back, TOC)에서 한글 출력을 얻을 수 있습니다.

ASCII 텍스트

차례를 '차례'라고 표기하도록 하고, 한글 출력에 있어서 필터링 단계에서 한글이 깨지지 않도록 하였습니다. 이 문서를 more로 볼 때 절 제목이 제대로 나오지 않는 경우가 있는데, 이럴 때에는 more대신 less와 같은 것으로 보면 됩니다.

LaTeX - A4, LaTeX2e, HLaTeX-0.95(0.92e버전 포함)
  % sgml2latex -k -a xxx.sgml
LaTeX - A4, LaTeX2e, hLaTeXp
  % sgml2latex -kp -a xxx.sgml
HTML
  % sgml2html -k xxx.sgml
ASCII Text
  % sgml2txt -k xxx.sgml

패치 내용

Patchlevel 1(96/11/4)

• sgml2latex
  • 기본을 LaTeX-2.09에서 LaTeX2e로
  • 이전 2.09버전을 쓰려면 -209옵션을 주면 됩니다. -2e옵션은 없어졌습니다.
  • a4종이와 LaTeX2e를 함께 쓸때 나타나는 버그 제거
• sgml2html
  • 한글 필터링 추가
  • 이동 메시지 한글판 추가
• sgml2txt
  • 한글 필터링 추가
  • genertoc에서 'Table of Contents'대신 '차례'가 나오도록 추가

Patchlevel 2(97/1/17)

• 한글모드(-k)에서 빠져있던 몇몇 entity를 추가했습니다. entity는 영문판에서 정의된 것들을 한글패치 부분에 넣지 않았기 때문에 생기는 문제였습니다. 그리고 1.5버전에서 정의되지 않으나 쓰고 있는 몇몇 entity들도 넣었습니다. (유성태 <alloying@nownuri.nowcom.co.kr> 님의 도움)
• hLaTeXp에 대한 지원을 추가했습니다(유성태 <alloying@nownuri.nowcom.co.kr> 님의 도움). hLaTeXp사용자는 sgml2latex에서 -k옵션 대신 -kp옵션을 주면 됩니다.
• Manual page를 한글패치에 맞도록 수정하였습니다.
• 각 스크립트(sgml2html, sgml2latex, sgml2txt)의 도움말 출력을 한글패치에 맞도록 수정하였습니다.
• install과 install.quick스크립트를 한글판에 맞도록 수정하였습니다.

소스 구하기

• linuxdoc-sgml-1.6bh2.tar.gz (한글패치)
• linuxdoc-sgml-1.5.tar.gz (원본)
• linuxdoc-sgml-1.4h.tar.gz (1.4한글판 - 기타 참조)

기타

Solaris등의 grep, sed, awk가 GNU버전이 아닌 경우 옵션이나 8비트 캐릭터의 통과에 있어서 문제가 발생하는 경우가 있습니다. 이럴 경우에는 환경변수 LANG를 ko가 아닌 C로 하고 작업을 하거나, GNU버전의 grep, sed, awk를 사용해야 합니다. 이런 경우를 대비해서 각 변환 프로그램이 /usr/local/bin을 먼저 패스로 사용하도록 하였습니다. Linux이외의 다른 OS를 사용하는 경우 참고하시기 바랍니다.

HTML변환의 경우 교차참조를 사용하면 제대로 HTML출력이 나오지 않습니다. 이것은 1.5자체의 버그인데, html2html.l파일을 고치면 되겠는데 제가 lex/flex를 잘 모르는 관계로 고칠 수가 없었습니다. 이것은 샘플에서도 발생하는데, 홈페이지에 가도 그렇습니다. :<

이 버전은 localized이기 보다는 internationalized된 것입니다. 따라서 기존의 동작에는 영향을 미치지 않도록 패치를 한 관계로, 현재 Linuxdoc-SGML의 관리자에게 이 패치를 반영해 주도록 메일을 보냈습니다. 저자는 다른 패치들과 함께 반영하겠다고 하였으니, 다음 Linuxdoc-SGML의 버전에서는 한글의 기본 지원을 기대할 수도 있을 겁니다. :)

그러나 저는 리눅스를 사용하지 않습니다! 저는 FreeBSD유저이며, 학교에서는 솔라리스를 사용합니다. Linuxdoc-SGML은 실제 Linux만이 아니라 일반적인 Unix시스템이라면 문제없이 사용 가능합니다. 따라서 이 버전이 진짜 Linux나 다른 OS에서 어떤 외부효과를 가질 가능성이 있습니다. 패치에 사용된 시스템은 Solaris 2.5, gcc-2.7.2, teTeX-0.4, HLaTeX-0.95이라는 것을 참고하시기 바랍니다. grep이나 sed등은 GNU버전을 사용하였습니다. 다른 기종에서 테스트하실 때에는 이 점을 주의하시기 바랍니다.

Linuxdoc-SGML은 이제 SGML-tools로 이름이 바뀌었습니다. 현재 버전은 0.99.0인데, 실제 이 유틸리티가 리눅스와는 관련이 없게 되었으므로(이것은 LDP(Linux Documentation Project)와 FreeBSD, 그리고 XFree86 Project에서 내부 문서관리의 포맷으로 쓰이고 있습니다), 이름을 바꾸었다고 합니다. 중요한 변화는 아직 이 판에서 일어나지 않았지만, SGML파서를 바꾸고, 1.5판에서의 많은 버그를 잡을 것이라 합니다. 한글패치는 1.5의 패치와 SGML-tools의 중간정도의 버전입니다. SGML-Tools가 정식으로 나오게 되면, 이것에 맞추어 새로 패치를 하는 일이 필요하겠습니다.

관련 링크

• 일본어 Linuxdoc-SGML의 홈페이지
• SGML-tools Official Web Page

$Id: index.shtml,v 1.1.1.1 2001/05/23 03:11:20 cjh Exp $

[ Home | Freetime works | FreeBSD | KFUG ]