Skip to content

scotthartley/pandoc-wrapfig

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pandoc-wrapfig: A pandoc filter for pdf/LaTeX export with the wrapfig package

pandoc-wrapfig is a simple pandoc filter written in python 3. It simply allows use of the wrapfig package so that (specified) figures will have text wrapped around them.

Installation

Obviously, the wrapfig package must be installed.

A pandoc template must be used that contains \usepackage{wrapfig}. The included template is the default pandoc LaTeX template with this line added.

Usage

Simply include {x} at the end of the captions for figures that are to be wrapped. x is a number that specifies the width of the wrap in inches. Setting it to 0 will cause the width of the figure to be used (as per the wrapfig package instructions). Figures without the tag will float as usual. Optionally precede x with a character in the set {l,r,i,o} to set wrapfig's placement parameter; the default is 'l'. Optionally follow ? with a '-' and another width specification to set wrapfig's overhang parameter and push the figure that far into the margin.

To use a specific length, you may also add cm,ptor in like {5cm}.

Also, wrapfig allows optional specification of the "number of narrow lines" that are aquivalent to height of the image. Though guessed by wrapfig, this sometimes has to be adjusted. This is possible by adding a second number to the {} argument like: {5cm,28}.

Wrapping is specific to pdf/LaTeX output. For other formats, the tag is simply removed.

Tufte-latex margin figures

For users of the tufte-latex package, pandoc-wrapfig can produce margin figures with tufte-latex's marginfigure environment. Example:

![Image caption {m0}](image.png)

You must have tufte-latex and its dependencies installed and your document class must of course be set to tufte-handout or tufte-book.

About

A simple pandoc filter that facilitates using the wrapfig package.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published