LyX for Mac OS X
<< | Page list | >>
This is a HOWTO for LyX/Mac, a full-featured native implementation of LyX on the Mac OS X.
For users who prefer emacs-like modifier key bindings, there is additional information on customizing these keys, including patched binary versions.
"LyX" can't be opened because it is from an unidentified developer.
With Mac OS X Mountain Lion a new feature is active: the Gatekeeper. It's there to help protect your Mac from malware and misbehaving apps downloaded from the Internet. An app that is delivered by an unknown developer — one with no Developer ID — will be blocked. To get a developer ID one has to buy a license from Apple with yearly costs. Because there is no support for open source programs like LyX by Apple the application is not signed. (In case you are GPG user we provide gpg signatures, see Download Checksums & signing section).
Fortunately there is an easy way to start LyX without disabling Gatekeeper:
* Don't open the application with a double click. Click it while pressing the Control-key instead.
* Choose Open * Another window is opened. There you choose open again. That's it.
More information is available here (the Apple documentation).
You need a TeX installation. The easiest option is to use MacTeX. The .dmg file for a complete MacTeX installation is very large (> 1 GB), but it is a very complete distribution and installs right out of the box. MacTeX includes all the components necessary for TeX to work, and includes the bibliography managing program BibDesk.
Users with slower download speeds might want to download BasicTeX, a much smaller distribution, linked from the MacTeX page.
To specify a non-default GUI viewer use
As of LyX/Mac 2.0, spellchecking support is included by default.
To print envelopes, install envelope in /usr/local/bin and make it executable. While you're writing a letter in LyX, do File -> Export -> Custom -> ASCII and give
OmniGraffle is a great software for creating diagrams under Mac OS X (in particular, it works very well with LaTeXiT so that you can easily insert math formulae into diagrams). As it doesn't have a command line mode, you can use an AppleScript in order to insert ".graffle" files directly into LyX.
When you include a PDF graphic in a LyX file, it will appear crisp in the typeset PDF file of your document, but the version you see in the LyX window can be quite ugly. Lyx converts PDFs to PNG to show them in this window, and the default conversion method can choose quite a low definition for these bitmaps. A quicker and better solution would be to include a converter that uses the
You can also increase the
LyX allows, using a suitable viewer such as Skim.app, to navigate quickly between a particular place in a LyX document to the corresponding place in the rendered PDF document (forward search) and from a particular place in the PDF back to the corresponding place in the LyX document (reverse or inverse search). However, some set-up is needed before this functionality is available.
-- Please note that there are more up-to-date instructions using SyncTeX on this wiki at http://wiki.lyx.org/LyX/SyncTeX where the free OS X PDF viewer Skim.app is used. (Skim is highly recommended for this use.)
-- Please note also that there are new instructions about reverse search in Additional Features Manual.
PdfSync is similar to reverse DVI search but is for the (now more common) method of directly producing pdf files. If you use the program Skim as your previewer you can COMAND-SHIFT-click in the previewed pdf file which causes the cursor to move to that point in LyX.
-- Please note that there are new instructions about version control in Additional Features Manual.
Version control is useful for managing large documents, or documents with multiple authors. In order to implement it, you need to have RCS (Revision Control System) installed. This is a standard part of Xcode. The simplest way to get version control working, is to install the Xcode Tools package contained on the OS X install DVD. See the Mac Version Control page for more information.
Xfig or X-windows previewers like xdvi or gv can be used with LyX/Mac if you modify your
By default, LyX will generate PDF files. If for some reason you prefer to create and view DVI files, some set-up hints are provided on the Mac-DVI page.
Programs such as JabRef communicate with LyX via pipes, which are sometimes named incorrectly by default (e.g., they assume that the pipe is in a directory that has a space in its name, such as
To fix the LyX pipe in JabRef, open JabRef and go to
Then open LyX, go to
The next time you run LyX and JabRef, you should be able to push citations directly from your BibTeX bibliography in JabRef into LyX. If anything goes wrong, JabRef will return an error message, and you will have to redefine the pipe. You might try the following: (1) change the LyXServer path in LyX -> Preferences -> Paths back to
The information on this page is believed to be accurate, has been used successfully on many systems and sites, and has benefited from the comments and suggestions of many users. Due to the variations in individual systems, this information and the various files and code available on this page are conveyed as is with no warranty of any kind.
This group contains the following pages: