57
Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro Shikano Book editor for Ohmsha, Ltd. [email protected] TUG 2013 October 23

Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

  • Upload
    others

  • View
    3

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Indexing Makes Your Book Perfect(and also, the common way ofarranging words in Japanese)

Keiichiro ShikanoBook editor for Ohmsha, [email protected]

TUG 2013 October 23

Page 2: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Indexes from around

the world

Page 3: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example The Manga Guideto Statistics

(in English)

Page 4: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in English

Page 5: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

How to use index

Page 6: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

How to use index

Page 7: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example The Manga Guideto Statistics

(in Portuguese)

Page 8: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in Portuguese

Page 9: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example The Manga Guideto Statistics

(in Russian)

Page 10: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in RussianLatin alphabet

Russian alphabet

Page 11: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example The Manga Guideto Statistics

(in Korean)

Page 12: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in Korean

Latin alphabet Hangul

alphabet

Page 13: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in Korean

sansul pyeong-gyun산술 평균 arithmetic

mean

ㅅWord group beginning with consonant letter “ ”

Page 14: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example The Manga Guideto Statistics

(in Thai)

Page 15: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in Thai

Latin alphabet

Thai script

Page 16: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in Thai● The index is arranged

as the same manner as the alphabetical languages, although Thai is not technically an alphabet.

ค่าเฉล่ียเลขคณิตKh̀ā c̄helī̀y lek̄h

arithmeticmean

คWord group beginning with letter “ ”

Page 17: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example The Manga Guideto Statistics

(in traditional Chinese)

Page 18: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in Chinese (Traditional)

Page 19: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in Chinese (Traditional)

Stroke counts of

算 is fourteen.

4 strokes

5 strokes

14 strokes

15 strokes

arithmeticmean

Page 20: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Pinyin based order

算術平均數

Suànshù píngjūn shù

You can find the term in the “S” section.

Romanize

(for “arithmetic mean”)

Page 21: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example The Manga Guideto Statistics

(in simplified Chinese)

Page 22: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example The Manga Guideto Statistics

(in Japanese)

Page 23: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in Japanese

Page 24: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index in Japanese

か toご of gojuon

arithmeticmean

さ toぞ of gojuon

● The index is arranged in gojuon order, which is roughly based on the pronunciation.

Page 25: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Kana based order算術平均

さんじゅつへいきんTurn into kana (syllables)

(for “arithmetic mean”)

You can find the term in the “ ” section of gojuon, instead of the “S” section.

(“sanjutsuheikin” in romanization)

Page 26: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Gojuon order● Red ones can be used as

the header for the group containing followings. (Light-weight ones often omitted.)

● Numbered only as a guide. There is more syllables.

Page 27: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example against gojuon

久保田五郎(くぼたごろう) 久保田四郎

窪田二郎(くぼたじろう) 窪田三郎

久保田四郎(くぼたしろう) 窪田二郎

窪田三郎(くぼたさぶろう) 久保田五郎

according to the gojuon order ... but often ...

ku bo ta go ro u

ku bo ta sa bu ro u

ku bo ta shi ro u

ku bo ta ji ro u

Page 28: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

If you’d like to know more about arranging Japanese

index...

• SIST 13 – Indexes and Indexing• One of the Standards for Information of Science and Technology by the Ministry of Education, Culture, Sports, Science and Technology

• http://sti.jst.go.jp/sist/handbook/sist13/sist13_m.htm

Page 29: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Making (Japanese) index with

LaTeX

Page 30: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Embed index entry with kana

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

算術平均

さんじゅつへいきんTurn into kana (syllables)

(for “arithmetic mean”)

Put it in \index command

kana(syllables) word appearing in the index

Page 31: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Indexing in LaTeX

● Embed the index entries within the manuscripts using \index command.

● makeindex arrange the entries so as to be sorted and laid out.

● The manuscript tends to be messy.

Page 32: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Tips: How to avoid messy manuscripts

Page 33: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

IndexingJapanese in LaTeX

● Include kana in each \index command.

● mendex arrange the entries so as to be sorted and laid out.

● The manuscript tends to be messier.

Page 34: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Kana depends on the context

(not just on kanji)

多相性 た そ う せ い

あ い しょ うTurn into kana

Turn into kana

相性for “compatibility”

for “polymorphism”

a i syo u

ta so u se i

多相性 た あ い しょ うTurn into kana

for “a lot of compatibilities” ta a i syo u

?

Page 35: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Morphological analyzer and its corner case

多相性 た / あいしょう

たそう / せい

多相的な たそう / てき / な

morphological analyzer

morphological analyzer

successsuccess

fail

Page 36: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Using morpho-logical

analyzer to put kana

● The manuscript is slightly tidier than before!

Page 37: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Why bother with

indexing?

Page 38: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Example

The TeXbook

Page 39: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Components of index

Page 40: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Qualifications

Subheadings

Cross-references

Modifications

References

Headings

Components

Page 41: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

References

Headings

Mandatory

● The reader will easily find what information the book has or not, just by revising the headings of the index.

● References are what make the index the index.

Page 42: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Qualifications

Subheadings

Modifications

Subsidiary

Cross-references

● They help the reader learn the context of the headings.

Page 43: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Allowed● Any remarks that

help reader get the proper reference out of several alternatives.

● For example, each asterisk(*) indicates that the following heading is a primitive of TeX

Page 44: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Unrecommended

• Auxiliary information beyond the main purpose of the index.

• Exclude everything which gets the readers nowhere!

Page 45: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Pointless Components

● Excerpt from the index of“The Visual Book of Dinosaurs for Kids”

● Who cares the name of discoverers in the index?

Page 46: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Indexing for who?

Page 47: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Three typesof index users

1. Looking-up2. Reluctant3. Potential

Page 48: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Looking-up readers• Already read the book.• At least, know the subject.

(Books on technologies or any sort of practical knowledge often have these kind of readers.)

• They’d like to go directly to some specific part of the book.

Page 49: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Reluctant index-users• Readers would get lost during

reading the book when …• they forget the key words.• the book is poorly constructed.

• The latter could be avoided by indexing.

Page 50: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Potential readers• You can use the index to grasp

the contents of the book even before actually read it through.

• The index exhibits the contents of the book in another way than the book itself.

Page 51: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Index and ebook

Page 52: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Is it necessary anyway?

Page 53: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Is it necessary anyway?

• Definitely!• They would supplement a full

text literature search through ebooks.

• It may take a different shape from that of the printed books.

Page 54: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

Summing up

Page 55: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

With bad index,readers …

• would be just confused.• have to read through the whole book anyway.

• would come to read an ill written or edited book.

Page 56: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

With good index, readers …

• could directly reach to the proper pages.

• could grasp the whole book.• could get another aspect of the book.

Page 57: Indexing Makes Your Book Perfect - TeX Users Group (TUG) · 2013. 10. 21. · Indexing Makes Your Book Perfect (and also, the common way of arranging words in Japanese) Keiichiro

What we have seen

• Indexes from the world• How to arrange Japanese words in LaTeX realm

• Good index, bad index