From aa67b34da4bd9d4153671b3b6551ef5b9b6db513 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Sun, 27 Nov 2016 17:49:36 +0100 Subject: Update changelog. --- changelog | 258 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 258 insertions(+) diff --git a/changelog b/changelog index 1403b881e..09731d1ea 100644 --- a/changelog +++ b/changelog @@ -1,3 +1,261 @@ +pandoc (1.19) + + * Changed resolution of filter paths. + + + We now first treat the argument of `--filter` as a full (absolute + or relative) path, looking for a program there. If it's found, + we run it. + + If not, and if it is a simple program name or a relative path, + we try resolving it relative to `$DATADIR/filters`. + + If this fails, then we treat it as a program name and look in + the user's PATH. + + Removed a hardcoded '/' that may have caused problems with Windows + paths. + + Previously if you did `--filter foo` and you had `foo` in your + path and also an executable `foo` in your working directory, + the one in the path would be used. Now the one in the working + directory is used. + + In addition, when you do `--filter foo/bar.hs`, pandoc will now + find a filter `$DATADIR/filters/foo/bar.hs` -- assuming there + isn't a `foo/bar.hs` relative to the working directory. + + * Allow `file://` URIs as arguments (#3196). Also improved default reader + format detection. Previously with a URI ending in .md or .markdown, + pandoc would assume HTML input. Now it treats these as markdown. + + * Allow to overwrite top-level division type heuristics (#3258, + Albert Krewinkel). Pandoc uses heuristics to determine the most + reasonable top-level division type when emitting LaTeX or Docbook markup. + It is now possible to overwrite this implicitly set top-level division + via the `top-level-division` command line parameter. + + * Text.Pandoc.Options [API change] (#3197): The type of the + `writerTopLevelDivision` field in of the `WriterOptions` data type is + altered from `Division` to `Maybe Division`. The field's default value + is changed from `Section` to `Nothing`. + + * Improved error if they give wrong arg to `--top-level-division`. + + * DocBook reader: Fixed xref lookup (#3243). + It previously only worked when the qnames lacked the docbook + namespace URI. + + * HTML reader: + + + Improved table parsing (#3027). We now check explicitly for non-1 + rowspan or colspan attributes, and fail when we encounter them. + Previously we checked that each row had the same number of cells, + but that could be true even with rowspans/colspans. + And there are cases where it isn't true in tables that + we can handle fine -- e.g. when a tr element is empty. + So now we just pad rows with empty cells when needed. + + Treat `` as MathML by default unless something else + is explicitly specified in xmlns. Provided it parses as MathML, + of course. Also fixed default which should be to inline math if no + display attribute is used. + + Only treat "a" element as link if it has href (#3226). Otherwise + treat as span. + + * Docx reader (Jesse Rosenthal): + + + Add a placeholder value for CHART. We wrap `[CHART]` in a + ``. Note that it maps to inlines because, in docx, + anything in a drawing tag can be part of a larger paragraph. + + Be more specific in parsing images We not only want `w:drawing`, + because that could also include charts. Now we specify + `w:drawing/pic:pic`. This shouldn't change behavior at all, but it's + a first step toward allowing other sorts of drawing data as well. + + Abstract out function to avoid code repetition. + + Update tests for img title and alt (#3204). + + Handle Alt text and titles in images. We use the "description" field + as alt text and the "title" field as title. These can be accessed + through the "Format Picture" dialog in Word. + + Docx reader utils: handle empty namespace in `elemName`. + Previously, if given an empty namespace `(elemName ns "" "foo")` + `elemName` would output a QName with a `Just ""` namespace. This is + never what we want. Now we output a `Nothing`. If someone *does* want a + `Just ""` in the namespace, they can enter the QName value explicitly. + + * ODT reader/writer: + + + Inline code when text has a special style (Hubert Plociniczak). When + a piece of text has a text `Source_Text` then we assume that this is a + piece of the document that represents a code that needs to be inlined. + Adapted the writer to also reflect that change. Previously it was just + writing a 'preformatted' text using a non-distinguishable font style. + Code blocks are still not recognized by the ODT reader. That's a + separate issue. + + Infer table's caption from the paragraph (#3224, Hubert Plociniczak). + ODT's reader always put empty captions for the parsed tables. This commit + + 1. checks paragraphs that follow the table definition + 2. treats specially a paragraph with a style named 'Table' + 3. does some postprocessing of the paragraphs that combines + tables followed immediately by captions + + The ODT writer used the `TableCaption` style for the caption + paragraph. This commit follows the OpenOffice approach which + allows for appending captions to table but uses a built-in style + named `Table` instead of `TableCaption`. Users of a custom + `reference.odt` should change the style's name from `TableCaption` + to `Table`. + + * ODT reader: Infer tables' header props from rows (#3199, Hubert + Plociniczak). ODT reader simply provided an empty header list + which meant that the contents of the whole table, even if not empty, + was simply ignored. While we still do not infer headers we at least + have to provide default properties of columns. + + * Markdown reader: + + + Allow reference link labels starting with `@...` if `citations` + extension disabled (#3209). Example: in + + [link text][@a] + + [@a]: url + + `link text` isn't hyperlinked because `[@a]` is parsed as a citation. + Previously this happened whether or not the `citations` extension was + enabled. Now it happens only if the `citations` extension is enabled. + + Allow alignments to be specified in Markdown grid tables. For example, + + +---------------+---------------+--------------------+ + | Right | Left | Centered | + +==============:+:==============+:==================:+ + | Bananas | $1.34 | built-in wrapper | + +---------------+---------------+--------------------+ + + + Allow Small Caps elements to be created using bracketed spans + (as they already can be using HTML-syntax spans) (#3191, Kolen Cheung). + + * LaTeX reader: + + + Don't treat `\vspace` and `\hspace` as block commands (#3256). + Fixed an error which came up, for example, with `\vspace` + inside a caption. (Captions expect inlines.) + + Improved table handling. We can now parse all of the tables emitted + by pandoc in our tests. The only thing we don't get yet are + alignments and column widths in more complex tables. See #2669. + + Limited support for minipage. + + Allow for `[]`s inside LaTeX optional args. Fixes cases like: + + \begin{center} + \begin{tikzpicture}[baseline={([yshift=+-.5ex]current bounding box.center)}, level distance=24pt] + \Tree [.{S} [.NP John\index{i} ] [.VP [.V likes ] [.NP himself\index{i,*j} ]]] + \end{tikzpicture} + \end{center} + + Handle BVerbatim from fancyvrb (#3203). + + Handle hungarumlaut (#3201). + + Allow beamer-style `<...>` options in raw LaTeX (also in Markdown) + (#3184). This allows use of things like `\only<2,3>{my content}` in + Markdown that is going to be converted to beamer. + + * Use pre-wrap for code in dzslides template (Nicolas Porcel). + Otherwise overly long code will appear on every slide. + + * Org reader (Albert Krewinkel): + + + Respect column width settings (#3246). Table column properties can + optionally specify a column's width with which it is displayed in + the buffer. Some exporters, notably the ODT exporter in org-mode v9.0, + use these values to calculate relative column widths. The org reader now + implements the same behavior. Note that the org-mode LaTeX and HTML + exporters in Emacs don't support this feature yet, which should be kept + in mind by users who use the column widths parameters. + + Allow HTML attribs on non-figure images (#3222). Images which are the + only element in a paragraph can still be given HTML attributes, even if + the image does not have a caption and is hence not a figure. + The following will add set the `width` attribute of the image to `50%`: + + #+ATTR_HTML: :width 50% + [[file:image.jpg]] + + + Support `ATTR_HTML` for special blocks (#3182). + Special blocks (i.e. blocks with unrecognized names) can be prefixed + with an `ATTR_HTML` block attribute. The attributes defined in that + meta-directive are added to the `Div` which is used to represent the + special block. + + Support the `todo` export option. The `todo` export option allows to + toggle the inclusion of TODO keywords in the output. Setting this to + `nil` causes TODO keywords to be dropped from headlines. The default + is to include the keywords. + + Add support for todo-markers. Headlines can have optional todo-markers + which can be controlled via the `#+TODO`, `#+SEQ_TODO`, or `#+TYP_TODO` + meta directive. Multiple such directives can be given, each adding a + new set of recognized todo-markers. If no custom todo-markers are + defined, the default `TODO` and `DONE` markers are used. Todo-markers + are conceptually separate from headline text and are hence excluded + when autogenerating headline IDs. The markers are rendered as spans + and labelled with two classes: One class is the markers name, the other + signals the todo-state of the marker (either `todo` or `done`). + + * LaTeX writer: + + + Use `\autocites*` when "suppress-author" citation used. + + Ensure that simple tables have simple cells (#2666). If cells contain + more than a single Plain or Para, then we need to set nonzero widths + and put contents into minipages. + + Remove invalid inlines in sections (#3218, Hubert Plociniczak). + + * Markdown writer: + + + Fix calculation of column widths for aligned multiline tables + (#1911, Björn Peemöller). This also fixes excessive CPU and memory + usage for tables when `--columns` is set in such a way that cells + must be very tiny. Now cells are guaranteed to be big enough so that + single words don't need to line break, even if this pushes the + line length above the column width. + + Use bracketed form for native spans when `bracketed_spans` + enabled (#3229). + + Fixed inconsistent spacing issue (#3232). Previously a tight bullet + sublist got rendered with a blank line after, while a tight ordered + sublist did not. Now we don't get the blank line in either case. + + Fix escaping of spaces in super/subscript (#3225). Previously two + backslashes were inserted, which gave a literal backslash. + + Adjust widths in Markdown grid tables so that they match on round-trip. + + * Docx writer: + + + Give full detail when there are errors converting tex math. + + Handle title text in images (Jesse Rosenthal). We already handled alt + text. This just puts the image "title" into the docx "title" attr. + + Fixed XML markup for empty cells (#3238). Previously the Compact + style wasn't being applied properly to empty cells. + + * Text.Pandoc.Pretty: + + + Fixed some bugs that caused blank lines in tables (#3251). + The bugs caused spurious blank lines in grid tables when we + had things like ``blankline $$ blankline``. + + Add exported function `minOffet` [API change] (Björn Peemöller). + + Added error message for illegal call to `block` (Björn Peemöller). + + * Text.Pandoc.Shared: Put `warn` in MonadIO. + + * Export Text.Pandoc.getDefaultExtensions [API change] (#3178). + + * In --version, trap error in `getAppUserDataDirectory` (#3241). + This fixes a crash with `pandoc --version` on unusual systems with + no real user (e.g. SQL Server 2016). + + * Added weigh-pandoc for memory usage diagnostics (#3169). + + * Use correct mime types for woff and woff2 (#3228). + + * Remove make_travis_yml.hs (#3235, Kolen Cheung). + + * changelog: Moved an item that was misplaced in the 1.17.2 section to + the 1.18 section where it belongs. + + * CONTRIBUTING.md: minor change in wording and punctuation (#3252, + Kolen Cheung). + + * Further revisions to manual for `--version` changes (#3244). + + pandoc (1.18) * Added `--list-input-formats`, `--list-output-formats`, -- cgit v1.2.3