Home

MiKTeX 2.9 Manual - Revision 2.9.5671

1. screen Enable screen output stack size n Set the maximum number of simultaneous input sources string vacancies n Set 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 Must be at least 25000 less than pool size but doesn t need to be nearly that large tcx name time statistics Show processing time statistics trace tracestreams Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream names Chapter 6 Trace Streams 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 oe amp line version Show version information and exit Environment MFINPUTS Extra paths to locate METAFONT input and openin files See also The METAFONTbook ISBN 0 201 13444 6 52 Programs Name miktexsetup MiKTeX setup utility Synopsis miktexsetup options download miktexsetup options install miktexsetup options uninstall Description The MiKTeX Setup Utility is used to download install and uninstall MiKTeX This utility is the command line counterpart of the MiKTeX Setup Wizard see setupwiz 1 i e it is suitable for unattended setup tasks The download task creates a local package package repository which is a mirror of the remote package repository It is poss
2. TEMFONTS Extra paths to locate TeX font metric files See also The XeTeX reference guide Run mthelp xetexref 87 Chapter 4 Files Files Name pdftex cfg configuration Settings for pdf TeX Description pdfTeX configurations settings are read from the file pdftex cfg when a format file is being created by pdfTeX Caution Do not edit this file directly Run initexmf edit config file pdftex cfgtoedit configuration settings for pdfTeX Instructions This section is borrowed from the pdfTeX manual A typical pdftex cfg file looks like this setting up output for A4 paper size and the standard TeX offset of 1 inch compress level 9 decimal digits 3 horigin 1 true in vorigin 1 true in image resolution 300 move chars 1 output format 1 page width 210 true mm page height 297 true mm pdf minorversion 4 pk resolution 600 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 t rue which makes them immune for magnification when set compress level decimal digits horigin amp vorigin This integer parameter specifies the level of text and inllline graphics compression pdf TeX 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
3. MiKTeX can be removed by selecting the uninstall task shared should be specified if MIKTeX is installed for all users C gt miktexsetup verbose shared uninstall 55 Programs Name miktex tools experimental TeX additions Description MiKTeX Tools should be regarded as an addition to the host TeX system installed on your system The following utilities are included miktex pdftex MiKTeX implementation of the pdfTeX engine mpm MiKTeX Package Manager mthelp MiKTeX Help Utility System wide configuration In order to configure MiKTeX Tools for your system you run the MiKTeX configuration utility initexmf and the MiKTeX package manager mpm sudo initexmf admin configure sudo mpm admin update db This is what happens e The TEXMF trees of the host TeX system are collected the information is written to var 1lib miktex texmf miktex config miktexstartup ini the system wide file name database is created e the package database is downloaded from the MiKTeX package repository Per user configuration Once you have configured MiKTeX Tools for the system each user should create the per user file name database initexmf update fndb Without this step the on the fly package installer will not work MiKTeX pdfTeX MiKTeX pdfTeX is an alternative pdfTeX engine The engine features integrated package management 1 e missing packages will be installed on the fly after confir
4. MiKTeX configuration utility Synopsis initexmf option Description initexmf is used to configure MiKTeX User mode vs administrative mode This utility can be run in two modes User mode default Administrative mode Only user related MiKTeX configuration and data files are modified Only system wide MiKTeX configuration and data files are modified The utility should be run as the system administrator By default the utility runs in user mode You can turn on administrative mode with the admin option For example if you want to update the system wide file name database you invoke the utility as follows initexmf admin update fndb Options admin configure dump dump key edit config file configfile force list modes mklinks Run in administrative mode This option is only available on UNIX system like platforms Configure MiKTeX kpsewhich is run to find existing TEXMF trees the information is written to var lib miktex texmf miktex config miktexstartup ini ifadministrative mode is turned on otherwise the information is written to miktex miktex config miktexstartup ini the system wide per user file name database is created if administrative mode is turned on off Dump the specified memory dump file Open the specified config file in an editor Force mklinks to overwrite existing executables 47 Programs Create an executable for
5. The first task is to download MiKTeX into a local package repository C gt miktexsetup verbose 54 Programs local package repository C miktex repository package set complete download This command will create a local package repository in C miktex repository It is possible to interrupt Control C this operation at anytime and resume it later by running the same command again Installing for all users In this example MiKTeX is installed for all users from the local package repository C miktex repository User directories are specified by using environment variables VARNAME which are expanded at run time delayed expansion You can first specify print info only in order to perform a dry run C gt miktexsetup verbose local package repository C miktex repository shared user config lt APPDATA gt MiKTeX 2 9 user data lt LOCALAPPDATA gt MiKTeX 2 9 user install lt APPDATA gt MiKTeX 2 9 print info only install setup task install from local package repository local package repository C miktex repository package level complete install for all users yes use registry yes modify path yes common install root C Program Files x86 MiKTeX 2 9 user install root lt APPDATA gt MiKTeX 2 9 user config root lt LOCALAPPDATA gt MiKTeX 2 9 user data root lt APPDATA gt MiKTeX 2 9 program folder name MiKTeX 2 9 Uninstalling
6. Use name as the name of the format to be used instead of the name by which the program was called or a 64 Programs oe amp line version Show version information and exit Environment MFINPUTS Extra paths to locate METAFONT input and openin files MPINPUTS Extra paths to locate MetaPost input files See also AT amp T technical report CSTR 162 Run mthelp mpman 65 Programs Name mthelp MiKTeX help utility Synopsis mthelp option name Description mthelp is a utility to lookup TeX package documentation mthelp creates an HTML page which contains a short description of the package together with links to all documentation files An HTML viewer is started to view the page You can use the view to bypass the intermediate HTML file name should be the name of a package in the TeX distribution Options list only print only quiet version view List documentation files but do not start a viewer Print the command that would be executed to view the documentation but do not start the command Suppress all output except errors Show version information and exit Open the main documenation file in a viewer Environment I KT KT KT EX VII EW dvi EX VII EW pdf EX VII EW ps KT KT EX _VI EX VII EW html EW txt DVI viewer PDF viewer PostScript viewer HT
7. ms win32 miktex tm packages lt misc cab unknown size lt When the update operation is complete click Next gt and then Finish Automatic Package Installation MiKTeX has the ability to automatically install missing packages MiKTeX asks your permission before installing a package see Figure 4 3 Automatic Package Installation 20 Maintenance Figure 4 3 Automatic Package Installation The required file tex latex memoir memoir cls is missing Itis a part of the following package Mame memoir Tite Typeset fiction non fiction and mathematical books The package will be installed from Always show this dialog before installing packages Click Install to start the installation of the package Click Cancel to cancel the installation If you do not want to see this dialog in the future clear the mark from the check box Always show this dialog before installing packages Your decision will be remembered Integrating Local Additions If you have files that you want to integrate into the MiKTeX setup you have several options Use the command line option include directory dir For example latex include directory C path to my style files thesis tex See the section called Specifying Additional Input Directories for more information Set environment variables For example set TEXINPUTS C path to my style files latex thesis tex 21 Maintenance See Chapter 5
8. nest size n no c styl rrors no pdf nonstopmode scrollmode and errorstopmode The meaning of these modes is the same as the corresponding commands Set the name of the job Sobname This has an affect on the output file names Set the time stamp of all output files equal to file s time stamp Change the total size in memory words of the main memory array Relevant only while creating memory dump files Set the maximum number of input files and error insertions that can be going on simultaneously Set the width of longest text lines output should be at least 60 Set the maximum number of strings Setthe maximum number of semantic levels simultaneously active Don t change the way error messages are printed Generate XDV extended DVI output rather than PDF 85 Programs output directory dir output driver cmd papersize string param size n parse first lin pool size n quiet record package usages file recorder restrict writel8 save size n src specials stack size n string vacancies n synctex n time statistics trace tracestreams trie size n undump name version Create output files in dir This implies include directory dir Use cmd as the XDV to PDF driver instead of xdvipdfmx Set PDF media size to string Setthe the maximum number of simultaneous macro parameters Check whether the first line of the ma
9. ssessesee IH HH eme ee rene 7 Suppressing Screen Output er eee EAEE OaE EEES PERE ETIESE PE inten ci 8 Setting the Name of the Output File sssssssse HI 8 Auto insertion of Source Specials sisisi serti i eira E a nennen hne hene 8 Quoted File Names 3 e rl RATEN ce eget ida 9 Specifying Additional Input Directories ssese HH 9 Specifying the Output Directory 20 0 0 eee eee cence HH emere ree 10 Specifying the Directory for Auxiliary Files sses cee ceeeceeeea seen nennen 10 Running Programs From Within TeX sssessssese IH 10 TCX Files Character Translations 1 0 00 east 11 texify The MiKTeX Compiler Driver esses eee HII 12 Printing erp EIE EE ne raid 13 Using a Viewer to Print DVI PDF Files ss HH 13 Using mtprint to Print DVI Files 0 222s2s44022 2202er nnne hene nnnem erre 13 4 MaimtenanCe etario ete 14 Refreshing the File Name Database sirrien i E EEE E 14 Setting the Preferred Paper Format oocooocnnccnnccnnccnnccnnconnconeconncnnncnnncnnronnronncnnccnncinnccnnions 15 selecting Languages ime erp e rere IE HON ERR REIP REPRE 15 Installing Updates sisisi nee eat Robin gsi 16 Automatic Package Installation 2 0 0 0 cece cece cece ence ence HH eee nhe 20 Integrating Local Add iia BR A Ab 21 A Short Excursion The TeX Directory Structure TDS ocooccocnccnnccoconcnnconcnnconcnnnonos 22 Walkthrough Registering
10. 50 63 69 72 79 84 draftmode dump 47 edit config file file 47 enable enctex 72 79 enable etex 72 84 enable installer 7 34 36 45 50 63 69 73 79 84 enable mltex 70 73 79 85 enable pipes 11 34 36 50 64 69 73 79 85 enable write18 10 69 73 79 85 error line n 50 69 73 79 85 even only 68 expand 82 extra mem bot n 69 73 79 85 extra mem top n 70 73 79 85 file line error 50 63 69 72 79 84 file line error style 50 63 69 72 79 84 file type filetype 43 find updates 59 font max n 73 79 85 font mem size n 73 79 85 force 47 gray font font 45 half error n 50 70 73 79 85 halt on error 51 64 70 73 79 85 hash extra n 73 80 85 help 34 36 43 45 51 59 64 70 73 80 82 85 hhelp 34 36 45 51 59 64 70 import all 59 import package 59 include directory dir 9 34 36 46 51 64 70 73 80 85 initialize 51 64 70 73 80 85 install some file 59 install package 59 interaction mode 51 64 70 73 80 85 job name name 8 51 64 70 73 80 85 job time file 51 64 70 73 80 85 Jabel font font 46 landscape 68 language lang 82 lib table size n 51 list 60 list modes 47 logo font font 46 mag mag 36 main memory n 51 70 73 80 85 max in open n 70 73 80 85 max pages n 36 max print line n 51 70 7
11. Environment variables to learn more about MiKTeX environment variables Register a user managed TEXMF directory Register the root of the directory tree which contains your files The directory tree must conform to the TDS standard i e you must imitate the directory tree in the MiKTeX installation directory usually C Program Files MMiKTeX 2 9 Tip This is the recommended method The rest of this section explains how you can register your own root directory A Short Excursion The TeX Directory Structure TDS Here is a brief summary of the TDS standard afmgoin root fonts afm supplier font dvi ps or pdf goin root doc latex package enc goin root fonts enc syntax bundle map goin root fonts map syntax bundle mf goin root fonts source supplier font ofb goin root fonts typel supplier font sty clsor fdgoin root tex latex package tim goin root fonts tfm supplier font ttf goin root fonts truetype supplier font vf goin root fonts vf supplier font Please run mthelp tds to learn more about the TDS Walkthrough Registering a User Managed TEXMF Directory In this walkthrough we assume that your own additions are located in the directory tree rooted at C Local TeX Files This tree might look as follows 22 Maintenance Figure 4 4 Sample TeX Directory Structure C Local TeX Files File Edit View Favorites Address e C Local TeX Files N 4 Sie Type Date Modif
12. If you wish to obtain a copy of the MiKTeX DVD R visit the DVD R info page http miktex org dvd Give Back If you enjoy MiKTeX and want to support the project then please become an esteemed MiKTeX user by giving back something It encourages me to continue and is the perfect way to say thank you Visit the MiKTeX Give Back page http miktex org giveback for more information The MiKTeX Project Page The MiKTeX Project Page http miktex org is the address to turn to for MiKTeX related news amp information The MiKTeX Mailing List There is a discussion list for MiKTeX users You can join this list by visiting the MiKTeX Users Info Page http lists sourceforge net lists listinfo miktex users and filling out the form provided there To see the collection of prior postings to the mailing list browse the MiKTeX Users Archives http sourceforge net mailarchive forum php forum miktex users Documentation Use the mthelp utility to quickly access general TeX related documentation For example run mthelp memoir to view documentation of the memoir package Chapter 2 Installing MIKTeX You use the Basic MiKTeX Installer to install MiKTeX on your computer You can download the installer from the MiKTeX download page http miktex org download Please read the installation tutorial http miktex org howto install miktex for a step to step guide MiKTeX 2 9 Previewer MiKTeX 2 9 TeXworks MiKTeX 2
13. Name tex TeX Synopsis tex option file command 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 De Vice Independent TeX s capabilities and language are described in The TeXbook TeX is normally used with a large body of precompiled macros and there are several specific formatting systems such as LaTeX 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 mt 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 TeXbook 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 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 TeX s favorite symbols like backslashes unless you quote them As described in The TeXbook that first line should begin with a file
14. Programs K 1 num m M n num N o name O x offset y offset cross style crop marks Itis 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 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 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 countO 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 Specify manual feed if supported by the output device Turns off automatic font generation Print at most num pages Default is 100000 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 Thi
15. WSH MSC 43 Programs fmt fmt hbf hbf graphic figure eps epsi png gf gf ist ist lig files lig lua lua luatex luc luctex texlua texluc tlu map map mem mem mf mf mfpool pool mft mft mlbib mlbib bib mlbst bst mp mp mppool pool ocp ocp ofm ofm tfm opl opl opentype fonts otf otp otp ovf ovf ovp ovp perlscript pl pk pk PostScript header pro enc subfont definition files sfd ESX EOX tex tex texpool pool TeX system documentation chm dvi html txt pdf ps tfm tfm truetype fonts ttf ttc typel fonts pfb pfa type42 fonts t42 vf vf web web Windows command script file bat cmd 44 Programs Name gftodvi make proof sheets from generic font files Synopsis gftodvi option gffile Description The gftodvi program converts a generic font GF file output by for example METAFONT to a device independent DVD 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
16. or an URL a remote package repository You can use the 1ist repositories to retrieve a list of working package repository URLs Select the release state of the remote package repository The release state is relevant for finding appropriate package repositories list repositories pick repository url This option is only available on Windows systems permanently register the location of the default package repository in the user area of the Windows Registry The location can be either a fully qualified path name a local package repository or an URL a remote package repository Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream names Chapter 6 Trace Streams Uninstall the specified package Update the specified package if an updated version is available in the package repository Update all installed packages if package is omitted Synchronize the local package database with the package repository Update packages listed line by line in the specified file Verify the integrity of all installed packages Verify the integrity of the specified package 60 Programs verbose Turn on verbose output mode version Show version information and exit Installation Destination All files are installed in the TEXME installation directory usually C Program Files MiKTeX 2 9 It may be necessary to specify the location of the installation directo
17. 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 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 results 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 co
18. time statistics trace tracestreams undump name Enable input output from to child processes Quit after the first error Give help and exit This option is only available on Windows systems show the manual page in an HTML Help window and exit when the window is closed Prefix dirto the search path Become the ZNI variant of the compiler 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 Set the name of the job Sobname This has an affect on the output file names Set the time stamp of all output files equal to file s time stamp Don t change the way error messages are printed Create output files in dir This implies include directory dir Check whether the first line of the main input file starts with 96 amp and parse if it does This can be used to specify extra command line options Suppress all output except errors Record all package usages and write them into file Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension fls Use texprograminstead of tex when compiling text labels This flag overrides the environment variable TEX Show processing time statistics Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream names Chapter 6 Trace Streams
19. Extra paths to locate BSTINPUTS Extra paths to locate See Also BibTeXing Designing BibTeX Styles LaTeX A Document Preparation System Defines the minimum number of crossrefs required for automatic inclusion of the crossref d entry on the citation list the default is two Suppress all output except errors Record all package usages and write them into file Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream names Chapter 6 Trace Streams Show version information and exit bib files bst files Run mthelp btxdoc Run mthelp btxhak ISBN 0 201 52983 1 35 Programs Name dvicopy produce modified copy of DVI file Synopsis dvicopy option indvi outdvi 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 Options alias app Pretend to be app i e set program and memory dump name to app This may affect the search paths and other values used Using this option is equivalent to copying the executable file to app exe and invoking app exe disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automati
20. Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation 84 Programs nable mltex nable pipes nable writel8 rror line n xtra mem bot n xtra mem top n font max n font mem size n half error line n halt on error hash extra n help Enable ML TeX extensions such as charsubdef Enable input output from to child processes Set the width of context lines on terminal error messages Setthe extra size in memory words for large data structures like boxes glue breakpoints et al Relevant only after the memory dump file has been read Set the extra size in memory words for chars tokens et al Relevant only after the memory dump file has been read Setthe maximum internal font number Setthe size in TeX memory words of the font memory Setthe width of first lines of contexts in terminal error messages Quit after the first error Set the extra space for the hash table of control sequences which allows 10K names as distributed Give help and exit include directory dir Prefix dir to the search path initialize Become the ZNI variant of the compiler interaction mode Set the interaction mode Must be one of batchmode job name nam job time fil main memory n max in open n max print line n max strings n
21. meaning of these modes is the same as the corresponding commands Set the name of the job Sobname This has an affect on the output file names Set the time stamp of all output files equal to file s time stamp Set the maximum number of ligature kern steps Must be at least 255 and at most 32510 Change the total size in memory words of the main memory array Relevant only while creating memory dump files Setthe width of longest text lines output should be at least 60 Set the maximum number of strings Set the number of autorounded points per cycle Setthe the space for storing moves in a single octant Don t change the way error messages are printed Create output files in dir This implies include directory dir Set the the maximum number of simultaneous macro parameters Check whether the first line of the main input file starts with 96 amp and parse if it does This can be used to specify extra command line options Set the the maximum number of knots between breakpoints of a path Set the maximum number of characters in strings including all error messages and help texts and the names of all fonts and control sequences Suppress all output except errors 51 Programs record package Record all package usages and write them into file usages file recorder Enable the file name recorder This leaves a trace ofthe files opened for input and output in a file with the extension 1s
22. miktexstartup ini Download Install the specified package set This must be one of basic complete Setup MiKTeX Portable Install MiKTeX for the current user only Add shortcuts to the specified program folder Download from the specified the URL Install MiKTeX for everyone using this computer This option requires administrator privileges Run in unattended mode Set the location of the configuration directory for the current user Environment variables lt VARNAME gt can be used See the example below Set the location of the data directory for the current user Environment variables lt VARNAME gt can be used See the example below Set the user installation directory Environment variables lt VARNAME gt can be used See the example below Register additional directories for the current user dirs must be a semicolon separated list of fully qualified path names Environment variables lt VARNAME gt can be used In this example MiKTeX is installed from a network share server miktex repository User directories are specified by using environment variables VARNAME which are expanded at run time C gt setupwiz install from local repository local package repository server miktex repository package set complete shared user config APPDATA MMiKTeXM2 9 user data LOCALAPPDATA MMiKTeXM2 9 user install lt APPDATA gt MiKTeX 2 9 77 Programs
23. n c style errors disable installer disable pipes disable writel8 dont parse first lin enable installer nable pipes nable writel8 rror line n xtra mem bot n Pretend to be app i e set program and memory dump name to app This may affect the search paths and other values used Using this option is equivalent to copying the executable file to app exe and invoking app exe Setthe directory dirto which auxiliary files are written Also look for input files in dir first before along the normal search path Setthe the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname TeX uses the buffer to contain input lines but macro expansion works by writing material into the buffer and reparsing the line As a consequence certain constructs require the buffer to be very large even though most documents can be handled with a small value Change the way error messages are printed The alternate style looks like error messages from many compilers and is easier to parse for some editors This option implies scrollmode Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation Disable input output from to child processes Disable checking whether the first line o
24. 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 10g 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 amp ormat translate file tcxname then TeX will use the named format and transation table t cxname 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 change the editor used It may contain a string with f indicating where the file name goes and 1 indicating where the decimal line number if any goes A convenient file is null 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 null get
25. names Chapter 6 Trace Streams Set the amount of space for hyphenation patterns Use name as the name of the format to be used instead of the name by which the program was called or a oe ge line 74 Programs version Show version information and exit Files pdftex cfg The MiKTeX pdfTeX configuration file Environment TEXINPUTS Extra paths to locate TeX input and openin files TEMFONTS Extra paths to locate TeX font metric files See also The pdfTeX user manual A4 Run mthelp pdftex a version 75 Programs Name setupwiz MiKTeX setup wizard Synopsis basic miktex 2 9 xxxx exe options setup 2 9 xxxx exe options Description MiKTeX Setup Wizard is used to install MiKTeX There a two instances of the installer Basic MiKTeX Installer basic miktex 2 9 x xx exe MiKTeX Net Installer setup 2 9 xxxx exe Basic MiKTeX Installer is used to set up a basic MiKTeX system All required resources are embedded in the installer i e nothing else needs to be downloaded from the Internet MiKTeX Net Installer is used to set up a complete MiKTeX system In a first step all required resources will be downloaded from the Internet In a second step a complete MiKTeX system is installed Both installers read command line options from the file setupwiz opt if it exists Options allow una reboot common co common da ttended nfig dir
26. or a oo amp line Show version information and exit Extra paths to locate TeX input and openin files TFMFONTS Extra paths to locate TeX font metric files See Also The TeXbook ISBN 0 201 13448 9 See texify 1 for an alternative way to invoke TeX 81 Programs Name texify MiKTeX compiler driver Synopsis texify option file Description texify runs Texinfo or LaTeX 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 file is used to determine its language LaTeX or Texinfo makeinfo is used to perform Texinfo macro expansion before running tex when needed Options Use input instead of input for preloaded Texinfo batch b No interaction 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 max 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 bat ch run viewer Run viewer on the r
27. search 13 E edit compile view edit cycle 8 error messages C style 8 C C style 50 63 69 72 79 84 line width 50 69 73 79 85 extra_mem_bot 30 F FAQ frequently asked questions 5 file name database defined 14 refreshing 14 file name datasbase refreshing font_mem_size 30 format files creating G gftodvi 38 100 Index give back 4 H hyphenation patterns selecting 15 international characters 11 K Knuth Donald E 3 L languages selecting 15 LaTeX invoked by texify 12 local additions intergrating 21 local guide 7 long file names quoting of 9 mailing list archive 4 main memory 30 Makelndex invoked by texify 12 memory dump files creating defined 29 defining new 29 METAFONT modes MFINPUTS 52 65 93 MiKTeX downloading 4 DVD R 4 features 3 getting 4 how to pronounce 3 registering 4 uninstalling 6 updating 16 MiKTeX DVD R 4 MiKTeX project how to support the 4 MiKTeX Project Page 4 MiKTeX update wizard see update wizard MIKTEX REPOSITORY 93 MIKTEX TRACE 93 MLTeX 11 modes mf 49 MPINPUTS 65 93 mthelp 4 O Outline fonts psfonts map 28 output file name changing the 8 P package management 28 package set 53 77 packages automatic installation of 20 finding out usages 7 installing 28 28 searching for 29 updating 16 paper format setting 15 paper size changing 90 PDF distillin
28. 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 Runmthelp dvips 42 Programs Name findtexmf find MiKTeX files Synopsis findtexmf option file Description findtexmf can be used to find MiKTeX related files When the file 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 Options app when finding files alias app Pretend to be help Give help and exit file type filetyp Use the specified file type see below must exist Install missing packages if necessary show path filetyp Output search path for the specified file type see below start Start the associated program if the file was found the name of th game name files version Show version File Types afm base afm base bib bib bst bst cid maps cid cidmap clua dll so cnf cnf cweb w dvi dvi enc enc exe COM E font featur XE BAT CMD VBS VB p files fea Set the name of the program Relevant when searching for format information and exit E J8 JSE WSF
29. ta dir common install dir common roots dirs download only dry run install from local repository local package repository dir Restart the system if necessary Set the location of the common configuration directory This option requires administrator privileges Set the location of the common data directory This option requires administrator privileges Set the common installation directory This option requires administrator privileges Register additional directories for all users dirs must be a semicolon separated list of fully qualified path names This option requires administrator privileges Environment variables lt VARNAME gt can be used Download all required packages but do not otherwise install MiKTeX Simulate No files shall be downloaded and or installed Install MiKTeX from a directory to be specified with the local package repository option Download into Install from the specified directory 76 Programs no additional roots no registry package set set portable private program folder name remote package repository url shared unattended user config dir user data dir user install dir user roots dirs Examples Do not integrate additional TEXMF root directories into the MiKTeX setup Do not store path information in the Windows Registry but write the startup configuration file
30. the hash table of control sequences which allows 10K names as distributed hash extra 200000 Prime number of hyphenation exceptions hyph size 8191 Omega ocp buf size 500000 ocp listinfo size 1000 ocp list list size 1000 ocp lstack size 1000 ocp stack size 10000 trie op size 35111 pdfTeX pdf mem size 10000 obj tab size 1000 dest names size 131072 pdf os buf size 1 METAFONT amp MetaPost Size of stack for bisection algorithms 97 TEXMF Run Time Parameters Should probably be left at this value bistack size 1500 Maximum number of ligature kern steps must be at least 255 and at most 32510 lig table size 15000 Fry mv path_size 10000 METAFONT 7 Number of autorounded points per cycle max_wiggle 1000 7 Space for storing moves in a single octant move size 20000 MetaPost EP font mem size 10000 Maximum number of knots between breakpoints of a path Number of words for TFM information for text fonts 98 Index Symbols admin 47 59 alias app 34 36 43 45 50 63 69 72 78 84 aux directory dir 10 50 63 69 72 79 84 batch 82 bistack size n 50 buf size n 50 69 72 79 84 c style errors 50 63 69 72 79 84 clean 82 configure 47 disable installer 7 34 36 45 50 63 69 72 79 84 disable pipes 34 36 50 63 69 72 79 84 disable write18 69 72 79 84 dont parse first line
31. 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 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 Options alias app Pretend to be app i e set program and memory dump name to app This may affect the search paths and other values used Using this option is equivalent to copying the executable file to app exe and invoking app exe disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Pack
32. to app This may affect the search paths and other values used Using this option is equivalent to copying the executable file to app exe and invoking app exe aux directory dir Set the directory dir to which auxiliary files are written Also look for input files in dir first before along the normal search path c style errors Change the way error messages are printed The alternate style looks like error messages from many compilers and is easier to parse for some editors This option implies scrollmode disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation disable pipes Disable input output from to child processes dont parse first lin Disable checking whether the first line of the main input file starts with amp enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation 63 Programs nable pipes halt on error help hhelp include directory dir initialize interaction mode job name nam job time fil no c styl rrors output directory dir parse first lin quiet record package usages file recorder tcx name tex texprogram
33. would say latex src specials foo tex to create the DVI file foo dvi with embedded source specials 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 LaTeX primitive include You have to write something like the following include extra space long space file space name Specifying Additional Input Directories The command line option include directory dir causes the program to include dir into the list of input directories For example latex include directory C My Styles foo tex This prepends C My Styles to the input search path i e C NMMy Styles will be searched first when TeX tries to find an input file Using MiKTeX Specifying the Output Directory The option output directory dir causes TeX to create all output files in another directory For example C gt mkdir C texoutput C gt latex output directory C texoutput sample2e tex C gt This ensures that al
34. 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 base 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 49 Programs 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 indicating where the filename goes and 1 indicating where the decimal line number if any goes A convenient file is nu11 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 i
35. 3 80 85 max strings n 51 70 73 80 85 max wiggle n 51 min crossrefs n 34 mkidx option option 82 mklinks 47 mkmaps 48 move size n 51 must exist 43 nest size n 70 74 80 85 no c style errors 51 64 70 74 80 85 no file line error 51 64 70 74 80 85 no file line error style 51 64 70 74 80 85 no pdf no registry 77 no shell escape E odd only 68 output directory dir 10 51 64 70 74 80 86 output driver cmd output format format overflow label offset real 46 page range range 68 page start page spec 36 papersize string param size n 51 70 74 80 86 parse first line 51 64 70 74 80 86 path size n 51 pdf 82 pool size n 51 70 74 80 86 print method method 68 print nothing 68 print only 48 print package info package 60 printer printer 68 quiet 8 48 A A 5 82 record package usages file 7 35 36 46 52 64 71 74 80 86 recorder 52 64 71 74 80 86 register root 48 report 48 restrict write18 74 80 86 99 Index run viewer 82 save size n 71 74 80 86 screen 52 select sel 37 set repository location 60 shell escape F 3 shell restricted a show path filetype 43 src 82 src specials 9 71 74 81 86 stack size n 52 71 74 81 86 start 43 string vacancies n 52 71 74 81 86 synctex n 7
36. 4 86 tcx name 52 64 71 74 81 tex option option 83 texinfo cmd 83 the name of the game name 43 time statistics 52 64 71 74 81 86 trace tracestreams 35 37 46 52 54 60 64 71 74 81 86 translate file name gt trie op size n 71 trie size n 71 74 81 86 undump name 52 64 71 74 81 86 uninstall package 60 unregister root 48 update db 60 update fndb 48 update some file 60 update package 60 verbose 48 83 verify 60 verify package 60 version 35 37 43 46 48 52 54 61 65 66 71 75 81 83 86 viewer option option 83 max iterations n 82 slant font font 46 src 71 74 74 81 86 86 tex texprogram 64 title font font 46 aux auxiliary file 34 bbl 34 bbl bibliography file 34 bib bibliographic database 34 bst bibliography style file 34 dvi DVI file 38 8 bit characters 11 writel8 run a program from within TeX 10 gt gt A accented character 11 ADOBE fonts 91 automatic package installation 7 auxiliary files removing 13 specifying the directory for 10 B BIBINPUTS 35 93 bibliography creation 34 BibTeX invoked by texify 12 BSTINPUTS 35 93 C CD R installing updates 17 character translation files 11 Cork encoding and ISO input 12 cross references minimum number required 35 resolving 12 D DVD R obtaining 4 running MiKTeX from the 4 DVI
37. 9 gt Help FAQ MiKTeX 2 9 Help gt Manual MiKTeX 2 9 gt Maintenance gt Package Manager MiKTeX 2 9 Maintenance gt Settings MiKTeX 2 9 Maintenance gt Update MiKTeX 2 9 Maintenance Admin gt Package Manager Admin MiKTeX 2 9 Maintenance Admin Settings Admin MiKTeX 2 9 Maintenance Admin gt Update Admin MiKTeX 2 9 gt MiKTeX on the Web gt Known Issues MiKTeX 2 9 gt MiKTeX on the Web gt MiKTeX Project Page MiKTeX 2 9 gt MiKTeX on the Web Registration Items in the Start Menu MiKTeX Setup Wizard installs the following menu items in the Windows start menu A shortcut to the MiKTeX previewer Yap A shortcut to TeX works an integrated development environment for TeX and LaTeX Answers to frequently asked questions The MiKTeX manual A shortcut to the MIKTeX package manager A shortcut to MiKTeX Options A shortcut to the MiKTeX update wizard A shortcut to the admin variant of the MiKTeX package manager A shortcut to the admin variant of MiKTeX Options A shortcut to the admin variant of the MiKTeX update wizard An Internet shortcut to the MiKTeX issues page An Internet shortcut to the MiKTeX project page An Internet shortcut to the MiKTeX registration page Installing MiKTeX MiKTeX 2 9 gt MiKTeX on the An Internet shortcut to the MiKTeX support page Web gt Support Removing MiKTeX MiKTeX can be removed fro
38. Available package repositories Country URL Description Germany ftp ftp uni bielefeld de pub tex systems win32 mikt CTAN mirror Germany ftp ftp uni stuttgart de pub tex systems win32 mikte CTAN mirror Germany ftp ftp dante de tex archive systems win32 miktex t CTAN Dante Greece ftp ftp ntua gr mirror ctan systems win32 miktex tm CTAN mirror Hong Kong ftp ftp comp hkbu edu hk pub Tex CTAN systems CTAN mirror ftp ftp sztaki hu pub tex systems win32 miktex tm CTAN mirror ftp cis uniRoma2 it T eX systems win32 miktex tm CTAN mirror ftp ftp lab kdd co jp CTAN systems win32 miktex t CTAN mirror Ces Je Click Next to continue A list of updateable packages is displayed Choose the packages you wish to update 18 Maintenance MiKTeX Update Wizard 2 2 3 Update List Select the packages you wish to update The following updates are available Select the packages you wish to update Click Next to start the update process Name Old New hyperref 30 Mar 03 31 Mar 03 Itxmisc 30 Mar 03 31 Mar 03 Click Next gt to start the update process MiKTeX Update Wizard now updates the selected packages 19 Maintenance MiKTeX Update Wizard 2 2 3 Update Selected packages are being updated eZ Updating Itzmisc Overall progress ETA 1 seconds ms win32 miktex tm packages hyperref cab unknown size 941610 bytes 80 06 KB Se
39. E EEE i ner rennen 5 Removing MIR TeX ente seats e es ara Peer E te RAES SEE 6 3 Using MIKT 6X cuota ai ii 7 Getting Started om et re Se ERE tte Oe a esee apli dirias 7 Specialties iiie ee RN Erin as 7 Automatic Package Installation misini ror an EE EAA E E A EEA 7 Finding out Package Usages ooocccoccnnccnnconnconnconoconncnnncnnncnnrcnnronncnnccnnccnnccnnions 7 Suppressing Screen Output terere se Reg 8 Setting the Name of the Output File sssssse HI 8 Auto insertion of Source Specials ocooncncccnccnnocnnccnnconnconnconnconnconnconarnnacnncnnnss 8 Quoted File Names c nei et Ie AE REIR 9 Specifying Additional Input Directories ese 9 Specifying the Output Directory sesssssss emen 10 Specifying the Directory for Auxiliary Files se 10 Running Programs From Within TeX ssssssesse seca seen een een een 10 TEX Files Character Translations ssns rettet nere Res 11 texify The MiKTeX Compiler Driver essem mme 12 Printing in E m Dee te ete ib enm 13 Using a Viewer to Print DVI PDF Files essee M 13 Using mtprint to Print DVI Files wierre meme 13 A Maintenance ene Re Bis si iR erm Ere e ERU OPE Redi as 14 Refreshing the File Name Database esses eene nennen nene 14 Setting the Preferred Paper Format 0 0 0 0 cee cece cece cece ce eece seen e em eee 15 SelechngL anguages 0 een km lieg 15 Insta
40. I output 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 Sets the PDF version of the generated file and the latest allowed PDF version of included PDFs The value 3 tells pdfTeX to set the PDF version to 1 3 and allows only included PDFs with versions less than 1 3 A suitable default value is 4 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 90 Files Name updmap cfg configuration Settings for outline fonts Description The configuration file updmap cfg contains declarative instructions which will be used to build font map files Caution Do not edit this file directly Run initexmf edit config file updmap to edit configuration settings for outline fonts Instructions updmap cfg can contain the following instructions dvipsPreferOutline value Specifies whether Dvips prefers bitmap fonts or outline fonts if LW35 value dvipsDownloadBase35 value both are available Valid values are t rue default and false Independend of this setting outlines can be forced by putting p psfonts tl 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 configu
41. ML viewer Text viewer The environment variables should be set with a f as a placeholder for the name of the file For example C gt MIKTEX VIEW pdf gv Files The intermediate HTML file package html is stored in the directory miktex mthelp relative to the data TEXMF root 66 Programs See also MiKTeX Project Page http www miktex org 67 Programs Name mtprint MiKTeX print utility Synopsis mtprint option file Description mtprint sends TeX output files to a printing device Options even only Prints only even TeX pages landscape Selects landscape output format odd only Prints only odd TeX pages page range rang Selects a TeX page range e g 20 21 Multiple page range options accumulate print method met hod Selects a print method One of psbmp This method uses Dvips and Ghostscript to produce the print output 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 is omitted 68 Programs Name omega extended unicode TeX Synopsis omega option file command Description Omega is a 16 bit enhanced version of TeX Options alias app aux directory dir buf size
42. MiKTeX 2 9 Manual Revision 2 9 5671 Christian Schenk MiKTeX 2 9 Manual Revision 2 9 5671 Christian Schenk Copyright O 2015 Christian Schenk 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 Table of Contents About this Document eo ette rp teen Op Ee PRSE OR E exte Rap pote de E S vi I User Guide en ee Era eie senes E ewes Mee 1 A n EAE E EE essen leise rhnien hp heisser engen 3 About this Manual vecinas te ge cr geilen de 3 About MAK TEX 2 5 5020 00 ee Benannte 3 How to Get MiKTeX vencre rs a Bine he 4 Downloading MiKTeX el RR Rn pen 4 MiKTeX on DV DER td er fehle 4 Give B ck na se tn ein Eisen 4 The Mik TeX Project Pale iii RR Nas Im aD 4 The MiKTeX Mailing List eoo Rinne Das 4 Documentation ssi epp Uere p pru Ye Ei EUM 4 2 Installing MIK T X cicer e Bag I Han 5 Items in the Start Menu ssiru oeri Eiee
43. MiKTeX update wizard to install the latest MiKTeX updates To start the wizard click Start gt Programs gt MiKTeX 2 9 Update The wizard asks you to choose an update source 16 Maintenance MiKTeX Update Wizard 2 4 1704 Download Type Specify the download type Where do you want to get packages from Choose this if you want to update packages from the Internet Local folder Choose this if you want to update packages from a local package repository MiKTex CD Choose this if you want to install updates from a MiKT ex CD Ces Jen Choose 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 MiKTeX CD Click Next gt to continue If you have chosen to install packages from a remote package repository MiKTeX Update Wizard lists the available package repositories Choose the nearest repository 17 Maintenance MiKTeX Update Wizard 2 2 3 Remote Package Repository Specify the location of a remote package repository Packages will be downloaded from the remote package repository selected below In order to reduce network load it is recommended that you use the remote package repository which is located in the closest network proximity to your site Alternatively you may wish to obtain a copy of the MiKT ex CD R see http www miktex org
44. a User Managed TEXMF Directory coooccocccncccnccnnccniccnicnnns 22 5 Advanced Topi6s te e RR be Rn Br isses 28 Managing Font Map Files 2 0 0 0 eee cence ence ee III em meme E ent entente 28 Working With the Package Manager sss Hmm Hh 28 Installing Packages nme Ea RR EI YR 28 Searching Packages o teri ee Bear RR ss 29 Managing Memory Dump Files 0 0 cece cece cece eI HH HH eI eene rene 29 Changing TEXMF run time parameters cece cece eee c eee ee emm eme He menn 29 Chapter 1 Introduction 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 http www tex ac uk cgi bin texfaq2html label tutorials About MiKTeX MiKTeX pronounced mik tech is an up to date implementation of TeX and related programs for Windows all current variants TeX is a typesetting system invented by D E Knuth MiKTeX s main features include easy to install 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 that are freely redistributable enhanced TeX compiler capabilities enhanced pr
45. age Installation enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation gray font font Sets the gray font Default is gray help Give help and exit hhelp This option is only available on Windows systems show the manual page in an HTML Help window and exit when the window is closed 45 Programs include directory dir label font font logo font font overflow label offset real record package usages file slant font font title font font trace tracestreams version Documentation The METAFONTbook Prefix dirtothe search path Sets the label font Default is cmt t 10 Sets the logo font Default is 10908 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 all package usages and write them into file Sets the slant font There is no default Sets the title font Default is cmr8 Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream names Chapter 6 Trace Streams Show version information and exit ISBN 0 201 13444 6 46 Programs Name initexmf
46. 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 Set the maximum number of pages in each section This option is most commonly used with the i option see its description above for more information 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 papert ype 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 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 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 information in the same string that is used to store the bitmap information This is only necessary when drivi
47. 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 printengine 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 bat chmode for silent operation can also appear The name ont 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 log 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 1ocalfont must be substituted If the mode is not specified or is not valid METAFONT 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
48. at You can set the preferred paper format with the help of MiKTeX Options Click Start gt Programs gt MiKTeX 2 9 Maintenance Settings to open the MiKTeX Options window see Figure 4 1 MiKTeX Options General Settings Select your preferred paper format from the drop down list and click OK Selecting Languages 15 Maintenance You can control the loading of hyphenation patterns with the help of MiKTeX Options Click Start gt Programs gt MiKTeX 2 9 Maintenance Settings to open the MiKTeX Options window see Figure 4 1 MiKTeX Options General Settings Click on the Languages tab You will presented with the list of available languages Figure 4 2 MiKTeX Options Languages Mark the languages whose hyphenation patterns are to be loaded by the TeX engines Figure 4 2 MiKTeX Options Languages MiKTeX Options General Roots Formats Languages Packages Languages Language english dumylang nohyph C basque C bulgarian C coptic C welsh C czech C slovak german ngerman C danish C spanish ee C usenglis Hyphenation hyphen tex ushyphmax tex dumphyph tex zerohyph tex bahyph tex bghyphen tex copthyph tex cyhyph tex czhyph tex skhyph tex dehypht tex dehyphn tex dkhyph tex eshyph tex anbkuml bau Synonyms usenglish USe espanol a lt Installing Updates Appl You can use the
49. ation 40 Programs p num pp first last P printer q S num t papertype T hsize vsize u name U The first page printed will be the first one numbered num Default is the first page in the document If numis 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 countO values stored 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 Print pages first through 1ast equivalentto p first 1 last except that multiple pp options accumulate unlike p and 1 The separator can also be 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 Run quietly Don t chatter about pages converted etc to standard output report no warnings only errors to standard error 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
50. c Package Installation disable pipes Disable input output from to child processes enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation nable pipes Enable input output from to child processes help Give help and exit hhelp This option is only available on Windows systems show the manual page in an HTML Help window and exit when the window is closed include directory dir Prefix 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 select record package Record all package usages and write them into file usages file 36 Programs select sel trace tracestreams version Select pages to be copied The syntax for selis 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 Enable trace messages The tracestreams argument if speciefied is a comma separated list of trac
51. ce Streams file tests access stat MiKTeX configuration settings MiKTeX core library cURL library device independant bitmaps DVI bitmaps DVI color DVI files DVI garbage collector DVI hypertex specials DVI page builder DVI PK raster operations DVI PK characters DVI PK fonts DVI source specials DVI font metrics DVI virtual font characters DVI virtual fonts environment variables error conditions MiKTeX package archive file extractor file operations file searching file name database operations font information retrieval TeX amp Friends memory allocation memory mapped files package manager 94 Trace Streams mtprint packages process tempfile time values yap MiKTeX print utility packages execution of secondary processes temporary files execution time configuration values Yap 95 Chapter 7 TEXMF Run Time Parameters All TeXMF Programs TeX uses the buffer to contain input lines but macro expansion works by writing material into the buffer and reparsing the line As a consequence certain constructs require the buffer to be very large even though most documents can be handled with a small value buf size 200000 Width of context lines on terminal error messages error line 79 Extra low memory for boxes glue breakpoints etc extra mem bot 0 Extra high memory for chars tokens etc extra mem top 0 Width of firs
52. d is easier to parse for some editors This option implies scrollmode Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation Disable input output from to child processes Disable checking whether the first line of the main input file starts with amp Enable encTeX extensions such as mubyte Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation Enable MLTeX extensions such as charsubdef Enable input output from to child processes Set the width of context lines on terminal error messages Setthe extra size in memory words for large data structures like boxes glue breakpoints et al Relevant only after the memory dump file has been read Set the extra size in memory words for chars tokens et al Relevant only after the memory dump file has been read Set the maximum internal font number Set the size in TeX memory words of the font memory Set the width of first lines of contexts in terminal error messages Quit after the first error 79 Programs hash extra n help include directory dir initialize interaction mode job name nam job time fil main memory n max in op
53. de for dest texify The MIKTeX Compiler Driver texify is a command line utility that simplifies the creation of DVI PDF documents texify automatically runs LaTeX pdfLaTeX MakeIndex 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 texify foo tex As shown in the example above the input file names to texify must include any extension tex 1tx wal There are several command line options you can use to control texify see texify 1 Here are some examples 12 Using MiKTeX 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 option src foo tex Passes the option src to the TeX compiler texify run viewer foo tex Opens the output file foo dvi unless there are compile erros texify tex option src viewer option 1 s 200 foo tex run viewer foo Compiles foo tex with source file information src and then initiates forward DVI search to open oo 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 Printing Using a Viewer to Print DVI PDF Files TeX output files dvi pdf can be printed from within the viewer Using mtprint to Print DVI F
54. e ERLERNEN D e Meneses cede EE e ih aree dre eddy Ve A Ee RN 59 IDO ati dro ai uo ote n ete de quee eee uev e eon e ihe qe une duse E duet he neues ss on NEE 63 nubi M D UEM 66 PTI asec oie e uer or D tee eene re eme des tette eeu don siege sete ok Sameday eb tee deoa or dest 68 OME SA EL EIE EE 69 TIE DE steilen tiet etis e a teres Se Ad eux SEU RN di 72 SeLUDWIZ SEHE eut o uei e mot on utet itecto e 76 oJ O 78 VERY esso I REO NEU S HEU EU Es SEE da 82 KOLEK es ELS 84 A PIES MUERE 88 junio dur rae O AN 89 UpPAMap CLE xo is SS weal e e ee Ae nen de o Tet uem 91 5 Environment variables cies stet iecore ete airline 93 6 Trace Streams ii ii E ERU HRS rl SCARED E e RAE rs 94 T TEXME Run Time Paraimetets uie esee dee tete een er Ee dr erase Core Rude equ ER EUR E PR ENEE 96 AIL TeXME Programs xp E e ee EN re ERE 96 AU TeX Programs a 3 oioes tesoro Idee treo Posi see Toe e RESO ra ges does Te Poe oe atc onu der 97 OM O A eO eed eb rete o Dee hn reet bue eoe ieu ds 97 jun duo Cc 97 METAFONT e MetaPost reed ede veh ea Herde od ebd erred 97 METAFONT Se 22 512 rons Siti MeT e dra 98 MetaPost triti Er A EN EEUU E ERO ree 98 n PM ses 99 iv List of Figures 4 1 4 2 4 3 4 4 4 5 4 6 4 7 4 8 MiKTeX Options General Settings 0 0 een ae 15 MiKTeX Options Languages c
55. e 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 LaTeX inputenc package This is why you should either use tcxfile or inputenc in LaTeX 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 TeX 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 that an input keyboard character maps to more than one character Specifying TCX files You can specify a TCX file to be used for a particular TeX run by specifying the command line option translate file tcxfile or preferably specifying it explicitly in the first line of the main document amp translate file tcxfile 11 Using MiKTeX TCX files are searched for along the TCXPath path initex ignores TCX files MiKTeX comes with at least two TCX files 111 t1 tcxand 112 t1 tcx These support ISO Latin 1 and ISO Latin 2 respectively with Cork encoded fonts a k a
56. e stream names Chapter 6 Trace Streams Show version information and exit 37 Programs Name dvips convert a DVI file to PostScript Synopsis dvips option dvifile 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 specified without the dvi extension 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 b num c num e num Conserve memory by making three passes over the DVI file instead of two and only loading those characters actually used Printonly the odd pages This option uses TeX page numbers not physical page numbers 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 Generate num consecutive copies of every page i e the output is uncollated This merely sets the builtin PostScript variable copies 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 re
57. each known format mkmaps print only Print what would be done Nothing is changed quiet Suppress screen output register root dir report Write aMiKTeX configuration report unregister root dir update fndb update fndb dir Refresh the file name database for a specific TEXMF tree verbose Print information on what is being done version Print the version number and exit See also MiKTeX Project Page http www miktex org 48 Programs Name mf METAFONT a language for font and logo design Synopsis mf option command i 1e 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
58. ece cece cece ence III eme mme ent ent ent entre nenne 16 Automatc Package Installation oe e D RR RR di 21 Sample TeX Directory Structure sssesssessessesee e e e m emen He mee mee hen rennen 23 MiKTeX Options ROOTS u ein iR ch tee etr e Pare Yee 24 Browsing to a Root Directory ssessesseseee e HH He mee hehe hee entrent eenne 25 MiKTeX Options Root Directory Added ssssssssss eee 26 MiKTeX Options Root Directory Moved sssessssee IH e eere 27 About this Document This is version 2 9 5671 of the MiKTeX manual It corresponds to MiKTeX 2 9 as at July 12 2015 vi Part I User Guide Table of Contents l Introduction 2 2 22 22 0 2 eat alten a biste al a Ri 3 About this Manual u et nr SHE uni en 3 About MIKTeX comida ici ias il di 3 How to Get MIKTeX eleg RET EAE EUREN plis 4 Downloading MiK TeX ae a ee ru IR o Pet ER 4 MiKTeX n DVDR 2 2 DA eae 4 O EAEE E rei een hei 4 The MiKTeX Project Page ats en een TEM E en 4 The MiKTeX Mailing Listando Re ee 4 Documentation A RESI AERE eo sea 4 2 Installing MIK TeX 0 2002 eek m EES IESE EEEE POETESS S 5 Ttems inthe Start Men 20 2 2 lin EEE EEE E 5 Removing MiK TeX nn p E e ree t ia ss arts 6 3 Using MIKTeX oe iii EE E a sega 7 Getting Startede O 7 Specialities u eu ers EIUSMOE 7 Automatic Package Installation 008 dente ern ae an ip 7 Finding out Package Usages
59. ection called Automatic Package Installation disable pipes Disable input output from to child processes disable writel8 dont parse first lin Disable checking whether the first line of the main input file starts with amp draftmode Switch on draft mode generates no output nabl nctex Enable encTeX extensions such as mubyte enable etex 72 Programs enable installer nable mltex nable pipes nable writel8 rror line n xtra mem bot n xtra mem top n font max n font mem size n half error line n halt on error hash extra n help include directory dir initialize interaction mode job name nam job time fil main memory n max in open n max print line n max strings n Enable eTeX extensions Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation Enable MLTeX extensions such as charsubdef Enable input output from to child processes Set the width of context lines on terminal error messages Set the extra size in memory words for large data structures like boxes glue breakpoints et al Relevant only after the memory dump file has been read Set the extra size in memory words for chars tokens et al Rel
60. en n max print line n max strings n nest size n no c styl rrors output directory dir param size n parse first lin pool size n quiet recorder record package usages file restrict writel8 save size n Setthe extra space for the hash table of control sequences which allows 10K names as distributed Give help and exit Prefix dirto the search path Become the ZNI variant of the compiler 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 Set the name of the job jobname This has an affect on the output file names Set the time stamp of all output files equal to file s time stamp Change the total size in memory words of the main memory array Relevant only while creating memory dump files Set the maximum number of input files and error insertions that can be going on simultaneously Set the width of longest text lines output should be at least 60 Set the maximum number of strings Setthe maximum number of semantic levels simultaneously active Don t change the way error messages are printed Create output files in dir This implies include directory dir Set the the maximum number of simultaneous macro parameters Check whether the first line of the main input file starts with 96 amp and parse if it does This can be used to
61. entation for the Omega system Suppress all output except errors Record all package usages and write them into file Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension fls Set the the amount of space for saving values outside of current group Embed source file information source specials in the DVI file Set the maximum number of simultaneous input sources Set 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 Must be at least 25000 less than pool_size but doesn t need to be nearly that large Show processing time statistics Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream names Chapter 6 Trace Streams Set the amount of space for opcodes in the hyphenation patterns Set the amount of space for hyphenation patterns Use name as the name of the format to be used instead of the name by which the program was called or a oe ge line Show version information and exit Runmthelp omega manual 71 Programs Name miktex pdftex DVI PDF output from TeX Synopsis miktex pdftex option i1e command Description Run the pdfTeX typesetter on file usually creating file pdf If the file argument has no extension tex will be appended to it In
62. es of a package 57 Programs Caveats The integrated package manager installs packages in the user home directory under miktex texmf A better approach would be to enhance the auto install dialog box 1 add a new check box Install package in usr share miktex texmf 2 A password dialog pops up if the user has chosen to install the package in the usr directory 3 the package manager is run with root privileges if the the user entered the root password This will be implemented in one of the next beta releases See also initexmf 1 miktex pdftex 1 mpm 1 mthelp 1 58 Programs Name mpm MiKTeX package manager Synopsis mpm option Description MPM MiKTeX Package Manager is used to install packages from a MiKTeX package repository MPM was originally intended to be a tool for MiKTeX users But the program can be helpful for users of other TeX systems too because many of the MiKTeX packages are system independent Two variants The package manager can be run in two modes 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 command menus MPM starts in windowed mode if you do not specify any command line options Options admin find updates help hhelp import PACKAGE import all install package install some file Run in administrative mode Te
63. es of the packages used by test tex If test tex looks like this documentclass scrartcl begin document Hello world end document Then the resulting packages txt would contain these lines cm koma script ltxbase Using MiKTeX The package list can be handed over to the package manager see mpm 1 e g mpm update some packages txt would ensure that you have the latest versions installed 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 Le 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 C gt latex quiet foo tex foo tex 3 Undefined control sequence C gt 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 C 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 hy
64. esulting DVI PDF file src Pass src specials to the TeX compiler 82 Programs texinfo cmd t cmd tex option option verbose V version v viewer option option Insert cmd after setfilename in copy of input file Multiple values accumulate Pass option to the compiler Print information on what is being done Display version information and exit successfully Pass option to the viewer Environment Variables The values of the BIBTEX LATI T EXINDI EX or PDFLAT Aliases tex2dvi EX MAK EINDI EX MAK EINFO TI Equivalent to texify EX environment variables are used to run those commands if they are set EX or PDF TI EX and 83 Programs Name xetex Unicode based TeX engine Synopsis xetex option file command Description Run the XeTeX typesetter on file usually creating file pdf If the file argument has no extension tex will be appended to it Instead of a file name a set of XeTeX commands can be given the first of which must start with a backslash XeTeX has simple font installation it can use any installed fonts in the operating system without configuring TeX font metric As a result XeTeX can access font features such as special ligatures and variable font weights Options alias app Pretend to be app i e set program and memory dump name to app Th
65. evant only after the memory dump file has been read Set the maximum internal font number Set the size in TeX memory words of the font memory Setthe width of first lines of contexts in terminal error messages Quit after the first error Set the extra space for the hash table of control sequences which allows 10K names as distributed Give help and exit Prefix dirtothe search path Become the ZNI variant of the compiler 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 Set the name of the job jobname This has an affect on the output file names Set the time stamp of all output files equal to file s time stamp Change the total size in memory words of the main memory array Relevant only while creating memory dump files Set the maximum number of input files and error insertions that can be going on simultaneously Set the width of longest text lines output should be at least 60 Set the maximum number of strings 73 Programs nest size n no c styl rrors output directory dir output format format param size n parse first lin pool size n quiet record package usages file recorder restrict writel8 save size n src specials stack size n string vacancies n synctex n tcx name time statistics trace tracest
66. eviewer capabilities forward inverse DVI search graphics color magnifying glass open source MiKTeX source code is get at able for everyone The MiKTeX distribution consists of the following components TeX METAFONT TeXware the base TeX system METAFONTware Computer Modern Fonts pdfTeX XeTeX LuaTeX various TeX derivatives Omega 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 fonts almost all free fonts Yap a sophisticated viewer for TeX output TeXify a TeX compiler driver MiKTeX Options assists in configuring MiKTeX MiKTeX Update Wizard assists in keeping the MiKTeX system up to date Introduction lots of utilities tools for the creation of bibliographies amp indexes PostScript utilities and more How to Get MiKTeX The MiKTeX distribution can be downloaded from the Internet And it is available on DVD R Downloading MiKTeX There MiKTeX setup program comes in two flavors Basic MiKTeX Installer MiKTeX Net Installer You use the Basic MiKTeX Installer to install a basic MiKTeX system The MiKTeX Net Installer can be used to download and install a complete MiKTeX system All this is explained later in this manual see Chapter 2 Installing MiKTeX MiKTeX on DVD R The MiKTeX DVD R allows you to install MiKTeX on the hard disk or to run the programs directly from the DVD R
67. f the main input file starts with amp Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation Enable input output from to child processes Set the width of context lines on terminal error messages Setthe extra size in memory words for large data structures like boxes glue breakpoints et al Relevant only after the memory dump file has been read 69 Programs xtra mem top n half error line n halt on error help hhelp include directory dir initialize interaction mode job name nam job time fil main memory n max in open n max print line n max strings n nable mltex nest size n no c styl rrors output directory dir param size n parse first lin pool size n Set the extra size in memory words for chars tokens et al Relevant only after the memory dump file has been read Setthe width of first lines of contexts in terminal error messages Quit after the first error Give help and exit This option is only available on Windows systems show the manual page in an HTML Help window and exit when the window is closed Prefix dirto the search path Become the ZNI variant of the compiler Set the interaction mode Must be one of batchmode nonstopmode sc
68. ftex CEE M EE 89 updmap etfg acto nens re Pu er eer shoves sia Sua edule seach Seadheg ses veep ise Trans taser vets 91 Environment varlables cn Iter Rss Do rennen ee Dees IR RU E nee 93 6 Trace Streams nase ee 94 7 TEXMF Run Time Parameters ccsecesenenesencnesenscevenssesenesesenessvenssevenssevenessvenesevenes 96 All TeXME Programs iore O EST enS 96 All TeX Programs iii tbn bri 97 Omega EE 97 POULT qe EE 97 METAFONT amp MetaPost 2 2 2 02 000 ea EE Pise rte nee 97 METAFONT iE Bun is 98 MetaPost EE 98 32 Chapter 6 Programs Programs Name bibtex make a bibliography for La TeX Synopsis bibtex option auxname 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 LaTeX or TeX The auxname on the command line must be given without the aux extension If you don t give the auxname the program prompts you for it bibtex looks up in bibliographic database bib files specified by the bibliography command the entries specified by the cite and nocite commands in the LaTeX or TeX source file It formats the information from those entries according to instructions in a bibliography style bst file specified by the bibliographystyle command and it outputs the results to the bb1 file The LaTeX
69. g into 42 pdfLaTeX invoked by texify 12 PostScript converting TeX output into 38 PostScript Type 1 fonts psfonts map 28 private installation 77 project page 4 psfonts map 41 creating 28 Q quoted file names 9 R registration 4 Remove MiKTeX Wizard 6 S screen output suppressing 8 security 10 11 41 setup wizard setupwiz opt 76 setupwiz opt 76 shared installation 77 source specials 101 Index defined 8 inserting 9 start menu 5 startup configuration file 77 T T1 encoding and ISO input 12 TCX character translation files 11 TeX job name changing the 8 texify 12 TEXINPUTS 75 81 87 93 TEXMF root registering unregistering TFMFONTS 75 81 87 93 U unattended setup 53 77 uninstaller 6 update wizard running 16 updates installing 16 updmap cfg 91 dvipdfmDownloadBase14 92 dvipsDownloadBase35 91 dvipsPreferOutline 91 instructions 91 LW35 91 ADOBE 91 ADOBEkb 91 URW 91 URWkb 91 Map 92 MixedMap 92 pdftexDownloadBase 14 92 URW fonts 91 V virtual fonts resolving 36 102
70. g 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 glyph has significant left or right side bearings Nonetheless 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 wor
71. ible to run the task on a regular basis in order to maintain an up to date package repository The install task installs MiKTeX from the local package repository The uninstall task removes MiKTeX Options common config dir common data dir common install dir common roots dirs list repositories local package repository dir modify path modify path no modify path package set set Set the location of the common configuration directory This option requires administrator privileges Set the location of the common data directory This option requires administrator privileges Set the common installation directory This option requires administrator privileges Register additional directories for all users dirs must be a semicolon separated list of fully qualified path names This option requires administrator privileges Environment variables lt VARNAME gt can be used Download the list of known package repository URLs from the project server then print the list Download into install from the specified directory Add MiKTeX to PATH Don t add MiKTeX to PATH Add MiKTeX to PATH Download Install the specified package set This must be one of essential basic complete 53 Programs print info only program folder name quiet remote package repository url shared shared no trace tracestreams use registry use registr
72. ied bibtex File Folder 5 4 2006 8 39 PM amp E My Documents tex File Folder 5 4 2006 8 40 PM E 4 My Computer E q 312 Floppy A E w Local Disk C amp E Documents and Settings an E C3 bibtex bib O misc amp C3 Program Files E E WINDOWS In our example the input files are distributed over three directories C Local TeX Files Contains bib files bibtex bib misc C Local TeX Files Contains bst files bibtex bst misc C Local TeX Files tex Contains LaTeX input files sty cls latex misc You use MiKTeX Options to register C Local TeX Files Click Start gt Programs gt MiKTeX 2 9 gt Maintenance gt Settings to open the MiKTeX Options window see Figure 4 1 MiKTeX Options General Settings Click on the Roots tab The Roots page see Figure 4 5 MiKTeX Options Roots shows the list of currently registered root directories 23 Maintenance Figure 4 5 MiKTeX Options Roots MiKTeX Options General Formats Languages Packages The list af registered root directories The order in the list determines the order in which Files are searched Up L Our Path Description C Documents and Settinga cechenk App 2 5 LU serConfig C Documents and Settingsscschenk L ac 42 5 UserD ata C Documents and Settings all LI sers s 2 5 CommonD ata C Program FilessiK T exi 2 5 Install Click Add In the following dialog b
73. iles DVI files can also be printed with the help of the command line utility mtprint MiKTeX Print Utility For example run mtprint paper to send the DVI file paper dvi to the default Windows printer See mtprint 1 for more information about mtprint 13 Chapter 4 Maintenance 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 database FNDB It is necessary that you refresh the file name database whenever you manually install TeX LaTeX related files in a user managed TEXMF directory You update the file name database with the help of MiKTeX Options Click Start gt Programs gt MiKTeX 2 9 Maintenance Settings to open the MiKTeX Options window see Figure 4 1 MiKTeX Options General Settings 14 Maintenance Figure 4 1 MiKTeX Options General Settings MiKTeX Options General Roots Formats Languages Packages Maintenance Refresh the file name database whenever you Refresh FNDE install or remove Files Update all format files when you have installed Update Formats new packages Paper Select pour default paper format w Fackage installation You can choose whether missing packages are to be installed on the fly Install missing packages on the fly Ask me first Click Refresh FNDB to refresh the file name database Setting the Preferred Paper Form
74. in input file starts with 96 amp and parse if it does This can be used to specify extra command line options Set the maximum number of characters in strings including all error messages and help texts and the names of all fonts and control sequences Suppress all output except errors Record all package usages and write them into file Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension 1s Set the the amount of space for saving values outside of current group Embed source file information source specials in the DVI file Set the maximum number of simultaneous input sources Set 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 Must be at least 25000 less than pool size but doesn t need to be nearly that large Generate SyncTeX data for previewers if nonzero Show processing time statistics Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream names Chapter 6 Trace Streams Set the amount of space for hyphenation patterns Use name as the name of the format to be used instead of the name by which the program was called or a oe ge line Show version information and exit 86 Programs Environment TEXINPUTS Extra paths to locate TeX input and openin files
75. is may affect the search paths and other values used Using this option is equivalent to copying the executable file to app exe and invoking app exe aux directory dir Set the directory di rto which auxiliary files are written Also look for input files in di r first before along the normal search path buf size n Setthe the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname TeX uses the buffer to contain input lines but macro expansion works by writing material into the buffer and reparsing the line As a consequence certain constructs require the buffer to be very large even though most documents can be handled with a small value c style errors Change the way error messages are printed The alternate style looks like error messages from many compilers and is easier to parse for some editors This option implies scrollmode disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation disable pipes Disable input output from to child processes disable writel8 dont parse first lin Disable checking whether the first line of the main input file starts with amp enable etex Enable eTeX extensions enable installer Enable automatic installation of missing packages
76. king 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 Prepend name as an additional header file or if name is suppress all header files Any definitions in the header file get added to the PostScript userdict Make each section be a separate file a section is 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 Download only needed characters from Type 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 the section called Managing Font Map Files 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 39
77. l output files foo dvi foo log will be created in C texoutput Specifying the Directory for Auxiliary Files The option aux directory dir causes TeX to create auxiliary files in another directory For example C gt mkdir C texoutput C gt mkdir C tobedeleted C gt latex output directory C texoutput aux directory C tobedeleted foo tex C gt This ensures that 1 foo dvi will be created in C texoutput and 2 all other files foo 1og will be created in C tobedeleted Running Programs From Within TeX write18 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 Writel8 tok 1ist starts the command interpreter usually cmd exe to carry out the command specified by toklist For example writel8 dir lists the files and sub directories of the current directory Note The write18 feature is only partially enabled by default to avoid security problems only well known commands are allowed You fully enable the feature by specifying enable writel8 on the TeX command line Piped Input and Output TeX s input output primitives can be used for unidirectional interprocess communication by prepending a pipe symbol to the file name If this feature is enabled then input commana starts the command interpreter usually cmd exe to carry out the command The output of the command becomes the i
78. lling Updates iia seien Rear RR In 16 Automatic Package Installation seseeseee emere 20 Integrating Local Additions ooooccoccoconcnnconccocononocononocononoconocnconocnronroronnoronanorinicos 21 A Short Excursion The TeX Directory Structure TDS ocooccoccncnncnncnoconcnnnononns 22 Walkthrough Registering a User Managed TEXMF Directory esses 22 3 Advanced Topics iiid ord DR nM ER REPRE RERO M CURRERE RES 28 Managing Font Map Files ssssssses cece cena cena em e He He e eene 28 Working With the Package Manager sse IH 28 Installing P cka ges 0 nente Bean ts Ban Den 28 Searching Packages erret RR rH ERR SER US R bom 29 Managing Memory Dump Files sese emere 29 Changing TEXMF run time parameters sese 29 IL Reterenc unit ar east E eR eie 31 6 PrOBrams nn Bra Re esi e te re REPRE RE PR RETE 33 lil MiKTeX 2 9 Manual bibeX T 34 dVICODy rn a eR RI D Eee qe 36 VIPS HE P 38 findtextmf iiri Deer Tenere reete e Ee Ue Ye Paese e pieces t Ure eee ree e ep end 43 BftOQVL ar soe teet oh wed tes e Ue etra eee teneo ne Poe eere eodem dodge 45 WIE XML osuere eee dev ues e E o ex ctv donde PORE NER E ER CORRER NEU CN EGRE I Sart 47 a Decio der c oat codes eire ductus foes 49 miktexsetup e iO IO Eb eee 53 MIkKtex OO 2v 56 TPM sir
79. m your computer in the following way 1 Open Control Panel 2 Double click Add or Remove Programs 3 Click MiKTeX 2 9 4 Click Change Remove Chapter 3 Using MIKTeX Getting Started If you have never used TeX before then it is recommendable to work through one of the TeX LaTeX tutorials A good starting point is this entry in the UK TeX FAQ http www tex ac uk cgi bin texfaq2html label tutorials MiKTeX doesn t differ very much from any other TeX system you might have used before Typesetting with MiKTeX involves these steps 1 Start TeXworks and edit your LaTeX document 2 Press Ctrl T to create a typeset view of your document Specialities This section describes features that were added to the MiKTeX implementation of TeX amp Friends Automatic Package Installation All MiKTeX programs can be configured in such a way that missing packages are automatically installed see the section called Automatic Package Installation 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 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 to create the file packages t xt which contains the nam
80. mation You invoke MiKTeX pdfTeX as follows miktex pdftex undump latex sample2e The undump option must be used to specify the format See the miktex pdftex reference page for more information 56 Programs If you prefer shortcuts you can create symbolic links to the MiKTeX pdfTeX engine mkdir bin cd bin In s usr bin miktex pdftex latex In s usr bin miktex pdftex pdflatex PATH bin PATH Then you can invoke the engine in the usual way pdflatex sample2e Of course you can replace bin with a more suitable directory Using the MiKTeX package manager MPM MiKTeX Package Manager was originally intended to be a tool for MiKTeX users But the program can be helpful for users of other TeX systems too because many of the MiKTeX packages are system independent There are two variants of the package manager GUI and console Run mpm to start the GUI variant of the package manager You will be presented with a list of packages The rest of this section describes the console variant of the package manager To list the contents of the package database run mpm list To get detailed information about a package run mpm print package info package If you want to install a package run mpm install package Using the mthelp utility The mthelp utility can be used to lookup package documentation Run mthelp package to view an HTML page wich contains links to the documentation fil
81. ng the Xerox 4045 41 Programs V x num X num y num Y num z Z See Also Dvips A DVI to PostScript Translator 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 must 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 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 Set the horizontal resolution in dots per inch to num Set the y magnification ratio to num 1000 See x above 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
82. nput anything 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 Options alias app Pretend to be app i e set program and memory dump name to app This may affect the search paths and other values used Using this option is equivalent to copying the executable file to app exe and invoking app exe aux directory dir Set the directory dirto which auxiliary files are written Also look for input files in dir first before along the normal search path bistack size n Set the size of the stack for bisection algorithms buf size n Setthe the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname TeX uses the buffer to contain input lines but macro expansion works by writing material into the buffer and reparsing the line As a consequence certain constructs require the buffer to be very large even though most documents can be handled with a small value c style errors Change the way error messages are printed The alternate style looks like error messages from many compilers and is easier to parse for some editors This option implies scrollmode disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX O
83. nput of TeX For example 10 Using MiKTeX input dir b typesets the file names of the current directory Likewise it is possible to let TeX write something into the input stream of a command For example immediate openoutl unix2dos sort gt sorted immediate write 1 b immediate write 1 a immediate write 1 c immediate closeoutl input sorted typesetsabc Note Piped input and output is disabled by default to avoid security problems You enable the feature by specifying nable pipes on the TeX command line 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 proposals 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 This approach limits th
84. ox Figure 4 6 Browsing to a Root Directory browse to C Local TeX Files and click OK 24 Maintenance Figure 4 6 Browsing to a Root Directory Browse For Folder Select the root directory to be added a My Documents Y My Computer fh 31 Floppy A 3 w Local Disk C H Documents and Settings 3 O Local Tex Files E O Program Files 3 5 WINDOWS Folder Local Tex Files Make New Folder The root directory will be appended to the list Figure 4 7 MiKTeX Options Root Directory Added 25 Maintenance Figure 4 7 MiKTeX Options Root Directory Added MiKTeX Options General Formats Languages Packages The list of registered root directories The order in the list determines the order in which files are searched Path Description C Documents and Settings4cschenk App 2 5 LU serConfig C Documents and Settingsscschenk L ac 42 5 UserD ata C Documents and Settings all LI sers a 2 5 CommonD ata C Program FilessdiK T exi 2 5 Install CALocal Tex Files You can move C Local TeX Files before the installation directory if you want to prioritize your own files Click CALocal TeX Files to select the list entry Then click Up to move it before the installation directory Figure 4 8 MiKTeX Options Root Directory Moved 26 Maintenance Figure 4 8 MiKTeX Options Root Directory Moved MiKTeX Options General Formats Languages Package
85. phenation patterns for english german ngerman loaded D N e texmf tex latex base article cls ocument Class article 2001 04 21 vl 4e Standard LaTeX document class N f texmf tex latex base sizel0 clo o 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 C gt Note the altered output file names foo aux foo dvi and foo log Auto insertion of Source Specials 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 oo tex and the DVI location e g page 2 in foo dvi Source specials can improve the edit compile view edit cycle Using MiKTeX 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 window back to the front moving the text cursor directly to the line that corresponds to the view location How to Insert Source Specials The TeX compiler option src specials directs TeX to insert source specials into the DVI file You
86. pt PDF tools printers use bad default fonts it is safer to download the fonts The PDF files will get bigger though Arranges that the contents of filename will be included in psfonts map Arranges that the contents of filename will be included in psfonts map unless dvipsPreferOutline is set to false Mixed means that the fonts referenced in the file are available as bitmap and as outline 92 Chapter 5 Environment variables BIBINPUTS BSTINPUTS MFINPUTS MIKTEX REPOSITORY MIKTEX TRACE MPINPUTS H EXINPUTS TEMFONTS Extra paths to locate bib files Extra paths to locate bst files Extra paths to locate METAFONT input and openin files Location of the package repository This can be either a fully qualified path name a local package repository or an URL a remote package repository Comma separated list of trace stream names see Chapter 6 Trace Streams If this variable is set then MiKTeX programs will write trace messages into the DebugView window Extra paths to locate MetaPost input files Extra paths to locate TeX input and openin files Extra paths to locate TeX font metric files 93 access config core curl dib dvibitmap dvicolor dvifile dvigc dvihypertex dvipage dvipkbitmap dvipkchar dvipkfont dvisearch dvitfm dvivfchar dvivfont env error extractor files filesearch fndb fontinfo mem mmap mpm Chapter 6 Tra
87. ptions see the section called Automatic Package Installation disable pipes Disable input output from to child processes dont parse first lin Disable checking whether the first line of the main input file starts with 96 amp enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation nable pipes Enable input output from to child processes rror line n Set the width of context lines on terminal error messages half error line n Setthe width of first lines of contexts in terminal error messages 50 Programs halt on error help hhelp include directory dir initialize interaction mode job name nam job time fil lig table size n main memory n max print line n max strings n max wiggle n move size n no c styl rrors output directory dir param size n parse first lin path size n pool size n quiet Quit after the first error Give help and exit This option is only available on Windows systems show the manual page in an HTML Help window and exit when the window is closed Prefix dirto the search path Become the ZNI variant of the compiler Set the interaction mode Must be one of batchmode nonstopmode scrollmode and errorstopmode The
88. ration files are provided which can be enabled via dvips Poutline resp dvips Ppk 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 URWkb URW fonts with berry file names e g uhvbo8ac pfb URWkb is the default value ADOBE Adobe fonts with vendor file names e g hvnbo p b ADOBEkb Adobe fonts with berry file names e g phvbo8an pfb Specifies whether Dvips downloads the standard 35 LaserWriter fonts with the document If these fonts are not downloaded then 91 Files pdftexDownloadBasel4 value dvipdfmDownloadBasel4 value Map filename MixedMap filename they must be available in the PostScript printer interpreter Valid values are t rue 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 Specifies whether pdfTeX downloads the base 14 PDF fonts Valid values are t rue 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 Specifies whether Dvipdfm downloads the base 14 PDF fonts Valid values are t rue default and false Since some configurations PostScri
89. reams trie size n undump name Setthe maximum number of semantic levels simultaneously active Don t change the way error messages are printed Create output files in dir This implies include directory dir Set the output format Setthe the maximum number of simultaneous macro parameters Check whether the first line of the main input file starts with amp and parse if it does This can be used to specify extra command line options Set the maximum number of characters in strings including all error messages and help texts and the names of all fonts and control sequences Suppress all output except errors Record all package usages and write them into file Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension fls Set the the amount of space for saving values outside of current group Embed source file information source specials in the DVI file Set the maximum number of simultaneous input sources Set 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 Must be at least 25000 less than pool size but doesn t need to be nearly that large Generate SyncTeX data for previewers if nonzero Show processing time statistics Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream
90. reference manual explains what a LaTeX source file must contain to work with bibtex Appendix B of the manual describes the format of the bib files The BibTeXing document describes extensions and details of this format and it gives other useful hints for using bibtex Options alias app Pretend to be app i e set program and memory dump name to app This may affect the search paths and other values used Using this option is equivalent to copying the executable file to app exe and invoking app exe disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation disable pipes Disable input output from to child processes enable installer Enable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the section called Automatic Package Installation nable pipes Enable input output from to child processes help Give help and exit hhelp This option is only available on Windows systems show the manual page in an HTML Help window and exit when the window is closed include directory dir Prefix dir to the search path min crossrefs n 34 Programs quiet record package usages file trace tracestreams version Environment BIBINPUTS
91. rollmode and errorstopmode The meaning of these modes is the same as the corresponding commands Set the name of the job Sobname This has an affect on the output file names Set the time stamp of all output files equal to file s time stamp Change the total size in memory words of the main memory array Relevant only while creating memory dump files Set the maximum number of input files and error insertions that can be going on simultaneously Setthe width of longest text lines output should be at least 60 Set the maximum number of strings Enable MLTeX extensions such as charsubdef Setthe maximum number of semantic levels simultaneously active Don t change the way error messages are printed Create output files in dir This implies include directory dir Set the the maximum number of simultaneous macro parameters Check whether the first line of the main input file starts with 96 amp and parse if it does This can be used to specify extra command line options Set the maximum number of characters in strings including all error messages and help texts and the names of all fonts and control sequences 70 Programs quiet record package usages file recorder save size n src specials stack size n string vacancies n tcx name time statistics trace tracestreams trie op size n trie size n undump name version See also Draft docum
92. ry if you are running MPM as a standalone program i e if MiKTeX is not the TeX system The install root option allows you to set the installation directory for one invocation of MPM Package Database All package information is retrieved from the package database which must have been properly installed by running MPM with the update db option Examples Print the list of known package repository URLs C gt mpm list repositories Retrieve the package database files from the FTP server some server C gt mpm repository ftp some server miktex packages verbose update db Print information about package a0poster C gt mpm print package info a0poster Install package aOposter C gt mpm verbose install a0poster Update all installed packages C gt mpm verbose update Print the list of installed packages C gt mpm list grep i Environment http proxy The proxy server to be used for HTTP FTP PROXY The proxy server to be used for FTP ALL PROXY The proxy server to be used if no protocol specific proxy is set NO PROXY Comma separated list of host names that should not go through any proxy 61 Programs See also MiKTeX Project Page http miktex org 62 Programs Name mpost MetaPost a system for drawing pictures Synopsis mpost option command l i1e Description MetaPost installed as mpost reads a series of pictures specified in
93. s Some of the more interesting paramaters main memory Total words of memory available for TeX METAFONT and MetaPost You must remake the format file after changing see the section called Managing Memory Dump Files extra mem bot Extra space for large TeX data structures boxes glue breakpoints et al font mem size Words of font info available for TeX See Chapter 7 TEXMF Run Time Parameters for a complete list of the TEXMF run time parameters Here is a typical example of a configuration file main memory 2000000 extra mem bot 2000000 font mem size 2000000 The name of the configuration file is that of the engine e g pdftex or format e g pdflatex You use the edit config file option of initexmf to edit the configuration file e g C gt initexmf edit config file pdflatex C gt 30 Part Il Reference Table of Contents 6 Programs seine fragt eben fine Een 33 DIDIER ne p 34 mu 36 mun cM AE E E E E E E A A E 38 ANGER oo vie ee Re re pit pida 43 ui MEE 45 INIEXMI EE 47 ME MP 49 MIKTEXSELUP EE 53 thiktex tools A e etes Geen gio ereese ee ein GAMBA oie 56 uH 59 IMPOSE es EE 63 mtbhelp 2 5 hes EG bet tt te ae pata aah ag ea 66 HN MESES 68 OMEga Er 69 t ktexspadfiex utes Dr eite eee PC E E DII EE 12 SCLUPWIZ He ee tn es mh Eee Rn Brillen ie 76 oq EE 78 ian a neh rd iia 82 O x P 84 4 Filey EU 88 pd
94. s The list af registered root directories The order in the list determines the arder in which Files are searched Path Description C Documents and Settings4cschenk App 2 5 UserContig C Documents and Settings cachenksLoc 42 5 User ata C Documents and Settings all LI sers a 2 5 CommonD ata CALocal Tes Files C Program FilegsMIE Tex 2 5 Install Click OK to close MiKTeX Options The file name database will be refreshed Your files in C Local TeX Files are now available to MiKTeX 27 Chapter 5 Advanced Topics Managing Font Map Files 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 It can be manually created by running initexmf mkmaps psfonts map depends on the file updmap cfg This configuration file contains declarative instructions see updmap cfg 5 which will be used to build ps fonts map Caution The contents of psfonts map should never be edited directly Your modifications get lost when you install new packages For example follow these steps if you want to add an entry for the font map file xyz map l Runinitexmf edit config file updmap 2 Insert the following line at the end of the file Map xyz map 3 Save the file and close the editor 4 Runinitexmf mkmaps to rebuild the font map files Working With the Package Manager You use MiKTeX Package Manager MPM to install and remo
95. s also disables page movement etc in PostScript viewers such as GSview Send output to the file name If o is specified without name the default is file ps where the input DVI file was ile 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 name is 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 anda 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 Move the origin by x offset y offset a comma separated pair of dimensions such as lin 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 test page tex to determine the correct value for your printer Be sure to do several runs with the same O 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 inform
96. s you out of the loop if you don t want to input anything You can also type your EOF character usually Control Z Options alias app Pretend to be app i e set program and memory dump name to app This may affect the search paths and other values used Using 78 Programs aux directory dir buf size n c style errors disable installer disable pipes disable writel8 dont parse first lin nabl nctex enable installer nabl mltex nabl pipes nabl writel8 rror line n xtra mem bot n xtra mem top n font max n font mem size n half rror line n halt on error this option is equivalent to copying the executable file to app exe and invoking app exe Set the directory dirto which auxiliary files are written Also look for input files in dir first before along the normal search path Setthe the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname TeX uses the buffer to contain input lines but macro expansion works by writing material into the buffer and reparsing the line As a consequence certain constructs require the buffer to be very large even though most documents can be handled with a small value Change the way error messages are printed The alternate style looks like error messages from many compilers an
97. specify extra command line options Set the maximum number of characters in strings including all error messages and help texts and the names of all fonts and control sequences Suppress all output except errors Enable the file name recorder This leaves a trace of the files opened for input and output in a file with the extension 1s Record all package usages and write them into file Set the the amount of space for saving values outside of current group 80 Programs src specials stack size n string vacancies n tcx name time statistics trace tracestreams trie size n undump name version Aliases initex Equivalenttotex ini virtex Equivalent to tex Environment TEXINPUTS Embed source file information source specials in the DVI file Set the maximum number of simultaneous input sources Set 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 Must be at least 25000 less than pool_size but doesn t need to be nearly that large Show processing time statistics Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream names Chapter 6 Trace Streams Set the amount of space for hyphenation patterns Use name as the name ofthe format to be used instead ofthe name by which the program was called
98. st the package repository for updates then print the list of updateable packages Give help and exit This option is only available on Windows systems show the manual page in an HTML Help window and exit when the window is closed Import the specified package from another MiKTeX installation The root directory must be specified via repository DIR Import all packages from another MiKTeX installation The root directory must be specified via repository DIR Install the specified package 59 Programs list list repositories pick repository url print package info package quiet repository location repository release state state set repository location trace tracestreams uninstall package update package update db update some fil verify verifyzpackage Install packages listed line by line in the specified file List the contents of the package database for each package print the installation status the number of files the size and the name Download the list of known package repository URLs from the project server then print the list Pick up a suitable URL from the package repository list and print it Print detailed information about the specified package Suppress all output except errors Use the specified location as the package repository The location can be either a fully qualified path name a local package repository
99. stead of a file name a set of pdfTeX commands can be given the first of which must start with a backslash pdfTeX is a version of TeX that can create PDF files as well as DVI files In PDF mode pdfTeX can natively handle the PDF JPG and PNG graphics formats Options alias app Pretend to be app i e set program and memory dump name to app This may affect the search paths and other values used Using this option is equivalent to copying the executable file to app exe and invoking app exe aux directory dir Set the directory dir to which auxiliary files are written Also look for input files in dir first before along the normal search path buf size n Setthe the maximum number of characters simultaneously present in current lines of open files and in control sequences between csname and endcsname TeX uses the buffer to contain input lines but macro expansion works by writing material into the buffer and reparsing the line As a consequence certain constructs require the buffer to be very large even though most documents can be handled with a small value c style errors Change the way error messages are printed The alternate style looks like error messages from many compilers and is easier to parse for some editors This option implies scrollmode disable installer Disable automatic installation of missing packages Specifying this option overwrites the global configuration setting in MiKTeX Options see the s
100. submitting the same PostScript file multiple times 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 Set both the horizontal and vertical resolution to num given in dpi 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 Maximum drift in pixels of each character from its true resolution independent position on the page The default value of this parameter is 38 Programs f F h name i k 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 spacin
101. t lines of contexts in terminal error messages Should be between 30 and error line 15 half error line 50 Words of inimemory available main memory 3000000 Width of longest text lines output should be at least 60 max print line 79 se Maximum number of strings max strings 500000 Maximum number of simultaneous macro parameters param size 10000 7 Pool space free after format loaded pool_free 47500 Max number of characters in all strings including all error messages help texts font names control sequences 7 These values apply to TeX and MP pool size 3250000 Maximum number of simultaneous input sources Stack size 5000 Strings available after format loaded strings free 100 96 TEXMF Run Time Parameters Minimum pool space after TeX MP s own strings must be at least 25000 less than pool size but doesn t need to be nearly that large string vacancies 90000 All TeX Programs Maximum number of input files and error insertions that can be going on simultaneously max in open 50 Maximum number of semantic levels simultaneously active nest size 500 Space for saving values outside current group save size 50000 Space for hyphenation patterns trie size 700000 Total number of fonts font max 9000 Words of font info for TeX total size of all TFM files approximately font mem size 3000000 Extra space for
102. testing macros that use Wdfliteral This integer specifies the preciseness of real numbers in PDF page descriptions It 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 and more time to display or print In most cases the optimal value is 2 This parameter does not influence the precision of numbers used in raw PDF code like that used in pdfliteral and annotation action specifications These dimension parameters can be used to set the offset of the TeX output box from the top left corner of the paper 89 Files image resolution move chars output format page width amp page height pdf minorversion pk resolution When pdfTeX 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 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 This integer parameter specifies whether the output format should be DVI or PDF A positive value means PDF output otherwise we get DV
103. the MetaPost programming language and outputs corresponding PostScript code Like TeX and METAFONT MetaPost is normally used with a large body of precompiled macros This version of MetaPost looks at its command line to see what name it was called under Both inimpost and virmpost are aliases for the mpost executable When called as inimpost or when the initialize option is given it can be used to precompile macros into a mem file When called as virmpost it will use the plain mem When called under any other name MetaPost will use that name as the name of the mem to use For example when called as mpost the mpost mem is used which is identical to the plain mem Other mems than plain are rarely used The commands given on the command line to the MetaPost 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 MetaPost s favorite symbols like semicolons unless you quote them The first line should begin with a filename a controlsequence or a amp basename The normal usage is to say mpost figs to process the file figs mp The basename of figs becomes the jobname and is used in forming output file names If no file is named the jobname becomes mpout The default extension mp can be overridden by specifying an extension explicitly Options alias app Pretend to be app i e set program and memory dump name
104. ve packages 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 mpm 1 for a list of available command line options To start the package manager in windowed mode click Start gt Programs gt MiKTeX 2 9 Browse Packages You will see a window similar to this 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 ConTeXt package 1 Locate and select the ConTeXt package in the list view e g type the key sequence C ON T 2 You can now click to install the package 28 Advanced Topics 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 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 Managing Memory Dump Files In typical use TeX METAFONT and MetaPost require a large number of macros to be predefined therefore they support memor
105. y dump files which can be read much more efficiently than ordinary source code For example LaTeX macros are stored in the file latex fmt This file is loaded by pdfTeX when you start latex MiKTeX Options can assist you in defining a new memory dump file Click Start gt Programs gt MiKTeX 2 9 Maintenance Settings to open the MiKTeX Options window see Figure 4 1 MiKTeX Options General Settings Click on the Formats tab You are presented with a list of known memory dump files To add an entry to this list click New In the Format Definition dialog box enter the following information Format name The name of the memory dump file without an extension Compiler The program which creates and loads the memory dump file Input file The name of the main input file Preloaded format Optional The name of another memory dump file which must be loaded before the actual memory dump file is being created Descriptioin A one line comment which describes the new memory dump file A new executable file with the name of the memory dump will be installed in the MiKTeX bin directory This executable serves as a short cut for compiler amp name For example these two commands are equivalent latex sample2e pdftex amp latex sample2e Changing TEXMF run time parameters You can control a number of run time parameters in particular array sizes on the command line or in a configuration file 29 Advanced Topic
106. y no user config dir user data dir user install dir user roots dirs verbose version Examples Downloading Print information about what would be done then exit Add shortcuts to the specified program folder Suppress all output except errors Download from the specified URL Use list repositories to download an up to date list of possible repositories Run the task for all users This option requires administrator privileges Run the task for current user only Enable trace messages The tracestreams argument if speciefied is a comma separated list of trace stream names Chapter 6 Trace Streams Write configuration settings into the Windows registry Don t write configuration settings into the Windows registry Use configuration files instead Set the location of the configuration directory for the current user Environment variables lt VARNAME gt can be used See the example below Set the location of the data directory for the current user Environment variables lt VARNAME gt can be used See the example below Set the user installation directory Environment variables lt VARNAME gt can be used See the example below Register additional directories for the current user dirs must be a semicolon separated list of fully qualified path names Environment variables lt VARNAME gt can be used Turn on verbose output mode Show version information and exit

MiKTeX 2.9 Manual - Revision 2.9.5671

Contents

Download Pdf Manuals

Related Search

Related Contents