|Published (Last):||26 August 2005|
|PDF File Size:||2.72 Mb|
|ePub File Size:||14.30 Mb|
|Price:||Free* [*Free Regsitration Required]|
Features and limitations of Pandoc exports The lists are not exhaustive. Features Main structural elements: title, headings, footnotes, description, quote, author Main typography elements: bold, italic, References: BibTeX bibliographies are converted, by default with the Chicago author-year style, but also with most journal styles using CSL files. See below for details. Metadata: title, author.
Limitations Cross-references: not converted. Instead Pandoc reproduces their labels. Headings: not converted. Additional configuration to process bibliographies is explained in the next section. Note for Mac OS X users. There are two ways to install pandoc: an installer package and using "Homebrew". The first is quick but requires you to download and install the package again to get pandoc updates. The second is best because it allows for easy updates and it is needed anyway to install further tools, notably Latex2rtf, the other word processor converter for LyX.
To do so: Open the Terminal app. In this tutorial and elsewhere on the LyX Wiki, when you see "enter" or "enter the command" followed by some code, this normally means that you should enter the code in question in the Terminal one line at a time. This gives you a command code that you should copy and paste in the Terminal. This will ask for confirmation before downloading install the Homebrew package manager. You may need to enter your user password to allow for the installation.
Install Pandoc. To do so: Still in the Terminal app, enter the command brew install pandoc. This will ask for confirmation before downloading and installing Pandoc. Still in the Terminal app, enter the command brew install pandoc-citeproc. This will ask for confirmation before downloading and installing a plugin "filter" for Pandoc that allows it to process bibliographies. You may close to the terminal.
To install it enter brew install latex2rtf in the Terminal. Maintenance with Homebrew. Lyx 2. That takes a few moments during which LyX scans your system and finds what tools and formats it can use. If all goes well it will detect Pandoc and Latex2rtf if you installed it and configure itself for using it and Latex2rtf.
When the process is over, LyX displays a message that says that you must restart it to use the new configuration. The box opens. At that point one of the two top-right buttons "Add" or "Modify" will be active.
If "Add" you can proceed. If you want to be able to undo the switch to Pandoc simply copy and paste somewhere the content of the "Converter" and "Extra flag" fields. If none are active, you already had the Pandoc converter configured as above. Create a converter command from LaTex plain to OpenDocument. A processing wheel and processing messages should appear at the bottom of your LyX window. If all goes well, the last message displayed at the bottom of the window should be something like "Export successful".
You should see a file with the same name but a. Try an open it with a word processor to see if the conversion worked. Try exporting again. If that works now, then encoding was the problem. See the Troubleshooting section for a way to ensure that all your new LyX documents have the proper encoding setting. If you still get the warning message, see Troubleshooting below.
Configuration for bibliographies The default configuration above does not handle separate bibliography files. However Pandoc does support them and it is possible to setup LyX to include the bibliography in the conversion. By default the bibliography will be formatted in the Chicago manual of style author-year style.
Some further setup is needed if you want to generate bibliographies in other formats. The first section below gives some background on bibliography files, you can skip it if you know what a BibTeX bibliography is.
Background on bibliography. Below are the steps to allow exports with bibliography. If not done already, install Pandoc See step " Install Pandoc " above. Click "Modify" or "Add" if "Modify" is greyed out. Update the converter command from LaTex plain to OpenDocument. Try exporting a LyX document See step " Try exporting " above. Of course you should try a LyX document that uses a separate bibliography file.
The bibliography file must be in the so-called "utf8" encoding, otherwise you will get an error message "Error while processing pandoc To make sure your bibliography file is in the proper encoding see the Troubleshooting section.
Selecting a bibliography style As of the configuration above will export your bibliography, but it will ignore your choice of bibliography style. However, there are fairly easy ways to get Pandoc to generate a document with pretty much any bibliography style.
Two options are detailed below. The first uses LyX only, the second uses the command line. The first step is common to both. Get a CSL file for the bibliography format you want. Click on the name of the style you choose to download a. The file is a description of the format in the "Citation Style Language" that can be used by Pandoc. Below we use the file mybibformatfile.
Save or copy the. That is not necessary see below for putting having. Method 1, Lyx-only: adjust the Converter command This method is good if you want to export a LyX file several times, or export several LyX files and use the same bibliography format for all. Its downside is that each time you want to change bibliography format, you have to change the LyX converter command. In the "Converters" field, enter pandoc -s --filter pandoc-citeproc --csl mybibformatfile. Update the converter from LaTex plain to OpenDocument.
The second is selected by the commands above --csl mybibformatfile. For more information of the command line do an online search with "command line" and the name of your system. Its downside is that each time you edit your text you need to export it again and switch from LyX to the terminal.
This generates a file with a. Here we assume its name is mydocument. Open a terminal and navigate towards the folder of your LyX document. For OpenDocument conversion enter pandoc -s --filter pandoc-citeproc --csl mybibformatfile.
For instance, a folder that also contains your. This can be done in one of the two ways below. First, find the "full path" of mybibformatfile. Choose one of the method of the step 3. These are necessary if the full path contains spaces. Method 2 relative path If you adopt the command-line method to use bibliography formats, this method can save you some typing.
If you adopt the Lyx-only method to use bibliography formats, this method is useful in two settings: if your LyX files are in a folder synchronized between several computers through some cloud application like Dropbox, OneDrive, iCloud, etc. In that kind of setting the full path of your. To be able to export several all your LyX files with the same converter setting, these files should all have the same "relative position" relative to your.
In most cases, this means that all the LyX files in question should be at the same "depth" in your directories.
LYX ERROR NO INFORMATION FOR EXPORTING THE FORMAT PDF