BlogLiterately

A tool for posting Haskelly articles to blogs

http://byorgey.wordpress.com/blogliterately/

Version on this page:0.8.4.3@rev:1
LTS Haskell 9.21:0.8.4.3@rev:1
Stackage Nightly 2017-07-25:0.8.4.3@rev:1
Latest on Hackage:0.8.8.2@rev:1

See all snapshots BlogLiterately appears in

GPL-3.0-only licensed by Robert Greayer, Brent Yorgey
Maintained by Brent Yorgey
This version can be pinned in stack with:BlogLiterately-0.8.4.3@sha256:fa4ead9c5b7ffc4b664584723d9cb95fccab0ba835b8ec8ca8303787bbe1d705,4080

Write blog posts in Markdown format, then use BlogLiterately to do syntax highlighting, format ghci sessions, and upload to any blog supporting the metaWeblog API (such as Wordpress).

To get started, use the provided executable BlogLiterately; see http://byorgey.wordpress.com/blogliterately/ for complete documentation.

To make further customization possible, the internals of the executable are made available as a library. In particular, it is easy to create your own executable which adds extra custom transformations; see Text.BlogLiterately.Run.

Changes

0.8.4.3 (3 December 2016)

  • allow (and require) pandoc-1.19

0.8.4.2 (18 November 2016)

  • allow pandoc-1.18 and pandoc-types-1.17

0.8.4.1 (22 October 2016)

  • allow lens-4.15

0.8.4 (13 July 2016)

Two new special link types:

  • Github (link to a repo, issue, or commit)
  • Hackage (link to a package)

0.8.3.1 (14 June 2016)

Allow:

  • pandoc-citeproc-0.10
  • data-default-0.7
  • tagsoup-0.14

0.8.3 (25 May 2016)

  • Add --[no-]lit-haskell flags, to enable/disable processing of markdown files as literate Haskell. See #29.

0.8.2.3 (9 May 2016)

  • Allow transformers-0.5

0.8.2.2 (6 May 2016)

  • Allow lens-4.14

0.8.2.1 (20 April 2016)

  • Allow data-default-0.6

0.8.2 (25 March 2016)

  • New feature: support various types of “special links” which are automatically replaced with appropriate URLs. Initial support for wikipedia links, Google “feeling lucky” search, and links to other posts on the same blog specified by ID or search term.

0.8.1.6 (22 March 2016)

  • Allow pandoc-1.17

0.8.1.5 (26 January 2016)

  • Allow hscolour-1.24

0.8.1.4 (5 January 2016)

  • Require pandoc-1.16

0.8.1.3 (14 October 2015)

  • Allow pandoc-citeproc-0.8

0.8.1.2 (22 September 2015)

  • Allow lens-4.13

0.8.1.1 (10 July 2015)

  • Allow pandoc-1.15
  • Allow lens-4.12

0.8.1 (1 June 2015)

  • Require haxr-3000.11 which adds HTTPS support.

0.8 (28 May 2015)

  • Require pandoc-1.14
  • Allow highlighting-kate-0.6
  • With the introduction of Either results for pandoc’s reader functions, the type of Text.BlogLiterately.Transform.xformDoc has changed. It now yields IO (Either PandocError (BlogLiterately, String)) instead of IO (BlogLiterately, String).

0.7.1.11 (26 May 2015)

  • Allow lens-4.11

0.7.1.10 (12 May 2015)

  • Bump upper bounds. Allow:
    • hscolour-1.23
    • pandoc-citeproc-0.7

0.7.1.9 (6 May 2015)

  • Fix compilation under GHC-7.10

0.7.1.8 (4 May 2015)

  • Bump upper bounds. Now allows:
    • base-4.8
    • transformers-0.4
    • lens-4.9
    • hscolour-1.22
    • blaze-html-0.8
    • HaXml-1.25
    • pandoc-1.13
    • pandoc-citeproc-0.6
  • Get rid of utf8-string dependency
  • Drop leading spaces while parsing BLOpts block

0.7.1.7 (5 June 2014)

  • Allow lens-4.2
  • Test with GHC 7.8

0.7.1.6 (21 March 2014)

  • Allow lens-4.1

0.7.1.5 (10 March 2014)

  • Fix bug that was causing options set in profile or in-file options header to be ignored when doing pandoc writing, which affected e.g. table of contents setting.

0.7.1.4 (3 February 2014)

  • (#11) Workaround allowing [ghci] blocks in .lhs files containing lines that start with #

0.7.1.3 (30 January 2014)

  • Allow lens-4.0

0.7.1.2 (27 January 2014)

  • Allow blaze-html-0.7

0.7.1.1 (17 January 2014)

  • Bug fix: no table of contents is now actually the default, as advertised

0.7.1 (14 January 2014)

  • Allow pandoc-citeproc-0.3
  • Add –toc option for putting a table of contents at the top of a post

0.7.0.2 (4 December 2013)

  • Allow pandoc-citeproc-0.2

0.7.0.1 (7 November 2013)

  • Allow lens-3.10

0.7 (2 November 2013)

  • Add support for citations.

0.6.3.1 (10 October 2013)

  • Allow haxr-3000.10

0.6.3 (30 September 2013)

  • Update to build against pandoc-1.12. Note that BlogLiterately no longer builds with pandoc < 1.12.

0.6.2 (29 August 2013)

  • Enable input in reStructuredText format

0.6.1 (27 August 2013)

  • Automatically include necessary preamble (e.g. <script> tags) for the math mode chosen (e.g. MathJax)
  • Wrap the results of hscolour in pre and code tags with classes, to conform more closely to the style used by highlighting-kate
  • Output an entire URL upon a successful post

0.6.0.2 (15 May 2013)

  • bump upper bound to allow HaXml-1.24

0.6.0.1 (27 March 2013)

  • bump upper bound to allow lens-3.9

0.6: 10 March 2013

  • Add support for “profiles” with sets of common options

  • Add support for reading options from inline blocks tagged [BLOpts]

  • Add support for reading post titles using pandoc-supported title block format, % Title

  • Transforms are now of type StateT (BlogLiterately, Pandoc) IO (), to allow transforms to alter the options record as well as the document

  • Add centerImagesXF to standard transforms

  • Move a bunch of ad-hoc functionality into standard transforms

  • Add --html-only option

  • bump pandoc upper bound to < 1.12

0.5.4.1: 18 February 2013

  • bump blaze-html upper bound to < 0.7

0.5.4: 24 January 2013

  • Require pandoc 1.10.

0.5.3: 19 November 2012

  • New --math option for selecting pandoc math writing mode

  • Run the pandoc parser in “smart” mode, which generates proper en- and em-dashes, quotation marks, etc.

  • More updates for GHC 7.6.1 compatibility

  • Using highlighting-kate to highlight non-Haskell code was already the default; make this more clear.

    The --other-kate option is no more; now there are two options

    --kate --no-kate

    with --kate the default.

0.5.2.1: 19 September 2012

  • bump base upper bound to <4.7

0.5.2: 20 August 2012

  • improvement to behavior of --upload-images flag: cache uploaded image server URLs, even across multiple runs, to avoid uploading the same image multiple times

  • bump dep upper bounds:

    • split to < 0.3
    • cmdargs to < 0.11

0.5.1: 30 July 2012

  • Escape < and > characters in ghci output

  • Supress vertical whitespace following ghci commands that produce no output

  • add centerImagesXF transform (disabled by default)

  • create bug tracker and add Bug-reports: field to .cabal file

  • re-export Text.BlogLiterately.Run from Text.BlogLiterately

  • improved documentation

  • fix output of --version

0.5: 7 July 2012

  • expose internals as a library, and create framework for adding custom transformations to the pipeline

  • image uploads

  • ability to specify expected outputs in ghci blocks

  • prompt for password if not provided

  • bump HaXml upper bound to allow 1.23.*

0.4: 2 July 2012

  • Add special support for wordpress.com’s LaTeX format

  • Support for [ghci] blocks with contents automatically passed through ghci and results typeset

  • Support for tags

  • Support for creating “pages” as well as posts (WordPress only)

  • New standalone documentation

  • Code cleanup

  • Update to build with GHC 7.4.1