Indexing Makes Your Book Perfect (and also, the common way of - - PowerPoint PPT Presentation

Indexing Makes Your Book Perfect

(and also, the common way of arranging words in Japanese)

K e i i c h i r

• S

h i k a n

• B
• k

e d i t

• r

f

• r

O h m s h a , L t d . K 1 6 . s h i k a n

• @

g m a i l . c

• m

T U G 2 1 3 O c t

• b

e r 2 3

Indexes from around the world

Example

The Manga Guide to Statistics (in English)

Index in English

How to use index

How to use index

Example

The Manga Guide to Statistics (in Portuguese)

Index in Portuguese

Example

The Manga Guide to Statistics (in Russian)

Index in Russian

L a t i n a l p h a b e t R u s s i a n a l p h a b e t

Example

The Manga Guide to Statistics (in Korean)

Index in Korean

L a t i n a l p h a b e t H a n g u l a l p h a b e t

Index in Korean

sansul pyeong-gyun

산술 평균

a r i t h m e t i c m e a n

ㅅ

Wo r d g r

• u

p b e g i n n i n g w i t h c

• n

s

• n

a n t l e t t e r “ ”

Example

The Manga Guide to Statistics (in Thai)

Index in Thai

L a t i n a l p h a b e t T h a i s c r i p t

Index in Thai

• T

h e i n d e x i s a r r a n g e d a s t h e s a m e m a n n e r a s t h e a l p h a b e t i c a l l a n g u a g e s , a l t h

• u

g h T h a i i s n

• t

t e c h n i c a l l y a n a l p h a b e t .

ค่าเฉลี่ยเลขคณิต

Kh̀ā c ̄ helī̀y lek ̄ h a r i t h m e t i c m e a n

ค

Wo r d g r

• u

p b e g i n n i n g w i t h l e t t e r “ ”

Example

The Manga Guide to Statistics (in traditional Chinese)

Index in Chinese

(Traditional)

Index in Chinese

(Traditional)

S t r

• k

e c

• u

n t s

• f

算

i s f

• u

r t e e n . 4 s t r

• k

e s 5 s t r

• k

e s 1 4 s t r

• k

e s 1 5 s t r

• k

e s

a r i t h m e t i c m e a n

Pinyin based order 算術平均數 S u à n s h ù p í n g j ū n s h ù

Y

• u

c a n f i n d t h e t e r m i n t h e “ S ” s e c t i

• n

.

R

• m

a n i z e ( f

• r

“ a r i t h m e t i c m e a n ” )

Example

The Manga Guide to Statistics (in simplified Chinese)

Example

The Manga Guide to Statistics (in Japanese)

Index in Japanese

Index in Japanese

か t

• ご o

f g

• j

u

• n

a r i t h m e t i c m e a n

さ t

• ぞ o

f g

• j

u

• n
• T

h e i n d e x i s a r r a n g e d i n g

• j

u

• n
• r

d e r , w h i c h i s r

• u

g h l y b a s e d

• n

t h e p r

• n

u n c i a t i

• n

.

Kana based order

算術平均 さんじゅつへいきん

T u r n i n t

• k

a n a ( s y l l a b l e s ) ( f

• r

“ a r i t h m e t i c m e a n ” )

Y

• u

c a n f i n d t h e t e r m i n t h e “ ” s e c t i

• n
• f

g

• j

u

• n

, i n s t e a d

• f

t h e “ S ” s e c t i

• n

.

さ

( “ s a n j u t s u h e i k i n ” i n r

• m

a n i z a t i

• n

)

Gojuon order

• R

e d

• n

e s c a n b e u s e d a s t h e h e a d e r f

• r

t h e g r

• u

p c

• n

t a i n i n g f

• l

l

• w

i n g s . ( L i g h t

• w

e i g h t

• n

e s

• f

t e n

• m

i t t e d . )

• N

u m b e r e d

• n

l y a s a g u i d e . T h e r e i s m

• r

e s y l l a b l e s .

Example against gojuon

久保田五郎（くぼたごろう） 久保田四郎 窪田二郎（くぼたじろう） 窪田三郎 久保田四郎（くぼたしろう） 窪田二郎 窪田三郎（くぼたさぶろう） 久保田五郎 a c c

• r

d i n g t

• t

h e g

• j

u

• n
• r

d e r . . . b u t

• f

t e n . . .

k u b

• t

a g

• r
• u

k u b

• t

a s a b u r

• u

k u b

• t

a s h i r

• u

k u b

• t

a j i r

• u

If you’d like to know more about arranging Japanese index...

• S

I S T 1 3 – I n d e x e s a n d I n d e x i n g

• O

n e

• f

t h e S t a n d a r d s f

• r

I n f

• r

m a t i

• n
• f

S c i e n c e a n d T e c h n

• l
• g

y b y t h e Mi n i s t r y

• f

E d u c a t i

• n

, C u l t u r e , S p

• r

t s , S c i e n c e a n d T e c h n

• l
• g

y

• http://sti.jst.go.jp/sist/handbook/

sist13/sist13_m.htm

Making (Japanese) index with LaTeX

Embed index entry with kana

\index{ さんじゅつへいきん @ 算術平均 }

算術平均 さんじゅつへいきん

T u r n i n t

• k

a n a ( s y l l a b l e s ) ( f

• r

“ a r i t h m e t i c m e a n ” ) P u t i t i n

\index c

• m

m a n d k a n a ( s y l l a b l e s ) w

• r

d a p p e a r i n g i n t h e i n d e x

Indexing in LaTeX

• E

m b e d t h e i n d e x e n t r i e s w i t h i n t h e m a n u s c r i p t s u s i n g \ i n d e x c

• m

m a n d .

• m

a k e i n d e x a r r a n g e t h e e n t r i e s s

• a

s t

• b

e s

• r

t e d a n d l a i d

• u

t .

• T

h e m a n u s c r i p t t e n d s t

• b

e m e s s y .

Tips: How to avoid messy manuscripts

Indexing Japanese in LaTeX

• I

n c l u d e k a n a i n e a c h \index

c

• m

m a n d .

• mendex

a r r a n g e t h e e n t r i e s s

• a

s t

• b

e s

• r

t e d a n d l a i d

• u

t .

• T

h e m a n u s c r i p t t e n d s t

• b

e m e s s i e r .

Kana depends on the context

(not just on kanji)

多相性 た そ う せ い あ い しょ う T u r n i n t

• k

a n a T u r n i n t

• k

a n a 相性

f

• r

“ c

• m

p a t i b i l i t y ” f

• r

“ p

• l

y m

• r

p h i s m ” a i s y

• u

t a s

• u

s e i

多相性 た あ い しょ う T u r n i n t

• k

a n a

f

• r

“ a l

• t
• f

c

• m

p a t i b i l i t i e s ” t a a i s y

• u

?

Morphological analyzer and its corner case

多相性 た / あいしょう たそう / せい 多相的な たそう / てき / な m

• r

p h

• l
• g

i c a l a n a l y z e r m

• r

p h

• l
• g

i c a l a n a l y z e r

success success fail

Using morpho- logical analyzer to put kana

• T

h e m a n u s c r i p t i s s l i g h t l y t i d i e r t h a n b e f

• r

e !

Why bother with indexing?

Example

The TeXbook

Components

• f index

Q u a l i f i c a t i

• n

s S u b h e a d i n g s C r

• s

s

• r

e f e r e n c e s Mo d i f i c a t i

• n

s R e f e r e n c e s H e a d i n g s

Components

References Headings

Mandatory

• T

h e r e a d e r w i l l e a s i l y f i n d w h a t i n f

• r

m a t i

• n

t h e b

• k

h a s

• r

n

• t

, j u s t b y r e v i s i n g t h e h e a d i n g s

• f

t h e i n d e x .

• R

e f e r e n c e s a r e w h a t m a k e t h e i n d e x t h e i n d e x .

Qualifications Subheadings Modifications

Subsidiary

Cross-references

• T

h e y h e l p t h e r e a d e r l e a r n t h e c

• n

t e x t

• f

t h e h e a d i n g s .

Allowed

• A

n y r e m a r k s t h a t h e l p r e a d e r g e t t h e p r

• p

e r r e f e r e n c e

• u

t

• f

s e v e r a l a l t e r n a t i v e s .

• F
• r

e x a m p l e , e a c h a s t e r i s k ( * ) i n d i c a t e s t h a t t h e f

• l

l

• w

i n g h e a d i n g i s a p r i m i t i v e

• f

T e X

Unrecommended

• A

u x i l i a r y i n f

• r

m a t i

• n

b e y

• n

d t h e m a i n p u r p

• s

e

• f

t h e i n d e x .

• E

x c l u d e e v e r y t h i n g w h i c h g e t s t h e r e a d e r s n

• w

h e r e !

Pointless Components

• E

x c e r p t f r

• m

t h e i n d e x

• f

“ T h e V i s u a l B

• k
• f

D i n

• s

a u r s f

• r

K i d s ”

• Wh
• c

a r e s t h e n a m e

• f

d i s c

• v

e r e r s i n t h e i n d e x ?

Indexing for who?

Three types

• f index users

1 . L

• k

i n g

• u

p 2 . R e l u c t a n t 3 . P

• t

e n t i a l

Looking-up readers

• A

l r e a d y r e a d t h e b

• k

.

• A

t l e a s t , k n

• w

t h e s u b j e c t .

( B

• k

s

• n

t e c h n

• l
• g

i e s

• r

a n y s

• r

t

• f

p r a c t i c a l k n

• w

l e d g e

• f

t e n h a v e t h e s e k i n d

• f

r e a d e r s . )

• T

h e y ’ d l i k e t

• g
• d

i r e c t l y t

• s
• m

e s p e c i f i c p a r t

• f

t h e b

• k

.

Reluctant index-users

• R

e a d e r s w

• u

l d g e t l

• s

t d u r i n g r e a d i n g t h e b

• k

w h e n …

• t

h e y f

• r

g e t t h e k e y w

• r

d s .

• t

h e b

• k

i s p

• r

l y c

• n

s t r u c t e d .

• T

h e l a t t e r c

• u

l d b e a v

• i

d e d b y i n d e x i n g .

Potential readers

• Y
• u

c a n u s e t h e i n d e x t

• g

r a s p t h e c

• n

t e n t s

• f

t h e b

• k

e v e n b e f

• r

e a c t u a l l y r e a d i t t h r

• u

g h .

• T

h e i n d e x e x h i b i t s t h e c

• n

t e n t s

• f

t h e b

• k

i n a n

• t

h e r w a y t h a n t h e b

• k

i t s e l f .

Index and ebook

Is it necessary anyway?

Is it necessary anyway?

• D

e f i n i t e l y !

• T

h e y w

• u

l d s u p p l e m e n t a f u l l t e x t l i t e r a t u r e s e a r c h t h r

• u

g h e b

• k

s .

• I

t m a y t a k e a d i f f e r e n t s h a p e f r

• m

t h a t

• f

t h e p r i n t e d b

• k

s .

Summing up

With bad index, readers …

• w
• u

l d b e j u s t c

• n

f u s e d .

• h

a v e t

• r

e a d t h r

• u

g h t h e w h

• l

e b

• k

a n y w a y .

• w
• u

l d c

• m

e t

• r

e a d a n i l l w r i t t e n

• r

e d i t e d b

• k

.

With good index, readers …

• c
• u

l d d i r e c t l y r e a c h t

• t

h e p r

• p

e r p a g e s .

• c
• u

l d g r a s p t h e w h

• l

e b

• k

.

• c
• u

l d g e t a n

• t

h e r a s p e c t

• f

t h e b

• k

.

What we have seen

• I

n d e x e s f r

• m

t h e w

• r

l d

• H
• w

t

• a

r r a n g e J a p a n e s e w

• r

d s i n L a T e X r e a l m

• G
• d

i n d e x , b a d i n d e x