Commit graph

471 commits

Author SHA1 Message Date
John MacFarlane
84eea72e79 MANUAL: Add note about lualatex using selnolig. 2020-10-08 17:25:36 -07:00
John MacFarlane
e0984a43a9 Add built-in citation support using new citeproc library.
This deprecates the use of the external pandoc-citeproc
filter; citation processing is now built in to pandoc.

* Add dependency on citeproc library.
* Add Text.Pandoc.Citeproc module (and some associated unexported
  modules under Text.Pandoc.Citeproc).  Exports `processCitations`.
  [API change]
* Add data files needed for Text.Pandoc.Citeproc:  default.csl
  in the data directory, and a citeproc directory that is just
  used at compile-time.  Note that we've added file-embed as a mandatory
  rather than a conditional depedency, because of the biblatex
  localization files. We might eventually want to use readDataFile
  for this, but it would take some code reorganization.
* Text.Pandoc.Loging: Add `CiteprocWarning` to `LogMessage` and use it
  in `processCitations`. [API change]
* Add tests from the pandoc-citeproc package as command tests (including
  some tests pandoc-citeproc did not pass).
* Remove instructions for building pandoc-citeproc from CI and
  release binary build instructions.  We will no longer distribute
  pandoc-citeproc.
* Markdown reader: tweak abbreviation support.  Don't insert a
  nonbreaking space after a potential abbreviation if it comes right before
  a note or citation.  This messes up several things, including citeproc's
  moving of note citations.
* Add `csljson` as and input and output format. This allows pandoc
  to convert between `csljson` and other bibliography formats,
  and to generate formatted versions of CSL JSON bibliographies.
* Add module Text.Pandoc.Writers.CslJson, exporting `writeCslJson`. [API
  change]
* Add module Text.Pandoc.Readers.CslJson, exporting `readCslJson`. [API
  change]
* Added `bibtex`, `biblatex` as input formats.  This allows pandoc
  to convert between BibLaTeX and BibTeX and other bibliography formats,
  and to generated formatted versions of BibTeX/BibLaTeX bibliographies.
* Add module Text.Pandoc.Readers.BibTeX, exporting `readBibTeX` and
  `readBibLaTeX`. [API change]
* Make "standalone" implicit if output format is a bibliography format.
  This is needed because pandoc readers for bibliography formats put
  the bibliographic information in the `references` field of metadata;
  and unless standalone is specified, metadata gets ignored.
  (TODO: This needs improvement. We should trigger standalone for the
  reader when the input format is bibliographic, and for the writer
  when the output format is markdown.)
* Carry over `citationNoteNum` to `citationNoteNumber`.  This was just
  ignored in pandoc-citeproc.
* Text.Pandoc.Filter: Add `CiteprocFilter` constructor to Filter.
  [API change] This runs the processCitations transformation.
  We need to treat it like a filter so it can be placed
  in the sequence of filter runs (after some, before others).
  In FromYAML, this is parsed from `citeproc` or `{type: citeproc}`,
  so this special filter may be specified either way in a defaults file
  (or by `citeproc: true`, though this gives no control of positioning
  relative to other filters).  TODO: we need to add something to the
  manual section on defaults files for this.
* Add deprecation warning if `upandoc-citeproc` filter is used.
* Add `--citeproc/-C` option to trigger citation processing.
  This behaves like a filter and will be positioned
  relative to filters as they appear on the command line.
* Rewrote the manual on citatations, adding a dedicated Citations
  section which also includes some information formerly found in
  the pandoc-citeproc man page.
* Look for CSL styles in the `csl` subdirectory of the pandoc user data
  directory.  This changes the old pandoc-citeproc behavior, which looked
  in `~/.csl`.  Users can simply symlink `~/.csl` to the `csl`
  subdirectory of their pandoc user data directory if they want
  the old behavior.
* Add support for CSL bibliography entry formatting to LaTeX, HTML,
  Ms writers.  Added CSL-related CSS to styles.html.
2020-09-21 10:15:50 -07:00
Mauro Bieg
caa225ad82
Add CSS to default HTML template (#6601) 2020-09-19 16:13:50 -07:00
John MacFarlane
62948f3579 Delete obsolete MANUAL section on compact and loose lists.
This gives a rule that has been been superseded by
commit 47537d26db.

The section is concerned to explain a discrepancy with
original Markdown.pl and its test suite.  In the case
under consideration, Markdown.pl gave strange results
which pandoc corrected.  I think it's no longer worth
wasting space on this, as its behavior seems clearly wrong.
If we are going to comment on every edge case with
Markdown.pl, the manual will get too long.

Babelmark 2 shows that some of the older implementations
follow Markdown.pl -- PHP Markdown, Python Markdown,
redcarpet, discount.

https://johnmacfarlane.net/babelmark2/?normalize=1&text=%2B+++First%0A%2B+++Second%0A++++-+a%0A++++-+b%0A%0A%2B+Third%0A

Closes #6684.
2020-09-13 12:45:17 -07:00
Albert Krewinkel
2109ded710
MANUAL: fix position of attributes in header 2020-09-13 07:42:44 +02:00
John MacFarlane
a7c9a69004 MANUAL: remove lists of support extensions for markdown variants.
Instead, offer the advice to use `--list-extensions=FORMAT`.

Closes #6604.
2020-08-09 11:12:59 -07:00
Blake Eryx
eb4fe697f0
Remove duplicate 'seriespage'. (#6568) 2020-07-27 19:01:29 -07:00
John MacFarlane
5a216f7bd7 update date, man page, README. 2020-07-23 17:56:12 -07:00
John MacFarlane
48fb6d947d Add raw_markdown extension affecting ipynb reader.
Specifying `-f ipynb+raw_markdown` will cause Markdown cells
to be represented as raw Markdown blocks, instead of being
parsed.  This is not what you want when going from `ipynb`
to other formats, but it may be useful when going from `ipynb`
to Markdown or to `ipynb`, to avoid semantically insignificant
changes in the contents of the Markdown cells that might
otherwise be introduced.

Closes #5408.
2020-07-23 17:47:02 -07:00
John MacFarlane
1e84178431 Docx writer: support --number-sections.
Closes #1413.
2020-07-22 11:53:31 -07:00
John MacFarlane
d6b7b1dc77 Remove use of cmark-gfm for commonmark/gfm rendering.
Instead rely on the markdown writer with appropriate extensions.

Export writeCommonMark variant from Markdown writer.
This changes a few small things in rendering markdown,
e.g. w/r/t requiring backslashes before spaces inside
super/subscripts.
2020-07-19 22:51:59 -07:00
John MacFarlane
0aed9dd589 Add commonmark_x output format...
commonmark with a number of useful extensions (more than gfm).
2020-07-19 22:51:59 -07:00
John MacFarlane
8d523d80d4 Add generic attributes extension.
This allows attributes to be added to any block or inline
element, in principle.  (Though in many cases this will be
done by adding a Div or Span container, since pandoc's
AST doesn't have a slot for attributes for most elements.)

Currently this is only possible with the commonmark and gfm
readers.

Add `Ext_attributes` constructor for `Extension` [API change].
2020-07-19 22:51:59 -07:00
John MacFarlane
7dbf03f527 MANUAL.txt: rewrite Raw HTML/TeX section...
...to avoid duplicate headings for the extensions.
2020-07-19 22:51:59 -07:00
Blake Eryx
920732078c Remove duplicate 'titlepage' in docs 2020-07-19 14:03:18 -04:00
Benjamin Wuethrich
e965926c1a Fix typo in MANUAL.txt 2020-07-05 23:50:04 -04:00
John MacFarlane
495cc11941 Update manual date, generate man page. 2020-06-29 13:33:57 -07:00
John MacFarlane
8ab3d8736a Delete misleading sentence in manualfor --verbose 2020-06-28 10:38:38 -07:00
Mauro Bieg
f91121fe56
MANUAL: clarify partial naming (#6476) 2020-06-21 10:29:55 -07:00
Albert Krewinkel
a6a7f08a2b
MANUAL: describe jira as "Jira/Confluence wiki markup"
In the past, Jira's wiki markup was also used by – and could be imported
into – Atlassian Confluence.

Closes: #6351
2020-06-15 21:16:35 +02:00
John MacFarlane
7c6dbd37eb Change default revealjs-url to use CDN version of revealjs v4.
See #6408.
2020-05-30 12:10:27 -07:00
Salim B
18b815cdce
Update links to reveal.js documentation (#6386)
With the [release of reveal.js 4.0.0](https://github.com/hakimel/reveal.js/releases/tag/4.0.0), the documentation moved from the GitHub README to the dedicated website <https://revealjs.com/>.

Note that there are [further adjustments](https://revealjs.com/upgrading/) to the [Pandoc template](https://github.com/jgm/pandoc-templates/blob/master/default.revealjs) necessary in order to make Pandoc work with reveal.js 4.0.0.
2020-05-20 08:53:55 -07:00
John MacFarlane
82eb4df284 Fix misleading note about image size conversions in MANUAL.
Closes #6353.
2020-05-10 17:20:47 -07:00
andrebauer
97fe2ea16c
LaTeX Writer: Add support for customizable alignment of columns in beamer (#6331)
Add support for customizable alignment of columns in beamer.
Closes #4805, closes #4150.
2020-05-02 17:08:16 -07:00
tom-audm
3e52c402d0
Manual: separate adjacent verbatim code blocks (#6307) 2020-04-23 18:07:03 -07:00
Cédric Couralet
34775b4128
Add an option to disable certificate validation (#6156)
This commit adds the option `--no-check-certificate`, which disables certificate
checking when resources are fetched by HTTP.

Co-authored-by: Cécile Chemin <cecile.chemin@insee.fr>
Co-authored-by: Juliette Fourcot <juliette.fourcot@insee.fr>
2020-04-13 14:58:42 -07:00
John MacFarlane
58cd731e51 Require doctemplates 0.8.2. 2020-04-12 22:25:31 -07:00
Mauro Bieg
61f666a88f
MANUAL: add link to print-css.rocks (#6272) 2020-04-11 09:49:36 -07:00
John MacFarlane
c49061e99b Clarify docs for pipe table column width adjustment.
See #6254.
2020-04-09 09:35:27 -07:00
John MacFarlane
39b742e5ba Fix ATX header syntax in manual 2020-04-07 08:54:18 -07:00
John MacFarlane
42fe30a9ee Update manual date and man paeg. 2020-03-23 16:43:31 -07:00
Fabien Schurter
5d88396dd4
Make MANUAL more explicit about NBSP handling by all_symbols_escapable (#6201)
Fixes #6154.
2020-03-20 17:15:00 -07:00
Albert Krewinkel
11b5f1e40b
Update copyright year (#6186)
* Update copyright year

* Copyright: add notes for Lua and Jira modules
2020-03-13 09:52:47 -07:00
John MacFarlane
0edc084c50 Revert "Allow specifying string value in metadata using !!literal tag."
This reverts commit 3493d6afaa.

This might be worth considering in the future, but let's not do
it yet...the additional complexity needs a better justification.
2020-02-17 15:58:21 -08:00
John MacFarlane
3493d6afaa Allow specifying string value in metadata using !!literal tag.
This is experimental.  Normally metadata values are interpreted
as markdown, but if the !!literal tag is used they will be interpreted
as plain strings.

We need to consider whether this can still be implemented if
we switch back from HsYAML to yaml for performance reasons.
2020-02-17 09:53:36 -08:00
John MacFarlane
cdbb14de5b Update changelog and man page. 2020-02-15 21:26:29 -08:00
Albert Krewinkel
f5ea5f0aad
Introduce new format variants for JATS (#6067)
New formats:

- `jats_archiving` for the "Archiving and Interchange Tag Set",
- `jats_publishing` for the "Journal Publishing Tag Set", and
- `jats_articleauthoring` for the "Article Authoring Tag Set."

The "jats" output format is now an alias for "jats_archiving".

Closes: #6014
2020-02-12 20:36:02 -08:00
John MacFarlane
f9514ccb9e Add Text.Pandoc.Readers.CSV (readCSV).
This adds csv as an input format.
The CSV table is converted into a pandoc simple table.

Closes #6100.
2020-01-31 21:14:21 -08:00
Salim B
34eba446a0 Update URLs and use HTTP**S** wherever possible (#6090)
I've changed _all_ `http:` URLs in the file to their `https` equivalents if the respective sites have properly configured HTTPS.
2020-01-27 15:46:33 -08:00
Albert Krewinkel
11e99409ce
docs: capitalize Lua where it refers to the programming language name
This follows the advise on the Lua
website (https://www.lua.org/about.html#name):

> […] "Lua" is a name, the name of the Earth's moon and the name of the
> language. Like most names, it should be written in lower case with an
> initial capital, that is, "Lua".
2020-01-12 11:29:05 +01:00
John MacFarlane
e4b2252a94 Bump to 2.9.1.1, update manual. 2020-01-05 11:15:52 -08:00
John MacFarlane
cd03ccca58 Update man page and MANUAL date. 2019-12-21 10:30:28 -08:00
John MacFarlane
18b530d613 MANUAL: A bit clearer explanation for --base-header-level.
We now say exactly how to work around the deprecation of this
option.
2019-12-20 17:04:38 -08:00
Albert Krewinkel
96c80b156d Add jira reader (#5913)
Closes #5556
2019-12-17 21:07:46 -08:00
John MacFarlane
1ed8518011 Regenerate man page. 2019-12-11 21:03:29 -08:00
Frederik Elwert
90804b5506 Add title-slide-attributes variable to reveal.js template. (#5981) 2019-12-11 08:26:54 -08:00
John MacFarlane
e16fd88c2e Rename template 'filters' as 'pipes'
to avoid confusion with the other notion of filter used by pandoc.
We may want to rename this upstream in doctemplates as well.
2019-12-07 11:42:29 -08:00
John MacFarlane
8ad14d6f57 Removed trailing whitespace in manual. 2019-12-07 09:06:20 -08:00
John MacFarlane
6bb552c589 Document display math syntax in manual. 2019-12-07 09:05:07 -08:00
John MacFarlane
d643393a69 Update manual date and man page. 2019-12-05 12:38:42 -08:00