Home

MiKTeX Manual

1. 0 o 41 4 2 5 Auto insertion of Source Specials 0 o a 42 4 2 5 1 What Are Source Specials o o o e 42 4 2 5 2 Howto Insert Source Specials 0 o 42 4 2 6 Quoted File Names o e 42 4 2 7 Specifying Additional Input Directories o o a 42 4 2 8 Specifying the Output Directory o o o 43 4 2 9 Specifying the Directory for Auxiliary Files o o 43 4 2 10 Running Programs From Within TEX o o e 43 4 2 11 TCX Files Character Translations 0 oo eee eee 43 4 3 texify The MiKTEX Compiler Driver 0 ooo e e 44 4 4 mtprint The MiKTEX Print Utility o ooo e e 45 A Manual Pages 46 Acl DIDIEX 2 3 aome A E AA ae See A AA 46 AAA SYNOPSIS sa see e i tae a ie a A AR a eS 46 ALA DOSCriPUION knees ai ao e a a 4nd ee T eS 46 A OPUONS he grec al a A Oe ee ee a 46 ATA See AlSO gt jc g iS wine ee eee ee RA ee AA OSS 47 A 1 5 Documentation iii a eee ad r eed DL bao BE EAS a A oes 47 A 2 AVICOPY 52 888545 Heo cio aa weeded aad wea Ya ee ae 48 ACOA lt SYNOPSIS y g gea e ea aa eG Ge OEE ek ae a ars 48 A 2 2 DESCTIPUION ex rr a a ke Geet ee ee ee aS 48 A2 3 QDpUONS sce ee eS RRR eee GSES See REM N ERAS Sees 48 A 3 VIPS rsss eee ee ee ee eee eG 49 A 3 1 SYNOPSIS 2 socio bee dS ad pe oe CARERS OER ES
2. help Give help and exit file type filetype Use the specified file type see below must exist Install missing packages if necessary show path filetype Output search path for the specified file type see below start Start the associated program if the file was found version Show version information and exit A 5 4 File Types afm Adobe font metric files atm base METAFONT base files base bib Bibliographic database files bib bst Bibliography style files bst dvips config Dvips config files config 58 APPENDIX A MANUAL PAGES A 5 FINDTEXMF enc Font encoding files enc exe Executables com exe bat fmt TEX format files fmt efmt eofmt hbf Hanzi Bitmap Fonts hbf graphic figure Graphics files eps epsi png ist Index style files ist map Font mapping files map mem METAPOST memory files mem mf METAFONT input files mf mp METAPOST input files mp ocp OCP files ocp ofm Q font metric files ofm otp OTP files otp ovf Q virtual font files ovf ovp OVP files ovp perlscript Perl script files p1 PostScript header PostScript header files pro enc tex TCX files tcx tex TEX input files tex TeX system documentation Documentation files dvi pdf ps ps txt chm htm1 tim TEX font metric files tfm truetype fonts TrueType font
3. sequences must exceed string_vacancies by the total length of the program s own strings which is currently about 30000 quiet Suppress all output except errors record package usages f1le Record all package usages and write them into file recorder Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension f1s stack size n Set the internal compiler variable stack_size to n stack_size is the maximum number of simultaneous input sources string vacancies n Set the internal compiler variable string_vacancies to n string_vacancies is the minimum number of characters that should be available for the user s control sequences and font names after the compiler s own error messages are stored tcx name Process the TCX table name See Section 4 2 11 for a discussion of TCX tables terminal oem Use the active code page e g 437 for console output tex texprogram Use texprogram instead of tex when compiling text labels This flag overrides the environment variable TEX time statistics Show processing time statistics trace traceflags Write trace messages into the DebugView window The traceflags argument is a comma separated list of trace categories access Accesses to disk files config Retrieval of configuration settings error Error conditions filesearch File search fndb File name database fontinfo Font informatio
4. batch mpm is driven by command line options windowed mpm shows a package list view with standard GUI controls such as tool bar buttons and com mand menus mpm starts in windowed mode if you do not specify any command line options see Section 3 2 2 A 9 3 Options find updates Print a list of available updates help Give help and exit hhelp Show the manual page in an HTML Help window and exit when the window is closed install package Install the specified package install some file Install packages listed line by line in the specified file list Output known packages print package info package Output detailed information about the specified package set repository url Set the location of the package repository uninstall package Uninstall the specified package update package Update the specified package update all Find available updates and install them update db Update the package database update some f1le Update packages listed line by line in the specified file verbose Turn on verbose output mode version Show version information 67 APPENDIX A MANUAL PAGES A 10 MPOST A 10 mpost A 10 1 Synopsis mpost alias app aux directory dir bistack size n buf size n c style errors disable installer enable installer error line n font mem size n half error line n halt on error help hhelp include directory dir initialize
5. section This option is most commonly used with the i option see its description above for more information t papertype T u Vx Z Zx Set the paper type to papertype usually defined in one of the configuration files along with the appropriate PostScript code to select it You can also specify a papertype Of landscape which rotates a document by 90 degrees To rotate a document whose paper type is not the default you can use the t option twice once for the paper type and once for landscape hsize usize Set the paper size to hsize vsize a comma separated pair of dimensions such as 1in 3cm It overrides any paper size special in the DVI file name Examine name for PostScript font aliases Default is psfonts map This option allows you to specify different resident fonts that different printers may have If name starts with a character then the rest of the name after any leading spaces is used as an additional map file Disable a PostScript virtual memory saving optimization that stores the character metric informa tion in the same string that is used to store the bitmap information This is only necessary when driving the Xerox 4045 PostScript interpreter which has a bug that puts garbage on the bottom of each character Not recommended unless you must drive this printer Download non resident PostScript fonts as bitmaps This requires use of makepk to generate the required bitmap fonts The bitmap mus
6. By default no characters are translated and character codes between 32 and 126 inclusive decimal are printable It is not possible to make these or any characters unprintable Specifying translations for the printable ASCII characters codes 32 127 will yield unpredictable re sults Additionally you shouldn t make the following characters printable I TAB J line feed M carriage return and delete since TEX uses them in various ways Thus the idea is to specify the input keyboard character code for src and the output font character code for dest 4 3 texify The MiKT X Compiler Driver texify is a command line utility that simplifies the creation of DVI PDF documents texify automatically runs TEX pdflATEX Makelndex and BibTEX as many times as necessary to produce a DVI PDF file with sorted indices and all cross references resolved To run texify on an input file foo tex do this 44 CHAPTER 4 USING MIKTEX 4 4 MTPRINT THE MIKTEX PRINT UTILITY texify foo tex As shown in the example above the input file names to texify must include any extension tex 1tx s There are several command line options you can use to control texify see Section A 15 Here are some examples texify clean foo tex All auxiliary files will be removed i e only the output foo dvi file will be left in the current folder texify tex opt src foo tex Passes the option src to the TEX compiler texif
7. C Downdoads MiKTax 2 2 Downloaded packages will be stored in the local package repository a directory on your computer Later you will run the wizard again to install MiKTEX from here Click Next gt to go to the next page 7 Review the download settings CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTIONS MiKTeX Setup Wizard 2 2 7 Setup Information Review tre setup settings METER Setup wizard has information lo start the installation lf pou wart bo review or change any of the settings click Back If pou are satisfied with the settings click Mest to shart the installation SergE Download completa package set trom fpi unae ac at packages ten seston wine mi het package to E Aiowroadit MET e 2 2 Click lt Back if you want to change the settings Click Next gt to start the download process 8 Two progress bars indicate the progress of the download operation MiKTeX Setup Wizard 2 2 7 Mik TeX Packoge Download MET Setup Wizard wil now download the selected packages to a local package reposo a ted Overall progress ET 2 hours 0 minutes md plob kdd co pC AR system dar mike imi packages symbols cab 1 200809 bytes pleb kdd ca pACTAN system wen d2mikbensimpackageskliecmklecbineab 1193941 b Pleb kdd co CAN spstenme radares tm packagesnicelame cab 60016 bytes plab kdd co p CTAN sustentan 2 mkhan imi packages pihonts cab 1415574 bytes z 4 Click Next gt
8. MiKTeX Tips Tips for MiKTEX users MiKTeX MiKTeX on the Web Known Issues An Internet shortcut to the latest release notes MiKTeX MiKTeX on the Web MiKTeX Project Page An Internet shortcut to the project page MiKTeX MiKTeX on the Web Registration An Internet shortcut to the registration form MiKTeX DVI Viewer A shortcut to the DVI file viewer MiKTeX MiKTeX Options A shortcut to the configuration utility MiKTeX MiKTeX Package Manager A shortcut to the package manager MiKTeX MiKTeX Update Wizard A shortcut to the update wizard 2 4 The TEXMF Directory Hierarchy A TEXMF directory is the root of a TDS compliant directory structure as described in A Directory Structure for TeX Files run texdoc tds to view this document A standard MiKTEX system is composed of two TEXMF directories STDS TeX directory structure 25 CHAPTER 2 INSTALLING MIKTgX 2 5 REMOVING MIKTEX e The installation directory contains the installed files of the MiKT X distribution e The local TEXMF directory contains files that were created during the use of the MiKTEX programs You can declare additional TEXMF directories if the need arises For example you can incorporate the TEXMF directory of another TEX system such as Tex Live Or you can create a personal TEXMF directory say C MyTeXMF which serves as a repository for your own TeX related files See Section 3 3 for more informat
9. Page comments when left in often cause difficulties Use of this flag can cause other graphics to fail however since the PostScript header macros from some software packages read portion the input stream line by line searching for a particular comment 51 APPENDIX A MANUAL PAGES A 3 DVIPS 1 num The last page printed will be the first one numbered num Default is the last page in the document If num is prefixed by an equals sign then it and the argument to the p option if specified is treated as a physical absolute page number rather than a value to compare with the TEX count0 values stored in the DVI file Thus using 1 9 will end with the ninth page of the document no matter what the pages are actually numbered m Specify manual feed if supported by the output device M Turns off automatic font generation n num Print at most num pages Default is 100000 N Turns off generation of structured comments such as Page this may be necessary on some systems that try to interpret PostScript comments in weird ways or on some PostScript printers Beware This also disables page movement etc in PostScript viewers such as GSview O name Send output to the file name If o is specified without name the default is fzle ps where the input DVI file was file dvi If o isn t given at all the configuration file default is used If name is output goes to standard output If the first character of
10. interaction mode job name name job time filename lig table size n max print line n max strings n mem max n mem min n mem top n output directory dir param size n path size n pool size n quiet record package usages file recorder stack size n string vacancies n tcx tcaname terminal oem tex texprogram time statistics trace options undump name version command file A 10 2 Description METAPOST installed as mpost reads a series of pictures specified in the METAPOST programming language and outputs corresponding PostScript code A 10 3 Options alias app Pretend to be app This affects both the format used and the search paths aux directory dir Keep auxiliary files in dir This implies include directory dir bistack size n Set the internal compiler variable bistack_size to n bistack_size is the size of the stack for bisection algorithms buf size n Set the internal compiler variable buf_size to n buf_size is the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname c style errors Show C C style error messages This switch implies scrollmode disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable installer Enable automatic installation o
11. 3 2 2 2 Searching Packages o e e e 3 2 3 Automatic Package Installation o 0 o 3 3 Managing TEXMF Directory Hierarchies 0 o e 3 3 1 Using Additional TEXMF Directories o e e 3 3 2 Changing the Search Order o o 3 4 Refreshing the File Name Database e e a 3 5 Managing Format Files 0 e 3 5 1 Refreshing Format Files lt lt o e es 3 5 2 Defining New Format Files 2 e e e 3 6 Regional SettidgS o 3 0 1 Paper Size is iodo e a TE a ae eS 3 6 2 Selecting Hyphenation Tables o ee 3 EQMINGMmiktex Iais id da A ee A AA era ak 3 8 Configuring Dvipdfm 2 2 ee 3 9 Configuring DVIPS se ss s easa aa aaa a a aa e a a E a a a a A a a a E 3 10 Configuring pdfTEX 2 3 11 QU INEAFON S 2 22 o oe ere awe ee BAe ee ee ere ek eke pee a ee 3 11 1 Adding updmap cfg Instructions 0 o eee ee ee CONTENTS 4 Using MiKT X 40 4 1 Getting Started ee 40 4 2 TEX amp Friends Specialities o ooo 0000000020000 40 4 2 1 Automatic Package Installation o ooo e 40 4 2 2 Finding out Package Usages o e ee 40 4 2 3 Suppressing Screen Output o e e 41 4 2 4 Setting the Name of the Output File
12. ISBN 0 201 52983 1 A 2 dvicopy A 2 1 Synopsis dvicopy alias app disable installer enable installer help hhelp include directory dir mag mag max pages n page start page spec record package usages file select range trace traceflags version indui outdut A 2 2 Description dvicopy reads a DVI file expands any references to virtual fonts to base fonts and writes the resulting DVI file Thus you can use virtual fonts even if your DVI processor does not support them by passing the documents through dvicopy first A 2 3 Options alias app Pretend to be app This affects both the format used and the search paths disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 help Give help and exit hhelp Show the manual page in an HTML Help window and exit when the window is closed include directory dir Prepend dir to the search path mag mag Override existing magnification with mag max pages n Process n pages default one million This option cannot be used together with select page start page spec Start at page spec for example 2 or 5 2 This option cannot be used together with selec
13. Set the internal compiler variable pool_size to n pool_size is the maximum number of charac ters in strings including all error messages and help texts and the names of all fonts and control sequences must exceed string_vacancies by the total length of the program s own strings which is currently about 30000 quiet Suppress all output except errors record package usages f1le Record all package usages and write them into file recorder Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension f1s save size n Set the internal compiler variable save_size to n save_size is the amount of space for saving values outside of current group src specials Embed source file information source specials in the DVI file stack size n Set the internal compiler variable stack_size to n stack_size is the maximum number of simultaneous input sources string vacancies n Set the internal compiler variable string_vacancies to n string_vacancies is the minimum number of characters that should be available for the user s control sequences and font names after the compiler s own error messages are stored time statistics Show processing time statistics trace traceflags Write trace messages into the DebugView window The traceflags argument is a comma separated list of trace categories access Accesses to disk files config Retrieval of configuration sett
14. 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTIONS MiKTeX Setup Wizard 2 2 7 Local TEXMF Tree Tou can serve a boder mes fos local additions You can cause MiETex lo depasi newly crested Mes a g bimap fonts in a separate folder trae This folder trae i called the Local TESMF Tree If pou decide to create such a ber hen pou musi choose a locaton hor ibs root folder erat folder wil be the pont of thee local TESMF tree ou can enter a naw pal Path to root falder Cocalteort Ne local TEXMPF Iree rol recommended The local TEXMF directory is mainly used for files that are created during run time Click Next gt to go to the next page 11 Choose if you want to incorporate additional TEXMF directories MiKTeX Setup Wizard 2 2 7 Additonal TEAMF Folder Trees Tou can incoporate existing TESMF folder tees ou Can incorpatate axcling TESMF folder lees Le you can make use of Tex related packager thal are already installed in pou network neighbourhood lf pou are unsure usa the default configuration You can incorporaba esicting folder bess later via the ME Tes Options shortcut O Dont incorporate ening TEXMF folder trees now O Incarporate mashing TEXMF folder bees You can safely defer the decision TEXMF trees can be configured later with the help of MiKTEX Options Click Next gt to go to the next page 12 Review the setup settings 21 CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTR
15. 2001 04 21 v1 4e Standard LaTeX document class D texmf tex latex base size10 clo No file foo aux D texmf tex latex base omscmr fd 1 2 3 foo aux Output written on foo dvi 3 pages 7256 bytes Transcript written on foo log gt Note the altered output file names foo aux foo dvi and foo log 41 CHAPTER 4 USING MIKTEX 4 2 TEX amp FRIENDS SPECIALITIES 4 2 5 Auto insertion of Source Specials 4 2 5 1 What Are Source Specials Source specials are pieces of information embedded in a DVI file They make a connection between the source file location e g line 100 in foo tex and the DVI location e g page 2 in foo dvi Source specials can improve the edit compile view edit cycle 1 You edit the source file with a TEX editor 2 You compile the source file 3 You execute a special editor command to open the previewer Yap going directly to the page that corresponds to the cursor location in your editor window 4 You navigate through the viewed document 5 You double click somewhere inside the viewed document this causes Yap to bring the editor win dow back to the front moving the text cursor directly to the line that corresponds to the view location 4 2 5 2 How to Insert Source Specials The TEX compiler option src specials directs TEX to insert source specials into the DVI file You would say latex src specials foo tex to create the DVI file foo dvi with embedded
16. MiKT X 3 1 Installing Updates You can use MiKTEX Update Wizard to download and install the latest MiKTEX updates 3 1 1 How It Works 1 MiKTEX Update Wizard contacts a remote package repository and retrieves the updated package database 2 The time stamps of local packages and remote packages are compared If a remote package is newer than the corresponding local package than that package is added to the update list 3 MiKTEX Update Wizard goes through the update list and updates the packages 3 1 2 Running MiKTEX Update Wizard 1 Click Start Programs MiKTeX MiKTeX Update Wizard 2 The wizard starts and you are presented with the welcome page 27 CHAPTER 3 CONFIGURING MIKTEX 3 1 INSTALLING UPDATES MiKTeX Update Wizard 2 4 1704 Welcome to the MiKTeX Update Wizard This wizard peshorme thee folloeang tacks Search for updaled packager List available updates Update selected packages Click Next bo contra Click Next gt to continue 3 The wizard asks you to choose a download source MiKTeX Update Wizard 27 4 7 704 Download Type Spe the download tyme Where do pou wart bo gel packages Irom Choose this f pou want bo update packages iom lhe intemmet O Local folder Choose this you want bo update packages Irom a local package repostory O METex CD Choose this F you want bo install updates from a MIET e CO Back Hext gt Ji Cancel Choose In
17. MiKTEX Package Manager MPM to install and remove packages 3 2 1 What Is a Package A package is a collection of files that together implement a specific feature 3 2 2 Working With the Package Manager The package manager can be run in two modes batch and windowed MPM runs in batch mode if you specify command line options such as install and update see Section A 9 for a list of available command line options To start the package manager in windowed mode click Start Programs MiKTeX MiKTeX Package Manager You will see a window similar to this S MiKTeX Package Manager 7 4 1667 Fie Edt view Tesk Repository Help 1 Hame Keywords Filename Name Cabegory Packaged on Instaledon Tie k mar icstegorzed 2004 11 11 alposter FormatsiLaTexilLaTe com 2004 11 11 Provides Fonts in sizes of 12pt up bo sastez FormatsilaTexXiLaTes con 2004 11 11 American Astronomical Society Porra abstract iFormatelLaTeXiLaTex com 2004 11 11 Control the typesetting of the abstr abstyles icetegorzed 2004 11 11 acchonts Wncabegorized 2004 11 11 Fork manipulation utilities mkt fom achemso PormatsilaTexXiLaTe2 con 2004 11 11 LaTex and BibTex style For Americar arc cin iFormatelLaTeXiLaTex com 2004 11 11 Association for Computing Machinen acmirans incabegorzed 2004 11 11 atrangi FormateiLaTexiLaves com 2004 11 11 Expand acrormms at Best once adfathesis PormatsilaTexiLaTex con 2004 11 11 adobeather Ponta
18. and more time to display or print In most cases the optimal value is 2 This parameter does fem not influence the precision of numbers used in raw PDF code like that used in pdfliteral and annotation action specifications horigin amp vorigin These dimension parameters can be used to set the offset of the TEX output box from the top left corner of the paper image_resolution When pdf TEX is not able to determine the natural dimensions of an image it assumes a resolution of type 72 dots per inch Use this variable to change this default value move_chars Although PDF output is claimed to be portable especially when all font information is included in the file problems with printing and viewing have a persistent nature Moving the characters in range 0 31 sometimes helps a lot When set to 1 characters are only moved when a font has less than 128 glyphs when set to 2 higher slots are used too output_format This integer parameter specifies whether the output format should be DVI or PDF A positive value means PDF output otherwise we get DVI output page_width amp page_height These two dimension parameters specify the output medium dimensions the paper screen or whatever the page is put on If they are not specified these values are calculated pdf_minorversion Sets the PDF version of the generated file and the latest allowed PDF version of included PDFs The value 3 tells pdfTpX to set the PDF version to 1 3 and allows
19. at most 1073741823 stack_size n Maximum number of simultaneous input sources string_vacancies n The minimum number of characters that should be available for the user s control sequences and font names after TEX s own error messages are stored trie_op_size n Space for opcodes in the hyphenation patterns trie_size n Space for hyphenation patterns should be larger for initex than it is in production versions of TEX B 2 11 Omega Input Dirs searchpath The search path for Q input files OCPPath searchpath Where Q searches for OCP files B 2 12 otp2ocp Input Dirs searchpath Used by OTP2OCP to locate otp files 90 APPENDIX B MIKTEX INI THE MIKTEX B 2 MIKTEX INI SETTINGS B 2 13 pdfeTeX Input Dirs searchpath Where pdf e TEX searches for input files PSPath searchpathsearchpath Where pdf e TEX searches for font mapping files map and font encoding files enc B 2 14 pdfTeX dest_names_size n Maximum number of names in name tree of PDF output file Input Dirs searchpath Where pdf T X searches for input files obj_tab_size n Minimum size of the cross reference table for PDF output PSPath searchpath Where pdfTEX searches for font mapping files map and font encoding files enc B 2 15 TeX Editor command The command to be started when the user presses e in the error menu command may contain the following placeholders Will be replaced by the name of
20. be at least 60 max strings n Set the internal compiler variable max_strings to n max_strings is the maximum number of strings mem bot n Set the internal compiler variable mem_bot to n mem_bot is the smallest index in the internal memory array dumped by the N variant of the com piler must not be less than mem_min mem max n Set the internal compiler variable mem_max to n mem_max is the greatest index in the internal memory array mem min n Set the internal compiler variable mem_min to n mem_min is the smallest index in the internal memory array must be 0 or more must be equal to mem_bot in the N variant of the compiler otherwise less than or equal to mem_bot mem top n Set the internal compiler variable mem_top to n mem_top Is the largest index in the internal memory array dumped by the INI variant of the compiler must be substantially larger than 0 and not greater than mem_max nest size n Set the internal compiler variable nest_size to n nest_size is the maximum number of semantic levels simultaneously active output directory dir Create output files in dir This implies include directory dir param size n Set the internal compiler variable param_size to n param_size is the maximum number of simul taneous macro parameters pool size n Set the internal compiler variable pool_size to n pool_size is the maximum number of charac ters in strings including all error messages and help texts a
21. bistack size n Set the internal compiler variable bistack_size to n bistack_size is the size of the stack for bisection algorithms buf size n Set the internal compiler variable buf_size to n buf_size is the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname c style errors Show C C style error messages This switch implies scrollmode disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 error line n Set the internal compiler variable error_line to n error_line is the width of context lines on terminal error messages half error line n Set the internal compiler variable half_error_line to n half_error_line is the width of first lines of contexts in terminal error messages halt on error Quit after the first error help Give help and exit hhelp Show the manual page in an HTML Help window and exit when the window is closed include directory dir Prepend dir to the search path initialize Become the NI variant of the compiler interaction mode Set the interaction mode Must be one of batchmode nonstopmode scrollmode an
22. change the editor used It may contain a string with 7f indicating where the file name goes and 1 indicating where the decimal line number if any goes See Section B 2 15 for more information A convenient file is nul1 tex containing nothing When TEX can t find a file it thinks you want to input it keeps asking you for another file name responding nul11 gets you out of the loop if you don t want to input anything You can also type your EOF character usually Control Z A 14 3 Options alias app Pretend to be app This affects both the format used and the search paths aux directory dir Keep auxiliary files in dir This implies include directory dir buf size n Set the internal compiler variable buf_size to n buf_size is the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname c style errors Show C C style error messages This switch implies scrollmode enable write18 Enable the write18 construct see Section 4 2 10 error line n Set the internal compiler variable error_line to n error_line is the width of context lines on terminal error messages font max n Set the internal compiler variable font _max to n font_max is the maximum internal font number must not exceed 5000 half error line n Set the internal compiler variable half_error_line to n half_error_line is the width of first lines of contexts in
23. dump all format files or dump the specified format file list modes List all known METAFONT modes local root dir Set the location of the local TEXMF directory mklinks Create an executable for each known format mkmaps Create the file psfonts map See Section 3 11 for more information print only n Print what would be done Nothing is changed quiet q Suppress screen output report Write a MiKTEX configuration report root directories dirs rdirs Specify the locations of all TEXMF root directories update fndb u Refresh the whole file name database update fndb dir udir Refresh the file name database for a specific TEXMF tree update miktex Start MiKTEX Update Wizard verbose v Print information on what is being done version V Print the version number and exit A B mf A 8 1 Synopsis mf alias app aux directory dir bistack size n buf size n c style errors disable installer enable installer error line n half error line n halt on error help hhelp include directory dir initialize interaction mode job name name job time file lig table size n max print line n max strings n max wiggle n mem max n mem min n mem top n move size n output directory folder param size n path size n pool size n quiet record package usages file recorder screen string vacancies n tcx file terminal oe
24. files ttc ttf type1 fonts Type 1 font files pfa pfb v Virtual font files vf 59 APPENDIX A MANUAL PAGES A 6 GFTODVI A 6 gftodvi A 6 1 Synopsis gftodvi alias app disable installer enable installer gray font font help hhelp include directory dir label font font logo font font overflow label offset real record package usages file slant font font title font font trace traceflags version gffile A 6 2 Description The gftodvi program converts a generic font GF file output by for example METAFONT to a device independent DVI file that can then be typeset using the same software that has already been written for The characters in the GF file will appear one per page with labels titles and annotations as specified in Appendix H Hardcopy Proofs of The METAFONTbook gftodvi uses other fonts in addition to the main GF file A gray font is used to typeset the pixels that actually make up the character We wouldn t want all the pixels to be simply black since then labels key points and other information would be lost A title font is used for the information at the top of the page A label font is used for the labels on key points of the figure A slant font is used to typeset diagonal lines which otherwise have to be simulated using horizontal and vertical rules The default gray title and label fonts are gray cmr8 and cmtt
25. glyph has significant left or right side bearings Nonethe less this option works well enough for creating small EPSF files for equations or tables or the like Of course dvips output especially when using bitmap fonts is resolution dependent and thus does not make very good EPSF files especially if the images are to be scaled use these EPSF files with care For multiple page input files also specify i to get each page as a separate EPSF file otherwise all the pages are overlaid in the single output file Read the DVI file from standard input and write the PostScript to standard output The standard input must be seekable so it cannot be a pipe If your input must be a pipe write a shell script that copies the pipe output to a temporary file and then points dvips at this file It turns off the automatic sending of control D if it was turned on with the F option or in the configuration file use F after the f to send it anyway Write control D ASCII code 4 as the very last character of the PostScript file This is useful when dvips is driving the printer directly instead of working through a spooler as is common on personal systems On systems shared by more than one person this is not recommended Shift low chars to higher pos 50 APPENDIX A MANUAL PAGES A 3 DVIPS h name ix Prepend name as an additional header file or if name is suppress all header files Any definitions in the header file get added to
26. has the syntax fromext toext commandline fromezxt is the file name extension of the source file toext is the file name extension of the destina tion file commandline is the command plus arguments which does the conversion The command line may include the following placeholders 71 The name of the input file o The name of the output file The standard MiKTEX configuration file contains the following standard rules gif bmp giftopnm i ppmtobmp windows gt Zo pcx bmp pcxtoppm i ppmtobmp windows gt o png bmp pngtopnm i ppmtobmp windows gt Zo tga bmp tgatoppm i ppmtobmp windows gt o tif bmp tifftopnm i ppmtobmp windows gt Zo tiff bmp tifftopnm i ppmtobmp windows gt Zo B 2 5 Makelndex INDEXSTYLE searchpath Search path for Makelndex style files ist B 2 6 MakePK DestDir path Specifies the directory which receives newly created PK Packed Raster Font files The specification may include special control sequences which will be replaced at run time m The METAFONT mode a The horizontal resolution in dots per inch s The font supplier t The typeface name B 2 7 MakeTFM DestDir path Specifies the directory which receives newly TFM TeX Font Metrics files The specification may include special control sequences which will be replaced at run time 87 APPENDIX B MIKTEX INI THE MIKTEX B 2 MIKTEX INI SETTINGS s
27. mf 63 network installation 25 NTS project 54 Outline fonts psfonts map 38 output file name changing the 41 package 31 defined 31 package management 31 package sets 11 packages automatic installation of 32 finding out usages 40 installing 31 searching for 32 updating 27 paper size changing 36 38 94 default 36 PDF distilling into 53 viewing 8 pdfLaTeX invoked by texify 44 Perl getting 8 PostScript converting TeX output into 49 PostScript Type 1 fonts psfonts map 38 project page 9 psfonts map 53 creating 38 62 quoted file names 42 registration 9 Remove MiKTeX Wizard 26 screen output suppressing 41 search paths defined 85 security 43 53 setup wizard command line options 24 log file 24 running 16 setupwiz opt 24 troubleshooting 23 unattended mode 24 setupwiz opt 24 shared MiKTeX system 19 shared network installation 25 Small MiKTeX 12 source specials defined 42 inserting 42 start menu 25 support 9 email 9 system components required 11 T1 encoding and ISO input 44 TCX character translation files 43 TDS TeX directory structure 26 TeX job name changing the 41 texdoc 10 46 texify 44 TEXMF directories additional additional 21 changing search order 33 managing 32 specifying 62 using additional 26 33 TEXMF directory defined 25 TeXnicCenter getting 9 unattended setup 24 uninstaller 26 update wizard running 27 update
28. min n mem top n nest size n output directory folder param size n pool size n quiet record package usages file recorder save size n src specials stack size n string vacancies n tcx tcaname terminal oem 75 APPENDIX A MANUAL PAGES A 13 PDFTEX time statistics trace traceflags trie op size n trie size n undump fmtname version command file A 13 2 Options alias app Pretend to be app This affects both the format used and the search paths aux directory dir Keep auxiliary files in dir This implies include directory dir buf size n Set the internal compiler variable buf_size to n buf_size is the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname c style errors Show C C style error messages This switch implies scrollmode disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable write18 Enable the write18 construct see Section 4 2 10 error line n Set the internal compiler variable error_line to n error_line is the width of context lines on terminal error me
29. n max_strings is the maximum number of strings 55 APPENDIX A MANUAL PAGES A 4 ETEX mem bot n Set the internal compiler variable mem_bot to n mem_bot is the smallest index in the internal memory array dumped by the N variant of the com piler must not be less than mem_min mem max n Set the internal compiler variable mem_max to n mem_max is the greatest index in the internal memory array mem min n Set the internal compiler variable mem_min to n mem_min is the smallest index in the internal memory array must be 0 or more must be equal to mem_bot in the NI variant of the compiler otherwise less than or equal to mem_bot mem top n Set the internal compiler variable mem_top to n mem_top Is the largest index in the internal memory array dumped by the INI variant of the compiler must be substantially larger than 0 and not greater than mem_max nest size n Set the internal compiler variable nest_size to n nest_size is the maximum number of semantic levels simultaneously active output directory dir Create output files in dir This implies include directory dir param size n Set the internal compiler variable param_size to n param_size is the maximum number of simul taneous macro parameters pool size n Set the internal compiler variable pool_size to n pool_size is the maximum number of charac ters in strings including all error messages and help texts and the names of all fonts and contr
30. package rmeponbaiy Install MET ex roam a local package repository Click Next gt to go to the next page 5 Click on the package set you wish to install CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTIONS MiKTeX Setup Wizard 2 2 7 Package Sect Choose a package sal Small Download aze 23 ME Ses ondek 100MB A small set of packages Tex recommended LaTe packages pd Tex Typel lanis Large Dowrload ace 5d ME Site on disk 100 ME The add Omega eTe ond advanced macso packages be ConT ef Dewrlazd me 143 MB Sire on dek 500MB All avaiable packages lt Back IL news Cancel l NOTE The selected package set must match the downloaded package set e g Q you cannot install the large package set when you have downloaded the small package set Click Next gt to go to the next page 6 Choose if you want to set up a shared MiKTEX system or if you want to use MiKTEX privately CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTIONS MiKTeX Setup Wizard 2 2 7 Shared va Private Installation Tou can grant other users access bo the Mi Te programe Selup Wizard can incall a shared MK Tes ermionment so that other user on this computar can access the WIET e programs C Inetall a private MIT environment lt Back Lew gt Cancel l Click Next gt to go to the next page 7 Specify the location of the local package repository MiKTeX Setup Wizard 2
31. program was called ora 7 8 line version Show version information and exit A 14 4 Aliases initex Equivalent to tex ini virtex Equivalent to tex A 14 5 See Also See Section A 15 for an alternative way to invoke TEX A 14 6 Documentation The TeXbook ISBN 0 201 13448 9 A 15 texify A 15 1 Synopsis texify batch b clean c expand e 1 dir help h language lang 1 lang max iterations n mkidx option option pdf p quiet q silent s run viewer src texinfo cmd t cmd tex option option version v verbose V viewer option option filers A 15 2 Description texify runs Texinfo or ATEX input files through tex pdftex in turn until all cross references are resolved building all indices The directory containing each file is searched for included files The suffix of fi leis used to determine its language ATEX or Texinfo makeinfo is used to perform Texinfo macro expansion before running tex when needed A 15 3 Options Use input instead of input for preloaded Texinfo batch b No interaction 83 APPENDIX A MANUAL PAGES A 15 TEXIFY clean c Remove all auxiliary files expand e Force macro expansion using makeinfo I dir Search dir for input files help h Display help and exit successfully language lang 1 lang Specify the language of input files either latex or texinfo ma
32. sample2e tex gt This ensures that all output files oo dvi foo log will be created in C texoutput 4 2 9 Specifying the Directory for Auxiliary Files The option aux directory dir causes TEX to create auxiliary files in another directory For example gt mkdir C texoutput gt mkdir C tobedeleted gt latex output directory C texoutput aux directory C tobedeleted foo tex gt This ensures that 1 foo dvi will be created in C texoutput and 2 all other files foo log will be created in C tobedeleted 4 2 10 Running Programs From Within Tex TEX handles output stream 18 in a special way the token list is interpreted as a command line If the write18 feature is enabled see below then write18 toklist starts the command interpreter usually cmd com to carry out the command specified by toklist For example write18 dir lists the files and sub directories of the current directory TEX ignores write18 by default for security reasons You enable the feature by using the TEX compiler option enable write18 4 2 11 TCX Files Character Translations This section is borrowed from the Web2C manual TCX TEX character translation files help TEX support direct input of 8 bit international characters if fonts containing those characters are being used Specifically they map an input keyboard character code to the internal TEX character code a superset of ASCII Of the various prop
33. the file updmap cfg This configuration file contains declarative instructions see Appendix D which will be used to build psfonts map 3 11 1 Adding updmap cfg Instructions You must edit a local version of updmap cfg if you want to add instructions e g add new map files entries 38 CHAPTER 3 CONFIGURING MIKTEX 3 11 OUTLINE FONTS Instructions in the local version of updmap cfg take precedence over those specified in the main version i e you can easily override options such as dvipsPrefer0utline For example follow these steps if you want to add an entry for the map file xyz map 1 Use the Explorer interface to open the directory miktex conf ig relative to the local TEXMF direc tory see Section 2 4 2 Create a local version of updmap cfg if it doesn t yet exist use the Explorer interface to create a new text document with the name of updmap cfg 3 Open updmap cfg with Notepad Insert the following line Map xyz map Save the file and exit Notepad Refresh the file name database see Section 3 4 Run initexmf mkmaps to rebuild psfonts map 39 Chapter 4 Using MiK TeX 4 1 Getting Started If you have never used TEX before we recommend that first of all you work through a TEX IATEX tu torial A good starting point is this this entry in the UK TEX FAQ lt http www tex ac uk cgi bin texfaq2html label tutorials gt MiKTEX doesn t differ very much from any ot
34. the input file that caused the error h Will be replaced by a help text 1 Will be replaced by the line number m Will be replaced by the error message t Will be replaced by the name of the transcript file For example a suitable value for WinEdt would be winedt f G 1 1 0 S 12 1 0 Input Dirs searchpath Used by TeX to locate input files InputEnvVar envvar The name of the environment variable which contains additional input directories write18 val Status of write18 primitive val must be on of disable enable B 2 16 ttf2pk ENCPath searchpath Used by TTF2PK to locate font encoding files enc 91 APPENDIX B MIKTEX INI THE MIKTEX B 2 MIKTEX INI SETTINGS B 2 17 ttf2tfm ENCPath searchpath Used by TTF2TFM to locate font encoding files enc B 2 18 Yap Input Dirs searchpath Used by Yap to locate DVI files dvi 92 Appendix C pdftex cfg The pdf TEX Configuration File pdf T X configurations settings are read from the file pdftex cfg when the pdfTFX format file is being created CAUTION O It is highly recommended that you edit a local version of pdftex cfg when chang ing configuration settings See Section 3 10 for more information C 1 pdftex cfg Settings This section is borrowed from the pdfTpX manual A typical pdftex cfg file looks like this setting up output for A4 paper size and the standard TeX offset of 1 inch c
35. the internal compiler variable max print line to n max print line is the width of longest text lines output should be at least 60 max strings n Set the internal compiler variable max_strings to n max_strings is the maximum number of strings mem max n Set the internal compiler variable mem_max to n mem_max is the greatest index in the internal memory array mem min n Set the internal compiler variable mem_min to n mem_min is the smallest index in the internal memory array must be O or more must be equal to mem_bot in the NI variant of the compiler otherwise less than or equal to mem_bot mem top n Set the internal compiler variable mem_top to n mem_top Is the largest index in the internal memory array dumped by the INI variant of the compiler must be substantially larger than 0 and not greater than mem_max output directory dir Create output files in dir This implies include directory dir param size n Set the internal compiler variable param_size to n param_size is the maximum number of simul taneous macro parameters path size n Set the internal compiler variable path_size to n path_size is the maximum number of knots between breakpoints of a path pool size n Set the internal compiler variable pool_size to n pool_size is the maximum number of charac ters in strings including all error messages and help texts and the names of all fonts and control 69 APPENDIX A MANUAL PAGES A 10 MPOST
36. when the download is complete 9 You will see the final wizard page CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTIONS MiKTeX Setup Wizard 2 2 7 Completing the MiKTeX Setup Wizard You hare zucesfuly completed the ME Tes Setup Wizard The packages pou chose have beer copied bo a local package reposton ou can matal Mi Te by nana this wierd agar To eat the wizard chek Fires Click Finish to close the wizard 2 1 4 Installing MiKT X You install MiKTEX with the help of MiKTEX Setup Wizard 1 Download the latest version of the wizard from the SourceForge net download server lt http sourceforge net project showfiles php group_id 10783 gt 2 Login as Administrator if you want to set up a shared MiKTEX system 3 Start the wizard setup exe You will be presented with the welcome page 4chttp sourceforge net project showfiles php group_id 10783 gt CHAPTER 2 INSTALLING MIKTgX 2 1 INSTALLATION INSTRUCTIONS MiKTeX Setup Wizard 2 2 7 Welcome to the MiKTeX Setup Wizard This wizard instale ME Tex on pour computer ME Te is a hee Te disbibubon for Windows To continue vah Setup cick Mari Click Next gt to go to the next page 4 Click on the Install radio button MiKTeX Setup Wizard 2 2 7 Setup Task Choose the primary task METE Setup Wizard i lo cay out Cheace ore of the follawing setup tacks Download oly Downoad regured MIKT ex packages lo a local
37. 10 respectively there is no default slant font To change the default fonts you can give special commands in your source file or you can change the fonts on the command line The GF file name on the command line must be complete The program prompts you for it if you don t give it Because the resolution is part of the extension it would not make sense to append a default extension as is done with other DVI reading software The output file name defaults to the same root as the GF file with the dvi extension added For example the input file cmr10 2602gf would become cmr10 dvi A 6 3 Options alias app Pretend to be app This affects both the format used and the search paths disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 gray font font Sets the gray font Default is gray help Give help and exit hhelp Show the manual page in an HTML Help window and exit when the window is closed include directory dir Prepend dir to the search path label font font Sets the label font Default is cmtt10 logo font font Sets the logo font Default is logos 60 APPENDIX A MANUAL PAGES A 7 INIT
38. 2 7 Local Package Repository Select the local package repository MiK Tes Setup wizard will use the following folder to install MET e from To lcd a different fode click Browse Path to local package reposibay C Downloade MiKTeax 2 2 MiKTEX will be installed from a local package repository which mirrors the contents or parts of it of a remote package repository You have created the local package repository during the download stage Click Next gt to go to the next page 8 Accept the suggested installation directory or enter your own choice CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTIONS MiKTeX Setup Wizard 2 2 7 Installation Folder Choose a location for the installation folder MET es wil be metalled m the bolang folder You carentes a new path Path lo installation folder E Mean Back tie Cancel l The installation directory is the root of the main TEXMF directory hierarchy Click Next gt to go to the next page 9 Accept the suggested program folder name or enter your own choice MiKTeX Setup Wizard 2 2 7 Program Folder Tou can specify he name of the Program Folder MET es Setup Wizard wil add shortculs to lhe program folder lected below Tou may anbar a res nama Program folder nanma Back tie Cancel Click Next gt to go to the next page 10 Accept the suggested path to the local TEXMF directory or enter your own choice 20 CHAPTER
39. 3 76 80 file type filetype 58 font max n 55 76 80 font mem size n 55 68 76 gray font font 60 half error n 55 64 68 73 76 80 halt on error 55 64 69 73 76 80 help 47 48 55 58 60 64 67 69 73 76 80 hhelp 47 48 55 60 64 67 69 73 76 include directory dir 42 47 48 55 60 64 69 73 76 81 initialize 55 64 69 73 76 81 interaction mode 55 64 69 73 76 81 job name name 41 55 64 69 73 77 81 job time file 55 64 69 73 77 81 label font font 60 lib table size n 64 69 logo font font 60 mag mag 48 max in open n 55 73 77 81 max iterations n 84 max pages n 48 max print line n 55 65 69 73 77 81 max strings n 55 65 69 73 77 81 max wiggle n 65 mem bot n 56 73 77 81 mem max n 56 65 69 73 77 81 mem min n 56 65 69 73 77 81 mem top n 56 65 69 73 77 81 min crossrefs n 47 move size n 65 must exist 58 nest size n 56 74 77 81 output directory dir 43 56 65 69 74 77 81 overflow label offset real 61 page start page spec 48 param size n 56 65 69 74 77 81 path size n 65 69 pool size n 56 65 69 74 77 81 quiet 41 47 56 65 70 74 77 82 record package usages file 40 47 48 56 61 65 70 74 77 recorder 56 65 70 74 77 save size n 56 74 78 82 screen 65 select sel 48 shell escape 55 72 76 80 show path filetype 5
40. 8 slant font font 61 src 56 74 78 82 src specials 42 56 74 78 82 stack size n 56 65 70 74 78 82 start 58 string vacancies n 56 66 70 74 78 82 tcx name 56 66 70 78 82 terminal oem 57 66 70 78 82 tex texprogram 70 time statistics 57 66 70 74 78 82 title font font 61 trace traceflags 47 49 57 61 66 70 74 78 82 translate file name 56 66 70 78 82 trie op size n 57 75 78 82 trie size n 57 75 78 82 97 INDEX INDEX undump name 57 66 71 75 79 83 version 47 49 57 58 61 66 71 75 79 83 aux auxiliary file 46 bbl 46 bbl bibliography file 46 bib bibliographic database 46 bst bibliography style file 46 dvi DVI file 49 write18 run a program from within TeX 43 55 72 76 80 8 bit characters 43 accented character 43 ActivePerl 8 Adobe Acrobat Reader getting 8 ADOBE fonts 96 automatic package installation 40 auxiliary files removing 45 specifying the directory for 43 bibliography creation 46 BibTeX invoked by texify 44 bidirectional typesetting 54 CD R installing updates 28 obtaining 8 running MiKTeX from the 8 character translation files 43 comctl32 dll 11 Cork encoding and ISO input 44 cross references minimum number required 47 resolving 44 DANTE e V 54 DebugView 23 getting 8 donations 9 DVI search 45 e TeX compatibility mode 54 extended mod
41. AFont Support 2004 11 11 Fart metrics for Adobe narrstandar adroony Uncategorized 2004 11 11 Bibtex address database bo address adrist iFormatslLaTexXiLaTex con 2004 11 11 Leing address lists in LaTeX a iFontsiFont Support 2004 11 11 0046 11 12 virtual fonts for POF fles with Tl en ae quill Language Support French 2004 11 11 Add several hind af guillemets ba th aguplus iFormatsiLatexiLates con 2004 11 11 Styles for American Geophysical Uri E 1 3 2 2 1 Installing Packages You install packages as follows 1 Select all wanted packages in the list view 2 Click on to install the packages For example you want to install the ConT Xt package 1 Locate and select the ConTEXt package in the list view e g type the key sequence CONT 2 You can now click to install the package 31 CHAPTER 3 CONFIGURING MIKTEX 3 3 MANAGING TEXMF DIRECTORY 3 2 2 2 Searching Packages Sometimes you don t know the name of a package but you know the name of a file that belongs to the wanted package In this case enter the file name information in the file name edit control Note that the file name information can include wildcard characters 7 For example you need to download the class file weekly cls 1 Enter weekly cls in the file name edit control 2 Click the Filter button The list view will be reduced to contain only the calendar package Selecting calendar and pressing will install the package 3 2 3 Au
42. AR SYNOPSIS a s oo Ree a a ee ek ee gon BR Ww A 79 A 14 2 DOSCTIDIONM lt c rerea od ee eo et Gad Gi ee eal ala aS 79 AAA 3 ODUONS siii A wee eee hea a eee EER Dy a oes 80 A 14 4 Aliases 20a ee Ree AREA ee ord aa eta eal ee AS 83 A 145 S66 AISO aora s aa aaa E ee a eee ee a as 8 83 A 14 6 Documentation uaa aa Kaaa a A 83 ATOE 2s ate eee eee ele E AA ARA A A A aaa 83 AASA SYNOPSIS wea 2 ems ee eee ee EEE eee Pee ee eS 83 A To DESCUIDO e hara aaie oS ie ee od dnd amp dna en ERE oes ox a er ere 83 A 15 3 OPUONS Ceci ya adai A Me A Ee eee ee eed 83 A 15 4 Environment Variables aoaaa a 84 A155 Allases cicada E ee A a a ee RES BAYS G 84 B miktex ini The MiKTgX Configuration File 85 B 1 AboutSearch Paths s ici aiaa aeia a e e aa ee 85 B 1 1 EXIME ee eee Pa AAA a ET 85 B 1 2 Testing a Search Path e o 86 B 2 miktex iniSettings ee 86 B21 DIDISX Cicas a a a a A er 86 pez Opi Soer ee ee ee ote E E AAA Be eas 86 B 2 3 OMPS nt a AA oe es 86 B24 Grapnies sois o baba A AA a A oes 87 B 2 5 Makelndex rr ee ee ee ee A N A 87 B 2 6 MakePK o 87 B 2 7 Make TFM enc eked tbe ee whe he a A PER eee 87 B 2 8 METAFONT 2244222408464 4888 eae td be eed add TE 88 B 2 9 MetaPost remesas sr obewe oO dad ddd eee Oe Se aes 88 Bi2 10 MIKTeX so eed ha a ee eR Bee ee eee e ee A 88 B 2 10 1 Search Paths 2 2 0 88 B 2 10 2 Memory Settings for TEX amp Fr
43. EXMF overflow label offset real Specifies the distance from the right edge of the character bounding box at which the overflow equations if any are typeset The value is given in points The default is a little over two inches record package usages f1le Record all package usages and write them into file slant font font Sets the slant font There is no default title font font Sets the title font Default is cmrs trace traceflags Write trace messages into the DebugView window separated list of trace categories access Accesses to disk files config Retrieval of configuration settings error Error conditions filesearch File search ndb File name database fontinfo Font information open File openings process Process invocations tempfile Temporary files version Show version information and exit A 6 4 Documentation The METAFONTbook ISBN 0 201 13444 6 A 7 initexmf A 7 1 Synopsis The traceflags argument is a comma initexmf dump dump fmtname help h list modes local root dir mklinks mkmaps print only n quiet q report root directories dirs rdirs update fndb u update fndb dir udir update miktex verbose v version V 61 APPENDIX A MANUAL PAGES A 8 MF A 7 2 Description initexmf is used at the command prompt to configure MiKT X A 7 3 Options dump dump fmtname Either
44. G CONFIGURATION D 1 UPDMAP CFG INSTRUCTIONS URWkb URW fonts with berry file names e g unvbo8ac pfb URWkb is the default value ADOBE Adobe fonts with vendor file names e g hvnbo___ pfb ADOBEkb Adobe fonts with berry file names e g phvbo8an pfb dvipsDownloadBase35 value Specifies whether Dvips downloads the standard 35 LaserWriter fonts with the document If these fonts are not downloaded then they must be available in the PostScript printer interpreter Valid values are true and false default Whatever is specified here the user can override it by specifying dvips Pdownload35 resp dvips Pbuiltin35 to either download the LW35 fonts resp use the build in fonts pdftexDownloadBase14 value Specifies whether pdfT EX downloads the base 14 PDF fonts Valid values are true default and false Since some configurations PostScript PDF tools printers use bad default fonts it is safer to download the fonts The PDF files will get bigger though dvipdfmDownloadBase14 value Specifies whether Dvipdfm downloads the base 14 PDF fonts Valid values are true default and false Since some configurations PostScript PDF tools printers use bad default fonts it is safer to download the fonts The PDF files will get bigger though Map filename Arranges that the contents of filename will be included in psfonts map MixedMap filename Arranges that the contents of file
45. Mik TeX 2 4 Manual Revision 2 4 1779 Christian Schenk November 14 2004 Copyright 2004 Christian Schenk Legal Notice Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one Permission is granted to copy and distribute translations of this manual into another language under the above conditions for modified versions except that this permission notice may be stated in a translation approved by the Free Software Foundation About this Document This is version 2 4 1779 of the MiKTEX manual It corresponds to MiKTEX 2 4 as of November 14 2004 The latest version of this document is available on the MiKTgX Download Page lt http sourceforge net project showfiles php group_id 10783 gt in various formats l lt http sourceforge net project showfiles php group_id 10783 gt 2 Contents 1 2 Introduction 11 About this Mantall ee conan ss a Re ee ea eS Pa See Be See ee 12 About MIK IEX s 22244 2 RL al Ge ER a ae G 1 3 How to Get MIKTEX 2 2 2 ee 1 3 1 Downloading from the CTAN 00000 cee ee 1 3 2 MIKTEXON CD R eg ese cee ee a eee ae He ee ee e
46. ONS MiKTeX Setup Wizard 2 2 7 Remote Package Hepozitorg Select a remote package Pposkona MRT es Setup Wizard val download required packages from a remote package reponlaiy selected below in order to reduce network load i recommended that pou we the remote package repository which e located in the closest neteork pigana bo your site Alkematvwek pou may wish bo obtain a copy of the MET e CD A see hip vauva mikbex ong Avasble package repositones Courty UAL Desciiplior Italy ftp cis uniAomad Tae nn amike CTAN mimar CTAN systeme tanda mikte CTAN fraita dapan fip fip netted ar p pub CTAN sben vna mk CTAN mimar Japan fie ip kenge p pub les arehiwe syelems vinam CTAN mima dapan fip ip azu ac p pubie CTAN syen naar CTAN mimor Japan pA runala sut ec pipub achres elardipysbema w CTAN mirar AW Au ip canine edu ate archvetsucbema tinde mi CTAN miror i ob Pies ro aim ii mi Tihi MiKTEX Setup Wizard will download packages from a remote package repository Choose a repos itory which is located in the closest network proximity to your location Click Next gt to go to the next page 6 Specify the location of the local package repository MiKTeX Setup Wizard 2 2 7 Local Package Aepossbory Select the local package repository MikTe lt Setup Wired val dewikiad required pack ages be the following folder on pour Computer To select a different folder click Browse Path to local package repository
47. Oe ee ees 49 A3 2 DOSCIIPIION sae ce cee ee di ee a ee A eR AA 49 A 393 ODUONS 4 5 4 9 niniin a ER eae a AA eee SS 8S 49 A 3 4 Documentation 244 402 sanaaa aaia ee EE EERE ee be A 54 O APA 54 AAA SYNOPSIS oscila aa a a RA oi 54 A 4 2 DESCTIPUION oo rro a do e eee A ee a 54 BAS OPUONS si a a A AAA e ees 54 AAA Aliases tn a a o ne ir da oe be a ee ad 57 AAS Documentation 00 o A A RR 58 ALS matemi oo a o a AAA AA 58 AL SYNOPSIS y Herria E AA IA eee ee AR 58 AB 2 Description s se 244 02 A a a aa a a a a a a AAA pe e A 58 A 5 3 ODUOMS aa osup gag Pa apse o he e ie ua a da ae amp Dees a ieir 58 ADA File TYPOS sa aa a ae Ba i eke a ee PR A A A 58 AO GNOU 22 3 is eee eee ae E E aa ae Gr ee alae AA ee a eas 60 AGA SYNOPSIS wifes kA Ao ee oe oh ee ee A we S 60 A 6 2 gt DeSCIIPUON ss ss a aoe tence Pe ead doa wa ee Pe ee a 60 AC6 3 ODUONS oi he A wo ee a el ee ee a O 60 A 6 4 Documentation 2 aaa aa 61 O AAA 61 AWA SYNOPSIS ee eee hae eed nea eee ewe dd be RR Oe ec de 61 ALe Dosch gi ues cores Hci cei age ee ae e eh da en eG Gees ee a 62 AS ODPtiOMS y sis e e Ye doe a a ee est haw A 62 AS WM ea rele Gree ie ee eee on ee a ee ae Se ee 62 A81 SYNOPSIS e442 oe aa ed Eee ee EEE Se Pee ee eS 62 A82 DOSCIPUOM e sa eama ee Se Ah de amp RR GRO A es ee ited S 63 A 8 3 Online Graphics Output o ee 63 ABA ODUONS i wie ee BRR a ee OO de a Oa 64 CONTENTS A 8 5 Documentat
48. Section 3 10 3 6 2 Selecting Hyphenation Tables You can control the loading of hyphenation tables with the help of MiKTEX Options 1 Click Start Programs gt MiKTeX MiKTeX Options 2 The MiKTEX Options window opens Click on the Languages tab 3 You will presented with the list of available languages and corresponding hyphenation tables Mark the languages whose hyphenation tables shall be loaded by TEX 3 7 Editing miktex ini The MiKTEX core components read a large part of configuration settings from the file miktex ini see Appendix B You must edit a local version of miktex ini if you have to change MiKTEX configuration settings Settings in the local version of miktex ini take precedence over those specified in the installed version i e you can easily override settings such as TeX Editor For example follow these steps if you want to edit TEX files with WinEdt 1 Use the Explorer interface to open the directory miktex config relative to the local TEXMF direc tory see Section 2 4 2 2 Create a local version of miktex ini if it doesn t yet exist use the Explorer interface to create a new text document with the name of miktex ini 3 Open miktex ini with Notepad 4 Insert change the following lines TeX Editor winedt Open f SelPar 1 7 5 Save the file and exit Notepad 6 Refresh the file name database see Section 3 4 3 8 Configuring Dvipdfm Dvipdfm configurations se
49. The font supplier t The typeface name B 2 8 METAFONT Input Dirs searchpath Search path for METAFONT input files InputEnvVar enuvar The name of an environment variable which contains additional input directories B 2 9 MetaPost Input Dirs searchpath Search path for METAPOST input files InputEnvVar enuvar The name of an environment variable which contains additional input directories B 2 10 MiKTeX The MiKTeX section contains general configuration settings and search path specifications B 2 10 1 Search Paths AFMPath searchpath Used to locate Adobe font metric files afm BASEPath searchpath Used by METAFONT to locate base files base ENCPath searchpath Used to locate font encoding files enc EXEPath searchpath Used to locate MiKTEX executables bat com exe FMTPath searchpath Used by TEX and derivatives to locate format files efmt eofmt fmt GraphicsPath searchpath Used to locate all sorts of graphics files bmp eps HBFPath searchpath Used by HBF2GF to locate hbf files MAPPath searchpath Used by the MkFntMap utility to locate font mapping files map MEMPath searchpath Used by METAPOST to locate men files OFMPath searchpath Used by 2 and 2 to locate font Q metric files ofm OVFPath searchpath Used by 2 and 2 to locate Q virtual fonts ovf 88 APPENDIX B MIKTEX INI THE MIKTEX B 2 MIKTEX INI SETTINGS OVPPat
50. UCTIONS MiKTeX Setup Wizard 2 2 7 Setup Information Review the setup settings MET es Setup wizard has enough infomation lo fart the installation If pou want be review or change any of the settings click Back If pou ane satisfied with the setings cick Nest to start the installation Sethings Install small package set from Cowrloads Hik Tes 2 2 Install TEXMF folder C bexmt Local TESMF folder C Mocakanmi TESMF search path C erani C sheen Program folder Mik Te Click lt Back if you want to change the settings Click Next gt to start the installation process 13 Two progress bars indicate the progress of the installation process MiKTeX Setup Wizard 2 2 7 MET ex Package Installation Mi Tes Setup Wizard wil now naal the selected ME Tes packages g E Iretaling adobestd Fieposton ipype local Ertenng scrabeh Holder Estimaling experiditune instaling E341 files 94 packages Extraching hlez irom adobestd cab Click Next gt when the installation is complete 14 You will see the final wizard page 22 CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTIONS MiKTeX Setup Wizard 2 2 7 Completing the MiKTeX Setup Wizard You hare zucesfuly completed the ME Tes Setup Wizard The packages pou chose have been installed To eat the wizard chek Fires Click Finish to close the wizard 2 1 5 Making Sure that the Installation Worked Open a command prompt window and ru
51. al of configuration settings error Error conditions filesearch File search fndb File name database fontinfo Font information open File openings process Process invocations tempfile Temporary files trie op size n Set the internal compiler variable trie_op_size to n trie_op_size is the amount of space for opcodes in the hyphenation patterns trie size n Set the internal compiler variable trie_size to n trie_size is the amount of space for hyphenation patterns should be larger for the N variant of the compiler undump name Use name as the name of the format to be used instead of the name by which the program was called or a hl line version Show version information and exit A 4 4 Aliases einitex Equivalent to etex ini evirtex Equivalent to etex 57 APPENDIX A MANUAL PAGES A 5 FINDTEXMF A 4 5 Documentation The e T X manual Run texdoc etex man A 5 findtexmf A 5 1 Synopsis findtexmf alias app help file type filetype must exist show path filetype start version file A 5 2 Description findtexmf can be used to find MiKTEX related files When the f ile type option is not given the search path used when looking for a file is inferred from the name given by looking for a known extension If no known extension is found the search path for TEX source files is used A 5 3 Options alias app Pretend to be app when finding files
52. app aux directory dir buf size n c style errors disable installer enable installer enable write18 error line n font max n font mem size n half error line n halt on error help hhelp include directory folder initialize interaction mode job name name job time file max in open n max print line n max strings n mem bot n mem max n mem min n mem top n nest size n output directory folder param size n pool size n quiet record package usages file recorder save size n src specials stack size n string vacancies n terminal oem time statistics trace traceflags trie op size n trie size n undump fmtname version file command file A 4 2 Description TEX is the first concrete result of an international research amp development project the 7S Project which was established under the aegis of DANTE e V during 1992 The aims of the project are to perpetuate and develop the spirit and philosophy of TEX whilst respecting Knuth s wish that TEX should remain frozen e TEX can be used in two different modes in compatibility mode it is supposed to be completely inter changable with standard TEX In extended mode several new primitives are added that facilitate among other things bidirectional typesetting An extended mode format is generated by prefixing the name of the source file for the format with an asterisk Such fo
53. ase files The minimum set of components for font production for a given printengine is the plain mf macro file and the local mode_def file The macros in plain mf can be studied in an appendix to The METAFONTbook they were developed by Donald E Knuth and this file should never be altered Each mode_def specification helps adapt fonts to a particular printengine The local ones in use on this computer should be in modes mf The e response to METAFONT S error prompt causes the default editor to start up at the current line of the current file The configuration value Editor can be used to change the editor used It may contain a string with f indicating where the filename goes and 1 indicating where the decimal line number if any goes See Section B 2 15 for more information A convenient file is null mf containing nothing When METAFONT can t find the file it thinks you want to input it Keeps asking you for another file name responding nu11 gets you out of the loop if you don t want to input anything A 8 3 Online Graphics Output You can see METAFONTS output without printing Chapter 23 of The METAFONTbook describes what you can do You enable screen ouput by giving screen on the command line 63 APPENDIX A MANUAL PAGES A 8 MF A 8 4 Options alias app Pretend to be app This affects both the format used and the search paths aux directory dir Keep auxiliary files in dir This implies include directory dir
54. at are freely redistributable enhanced TEX compiler capabilities enhanced previewer capabilities forward inverse DVI search graphics color magnifying glass open source MiKTEX source code is get at able for everyone The MiKTE X distribution consists of the following components TEX METAFONT TeXware METAFONTware Computer Modern Fonts the base TEX system pdfT X lt TEX pdf c TEX Q e 0 NS various TEX derivatives METAPOST a METAFONT derivative for the creation of PostScript figures Dvipdfm converts TEX output into PDF documents macro packages almost all free TEX macro packages lenttp www tex ac uk cgi bin texfaq2html label tutorials gt CHAPTER 1 INTRODUCTION 1 3 HOW TO GET MIKTpX fonts almost all free fonts Yap a sophisticated viewer for TEX output T EXify a TEX compiler driver MiKT X Options assists in configuring MiKTEX MiKT X Update Wizard assists in keeping the MiKTEX system up to date lots of utilities tools for the creation of bibliographies amp indexes PostScript utilities and more 1 3 How to Get MiKTEX MiKTEX is available on the CTAN and on CD R 1 3 1 Downloading from the CTAN You can download MiKTEX from the CTAN with the help of MiIKTEX Setup Wizard see Section 2 1 3 1 3 2 MiKT X on CD R If you cannot easily download more than 250 MB the complete MiKTEX distribution then you may wish to obtain a copy of the MiKTEX CD R Visit the CD R in
55. atabase FNDB It is strongly recommended that you update the file name database whenever files are added to or removed from one of the TEXMF directories You can update the file name database with the help of MiKT X Options 1 Click Start Programs gt MiKTeX MiKTeX Options 2 The MiKTEX Options window opens MiKTeX Options 2 4 1362 General Roots Tex Fomals Languages Packager Fie name databace elresh the He name databse when pou have installed ne packages or lont iles Ralrezh Mow Format ties Update all formal Hes when you hawe upgiaded bo a new LaT ex METIO Package nelallalior ou can choose whether mesing packages ae bo be installed andthe fy by Tes Frende Install missing packages or thetly MER Ceri ar Click Refresh Now 34 CHAPTER 3 CONFIGURING MIKTEX 3 5 MANAGING FORMAT FILES 3 5 Managing Format Files Many programs can load internal data structures from so called format files For example IATEX macros are stored in the file Latex efmt This file is loaed by T X when you start latex 3 5 1 Refreshing Format Files The setup program has created standard format files in course of the installation process You can refresh these format files in MiKTEX Options 1 Click Start Programs gt MiKTeX MiKTeX Options 2 The MiKTEX Options window opens Click Update Now to refresh the formal files 3 5 2 Defining New Format Files NOTE Defining new
56. ave to change Dvips configuration settings Settings in the local version of config ps take precedence over those specified in the installed version i e you can easily override settings such as as the default paper format For example follow these steps if you want to change the default paper size to Letter 1 Use the Explorer interface to create the local Dvips config directory if it doesn t exist yet The path to this directory is dvips conf ig relative to the local TEXMF directory see Section 2 4 2 2 Create a local version of config ps if it doesn t yet exist a Use the Explorer interface to locate the installed version of config ps It can be found in the directory dvips conf ig relative to the installation directory see Section 2 4 1 b Copy the installed version of config ps into the local Dvips config directory 3 Open the local version of config ps with Notepad 4 Select the desired paper size definition and cut it out For example cut out the following lines if you want to use the Letter paper format O letterSize 8 5in 1lin 5 Insert the Clipboard contents the desired paper size definition before the first paper size definition i e the first line starting with 37 CHAPTER 3 CONFIGURING MIKTEX 3 10 CONFIGURING PDFTEX 6 Save the file and exit Notepad 7 Refresh the file name database see Section 3 4 3 10 Configuring pdf TX pdfTEX configurations settings are read from the
57. can specify the alpha channel expresses opacity default t specifies transparency Normally only pixels with 0 opacity are masked all others are drawn The alternative behav iour is to draw only pixels with full opacity and mask all others this can be reached by option 1 Option m advices the program to mix foreground and background color for a pixel depending on its alpha value You can specify a background color like 128 255 128 for light green The color specification must appar after the a option Normally this background color is used only if there is no background color chunk in the file Option s gives this command line background color higher priority than the background color from chunk Download only needed characters from Type 1 fonts This is the default Some debugging flags trace this operation You can also control partial downloading on a per font basis by editing updmap cfg See Section 3 11 Print crop marks This option increases the paper size which should be specified either with a paper size special or with the T option by a half inch in each dimension It translates each page by a quarter inch and draws cross style crop marks It is mostly useful with typesetters that can set the page size automatically This works by downloading crop pro Remove comments in included PostScript graphics font files and headers only necessary to get around bugs in spoolers or PostScript post processing programs Specifically the
58. d be available for the user s control sequences and font names after the compiler s own error messages are stored tcx name Process the TCX table name See Section 4 2 11 for a discussion of TCX tables terminal oem Use the active code page e g 437 for console output time statistics Show processing time statistics trace traceflags Write trace messages into the DebugView window The traceflags argument is a comma separated list of trace categories access Accesses to disk files config Retrieval of configuration settings error Error conditions filesearch File search fndb File name database fontinfo Font information open File openings process Process invocations tempfile Temporary files undump name Use name as the name of the format to be used instead of the name by which the program was called ora 7 8 line version Show version information and exit A 8 5 Documentation The METAFONTbook ISBN 0 201 13444 6 A 9 mpm A 9 1 Synopsis mpm find updates help hhelp install package install some file list print package info package set repository url uninstall package 66 APPENDIX A MANUAL PAGES A 9 MPM update package update all update db update some file verbose version A 9 2 Description mpm MiKTEX Package Manager is used to install packages from a package repository The package manager can be run in two modes
59. d errorstopmode The meaning of these modes is the same as the corresponding commands job name name Set the name of the job jobname This has an affect on the output file names job time file Set the time stamp of all output files equal to file s time stamp lig table size n Set the internal compile variable 1ig_table_size to n lig_table_size is the maximum number of ligature kern steps Must be at least 255 and at most 32510 64 APPENDIX A MANUAL PAGES A 8 MF max print line n Set the internal compiler variable max print line to n max print line is the width of longest text lines output should be at least 60 max strings n Set the internal compiler variable max_strings to n max_strings is the maximum number of strings max wiggle n Set the internal compiler variable max wiggle to n max_wiggle is number of autorounded points per cycle mem max n Set the internal compiler variable mem_max to n mem_max is the greatest index in the internal memory array mem min n Set the internal compiler variable mem_min to n mem_min is the smallest index in the internal memory array must be O or more must be equal to mem_bot in the NI variant of the compiler otherwise less than or equal to mem_bot mem top n Set the internal compiler variable mem_top to n mem_top Is the largest index in the internal memory array dumped by the INI variant of the compiler must be substantially larger than 0 and not grea
60. dots per inch This affects the choice of bitmap fonts that are loaded and also the positioning of letters in resident PostScript fonts Must be between 10 and 10000 This affects both the horizontal and vertical resolution If a high resolution something greater than 400 dpi say is selected the Z flag should probably also be used If you are using fonts made with METAFONT such as Computer Modern makepk needs to know about the value for num that you use or METAFONT will fail See the file modes mf for a list of resolutions and mode names for most devices num Maximum drift in pixels of each character from its true resolution independent position on the page The default value of this parameter is resolution dependent it is the number of entries in the list 100 200 300 400 500 600 800 1000 1200 1600 2000 2400 2800 3200 that are less than or equal to the resolution in dots per inch Allowing individual characters to drift from their correctly rounded positions by a few pixels while regaining the true position at the beginning of each new word improves the spacing of letters in words Generate an EPSF file with a tight bounding box This only looks at marks made by characters and rules not by any included graphics In addition it gets the glyph metrics from the TFM file so characters that print outside their enclosing TFM box may confuse it In addition the bounding box might be a bit too loose if the character
61. e 54 edit compile view edit cycle 42 email support 9 getting 9 error messages C style 41 C C style 54 64 68 72 76 80 line width 55 64 68 73 76 80 FAQ frequently asked questions 9 25 file name database defined 34 refreshing 34 file name datasbase refreshing 62 file line error style 54 64 68 72 76 80 format files creating 62 defined 35 defining new 35 refreshing 35 gftodvi 49 hyphenation tables selecting 36 initexmf 61 installation directory choosing a location for the 19 defined 26 international characters 43 Knuth Donald E 7 languages selecting 36 LaTex invoked by texify 44 LaTeX2e reference 25 local guide 40 local package repository choosing a location for the 14 installing from 19 local TEXMF directory choosing a location for the 20 62 defined 26 log files setup wizard 24 update wizard 30 long file names quoting of 42 mailing list archive 9 Makelndex invoked by texify 44 METAFONT 88 modes 62 search path 88 MiKTeX CD R 8 documentation 9 downloading 8 FAQ 9 features 7 getting 8 how to pronounce 7 installing 16 network installation 25 registering 9 uninstalling 26 updating 27 MiKTeX CD R 8 25 98 INDEX INDEX MiKTeX manual getting 2 MiKTeX project how to support the 9 MiKTeX Project Page 9 MiKTeX Setup Wizard see setup wizard 16 MiKTeX Update Wizard see update wizard 27 MLTex 44 modes
62. e input font to start processing font mf Or you can just say mf and give the other stuff on the next line Other control sequences such as batchmode for silent operation can also appear The name font will be the job name and is used in forming output file names If METAFONT doesn t get a file name in the first line the job name is mfput The default extension mf can be overridden by specifying an extension explicitly A log of error messages goes into the file font 1og The output files are font tfm and font numbergf where number depends on the resolution and magnification of the font The mode in this example is shown generically as printengine a symbolic term for which the name of an actual device or most commonly the name localfont must be substituted If the mode is not specified or is not valid META FONT will default to proof mode which produces large character images for use in font design and refinement Proof mode can be recognized by the suffix 2602gf after the job name Examples of proof mode output can be found in Computer Modern Typefaces Volume E of Computers and Typesetting The system of magsteps is identical to the system used by TEX with values generally in the range 0 5 1 0 2 0 3 0 4 0 and 5 0 Magnification can also be specified not as a magstep but as an arbitrary value such as 1 315 to create special character sizes Before font production can begin it is necessary to set up the appropriate b
63. e a 1 3 3 Related Applications 2 2 srad rrsan uraa ROQISITAION 2 5 2 twee ae BR RE a ae om a i ig ara Sd The MiKT X Project Page oo e The MiKTpX Mailing List 2 0 o o e Documentation irc a RR AR AA A A AA bh h bh mb NOOR Installing MiKTEX 2 1 Installation Instructions 2 ee 214A Prerequisites se ee vaso da ke ee a ee el aS 2 1 2 Choosing a Package Set o a 2 1 3 Downloading MIKTEX o o e 2 1 4 Installing MIKTBX lt lt aa cocco meeue tiasana ee ee 2 1 5 Making Sure that the Installation Worked o o 2 1 6 Troubleshooting the Setup Process aoa a a a 2 2 Advanced Installation Options o a oa a 2 2 1 Driving MiKTEX Setup Wizard aaa aaa a ee 2 2 2 Shared Network Installation ooa aa a 2 3 ltemsinthe Start Menu a naaa aaa ee 2 4 The TEXMF Directory Hierarchy a a aaua aaa a 2 4 1 The Installation Directory aoaaa aaa ee 2 4 2 The Local TEXMF Directory aaau aaa eee ee ee 2 5 Removing MIKTEX o o Configuring MiKTEX 3 1 Installing Updates 2 a a e a a a e aa a a a o o a 31 1 HOw IE WOKS 30 2 ee os R a a RR poe A o 3 1 2 Running MiKTEX Update Wizard aaau aa 22 00 0 3 2 Package Management 002 ee ee 3 2 1 What Is a Package o e 3 2 2 Working With the Package Manager o o 0000 eee 3 2 2 1 Installing Packages 0 e e ee
64. e the texdoc utility to quickly access TEX related documentation For example enter E texdoc yap to view the Yap manual Chapter 2 Installing MiK TEX 2 1 Installation Instructions 2 1 1 Prerequisites MiKTEX runs on all current Windows platforms MiKTEX Setup Wizard does not install any operating system components such as comct132 d11 It is taken for granted that all required system components exist either because they are a part of the operating system or because they were installed by an operating system update service pack The following system components are required by MiKTEX comct132 d11 Version 5 80 2614 3600 or later of the Common Controls DLL must be installed This is the case if the operating system is Windows Me or Windows XP For older operating systems it might be necessary to get the DLL from Microsoft lt http www microsoft com downloads release asp releaseid 30318 gt wininet dll Version 4 70 0 1300 or later of the Internet Extensions DLL must be installed It is a part of Internet Explorer 4 0 or later MiKT X Setup Wizard displays a message and quits if one of the required system components is miss ing 2 1 2 Choosing a Package Set If you install MiIKTEX on your hard disk you can choose between three package sets Small MiKTEX Large MiKTEX and Total MiKTEX Small MiK TEX This is a basic MiKTEX system which gets you started Large M
65. ecified without the dvi extension A 3 3 Options Many of the parameterless options listed here can be turned off by suffixing the option with a zero 0 for instance to turn off page reversal use r0 Such options are marked with a trailing a Conserve memory by making three passes over the DVI file instead of two and only loading those characters actually used A Print only the odd pages This option uses TEX page numbers not physical page numbers 49 APPENDIX A MANUAL PAGES A 3 DVIPS b fx Fx num Generate num copies of each page but duplicating the page body rather than using the copies PostScript variable This can be useful in conjunction with a header file setting bop hook to do color separations or other neat tricks Print only the even pages This option uses TEX page numbers not physical page numbers num Generate num consecutive copies of every page i e the output is uncollated This merely sets the builtin PostScript variable Hcopies num Generate num copies but collated by replicating the data in the PostScript file Slower than the c option but easier on the hands and faster than resubmitting the same PostScript file multiple times num Set the debug flags showing what Dvips thinks it is doing See the Dvips manual for the possible values Of num Use d 1 as the first option for maximum output num Set both the horizontal and vertical resolution to num given in dpi
66. em_min is the smallest index in the internal memory array must be 0 or more must be equal to mem_bot in the NI variant of the compiler otherwise less than or equal to mem_bot mem top n Set the internal compiler variable mem_top to n mem_top Is the largest index in the internal memory array dumped by the INI variant of the compiler must be substantially larger than 0 and not greater than mem_max nest size n Set the internal compiler variable nest_size to n nest_size is the maximum number of semantic levels simultaneously active output directory dir Create output files in dir This implies include directory dir param size n Set the internal compiler variable param_size to n param_size is the maximum number of simul taneous macro parameters pool size n Set the internal compiler variable pool_size to n pool_size is the maximum number of charac ters in strings including all error messages and help texts and the names of all fonts and control sequences must exceed string_vacancies by the total length of the program s own strings which is currently about 30000 81 APPENDIX A MANUAL PAGES A 14 TEX quiet Suppress all output except errors save size n Set the internal compiler variable save_size to n save_size is the amount of space for saving values outside of current group src specials Embed source file information source specials in the DVI file stack size n Set the internal compiler var
67. erwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 46 APPENDIX A MANUAL PAGES A 1 BIBTEX help Give help and exit hhelp Show the manual page in an HTML Help window and exit when the window is closed include directory dir Prepend dir to the search path min crossrefs n Defines the minimum number of crossrefs required for automatic inclusion of the crossref d entry on the citation list the default is two quiet Suppress all output except errors record package usages f1le Record all package usages and write them into file trace traceflags Write trace messages into the DebugView window separated list of trace categories access Accesses to disk files config Retrieval of configuration settings error Error conditions filesearch File search ndb File name database fontinfo Font information open File openings process Process invocations tempfile Temporary files version Show version information and exit A 1 4 See Also Section 4 3 A 1 5 Documentation BibTgXing Run texdoc btxdoc Designing BibTgX Styles Run texdoc btxhak The traceflags argument is a comma 47 APPENDIX A MANUAL PAGES A 2 DVICOPY LATEX A Document Preparation System
68. es to disk files config Retrieval of configuration settings error Error conditions filesearch File search fndb File name database fontinfo Font information open File openings process Process invocations tempfile Temporary files trie op size n Set the internal compiler variable trie_op_size to n trie_op_size is the amount of space for opcodes in the hyphenation patterns trie size n Set the internal compiler variable trie_size to n trie_size is the amount of space for hyphenation patterns should be larger for the N variant of the compiler 78 APPENDIX A MANUAL PAGES A 14 TEX undump name Use name as the name of the format to be used instead of the name by which the program was called or a hl line version Show version information and exit A 13 3 Aliases pdfinitex Equivalent to pdftex ini pdfvirtex Equivalent to pdftex A 13 4 Documentation The pdfT X user manual A4 version Run texdoc pdftex a A 14 tex A 14 1 Synopsis tex alias app aux directory dir buf size n c style errors disable installer enable installer enable write18 error line n font max n font mem size n half error line n halt on error help hhelp include directory dir initialize interaction mode job name name job time file max in open n max print line n max strings n mem bot n mem max n mem min n mem top n n
69. est size n output directory dir param size n pool size n quiet record package usages file recorder save size n src specials stack size n string vacancies n tcx tcaname terminal oem time statistics trace traceflags trie op size n trie size n undump fmtname version file command file A 14 2 Description TEX formats the interspersed text and commands contained in the named files and outputs a typesetter independent file called DVI which is short for DeVice Independent TEX s capabilities and language are described in The T Xbook TEX is normally used with a large body of precompiled macros and there are several specific formatting systems such as IATEX which require the support of several macro files TEX looks at its command line to see what name it was called under Both initex and virtex are linked to the tex executable When called as initex or when the initialize option is given it can be used to precompile macros into a fmt file When called as virtex it will use the plain format When called under any other name TEX will use that name as the name of the format to use For example when called as tex the tex format is used which is identical to the plain format The commands defined by the plain format are documented in The TpgXbook Other formats that are often available include latex and amstex The commands given on the command line to the TEX program are passed to it as t
70. f missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 error line n Set the internal compiler variable error_line to n error_line is the width of context lines on terminal error messages font mem size n Set the internal compiler variable font __mem_size to n font_mem_size is the size in TEX memory words of the font memory half error line n Set the internal compiler variable half_error_line to n half_error_line is the width of first lines of contexts in terminal error messages 68 APPENDIX A MANUAL PAGES A 10 MPOST halt on error Quit after the first error help Give help and exit hhelp Show the manual page in an HTML Help window and exit when the window is closed include directory dir Prepend dir to the search path initialize Become the NI variant of the compiler interaction mode Set the interaction mode Must be one of batchmode nonstopmode scrollmode and errorstopmode The meaning of these modes is the same as the corresponding commands job name name Set the name of the job jobname This has an affect on the output file names job time file Set the time stamp of all output files equal to file s time stamp lig table size n Set the internal compile variable 1ig_table_size to n lig_table_size is the maximum number of ligature kern steps Must be at least 255 and at most 32510 max print line n Set
71. file pdftex cfg when the pdfTFX format file is being created See Appendix C for details about this file You must edit a local version of pdftex cfg if you have to change pdfTEX configuration settings Settings in the local version of pdftex cfg take precedence over those specified in the installed version i e you can easily override settings such as the paper format For example follow these steps if want to change the default paper format to Letter 1 Use the Explorer interface to open the directory pdftex config relative to the local TEXMF direc tory see Section 2 4 2 Possibly you have to create this directory if it doesn t exist yet 2 Create a local version of pdftex cfg if it doesn t yet exist use the Explorer interface to create a new text document with the name of pdftex cfg 3 Open pdftex cfg with Notepad 4 Insert change the following lines page_height 11 true in page_width 8 5 true in 5 Save the file and exit Notepad 6 Refresh the file name database and create the pdfTEX format files see Section 3 4 3 11 Outline Fonts Information about outline fonts is stored in a file by the name of psfonts map This file is created in the course of the setup update process lt can be manually created by running initexmf mkmaps at the command prompt CAUTION O The contents of psfonts map should never be edited it will be overwritten by the MiKTEX update process psfonts map depends on
72. fo page lt http www miktex org cd gt for more information The MiKTEX CD R allows you to install MiIKTEX on the hard disk or to run the programs directly from the CD R 1 3 3 Related Applications There are other applications you might be interested in installing ActivePerl ActivePerl lt http www activestate com gt is an implementation of Perl for Windows A few utilities e g ConTEXt are Perl scripts You should install ActivePerl if you want to use these utilities Adobe Acrobat Reader Adobe Acrobat Reader lt http www adobe com prodindex acrobat readstep htm1 gt is a PDF document viewer DebugView DebugView is a freeware application that lets you monitor diagnostic messages produced by MiKT X You can download DebugView from the Sysinternals web site lt http www sysinternals com gt 2Comprehenisive TeX Archive Network Schttp www miktex org cd gt 4chttp www activestate com gt S lt http www adobe com prodindex acrobat readstep html gt Schttp www sysinternals com gt CHAPTER 1 INTRODUCTION 1 4 REGISTRATION TeXnicCenter TeXnicCenter lt http www toolscenter org gt is a freeware TEX editor shell It cooperates with MiKTEX with respect to forward and inverse DVI search see Section 4 2 5 WinEdt WinEdt lt http www winedt com gt is a shareware TEX editor shell It cooperates with MiKTEX with respect to forward and inverse DVI search see Section 4 2 5 1 4 Reg
73. format files is a task for experienced TEX users MiKT X Options can assist you in defining a new format 1 Click Start Programs MiKTeX MiKTeX Options 2 The MiKTEX Options window opens 3 Click on the TeX Formats tab You are presented with a list of known TeX formats To add an entry to this list click New 4 In the Format Definition dialog box enter the following information Format name The name of the format Compiler The TEX compiler variant engine which creates the format file Input file The name of the main input file Output file The name of the format file Preloaded format Optional The name of another format which must be loaded before the actual format file is created Descriptioin A one line comment which describes the new format A new application file with the name of the format will be installed in the MiKTEX bin directory This application file serves as a short cut for compiler amp format For example these two commands are equivalent latex sample2e etex amp latex sample2e 35 CHAPTER 3 CONFIGURING MIKTEX 3 6 REGIONAL SETTINGS 3 6 Regional Settings 3 6 1 Paper Size The setup process configures all programs to use A4 as the default paper format If this doesn t fit your needs you have to edit configuration settings for the following programs e Dvipdfm see Section 3 8 e Dvipdfmx see Section 3 8 e Dvips see Section 3 9 e pafTpX see
74. h searchpath Used OVP2OVF to locate locate ovp files PKPath searchpath Used to locate packed font raster files pk PK File Name filenamespec File name convention for PK packed raster files PSPath searchpath Used to locate all sorts of PostScript related files TCXPath searchpath Used to locate character translation files tcx TFMPath searchpath Used to locate TEX font metric files tfm TTFPath searchpath Used to locate TrueType font files ttc ttf TypeiPath searchpath Used to locate Type 1 font files pfa pfb VFPath searchpath Used to locate virtual font files vf B 2 10 2 Memory Settings for TEX amp Friends The values described here are used by TEX amp Friends when allocating memory for internal data struc tures bistack_size n Size of stack for bisection algorithms buf_size n Maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname must not exceed 1073741823 error_line n Width of context lines on terminal error messages error_line n Width of context lines on terminal error messages font_max n Maximum internal font number must not exceed 5000 font_mem_size n Number of words of font_info for all fonts half_error_line n Width of first lines of contexts in terminal error messages should be between 30 and error_line 15 lig_table_size n Maximum number of ligature kern step
75. he first input line But it is often easier to type extended arguments as the first input line since shells tend to gobble up 79 APPENDIX A MANUAL PAGES A 14 TEX or misinterpret TEX s favorite symbols like backslashes unless you quote them As described in The TpXbook that first line should begin with a file name a controlsequence or a amp formatname The normal usage is to say tex paper to start processing paper tex The name paper will be the job name and is used in forming output file names If TEX doesn t get a file name in the first line the job name is texput When looking for a file TEX looks for the name with and without the default extension tex appended unless the name already contains that extension If paper is the job name a log of error messages with rather more detail than normally appears on the screen will appear in paper log and the output file will be in paper dvi TEX will look in the first line of the file paper tex to see if it begins with the magic sequence amp If the first line begins with Y format translate file tcxname then TEX will use the named format and transation table tczname to process the source file Either the format name or the translate file specification may be omitted but not both The e response to TEX s error prompt causes the default editor to start up at the current line of the current file The configuration value Editor can be used to
76. her TEX system you might have used before Typesetting with MiKT X involves these steps 1 Edit the IATEX source with your favourite text document editor 2 Compile the IATEX source into a DVI file i e say something like latex MyMastersThesis 3 Open the result by double clicking the DVI file e g MyMastersThesis dvi in Windows Explorer You usually use a lAT X editor to carry out these steps The most prominent ones are listed here lt http www tex ac uk cgi bin texfaq2html label editors gt 4 2 TEX amp Friends Specialities This section describes features that were added to the MiKTEX implementation of TEX amp Friends 4 2 1 Automatic Package Installation All MiKTEX programs can be configured in such a way that missing packages are automatically installed see Section 3 2 3 It is possible to override the global configuration setting with these command line options disable installer Missing packages will not be installed enable installer Missing packages will be installed 4 2 2 Finding out Package Usages The command line option record package usages can be used to find out which packages are used in a job For example you would say latex record package usages packages txt test 40 CHAPTER 4 USING MIKTpX 4 2 TEX amp FRIENDS SPECIALITIES to create the file packages txt which contains the names of the packages used by test tex If test tex looks like this documentclass scrartcl begi
77. iKTEX This gives you the most important macro packages and fonts Total MiKTEX This includes all available packages Choose Small MiKTEX if you are downloading MiKT X over a slow Internet connection or if you want to conserve disk space It is possible to configure MiKT X in such a a way that missing packages are automatically installed later in the course of use lenttp www microsoft com downloads release asp releaseid 30318 gt CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTIONS 2 1 3 Downloading MiKT X TIP The small package set and the setup program have been packed together into the Small MiKTEX Installer available on the SourceForge net download server lt http sourceforge net project showfiles php group_id 10783 gt It is recommended that you download this installer if you intend to install the small package set In this case you can skip the rest of this section a lt chttp sourceforge net project showfiles php group_id 10783 gt You can download MiKT X either with the help of MiKTeX Setup Wizard setup exe or manually with the help of an FTP client This installation guide covers the wizard method because it is the recom mended method for most users See the MiKTEX FAQ lt http www miktex org faq gt for a detailed description of the FTP method 1 Download the latest version of the wizard from the SourceForge net download server lt http so
78. iable stack_size to n stack_size is the maximum number of simultaneous input sources string vacancies n Set the internal compiler variable string_vacancies to n string_vacancies is the minimum number of characters that should be available for the user s control sequences and font names after the compiler s own error messages are stored tcx name Process the TCX table name See Section 4 2 11 for a discussion of TCX tables terminal oem Use the active code page e g 437 for console output time statistics Show processing time statistics trace traceflags Write trace messages into the DebugView window The traceflags argument is a comma separated list of trace categories access Accesses to disk files config Retrieval of configuration settings error Error conditions filesearch File search fndb File name database fontinfo Font information open File openings process Process invocations tempfile Temporary files trie size n Set the internal compiler variable trie_size to n trie_size is the amount of space for hyphenation patterns should be larger for the N variant of the compiler trie op size n Set the internal compiler variable trie_op_size to n trie_op_size is the amount of space for opcodes in the hyphenation patterns 82 APPENDIX A MANUAL PAGES A 15 TEXIFY undump name Use name as the name of the format to be used instead of the name by which the
79. iends o 89 B 2 11 OMOIA eae ee bow kag Se ee ke e He RRR Ew we eS 90 B 2 12 Otp20Cp 2 6 oS ee ee ew ao Ree ee le ae ee eco Ee Eee wa 90 B 2 13 pdfeTeX 2 ee 91 CONTENTS B 2 14 pdfTeX Bi215 TeX igs c smica a a lA id A B 2 16 ttf2pk B 2 17 ttf2tim B 2 18 Yap C pdftex cfg The pdf TEX Configuration File C 1 pdftex cfg Settings D updmap cfg Configuration Settings for Outline Fonts D 1 updmap cfg Instructions Index Chapter 1 Introduction 1 1 About this Manual This manual is about MiKTEX the purpose of this manual is not to give an introduction into the world of TEX If you are not familiar with using TEX and Friends then please consider reading one of the tutorials available on the Internet lt http www tex ac uk cgi bin texfaq2html label tutorials gt 1 2 About MiKT X MiKTEX pronounced mik tech is an up to date implementation of TEX and related programs for Win dows all current variants TEX is a typesetting system invented by D E Knuth MiKTEX s main features include easy to install MiKTEX comes with a setup program that allows you to install the distribution via the Internet integrated package management missing packages can be installed automatically on the fly during run time network friendly MiKTEX can be run directly from a shared and read only network directory complete the MiKTEX distribution contains almost all packages th
80. ig 2 2 Advanced Installation Options 2 2 1 Driving MiKT X Setup Wizard MiKT X Setup Wizard reads options from the file setupwiz opt if it exists It is also possible to specify options on the command line though this is a bit intricated You have to stick to the following syntax setup exe C PreSetup setupwiz setup path e options Note that the placement of quotation marks is important and that e is surrounded with two pairs of double quotation marks For example this command starts the wizard in unattended mode gt setup exe C PreSetup setupwiz setup path e unattended gt MiKTEX Setup Wizard obeys the following command line options additional directory trees dirs Register extra TEXMF directory trees dirs is a semicolon separated list of fully qualified directory names allow unattended reboot Restart the system if necessary download only Download all required packages but do not otherwise install MiKT X dry run Simulate the setup process No files shall be downloaded and or installed install from local repository Install MiKTEX from a local package repository installation directory dir Register the location of the installation directory local directory dir Register the location of the local TEXMF directory local package repository dir Register the location of the local package repository no additional directory trees Do not incorporate additional TEXMF
81. ings error Error conditions filesearch File search fndb File name database fontinfo Font information 74 APPENDIX A MANUAL PAGES A 13 PDFTEX open File openings process Process invocations tempfile Temporary files trie op size n Set the internal compiler variable trie_op_size to n trie_op_size is the amount of space for opcodes in the hyphenation patterns trie size n Set the internal compiler variable trie_size to n trie_size is the amount of space for hyphenation patterns should be larger for the N variant of the compiler undump name Use name as the name of the format to be used instead of the name by which the program was called ora hl line version Show version information and exit A 12 4 Aliases iniomega Equivalent to omega ini viromega Equivalent to omega A 12 5 Documentation Draft documentation for the Q system Run texdoc omega manual A 13 pdftex pdf TpX is a special version of TEX that outputs PDF instead of DVI A 13 1 Synopsis pdftex alias app aux directory dir buf size n c style errors disable installer enable installer enable write18 error line n font max n font mem size n half error line n halt on error help hhelp include directory folder initialize interaction mode job name name job time file max in open n max print line n max strings n mem bot n mem max n mem
82. internal compiler variable font _max to n font_max is the maximum internal font number must not exceed 5000 font mem size n Set the internal compiler variable font __mem_size to n font_mem_size is the size in TEX memory words of the font memory half error line n Set the internal compiler variable half_error_line to n half_error_line is the width of first lines of contexts in terminal error messages halt on error Quit after the first error help Give help and exit hhelp Show the manual page in an HTML Help window and exit when the window is closed include directory dir Prepend dir to the search path initialize Become the NI variant of the compiler interaction mode Set the interaction mode Must be one of bat chmode nonstopmode scrollmode and errorstopmode The meaning of these modes is the same as the corresponding commands job name name Set the name of the job jobname This has an affect on the output file names job time file Set the time stamp of all output files equal to file s time stamp max in open n Set the internal compiler variable max_in_open to n max_in_open is the maximum number of input files and error insertions that can be going on simultaneously max print line n Set the internal compiler variable max print line to n max print line is the width of longest text lines output should be at least 60 max strings n Set the internal compiler variable max_strings to
83. ion ee 66 AQ MPM anida A ee ea es RA 66 A 9 1 gt SYNOPSIS 2 rra E Guede fea ee 4 4b eRe eee ee SSS 66 A 9 2 IDESCrIPIION s s raas ee ak Re ee ER REE ee a A 67 A93 OPUONS Cs se ees ened kegs gg na Aha Ge o Deer aes 67 ASTOMPOST of 4 2 ark hoe ee ee ea ek aed ea ee lt ea a 68 A 10 1 Synopsis i ai i ie i a ee 68 A102 Description 2 nea SSS eee he ew ba ee AA e a 68 A10 3 ODUONS ios cnc cece ee a ea ace ee BRS eG EASA eee eee ees 68 ATWO AllaSOS send uci he ee a ee eee aoe ee E 71 A 10 5 Documentation lt ses essas aaaea amea ee 71 ATEON siria a a OR ee a EON ee ie tt A 71 AAT SYNOPSIS 2 2 eee eae ee eb bee eee ew EPO Bee ee de 71 A112 DESCUIDO geo oe daw e eae ee ee oe ee o ee ee es 71 ATES Options fa eee ee a de dow a ae a a 71 AlL Omega Luci re a oe alae BEE PEE EE EER ae eae 72 AA2A SYNPOSIS lo kA Aa et a oh ee ee A we a 72 A12 2 DeSCIIDUON ccc ee pa oe een Po ead dla A ee Pe a aes 72 AN2 F3 OpUONS cv dee ok a a wo a ee a ee ee RR a O A 72 ACV2 4 AllaS S c f be eee a bE ie ee ella wa ree A125 Documentation gt r 25S aeee cee hee ee eee EER Se amp Ses 75 ACTS ipditeX 0 aa eee a dy ded a a TA E a wa a a 75 ATSA SYNOPSIS 2256 e o pads aud e ee he ae eae ede ee a a oe eee 75 A 13 2 OPUONS moone ai a a A a EY ee a a a Baste e 76 ASS AIS lt a E eRe A CEL LEER EEE Re eS aaa 79 A 13 4 Documentation ome we eee EE EEE EE Pee ee ES 79 ANANE 2 dace beh eRe Red E be hae Ce bad Re re REE A 79 AT
84. ion 2 4 1 The Installation Directory CAUTION O The contents of the installation directory must be regarded read only i e no files should be added removed or changed here The installation directory is the root of a TDS compliant directory hierarchy It contains the files installed by the MiKTEX Setup Wizard If you have installed MiKTEX on the system drive then the path to the installation directory is C Wtexmf unless you have specified another path You can use the MiKTEX Options application to find out the path to the installation directory 2 4 2 The Local TEXMF Directory The local TEXMF directory is the root of a TDS compliant directory hierarchy It contains files that are created during use of the MiKTEX programs lt can also contain your personal additions such as your own style files If you have installed MiKTEX on the system drive then the path to the local TEXMF directory is C localtexmf unless you have specified another path If you are running the MiKTEX programs from the MiKTEX CD then the path to the local TEXMF directory is C MiKTeXDirect You can use the MiKTEX Options application to find out the path to the local TEXMF directory 2 5 Removing MiKT X MiKTEX can be removed via the Windows control panel 1 Open Control Panel usually via Start Settings Control Panel 2 Click on the Software resp Add Remve Programs icon 3 Select MiKTeX 26 Chapter 3 Configuring
85. istration If you enjoy MiKTEX and want to support the project then please consider registering MiKTEX Visit the MiKT X donations page lt http www miktex org donations htm1 gt for more information Registered MiKTpX users are entitled to email support 1 5 The MiKTgX Project Page The MiKTEX Project Page lt http www miktex org gt is the address to turn to for MiKT X related news amp information 1 6 The MiKT X Mailing List There is a discussion list for MiKTEX users You can join this list by visiting the MiKTeX Users Info Page lt http lists sourceforge net lists listinfo miktex users gt and filling out the form provided there To see the collection of prior postings to the mailing list browse the MiKTeX Users Archives lt http waw geocrawler com redir sf php3 list miktex users gt 1 7 Documentation Other MiKTEX related documentation includes FAQ Answers to frequently asked questions Tips amp Tricks Some good advice for MiKTEX users Shortcuts to these documents can be found in the MiKTEX program folder see Section 2 3 and on the project page 7 chttp www toolscenter org gt 8 lt http www winedt com gt 9 lt http www miktex org donations html gt 10 lt http www miktex org gt ehttp lists sourceforge net lists listinfo miktex users gt 12 lt http www geocrawler com redir sf php3 list miktex users gt CHAPTER 1 INTRODUCTION 1 7 DOCUMENTATION TIP Us
86. l compiler variable max print line to n max print line is the width of longest text lines output should be at least 60 max strings n Set the internal compiler variable max_strings to n max_strings is the maximum number of strings mem bot n Set the internal compiler variable mem_bot to n mem_bot is the smallest index in the internal memory array dumped by the N variant of the com piler must not be less than mem_min mem max n Set the internal compiler variable mem_max to n mem_max is the greatest index in the internal memory array mem min n Set the internal compiler variable mem_min to n mem_min is the smallest index in the internal memory array must be 0 or more must be equal to mem_bot in the NI variant of the compiler otherwise less than or equal to mem_bot mem top n Set the internal compiler variable mem_top to n mem_top Is the largest index in the internal memory array dumped by the INI variant of the compiler must be substantially larger than 0 and not greater than mem_max 73 APPENDIX A MANUAL PAGES A 12 OMEGA nest size n Set the internal compiler variable nest_size to n nest_size is the maximum number of semantic levels simultaneously active output directory dir Create output files in dir This implies include directory dir param size n Set the internal compiler variable param_size to n param_size is the maximum number of simul taneous macro parameters pool size n
87. les 3 3 1 Using Additional TEXMF Directories You can incorporate additional TDS compliant TEXMF directories into the MiKT X setup For example you can store your own files in a personal TEXMF hierarchy rooted at C MyTeXMF To use this TEXMF directory follow this procedure 1 Click Add 2 In the Browse for Folder dialog box locate and choose C MyTeXMF C MyTeXMF will be added at the end of the list You can move it to the second position the local TEXMF directory should always be the first in the list so that it gets a higher priority IMPORTANT The TEXMF directory must be TDS compliant For example if you want to use K the directory for your own ATEX style files you should put your files into the directory tex latex mystuff relative to the TEXMF directory Run texdoc tds to learn everything about the TDS 3 3 2 Changing the Search Order The order in the list view determines the order in which the TEXMF directories are searched You can change the search order as follows 33 CHAPTER 3 CONFIGURING MIKTEX 3 4 REFRESHING THE FILE NAME DATABASE 1 Select a directory 2 Click Up or Down to move the selection up or down in the list CAUTION O It is highly recommended that the local TEXMF directory is the first in the list 3 4 Refreshing the File Name Database To speed up file search MiKTEX makes use of a list of known file names This list is called the file name d
88. m time statistics trace traceflags undump name version command file 62 APPENDIX A MANUAL PAGES A 8 MF A 8 2 Description METAFONT reads the program in the specified files and outputs font rasters in GF format and font metrics in TFM format The METAFONT language is described in The METAFONTbook Like TEX METAFONT is normally used with a large body of precompiled macros and font generation in particular requires the support of several macro files METAFONT looks at its command line to see what name it was called under Both inimf and virmf are linked to the mf executable When called as inimf or when the initialize option is given it can be used to precompile macros into a base file When called as virmf it will use the plain base When called under any other name METAFONT will use that name as the name of the base to use For example when called as mf the mf base is used which is identical to the plain base Other bases than plain are rarely used The commands given on the command line to the METAFONT program are passed to it as the first input line But it is often easier to type extended arguments as the first input line since shells tend to gobble up or misinterpret METAFONT s favorite symbols like semicolons unless you quote them As described in The METAFONTbook that first line should begin with a filename a controlsequence or a amp basename The normal usage is to say mf mode printengin
89. n open File openings process Process invocations tempfile Temporary files 70 APPENDIX A MANUAL PAGES A 11 MTPRINT undump name Use name as the name of the format to be used instead of the name by which the program was called or a hl line version Show version information and exit A 10 4 Aliases inimp Equivalent to mpost initialize mpost virmp Equivalent to mpost A 10 5 Documentation AT amp T technical report CSTR 162 Run texdoc mpman A 11 mtprint A 11 1 Synopsis mtprint even only help help landscape odd only page range ramge print method method print nothing printer printer usage file A 11 2 Description mtprint sends TEX output files to a printing device A 11 3 Options even only Prints only even TEX pages landscape Selects landscape output format odd only Prints only odd TEX pages page range range Selects a TEX page range e g 20 21 Multiple page range options accumulate print method method Selects a print method One of psbmp This method uses Dvips and Ghostscript to produce the print output 71 APPENDIX A MANUAL PAGES A 12 OMEGA ps This method uses Dvips to produce an intermediate PostScript file which will be sent to the printer This only works for PostScript printers print nothing Simulates printing printer printer Selects a printing device The default printer is used if this option i
90. n document Hello world end document Then the resulting packages txt would contain these lines cm koma script ltxbase The package list can be handed over to the package manager see Section A 9 e g mpm update some packages txt would ensure that you have the latest versions installed 4 2 3 Suppressing Screen Output The option quiet suppresses all diagnostic messages No screen output is produced unless there are errors The quiet option implies c style errors and interaction batchmode i e errors will be shown in a C style form and do not stop the compilation process For example the input file foo tex documentclass article begin document What s This end documnt would cause TEX to print one error message as in the following example gt latex quiet foo tex foo tex 3 Undefined control sequence gt 4 2 4 Setting the Name of the Output File You can change the name of all output files by using the option job name name This switch actually sets the name of the TEX job and has an effect of the output file names because these names are derived from the job name Look at the following example gt latex job name foo sample2e This is TeX Version 3 14159 MiKTeX 2 2 D texmf tex latex base sample2e tex LaTeX2e lt 2001 06 01 gt Babel lt v3 7h gt and hyphenation patterns for english german ngerman loaded D texmf tex latex base article cls Document Class article
91. n the following commands prefixed with gt gt latex sample2e This is e TeX Version 3 141592 2 1 MiKTeX 2 4 entering extended mode C texmf tex latex base sample2e tex LaTeX2e lt 2001 06 01 gt Babel lt v3 7m gt and hyphenation patterns for english french german ngerman du mylang nohyphenation loaded C texmf tex latex base article cls Document Class article 2001 04 21 v1 4e Standard LaTeX document class C texmf tex latex base size10 clo No file sample2e aux C texmf tex latex base omscmr fd 1 2 8 sample2e aux Output written on sample2e dvi 3 pages 7256 bytes Transcript written on sample2e log gt yap sample2e gt 2 1 6 Troubleshooting the Setup Process MiKTEX Setup Wizard logs all actions into the DebugView window You may want to download and install DebugView if you intend to troubleshoot setup related problems To download DebugView visit the DebugView page lt http www sysinternals com ntw2k freeware debugview shtm1 gt and follow the download installation instructions To create a trace start DebugView prior to the setup wizard S lt http www sysinternals com ntw2k freeware debugview shtml gt 23 CHAPTER 2 INSTALLING MIKTgxX 2 2 ADVANCED INSTALLATION OPTIONS In addition the wizard reports some actions into a log file The name of the log file is setup currentdate log Search for this file in the config directory usually C texmf miktex conf
92. name will be included in psfonts map unless dvipsPreferOutline is setto false Mixed means that the fonts referenced in the file are available as bitmap and as outline 96 Index batch 83 clean 84 dump 62 even only 71 expand 84 find updates 67 help 84 install some sfile 67 install package 67 landscape 71 language lang 84 list 67 list modes 62 local root dir 62 mkidx option option 84 mklinks 62 mkmaps 62 odd only 71 page range range 71 pdf 84 print method method 71 print nothing 72 print only 62 print package info package 67 printer printer 72 quiet 62 84 report 62 root directories dirs 62 run viewer 84 set repository url 67 src 84 tex option option 84 texinfo cmd 84 uninstall package 67 update all 67 update db 67 update fndb 62 update miktex 62 update somes file 67 update package 67 verbose 62 67 84 version 62 67 84 viewer option option 84 alias app 46 48 54 58 60 64 68 72 76 80 aux directory dir 43 54 64 68 72 76 80 bistack size n 64 68 buf size n 54 64 68 72 76 80 c style errors 54 64 68 72 76 80 disable installer 40 46 48 55 60 64 68 72 76 enable installer 40 46 48 55 60 64 68 72 76 enable write18 43 55 72 76 80 error line n 55 64 68 7
93. nameis or then the remainder will be used as an argument to popen thus specifying lpr as the output file will automatically queue the file for printing as usual dvips will print to the local printer device PRN when name is lpr and a program by that name cannot be found o turns off the automatic sending of control D See the f option for how to override this 0 z offset y offset Move the origin by z offset y offset a comma separated pair of dimensions such as 1in 3cm The origin of the page is shifted from the default position of one inch down one inch to the right from the upper left corner of the paper by this amount This is usually best specified in the printer specific configuration file This is useful for a printer that consistently offsets output pages by a certain amount You can use the file testpage tex to determine the correct value for your printer Be sure to do several runs with the same 0 value some printers vary widely from run to run If your printer offsets every other page consistently instead of every page your best recourse is to use bop hook see the Dvips manual for more information p num The first page printed will be the first one numbered num Default is the first page in the document If num is prefixed by an equals sign then it and the argument to the 1 option if specified is treated as a physical absolute page number rather than a value to compare with the TEX icountO values sto
94. nd the names of all fonts and control sequences must exceed string_vacancies by the total length of the program s own strings which is currently about 30000 quiet Suppress all output except errors record package usages f1le Record all package usages and write them into file recorder Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension f1s 77 APPENDIX A MANUAL PAGES A 13 PDFTEX save size n Set the internal compiler variable save_size to n save_size is the amount of space for saving values outside of current group src specials Embed source file information source specials in the DVI file stack size n Set the internal compiler variable stack_size to n stack_size is the maximum number of simultaneous input sources string vacancies n Set the internal compiler variable string_vacancies to n string_vacancies is the minimum number of characters that should be available for the user s control sequences and font names after the compiler s own error messages are stored tcx name Process the TCX table name See Section 4 2 11 for a discussion of TCX tables terminal oem Use the active code page e g 437 for console output time statistics Show processing time statistics trace traceflags Write trace messages into the DebugView window The traceflags argument is a comma separated list of trace categories access Access
95. of updateable packages is displayed Choose the packages you wish to update MiKTeX Update Wizard 2 2 3 Update List Select the packages pou vish fo update The following updates are avaliable Select the packages pou wich to update Click Mest to stait the update process Manne Old Hes hyperral miee Click Next gt to start the update process 6 MiKTEX Update Wizard now updates the selected packages 29 CHAPTER 3 CONFIGURING MIKTBX 3 1 INSTALLING UPDATES MiKTeX Update Wizard 2 2 3 Update Selected packages ale being updated i kmi CE Overall progress ETh 1 seconds LLL LE LE LL LLE LLO E O LLO LEO EL LLE LL LE LL LLL LLE LOL Pe andres im packages hypeirel cab unknown tee 341610 bytes 80 06 KB S manda mike im packages kanec cab unknown ze Cancel Click Next gt when the update operation is complete 7 MiKTEX Update Wizard displays the last page MiKTeX Update Wizard 2 2 3 Completing the MiKTeX Update Wizard Tou hare sucestully completed the ble Tex Update rad The packages pou selected have been updabed To eak the wizard cick Finish Click Finish to close the wizard The wizard records update events into a log file by the name of update currentdate log This file can be found in the MiKTEX config directory usually C localtexmf miktex config 30 CHAPTER 3 CONFIGURING MIKTEX 3 2 PACKAGE MANAGEMENT 3 2 Package Management You use
96. ol sequences must exceed string_vacancies by the total length of the program s own strings which is currently about 30000 quiet Suppress all output except errors record package usages f1le Record all package usages and write them into file recorder Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension f1s save size n Set the internal compiler variable save_size to n save_size is the amount of space for saving values outside of current group src specials Embed source file information source specials in the DVI file stack size n Set the internal compiler variable stack_size to n stack_size is the maximum number of simultaneous input sources string vacancies n Set the internal compiler variable string_vacancies to n string_vacancies is the minimum number of characters that should be available for the user s control sequences and font names after the compiler s own error messages are stored tcx name Process the TCX table name See Section 4 2 11 for a discussion of TCX tables 56 APPENDIX A MANUAL PAGES A 4 ETEX terminal oem Use the active code page e g 437 for console output time statistics Show processing time statistics trace traceflags Write trace messages into the DebugView window The traceflags argument is a comma separated list of trace categories access Accesses to disk files config Retriev
97. ompress_level 9 use the best level of compression decimal_digits 3 max 3 digits after the decimal point horigin 1 true in horizontal origin offset image_resolution 300 when not specified embed images at 300 DPI move_chars 1 move chars in 0 31 to higher area output_format 1 the implicit output will be PDF page_height 297 true mm A4 paper height page_width 210 true mm A4 paper width pdf_minorversion 4 produce PDF 1 4 pk_resolution 600 use PK fonts at 600 DPI vorigin 1 true in vertical origin offset The configuration file sets default values for these parameters and they all can be overridden in the TEX source file Dimensions can be specified as true which makes them immune for magnification when set compress_level This integer parameter specifies the level of text and in line graphics compression pdfTEX uses Zip compression A value of 0 means no compression 1 means fastest 9 means best 2 8 means something in between Just set this value to 9 unless there is a good reason to do otherwise 0 is great for testing macros that use pdfliteral 93 APPENDIX C PDFTEX CFG THE PDFTEX C 1 PDFTEX CFG SETTINGS decimal_digits This integer specifies the preciseness of real numbers in PDF page descriptions lt gives the maximal number of decimal digits after the decimal point of real numbers Valid values are in range 0 5 A higher value means more precise output but also results in a much larger file size
98. only included PDFs with versions less than 1 3 A suitable default value is 4 pk_resolution One can use this entry to specify the resolution for bitmap fonts Nowadays most printers are capable to print at least 600 dots per inch so this is a reasonable default 94 Appendix D updmap cfg Configuration Settings for Outline Fonts The configuration file updmap cfg contains declarative instructions which will be used to build font map files CAUTION O It is highly recommended that you edit a local version of updmap cfg when chang ing or adding instructions See Section 3 11 1 for more information D 1 updmap cfg Instructions updmap cfg can contain the following instructions dvipsPreferOutline value LW35 Specifies whether Dvips prefers bitmap fonts or outline fonts if both are available Valid values are true default and false Independend of this setting outlines can be forced by putting p psfonts_t1 map into a configuration file that Dvips reads Bitmaps for the fonts in question can be forced by putting p psfonts_pk map into a configuration file Such configuration files are provided which can be enabled via dvips Poutline resp dvips Ppk value Specifies which fonts for the Basic 35 LaserWriter Fonts will be used and how their file names are chosen Valid values URW URW fonts with vendor file names e g n0190641 pfb 95 APPENDIX D UPDMAP CF
99. osals for handling more than one input encoding TCX files were chosen because they follow Knuth s original ideas for the use of the xchr and xord tables He ventured that these would be changed in the WEB source in order to adjust the actual version to a given environment It turned out however that recompiling the WEB sources is not as simple task as Knuth predicted therefore TCX files providing the possibility of changing of the conversion tables on on the fly has been implemented instead 43 CHAPTER 4 USING MIKTpX 4 3 TEXIFY THE MIKTEX COMPILER DRIVER This approach limits the portability of TEX documents as some implementations do not support it or use a different method for input internal reencoding It may also be problematic to determine the encoding to use for a TEX document of unknown provenance in the worst case failure to do so correctly may result in subtle errors in the typeset output While TCX files can be used with any format using them breaks the IATEX inputenc package This is why you should either use tcxfile or inputenc in ATEX input files but never both This is entirely independent of the MLTeX extension whereas a TCX file defines how an input keyboard character is mapped to TpX s internal code MLTeX defines substitutions for a non existing character glyph in a font with a accent construction made out of two separate character glyphs TCX files involve no new primitives it is not possible to specify
100. red in the DVI file Thus using p 3 will start with the third page of the document no matter what the pages are actually numbered pp first last Print pages first through last equivalentto p first 1 last except that multiple pp options accumulate unlike p and 1 The separator can also be P printer Read the configuration file config printer which can set the output name most likely o lpr Pprinter resolution METAFONT mode and perhaps font paths and other printer specific defaults It works best to put sitewide defaults in the one master config ps file and only things that vary printer to printer in the config printer files config ps is read before config printer q Run quietly Don t chatter about pages converted etc to standard output report no warnings only errors to standard error 52 APPENDIX A MANUAL PAGES A 3 DVIPS rx R S S Output pages in reverse order By default page 1 is output first Run securely This disables shell command execution in special via and config files via the E pipes as output files and opening of any absolute filenames Enclose the output in a global save restore pair This causes the file to not be truly conformant and is thus not recommended but is useful if you are driving a deficient printer directly and thus don t care too much about the portability of the output to other environments num Set the maximum number of pages in each
101. rmats are often prefixed with an e hence etex as the extended version of tex and elatex as the extended version of latex However eplain is an exception to this rule The einitex and evirtex commands are e TpX s analogues to the initex and virtex commands e T X s handling of its command line arguments is similar to that of TEX A 4 3 Options alias app Pretend to be app This affects both the format used and the search paths aux directory dir Keep auxiliary files in dir This implies include directory dir buf size n Set the internal compiler variable buf_size to n buf_size is the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname c style errors Show C C style error messages This switch implies scrollmode 54 APPENDIX A MANUAL PAGES A 4 ETEX disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable write18 Enable the write18 construct see Section 4 2 10 error line n Set the internal compiler variable error_line to n error_line is the width of context lines on terminal error messages font max n Set the
102. s installing 27 updmap cfg 95 dvipdfmDownloadBase14 96 dvipsDownloadBase35 96 dvipsPreferOutline 95 instructions 95 LW35 95 ADOBE 96 ADOBEkb 96 URW 95 URWkb 96 Map 96 MixedMap 96 pdftexDownloadBase14 96 URW fonts 95 virtual fonts resolving 48 WinEdt getting 9 wininet dll 11 99
103. s must be at least 255 and at most 32510 max_in_open n Maximum number of input files and error insertions that can be going on simultaneously max_print_line n Width of longest text lines output should be at least 60 max_strings n Maximum number of strings must not exceed 1073741823 max_wiggle n Number of autorounded points per cycle 89 APPENDIX B MIKTEX INI THE MIKTEX B 2 MIKTEX INI SETTINGS mem_bot n Smallest index in the mem array dumped by initex must not be less than mem_min mem_max n Greatest index in TEX s internal mem array must be strictly less than 1073741823 mem_min n Smallest index in TpX s internal mem array must be 0 or more must be equal to mem_bot in initex otherwise lt mem_bot mem_top n Largest index in the mem array dumped by initex must be substantially larger than O and not greater than mem_max move_size n Space for storing moves in a single octant nest_size n Maximum number of semantic levels simultaneously active param_size n Maximum number of simultaneous macro parameters path_size n Maximum number of knots between breakpoints of a path pool_size n Maximum number of characters in strings including all error messages and help texts and the names of all fonts and control sequences must exceed string_vacancies by the total length of TgX s own strings which is currently about 23000 save_size n Space for saving values outside of current group must be
104. s omitted A 12 omega A 12 1 Synposis omega alias app aux directory dir buf size n c style errors disable installer enable installer enable write18 error line n half error line n halt on error help hhelp include directory dir initialize interaction mode job name name job time file max in open n max print line n max strings n mem bot n mem max n mem min n mem top n nest size n output directory dir param size n pool size n quiet record package usages file recorder save size n src specials stack size n string vacancies n time statistics trace traceflags trie op size n trie size n undump fmtname version command file A 12 2 Description Q is a 16 bit enhanced version of TEX A 12 3 Options alias app Pretend to be app This affects both the format used and the search paths aux directory dir Keep auxiliary files in dir This implies include directory dir buf size n Set the internal compiler variable buf_size to n buf_size is the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname c style errors Show C C style error messages This switch implies scrollmode disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options
105. see Section 3 2 3 enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTEX Options see Section 3 2 3 enable write18 Enable the write18 construct see Section 4 2 10 72 APPENDIX A MANUAL PAGES A 12 OMEGA error line n Set the internal compiler variable error_line to n error_line is the width of context lines on terminal error messages half error line n Set the internal compiler variable half_error_line to n half_error_line is the width of first lines of contexts in terminal error messages halt on error Quit after the first error help Give help and exit hhelp Show the manual page in an HTML Help window and exit when the window is closed include directory dir Prepend dir to the search path initialize Become the NI variant of the compiler interaction mode Set the interaction mode Must be one of batchmode nonstopmode scrollmode and errorstopmode The meaning of these modes is the same as the corresponding commands job name name Set the name of the job jobname This has an affect on the output file names job time file Set the time stamp of all output files equal to files time stamp max in open n Set the internal compiler variable max_in_open to n max_in_open is the maximum number of input files and error insertions that can be going on simultaneously max print line n Set the interna
106. source specials 4 2 6 Quoted File Names The TEX compiler can handle quoted file names This makes it possible to specify long file names that contain spaces For example to compile the input file long file name tex you start TEX as follows latex long file name This produces the DVI file long file name dvi The log file is named long file name log You can to some extent use quoted file names inside the TEX document For example input extra long file name This would cause TeX to read the file extra long file name tex Things get a little bit complicated if you want to use the TEX primitive include You have to write something like the following include extra space long space filelspace name 4 2 7 Specifying Additional Input Directories The option include directory dir allows you to extend the input search path for one invocation of TEX For example tex include directory C My TeX foo tex 42 CHAPTER 4 USING MIKTEX 4 2 TEX amp FRIENDS SPECIALITIES This prepends C My TeX to the input search path i e C My TeX will be searched first when TEX looks out any input file including foo tex You can specify either absolute paths as in the example above or relative paths 4 2 8 Specifying the Output Directory The option output directory dir causes TEX to create all output files in another directory For example gt mkdir C texoutput gt latex output directory C texoutput
107. ssages font max n Set the internal compiler variable font _max to n font_max is the maximum internal font number must not exceed 5000 font mem size n Set the internal compiler variable font __mem_size to n font_mem_size is the size in TEX memory words of the font memory half error line n Set the internal compiler variable half_error_line to n half_error_line is the width of first lines of contexts in terminal error messages halt on error Quit after the first error help Give help and exit hhelp Show the manual page in an HTML Help window and exit when the window is closed include directory dir Prepend dir to the search path initialize Become the NI variant of the compiler interaction mode Set the interaction mode Must be one of bat chmode nonstopmode scrollmode and errorstopmode The meaning of these modes is the same as the corresponding commands 76 APPENDIX A MANUAL PAGES A 13 PDFTEX job name name Set the name of the job jobname This has an affect on the output file names job time file Set the time stamp of all output files equal to file s time stamp max in open n Set the internal compiler variable max_in_open to n max_in_open is the maximum number of input files and error insertions that can be going on simultaneously max print line n Set the internal compiler variable max print line to n max print line is the width of longest text lines output should
108. t record package usages f1le Record all package usages and write them into file select sel Select pages to be copied The syntax for sel is start n where start is the starting page specification for example 2 or 5 2 and n optional is the maximum number of pages to be copied You can use up to 10 select options This option cannot be used together with max pages or page start 48 APPENDIX A MANUAL PAGES A 3 DVIPS trace traceflags Write trace messages into the DebugView window The traceflags argument is a comma separated list of trace categories access Accesses to disk files config Retrieval of configuration settings error Error conditions filesearch File search fndb File name database fontinfo Font information open File openings process Process invocations tempfile Temporary files version Show version information and exit A 3 dvips A 3 1 Synopsis dvips a A b num B c num C num d num D num e num E f F G h name i Iimageoptioms k K 1 num m M n num N o name 0 offset p num pp pagelist P printername q r R s S num t papertype T offset u name U V x num X num y num Y num z Z dvifile A 3 2 Description dvips takes a DVI file produced by tex or by some other processor such as gftodvi and converts it to PostScript The DVI file may be sp
109. t be put into psfonts map as the downloadable file for that font This is useful only for those fonts for which you do not have real outlines being downloaded to printers that have no resident fonts i e very rarely num Set the x magnification ratio to num 1000 Overrides the magnification specified in the DVI file Must be between 10 and 100000 It is recommended that you use standard magstep values 1095 1200 1440 1728 2074 2488 2986 and so on to help reduce the total number of PK files generated num may be a real number not an integer for increased precision num Set the horizontal resolution in dots per inch to num num Set the y magnification ratio to num 1000 See x above num Set the vertical resolution in dots per inch to num Pass html hyperdvi specials through to the output for eventual distillation into PDF This is not enabled by default to avoid including the header files unnecessarily and use of temporary files in creating the output Compress bitmap fonts in the output file thereby reducing the size of what gets downloaded Especially useful at high resolutions or when very large fonts are used May slow down printing especially on early 68000 based PostScript printers Generally recommend today and can be enabled in the configuration file 53 APPENDIX A MANUAL PAGES A 4 ETEX A 3 4 Documentation Dvips A DVI to PostScript Translator Run texdoc dvips A 4 etex A 4 1 Synopsis etex alias
110. ted list of directory specifications MiKTEX traverses the list from left to right when it searches for a file A directory specification is a directory path with embedded contro sequences The following control sequences can be used R A placeholder for the TEXMF root directory A flag which causes MiKTEX to search recursively B 1 1 Example Assuming that C localtexmf C texmf is the list of TEXMF root directories the search path R tex plain R tex generic R tex causes TEX to search its input files in the following locations 1 In the current directory In the directory C localtexmf tex plain and in all folders below it 2 3 In the directory C texmf tex plain and in all folders below it 4 In the directory C localtexmf tex generic and in all folders below it 5 In the directory C texmf tex generic and in all folders below it 85 APPENDIX B MIKTEX INI THE MIKTEX B 2 MIKTEX INI SETTINGS 6 In the directory C localtexmf tex and in all folders below it 7 Inthe directory C texmf tex and in all folders below it B 1 2 Testing a Search Path You can use findtexmf to test whether an input file can be found via the configured search path For example run findtexmf a4 sty to search for the TEX style file a4 sty If the search succeeds then findtexmf reports the absolute path to the file as in gt findtexmf a4 sty C texmf tex latex ntgclass a4 sty gt B 2 mikte
111. ter than mem_max move size n Set the internal compiler variable move_size to n move_size is the space for storing moves in a single octant output directory dir Create output files in dir This implies include directory dir param size n Set the internal compiler variable param_size to n param_size is the maximum number of simul taneous macro parameters path size n Set the internal compiler variable path_size to n path_size is the maximum number of knots between breakpoints of a path pool size n Set the internal compiler variable pool_size to n pool_size is the maximum number of charac ters in strings including all error messages and help texts and the names of all fonts and control sequences must exceed string_vacancies by the total length of the program s own strings which is currently about 30000 quiet Suppress all output except errors record package usages f1le Record all package usages and write them into file recorder Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension f1s screen Enable screen output stack size n Set the internal compiler variable stack_size to n stack_size is the maximum number of simultaneous input sources string vacancies n Set the internal compiler variable string_vacancies to n 65 APPENDIX A MANUAL PAGES A 9 MPM string_vacancies is the minimum number of characters that shoul
112. terminal error messages halt on error Quit after the first error help Give help and exit 80 APPENDIX A MANUAL PAGES A 14 TEX initialize Become the NI variant of the compiler include directory dir Prepend dir to the search path interaction mode Set the interaction mode Must be one of bat chmode nonstopmode scrollmode and errorstopmode The meaning of these modes is the same as the corresponding commands job name name Set the name of the job jobname This has an affect on the output file names job time file Set the time stamp of all output files equal to file s time stamp max in open n Set the internal compiler variable max_in_open to n max_in_open is the maximum number of input files and error insertions that can be going on simultaneously max print line n Set the internal compiler variable max print line to n max print line is the width of longest text lines output should be at least 60 max strings n Set the internal compiler variable max_strings to n max_strings is the maximum number of strings mem bot n Set the internal compiler variable mem_bot to n mem_bot is the smallest index in the internal memory array dumped by the N variant of the com piler must not be less than mem_min mem max n Set the internal compiler variable mem_max to n mem_max is the greatest index in the internal memory array mem min n Set the internal compiler variable mem_min to n m
113. ternet to install updates from a remote package repository Choose Local folder if you are mirroring a remote package repository on your computer Chosse MiKTeX CD if you have a new edition of the MiKT X CD Click Next gt to continue 4 If you have chosen to install packages from a remote package repository MiKTEX Update Wizard lists the available package repositories Choose the nearest repository 28 CHAPTER 3 CONFIGURING MIKTgX 3 1 INSTALLING UPDATES MiKTeX Update Wizard 2 2 3 Remote Package Hepoztorg Speci the location of aremote package repository Packages will be downloaded hom the remote package epatta selected below in arder lo reduce network load i recommended thal pau use the remote package reponlaiy which E located in the closest meteor pecera bo your sibe on pou may wish bo obtain a copy of the ME Te LO A ses Hap vv rmikbes oag Available package meposfonez Courktiy UAL Description Genmany ftp Mp uni bielefeld de pub ten sebene vina mkt ETAN mimar Germany p Aipu sugat de pubiies semsa mike CTAN miror Genmany ftp Mp deme devtex archives systema winda mikies t CTAN Dante fpg riua gumma Aan sems vanda mkien CTAN mior fimp comp hk bu edu hk pub T aA CTAN systems CTAM mimar pn hp szak hu pub tess sben arnd i mik her br TAB raro pociones entre tin CTAN mima fps Tip lab kdd co p CTAN aystemayeande mikbens ETAN mamor mm oF Click Next gt to continue 5 A list
114. that an input keyboard character maps to more than one character Specifying TCX files e You can specify a TCX file to be used for a particular TEX run by specifying the command line option translate file tcazfile or preferably specifying it explicitly in the first line of the main document 78 translate file tcxfile e TCX files are searched for along the TCXPath path e initex ignores TCX files MiKTEX comes with at least two TCX files i11 t1 tcx and il2 t1 tcx These support ISO Latin 1 and ISO Latin 2 respectively with Cork encoded fonts a k a the T1 encoding TCX files for Czech Polish and Slovak are also provided Syntax of TCX files 1 Line oriented Blank lines are ignored 2 Whitespace is ignored except as a separator 3 Comments start with and continue to the end of the line 4 Otherwise a line consists of one or two character codes src dest 5 Each character code may be specified in octal with a leading 0 hexadecimal with a leading Ox or decimal otherwise Values must be between 0 and 255 inclusive decimal 6 If the dest code is not specified it is taken to be the same as src 7 If the same src code is specified more than once it is the last definition that counts Finally here s what happens when TEX sees an input character with code src it 1 changes src to dest and 2 makes code the dest printable i e printed as is in diagnostics and the log file instead of in notation
115. the PostScript userdict Make each section be a separate file a sectionis a part of the document processed independently most often created to avoid memory overflow The filenames are created replacing the suffix of the supplied output file name by a three digit sequence number This option is most often used in conjunction with the S option which sets the maximum section length in pages if i is specified and S is not each page is output as a separate file For instance some phototypesetters cannot print more than ten or so consecutive pages before running out of steam these options can be used to automatically split a book into ten page sections each to its own file I imageoptions j K Specify image options 1 2 3 Select PostScript level 1 2 or 3 c g Use c if you have a color printer or g for conversion to grayscale Color printing requires PostScript level 2 or higher f r 8 h Use f to get flate encoding requires PostScript level 3 r to get run length encoding re quires PostScript level 2 8 to get ASCII85 encoding instead ASCII Hex encoding requires PostScript level 2 or h to use ASCII Hex encoding Flate encoding run length encoding and one from ASCII85 or ASCII Hex encoding can be used combined da Use d to turn draft mode on Bitmap images are not printed only the place is marked a O t 1 m S To convert an alpha channel into an EPS level 3 masked bitmap use the a option By use of o you
116. tomatic Package Installation The MiKTEX programs have the ability to install missing packages on the fly You can configure this feature with MiKTEX Options 1 Click Start Programs gt MiKTeX MiKTeX Options 2 The MiKTEX Options window opens Click on the drop down list labeled Install missing packages on the fly 3 Select one of the following items Yes Choose this to enable automatic package installation No Choose this to disable automatic package installation Ask me first Choose this if you want to be asked everytime a package needs to be installed 3 3 Managing TEXMF Directory Hierarchies The standard setup process creates two TEXMF directories e C texmf the installation directory see Section 2 4 1 e C localtexmf the local TEXMF directory see Section 2 4 2 You can manage the TEXMF directory hierarchies with the help of MiKTEX Options 1 Click Start Programs gt MiKTeX MiKTeX Options 2 The MiKTEX Options window opens Click on the Roots tab 3 The Roots page displays a list of TEXMF root directories that are used by MiKTEX 32 CHAPTER 3 CONFIGURING MIKTEX 3 3 MANAGING TEXMF DIRECTORY MiKTeX Options 2 4 1461 Gereral Roots Tax Formals Languages Packages TESMF root directonas Path Drescnphice C locskexml Local TE MF directa Chemi The order im the list determines the order m vehach Ehe rool drectones are sesiched The local diechon recehres ordhetly generated fi
117. trees private Install MiKTEX for the current user only This is the default program folder folder Register the name of the MiKTEX program folder remote package repository url Register the URL of the remote package repository shared Install MiKTEX for everyone This option requires administrative privileges unattended Run in unattended mode This is an example of a setupwiz opt file 24 CHAPTER 2 INSTALLING MIKTgxX 2 3 ITEMS IN THE START MENU install from local repository local package repository mirrors tm packages installation directory C texmf local directory C localtexmf unattended In this example MiKTEX is installed from the network directory mirrors tm packages The wizard is run in unattended mode 2 2 2 Shared Network Installation Setting up a shared network installation requires a copy of the MiKTEX CD R see Section 1 3 2 Create a shared directory say server miktex which contains the contents of the MiKTEX CD R The MiKTEX CD R comes with a special version of the setup wizard which offers users the option Prepare to run MiKTeX from the CD 2 3 Items in the Start Menu MiKTEX Setup Wizard installs the following menu items in the Windows start menu MiKTeX Help LaTeX2e Reference A LaTeX2e reference manual MiKTeX Help MiKTeX FAQ Answers to frequently asked questions MiKTeX Help MiKTeX Manual The MiKTEX manual MiKTeX Help
118. ttings are read from the file config The Dvipdfm manual run texdoc dvipdfm describes this file 36 CHAPTER 3 CONFIGURING MIKTEX 3 9 CONFIGURING DVIPS NOTE The configuration file for Dvipdfmx the successor of Dvipdfm has the name dvipdfmx cfg You must edit a local version of config resp dvipdfmx cfg if you have to change Dvipdfm configura tion settings Settings in the local version of config resp dvipdfmx cfg take precedence over those specified in the installed version i e you can easily override settings such as the paper format For example follow these steps if want to change the default paper format to Letter 1 Use the Explorer interface to open the directory dvipdfm config relative to the local TEXMF di rectory see Section 2 4 2 Possibly you have to create this directory if it doesn t exist yet 2 Create a local version of config resp dvipdfmx cfg if it doesn t yet exist use the Explorer interface to create a new text document with the name of config resp dvipdfmx cfg 3 Open config resp dvipdfmx cfg with Notepad 4 Insert change the following lines p letter 5 Save the file and exit Notepad 6 Refresh the file name database see Section 3 4 3 9 Configuring Dvips Dvips configurations settings are read from the file config ps The Dvips manual run texdoc dvips describes this file It is recommended that you edit a local version of config ps if you h
119. urceforge net project showfiles php group_id 10783 gt 2 Start the wizard setup exe You will be presented with the welcome page MiKTeX Setup Wizard 2 2 Welcome to the MiKTeX Setup Wizard This wizard instale ME Tex on your computer Mik Te is a hee Te distibubon hor aindar To continue eh Setup cick Mari Click Next gt to advance to the next page 3 Click on the Download only radio button 2chttp www miktex org faq gt Schttp sourceforge net project showfiles php group_id 10783 gt CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTIONS MiKTeX Setup Wizard 2 2 7 Setup Task Choose the primary task MET es Setup Wizard is lo cany out Choose ore of the following setup taska Dowriload regured MIKT ex packages lo a local package apatita O Install Instal METE from a local package repository Click Next gt to go to the next page 4 Click on the package set that you wish to download MiKTeX Setup Wizard 2 2 7 Package Set Choose a package sal O Smal Download ste 23 MB Seeondek 100MB Hal set of packages Tex recommended LaTe packages pte Typel ante Large Download see 64 HB Sie on dek 100MB Ther adds Omega eT and advanced macro packages ike ConT eti Download ave 143MB See on dek T00 ME All avaiable packages Click Next gt to go to the next page 5 Choose a download location CHAPTER 2 INSTALLING MIKTgxX 2 1 INSTALLATION INSTRUCTI
120. x A 1 1 Synopsis bibtex alias app disable installer enable installer help hhelp include directory dir min crossrefs n quiet record package usages file trace traceflags version auzname A 1 2 Description bibtex reads the top level auxiliary aux file that was output during the running of latex or tex and creates a bibliography bb1 file that will be incorporated into the document on subsequent runs of ATEX or TEX The auzname on the command line must be given without the aux extension If you don t give the auzname the program prompts you for it bibtex looks up in bibliographic database bib files specified by the bibliography command the en tries specified by the cite and nocite commands in the l4TFX or TEX source file It formats the information from those entries according to instructions in a bibliography style bst file specified by the bibliogra phystyle command and it outputs the results to the bb1 file The ATEX reference manual explains what a IATEX source file must contain to work with bibtex Appen dix B of the manual describes the format of the bib files The Bib TEXing document describes extensions and details of this format and it gives other useful hints for using bibtex A 1 3 Options alias app Pretend to be app This affects both the format used and the search paths disable installer Disable automatic installation of missing packages Specifying this option ov
121. x ini Settings The MiK TEX configuration file is divided into several named sections Each section contains configuration settings for a specific application or feature A section starts with a line containing the name of the section in brackets as in TeX A section contains assignments to named values Each assignment stands on a separate line as in Input Dirs R tex plain R tex generic R tex B 2 1 bibtex Input Dirs searchpath Search path for Bib TEX input files both databases and style files min_crossrefs n Minimum number of cross refs required for automatic cite_list inclusion B 2 2 dvipdfm Input Dirs searchpath Where Dvipdfm searches for the configuration file config MAPPath searchpath Where Dvipdfm searches for font mapping files map PSPath searchpath Where Dvipdfm searches for font encoding files enc B 2 3 dvips CONFIGPath searchpath Where Dvips searches configuration files config ENCPath searchpath Where Dvips searches for font encoding files enc GraphicsPath searchpath Where Dvips searches for graphics files eps 86 APPENDIX B MIKTEX INI THE MIKTEX B 2 MIKTEX INI SETTINGS MAPPath searchpath Where Dvips searches for font mapping files map PSPath searchpath Where Dvips searches for all sorts of PostScript related files afm pfb pro B 2 4 Graphics The Graphics section contains graphics conversion rules A rule
122. x iterations n Limits the number of iterations to prevent endless processing The default for n is 5 mkidx option option Pass option to the index generator pdf p Use pdftex or pdflatex for processing quiet q silent s No screen output unless errors plies batch run viewer Run a viewer on the resulting DVI PDF file Src Pass src specials to the TEX compiler texinfo cmd t cmd Insert cmd after setfilename in copy of input file Multiple values accumulate tex option option Pass option to the compiler verbose V Print information on what is being done version v Display version information and exit successfully viewer option option Pass option to the viewer A 15 4 Environment Variables The values of the BIBTEX LATEX or PDFLATEX MAKEINDEX MAKEINFO TEX or PDFTEX and TEXINDEX environment variables are used to run those commands if they are set A 15 5 Aliases tex2dvi Equivalent to texify 84 Appendix B miktex ini The MiKT EX Configuration File MiKTEX reads configuration settings from the file miktex ini CAUTION O It is highly recommended that you edit a local version of miktex ini when chang ing configuration settings See Section 3 7 for more information B 1 About Search Paths Search paths are used by MiKTEX to find files such as TEX input files within a comprehensive directory hierarchy A search path is a semicolon separa
123. y run viewer foo tex Opens the output file foo dvi unless there are compile erros texify tex opt src viewer opt 1 s 200 foo tex run viewer foo tex Compiles foo tex with source file information src and then initiates forward DVI search to open foo dvi at the source special location 200 foo tex The previewer option 1 re uses an existing previewer window See the Yap manual for a complete list of previewer options 4 4 mtprint The MiKT X Print Utility You can use the MiKT X Print Utility to send TEX output files dvi to a printing device The MiKTEX Print Utility is started in the command prompt window To print the DVI file foo dvi do this mtprint foo dvi Printing works as follows 1 The DVI file is converted by Dvips into an intermediate PostScript file 2 The PostScript file is then processed by Ghostscript to produce a series of Windows Bitmaps 3 These bitmaps are then sent to the printer If you have a PostScript printer then you can speed up the process by using using the print method option mtprint print method ps foo dvi This will omit steps 2 and 3 i e the intermediate PostScript file will be sent directly to the printer 45 Appendix A Manual Pages This chapter contains manual pages for various programs Only those programs are included which have non standard features built in Use the texdoc utility to find documentation for programs not listed here A 1 bibte

MiKTeX Manual

Contents

Download Pdf Manuals

Related Search

Related Contents