Installation of the minitoc package (version #60 2008/07/16). This package contains a lot of files. The list of all files is given in minitoc.l. The files are sorted into ``classes'' below (a file can appear in more than one class). Each class specifies the function and the placement of its files. (0) The files minitoc.ins and minitoc.dtx are the basic source files of this package. The file minitoc-fr.dtx loads minitoc.dtx but selects the french documentation. The language selection is done by using \ifcase ... \or ... \fi constructs. (1) The files minitoc.sty, mtcoff.sty, mtcmess.sty, and ALL *.mld and *.mlo files are the package itself. They must be all installed in a directory where LaTeX finds the .sty files. mtcmempatch.sty is a temporary fix for compatibility with the memoir class. (2) INSTALL is a file describing the installation of the package. You are reading it. minitoc.l contains the list of all files of the minitoc distribution. README is a file describing briefly the minitoc package, plus some useful infos. CATALOG contains basic infos about the minitoc package (abstract, date, author, version, licence). TODO lists some suggested developments of the package. Comments and suggestions are welcome. (3) Examples of documents: mtc-2c.tex, mtc-2nd.tex, mtc-3co.tex, mtc-add.tex, mtc-ads.tex, mtc-amm.tex, mtc-apx.tex, mtc-art.tex, mtc-bk.tex, mtc-bo.tex, mtc-ch0.tex, mtc-cri.tex, mtc-fko.tex, mtc-fo1.tex, mtc-fo2.tex, mtc-gap.tex, mtc-hi1.tex, mtc-hi2.tex, mtc-hia.tex, mtc-hir.tex, mtc-hop.tex, mtc-liv.tex, mtc-mem.tex, mtc-mm1.tex, mtc-mu.tex, mtc-nom.tex, mtc-ocf.tex, mtc-ofs.tex, mtc-sbf.tex, mtc-scr.tex, mtc-syn.tex, mtc-tbi.tex, mtc-tlc.tex, mtc-tlo.tex, mtc-tsf.tex, mtc-vti.tex, are example files, to play with. The associated .pdf files are provided. Another (short) examples are welcome. (4) minitoc.bug, minitoc.sum are plain text documentation: list of problems (faq) and summary of commands. (5) minitoc.dtx, minitoc.ins, minitoc.bib, minitoc.ist, minitoc.lan, en-mtc.bst, are the source of the documentation in (non perfect) english. (6) The files aaland-f.png, acadian-m.pdf, acadie-f.png, acadien-m.pdf, afghan-f.png, africa-lf.png, africa-lo.pdf, afrsud-l.pdf, afrsud-p.pdf, albania.pdf, albania-f.png, alb2.png, alba-eth.pdf, algeria-f.png, allemand.jpg, alsace-f.png, andorra-f.png, argentina-f.png, anglo1.pdf, angola-f.png, arab-l.jpg, arabw.png, armenia-f.png, armeniad.pdf, armenian-l.png, armeniar.jpg, aruba-f.png, australia-f.png, austria-f.png, azerbaijan-f.png, bahamas-f.png, bahrain-f.png. baltes.jpg, bangla.png, bangla1.png, bangla2.png, bangladesh-f.png, barbados-f.png, basque-de.png, basque-df.png, basque1.pdf, basque2.pdf, be-dg-f.png, belarus-f.png, belgique.pdf, belgium-f.png, belize-f.png, bengali-m.jpg, benin-f.png, bolivia-f.png, bolzano-f.png, bosnia.pdf, bosnia-hz-f.png, bozen-f.png, brazil.pdf, brazil-f.png, brazilp.pdf, bretagne.pdf, brussels-f.png bulgaria-f.png, bulgariar.jpg, bulgarski.png, bulgmap.png, bur-f.png, burkina-f.png, burundi-f.png, buryatia.pdf, buryatia-l.pdf, california-f.png, cambodia-f.png, cameroon-f.png, canada.pdf, canada-f.png, canada-l.pdf, canada-pe.png, canada-pf.pdf, canada1.pdf, cap-verde-f.png, castille-f.png, catalan-d.pdf, catalan-p.pdf, catalonia-f.png, chile-f.png, caucasus.pdf, central-africa-f.png, chad-f.png, china-ae.png, china-af.png, china-ch.png, china-f.png, china-l.pdf, china-w.png, chine1.pdf, chine2.pdf, cis-f.png, colombia-f.png, comoros-f.png, congo-f.png, corsica-f.jpg, costa-rica-f.jpg, cplp-0.png, cplpmap.png, croatia-f.png, croatia-un.png, croatie2.png, cuba-f.png, cyprus-f.png, cyr-alf.png, cz1.pdf, cz3.png, czech-f.png, czechd.pdf, dane-f.png, danemark.jpg, danishd.pdf, danishg.pdf, devanagari.png, djibouti-f.png, dominica-f.png, dominican-f.png, dutchw.pdf, east-timor-f.png, ecosse1.pdf, ecosse2.pdf, ecosse3.pdf, ecuador-f.jpg, egypt-f.png, el-salvador-f.png, england-f.jpg, equa-guinea-f.png, eritrea-f.png, espa-l.pdf, espa-o.png, esperanto-f.png, estonia-a.pdf, estonia-b.pdf, estonia-f.png, eth2.png, ethiolang.png, ethiopia.pdf, ethiopia-f.png, ethiopia-p.pdf, euro-lan.png, euro-lan1.png, euro-lan2.png, eusk-f.png, euskara.png, faroe-f.png, farsi.pdf, farsi-logo.png, feroe.jpg, fiji-f.png, finland-f.png, finlande1.png, finlande2.pdf, finnishd.pdf, finnishl.pdf, flanders-f.png, france-f.png, france-lr.png, franco.png, francophonie-f.png, gabon-f.png, gael-ft.pdf, gaid.jpg, galicia-f.png, galicia-m.pdf, galicia-mp.pdf, galician-l.png, galles1.pdf, galles2.pdf, georgia-f.png, germ-w.png, german-c.pdf, german-d.pdf, german-m.pdf, germany-f.jpg, ghana-f.png, gibraltar-f.png, grece1.pdf, grece2.pdf, greece-f.png, greeka.png, greekm.jpg, greenland-f.png, guatemala-f.jpg, guinea-bissau-f.png, guinea-f.png, gwenn-f.png, haiti-f.jpg, hangul.png, hanja.png, hanzi.png, hin.png, hindi-b.png, hindi-p.png, hrv.png, hispano.png, honduras-f.png, hun1.png, hun2.jpg, hungary-f.png, iceland-f.png, imongolia-f.png, inde1.pdf, inde2.jpg, india-f.png, indonesia-f.png, indonesia1.pdf, indonesia2.pdf, iran-f.png, iranian.jpg, iraq-f.png, ireland-f.png, irish.png, irlande.pdf, islam-pbc.png, islam-sw.pdf, islande.png, islandep.jpg, isr1.pdf, isr2.pdf, israel-f.png, italian.pdf, italy-f.png, italo1.png, italysm.png, ivory-f.png, ivrit.png, jamaica-f.png, japan-f.png, japon1.pdf, japon2.jpg, jordan-f.png, jutland-f.png, kannada-n.png, karnad1.jpg, karnataka.jpg, karnataka-f.jpg, kazakhstan-f.png, kenya-f.png, kerala.jpg, kerala-f.jpg, khalka.pdf, kiribati-f.png, korea-n-f.png, korea-s-f.png, korean1.png, korean2.jpg, kos-alb.png, kos-ml.png, kosovo-f.png, kuwait-f.png, kyrgyzstan-f.png, lamed3.png, lang-g.png, laos-f.png, latvia-f.png, latvian-d.png, latvian-r1.png, lebanon-f.png, lettonie.jpg, leur.png, liberia-f.png, libya-f.jpg, liech-f.png, lithuania-f.jpg, lituanie.png, lorraine-f.jpg, louisiana-f.png, ls-f.png, luso1.pdf, luso2.pdf, lux-f.png, macau-f.png, macedonia-f.png, madagascar-f.png, maine-f.jpg, malawi-f.png, malayalam.pdf, malayalam.png, malaysia-f.png, malaysia1.pdf, malaysia2.pdf, mali-f.png, malta1-f.png, manchu.jpg, manchuria.jpg, manjuc.jpg, manjui.png, mauritania-f.png, mauritius-f.png, mex1.pdf, mex2.pdf, mex3.pdf, mexico-f.jpg, mexip.pdf, meyalu.png, moldova-f.png, monaco-f.png, mondep.png, mongasie.pdf, mongolcy.png, mongolia-f.png, mongolian.pdf, mongols.png, mongoltr.png, montenegro-f.jpg, morocco-f.png, mozambique-f.png, namibia-f.png, nbrunswick-f.png, ncyprus-f.png, neder.pdf, netherlands-antilles-f.png, netherlands-f.png, new-york-f.png, newzealand-f.png, nicaragua-f.png, nice-f.png, niger-f.png, nigeria-f.png, nihongo.png, norvege-c.pdf, norvege-t.pdf, norway-f.png, norway-p.pdf, occ-f.png, occdial1.jpg, occdial2.png, occitanie.png, occtaur.jpg, oman-f.png, opole-f.png, pakistan-f.png, palestine-f.png, panama-f.png, paraguay.png, paraguay-f.png, paraguayp.pdf, peru-f.png, philippines-f.png, poland-f.png, polish-d.jpg, polmin.jpg, pologne.pdf, polski-f.png, portu-a.png, portu-b.png, portu-p.jpg, portu-r.jpg, portugal.pdf, portugal-f.png, puerto-rico-f.png, qatar-f.png, quebec-f.png, rdcongo-f.png, romania-f.png, romanian.pdf, rus-cyr.png, rus-re.png, rus-su.pdf, russia-f.png, russian.png, russian-e.pdf, russian-n.png, russian-w.png, rwanda-f.png, saint-lucia-f.png, same.png, same-f.png, sami-f.png, samoa-f.png, san-marino-f.png, sao-f.png, saudi-arabia-f.png, scotland-f.png, senegal-f.png, serb-a.pdf, serbia-f.png, serbia-f2.png, serbia1.pdf, seychelles-f.png, singapore-f.png, slovak-ok.png, slovakia.pdf, slovakia-f.png, slovenia-f.png, slovenian.png, slovenie.pdf, solomon-islands-f.png, somalia-f.png, sorabe-1.jpg, sorabe-2.jpg, sorben.jpg, sorbian.jpg, south-africa-f.png, spain.png, spain-f.png, spilhennig.png, start.jpg, stop.png, sudan-f.png, suede-a.pdf, suede-fin.pdf, suisse-f.png, suriname-f.png, svenska.png, swahili.pdf, fswahili.pdf, swahili-m.png, sweden.pdf, sweden-f.png, syria-f.png, taiwan-f.png, tajikistan-f.png, tanzania-f.png, thai.pdf, thai.png, thailand-f.png, togo-f.png, tonga-f.png, tunisia-f.png, turkey-f.png, turkish.png, turkmenistan-f.png, turquie.pdf, tuvalu-f.png, uae-f.png, uganda-f.png, uighur-f.png, uighur.pdf, uk-f.png, ukra.png, ukraine.jpg, ukraine-f.png, ukrainep.pdf, uruguay-f.png, us-f.png, usa-f.png, uzbekistan-f.png, vanuatu-f.png, vatican-f.jpg, venezuela-f.png, vermont-f.png, viet2.pdf, viet3.pdf, viet4.pdf, viet-w.pdf, vietnam-f.png, vojvodina-f.png, wales-f.png, wallonia-f.png, wallonie.pdf, wiki.png, wikif.png, wrs-a.png, wrs-c.png, xinjiang.png, xinjiangc.png, xyugo.png, yemen-f.png, zambia-f.png, zanzibar-f.png, zimbabwe-f.png, are images to include. (7) minitoc-fr.dtx, minitoc-fr.bib, minitoc-fr.ist, frbib.sty, fr-mtc.bst, minitoc-fr.lan are the source (and tools) of the documentation in french. (8) minitoc.pdf is the documentation in (non perfect) english, in PDF format. (9) minitoc-fr.pdf is the documentation in french, in PDF format. (10) pmk is a shell script to prepare the package and its documentation; the pmk script uses the /tmp/`whoami`.imk and /tmp/`whoami`.tmk directories to not waste disk space under your home directory; there are also six partial scripts (to be adapted): -- imk, which prepares the package from minitoc.ins and minitoc.dtx; note that imk must be run before emk or fmk; it creates also some .sty files necessary to prepare the documentation but they must be installed with it; the imk script uses the /tmp/`whoami`.imk directory to not waste disk space under your home directory; -- emk, which prepares the english documentation from minitoc.dtx; -- fmk, which prepares the french documentation from minitoc-fr.dtx and minitoc.dtx; -- xmk, which typesets the example files (into PDF). -- rmk, which sorts the files into classes (one directory for each class); -- tmk, which creates a TDS-conformant hierarchy (to be tailored for your system); this hierarchy is saved in minitoc.tds.zip; -- cmk, which convert the PDF documentation files into PostScript files. These scripts are currently written in C-shell, but there are very simple, and should be easy to convert in another classic shell. The documentation in PostScript format is no more distributed on the CTAN sites, but the cmk script prepares it (with recto-verso printing). (11) minitoc.tds.zip is a ZIP-archive file containing a TDS-compliant hierarchy with all the files of the minitoc package. Some remarks about the rmk, tmk and pmk scripts (which you should tailor to your needs): * with rmk: -- the files of (1) must be installed in a directory where LaTeX finds .sty files; -- the files of (2), (3), (4), (5), (6) and (9) must be installed in a separate directory, but must not be omitted; -- the files of (7) and (8) must be installed as on-line documentation; -- the directories created by the rmk script are under /tmp/`whoami`.rmk to not waste disk space under your home directory. * with tmk: -- the hierarchy is TDS-compliant; -- each file appears only once in the hierarchy; -- the installation is much easier: you only need a .zip or a .tar (or .tgz} dump file of the hierarchy to be deployed into the installed TDS hierarchy; you should examine VERY CAREFULLY (by comparison with you TDS installation) and tailor the tmk script before using it; -- the directories created by the \texttt{tmk} script are under /tmp/`whoami`.tmk to not waste disk space under your home directory; -- the file minitoc.tds.zip (10) should not be installed; it is just a method to help making a TDS-compliant installation. * with pmk: -- the pmk script performs the actions of imk (preparation of the basic files), emk and fmk (preparation of the english and french documentation), xmk (preparation of the examples of documents), rmk and tmk (repartition of files into classes and in a TDS-compliant hierarchy); -- the directories created by the pmk script are under the /tmp/`whoami`.rmk and /tmp/`whoami`.tmk directories to not waste disk space under your home directory. -- the SAME PRECAUTIONS as for tmk are needed. The file minitoc.tds.zip contains a ZIP archive of a TDS-compliant hierarchy of all files of the minitoc package. It has been prepared by the pmk or tmk scripts. Note that the PostScript documentation files may be printed recto-verso on some printers. They are no more distributed on the CTAN archives but the scripts prepare them. Note that minitoc.dtx and minitoc-fr.dtx are (not so trivial) examples of using minitoc with hyperref. They show how the combinaison of these two packages may be useful. For a more detailed description of the installation of the minitoc package, see the ``Installation'' chapter in minitoc.pdf (in english) ou in minitoc-fr.pdf (in french).