Return to Print_Tricks.tex CVS log

Up to [LON-CAPA] / loncom / html / adm / help / tex

Annotation of loncom/html/adm/help/tex/Print_Tricks.tex, revision 1.2

1.1       foxr        1: \label{Print_Tricks}
                      2: 
                      3: When you print a LonCAPA resource, the XML of your resource is translated into
                      4: LaTeX.  The LaTeX is then processed and turned into a PDF document which can 
                      5: be displayed with your browser's Acrobat plugin and subsequently printed.
                      6: 
                      7: There are several problems that crop up both due to limitations in the XML to LaTeX
                      8: translation and due to differences in the model used by web browsers to render
                      9: HTML and LaTeX to compose print pages.  This document provides information
                     10: about some of these problems and, where possible, solutions, and tricks to work 
                     11: around them.  If you have a printing trick or a problem and would like to report 
                     12: it, please go to  http://bugs.lon-capa.org and register a bug report.
                     13: 
                     14: General information about printing within LonCAPA is also available: 
                     15: \ref{Print_Resource}
                     16: 
1.2     ! foxr       17: \emph{\&prettyprint and \&dollarformat look ugly}
        !            18: 
1.1       foxr       19: To make these two functions work correctly within the print translator, it is
                     20: necessary to wrap them within a <DISPLAY> tag.  For example:
                     21: 
                     22: \begin{verbatim}
                     23: <p>
                     24: If I had <display>&dollarformat(100)</display>
                     25: </p>
                     26: \end{verbatim}
                     27: 
                     28: Note that the <display> tags must be tightly wrapped around the function call or
                     29: you will get a syntax error in web presentation mode.
                     30: 
                     31: 
1.2     ! foxr       32: \emph{Image placement and alignment is wrong}
        !            33: 
1.1       foxr       34: Unfortunately this is due to a large difference between the LaTeX and HTML page
                     35: layout model.  In HTML images are placed exactly where you ask them to be placed.  
                     36: In LaTeX, images are considered {\em floats}, which LaTeX will place for you.
                     37: There are a few print options you can try to place images approximately where you 
                     38: want them relative to sorrounding text \ref{Print_Options}.
                     39: 
1.2     ! foxr       40: \emph{Variables with tags don't print correctly}
        !            41: 
1.1       foxr       42: If a variable contains XML, in general it is necessary to force the XML parser
                     43: to make a pass over the contents of the contents of the variable prior to rendering
                     44: the section of the resource that contains that substitution.  For example:
                     45: 
                     46: \begin{verbatim}
1.2     ! foxr       47: <problem>
        !            48: <script type="loncapa/perl">
        !            49: $a = &xmlparse('<br />');
        !            50: </script>
        !            51: <startouttext />
        !            52: <p>This is a break <display>$a</display> and then some more text</p>
        !            53: <endouttext />
        !            54: </problem>
        !            55: \end{verbatim}
1.1       foxr       56: 
1.2     ! foxr       57: Without the xmlparse call and the display tag bracketing the variable, this
        !            58: problem will display on the web just fine, but print incorrectly.
1.1       foxr       59: 
                     60: 
                     61: