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.
LyX for Mac OS X is available here: LyX-2.3.0+qt5-x86_64-cocoa.dmg, and the GPG signature is here. If the download is too slow try some other mirror closer to you. The official download section on the main page with binaries for Mac and Windows can be found here: LyX 1.6.x.
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 section). Fortunately there is an easy way to start LyX without disabling Gatekeeper: 1. Don't open the application with a double click. Click it while pressing the Control-key instead. More information is available.
Prerequisite You need a TeX installation. The easiest option is to use. 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. Useful Helper Programs Previewers LyX/Mac uses the system default viewers, and should require no configuration for PDF and HTML. OmniGraffle converter is a great software for creating diagrams under Mac OS X (in particular, it works very well with 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. • Put somewhere on your disk (e.g.
In $HOME/Library/Scripts/). • In order to use it, go to LyX preferences, add an OmniGraffle file format (just type auto for the editor), and then add converters: • OmniGraffle ->PDF (ps2pdf) converter: osascript replace/with/path/to/og-export.scpt `pwd`/$$i `pwd`/$$o pdf • OmniGraffle ->EPS converter: osascript replace/with/path/to/og-export.scpt `pwd`/$$i `pwd`/$$o eps • OmniGraffle ->PNG converter: osascript replace/with/path/to/og-export.scpt $$i $$o png • Note that currently, LyX doesn't work with OmniGraffle packages (e.g. Diagrams including images).
This problem will hopefully be solved in the future (see for details). On screen quality of included PDF files 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 sips program that comes with OSX (it is a command line tool that you can use in the Terminal for converting a graphic file between different formats). To create this converter, you should open the Preference menu item in the LyX menu, and go to the File handling tab, then the Converters item. Here we will use the PDF (graphics) ->EPS item as a template. When you choose this item, the bottom boxes are filled and you can read a command that starts with pdftops.
In the converter box. We will first change the EPS item on the right to PNG (you should have this possibility in the combo that opens when you click on EPS), and change the converter command as consequence, by replacing the complete psdtopdf. Command by: sips --resampleWidth 600 --setProperty format png $$i --out $$o You can also increase the resampleWidth value if the generated bitmaps look too small on your screen (please first check that Lyx shows them at 100% of their size).
When you finish setting these parameter, click Add button next to the top converters list (if not, you will loose the new converter), then click Save. If you open a new file containing PDF graphics, they should be much better looking and crispier now. If you want to change these values later, you should come to the same screen, select this converter, change the parameters in the converter box, and click Modify before leaving this screen. Beyond basics PdfSync and SyncTeX -- Forward Search and Reverse Search 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. Troubleshooting PdfSync Make sure that the.lyxpipe.in and.lyxpipe.out files do not exist when LyX is not running. (They are normally deleted when LyX quits, but if LyX crashes, they remain and prevent LyX from communicating with PDFView.) Their location can be found in LyX >Preferences >Paths.
Version Control • 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 page for more information.
DVI viewers 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.
Pipes Name in Path Problem (JabRef) Programs such as 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 Application Support, but other programs often cannot deal with spaces in paths). You may need to fix the lyxpipe path in both LyX and JabRef in Mac OS X. To fix the LyX pipe in JabRef, open JabRef and go to Preferences>Auto Tune 7 Mac Download. External Programs and in 'Path to LyX pipe' enter /Applications/LyX.app/Contents/Resources/lyxpipe. Close JabRef. Then open LyX, go to LyX>Preferences>Paths, and in 'LyXServer pipe' enter /Applications/LyX.app/Contents/Resources/lyxpipe. 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 ~/.lyx; (2) recreate the ~/.lyx directory by entering in a terminal session, ' mkdir ~/.lyx'; and (3) restart LyX.
Known issues • Due to limitations in the Qt/Mac library, interface languages other than English modify the organization of the toolbar menus and it may not be possible to directly enter some special characters into the document preamble (you can copy them to the preamble). Please report any other bugs to the appropriate LyX. A is also available.
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.