LaTeX Output Filter

Description

Can be used as an output stream filter to produce a package containing:

• Each page converted into a LaTeX file
• Each attachment/image used in the exported pages
• An index.tex file to group all exported documents in one

Index Template

The generation of the index.tex file can be customized using the same mechanism described in the Templates mechanism.

The template name is latex/Index.

Overriding Commands

The default Index template defines 3 LaTeX commands that you can override in latex/Preamble if you wish to customize them:

• \xwikidate (sets the \date)
• \xwikiauthor (sets the \author)
• \xwikititle (sets the \title)

Override example in latex/Preamble:

Parameters

The filter support the following parameters:

Release Notes

All release notes

1.9.4

• LATEX-87 Labels inside wiki macros are not working

1.9.3

• LATEX-86 Figure Block should be handled even when not inside a MacroMarkerBlock

1.9.2

• LATEX-85 LaTeX Generation Broken With XWiki 11.8.1
• LATEX-83 Unwanted quote in caption when using the figure/figureCaption macros

1.9.1

• LATEX-82 Figure Macro rendering is fragile and fails on XWiki 10.10 when containing a Table
• LATEX-81 Info macro can have extra new lines when rendered to LaTeX

1.9

• LATEX-77 Support for small text
• LATEX-76 Correct translation of less, greater and bar symbol
• LATEX-74 Preamble 1.8 Has Syntax Error

1.8

• LATEX-65 LaTeX RawBlock should support inline elements
• LATEX-64 Translate quotes to LaTeX quotes
• LATEX-63 Allow underscore in IDs
• LATEX-62 Correct translation of backslash symbol
• LATEX-57 Horizontal line incorrectly translated

1.7.1

• LATEX-61 Images file may not contain non-ASCII characters
• LATEX-60 Underscores in image file names are escaped

1.7

• LATEX-56 Message macros don't support inline usage
• LATEX-55 Inline code macros not working
• LATEX-54 New line should not start a new paragraph
• LATEX-53 xcontext.action doesn't return "latexexport"
• LATEX-52 Invalid new line "\\" character after id macro
• LATEX-51 Pages with reserved latex characters in their name generate invalid latex
• LATEX-50 LaTeX export button text is not consistent with other buttons

1.6

• LATEX-48 Image path references can cause LaTeX compilation errors
• LATEX-47 Images in table cells generate invalid LaTeX
• LATEX-46 Use a more standard way to output empty lines
• LATEX-45 Images located inside {{context}} macros are not exported
• LATEX-44 Also escape the ampersand character

1.5

• LATEX-43 Add support for exporting document using sheets
• LATEX-41 Exporting a nested page should produce a zip named after the space name
• LATEX-35 Refactoring the template bindings so that they're all under the same namespace
• LATEX-34 Remove support for captions and labels as parameters for Image and Table blocks
• LATEX-33 Ignore generated numbers when the Numbered Reference transformations are used
• LATEX-32 Add support for the {{figure}} and {{figureCaption}} macros
• LATEX-31 Generate chapters for top level headings when the document type is a book
• LATEX-30 Pass the document type to the Syntax Renderer
• LATEX-24 Add support for the Container macro
• LATEX-12 Provide Export options in the UI
• LATEX-11 Contribute a LaTeX export button in the page export dialog box
• LATEX-9 Allow users to customize the export's index template

1.4

• LATEX-29 Parameters in a paragraph having an extra new line
• LATEX-28 Add support for the Reference Macro
• LATEX-15 Fix attachment link embedding

1.3

• LATEX-26 The messages macro should support wiki syntax
• LATEX-25 Implement max image size
• LATEX-23 Add support for labels for captioned tables and images
• LATEX-22 Have images centered by default
• LATEX-21 Supports links to current page when there's no label
• LATEX-20 Convert any link to the current page to a local link
• LATEX-18 Ignore leading spaces in templates to make them more readable
• LATEX-13 Handle resized images
• LATEX-7 Handle Group Block

1.2

• LATEX-19 Add support for styles in footnote content

1.1

• LATEX-10 Add support for footnote macros

1.0

• LATEX-3 Export entry point for LaTex
• LATEX-2 Export Filter for LaTeX
• LATEX-1 LaTeX Syntax renderer based on templates

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.

Dependencies

Dependencies for this extension (org.xwiki.contrib.latex:latex-filter 1.9.4):

• org.xwiki.contrib.latex:latex-syntax 1.9.4
• org.xwiki.platform:xwiki-platform-filter-event-model 10.2
• org.xwiki.platform:xwiki-platform-oldcore 10.2