English | 中文
Last updated on 2019/12/21
This repository introduces an easy way to display Latex equations in OmniOutliner since itself doesn't provide this service.
This guide will help you successfully configure environment settings step by step. The only thing you need to note is that this works only in the operating system of macOS X.
To be able to successfully use Latex in OmniOutliner on your macOS X system, you must install the following packages.
Although the current system already has Python 2.7. However, as we have known, Python 2.7 will be no longer maintained by 2020. Given that, you need to install a Python interpreter whose version number must be 3.+ above. Click here to download 3.8 if you haven't any 3.+ Python.
ghostscript is a package for PDFCrop. Click here to download if you don't have this package.
As Eric Doviak said:
PDFCrop is a Perl script that crops the white margins of PDF pages and rescales them to fit a standard size sheet of paper. It makes the printed pages far more attractive to read!
Click here to download if you don't have this package. After installation, decompress the compressed package to the suitable folder (e.g., for me is the folder under the directory of Users). Alternatively, you could (as root) copy pdfcrop to /usr/local/bin/. Then, rename the folder name as pdfcrop and open the terminal and enter the following commands:
cd "your path for this folder"
sudo su
chmod 755 pdfcrop
According to the StackExchange, there are 2 ways to install pdflatex to macOS X.
The first one is MacTex. MacTex is the recommended Latex software for macOS X. However, the size of this package is over 4 G, which is quite big for this small function. But if you are a Latex fan, please enjoy MacTex!
Click here to download if you want this package or enter the following command in the terminal if you have already installed brew.
brew cask install mactex
Another one is called BasicTeX. BasicTeX also provides pdflatex and only uses a smaller storage size as it doesn't have GUI.
You can only download it if you have already installed brew. Please enter the following command in the terminal:
brew cask install basictex
In addition to the above four steps, there are also a few steps we need to take.
Firstly, please download OO_latex.scpt and create_latex_pdf.py from this repository.
Secondly, move the file OO_latex.scpt to ~/Library/Application Scripts/com.omnigroup.OmniOutliner5 (Hint: this folder has been hided, you can use Go from Finder and search this path to find this file).
The functions of this script are (quote from Claus Haslauer):
- gets content of note of selected row this should be a latex - math command
- passes the string of this content to a python script that generates a pdf of the latex string
- pastes a pdf of your latex string at the end of the selected row (not the note, the note stays there, found to be useful for future reference)
Thirdly, move the file create_latex_pdf.py to ~/Documents/OmniOutliner5/ (if not exists create a folder).
Finally, open an OmniOutliner file, click View → Customize Toolbar..., then you can find your script as shown in the following screenshot.
Congratulations! You have successfully achieved this function. In the future, the only thing you need to do is write your Latex equation code in the Note section and click that purple icon. About 3 seconds later you can see the result in the corresponding heading. The figure is shown as follows.
This guide was written based on the works from Yu Wang and Claus Haslauer.