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

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
You will be recognized and honored as a community leader.


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