aboutsummaryrefslogtreecommitdiff
path: root/MANUAL.txt
AgeCommit message (Collapse)AuthorFilesLines
2020-12-17Update man page.John MacFarlane1-1/+1
2020-12-17MANUAL: clarify that inline references take precedence ...John MacFarlane1-0/+4
over references defined in an external bibliography.
2020-12-15MANUAL: update `--bibliography` with info about resource-pathJohn MacFarlane1-5/+8
and URLs.
2020-12-15MANUAL.txt: Remove misleading paragraphJohn MacFarlane1-5/+0
about `--resource-path`. (Note that resource-path now affects searching for bibilographies and other resources.)
2020-12-10Add sourcepos extension for commonmarkeJohn MacFarlane1-0/+7
* Add `Ext_sourcepos` constructor for `Extension`. * Add `sourcepos` extension (only for commonmark). * Bump to 2.11.3 With the `sourcepos` extension set set, `data-pos` attributes are added to the AST by the commonmark reader. No other readers are affected. The `data-pos` attributes are put on elements that accept attributes; for other elements, an enlosing Div or Span is added to hold the attributes. Closes #4565.
2020-12-08Document that --number-sections works in ms.John MacFarlane1-2/+2
Closes #6935.
2020-12-05OpenDocument writer: Allow references for internal links (#6774)Nils Carlson1-0/+37
This commit adds two extensions to the OpenDocument writer, `xrefs_name` and `xrefs_number`. Links to headings, figures and tables inside the document are substituted with cross-references that will use the name or caption of the referenced item for `xrefs_name` or the number for `xrefs_number`. For the `xrefs_number` to be useful heading numbers must be enabled in the generated document and table and figure captions must be enabled using for example the `native_numbering` extension. In order for numbers and reference text to be updated the generated document must be refreshed. Co-authored-by: Nils Carlson <nils.carlson@ludd.ltu.se>
2020-11-19Update README.md, man page.John MacFarlane1-1/+1
2020-11-16Added a sentence about `pagetitle` for HTML (#6843)Alex Toldaiev1-1/+2
changed: MANUAL.txt
2020-11-14Fix small typo in manual for `--markdown-headings`.John MacFarlane1-3/+3
2020-11-14MANUAL: wrap some overly long lines.John MacFarlane1-102/+130
2020-11-14Markdown writer: default to using ATX headings.Aner Lucero1-7/+12
Previously we used Setext (underlined) headings by default. The default is now ATX (`##` style). * Add the `--markdown-headings=atx|setext` option. * Deprecate `--atx-headers`. * Add constructor 'ATXHeadingInLHS` constructor to `LogMessage` [API change]. * Support `markdown-headings` in defaults files. * Document new options in MANUAL. Closes #6662.
2020-11-11Manual: correct `link-citation` -> `link-citations`.John MacFarlane1-1/+1
2020-11-07Bump to 2.11.1.1 and update changelog.John MacFarlane1-1/+1
2020-11-03Clarify manual on `--track-changes`.John MacFarlane1-12/+12
Closes #6801.
2020-11-02Update man page.John MacFarlane1-1/+1
2020-11-01Default CSS: avoid padding and color if monobackgroundcolor not given.John MacFarlane1-1/+2
This makes the default more austere, while putting the padded, colored code elements within easy reach.
2020-11-01Updates to default CSS (#6786)Mauro Bieg1-1/+26
- Fix margin before codeblock - Add `monobackgroundcolor` variable, making the background color and padding of code optional. - Ensure that backgrounds from highlighting styles take precedence over monobackgroundcolor - Remove list markers from TOC - Add margin-bottom where needed - Remove italics from blockquote styling - Change borders and spacing in tables to be more consistent with other output formats - Style h5, h6 - Decrease root font-size to 18px - Update tests for styles.html changes - Add CSS example to MANUAL
2020-10-29Allow citation-abbreviations in defaults file.John MacFarlane1-0/+1
2020-10-23Document that --html-q-tags requires the smart extension on the reader.John MacFarlane1-1/+3
Closes #6766.
2020-10-22Update manual date and regenerate man page.John MacFarlane1-1/+1
2020-10-22improve explanation of "indent" variable (#6767)Cyrus Yip1-1/+1
2020-10-16MANUAL: remove org from list of input formats supporting raw_tex (#6753)Nick Fleisher1-1/+1
Also update man page.
2020-10-14Fix CSL JSON conversion examples in MANUAL.John MacFarlane1-4/+4
You need -f csljson.
2020-10-12Fix spelling errors in MANUAL found by fossies codespell tool.John MacFarlane1-3/+3
See #6738
2020-10-10Add citeproc related options to sample defaults file.John MacFarlane1-2/+15
2020-10-08More documentation on converting bib formats.John MacFarlane1-0/+12
2020-10-08MANUAL: Add note about lualatex using selnolig.John MacFarlane1-9/+10
2020-09-21Add built-in citation support using new citeproc library.John MacFarlane1-183/+347
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-19Add CSS to default HTML template (#6601)Mauro Bieg1-0/+37
2020-09-13Delete obsolete MANUAL section on compact and loose lists.John MacFarlane1-24/+0
This gives a rule that has been been superseded by commit 47537d26db29b9dd0810d039933497d4db4ed813. 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-13MANUAL: fix position of attributes in headerAlbert Krewinkel1-1/+1
2020-08-09MANUAL: remove lists of support extensions for markdown variants.John MacFarlane1-46/+20
Instead, offer the advice to use `--list-extensions=FORMAT`. Closes #6604.
2020-07-27Remove duplicate 'seriespage'. (#6568)Blake Eryx1-1/+0
2020-07-23update date, man page, README.John MacFarlane1-1/+1
2020-07-23Add `raw_markdown` extension affecting `ipynb` reader.John MacFarlane1-0/+8
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-22Docx writer: support --number-sections.John MacFarlane1-1/+2
Closes #1413.
2020-07-19Remove use of cmark-gfm for commonmark/gfm rendering.John MacFarlane1-1/+2
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-19Add commonmark_x output format...John MacFarlane1-0/+2
commonmark with a number of useful extensions (more than gfm).
2020-07-19Add generic `attributes` extension.John MacFarlane1-0/+31
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-19MANUAL.txt: rewrite Raw HTML/TeX section...John MacFarlane1-47/+37
...to avoid duplicate headings for the extensions.
2020-07-19Remove duplicate 'titlepage' in docsBlake Eryx1-1/+0
2020-07-05Fix typo in MANUAL.txtBenjamin Wuethrich1-1/+1
2020-06-29Update manual date, generate man page.John MacFarlane1-1/+1
2020-06-28Delete misleading sentence in manualfor --verboseJohn MacFarlane1-2/+1
2020-06-21MANUAL: clarify partial naming (#6476)Mauro Bieg1-6/+14
2020-06-15MANUAL: describe `jira` as "Jira/Confluence wiki markup"Albert Krewinkel1-2/+2
In the past, Jira's wiki markup was also used by – and could be imported into – Atlassian Confluence. Closes: #6351
2020-05-30Change default revealjs-url to use CDN version of revealjs v4.John MacFarlane1-1/+2
See #6408.
2020-05-20Update links to reveal.js documentation (#6386)Salim B1-4/+3
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-10Fix misleading note about image size conversions in MANUAL.John MacFarlane1-4/+6
Closes #6353.