Commit graph

489 commits

Author SHA1 Message Date
John MacFarlane
bbdc0e7542 MANUAL: Default --columns width is 72, not 80. 2016-12-16 09:11:14 +01:00
John MacFarlane
35ff12a569 Updated MANUAL date and man page. 2016-12-10 11:29:58 +01:00
John MacFarlane
a197341252 MANUAL: better docs on how to create a custom reference.docx. 2016-12-07 15:39:06 +01:00
Anthony Geoghegan
733b1f3ae2 Minor spelling typos in the manual (#3273)
* Fix spelling typos:

 * hightlight
 * respecitively
 * codeblock – inconsistent with rest of document using “code block”

* Use consistent case for proper nouns.

For example: “ASCII”, “Unicode”, “Latin”, “JavaScript”, “CSS”.
2016-12-03 21:17:27 +01:00
John MacFarlane
4e6edd2d0d Update date in manual and man page. 2016-11-30 21:03:17 +01:00
Albert Krewinkel
1fc07ff4da Refactor top-level division selection (#3261)
The "default" option is no longer represented as `Nothing` but via a new
type constructor, making the `Maybe` wrapper superfluous.

The default behavior of using heuristics can now be enabled explicitly
by setting `--top-level-division=default`.

API change (`Text.Pandoc.Options`): The `Division` type was renamed to
`TopLevelDivision`. The `Section`, `Chapter`, and `Part` constructors
were renamed to `TopLevelSection`, `TopLevelChapter`, and
`TopLevelPart`, respectively. An additional `TopLevelDefault`
constructor was added, which is now also the new default value of the
`writerTopLevelDivision` field in `WriterOptions`.
2016-11-27 20:31:04 +01:00
John MacFarlane
6ee7f7206b Further revisions to manual for --version changes.
Closes #3244.
2016-11-23 15:08:54 +01:00
John MacFarlane
ac6dfe0b4e Changed resolution of filter paths.
- We now first treat the argument of `--filter` as a full (absolute
  or relative) path, looking for a program there.  If it's found,
  we run it.
- If not, and if it is a simple program name or a relative path,
  we try resolving it relative to `$DATADIR/filters`.
- If this fails, then we treat it as a program name and look in
  the user's PATH.

Previously if you did `--filter foo` and you had `foo` in your
path and also an executable `foo` in your working directory,
the one in the path would be used. Now the one in the working
directory is used.

In addition, when you do `--filter foo/bar.hs`, pandoc will now
find a filter `$DATADIR/filters/foo/bar.hs` -- assuming there
isn't a `foo/bar.hs` relative to the working directory.

@jkr note the slight revision of what we had before.
This was motivated by the idea that one might clone filter
repositories into the filters subdirectory; it is nice to
be able to run them as `reponame/filtername`.
2016-11-21 15:32:27 +01:00
ickc
e8ce21d614 Small caps in Bracketed Spans (#3191)
* Markdown reader: modify bracketedSpan to check small caps

* MANUAL.txt: add description on the use of `bracketed_spans` in small cap

* Improve markdown readers: bracketedSpan function EXACTLY as spanHtml
2016-11-16 11:53:51 +01:00
John MacFarlane
298e6f38f9 Allow alignments to be specified in Markdown grid tables. 2016-11-15 16:41:54 +01:00
John MacFarlane
4afb115e0a Updated authors in MANUAL.txt. 2016-10-26 22:32:23 +02:00
John MacFarlane
4473cd819c Fixed date on MANUAL.txt 2016-10-26 12:24:39 +02:00
John MacFarlane
b4fbe226a5 Document hyperref options for beamer in MANUAL. 2016-10-25 16:04:44 +02:00
John MacFarlane
273d90bc19 Added --list-* options.
Added `--list-input-formats`, `--list-output-formats`,
`--list-extensions`, `--list-highlight-languages`,
`--list-highlight-styles`.

Removed list of highlighting languages from `--version`
output.

Removed list of input and output formats from default
`--help` output.

Closes #3173.
2016-10-23 21:35:54 +02:00
John MacFarlane
696dfbc993 Added angle_brackets_escapable extension.
This is needed because github flavored Markdown has a slightly
different set of escapable symbols than original Markdown;
it includes angle brackets.

Closes #2846.
2016-10-22 23:41:55 +02:00
ickc
8b9cce9792 "Merge" MANUAL.txt into README.md (#3167)
* "Merge" MANUAL.txt into README.md

Pull request #3157 without the automatic building from MANUAL.txt to
README.md

* remove contributors in README.md
2016-10-22 22:33:45 +02:00
Albert Krewinkel
595a171407
Add option for top-level division type
The `--chapters` option is replaced with `--top-level-division` which allows
users to specify the type as which top-level headers should be output. Possible
values are `section` (the default), `chapter`, or `part`.

The formats LaTeX, ConTeXt, and Docbook allow `part` as top-level division, TEI
only allows to set the `type` attribute on `div` containers.  The writers are
altered to respect this option in a sensible way.
2016-10-19 13:12:57 +02:00
Oliver Matthews
23fb52ef7d
Add --parts command line option to LaTeX writer.
Add --parts command line argument.
This only effects LaTeX writer, and only for non-beamer output formats.
It changes the output levels so the top level is 'part', the next
'chapter' and then into sections.
2016-09-06 21:43:45 +02:00
John MacFarlane
79d8056acf Document biblio-title variable in MANUAL.txt.
Cloess #258.
2016-10-13 11:57:56 +02:00
John MacFarlane
cbeb72d06b MANUAL: Made formatting of arguments with several options consistent. 2016-10-12 11:15:08 +02:00
John MacFarlane
ced4032a35 Note on --reference-links about --reference-location. 2016-10-12 11:13:28 +02:00
Jesse Rosenthal
afbeba952d MANUAL.txt: document --reference-location. 2016-10-11 22:30:13 -04:00
KolenCheung
a06586a6fd update manual accordingly 2016-10-09 21:30:03 +02:00
John MacFarlane
d8600d6627 Added a small clarification on --webtex with Markdown output.
Thanks to @ickc.
2016-10-06 11:08:52 +02:00
KolenCheung
6613359182 fix typo 2016-10-06 11:04:37 +02:00
KolenCheung
4d621f43d9 Replace Google Chart API by CodeCogs 2016-10-06 11:04:37 +02:00
John MacFarlane
e95047ed85 Markdown reader: added bracket syntax for native spans.
See #168.

Text.Pandoc.Options.Extension has a new constructor `Ext_brackted_spans`,
which is enabled by default in pandoc's Markdown.
2016-09-28 12:33:05 +02:00
John MacFarlane
14a26f99e8 Whitespace fixes. 2016-09-28 11:12:05 +02:00
Jesse Rosenthal
cc5c5c1037 Update MANUAL.txt for new filter behavior. 2016-09-27 12:25:21 -04:00
John MacFarlane
e7c3ea44bd Updated man page and MANUAL date. 2016-09-26 14:25:24 +02:00
John MacFarlane
02e4b7da89 Merge pull request #3071 from tarleb/structured-author-doc
Put note on structured vars in separate paragraph
2016-09-20 11:31:49 +02:00
John MacFarlane
f59dfb8d17 Note in MANUAL that --katex works best with html5.
Closes #3077.
2016-08-20 22:47:12 +02:00
Jesse Rosenthal
84a99af24e MANUAL: fix up custom-style documentation.
* Remove nitty-gritty details about custom-style filters (it won't make
  sense to readers unfamiliar with filters, and would be obvious to
  users already familiar with them).

* Fix a capitalization.
2016-08-20 09:38:15 -04:00
Jesse Rosenthal
3a44ee62c0 MANUAL: fix some whitespace issues. 2016-08-15 19:50:40 -04:00
Jesse Rosenthal
b512573805 Add discussion of custom styles to MANUAL.txt. 2016-08-15 14:22:55 -04:00
Albert Krewinkel
5c4adf9270 Put note on structured vars in separate paragraph
Make it clearer that structured author variables require a custom
template.

Many thanks to John Muccigrosso (@Jmuccigr) for his help in addressing
this issue.

This supersedes and closes #2148.
2016-08-15 16:26:14 +02:00
John MacFarlane
81311a7deb Added themeoptions variable to beamer template (Carsten Gips). 2016-08-11 21:14:26 +02:00
John MacFarlane
cde1f00813 Added beamerarticle variable.
This causes the `beamerarticle` package to be loaded
in beamer, to produce an article from beamer slides.
(Carsten Gips)
2016-08-06 22:43:51 +02:00
Albert Krewinkel
a396003a31 Rename README to MANUAL.txt 2016-07-20 21:16:45 +02:00
Renamed from README (Browse further)