あたらしいマニュアルを一つ追加する手順- GLOBALBASE PROJECT

GLOBALBASEマニュアル集 >> マニュアル環境とマニュアルの書き方 >> あたらしいマニュアルを一つ追加する手順
2007-11-04版

あたらしいマニュアルを一つ追加する手順

著者:　森　洋久 / joshua＠globalbase.org 　※　

* 概要
* この作業の前提となるシステム用件
* [ステップ1] マニュアルを書く
* [ステップ2] TeX用bibファイルの編集
* [ステップ3] HTMLマニュアルホームページへの追加
* [ステップ4] TOCディレクトリへのエントリの追加
* [ステップ5] makefileへのエントリの追加
* [ステップ6] コンパイル
* [ステップ7] tocファイルのCVSへの追加
* [ステップ8] HTMLおよびPDFの確認
* [ステップ9] HTMLの公開
* [ステップ10] CVSチェックイン


% cd gbs/doc/xml/src/xml
% cvs add ja-**.xml

ja-**.xmlは保存したファイル名です。

[注意] 新しいマニュアルを作ったら必ず最初のhistoryを追加しましょう。

なお、図表の編集は、「マニュアル文章に図や表を挿入する方法」参照してください。

▲ページトップへ戻る

[ステップ2] TeX用bibファイルの編集

次に、PDF文書を生成するために必要なBiBTeXのデータベースに追加したマニュアルのデータを追加します。このデータベースファイルは、gbs/deoc/xml/src/tex/ja-reference.bib です。その中に以下のような一エントリーを追加します。


@book{gb-manuals-writing-method,
  title =  "マニュアル環境とマニュアルの書き方",
  author = "森　洋久",
  publisher = "GLOBALBASE PROJECT",
  year = 2006,
}

最初の、gb-manuals-writing-methodは、マニュアルのXMLファイルの冒頭にある


<?xml version="1.0" encoding="Shift_JIS"?>
<manual 
	code="gb-manuals-writing-method" 
	title="マニュアル環境とマニュアルの書き方"
	
	tocloader="src/xml/ja-xltoc.xl">
....

code属性で指定されたコードを書きます。この書式についてはTeXのマニュアルを参照してください。

▲ページトップへ戻る

[ステップ3] HTMLマニュアルホームページへの追加

HTMLマニュアルを更新、公開した場合に、新しいマニュアルはHTMLマニュアルホームページのソースコードへ追加します。HTMLマニュアルのホームページのソースコードは、gbs/doc/xml/src/html/ja-index.html です。この中の適切な箇所に一行、新しいマニュアルへのリンクを追加します。リンクは、[ファイル名の幹名]/index.html となります。このマニュアルであれば、


ja-manuals/index.html

となります。従って、


<A HREF="ja-manuals/index.html">マニュアル環境とマニュアルの書き方</A>

というリンクを追加します。

▲ページトップへ戻る

[ステップ4] TOCディレクトリへのエントリの追加

gbs/doc/xml/src/xml/ja-xltoc.xl というファイルがあります。英語マニュアルの場合であれば、en-xltoc.xlというファイルです。ここに新しいマニュアル用の一行を追加します。このマニュアルであれば、work/xml/ja-manuals.xltocという行がそれにあたります。

[注意] このファイルは行単位で読み込まれ、改行のみの行があると mmake 時に不要なワーニングが発生します。特にコンパイル結果には影響はありませんが、改行のみの行は極力削除するようにしてください。

▲ページトップへ戻る

[ステップ5] makefileへのエントリの追加

新しいマニュアル用にmakefile ( gbs/doc/xml/makefile )にも@ make から始まる一つのエントリーを加えます。このマニュアル用のエントリは以下の通り。


@ make file man/pdf/ja-manuals.pdf from \
	file work/xml ja-manuals.tex
.set MAN	ja-manuals

.(neq,${PDF},on)	do touch man/pdf/${MAN}.pdf
.(eq,${PDF},off)	finish
	cd work/xml; \
	${TEX} ${MAN}.tex; \
	${BIB} ${MAN}; \
	${TEX} ${MAN}.tex; \
	${TEX} ${MAN}.tex; \
	dvipdfmx ${MAN}.dvi; \
	mv ${MAN}.pdf ../../man/pdf/${MAN}.pdf

上記ファイル名幹のある、最初の三行部分が変更対象です。ja-manualsの部分を新しいファイルの幹名にします。

▲ページトップへ戻る

[ステップ6] コンパイル

マニュアルのコンパイルを実行します。


% cd gbs/doc/xml
% mmake

もしTeXの環境がインストールされていない場合は、


% cd gbs/doc/xml
% mmake PDF=off

とすることによってTeXの環境を使わないようにすることができます。そのかわりPDFは空のファイルが生成されます。エラーが発生した場合は、エラーに対処してください。発生エラーのリファレンスは、「mmake時エラーリファレンス」です。

以下に実行の一例を挙げます。（長いです。）


[PowerBook19:gbs/doc/xml] joshua% mmake
mmake
uname : Darwin
source:src
work:work
tree
warning work/xml/ja-bugs-report.xml.ap
No such file or directory
warning work/xml/ja-cosmos.xml.ap
No such file or directory
warning work/xml/ja-gbview.xml.ap
No such file or directory
warning work/xml/ja-guide.xml.ap
No such file or directory
warning work/xml/ja-httpgateway.xml.ap
No such file or directory
warning work/xml/ja-landscape.xml.ap
No such file or directory
warning work/xml/ja-localbase-ui.xml.ap
No such file or directory
warning work/xml/ja-localbase.xml.ap
No such file or directory
warning work/xml/ja-manuals.xml.ap
No such file or directory
        exl utils/xl/manual.xl - - / src/xml/ja-manuals.xml work/xml/ja-manuals.tex
<Result> 1 ()</Result>
Preparing the System....
Loading the Source Code src/xml/ja-manuals.xml....
Merging Input File....
Checking the reference relations Phase-1....
Checking the reference relations Phase-2....
Consistent Checking and Generate Regular Format.....
<Result> 3 ()</Result>
Output the HTML directory man/html/ja-manuals....
<Result> 4 ()</Result>
Output the Latex file work/xml/ja-manuals.tex....
<Result> 5 ()</Result>
Save TOC.....
<Result> 12 ()</Result>
<Result> 14 ()</Result>
<Result> 38 ()</Result>
# stop
ACTIVE
warning work/xml/ja-xl.xml.ap
No such file or directory
warning work/xml/ja-xlsv.xml.ap
No such file or directory
DO line=43
        cd work/xml; platex ja-manuals.tex; jbibtex ja-manuals; platex ja-manuals.tex; platex ja-manuals.tex; dvipdfmx ja-manuals.dvi; mv ja-manuals.pdf ../../man/pdf/ja-manuals.pdf
This is pTeX, Version 3.141592-p3.1.8 (sjis) (Web2C 7.5.4)
(./ja-manuals.tex
pLaTeX2e <2005/01/04>+0 (based on LaTeX2e <2003/12/01> patch level 0)
(/usr/local/share/texmf/ptex/platex/base/jreport.cls
Document Class: jreport 2002/04/09 v1.4 Standard pLaTeX class
(/usr/local/share/texmf/tex/latex/base/fleqn.clo)
(/usr/local/share/texmf/ptex/platex/base/jsize10.clo))
(/usr/local/share/texmf/tex/latex/graphics/graphicx.sty
(/usr/local/share/texmf/tex/latex/graphics/keyval.sty)
(/usr/local/share/texmf/tex/latex/graphics/graphics.sty
(/usr/local/share/texmf/tex/latex/graphics/trig.sty)
(/usr/local/share/texmf/tex/latex/graphics/graphics.cfg)
(/usr/local/share/texmf/tex/latex/graphics/dvips.def)))
(../../utils/tex/input.in) (./ja-manuals.aux

LaTeX Warning: Label `fig-manual-function-xl-web2' multiply defined.


LaTeX Warning: Label `____c62' multiply defined.


LaTeX Warning: Label `____c63' multiply defined.

) [1] (./ja-manuals.toc [1] [2] [3]) [4]
?? 1 ??
<../../src/images//manual/environment.eps>

LaTeX Warning: `h' float specifier changed to `ht'.


LaTeX Warning: `h' float specifier changed to `ht'.

[5] [6] [7] (/usr/local/share/texmf/tex/latex/base/omscmr.fd) [8]

LaTeX Font Warning: Font shape `JT1/mc/m/it' undefined
(Font)              using `JT1/mc/m/n' instead on input line 210.


LaTeX Font Warning: Font shape `JY1/mc/m/it' undefined
(Font)              using `JY1/mc/m/n' instead on input line 210.

[9]
?? 2 ??

LaTeX Warning: Citation `gb-manuals-writing-method' on page 10 undefined on inp
ut line 232.

[10] [11]

LaTeX Warning: `h' float specifier changed to `ht'.

[12]
Overfull \hbox (51.28922pt too wide) in paragraph at lines 419--420
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html

Underfull \hbox (badness 6559) in paragraph at lines 437--438
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[13] [14]
?? 3 ??

LaTeX Warning: Citation `gb-manuals-writing-method' on page 15 undefined on inp
ut line 504.


Overfull \hbox (51.28922pt too wide) in paragraph at lines 526--527
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html
[15]
Underfull \hbox (badness 6559) in paragraph at lines 544--545
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[16]
?? 4 ??
[17] [18]
Overfull \hbox (51.28922pt too wide) in paragraph at lines 704--705
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html

Underfull \hbox (badness 6559) in paragraph at lines 722--723
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[19] [20]
?? 5 ??

Overfull \hbox (1.31525pt too wide) in paragraph at lines 783--784
[]\JY1/mc/m/n/10 ?o?O???| ?[?g?R ?[?h????W????A?C?e???t ?@ ?C????????
?B ??{?I?? ?A \OT1/cmr/m/n/10 gbs/doc/xml/src/xml/bugs-
[21]
Overfull \hbox (51.28922pt too wide) in paragraph at lines 850--851
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html
[22]
Underfull \hbox (badness 6559) in paragraph at lines 868--869
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[23]
?? 6 ??
[24]
Overfull \hbox (13.77843pt too wide) in paragraph at lines 1001--1002
\OT1/cmr/m/n/10 gbs/doc/xml/src/images \JY1/mc/m/n/10 ????Q????B ??
????????\OT1/cmr/m/n/10 "/"\JY1/mc/m/n/10 ???K?v???B ??? ?A \OT1/cmr/m/n/1
0 PDF \JY1/mc/m/n/10 ?? ?A \OT1/cmr/m/n/10 gbs/doc/xml/src
[25] [26]
?? 7 ??
[27] [28] [29] [30] [31] [32] [33]
?? 8 ??
[34] [35] [36]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 37 undefined on input line 1513.


Overfull \hbox (1.72684pt too wide) in paragraph at lines 1531--1533
[]\OT1/cmr/m/n/10 /manual/reference-man/function-script/ re-turn [UN-DEF REF (g
b-manuals-manual--reference-man--
[37] [38]
Overfull \hbox (0.40884pt too wide) in paragraph at lines 1615--1616
[]\OT1/cmr/m/n/10 pdf-section-divide  [\JY1/mc/m/n/10 ?C??\OT1/cmr/m/n/10 ]  \J
Y1/mc/m/n/10 ?u\OT1/cmr/m/n/10 xl(standard) \JY1/mc/m/n/10 ?G ?[?W ?F ???g ?E 
???t ?@ ?????X ?E ?}?j ?? ?A?? ?v  \OT1/cmr/m/n/10 [[]] \JY1/mc/m/n/10 ?? ?u\OT
1/cmr/m/n/10 XLT[]STRING(\JY1/mc/m/n/10 ??
[39] [40] [41] [42] [43] [44] [45] [46] [47] [48] [49]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 50 undefined on input line 2136.

[50] <../../src/images//manual/example-function-xml.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xml-web.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

[51] <../../src/images//manual/example-function-xml-err.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xml-err-web.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

[52] <../../src/images//manual/example-function-xl.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xl-web1.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xl-web2.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

[53] [54]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 55 undefined on input line 2543.

[55] [56] [57]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 58 undefined on input line 2681.

[58] [59]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 60 undefined on input line 2775.

[60]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 61 undefined on input line 2823.

[61]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 62 undefined on input line 2871.

[62] [63]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 64 undefined on input line 2957.

[64] [65]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 66 undefined on input line 3045.

[66]

LaTeX Warning: Reference `gb-manuals-manual--reference-man--function-script' on
 page 67 undefined on input line 3089.

[67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81]
?? 9 ??
[82] [83] [84] [85] [86] [87] [88] [89] [90] [91] [92] [93] [94] [95]
?? 10 ??
[96] [97] [98] (./ja-manuals.bbl) [99] [100] (./ja-manuals.aux)

LaTeX Font Warning: Some font shapes were not available, defaults substituted.


LaTeX Warning: There were undefined references.


LaTeX Warning: There were multiply-defined labels.

 )
(see the transcript file for additional information)
Output written on ja-manuals.dvi (101 pages, 206056 bytes).
Transcript written on ja-manuals.log.
This is JBibTeX, Version 0.99c-j0.33 (Web2C 7.5.4)
The top-level auxiliary file: ja-manuals.aux
The style file: junsrt.bst
Database file #1: ../../src/tex/reference.bib
Warning--I didn't find a database entry for "gb-manuals-writing-method"
(There was 1 warning)
This is pTeX, Version 3.141592-p3.1.8 (sjis) (Web2C 7.5.4)
(./ja-manuals.tex
pLaTeX2e <2005/01/04>+0 (based on LaTeX2e <2003/12/01> patch level 0)
(/usr/local/share/texmf/ptex/platex/base/jreport.cls
Document Class: jreport 2002/04/09 v1.4 Standard pLaTeX class
(/usr/local/share/texmf/tex/latex/base/fleqn.clo)
(/usr/local/share/texmf/ptex/platex/base/jsize10.clo))
(/usr/local/share/texmf/tex/latex/graphics/graphicx.sty
(/usr/local/share/texmf/tex/latex/graphics/keyval.sty)
(/usr/local/share/texmf/tex/latex/graphics/graphics.sty
(/usr/local/share/texmf/tex/latex/graphics/trig.sty)
(/usr/local/share/texmf/tex/latex/graphics/graphics.cfg)
(/usr/local/share/texmf/tex/latex/graphics/dvips.def)))
(../../utils/tex/input.in) (./ja-manuals.aux

LaTeX Warning: Label `fig-manual-function-xl-web2' multiply defined.


LaTeX Warning: Label `____c62' multiply defined.


LaTeX Warning: Label `____c63' multiply defined.

) [1] (./ja-manuals.toc [1] [2] [3]) [4]
?? 1 ??
<../../src/images//manual/environment.eps>

LaTeX Warning: `h' float specifier changed to `ht'.


LaTeX Warning: `h' float specifier changed to `ht'.

[5] [6] [7] (/usr/local/share/texmf/tex/latex/base/omscmr.fd) [8]

LaTeX Font Warning: Font shape `JT1/mc/m/it' undefined
(Font)              using `JT1/mc/m/n' instead on input line 210.


LaTeX Font Warning: Font shape `JY1/mc/m/it' undefined
(Font)              using `JY1/mc/m/n' instead on input line 210.

[9]
?? 2 ??

LaTeX Warning: Citation `gb-manuals-writing-method' on page 10 undefined on inp
ut line 232.

[10] [11]

LaTeX Warning: `h' float specifier changed to `ht'.

[12]
Overfull \hbox (51.28922pt too wide) in paragraph at lines 419--420
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html

Underfull \hbox (badness 6559) in paragraph at lines 437--438
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[13] [14]
?? 3 ??

LaTeX Warning: Citation `gb-manuals-writing-method' on page 15 undefined on inp
ut line 504.


Overfull \hbox (51.28922pt too wide) in paragraph at lines 526--527
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html
[15]
Underfull \hbox (badness 6559) in paragraph at lines 544--545
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[16]
?? 4 ??
[17] [18]
Overfull \hbox (51.28922pt too wide) in paragraph at lines 704--705
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html

Underfull \hbox (badness 6559) in paragraph at lines 722--723
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[19] [20]
?? 5 ??

Overfull \hbox (1.31525pt too wide) in paragraph at lines 783--784
[]\JY1/mc/m/n/10 ?o?O???| ?[?g?R ?[?h????W????A?C?e???t ?@ ?C????????
?B ??{?I?? ?A \OT1/cmr/m/n/10 gbs/doc/xml/src/xml/bugs-
[21]
Overfull \hbox (51.28922pt too wide) in paragraph at lines 850--851
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html
[22]
Underfull \hbox (badness 6559) in paragraph at lines 868--869
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[23]
?? 6 ??
[24]
Overfull \hbox (13.77843pt too wide) in paragraph at lines 1001--1002
\OT1/cmr/m/n/10 gbs/doc/xml/src/images \JY1/mc/m/n/10 ????Q????B ??
????????\OT1/cmr/m/n/10 "/"\JY1/mc/m/n/10 ???K?v???B ??? ?A \OT1/cmr/m/n/1
0 PDF \JY1/mc/m/n/10 ?? ?A \OT1/cmr/m/n/10 gbs/doc/xml/src
[25] [26]
?? 7 ??
[27] [28] [29] [30] [31] [32] [33]
?? 8 ??
[34] [35] [36]
Overfull \hbox (1.72684pt too wide) in paragraph at lines 1531--1533
[]\OT1/cmr/m/n/10 /manual/reference-man/function-script/ re-turn [UN-DEF REF (g
b-manuals-manual--reference-man--
[37] [38]
Overfull \hbox (0.40884pt too wide) in paragraph at lines 1615--1616
[]\OT1/cmr/m/n/10 pdf-section-divide  [\JY1/mc/m/n/10 ?C??\OT1/cmr/m/n/10 ]  \J
Y1/mc/m/n/10 ?u\OT1/cmr/m/n/10 xl(standard) \JY1/mc/m/n/10 ?G ?[?W ?F ???g ?E 
???t ?@ ?????X ?E ?}?j ?? ?A?? ?v  \OT1/cmr/m/n/10 [[]] \JY1/mc/m/n/10 ?? ?u\OT
1/cmr/m/n/10 XLT[]STRING(\JY1/mc/m/n/10 ??
[39] [40] [41] [42] [43] [44] [45] [46] [47] [48] [49] [50]
<../../src/images//manual/example-function-xml.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xml-web.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

[51] <../../src/images//manual/example-function-xml-err.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xml-err-web.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

[52] <../../src/images//manual/example-function-xl.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xl-web1.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xl-web2.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

[53] [54] [55] [56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67]
[68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81]
?? 9 ??
[82] [83] [84] [85] [86] [87] [88] [89] [90] [91] [92] [93] [94] [95]
?? 10 ??
[96] [97] [98] (./ja-manuals.bbl) [99] [100] (./ja-manuals.aux)

LaTeX Font Warning: Some font shapes were not available, defaults substituted.


LaTeX Warning: There were undefined references.


LaTeX Warning: There were multiply-defined labels.

 )
(see the transcript file for additional information)
Output written on ja-manuals.dvi (101 pages, 206420 bytes).
Transcript written on ja-manuals.log.
This is pTeX, Version 3.141592-p3.1.8 (sjis) (Web2C 7.5.4)
(./ja-manuals.tex
pLaTeX2e <2005/01/04>+0 (based on LaTeX2e <2003/12/01> patch level 0)
(/usr/local/share/texmf/ptex/platex/base/jreport.cls
Document Class: jreport 2002/04/09 v1.4 Standard pLaTeX class
(/usr/local/share/texmf/tex/latex/base/fleqn.clo)
(/usr/local/share/texmf/ptex/platex/base/jsize10.clo))
(/usr/local/share/texmf/tex/latex/graphics/graphicx.sty
(/usr/local/share/texmf/tex/latex/graphics/keyval.sty)
(/usr/local/share/texmf/tex/latex/graphics/graphics.sty
(/usr/local/share/texmf/tex/latex/graphics/trig.sty)
(/usr/local/share/texmf/tex/latex/graphics/graphics.cfg)
(/usr/local/share/texmf/tex/latex/graphics/dvips.def)))
(../../utils/tex/input.in) (./ja-manuals.aux

LaTeX Warning: Label `fig-manual-function-xl-web2' multiply defined.


LaTeX Warning: Label `____c62' multiply defined.


LaTeX Warning: Label `____c63' multiply defined.

) [1] (./ja-manuals.toc [1] [2] [3]) [4]
?? 1 ??
<../../src/images//manual/environment.eps>

LaTeX Warning: `h' float specifier changed to `ht'.


LaTeX Warning: `h' float specifier changed to `ht'.

[5] [6] [7] (/usr/local/share/texmf/tex/latex/base/omscmr.fd) [8]

LaTeX Font Warning: Font shape `JT1/mc/m/it' undefined
(Font)              using `JT1/mc/m/n' instead on input line 210.


LaTeX Font Warning: Font shape `JY1/mc/m/it' undefined
(Font)              using `JY1/mc/m/n' instead on input line 210.

[9]
?? 2 ??

LaTeX Warning: Citation `gb-manuals-writing-method' on page 10 undefined on inp
ut line 232.

[10] [11]

LaTeX Warning: `h' float specifier changed to `ht'.

[12]
Overfull \hbox (51.28922pt too wide) in paragraph at lines 419--420
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html

Underfull \hbox (badness 6559) in paragraph at lines 437--438
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[13] [14]
?? 3 ??

LaTeX Warning: Citation `gb-manuals-writing-method' on page 15 undefined on inp
ut line 504.


Overfull \hbox (51.28922pt too wide) in paragraph at lines 526--527
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html
[15]
Underfull \hbox (badness 6559) in paragraph at lines 544--545
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[16]
?? 4 ??
[17] [18]
Overfull \hbox (51.28922pt too wide) in paragraph at lines 704--705
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html

Underfull \hbox (badness 6559) in paragraph at lines 722--723
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[19] [20]
?? 5 ??

Overfull \hbox (1.31525pt too wide) in paragraph at lines 783--784
[]\JY1/mc/m/n/10 ?o?O???| ?[?g?R ?[?h????W????A?C?e???t ?@ ?C????????
?B ??{?I?? ?A \OT1/cmr/m/n/10 gbs/doc/xml/src/xml/bugs-
[21]
Overfull \hbox (51.28922pt too wide) in paragraph at lines 850--851
[]\JY1/mc/m/n/10 ?????????m?F?????B ?f ?B ???N?g???A \OT1/cmr/m/n/10 gbs/do
c/xml/man/pdf \JY1/mc/m/n/10 ???? \OT1/cmr/m/n/10 PDF \JY1/mc/m/n/10 ?t ?@ ?C??
????????B \OT1/cmr/m/n/10 gbs/doc/xml/man/html
[22]
Underfull \hbox (badness 6559) in paragraph at lines 868--869
[]\OT1/cmr/m/n/10 GLOBALBASE \JY1/mc/m/n/10 ?????}?j ?? ?A???y ?[?W?? ?A \OT1
/cmr/m/n/10 http://www.globalbase.org/globalbase/man/ja-
[23]
?? 6 ??
[24]
Overfull \hbox (13.77843pt too wide) in paragraph at lines 1001--1002
\OT1/cmr/m/n/10 gbs/doc/xml/src/images \JY1/mc/m/n/10 ????Q????B ??
????????\OT1/cmr/m/n/10 "/"\JY1/mc/m/n/10 ???K?v???B ??? ?A \OT1/cmr/m/n/1
0 PDF \JY1/mc/m/n/10 ?? ?A \OT1/cmr/m/n/10 gbs/doc/xml/src
[25] [26]
?? 7 ??
[27] [28] [29] [30] [31] [32] [33]
?? 8 ??
[34] [35] [36]
Overfull \hbox (1.72684pt too wide) in paragraph at lines 1531--1533
[]\OT1/cmr/m/n/10 /manual/reference-man/function-script/ re-turn [UN-DEF REF (g
b-manuals-manual--reference-man--
[37] [38]
Overfull \hbox (0.40884pt too wide) in paragraph at lines 1615--1616
[]\OT1/cmr/m/n/10 pdf-section-divide  [\JY1/mc/m/n/10 ?C??\OT1/cmr/m/n/10 ]  \J
Y1/mc/m/n/10 ?u\OT1/cmr/m/n/10 xl(standard) \JY1/mc/m/n/10 ?G ?[?W ?F ???g ?E 
???t ?@ ?????X ?E ?}?j ?? ?A?? ?v  \OT1/cmr/m/n/10 [[]] \JY1/mc/m/n/10 ?? ?u\OT
1/cmr/m/n/10 XLT[]STRING(\JY1/mc/m/n/10 ??
[39] [40] [41] [42] [43] [44] [45] [46] [47] [48] [49] [50]
<../../src/images//manual/example-function-xml.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xml-web.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

[51] <../../src/images//manual/example-function-xml-err.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xml-err-web.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

[52] <../../src/images//manual/example-function-xl.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xl-web1.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

<../../src/images//manual/example-function-xl-web2.eps>

LaTeX Warning: `h' float specifier changed to `ht'.

[53] [54] [55] [56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67]
[68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81]
?? 9 ??
[82] [83] [84] [85] [86] [87] [88] [89] [90] [91] [92] [93] [94] [95]
?? 10 ??
[96] [97] [98] (./ja-manuals.bbl) [99] [100] (./ja-manuals.aux)

LaTeX Font Warning: Some font shapes were not available, defaults substituted.


LaTeX Warning: There were undefined references.


LaTeX Warning: There were multiply-defined labels.

 )
(see the transcript file for additional information)
Output written on ja-manuals.dvi (101 pages, 206420 bytes).
Transcript written on ja-manuals.log.
ja-manuals.dvi -> ja-manuals.pdf
[1][2][3][4][5][6][7][8][9][10][11][12][13][14][15][16][17][18][19][20][21]
[22][23][24][25][26][27][28][29][30][31][32][33][34][35][36][37][38][39][40]
[41][42][43][44][45][46][47][48][49][50][51][52][53][54][55][56][57][58][59]
[60][61][62][63][64][65][66][67][68][69][70][71][72][73][74][75][76][77][78]
[79][80][81][82][83][84][85][86][87][88][89][90][91][92][93][94][95][96][97]
[98][99][100][101]
941914 bytes written
DO line=169
        cp -r src/html/* man/html
        cp -r src/images man/html
        find man/html/images -name '*.ai' -exec rm {} \;
        find man/html/images -name '*.psd' -exec rm {} \;
        find man/html/images -name '*.txt' -exec rm {} \;
        find man/html/images -name '*.html' -exec rm {} \;
        find man/html/images -name '*.eps' -exec rm {} \;
        find man/html -name '*.xl' -exec rm {} \;
        touch man/html/index.html
warning work/xml/ja-bugs-report.xml.ap
No such file or directory
warning work/xml/ja-cosmos.xml.ap
No such file or directory
warning work/xml/ja-gbview.xml.ap
No such file or directory
warning work/xml/ja-guide.xml.ap
No such file or directory
warning work/xml/ja-httpgateway.xml.ap
No such file or directory
warning work/xml/ja-landscape.xml.ap
No such file or directory
warning work/xml/ja-localbase-ui.xml.ap
No such file or directory
warning work/xml/ja-localbase.xml.ap
No such file or directory
warning work/xml/ja-manuals.xml.ap
No such file or directory
warning work/xml/ja-xl.xml.ap
No such file or directory
warning work/xml/ja-xlsv.xml.ap
No such file or directory
[PowerBook19:gbs/doc/xml] joshua%

▲ページトップへ戻る

[ステップ7] tocファイルのCVSへの追加

コンパイル後必要な制御ファイルが生成されていることを確認してください。たとえば、このマニュアルであれば以下のような制御ファイルが生成されています。


% cd gbs/doc/xml/work/xml
% ls ja-manuals*
ja-manuals.aux          ja-manuals.dvi          ja-manuals.toc
ja-manuals.bbl          ja-manuals.log          ja-manuals.xltoc
ja-manuals.blg          ja-manuals.tex

ここで、それぞれのファイルの意味は表(制御ファイルの意味)の通りです。

表　制御ファイルの意味

*.aux	TeXのlog
*.bbl	BiBTeXの制御ファイル
*.blg	BiBTeXの制御ファイル
*.dvi	TeXの出力するDVIファイル
*.log	TeXのログファイル
*.tex	exl manual.xlが出力したTeXのソースファイル
*.toc	TeXの出力するTOC情報
*.xltoc	exl manual.xlの出力したTOC情報
man/pdf/*.pdf	最終的にdvipdfmxが生成したPDFファイル
man/html/*	最終的にexl manual.xlが生成したHTMLディレクトリおよびファイル群

[メモ] TOCとは、Table Of Contents の略であり、目次情報のことです。

上記ファイルはいずれも、制御ファイルなので、コンパイル時に生成されるものではありますが、このうち、*.xltocのみはCVSに追加します。これは、toc情報の読み込みを迅速にするためです。


% cd gbs/doc/xml/work/xml
% cvs add *.xltoc

*.xltocは新しく追加したマニュアルのTOCファイルです。

▲ページトップへ戻る

[ステップ8] HTMLおよびPDFの確認

生成結果を確認します。ディレクトリ、gbs/doc/xml/man/pdf 内にPDFファイルがあります。gbs/doc/xml/man/html内にHTMLファイルがあります。これらが正しく生成されているかどうか確認します。

▲ページトップへ戻る

[ステップ9] HTMLの公開

現時点では、HTMLの公開は基本的に森洋久が行います。しかし、ここで公開方法について述べます。gbs/doc/xml/man/htmlのディレクトリはCVSにコミットされているディレクトリでもあります。従って、これをそのまま公開すると、CVSという名前の制御ディレクトリまで公開されてしまいます。これを取り除く必要があります。取り除く方法は、


% cd gbs/doc/xml
% ./make.html.sh

という、取り除き用のスクリプト make.html.sh を実行します。これを実行すると、CVSといったディレクトリが取り除かれた公開用ディレクトリ、gbs/doc/xml/man/manが出来ます。このディレクトリを所定のWWWサーバへアップしてください。

[メモ] GLOBALBASEの公式マニュアルページは、http://www.globalbase.org/globalbase/man/ja-index.html ですが、基本的に、このディレクトリを他の場所へアップロードすると他の場所でも公開可能です。しかしその場合検索エンジンの窓は変更しておかないと、検索結果は、かならず公式ホームページへ飛ぶことになります。

▲ページトップへ戻る

[ステップ10] CVSチェックイン

最後に編集したファイルをCVSへチェックインします。開発したソースコードなどがある場合は、一緒にチェックイン出来ます。


% cvs commit -m "manual" gbs

[注意] チェックイン／チェックアウトはワークエリアのルートで行う必要があります。

▲ページトップへ戻る

$GLOBALBASE��AI[v\[XE\tgEFAxvOSOURCEFORGE.JP��QBĂ܂B$