Alphabetic groupings in indexes
An index may be divided into groups of headwords beginning with the same letter.
In such cases, insert an alphabet element as a child of indexList to separate each group in the indexList.
If the printed book shows the letter that is being grouped then the alphabet element’s value should contain that letter.
If the grouping letter is not displayed in the book then insert empty alphabet/ elements for each letter grouping.
Alphabetic groupings example
XML
<indexGroup>
<indexList indexListType="regular"><alphabet>X</alphabet><indexItem1>
<iHeadword>X-rays</iHeadword> ... </indexItem1><indexItem1>
<iHeadword>xanthelasma</iHeadword> ... </indexItem1><indexItem1>
<iHeadword>xanthomata</iHeadword> ... </indexItem1><alphabet>Y</alphabet><indexItem1>
<iHeadword>young people</iHeadword> ... </indexItem1><alphabet>Z</alphabet><indexItem1>
<iHeadword>z-shaped thumb</iHeadword> ... </indexItem1><indexItem1>
<iHeadword>zinc</iHeadword> ... </indexItem1>
</indexList>
</indexGroup>
Alphabetic groupings with empty alphabet/ element example
XML
<indexGroup>
<indexList indexListType="regular"><alphabet/><indexItem1>
<iHeadword>World Food Programme (WFP)</iHeadword> ...</indexItem1><indexItem1>
<iHeadword>World Health Organization (WHO)</iHeadword> ...</indexItem1><indexItem1>
<iHeadword>Wu Po-hsiung</iHeadword> ...</indexItem1><alphabet/><indexItem1>
<iHeadword>Yemen</iHeadword> ...</indexItem1><indexItem1>
<iHeadword>Yugoslavia</iHeadword>
<i>see</i> ...</indexItem1><indexItem1>
<iHeadword>Yusuf Ahmad, President Abdullahi</iHeadword> ...</indexItem1><alphabet/><indexItem1>
<iHeadword>Zaghawa tribe</iHeadword> ...</indexItem1><indexItem1>
<iHeadword>Zakayev, Akhmed</iHeadword> ...</indexItem1><indexItem1>
<iHeadword>Zambia</iHeadword> ...</indexItem1><indexItem1>
<iHeadword>Zangger Committee</iHeadword> ...</indexItem1><indexItem1>
<iHeadword>Zeid Report</iHeadword> ...</indexItem1><indexItem1>
<iHeadword>Zimbabwe:</iHeadword>
<indexItem2>
<iHeadword>arms trade treaty and</iHeadword> ...</indexItem2>
<indexItem2>
<iHeadword>elections</iHeadword> ...</indexItem2>
<indexItem2>
<iHeadword>EU arms embargo</iHeadword> ...</indexItem2>
<indexItem2>
<iHeadword>G8 Declaration</iHeadword> ...</indexItem2>
<indexItem2>
<iHeadword>landmines</iHeadword> ...</indexItem2>
<indexItem2>
<iHeadword>power-sharing agreement</iHeadword> ...</indexItem2>
<indexItem2>
<iHeadword>UN arms embargo</iHeadword> ...</indexItem2></indexItem1>
</indexList>
</indexGroup>