Links

Cassiopeia makes use of a relational database to store sections, books, bibliography entries and all kinds of text objects. This allows efficient management of tons of documents, fulltext search and cross-referencing from any to any object. This document is supposed to explain the generic link mechanism of Cassiopeia. Links can reference sections, equations, images and bibliography entries.
  • Section links
  • Equations links
  • Image links
  • Bibliography and citations

Section links

Open an existing or create a new document and type a sentence like: "As can be seen in " Then press Command-Shift-M to insert a link anchor.


Do not type MARK. The word MARK is inserted by Cassiopeia when you press Command-Shift-M and assigned the link source attribute. Now open any other document, click into the section you want to reference and press Command-Shift-L to complete the link creation. The MARK anchor is replaced with the title of the referenced section, in this case Analysis.


The red color indicates a link. Doubleclicking on a section link opens the target document and scrolls to the referenced section.


Go back to the document that contains the link and therein press Command-p to open the print panel. Use the Referenced Sections popup to specify how referenced sections are to be treated during LaTeX generation.


Exclude means referenced sections are excluded from the export. Include in main matter means referenced sections are appended to the LaTeX output as part of the main matter.


Include in appendix means referenced sections are appended to the LaTeX output as part of the appendix.

Open the example book we created in the last tutorial and add a section referencing some other section to a chapter. Note that in the example below the book A Treatise on Electricity and Magnetism references the section A second paper and that this section contains a link to section Analysis in document My first paper.

Neither My first paper nor its subsection Analysis are referencec by the book directly. However, Analysis is referenced indirectly via the link in A second paper. Set the referenced sections popup on the print panel to Include in appendix

and generate LaTeX for the book.


The indirectly referenced section Analysis is appended as part of the appendix.

Equation links

Another possible link target is an equation. Create a document and insert a couple of equations. Then type a few words and at a suitable location press Command-Shift-M to create a link anchor. This inserts MARK into your document.


Click on an equation in any document - we choose the first one in this test document - and press Command-Shift-L to complete link creation.


Note, that MARK is replaced with (Eq.) in red indicating a link and that the target equation gets numbered. Save changes and press Command-p to generate LaTeX for the document.


All three equations of the equation array are numbered in in the TeX output. Cassiopeia can have numbered and not numbered equations in an array, LaTeX can't. If you only want the first equation to be numbered in the LaTeX output a newline has to be inserted between the first equation and the other two.


Cassiopeia currently does not maintain an equation counter. Since equations can be inserted everywhere at any time in the document those numbers would become unordered quickly anyway. That's why Cassiopeia just shows a neutral (Eq.) label to present an equation link. Doubleclicking on such a link always takes you to the target and thus tells you which equation is referenced. The equation numbers appearing in the PDF are generated during LaTeX compilation.

Image links

Yet another kind of links can reference images. Drag some image (pdf, tiff, png,...) from Finder.app into your document, type a few words and create a link anchor by pressing Command-Shift-M.


Then click on an image in any document and press Command-Shift-L to complete link creation. MARK is replaced with (Fig.).


Press Command-p to open the print panel and generate LaTeX for the document.

Note that the figures encountered in the document are counted and the refences accordingly set. You might want to set a caption for a figure. Hold down the Command and Shift key and then doubleclick on the image in your Cassiopeia document to open the image inspector.
Specify a caption and press Command-s to save changes. Then regenerate LaTeX for your document.

Bibliography and citations

Choose Form - Core - Bibliography to open the bibliography manager.


If you want to fetch all available bibliography entries (this could be a lot in a multi user environment) click into any of the three text fields at the bottom of the window and press Return. If you know the title or the author of the entry you are looking for type in the first few letters in the corresponing field(s) and hit enter.

To create a new bibiography entry click on Add. The following bibliography entry viewer appears.


Click on the popup button to select a type.


Then fill out the value fields in the tableview to supply content.


Create a few more bibliography entries. If you have worked with LaTeX before you might have a bibtex file containing all your articles. Such a file can easily be imported into Cassiopeia. Click on the Import button of the bibliography manager, select your bib file


and then click on Import in the file dialog.


Once you have a relevant entry in the database it can be referenced from any document and by any user of the system. Keep the bibliography manager window open since it will be the target for a link creation in a couple of seconds. Open a document and start a sentence like: "A good introduction to tensors can be found in " and then press Command-Shift-M.


Do not type MARK. The word MARK is inserted by Cassiopeia when you press Command-Shift-M and assigned the link source attribute. Now go back to the bibliography manager window, fetch and select the desired publication and press Command-Shift-L to complete the link creation.

The placeholder MARK is replaced with a link to the selected bilbliography entry. Doubleclicking on the citation link in the document opens the bibliography entry.


Press Command-p to open the print panel make sure the Bibliography checkbox is checked and then click on the brown wheel to generate LaTeX.



Advanced Science          Terms and Conditions          © Smartsoft GmbH 2014