Commit graph

324 commits

Author SHA1 Message Date
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
John MacFarlane
eef8adaad8 Use 'keywords' instead of 'tags' in YAML metadata example.
Unlike `tags`, `keywords` is used in some of the writers
and default templates.

Closes #4779.
2018-07-18 19:24:45 -07:00
John MacFarlane
67f7cec439 Update man page. 2018-07-15 14:42:58 -07:00
Mauro Bieg
c30eada4ee MANUAL: clarify EPUB linked media (#4756) 2018-07-06 23:28:33 +02:00
John MacFarlane
99252b3d55 Update manual for "true" YAML values.
Now that we're using HsYAML and YAML 1.2, the valid
true values are `true`, `True`, `TRUE`.

NOTE!  `y`, `yes`, `on` no longer count as true values.
2018-06-30 12:36:27 +02:00
John MacFarlane
e49b8304e4 Use HsYAML instead of yaml for translations, YAML metadata.
yaml wraps a C library; HsYAML is pure Haskell.
Closes #4747.  Advances #4535.
2018-06-29 23:21:25 +02:00
John MacFarlane
76e52ed4b0 MANUAL: Removed spurious 'LaTeX' from list. 2018-06-25 22:40:54 +02:00
John MacFarlane
6338e4f088 MANUAL: document -F as alias for --filter.
Thanks to Gandalf Saxe for pointing out the omission.
2018-06-25 22:31:57 +02:00
John MacFarlane
ee84687d25 Update manual on how math is rendered in LaTeX. 2018-06-24 13:03:01 +02:00
Mauro Bieg
9149155fda MANUAL.txt add proxy description (#4707)
closes #4131
2018-06-14 09:38:47 -07:00
John MacFarlane
e9b81bf5c4 MANUAL: Clarify that --toc requires --standalone. See #4703. 2018-06-13 11:04:31 -07:00
Raymond Ehlers
2c1a309c9f Beamer: Allow "noframenumbering" option (#4696)
As noted [here](https://tex.stackexchange.com/a/49805) ([beamer
commit here](ff70090f36)),
`noframenumbering` is an undocumented, but long existing option
to disable frame numbering for a particular slide. This is useful
to avoid numbering backup slides.
2018-06-12 10:39:20 -07:00
John MacFarlane
07bce91f4f Allow --template to take a URL argument. 2018-06-12 10:33:34 -07:00
wiefling
e499769dc0 Citation styles link updated (#4699) 2018-06-12 10:05:51 -07:00
John MacFarlane
32ef6f91fd Update manual date and man page. 2018-05-10 21:44:32 -07:00
Mauro Bieg
b502056104 MANUAL: clarify pipe table width calculation (#4630)
closes #4520
2018-05-09 21:05:23 -07:00
John MacFarlane
b7356d3ddf Restored and undeprecated gladtex for HTML math.
- Added `GladTeX` constructor to `Text.Pandoc.Options.HTMLMathMethod`
  [API change, reverts removal in v2.2]
- Restored and undeprecated `--gladtex` option, removed in v2.2.

Closes #4607.
2018-05-09 11:29:20 -07:00
Mauro Bieg
eb3521e4c9 MANUAL: clarify truthiness in template variables (#4631)
closes #2281
2018-05-08 09:36:50 -07:00
John MacFarlane
83fe92d23b Note on the effect of --standalone on native output. 2018-05-03 09:40:39 -07:00
Mauro Bieg
7e0362eeb2
MANUAL.txt fix two internal links 2018-05-02 11:09:33 +02:00
John MacFarlane
79d6c3d62c Update man page and MANUAL date. 2018-04-26 23:35:31 -07:00
John MacFarlane
1494b20bb4 Document FB2 reader. 2018-04-26 12:35:02 -07:00
John MacFarlane
50da88446c MANUAL: explain where you can put lua filters. 2018-04-26 12:23:25 -07:00
John MacFarlane
e3d05171f3 Make --ascii work for all XML formats (ICML, OPML, JATS,...).
Also document in manual.
2018-04-26 12:23:25 -07:00
John MacFarlane
16f36eee43 Removed deprecated ancient HTML math methods.
Removed `--latexmathml`, `--gladtex`, `--mimetex`, `--jsmath`, `-m`,
`--asciimathml` options.

Removed `JsMath`, `LaTeXMathML`, and `GladTeX` constructors from
`Text.Pandoc.Options.HTMLMathMethod` [API change].

Removed unneeded data file LaTeXMathML.js and updated tests.

Bumped version to 2.2.
2018-04-25 17:18:56 -07:00
John MacFarlane
72bdac3036 New README template, take in/out formats from manual. 2018-04-22 11:36:47 -07:00
Mauro Bieg
873a4c4bf5 MANUAL: consolidate input/output format documentation (#4577)
* MANUAL: consolidate format lists

* MANUAL: make formats a proper list
2018-04-22 10:37:36 -07:00
John MacFarlane
939985ef18 MANUAL.txt: Don't say that empty_paragraphs affects markdown output.
It doesn't.

Closes #4540.
2018-04-15 17:51:17 -07:00
John MacFarlane
362045afa0 Fix typo. 2018-04-02 09:49:12 -07:00
Étienne BERSAC
7f97b04862 Add -V beameroption variable (#4359)
* LaTeX template: Use `pgfpages` package; this is needed for notes on second screen in beamer
* LaTeX template: Add `beameroption` variable in template
2018-03-30 09:20:06 -07:00
Mauro Bieg
c24ecf9cd9 MANUAL: clarify template vs metadata variables (#4501) 2018-03-27 09:14:50 -07:00
Mauro Bieg
0987aa2a54 MANUAL.txt fix raw content example (#4479) 2018-03-21 17:08:39 -07:00
John MacFarlane
904f82176d MANUAL: specify that you use html for raw output in epub. 2018-03-19 16:00:49 -07:00
John MacFarlane
2c2cd31806 Small improvement of doc change in #4472.
Mention other formats as well where a different
name is needed.
2018-03-19 09:22:41 -07:00
Tristan Stenner
24faccdf5d Add examples for raw docx blocks (#4472)
The documentation states that the target format name should match the output format, which isn't the case for `docx`/`openxml`.

This PR adds a remark and a frequently requested example (inserting a pagebreak in docx output) to the documentation.
2018-03-19 09:20:16 -07:00
John MacFarlane
1ec8b5b92d Manual formatting tweaks. 2018-03-17 21:27:57 -07:00
Henri Menke
46f4238a2a ConTeXt template: pdfa variable to generate PDF/A (#4294)
The resulting PDF can be verified using the Apache PDFBox preflight app.

```
$ java -jar preflight-app-2.0.8.jar test.pdf 
The file test.pdf is a valid PDF/A-1b file
```

Instructions on how to install the ICC profiles on ConTeXt standalone can be found in the wiki: <http://wiki.contextgarden.net/PDFX#ICC_profiles>.
If the ICC profiles are not available the log will contain messages like these

```
backend         > profiles > profile specification 'sRGB.icc' loaded from '/usr/local/texlive/2017/texmf-dist/tex/context/colors/icc/context/colorprofiles.xml'
backend         > profiles > error, couldn't locate profile 'srgb.icc'
backend         > profiles > no default profile 'srgb.icc' for colorspace 'rgb'
backend         > profiles > profile specification 'sRGB IEC61966-2.1' loaded from '/usr/local/texlive/2017/texmf-dist/tex/context/colors/icc/context/colorprofiles.xml'
backend         > profiles > error, couldn't locate profile 'srgb.icc'
backend         > profiles > invalid output intent 'sRGB IEC61966-2.1'
```

and the resulting PDF will not be valid PDF/A:

```
$ java -jar preflight-app-2.0.8.jar test.pdf 
The file test.pdf is not a valid PDF/A-1b file, error(s) :
2.4.3 : Invalid Color space, The operator "g" can't be used without Color Profile on page 1
2.4.3 : Invalid Color space, The operator "G" can't be used without Color Profile on page 1
2.4.3 : Invalid Color space, /DeviceGray default for operator "TJ" can't be used without Color Profile on page 1
2.4.3 : Invalid Color space, /DeviceGray default for operator "TJ" can't be used without Color Profile on page 1
2.4.3 : Invalid Color space, The operator "g" can't be used without Color Profile on page 1
2.4.3 : Invalid Color space, The operator "G" can't be used without Color Profile on page 1
2.4.3 : Invalid Color space, /DeviceGray default for operator "TJ" can't be used without Color Profile on page 1
```

However, the PDF will still be generated and the "errors" shown in the log do not break anything.
2018-03-17 21:05:55 -07:00
John MacFarlane
01f7f8da62 Update man page. 2018-03-17 20:40:16 -07:00
John Muccigrosso
f921b38869 Add instructions for background images reveal.js (#4325) 2018-03-13 09:17:46 -07:00
John MacFarlane
5e6879dbf9 Update man page and date on MANUAL. 2018-03-02 20:23:53 -08:00
Jesse Rosenthal
5ada5cceac Docx reader: Don't look up dependant run styles if +styles is enabled.
It makes more sense not to interpret -- otherwise using the original
document as the reference-doc would produce two of everything: the
interpreted version and the uninterpreted style version.
2018-02-23 14:35:30 -05:00
Jesse Rosenthal
9d076eb8ef MANUAL.txt: Document incremental and nonincremental divs.
Blockquoted lists are still described, but fenced divs are presented
in preference.
2018-02-22 14:41:02 -05:00
Jesse Rosenthal
8b7df2d915 Docx reader: Move pandoc inline styling inside custom-style span
Previously Emph, Strong, etc were outside the custom-style span. This
moves them inside in order to make it easier to write filters that act
on the formatting in these contents.

Tests and MANUAL example are changed to match.
2018-02-22 13:41:02 -05:00
Jesse Rosenthal
87e0728b87 Docx reader: Avoid repeated spans in custom styles.
The previous commit had a bug where custom-style spans would be read
with every recurrsion. This fixes that, and changes the example given
in the manual.
2018-02-22 13:27:34 -05:00
Jesse Rosenthal
03eda213d1 MANUAL: add documentation on custom styles.
Discuss workflow of using input document as reference.docx.

We also split the "Custom styles" section into two parts: input and output.
2018-02-22 13:05:44 -05:00
Jesse Rosenthal
aae362f634 MANUAL.txt: fix typo. 2018-02-20 09:58:07 -05:00
Jesse Rosenthal
b4401165dd MANUAL.txt: A bit of clarification on speaker notes.
Make it clear that pressing `s` is just for reveal.js.
2018-02-20 09:42:31 -05:00
Jesse Rosenthal
c46e796491 MANUAL.txt: Add instructions for using pptx reference-docs 2018-02-20 09:40:43 -05:00
Jesse Rosenthal
4a6000c7d0 MANUAL: add reference to pptx support for speaker notes. 2018-02-18 16:31:32 -05:00
Daniel Lublin
d2e4790b50 MANUAL.txt: self-contained implies standalone (#4304) 2018-01-28 11:25:34 -08:00
John MacFarlane
848a3fd528 Delete excess whitespace 2018-01-21 10:21:16 -08:00
John MacFarlane
e9aadc1cfa
Merge pull request #4237 from sitewisely/header_and_footer
Add header and footer parameters for wkhtmltopdf
2018-01-21 11:18:44 -07:00
Jesse Rosenthal
d0a895acee Powerpoint writer: Implement syntax highlighting
This also necessitated implementing colors and underlining, though
there is currently no way to produce these from markdown. Note that
background colors can't be implemented in PowerPoint, so highlighting
styles that require these will be incomplete.
2018-01-18 17:33:05 -05:00
John MacFarlane
d57ff311e5 Replaced tabs with spaces in MANUAL.txt.
@jkr - the tabs were inserted by
your 624abeec5c,
presumably through some automatic setting in your editor
that replaced 8 spaces with a tab.

This messed up indented formatting in the manual.
2018-01-18 08:18:46 -08:00
Henri Menke
6910267abf ConTeXt writer: Use xtables instead of Tables (#4223)
- Default to xtables for context output.
- Added `ntb` extension (affecting context writer only) to use Natural Tables instead.
- Added `Ext_ntb` constructor to `Extension` (API change).
2018-01-15 18:38:33 -07:00
John MacFarlane
9184e1a55b Clarified latex_macros extension. 2018-01-14 16:05:13 -08:00
John MacFarlane
e5e69e68c9 MANUAL: recommend use of raw_attribute extension in header includes.
See #4253.
2018-01-13 12:22:25 -08:00
Jesse Rosenthal
624abeec5c Powerpoint writer: allow setting toc-title in metadata.
Accompanying change in MANUAL.txt
2018-01-12 11:09:17 -05:00
John MacFarlane
9f888659f7 MANUAL.txt: clarify otherlangs in LaTeX.
Closes #4072.
2018-01-11 21:03:09 -08:00
newmana
6b40b8c27c Add header and footer parameters 2018-01-10 13:58:35 +10:00
mb21
9f2707818b MANUAL.txt update ICML link 2018-01-08 13:19:01 +01:00
John MacFarlane
5ca99f2cea Update changelog and man page. 2018-01-07 21:28:04 -08:00
Jesse Rosenthal
06a672dd4f MANUAL.txt: add information about paragraph insertion/deletion 2018-01-02 11:56:53 -05:00
Jesse Rosenthal
10238f059b Revert "MANUAL.txt: add information about paragraph insertion/deletion."
This reverts commit 09e132726d.
2018-01-02 11:52:03 -05:00
Jesse Rosenthal
09e132726d MANUAL.txt: add information about paragraph insertion/deletion. 2018-01-02 11:32:48 -05:00
John MacFarlane
0d968c4bbb Small MANUAL tweaks. 2017-12-29 08:41:54 -08:00
mb21
579e32408c MANUAL.txt move fenced_divs down to bracketed_spans 2017-12-29 15:55:08 +01:00
mb21
9cba3d22c4 MANUAL.txt simplify and add more structure 2017-12-29 10:37:14 +01:00
John MacFarlane
346b10392f Update docs on filters. 2017-12-28 16:39:52 -08:00
Richard Edwards
eabb47335a
clarify default html output for --section-divs
In Pandoc v2 using --section-divs and -t html results in <section>s, not <div>s, by default, as was the case for v1.9.
This change to the Manual emphasizes that you must use -t html4 if you want divs, otherwise you get sections.
2017-12-28 15:27:16 -08:00
John MacFarlane
e10864d9d5 Changed format of --list-extensions.
Now the + or - occurs first.
2017-12-28 12:12:22 -08:00
John MacFarlane
cc9e3a9172 Allow --list-extensions to take an optional FORMAT argument.
This lists the extensions set by default for the selected
FORMAT.
2017-12-27 12:25:48 -08:00
John MacFarlane
eb7f65305d Update manual date and man page. 2017-12-27 09:53:16 -08:00
mb21
44e504853f MANUAL.txt introduce dedicated extensions section 2017-12-27 17:11:23 +01:00
John MacFarlane
28b736bf95 latex_macros extension changes.
Don't pass through macro definitions themselves when `latex_macros`
is set.  The macros have already been applied.

If `latex_macros` is enabled, then `rawLaTeXBlock` in
Text.Pandoc.Readers.LaTeX will succeed in parsing a macro definition,
and will update pandoc's internal macro map accordingly, but the
empty string will be returned.

Together with earlier changes, this closes #4179.
2017-12-22 18:03:51 -08:00
John MacFarlane
a848d3e031 Mention JATS output (and input) in MANUAL, README, cabal description. 2017-12-21 22:20:38 -08:00
Mauro Bieg
6ec7e39b4c MANUAL.txt use native syntax for custom-style (#4174) 2017-12-21 12:56:20 -07:00
John MacFarlane
a831a4f469 MANUAL: add note on what formats have +smart by default. 2017-12-14 12:54:37 -08:00
John MacFarlane
d9cdce4281 Markdown reader: always use four space rule for example lists.
It would be awkward to indent example list contents to the
first non-space character after the label, since example
list labels are often long.

Thanks to Bernhard Fisseni for the suggestion.
2017-12-13 10:20:57 -08:00