DocBook Korea

dbkpack-2.0-installer-1.0 설치 시 계속 오류나네요.

Sat, 21 Jan 2012 18:41:24 +0900

이제야 패키지 파일 갱신했습니다... ( http://kldp.net/projects/docbook/download/note/3363 )

설치 프로그램 다음 버전은 dbkspec.lua 파일을 닥북 한국 사이트에서 직접 내려 받아서 설치를 진행하는 방식이 될 것입니다. 넉넉히 올 상반기 안에 구현해 보겠습니다.

.po 를 가지고 .html 만들기?

Thu, 15 Sep 2011 07:12:24 +0900

http://gimp.kr/viewtopic.php?f=15&t=2601 질문 올려 놓았는데 아직 답변이...
닥북 사용하시는 분중엔 위 질문에 답변해 주실 수 있는 분이 있으리라 믿고 닥북 게시판에도 올립니다.

자동 줄바꿈 시 단어 짤림 방지

Mon, 16 May 2011 17:20:48 +0900

stylesheet/dbk-fo.xsl 보면

<xsl:param name="hyphenate">false</xsl:param>

로 되어 있습니다. 즉 하이픈 분리 기능이 꺼져 있습니다. true로 바꾸어도 관련 패턴이 없다는 오류가 납니다. 이 때문에 꺼 두었던 것이고요.

근본적인 해결책은 FOP가 원하는 한국어 하이픈 분리 패턴을 만드는 것인데, http://xmlgraphics.apache.org/fop/1.0/hyphenation.html 과 http://offo.sourceforge.net/ 을 출발점으로 삼아서 시도해 보세요. 그냥 영어용 패턴을 복사하는 수준으로 간단히 해결될 수도 있습니다.

해결책을 만드셨다면 닥북 모음집에 기증해 주시길... 이것이 해결된다면 닥북 한국 뿐만 아니라 한국의 모든 FOP 사용자에게도 쾌거가 될 것입니다. (... 라고 하니 이미 누군가 만들어 두었을 수도 있겠다는 생각도 듭니다.)

dbkpack-2.0-installer-1.0 사용자인데 pdf 변환 시 chapter#1.# 이렇게 붙는�

Fri, 29 Apr 2011 17:45:49 +0900

좀 더 정확하게는 주어진 글자에 해당하는 자형이 글꼴 파일에 없기 때문입니다.

docbook-xsl의 common/en.xml을 보면 <chapter>의 표시에 쓰이는 문자열이 나오는데... Chapter 다음의 빈칸이 보통의 빈칸이 아니라 "줄바꿈 금지" 빈칸인 nbspace입니다(유니코드 0xA000). 그런데 현재 닥북 모음집에서 제목 표시에 쓰이는 글꼴인 UnGraphic에 이 0xA000에 해당하는 자형이 없습니다.

가장 쉬운 해결책은 lang="ko"를 사용하는 것이고요. (그러면 common/ko.xml이 적용되는데 여기에는 A000이 없습니다.)

영문 문서를 위한 좀 더 본격적인 해결책은 0xA000 자형이 있는 글꼴을 제목 표시용으로 사용하는 것인데요. 참고로 닥북 모음집에서 제목 표시용 글꼴 설정은 conf/dbk-pdf.conf 의 title.font.family= 줄입니다. 물론 fop-config.xml에 등록한 글꼴을 사용해야 하고요.

닥북에서 실체요소 사용 한계는?

Fri, 15 Apr 2011 19:17:03 +0900

XInclude 를 한 번 살펴보세요~

http://www.sagehill.net/docbookxsl/ModularDoc.html#UsingXinclude

그런데 현재 모음집 2.0의 docbookto 명령은 xsltproc(기본 옵션)에 대해서만 XInclude가 활성화되어 있습니다. Xalan이나 Saxon에서 XInclude가 작동하게 하려면 모음집의
bin/xalan.bat과 bin/saxon.bat을 http://www.sagehill.net/docbookxsl/Xinclude.html 을 참고해서 적절히 수정하셔야 합니다. (다음 번 업데이트는 이 부분이 주가 되겠네요...)

Oxygen XML 과 Entity

Thu, 14 Apr 2011 15:39:17 +0900

안녕하세요

닥북을 메모장으로 만들면서 이렇게 계속 마크업을 써주어야 하는데 어떻게 닥북이 저자에게 글에만 집중할 수 있게 해주는가 하고 생각하다가 Oxygen XML의 닥북5 문서를 사용해보니 매우 훌륭하더군요.

그런데 제가 닥북을 사용하려는 이유가 모듈화를 통한 문서의 재사용이라서 외부실체요소의 사용이 절실한데 Oxygen 에는 외부실체요소(내부실체요소) 선언이라던가 하는게 도통 보이질 않아서 OXYGEN 홈페이지를 열심히 찾아보고 있긴 한데 혹시 OXYGEN을 사용해 보신 분이 계시다면 실체요소 사용과 관련해서 조언을 좀 부탁드립니다.

혹은 다른 편집기 프로그램의 추천을 부탁드립니다.

감사합니다.

CHAPTER 번호와 제목앞에 #이 들어가는데요

Thu, 14 Apr 2011 13:39:30 +0900

일단 lang 을 ko로 지정해 주니 chapter가 장으로 나오고 #가 안나오긴 하네요.^^

Docbook 폰트

Thu, 10 Mar 2011 18:09:34 +0900

conf/font-config.xml 에 등록되어 있는 글꼴이면 관련 스타일시트 매개변수 설정만 하면 됩니다. (예: http://docbook.kr/phpBB2/viewtopic.php?t=814 )

등록되지 않은 글꼴인 경우에는.... ttfreader 로 게시판을 검색해 보면 몇 가지 참고할만한 글들이 나올 것입니다.

닥북 모음집 2.0 정식 버전 나왔습니다.

Mon, 28 Feb 2011 18:19:03 +0900

다운로드:
http://kldp.net/projects/docbook/download/note/3363

변경 사항:
* Windows 7에서 디렉터리 설정이 잘 안 되던 버그를 수정했습니다.
* 가끔 다운로드가 잘 안 되던 몇몇 압축 파일들을 원래의 사이트에서 KLDP.net으로 이동했습니다.
* 설치 오류 시 메시지 상자가 뜨게 했습니다(사용자가 설치 프로그램을 계속 지켜볼 필요가 없도록).

지난 베타 버전과 기능상의 차이는 없으니, 베타 버전을 문제 없이 설치하셨다면 굳이 다시 설치할 필요는 없습니다.

Windows 7 사용하시는 분 도움 부탁합니다 - 닥북 모음집 2.0 베타 설정 프로그램 패치

Thu, 24 Feb 2011 19:23:03 +0900

보고 고맙습니다~ 조만간 몇 가지 사소한 수정들까지 적용해서 2.0 정식을 릴리스하겠습니다.

fop의 경고 메시지 두 개는 예전 모음집의 FOP 0.9x에서는 없었는데 FOP 1.0으로 바꾸면서 등장했습니다. 웹을 검색해 봤는데 딱히 해결책은 못찾았습니다...

xml->pdf 변환이 잘 안 됩니다.

Wed, 23 Feb 2011 17:55:15 +0900

http://docbook.kr/phpBB2/viewtopic.php?topic=842 에 패치를 올렸으니 시험해 주세요~

DTD와 schema

Wed, 23 Feb 2011 01:01:24 +0900

54536 씀:

docbook 설치 폴더 내에 보면 schemas 폴더가 있는데 그 안을 보면 DTD 파일도 있고 xsd(스키마) 파일도 있더군요.
DTD나 스키마나 어차피 용도는 같을 텐데 둘 중 아무거나 써도 상관없는 것인가요?
그리고... 제가 스키마 파일을 이용해서 이클립스로 xml 문서를 한 번 만들어봤는데, 엘리먼트의 종류가 많아서 어떤 것을 써야할지 감이 잘 안 오더군요...;
저 같은 경우는 그냥 간단하게 작업 로그 같은 걸 닥북으로 한 번 만들어보려고 했는데 쉽지는 않은 것 같습니다.
혹시 이런 용도로 닥북을 사용하는데 참고할 만한 자료 같은 게 없을까요...?

사실 닥북 5.0은 Relax-NG(rng 폴더)가 기본입니다. 그러나 아직 rng에 대한 경험이 없어서 닥북 모음집에서는 여전히 DTD를 기본으로 하고 있는데요. 한번 시도해 보시고 경험을 공유해 주시길!

읽을 거리로는 http://www.docbook.org/tdg51/en/html/ch01.html#introduction-rng 에서 시작하시면 좋겠고요. "Thanks to RELAX NG, it is now much easier to create customized versions of DocBook"라고 하니 아마 원하시는 용도와도 잘 맞을 것 같습니다.

닥북 모음집 2.0 설치 도중 파일 다운로드에 실패하는 경우

Sun, 13 Feb 2011 23:02:38 +0900

닥북 모음집 2.0부터는 주요 구성요소들을 웹에서 내려받아서 설치하는데요. 가끔 다운로드가 실패하는 경우가 있습니다. 설치를 종료하고 install.bat을 다시 실행해도 비슷한 문제가 반복된다면 다음과 같이 해보세요.

* 실행 프로그램 창을 보면 어떤 zip 파일의 다운로드가 실패했는지 알 수 있습니다.
* 그리고 installer/dbkspec.lua 를 보면 그 파일의 구체적인 URL을 알 수 있고요.
* 그 URL을 이용해서, 브라우저나 FTP 클라이언트로 해당 zip 파일을 직접 다운 받아서 installer/files 디렉터리에 집어 넣으세요.
* install.bat을 실행하면 설치 프로그램은 다운로드늘 생략하고 files 폴더에 있는 것을 직접 사용합니다.

관련 팁으로, 설치 프로그램은 installer/files 디렉터리에 확장자가 .done인 파일이 있으면 해당 zip의 설치를 완전히 건너뜁니다. 다운로드는 잘 되었지만 뭔가 빠졌다거나 파일들을 잘못 삭제한 경우에는 zip 파일뿐만 아니라 .done 파일도 삭제한 후에 install.bat을 다시 실행해 보세요.

닥북 모음집 2.0의 조사 자동 선택 기능 시험 방법

Sun, 13 Feb 2011 22:55:40 +0900

http://kldp.net/projects/docbook/download/note/3360 에서 설치 프로그램 받아서 설치 후 dbkshell.bat을 실행하고, test 디렉터리로 가서(cd test) 다음을 실행해 보세요.

> docbookto pdf --xalan post-position-test.xml

post-position-test.pdf에

컴퓨터
• “2”는
• “2”는
• “2”가
• “2”가

등이 나오면 제대로 된 것입니다.

--xalan을 빼고 PDF를 생성하면

> docbookto pdf post-position-test.xml

컴퓨터
• “2”은
• “2”는
• “2”이
• “2”가

으로 조사가 잘못 나타납니다.

닥북 모음집 2.0 베타 버전 나왔습니다.

Sun, 13 Feb 2011 22:51:49 +0900

http://kldp.net/projects/docbook/download/note/3360 에서 내려 받으세요.

주요 변경 사항은:

* 웹 설치 방식으로 바뀌었습니다.
* FOP 1.0, 닥북 XSL 1.76.1 등 주요 구성요소들이 최신 버전으로 갱신되었습니다.
* 고동진님의 한글 조사 자동 선택 패키지가 포함되었습니다.

문제점 보고나 질문은 자유 게시판이나 질문과 답변 게시판에 올려 주세요~