LaTeX Generation

Cassiopeia automatically generates and compiles LaTeX code when it comes to printing and thus produces results in book printing quality. It does not require the user to know LaTeX or any other typesetting language. Instead easy to remember key strokes are used to efficiently create document content in a WYSIWYG environment. However, if the LaTeX representation for a piece of text is known that cannot be expressed by any other means in Cassiopeia this pure LaTeX can be inserted using so called LaTeX regions (see Documents).

Open any Cassiopeia document or book and press Command-p to open the print document panel.

A bunch of self-explaining controls are offered to customize the LaTeX generation. Make your selections and then click on the brown wheel in the top right corner to start the LaTeX generation process. A temporary directory is created, LaTeX code for the document generated and compiled using a customizable script (see GenerateLaTeXScript entry on the Environment pane of the preferences panel). The resulting PDF is opened using your default PDF viewer (probably Preview.app).

The default value for the GenerateLaTeXScript entry in the Cassiopeia preferences is /Library/Frameworks/SDMFoundation.framework/Resources/generateLaTeXPDF. You can inspect this script e.g. in a terminal session by doing cat /Library/Frameworks/SDMFoundation.framework/Resources/generateLaTeXPDF. The script needs to find your LaTeX distribution or compiling automatically generated LaTeX code won't work. If you do not use the LaTeX packages from the Cassiopeia Essentials disk image but have installed any other LaTeX distribution make sure the above script contains the PATH to your distribution (either extend the script or provide a replacement). If you do not know how to do that please contact support@advanced-science.com. We will be happy to assist.

HTML Generation

Cassiopeia comes with a built-in HTML generation engine that allows to publish scientific documents in HTML form. Open any Cassiopeia document and press Command-Shift-W to open the HTML generation panel.

Click on the first Browse button to select a destination path for the HTML and image files to be generated. Optionally click on the second Browse button to select a html file that is to be used as a frame for the generated html. This file should contain the string <content/> at the location where Cassiopeia is supposed to insert the HTML for your document. This approach allows to customize the HTML generation process to the extend that the resulting files can immediately by synched to the htdocs directory of your webserver. These two settings need to be made only once (saved in your user defaults). Once you have made or verified the settings click on Generate HTML. The generated *.html file is automatically opened in your default browser. See Example Paper in HTML for an example for a automatically generated HTML representation of a Cassiopeia document.