Commit graph

240 commits

Author SHA1 Message Date
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
John MacFarlane
e86c337356 Pipe tables: use full text width for tables with wrapping cells.
Previously we computed the column sizes based on the ratio
between the header lines and the text width (as set by `--columns`).
This meant that tables with very short header lines would be
very narrow. With this change, pipe tables with wrapping cells will
always take up the whole text width. The relative column widths
will still be determined by the ratio of header lines, but they
will be normalized to add up to 1.0.
2017-12-12 15:16:16 -08:00
Thomas Hodgson
166561cc8d Added support for LaTeX pagestyle variable (#4135)
* Add pagestyle support

* Add pagestyle option to MANUAL.txt

* Moved mention of pagestyle to the section on variables
2017-12-11 22:26:16 -07:00
Jesse Rosenthal
1a5e494cb5 Add PowerPoint info to MANUAL and README. 2017-12-11 07:00:17 -05:00
John MacFarlane
ae60e0196c Add empty_paragraphs extension.
* Deprecate `--strip-empty-paragraphs` option.  Instead we now
  use an `empty_paragraphs` extension that can be enabled on
  the reader or writer.  By default, disabled.

* Add `Ext_empty_paragraphs` constructor to `Extension`.

* Revert "Docx reader: don't strip out empty paragraphs."
  This reverts commit d6c58eb836.

* Implement `empty_paragraphs` extension in docx reader and writer,
  opendocument writer, html reader and writer.

* Add tests for `empty_paragraphs` extension.
2017-12-04 14:56:57 -08:00
John MacFarlane
c58ecde937 MANUAL: note on extensions in gfm. 2017-12-04 10:29:27 -08:00
John MacFarlane
3ee85960cb Update man page and MANUAL date. 2017-12-02 18:56:45 -08:00
John MacFarlane
7b8c2b6691 Add --strip-empty-paragraphs option.
This works for any input format.
2017-12-02 15:21:59 -08:00
John MacFarlane
845b6c8670 Added --print-highlight-style option.
This generates a JSON version of a highlighting style, which can be
saved as a .theme file, modified, and used with `--highlight-style`.

Closes #4106.
Closes #4096.
2017-11-28 13:35:49 -08:00
John MacFarlane
90ee678ea6 Update MANUAL date 2017-11-20 16:52:22 -08:00
John MacFarlane
9916f421dc MANUAL: clarify that math extensions work with HTML.
Clarify that `tex_math_dollars` and `tex_math_single_backslash`
will work with HTML as well as Markdown.
2017-11-18 13:58:40 -08:00
John MacFarlane
84907fef15 MANUAL: update date. 2017-11-11 10:26:56 -05:00
Albert Krewinkel
725500bc58
MANUAL: fix header level of "Extension: emoji"
The level of the "Extension: `emoji`" heading is reduced from 5 to 4 to
conform with the other extension headings.
2017-11-09 09:46:54 +01:00
John MacFarlane
5a4c0d6a8c Deprecated ancient HTML math methods.
`--latexmathml`,
`--gladtex`,
`--mimetex`,
`--jsmath`
2017-11-07 13:05:06 -08:00
Mauro Bieg
f0182e1cb5 MANUAL: consolidate math documentation (#4049) 2017-11-07 15:43:36 -05:00
Alexander Krotov
dd2455cb0d s/suppport/support/ 2017-11-06 09:53:10 +03:00
John MacFarlane
4a98b86a78 Update MANUAL date and man page. 2017-11-04 15:52:05 -07:00
John MacFarlane
d31a04dfb2 Clarify that --setext-headers doesn't affect gfm output.
Closes #4035.
2017-11-04 10:35:26 -07:00
John MacFarlane
8a216b00ef Revise clarification on fenced_divs.
(#4039)
2017-11-04 10:30:32 -07:00
Tristano Ajmone
e9c9bf10e2 Manual: Edit "Extension: fenced_divs" (#4039)
Add paragraph at end of `Extension: fenced_divs` section to clarify that the actual number of colons in fences is irrelevant. (See issue #4037).
2017-11-04 13:27:03 -04:00
John MacFarlane
5dfe131ee0 Support lineAnchors (or line-anchors) in code blocks, for HTML. 2017-11-02 16:38:06 -07:00
John MacFarlane
faa1b364e2 Removed reference to default.beamer in docs.
Also added mention of other templates affecting PDF output
with different settings.

Closes #4024.
2017-11-01 17:46:57 -07:00
John MacFarlane
a25843238c Updated date on manual and regenerated man page. 2017-10-31 21:29:31 -07:00
Andrew Dunning
b90a0fe3dc Revise documentation of small caps syntax. (#4013) 2017-10-31 14:19:30 -04:00
Andrew Dunning
13e438ec9f Fix broken reference links in manual. (#4014) 2017-10-31 14:18:47 -04:00
John MacFarlane
1d208babe4 Fixed example of slide columns structure in changelog.
Also documented this feature in MANUAL.txt.

Closes #4015.
2017-10-31 10:57:20 -07:00
John MacFarlane
e38d8fbec0 Update date on MANUAL.txt 2017-10-27 23:19:37 -07:00
John MacFarlane
d039f231cb Improved documentation about markdown and gfm extensions. 2017-10-27 16:24:08 -07:00
Kolen Cheung
3f0ceaf6ee Use CamelCase for JavaScript for uniformity
other instances when javascript is refered to in pandoc is also in CamelCase, the official casing of JavaScript.
2017-10-26 22:43:19 -07:00
John MacFarlane
70288a4e39 Fixed filters doc link 2017-10-26 16:59:16 -07:00
John MacFarlane
7d60e9e0eb Bring MANUAL, README, and pandoc.cabal description in sync. 2017-10-26 16:30:37 -07:00
John MacFarlane
e43408f74e Add creole support to manual. 2017-10-26 16:23:00 -07:00
John MacFarlane
513b16a71b Fenced divs: ensure that paragraph at end doesn't become Plain.
Added test case.
2017-10-24 09:53:29 -07:00
John MacFarlane
fda0c0119f Implemented fenced Divs.
+ Added Ext_fenced_divs to Extensions (default for pandoc Markdown).
+ Document fenced_divs extension in manual.
+ Implemented fenced code divs in Markdown reader.
+ Added test.

Closes #168.
2017-10-23 22:45:28 -07:00
John MacFarlane
dc92c34827 Use doctemplates 0.2.1: allows $-- line comments in templates.
Closes #3806.
2017-10-20 22:44:49 -07:00
John MacFarlane
9bb8a1f170 Clarify DATADIR in MANUAL 2017-10-18 08:51:15 -07:00
John MacFarlane
99c1481c12 Split list of authors from MANUAL.txt into separate file, AUTHORS.md.
It was getting too long for a man page.
2017-10-17 20:30:20 -07:00
John MacFarlane
0bc30fa03d Updated AUTHORS 2017-10-17 20:14:38 -07:00
John MacFarlane
d8804f4747 App: added --request-header option. 2017-10-15 22:13:15 -07:00
John MacFarlane
27b1581d78 Updated authors in MANUAL.txt. 2017-10-11 22:39:47 -07:00
John MacFarlane
23eaf2a74f KaTeX fixes:
* In Options.HTMLMathMethod, the KaTeX contsructor now takes only
  one string (for the KaTeX base URL), rather than two [API change].
* The default URL has been updated to the latest version.
* The autoload script is now loaded by default.
2017-10-05 10:08:04 -07:00
John MacFarlane
e38c023007 Updated AUTHORS. 2017-09-27 22:35:33 -07:00
John MacFarlane
b1ee747a24 Added --strip-comments option, readerStripComments in ReaderOptions.
* Options:  Added readerStripComments to ReaderOptions.
* Added `--strip-comments` command-line option.
* Made `htmlTag` from the HTML reader sensitive to this feature.

This affects Markdown and Textile input.

Closes #2552.
2017-09-17 13:01:27 -07:00
Ian
5e5ec586d4 Update MANUAL.txt (#3919)
Add URL for Prince HTML > PDF engine
2017-09-12 08:15:08 -07:00
Mauro Bieg
c7e3c1ec17 Support for PDF generation via weasyprint and prince (#3909)
* Rename --latex-engine to --pdf-engine
* In `Text.Pandoc.Options.WriterOptions`, rename `writerLaTeXEngine` to `writerPdfEngine` and `writerLaTeXArgs` to `writerPdfArgs`.
 * Add support for `weasyprint` and `prince`, in addition to `wkhtmltopdf`, for PDF generation via HTML (closes #3906).
* `Text.Pandoc.PDF.html2pdf`: use stdin instead of intermediate HTML file
2017-09-11 20:18:42 -07:00
Andrew Dunning
621e43e0ec Write euro symbol directly in LaTeX
The textcomp package allows pdfLaTeX to parse `€` directly, making the \euro command unneeded. Closes #3801.
2017-09-08 22:26:32 +01:00
Andrew Dunning
2791a68d68 Note use of xcolor in manual. 2017-09-08 10:18:54 +01:00
Stephen McDowell
5365baef9c add documentation of limitations of grid tables (#3864)
- see discussion: https://groups.google.com/forum/#!topic/pandoc-discuss/r9fAeeV3dSw
- grid tables cannot have row spans or column spans
2017-08-23 13:50:58 -07:00
ickc
5c1d844e40 Name change OSX -> macOS (#3869)
* Name change OSX -> macOS

fix commit c96b64e

This commit finishes remaining osx to macOS change, as well as replacing MacOS with macOS.

The reason for the later one is because the "correct" casing of macOS is like that. Apple styles it to looks like iOS, watchOS, tvOS, etc. And unfortunately they all start with a lowercase letter, making propercasing (or even title-casing) odd.

* fix casing of Linux, UNIX, and Windows
2017-08-23 13:48:10 -07:00
John MacFarlane
a31241a08b Markdown reader: use CommonMark rules for list item nesting.
Closes #3511.

Previously pandoc used the four-space rule: continuation paragraphs,
sublists, and other block level content had to be indented 4
spaces.  Now the indentation required is determined by the
first line of the list item:  to be included in the list item,
blocks must be indented to the level of the first non-space
content after the list marker. Exception: if are 5 or more spaces
after the list marker, then the content is interpreted as an
indented code block, and continuation paragraphs must be indented
two spaces beyond the end of the list marker.  See the CommonMark
spec for more details and examples.

Documents that adhere to the four-space rule should, in most cases,
be parsed the same way by the new rules.  Here are some examples
of texts that will be parsed differently:

    - a
      - b

will be parsed as a list item with a sublist; under the four-space
rule, it would be a list with two items.

    - a

          code

Here we have an indented code block under the list item, even though it
is only indented six spaces from the margin, because it is four spaces
past the point where a continuation paragraph could begin.  With the
four-space rule, this would be a regular paragraph rather than a code
block.

    - a

            code

Here the code block will start with two spaces, whereas under
the four-space rule, it would start with `code`.  With the four-space
rule, indented code under a list item always must be indented eight
spaces from the margin, while the new rules require only that it
be indented four spaces from the beginning of the first non-space
text after the list marker (here, `a`).

This change was motivated by a slew of bug reports from people
who expected lists to work differently (#3125, #2367, #2575, #2210,
 #1990, #1137, #744, #172, #137, #128) and by the growing prevalance
of CommonMark (now used by GitHub, for example).

Users who want to use the old rules can select the `four_space_rule`
extension.

* Added `four_space_rule` extension.
* Added `Ext_four_space_rule` to `Extensions`.
* `Parsing` now exports `gobbleAtMostSpaces`, and the type
  of `gobbleSpaces` has been changed so that a `ReaderOptions`
  parameter is not needed.
2017-08-19 15:45:01 -07:00
ickc
2a0e2e6fd6 slidy uses https instead of http (#3848)
grep -rl 'http://www.w3.org/Talks/Tools/Slidy2' . | xargs sed -i 's/http:\/\/www\.w3\.org\/Talks\/Tools\/Slidy2/https:\/\/www\.w3\.org\/Talks\/Tools\/Slidy2/g'
2017-08-17 10:11:49 -07:00
John MacFarlane
c6ec189a96 Revision to binary format output to stdout:
We now allow default output to stdout when it can be
determined that the output is being piped.  (On Windows,
as mentioned before, this can't be determined.)

Using '-o -' forces output to stdout regardless.
2017-08-16 10:39:34 -07:00
John MacFarlane
61cf3affa9 Change behavior with binary format output to stdout.
Previously, for binary formats, output to stdout was disabled
unless we could detect that the output was being piped (and not
sent to the terminal).  Unfortunately, such detection is not
possible on Windows, leaving windows users no way to pipe binary
output.  So we have changed the behavior in the following way:

* If the -o option is not used, binary output is never sent
  to stdout by default; instead, an error is raised.
* IF '-o -' is used, binary output is sent to stdout, regardless
  of whether it is being piped. This works on Windows too.
2017-08-16 09:45:12 -07:00
John MacFarlane
cf54c9b3c2 Document gfm in MANUAL.
Closes #3509.
2017-08-08 13:26:02 -07:00
John MacFarlane
2daab579f4 MANUAL: clarify that mathml is used for ODT math. 2017-07-26 00:00:54 +02:00
rlpowell
2ae75e23dd Added TikiWiki reader (#3800)
Added TikiWiki reader, including tests and documentation.

It's probably not *complete*, but it works pretty well, handles all
the basics (and some not-so-basics).
2017-07-21 10:09:54 +02:00
John MacFarlane
8300b3fbda MANUAL: document ibooks specific epub metadata. 2017-06-30 23:56:01 +02:00
John MacFarlane
7ea49da002 LaTeX template: added natbiboptions variable.
Closes #3768.
2017-06-28 14:34:12 +02:00
John MacFarlane
7d9d77ca44 Require nonempty alt text for implicit_figures.
A figure with an empty caption doesn't make sense.

Closes #2844.
2017-06-27 15:25:37 +02:00
John MacFarlane
19d9482fc4 OpenDocument/ODT writer: Added support for table of contents.
Closes #2836.

Thanks to @anayrat.
2017-06-26 16:46:56 +02:00
John MacFarlane
6773447c8c Support --toc in opendocument/odt. 2017-06-26 16:31:28 +02:00
John MacFarlane
595d81bf54 Added note on output formats in docs for raw_attribute. 2017-06-23 11:36:13 +02:00
John MacFarlane
2b34337a9c Text.Pandoc.Extensions: Added Ext_raw_attribute.
Documented in MANUAL.txt.

This is enabled by default in pandoc markdown and multimarkdown.
2017-06-23 00:37:13 +02:00
John MacFarlane
24d215acf5 Added --epub-subdirectory option.
This specifies the subdirectory in the OCF container that
holds the EPUB specific content.

Closes #3720.
2017-06-22 12:01:33 +02:00
John MacFarlane
9ac0a99292 Added mention of vimwiki raeder more places. 2017-06-20 16:57:39 +02:00
Yuchen Pei
564c77964d Added Vimwiki reader (#3705).
* New module Text.Pandoc.Readers.Vimwiki, exporting readVimwiki [API change].
* New input format `vimwiki`.
* New data file, `data/vimwiki.css`, for displaying the HTML produced by this reader and pandoc's HTML writer in the style of vimwiki's own HTML export.
2017-06-19 22:15:12 +02:00
John MacFarlane
aface549a0 Mention muse reader in README, MANUAL, debian control, cabal description. 2017-06-19 10:50:59 +02:00
Alexander Krotov
10e3ce361f Mention Muse writer in MANUAL.txt (#3744) 2017-06-19 09:38:47 +02:00
Václav Haisman
4bae307616 Added aspectratio variable to beamer template (#3723).
* Transplant jgm/pandoc-templates#236 to Pandoc repository.
* Document `aspectratio` in user manual.
* Enumerate possible values for `aspectratio`.
2017-06-05 15:52:36 +02:00
John MacFarlane
708973a33a Added spaced_reference_links extension.
This is now the default for pandoc's Markdown.
It allows whitespace between the two parts of a
reference link:  e.g.

    [a] [b]

    [b]: url

This is now forbidden by default.

Closes #2602.
2017-05-25 12:57:31 +02:00
John MacFarlane
650e1ac1fd Docx writer: Use Table rather than "Table Normal" for table style.
"Table Normal" is the default table style and can't be modified.

Closes #3275, further testing welcome.
2017-05-25 12:11:46 +02:00
John MacFarlane
4d1e9b8e41 Let --eol take native as an argument.
Add `Native` to the `LineEnding` type.
Make `optEol` a `Native` rather than `Maybe Native`.
2017-05-22 10:15:03 +02:00
John MacFarlane
8c1b81bbef Finished implemtation of --resource-path.
* Default is just working directory.
* Working directory must be explicitly specifide if
  `--resource-path` option is used.
2017-05-21 09:02:01 +02:00
John MacFarlane
fd6e65b00f Added --resource-path=SEARCHPATH command line option.
SEARCHPATH is separated by the usual character,
depending on OS (: on unix, ; on windows).

Note: This does not yet work for PDF output, because the
routine that creates PDFs runs outside PandocMonad.
(This has to do with its use of inTemporaryDirectory and
its interaction with our exceptions.)

The best solution would be to figure out how to move the
PDF creation routines into PandocMonad.  Second-best,
just pass an extra parameter in?

See #852.
2017-05-20 21:47:10 +02:00
John MacFarlane
689a8dcd5f Update Figure With Caption -> Captioned Figure in MANUAL.txt. 2017-05-18 22:34:54 +02:00
Stefan Dresselhaus
6b8240fc2f Add --eol flag and writer option to control line endings.
* Add `--eol=crlf|lf` CLI option.
* Add `optEol` to `WriterOptions` [API change]
* In `Text.Pandoc.UTF8`, add new functions parameterized on `Newline`:
  `writeFileWith`, `putStrWith`, `putStrLnWith`, `hPutStrWith`,
  `hPutStrLnWith`. [API change]
* Document option in MANUAL.txt.

Closes #3663.
Closes #2097.
2017-05-18 11:55:45 +02:00
John MacFarlane
e01e2d0b9b MANUAL: remove refs to highlighting-kate.
Closes #3672.
2017-05-15 20:37:50 +02:00
Albert Krewinkel
965f1ddd4a
Update dates in copyright notices
This follows the suggestions given by the FSF for GPL licensed software.
<https://www.gnu.org/prep/maintain/html_node/Copyright-Notices.html>
2017-05-13 23:30:13 +02:00
John MacFarlane
af8860d26a Updated documentation for --extract-media. 2017-05-07 11:56:19 +02:00
John MacFarlane
f422000197 Small reformatting in MANUAL. 2017-05-06 15:01:54 +02:00
John MacFarlane
07778ade39 Use lowercase a4 for latex papersize example. 2017-04-12 23:41:31 +02:00
Sam Kim
7fe37d0b79 Fixed a typo (#3562) 2017-04-07 22:23:29 +02:00
John MacFarlane
48729f9715 Ms writer improvements:
- added some variables to the default template.
- cleaner output for images (stringify alt text).
2017-04-04 17:21:02 +02:00
John MacFarlane
b474a23296 MANUAL: document highlighting support in ms. 2017-04-02 23:10:42 +02:00
John MacFarlane
420e3eb26e Allow a theme file as argument to --highlight-style.
Also include a sample, `default.theme`, in `data/`.
2017-04-01 22:27:00 +02:00