· KLDP.org · KLDP.net · KLDP Wiki · KLDP BBS ·
Doc Book sgml, Linuxdoc sgml --> 위키텍스트 변환

지금 현재 문서화 작업을 위키로 전환하는데 있어 가장 시급하고도 중요한 문제는 바로 기존의 문서들을 어떻게 효과적으로 위키에 넣을 수 있느냐 하는 것입니다.

기존 문서는 크게 DocBook sgml 형태의 소스와 LinuxDoc sgml 형태의 소스로 나뉘는데 이중 LinuxDoc sgml 소스가 좀더 오래전에 만들어진 것들입니다. 따라서 이 둘은 서로 다르게 취급되어야 하며 파일을 보시면 아시겠지만 html과 같은 식의 태그들로 이루어져 있고, 정해진 프로그램을 사용하면 하나의 소스로부터 html, dvi, ps등등 여러가지 포맷의 출력물을 얻을 수 있습니다. 출력물을 기준으로 보면 DocBook sgml과 LinuxDoc sgml은 태그와 사용하는 프로그램만 다를 뿐 기본적인 개념은 같다고 할 수 있습니다.

그리고, 위키에서 저장되는 각 페이지의 경우 위키 고유의 문법을 가지고 있습니다. (WikiSandBox 참조)

따라서 필요한 작업은, 기존의 DocBook / LinuxDoc 문서의 태그를 적절한 방법을 거쳐 위키의 문법으로 교체하는 것입니다. 현재 문서의 갯수가 상당히 많기 때문에 일일이 손으로 변환하기에는 상당히 무리가 있고 많은 시간이 소요될 것이 분명하므로 이를 자동적으로 할 수 있는 프로그램이 필요합니다. (DocBook 변환용, LinuxDoc 변환용 각각 따로)

예를 들어 db2wiki 입력파일명 으로 실행하면 위키텍스트를 표준출력으로 내보내는 정도면 충분합니다. 지금 현재 이곳에서 사용하고 있는 MoniWiki에서는 파일명이 페이지의 제목이 되기 때문에 각 문서의 제목별로 파일명을 일일이 다르게 결정해서 위키텍스트를 생성해야 하기 때문입니다.

혹시 이 작업에 관심있으신 분들은 아래 DocBook sgml, LinuxDoc sgml 의 예제 파일을 받아서 테스트해 보십시오.

질문

MoniWiki는 jade,sgml2html을 이용해서 DocbookSgml LinuxdocSgml 하위 페이지를 html로 랜더링해서 캐쉬에 보관합니다. 그런데, dsssl을 이용하는 DocbookSgml의 경우, #html이 kldp.dsl#html이 붙는 형태입니다. #wiki라는 옵션도 이론적으로 넣을 수 있을 것 같은데 그런가요 ? --WkPark
kldp.dsl#wiki 뭐 이런 식으로 쓰려면 kldp.dsl 파일을 고쳐야 하겠지요. kldp.dsl은 대부분의 내용을 docbook.dsl을 참고하고, 몇가지 부분에 대해서 별도로 재정의하거나 새롭게 정의한 내용들을 포함하고 있는 것인데...저도 자세한 것은 잘 모르겠네요. http://docbook.kldp.net 에 물어보시는게 가장 빠를것 같습니다. :-) -- 권순선
http://www.prescod.net/dsssl/을 보면 dsssl(Document Style Semantics and Specification Language)을 알아야 하나 봅니다. ㅡㅡ;; --WkPark

문제점

extracted to 문제점

ID
Password
Join
It is better to wear out than to rust out.


sponsored by andamiro
sponsored by cdnetworks
sponsored by HP

Valid XHTML 1.0! Valid CSS! powered by MoniWiki
last modified 2005-02-22 23:24:45
Processing time 0.0041 sec