Workbookユーザガイド

セットアップ

まず必要なソフトウェアをインストールして、そのうえでWorkbookをインストールしてください。

特別なハードウェアは必要ありません。普通のPCで十分です。

Workbookを実行するには次のソフトウェアが必要です（括弧内はテストに使ったDebianパッケージ名）：

Unix-like operating environment (Debian GNU/Linux 4.0 (etch))
xsltproc (xsltproc 1.1.19)
XHTML plus Math 1.1 DTD (w3c-dtd-xhtml 1.1, w3-dtd-mathml 2.0.0.0)
Ruby (ruby1.8 1.8.5)
Rake (rake 0.7.1)
pLaTeX (ptex-bin 3.1.10~beta3+0.04b, ptex-jisfonts 2-19)
Adobe CMaps (cmap-adobe-japan1 0+20040605, cmap-adobe-japan2 0+20020208)
mendex (mendexk 2.6d)
dvipdfmx (dvipdfmx 20050831)
jsbook/jsclasses LaTeX class (okumura-clsfiles 2006.11.06)
Computer Modern font (cm-super 0.3.3)
Ghostscript (gs-esp 8.15.3, gs-cjk-resource 1.20021122)
ImageMagick (imagemagick 6.2.4.5)
pdfinfo (xpdf-utils 3.01)
epstool (epstool 3.08)
nkf (nkf 2.07)
GNU wget (wget 1.10.2)
HTML Tidy (tidy 20051018)
unzip (unzip 5.52)

詳しくは配布tarball中のdebian/controlにあるDepends:フィールドを見てください。

このソフトウェアの開発には次のものを使っています：

依存関係の面倒を避けるために、パッケージ管理システムを備えたOSを使うことをおすすめします。お手数をおかけして申し訳ありません。

Windowsユーザの方へ： WorkbookはまだWindowsを直接サポートしませんが、VMwareやcoLinuxのような仮想環境にインストールしたUnix系OS上で動かすことは可能です。

これらは必須ではありませんが、選択の余地があるならおすすめします。

なくても動作しますが、一緒に使うと便利なソフトウェアです。

psgml-mode / Emacs (for editing XHTML/XML)
Web Developer extension for Firefox (for validating XHTML with w3 validator service)
OpenOffice.org Draw (for drawing diagrams)
Adobe Acrobat (Professional)
Decent font

バイナリパッケージやソースコードも含めて、すべて次のサイトで手に入ります：

http://sourceforge.net/projects/workbook

Debianパッケージは簡単にインストールでき、アンインストールも簡単です。.debパッケージをダウンロードして、dpkgでインストールします。

$ sudo dpkg --install workbook-x.y.z-*.deb
$ sudo apt-get install -f
$ sudo dpkg --install workbook-x.y.z-*.deb

apt lineにcontribとnon-freeを含めておくのを忘れないでください。

あえてtar ballからインストールしたい場合は、makeを使ってください。インストール先を変えるにはDESTDIRを指定してください。

$ tar zxvf workbook-x.y.z.tar.gz
$ cd workbook-x.y.z
$ make
$ make install DESTDIR=/home/jdoe