aboutsummaryrefslogtreecommitdiff
path: root/MANUAL.txt
AgeCommit message (Collapse)AuthorFilesLines
2021-05-15MANUAL: note that `institute` variable works for HTML-based slides.John MacFarlane1-2/+5
2021-05-14MANUAL: add info about YAML escape sequences, link to spec.Albert Krewinkel1-4/+7
Closes: #7152
2021-05-14Beamer writer: support exampleblock and alertblock.John MacFarlane1-1/+5
A block will be rendered as an exampleblock if the heading has class `example` and alertblock if it has class `alert`. Closes #7278.
2021-05-13Implement curly-brace syntax for Markdown citation keys.John MacFarlane1-5/+10
The change provides a way to use citation keys that contain special characters not usable with the standard citation key syntax. Example: `@{foo_bar{x}'}` for the key `foo_bar{x}`. Closes #6026. The change requires adding a new parameter to the `citeKey` parser from Text.Pandoc.Parsing [API change]. Markdown reader: recognize @{..} syntax for citatinos. Markdown writer: use @{..} syntax for citations when needed. Update manual with curly-brace syntax for citations. Closes #6026.
2021-05-13Update manual date and man page.John MacFarlane1-1/+1
2021-04-18MANUAL: Add information about `lang` and bibliography sorting.John MacFarlane1-10/+17
2021-03-20Support `yaml_metadata_block` extension form commonmark, gfm.John MacFarlane1-0/+16
This is a bit more limited than with markdown, as documented in the manual: - The YAML block must be the first thing in the input. - The leaf notes are parsed in isolation from the rest of the document. So, for example, you can't use reference links if the references are defined later in the document. Closes #6537.
2021-03-20Update man page and manual date.John MacFarlane1-1/+1
2021-03-08Update date in changelog and manual.John MacFarlane1-1/+1
2021-03-06Allow `--resource-path` to accumulate.John MacFarlane1-0/+5
Previously, if `--resource-path` were used multiple times, the last resource path would replace the others. With this change, each time `--resource-path` is used, it prepends the specified path components to the existing resource path. Similarly, when `resource-path` is specified in a defaults file, the paths provided will be prepended to the existing resource path. This change also allows one to avoid using the OS-specific path separator; instead, one can simply use `--resource-path` a number of times with single paths. This form of command will not have an OS-dependent behavior. This change facilitates the use of multiple, small defaults files: each can specify a directory containing its own resources without clobbering the resource paths set by the others. Closes #6152.
2021-03-05Allow `${.}` in defaults files paths...John MacFarlane1-0/+13
to refer to the directory where the default file is. This will make it possible to create moveable "packages" of resources in a directory. Closes #5871.
2021-03-05Implement environment variable interpolation in defaults files.John MacFarlane1-0/+15
This allows the syntax `${HOME}` to be used, in fields that expect file paths only. Any environment variable may be interpolated in this way. A warning will be raised for undefined variables. The special variable `USERDATA` is automatically set to the user data directory in force when the defaults file is parsed. (Note: it may be different from the eventual user data directory, if the defaults file or further command line options change that.) Closes #5982. Closes #5977. Closes #6108 (path not taken).
2021-03-05Shared: Change defaultUserDataDirs -> defaultUserDataDir.John MacFarlane1-6/+6
Rationale: the manual says that the XDG data directory will be used if it exists, otherwise the legacy data directory. So we should just determine this and use this directory, rather than having a search path which could cause some things to be taken from one data directory and others from others. [API change]
2021-03-04Revert "Revert "Relax `--abbreviations` rules so that a period isn't required.John MacFarlane1-3/+3
This reverts commit 916ce4d51121e0529b938fda71f37e947882abe5. I was confused in thinking it wouldn't work.
2021-03-04Revert "Relax `--abbreviations` rules so that a period isn't required."John MacFarlane1-3/+3
This reverts commit e461b7dd45f717f3317216c7d3207a1d24bf1c85. Ill-advised change. This doesn't work because we parse strings in chunks.
2021-03-04Relax `--abbreviations` rules so that a period isn't required.John MacFarlane1-3/+3
Partially addresses #7124.
2021-03-04Update date on manual.John MacFarlane1-1/+1
2021-02-26Fix/update URLs and use HTTP**S** where possible (#7122)Salim B1-1/+1
2021-02-22T.P.Error: Add PandocUnsupportedCharsetError constructor...John MacFarlane1-0/+1
...for PandocError. [API change]
2021-02-19MANUAL: block-level formatting is not allowed in line blocks.John MacFarlane1-0/+3
Closes #7107.
2021-02-19Clarify `tex_math_dollars` extension.John MacFarlane1-1/+2
Note that no blank lines are allowed between the delimiters in display math.
2021-02-11Add MANUAL section on reproducible builds.John MacFarlane1-0/+15
2021-02-10Add new unexported module T.P.XMLParser.John MacFarlane1-0/+1
This exports functions that uses xml-conduit's parser to produce an xml-light Element or [Content]. This allows existing pandoc code to use a better parser without much modification. The new parser is used in all places where xml-light's parser was previously used. Benchmarks show a significant performance improvement in parsing XML-based formats (especially ODT and FB2). Note that the xml-light types use String, so the conversion from xml-conduit types involves a lot of extra allocation. It would be desirable to avoid that in the future by gradually switching to using xml-conduit directly. This can be done module by module. The new parser also reports errors, which we report when possible. A new constructor PandocXMLError has been added to PandocError in T.P.Error [API change]. Closes #7091, which was the main stimulus. These changes revealed the need for some changes in the tests. The docbook-reader.docbook test lacked definitions for the entities it used; these have been added. And the docx golden tests have been updated, because the new parser does not preserve the order of attributes. Add entity defs to docbook-reader.docbook. Update golden tests for docx.
2021-02-07 Document no template fallback for absolute path (#7088)Nixon Enraght-Moony1-1/+2
See jgm/pandoc#7077
2021-02-03ePub writer: `belongs-to-collection` metadata (#7063)Nick Berendsen1-0/+9
2021-02-03LaTeX template: Update to iftex package (#7073)Andrew Dunning1-3/+2
Load the iftex package directly rather than via the ifxetex and ifluatex compatibility wrappers, which have been merged into a single package that is part of the LaTeX core. The capitalization of the commands has been changed for compatibility with older versions of TeX Live that have the version of iftex by the Persian TeX Group. This had been removed in <https://github.com/jgm/pandoc/commit/2845794c0c31b2ef1f3e6a73bb5b109da4c74f37> for compatibility with BasicTeX, but that is no longer an issue.
2021-01-27Improve docs for cite-method.John MacFarlane1-1/+4
2021-01-22Update README and man page.John MacFarlane1-1/+1
2021-01-22Merge pull request #7042 from tarleb/jats-element-citationsJohn MacFarlane1-0/+7
JATS writer: use element citations
2021-01-22JATS writer: allow to use element-citationAlbert Krewinkel1-0/+7
2021-01-22Add biblatex, bibtex as output formats (closes #7040).John MacFarlane1-3/+5
* `biblatex` and `bibtex` are now supported as output as well as input formats. * New module Text.Pandoc.Writers.BibTeX, exporting writeBibTeX and writeBibLaTeX. [API change] * New unexported function `writeBibtexString` in Text.Pandoc.Citeproc.BibTeX.
2021-01-11MANUAL.txt: update description of `-L`/`--lua-filter`.Albert Krewinkel1-18/+10
The example filter was outdated, a reference to the separate Lua filters documentation is added instead.
2021-01-08Update copyright notices for 2021 (#7012)Albert Krewinkel1-1/+1
2021-01-05Implement defaults file inheritance (#6924)David Martschenko1-0/+10
Allow defaults files to inherit options from other defaults files by specifying them with the following syntax: `defaults: [list of defaults files or single defaults file]`.
2020-12-30MANUAL: Document use of citations in note styles.John MacFarlane1-0/+28
See #6828.
2020-12-29Bump to 2.11.3.2, update changelog and man pageJohn MacFarlane1-1/+1
2020-12-28MANUAL: note that textarea content is never parsed as Markdown.Albert Krewinkel1-2/+2
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