Commit graph

302 commits

Author SHA1 Message Date
John MacFarlane
f961dd7c1b MANUAL: Fix outdated description of latex_macros extension. 2018-11-21 22:56:50 -05:00
John MacFarlane
3689d047a8 MANUAL.txt: Clarified placement of bibliography. 2018-11-19 10:46:50 -08:00
John MacFarlane
2347babbf0 MANUAL: Under security, added note about +RTS option to limit heap size.
See #5047.
2018-11-15 10:10:40 -08:00
John MacFarlane
4a950feb8e Fix note on curly brace syntx for locators. 2018-11-13 07:05:58 -08:00
John MacFarlane
a01ee64970 Document new explicit syntax for citeproc locators. 2018-11-12 20:20:32 -08:00
John MacFarlane
a36d202e86 Text.Pandoc.Shared: add parameter to uniqueIdent, inlineListToIdentifier.
The parameter is Extensions. This allows these functions to
be sensitive to the settings of `Ext_gfm_auto_identifiers` and
`Ext_ascii_identifiers`.

This allows us to use `uniqueIdent` in the CommonMark reader,
replacing some custom code.

It also means that `gfm_auto_identifiers` can now be used
in all formats.

Semantically, `gfm_auto_identifiers` is now a modifier of
`auto_identifiers`; for identifiers to be set, `auto_identifiers`
must be turned on, and then the type of identifier produced
depends on `gfm_auto_identifiers` and `ascii_identifiers` are set.

Closes #5057.
2018-11-11 13:46:23 -08:00
John MacFarlane
ca17ae5246 Remove ascii_identifiers from githubMarkdownExtensions.
GitHub doesn't seem to strip non-ascii characters.
2018-11-11 11:04:34 -08:00
John MacFarlane
f16e29ee2b MANUAL.txt: remove confusing cross-links for some extensions.
I think the text comment to look in the pandoc markdown section
is enough.
2018-11-05 17:20:41 -08:00
John MacFarlane
c4223ca094 MANUAL: don't put pandoc in code ticks in heading. 2018-11-05 10:09:52 -08:00
John MacFarlane
1269fbd032 MANUAL.txt: --ascii works for gfm too. 2018-11-05 09:46:04 -08:00
quasicomputational
a747268823 CommonMark writer: respect --ascii (#5043) 2018-11-05 09:33:10 -08:00
John MacFarlane
249fd40838 MANUAL.txt: added "A note on security." 2018-11-05 09:21:43 -08:00
John MacFarlane
41b8ad6dd7 MANUAL.txt: add man to --from options. 2018-11-04 11:28:10 -08:00
John MacFarlane
db8ff174e5 Document romanfont, romanfontoptions. 2018-11-03 12:42:36 -07:00
John MacFarlane
2f65263851 AsciiDoc writer: use single-line section headers.
The underline style is now deprecated.
Previously `--atx-headers` would enable the single-line
style; now the single-line style is always used.

Closes #5038.
2018-11-03 12:03:05 -07:00
John MacFarlane
c0e0ef12cf Update manual date and man page. 2018-11-01 21:56:41 -07:00
John MacFarlane
e10d5b3d5b Change 'groff' -> 'roff'.
These formats (man, ms) are not groff-specific.
2018-11-01 16:46:43 -07:00
John MacFarlane
26341c1632 Implement --ascii for Markdown writer. 2018-11-01 16:31:04 -07:00
John MacFarlane
f379edc4ad HTML writer: use character entities references when possible for HTML5. 2018-11-01 16:08:27 -07:00
Mauro Bieg
614b1c0c61 MANUAL: clarify LaTeX image dimensions output 2018-11-01 14:15:09 -07:00
John MacFarlane
7c9ff8461f small wording change 2018-10-28 16:18:11 -07:00
mb21
7e6f13cf81 EPUB writer: use metadata field css instead of stylesheet
closes #4990
2018-10-28 16:18:11 -07:00
John MacFarlane
efbb329f1a Groff escaping changes.
- `--ascii` is now turned on automatically for man output, for
  portability.  All man output will be escaped to ASCII.
- In T.P.Writers.Groff, `escapeChar`, `escapeString`, and
  `escapeCode` now take a boolean parameter that selects
  ascii-only output.  This is used by the Ms writer for
  `--ascii`, instead of doing an extra pass after writing
  the document.
- In ms output without `--ascii`, unicode is used whenever
  possible (e.g. for double quotes).
- A few escapes are changed: e.g. `\[rs]` instead of `\\` for
  backslash, and `\ga]` instead of `` \` `` for backtick.
2018-10-18 10:21:34 -07:00
quasicomputational
6207bdeb68 CommonMark writer: add plain text fallbacks. (#4531)
Previously, the writer would unconditionally emit HTMLish output for
subscripts, superscripts, strikeouts (if the strikeout extension is
disabled) and small caps, even with raw_html disabled.

Now there are plain-text (and, where possible, fancy Unicode)
fallbacks for all of these corresponding (mostly) to the Markdown
fallbacks, and the HTMLish output is only used when raw_html is
enabled.

This commit adds exported functions `toSuperscript` and
`toSubscript` to `Text.Pandoc.Writers.Shared`.  [API change]

Closes #4528.
2018-10-05 21:33:14 -07:00
John MacFarlane
36f1846cc3 Implement --ascii (writerPreferAscii) in writers, not App.
Now the `write*` functions for Docbook, HTML, ICML, JATS,
Man, Ms, OPML are sensitive to `writerPreferAscii`.  Previously
the to-ascii translation was done in Text.Pandoc.App, and
thus not available to those using the writer functions
directly.

In addition, the LaTeX writer is now sensitive to
`writerPreferAscii` and to `--ascii`.  100% ASCII
output can't be guaranteed, but the writer will use
commands like `\"{a}` and `\l` whenever possible,
to avoid emiting a non-ASCII character.

A new unexported module, Text.Pandoc.Groff, has been
added to store functions used in the different groff-based
writers.
2018-09-30 22:32:00 -07:00
John MacFarlane
c07b9aebc2 Version to 2.3.1. 2018-09-27 23:09:06 -07:00
Mauro Bieg
b69f7d8810
MANUAL: epub:type is only useful for epub3 2018-09-27 12:15:20 +02:00
John MacFarlane
6632f2f2ce Add .options class to option headers in manual.
This will allow autogeneration of ids for particular
options in the manual.
2018-09-18 11:35:23 -07:00
John MacFarlane
1dd899c242 MANUAL: use https for context wiki links.
Otherwise the wiki won't redirect.

Closes #4910.
2018-09-16 20:41:20 -07:00
John MacFarlane
04fce40cd6 Update manual date and man page. 2018-09-16 11:18:41 -07:00
John MacFarlane
6bd8037b8d
Merge pull request #4604 from mb21/yaml-file
Introduce --metadata-file option
2018-09-15 14:32:06 -07:00
John MacFarlane
f6d8df2c76 MANUAL: clarify that --biblatex/--natbib don't work directly for PDF.
Closes #4904.
2018-09-15 11:52:03 -07:00
mb21
6aa5fcac13 introduce --metadata-file option
closes #1960

API change: Text.Pandoc.Readers.Markdown exports now `yamlToMeta`
2018-09-15 16:48:04 +02:00
Mauro Bieg
2bd5ba2342 MANUAL.txt epub:type attribute (#4901) 2018-09-14 10:06:49 -07:00
John MacFarlane
a734ed6532 MANUAL: Clarify when --resource-path has an effect. 2018-09-06 10:07:22 -07:00
damien clochard
efe99b5e97 Document encoding issue with --listings (#4873)
Document encoding issue with `--listings`.

Closes #4871.
2018-09-05 09:41:48 -07:00
Mauro Bieg
d63202c2f4
MANUAL: remove docs on removed --katex-stylesheet
closes #4862
2018-08-30 21:16:30 +02:00
Wandmalfarbe
dac85d683f Add support for $toc-title$ to LaTeX (and PDF). (#4853) 2018-08-25 09:55:17 -07:00
John MacFarlane
a2c4261b32 HTML reader: allow enabling raw_tex extension.
This now allows raw LaTeX environments, `\ref`, and `\eqref` to
be parsed (which is helpful for translation HTML documents using
MathJaX).

Closes #1126.
2018-08-24 18:04:00 -07:00
John MacFarlane
fe312b0a7a LaTeX writer/template: be sensitive to filecolor variable.
`linkcolor` only affects internal links, and `urlcolor` only
affects linked URLs.  For external links, the option to use is
`filecolor`.

Closes #4822.
2018-08-16 20:48:51 -07:00
Cyril Roelandt
2ae8272754 Support "toc-title" in the beamer template. (#4835)
It is a bit awkward to have a title for every frame, but not for the one
that holds the table of contents. Allow users to specify a title if they
wish.
2018-08-15 09:58:17 -07:00
John MacFarlane
fb3ee947aa MANUAL: more detail on customization in syntax highlighting section. 2018-08-11 16:31:35 -07:00
John MacFarlane
6728049225 Bump to 2.2.3.2, update man page, changelog. 2018-08-07 09:30:34 -07:00
John MacFarlane
030e8969c7 Bump to 2.2.3.1, update man page and changelog. 2018-08-06 21:37:15 -07:00
John MacFarlane
d8a614d7bb Bump to 2.2.3, update changelog and man page. 2018-08-05 12:40:56 -07:00
John Muccigrosso
c279a2d332 MANUAL: Add beamer info for slide backgrounds (#4802) 2018-07-31 11:36:35 -07:00
John MacFarlane
a85877424b MANUAL: Clarify when csquotes is used in LaTeX writer.
Closes #4514.
2018-07-21 23:29:30 -07:00
John MacFarlane
ffed20cd71 MANUAL: Added commonmark to list of output formats where...
`raw_tex` has an effect.  See #4527.
2018-07-21 23:07:50 -07:00
John MacFarlane
31ef9959b8 Update man page, changelog, authors. 2018-07-19 21:51:56 -07:00
Mauro Bieg
640814ac75 MANUAL: clarify gfm vs markdown_github (#4783) 2018-07-19 13:09:26 -07:00