====== Troubleshooting ======
It is inevitable.  Tex is such a monster that you are going to have troubles of one sort or another.  Here we can collectively have an archive of the most common solutions!

&&Note that with the console open, most of the time you can either push ``enter`` when the console printout pauses with a message to skip over the error or warning and just continue, OR you can push ``Q`` to just finish the script in silence.  Either way you will see the resulting PDF.&&

=====Topics=====
  *[[#Missing Begin Document]]
  *[[#Option Clash for Geometry]]
  *[[#Cannot Extract Embedded Font AND/OR Hieroglyphs]]


====Missing Begin Document====
<code>! LaTex Error: Missing \begin{document}.</code>
**Solution:**

...or you can just push ``return`` and continue, hoping it turns out okay anyway (it just might!).


====Option Clash for Geometry====
<code>! LaTex Error: Option clash for package geometry.</code>
**Solution:**

...or you can just push ``return`` and continue, hoping it turns out okay anyway (it just might!).


====Cannot Extract Embedded Font AND/OR Hieroglyphs====
When you open the pdf in Adobe Acrobat, you get a warning:
<code>Cannot extract the embedded font 'ZMIZFF+greciliae'. Some characters may not display or print correctly.</code>

{{:gregowiki:hieroglyphs.png?nolink&400|}}

When you open the pdf file in Adobe Acrobat you may see hieroglyphs - Characters that look like they are pulled and smeared along the page or long parenthesis-looking characters that are not supposed to be there.

[[http://choorucode.com/2010/02/02/adobe-acrobat-embedded-font-error/|This is a popular error]].

These errors have to do both with the fonts themselves and with the way TexLive embeds the fonts.  I've noticed that these funny marks print if I embed the pdf inside another pdf using InDesign.  If I open it directly there is no problem.

**Workarounds**
 - Open the pdf file in Adobe Acrobat and save it as a .ps (postscript) file.  Then open the .ps file in Adobe Distiller to reconvert it to pdf.  This should solve the error message.
 - In Adobe Reader, when you enter the print dialogue, click on //Advanced// and then check the box for //Print as Image//.
 - Open the pdf that TexLive created and save it as a jpeg and include that in your InDesign document!  [[http://www.xnview.com/en|XnView]] is free and does a good job of converting pdfs to jpegs.



Back to [[Start]] Page