# man > mendex(1) [_MENDEX_(1)](https://www.chedong.com/phpMan.php/man/MENDEX/1/markdown) General Commands Manual [_MENDEX_(1)](https://www.chedong.com/phpMan.php/man/MENDEX/1/markdown) ## NAME mendex - Japanese index processor ## SYNOPSIS **mendex **[-ilqrcgfEJSU] [**-s _**sty_] [**-d _**dic_] [**-o _**ind_] [**-t _**log_] [**-p _**no_] [**-I _**enc_] [**--help**] [**--**] [ _idx0_ _idx1_ _idx2_ _..._] ## DESCRIPTION The program _mendex_ is a general purpose hierarchical index generator; it accepts one or more input files (_.idx_; often produced by a text formatter such as LaTeX), sorts the entries, and produces an output file which can be formatted. It is almost compatible with _makeindex_, and additional feature for handling readings of kanji words is also available. The formats of the input and output files are specified in a style file. The readings of kanji words can be specified in a dictionary file. The index can have up to three levels (0, 1, and 2) of subitem nesting. ## OPTIONS ### -i ### -l are described below. ### -q ### -r are automatically abbreviated as a range (e.g. 1–5). ### -c ignore leading and trailing blank(s). By default, blanks in the index key are re‐ tained. ### -g (Japanese syllabary). By default, all 48 characters in the _gojuon_ table are used. ### -f ### -s _ ### -d _ _dex_word_ _reading_>. ### -o _ pending the extension _ind_ to the base name of the first input file. ### -t _ ing the extension _ilg_ to the base name of the first input file. ### -p _ be numerical or one of the following: _any_ (the next page to the end of contents), _odd_ (the next odd page to the end of contents), _even_ (the next even page to the end of contents). ### -E ### -J ### -S ### -U ### -I _ _utf8_ (UTF-8). The default is set to _utf8_. **--help **Show summary of options. **-- **Arguments after **-- **are not taken as options. This is useful when the input file name starts with '-'. ## STYLE FILE The style file informs _mendex_ about the format of the _idx_ input files and the intended format of the final output file. The format is upper compatible with the one for _makeindex_. The style file contains a list of <_specifier_ _attribute_> pairs. There are two types of speci‐ fiers: input and output. Pairs do not have to appear in any particular order. A line begun by ´%´ is a comment. ### Input file style parameter **keyword ** "\\indexentry" Command with an argument of index entry which is going to be processed. **arg_open ** ´{´ Opening delimiter which shows the beginning of index entry. **arg_close ** ´}´ Closing delimiter which shows the end of index entry. **range_open ** ´(´ Opening delimiter which shows the beginning of page range. **range_close ** ´)´ Closing delimiter which shows the end of page range. **level ** ´!´ Delimiter which shows lower level. **actual ** ´@´ Symbol which shows the next sequence is to appear as index strings in the output file. **encap ** ´|´ Symbol which shows the next sequence is to be used as command name attached to the page number. **page_compositor ** "-" Separator between page levels for a style with multi-levels of page numbers. **page_precedence ** "rnaRA" Priority of expression for page number. ´R´ and ´r´ correspond to Roman. ´n´ corresponds to arabic numeral. ´A´ and ´a´ cor‐ respond to Latin alphabet. **quote ** ´"´ Escape character for _mendex_ parameters. **escape ** ´\\´ Escape character for general scripts. ### Output file style parameter **preamble ** "\\begin{theindex}\n" Preamble of output file. **postamble ** "\n\n\\end{theindex}\n" Postamble of output file. **setpage_prefix ** "\n \\setcounter{page}{" Prefix of page number if start page is designated. **setpage_suffix ** "}\n" Suffix of page number if start page is designated. **group_skip ** "\n\n \\indexspace\n" Strings to insert vertical space before new section of index. **lethead_prefix ** "" Prefix of heading for newly appeared heading letter. **heading_prefix ** "" Same as **lethead_prefix**. (compatible with makeindex) **lethead_suffix ** "" Suffix of heading for newly appeared heading letter. **heading_suffix ** "" Same as **lethead_suffix**. (compatible with makeindex) **lethead_flag ** 0 Flag to control output of heading letters. ´0´, ´1´ and ´-1´ respectively denotes no output, uppercase and lowercase. **heading_flag ** 0 Same as **lethead_flag**. (Note: makeindex uses a different name **headings_flag**) **item_0 ** "\n \\item " Command sequence inserted between primary level entries. **item_1 ** "\n \\subitem " Command sequence inserted between sub level entries. **item_2 ** "\n \\subsubitem " Command sequence inserted between subsub level entries. **item_01 ** "\n \\subitem " Command sequence inserted between primaly and sub level en‐ tries. **item_x1 ** "\n \\subitem " Command sequence inserted between primary and sub level entries when main entry does not have page number. **item_12 ** "\n \\subsubitem " Command sequence inserted between sub and subsub level entries. **item_x2 ** "\n \\subsubitem " Command sequence inserted between sub and subsub level entries when sub level entry does not have page number. **delim_0 ** ", " Delimiter string between primary level entry and first page number. **delim_1 ** ", " Delimiter string between sub level entry and first page number. **delim_2 ** ", " Delimiter string between subsub level entry and first page num‐ ber. **delim_n ** ", " Delimiter string between page numbers commonly used for any en‐ try level. **delim_r ** "--" Delimiter string between pages to show page range. **delim_t ** "" Delimiter string output at the end of page number list. **suffix_2p ** "" String to be inserted in place of **delim_n **and the next page number when the two pages are contiguous. It works only when the parameter is defined. **suffix_3p ** "" String to be inserted in place of **delim_r **and the third page number when the three pages are contiguous. The parameter is prior to **suffix_mp**. It works only when the parameter is defined. **suffix_mp ** "" String to be inserted in place of **delim_r **and the last page number when the three or more pages are contiguous. It works only when the parameter is defined. **encap_prefix ** "\\" Prefix for an encapsulating command when the encapsulating com‐ mand is added to the page number. **encap_infix ** "{" Prefix just before the page number when the encapsulating com‐ mand is added to the page number. **encap_suffix ** "}". Suffix after the page number when the encapsulating command is added to the page number. **line_max ** 72 Maximum number of one line. If exceed the number, lines are folded. **indent_space ** "" Space for indent which inserted to top of folded line. **indent_length ** 16 Length of space for indent which inserted to top of folded line. **symhead_positive ** "Symbols" Strings to output as heading letter for numbers and symbols when lethead_flag or heading_flag is positive number. **symhead_negative ** "symbols" Strings to output as heading letter for numbers and symbols when lethead_flag or heading_flag is negative number. **symbol ** "" Strings to output as heading letter for numbers and symbols when symbol_flag is non zero. If specified, the option is prior to symhead_positive and symhead_negative. (Extended by mendex) **symbol_flag ** 1 Flag to output of symbol. If ´0´, do not output. (Extended by mendex) **letter_head ** 1 Flag of heading letter for Japanese Kana. If ´1´ and ´2´, Katakana and Hiragana is used, respectively. (Extended by mendex) **priority ** 0 Flag of sorting method for index words composed of Japanese and non-Japanese (ex. Latin scripts). If non zero, one space (U+20) is inserted between Japanese sequence and non-Japanese sequence in sorting procedure. (Extended by mendex) **character_order ** "SNEJ" Order of scripts and symbols. ´S´, ´N´, ´E´ and ´J´ respec‐ tively denotes symbol, numbers, English and Japanese. (Ex‐ tended by mendex) Please make sure that ´S´ and ´N´ are next to each other, since **mendex **considers numbers as part of symbol. ## ABOUT JAPANESE PROCESSING _mendex_ has an additional feature to simplify the procedure of handling Japanese indexes, com‐ pared to _makeindex_. Users can save the effort of manually specifying a reading for every kanji word. Japanese kanji words are usually sorted by the syllables of their readings (_´Yomi´_), which can be represented by kana (Hiragana, Katakana) scripts. _mendex_ accepts index words speci‐ fied in kana expression directly on an input file, and also accepts conversion from index words to kana scripts by referring to Japanese dictionaries. Examples of internal simplification of syllables are shown below. かぶしきがいしゃ かふしきかいしや マッキントッシュ まつきんとつしゆ ワープロ わあふろ The dictionary file consists of list with <´index_word´ ´reading´>. The index word can be written in any scripts (kanji, kana, etc), and the reading must be in Hiragana or Katakana scripts. The delimiter between the index word and its reading is one or more tab(s) or space(s). An example of a Japanese dictionary is shown below. 漢字 かんじ 読み よみ 環境 かんきょう α アルファ Here, each index word is allowed to have only one Yomi. Though some kanji words (ex. 「表」) may have more than one Yomi´s (ex. 「ひょう」 and 「おもて」), only one of them can be registered in the dictionary. When some different Yomi´s are needed, they should be specified explicitly in kana expression (ex. \index{ひょう@表} or \index{おもて@表}) on the input file. Moreover, a dictionary file is automatically referred by setting the file name at an environ‐ ment variable _INDEXDEFAULTDICTIONARY_. The dictionary set by the environment variable can be used together with file(s) specified by _-d_ option. ## ABOUT SORTING PROCEDURE _mendex_ sorts indexes as is (´sort by word order´) by default. Setting _-l_ option, spaces be‐ tween words in an index are truncated prior to sorting procedure (´sort by character order´). Even when sort by character order, the index at output remains the original sequence without the truncation. Follows show an example. _sort_ _by_ _word_ _order_ _sort_ _by_ _character_ _order_ X Window Xlib Xlib XView XView X Window In addition, two sorting methods can be applied for indexes which contains both Japanese kana and other scripts (e.g. Latin script). By setting _priority_ 0 (default) and 1 at a style file, a space between Japanese Kana and other scripts is inserted and not inserted respec‐ tively, prior to the sorting procedure. Follows show an example. _priority=0_ _priority=1_ index sort indファイル indファイル index sort ## ENVIRONMENT VARIABLES _mendex_ refers environment variables as follows. _INDEXSTYLE_ Directory where index style files exist. _INDEXDEFAULTSTYLE_ Index style file to be referred to as default. _INDEXDICTIONARY_ Directory where dictionary files exist. _INDEXDEFAULTDICTIONARY_ Dictionary file which is automatically read. ## DETAIL Detailed specification is compatible with _makeindex_. ## KNOWN ISSUES When plural page number expression is used, _.idx_ files should be specified along with the or‐ der of page numbers. Otherwise, wrong page numbers might be output. ## SEE ALSO [tex(1)](https://www.chedong.com/phpMan.php/man/tex/1/markdown), [latex(1)](https://www.chedong.com/phpMan.php/man/latex/1/markdown), [makeindex(1)](https://www.chedong.com/phpMan.php/man/makeindex/1/markdown) ## AUTHOR This manual page was written by Japanese TeX Development Community. [_MENDEX_(1)](https://www.chedong.com/phpMan.php/man/MENDEX/1/markdown)