Skip to content

mgedmin/mgp2pdf

Repository files navigation

mgp2pdf

This is a quick-and-dirty MagicPoint to PDF converter.

It supports only a subset of MagicPoint, specifically, the subset I've used in my slides so far. If you send me your slide decks, I'll make mgp2pdf handle them too.

SUPPORT.rst has a list of supported and unsupported features.

BUGS.rst has a list of known bugs.

Installation

pip install mgp2pdf

Usage

mgp2pdf [-v] [--unsafe] slides.mgp [-o output.pdf]
mgp2pdf [-v] [--unsafe] slides.mgp ... [-o directory]
mgp2pdf [-h|--help]

Why another converter?

I used mgp to produce slides for a Python course I taught at Vilnius University. However, since most of the students are not (yet) Linux users, they couldn't use MagicPoint to view my slides at home. There are some converters from MagicPoint to PostScript/HTML, but the result either looks ugly, or doesn't support Unicode characters. MagicPoint itself can produce a number of bitmaps (by taking screenshots), but those are big, and the conversion process is inconvenient (you cannot use your machine while mgp is busy rendering slides and taking screenshots).

I wrote a Python program to interpret MagicPoint commands and produce a PDF file using ReportLab. It can handle my slides (Lithuanian), but otherwise it is probably incomplete. Feel free to give it a try. File bugs for missing features, and I'll see what I can do.

Resources

There's a web page, of sorts, at https://mg.pov.lt/mgp2pdf

The source code can be found at https://github.com/mgedmin/mgp2pdf.

Report bugs at https://github.com/mgedmin/mgp2pdf/issues.

Licence: GPL v2 or v3 (https://www.gnu.org/copyleft/gpl.html)

https://github.com/mgedmin/mgp2pdf/workflows/build/badge.svg?branch=master https://ci.appveyor.com/api/projects/status/github/mgedmin/mgp2pdf?branch=master&svg=true https://coveralls.io/repos/mgedmin/mgp2pdf/badge.svg?branch=master