Info file: eblook.info,    -*-Text-*-
produced by `texinfo-format-buffer'
from file `eblook.texi'
using `texinfmt.el' version 2.38 of 3 July 1998.



INFO-DIR-SECTION CD-ROM Book Utilities
START-INFO-DIR-ENTRY
* eblook: (eblook).             Interactive EB interface command.
END-INFO-DIR-ENTRY


This file documents eblook, an interactive EB interface command.

Copyright (C) 1997,1998,1999 Keisuke Nishida

Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation
approved by the Free Software Foundation.





File: eblook.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir)

eblook
******

eblook は、EB ライブラリを用いた対話型の電子辞書検索コマンドです。簡単な
設定とコマンドにより CD-ROM 書籍が利用出来ます。

本書は eblook 1.3 について説明しています。

* Menu:

* Introduction::                はじめに
* Overview::                    大まかな使い方
* Starting::                    eblook の起動
* Setting::                     辞書の選択と設定
* Search::                      検索法
* Information::                 各種情報
* Commands::                    コマンド一覧
* Variables::                   変数一覧
* How To Get::                  最新情報の入手



File: eblook.info, Node: Introduction, Next: Overview, Prev: Top, Up: Top

はじめに
********

eblook は、EB ライブラリ(*Note EB: (eb)Top)を用いた対話型の電子辞書検索
コマンドです。簡単な設定とコマンドにより CD-ROM 書籍が利用出来ます。

eblook は手軽さを重視したツールであり、ユーザ・アクセスの管理など、ネッ
トワーク利用を想定した複雑な機能は提供していません。そのような目的には
NDTPD というソフトウェアが公開されていますので、そちらが利用になれます。
(`http://www.sra.co.jp/people/m-kasahr/ndtpd/' を参照)

eblook はフリー・ソフトウェアです。あなたは、Free Software Foundation が
公表した GNU General Public License (GNU 一般公有使用許諾)のバージョン 2 
あるいはそれ以降の各バージョンの中からいずれかを選択し、そのバージョンが
定める条項に従って eblook を再配布または変更することができます。

eblook は有用とは思いますが、頒布にあたっては、市場性及び特定目的適合性
についての暗黙の保証を含めて、いかなる保証も行ないません。詳細については 
GNU General Public License をお読みください。

加えてあなたは、eblook と共に利用する CD-ROM 書籍の使用許諾も守らなけれ
ばなりません。書籍の利用が許されない場合にも eblook を用いることは可能か
もしれませんが、そのような場合に eblook を用いてはなりません。



File: eblook.info, Node: Overview, Next: Starting, Prev: Introduction, Up: Top

大まかな使い方
**************

辞書のあるディレクトリを引数に、eblook をシェルから起動する。

     % eblook /cdrom
     eblook> -!-

`help' でコマンド一覧。

     eblook> help
      book [directory [appendix]] - Set a book directory
      info                   - Show information of the selected book
      list                   - List all dictionaries in the selected book
      select subbook         - Select a subbook
      subinfo                - Show information of the selected subbook
      copyright              - Show copyright of the selected subbook
      menu                   - Show the menu of the selected subbook
      search pattern [offset] - Search for a word
      content entry [offset] - Display contents of entry
      font [id]              - Display the bitmap of gaiji
      show [variable]        - Show the value of variables
      set variable value     - Set a variable to the value
      unset varialbe...      - Unset variables
      help                   - Show this message
      quit                   - Quit program

`list' で辞書一覧。

     eblook> list
      1. KOKUGO      国語辞典
      2. EIWA        英和辞典

`select' で辞書選択。`search' で検索。

     eblook> select 2
     eblook> search test
      1. 1234:567    test

`content' で内容表示。

     eblook> content 1
     test /t'est/
     [名] 1. 試験...

`quit' で終了。

     eblook> quit
     % -!-



File: eblook.info, Node: Starting, Next: Setting, Prev: Overview, Up: Top

eblook の起動
*************

eblook の起動方法は次の通りです。

     eblook [option...] [BOOK-DIRECTORY [APPENDIX-DIRECTORY]]

BOOK-DIRECTORY は書籍のあるディレクトリを指定します。省略された場合は、
カレントディレクトリが書籍ディレクトリとみなされます。

APPENDIX-DIRECTORY には Appendix のあるディレクトリを指定します。省略さ
れた場合は、Appendix は利用されません。(*Note Appendix::)

これら引数の値は、どちらも起動後に変更することも出来ます。*Note
Setting:: を参照して下さい。

オプションには次のものが有効です。

`-q'
`--no-init-file'
     初期化ファイル(`~/.eblookrc')を読み込まない。

`-v'
`--version'
     コマンドのバージョン番号を表示して終了する。

`-h'
`--help'
     コマンドのヘルプを表示して終了する。



File: eblook.info, Node: Setting, Next: Search, Prev: Starting, Up: Top

辞書の選択と設定
****************

コマンド `book' により書籍のあるディレクトリを指定します。

     eblook> book `/cdrom' `/usr/local/share/eb/appendix'

書籍ディレクトリに含まれる辞書の一覧は、コマンド `list' により見ることが
出来ます。

     eblook> list
      1. KOKUGO	国語辞典
      2. EIWA	英和辞典

辞書はコマンド `select' によりセットすることで、利用可能となります。

     eblook> select 1

あるいは

     eblook> select KOKUGO

コマンド `set' により、オプションの設定が可能です。例えばプロンプトを変
更するには、次のようにします。

     eblook> set prompt "eblook$ "
     eblook$ -!-

上のように、引数に空白を含める必要がある場合には、値をダブルクオートで引
用出来ます。

変数の値はコマンド `show' で見ることが出来ます。値を無効にするにはコマン
ド `unset' があります。

     eblook$ show prompt
     eblook$ 
     eblook$ unset prompt
     eblook> show
     version eblook 1.0
     max-text        8192
     max-hits        256
     eblook> -!-

設定・参照できる変数の一覧は *Note Variables:: を参照して下さい。



File: eblook.info, Node: Search, Next: Information, Prev: Setting, Up: Top

検索方法
********

このバージョンの eblook では、検索方式として単語検索(前方一致検索、後方
一致検索、完全一致検索)と、メニューの参照を行なうことが出来ます。また、
外字を扱うことも出来ます。

* Menu:

* Word Search::                 単語検索
* Menu::                        メニュー
* Content::                     内容表示
* Appendix::                    外字の置換



File: eblook.info, Node: Word Search, Next: Menu, Prev: Search, Up: Search

単語検索
========

コマンド `search' で検索を行ないます。あらかじめ辞書を選択しておく必要が
あります。

     eblook> select EIWA
     eblook> search test
      1. 1234:567    test

変数 `search-method' により検索方式を変更出来ます。現在、次のものを指定
可能です。(デフォルトは `glob')

`word'
     前方一致検索を行なう。
`endword'
     後方一致検索を行なう。
`exact'
     完全一致検索を行なう。
`glob'
     文字列を見て、検索法を決定する。検索語が `foo*' ならば `foo' をキー
     に前方一致検索を行ない、同様に `*foo' ならば後方一致検索、`foo' な
     らば完全一致検索を行なう。

     eblook> show search-method
     glob
     eblook> search test*
      1. 1234:567    test
      2. 2345:678    testament
     eblook> search *test
      1. 1234:567    test
      2. 3456:789    latest
     eblook> set search-method word
     eblook> search test
      1. 1234:567    test
      2. 2345:678    testament

出力の一桁目はエントリの番号で、二桁目はエントリを決定するためのコード番
号です。いずれかをコマンド `content' に渡すことで、エントリの内容が出力
されます。(*Note Content::)

変数 `max-hits' により、出力する見出し語の数を制限出来ます。

     eblook> show max-hits
     256
     eblook> search t*
      1. 1263:25     t
      2. 1273:832    t.
      :
     255. 1312:684   tabu
     <more point=256>

続きを表示するには、`search' に第二引数を渡して下さい。

     eblook> search t* 256
     256. 1336:32    tantalization
     257. 1358:2ab   tantalize
      :
     511. 14c6:233   tea shop
     <more point=512>

引数や `max-hits' に 0 を指定すると、全てのエントリが出力されます。



File: eblook.info, Node: Menu, Next: Content, Prev: Word Search, Up: Search

メニュー
========

辞書がメニューを持つ場合、コマンド `menu' により出力されます。

     eblook> menu
     <reference>『国語辞典』について</reference=2a18:2>
     <reference>凡例</reference=2a18:202>

角括弧に挟まれたタグのうち、`/reference=' となっている部分の後ろがメニュー
の内容となっており、コマンド `content' によりその先を得ることが出来ます。
(*Note Content::)

     eblook> content 2a18:2
     『国語辞典 第一版』 

     19xx年xx月xx日 第一版第一刷



File: eblook.info, Node: Content, Next: Appendix, Prev: Menu, Up: Search

内容表示
========

コマンド `content' により、エントリの内容が得られます。

     eblook> search test
      1. 1234:567    test
      2. 2345:678    testament
     eblook> content 1
     test /t'est/
     [名] 1. 試験...
     eblook> content 1234:567
     test /t'est/
     [名] 1. 試験...

内容がリファレンスを持つ場合、その部分が先のメニューと同じタグによって表
わされます。

`search' と同様に、出力するバイト数を変数 `max-text' によって調節出来ま
す。続きを得る場合には `content' に第二引数を与えるのも同じです。0 を与
えると最後まで出力されます。

出力内容の外字部分を通常のテキスト文字で置き換えることも可能です。*Note
Appendix:: を参照して下さい。



File: eblook.info, Node: Appendix, Prev: Content, Up: Search

外字の置換
==========

EB ライブラリの機能として、CD-ROM 書籍に含まれる特殊な外字を通常の文字列
で置き換えることが可能です。何もしないと、外字は次のように表わされます。

     eblook> content 1234:567
     test /t<gaiji=ha123>st/
     <gaiji=ha234><gaiji=ha345> 1. 試験...

これを適当な文字列で置き換えるには、NDTPD と共に配布されている Appendix 
パッケージを入手し、適当なディレクトリに展開して下さい。

NDTPD
     `http://www.sra.co.jp/people/m-kasahr/ndtpd/'

eblook コマンドの第二引数か、もしくはコマンド `book' の第二引数としてディ
レクトリを指定すれば、外字の置き換えが行なわれます。(*Note Starting::)

     eblook> book /cdrom /usr/local/share/eb/appendix
     eblook> content 1234:567
     test /t'est/
     [名] 1. 試験...
     eblook> -!-

あるいはコマンド `font' により、外字のデータを xbm 形式のビットマップデー
タとして得ることも出来ます。

     eblook> font ha123
     #define default_width    8
     #define default_height   16
     static unsigned char default_bits[] = {
        0x00, 0x30, 0x18, 0x00, 0x00, 0x00, 0x18, 0x24, 0x42, 0x7e, 0x02, 0x02,
        0x44, 0x38, 0x00, 0x00};



File: eblook.info, Node: Information, Next: Commands, Prev: Search, Up: Top

各種情報
********

コマンド `info' により、書籍の情報が出力されます。

     eblook> info
      disc type: EPWING
      character code: JIS X 0208
      the number of dictionaries: 4

コマンド `subinfo' により、選択している辞書の情報が出力されます。

     eblook> select EIWA
     eblook> subinfo
      title: 英和辞典
      directory: EIWA
      search methods: word endword exact menu
      font sizes: 16 24 30 48
      widw font characters: 0xa123 -- 0xa456

コマンド `copyright' により、選択している辞書の著作権情報が出力されます。

     eblook> copyright
     「英和辞典」 Copyright (C) 1998 Keisuke Nishida

コマンド `help' により、コマンドの一覧が出力されます。



File: eblook.info, Node: Commands, Next: Variables, Prev: Information, Up: Top

コマンド一覧
************

`book [DIRECTORY [APPENDIX]]'
     辞書を選択する。第一引数には書籍のあるディレクトリ、第二引数には 
     Appendix のあるディレクトリを指定する。全て省略した場合には、現在の
     設定が表示される。

`info'
     選択されている書籍に関する情報を出力する。

`list'
     選択されている書籍の辞書一覧を出力する。

`select DICTIONARY'
     辞書を選択する。設定すべき値は、`list' コマンドの出力から得られる。

`subinfo'
     選択されている辞書に関する情報を出力する。

`copyright'
     選択されている辞書の著作権情報を出力する。

`menu'
     選択されている辞書がメニューを持つ場合、それを出力する。(*Note
     Menu::)

`search PATTERN [OFFSET]'
     検索を行なう。第二引数は出力の開始位置。(*Note Search::)

`content ENTRY [OFFSET]'
     エントリの内容を出力する。第二引数は出力の開始位置。(*Note
     Content::)

`font [ID]'
     外字データを xbm 形式で出力する。引数を省略した場合、全ての外字の情
     報を出力する。外字の高さは変数 `font' により与えられる。

`show [VARIABLE]'
     変数の値を出力する。引数を省略した場合、すべての変数の一覧が出力さ
     れる。

`set VARIABLE VALUE'
     変数の値をセットする。

`unset VARIALBE...'
     変数をクリアする。

`help'
     コマンドの一覧を出力する。

`quit'
     eblook を終了する。



File: eblook.info, Node: Variables, Next: How To Get, Prev: Commands, Up: Top

変数一覧
********

`search-method'
     `search' コマンドの検索法。`exact', `word', `endword', `glob' のい
     ずれかが可能。デフォルトは `glob'。

`max-hits'
     `search' コマンドが出力する最大の項目数。0 のとき制限なし。デフォル
     トは 256。

`max-text'
     `content' コマンドが出力する表示バイト数(の目安)。0 のとき制限なし。
     デフォルトは 8192。

`font'
     外字データの高さ。デフォルトは 16。

`kanji-code'
     入出力の文字コード。設定出来る値は `JIS', `SJIS', `EUC' のいずれか。

`stop-code'
     テキスト出力の終了コード。"set stop-code 0x1f090000" のように指定す
     る。辞書によっては、これを指定しないと出力が適切な個所で終了しない。

`prompt'
     プロンプト。デフォルトは "eblook> "。

`version'
     eblook のバージョン番号。



File: eblook.info, Node: How To Get, Prev: Variables, Up: Top

最新情報の入手
**************

最新の eblook は，次のところから入手可能です。

ebook
     `http://www.ring.gr.jp/openlab/lookup/eblook/'

eblook に関する情報交換は、Lookup や NDTPD の ML にて行われています。

Lookup ML
     `http://www.ring.gr.jp/openlab/lookup/ml.html'
NDTPD ML
     `http://www.sra.co.jp/people/m-kasahr/ndtpd/ml-ja.html'

eblook は Lookup 開発チーム(lookup-ja@ring.gr.jp)により管理されています。
eblook に関する問い合わせはこちらまでお願いします。



Tag table:
Node: Top1077
Node: Introduction1630
Node: Overview2405
Node: Starting3817
Node: Setting4393
Node: Search5229
Node: Word Search5575
Node: Menu6917
Node: Content7332
Node: Appendix7879
Node: Information8813
Node: Commands9448
Node: Variables10391
Node: How To Get11017

End tag table
