001  <?xml version="1.0"?>
002  <!DOCTYPE book [
003  <!ENTITY introduction SYSTEM "chap1.xml">
004  <!ENTITY background SYSTEM "chap2.xml">
005  <!ENTITY features SYSTEM "chap3.xml">
006  <!ENTITY input SYSTEM "chap4.xml">
007  <!ENTITY buffer-overflow SYSTEM "chap5.xml">
008  <!ENTITY internals SYSTEM "chap6.xml">
009  <!ENTITY call-out SYSTEM "chap7.xml">
010  <!ENTITY output SYSTEM "chap8.xml">
011  <!ENTITY language-specific SYSTEM "chap9.xml">
012  <!ENTITY special SYSTEM "chap10.xml">
013  <!ENTITY conclusion SYSTEM "chap11.xml">
014  <!ENTITY bibliography SYSTEM "chap12.xml">
015  ]>
016  
017  <!-- 문서의 메타 정보들 -->
018  <book version="5.0" encoding="UTF-8" xml:lang="ko">
019  <bookinfo xml:lang="ko">
020  <title>Secure Programming for Linux and Unix HOWTO</title>
021  <author>
022  <firstname>David</firstname>
023  <othername role="mi">A.</othername>
024  <surname>Wheeler</surname>
025  </author>
026  <affiliation><address><email>dwheeler@dwheeler.com</email></address></affiliation>
027  <pubdate>v2.92, 8 January 2002</pubdate>
028  <edition>v2.92</edition>
029  <!-- FYI: The LDP claims they don't use the "edition" tag.  -->
030  <copyright>
031   <year>1999</year>
032   <year>2000</year>
033   <year>2001</year>
034   <year>2002</year>
035   <holder>David A. Wheeler</holder>
036  </copyright>
037  
038  </bookinfo>
039  &introduction;
040  &background;
041  &features;
042  &input;
043  &buffer-overflow;
044  &internals;
045  &call-out;
046  &output;
047  &special;
048  &conclusion;
049  &bibliography;
050  </book>
051  

<chapter xml:id="introduction" xml:lang="ko"> <!-- xml:id가 키다 
<title>소개</title> 
<epigraph> 
<attribution>Proverbs 21:22 (NIV)</attribution> 
<para> 
A wise man attacks the city of the mighty and pulls down the stronghold in which they trust. 
</para> 
</epigraph> 
 
<para> 
이 책은 리눅스와 유닉스 시스템에서 보안적인 프로그램을 작성하기 위한 일련의 설계 및 구현 지침들을 기술한다.  
이 책의 목적을 위해 보안적인 (secure) 프로그램을 보안 경계에 존재하여 프로그램과 동일한 권한을 갖지 않는  
출처로부터 입력을 받아들이는 프로 
그램으로 정의할 수 있는데 이들로는 원격 뷰어로 사용되는 애플리케이션 프로그램, CGI 스크립트를 포함한 웹 애플리케이션,  
네트>워크 서버와 setuid/setgid 프로그램들이 있다. 이 책에서 논의되는 원리들중 다수가  
적용됨에도 불구하고 운영 체제의 커널 자체를 수정하는 것을 다루지는 않는다.  
이 지침들은 저자가 추가한 의견과 함께 보안적인 프로그램들을 만드는 방법에 대한 다양한 출처들로부터 배운 교훈들을  
조사함으로써 개발되었으며 일련의 더욱 커다란 원리들로 재구성되었다. 이 책은 C, C++, 자바, 펄, PHP,  
파이썬, TCL 과 Ada95 를 포함한 많은 언어들에 대한 구체적인 안내를 포함한다. 
</para> 
} 

5 기타 문서 요소

문서는 text뿐만 아니라 표, 그림, 각주등 다양한 요소를 가질 수 있다. 이들 요소를 적절히 사용하면 문서의 내용을 더 풍부하게 할 수 있다.

5.1 그림

<mediaobject> 
    <imageobject role="html"> 
        <imagedata fileref="imgs/AbstractViewofaProgram.png" format="PNG" scale="90"/> 
    </imageobject> 
    <caption> 
abstract view of a program 
    </caption> 
</mediaobject> 
 

5.2 표

<para> 
그 뒤 1년이 흐른 지금, 우리는 얼마나 자성하고 분발했는지 따져봐야 한다.  
소프트파워 중심으로 재편되는 모바일 시장은 아직 초>창기다. 그만큼 기회도 많다.  
이젠 모바일 HW 강국에서 모바일 SW 강국으로 대변신을 모색할 때가 됐다. 
<table> 
    <title>세계 IT 시장 현황 (단위 : 달러)</title> 
    <tgroup cols='2'> 
    <tbody> 
        <row> 
            <entry>정보 통신 서비스</entry> 
            <entry>1조 5700억</entry> 
        </row> 
        <row> 
            <entry>소프트웨어</entry> 
            <entry>1조 300억</entry> 
        </row> 
        <row> 
            <entry>하드웨어</entry> 
            <entry>7700억</entry> 
        </row> 
    </tbody> 
    </tgroup> 
</table> 
 
<table> 
    <title>모바일 앱 다운로드 건수(단위:백만건) /자료 퓨처소스 컨설팅</title> 
    <tgroup cols='3'> 
    <tbody> 
        <row> 
            <entry>2008</entry> 
            <entry>530</entry> 
        </row> 
        <row> 
            <entry>2009</entry> 
            <entry>3059</entry> 
        </row> 
        <row> 
            <entry>2010</entry> 
            <entry>6610</entry> 
        </row> 
        <row> 
            <entry>2011</entry> 
            <entry>9880</entry> 
        </row> 
        <row> 
            <entry>2012</entry> 
            <entry>13250</entry> 
        </row> 
        <row> 
            <entry>2013</entry> 
            <entry>16210</entry> 
        </row> 
    </tbody> 
    </tgroup> 
</table> 
</para> 
 

5.3 링크

외부 URL 링크

NSA 의 <ulink url="http://www.radium.ncsc.mil/tpep/library/fers/index.html">Final 
Evaluation Reports (FERs)</ulink> 에서 얻을 수 있다. 
 

문서 내에서 다른 문서를 참고

더욱 자세한 정보는 <xref linkend="avoid-vfork" />을 참조해라. 
 

이렇게 하면 id가 avoid-vfork인 문서영역으로 내부링크가 걸린다.

<sect1 id="avoid-vfork"> 
<title>vfork(2) 사용을 피해라 </title> 
 
<para> 
유닉스 계열 시스템에서 새로운 프로세스를 생성하는 이식성 있는 방법은 
fork(2) 호출을 사용하는 것이다. BSD 는 최적화 기법으로 vfork(2) 라는 
... 
</para> 
 

5.4 리스트

<itemizedlist> 
<listitem> 
<para> 
서로 다른 표기법으로 작성된 구성요소들은 필연적으로 결합도(coupling)가 낮아진다. (깔끔한 인터페이스는 없겠지만) 
</para> 
</listitem> 
<listitem> 
<para> 
각 요소들을 개별적으로 재작성함으로써 새로운 언어/플랫폼으로 발전시키기 쉽다. 
</para> 
</listitem> 
<listitem> 
<para> 
실제로는 어떤 모듈들이 최신의 것으로 갱신되었기 때문일 수도 있다. 
</para> 
</listitem> 
</itemizedlist> 
 

6 문서변환

xsltproc라는 툴을 이요하면 docbook문서를 다양한 형식의 문서로 변환할 수 있다.

6.1 Docbook에서 HTML로 변환

# xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl/html/docbook.xsl article.xml > article.html 
 

6.2 Docbook에서 epub로 변환

xsltproc로도 변환할 수 있지만 그 보다는 dbtoepub를 사용하는 걸 권장한다. epub는 전자책을 위한 표준 포맷이다.

# dbtoepub mybook.xml 
 

성공적으로 실행되면, 확장자가 .epub인 파일이 만들어진다.

7 독북 활용

객체지향 프로그래밍 언어를 사용하면, 자연 스럽게 객체지향적 사고 방식을 가지게 된다고 했다. 독북을 이용해서 문서를 작성하다보면 자연 스럽게 구조적인 문서를 쓸 수 있다. 글쓰기 연습이 된다고나 할까 ?

역시 문제는 웹과 함께 사용하기에는 그닥 좋은 시스템이 아니라는 점이다. (Docbook으로 변환해주는 wiki가 있긴 하지만) 그리고 프리젠테이션용 문서 시스템도 아니다. 메뉴얼과 레퍼런스 문서의 작성에 특화됐다. 하긴 docbook사이트도 docbook이 기술문서 개발을 위한 언어라고 소개하고 있으니...

공개 소프트웨어 진영의 경우 오래전부터 많은 문서가 docbook 으로 저작되는데, Linux Document Project의 문서들이 대표적이다. 이런 영향 때문인지, 심심 찮게 docbook로 작성되고 변환된 문서들을 볼 수 있다.

8 문서 예제

• Joinc Ebook 컨텐츠들
  

태그 : Docbook xml epub 문서

category_TOOL