## MiKTeXFAQ (January 02, 2016)

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.

This is the official MiKTeX FAQ. It is available in the following formats:

• formatted in HTML entirely on one web page

• formatted in HTML with one web page per section

## General

1. What is MiKTeX?
3. Which Windows version is required for running MiKTeX?
4. Am I allowed to redistribute MiKTeX?
 1. What is MiKTeX? MiKTeX is a complete TeX system for Windows. 2. Is there a home page? Yes. The official project page is https://miktex.org/. 3. Which Windows version is required for running MiKTeX? MiKTeXÂ 2.9 requires one of the following Windows operating systems:WindowsÂ 8WindowsÂ 7WindowsÂ Vista with Service PackÂ 2 (all editions except Starter Edition)WindowsÂ XP with Service PackÂ 3 (all editions except Starter Edition)Windows ServerÂ 2008Â R2Windows ServerÂ 2008 with Service PackÂ 2Windows ServerÂ 2003Â R2Windows ServerÂ 2003 with Service PackÂ 2 4. Am I allowed to redistribute MiKTeX? The MiKTeX distribution is a conglomerate of many software packages. To the best of my knowledge, all packages meet the requirements of the Debian Free Software Guidelines. This means that MiKTeX may be freely used, copied, modified, and redistributed.Please visit this page, for more information

## Installation

2. How do I install MiKTeX?
3. What is the âBasic MiKTeXâ installer?
4. What is the MiKTeX Net Installer?
5. Is MiKTeX available on CD or DVD?
6. Is it possible to download MiKTeX without the wizard?

## Getting Help

1. How do I get support?
2. Is there a mailing list?
3. How can I join the mailing list?
4. How can I read old articles?
5. How can I leave the mailing list?
 1. How do I get support? Please visit https://miktex.org/support, for an overview of available support options. 2. Is there a mailing list? Yes. 3. How can I join the mailing list? To join the list, direct your browser to the MiKTeX-Users Info Page and fill out the form.You will receive instructions (via email) on how to use the mailing list. 4. How can I read old articles? To see the collection of prior postings to the MiKTeX-Users list, visit the MiKTeX-Users Archives. 5. How can I leave the mailing list? Visit the MiKTeX-Users Info Page and enter you subscription email address to change your subscription status.

## Basics

1. I have installed MiKTeX. How do I use it?
2. Which program should I use to edit LaTeX documents?
 1. I have installed MiKTeX. How do I use it? If you have never used TeX before: we recommend that, first of all, you work through a TeX/LaTeX tutorial. A good starting point is this page.MiKTeX doesn't differ very much from any other TeX system you might have used before. Typesetting with MiKTeX involves these steps:Start TeXworks and edit your LaTeX document.Press Ctrl+T to create a typeset view of your document. 2. Which program should I use to edit LaTeX documents? The MiKTeX distribution includes TeXworks, a simple environment for editing TeX/LaTeX documents.

## Maintenance

1. How do I update my MiKTeX system?
2. Which is the best directory to keep .sty files where MiKTeX can find them?
3. How do I add new languages to the LaTeX format file?
4. How do I refresh the file name database?

## Packages

1. How do I install package X?
2. Why is package X not MiKTeX package repository?
3. How can I find out which package the file x.y belongs to?
 1. How do I install package X? If package X is a part of the MiKTeX package repository, then you install it with the help of MiKTeX Package Manager. See the section Working With the Package Manager in the MiKTeX manual.For the impatient: try it with mpm --verbose --install X If the package turns out to be missing in the MiKTeX package repository, then you must install it manually. See also Q:Â 2. 2. Why is package X not MiKTeX package repository? There are two possible reasons:It is a new package of which the MiKTeX maintainers are not aware of.The package's license doesn't meet the requirements of the Debian Free Software Guidelines. 3. How can I find out which package the file x.y belongs to? The search facility in MiKTeX Package Manager allows you to enter all or part of a file name. For example, enter colortbl.* to find out that colortbl.sty belongs to the package carlisle.

## (La)TeX

1. Why does latex use pdfTeX (and not TeX)?
2. How can I change the output file name?
3. How can I change the output directory?
4. How do I insert source specials into the DVI file?
 1. Why does latex use pdfTeX (and not TeX)? pdfTeX is now the default typesetting engine. The DVI output should be identical to that of TeX. 2. How can I change the output file name? You can use option --job-name to set the name of the output file. For example, you would run pdflatex --job-name=dog cat.tex to create the PDF file dog.pdf instead of cat.pdf. 3. How can I change the output directory? You can use the option --output-directory to specify an alternative location for all output files.For example, you would run pdflatex --output-directory=C:\temp mydoc.tex to deposit the output file (mydoc.pdf) in C:\temp\. 4. How do I insert source specials into the DVI file? You use the --src-specials option to enrich the DVI file with source file information (aka âsource specialsâ).Source specials enable the DVI previewer to synchronize with the text editor while you are editing the TeX source file.For example, run the latex --src mydoc.tex to enrich DVI file mydoc.dvi with source file information, i.e., mydoc.dvi will contain references to mydoc.tex.

## Dvips

1. How do I produce PostScript for distilling to PDF?
 1. How do I produce PostScript for distilling to PDF? You use the option -Ppdf to produce PostScript optimized for distilling to PDF.For example, the command dvips -Ppdf mydoc.dvi causes Dvips to use Type 1 fontsand an alternative rule drawing algorithm.

## Yap

1. How can I navigate to a random page?
 1. How can I navigate to a random page? You can type the page number followed by g to jump to a certain page. For example, typing the key sequence 220g will direct Yap to page 220.

## Troubleshooting

1. I want to see what's going on backstage. Where does MiKTeX write the trace messages?
2. How do I use the DebugView window?
3. How do I set trace options?
 1. I want to see what's going on backstage. Where does MiKTeX write the trace messages? MiKTeX programs log their actions into the DebugView window, if you specify suitable trace options. 2. How do I use the DebugView window? First of all, you will need the DebugView utilitt, which is a part of the Windows Sysinternals suite. To download. To download DebugView, visit the Windows Sysinternals page. 3. How do I set trace options? Set the environment variable MIKTEX_TRACE. The value must be a comma-separated list of trace stream names. For example,set MIKTEX_TRACE=error,accesswill trace all errors and file accesses. For more information, read the section Trace Streams in the MiKTeX manual.