https://github.com/aesiniath/publish

Publishing tools for papers, books, and presentations
https://github.com/aesiniath/publish

haskell latex markdown pdf rendering

Last synced: 3 months ago
JSON representation

Publishing tools for papers, books, and presentations

• Host: GitHub
• URL: https://github.com/aesiniath/publish
• Owner: aesiniath
• License: mit
• Created: 2018-10-22T12:29:58.000Z (about 6 years ago)
• Default Branch: main
• Last Pushed: 2024-05-29T12:01:42.000Z (5 months ago)
• Last Synced: 2024-07-16T02:55:28.055Z (4 months ago)
• Topics: haskell, latex, markdown, pdf, rendering
• Language: Haskell
• Homepage: http://hackage.haskell.org/package/publish
• Size: 255 KB
• Stars: 13
• Watchers: 3
• Forks: 4
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Publishing tools for papers, books, and presentations

=====================================================

Authoring a high quality document and rendering it to a PDF suitable for

printing means using a toolchain different than those used to assemble content

into web pages. LaTeX processors are the dominant way to typeset documents,

but while the results are often beautiful it is an environment which has

accreted cruft over decades and can be difficult to use. We have faith that

the gods in the computing pantheon will someday grant us peace (e.g. the end

of the editor wars) and better tools (or at least ones that give useful error

messages), but while we wait for the millennium (when LaTeX will be replaced

with something whose syntax doesn't make your eyes bleed) we wanted to see if

we could offer a slightly less unpleasant authoring experience.

Ideally we could:

  - write content in lightly marked-up plain text (_i.e._ Markdown) as much as

    possible;

  - use localized typesetting commands inline when slightly greater

    expressiveness is needed; and

  - directly pass-through entire blobs of LaTeX when complex incantations and

    arcane summonings are necessary to appease the vengeful daemons who make

    the office printer work.

and that is what **publish** provides. It gives you a way to:

 1. list the _.md_ and _.tex_ files that make up your document;

 2. convert Markdown fragments into LaTeX using **pandoc**;

 3. use **inkscape** programmatically to convert _.svg_ images into something

    that can be included by the LaTeX processors; and

 4. combine the resultant intermediate pieces and render them to a _.pdf_

    using the **lualatex** toolchain.

Documentation

-------------

There is a [getting started][Tutorial] tutorial, [background][Background]

notes, and several [examples][Examples]. And you can get help from the

command-line:

```

$ render --help

```

[Tutorial]: doc/Tutorial.md

[Background]: doc/Background.md

[Examples]: doc/Examples.md