· KLDP.org · KLDP.net · KLDP Wiki · KLDP BBS ·
Docbook Sgml/Doc Book_Install-KLDP

You are not allowed to 'backlinks'


DocBook ¼³Ä¡ mini-HOWTO

DocBook ¼³Ä¡ mini-HOWTO

Á¤Çϳç

          
        

ÀÌ ¹®¼­¿¡¼­´Â DocBook DTD¿Í nwalsh stylesheet, jade¸¦ Linux¿Í MS Windows(98, 2000)¿¡ ¼³Ä¡ÇÏ´Â ¹æ¹ý¿¡ ´ëÇØ ¼³¸íÇÏ°í ÀÖ½À´Ï´Ù. ÀÌ ¹®¼­ÀÇ ³»¿ëµéÀº DocBook SGML v4.1À» ±âÁØÀ¸·Î ÇÏ°í ÀÖ½À´Ï´Ù. Â÷ÈÄ¿¡ XML¿¡ ´ëÇÑ ³»¿ëÀÌ Ãß°¡µÇ¸é ÁÁ°ÚÁö¸¸ ¾ðÁ¦°¡ µÉ Áö´Â ¾Ë ¼ö ¾ø½À´Ï´Ù. :)

고친 과정
고침 0.12001-09-26고친이 alita
ù ¸±¸®Áî

1. ¸Ó¸®±Û

ÀÌ ¹®¼­¿¡¼­´Â DocBookÀ» »ç¿ëÇÏ¿© ¹®¼­¸¦ ÀÛ¼ºÇÏ°í html, rtf, dvi µîÀ¸·Î º¯È¯Çϱâ À§ÇØ ÇÊ¿äÇÑ ±âº»ÀûÀÎ ÇÁ·Î±×·¥µé°ú ÆÄÀϵéÀ» ¼³Ä¡ÇÏ´Â ¹æ¹ý¿¡ ´ëÇØ °£·«ÇÏ°Ô ¼Ò°³ÇÏ°í ÀÖ½À´Ï´Ù. ÀÌ ¹®¼­´Â DocBookÀ» »ç¿ëÇÏ´Â ¹æ¹ý¿¡ ´ëÇؼ­´Â ´Ù·çÁö ¾Ê½À´Ï´Ù. ÀÌ¿¡ °üÇÑ »çÇ×µéÀº ÀÌ°÷À» Âü°íÇÏ½Ã¸é µË´Ï´Ù. ¶ÇÇÑ, DocBook¿¡ ´ëÇÑ ¼Ò°³µµ Áö¸é °ü°è»ó »ý·«ÇÕ´Ï´Ù. ÀÌ ³»¿ë ¿ª½Ã À§ÀÇ ¸µÅ©¸¦ ÂüÁ¶ÇÏ½Ã¸é µË´Ï´Ù. ±× ¿Ü ¼³Ä¡¸¦ ÇÏ´Â ÆÄÀϵ鿡 ´ëÇÑ ¼Ò°³ ȤÀº °ü·Ã ¸µÅ©´Â ÇØ´ç ³»¿ë¿¡¼­ ´Ù·ì´Ï´Ù.

참고: ¹®¼­ ÀüüÀÇ ³»¿ëÀº ¼³Ä¡ ¼ø¼­¸¦ µû¸£¸ç °¢ ¼ø¼­¸¶´Ù LinuxÀÇ °æ¿ì¿Í MS Windows °è¿­[1]ÀÇ °æ¿ì¸¦ ³ª´²¼­ ¼³¸íÇÕ´Ï´Ù.[2]


1.1. ÀúÀÛ±Ç Á¤º¸

ÀÌ ¹®¼­´Â GNU Free Documentation License ¹öÀü 1.1 ȤÀº ÀÚÀ¯ ¼ÒÇÁÆ®¿þ¾î Àç´Ü¿¡¼­ ¹ß ÇàÇÑ ÀÌÈÄ ÆÇÀÇ ±ÔÁ¤¿¡ µû¸£¸ç ÀúÀ۱ǿ¡ ´ëÇÑ º» »çÇ×ÀÌ ¸í½ÃµÇ´Â ÇÑ ¾î¶°ÇÑ Á¤º¸ ¸Åü¿¡ ÀÇÇÑ º»¹®ÀÇ ÀüÀ糪 ¹ßÃéµµ ¹«»óÀ¸·Î Çã¿ëÇÕ´Ï´Ù.


1.2. Ã¥ÀÓÀÇ ÇÑ°è

º» ÀúÀÚ´Â ¹®¼­ÀÇ ³»¿ëÀÌ ¾ß±âÇÒ ¼ö ÀÖ´Â ¾î¶°ÇÑ °á°ú¿¡ ´ëÇؼ­µµ Ã¥ÀÓÀ» ÁöÁö ¾Ê½À´Ï´Ù. º» ¹®¼­¿¡¼­ ³»Æ÷ÇÏ°í ÀÖ´Â Á¤º¸µé ¹× ¿¹Á¦µéÀº ¿©·¯ºÐÀÌ ¾Ë¾Æ¼­ È°¿ëÇϽʽÿÀ. ºñ·Ï ÃÖ¼±À» ´ÙÇßÀ¸³ª ÀÌ ¹®¼­´Â Ʋ¸° Á¡À̳ª ¿À·ù°¡ ÀÖÀ» ¼öµµ ÀÖ½À´Ï´Ù. ¸¸¾à ¿©·¯ºÐÀÌ Æ²¸° Á¡À» ¹ß°ßÇß´Ù¸é ²À Àú¿¡°Ô ¾Ë·Á Áֽñ⠹ٶø´Ï´Ù.


1.3. Çǵå¹é

ÀÌ ¹®¼­¿¡ ´ëÇÑ ¹ßÀüÀûÀÎ Á¦¾ÈÀ̳ª ¼öÁ¤»çÇ×, ¹®Á¦Á¡ µî¿¡ ´ëÇÑ Çǵå¹éÀº ¾ðÁ¦µçÁö ȯ¿µÇÕ´Ï´Ù. ·Î ¸ÞÀÏÀ» º¸³» ÁֽʽÿÀ.


2. ÇÊ¿äÇÑ ÇÁ·Î±×·¥µéÀÇ ¼³Ä¡


2.1. DocBook DTD

DocBook DTD´Â http://www.docbook.org/sgml/4.1/docbk41.zip¿¡¼­ ¹ÞÀ» ¼ö ÀÖ½À´Ï´Ù. ½ÇÇàÆÄÀÏÀ̳ª ¶óÀ̺귯¸®°¡ ¾Æ´Ï±â ¶§¹®¿¡ Linux¿Í Windows ¸ðµÎ °°Àº ÆÄÀÏÀ» »ç¿ëÇÕ´Ï´Ù. À̸¦ ¹ÞÀº ÈÄ ÀÓÀÇÀÇ µð·ºÅ丮¿¡ DZ´Ï´Ù. ¾ÕÀ¸·Î ÀÌ µð·ºÅ丮¸¦ %DOCBK41%[3]À¸·Î Ç¥±âÇÕ´Ï´Ù.


2.2. ISO entity set

ISO entity setÀº www.oasis-open.org/cover/ISOEnts.zip¿¡¼­ ¹ÞÀ» ¼ö ÀÖ½À´Ï´Ù. À̸¦ %DOCBK41% ¾È¿¡ DZ´Ï´Ù. ±×·¯¸é ISOpub, ISOtech, ISOnum °°ÀÌ È®ÀåÀÚ ¾øÀÌ À̸§ÀÌ ISO<entity>ÀÎ ÆÄÀϵéÀÌ Ç®¸³´Ï´Ù. %DOCBK41%docbook.catÀ» º¸½Ã¸é ¸¶Áö¸·¿¡ ISO entity sets ¼³Á¤ ºÎºÐÀÌ Àִµ¥ À̸§ÀÌ iso-<entity>.gml Çü½ÄÀÎ °ÍÀ» ¾Ë ¼ö ÀÖ½À´Ï´Ù. µû¶ó¼­ ÀÌ docbook.catÀ» °íÃļ­ ISO<entity> Çü½ÄÀ¸·Î ¸¸µé°Å³ª ISO<entity> ÇüÅÂÀÎ ÆÄÀϵéÀÇ À̸§À» ISO-<entity>.gml ÇüÅ·Π¹Ù²ãÁÝ´Ï´Ù. ÀüÀÚ°¡ ½±°ÚÁÒ? :)

참고: ¿©±â¿¡¼­ ISO entity setÀÌ ¿Ö ÇÊ¿äÇÑÁö¸¦ ¼³¸íÇÕ´Ï´Ù.[4]


2.3. Stylesheet

StylesheetÀº Normal WalshÀÇ Modular DocBook StylesheetÀ» »ç¿ëÇÕ´Ï´Ù. http://sourceforge.net/projects/docbook¿¡¼­ Á÷Á¢ ¹ÞÀ» ¼ö ÀÖ°í ÀÌ ±ÛÀ» ¾²´Â ½ÃÁ¡¿¡¼­ ÃֽŠ¹öÀüÀº 1.72ÀÔ´Ï´Ù. ÀÌ ÆÄÀÏÀ» Ç®¸é docbookÀ̶ó´Â µð·ºÅ丮°¡ ¸¸µé¾îÁö°í ±× ¾È¿¡ ÆÄÀϵéÀÌ Ç®¸³´Ï´Ù. ÀÌ docbookÀ̶ó´Â µð·ºÅ丮´Â %NWALSH%¶ó ÇÏ°Ú½À´Ï´Ù.


2.4. Jade

jade´Â stylesheetÀ» ÀÌ¿ëÇÏ¿© DocBook ¹®¼­¸¦ html, rtf µîÀÇ ¹®¼­·Î º¯È¯ÇØ ÁÖ´Â ´ëÇ¥ÀûÀÎ toolÀÔ´Ï´Ù. http://www.jclark.com/jade/#getting¿¡ °¡½Ã¸é ÃֽŠ¹öÀüÀ» ¹ÞÀ» ¼ö ÀÖ½À´Ï´Ù. ¹ÞÀº ÆÄÀÏÀ» Àû´çÇÑ µð·ºÅ丮¿¡ DZ´Ï´Ù. ÀÌ µð·ºÅ丮´Â %JADE%¶ó ÇÏ°Ú½À´Ï´Ù.


2.5. SGML_CATALOG_FILES

catalog fileµéÀÇ À§Ä¡¸¦ ÁöÁ¤ÇØ ÁÖ´Â SGML_CATALOG_FILES¶ó´Â ȯ°æ º¯¼ö¸¦ ¼³Á¤ÇØ Áà¾ß ÇÕ´Ï´Ù.


2.5.1. Linux

Bash »ç¿ëÀÚ

  bash$ export SGML_CATALOG_FILES=$DOCBK41\docbook.cat;$JADE\catalog
               

Tcsh »ç¿ëÀÚ

  tcsh$ setenv SGML_CATALOG_FILES $DOCBK41\docbook.cat;$JADE\catalog
               


2.5.2. Windows

command prompt »ó¿¡¼­

  C:\>set SGML_CATALOG_FILE=%DOCBK41%\docbook.cat;%JADE%\catalog
	  
ÇϽðųª Windows 2000 °è¿­Àº ³» ÄÄÇ»ÅÍ->½Ã½ºÅÛ µî·ÏÁ¤º¸->°í±Þ->ȯ°æ ¹ø¼ö->»õ·Î ¸¸µé±â(N) Çؼ­ Ãß°¡ÇØ ÁÖ¸é ÀÌÈÄ ½ÇÇàµÇ´Â ¸ðµç ÇÁ·Î±×·¥µé¿¡ Àû¿ëµË´Ï´Ù.


2.5.3.

ÀÌÁ¦, ´ÙÀ½°ú °°ÀÌ ÇÏ¸é µË´Ï´Ù. html·Î º¯È¯ÇÒ ¶§

  C:\>%JADE%\jade -t sgml -d %NWALSH%\html\docbook.dsl filename.sgml
	  
rtf·Î...
  C:\>%JADE%\jade -t rtf -d %NWALSH%\print\docbook.dsl filename.sgml
	  
tex·Î...
  C:\>%JADE%\jade -t tex -d %NWALSH%\print\docbook.dsl filename.sgml
	  


2.6. KLDP¿ë Stylesheet

kldp.dsl ´Ù¿î http://docs.kldp.org/Stuff/kldp.dslÀ» ¹Þ¾Æ¼­ ¾Æ¹« µð·ºÅ丮¿¡´Ù º¹»çÇÕ´Ï´Ù. ÀÌ µð·ºÅ丮´Â %KLDP%¶ó ÇÏ°Ú½À´Ï´Ù. kldp.dslÀ» ¿­¾î¼­

/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl
        
¶ó°í µÇ¾î ÀÖ´Â ÁÙÀ»
  %NWALSH%/html/docbook.dsl
        
·Î,
  /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl
        
À»
  %NWALSH%/print/docbook.dsl
        
·Î ¹Ù²ãÁÝ´Ï´Ù.

ÀÌÈÄ jade¸¦ ¾µ ¶§´Â

  C:\>%JADE%\jade -t sgml -i html -d %KLDP%\kldp.dsl#html filename.sgml
  C:\>%JADE%\jade -t rtf -d %KLDP%\kldp.dsl#print filename.sgml
        
°°ÀÌ ½áÁÖ¸é µË´Ï´Ù.

주석

[1]

ÀÌÇÏ Windows

[2]

½ÇÁúÀûÀ¸·Î µÎ OS°£¿¡ Â÷ÀÌÁ¡À̶ó°ï jade¸¦ ¼­·Î ´Ù¸¥°É ¹Þ¾Æ¿Í¾ß ÇÑ´Ù´Â °Í°ú ȯ°æ º¯¼ö¸¦ ³ªÅ¸³»´Â ¹æ¹ýÀÌ ´Ù¸£´Ù´Â °Í ¹Û¿¡ ¾ø½À´Ï´Ù.

[3]

Windows°è¿­Àº ȯ°æ º¯¼ö¸¦ %NAME%À¸·Î Ç¥±âÇÏ¸ç ´ë¼Ò¹®ÀÚ ±¸ºÐÀÌ ¾ø½À´Ï´Ù. *inx¿¡¼­´Â ¹°·Ð $NAME ÇüÅÂÀÌ¸ç ´ë¼Ò¹®ÀÚ¸¦ ±¸ºÐÇÕ´Ï´Ù.

[4]

¹ø¿ªº»Àº ÀúÀÚ µ¿ÀǸ¦ ¾ò¾î¼­ Ãß°¡ÇÏ°Ú½À´Ï´Ù.


ID
Password
Join
Deprive a mirror of its silver and even the Czar won't see his face.


sponsored by andamiro
sponsored by cdnetworks
sponsored by HP

Valid XHTML 1.0! Valid CSS! powered by MoniWiki
last modified 2006-08-07 16:33:19
Processing time 0.0017 sec