· 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 문제점



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.0266 sec