git.iko.soy/typeable/pandoc
on 112e98d help sign in
.circleci/config.yml+122−64
since splitsnapshots
unifiedsplit
@@ -1,72 +1,130 @@
1version: "2.1"
1version: "2.1"
2−jobs:
2+
3− build:
3+env: &env
4− macos:
5− xcode: 11.1.0
6 environment:
4 environment:
7− HOMEBREW_NO_AUTO_UPDATE: 1
5+ LC_ALL: "C.UTF-8"
6+ docker:
7+ - image: fpco/stack-build:lts-13
8+
9+#-----------------------------------------------------------------------------
10+# Common utility stuff, not to be modified usually
11+#-----------------------------------------------------------------------------
12+
13+preinstall: &preinstall
14+ run: |
15+ echo 'export PATH=/opt/cabal/bin:/opt/ghc/bin:$PATH' >> $BASH_ENV
16+ source $BASH_ENV
17+ apt-get update
18+
19+restore: &restore
20+ # Needs to happen after installing ca-certificates
21+ restore_cache:
22+ key: v1-{{ .Environment.CIRCLE_JOB }}-{{ .Branch }}
23+
24+save: &save
25+ save_cache:
26+ key: v1-{{ .Environment.CIRCLE_JOB }}-{{ .Branch }}
27+ paths:
28+ - ~/.cabal
29+ - ~/.ghc
30+ - ~/.local
31+ - ~/.stack
32+
33+commands:
34+ cabal_build:
35+ parameters:
36+ ghcversion:
37+ type: string
8 steps:
38 steps:
9− - checkout
39+ - checkout
10− - restore_cache:
40+ - *preinstall
11− # See https://circleci.com/docs/2.0/caching/
41+ - *restore
12− name: Restore Cached Dependencies
42+ - run:
13− keys:
43+ name: install cabal
14− - stack-dependencies-{{ checksum "stack.yaml" }}
44+ command: apt-get install -y cabal-install-2.4
15− - run:
45+ - run:
16− name: Install stack
46+ name: install ghc
17− command: stack --version || (curl -sSL https://get.haskellstack.org/ | sh -s - -f)
47+ command: |
18− - run:
48+ apt-get install -y ghc-<< parameters.ghcversion >>
19− name: Resolve/Update Dependencies
49+ - run:
20− command: stack --no-terminal setup
50+ name: build and test project
21− - run:
51+ command: |
22− name: Run tests
52+ set -e
23− command: stack --no-terminal test
53+ cabal v2-update
24− - run:
54+ TMPDIR=`mktemp -d -t circleci.XXXXXXX`
25− name: Install executable
55+ cabal v2-sdist --output-dir=${TMPDIR}
26− command: stack --no-terminal install
56+ cd ${TMPDIR}
27− - run:
57+ tar xvzf *.tar.gz
28− name: Create artifacts
58+ cd *
29− command: |
59+ cabal v2-build -w ghc-<< parameters.ghcversion >> -j2 --disable-optimization --dependencies-only --enable-tests --enable-benchmarks
30− export VERSION=$(grep '^[Vv]ersion:' pandoc.cabal | awk '{print $$2;}')
60+ cabal v2-build -w ghc-<< parameters.ghcversion >> -j2 --disable-optimization --enable-tests --enable-benchmarks 2>build.log
31− export ARTIFACTS=macos-release-candidate
61+ cat build.log
32− export RESOURCES=${ARTIFACTS}/Resources
62+ # fail if we had warnings in local build
33− export ROOT=${ARTIFACTS}/pandoc
63+ # this is to work around the fact that cabal v2 doesn't allow
34− export DEST=${ROOT}/usr/local
64+ # us to use -Werror for just local build:
35− export ME=$(whoami)
65+ # https://github.com/haskell/cabal/issues/4247
36− export BASE=pandoc-$VERSION
66+ ! grep -q "[Ww]arning:" build.log
37− mkdir -p ${ARTIFACTS}
67+ cabal v2-test -w ghc-<< parameters.ghcversion >> -j2 --disable-optimization --enable-tests
38− mkdir -p ${RESOURCES}
68+ cabal v2-haddock -w ghc-<< parameters.ghcversion >>
39− mkdir -p ${DEST}/bin
69+ cabal check
40− mkdir -p ${DEST}/share/man/man1
70+ - *save
41− cp ~/.local/bin/pandoc ${DEST}/bin/
42− strip ${DEST}/bin/pandoc
43− cp man/pandoc.1 ${DEST}/share/man/man1/pandoc.1
44− ~/.local/bin/pandoc -s COPYING.md -Vpagetitle=License -o ${RESOURCES}/license.html
45− chown -R $ME:staff ${ROOT}
46− sed -e "s/PANDOCVERSION/${VERSION}/" macos/distribution.xml.in > ${ARTIFACTS}/distribution.xml
47− cp macos/Makefile ${ARTIFACTS}/
48− echo ${VERSION} > ${ARTIFACTS}/version.txt
49− zip -r macos-release-candidate.zip ${ARTIFACTS}
50
71
51− - save_cache:
72+#-----------------------------------------------------------------------------
52− name: Cache Dependencies
73+# Build matrix
53− key: stack-dependencies-{{ checksum "stack.yaml" }}
74+#-----------------------------------------------------------------------------
54− paths:
55− - "/root/.stack"
56− - ".stack-work"
57− - "/usr/local/bin/stack"
58
75
59− - store_artifacts:
76+jobs:
60− # https://circleci.com/docs/2.0/artifacts/
77+ cabal-ghc-8_8_1:
61− path: macos-release-candidate.zip
78+ <<: *env
62− destination: macos-release-candidate.zip
79+ steps:
80+ - cabal_build:
81+ ghcversion: 8.8.1
82+
83+ cabal-ghc-8_6_5:
84+ <<: *env
85+ steps:
86+ - cabal_build:
87+ ghcversion: 8.6.5
88+
89+ cabal-ghc-8_4_4:
90+ <<: *env
91+ steps:
92+ - cabal_build:
93+ ghcversion: 8.4.4
94+
95+ cabal-ghc-8_2_2:
96+ <<: *env
97+ steps:
98+ - cabal_build:
99+ ghcversion: 8.2.2
100+
101+ cabal-ghc-8_0_2:
102+ <<: *env
103+ steps:
104+ - cabal_build:
105+ ghcversion: 8.0.2
106+
107+ stack-ghc-8_6:
108+ <<: *env
109+ steps:
110+ - checkout
111+ - *preinstall
112+ - *restore
113+ - run: |
114+ set -e
115+ apt-get install -y ghc-8.6.5
116+ stack update
117+ stack test --system-ghc --fast --ghc-options="-Werror" .
118+ - *save
63
119
64workflows:
120workflows:
65− version: 2
121+ version: "2.1"
66− release:
122+ build:
67 jobs:
123 jobs:
68− - build:
124+ - cabal-ghc-8_6_5
69− filters:
125+ - cabal-ghc-8_4_4
70− branches:
126+ - cabal-ghc-8_2_2
71− only:
127+ - cabal-ghc-8_0_2
72− - /rc\/.*/
128+ - stack-ghc-8_6
129+ # - cabal-ghc-8_8_1
130+
.editorconfig−8
@@ -8,14 +8,6 @@ indent_size = 2
8insert_final_newline = true
8insert_final_newline = true
9trim_trailing_whitespace = true
9trim_trailing_whitespace = true
10
10
11−[*.{zip,docx}]
12−charset =
13−end_of_line =
14−indent_style =
15−indent_size =
16−insert_final_newline =
17−trim_trailing_whitespace =
18−
19[*.{markdown,md}]
11[*.{markdown,md}]
20trim_trailing_whitespace = false
12trim_trailing_whitespace = false
21
13
.github/ISSUE_TEMPLATEnew file+11
@@ -0,0 +1,11 @@
1+Asking a question?
2+Please use the pandoc-discuss mailing list instead:
3+https://groups.google.com/forum/#!forum/pandoc-discuss
4+This tracker is for bug reports and enhancement requests.
5+
6+Reporting a bug?
7+Please include your pandoc version and an example that allows us
8+to reproduce the problem (complete input, exact command line
9+used, expected and actual output). The smaller the example, the
10+better.
11+
.github/ISSUE_TEMPLATE/bug_report.mddeleted−25
@@ -1,25 +0,0 @@
1−---
2−name: Bug report
3−about: Create a report to help us improve
4−title: ''
5−labels: 'bug'
6−assignees: ''
7−
8−---
9−
10−<!--
11−Thank you for reporting an issue! Before you continue, please make sure that you have
12−
13−- searched the issue tracker for similar issues (including closed issues): https://github.com/jgm/pandoc/issues
14−- searched the pandoc-discuss mailing list for solutions: https://groups.google.com/forum/#!forum/pandoc-discuss
15−- reproduced your issue on the latest release of pandoc, or on https://pandoc.org/try
16−
17−Note that this bug tracker is for reporting bugs, not asking questions. For questions, use the pandoc-discuss mailing list.
18−-->
19−
20−**Explain the problem.**
21−Include the exact command line you used and all inputs necessary to reproduce the issue. Please create as minimal an example as possible, to help the maintainers isolate the problem. Explain the output you received and how it differs from what you expected.
22−
23−**Pandoc version?**
24−What version of pandoc are you using, on what OS?
25−
.github/ISSUE_TEMPLATE/config.ymldeleted−9
@@ -1,9 +0,0 @@
1−blank_issues_enabled: false
2−contact_links:
3− - name: Ask a question
4− url: https://groups.google.com/forum/#!forum/pandoc-discuss
5− about: "Discussion forum for pandoc (may be used as an email list)"
6− - name: Contributing Guidelines
7− url: https://pandoc.org/CONTRIBUTING.html
8− about: "Guidelines for submitting bug reports and code improvements"
9−
.github/ISSUE_TEMPLATE/feature_request.mddeleted−21
@@ -1,21 +0,0 @@
1−---
2−name: Feature request
3−about: Suggest an idea for this project
4−title: ''
5−labels: 'enhancement'
6−assignees: ''
7−
8−---
9−
10−<!--
11−Thank you for suggesting a feature! Before you continue, please make sure that you have
12−
13−- read the contributing guidelines: https://pandoc.org/CONTRIBUTING.html
14−- searched the issue tracker for similar issues (including closed issues): https://github.com/jgm/pandoc/issues
15−- searched the pandoc-discuss mailing list for relevant discussions: https://groups.google.com/forum/#!forum/pandoc-discuss
16−-->
17−
18−**Describe your proposed improvement and the problem it solves.**
19−
20−**Describe alternatives you've considered.**
21−
.github/workflows/ci.yml+49−148
@@ -5,7 +5,7 @@ on:
5 branches:
5 branches:
6 - '*'
6 - '*'
7 - '!rc/*'
7 - '!rc/*'
8− paths-ignore:
8+ ignore-paths:
9 - 'doc/**'
9 - 'doc/**'
10 - 'MANUAL.txt'
10 - 'MANUAL.txt'
11 - '*.md'
11 - '*.md'
@@ -20,7 +20,7 @@ on:
20 - 'windows/**'
20 - 'windows/**'
21 - 'man/**'
21 - 'man/**'
22 pull_request:
22 pull_request:
23− paths-ignore:
23+ ignore-paths:
24 - 'doc/**'
24 - 'doc/**'
25 - 'MANUAL.txt'
25 - 'MANUAL.txt'
26 - '*.md'
26 - '*.md'
@@ -45,53 +45,29 @@ jobs:
45 versions:
45 versions:
46 - ghc: '8.0.2'
46 - ghc: '8.0.2'
47 cabal: '2.4'
47 cabal: '2.4'
48− prefix: 'v2-'
49− cabalopts: ''
50− testopts: ''
51 - ghc: '8.2.2'
48 - ghc: '8.2.2'
52 cabal: '2.4'
49 cabal: '2.4'
53− prefix: 'v2-'
54− cabalopts: ''
55− testopts: ''
56 - ghc: '8.4.4'
50 - ghc: '8.4.4'
57 cabal: '2.4'
51 cabal: '2.4'
58− prefix: 'v2-'
59− cabalopts: '-f-embed_data_files'
60− testopts: ''
61 - ghc: '8.6.5'
52 - ghc: '8.6.5'
62 cabal: '3.2'
53 cabal: '3.2'
63− prefix: ''
64− cabalopts: ''
65− testopts: '--test-option=--hide-successes'
66− - ghc: '8.8.4'
54+ - ghc: '8.8.3'
67 cabal: '3.2'
55 cabal: '3.2'
68− prefix: ''
69− cabalopts: ''
70− testopts: '--test-option=--hide-successes'
71− - ghc: '8.10.4'
56+ - ghc: '8.10.1'
72 cabal: '3.2'
57 cabal: '3.2'
73− prefix: ''
74− cabalopts: '-ftrypandoc'
75− testopts: '--test-option=--hide-successes'
76− - ghc: '9.0.1'
77− cabal: '3.4'
78− prefix: ''
79− cabalopts: ''
80− testopts: '--test-option=--hide-successes'
81 steps:
58 steps:
82− - uses: actions/checkout@v2
59+ - uses: actions/checkout@v1
83−
84− # needed by memory
85− - name: Install numa
86− run: sudo apt-get install libnuma-dev
87
60
88 # need to install older cabal/ghc versions from ppa repository
61 # need to install older cabal/ghc versions from ppa repository
89
62
90 - name: Install recent cabal/ghc
63 - name: Install recent cabal/ghc
91− uses: haskell/actions/setup@v1
64+ run: |
92− with:
65+ if [[ ! -d /opt/ghc/${{ matrix.versions.ghc }} ]]
93− ghc-version: ${{ matrix.versions.ghc }}
66+ then
67+ sudo add-apt-repository ppa:hvr/ghc
68+ sudo apt-get update
94− cabal-version: ${{ matrix.versions.cabal }}
69+ sudo apt-get install ghc-${{ matrix.versions.ghc }} cabal-install-${{ matrix.versions.cabal }}
70+ fi
95
71
96 # declare/restore cached things
72 # declare/restore cached things
97 # caching doesn't work for scheduled runs yet
73 # caching doesn't work for scheduled runs yet
@@ -99,44 +75,41 @@ jobs:
99
75
100 - name: Cache cabal global package db
76 - name: Cache cabal global package db
101 id: cabal-global
77 id: cabal-global
102− uses: actions/cache@v2
78+ uses: actions/cache@v1
103 with:
79 with:
104− path: |
105− ~/.cabal
80+ path: ~/.cabal
106 key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-global-${{ hashFiles('cabal.project') }}
81 key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-global-${{ hashFiles('cabal.project') }}
107
82
108 - name: Cache cabal work
83 - name: Cache cabal work
109 id: cabal-local
84 id: cabal-local
110− uses: actions/cache@v2
85+ uses: actions/cache@v1
111 with:
86 with:
112− path: |
113− dist-newstyle
87+ path: dist-newstyle
114 key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-local
88 key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-local
115
89
116 - name: Install dependencies
90 - name: Install dependencies
117 run: |
91 run: |
118− cabal ${{ matrix.versions.prefix }}update
92+ export PATH=/opt/cabal/${{ matrix.versions.cabal }}/bin:/opt/ghc/${{ matrix.versions.ghc }}/bin:$PATH
93+ cabal v2-update
119− cabal ${{ matrix.versions.prefix }}build ${{ matrix.versions.cabalopts }} --dependencies-only --enable-tests --disable-optimization
94+ cabal v2-build --dependencies-only --enable-tests --disable-optimization
120−
121 - name: Build and test
95 - name: Build and test
122 run: |
96 run: |
97+ export PATH=/opt/cabal/${{ matrix.versions.cabal }}/bin:/opt/ghc/${{ matrix.versions.ghc }}/bin:$PATH
123− cabal ${{ matrix.versions.prefix }}build ${{ matrix.versions.cabalopts }} --enable-tests --disable-optimization 2>&1 | tee build.log
98+ cabal v2-build --enable-tests --disable-optimization 2>&1 | tee build.log
124 # fail if warnings in local build
99 # fail if warnings in local build
125 ! grep -q ": *[Ww]arning:" build.log || exit 1
100 ! grep -q ": *[Ww]arning:" build.log || exit 1
126− cabal ${{ matrix.versions.prefix }}test ${{ matrix.versions.cabalopts }} --disable-optimization ${{ matrix.versions.testopts }}
101+ cabal v2-test --disable-optimization
127
102
128 windows:
103 windows:
129
104
130 runs-on: windows-2019
105 runs-on: windows-2019
131
106
132 steps:
107 steps:
133− - uses: actions/checkout@v2
108+ - uses: actions/checkout@v1
134−
109+ - name: Install stack
135− # We should have ghc 8.10, cabal, stack pre-installed
110+ shell: cmd
136− # - uses: haskell/actions/setup@v1
111+ run: |
137− # with:
112+ choco install haskell-stack
138− # enable-stack: true
139− # stack-version: 'latest'
140
113
141 # declare/restore cached things
114 # declare/restore cached things
142 # caching doesn't work for scheduled runs yet
115 # caching doesn't work for scheduled runs yet
@@ -144,11 +117,10 @@ jobs:
144
117
145 - name: Cache stack global package db
118 - name: Cache stack global package db
146 id: stack-global-package-db
119 id: stack-global-package-db
147− uses: actions/cache@v2
120+ uses: actions/cache@v1
148 with:
121 with:
149− path: |
150− C:\Users\runneradmin\AppData\Roaming\stack\
122+ path: C:\Users\runneradmin\AppData\Roaming\stack\
151− key: ${{ runner.os }}-appdata-roaming-stack-${{ hashFiles('stack.yaml') }}
123+ key: ${{ runner.os }}-appdata-roaming-stack-${{ hashFiles('stack.yaml') }}
152
124
153 # stack's local package dbs for the project and each package
125 # stack's local package dbs for the project and each package
154 # - name: Cache .stack-work
126 # - name: Cache .stack-work
@@ -161,7 +133,6 @@ jobs:
161 - name: Install dependencies
133 - name: Install dependencies
162 run: |
134 run: |
163 stack update
135 stack update
164− stack install happy
165 stack test --dependencies-only --fast
136 stack test --dependencies-only --fast
166 - name: Build and test
137 - name: Build and test
167 shell: cmd
138 shell: cmd
@@ -171,105 +142,35 @@ jobs:
171 macos:
142 macos:
172
143
173 runs-on: macOS-10.15
144 runs-on: macOS-10.15
174− strategy:
175− fail-fast: true
176− matrix:
177− versions:
178− - ghc: '8.8.4'
179− cabal: '3.2'
180
145
181 steps:
146 steps:
182− - uses: actions/checkout@v2
147+ - uses: actions/checkout@v1
183−
148+ - name: Install stack
184− - name: Install recent cabal/ghc
185− uses: haskell/actions/setup@v1
186− with:
187− ghc-version: ${{ matrix.versions.ghc }}
188− cabal-version: ${{ matrix.versions.cabal }}
189−
190− # declare/restore cached things
191− # caching doesn't work for scheduled runs yet
192− # https://github.com/actions/cache/issues/63
193−
194− - name: Cache cabal global package db
195− id: cabal-global
196− uses: actions/cache@v2
197− with:
198− path: |
199− ~/.cabal
200− key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-global-${{ hashFiles('cabal.project') }}
201−
202− - name: Cache cabal work
203− id: cabal-local
204− uses: actions/cache@v2
205− with:
206− path: |
207− dist-newstyle
208− key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-local
209−
210− - name: Install dependencies
211− run: |
212− cabal v2-update
213− cabal v2-build --dependencies-only --enable-tests --disable-optimization
214− - name: Build and test
215 run: |
149 run: |
216− cabal v2-build --enable-tests --disable-optimization 2>&1 | tee build.log
150+ curl -L https://get.haskellstack.org/stable/osx-x86_64.tar.gz -o stack.tar.gz
217− # fail if warnings in local build
151+ tar xzvf stack.tar.gz --strip-components=1 'stack*/stack'
218− ! grep -q ": *[Ww]arning:" build.log || exit 1
219− cabal v2-test --disable-optimization
220−
221− benchmark:
222−
223− runs-on: ubuntu-18.04
224− strategy:
225− fail-fast: true
226− matrix:
227− versions:
228− - ghc: '8.8.4'
229− cabal: '3.2'
230− - ghc: '8.10.2'
231− cabal: '3.2'
232− steps:
233− - uses: actions/checkout@v2
234−
235− # need to install older cabal/ghc versions from ppa repository
236−
237− - name: Install recent cabal/ghc
238− uses: haskell/actions/setup@v1
239− with:
240− ghc-version: ${{ matrix.versions.ghc }}
241− cabal-version: ${{ matrix.versions.cabal }}
242
152
243 # declare/restore cached things
153 # declare/restore cached things
244− # caching doesn't work for scheduled runs yet
154+ # caching doesn't work for scheduled runs yet https://github.com/actions/cache/issues/63
245− # https://github.com/actions/cache/issues/63
246
155
247− - name: Cache cabal global package db
156+ - name: Cache stack global package db
248− id: cabal-global
157+ id: stack-global
249− uses: actions/cache@v2
158+ uses: actions/cache@v1
250 with:
159 with:
251− path: |
160+ path: ~/.stack
252− ~/.cabal
253− key: benchmark-${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-global-${{ hashFiles('cabal.project') }}
161+ key: ${{ runner.os }}-stack-global-${{ hashFiles('stack.yaml') }}
254
162
163+ # stack's local package db
255− - name: Cache cabal work
164+ # - name: Cache .stack-work
256− id: cabal-local
257− uses: actions/cache@v2
165+ # uses: actions/cache@v1
258− with:
166+ # with:
259− path: |
167+ # path: .stack-work
260− dist-newstyle
168+ # key: ${{ runner.os }}-stack-work
261− key: benchmark-${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-local
262
169
263 - name: Install dependencies
170 - name: Install dependencies
264 run: |
171 run: |
265− v2=$([ "${{ matrix.versions.cabal }}" = "2.2" ] && printf 'new' || printf 'v2')
266− cabal $v2-update
172+ ./stack update
267− cabal $v2-build --dependencies-only --enable-optimization=1 --enable-benchmarks --disable-tests
173+ ./stack test --dependencies-only --fast
268−
269 - name: Build and test
174 - name: Build and test
270 run: |
175 run: |
271− v2=$([ "${{ matrix.versions.cabal }}" = "2.2" ] && printf 'new' || printf 'v2')
176+ ./stack test --fast --test-arguments=--hide-successes
272− cabal $v2-build --enable-optimization=1 --enable-benchmarks --disable-tests 2>&1 | tee build.log
273− # fail if warnings in local build
274− ! grep -q ": *[Ww]arning:" build.log || exit 1
275− cabal $v2-bench --enable-optimization=1 --benchmark-options='--timeout=6 +RTS -T -RTS'
.github/workflows/format-validation.ymldeleted−88
@@ -1,88 +0,0 @@
1−name: Format validation
2−
3−on:
4− push:
5− branches:
6− - '*'
7− - '!rc/*'
8− paths:
9− - 'test/writer.jats_articleauthoring'
10− - 'test/writer.jats_publishing'
11− - 'test/writer.jats_archiving'
12− - 'test/tables.jats_archiving'
13− - 'test/tables/nordics.jats_archiving'
14− - 'test/tables/planets.jats_archiving'
15− - 'test/tables/students.jats_archiving'
16− pull_request:
17− branches:
18− - '*'
19− - '!rc/*'
20− paths:
21− - 'test/writer.jats_articleauthoring'
22− - 'test/writer.jats_publishing'
23− - 'test/writer.jats_archiving'
24− - 'test/tables.jats_archiving'
25− - 'test/tables/nordics.jats_archiving'
26− - 'test/tables/planets.jats_archiving'
27− - 'test/tables/students.jats_archiving'
28−
29−jobs:
30− jats:
31− name: JATS
32− runs-on: ubuntu-latest
33− env:
34− VALIDATOR_URL: "https://jats-validator.hubmed.org/dtd/"
35− strategy:
36− fail-fast: false
37− matrix:
38− tagset:
39− - articleauthoring
40− - publishing
41− - archiving
42− steps:
43− - name: Checkout
44− uses: actions/checkout@v2
45−
46− - name: Validate writer output
47− run: |
48− filename=test/writer.jats_${{ matrix.tagset }}
49− printf "Validating file %s\n" "$filename"
50− json="$(curl --form "xml=@${filename}" --silent "$VALIDATOR_URL")"
51− err_count="$(printf '%s' "$json" | jq '.errors | length')"
52− if [ "$err_count" -eq 0 ]; then
53− printf "File was validated successfully.\n"
54− exit 0
55− else
56− printf "Validator report:\n%s" "$json"
57− exit 1
58− fi
59−
60− - name: Validate tables
61− # Archiving has the simplest template, so we only check with that.
62− if: matrix.tagset == 'archiving'
63− run: |
64− tmpl="$(cat <<EOF
65− <?xml version="1.0" encoding="utf-8" ?>
66− <!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Archiving and Interchange DTD v1.2 20190208//EN"
67− "JATS-archivearticle1.dtd">
68− <article xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink" dtd-version="1.2" article-type="other">
69− <front><article-meta></article-meta></front>
70− <body>%s</body></article>
71− EOF
72− )"
73− jats_file="$(mktemp jats-tables.XXXXX)"
74− exit_code=0
75− for f in tables tables/nordics tables/planets tables/students; do
76− filename=test/$f.jats_archiving
77− printf "Validating %s...\n" "$filename"
78− printf "$tmpl" "$(cat $filename)" > "$jats_file"
79− json="$(curl --form "xml=@${jats_file}" --silent "$VALIDATOR_URL")"
80− err_count="$(printf "%s" "$json" | jq '.errors | length')"
81− if [ "$err_count" -eq 0 ]; then
82− printf "Table output is valid when used as body content.\n"
83− else
84− printf "Validator report:\n%s" "$json"
85− exit_code=1
86− fi
87− done
88− exit "$exit_code"
.github/workflows/lint.ymldeleted−33
@@ -1,33 +0,0 @@
1−name: Lint
2−
3−# Trigger the workflow on push or pull request, but only for the
4−# master branch
5−on:
6− pull_request:
7− branch: [master]
8− push:
9− branch: [master]
10− paths-ignore:
11− - LICENSE
12− - README.md
13− - CHANGELOG.md
14− - stack.yaml
15− - .travis.yml
16−
17−jobs:
18− lint:
19− name: Lint
20− runs-on: ubuntu-latest
21− env:
22− hlint_script: https://raw.github.com/ndmitchell/hlint/master/misc/run.sh
23−
24− steps:
25− - name: Checkout
26− uses: actions/checkout@v2
27−
28− - name: Check cabal file for missing test files
29− run: make check-cabal
30−
31− - name: Download and run hlint
32− run: |
33− curl -sSL "${hlint_script}" | sh -s .
.github/workflows/nightly.yml+26−18
@@ -2,36 +2,35 @@ name: Nightly
2
2
3on:
3on:
4 schedule:
4 schedule:
5− - cron: '53 7 * * *'
5+ - cron: '53 6 * * *'
6
6
7jobs:
7jobs:
8 linux:
8 linux:
9
9
10 runs-on: ubuntu-18.04
10 runs-on: ubuntu-18.04
11 steps:
11 steps:
12− - uses: actions/checkout@v2
12+ - uses: actions/checkout@v1
13−
14− - name: Install recent cabal/ghc
15− uses: haskell/actions/setup@v1
16− with:
17− ghc-version: '8.10.3'
18− cabal-version: '3.2'
19−
20 - name: Install dependencies
13 - name: Install dependencies
21 run: |
14 run: |
15+ export PATH=/opt/cabal/3.2/bin:/opt/ghc/8.8.3/bin:$PATH
16+ ls /opt/cabal/*/bin
17+ ls /opt/ghc/*/bin
22 ghc --version
18 ghc --version
23 cabal --version
19 cabal --version
24 cabal v2-update
20 cabal v2-update
25− cabal v2-build --dependencies-only
21+ cabal v2-build --dependencies-only . pandoc-citeproc
26 - name: Build
22 - name: Build
27 run: |
23 run: |
24+ export PATH=/opt/cabal/3.2/bin:/opt/ghc/8.8.3/bin:$PATH
28− cabal v2-install
25+ cabal v2-install . pandoc-citeproc
29 strip $HOME/.cabal/bin/pandoc
26 strip $HOME/.cabal/bin/pandoc
27+ strip $HOME/.cabal/bin/pandoc-citeproc
30 - name: Install artifact
28 - name: Install artifact
31 run: |
29 run: |
32 export ARTIFACTS=nightly-linux/pandoc-nightly-linux-$(date +%Y-%m-%d)
30 export ARTIFACTS=nightly-linux/pandoc-nightly-linux-$(date +%Y-%m-%d)
33 mkdir -p ${ARTIFACTS}
31 mkdir -p ${ARTIFACTS}
34 cp $HOME/.cabal/bin/pandoc ${ARTIFACTS}/
32 cp $HOME/.cabal/bin/pandoc ${ARTIFACTS}/
33+ cp $HOME/.cabal/bin/pandoc-citeproc ${ARTIFACTS}/
35 cp COPYRIGHT ${ARTIFACTS}/
34 cp COPYRIGHT ${ARTIFACTS}/
36 echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
35 echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
37 - uses: actions/upload-artifact@master
36 - uses: actions/upload-artifact@master
@@ -44,18 +43,22 @@ jobs:
44 runs-on: windows-2019
43 runs-on: windows-2019
45
44
46 steps:
45 steps:
47− - uses: actions/checkout@v2
46+ - uses: actions/checkout@v1
47+ - name: Install stack
48+ shell: cmd
49+ run: |
50+ choco install haskell-stack
48 - name: Install dependencies
51 - name: Install dependencies
49 run: |
52 run: |
50 stack update
53 stack update
51− stack build --dependencies-only pandoc
54+ stack build --dependencies-only pandoc pandoc-citeproc
52 - name: Build artifacts
55 - name: Build artifacts
53 shell: cmd
56 shell: cmd
54 run: |
57 run: |
55 for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
58 for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
56 set ARTIFACTS=%CD%\nightly-windows\pandoc-nightly-windows-%THEDATE%
59 set ARTIFACTS=%CD%\nightly-windows\pandoc-nightly-windows-%THEDATE%
57 mkdir %ARTIFACTS%
60 mkdir %ARTIFACTS%
58− stack build pandoc
61+ stack build pandoc pandoc-citeproc
59 forfiles /P .\.stack-work\install /M pandoc*.exe /S /C "cmd /C copy @path %%ARTIFACTS%%"
62 forfiles /P .\.stack-work\install /M pandoc*.exe /S /C "cmd /C copy @path %%ARTIFACTS%%"
60 copy COPYRIGHT %ARTIFACTS%
63 copy COPYRIGHT %ARTIFACTS%
61 ren %ARTIFACTS%\COPYRIGHT COPYRIGHT.txt
64 ren %ARTIFACTS%\COPYRIGHT COPYRIGHT.txt
@@ -70,18 +73,23 @@ jobs:
70 runs-on: macOS-10.15
73 runs-on: macOS-10.15
71
74
72 steps:
75 steps:
73− - uses: actions/checkout@v2
76+ - uses: actions/checkout@v1
77+ - name: Install stack
78+ run: |
79+ curl -L https://get.haskellstack.org/stable/osx-x86_64.tar.gz -o stack.tar.gz
80+ tar xzvf stack.tar.gz --strip-components=1 'stack*/stack'
74 - name: Install dependencies
81 - name: Install dependencies
75 run: |
82 run: |
76− stack update
83+ ./stack update
77− stack build --dependencies-only pandoc
84+ ./stack build --dependencies-only pandoc pandoc-citeproc
78 - name: Build artifacts
85 - name: Build artifacts
79 run: |
86 run: |
80 export ARTIFACTS=nightly-macos/pandoc-nightly-macos-$(date +%Y-%m-%d)
87 export ARTIFACTS=nightly-macos/pandoc-nightly-macos-$(date +%Y-%m-%d)
81 mkdir -p ${ARTIFACTS}
88 mkdir -p ${ARTIFACTS}
82− stack build pandoc
89+ ./stack build pandoc pandoc-citeproc
83 for f in $(find .stack-work/install -name 'pandoc*' -perm +001 -type f); do cp $f ${ARTIFACTS}/; done
90 for f in $(find .stack-work/install -name 'pandoc*' -perm +001 -type f); do cp $f ${ARTIFACTS}/; done
84 mv ${ARTIFACTS}/pandoc ${ARTIFACTS}/pandoc
91 mv ${ARTIFACTS}/pandoc ${ARTIFACTS}/pandoc
92+ mv ${ARTIFACTS}/pandoc-citeproc ${ARTIFACTS}/pandoc-citeproc
85 cp COPYRIGHT ${ARTIFACTS}/
93 cp COPYRIGHT ${ARTIFACTS}/
86 echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
94 echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
87 - uses: actions/upload-artifact@master
95 - uses: actions/upload-artifact@master
.github/workflows/release-candidate.yml+62−5
@@ -17,7 +17,7 @@ jobs:
17 mkdir linux-release-candidate
17 mkdir linux-release-candidate
18 cp linux/artifacts/*.deb linux-release-candidate/
18 cp linux/artifacts/*.deb linux-release-candidate/
19 cp linux/artifacts/*.tar.gz linux-release-candidate/
19 cp linux/artifacts/*.tar.gz linux-release-candidate/
20− - uses: actions/upload-artifact@v2
20+ - uses: actions/upload-artifact@master
21 with:
21 with:
22 name: linux-release-candidate
22 name: linux-release-candidate
23 path: linux-release-candidate
23 path: linux-release-candidate
@@ -31,18 +31,28 @@ jobs:
31 versions:
31 versions:
32 - osarch: "windows-x86_64"
32 - osarch: "windows-x86_64"
33 arch: "x64"
33 arch: "x64"
34+ choco_opts: ""
34 stack_opts: "-j1"
35 stack_opts: "-j1"
36+ - osarch: "windows-i386"
37+ arch: "x86"
38+ choco_opts: "--x86"
39+ stack_opts: "-j1 --flag hslua:lua_32bits"
40+
35 steps:
41 steps:
36 - uses: actions/checkout@v1
42 - uses: actions/checkout@v1
43+ - name: Install stack
44+ shell: cmd
45+ run: |
46+ choco install haskell-stack ${{ matrix.versions.choco_opts }}
37 - name: Install dependencies
47 - name: Install dependencies
38 run: |
48 run: |
39 stack update
49 stack update
40− stack build ${{ matrix.versions.stack_opts }} --dependencies-only pandoc
50+ stack build ${{ matrix.versions.stack_opts }} --dependencies-only pandoc pandoc-citeproc
41 - name: Create windows package
51 - name: Create windows package
42 shell: cmd
52 shell: cmd
43 run: |
53 run: |
44 for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
54 for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
45− stack build ${{ matrix.versions.stack_opts }} pandoc
55+ stack build ${{ matrix.versions.stack_opts }} pandoc pandoc-citeproc
46 for /f "tokens=1-2 delims= " %%a in ('stack exec pandoc -- --version') do (
56 for /f "tokens=1-2 delims= " %%a in ('stack exec pandoc -- --version') do (
47 @set VERSION=%%b
57 @set VERSION=%%b
48 goto :next
58 goto :next
@@ -56,7 +66,7 @@ jobs:
56 @set WINDOWS=%CD%\windows
66 @set WINDOWS=%CD%\windows
57 @set RELEASE=%WINDOWS%\pandoc-%VERSION%
67 @set RELEASE=%WINDOWS%\pandoc-%VERSION%
58 mkdir %RELEASE%
68 mkdir %RELEASE%
59− forfiles /P .\.stack-work\install /M pandoc.exe /S /C "cmd /C echo @path && echo %%WINDOWS%% && copy @path %%RELEASE%%"
69+ forfiles /P .\.stack-work\install /M pandoc*.exe /S /C "cmd /C echo @path && echo %%WINDOWS%% && copy @path %%RELEASE%%"
60 stack exec pandoc -- -s --toc MANUAL.txt -o %RELEASE%\MANUAL.html
70 stack exec pandoc -- -s --toc MANUAL.txt -o %RELEASE%\MANUAL.html
61 stack exec pandoc -- -s COPYING.md -t rtf -o %RELEASE%\COPYING.rtf
71 stack exec pandoc -- -s COPYING.md -t rtf -o %RELEASE%\COPYING.rtf
62 copy %RELEASE%\COPYING.rtf %WINDOWS%
72 copy %RELEASE%\COPYING.rtf %WINDOWS%
@@ -77,7 +87,54 @@ jobs:
77 copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}-UNSIGNED.msi windows-release-candidate
87 copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}-UNSIGNED.msi windows-release-candidate
78 copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}.zip windows-release-candidate
88 copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}.zip windows-release-candidate
79 copy windows\Makefile windows-release-candidate
89 copy windows\Makefile windows-release-candidate
80− - uses: actions/upload-artifact@v2
90+ - uses: actions/upload-artifact@master
81 with:
91 with:
82 name: windows-release-candidate
92 name: windows-release-candidate
83 path: windows-release-candidate
93 path: windows-release-candidate
94+
95+ macos:
96+
97+ runs-on: macOS-10.15
98+
99+ steps:
100+ - uses: actions/checkout@v1
101+ - name: Install stack
102+ run: |
103+ curl -L https://get.haskellstack.org/stable/osx-x86_64.tar.gz -o stack.tar.gz
104+ tar xzvf stack.tar.gz --strip-components=1 'stack*/stack'
105+ - name: Install dependencies
106+ run: |
107+ ./stack update
108+ ./stack build --dependencies-only pandoc pandoc-citeproc
109+ - name: Create macOS package
110+ run: |
111+ export VERSION=$(grep '^[Vv]ersion:' pandoc.cabal | awk '{print $$2;}')
112+ export BASEDIR=$(pwd)
113+ export ARTIFACTS=${BASEDIR}/macos-release-candidate
114+ export RESOURCES=${ARTIFACTS}/Resources
115+ export ROOT=${ARTIFACTS}/pandoc
116+ export DEST=${ROOT}/usr/local
117+ export ME=$(whoami)
118+ export BASE=pandoc-$VERSION
119+ mkdir -p ${ARTIFACTS}
120+ mkdir -p ${RESOURCES}
121+ mkdir -p ${DEST}/bin
122+ mkdir -p ${DEST}/share/man/man1
123+ ./stack build pandoc pandoc-citeproc
124+ for f in $(find .stack-work/install -name 'pandoc*' -perm +001 -type f); do cp $f ${DEST}/bin/; done
125+ strip ${DEST}/bin/pandoc
126+ strip ${DEST}/bin/pandoc-citeproc
127+ cp man/pandoc.1 ${DEST}/share/man/man1/pandoc.1
128+ ${DEST}/bin/pandoc-citeproc --man > \
129+ $DEST/share/man/man1/pandoc-citeproc.1
130+ ${DEST}/bin/pandoc -t html5 -s COPYING.md -Vpagetitle=License \
131+ -o ${RESOURCES}/license.html
132+ chown -R $ME:staff ${ROOT}
133+ sed -e "s/PANDOCVERSION/${VERSION}/" macos/distribution.xml.in > ${ARTIFACTS}/distribution.xml
134+ cp macos/Makefile ${ARTIFACTS}/
135+ echo ${VERSION} > ${ARTIFACTS}/version.txt
136+ - uses: actions/upload-artifact@master
137+ with:
138+ name: macos-release-candidate
139+ path: macos-release-candidate
140+
.gitignore−8
@@ -1,6 +1,4 @@
1*~
1*~
2−.DS_Store
3−*.orig
4deb/.vagrant
2deb/.vagrant
5dist/*
3dist/*
6MANUAL.*
4MANUAL.*
@@ -16,10 +14,6 @@ man/man?/*.html
16*.o
14*.o
17*.hi
15*.hi
18*.pyc
16*.pyc
19−.hie/
20−.policeman-evidence/
21−.projectile/
22−.vscode/
23/COPYING.rtf
17/COPYING.rtf
24/COPYRIGHT.txt
18/COPYRIGHT.txt
25/cabal-dev/
19/cabal-dev/
@@ -29,7 +23,5 @@ windows/*.wixobj
29data/reference.docx
23data/reference.docx
30data/reference.odt
24data/reference.odt
31.stack-work
25.stack-work
32−/stack.yaml.lock
33cabal.project.local
26cabal.project.local
34/dist-newstyle/
27/dist-newstyle/
35−pandoc-2*/
.hlint.yaml+54−83
@@ -2,111 +2,82 @@
2# https://github.com/ndmitchell/hlint
2# https://github.com/ndmitchell/hlint
3##########################
3##########################
4
4
5+# This file contains a template configuration file, which is typically
6+# placed as .hlint.yaml in the root of your project
7+
8+
5# Specify additional command line arguments
9# Specify additional command line arguments
6#
10#
7−- arguments: [--color=auto, --cpp-ansi]
11+- arguments: [--color, --cpp-ansi]
8
12
9−# Ignore some builtin hints
13+
14+# Control which extensions/flags/modules/functions can be used
15+#
16+# - extensions:
17+# - default: false # all extension are banned by default
18+# - name: [PatternGuards, ViewPatterns] # only these listed extensions can be used
19+# - {name: CPP, within: CrossPlatform} # CPP can only be used in a given module
20+#
21+# - flags:
22+# - {name: -w, within: []} # -w is allowed nowhere
23+#
24+# - modules:
25+# - {name: [Data.Set, Data.HashSet], as: Set} # if you import Data.Set qualified, it must be as 'Set'
26+# - {name: Control.Arrow, within: []} # Certain modules are banned entirely
27+#
28+# - functions:
29+# - {name: unsafePerformIO, within: []} # unsafePerformIO can only appear in no modules
30+
31+
32+# Add custom hints for this project
33+#
34+# Will suggest replacing "wibbleMany [myvar]" with "wibbleOne myvar"
35+# - error: {lhs: "wibbleMany [x]", rhs: wibbleOne x}
36+
37+
38+# Turn on hints that are off by default
39+#
40+# Ban "module X(module X) where", to require a real export list
41+# - warn: {name: Use explicit module export list}
10#
42#
43+# Replace a $ b $ c with a . b $ c
44+# - group: {name: dollar, enabled: true}
45+#
46+# Generalise map to fmap, ++ to <>
47+# - group: {name: generalise, enabled: true}
48+
49+
50+# Ignore some builtin hints
51+# - ignore: {name: Use let}
52+# - ignore: {name: Use const, within: SpecialModule} # Only within certain modules
53+# - ignore: {name: "Use section"}
54+# - ignore: {name: "Use camelCase"}
55+# - ignore: {name: "Use list comprehension"}
56+# - ignore: {name: "Redundant if"}
11- ignore: {name: "Avoid lambda"}
57- ignore: {name: "Avoid lambda"}
12−- ignore: {name: "Use bimap"}
13- ignore: {name: "Eta reduce"}
58- ignore: {name: "Eta reduce"}
14- ignore: {name: "Evaluate"}
59- ignore: {name: "Evaluate"}
15−- ignore: {name: "Reduce duplication"} # TODO: could be more fine-grained
60+- ignore: {name: "Monad law, left identity", module: "Text.Pandoc.App.OutputSettings"}
61+- ignore: {name: "Reduce duplication", module: "Text.Pandoc.Readers.Markdown"}
16- ignore: {name: "Use &&&"}
62- ignore: {name: "Use &&&"}
17- ignore: {name: "Use String"}
63- ignore: {name: "Use String"}
18−- ignore: {name: "Use camelCase"}
19- ignore: {name: "Use fmap"} # specific for GHC 7.8 compat
64- ignore: {name: "Use fmap"} # specific for GHC 7.8 compat
65+- ignore: {name: "Use forM_", module: "Text.Pandoc.Readers.DocBook"}
20- ignore: {name: "Use isDigit"}
66- ignore: {name: "Use isDigit"}
21−
67+- ignore: {name: "Use tuple-section", module: "Text.Pandoc.Readers.EPUB"}
22−- ignore:
23− name: "Monad law, left identity"
24− within: Text.Pandoc.App.OutputSettings
25−
26−- ignore:
27− name: "Move brackets to avoid $"
28− within: Text.Pandoc.Writers.CslJson
29−
30−- ignore:
31− name: "Redundant <$>"
32− within:
33− - Text.Pandoc.Readers.Docx.Parse
68+- ignore: {name: "Use uncurry", module: "Text.Pandoc.Readers.Docx.Combine"}
34− - Text.Pandoc.Writers.MediaWiki
35− - Text.Pandoc.Writers.OpenDocument
36− - Text.Pandoc.Writers.Powerpoint.Output
37− - Text.Pandoc.Writers.Powerpoint.Presentation
38−
39−- ignore:
40− name: "Redundant return"
41− within: Text.Pandoc.Citeproc.BibTeX
42−
43−# With recent hlint this rule has given false positives on TH
44−- ignore:
45− name: "Redundant bracket"
46−
47−
48- ignore:
69- ignore:
49 name: "Use <$>"
70 name: "Use <$>"
50 within:
71 within:
51 - Text.Pandoc.Readers.LaTeX
72 - Text.Pandoc.Readers.LaTeX
52 - Text.Pandoc.Readers.Markdown
73 - Text.Pandoc.Readers.Markdown
53−
54- ignore:
74- ignore:
55 name: "Use camelCase"
75 name: "Use camelCase"
56 within:
76 within:
57− - Tests.Writers.Docbook
58− - Tests.Writers.Native
59− - Text.Pandoc.Citeproc
60 - Text.Pandoc.Extensions
77 - Text.Pandoc.Extensions
61− - Text.Pandoc.Lua.Marshaling.Version
78+ - Text.Pandoc.Lua.Marshalling.Version
62− - Text.Pandoc.Lua.Module.Pandoc
63− - Text.Pandoc.Lua.Module.Utils
64 - Text.Pandoc.Readers.Odt.ContentReader
79 - Text.Pandoc.Readers.Odt.ContentReader
65 - Text.Pandoc.Readers.Odt.Namespaces
80 - Text.Pandoc.Readers.Odt.Namespaces
66
81
67−- ignore:
68− name: "Use forM_"
69− within:
70− - Text.Pandoc.Readers.DocBook
71−
72−- ignore:
73− name: "Use Just"
74− within:
75− - Text.Pandoc.Citeproc.MetaValue
76− - Text.Pandoc.Readers.Odt.ContentReader
77− - Text.Pandoc.Writers.Roff
78−
79−- ignore:
80− name: "Use list comprehension"
81− within: Text.Pandoc.Citeproc.BibTeX
82−
83−- ignore:
84− name: "Use list literal pattern"
85− within: Text.Pandoc.Citeproc.MetaValue
86−
87−# TODO: check
88−- ignore:
89− name: "Use second"
90− within:
91− - Text.Pandoc.Citeproc.BibTeX
92− - Text.Pandoc.Citeproc.Locator
93−
94−# TODO: check
95−- ignore:
96− name: "Use sortOn"
97− within: Text.Pandoc.Writers.OpenDocument
98−
99−- ignore:
100− name: "Use tuple-section"
101− within:
102− - Text.Pandoc.Readers.EPUB
103− - Text.Pandoc.ImageSize
104− - Text.Pandoc.Readers.Markdown
105− - Text.Pandoc.Readers.RST
106−
107−# fromRight is only in base >= 4.10
108−- ignore:
109− name: "Use fromRight"
110−
111# Define some custom infix operators
82# Define some custom infix operators
112# - fixity: infixr 3 ~^#^~
83# - fixity: infixr 3 ~^#^~
AUTHORS.md−57
@@ -1,13 +1,11 @@
1# Contributors
1# Contributors
2
2
3- Anabra
3- Anabra
4−- Aner Lucero
5- Arata Mizuki
4- Arata Mizuki
6- Arfon Smith
5- Arfon Smith
7- Aaron Wolen
6- Aaron Wolen
8- Albert Krewinkel
7- Albert Krewinkel
9- Alex Ivkin
8- Alex Ivkin
10−- Alex Toldaiev
11- Alex Vong
9- Alex Vong
12- Alexander Kondratskiy
10- Alexander Kondratskiy
13- Alexander Krotov
11- Alexander Krotov
@@ -19,8 +17,6 @@
19- Anders Waldenborg
17- Anders Waldenborg
20- Andreas Lööw
18- Andreas Lööw
21- Andrew Dunning
19- Andrew Dunning
22−- Andy Morris
23−- Anti-Distinctlyminty
24- Antoine Latter
20- Antoine Latter
25- Antonio Terceiro
21- Antonio Terceiro
26- Arata Mizuki
22- Arata Mizuki
@@ -35,8 +31,6 @@
35- Beni Cherniavsky-Paskin
31- Beni Cherniavsky-Paskin
36- Benoit Schweblin
32- Benoit Schweblin
37- Bjorn Buckwalter
33- Bjorn Buckwalter
38−- Blake Eryx
39−- Bodigrim
40- Bradley Kuhn
34- Bradley Kuhn
41- Brent Yorgey
35- Brent Yorgey
42- Brian Leung
36- Brian Leung
@@ -45,9 +39,6 @@
45- Caleb Mclennan
39- Caleb Mclennan
46- Calvin Beck
40- Calvin Beck
47- Carlos Sosa
41- Carlos Sosa
48−- Cécile Chemin
49−- Cédric Couralet
50−- Charanjit Singh
51- Chris Black
42- Chris Black
52- Christian Conkle
43- Christian Conkle
53- Christian Despres
44- Christian Despres
@@ -65,23 +56,16 @@
65- Daniele D'Orazio
56- Daniele D'Orazio
66- David A Roberts
57- David A Roberts
67- David Lazar
58- David Lazar
68−- David Martschenko
69- David Röthlisberger
59- David Röthlisberger
70- Denis Laxalde
60- Denis Laxalde
71- Denis Maier
61- Denis Maier
72- Derek Chen-Becker
62- Derek Chen-Becker
73−- Diego Balseiro
74−- Dimitri Sabadie
75- Dmitry Pogodin
63- Dmitry Pogodin
76−- Dmitry Volodin
77- Douglas Calvert
64- Douglas Calvert
78- Eigil Rischel
65- Eigil Rischel
79- Emanuel Evans
66- Emanuel Evans
80−- Emerson Harkin
81−- Emily Bourke
82- Emily Eisenberg
67- Emily Eisenberg
83- Eric Kow
68- Eric Kow
84−- Erik Rask
85- Eric Seidel
69- Eric Seidel
86- Eric Schrijver
70- Eric Schrijver
87- Ethan Riley
71- Ethan Riley
@@ -91,7 +75,6 @@
91- Florian Beeres
75- Florian Beeres
92- Florian Eitel
76- Florian Eitel
93- Florian Klink
77- Florian Klink
94−- Florian Kohrt
95- Francesco Occhipinti
78- Francesco Occhipinti
96- François Gannaz
79- François Gannaz
97- Frederik Elwert
80- Frederik Elwert
@@ -114,7 +97,6 @@
114- Hubert Plociniczak
97- Hubert Plociniczak
115- Ian Max Andolina
98- Ian Max Andolina
116- Igor Khorlo
99- Igor Khorlo
117−- Igor Pashev
118- Ilya V. Portnov
100- Ilya V. Portnov
119- Ivan Trubach
101- Ivan Trubach
120- Ivo Clarysse
102- Ivo Clarysse
@@ -122,13 +104,11 @@
122- J. B. Rainsberger
104- J. B. Rainsberger
123- J. Lewis Muir
105- J. Lewis Muir
124- Jaime Marquínez Ferrándiz
106- Jaime Marquínez Ferrándiz
125−- Jake Zimmerman
126- Jakob Voß
107- Jakob Voß
127- James Aspnes
108- James Aspnes
128- Jamie F. Olson
109- Jamie F. Olson
129- Jan Larres
110- Jan Larres
130- Jan Schulz
111- Jan Schulz
131−- Jan Tojnar
132- Jan-Otto Kröpke
112- Jan-Otto Kröpke
133- Jason Ronallo
113- Jason Ronallo
134- Jeff Arnold
114- Jeff Arnold
@@ -136,7 +116,6 @@
136- Jens Getreu
116- Jens Getreu
137- Jens Petersen
117- Jens Petersen
138- Jeroen de Haas
118- Jeroen de Haas
139−- Jerry Sky
140- Jesse Rosenthal
119- Jesse Rosenthal
141- Joe Hermaszewski
120- Joe Hermaszewski
142- Joe Hillenbrand
121- Joe Hillenbrand
@@ -152,8 +131,6 @@
152- Josef Svenningsson
131- Josef Svenningsson
153- Joseph C. Sible
132- Joseph C. Sible
154- Julien Cretel
133- Julien Cretel
155−- Julien Dutant
156−- Juliette Fourcot
157- Juliusz Gonera
134- Juliusz Gonera
158- Justin Bogner
135- Justin Bogner
159- Jérémy Bobbio
136- Jérémy Bobbio
@@ -166,13 +143,7 @@
166- Krystof Beuermann
143- Krystof Beuermann
167- Herwig Stuetz
144- Herwig Stuetz
168- Lars-Dominik Braun
145- Lars-Dominik Braun
169−- Laurent P. René de Cotret
170- Leif Metcalf
146- Leif Metcalf
171−- Leonard Rosenthol
172−- Lila
173−- Loïc Grobol
174−- Lorenzo
175−- Lucas Escot
176- Luke Plant
147- Luke Plant
177- Marc Schreiber
148- Marc Schreiber
178- Mark Szepieniec
149- Mark Szepieniec
@@ -182,7 +153,6 @@
182- Matej Kollar
153- Matej Kollar
183- Mathias Schenner
154- Mathias Schenner
184- Mathias Walter
155- Mathias Walter
185−- Mathieu Boespflug
186- Mathieu Duponchelle
156- Mathieu Duponchelle
187- Matthew Doty
157- Matthew Doty
188- Matthew Eddey
158- Matthew Eddey
@@ -194,9 +164,7 @@
194- Merijn Verstraaten
164- Merijn Verstraaten
195- Michael Beaumont
165- Michael Beaumont
196- Michael Chladek
166- Michael Chladek
197−- Michael Hoffmann
198- Michael Peyton Jones
167- Michael Peyton Jones
199−- Michael Reed
200- Michael Snoyman
168- Michael Snoyman
201- Michael Thompson
169- Michael Thompson
202- Mike Tzou
170- Mike Tzou
@@ -205,12 +173,10 @@
205- Nathan Gass
173- Nathan Gass
206- Neil Mayhew
174- Neil Mayhew
207- Nick Bart
175- Nick Bart
208−- Nick Berendsen
209- Nick Fleisher
176- Nick Fleisher
210- Nicolas Kaiser
177- Nicolas Kaiser
211- Nikolay Yakimov
178- Nikolay Yakimov
212- Nils Carlson
179- Nils Carlson
213−- Nixon Enraght-Moony
214- Nokome Bentley
180- Nokome Bentley
215- Ole Martin Ruud
181- Ole Martin Ruud
216- Oliver Matthews
182- Oliver Matthews
@@ -235,9 +201,7 @@
235- Raymond Ehlers
201- Raymond Ehlers
236- Recai Oktaş
202- Recai Oktaş
237- Roland Hieber
203- Roland Hieber
238−- Roman Beránek
239- RyanGlScott
204- RyanGlScott
240−- Salim B
241- Sascha Wilde
205- Sascha Wilde
242- Scott Morrison
206- Scott Morrison
243- Sebastian Talmon
207- Sebastian Talmon
@@ -246,14 +210,12 @@
246- Shahbaz Youssefi
210- Shahbaz Youssefi
247- Shaun Attfield
211- Shaun Attfield
248- Shim Myeongseob
212- Shim Myeongseob
249−- Shin Sang-jae
250- Sidarth Kapur
213- Sidarth Kapur
251- Sidharth Kapur
214- Sidharth Kapur
252- Simon Hengel
215- Simon Hengel
253- Stefan Dresselhaus
216- Stefan Dresselhaus
254- Sumit Sahrawat
217- Sumit Sahrawat
255- Tarik Graba
218- Tarik Graba
256−- Tatiana Porras
257- Thenaesh Elango
219- Thenaesh Elango
258- Thomas Hodgson
220- Thomas Hodgson
259- Thomas Weißschuh
221- Thomas Weißschuh
@@ -263,18 +225,15 @@
263- Tiziano Müller
225- Tiziano Müller
264- Todd Sifleet
226- Todd Sifleet
265- Tom Leese
227- Tom Leese
266−- Tristan de Cacqueray
267- Tristan Stenner
228- Tristan Stenner
268- Uli Köhler
229- Uli Köhler
269- Urs Liska
230- Urs Liska
270- Václav Zeman
231- Václav Zeman
271- Václav Haisman
232- Václav Haisman
272−- Vaibhav Sagar
273- Vanessa McHale
233- Vanessa McHale
274- Vasily Alferov
234- Vasily Alferov
275- Viktor Kronvall
235- Viktor Kronvall
276- Vincent
236- Vincent
277−- Vlad Hanciuta
278- Wandmalfarbe
237- Wandmalfarbe
279- Waldir Pimenta
238- Waldir Pimenta
280- Wikiwide
239- Wikiwide
@@ -284,30 +243,20 @@
284- Yoan Blanc
243- Yoan Blanc
285- Yuchen Pei
244- Yuchen Pei
286- Zihang Chen
245- Zihang Chen
287−- a-vrma
288−- andrebauer
289−- argent0
290−- badumont
291- blmage
246- blmage
292- bucklereed
247- bucklereed
293- bumper314
248- bumper314
294- chinapedia
249- chinapedia
295−- cholonam
296- csforste
250- csforste
297−- dbecher-ito
298- d-dorazio
251- d-dorazio
299- ebiim
252- ebiim
300−- favonia
301- infinity0x
253- infinity0x
302- jeongminkim-islab
254- jeongminkim-islab
303- kaizshang91
255- kaizshang91
304- lux-lth
256- lux-lth
305- lwolfsonkin
257- lwolfsonkin
306−- mbrackeantidot
307- nkalvi
258- nkalvi
308- niszet
259- niszet
309−- nuew
310−- obcat
311- oltolm
260- oltolm
312- oquechy
261- oquechy
313- quasicomputational
262- quasicomputational
@@ -318,13 +267,7 @@
318- rski
267- rski
319- shreevatsa.public
268- shreevatsa.public
320- takahashim
269- takahashim
321−- taotieren
322−- tecosaur
323−- TEC
324- tgkokk
270- tgkokk
325−- the-solipsist
326−- timo-a
327- thsutton
271- thsutton
328- vijayphoenix
272- vijayphoenix
329- wiefling
273- wiefling
330−- wuffi
CONTRIBUTING.md+30−134
@@ -1,64 +1,6 @@
1Contributing to pandoc
1Contributing to pandoc
2======================
2======================
3
3
4−Welcome to pandoc! Very soon after its beginnings in 2006, pandoc
5−has been influenced, improved, and modified, by users, devs, and
6−newcomers alike. The project thrives on its active community. It is
7−great to have you here.
8−
9−How can I help?
10−---------------
11−
12−There are many ways in which you can support pandoc. Here are a few
13−ideas:
14−
15− * Participate in online discussions. The [pandoc-discuss] mailing
16− list is a good place for this. This gives valuable input and
17− makes it easier to improve the program.
18−
19− * Help with questions. Every request that is answered by the wider
20− community frees time for programming contributors. This will
21− speed up development of new features and issue fixes. Don't
22− underestimate your knowledge, please share it!
23−
24− Good places to help are the [pandoc-discuss] mailing list, Q/A
25− sites like StackOverflow, community forums (e.g.
26− [RStudio][RStudio Community], [Zettlr][Zettlr Forum]), and, for
27− technical questions, the GitHub [issue tracker].
28−
29− * Write or improve documentation. If you ran into a problem which
30− took more time to figure out than expected, please consider to
31− save other users from the same experience. People writing the
32− documentation tend to lack an outside view, so please help
33− provide one. Good documentation is both difficult and extremely
34− important.
35−
36− The official docs are not the only place for documentation.
37− Pandoc also has a [Wiki][pandoc wiki]. Private blogs can serve
38− as documentation just as the official manual can.
39−
40− * Contribute code. No matter whether it's a small fix in a format
41− template or a huge lump of Haskell code: help is welcome. It's
42− usually a good idea to talk about the plans early, as this can
43− prevent unnecessary work. See below for more information.
44−
45− * Last but not least: consider funding the development and
46− maintenance of pandoc financially. You can find sponsor buttons
47− on the [pandoc website] and the [GitHub repository][GitHub
48− repo].
49−
50−A rich ecosystem of libraries, editors, filters, and templates has
51−developed around pandoc; conversely, pandoc builds and depends on a
52−large number of libraries. Contributing to any of these projects is
53−another way that can help to ensure stability, and to keep pushing
54−the boundaries of what is possible with pandoc.
55−
56−[RStudio Community]: https://community.rstudio.com/
57−[Zettlr Forum]: https://forum.zettlr.com/
58−[pandoc wiki]: https://github.com/jgm/pandoc/wiki
59−[pandoc website]: https://pandoc.org
60−[GitHub repo]: https://github.com/jgm/pandoc
61−
62Have a question?
4Have a question?
63----------------
5----------------
64
6
@@ -68,21 +10,15 @@ Ask on [pandoc-discuss].
68Found a bug?
10Found a bug?
69------------
11------------
70
12
71−Bug reports are welcome! Please report all bugs on pandoc's GitHub
13+Bug reports are welcome! Please report all bugs on pandoc's github
72[issue tracker].
14[issue tracker].
73
15
74Before you submit a bug report, search the [open issues] *and* [closed issues]
16Before you submit a bug report, search the [open issues] *and* [closed issues]
75to make sure the issue hasn't come up before. Also, check the [User's Guide] and
17to make sure the issue hasn't come up before. Also, check the [User's Guide] and
76[FAQs] for anything relevant.
18[FAQs] for anything relevant.
77
19
78−Make sure you can reproduce the bug with the [latest released
20+Make sure you can reproduce the bug with the [latest released version] of pandoc
79−version] of pandoc---or, even better, the development version,
80−since the bug may have been fixed since the last release.
81−[Nightly builds] are available, so you don't need to compile
82−from source to test against the development version.
21+(or, even better, the [development version]).
83−(To fetch a nightly, visit the link, click the topmost "Nightly"
84−in the table, then choose your platform under "Artifacts." Note
85−that you must be logged in with a GitHub account.)
86
22
87Your report should give detailed, *reproducible* instructions, including
23Your report should give detailed, *reproducible* instructions, including
88
24
@@ -163,12 +99,7 @@ Explain the rationale for the feature you're requesting. Why would this
163feature be useful? Consider also any possible drawbacks, including backwards
99feature be useful? Consider also any possible drawbacks, including backwards
164compatibility, new library dependencies, and performance issues.
100compatibility, new library dependencies, and performance issues.
165
101
166−Features are very rarely "implement and forget", as all code must be
167−maintained. This is especially relevant for large or complex
168−contributions. It is helpful to be sympathetic to that fact, and to
169−communicate future plans and availability clearly.
170−
171−Any potential new feature is best discussed on [pandoc-discuss]
102+It is best to discuss a potential new feature on [pandoc-discuss]
172before opening an issue.
103before opening an issue.
173
104
174Patches and pull requests
105Patches and pull requests
@@ -215,7 +146,7 @@ Please follow these guidelines:
215
146
21610. We aim for compatibility with ghc versions from 8.0 to the
14710. We aim for compatibility with ghc versions from 8.0 to the
217 latest release. All pull requests and commits are tested
148 latest release. All pull requests and commits are tested
218− automatically on GitHub Actions.
149+ automatically on CircleCI.
219
150
220Tests
151Tests
221-----
152-----
@@ -244,16 +175,9 @@ Or with stack:
244
175
245 stack test --test-arguments='-p markdown'
176 stack test --test-arguments='-p markdown'
246
177
247−It is often helpful to add `-j4` (run tests in parallel) and
178+It is often helpful to add `-j4` (run tests in parallel)
248−`--hide-successes` (don't clutter output with successes) to the test
179+and `--hide-successes` (don't clutter output with successes)
249−arguments as well. Collecting all options in a `cabal.project.local`
180+to the test arguments as well.
250−file in the project's root directory can help to keep `cabal`
251−commands short. E.g.:
252−
253− flags: +embed_data_files
254− tests: True
255− test-show-details: direct
256− test-options: -j4 --hide-successes
257
181
258If you add a new feature to pandoc, please add tests as well, following
182If you add a new feature to pandoc, please add tests as well, following
259the pattern of the existing tests. The test suite code is in
183the pattern of the existing tests. The test suite code is in
@@ -276,35 +200,6 @@ or Powerpoint to ensure that they weren't corrupted and that
276they had the expected result, and mention the Word/Powerpoint
200they had the expected result, and mention the Word/Powerpoint
277version and OS in your commit comment.
201version and OS in your commit comment.
278
202
279−Code style
280−----------
281−
282−Pandoc uses [hlint] to identify opportunities for code improvements
283−like redundant brackets or unnecessary `Language` extensions.
284−However, sometimes there are cases where there are good reasons to
285−use code different from what hlint proposes. In these cases, the
286−respective warning should be disabled in the file `.hlint.yaml`.
287−
288−There should be no errors when running `hlint .`; this is checked by
289−the continuous integration (CI) setup. It is recommended that
290−contributors check their code with a local hlint installation, but
291−relying on the CI is fine, too.
292−
293−A good way to ensure no new warnings are introduced is to use a Git
294−[pre-commit hook] which runs hlint on all updated Haskell files
295−before creating a commit:
296−
297− #!/bin/sh
298− git diff --diff-filter=MA --cached --name-only | grep '\.hs$' | \
299− xargs hlint --hint .hlint.yaml
300−
301−(If you are using GNU `xargs`, add the `-r` option immediately
302−after `xargs`.)
303−
304−Saving this to `.git/hooks/pre-commit`, and making the script
305−executable, will prevent accidental introduction of potentially
306−problematic code.
307−
308Benchmarks
203Benchmarks
309----------
204----------
310
205
@@ -318,6 +213,9 @@ With stack:
318
213
319 stack bench
214 stack bench
320
215
216+You can also build `weigh-pandoc` (`stack build pandoc:weigh-pandoc`)
217+to get some statistics on memory usage. (Eventually this should
218+be incorporated into the benchmark suite.)
321
219
322Using the REPL
220Using the REPL
323--------------
221--------------
@@ -329,10 +227,10 @@ a ghci REPL for working with pandoc. With [stack], use
329We recommend using the following `.ghci` file (which can be
227We recommend using the following `.ghci` file (which can be
330placed in the source directory):
228placed in the source directory):
331
229
332− :set -fobject-code
230+ :set -fobject-code
333− :set -XTypeSynonymInstances
231+ :set -XTypeSynonymInstances
334− :set -XScopedTypeVariables
232+ :set -XScopedTypeVariables
335− :set -XOverloadedStrings
233+ :set -XOverloadedStrings
336
234
337Profiling
235Profiling
338---------
236---------
@@ -376,7 +274,7 @@ The code
376--------
274--------
377
275
378Pandoc has a publicly accessible git repository on
276Pandoc has a publicly accessible git repository on
379−GitHub: <https://github.com/jgm/pandoc>. To get a local copy of the source:
277+github: <http://github.com/jgm/pandoc>. To get a local copy of the source:
380
278
381 git clone https://github.com/jgm/pandoc.git
279 git clone https://github.com/jgm/pandoc.git
382
280
@@ -386,7 +284,7 @@ the pandoc library is in `src/`, the source for the tests is in
386
284
387The modules `Text.Pandoc.Definition`, `Text.Pandoc.Builder`, and
285The modules `Text.Pandoc.Definition`, `Text.Pandoc.Builder`, and
388`Text.Pandoc.Generic` are in a separate library `pandoc-types`. The code can
286`Text.Pandoc.Generic` are in a separate library `pandoc-types`. The code can
389−be found in <https://github.com/jgm/pandoc-types>.
287+be found in <http://github.com/jgm/pandoc-types>.
390
288
391To build pandoc, you will need a working installation of the
289To build pandoc, you will need a working installation of the
392[Haskell platform].
290[Haskell platform].
@@ -406,11 +304,11 @@ The library is structured as follows:
406 tree automatically.
304 tree automatically.
407 - `Text.Pandoc.Readers.*` are the readers, and `Text.Pandoc.Writers.*`
305 - `Text.Pandoc.Readers.*` are the readers, and `Text.Pandoc.Writers.*`
408 are the writers.
306 are the writers.
409− - `Text.Pandoc.Citeproc.*` contain the code for citation handling,
307+ - `Text.Pandoc.Biblio` is a utility module for formatting citations
410− including an interface to the [citeproc] library.
308+ using citeproc-hs.
411 - `Text.Pandoc.Data` is used to embed data files when the `embed_data_files`
309 - `Text.Pandoc.Data` is used to embed data files when the `embed_data_files`
412− cabal flag is used.
310+ cabal flag is used. It is generated from `src/Text/Pandoc/Data.hsb` using
413− - `Text.Pandoc.Emoji` is a thin wrapper around [emojis].
311+ the preprocessor [hsb2hs].
414 - `Text.Pandoc.Highlighting` contains the interface to the
312 - `Text.Pandoc.Highlighting` contains the interface to the
415 skylighting library, which is used for code syntax highlighting.
313 skylighting library, which is used for code syntax highlighting.
416 - `Text.Pandoc.ImageSize` is a utility module containing functions for
314 - `Text.Pandoc.ImageSize` is a utility module containing functions for
@@ -421,6 +319,7 @@ The library is structured as follows:
421 - `Text.Pandoc.PDF` contains functions for producing a PDF from a
319 - `Text.Pandoc.PDF` contains functions for producing a PDF from a
422 LaTeX source.
320 LaTeX source.
423 - `Text.Pandoc.Parsing` contains parsing functions used in multiple readers.
321 - `Text.Pandoc.Parsing` contains parsing functions used in multiple readers.
322+ - `Text.Pandoc.Pretty` is a pretty-printing library specialized to
424 the needs of pandoc.
323 the needs of pandoc.
425 - `Text.Pandoc.SelfContained` contains functions for making an HTML
324 - `Text.Pandoc.SelfContained` contains functions for making an HTML
426 file "self-contained," by importing remotely linked images, CSS,
325 file "self-contained," by importing remotely linked images, CSS,
@@ -447,18 +346,14 @@ you may want to consider submitting a pull request to the
447[open issues]: https://github.com/jgm/pandoc/issues
346[open issues]: https://github.com/jgm/pandoc/issues
448[closed issues]: https://github.com/jgm/pandoc/issues?q=is%3Aissue+is%3Aclosed
347[closed issues]: https://github.com/jgm/pandoc/issues?q=is%3Aissue+is%3Aclosed
449[latest released version]: https://github.com/jgm/pandoc/releases/latest
348[latest released version]: https://github.com/jgm/pandoc/releases/latest
450−[Nightly builds]: https://github.com/jgm/pandoc/actions?query=workflow%3ANightly
349+[development version]: https://github.com/pandoc-extras/pandoc-nightly/releases/latest
451−[pandoc-discuss]: https://groups.google.com/group/pandoc-discuss
350+[pandoc-discuss]: http://groups.google.com/group/pandoc-discuss
452[issue tracker]: https://github.com/jgm/pandoc/issues
351[issue tracker]: https://github.com/jgm/pandoc/issues
453−[User's Guide]: https://pandoc.org/MANUAL.html
352+[User's Guide]: http://pandoc.org/MANUAL.html
454−[FAQs]: https://pandoc.org/faqs.html
353+[FAQs]: http://pandoc.org/faqs.html
455−[EditorConfig]: https://editorconfig.org/
354+[EditorConfig]: http://editorconfig.org/
456−[Haskell platform]: https://www.haskell.org/platform/
355+[Haskell platform]: http://www.haskell.org/platform/
457−[hlint]: https://hackage.haskell.org/package/hlint
458−[citeproc]: https://hackage.haskell.org/package/citeproc
459−[emojis]: https://hackage.haskell.org/package/emojis
460−[hsb2hs]: https://hackage.haskell.org/package/hsb2hs
356+[hsb2hs]: http://hackage.haskell.org/package/hsb2hs
461−[pre-commit hook]: https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks
462[GitHub labels]: https://github.com/jgm/pandoc/labels
357[GitHub labels]: https://github.com/jgm/pandoc/labels
463[good first issue]:https://github.com/jgm/pandoc/labels/good%20first%20issue
358[good first issue]:https://github.com/jgm/pandoc/labels/good%20first%20issue
464[enhancement]: https://github.com/jgm/pandoc/labels/enhancement
359[enhancement]: https://github.com/jgm/pandoc/labels/enhancement
@@ -473,3 +368,4 @@ you may want to consider submitting a pull request to the
473[status:more-discussion-needed]: https://github.com/jgm/pandoc/labels/status:more-discussion-needed
368[status:more-discussion-needed]: https://github.com/jgm/pandoc/labels/status:more-discussion-needed
474[status:more-info-needed]: https://github.com/jgm/pandoc/labels/status:more-info-needed
369[status:more-info-needed]: https://github.com/jgm/pandoc/labels/status:more-info-needed
475[stack]: https://github.com/commercialhaskell/stack
370[stack]: https://github.com/commercialhaskell/stack
371+
COPYING.md+1−1
@@ -357,5 +357,5 @@ into proprietary programs. If your program is a subroutine library,
357you may consider it more useful to permit linking proprietary
357you may consider it more useful to permit linking proprietary
358applications with the library. If this is what you want to do, use the
358applications with the library. If this is what you want to do, use the
359[GNU Lesser General Public
359[GNU Lesser General Public
360−License](https://www.gnu.org/licenses/lgpl.html) instead of this
360+License](http://www.gnu.org/licenses/lgpl.html) instead of this
361License.
361License.
COPYRIGHT+26−17
@@ -1,5 +1,5 @@
1Pandoc
1Pandoc
2−Copyright (C) 2006-2021 John MacFarlane <jgm at berkeley dot edu>
2+Copyright (C) 2006-2020 John MacFarlane <jgm at berkeley dot edu>
3
3
4With the exceptions noted below, this code is released under the [GPL],
4With the exceptions noted below, this code is released under the [GPL],
5version 2 or later:
5version 2 or later:
@@ -22,11 +22,11 @@ The GNU General Public License is available in the file COPYING.md in
22the source distribution. On Debian systems, the complete text of the
22the source distribution. On Debian systems, the complete text of the
23GPL can be found in `/usr/share/common-licenses/GPL`.
23GPL can be found in `/usr/share/common-licenses/GPL`.
24
24
25−[GPL]: https://www.gnu.org/copyleft/gpl.html
25+[GPL]: http://www.gnu.org/copyleft/gpl.html
26
26
27Pandoc's complete source code is available from the [Pandoc home page].
27Pandoc's complete source code is available from the [Pandoc home page].
28
28
29−[Pandoc home page]: https://pandoc.org
29+[Pandoc home page]: http://pandoc.org
30
30
31Pandoc includes some code with different copyrights, or subject to different
31Pandoc includes some code with different copyrights, or subject to different
32licenses. The copyright and license statements for these sources are included
32licenses. The copyright and license statements for these sources are included
@@ -37,7 +37,7 @@ The modules in the `pandoc-types` repository (Text.Pandoc.Definition,
37Text.Pandoc.Builder, Text.Pandoc.Generics, Text.Pandoc.JSON,
37Text.Pandoc.Builder, Text.Pandoc.Generics, Text.Pandoc.JSON,
38Text.Pandoc.Walk) are licensed under the BSD 3-clause license:
38Text.Pandoc.Walk) are licensed under the BSD 3-clause license:
39
39
40−Copyright (c) 2006-2021, John MacFarlane
40+Copyright (c) 2006-2020, John MacFarlane
41
41
42All rights reserved.
42All rights reserved.
43
43
@@ -73,7 +73,7 @@ Pandoc's templates (in `data/templates`) are dual-licensed as either
73GPL (v2 or higher, same as pandoc) or (at your option) the BSD
73GPL (v2 or higher, same as pandoc) or (at your option) the BSD
743-clause license.
743-clause license.
75
75
76−Copyright (c) 2014--2021, John MacFarlane
76+Copyright (c) 2014--2020, John MacFarlane
77
77
78----------------------------------------------------------------------
78----------------------------------------------------------------------
79src/Text/Pandoc/Writers/Muse.hs
79src/Text/Pandoc/Writers/Muse.hs
@@ -83,19 +83,19 @@ Released under the GNU General Public License version 2 or later.
83
83
84----------------------------------------------------------------------
84----------------------------------------------------------------------
85src/Text/Pandoc/Writers/Texinfo.hs
85src/Text/Pandoc/Writers/Texinfo.hs
86−Copyright (C) 2008-2021 John MacFarlane and Peter Wang
86+Copyright (C) 2008-2020 John MacFarlane and Peter Wang
87
87
88Released under the GNU General Public License version 2 or later.
88Released under the GNU General Public License version 2 or later.
89
89
90----------------------------------------------------------------------
90----------------------------------------------------------------------
91src/Text/Pandoc/Writers/OpenDocument.hs
91src/Text/Pandoc/Writers/OpenDocument.hs
92−Copyright (C) 2008-2021 Andrea Rossato and John MacFarlane
92+Copyright (C) 2008-2020 Andrea Rossato and John MacFarlane
93
93
94Released under the GNU General Public License version 2 or later.
94Released under the GNU General Public License version 2 or later.
95
95
96----------------------------------------------------------------------
96----------------------------------------------------------------------
97src/Text/Pandoc/Writers/Org.hs
97src/Text/Pandoc/Writers/Org.hs
98−Copyright (C) 2010-2021 Puneeth Chaganti, John MacFarlane, and
98+Copyright (C) 2010-2020 Puneeth Chaganti, John MacFarlane, and
99 Albert Krewinkel
99 Albert Krewinkel
100
100
101Released under the GNU General Public License version 2 or later.
101Released under the GNU General Public License version 2 or later.
@@ -115,7 +115,7 @@ Released under the GNU General Public License version 2 or later.
115
115
116----------------------------------------------------------------------
116----------------------------------------------------------------------
117src/Text/Pandoc/Readers/Textile.hs
117src/Text/Pandoc/Readers/Textile.hs
118−Copyright (C) 2010-2021 Paul Rivier and John MacFarlane
118+Copyright (C) 2010-2020 Paul Rivier and John MacFarlane
119
119
120Released under the GNU General Public License version 2 or later.
120Released under the GNU General Public License version 2 or later.
121
121
@@ -133,7 +133,7 @@ Released under the GNU General Public License version 2 or later.
133
133
134----------------------------------------------------------------------
134----------------------------------------------------------------------
135src/Text/Pandoc/Readers/EPUB.hs
135src/Text/Pandoc/Readers/EPUB.hs
136−Copyright (C) 2014-2021 Matthew Pickering and John MacFarlane
136+Copyright (C) 2014-2020 Matthew Pickering and John MacFarlane
137
137
138Released under the GNU General Public License version 2 or later.
138Released under the GNU General Public License version 2 or later.
139
139
@@ -141,7 +141,7 @@ Released under the GNU General Public License version 2 or later.
141src/Text/Pandoc/Readers/Org.hs
141src/Text/Pandoc/Readers/Org.hs
142src/Text/Pandoc/Readers/Org/*
142src/Text/Pandoc/Readers/Org/*
143test/Tests/Readers/Org/*
143test/Tests/Readers/Org/*
144−Copyright (C) 2014-2021 Albert Krewinkel
144+Copyright (C) 2014-2020 Albert Krewinkel
145
145
146Released under the GNU General Public License version 2 or later.
146Released under the GNU General Public License version 2 or later.
147
147
@@ -149,7 +149,7 @@ Released under the GNU General Public License version 2 or later.
149src/Text/Pandoc/Lua.hs
149src/Text/Pandoc/Lua.hs
150src/Text/Pandoc/Lua/*
150src/Text/Pandoc/Lua/*
151test/lua/*
151test/lua/*
152−Copyright (C) 2017--2021 Albert Krewinkel and John MacFarlane
152+Copyright (C) 2017--2020 Albert Krewinkel and John MacFarlane
153
153
154Released under the GNU General Public License version 2 or later.
154Released under the GNU General Public License version 2 or later.
155
155
@@ -157,7 +157,7 @@ Released under the GNU General Public License version 2 or later.
157src/Text/Pandoc/Readers/Jira.hs
157src/Text/Pandoc/Readers/Jira.hs
158src/Text/Pandoc/Writers/Jira.hs
158src/Text/Pandoc/Writers/Jira.hs
159test/Tests/Readers/Jira.hs
159test/Tests/Readers/Jira.hs
160−Copyright (C) 2019--2021 Albert Krewinkel
160+Copyright (C) 2019--2020 Albert Krewinkel
161
161
162Released under the GNU General Public License version 2 or later.
162Released under the GNU General Public License version 2 or later.
163
163
@@ -169,21 +169,21 @@ Released under the GNU General Public License version 2 or later.
169
169
170----------------------------------------------------------------------
170----------------------------------------------------------------------
171data/pandoc.lua
171data/pandoc.lua
172−Copyright (C) 2017-2021 Albert Krewinkel
172+Copyright (C) 2017-2020 Albert Krewinkel
173
173
174Released under the GNU General Public License version 2 or later.
174Released under the GNU General Public License version 2 or later.
175
175
176----------------------------------------------------------------------
176----------------------------------------------------------------------
177The dzslides template contains JavaScript and CSS from Paul Rouget's
177The dzslides template contains JavaScript and CSS from Paul Rouget's
178dzslides template.
178dzslides template.
179−https://github.com/paulrouget/dzslides
179+http://github.com/paulrouget/dzslides
180
180
181Released under the Do What the Fuck You Want To Public License.
181Released under the Do What the Fuck You Want To Public License.
182
182
183------------------------------------------------------------------------
183------------------------------------------------------------------------
184−Pandoc embeds a Lua interpreter (via hslua).
184+Pandoc embeds a lua interpreter (via hslua).
185
185
186−Copyright © 1994–2020 Lua.org, PUC-Rio.
186+Copyright © 1994–2019 Lua.org, PUC-Rio.
187
187
188Permission is hereby granted, free of charge, to any person obtaining
188Permission is hereby granted, free of charge, to any person obtaining
189a copy of this software and associated documentation files (the
189a copy of this software and associated documentation files (the
@@ -203,3 +203,12 @@ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
203LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
203LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
204OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
204OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
205WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
205WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
206+
207+------------------------------------------------------------------------
208+The template pandoc.jats is Copyright 2013--2015 Martin Fenner,
209+released under GPL version 2 or later.
210+
211+The file data/jats.csl is derived from a csl file by Martin Fenner,
212+revised by Martin Paul Eve and then John MacFarlane.
213+"This work is licensed under a Creative Commons Attribution-ShareAlike 3.0
214+License. Originally by Martin Fenner."
INSTALL.md+38−27
@@ -34,10 +34,6 @@ without SVG support), [Python] (to use Pandoc filters), and
34
34
35 choco install rsvg-convert python miktex
35 choco install rsvg-convert python miktex
36
36
37−Using multiple installation methods can result in two separate
38−installations of pandoc; it is recommended to properly uninstall
39−pandoc before switching to an alternative installation method.
40−
41By default, Pandoc creates PDFs using LaTeX.
37By default, Pandoc creates PDFs using LaTeX.
42We recommend installing it via [MiKTeX].
38We recommend installing it via [MiKTeX].
43
39
@@ -49,10 +45,14 @@ by downloading [this script][uninstaller]
49and running it with `perl uninstall-pandoc.pl`.
45and running it with `perl uninstall-pandoc.pl`.
50
46
51Alternatively, you can install pandoc using
47Alternatively, you can install pandoc using
52−[Homebrew](https://brew.sh):
48+[Homebrew](http://brew.sh):
53
49
54 brew install pandoc
50 brew install pandoc
55
51
52+To include pandoc's citation parser:
53+
54+ brew install pandoc-citeproc
55+
56Homebrew can also install other software that integrates with Pandoc.
56Homebrew can also install other software that integrates with Pandoc.
57For example, to install [librsvg] (its `rsvg-convert` covers formats
57For example, to install [librsvg] (its `rsvg-convert` covers formats
58without SVG support), [Python] (to use Pandoc filters), and
58without SVG support), [Python] (to use Pandoc filters), and
@@ -86,8 +86,9 @@ not outdated. Pandoc is in the [Debian], [Ubuntu], [Slackware],
86To get the latest release, we provide a binary package for amd64
86To get the latest release, we provide a binary package for amd64
87architecture on the **[download page]**.
87architecture on the **[download page]**.
88
88
89+This provides both `pandoc` and `pandoc-citeproc`.
89−The executable is statically linked and
90+The executables are statically linked and
90−has no dynamic dependencies or dependencies on external
91+have no dynamic dependencies or dependencies on external
91data files. Note: because of the static
92data files. Note: because of the static
92linking, the pandoc binary from this package cannot use lua
93linking, the pandoc binary from this package cannot use lua
93filters that require external lua modules written in C.
94filters that require external lua modules written in C.
@@ -97,7 +98,8 @@ Both a tarball and a deb installer are provided. To install the deb:
97 sudo dpkg -i $DEB
98 sudo dpkg -i $DEB
98
99
99where `$DEB` is the path to the downloaded deb. This will
100where `$DEB` is the path to the downloaded deb. This will
100−install the `pandoc` executable and man page.
101+install the `pandoc` and `pandoc-citeproc` executables and
102+man pages.
101
103
102If you use an RPM-based distro, you may be able to install
104If you use an RPM-based distro, you may be able to install
103the deb from our download page using `alien`.
105the deb from our download page using `alien`.
@@ -120,7 +122,7 @@ package repositories. For example, on Debian/Ubuntu,
120you can install it with `apt-get install haskell-platform`.
122you can install it with `apt-get install haskell-platform`.
121
123
122For PDF output, you'll need LaTeX. We recommend installing
124For PDF output, you'll need LaTeX. We recommend installing
123−[TeX Live](https://www.tug.org/texlive/) via your package
125+[TeX Live](http://www.tug.org/texlive/) via your package
124manager. (On Debian/Ubuntu, `apt-get install texlive`.)
126manager. (On Debian/Ubuntu, `apt-get install texlive`.)
125
127
126## Chrome OS
128## Chrome OS
@@ -147,7 +149,7 @@ The official Docker images for pandoc can be found at
147[dockerhub](https://hub.docker.com/).
149[dockerhub](https://hub.docker.com/).
148
150
149The [pandoc/core](https://hub.docker.com/r/pandoc/core)
151The [pandoc/core](https://hub.docker.com/r/pandoc/core)
150−image contains `pandoc`.
152+image contains `pandoc` and `pandoc-citeproc`.
151
153
152The [pandoc/latex](https://hub.docker.com/r/pandoc/latex)
154The [pandoc/latex](https://hub.docker.com/r/pandoc/latex)
153image also contains the minimal LaTeX installation needed
155image also contains the minimal LaTeX installation needed
@@ -242,22 +244,28 @@ The easiest way to build pandoc from source is to use [stack][stack]:
242
244
243 pandoc --help
245 pandoc --help
244
246
245− [Not sure where `$CABALDIR` is?](https://wiki.haskell.org/Cabal-Install#The_cabal-install_configuration_file)
247+ [Not sure where `$CABALDIR` is?](http://www.haskell.org/haskellwiki/Cabal-Install#The_cabal-install_configuration_file)
246
248
249+5. If you want to process citations with pandoc, you will also need to
250+ install a separate package, `pandoc-citeproc`. This can be installed
251+ using cabal:
252+
253+ cabal install pandoc-citeproc
254+
247−5. By default `pandoc` uses the "i;unicode-casemap" method
255+ By default `pandoc-citeproc` uses the "i;unicode-casemap" method
248 to sort bibliography entries (RFC 5051). If you would like to
256 to sort bibliography entries (RFC 5051). If you would like to
249 use the locale-sensitive unicode collation algorithm instead,
257 use the locale-sensitive unicode collation algorithm instead,
250− specify the `icu` flag (which affects the dependency `citeproc`):
258+ specify the `unicode_collation` flag:
251
259
252− cabal install pandoc -ficu
260+ cabal install pandoc-citeproc -funicode_collation
253
261
254 Note that this requires the `text-icu` library, which in turn
262 Note that this requires the `text-icu` library, which in turn
255 depends on the C library `icu4c`. Installation directions
263 depends on the C library `icu4c`. Installation directions
256 vary by platform. Here is how it might work on macOS with Homebrew:
264 vary by platform. Here is how it might work on macOS with Homebrew:
257
265
258 brew install icu4c
266 brew install icu4c
259− stack install pandoc \
267+ stack install pandoc-citeproc \
260− --flag "citeproc:icu" \
268+ --flag "pandoc-citeproc:unicode_collation" \
261 --extra-lib-dirs=/usr/local/opt/icu4c/lib \
269 --extra-lib-dirs=/usr/local/opt/icu4c/lib \
262 --extra-include-dirs=/usr/local/opt/icu4c/include
270 --extra-include-dirs=/usr/local/opt/icu4c/include
263
271
@@ -266,6 +274,8 @@ The easiest way to build pandoc from source is to use [stack][stack]:
266 accordingly. If `MANUAL.txt` has been modified, the man page can be
274 accordingly. If `MANUAL.txt` has been modified, the man page can be
267 rebuilt: `make man/pandoc.1`.
275 rebuilt: `make man/pandoc.1`.
268
276
277+ The `pandoc-citeproc.1` man page will also be installed automatically.
278+
269
279
270### Custom cabal method
280### Custom cabal method
271
281
@@ -387,29 +397,30 @@ To run just the markdown benchmarks:
387
397
388
398
389[Arch]: https://www.archlinux.org/packages/community/x86_64/pandoc/
399[Arch]: https://www.archlinux.org/packages/community/x86_64/pandoc/
390−[Cabal User's Guide]: https://cabal.readthedocs.io/
400+[Cabal User's Guide]: http://www.haskell.org/cabal/release/latest/doc/users-guide/builders.html#setup-configure-paths
391[Debian]: https://packages.debian.org/pandoc
401[Debian]: https://packages.debian.org/pandoc
392[Fedora]: https://apps.fedoraproject.org/packages/pandoc
402[Fedora]: https://apps.fedoraproject.org/packages/pandoc
393−[FreeBSD ports]: https://www.freshports.org/textproc/hs-pandoc/
403+[FreeBSD ports]: http://www.freshports.org/textproc/hs-pandoc/
394−[GHC]: https://www.haskell.org/ghc/
404+[GHC]: http://www.haskell.org/ghc/
405+[GPL]: http://www.gnu.org/copyleft/gpl.html
395−[Haskell platform]: https://hackage.haskell.org/platform/
406+[Haskell platform]: http://hackage.haskell.org/platform/
396−[MacPorts]: https://trac.macports.org/browser/trunk/dports/textproc/pandoc/Portfile
407+[MacPorts]: http://trac.macports.org/browser/trunk/dports/textproc/pandoc/Portfile
397[MacTeX]: https://tug.org/mactex/
408[MacTeX]: https://tug.org/mactex/
398−[BasicTeX]: https://www.tug.org/mactex/morepackages.html
409+[BasicTeX]: http://www.tug.org/mactex/morepackages.html
399[LaTeX]: https://www.latex-project.org
410[LaTeX]: https://www.latex-project.org
400−[MiKTeX]: https://miktex.org/
411+[MiKTeX]: http://miktex.org/
401[librsvg]: https://wiki.gnome.org/Projects/LibRsvg
412[librsvg]: https://wiki.gnome.org/Projects/LibRsvg
402[Python]: https://www.python.org
413[Python]: https://www.python.org
403−[NetBSD]: https://pkgsrc.se/wip/pandoc
414+[NetBSD]: http://pkgsrc.se/wip/pandoc
404[NixOS]: https://nixos.org/nixos/packages.html
415[NixOS]: https://nixos.org/nixos/packages.html
405[Slackware]: https://www.slackbuilds.org/result/?search=pandoc&sv=
416[Slackware]: https://www.slackbuilds.org/result/?search=pandoc&sv=
406[Ubuntu]: https://packages.ubuntu.com/pandoc
417[Ubuntu]: https://packages.ubuntu.com/pandoc
407[download page]: https://github.com/jgm/pandoc/releases/latest
418[download page]: https://github.com/jgm/pandoc/releases/latest
408−[gentoo]: https://packages.gentoo.org/package/app-text/pandoc
419+[gentoo]: http://packages.gentoo.org/package/app-text/pandoc
409[haskell repository]: https://wiki.archlinux.org/index.php/Haskell_Package_Guidelines#.5Bhaskell.5D
420[haskell repository]: https://wiki.archlinux.org/index.php/Haskell_Package_Guidelines#.5Bhaskell.5D
410[openSUSE]: https://software.opensuse.org/package/pandoc
421[openSUSE]: https://software.opensuse.org/package/pandoc
411−[source tarball]: https://hackage.haskell.org/package/pandoc
422+[source tarball]: http://hackage.haskell.org/package/pandoc
412[stack]: https://docs.haskellstack.org/en/stable/install_and_upgrade.html
423[stack]: https://docs.haskellstack.org/en/stable/install_and_upgrade.html
413−[cabal-install]: https://hackage.haskell.org/package/cabal-install
424+[cabal-install]: http://hackage.haskell.org/package/cabal-install
414[Void]: https://voidlinux.org/
425[Void]: https://voidlinux.org/
415[uninstaller]: https://raw.githubusercontent.com/jgm/pandoc/master/macos/uninstall-pandoc.pl
426[uninstaller]: https://raw.githubusercontent.com/jgm/pandoc/master/macos/uninstall-pandoc.pl
MANUAL.txt+505−1048
@@ -1,7 +1,7 @@
1---
1---
2title: Pandoc User's Guide
2title: Pandoc User's Guide
3author: John MacFarlane
3author: John MacFarlane
4−date: June 20, 2021
4+date: March 23, 2020
5---
5---
6
6
7# Synopsis
7# Synopsis
@@ -136,22 +136,22 @@ to output the generated LaTeX. You can then test it with `pdflatex test.tex`.
136When using LaTeX, the following packages need to be available
136When using LaTeX, the following packages need to be available
137(they are included with all recent versions of [TeX Live]):
137(they are included with all recent versions of [TeX Live]):
138[`amsfonts`], [`amsmath`], [`lm`], [`unicode-math`],
138[`amsfonts`], [`amsmath`], [`lm`], [`unicode-math`],
139−[`iftex`], [`listings`] (if the
139+[`ifxetex`], [`ifluatex`], [`listings`] (if the
140`--listings` option is used), [`fancyvrb`], [`longtable`],
140`--listings` option is used), [`fancyvrb`], [`longtable`],
141[`booktabs`], [`graphicx`] (if the document
141[`booktabs`], [`graphicx`] (if the document
142contains images), [`hyperref`], [`xcolor`],
142contains images), [`hyperref`], [`xcolor`],
143[`ulem`], [`geometry`] (with the `geometry` variable set),
143[`ulem`], [`geometry`] (with the `geometry` variable set),
144[`setspace`] (with `linestretch`), and
144[`setspace`] (with `linestretch`), and
145[`babel`] (with `lang`). The use of `xelatex` or `lualatex` as
145[`babel`] (with `lang`). The use of `xelatex` or `lualatex` as
146−the PDF engine requires [`fontspec`]. `lualatex` uses
146+the PDF engine requires [`fontspec`]. `xelatex` uses
147−[`selnolig`]. `xelatex` uses [`polyglossia`] (with `lang`),
147+[`polyglossia`] (with `lang`), [`xecjk`], and [`bidi`] (with the
148−[`xecjk`], and [`bidi`] (with the `dir` variable set). If the
148+`dir` variable set). If the `mathspec` variable is set,
149−`mathspec` variable is set, `xelatex` will use [`mathspec`]
149+`xelatex` will use [`mathspec`] instead of [`unicode-math`].
150−instead of [`unicode-math`]. The [`upquote`] and [`microtype`]
150+The [`upquote`] and [`microtype`] packages are used if
151−packages are used if available, and [`csquotes`] will be used
151+available, and [`csquotes`] will be used for [typography]
152−for [typography] if the `csquotes` variable or metadata field is
152+if the `csquotes` variable or metadata field is set to a
153−set to a true value. The [`natbib`], [`biblatex`], [`bibtex`],
153+true value. The [`natbib`], [`biblatex`], [`bibtex`], and
154−and [`biber`] packages can optionally be used for [citation
154+[`biber`] packages can optionally be used for [citation
155rendering]. The following packages will be used to improve
155rendering]. The following packages will be used to improve
156output quality if present, but pandoc does not require them to
156output quality if present, but pandoc does not require them to
157be present: [`upquote`] (for straight quotes in verbatim
157be present: [`upquote`] (for straight quotes in verbatim
@@ -180,7 +180,8 @@ footnotes in tables).
180[`graphicx`]: https://ctan.org/pkg/graphicx
180[`graphicx`]: https://ctan.org/pkg/graphicx
181[`grffile`]: https://ctan.org/pkg/grffile
181[`grffile`]: https://ctan.org/pkg/grffile
182[`hyperref`]: https://ctan.org/pkg/hyperref
182[`hyperref`]: https://ctan.org/pkg/hyperref
183−[`iftex`]: https://ctan.org/pkg/iftex
183+[`ifluatex`]: https://ctan.org/pkg/ifluatex
184+[`ifxetex`]: https://ctan.org/pkg/ifxetex
184[`listings`]: https://ctan.org/pkg/listings
185[`listings`]: https://ctan.org/pkg/listings
185[`lm`]: https://ctan.org/pkg/lm
186[`lm`]: https://ctan.org/pkg/lm
186[`longtable`]: https://ctan.org/pkg/longtable
187[`longtable`]: https://ctan.org/pkg/longtable
@@ -199,7 +200,6 @@ footnotes in tables).
199[`xcolor`]: https://ctan.org/pkg/xcolor
200[`xcolor`]: https://ctan.org/pkg/xcolor
200[`xecjk`]: https://ctan.org/pkg/xecjk
201[`xecjk`]: https://ctan.org/pkg/xecjk
201[`xurl`]: https://ctan.org/pkg/xurl
202[`xurl`]: https://ctan.org/pkg/xurl
202−[`selnolig`]: https://ctan.org/pkg/selnolig
203
203
204
204
205
205
@@ -225,12 +225,8 @@ header when requesting a document from a URL:
225: Specify input format. *FORMAT* can be:
225: Specify input format. *FORMAT* can be:
226
226
227 ::: {#input-formats}
227 ::: {#input-formats}
228− - `bibtex` ([BibTeX] bibliography)
229− - `biblatex` ([BibLaTeX] bibliography)
230 - `commonmark` ([CommonMark] Markdown)
228 - `commonmark` ([CommonMark] Markdown)
231− - `commonmark_x` ([CommonMark] Markdown with extensions)
232 - `creole` ([Creole 1.0])
229 - `creole` ([Creole 1.0])
233− - `csljson` ([CSL JSON] bibliography)
234 - `csv` ([CSV] table)
230 - `csv` ([CSV] table)
235 - `docbook` ([DocBook])
231 - `docbook` ([DocBook])
236 - `docx` ([Word docx])
232 - `docx` ([Word docx])
@@ -280,12 +276,8 @@ header when requesting a document from a URL:
280 ::: {#output-formats}
276 ::: {#output-formats}
281 - `asciidoc` ([AsciiDoc]) or `asciidoctor` ([AsciiDoctor])
277 - `asciidoc` ([AsciiDoc]) or `asciidoctor` ([AsciiDoctor])
282 - `beamer` ([LaTeX beamer][`beamer`] slide show)
278 - `beamer` ([LaTeX beamer][`beamer`] slide show)
283− - `bibtex` ([BibTeX] bibliography)
284− - `biblatex` ([BibLaTeX] bibliography)
285 - `commonmark` ([CommonMark] Markdown)
279 - `commonmark` ([CommonMark] Markdown)
286− - `commonmark_x` ([CommonMark] Markdown with extensions)
287 - `context` ([ConTeXt])
280 - `context` ([ConTeXt])
288− - `csljson` ([CSL JSON] bibliography)
289 - `docbook` or `docbook4` ([DocBook] 4)
281 - `docbook` or `docbook4` ([DocBook] 4)
290 - `docbook5` (DocBook 5)
282 - `docbook5` (DocBook 5)
291 - `docx` ([Word docx])
283 - `docx` ([Word docx])
@@ -361,15 +353,15 @@ header when requesting a document from a URL:
361 will be used. On \*nix and macOS systems this will be the `pandoc`
353 will be used. On \*nix and macOS systems this will be the `pandoc`
362 subdirectory of the XDG data directory (by default,
354 subdirectory of the XDG data directory (by default,
363 `$HOME/.local/share`, overridable by setting the `XDG_DATA_HOME`
355 `$HOME/.local/share`, overridable by setting the `XDG_DATA_HOME`
364− environment variable). If that directory does not exist and
356+ environment variable). If that directory does not exist,
365− `$HOME/.pandoc` exists, it will be used (for backwards compatibility).
357+ `$HOME/.pandoc` will be used (for backwards compatibility).
366− On Windows the default user data directory is
358+ In Windows the default user data directory is
367 `C:\Users\USERNAME\AppData\Roaming\pandoc`.
359 `C:\Users\USERNAME\AppData\Roaming\pandoc`.
368 You can find the default user data directory on your system by
360 You can find the default user data directory on your system by
369 looking at the output of `pandoc --version`.
361 looking at the output of `pandoc --version`.
370− Data files placed in this directory (for example, `reference.odt`,
371− `reference.docx`, `epub.css`, `templates`) will override
362+ A `reference.odt`, `reference.docx`, `epub.css`, `templates`,
363+ `slidy`, `slideous`, or `s5` directory
372− pandoc's normal defaults.
364+ placed in this directory will override pandoc's normal defaults.
373
365
374`-d` *FILE*, `--defaults=`*FILE*
366`-d` *FILE*, `--defaults=`*FILE*
375
367
@@ -394,7 +386,8 @@ header when requesting a document from a URL:
394
386
395`--verbose`
387`--verbose`
396
388
397−: Give verbose debugging output.
389+: Give verbose debugging output. Currently this only has an effect
390+ with PDF output.
398
391
399`--quiet`
392`--quiet`
400
393
@@ -486,7 +479,7 @@ header when requesting a document from a URL:
486[Emacs Org mode]: https://orgmode.org
479[Emacs Org mode]: https://orgmode.org
487[AsciiDoc]: https://www.methods.co.nz/asciidoc/
480[AsciiDoc]: https://www.methods.co.nz/asciidoc/
488[AsciiDoctor]: https://asciidoctor.org/
481[AsciiDoctor]: https://asciidoctor.org/
489−[DZSlides]: https://paulrouget.com/dzslides/
482+[DZSlides]: http://paulrouget.com/dzslides/
490[Word docx]: https://en.wikipedia.org/wiki/Office_Open_XML
483[Word docx]: https://en.wikipedia.org/wiki/Office_Open_XML
491[PDF]: https://www.adobe.com/pdf/
484[PDF]: https://www.adobe.com/pdf/
492[reveal.js]: https://revealjs.com/
485[reveal.js]: https://revealjs.com/
@@ -497,9 +490,6 @@ header when requesting a document from a URL:
497[Muse]: https://amusewiki.org/library/manual
490[Muse]: https://amusewiki.org/library/manual
498[PowerPoint]: https://en.wikipedia.org/wiki/Microsoft_PowerPoint
491[PowerPoint]: https://en.wikipedia.org/wiki/Microsoft_PowerPoint
499[Vimwiki]: https://vimwiki.github.io
492[Vimwiki]: https://vimwiki.github.io
500−[CSL JSON]: https://citeproc-js.readthedocs.io/en/latest/csl-json/markup.html
501−[BibTeX]: https://ctan.org/pkg/bibtex
502−[BibLaTeX]: https://ctan.org/pkg/biblatex
503
493
504## Reader options {.options}
494## Reader options {.options}
505
495
@@ -589,13 +579,13 @@ header when requesting a document from a URL:
589
579
590 3. `$PATH` (executable only)
580 3. `$PATH` (executable only)
591
581
592− Filters, Lua-filters, and citeproc processing are applied in
582+ Filters and Lua-filters are applied in the order specified
593− the order specified on the command line.
583+ on the command line.
594
584
595`-L` *SCRIPT*, `--lua-filter=`*SCRIPT*
585`-L` *SCRIPT*, `--lua-filter=`*SCRIPT*
596
586
597: Transform the document in a similar fashion as JSON filters (see
587: Transform the document in a similar fashion as JSON filters (see
598− `--filter`), but use pandoc's built-in Lua filtering system. The given
588+ `--filter`), but use pandoc's build-in Lua filtering system. The given
599 Lua script is expected to return a list of Lua filters which will be
589 Lua script is expected to return a list of Lua filters which will be
600 applied in order. Each Lua filter must contain element-transforming
590 applied in order. Each Lua filter must contain element-transforming
601 functions indexed by the name of the AST element on which the filter
591 functions indexed by the name of the AST element on which the filter
@@ -604,17 +594,26 @@ header when requesting a document from a URL:
604 The `pandoc` Lua module provides helper functions for element
594 The `pandoc` Lua module provides helper functions for element
605 creation. It is always loaded into the script's Lua environment.
595 creation. It is always loaded into the script's Lua environment.
606
596
607− See the [Lua filters documentation] for further details.
597+ The following is an example Lua script for macro-expansion:
608
598
609− In order of preference, pandoc will look for Lua filters in
599+ function expand_hello_world(inline)
600+ if inline.c == '{{helloworld}}' then
601+ return pandoc.Emph{ pandoc.Str "Hello, World" }
602+ else
603+ return inline
604+ end
605+ end
606+
607+ return {{Str = expand_hello_world}}
610
608
611− 1. a specified full or relative path
609+ In order of preference, pandoc will look for Lua filters in
612
610
613− 2. `$DATADIR/filters` where `$DATADIR` is the user data
611+ 1. a specified full or relative path (executable or
614− directory (see `--data-dir`, above).
612+ non-executable)
615
613
616− Filters, Lua filters, and citeproc processing are applied in
614+ 2. `$DATADIR/filters` (executable or non-executable)
617− the order specified on the command line.
615+ where `$DATADIR` is the user data directory (see
616+ `--data-dir`, above).
618
617
619`-M` *KEY*[`=`*VAL*], `--metadata=`*KEY*[`:`*VAL*]
618`-M` *KEY*[`=`*VAL*], `--metadata=`*KEY*[`:`*VAL*]
620
619
@@ -657,30 +656,30 @@ header when requesting a document from a URL:
657
656
658: Specifies what to do with insertions, deletions, and comments
657: Specifies what to do with insertions, deletions, and comments
659 produced by the MS Word "Track Changes" feature. `accept` (the
658 produced by the MS Word "Track Changes" feature. `accept` (the
660− default) processes all the insertions and deletions.
659+ default), inserts all insertions, and ignores all
660+ deletions. `reject` inserts all deletions and ignores
661− `reject` ignores them. Both `accept` and `reject` ignore comments.
661+ insertions. Both `accept` and `reject` ignore comments. `all` puts
662− `all` includes all insertions, deletions, and comments, wrapped
662+ in insertions, deletions, and comments, wrapped in spans with
663− in spans with `insertion`, `deletion`, `comment-start`, and
663+ `insertion`, `deletion`, `comment-start`, and `comment-end`
664− `comment-end` classes, respectively. The author and time of
664+ classes, respectively. The author and time of change is
665− change is included. `all` is useful for scripting: only
665+ included. `all` is useful for scripting: only accepting changes
666− accepting changes from a certain reviewer, say, or before a
666+ from a certain reviewer, say, or before a certain date. If a
667− certain date. If a paragraph is inserted or deleted,
667+ paragraph is inserted or deleted, `track-changes=all` produces a
668− `track-changes=all` produces a span with the class
669− `paragraph-insertion`/`paragraph-deletion` before the
668+ span with the class `paragraph-insertion`/`paragraph-deletion`
670− affected paragraph break. This option only affects the docx
669+ before the affected paragraph break. This option only affects the
671− reader.
670+ docx reader.
672
671
673`--extract-media=`*DIR*
672`--extract-media=`*DIR*
674
673
675: Extract images and other media contained in or linked from
674: Extract images and other media contained in or linked from
676 the source document to the path *DIR*, creating it if
675 the source document to the path *DIR*, creating it if
677 necessary, and adjust the images references in the document
676 necessary, and adjust the images references in the document
678− so they point to the extracted files. Media are downloaded,
677+ so they point to the extracted files. If the source format is
679− read from the file system, or extracted from a binary
678+ a binary container (docx, epub, or odt), the media is
680− container (e.g. docx), as needed. The original file paths
679+ extracted from the container and the original
681− are used if they are relative paths not containing `..`.
680+ filenames are used. Otherwise the media is read from the
682− Otherwise filenames are constructed from the SHA1 hash of
681+ file system or downloaded, and new filenames are constructed
683− the contents.
682+ based on SHA1 hashes of the contents.
684
683
685`--abbreviations=`*FILE*
684`--abbreviations=`*FILE*
686
685
@@ -691,15 +690,14 @@ header when requesting a document from a URL:
691 system default, use
690 system default, use
692 `pandoc --print-default-data-file=abbreviations`. The only
691 `pandoc --print-default-data-file=abbreviations`. The only
693 use pandoc makes of this list is in the Markdown reader.
692 use pandoc makes of this list is in the Markdown reader.
694− Strings found in this list will be followed by a nonbreaking
693+ Strings ending in a period that are found in this list will
694+ be followed by a nonbreaking space, so that the period will
695− space, and the period will not produce sentence-ending space
695+ not produce sentence-ending space in formats like LaTeX.
696− in formats like LaTeX. The strings may not contain spaces.
697
696
698[`pandocfilters`]: https://github.com/jgm/pandocfilters
697[`pandocfilters`]: https://github.com/jgm/pandocfilters
699[PHP]: https://github.com/vinai/pandocfilters-php
698[PHP]: https://github.com/vinai/pandocfilters-php
700[perl]: https://metacpan.org/pod/Pandoc::Filter
699[perl]: https://metacpan.org/pod/Pandoc::Filter
701[JavaScript/node.js]: https://github.com/mvhenderson/pandoc-filter-node
700[JavaScript/node.js]: https://github.com/mvhenderson/pandoc-filter-node
702−[Lua filters documentation]: https://pandoc.org/lua-filters.html
703
701
704## General writer options {.options}
702## General writer options {.options}
705
703
@@ -891,11 +889,11 @@ header when requesting a document from a URL:
891 will not be searched. For example:
889 will not be searched. For example:
892 `--resource-path=.:test` will search the working directory
890 `--resource-path=.:test` will search the working directory
893 and the `test` subdirectory, in that order.
891 and the `test` subdirectory, in that order.
894− This option can be used repeatedly. Search path components
892+
895− that come later on the command line will be searched before
893+ `--resource-path` only has an effect if (a) the output
896− those that come earlier, so
894+ format embeds images (for example, `docx`, `pdf`, or `html`
897− `--resource-path foo:bar --resource-path baz:bim` is
895+ with `--self-contained`) or (b) it is used together with
898− equivalent to `--resource-path baz:bim:foo:bar`.
896+ `--extract-media`.
899
897
900`--request-header=`*NAME*`:`*VAL*
898`--request-header=`*NAME*`:`*VAL*
901
899
@@ -905,9 +903,9 @@ header when requesting a document from a URL:
905 downloaded). If you're behind a proxy, you also need to set
903 downloaded). If you're behind a proxy, you also need to set
906 the environment variable `http_proxy` to `http://...`.
904 the environment variable `http_proxy` to `http://...`.
907
905
908−`--no-check-certificate`
906+`--no-check-certificate
909
907
910−: Disable the certificate verification to allow access to
908+: Disable the certificate verification to allow access to
911 unsecure HTTP resources (for example when the certificate
909 unsecure HTTP resources (for example when the certificate
912 is no longer valid or self signed).
910 is no longer valid or self signed).
913
911
@@ -936,9 +934,7 @@ header when requesting a document from a URL:
936
934
937`--html-q-tags`
935`--html-q-tags`
938
936
939−: Use `<q>` tags for quotes in HTML. (This option only has an
937+: Use `<q>` tags for quotes in HTML.
940− effect if the `smart` extension is enabled for the input
941− format used.)
942
938
943`--ascii`
939`--ascii`
944
940
@@ -956,45 +952,37 @@ header when requesting a document from a URL:
956 placement of link references is affected by the
952 placement of link references is affected by the
957 `--reference-location` option.
953 `--reference-location` option.
958
954
959−`--reference-location=block`|`section`|`document`
955+`--reference-location = block`|`section`|`document`
960
956
961: Specify whether footnotes (and references, if `reference-links` is
957: Specify whether footnotes (and references, if `reference-links` is
962 set) are placed at the end of the current (top-level) block, the
958 set) are placed at the end of the current (top-level) block, the
963 current section, or the document. The default is
959 current section, or the document. The default is
964 `document`. Currently only affects the markdown writer.
960 `document`. Currently only affects the markdown writer.
965
961
966−`--markdown-headings=setext`|`atx`
967−
968−: Specify whether to use ATX-style (`#`-prefixed) or
969− Setext-style (underlined) headings for level 1 and 2
970− headings in Markdown output. (The default is `atx`.)
971− ATX-style headings are always used for levels 3+.
972− This option also affects Markdown cells in `ipynb` output.
973−
974`--atx-headers`
962`--atx-headers`
975
963
976−: *Deprecated synonym for `--markdown-headings=atx`.*
964+: Use ATX-style headings in Markdown output. The default is
965+ to use setext-style headings for levels 1 to 2, and then ATX headings.
966+ (Note: for `gfm` output, ATX headings are always used.)
967+ This option also affects markdown cells in `ipynb` output.
977
968
978−`--top-level-division=default`|`section`|`chapter`|`part`
969+`--top-level-division=[default|section|chapter|part]`
979
970
980−: Treat top-level headings as the given division type in
971+: Treat top-level headings as the given division type in LaTeX, ConTeXt,
981− LaTeX, ConTeXt, DocBook, and TEI output. The hierarchy
972+ DocBook, and TEI output. The hierarchy order is part, chapter, then section;
982− order is part, chapter, then section; all headings are
983− shifted such that the top-level heading becomes the
973+ all headings are shifted such that the top-level heading becomes the specified
984− specified type. The default behavior is to determine the
974+ type. The default behavior is to determine the best division type via
985− best division type via heuristics: unless other conditions
975+ heuristics: unless other conditions apply, `section` is chosen. When the
986− apply, `section` is chosen. When the `documentclass`
987− variable is set to `report`, `book`, or `memoir` (unless the
976+ `documentclass` variable is set to `report`, `book`, or `memoir` (unless the
988− `article` option is specified), `chapter` is implied as the
977+ `article` option is specified), `chapter` is implied as the setting for this
989− setting for this option. If `beamer` is the output format,
978+ option. If `beamer` is the output format, specifying either `chapter` or
990− specifying either `chapter` or `part` will cause top-level
991− headings to become `\part{..}`, while second-level headings
979+ `part` will cause top-level headings to become `\part{..}`, while
992− remain as their default type.
980+ second-level headings remain as their default type.
993
981
994`-N`, `--number-sections`
982`-N`, `--number-sections`
995
983
996−: Number section headings in LaTeX, ConTeXt, HTML, Docx, ms, or EPUB
984+: Number section headings in LaTeX, ConTeXt, HTML, or EPUB output.
997− output. By default, sections are not numbered. Sections with class
985+ By default, sections are not numbered. Sections with class
998 `unnumbered` will never be numbered, even if `--number-sections`
986 `unnumbered` will never be numbered, even if `--number-sections`
999 is specified.
987 is specified.
1000
988
@@ -1136,7 +1124,6 @@ header when requesting a document from a URL:
1136 - Verbatim Char
1124 - Verbatim Char
1137 - Footnote Reference
1125 - Footnote Reference
1138 - Hyperlink
1126 - Hyperlink
1139− - Section Number
1140
1127
1141 Table style:
1128 Table style:
1142
1129
@@ -1303,77 +1290,50 @@ header when requesting a document from a URL:
1303
1290
1304## Citation rendering {.options}
1291## Citation rendering {.options}
1305
1292
1306−`-C`, `--citeproc`
1307−
1308−: Process the citations in the file, replacing them with
1309− rendered citations and adding a bibliography.
1310− Citation processing will not take place unless bibliographic
1311− data is supplied, either through an external file specified
1312− using the `--bibliography` option or the `bibliography`
1313− field in metadata, or via a `references` section in metadata
1314− containing a list of citations in CSL YAML format with
1315− Markdown formatting. The style is controlled by a [CSL]
1316− stylesheet specified using the `--csl` option or the `csl`
1317− field in metadata. (If no stylesheet is specified,
1318− the `chicago-author-date` style will be used by default.)
1319− The citation processing transformation may be applied before
1320− or after filters or Lua filters (see `--filter`,
1321− `--lua-filter`): these transformations are applied in the
1322− order they appear on the command line. For more
1323− information, see the section on [Citations].
1324−
1325`--bibliography=`*FILE*
1293`--bibliography=`*FILE*
1326
1294
1327: Set the `bibliography` field in the document's metadata to *FILE*,
1295: Set the `bibliography` field in the document's metadata to *FILE*,
1328− overriding any value set in the metadata. If you supply
1296+ overriding any value set in the metadata, and process citations
1297+ using `pandoc-citeproc`. (This is equivalent to
1298+ `--metadata bibliography=FILE --filter pandoc-citeproc`.)
1299+ If `--natbib` or `--biblatex` is also supplied, `pandoc-citeproc` is not
1300+ used, making this equivalent to `--metadata bibliography=FILE`.
1329− this argument multiple times, each *FILE* will be added to
1301+ If you supply this argument multiple times, each *FILE* will be added
1330− bibliography. If *FILE* is a URL, it will be fetched
1302+ to bibliography.
1331− via HTTP. If *FILE* is not found relative to the
1332− working directory, it will be sought in the resource path
1333− (see `--resource-path`).
1334
1303
1335`--csl=`*FILE*
1304`--csl=`*FILE*
1336
1305
1337: Set the `csl` field in the document's metadata to *FILE*,
1306: Set the `csl` field in the document's metadata to *FILE*,
1338 overriding any value set in the metadata. (This is equivalent to
1307 overriding any value set in the metadata. (This is equivalent to
1339− `--metadata csl=FILE`.) If *FILE* is a URL, it will be
1308+ `--metadata csl=FILE`.)
1340− fetched via HTTP. If *FILE* is not found relative to the
1309+ This option is only relevant with `pandoc-citeproc`.
1341− working directory, it will be sought in the resource path
1342− (see `--resource-path`) and finally in the `csl`
1343− subdirectory of the pandoc user data directory.
1344
1310
1345`--citation-abbreviations=`*FILE*
1311`--citation-abbreviations=`*FILE*
1346
1312
1347: Set the `citation-abbreviations` field in the document's metadata to
1313: Set the `citation-abbreviations` field in the document's metadata to
1348 *FILE*, overriding any value set in the metadata. (This is equivalent to
1314 *FILE*, overriding any value set in the metadata. (This is equivalent to
1349 `--metadata citation-abbreviations=FILE`.)
1315 `--metadata citation-abbreviations=FILE`.)
1350− If *FILE* is a URL, it will be fetched via HTTP. If *FILE* is not
1316+ This option is only relevant with `pandoc-citeproc`.
1351− found relative to the working directory, it will be sought
1352− in the resource path (see `--resource-path`) and finally in
1353− the `csl` subdirectory of the pandoc user data directory.
1354
1317
1355`--natbib`
1318`--natbib`
1356
1319
1357−: Use [`natbib`] for citations in LaTeX output. This option
1320+: Use [`natbib`] for citations in LaTeX output. This option is not for use
1358− is not for use with the `--citeproc` option or with PDF
1321+ with the `pandoc-citeproc` filter or with PDF output. It is intended for
1359− output. It is intended for use in producing a LaTeX file
1360− that can be processed with [`bibtex`].
1322+ use in producing a LaTeX file that can be processed with [`bibtex`].
1361
1323
1362`--biblatex`
1324`--biblatex`
1363
1325
1364−: Use [`biblatex`] for citations in LaTeX output. This option
1326+: Use [`biblatex`] for citations in LaTeX output. This option is not for use
1365− is not for use with the `--citeproc` option or with PDF
1327+ with the `pandoc-citeproc` filter or with PDF output. It is intended for
1366− output. It is intended for use in producing a LaTeX file
1367− that can be processed with [`bibtex`] or [`biber`].
1328+ use in producing a LaTeX file that can be processed with [`bibtex`] or [`biber`].
1368
1329
1369## Math rendering in HTML {.options}
1330## Math rendering in HTML {.options}
1370
1331
1371−The default is to render TeX math as far as possible using
1332+The default is to render TeX math as far as possible using Unicode characters.
1372−Unicode characters. Formulas are put inside a `span` with
1373−`class="math"`, so that they may be styled differently from the
1333+Formulas are put inside a `span` with `class="math"`, so that they may be styled
1374−surrounding text if needed. However, this gives acceptable
1334+differently from the surrounding text if needed. However, this gives acceptable
1375−results only for basic math, usually you will want to use
1335+results only for basic math, usually you will want to use `--mathjax` or another
1376−`--mathjax` or another of the following options.
1336+of the following options.
1377
1337
1378`--mathjax`[`=`*URL*]
1338`--mathjax`[`=`*URL*]
1379
1339
@@ -1387,11 +1347,10 @@ results only for basic math, usually you will want to use
1387
1347
1388`--mathml`
1348`--mathml`
1389
1349
1390−: Convert TeX math to [MathML] (in `epub3`, `docbook4`,
1350+: Convert TeX math to [MathML] (in `epub3`, `docbook4`, `docbook5`, `jats`,
1391− `docbook5`, `jats`, `html4` and `html5`). This is the
1392− default in `odt` output. Note that currently only Firefox
1351+ `html4` and `html5`). This is the default in `odt` output. Note that
1393− and Safari (and select e-book readers) natively support
1352+ currently only Firefox and Safari (and select e-book readers) natively
1394− MathML.
1353+ support MathML.
1395
1354
1396`--webtex`[`=`*URL*]
1355`--webtex`[`=`*URL*]
1397
1356
@@ -1415,12 +1374,13 @@ results only for basic math, usually you will want to use
1415`--gladtex`
1374`--gladtex`
1416
1375
1417: Enclose TeX math in `<eq>` tags in HTML output. The resulting HTML
1376: Enclose TeX math in `<eq>` tags in HTML output. The resulting HTML
1418− can then be processed by [GladTeX] to produce SVG images of the typeset
1377+ can then be processed by [GladTeX] to produce images of the typeset
1419− formulas and an HTML file with these images embedded.
1378+ formulas and an HTML file with links to these images.
1379+ So, the procedure is:
1420
1380
1421 pandoc -s --gladtex input.md -o myfile.htex
1381 pandoc -s --gladtex input.md -o myfile.htex
1422− gladtex -d image_dir myfile.htex
1382+ gladtex -d myfile-images myfile.htex
1423− # produces myfile.html and images in image_dir
1383+ # produces myfile.html and images in myfile-images
1424
1384
1425[MathML]: https://www.w3.org/Math/
1385[MathML]: https://www.w3.org/Math/
1426[MathJax]: https://www.mathjax.org
1386[MathJax]: https://www.mathjax.org
@@ -1465,10 +1425,8 @@ Nonzero exit codes have the following meanings:
1465 21 PandocUnknownReaderError
1425 21 PandocUnknownReaderError
1466 22 PandocUnknownWriterError
1426 22 PandocUnknownWriterError
1467 23 PandocUnsupportedExtensionError
1427 23 PandocUnsupportedExtensionError
1468− 24 PandocCiteprocError
1469 31 PandocEpubSubdirectoryError
1428 31 PandocEpubSubdirectoryError
1470 43 PandocPDFError
1429 43 PandocPDFError
1471− 44 PandocXMLError
1472 47 PandocPDFProgramNotFoundError
1430 47 PandocPDFProgramNotFoundError
1473 61 PandocHttpError
1431 61 PandocHttpError
1474 62 PandocShouldNeverHappenError
1432 62 PandocShouldNeverHappenError
@@ -1481,7 +1439,6 @@ Nonzero exit codes have the following meanings:
1481 91 PandocMacroLoop
1439 91 PandocMacroLoop
1482 92 PandocUTF8DecodingError
1440 92 PandocUTF8DecodingError
1483 93 PandocIpynbDecodingError
1441 93 PandocIpynbDecodingError
1484− 94 PandocUnsupportedCharsetError
1485 97 PandocCouldNotFindDataFileError
1442 97 PandocCouldNotFindDataFileError
1486 99 PandocResourceNotFound
1443 99 PandocResourceNotFound
1487----- ------------------------------------
1444----- ------------------------------------
@@ -1506,16 +1463,6 @@ input-files:
1506- content.md
1463- content.md
1507# or you may use input-file: with a single value
1464# or you may use input-file: with a single value
1508
1465
1509−# Include options from the specified defaults files.
1510−# The files will be searched for first in the working directory
1511−# and then in the defaults subdirectory of the user data directory.
1512−# The files are included in the same order in which they appear in
1513−# the list. Options specified in this defaults file always have
1514−# priority over the included ones.
1515−defaults:
1516−- defsA
1517−- defsB
1518−
1519template: letter
1466template: letter
1520standalone: true
1467standalone: true
1521self-contained: false
1468self-contained: false
@@ -1543,24 +1490,11 @@ include-after-body: []
1543include-in-header: []
1490include-in-header: []
1544resource-path: ["."]
1491resource-path: ["."]
1545
1492
1546−# turn on built-in citation processing. Note that if you need
1547−# control over when the citeproc processing is done relative
1548−# to other filters, you should instead use `citeproc` in the
1549−# list of `filters` (see below).
1550−citeproc: true
1551−csl: ieee
1552−bibliography:
1553−- foobar.bib
1554−- barbaz.json
1555−citation-abbreviations: abbrevs.json
1556−
1557−# Filters will be assumed to be Lua filters if they have
1493+# filters will be assumed to be Lua filters if they have
1558# the .lua extension, and json filters otherwise. But
1494# the .lua extension, and json filters otherwise. But
1559−# the filter type can also be specified explicitly, as shown.
1495+# the filter type can also be specified explicitly, as shown:
1560−# Filters are run in the order specified.
1561−# To include the built-in citeproc filter, use either `citeproc`
1562−# or `{type: citeproc}`.
1563filters:
1496filters:
1497+- pandoc-citeproc
1564- wordcount.lua
1498- wordcount.lua
1565- type: json
1499- type: json
1566 path: foo.lua
1500 path: foo.lua
@@ -1573,11 +1507,8 @@ data-dir:
1573verbosity: INFO
1507verbosity: INFO
1574log-file: log.json
1508log-file: log.json
1575
1509
1576−# citeproc, natbib, or biblatex. This only affects LaTeX
1510+# citeproc, natbib, or biblatex
1577−# output. If you want to use citeproc to format citations,
1578−# you should also set 'citeproc: true' (see above).
1579cite-method: citeproc
1511cite-method: citeproc
1580−
1581# part, chapter, section, or default:
1512# part, chapter, section, or default:
1582top-level-division: chapter
1513top-level-division: chapter
1583abbreviations:
1514abbreviations:
@@ -1646,7 +1577,7 @@ epub-cover-image: cover.jpg
1646reference-links: true
1577reference-links: true
1647# block, section, or document
1578# block, section, or document
1648reference-location: block
1579reference-location: block
1649−markdown-headings: setext
1580+atx-headers: false
1650
1581
1651# accept, reject, or all
1582# accept, reject, or all
1652track-changes: accept
1583track-changes: accept
@@ -1676,34 +1607,6 @@ one line:
1676verbosity: INFO
1607verbosity: INFO
1677```
1608```
1678
1609
1679−In fields that expect a file path (or list of file paths), the
1680−following syntax may be used to interpolate environment variables:
1681−
1682−``` yaml
1683−csl: ${HOME}/mycsldir/special.csl
1684−```
1685−
1686−`${USERDATA}` may also be used; this will always resolve to the
1687−user data directory that is current when the defaults file is
1688−parsed, regardless of the setting of the environment
1689−variable `USERDATA`.
1690−
1691−`${.}` will resolve to the directory containing the default
1692−file itself. This allows you to refer to resources contained
1693−in that directory:
1694−
1695−``` yaml
1696−epub-cover-image: ${.}/cover.jpg
1697−epub-metadata: ${.}/meta.xml
1698−resource-path:
1699−- . # the working directory from which pandoc is run
1700−- ${.}/images # the images subdirectory of the directory
1701− # containing this defaults file
1702−```
1703−
1704−This environment variable interpolation syntax *only* works in
1705−fields that expect file paths.
1706−
1707Default files can be placed in the `defaults` subdirectory of
1610Default files can be placed in the `defaults` subdirectory of
1708the user data directory and used from any directory. For
1611the user data directory and used from any directory. For
1709example, one could create a file specifying defaults for writing
1612example, one could create a file specifying defaults for writing
@@ -1913,26 +1816,17 @@ ${ endfor }
1913### Partials
1816### Partials
1914
1817
1915Partials (subtemplates stored in different files) may be
1818Partials (subtemplates stored in different files) may be
1916−included by using the name of the partial, followed
1819+included using the syntax
1917−by `()`, for example:
1918
1820
1919```
1821```
1920−${ styles() }
1822+${ boilerplate() }
1921```
1823```
1922
1824
1923Partials will be sought in the directory containing
1825Partials will be sought in the directory containing
1924−the main template. The file name will be assumed to
1826+the main template, and will be assumed to have the
1925−have the same extension as the main template if it
1827+same extension as the main template if they lack
1926−lacks an extension. When calling the partial, the
1828+an explicit extension. (If the partials are not
1927−full name including file extension can also be used:
1928−
1929−```
1930−${ styles.html() }
1931−```
1932−
1933−(If a partial is not found in the directory of the
1934−template and the template path is given as a relative
1935−path, it will also be sought in the `templates`
1829+found here, they will also be sought in the `templates`
1936subdirectory of the user data directory.)
1830subdirectory of the user data directory.)
1937
1831
1938Partials may optionally be applied to variables using
1832Partials may optionally be applied to variables using
@@ -2150,8 +2044,7 @@ Currently the following pipes are predefined:
2150 including a title block in the document itself, you can
2044 including a title block in the document itself, you can
2151 set the `title-meta`, `author-meta`, and `date-meta`
2045 set the `title-meta`, `author-meta`, and `date-meta`
2152 variables. (By default these are set automatically, based
2046 variables. (By default these are set automatically, based
2153− on `title`, `author`, and `date`.) The page title in HTML
2047+ on `title`, `author`, and `date`.)
2154− is set by `pagetitle`, which is equal to `title` by default.
2155
2048
2156`subtitle`
2049`subtitle`
2157: document subtitle, included in HTML, EPUB, LaTeX, ConTeXt, and docx
2050: document subtitle, included in HTML, EPUB, LaTeX, ConTeXt, and docx
@@ -2225,97 +2118,32 @@ ODT or pptx.
2225: the base script direction, either `rtl` (right-to-left)
2118: the base script direction, either `rtl` (right-to-left)
2226 or `ltr` (left-to-right).
2119 or `ltr` (left-to-right).
2227
2120
2228− For bidirectional documents, native pandoc `span`s and
2121+ For bidirectional documents, native pandoc `span`s and `div`s
2229− `div`s with the `dir` attribute (value `rtl` or `ltr`) can
2122+ with the `dir` attribute (value `rtl` or `ltr`) can be used to
2230− be used to override the base direction in some output
2123+ override the base direction in some output formats.
2231− formats. This may not always be necessary if the final
2124+ This may not always be necessary if the final renderer
2232− renderer (e.g. the browser, when generating HTML) supports
2125+ (e.g. the browser, when generating HTML) supports the
2233− the [Unicode Bidirectional Algorithm].
2126+ [Unicode Bidirectional Algorithm].
2234
2127
2235− When using LaTeX for bidirectional documents, only the
2128+ When using LaTeX for bidirectional documents, only the `xelatex` engine
2236− `xelatex` engine is fully supported (use
2237− `--pdf-engine=xelatex`).
2129+ is fully supported (use `--pdf-engine=xelatex`).
2238
2130
2239[BCP 47]: https://tools.ietf.org/html/bcp47
2131[BCP 47]: https://tools.ietf.org/html/bcp47
2240[Unicode Bidirectional Algorithm]: https://www.w3.org/International/articles/inline-bidi-markup/uba-basics
2132[Unicode Bidirectional Algorithm]: https://www.w3.org/International/articles/inline-bidi-markup/uba-basics
2241[Language subtag lookup]: https://r12a.github.io/app-subtags/
2133[Language subtag lookup]: https://r12a.github.io/app-subtags/
2242
2134
2243−### Variables for HTML
2244−
2245−`document-css`
2246−: Enables inclusion of most of the [CSS] in the `styles.html`
2247− [partial](#partials) (have a look with
2248− `pandoc --print-default-data-file=templates/styles.html`).
2249− Unless you use [`--css`](#option--css), this variable
2250− is set to `true` by default. You can disable it with
2251− e.g. `pandoc -M document-css=false`.
2252−
2253−`mainfont`
2254−: sets the CSS `font-family` property on the `html` element.
2255−
2256−`fontsize`
2257−: sets the base CSS `font-size`, which you'd usually set
2258− to e.g. `20px`, but it also accepts `pt`
2259− (12pt = 16px in most browsers).
2260−
2261−`fontcolor`
2262−: sets the CSS `color` property on the `html` element.
2263−
2264−`linkcolor`
2265−: sets the CSS `color` property on all links.
2266−
2267−`monofont`
2268−: sets the CSS `font-family` property on `code` elements.
2269−
2270−`monobackgroundcolor`
2271−: sets the CSS `background-color` property on `code` elements
2272− and adds extra padding.
2273−
2274−`linestretch`
2275−: sets the CSS `line-height` property on the `html` element,
2276− which is preferred to be unitless.
2277−
2278−`backgroundcolor`
2279−: sets the CSS `background-color` property on the `html` element.
2280−
2281−`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
2282−: sets the corresponding CSS `padding` properties on the `body` element.
2283−
2284−To override or extend some [CSS] for just one document, include for example:
2285−
2286− ---
2287− header-includes: |
2288− <style>
2289− blockquote {
2290− font-style: italic;
2291− }
2292− tr.even {
2293− background-color: #f0f0f0;
2294− }
2295− td, th {
2296− padding: 0.5em 2em 0.5em 0.5em;
2297− }
2298− tbody {
2299− border-bottom: none;
2300− }
2301− </style>
2302− ---
2303−
2304−[CSS]: https://developer.mozilla.org/en-US/docs/Learn/CSS
2305−
2306### Variables for HTML math
2135### Variables for HTML math
2307
2136
2308`classoption`
2137`classoption`
2309−: when using [KaTeX](#option--katex), you can render display
2138+: when using [KaTeX](#option--katex), you can render display math equations
2310−math equations flush left using [YAML metadata](#layout) or with
2139+ flush left using [YAML metadata](#layout) or with `-M classoption=fleqn`.
2311−`-M classoption=fleqn`.
2312
2140
2313### Variables for HTML slides
2141### Variables for HTML slides
2314
2142
2315These affect HTML output when [producing slide shows with pandoc].
2143These affect HTML output when [producing slide shows with pandoc].
2316
2144
2317−`institute`
2145+All [reveal.js configuration options] are available as variables.
2318−: author affiliations: can be a list when there are multiple authors
2146+To turn off boolean flags that default to true in reveal.js, use `0`.
2319
2147
2320`revealjs-url`
2148`revealjs-url`
2321: base URL for reveal.js documents (defaults to
2149: base URL for reveal.js documents (defaults to
@@ -2335,9 +2163,6 @@ These affect HTML output when [producing slide shows with pandoc].
2335: additional attributes for the title slide of reveal.js slide shows.
2163: additional attributes for the title slide of reveal.js slide shows.
2336 See [background in reveal.js and beamer] for an example.
2164 See [background in reveal.js and beamer] for an example.
2337
2165
2338−All [reveal.js configuration options] are available as variables.
2339−To turn off boolean flags that default to true in reveal.js, use `0`.
2340−
2341[reveal.js configuration options]: https://revealjs.com/config/
2166[reveal.js configuration options]: https://revealjs.com/config/
2342
2167
2343### Variables for Beamer slides
2168### Variables for Beamer slides
@@ -2423,10 +2248,9 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
2423 ...
2248 ...
2424
2249
2425`documentclass`
2250`documentclass`
2426−: document class: usually one of the standard classes,
2251+: document class: usually one of the standard classes, [`article`], [`book`],
2427− [`article`], [`book`], and [`report`]; the [KOMA-Script]
2428− equivalents, `scrartcl`, `scrbook`, and `scrreprt`, which
2252+ and [`report`]; the [KOMA-Script] equivalents, `scrartcl`, `scrbook`,
2429− default to smaller margins; or [`memoir`]
2253+ and `scrreprt`, which default to smaller margins; or [`memoir`]
2430
2254
2431`geometry`
2255`geometry`
2432: option for [`geometry`] package, e.g. `margin=1in`;
2256: option for [`geometry`] package, e.g. `margin=1in`;
@@ -2451,9 +2275,8 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
2451 ...
2275 ...
2452
2276
2453`indent`
2277`indent`
2454−: if true, pandoc will use document class settings for
2455− indentation (the default LaTeX template otherwise removes
2278+: uses document class settings for indentation (the default LaTeX template
2456− indentation and adds space between paragraphs)
2279+ otherwise removes indentation and adds space between paragraphs)
2457
2280
2458`linestretch`
2281`linestretch`
2459: adjusts line spacing using the [`setspace`]
2282: adjusts line spacing using the [`setspace`]
@@ -2478,8 +2301,8 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
2478#### Fonts
2301#### Fonts
2479
2302
2480`fontenc`
2303`fontenc`
2481−: allows font encoding to be specified through `fontenc` package (with
2304+: allows font encoding to be specified through `fontenc` package (with `pdflatex`);
2482− `pdflatex`); default is `T1` (see [LaTeX font encodings guide])
2305+ default is `T1` (see [LaTeX font encodings guide])
2483
2306
2484`fontfamily`
2307`fontfamily`
2485: font package for use with `pdflatex`:
2308: font package for use with `pdflatex`:
@@ -2549,8 +2372,7 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
2549: contents of acknowledgments footnote after document title
2372: contents of acknowledgments footnote after document title
2550
2373
2551`toc`
2374`toc`
2552−: include table of contents (can also be set using
2375+: include table of contents (can also be set using `--toc/--table-of-contents`)
2553− `--toc/--table-of-contents`)
2554
2376
2555`toc-depth`
2377`toc-depth`
2556: level of section to include in table of contents
2378: level of section to include in table of contents
@@ -2592,12 +2414,12 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
2592: font size for body text (e.g. `10pt`, `12pt`)
2414: font size for body text (e.g. `10pt`, `12pt`)
2593
2415
2594`headertext`, `footertext`
2416`headertext`, `footertext`
2595−: text to be placed in running header or footer (see [ConTeXt Headers and
2417+: text to be placed in running header or footer (see [ConTeXt Headers and Footers]);
2596− Footers]); repeat up to four times for different placement
2418+ repeat up to four times for different placement
2597
2419
2598`indenting`
2420`indenting`
2599−: controls indentation of paragraphs, e.g. `yes,small,next` (see
2421+: controls indentation of paragraphs, e.g. `yes,small,next` (see [ConTeXt Indentation]);
2600− [ConTeXt Indentation]); repeat for multiple options
2422+ repeat for multiple options
2601
2423
2602`interlinespace`
2424`interlinespace`
2603: adjusts line spacing, e.g. `4ex` (using [`setupinterlinespace`]);
2425: adjusts line spacing, e.g. `4ex` (using [`setupinterlinespace`]);
@@ -2608,19 +2430,16 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
2608 repeat for multiple options
2430 repeat for multiple options
2609
2431
2610`linkcolor`, `contrastcolor`
2432`linkcolor`, `contrastcolor`
2611−: color for links outside and inside a page, e.g. `red`, `blue` (see
2433+: color for links outside and inside a page, e.g. `red`, `blue` (see [ConTeXt Color])
2612− [ConTeXt Color])
2613
2434
2614`linkstyle`
2435`linkstyle`
2615−: typeface style for links, e.g. `normal`, `bold`, `slanted`, `boldslanted`,
2436+: typeface style for links, e.g. `normal`, `bold`, `slanted`, `boldslanted`, `type`, `cap`, `small`
2616− `type`, `cap`, `small`
2617
2437
2618`lof`, `lot`
2438`lof`, `lot`
2619: include list of figures, list of tables
2439: include list of figures, list of tables
2620
2440
2621`mainfont`, `sansfont`, `monofont`, `mathfont`
2441`mainfont`, `sansfont`, `monofont`, `mathfont`
2622−: font families: take the name of any system font (see
2442+: font families: take the name of any system font (see [ConTeXt Font Switching])
2623− [ConTeXt Font Switching])
2624
2443
2625`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
2444`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
2626: sets margins, if `layout` is not used (otherwise `layout`
2445: sets margins, if `layout` is not used (otherwise `layout`
@@ -2635,18 +2454,16 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
2635 repeat for multiple options
2454 repeat for multiple options
2636
2455
2637`pdfa`
2456`pdfa`
2638−: adds to the preamble the setup necessary to generate PDF/A
2457+: adds to the preamble the setup necessary to generate PDF/A of the type
2639− of the type specified, e.g. `1a:2005`, `2a`. If no type is
2458+ specified, e.g. `1a:2005`, `2a`. If no type is specified (i.e. the value
2640− specified (i.e. the value is set to True, by e.g.
2641− `--metadata=pdfa` or `pdfa: true` in a YAML metadata block),
2459+ is set to True, by e.g. `--metadata=pdfa` or `pdfa: true` in a YAML metadata
2642− `1b:2005` will be used as default, for reasons of backwards
2460+ block), `1b:2005` will be used as default, for reasons of backwards
2643− compatibility. Using `--variable=pdfa` without specified value
2461+ compatibility. Using `--variable=pdfa` without specified value is not supported.
2644− is not supported. To successfully generate PDF/A the required
2462+ To successfully generate PDF/A the required ICC color profiles have to
2645− ICC color profiles have to be available and the content and all
2463+ be available and the content and all included files (such as images)
2646− included files (such as images) have to be standard conforming.
2647− The ICC profiles and output intent may be specified using the
2464+ have to be standard conforming. The ICC profiles and output intent
2648− variables `pdfaiccprofile` and `pdfaintent`. See also [ConTeXt
2465+ may be specified using the variables `pdfaiccprofile` and `pdfaintent`.
2649− PDFA] for more details.
2466+ See also [ConTeXt PDFA] for more details.
2650
2467
2651`pdfaiccprofile`
2468`pdfaiccprofile`
2652: when used in conjunction with `pdfa`, specifies the ICC profile to use
2469: when used in conjunction with `pdfa`, specifies the ICC profile to use
@@ -2661,12 +2478,10 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
2661 If left unspecified, `sRGB IEC61966-2.1` is used as default.
2478 If left unspecified, `sRGB IEC61966-2.1` is used as default.
2662
2479
2663`toc`
2480`toc`
2664−: include table of contents (can also be set using
2481+: include table of contents (can also be set using `--toc/--table-of-contents`)
2665− `--toc/--table-of-contents`)
2666
2482
2667`whitespace`
2483`whitespace`
2668−: spacing between paragraphs, e.g. `none`, `small` (using
2484+: spacing between paragraphs, e.g. `none`, `small` (using [`setupwhitespace`])
2669− [`setupwhitespace`])
2670
2485
2671`includesource`
2486`includesource`
2672: include all source documents as file attachments in the PDF file
2487: include all source documents as file attachments in the PDF file
@@ -2945,43 +2760,53 @@ reading web pages formatted using MathJax, for example.
2945
2760
2946## Raw HTML/TeX
2761## Raw HTML/TeX
2947
2762
2763+The following extensions (especially how they affect Markdown
2948−The following extensions are described in more detail in
2764+input/output) are also described in more detail in their respective
2949−their respective sections of [Pandoc's Markdown]:
2765+sections of [Pandoc's Markdown].
2766+
2767+#### Extension: `raw_html` {#raw_html}
2768+
2769+When converting from HTML, parse elements to raw HTML which are not
2770+representable in pandoc's AST.
2771+By default, this is disabled for HTML input.
2950
2772
2951−- [`raw_html`](#extension-raw_html) allows HTML elements which
2773+#### Extension: `raw_tex` {#raw_tex}
2952− are not representable in pandoc's AST to be parsed as raw HTML.
2953− By default, this is disabled for HTML input.
2954
2774
2955−- [`raw_tex`](#extension-raw_tex) allows raw LaTeX, TeX, and ConTeXt
2956− to be included in a document. This extension can be enabled/disabled
2775+Allows raw LaTeX, TeX, and ConTeXt to be included in a document.
2957− for the following formats (in addition to `markdown`):
2958
2776
2959− input formats
2777+This extension can be enabled/disabled for the following formats
2960− : `latex`, `textile`, `html` (environments, `\ref`, and
2778+(in addition to `markdown`):
2961− `\eqref` only), `ipynb`
2962
2779
2780+input formats
2781+: `latex`, `org`, `textile`, `html` (environments, `\ref`, and
2782+ `\eqref` only), `ipynb`
2783+
2963− output formats
2784+output formats
2964− : `textile`, `commonmark`
2785+: `textile`, `commonmark`
2786+
2787+Note: as applied to `ipynb`, `raw_html` and `raw_tex` affect not
2788+only raw TeX in markdown cells, but data with mime type
2789+`text/html` in output cells. Since the `ipynb` reader attempts
2790+to preserve the richest possible outputs when several options
2791+are given, you will get best results if you disable `raw_html`
2792+and `raw_tex` when converting to formats like `docx` which don't
2793+allow raw `html` or `tex`.
2794+
2795+#### Extension: `native_divs` {#native_divs}
2796+
2797+This extension is enabled by default for HTML input. This means that
2798+`div`s are parsed to pandoc native elements. (Alternatively, you
2799+can parse them to raw HTML using `-f html-native_divs+raw_html`.)
2965
2800
2966− Note: as applied to `ipynb`, `raw_html` and `raw_tex` affect not
2801+When converting HTML to Markdown, for example, you may want to drop all
2967− only raw TeX in markdown cells, but data with mime type
2802+`div`s and `span`s:
2968− `text/html` in output cells. Since the `ipynb` reader attempts
2969− to preserve the richest possible outputs when several options
2970− are given, you will get best results if you disable `raw_html`
2971− and `raw_tex` when converting to formats like `docx` which don't
2972− allow raw `html` or `tex`.
2973
2803
2974−- [`native_divs`](#extension-native_divs) causes HTML `div`
2975− elements to be parsed as native pandoc Div blocks.
2976− If you want them to be parsed as raw HTML, use
2977− `-f html-native_divs+raw_html`.
2804+ pandoc -f html-native_divs-native_spans -t markdown
2805+
2806+#### Extension: `native_spans` {#native_spans}
2807+
2808+Analogous to `native_divs` above.
2978
2809
2979−- [`native_spans`](#extension-native_spans) causes HTML `span`
2980− elements to be parsed as native pandoc Span inlines.
2981− If you want them to be parsed as raw HTML, use
2982− `-f html-native_spans+raw_html`. If you want to drop all
2983− `div`s and `span`s when converting HTML to Markdown, you
2984− can use `pandoc -f html-native_divs-native_spans -t markdown`.
2985
2810
2986## Literate Haskell support
2811## Literate Haskell support
2987
2812
@@ -3069,44 +2894,7 @@ This extension can be enabled/disabled for the following formats:
3069output formats
2894output formats
3070: `odt`, `opendocument`
2895: `odt`, `opendocument`
3071
2896
3072−#### Extension: `xrefs_name` ####
3073−
3074−Links to headings, figures and tables inside the document are
3075−substituted with cross-references that will use the name or caption
3076−of the referenced item. The original link text is replaced once
3077−the generated document is refreshed. This extension can be combined
3078−with `xrefs_number` in which case numbers will appear before the
3079−name.
3080−
3081−Text in cross-references is only made consistent with the referenced
3082−item once the document has been refreshed.
3083−
3084−This extension can be enabled/disabled for the following formats:
3085−
3086−output formats
3087−: `odt`, `opendocument`
3088−
3089−#### Extension: `xrefs_number` ####
3090−
3091−Links to headings, figures and tables inside the document are
3092−substituted with cross-references that will use the number
3093−of the referenced item. The original link text is discarded.
3094−This extension can be combined with `xrefs_name` in which case
3095−the name or caption numbers will appear after the number.
3096−
3097−For the `xrefs_number` to be useful heading numbers must be enabled
3098−in the generated document, also table and figure captions must be enabled
3099−using for example the `native_numbering` extension.
3100−
3101−Numbers in cross-references are only visible in the final document once
3102−it has been refreshed.
3103−
3104−This extension can be enabled/disabled for the following formats:
3105−
3106−output formats
3107−: `odt`, `opendocument`
3108−
3109−#### Extension: `styles` #### {#ext-styles}
2897+#### Extension: `styles` {#ext-styles} ####
3110
2898
3111When converting from docx, read all docx styles as divs (for
2899When converting from docx, read all docx styles as divs (for
3112paragraph styles) and spans (for character styles) regardless
2900paragraph styles) and spans (for character styles) regardless
@@ -3122,25 +2910,10 @@ input formats
3122In the `muse` input format, this enables Text::Amuse
2910In the `muse` input format, this enables Text::Amuse
3123extensions to Emacs Muse markup.
2911extensions to Emacs Muse markup.
3124
2912
3125−#### Extension: `raw_markdown` ####
3126−
3127−In the `ipynb` input format, this causes Markdown cells
3128−to be included as raw Markdown blocks (allowing lossless
3129−round-tripping) rather than being parsed. Use this only
3130−when you are targeting `ipynb` or a markdown-based
3131−output format.
3132−
3133#### Extension: `citations` {#org-citations}
2913#### Extension: `citations` {#org-citations}
3134
2914
3135−Some aspects of [Pandoc's Markdown citation syntax](#citations)
2915+Some aspects of [Pandoc's Markdown citation syntax](#citations) are also accepted
3136−are also accepted in `org` input.
2916+in `org` input.
3137−
3138−#### Extension: `element_citations` ####
3139−
3140−In the `jats` output formats, this causes reference items to
3141−be replaced with `<element-citation>` elements. These
3142−elements are not influenced by CSL styles, but all information
3143−on the item is included in tags.
3144
2917
3145#### Extension: `ntb` ####
2918#### Extension: `ntb` ####
3146
2919
@@ -3248,8 +3021,7 @@ pandoc does require the space.
3248
3021
3249### Heading identifiers ###
3022### Heading identifiers ###
3250
3023
3251−See also the [`auto_identifiers`
3252−extension](#extension-auto_identifiers) above.
3024+See also the [`auto_identifiers` extension](#extension-auto_identifiers) above.
3253
3025
3254#### Extension: `header_attributes` ####
3026#### Extension: `header_attributes` ####
3255
3027
@@ -3371,12 +3143,11 @@ block in a block quote, you need five spaces after the `>`:
3371
3143
3372#### Extension: `blank_before_blockquote` ####
3144#### Extension: `blank_before_blockquote` ####
3373
3145
3374−Standard Markdown syntax does not require a blank line before a
3146+Standard Markdown syntax does not require a blank line before a block
3375−block quote. Pandoc does require this (except, of course, at
3147+quote. Pandoc does require this (except, of course, at the beginning of the
3376−the beginning of the document). The reason for the requirement
3148+document). The reason for the requirement is that it is all too easy for a
3377−is that it is all too easy for a `>` to end up at the beginning
3378−of a line by accident (perhaps through line wrapping). So,
3149+`>` to end up at the beginning of a line by accident (perhaps through line
3379−unless the `markdown_strict` format is used, the following does
3150+wrapping). So, unless the `markdown_strict` format is used, the following does
3380not produce a nested block quote in pandoc:
3151not produce a nested block quote in pandoc:
3381
3152
3382 > This is a block quote.
3153 > This is a block quote.
@@ -3445,16 +3216,14 @@ this syntax:
3445 qsort (filter (>= x) xs)
3216 qsort (filter (>= x) xs)
3446 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3217 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3447
3218
3448−Here `mycode` is an identifier, `haskell` and `numberLines` are
3219+Here `mycode` is an identifier, `haskell` and `numberLines` are classes, and
3449−classes, and `startFrom` is an attribute with value `100`. Some
3220+`startFrom` is an attribute with value `100`. Some output formats can use this
3450−output formats can use this information to do syntax
3451−highlighting. Currently, the only output formats that uses this
3221+information to do syntax highlighting. Currently, the only output formats
3452−information are HTML, LaTeX, Docx, Ms, and PowerPoint. If
3222+that uses this information are HTML, LaTeX, Docx, Ms, and PowerPoint. If
3453−highlighting is supported for your output format and language,
3223+highlighting is supported for your output format and language, then the code
3454−then the code block above will appear highlighted, with numbered
3224+block above will appear highlighted, with numbered lines. (To see which
3455−lines. (To see which languages are supported, type `pandoc
3225+languages are supported, type `pandoc --list-highlight-languages`.) Otherwise,
3456−--list-highlight-languages`.) Otherwise, the code block above
3457−will appear as follows:
3226+the code block above will appear as follows:
3458
3227
3459 <pre id="mycode" class="haskell numberLines" startFrom="100">
3228 <pre id="mycode" class="haskell numberLines" startFrom="100">
3460 <code>
3229 <code>
@@ -3517,9 +3286,6 @@ line must begin with a space.
3517 | 200 Main St.
3286 | 200 Main St.
3518 | Berkeley, CA 94718
3287 | Berkeley, CA 94718
3519
3288
3520−Inline formatting (such as emphasis) is allowed in the content,
3521−but not block-level formatting (such as block quotes or lists).
3522−
3523This syntax is borrowed from [reStructuredText].
3289This syntax is borrowed from [reStructuredText].
3524
3290
3525## Lists
3291## Lists
@@ -3723,12 +3489,11 @@ a blank line, and must be followed by one or more definitions.
3723A definition begins with a colon or tilde, which may be indented one
3489A definition begins with a colon or tilde, which may be indented one
3724or two spaces.
3490or two spaces.
3725
3491
3726−A term may have multiple definitions, and each definition may
3492+A term may have multiple definitions, and each definition may consist of one or
3727−consist of one or more block elements (paragraph, code block,
3493+more block elements (paragraph, code block, list, etc.), each indented four
3728−list, etc.), each indented four spaces or one tab stop. The
3729−body of the definition (including the first line, aside from the
3494+spaces or one tab stop. The body of the definition (including the first line,
3730−colon or tilde) should be indented four spaces. However, as with
3495+aside from the colon or tilde) should be indented four spaces. However,
3731−other Markdown lists, you can "lazily" omit indentation except
3496+as with other Markdown lists, you can "lazily" omit indentation except
3732at the beginning of a paragraph or other block element:
3497at the beginning of a paragraph or other block element:
3733
3498
3734 Term 1
3499 Term 1
@@ -3754,10 +3519,9 @@ definition:
3754Note that space between items in a definition list is required.
3519Note that space between items in a definition list is required.
3755(A variant that loosens this requirement, but disallows "lazy"
3520(A variant that loosens this requirement, but disallows "lazy"
3756hard wrapping, can be activated with `compact_definition_lists`: see
3521hard wrapping, can be activated with `compact_definition_lists`: see
3757−[Non-default extensions], below.)
3522+[Non-pandoc extensions], below.)
3758
3523
3759−[^3]: I have been influenced by the suggestions of [David
3760− Wheeler](https://justatheory.com/2009/02/modest-markdown-proposal/).
3524+[^3]: I have been influenced by the suggestions of [David Wheeler](https://justatheory.com/2009/02/modest-markdown-proposal/).
3761
3525
3762### Numbered example lists ###
3526### Numbered example lists ###
3763
3527
@@ -3793,6 +3557,30 @@ list marker. That is, example lists always behave as if the
3793labels tend to be long, and indenting content to the
3557labels tend to be long, and indenting content to the
3794first non-space character after the label would be awkward.
3558first non-space character after the label would be awkward.
3795
3559
3560+### Compact and loose lists ###
3561+
3562+Pandoc behaves differently from `Markdown.pl` on some "edge
3563+cases" involving lists. Consider this source:
3564+
3565+ + First
3566+ + Second:
3567+ - Fee
3568+ - Fie
3569+ - Foe
3570+
3571+ + Third
3572+
3573+Pandoc transforms this into a "compact list" (with no `<p>` tags around
3574+"First", "Second", or "Third"), while Markdown puts `<p>` tags around
3575+"Second" and "Third" (but not "First"), because of the blank space
3576+around "Third". Pandoc follows a simple rule: if the text is followed by
3577+a blank line, it is treated as a paragraph. Since "Second" is followed
3578+by a list, and not a blank line, it isn't treated as a paragraph. The
3579+fact that the list is followed by a blank line is irrelevant. (Note:
3580+Pandoc works this way even when the `markdown_strict` format is specified. This
3581+behavior is consistent with the official Markdown syntax description,
3582+even though it is different from that of `Markdown.pl`.)
3583+
3796
3584
3797### Ending a list ###
3585### Ending a list ###
3798
3586
@@ -4179,12 +3967,10 @@ option is used. All of the metadata will appear in a single block
4179at the beginning of the document.
3967at the beginning of the document.
4180
3968
4181Note that [YAML] escaping rules must be followed. Thus, for example,
3969Note that [YAML] escaping rules must be followed. Thus, for example,
4182−if a title contains a colon, it must be quoted, and if it contains a
3970+if a title contains a colon, it must be quoted. The pipe character
4183−backslash escape, then it must be ensured that it is not treated as a
4184−[YAML escape sequence]. The pipe character (`|`) can be used to begin
4185−an indented block that will be interpreted literally, without need for
3971+(`|`) can be used to begin an indented block that will be interpreted
4186−escaping. This form is necessary when the field contains blank lines
3972+literally, without need for escaping. This form is necessary
4187−or block-level formatting:
3973+when the field contains blank lines or block-level formatting:
4188
3974
4189 ---
3975 ---
4190 title: 'This is the title: it contains a colon'
3976 title: 'This is the title: it contains a colon'
@@ -4198,12 +3984,6 @@ or block-level formatting:
4198 It consists of two paragraphs.
3984 It consists of two paragraphs.
4199 ...
3985 ...
4200
3986
4201−The literal block after the `|` must be indented relative to the
4202−line containing the `|`. If it is not, the YAML will be invalid
4203−and pandoc will not interpret it as metadata. For an overview
4204−of the complex rules governing YAML, see the [Wikipedia entry on
4205−YAML syntax].
4206−
4207Template variables will be set automatically from the metadata. Thus, for
3987Template variables will be set automatically from the metadata. Thus, for
4208example, in writing HTML, the variable `abstract` will be set to the HTML
3988example, in writing HTML, the variable `abstract` will be set to the HTML
4209equivalent of the Markdown in the `abstract` field:
3989equivalent of the Markdown in the `abstract` field:
@@ -4250,24 +4030,6 @@ will be interpreted as markdown. For example:
4250 \renewcommand{\section}[1]{\clearpage\oldsection{#1}}
4030 \renewcommand{\section}[1]{\clearpage\oldsection{#1}}
4251 ```
4031 ```
4252
4032
4253−Note: the `yaml_metadata_block` extension works with
4254−`commonmark` as well as `markdown` (and it is enabled by default
4255−in `gfm` and `commonmark_x`). However, in these formats the
4256−following restrictions apply:
4257−
4258−- The YAML metadata block must occur at the beginning of the
4259− document (and there can be only one). If multiple files are
4260− given as arguments to pandoc, only the first can be a YAML
4261− metadata block.
4262−
4263−- The leaf nodes of the YAML structure are parsed in isolation from
4264− each other and from the rest of the document. So, for
4265− example, you can't use a reference link in these contexts
4266− if the link definition is somewhere else in the document.
4267−
4268−[YAML escape sequence]: https://yaml.org/spec/1.2/spec.html#id2776092
4269−[Wikipedia entry on YAML syntax]: https://en.m.wikipedia.org/wiki/YAML#Syntax
4270−
4271## Backslash escapes
4033## Backslash escapes
4272
4034
4273#### Extension: `all_symbols_escapable` ####
4035#### Extension: `all_symbols_escapable` ####
@@ -4425,8 +4187,7 @@ you need to enclose text in literal `$` characters, backslash-escape
4425them and they won't be treated as math delimiters.
4187them and they won't be treated as math delimiters.
4426
4188
4427For display math, use `$$` delimiters. (In this case, the delimiters
4189For display math, use `$$` delimiters. (In this case, the delimiters
4428−may be separated from the formula by whitespace. However, there can be
4190+may be separated from the formula by whitespace.)
4429−no blank lines betwen the opening and closing `$$` delimiters.)
4430
4191
4431TeX math will be printed in all output formats. How it is rendered
4192TeX math will be printed in all output formats. How it is rendered
4432depends on the output format:
4193depends on the output format:
@@ -4544,8 +4305,8 @@ into
4544
4305
4545whereas `Markdown.pl` will preserve it as is.
4306whereas `Markdown.pl` will preserve it as is.
4546
4307
4547−There is one exception to this rule: text between `<script>`,
4308+There is one exception to this rule: text between `<script>` and
4548−`<style>`, and `<textarea>` tags is not interpreted as Markdown.
4309+`<style>` tags is not interpreted as Markdown.
4549
4310
4550This departure from standard Markdown should make it easier to mix
4311This departure from standard Markdown should make it easier to mix
4551Markdown with HTML block elements. For example, one can surround
4312Markdown with HTML block elements. For example, one can surround
@@ -4956,72 +4717,142 @@ they cannot contain multiple paragraphs). The syntax is as follows:
4956
4717
4957Inline and regular footnotes may be mixed freely.
4718Inline and regular footnotes may be mixed freely.
4958
4719
4959−## Citation syntax
4720+## Citations
4960
4721
4961#### Extension: `citations` ####
4722#### Extension: `citations` ####
4962
4723
4963−To cite a bibliographic item with an identifier foo, use the
4724+Using an external filter, `pandoc-citeproc`, pandoc can automatically generate
4964−syntax `@foo`. Normal citations should be included in square
4725+citations and a bibliography in a number of styles. Basic usage is
4965−brackets, with semicolons separating distinct items:
4726+
4727+ pandoc --filter pandoc-citeproc myinput.txt
4728+
4729+In order to use this feature, you will need to specify a bibliography file
4730+using the `bibliography` metadata field in a YAML metadata section, or
4731+`--bibliography` command line argument. You can supply multiple `--bibliography`
4732+arguments or set `bibliography` metadata field to YAML array, if you want to
4733+use multiple bibliography files. The bibliography may have any of these
4734+formats:
4735+
4736+ Format File extension
4737+ ------------ --------------
4738+ BibLaTeX .bib
4739+ BibTeX .bibtex
4740+ Copac .copac
4741+ CSL JSON .json
4742+ CSL YAML .yaml
4743+ EndNote .enl
4744+ EndNote XML .xml
4745+ ISI .wos
4746+ MEDLINE .medline
4747+ MODS .mods
4748+ RIS .ris
4966
4749
4967− Blah blah [@doe99; @smith2000; @smith2004].
4750+Note that `.bib` can be used with both BibTeX and BibLaTeX files;
4751+use `.bibtex` to force BibTeX.
4968
4752
4969−How this is rendered depends on the citation style. In an
4753+Note that `pandoc-citeproc --bib2json` and `pandoc-citeproc --bib2yaml`
4970−author-date style, it might render as
4754+can produce `.json` and `.yaml` files from any of the supported formats.
4971
4755
4972− Blah blah (Doe 1999, Smith 2000, 2004).
4756+In-field markup: In BibTeX and BibLaTeX databases,
4757+pandoc-citeproc parses a subset of LaTeX markup; in CSL YAML
4758+databases, pandoc Markdown; and in CSL JSON databases, an
4759+[HTML-like markup][CSL markup specs]:
4973
4760
4974−In a footnote style, it might render as
4761+`<i>...</i>`
4762+: italics
4975
4763
4976− Blah blah.[^1]
4764+`<b>...</b>`
4765+: bold
4977
4766
4978− [^1]: John Doe, "Frogs," *Journal of Amphibians* 44 (1999);
4767+`<span style="font-variant:small-caps;">...</span>` or `<sc>...</sc>`
4979− Susan Smith, "Flies," *Journal of Insects* (2000);
4768+: small capitals
4980− Susan Smith, "Bees," *Journal of Insects* (2004).
4981
4769
4982−See the [CSL user documentation] for more information about CSL
4770+`<sub>...</sub>`
4983−styles and how they affect rendering.
4771+: subscript
4984
4772
4985−Unless a citation key start with a letter, digit, or `_`,
4773+`<sup>...</sup>`
4986−and contains only alphanumerics and internal punctuation
4774+: superscript
4987−characters (`:.#$%&-+?<>~/`), it must be surrounded
4988−by curly braces, which are not considered part of the key.
4989−In `@Foo_bar.baz.`, the key is `Foo_bar.baz`. The final
4990−period is not *internal* punctuation, so it is not included in
4991−the key. In `@{Foo_bar.baz.}`, the key is `Foo_bar.baz.`, including
4992−the final period. The curly braces are recommended if you use URLs as
4993−keys: `[@{https://example.com/bib?name=foobar&date=2000}, p. 33]`.
4994
4775
4995−Citation items may optionally include a prefix, a locator, and
4776+`<span class="nocase">...</span>`
4996−a suffix. In
4777+: prevent a phrase from being capitalized as title case
4997
4778
4998− Blah blah [see @doe99, pp. 33-35 and *passim*; @smith04, chap. 1].
4779+`pandoc-citeproc -j` and `-y` interconvert the CSL JSON
4780+and CSL YAML formats as far as possible.
4999
4781
5000−The first item (`doe99`) has prefix `see `, locator `pp. 33-35`,
4782+As an alternative to specifying a bibliography file using `--bibliography`
5001−and suffix `and *passim*`. The second item (`smith04`) has
4783+or the YAML metadata field `bibliography`, you can include
5002−locator `chap. 1` and no prefix or suffix.
4784+the citation data directly in the `references` field of the
4785+document's YAML metadata. The field should contain an array of
4786+YAML-encoded references, for example:
5003
4787
5004−Pandoc uses some heuristics to separate the locator from the
4788+ ---
5005−rest of the subject. It is sensitive to the locator terms
4789+ references:
5006−defined in the [CSL locale files]. Either abbreviated or
4790+ - type: article-journal
4791+ id: WatsonCrick1953
4792+ author:
4793+ - family: Watson
4794+ given: J. D.
4795+ - family: Crick
4796+ given: F. H. C.
4797+ issued:
4798+ date-parts:
4799+ - - 1953
4800+ - 4
4801+ - 25
4802+ title: 'Molecular structure of nucleic acids: a structure for deoxyribose
4803+ nucleic acid'
4804+ title-short: Molecular structure of nucleic acids
4805+ container-title: Nature
4806+ volume: 171
4807+ issue: 4356
4808+ page: 737-738
4809+ DOI: 10.1038/171737a0
4810+ URL: https://www.nature.com/articles/171737a0
4811+ language: en-GB
4812+ ...
4813+
4814+(`pandoc-citeproc --bib2yaml` can produce these from a bibliography file in one
4815+of the supported formats.)
4816+
4817+Citations and references can be formatted using any style supported by the
4818+[Citation Style Language], listed in the [Zotero Style Repository].
4819+These files are specified using the `--csl` option or the `csl` metadata field.
4820+By default, `pandoc-citeproc` will use the [Chicago Manual of Style] author-date
4821+format. The CSL project provides further information on [finding and editing styles].
4822+
4823+To make your citations hyperlinks to the corresponding bibliography
4824+entries, add `link-citations: true` to your YAML metadata.
4825+
4826+Citations go inside square brackets and are separated by semicolons.
4827+Each citation must have a key, composed of '@' + the citation
4828+identifier from the database, and may optionally have a prefix,
4829+a locator, and a suffix. The citation key must begin with a letter, digit,
4830+or `_`, and may contain alphanumerics, `_`, and internal punctuation
4831+characters (`:.#$%&-+?<>~/`). Here are some examples:
4832+
4833+ Blah blah [see @doe99, pp. 33-35; also @smith04, chap. 1].
4834+
4835+ Blah blah [@doe99, pp. 33-35, 38-39 and *passim*].
4836+
4837+ Blah blah [@smith04; @doe99].
4838+
4839+`pandoc-citeproc` detects locator terms in the [CSL locale files].
5007−unabbreviated forms are accepted. In the `en-US` locale, locator
4840+Either abbreviated or unabbreviated forms are accepted. In the `en-US`
5008−terms can be written in either singular or plural forms, as
4841+locale, locator terms can be written in either singular or plural forms,
5009−`book`, `bk.`/`bks.`; `chapter`, `chap.`/`chaps.`; `column`,
4842+as `book`, `bk.`/`bks.`; `chapter`, `chap.`/`chaps.`; `column`,
5010−`col.`/`cols.`; `figure`, `fig.`/`figs.`; `folio`,
4843+`col.`/`cols.`; `figure`, `fig.`/`figs.`; `folio`, `fol.`/`fols.`;
5011−`fol.`/`fols.`; `number`, `no.`/`nos.`; `line`, `l.`/`ll.`;
4844+`number`, `no.`/`nos.`; `line`, `l.`/`ll.`; `note`, `n.`/`nn.`; `opus`,
5012−`note`, `n.`/`nn.`; `opus`, `op.`/`opp.`; `page`, `p.`/`pp.`;
5013−`paragraph`, `para.`/`paras.`; `part`, `pt.`/`pts.`; `section`,
4845+`op.`/`opp.`; `page`, `p.`/`pp.`; `paragraph`, `para.`/`paras.`; `part`,
5014−`sec.`/`secs.`; `sub verbo`, `s.v.`/`s.vv.`; `verse`,
4846+`pt.`/`pts.`; `section`, `sec.`/`secs.`; `sub verbo`, `s.v.`/`s.vv.`;
5015−`v.`/`vv.`; `volume`, `vol.`/`vols.`; `¶`/`¶¶`; `§`/`§§`. If no
4847+`verse`, `v.`/`vv.`; `volume`, `vol.`/`vols.`; `¶`/`¶¶`; `§`/`§§`. If no
5016locator term is used, "page" is assumed.
4848locator term is used, "page" is assumed.
5017
4849
5018−In complex cases, you can force something to be treated as
4850+`pandoc-citeproc` will use heuristics to distinguish the locator
5019−a locator by enclosing it in curly braces or prevent parsing
4851+from the suffix. In complex cases, the locator can be enclosed
5020−the suffix as locator by prepending curly braces:
4852+in curly braces (using `pandoc-citeproc` 0.15 and higher only):
5021
4853
5022 [@smith{ii, A, D-Z}, with a suffix]
4854 [@smith{ii, A, D-Z}, with a suffix]
5023 [@smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
4855 [@smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
5024− [@smith{}, 99 years later]
5025
4856
5026A minus sign (`-`) before the `@` will suppress mention of
4857A minus sign (`-`) before the `@` will suppress mention of
5027the author in the citation. This can be useful when the
4858the author in the citation. This can be useful when the
@@ -5029,103 +4860,82 @@ author is already mentioned in the text:
5029
4860
5030 Smith says blah [-@smith04].
4861 Smith says blah [-@smith04].
5031
4862
5032−You can also write an author-in-text citation, by omitting the
4863+You can also write an in-text citation, as follows:
5033−square brackets:
5034
4864
5035 @smith04 says blah.
4865 @smith04 says blah.
5036
4866
5037 @smith04 [p. 33] says blah.
4867 @smith04 [p. 33] says blah.
5038
4868
5039−This will cause the author's name to be rendered, followed by
4869+If the style calls for a list of works cited, it will be placed
5040−the bibliographical details. Use this form when you want to
4870+in a div with id `refs`, if one exists:
5041−make the citation the subject of a sentence.
4871+
4872+ ::: {#refs}
4873+ :::
4874+
4875+Otherwise, it will be placed at the end of the document.
4876+Generation of the bibliography can be suppressed by setting
4877+`suppress-bibliography: true` in the YAML metadata.
4878+
4879+If you wish the bibliography to have a section heading, you can
4880+set `reference-section-title` in the metadata, or put the heading
4881+at the beginning of the div with id `refs` (if you are using it)
4882+or at the end of your document:
4883+
4884+ last paragraph...
4885+
4886+ # References
4887+
4888+The bibliography will be inserted after this heading. Note that
4889+the `unnumbered` class will be added to this heading, so that the
4890+section will not be numbered.
4891+
4892+If you want to include items in the bibliography without actually
4893+citing them in the body text, you can define a dummy `nocite` metadata
4894+field and put the citations there:
4895+
4896+ ---
4897+ nocite: |
4898+ @item1, @item2
4899+ ...
4900+
4901+ @item3
4902+
4903+In this example, the document will contain a citation for `item3`
4904+only, but the bibliography will contain entries for `item1`, `item2`, and
4905+`item3`.
4906+
4907+It is possible to create a bibliography with all the citations,
4908+whether or not they appear in the document, by using a wildcard:
4909+
4910+ ---
4911+ nocite: |
4912+ @*
4913+ ...
4914+
4915+For LaTeX output, you can also use [`natbib`] or [`biblatex`] to
4916+render the bibliography. In order to do so, specify bibliography
4917+files as outlined above, and add `--natbib` or `--biblatex`
4918+argument to `pandoc` invocation. Bear in mind that bibliography
4919+files have to be in respective format (either BibTeX or
4920+BibLaTeX).
5042
4921
5043−When you are using a note style, it is usually better to let
4922+For more information, see the [pandoc-citeproc man page].
5044−citeproc create the footnotes from citations rather than writing
5045−an explicit note. If you do write an explicit note that
5046−contains a citation, note that normal citations will be put in
5047−parentheses, while author-in-text citations will not. For
5048−this reason, it is sometimes preferable to use the
5049−author-in-text style inside notes when using a note style.
5050
4923
5051−[CSL user documentation]: https://citationstyles.org/authors/
5052−[CSL]: https://docs.citationstyles.org/en/stable/specification.html
5053[CSL markup specs]: https://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields
4924[CSL markup specs]: https://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields
5054[Chicago Manual of Style]: https://chicagomanualofstyle.org
4925[Chicago Manual of Style]: https://chicagomanualofstyle.org
5055[Citation Style Language]: https://citationstyles.org
4926[Citation Style Language]: https://citationstyles.org
5056[Zotero Style Repository]: https://www.zotero.org/styles
4927[Zotero Style Repository]: https://www.zotero.org/styles
5057[finding and editing styles]: https://citationstyles.org/authors/
4928[finding and editing styles]: https://citationstyles.org/authors/
5058[CSL locale files]: https://github.com/citation-style-language/locales
4929[CSL locale files]: https://github.com/citation-style-language/locales
4930+[pandoc-citeproc man page]: https://github.com/jgm/pandoc-citeproc/blob/master/man/pandoc-citeproc.1.md
5059
4931
5060−## Non-default extensions
4932+## Non-pandoc extensions
5061
4933
5062The following Markdown syntax extensions are not enabled by default
4934The following Markdown syntax extensions are not enabled by default
5063in pandoc, but may be enabled by adding `+EXTENSION` to the format
4935in pandoc, but may be enabled by adding `+EXTENSION` to the format
5064name, where `EXTENSION` is the name of the extension. Thus, for
4936name, where `EXTENSION` is the name of the extension. Thus, for
5065example, `markdown+hard_line_breaks` is Markdown with hard line breaks.
4937example, `markdown+hard_line_breaks` is Markdown with hard line breaks.
5066
4938
5067−#### Extension: `rebase_relative_paths` ####
5068−
5069−Rewrite relative paths for Markdown links and images, depending
5070−on the path of the file containing the link or image link. For
5071−each link or image, pandoc will compute the directory of the
5072−containing file, relative to the working directory, and prepend
5073−the resulting path to the link or image path.
5074−
5075−The use of this extension is best understood by example.
5076−Suppose you have a a subdirectory for each chapter of a book,
5077−`chap1`, `chap2`, `chap3`. Each contains a file `text.md` and a
5078−number of images used in the chapter. You would like to have
5079−`![image](spider.jpg)` in `chap1/text.md` refer to
5080−`chap1/spider.jpg` and `![image](spider.jpg)` in `chap2/text.md`
5081−refer to `chap2/spider.jpg`. To do this, use
5082−
5083− pandoc chap*/*.md -f markdown+rebase_relative_paths
5084−
5085−Without this extension, you would have to use
5086−`![image](chap1/spider.jpg)` in `chap1/text.md` and
5087−`![image](chap2/spider.jpg)` in `chap2/text.md`. Links with
5088−relative paths will be rewritten in the same way as images.
5089−
5090−Absolute paths and URLs are not changed. Neither are empty
5091−paths or paths consisting entirely of a fragment, e.g., `#foo`.
5092−
5093−Note that relative paths in reference links and images will
5094−be rewritten relative to the file containing the link
5095−reference definition, not the file containing the reference link
5096−or image itself, if these differ.
5097−
5098−#### Extension: `attributes` ####
5099−
5100−Allows attributes to be attached to any inline or block-level
5101−element. The syntax for the attributes is the same as that
5102−used in [`header_attributes`][Extension: `header_attributes`].
5103−
5104−- Attributes that occur immediately after an inline
5105− element affect that element. If they follow a space, then they
5106− belong to the space. (Hence, this option subsumes
5107− `inline_code_attributes` and `link_attributes`.)
5108−- Attributes that occur immediately before a block
5109− element, on a line by themselves, affect that
5110− element.
5111−- Consecutive attribute specifiers may be used,
5112− either for blocks or for inlines. Their attributes
5113− will be combined.
5114−- Attributes that occur at the end of the text of
5115− a Setext or ATX heading (separated by whitespace
5116− from the text) affect the heading element. (Hence, this
5117− option subsumes `header_attributes`.)
5118−- Attributes that occur after the opening fence
5119− in a fenced code block affect the code block element. (Hence,
5120− this option subsumes `fenced_code_attributes`.)
5121−- Attributes that occur at the end of a reference
5122− link definition affect links that refer to that
5123− definition.
5124−
5125−Note that pandoc's AST does not currently allow attributes
5126−to be attached to arbitrary elements. Hence a Span or Div
5127−container will be added if needed.
5128−
5129#### Extension: `old_dashes` ####
4939#### Extension: `old_dashes` ####
5130
4940
5131Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
4941Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
@@ -5281,382 +5091,58 @@ for regular emphasis, add extra blank space around headings.
5281
5091
5282 [Project Gutenberg]: https://www.gutenberg.org
5092 [Project Gutenberg]: https://www.gutenberg.org
5283
5093
5284−#### Extension: `sourcepos` ####
5285−
5286−Include source position attributes when parsing `commonmark`.
5287−For elements that accept attributes, a `data-pos` attribute
5288−is added; other elements are placed in a surrounding
5289−Div or Span elemnet with a `data-pos` attribute.
5290−
5291## Markdown variants
5094## Markdown variants
5292
5095
5293In addition to pandoc's extended Markdown, the following Markdown
5096In addition to pandoc's extended Markdown, the following Markdown
5294variants are supported:
5097variants are supported:
5295
5098
5296−- `markdown_phpextra` (PHP Markdown Extra)
5099+`markdown_phpextra` (PHP Markdown Extra)
5100+: `footnotes`, `pipe_tables`, `raw_html`, `markdown_attribute`,
5101+ `fenced_code_blocks`, `definition_lists`, `intraword_underscores`,
5102+ `header_attributes`, `link_attributes`, `abbreviations`,
5103+ `shortcut_reference_links`, `spaced_reference_links`.
5104+
5297−- `markdown_github` (deprecated GitHub-Flavored Markdown)
5105+`markdown_github` (deprecated GitHub-Flavored Markdown)
5106+: `pipe_tables`, `raw_html`, `fenced_code_blocks`, `auto_identifiers`,
5107+ `gfm_auto_identifiers`, `backtick_code_blocks`,
5108+ `autolink_bare_uris`, `space_in_atx_header`,
5109+ `intraword_underscores`, `strikeout`, `task_lists`, `emoji`,
5110+ `shortcut_reference_links`, `angle_brackets_escapable`,
5111+ `lists_without_preceding_blankline`.
5112+
5298−- `markdown_mmd` (MultiMarkdown)
5113+`markdown_mmd` (MultiMarkdown)
5114+: `pipe_tables`, `raw_html`, `markdown_attribute`, `mmd_link_attributes`,
5115+ `tex_math_double_backslash`, `intraword_underscores`,
5116+ `mmd_title_block`, `footnotes`, `definition_lists`,
5117+ `all_symbols_escapable`, `implicit_header_references`,
5118+ `auto_identifiers`, `mmd_header_identifiers`,
5119+ `shortcut_reference_links`, `implicit_figures`,
5120+ `superscript`, `subscript`, `backtick_code_blocks`,
5121+ `spaced_reference_links`, `raw_attribute`.
5122+
5299−- `markdown_strict` (Markdown.pl)
5123+`markdown_strict` (Markdown.pl)
5300−- `commonmark` (CommonMark)
5124+: `raw_html`, `shortcut_reference_links`,
5301−- `gfm` (Github-Flavored Markdown)
5125+ `spaced_reference_links`.
5302−- `commonmark_x` (CommonMark with many pandoc extensions)
5126+
5303−
5127+We also support `commonmark` and `gfm` (GitHub-Flavored Markdown,
5304−To see which extensions are supported for a given format,
5305−and which are enabled by default, you can use the command
5306−
5307− pandoc --list-extensions=FORMAT
5308−
5309−where `FORMAT` is replaced with the name of the format.
5310−
5311−Note that the list of extensions for `commonmark`,
5128+which is implemented as a set of extensions on `commonmark`).
5312−`gfm`, and `commonmark_x` are defined relative to default
5129+
5313−commonmark. So, for example, `backtick_code_blocks`
5130+Note, however, that `commonmark` and `gfm` have limited support
5314−does not appear as an extension, since it is enabled by
5131+for extensions. Only those listed below (and `smart`,
5315−default and cannot be disabled.
5132+`raw_tex`, and `hard_line_breaks`) will work. The extensions
5316−
5133+can, however, all be individually disabled. Also, `raw_tex`
5317−# Citations
5134+only affects `gfm` output, not input.
5318−
5135+
5319−When the `--citeproc` option is used, pandoc can automatically generate
5136+`gfm` (GitHub-Flavored Markdown)
5320−citations and a bibliography in a number of styles. Basic usage is
5137+: `pipe_tables`, `raw_html`, `fenced_code_blocks`, `auto_identifiers`,
5321−
5138+ `gfm_auto_identifiers`, `backtick_code_blocks`,
5322− pandoc --citeproc myinput.txt
5139+ `autolink_bare_uris`, `space_in_atx_header`,
5323−
5140+ `intraword_underscores`, `strikeout`, `task_lists`, `emoji`,
5324−To use this feature, you will need to have
5141+ `shortcut_reference_links`, `angle_brackets_escapable`,
5325−
5142+ `lists_without_preceding_blankline`.
5326−- a document containing citations (see [Extension: `citations`]);
5143+
5327−- a source of bibliographic data: either an external bibliography
5144+
5328− file or a list of `references` in the document's YAML metadata
5145+# Producing slide shows with pandoc
5329−- optionally, a [CSL] citation style.
5330−
5331−## Specifying bibliographic data
5332−
5333−You can specify an external bibliography using the
5334−`bibliography` metadata field in a YAML metadata section or the
5335−`--bibliography` command line argument. If you want to use
5336−multiple bibliography files, you can supply multiple
5337−`--bibliography` arguments or set `bibliography` metadata field
5338−to YAML array. A bibliography may have any of these formats:
5339−
5340− Format File extension
5341− ------------ --------------
5342− BibLaTeX .bib
5343− BibTeX .bibtex
5344− CSL JSON .json
5345− CSL YAML .yaml
5346−
5347−Note that `.bib` can be used with both BibTeX and BibLaTeX files;
5348−use the extension `.bibtex` to force interpretation as BibTeX.
5349−
5350−In BibTeX and BibLaTeX databases, pandoc parses LaTeX markup
5351−inside fields such as `title`; in CSL YAML databases, pandoc
5352−Markdown; and in CSL JSON databases, an [HTML-like markup][CSL
5353−markup specs]:
5354−
5355−`<i>...</i>`
5356−: italics
5357−
5358−`<b>...</b>`
5359−: bold
5360−
5361−`<span style="font-variant:small-caps;">...</span>` or `<sc>...</sc>`
5362−: small capitals
5363−
5364−`<sub>...</sub>`
5365−: subscript
5366−
5367−`<sup>...</sup>`
5368−: superscript
5369−
5370−`<span class="nocase">...</span>`
5371−: prevent a phrase from being capitalized as title case
5372−
5373−As an alternative to specifying a bibliography file using
5374−`--bibliography` or the YAML metadata field `bibliography`, you
5375−can include the citation data directly in the `references` field
5376−of the document's YAML metadata. The field should contain an
5377−array of YAML-encoded references, for example:
5378−
5379− ---
5380− references:
5381− - type: article-journal
5382− id: WatsonCrick1953
5383− author:
5384− - family: Watson
5385− given: J. D.
5386− - family: Crick
5387− given: F. H. C.
5388− issued:
5389− date-parts:
5390− - - 1953
5391− - 4
5392− - 25
5393− title: 'Molecular structure of nucleic acids: a structure for
5394− deoxyribose nucleic acid'
5395− title-short: Molecular structure of nucleic acids
5396− container-title: Nature
5397− volume: 171
5398− issue: 4356
5399− page: 737-738
5400− DOI: 10.1038/171737a0
5401− URL: https://www.nature.com/articles/171737a0
5402− language: en-GB
5403− ...
5404−
5405−If both an external bibliography and inline (YAML metadata)
5406−references are provided, both will be used. In case of
5407−conflicting `id`s, the inline references will take precedence.
5408−
5409−Note that `pandoc` can be used to produce such a YAML metadata
5410−section from a BibTeX, BibLaTeX, or CSL JSON bibliography:
5411−
5412− pandoc chem.bib -s -f biblatex -t markdown
5413− pandoc chem.json -s -f csljson -t markdown
5414−
5415−Indeed, `pandoc` can convert between any of these
5416−citation formats:
5417−
5418− pandoc chem.bib -s -f biblatex -t csljson
5419− pandoc chem.yaml -s -f markdown -t biblatex
5420−
5421−Running pandoc on a bibliography file with the `--citeproc`
5422−option will create a formatted bibliography in the format
5423−of your choice:
5424−
5425− pandoc chem.bib -s --citeproc -o chem.html
5426− pandoc chem.bib -s --citeproc -o chem.pdf
5427−
5428−### Capitalization in titles
5429−
5430−If you are using a bibtex or biblatex bibliography, then observe
5431−the following rules:
5432−
5433− - English titles should be in title case. Non-English titles should
5434− be in sentence case, and the `langid` field in biblatex should be
5435− set to the relevant language. (The following values are treated
5436− as English: `american`, `british`, `canadian`, `english`,
5437− `australian`, `newzealand`, `USenglish`, or `UKenglish`.)
5438−
5439− - As is standard with bibtex/biblatex, proper names should be
5440− protected with curly braces so that they won't be lowercased
5441− in styles that call for sentence case. For example:
5442−
5443− title = {My Dinner with {Andre}}
5444−
5445− - In addition, words that should remain lowercase (or camelCase)
5446− should be protected:
5447−
5448− title = {Spin Wave Dispersion on the {nm} Scale}
5449−
5450− Though this is not necessary in bibtex/biblatex, it is necessary
5451− with citeproc, which stores titles internally in sentence case,
5452− and converts to title case in styles that require it. Here we
5453− protect "nm" so that it doesn't get converted to "Nm" at this stage.
5454−
5455−If you are using a CSL bibliography (either JSON or YAML), then observe
5456−the following rules:
5457−
5458− - All titles should be in sentence case.
5459−
5460− - Use the `language` field for non-English titles to prevent their
5461− conversion to title case in styles that call for this. (Conversion
5462− happens only if `language` begins with `en` or is left empty.)
5463−
5464− - Protect words that should not be converted to title case using
5465− this syntax:
5466−
5467− Spin wave dispersion on the <span class="nocase">nm</span> scale
5468−
5469−### Conference Papers, Published vs. Unpublished
5470−
5471−For a formally published conference paper, use the biblatex entry type
5472−`inproceedings` (which will be mapped to CSL `paper-conference`).
5473−
5474−For an unpublished manuscript, use the biblatex entry type
5475−`unpublished` without an `eventtitle` field (this entry type
5476−will be mapped to CSL `manuscript`).
5477−
5478−For a talk, an unpublished conference paper, or a poster
5479−presentation, use the biblatex entry type `unpublished` with an
5480−`eventtitle` field (this entry type will be mapped to CSL
5481−`speech`). Use the biblatex `type` field to indicate the type,
5482−e.g. "Paper", or "Poster". `venue` and `eventdate` may be useful
5483−too, though `eventdate` will not be rendered by most CSL styles.
5484−Note that `venue` is for the event's venue, unlike `location`
5485−which describes the publisher's location; do not use the latter
5486−for an unpublished conference paper.
5487−
5488−
5489−## Specifying a citation style
5490−
5491−Citations and references can be formatted using any style supported by the
5492−[Citation Style Language], listed in the [Zotero Style Repository].
5493−These files are specified using the `--csl` option or the `csl`
5494−(or `citation-style`) metadata field. By default, pandoc will
5495−use the [Chicago Manual of Style] author-date format. (You can
5496−override this default by copying a CSL style of your choice
5497−to `default.csl` in your user data directory.)
5498−The CSL project provides further information on [finding and
5499−editing styles].
5500−
5501−The `--citation-abbreviations` option (or the
5502−`citation-abbreviations` metadata field) may be used to specify
5503−a JSON file containing abbreviations of journals that should be
5504−used in formatted bibliographies when `form="short"` is
5505−specified. The format of the file can be illustrated with an
5506−example:
5507−
5508−
5509− { "default": {
5510− "container-title": {
5511− "Lloyd's Law Reports": "Lloyd's Rep",
5512− "Estates Gazette": "EG",
5513− "Scots Law Times": "SLT"
5514− }
5515− }
5516− }
5517−
5518−
5519−## Citations in note styles
5520−
5521−Pandoc's citation processing is designed to allow you to
5522−move between author-date, numerical, and note styles without
5523−modifying the markdown source. When you're using a note
5524−style, avoid inserting footnotes manually. Instead, insert
5525−citations just as you would in an author-date style---for
5526−example,
5527−
5528− Blah blah [@foo, p. 33].
5529−
5530−The footnote will be created automatically. Pandoc will take
5531−care of removing the space and moving the note before or
5532−after the period, depending on the setting of
5533−`notes-after-punctuation`, as described below in [Other relevant
5534−metadata fields].
5535−
5536−In some cases you may need to put a citation inside a regular
5537−footnote. Normal citations in footnotes (such as `[@foo, p.
5538−33]`) will be rendered in parentheses. In-text citations (such
5539−as `@foo [p. 33]`) will be rendered without parentheses. (A
5540−comma will be added if appropriate.) Thus:
5541−
5542− [^1]: Some studies [@foo; @bar, p. 33] show that
5543− frubulicious zoosnaps are quantical. For a survey
5544− of the literature, see @baz [chap. 1].
5545−
5546−## Raw content in a style
5547−
5548−To include raw content in a prefix, suffix, delimiter, or term,
5549−surround it with these tags indicating the format:
5550−
5551− {{jats}}&lt;ref&gt;{{/jats}}
5552−
5553−Without the tags, the string will be interpreted as a string
5554−and escaped in the output, rather than being passed through raw.
5555−
5556−This feature allows stylesheets to be customized to give
5557−different output for different output formats. However,
5558−stylesheets customized in this way will not be usable
5559−by other CSL implementations.
5560−
5561−
5562−
5563−## Placement of the bibliography
5564−
5565−If the style calls for a list of works cited, it will be placed
5566−in a div with id `refs`, if one exists:
5567−
5568− ::: {#refs}
5569− :::
5570−
5571−Otherwise, it will be placed at the end of the document.
5572−Generation of the bibliography can be suppressed by setting
5573−`suppress-bibliography: true` in the YAML metadata.
5574−
5575−If you wish the bibliography to have a section heading, you can
5576−set `reference-section-title` in the metadata, or put the heading
5577−at the beginning of the div with id `refs` (if you are using it)
5578−or at the end of your document:
5579−
5580− last paragraph...
5581−
5582− # References
5583−
5584−The bibliography will be inserted after this heading. Note that
5585−the `unnumbered` class will be added to this heading, so that the
5586−section will not be numbered.
5587−
5588−## Including uncited items in the bibliography
5589−
5590−If you want to include items in the bibliography without actually
5591−citing them in the body text, you can define a dummy `nocite` metadata
5592−field and put the citations there:
5593−
5594− ---
5595− nocite: |
5596− @item1, @item2
5597− ...
5598−
5599− @item3
5600−
5601−In this example, the document will contain a citation for `item3`
5602−only, but the bibliography will contain entries for `item1`, `item2`, and
5603−`item3`.
5604−
5605−It is possible to create a bibliography with all the citations,
5606−whether or not they appear in the document, by using a wildcard:
5607−
5608− ---
5609− nocite: |
5610− @*
5611− ...
5612−
5613−For LaTeX output, you can also use [`natbib`] or [`biblatex`] to
5614−render the bibliography. In order to do so, specify bibliography
5615−files as outlined above, and add `--natbib` or `--biblatex`
5616−argument to `pandoc` invocation. Bear in mind that bibliography
5617−files have to be in either BibTeX (for `--natbib`)
5618−or BibLaTeX (for `--biblatex`) format.
5619−
5620−## Other relevant metadata fields
5621−
5622−A few other metadata fields affect bibliography formatting:
5623−
5624−`link-citations`
5625−: If true, citations will be
5626− hyperlinked to the corresponding bibliography entries
5627− (for author-date and numerical styles only).
5628−
5629−`lang`
5630−: The `lang` field will affect how the style is localized,
5631− for example in the translation of labels, the use
5632− of quotation marks, and the way items are sorted.
5633− (For backwards compatibility, `locale` may be used instead
5634− of `lang`, but this use is deprecated.)
5635−
5636− A BCP 47 language tag is expected: for example, `en`,
5637− `de`, `en-US`, `fr-CA`, `ug-Cyrl`. The unicode extension
5638− syntax (after `-u-`) may be used to specify options for
5639− collation (sorting) more precisely. Here are some examples:
5640−
5641− - `zh-u-co-pinyin` -- Chinese with the Pinyin collation.
5642− - `es-u-co-trad` -- Spanish with the traditional collation
5643− (with `Ch` sorting after `C`).
5644− - `fr-u-kb` -- French with "backwards" accent sorting
5645− (with `coté` sorting after `côte`).
5646− - `en-US-u-kf-upper` -- English with uppercase letters sorting
5647− before lower (default is lower before upper).
5648−
5649−`notes-after-punctuation`
5650−: If true (the default), pandoc will put footnote citations
5651− after following punctuation. For example, if the source
5652− contains `blah blah [@jones99].`, the result will look like
5653− `blah blah.[^1]`, with the note moved after the period and
5654− the space collapsed. If false, the space will still be
5655− collapsed, but the footnote will not be moved after the
5656− punctuation.
5657−
5658−
5659−# Slide shows
5660
5146
5661You can use pandoc to produce an HTML + JavaScript slide presentation
5147You can use pandoc to produce an HTML + JavaScript slide presentation
5662that can be viewed via a web browser. There are five ways to do this,
5148that can be viewed via a web browser. There are five ways to do this,
@@ -5704,21 +5190,18 @@ To produce an HTML/JavaScript slide show, simply type
5704
5190
5705where `FORMAT` is either `s5`, `slidy`, `slideous`, `dzslides`, or `revealjs`.
5191where `FORMAT` is either `s5`, `slidy`, `slideous`, `dzslides`, or `revealjs`.
5706
5192
5707−For Slidy, Slideous, reveal.js, and S5, the file produced by
5193+For Slidy, Slideous, reveal.js, and S5, the file produced by pandoc with the
5708−pandoc with the `-s/--standalone` option embeds a link to
5194+`-s/--standalone` option embeds a link to JavaScript and CSS files, which are
5709−JavaScript and CSS files, which are assumed to be available at
5710−the relative path `s5/default` (for S5), `slideous` (for
5195+assumed to be available at the relative path `s5/default` (for S5), `slideous`
5711−Slideous), `reveal.js` (for reveal.js), or at the Slidy website
5196+(for Slideous), `reveal.js` (for reveal.js), or at the Slidy website at
5712−at `w3.org` (for Slidy). (These paths can be changed by setting
5197+`w3.org` (for Slidy). (These paths can be changed by setting the `slidy-url`,
5713−the `slidy-url`, `slideous-url`, `revealjs-url`, or `s5-url`
5714−variables; see [Variables for HTML slides], above.) For
5198+`slideous-url`, `revealjs-url`, or `s5-url` variables; see [Variables for HTML slides],
5715−DZSlides, the (relatively short) JavaScript and CSS are included
5199+above.) For DZSlides, the (relatively short) JavaScript and CSS are included in
5716−in the file by default.
5200+the file by default.
5717−
5201+
5718−With all HTML slide formats, the `--self-contained` option can
5202+With all HTML slide formats, the `--self-contained` option can be used to
5719−be used to produce a single file that contains all of the data
5203+produce a single file that contains all of the data necessary to display the
5720−necessary to display the slide show, including linked scripts,
5721−stylesheets, images, and videos.
5204+slide show, including linked scripts, stylesheets, images, and videos.
5722
5205
5723To produce a PDF slide show using beamer, type
5206To produce a PDF slide show using beamer, type
5724
5207
@@ -5748,11 +5231,7 @@ rules:
5748 * A heading at the slide level always starts a new slide.
5231 * A heading at the slide level always starts a new slide.
5749
5232
5750 * Headings *below* the slide level in the hierarchy create
5233 * Headings *below* the slide level in the hierarchy create
5751− headings *within* a slide. (In beamer, a "block" will be
5234+ headings *within* a slide.
5752− created. If the heading has the class `example`, an
5753− `exampleblock` environment will be used; if it has the class
5754− `alert`, an `alertblock` will be used; otherwise a regular
5755− `block` will be used.)
5756
5235
5757 * Headings *above* the slide level in the hierarchy create
5236 * Headings *above* the slide level in the hierarchy create
5758 "title slides," which just contain the section title
5237 "title slides," which just contain the section title
@@ -6005,7 +5484,7 @@ Slide 1 has background_image.png as its background.
6005Slide 2 has a special image for its background, even though the heading has no content.
5484Slide 2 has a special image for its background, even though the heading has no content.
6006```
5485```
6007
5486
6008−# EPUBs
5487+# Creating EPUBs with pandoc
6009
5488
6010## EPUB Metadata
5489## EPUB Metadata
6011
5490
@@ -6085,15 +5564,6 @@ The following fields are recognized:
6085
5564
6086`rights`
5565`rights`
6087 ~ A string value.
5566 ~ A string value.
6088−
6089−`belongs-to-collection`
6090− ~ A string value. identifies the name of a collection to which
6091− the EPUB Publication belongs.
6092−
6093−`group-position`
6094− ~ The `group-position` field indicates the numeric position in which
6095− the EPUB Publication belongs relative to other works belonging to
6096− the same `belongs-to-collection` field.
6097
5567
6098`cover-image`
5568`cover-image`
6099 ~ A string value (path to cover image).
5569 ~ A string value (path to cover image).
@@ -6155,6 +5625,8 @@ halftitlepage frontmatter
6155seriespage frontmatter
5625seriespage frontmatter
6156foreword frontmatter
5626foreword frontmatter
6157preface frontmatter
5627preface frontmatter
5628+seriespage frontmatter
5629+titlepage frontmatter
6158appendix backmatter
5630appendix backmatter
6159colophon backmatter
5631colophon backmatter
6160bibliography backmatter
5632bibliography backmatter
@@ -6177,7 +5649,7 @@ with the `src` attribute. For example:
6177 </source>
5649 </source>
6178 </audio>
5650 </audio>
6179
5651
6180−# Jupyter notebooks
5652+# Creating Jupyter notebooks with pandoc
6181
5653
6182When creating a [Jupyter notebook], pandoc will try to infer the
5654When creating a [Jupyter notebook], pandoc will try to infer the
6183notebook structure. Code blocks with the class `code` will be
5655notebook structure. Code blocks with the class `code` will be
@@ -6330,7 +5802,7 @@ Then edit `my.theme` and use it like this:
6330If you are not satisfied with the built-in highlighting, or you
5802If you are not satisfied with the built-in highlighting, or you
6331want highlight a language that isn't supported, you can use the
5803want highlight a language that isn't supported, you can use the
6332`--syntax-definition` option to load a [KDE-style XML syntax definition
5804`--syntax-definition` option to load a [KDE-style XML syntax definition
6333−file](https://docs.kde.org/stable5/en/kate/katepart/highlight.html).
5805+file](https://docs.kde.org/stable5/en/applications/katepart/highlight.html).
6334Before writing your own, have a look at KDE's [repository of syntax
5806Before writing your own, have a look at KDE's [repository of syntax
6335definitions](https://github.com/KDE/syntax-highlighting/tree/master/data/syntax).
5807definitions](https://github.com/KDE/syntax-highlighting/tree/master/data/syntax).
6336
5808
@@ -6461,21 +5933,6 @@ subdirectory of your user data directory (see [Templates]).
6461
5933
6462[Lua]: https://www.lua.org
5934[Lua]: https://www.lua.org
6463
5935
6464−# Reproducible builds
6465−
6466−Some of the document formats pandoc targets (such as EPUB,
6467−docx, and ODT) include build timestamps in the generated document.
6468−That means that the files generated on successive builds will
6469−differ, even if the source does not. To avoid this, set the
6470−`SOURCE_DATE_EPOCH` environment variable, and the timestamp will
6471−be taken from it instead of the current time.
6472−`SOURCE_DATE_EPOCH` should contain an integer unix timestamp
6473−(specifying the number of second since midnight UTC January 1, 1970).
6474−
6475−Some document formats also include a unique identifier. For
6476−EPUB, this can be set explicitly by setting the `identifier`
6477−metadata field (see [EPUB Metadata], above).
6478−
6479# A note on security
5936# A note on security
6480
5937
6481If you use pandoc to convert user-contributed content in a web
5938If you use pandoc to convert user-contributed content in a web
@@ -6504,13 +5961,13 @@ application, here are some things to keep in mind:
65044. The HTML generated by pandoc is not guaranteed to be safe.
59614. The HTML generated by pandoc is not guaranteed to be safe.
6505 If `raw_html` is enabled for the Markdown input, users can
5962 If `raw_html` is enabled for the Markdown input, users can
6506 inject arbitrary HTML. Even if `raw_html` is disabled,
5963 inject arbitrary HTML. Even if `raw_html` is disabled,
6507− users can include dangerous content in URLs and attributes.
5964+ users can include dangerous content in attributes for
5965+ headings, spans, and code blocks. To be safe, you should
6508− To be safe, you should run all the generated HTML through
5966+ run all the generated HTML through an HTML sanitizer.
6509− an HTML sanitizer.
6510
5967
6511# Authors
5968# Authors
6512
5969
6513−Copyright 2006--2021 John MacFarlane (jgm@berkeley.edu). Released
5970+Copyright 2006--2020 John MacFarlane (jgm@berkeley.edu). Released
6514under the [GPL], version 2 or greater. This software carries no
5971under the [GPL], version 2 or greater. This software carries no
6515warranty of any kind. (See COPYRIGHT for full copyright and
5972warranty of any kind. (See COPYRIGHT for full copyright and
6516warranty notices.) For a full list of contributors, see the file
5973warranty notices.) For a full list of contributors, see the file
Makefile+50−55
@@ -2,31 +2,16 @@ version?=$(shell grep '^[Vv]ersion:' pandoc.cabal | awk '{print $$2;}')
2pandoc=$(shell find dist -name pandoc -type f -exec ls -t {} \; | head -1)
2pandoc=$(shell find dist -name pandoc -type f -exec ls -t {} \; | head -1)
3SOURCEFILES?=$(shell git ls-tree -r master --name-only | grep "\.hs$$")
3SOURCEFILES?=$(shell git ls-tree -r master --name-only | grep "\.hs$$")
4BRANCH?=master
4BRANCH?=master
5−ARCH=$(shell uname -m)
5+RESOLVER?=lts-13
6−DOCKERIMAGE=registry.gitlab.b-data.ch/ghc/ghc4pandoc:8.10.4
7−COMMIT=$(shell git rev-parse --short HEAD)
8−TIMESTAMP=$(shell date "+%Y%m%d_%H%M")
9−LATESTBENCH=$(word 1,$(shell ls -t bench_*.csv 2>/dev/null))
10−BASELINE?=$(LATESTBENCH)
11−ifeq ($(BASELINE),)
12−BASELINECMD=
13−else
14−BASELINECMD=--baseline $(BASELINE)
15−endif
16−GHCOPTS=-fdiagnostics-color=always -j4 +RTS -A8m -RTS
6+GHCOPTS=-fdiagnostics-color=always
17WEBSITE=../../web/pandoc.org
7WEBSITE=../../web/pandoc.org
18−REVISION?=1
19−# For gauge:
20−# BENCHARGS?=--small --ci=0.90 --match=pattern $(PATTERN)
21−# For tasty-bench:
22−BENCHARGS?=--csv bench_$(TIMESTAMP).csv $(BASELINECMD) --timeout=6 +RTS -T -RTS $(if $(PATTERN),--pattern "$(PATTERN)",)
23
8
24quick:
9quick:
25− stack install --ghc-options='$(GHCOPTS)' --install-ghc --flag 'pandoc:embed_data_files' --fast --test --ghc-options='$(GHCOPTS)' --test-arguments='-j4 --hide-successes $(TESTARGS)'
10+ stack install --ghc-options='$(GHCOPTS)' --install-ghc --flag 'pandoc:embed_data_files' --fast --test --ghc-options='-j +RTS -A64m -RTS' --test-arguments='-j4 --hide-successes $(TESTARGS)'
26
11
27quick-cabal:
12quick-cabal:
28 cabal new-configure . --ghc-options '$(GHCOPTS)' --disable-optimization --enable-tests
13 cabal new-configure . --ghc-options '$(GHCOPTS)' --disable-optimization --enable-tests
29− cabal new-build -j4 . --disable-optimization
14+ cabal new-build . --disable-optimization
30 cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
15 cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
31
16
32full-cabal:
17full-cabal:
@@ -35,7 +20,7 @@ full-cabal:
35 cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
20 cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
36
21
37full:
22full:
38− stack install --flag 'pandoc:embed_data_files' --flag 'pandoc:trypandoc' --bench --no-run-benchmarks --test --test-arguments='-j4 --hide-successes' --ghc-options '-Wall -Werror -fno-warn-unused-do-bind -O0 $(GHCOPTS)'
23+ stack install --flag 'pandoc:embed_data_files' --flag 'pandoc:trypandoc' --bench --no-run-benchmarks --test --test-arguments='-j4 --hide-successes' --ghc-options '-Wall -Werror -fno-warn-unused-do-bind -O0 -j4 $(GHCOPTS)'
39
24
40ghci:
25ghci:
41 stack ghci --flag 'pandoc:embed_data_files'
26 stack ghci --flag 'pandoc:embed_data_files'
@@ -51,14 +36,11 @@ test:
51ghcid:
36ghcid:
52 ghcid -c "stack repl --flag 'pandoc:embed_data_files'"
37 ghcid -c "stack repl --flag 'pandoc:embed_data_files'"
53
38
54−ghcid-test:
55− ghcid -c "stack repl --ghc-options=-XNoImplicitPrelude --flag 'pandoc:embed_data_files' --ghci-options=-fobject-code pandoc:lib pandoc:test-pandoc"
56−
57bench:
39bench:
58− stack bench \
59− --ghc-options '$(GHCOPTS)' \
60− --benchmark-arguments='$(BENCHARGS)' 2>&1 | \
40+ stack bench --benchmark-arguments='$(BENCHARGS)' --ghc-options '$(GHCOPTS)'
61− tee "bench_latest.txt"
41+
42+weigh:
43+ stack build --ghc-options '$(GHCOPTS)' pandoc:weigh-pandoc && stack exec weigh-pandoc
62
44
63reformat:
45reformat:
64 for f in $(SOURCEFILES); do echo $$f; stylish-haskell -i $$f ; done
46 for f in $(SOURCEFILES); do echo $$f; stylish-haskell -i $$f ; done
@@ -82,25 +64,48 @@ dist: man/pandoc.1
82 cd pandoc-${version}
64 cd pandoc-${version}
83 stack setup && stack test && cd .. && rm -rf "pandoc-${version}"
65 stack setup && stack test && cd .. && rm -rf "pandoc-${version}"
84
66
85−check: checkdocs check-cabal
67+packages: checkdocs winpkg debpkg macospkg
86
68
87−checkdocs:
69+checkdocs: README.md
88− ! grep -q -n -e "\t" MANUAL.txt changelog.md
70+ ! grep -n -e "\t" MANUAL.txt changelog
89
71
90debpkg: man/pandoc.1
72debpkg: man/pandoc.1
91− docker run -v `pwd`:/mnt \
73+ make -C linux && \
92− -v `pwd`/linux/artifacts:/artifacts \
74+ cp linux/artifacts/pandoc-$(version)-*.* .
93− --user $(id -u):$(id -g) \
75+
94− -e REVISION=$(REVISION) \
76+macospkg: man/pandoc.1
95− -w /mnt \
77+ ./macos/make_macos_package.sh
96− --memory=0 \
78+
97− --rm \
79+winpkg: pandoc-$(version)-windows-i386.msi pandoc-$(version)-windows-i386.zip pandoc-$(version)-windows-x86_64.msi pandoc-$(version)-windows-x86_64.zip
98− $(DOCKERIMAGE) \
80+
99− bash \
81+pandoc-$(version)-windows-%.zip: pandoc-$(version)-windows-%.msi
100− /mnt/linux/make_artifacts.sh 2>&1 > docker.log
82+ ORIGDIR=`pwd` && \
83+ CONTAINER=$(basename $<) && \
84+ TEMPDIR=`mktemp -d` && \
85+ msiextract -C $$TEMPDIR/msi $< && \
86+ pushd $$TEMPDIR && \
87+ mkdir $$CONTAINER && \
88+ find msi -type f -exec cp {} $$CONTAINER/ \; && \
89+ zip -r $$ORIGDIR/$@ $$CONTAINER && \
90+ popd & \
91+ rm -rf $$TEMPDIR
92+
93+pandoc-$(version)-windows-%.msi: pandoc-windows-%.msi
94+ osslsigncode sign -pkcs12 ~/Private/SectigoCodeSigning.exp2023.p12 -in $< -i http://johnmacfarlane.net/ -t http://timestamp.comodoca.com/ -out $@ -askpass
95+ rm $<
96+
97+.INTERMEDIATE: pandoc-windows-i386.msi pandoc-windows-x86_64.msi
98+
99+pandoc-windows-i386.msi:
100+ JOBID=$(shell curl https://ci.appveyor.com/api/projects/jgm/pandoc | jq '.build.jobs[]| select(.name|test("i386")) | .jobId') && \
101+ wget "https://ci.appveyor.com/api/buildjobs/$$JOBID/artifacts/windows%2F$@" -O $@
102+
103+pandoc-windows-x86_64.msi:
104+ JOBID=$(shell curl https://ci.appveyor.com/api/projects/jgm/pandoc | jq '.build.jobs[]| select(.name|test("x86_64")) | .jobId') && \
105+ wget "https://ci.appveyor.com/api/buildjobs/$$JOBID/artifacts/windows%2F$@" -O $@
101
106
102man/pandoc.1: MANUAL.txt man/pandoc.1.before man/pandoc.1.after
107man/pandoc.1: MANUAL.txt man/pandoc.1.before man/pandoc.1.after
103− pandoc $< -f markdown -t man -s \
108+ pandoc $< -f markdown-smart -t man -s \
104 --lua-filter man/manfilter.lua \
109 --lua-filter man/manfilter.lua \
105 --include-before-body man/pandoc.1.before \
110 --include-before-body man/pandoc.1.before \
106 --include-after-body man/pandoc.1.after \
111 --include-after-body man/pandoc.1.after \
@@ -109,7 +114,7 @@ man/pandoc.1: MANUAL.txt man/pandoc.1.before man/pandoc.1.after
109 -o $@
114 -o $@
110
115
111README.md: README.template MANUAL.txt tools/update-readme.lua
116README.md: README.template MANUAL.txt tools/update-readme.lua
112− pandoc --lua-filter tools/update-readme.lua \
117+ pandoc --lua-filter tools/update-readme.lua --reference-links \
113 --reference-location=section -t gfm $< -o $@
118 --reference-location=section -t gfm $< -o $@
114
119
115download_stats:
120download_stats:
@@ -118,9 +123,9 @@ download_stats:
118
123
119pandoc-templates:
124pandoc-templates:
120 rm ../pandoc-templates/default.* ; \
125 rm ../pandoc-templates/default.* ; \
121− cp data/templates/* ../pandoc-templates/ ; \
126+ cp data/templates/default.* README.md styles.* ../pandoc-templates/ ; \
122 pushd ../pandoc-templates/ && \
127 pushd ../pandoc-templates/ && \
123− git add * && \
128+ git add default.* README.md styles.* && \
124 git commit -m "Updated templates for pandoc $(version)" && \
129 git commit -m "Updated templates for pandoc $(version)" && \
125 popd
130 popd
126
131
@@ -135,14 +140,4 @@ update-website:
135clean:
140clean:
136 stack clean
141 stack clean
137
142
138−check-cabal: git-files.txt sdist-files.txt
139− echo "Checking to see if all committed test/data files are in sdist."
140− diff -u $^
141−
142−sdist-files.txt: .FORCE
143− cabal sdist --list-only | sed 's/\.\///' | grep '^\(test\|data\)\/' | sort > $@
144−
145−git-files.txt: .FORCE
146− git ls-tree -r --name-only HEAD | grep '^\(test\|data\)\/' | sort > $@
147−
148−.PHONY: .FORCE deps quick full haddock install clean test bench changes_github dist prof download_stats reformat lint weigh doc/lua-filters.md pandoc-templates trypandoc update-website debpkg checkdocs ghcid ghci fix_spacing hlint check check-cabal
143+.PHONY: deps quick full haddock install clean test bench changes_github macospkg dist prof download_stats reformat lint weigh doc/lua-filters.md packages pandoc-templates trypandoc update-website debpkg macospkg winpkg checkdocs ghcid ghci fix_spacing hlint
README.md+95−108
@@ -8,10 +8,11 @@ pandoc --lua-filter tools/update-readme.lua README.template -o README.md
8[![github
8[![github
9release](https://img.shields.io/github/release/jgm/pandoc.svg?label=current+release)](https://github.com/jgm/pandoc/releases)
9release](https://img.shields.io/github/release/jgm/pandoc.svg?label=current+release)](https://github.com/jgm/pandoc/releases)
10[![hackage
10[![hackage
11−release](https://img.shields.io/hackage/v/pandoc.svg?label=hackage)](https://hackage.haskell.org/package/pandoc)
11+release](https://img.shields.io/hackage/v/pandoc.svg?label=hackage)](http://hackage.haskell.org/package/pandoc)
12−[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](https://formulae.brew.sh/formula/pandoc)
12+[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](http://brewformulas.org/Pandoc)
13[![stackage LTS
13[![stackage LTS
14−package](https://stackage.org/package/pandoc/badge/lts)](https://www.stackage.org/lts/package/pandoc-types)
14+package](http://stackage.org/package/pandoc/badge/lts)](http://stackage.org/lts/package/pandoc)
15+[![CircleCI](https://circleci.com/gh/jgm/pandoc.svg?style=svg)](https://circleci.com/gh/jgm/pandoc)
15[![CI
16[![CI
16tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
17tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
17[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
18[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
@@ -20,71 +21,64 @@ groups](https://img.shields.io/badge/pandoc-discuss-red.svg?style=social)](https
20
21
21## The universal markup converter
22## The universal markup converter
22
23
23−Pandoc is a [Haskell](https://haskell.org) library for converting from
24+Pandoc is a [Haskell](http://haskell.org) library for converting from
24one markup format to another, and a command-line tool that uses this
25one markup format to another, and a command-line tool that uses this
25library. It can convert *from*
26library. It can convert *from*
26
27
27<div id="input-formats">
28<div id="input-formats">
28
29
29−- `bibtex` ([BibTeX](https://ctan.org/pkg/bibtex) bibliography)
30−- `biblatex` ([BibLaTeX](https://ctan.org/pkg/biblatex) bibliography)
31−- `commonmark` ([CommonMark](https://commonmark.org) Markdown)
30+ - `commonmark` ([CommonMark](https://commonmark.org) Markdown)
32−- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with
33− extensions)
34−- `creole` ([Creole 1.0](http://www.wikicreole.org/wiki/Creole1.0))
31+ - `creole` ([Creole 1.0](http://www.wikicreole.org/wiki/Creole1.0))
35−- `csljson` ([CSL
36− JSON](https://citeproc-js.readthedocs.io/en/latest/csl-json/markup.html)
37− bibliography)
38−- `csv` ([CSV](https://tools.ietf.org/html/rfc4180) table)
32+ - `csv` ([CSV](https://tools.ietf.org/html/rfc4180) table)
39−- `docbook` ([DocBook](https://docbook.org))
33+ - `docbook` ([DocBook](https://docbook.org))
40−- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
34+ - `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
41−- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
35+ - `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
42−- `epub` ([EPUB](http://idpf.org/epub))
36+ - `epub` ([EPUB](http://idpf.org/epub))
43−- `fb2`
37+ - `fb2`
44 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
38 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
45 e-book)
39 e-book)
46−- `gfm` ([GitHub-Flavored
40+ - `gfm` ([GitHub-Flavored
47 Markdown](https://help.github.com/articles/github-flavored-markdown/)),
41 Markdown](https://help.github.com/articles/github-flavored-markdown/)),
48 or the deprecated and less accurate `markdown_github`; use
42 or the deprecated and less accurate `markdown_github`; use
49 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
43 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
50 only if you need extensions not supported in
44 only if you need extensions not supported in
51 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
45 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
52−- `haddock` ([Haddock
46+ - `haddock` ([Haddock
53 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
47 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
54−- `html` ([HTML](https://www.w3.org/html/))
48+ - `html` ([HTML](https://www.w3.org/html/))
55−- `ipynb` ([Jupyter
49+ - `ipynb` ([Jupyter
56 notebook](https://nbformat.readthedocs.io/en/latest/))
50 notebook](https://nbformat.readthedocs.io/en/latest/))
57−- `jats` ([JATS](https://jats.nlm.nih.gov) XML)
51+ - `jats` ([JATS](https://jats.nlm.nih.gov) XML)
58−- `jira`
52+ - `jira`
59− ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence
53+ ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)
60 wiki markup)
54 wiki markup)
61−- `json` (JSON version of native AST)
55+ - `json` (JSON version of native AST)
62−- `latex` ([LaTeX](https://www.latex-project.org/))
56+ - `latex` ([LaTeX](https://www.latex-project.org/))
63−- `markdown` ([Pandoc’s
57+ - `markdown` ([Pandoc’s
64 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
58 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
65−- `markdown_mmd`
59+ - `markdown_mmd`
66 ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
60 ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
67−- `markdown_phpextra` ([PHP Markdown
61+ - `markdown_phpextra` ([PHP Markdown
68 Extra](https://michelf.ca/projects/php-markdown/extra/))
62 Extra](https://michelf.ca/projects/php-markdown/extra/))
69−- `markdown_strict` (original unextended
63+ - `markdown_strict` (original unextended
70 [Markdown](https://daringfireball.net/projects/markdown/))
64 [Markdown](https://daringfireball.net/projects/markdown/))
71−- `mediawiki` ([MediaWiki
65+ - `mediawiki` ([MediaWiki
72 markup](https://www.mediawiki.org/wiki/Help:Formatting))
66 markup](https://www.mediawiki.org/wiki/Help:Formatting))
73−- `man` ([roff man](https://man.cx/groff_man(7)))
67+ - `man` ([roff man](https://man.cx/groff_man\(7\)))
74−- `muse` ([Muse](https://amusewiki.org/library/manual))
68+ - `muse` ([Muse](https://amusewiki.org/library/manual))
75−- `native` (native Haskell)
69+ - `native` (native Haskell)
76−- `odt` ([ODT](https://en.wikipedia.org/wiki/OpenDocument))
70+ - `odt` ([ODT](https://en.wikipedia.org/wiki/OpenDocument))
77−- `opml` ([OPML](http://dev.opml.org/spec2.html))
71+ - `opml` ([OPML](http://dev.opml.org/spec2.html))
78−- `org` ([Emacs Org mode](https://orgmode.org))
72+ - `org` ([Emacs Org mode](https://orgmode.org))
79−- `rst`
73+ - `rst`
80 ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
74 ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
81−- `t2t` ([txt2tags](https://txt2tags.org))
75+ - `t2t` ([txt2tags](https://txt2tags.org))
82−- `textile` ([Textile](https://www.promptworks.com/textile))
76+ - `textile` ([Textile](https://www.promptworks.com/textile))
83−- `tikiwiki` ([TikiWiki
77+ - `tikiwiki` ([TikiWiki
84 markup](https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax))
78 markup](https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax))
85−- `twiki` ([TWiki
79+ - `twiki` ([TWiki
86 markup](https://twiki.org/cgi-bin/view/TWiki/TextFormattingRules))
80 markup](https://twiki.org/cgi-bin/view/TWiki/TextFormattingRules))
87−- `vimwiki` ([Vimwiki](https://vimwiki.github.io))
81+ - `vimwiki` ([Vimwiki](https://vimwiki.github.io))
88
82
89</div>
83</div>
90
84
@@ -92,101 +86,94 @@ It can convert *to*
92
86
93<div id="output-formats">
87<div id="output-formats">
94
88
95−- `asciidoc` ([AsciiDoc](https://www.methods.co.nz/asciidoc/)) or
89+ - `asciidoc` ([AsciiDoc](https://www.methods.co.nz/asciidoc/)) or
96 `asciidoctor` ([AsciiDoctor](https://asciidoctor.org/))
90 `asciidoctor` ([AsciiDoctor](https://asciidoctor.org/))
97−- `beamer` ([LaTeX beamer](https://ctan.org/pkg/beamer) slide show)
91+ - `beamer` ([LaTeX beamer](https://ctan.org/pkg/beamer) slide show)
98−- `bibtex` ([BibTeX](https://ctan.org/pkg/bibtex) bibliography)
99−- `biblatex` ([BibLaTeX](https://ctan.org/pkg/biblatex) bibliography)
100−- `commonmark` ([CommonMark](https://commonmark.org) Markdown)
92+ - `commonmark` ([CommonMark](https://commonmark.org) Markdown)
101−- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with
102− extensions)
103−- `context` ([ConTeXt](https://www.contextgarden.net/))
93+ - `context` ([ConTeXt](https://www.contextgarden.net/))
104−- `csljson` ([CSL
105− JSON](https://citeproc-js.readthedocs.io/en/latest/csl-json/markup.html)
106− bibliography)
107−- `docbook` or `docbook4` ([DocBook](https://docbook.org) 4)
94+ - `docbook` or `docbook4` ([DocBook](https://docbook.org) 4)
108−- `docbook5` (DocBook 5)
95+ - `docbook5` (DocBook 5)
109−- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
96+ - `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
110−- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
97+ - `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
111−- `epub` or `epub3` ([EPUB](http://idpf.org/epub) v3 book)
98+ - `epub` or `epub3` ([EPUB](http://idpf.org/epub) v3 book)
112−- `epub2` (EPUB v2)
99+ - `epub2` (EPUB v2)
113−- `fb2`
100+ - `fb2`
114 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
101 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
115 e-book)
102 e-book)
116−- `gfm` ([GitHub-Flavored
103+ - `gfm` ([GitHub-Flavored
117 Markdown](https://help.github.com/articles/github-flavored-markdown/)),
104 Markdown](https://help.github.com/articles/github-flavored-markdown/)),
118 or the deprecated and less accurate `markdown_github`; use
105 or the deprecated and less accurate `markdown_github`; use
119 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
106 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
120 only if you need extensions not supported in
107 only if you need extensions not supported in
121 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
108 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
122−- `haddock` ([Haddock
109+ - `haddock` ([Haddock
123 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
110 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
124−- `html` or `html5` ([HTML](https://www.w3.org/html/),
111+ - `html` or `html5` ([HTML](https://www.w3.org/html/),
125 i.e. [HTML5](https://html.spec.whatwg.org/)/XHTML [polyglot
112 i.e. [HTML5](https://html.spec.whatwg.org/)/XHTML [polyglot
126 markup](https://www.w3.org/TR/html-polyglot/))
113 markup](https://www.w3.org/TR/html-polyglot/))
127−- `html4` ([XHTML](https://www.w3.org/TR/xhtml1/) 1.0 Transitional)
114+ - `html4` ([XHTML](https://www.w3.org/TR/xhtml1/) 1.0 Transitional)
128−- `icml` ([InDesign
115+ - `icml` ([InDesign
129 ICML](https://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf))
116 ICML](https://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf))
130−- `ipynb` ([Jupyter
117+ - `ipynb` ([Jupyter
131 notebook](https://nbformat.readthedocs.io/en/latest/))
118 notebook](https://nbformat.readthedocs.io/en/latest/))
132−- `jats_archiving` ([JATS](https://jats.nlm.nih.gov) XML, Archiving
119+ - `jats_archiving` ([JATS](https://jats.nlm.nih.gov) XML, Archiving
133 and Interchange Tag Set)
120 and Interchange Tag Set)
134−- `jats_articleauthoring` ([JATS](https://jats.nlm.nih.gov) XML,
121+ - `jats_articleauthoring` ([JATS](https://jats.nlm.nih.gov) XML,
135 Article Authoring Tag Set)
122 Article Authoring Tag Set)
136−- `jats_publishing` ([JATS](https://jats.nlm.nih.gov) XML, Journal
123+ - `jats_publishing` ([JATS](https://jats.nlm.nih.gov) XML, Journal
137 Publishing Tag Set)
124 Publishing Tag Set)
138−- `jats` (alias for `jats_archiving`)
125+ - `jats` (alias for `jats_archiving`)
139−- `jira`
126+ - `jira`
140− ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence
127+ ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)
141 wiki markup)
128 wiki markup)
142−- `json` (JSON version of native AST)
129+ - `json` (JSON version of native AST)
143−- `latex` ([LaTeX](https://www.latex-project.org/))
130+ - `latex` ([LaTeX](https://www.latex-project.org/))
144−- `man` ([roff man](https://man.cx/groff_man(7)))
131+ - `man` ([roff man](https://man.cx/groff_man\(7\)))
145−- `markdown` ([Pandoc’s
132+ - `markdown` ([Pandoc’s
146 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
133 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
147−- `markdown_mmd`
134+ - `markdown_mmd`
148 ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
135 ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
149−- `markdown_phpextra` ([PHP Markdown
136+ - `markdown_phpextra` ([PHP Markdown
150 Extra](https://michelf.ca/projects/php-markdown/extra/))
137 Extra](https://michelf.ca/projects/php-markdown/extra/))
151−- `markdown_strict` (original unextended
138+ - `markdown_strict` (original unextended
152 [Markdown](https://daringfireball.net/projects/markdown/))
139 [Markdown](https://daringfireball.net/projects/markdown/))
153−- `mediawiki` ([MediaWiki
140+ - `mediawiki` ([MediaWiki
154 markup](https://www.mediawiki.org/wiki/Help:Formatting))
141 markup](https://www.mediawiki.org/wiki/Help:Formatting))
155−- `ms` ([roff ms](https://man.cx/groff_ms(7)))
142+ - `ms` ([roff ms](https://man.cx/groff_ms\(7\)))
156−- `muse` ([Muse](https://amusewiki.org/library/manual)),
143+ - `muse` ([Muse](https://amusewiki.org/library/manual)),
157−- `native` (native Haskell),
144+ - `native` (native Haskell),
158−- `odt` ([OpenOffice text
145+ - `odt` ([OpenOffice text
159 document](https://en.wikipedia.org/wiki/OpenDocument))
146 document](https://en.wikipedia.org/wiki/OpenDocument))
160−- `opml` ([OPML](http://dev.opml.org/spec2.html))
147+ - `opml` ([OPML](http://dev.opml.org/spec2.html))
161−- `opendocument` ([OpenDocument](http://opendocument.xml.org))
148+ - `opendocument` ([OpenDocument](http://opendocument.xml.org))
162−- `org` ([Emacs Org mode](https://orgmode.org))
149+ - `org` ([Emacs Org mode](https://orgmode.org))
163−- `pdf` ([PDF](https://www.adobe.com/pdf/))
150+ - `pdf` ([PDF](https://www.adobe.com/pdf/))
164−- `plain` (plain text),
151+ - `plain` (plain text),
165−- `pptx`
152+ - `pptx`
166 ([PowerPoint](https://en.wikipedia.org/wiki/Microsoft_PowerPoint)
153 ([PowerPoint](https://en.wikipedia.org/wiki/Microsoft_PowerPoint)
167 slide show)
154 slide show)
168−- `rst`
155+ - `rst`
169 ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
156 ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
170−- `rtf` ([Rich Text
157+ - `rtf` ([Rich Text
171 Format](https://en.wikipedia.org/wiki/Rich_Text_Format))
158 Format](https://en.wikipedia.org/wiki/Rich_Text_Format))
172−- `texinfo` ([GNU Texinfo](https://www.gnu.org/software/texinfo/))
159+ - `texinfo` ([GNU Texinfo](https://www.gnu.org/software/texinfo/))
173−- `textile` ([Textile](https://www.promptworks.com/textile))
160+ - `textile` ([Textile](https://www.promptworks.com/textile))
174−- `slideous` ([Slideous](https://goessner.net/articles/slideous/) HTML
161+ - `slideous` ([Slideous](https://goessner.net/articles/slideous/) HTML
175 and JavaScript slide show)
162 and JavaScript slide show)
176−- `slidy` ([Slidy](https://www.w3.org/Talks/Tools/Slidy2/) HTML and
163+ - `slidy` ([Slidy](https://www.w3.org/Talks/Tools/Slidy2/) HTML and
177 JavaScript slide show)
164 JavaScript slide show)
178−- `dzslides` ([DZSlides](https://paulrouget.com/dzslides/) HTML5 +
165+ - `dzslides` ([DZSlides](http://paulrouget.com/dzslides/) HTML5 +
179 JavaScript slide show),
166 JavaScript slide show),
180−- `revealjs` ([reveal.js](https://revealjs.com/) HTML5 + JavaScript
167+ - `revealjs` ([reveal.js](https://revealjs.com/) HTML5 + JavaScript
181 slide show)
168 slide show)
182−- `s5` ([S5](https://meyerweb.com/eric/tools/s5/) HTML and JavaScript
169+ - `s5` ([S5](https://meyerweb.com/eric/tools/s5/) HTML and JavaScript
183 slide show)
170 slide show)
184−- `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple))
171+ - `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple))
185−- `xwiki` ([XWiki
172+ - `xwiki` ([XWiki
186 markup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/))
173 markup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/))
187−- `zimwiki` ([ZimWiki
174+ - `zimwiki` ([ZimWiki
188 markup](https://zim-wiki.org/manual/Help/Wiki_Syntax.html))
175 markup](https://zim-wiki.org/manual/Help/Wiki_Syntax.html))
189−- the path of a custom Lua writer, see [Custom
176+ - the path of a custom Lua writer, see [Custom
190 writers](https://pandoc.org/MANUAL.html#custom-writers) below
177 writers](https://pandoc.org/MANUAL.html#custom-writers) below
191
178
192</div>
179</div>
@@ -238,7 +225,7 @@ opening a new issue.
238
225
239## License
226## License
240
227
241−© 2006-2021 John MacFarlane (jgm@berkeley.edu). Released under the
228+© 2006-2020 John MacFarlane (jgm@berkeley.edu). Released under the
242−[GPL](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html "GNU General Public License"),
229+[GPL](http://www.gnu.org/copyleft/gpl.html "GNU General Public License"),
243version 2 or greater. This software carries no warranty of any kind.
230version 2 or greater. This software carries no warranty of any kind.
244(See COPYRIGHT for full copyright and warranty notices.)
231(See COPYRIGHT for full copyright and warranty notices.)
README.template+7−6
@@ -7,9 +7,10 @@ Pandoc
7======
7======
8
8
9[![github release](https://img.shields.io/github/release/jgm/pandoc.svg?label=current+release)](https://github.com/jgm/pandoc/releases)
9[![github release](https://img.shields.io/github/release/jgm/pandoc.svg?label=current+release)](https://github.com/jgm/pandoc/releases)
10−[![hackage release](https://img.shields.io/hackage/v/pandoc.svg?label=hackage)](https://hackage.haskell.org/package/pandoc)
10+[![hackage release](https://img.shields.io/hackage/v/pandoc.svg?label=hackage)](http://hackage.haskell.org/package/pandoc)
11−[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](https://formulae.brew.sh/formula/pandoc)
11+[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](http://brewformulas.org/Pandoc)
12−[![stackage LTS package](https://stackage.org/package/pandoc/badge/lts)](https://www.stackage.org/lts/package/pandoc-types)
12+[![stackage LTS package](http://stackage.org/package/pandoc/badge/lts)](http://stackage.org/lts/package/pandoc)
13+[![CircleCI](https://circleci.com/gh/jgm/pandoc.svg?style=svg)](https://circleci.com/gh/jgm/pandoc)
13[![CI tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
14[![CI tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
14[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
15[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
15[![pandoc-discuss on google groups](https://img.shields.io/badge/pandoc-discuss-red.svg?style=social)](https://groups.google.com/forum/#!forum/pandoc-discuss)
16[![pandoc-discuss on google groups](https://img.shields.io/badge/pandoc-discuss-red.svg?style=social)](https://groups.google.com/forum/#!forum/pandoc-discuss)
@@ -81,9 +82,9 @@ new issue.
81License
82License
82-------
83-------
83
84
84−© 2006-2021 John MacFarlane (jgm@berkeley.edu). Released under the
85+© 2006-2020 John MacFarlane (jgm@berkeley.edu). Released under the
85[GPL], version 2 or greater. This software carries no warranty of
86[GPL], version 2 or greater. This software carries no warranty of
86any kind. (See COPYRIGHT for full copyright and warranty notices.)
87any kind. (See COPYRIGHT for full copyright and warranty notices.)
87
88
88−[GPL]: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html "GNU General Public License"
89+[GPL]: http://www.gnu.org/copyleft/gpl.html "GNU General Public License"
89−[Haskell]: https://haskell.org
90+[Haskell]: http://haskell.org
RELEASE-CHECKLIST+1−3
@@ -1,11 +1,9 @@
1−[ ] use 'policeman' to check API changes and version update
2[ ] make README.md and commit if needed
1[ ] make README.md and commit if needed
3[ ] make man/pandoc.1 and commit if needed
2[ ] make man/pandoc.1 and commit if needed
4[ ] Finalize changelog
3[ ] Finalize changelog
4+ tools/changelog-helper.sh
5[ ] push release candidate branch rc/VERSION and (if it builds
5[ ] push release candidate branch rc/VERSION and (if it builds
6 successfully) download artifacts
6 successfully) download artifacts
7−[ ] run tools/build-arm.sh to create and download arm64 linux package
8−[ ] download macos artifacts from CircleCI
9[ ] Use 'make' in macos and windows artifacts to sign code
7[ ] Use 'make' in macos and windows artifacts to sign code
10[ ] make update-website
8[ ] make update-website
11[ ] make trypandoc
9[ ] make trypandoc
SECURITY.mddeleted−12
@@ -1,12 +0,0 @@
1−# Security Policy
2−
3−## Supported Versions
4−
5−Only the most recent version of pandoc is supported with security updates.
6−
7−## Reporting a Vulnerability
8−
9−To report a vulnerability, email the maintainer, jgm@berkeley.edu.
10−But first please read the section of the manual entitled
11−[A note on security](https://pandoc.org/MANUAL.html#a-note-on-security),
12−which describes some security guarantees pandoc does NOT make.
benchmark/benchmark-pandoc.hs+72−63
@@ -1,6 +1,8 @@
1+{-# LANGUAGE NoImplicitPrelude #-}
1{-# LANGUAGE OverloadedStrings #-}
2{-# LANGUAGE OverloadedStrings #-}
3+{-# LANGUAGE TupleSections #-}
2{-
4{-
3−Copyright (C) 2012-2021 John MacFarlane <jgm@berkeley.edu>
5+Copyright (C) 2012-2019 John MacFarlane <jgm@berkeley.edu>
4
6
5This program is free software; you can redistribute it and/or modify
7This program is free software; you can redistribute it and/or modify
6it under the terms of the GNU General Public License as published by
8it under the terms of the GNU General Public License as published by
@@ -16,88 +18,95 @@ You should have received a copy of the GNU General Public License
16along with this program; if not, write to the Free Software
18along with this program; if not, write to the Free Software
17Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18-}
20-}
21+import Prelude
19import Text.Pandoc
22import Text.Pandoc
20import Text.Pandoc.MIME
23import Text.Pandoc.MIME
21−import Control.DeepSeq (force)
24+import Text.Pandoc.Error (PandocError(..))
22import Control.Monad.Except (throwError)
25import Control.Monad.Except (throwError)
23import qualified Text.Pandoc.UTF8 as UTF8
26import qualified Text.Pandoc.UTF8 as UTF8
24import qualified Data.ByteString as B
27import qualified Data.ByteString as B
25import qualified Data.Text as T
28import qualified Data.Text as T
26−import Test.Tasty.Bench
29+import Criterion.Main
27−-- import Gauge
30+import Criterion.Types (Config(..))
28−import qualified Data.ByteString.Lazy as BL
31+import Data.List (intersect)
29import Data.Maybe (mapMaybe)
32import Data.Maybe (mapMaybe)
30−import Data.List (sortOn)
33+import System.Environment (getArgs)
34+import qualified Data.ByteString.Lazy as BL
31
35
32readerBench :: Pandoc
36readerBench :: Pandoc
33 -> T.Text
37 -> T.Text
34 -> Maybe Benchmark
38 -> Maybe Benchmark
35−readerBench _ name
39+readerBench doc name =
36− | name `elem` ["bibtex", "biblatex", "csljson"] = Nothing
40+ case res of
37−readerBench doc name = either (const Nothing) Just $
41+ Right (readerFun, inp) ->
42+ Just $ bench (T.unpack $ name <> " reader")
43+ $ nf (\i -> either (error . show) id $ runPure (readerFun i))
44+ inp
45+ Left _ -> Nothing
38− runPure $ do
46+ where res = runPure $ do
39− (rdr, rexts) <- getReader name
47+ (rdr, rexts) <- getReader name
40− (wtr, wexts) <- getWriter name
48+ (wtr, wexts) <- getWriter name
41− case (rdr, wtr) of
49+ case (rdr, wtr) of
42− (TextReader r, TextWriter w) -> do
50+ (TextReader r, TextWriter w) -> do
43− inp <- w def{ writerWrapText = WrapAuto
51+ setResourcePath ["../test"]
44− , writerExtensions = wexts } doc
45− return $ bench (T.unpack name) $
46− nf (either (error . show) id . runPure . r def) inp
47− (ByteStringReader r, ByteStringWriter w) -> do
48− tmpl <- Just <$> compileDefaultTemplate name
49− inp <- w def{ writerWrapText = WrapAuto
52+ inp <- w def{ writerWrapText = WrapAuto
50− , writerExtensions = wexts
53+ , writerExtensions = wexts } doc
51− , writerTemplate = tmpl } doc
52− return $ bench (T.unpack name) $
53− nf (either (error . show) id .
54− runPure . r def{readerExtensions = rexts}) inp
54+ return $ (r def{ readerExtensions = rexts }, inp)
55− _ -> throwError $ PandocSomeError $ "text/bytestring format mismatch: "
55+ _ -> throwError $ PandocSomeError $ "not a text format: "
56− <> name
56+ <> name
57
57
58getImages :: IO [(FilePath, MimeType, BL.ByteString)]
58getImages :: IO [(FilePath, MimeType, BL.ByteString)]
59getImages = do
59getImages = do
60− ll <- B.readFile "test/lalune.jpg"
60+ ll <- BL.readFile "test/lalune.jpg"
61− mv <- B.readFile "test/movie.jpg"
61+ mv <- BL.readFile "test/movie.jpg"
62− return [("lalune.jpg", "image/jpg", BL.fromStrict ll)
62+ return [("lalune.jpg", "image/jpg", ll)
63− ,("movie.jpg", "image/jpg", BL.fromStrict mv)]
63+ ,("movie.jpg", "image/jpg", mv)]
64
64
65−writerBench :: [(FilePath, MimeType, BL.ByteString)]
66− -> Pandoc
65+writerBench :: Pandoc
67 -> T.Text
66 -> T.Text
68 -> Maybe Benchmark
67 -> Maybe Benchmark
69−writerBench _ _ name
68+writerBench doc name =
70− | name `elem` ["bibtex", "biblatex", "csljson"] = Nothing
71−writerBench imgs doc name = either (const Nothing) Just $
72− runPure $ do
73− (wtr, wexts) <- getWriter name
74− case wtr of
69+ case res of
75− TextWriter writerFun ->
70+ Right writerFun ->
76− return $ bench (T.unpack name)
71+ Just $ env getImages $ \imgs ->
77− $ nf (\d -> either (error . show) id $
78− runPure $ do
79− mapM_ (\(fp,mt,bs) -> insertMedia fp (Just mt) bs) imgs
80− writerFun def{ writerExtensions = wexts} d)
81− doc
82− ByteStringWriter writerFun ->
83− return $ bench (T.unpack name)
72+ bench (T.unpack $ name <> " writer")
84 $ nf (\d -> either (error . show) id $
73 $ nf (\d -> either (error . show) id $
85− runPure $ do
74+ runPure (do mapM_
75+ (\(fp, mt, bs) ->
86− mapM_ (\(fp,mt,bs) -> insertMedia fp (Just mt) bs) imgs
76+ insertMedia fp (Just mt) bs)
77+ imgs
78+ writerFun d)) doc
79+ Left _ -> Nothing
80+ where res = runPure $ do
81+ (wtr, wexts) <- getWriter name
82+ case wtr of
83+ TextWriter w ->
87− writerFun def{ writerExtensions = wexts} d)
84+ return $ w def{ writerExtensions = wexts }
88− doc
85+ _ -> throwError $ PandocSomeError
86+ $ "could not get text writer for " <> name
89
87
90main :: IO ()
88main :: IO ()
91main = do
89main = do
90+ args <- filter (\x -> T.take 1 x /= "-") . fmap T.pack <$> getArgs
91+ print args
92+ let matchReader (n, TextReader _) =
93+ null args || ("reader" `elem` args && n `elem` args)
94+ matchReader _ = False
95+ let matchWriter (n, TextWriter _) =
96+ null args || ("writer" `elem` args && n `elem` args)
97+ matchWriter _ = False
98+ let matchedReaders = map fst $ (filter matchReader readers
99+ :: [(T.Text, Reader PandocPure)])
100+ let matchedWriters = map fst $ (filter matchWriter writers
101+ :: [(T.Text, Writer PandocPure)])
92 inp <- UTF8.toText <$> B.readFile "test/testsuite.txt"
102 inp <- UTF8.toText <$> B.readFile "test/testsuite.txt"
93 let opts = def
103 let opts = def
94− let doc = either (error . show) force $ runPure $ readMarkdown opts inp
104+ let doc = either (error . show) id $ runPure $ readMarkdown opts inp
95− defaultMain
96− [ env getImages $ \imgs ->
97− bgroup "writers" $ mapMaybe (writerBench imgs doc . fst)
98− (sortOn fst
99− writers :: [(T.Text, Writer PandocPure)])
100− , bgroup "readers" $ mapMaybe (readerBench doc . fst)
105+ let readerBs = mapMaybe (readerBench doc)
101− (sortOn fst
106+ $ filter (/="haddock")
102− readers :: [(T.Text, Reader PandocPure)])
107+ (matchedReaders `intersect` matchedWriters)
103− ]
108+ -- we need the corresponding writer to generate
109+ -- input for the reader
110+ let writerBs = mapMaybe (writerBench doc) matchedWriters
111+ defaultMainWith defaultConfig{ timeLimit = 6.0 }
112+ (writerBs ++ readerBs)
benchmark/weigh-pandoc.hsnew file+50
@@ -0,0 +1,50 @@
1+{-# LANGUAGE NoImplicitPrelude #-}
2+{-# LANGUAGE OverloadedStrings #-}
3+{- |
4+ Module : Main
5+ Copyright : © 2016-2019 John MacFarlane <jgm@berkeley.edu>
6+ License : GNU GPL, version 2 or above
7+
8+ Maintainer : John MacFarlane <jgm@berkeley.edu>
9+ Stability : alpha
10+ Portability : portable
11+
12+Benchmarks to determine resource use of readers and writers.
13+-}
14+import Prelude
15+import Weigh
16+import Text.Pandoc
17+import Data.Text (Text, unpack)
18+
19+main :: IO ()
20+main = do
21+ doc <- read <$> readFile "test/testsuite.native"
22+ mainWith $ do
23+ func "Pandoc document" id doc
24+ mapM_
25+ (\(n,r) -> weighReader doc n (either (error . show) id . runPure . r def{readerExtensions = pandocExtensions}))
26+ [("markdown", readMarkdown)
27+ ,("html", readHtml)
28+ ,("docbook", readDocBook)
29+ ,("latex", readLaTeX)
30+ ,("commonmark", readCommonMark)
31+ ]
32+ mapM_
33+ (\(n,w) -> weighWriter doc n (either (error . show) id . runPure . w def))
34+ [("markdown", writeMarkdown)
35+ ,("html", writeHtml5String)
36+ ,("docbook", writeDocbook5)
37+ ,("latex", writeLaTeX)
38+ ,("commonmark", writeCommonMark)
39+ ]
40+
41+weighWriter :: Pandoc -> String -> (Pandoc -> Text) -> Weigh ()
42+weighWriter doc name writer = func (name ++ " writer") writer doc
43+
44+weighReader :: Pandoc -> Text -> (Text -> Pandoc) -> Weigh ()
45+weighReader doc name reader = do
46+ case lookup name writers of
47+ Just (TextWriter writer) ->
48+ let inp = either (error . show) id $ runPure $ writer def{ writerWrapText = WrapAuto} doc
49+ in func (unpack $ name <> " reader") reader inp
50+ _ -> return () -- no writer for reader
cabal.project+14−8
@@ -1,13 +1,19 @@
1packages: pandoc.cabal
1packages: pandoc.cabal
2−tests: True
2+
3+package pandoc
4+ flags: +embed_data_files -trypandoc
5+ ghc-options: -j +RTS -A64m -RTS
6+
7+package pandoc-citeproc
3−flags: +embed_data_files
8+ flags: +embed_data_files +bibutils -unicode_collation -test_citeproc -debug
9+ ghc-options: -j +RTS -A64m -RTS
4
10
5source-repository-package
11source-repository-package
6− type: git
12+ type: git
7− location: https://github.com/jgm/doctemplates
13+ location: https://github.com/jgm/pandoc-citeproc
8− tag: 428c26d5303cf7a2b1051fe1ffd9aafe9ba71c81
14+ tag: 2e6fe791ec5293acc925c2ccbe79c9c10d2b7e07
9
15
10source-repository-package
16source-repository-package
11− type: git
17+ type: git
12− location: https://github.com/jgm/citeproc
18+ location: https://github.com/jgm/pandoc-types
13− tag: 4ce0501cd6f9c86eee087afcf878c256e49b9615
19+ tag: dd50a6eaeaf63773bbf04d6ef34b86d6f92b7825
changelog.md+20−3091
@@ -1,3076 +1,5 @@
1# Revision history for pandoc
1# Revision history for pandoc
2
2
3−## pandoc 2.14.0.3 (2021-06-22)
4−
5− * Text.Pandoc.MediaBag `insertMediaBag`: ensure we get a sane mediaPath
6− for URLs (#7391). In earlier 2.14.x versions, we'd get
7− incorrect paths for resources downloaded from URLs when the
8− media are extracted (including in PDF production).
9− * Text.Pandoc.Parsing: improve `emailAddress` (#7398).
10− Previously the parser would accept characters in domains
11− that are illegal in domains, and this sometimes caused it
12− to gobble bits of the following text.
13− * txt2tags reader: modify the email address parser so
14− it still includes form parameters, even after the change to
15− `emailAddress` in Text.Pandoc.Parsing.
16− * Text.Pandoc.Readers.Metadata: Fix regression with comment-only YAML
17− metadata blocks (#7400).
18− * reveal.js writer and template: better handling of options. Previously
19− it was impossible to specify false values for options that default to
20− true (e.g. `center`); setting the option to false just caused the portion
21− of the template setting the option to be omitted. Now we prepopulate
22− all the variables with their default values, including them all
23− unconditionally and allowing them to be overridden.
24− * Markdown writer: Fix regression in code blocks with attributes (#7397).
25− Code blocks with a single class but nonempty attributes
26− were having attributes drop as a result of #7242.
27− * LaTeX writer:
28− + Add strut at end of minipage if it contains line breaks.
29− Without them, the last line is not as tall as it should be in
30− some cases.
31− + Always use a minipage for cells with line breaks, when
32− width information is available (#7393). Otherwise the way we treat them
33− can lead to content that overflows a cell.
34− + Use `\strut` instead of `~` before `\\` in empty line.
35− * Use lts-18.0 stack resolver.
36− * Require skylighting 0.10.5.2 (adding support for Swift).
37− * Require commonmark 0.2.1.
38− * Rephrase section on unsafe HTML in manual.
39− * Create SECURITY.md
40−
41−## pandoc 2.14.0.2 (2021-06-13)
42−
43− * Fix MediaBag regressions (#7345). iIn the 2.14 release `--extract-media`
44− stopped working as before; there could be mismatches between the
45− paths in the rendered document and the extracted media.
46− This patch makes several changes that restore the earlier behavior
47− (while keeping the same API). The `mediaPath` in 2.14 was always
48− constructed from the SHA1 hash of the media contents. Now, we
49− preserve the original path unless it's an absolute path or contains
50− `..` segments (in that case we use a path based on the SHA1 hash of
51− the contents).
52−
53− In Text.Pandoc.MediaBag, `mediaDirectory` and `mediaItems` now use the
54− `mediaPath`, rather than the mediabag key, for the first component of the
55− tuple. This makes more sense, I think, and fits with the documentation of
56− these functions; eventually, though, we should rework the API so that
57− `mediaItems` returns both the keys and the MediaItems.
58−
59− In Text.Pandoc.Class.IO, rewriting of source paths in `extractMedia` has
60− been fixed.
61−
62− In Text.Pandoc.Class.PandocMonad, `fillMediaBag` has been modified so that
63− it doesn't modify image paths (that was part of the problem in #7345).
64−
65− We now do path normalization (e.g. `\` separators on Windows) in
66− writing the media.
67−
68− * Text.Pandoc.PDF:
69−
70− + Text.Pandoc.PDF: Fix regression in 2.14 for generation of PDFs with
71− SVGs (#7344).
72− + Only print relevant part of environment on `--verbose`. Since
73− `--verbose` output might be put in an issue, we want to avoid
74− spilling out secrets in environment variables.
75−
76− * Markdown reader: fix pipe table regression in 2.11.4 (#7343).
77− Previously pipe tables with empty headers (that is, a header
78− line with all empty cells) would be rendered as headerless
79− tables. This broke in 2.11.4. The fix here is to produce an
80− AST with an empty table head when a pipe table has all empty
81− header cells.
82−
83− * LaTeX reader: don't allow optional `*` on symbol control sequences
84− (#7340). Generally we allow optional starred variants of LaTeX commands
85− (since many allow them, and if we don't accept these explicitly,
86− ignoring the star usually gives acceptable results). But we
87− don't want to do this for `\(*\)` and similar cases.
88−
89− * Docx reader: handle absolute URIs in Relationship Target (#7374).
90−
91− * Docx writer: fix handling of empty table headers (Albert Krewinkel,
92− #7369). A table header which does not contain any cells is now treated as
93− an empty header.
94−
95− * LaTeX writer: Fix regression in table header position (#7347).
96− In recent versions the table headers were no longer bottom-aligned
97− (if more than one line). This patch fixes that by using minipages
98− for table headers in non-simple tables.
99−
100− * CommonMark writer:
101−
102− + Do not use simple class for fenced-divs (Jan Tojnar, amends #7242.)
103− + Do not throw away attributes when `Ext_attributes` is enabled.
104− `Ext_attributes` covers at least the following:
105− `Ext_fenced_code_attributes`, `Ext_header_attributes`,
106− `Ext_inline_code_attributes`, `Ext_link_attributes`.
107−
108− * Markdown writer:
109−
110− + Allow `pipe_tables` to be disabled for commonmark formats
111− (`commonmark_x`, `gfm`) (#7375).
112− + Re-use functions from Text.Pandoc.Markdown.Inline (Jan Tojnar).
113−
114− * DocBook writer: Remove non-existent admonitions (Jan Tojnar).
115− `attention`, `error` and `hint` are reStructuredText specific.
116−
117− * HTML writer: Don't omit width attribute on div (#7342).
118−
119− * Text.Pandoc.MIME, `extensionFromMimeType`: add a few special cases.
120− When we do a reverse lookup in the MIME table, we just get the
121− last match, so when the same mime type is associated with several
122− different extensions, we sometimes got weird results, e.g. `.vs`
123− for `text/plain`. These special cases help us get the most standard
124− extensions for mime types like `text/plain`.
125−
126− * Lua utils: fix handling of table headers in `from_simple_table` (Albert
127− Krewinkel, #7369). Passing an empty list of header cells now results
128− in an empty table header.
129−
130− * Text.Pandoc.Citeproc:
131−
132− + Avoid duplicate classes and attributes on references div.
133− + Fix regression in citeproc processing (#7376). If inline
134− references are used (in the metadata `references` field), we
135− should still only include in the bibliography items that are
136− actually cited (unless `nocite` is used).
137−
138− * Require citeproc 0.4.0.1. This fixes a bug which led to doubled
139− "et al." in some (rare) circumstances.
140−
141− * MANUAL.txt:
142−
143− + Mention GladTeX for EPUB export (Sebastian Humenda).
144− This updates the manual and the web site about the GladTeX usage.
145− + More details and a useful link for YAML syntax.
146−
147− * CONTRIBUTING.md: update modules overview (Albert Krewinkel).
148−
149− * using-the-pandoc-api.md: switch from String to Text (Albert Krewinkel).
150−
151−
152−## pandoc 2.14.0.1 (2021-06-01)
153−
154− * Commonmark reader: Fix regression in 2.14 with YAML metdata block parsing,
155− which could cause the document body to be omitted after metadata (#7339).
156−
157− * HTML reader: fix column width regression in 2.14 (#7334).
158− Column widths specified with a style attribute were off by a factor of 100.
159−
160− * Markdown reader: in `rebasePaths`, check for both Windows and Posix
161− absolute paths. Previously Windows pandoc was treating
162− `/foo/bar.jpg` as non-absolute.
163−
164− * Text.Pandoc.Logging: In rendering `LoadedResource`, use relative paths.
165−
166− * Docx writer: fix regression on captions (#7328). The "Table Caption"
167− style was no longer getting applied. (It was overwritten by "Compact.")
168−
169− * Use commonmark-extensions 0.2.1.2
170−
171−## pandoc 2.14 (2021-05-28)
172−
173− * Change reader types, allowing better tracking of source positions
174− [API change]. Previously, when multiple file arguments were provided,
175− pandoc simply concatenated them and passed the contents to the readers,
176− which took a Text argument. As a result, the readers had no way of knowing
177− which file was the source of any particular bit of text. This meant that
178− we couldn't report accurate source positions on errors or include accurate
179− source positions as attributes in the AST. More seriously, it meant that
180− we couldn't resolve resource paths relative to the files containing them
181− (see e.g. #5501, #6632, #6384, #3752).
182−
183− * Add `rebase_relative_paths` extension (#3752). When enabled, this
184− extension rewrites relative image and link paths by prepending
185− the (relative) directory of the containing file. This
186− behavior is useful when your input sources are split
187− into multiple files, across several directories, with files
188− referring to images stored in the same directory. The
189− extension can be enabled for all markdown and commonmark-based formats.
190−
191− * Add Text.Pandoc.Sources (exported module), with a `Sources` type and a
192− `ToSources` class. A `Sources` wraps a list of `(SourcePos, Text)` pairs
193− [API change]. A parsec `Stream` instance is provided for `Sources`. The
194− module also exports versions of parsec's `satisfy` and other Char parsers
195− that track source positions accurately from a `Sources` stream (or any
196− instance of the new `UpdateSourcePos` class).
197−
198− * Text.Pandoc.Parsing
199−
200− + Export the modified Char parsers defined in Text.Pandoc.Sources
201− instead of the ones parsec provides. Modified parsers to use a
202− `Sources` as stream [API change].
203− + Improve include file functions [API change]. Remove old
204− `insertIncludedFileF`. Give `insertIncludedFile` a more general type,
205− allowing it to be used where `insertIncludedFileF` was.
206− + Add parameter to the `citeKey` parser from
207− Text.Pandoc.Parsing, which controls whether the `@{..}`
208− syntax is allowed [API change].
209−
210− * Text.Pandoc.Error: Modified the constructor `PandocParsecError` to take a
211− `Sources` rather than a `Text` as first argument, so parse error locations
212− can be accurately reported.
213−
214− * Fix source position reporting for YAML bibliographies (#7273).
215−
216− * Issue error message when reader or writer format is malformed
217− (#7231). Previously we exited with an error status but (due to a bug)
218− no message.
219−
220− * Smarter smart quotes (#7216, #2103). Treat a leading `"` with no
221− closing `"` as a left curly quote. This supports the practice, in
222− fiction, of continuing paragraphs quoting the same speaker without an
223− end quote. It also helps with quotes that break over lines in line blocks.
224−
225− * Markdown reader:
226−
227− + Use MetaInlines not MetaBlocks for multimarkdown metadata fields.
228− This gives better results in converting to e.g. pandoc markdown.
229− + Implement curly-brace syntax for Markdown citation keys (#6026).
230− The change provides a way to use citation keys that contain
231− special characters not usable with the standard citation key syntax.
232− Example: `@{foo_bar{x}'}` for the key `foo_bar{x}`. It also allows
233− separating citation keys from immediately following text, e.g. `@{foo}A`.
234−
235− * RST reader:
236−
237− + Seek include files in the directory of the file
238− containing the include directive, as RST requires (#6632).
239− + Use `insertIncludedFile` from Text.Pandoc.Parsing
240− instead of reproducing much of its code.
241−
242− * Org reader: Resolve org includes relative to the directory containing the
243− file containing the INCLUDE directive (#5501).
244−
245− * ODT reader: Treat tabs as spaces (#7185, niszet).
246−
247− * Docx reader:
248−
249− + Add handling of vml image objects (#7257, mbrackeantidot).
250− + Support new table features (Emily Bourke, #6316): column
251− spans, row spans, multiple header rows, table description
252− (parsed as a simple caption), captions, column widths.
253−
254− * LaTeX reader:
255−
256− + Improved siunitx support (#6658, #6620).
257− + Better support for `\xspace` (#7299).
258− + Improve parsing of `\def` macros. We previously set "verbatim mode"
259− even for parsing the initial `\def`; this caused problems
260− for `\def` nested inside another `\def`.
261− + Implement `\newif`.
262−
263− * ConTeXt writer: improve ordered lists (#5016, Denis Maier).
264− Change ordered list from itemize to enumerate. Add new
265− itemgroup for ordered lists. Remove manual insertion of
266− width attributes. Use tabular figures in ordered list
267− enumerators.
268−
269− * HTML reader:
270−
271− + Don't fail on unmatched closing "script" tag (Albert Krenkel, #7282).
272− + Keep h1 tags as normal headers (#2293, Albert Krewinkel).
273− The tags `<title>` and `<h1 class="title">` often contain the same
274− information, so the latter was dropped from the document. However, as
275− this can lead to loss of information, the heading is now always
276− retained. Use `--shift-heading-level-by=-1` to turn the `<h1>`
277− into the document title, or a filter to restore the previous behavior.
278− + Handle relative lengths (e.g. `2*`) in HTML column widths (#4063).
279− See <https://www.w3.org/TR/html4/types.html#h-6.6>.
280−
281− * DocBook/JATS readers:
282−
283− + Fix mathml regression caused by the switch in XML libraries (#7173).
284− + Fix "phrase" in DocBook: take classes from "role" not "class" (#7195).
285−
286− * DocBook reader: ensure that first and last names are separated (#6541).
287−
288− * Jira reader (Albert Krewinkel, #7218):
289−
290− + Support "smart" links: `[alias|https://example.com|smart-card]` syntax.
291− + Allow spaces and most unicode characters in attachment links.
292− + No longer require a newline character after `{noformat}`.
293− + Only allow URI path segment characters in bare links.
294− + The `file:` schema is no longer allowed in bare links; these
295− rarely make sense.
296−
297− * Plain writer: handle superscript unicode minus (#7276).
298−
299− * LaTeX writer:
300−
301− + Better handling of line breaks in simple tables (#7272).
302− Now we also handle the case where they're embedded in other elements,
303− e.g. spans.
304− + For beamer output, support `exampleblock` and `alertblock` (#7278).
305− A block will be rendered as an `exampleblock` if the heading
306− has class `example` and an `alertblock` if it has class `alert`.
307− + Separate successive quote chars with thin space (#6958,
308− Albert Krewinkel). Successive quote characters are separated with
309− a thin space to improve readability and to prevent unwanted ligatures.
310− Detection of these quotes sometimes had failed if the second quote
311− was nested in a span element.
312− + Separate successive quote chars with thin space (#6958, Albert
313− Krewinkel).
314−
315− * EPUB Writer: Fix belongs-to-collection XML id choice (#7267, nuew).
316− The epub writer previously used the same XML id for both the book
317− identifier and the epub collection. This causes an error on epubcheck.
318−
319− * BibTeX/BibLaTeX writer: Handle `annote` field (#7266).
320−
321− * ZimWiki writer: allow links and emphasis in headers (#6605,
322− Albert Krewinkel).
323−
324− * ConTeXt writer:
325−
326− + Support blank lines in line blocks (#6564, Albert Krewinkel,
327− thanks to @denismaier).
328− + Use span identifiers as reference anchors (#7246, Albert Krewinkel).
329−
330− * HTML writer:
331−
332− + Keep attributes from code nested below `pre` tag (#7221,
333− Albert Krewinkel). If a code block is defined with `<pre><code
334− class="language-x">…</code></pre>`, where the `<pre>` element has no
335− attributes, then the attributes from the `<code>` element are used
336− instead. Any leading `language-` prefix is dropped in the code's
337− `class` attribute are dropped to improve syntax highlighting.
338− + Ensure headings only have valid attribs in HTML4 (#5944, Albert
339− Krewinkel).
340− + Parse `<header>` as a Div (Albert Krewinkel).
341−
342− * Org writer:
343−
344− + Inline latex envs need newlines (#7252, tecosaur).
345− As specified in https://orgmode.org/manual/LaTeX-fragments.html, an
346− inline \begin{}...\end{} LaTeX block must start on a new line.
347− + Use LaTeX style maths deliminators (#7196, tecosaur).
348−
349− * JATS writer (Albert Krewinkel):
350−
351− + Use either styled-content or named-content for spans (#7211).
352− If the element has a content-type attribute, or at least one class,
353− then that value is used as `content-type` and the span is put inside
354− a `<named-content>` element. Otherwise a `<styled-content>` element
355− is used instead.
356− + Reduce unnecessary use of `<p>` elements for wrapping (#7227).
357− The `<p>` element is used for wrapping in cases were the contents
358− would otherwise not be allowed in a certain context. Unnecessary
359− wrapping is avoided, especially around quotes (`<disp-quote>` elements).
360− + Convert spans to `<named-content>` elements (#7211). Spans with
361− attributes are converted to `<named-content>` elements instead of
362− being wrapped with `<milestone-start/>` and `<milestone-end>`
363− elements. Milestone elements are not allowed in documents using the
364− articleauthoring tag set, so this change ensures the creation of valid
365− documents.
366− + Add footnote number as label in backmatter (#7210). Footnotes in the
367− backmatter are given the footnote's number as a label. The
368− articleauthoring output is unaffected from this change, as footnotes
369− are placed inline there.
370− + Escape disallows chars in identifiers. XML identifiers must start
371− with an underscore or letter, and can contain only a limited set
372− of punctuation characters. Any IDs not adhering to these rules are
373− rewritten by writing the offending characters as `Uxxxx`,
374− where `xxxx` is the character's hex code.
375−
376− * Jira writer: use `{color}` when span has a color attribute
377− (Albert Krewinkel, tarleb/jira-wiki-markup#10).
378−
379− * Docx writer:
380−
381− + Autoset table width if no column has an explicit width (Albert
382− Krewinkel).
383− + Extract Table handling into separate module (Albert Krewinkel).
384− + Support colspans and rowspans in tables (Albert Krewinkel, #6315).
385− + Support multirow table headers (Albert Krewinkel).
386− + Improve integration of settings from reference.docx (#1209).
387− This change allows users to create a reference.docx that
388− sets `w:proofState` for spelling or grammar to `dirty`,
389− so that spell/grammar checking will be triggered on the
390− generated docx.
391− + Copy over more settings from reference.docx (#7240). From settings.xml
392− in the reference-doc, we now include: `zoom`, `embedSystemFonts`,
393− `doNotTrackMoves`, `defaultTabStop`, `drawingGridHorizontalSpacing`,
394− `drawingGridVerticalSpacing`, `displayHorizontalDrawingGridEvery`,
395− `displayVerticalDrawingGridEvery`, `characterSpacingControl`,
396− `savePreviewPicture`, `mathPr`, `themeFontLang`, `decimalSymbol`,
397− `listSeparator`, `autoHyphenation`, `compat`.
398− + Set zoom to 100% by default in settings.xml.
399− + Align math options more with current Word defaults (e.g. Cambria Math
400− font).
401− + Remove `rsid`s from default settings.xml. Word will add these
402− when revisions are made.
403−
404− * Ms writer: Handle tables with multiple paragraphs (#7288).
405− Previously they overflowed the table cell width. We now set line lengths
406− per-cell and restore them after the table has been written.
407−
408− * Markdown writer:
409−
410− + Use cleaner braceless syntax for code blocks with a
411− single class (#7242, Jan Tojnar).
412− + Add quotes properly in markdown YAML metadata fields (#7245).
413− This fixes a bug, which caused the writer to look at the *last*
414− rather than the *first* character in determining whether quotes
415− were needed. So we got spurious quotes in some cases and
416− didn't get necessary quotes in others.
417− + Use `@{..}` syntax for citations when needed.
418− + Use fewer unneeded escapes for `#` (see #6259).
419− + Improve escaping of `@`. We need to escape literal `@` before
420− `{` because of the new citation syntax.
421−
422− * Commonmark writer: Use backslash escapes for `<` and `|`...
423− instead of entities (#7208).
424−
425− * Powerpoint writer: allow `monofont` to be specified in metadata
426− (#7187).
427−
428− * LaTeX template:
429−
430− + Use non-starred names for xcolor color names (#6109).
431− This should make svgnames and x11names work properly.
432− + Fix bad vertical spacing after bibliography (#7234, badumont).
433− + List of figures before list of tables (#7235, Julien Dutant).
434− + Move CSL macro definitions before header-includes so they can be
435− overridden (#7286).
436− + Improve treatment of CSL `entry-spacing` (#7296).
437− Previously with the default template settings (`indent` variable
438− not set), we would get interparagraph spaces separating bib
439− entries even with `entry-spacing="0"`. On the other hand,
440− setting `entry-spacing="2"` gave ridiculously large spacing.
441− This change makes the spacing caused by `entry-spacing` a multiple
442− of `\parskip` by default, which gives aesthetically reasonable
443− output. Those who want a larger or smaller unit (e.g. because
444− they use `indent` which sets `\parskip` to 0) may
445− `\setlength{\cslentryspacingunit}{10pt}` in header-includes
446− to override the defaults.
447− + Move title, author, date up to top of preamble (#7295).
448− This allows header-includes to use them, and puts them
449− in a position where you can see them immediately.
450− + Define commands for zero width non-joiner character
451− (#6639, Albert Krewinkel). The zero-width non-joiner character
452− is used to avoid ligatures (e.g. in German).
453−
454− * ConTeXt template:
455−
456− + Define `enumerate` itemgroup (#5016, Denis Maier).
457− + List of figures before list of tables (#7235, Julien Dutant).
458−
459− * reveal.js template:
460−
461− + Support `toc-title` (#7171, Florian Kohrt).
462− + Use `hash: true` by default rather than `history: true` (#6968).
463−
464− * HTML-based slide shows: add support for `institute` (#7289, Thomas
465− Hodgson).
466−
467− * Text.Pandoc.Extensions: Add constructor `Ext_rebase_relative_paths` to
468− `Extensions` [API change].
469−
470− * Text.Pandoc.XML.Light: add Eq, Ord instances for Content,
471− Element, Attr, CDataKind [API change].
472−
473− * Text.Pandoc.MediaBag:
474−
475− + Change type to use a `Text` key instead of `[FilePath]`.
476− We normalize the path and use `/` separators for consistency.
477− + Export `MediaItem` type [API change].
478− + Change `MediaBag` type to a map from Text to MediaItem [API change].
479− + `lookupMedia` now returns a `MediaItem` [API change].
480− + Change `insertMedia` so it sets the `mediaPath` to a filename based on
481− the SHA1 hash of the contents. This will be used when contents
482− are extracted.
483−
484− * Text.Pandoc.Class.PandocMonad:
485−
486− + Remove `fetchMediaResource` [API change]. Use `fetchItem` to get
487− resources in `fillMediaBag`.
488− + Add informational message in `downloadOrRead` indicating what path
489− local resources have been loaded from.
490−
491− * Text.Pandoc.Logging:
492−
493− + Remove single quotes around paths in messages.
494− + Add LoadedResource constructor to LogMessage [API change].
495− This is for INFO-level messages telling where image data has been
496− loaded from. (This can vary because of the resource path.)
497−
498− * Text.Pandoc.Asciify: simplify code and export `toAsciiText` [API change].
499− Instead of encoding a giant (and incomplete) map, we now
500− just use unicode-transforms to normalize the text to
501− a canonical decomposition, and manipulate the result.
502−
503− * App: allow tabs expansion even if file-scope is used (Albert Krewinkel,
504− #6709). Tabs in plain-text inputs are now handled correctly, even if
505− the `--file-scope` flag is used.
506−
507− * Add new internal module Text.Pandoc.Writers.GridTable (Albert Krewinkel).
508−
509− * Text.Pandoc.Highlighting: Change type of `languagesByExtension`, adding
510− a parameter for a `SyntaxMap` [API change] (Jan Tojnar, #7241).
511− Languages defined using `--syntax-definition` were not recognized by
512− `languagesByExtension`. This patch corrects that, allowing the writers
513− to see all custom definitions. The LaTeX writer still uses the default
514− syntax map, but that's okay in that context, since
515− `--syntax-definition` won't create new listings styles.
516−
517− * Text.Pandoc.Citeproc:
518−
519− + Ensure that CSL-related attributes are passed on to a Div with id
520− 'refs'. Otherwise things like `entry-spacing` won't work when
521− such Divs are used.
522− + Use metadata's `lang` for the lang parameter of citeproc, overriding
523− `localeLanguage`.
524− + Recognize locators spelled with a capital letter (#7323).
525− + Add a comma and a space in front of the suffix if it doesn't start
526− with space or punctuation (#7324).
527− + Don't detect math elements as locators (#7321).
528−
529− * Remove Text.Pandoc.BCP47 module [API change]. Use types and functions
530− from UnicodeCollation.Lang instead. This is a richer implementation
531− of BCP 47.
532−
533− * Text.Pandoc.Shared:
534−
535− + Fix regression in grid tables for wide characters (#7214).
536− In the translation from String to Text, a char-width-sensitive
537− `splitAt'` was dropped. This commit reinstates it and uses it to make
538− `splitTextByInstances` char-width sensitive.
539− + Add `getLang` (formerly in the now-removed BCP47) [API change].
540−
541− * Text.Pandoc.SelfContained: use `application/octet-stream`
542− for unknown mime types instead of halting with an error (#7202).
543−
544− * Lua filters: respect Inlines/Blocks filter functions in `pandoc.walk_*`
545− (Albert Krewinkel).
546−
547− * Add text as build-depend for trypandoc (#7193, Roman Beránek).
548−
549− * Bump upper-bounds for network-uri, time, attoparsec.
550−
551− * Use citeproc 0.4.
552−
553− * Use texmath 0.12.3.
554−
555− * Use jira-wiki-markup 1.3.5 (Albert Krewinkel).
556−
557− * Require latest skylighting (fixes a bug in XML syntax highlighting).
558−
559− * Use latest xml-conduit.
560−
561− * Use latest commonmark, commonmark-extensions, commonmark-pandoc.
562−
563− * Use haddock-library-1.10.0 (Albert Krewinkel).
564−
565− * Allow compilation with base 4.15 (Albert Krewinkel).
566−
567− * MANUAL:
568−
569− + Add information about `lang` and bibliography sorting.
570− + Add info about YAML escape sequences, link to spec (#7152,
571− Albert Krewinkel).
572− + Note that `institute` variable works for HTML-based slides.
573− + Update documentation on citation syntax.
574− + Add citation example for locators and suffixes (Tristan Stenner)
575−
576− * Updated and fixed typos in documentation (Charanjit Singh,
577− Anti-Distinctlyminty, Tatiana Porras, obcat).
578−
579− * Add instructions for installing pandoc-types before compiling filter.
580−
581− * INSTALL: add note that parallel installations should be avoided
582− (#6865).
583−
584− * Remove `biblatex-nussbaum.md` test. It is basically the same
585− as `biblaetx-quotes.md`.
586−
587− * Command tests: fail if a file contains no tests---and fix a
588− test that failed in that way!
589−
590− * Use smaller images in tests, reducing the size of the source tarball by 8 MB.
591−
592−
593−## pandoc 2.13 (2021-03-21)
594−
595− * Support `yaml_metadata_block` extension for `commonmark`, `gfm` (#6537).
596− This supported is a bit more limited than with pandoc's
597− `markdown`. The YAML block must be the first thing in the input,
598− and the leaf notes are parsed in isolation from the rest of
599− the document. So, for example, you can't use reference
600− links if the references are defined later in the document.
601−
602− * Fix fallback to default partials when custom templates are used.
603− If the directory containing a template does not contain the partial,
604− it should be sought in the default templates, but this was not
605− working properly (#7164).
606−
607− * Handle `nocite` better with `--biblatex` and `--natbib` (#4585).
608− Previously the nocite metadata field was ignored with these formats.
609− Now it populates a `nocite-ids` template variable and causes a
610− `\nocite` command to be issued.
611−
612− * Text.Pandoc.Citeproc: apply `fixLinks` correctly (#7130). This is code
613− that incorporates a prefix like `https://doi.org/` into a following link
614− when appropriate.
615−
616− * Text.Pandoc.Shared:
617−
618− + Remove `backslashEscapes`, `escapeStringUsing` [API change]. Replace
619− these inefficient association list lookups with more efficient escaping
620− functions in the writers that used them (for a 10-25% performance boost
621− in org, haddock, rtf, texinfo writers).
622− + Remove `ToString`, `ToText` typeclasses [API change]. These were needed
623− for the transition from String to Text, but they are no longer used and
624− may clash with other things.
625− + Simplify `compactDL`.
626−
627− * Text.Pandoc.Parsing:
628−
629− + Change type of `readWithM` so that it is no longer polymorphic
630− [API change]. The `ToText` class has been removed, and now that we've
631− completed the transition to Text we no longer need this to operate
632− on Strings.
633− + Remove `F` type synonym [API change]. Muse and Org were defining their
634− own `F` anyway.
635−
636− * Text.Pandoc.Readers.Metadata:
637−
638− + Export `yamlMetaBlock` [API change].
639− + Make `yamlBsToMeta`, `yamlBsToRefs` polymorphic on the parser state
640− [API change].
641−
642− * Markdown reader: Fix regression with `tex_math_backslash` (#7155).
643−
644− * MediaWiki reader: Allow block-level content in notes (ref) (#7145).
645−
646− * Jira reader (Albert Krewinkel):
647−
648− + Fixed parsing of autolinks (i.e., of bare URLs in the text).
649− Previously an autolink would take up the rest of a line, as spaces
650− were allowed characters in these items.
651− + Emoji character sequences no longer cause parsing failures. This was
652− due to missing backtracking when emoji parsing fails.
653− + Mark divs created from panels with class "panel".
654−
655− * RST reader: fix logic for ending comments (#7134). Previously comments
656− sometimes got extended too far.
657−
658− * DocBook writer: include Header attributes as XML attributes on
659− section (Erik Rask). Attributes with key names that are not allowed
660− as XML attributes are dropped, as are attributes with invalid values
661− and `xml:id` (DocBook 5) and `id` (DocBook 4).
662−
663− * Docx writer:
664−
665− + Make `nsid` in `abstractNum` deterministic. Previously we assigned
666− a random number, but we don't need random values, so now we just
667− assign a value based on the list marker.
668− + Use integral values for `w:tblW` (#7141).
669−
670− * Jira writer (Albert Krewinkel):
671−
672− + Block quotes are only rendered as `bq.` if they do not contain a
673− linebreak.
674− + Jira writer: improve div/panel handling. Include div attributes in
675− panels, always render divs with class `panel` as panels, and
676− avoid nesting of panels.
677−
678− * HTML writer: Add warnings on duplicate attribute values.
679− This prevents emitting invalid HTML. Ultimately it would be good to
680− prevent this in the types themselves, but this is better for now.
681−
682− * Org writer: Prevent unintended creation of ordered list items (#7132,
683− Albert Krewinkel). Adjust line wrapping if default wrapping would cause
684− a line to be read as an ordered list item.
685−
686− * JATS templates: support 'equal-contrib' attrib for authors (Albert
687− Krewinkel). Authors who contributed equally to a paper may be marked
688− with `equal-contrib`.
689−
690− * reveal.js template: replace JS comment with HTML (#7154, Florian Kohrt).
691−
692− * Text.Pandoc.Logging: Add `DuplicateAttribute` constructor to `LogMessage`.
693− [API change]
694−
695− * Use `-j4` for linux release build. This speeds up the build dramatically
696− on arm.
697−
698− * cabal.project: remove ghcoptions. Move flags to top level, so they can
699− be set differently on the command line.
700−
701− * Require latest texmath, skylighting, citeproc, jira-wiki-markup.
702− (The latest skylighting fixes a bad bug with Haskell syntax highlighting.)
703− Narrow version bounds for texmath, skylighting, and citeproc, since
704− the test output depend on them.
705−
706− * Use doclayout 0.3.0.2. This significantly reduces the time and memory
707− needed to compile pandoc.
708−
709− * Use `foldl'` instead of `foldl` everywhere.
710−
711− * Update bounds for random (#7156, Alexey Kuleshevich).
712−
713− * Remove uses of some partial functions.
714−
715− * Don't bake in a larger stack size for the executable.
716−
717− * Test improvements:
718−
719− + Use `getExecutablePath` from base, avoiding the dependency on
720− `executable-path`.
721− + Factor out `setupEnvironment` in Helpers, to avoid code duplication.
722− + Fix finding of data files by setting teh `pandoc_datadir` environment
723− variable when we shell out to pandoc. This avoids the need to use
724− `--data-dir` for the tests, which caused problems finding `pandoc.lua`
725− when compiling without the `embed_data_files` flag (#7163).
726−
727− * Benchmark improvements:
728−
729− + Build `+RTS -A8m -RTS` into default ghc-options for benchmark.
730− This is necessary to get accurate benchmark results; otherwise we
731− are largely measuring garbage collecting, some not related to the
732− current benchmark.
733− + Allow specifying BASELINE file in 'make bench' for comparison
734− (otherwise the latest benchmark is chosen by default).
735− + Force `readFile` in benchmarks early (Bodigrim).
736−
737− * CONTRIBUTING: suggest using a `cabal.project.local` file (#7153,
738− Albert Krewinkel).
739−
740− * Add ghcid-test to Makefile. This loads the test suite in ghcid.
741−
742−
743−## pandoc 2.12 (2021-03-08)
744−
745− * `--resource-path` now accumulates if specified multiple
746− times (#6152). Resource paths specified later on the command line are
747− prepended to those specified earlier. Thus,
748− `--resource-path foo --resource-path bar:baz` is equivalent to
749− `--resource-path bar:bas:foo`. (The previous behavior was
750− for the last `--resource-path` to replace all the rest.)
751− `resource-path` in defaults files behaves the same way: it
752− will be prepended to the resource path set by earlier
753− command line options or defaults files. This change
754− facilitates the use of multiple defaults files: each can
755− specify a directory containing resources it refers to
756− without clobbering the resource paths set by the others.
757−
758− * Allow defaults files to refer to the home directory, the
759− user data directory, and the directory containing the defaults file
760− itself (#5871, #5982, #5977). In fields that expect file paths
761− (and only in these fields),
762−
763− + `${VARIABLE}` will expand to the value of the environment variable
764− `VARIABLE` (and in particular `${HOME}` will expand to the path
765− of the home directory). A warning will be raised for undefined
766− variables.
767− + `${USERDATA}` will expand to the path of the user data
768− directory in force when the defaults file is being processed.
769− + `${.}` will expand to the directory containing the defaults file.
770− (This allows default files to be placed in a directory containing
771− resources they make use of.)
772−
773− * When downloading content from URL arguments, be sensitive to
774− the character encoding (#5600). We can properly handle UTF-8 and latin1
775− (ISO-8859-1); for others we raise an error. Fall back to latin1 if
776− no charset is given in the mime type and UTF-8 decoding fails.
777−
778− * Allow abbreviations that don't end in a period to be
779− specified using `--abbreviations` (#7124).
780−
781− * Add new unexported module Text.Pandoc.XML.Light, as well
782− as Text.Pandoc.XML.Light.Types, Text.Pantoc.XML.Light.Proc,
783− Text.Pandoc.XML.Light.Output. (Closes #6001, #6565, #7091).
784−
785− This module exports definitions of `Element` and `Content`
786− that are isomorphic to xml-light's, but with Text
787− instead of String. This allows us to keep most of the code in existing
788− readers that use xml-light, but avoid lots of unnecessary allocation.
789−
790− We also add versions of the functions from xml-light's
791− Text.XML.Light.Output and Text.XML.Light.Proc that operate on our
792− modified XML types, and functions that convert xml-light types to our
793− types (since some of our dependencies, like texmath, use xml-light).
794−
795− We export functions that use xml-conduit's parser to produce an
796− `Element` or `[Content]`. This allows existing pandoc code to use
797− a better parser without much modification.
798−
799− The new parser is used in all places where xml-light's parser was
800− previously used. Benchmarks show a significant performance improvement
801− in parsing XML-based formats (with docbook, opml, jats, and docx
802− almost twice as fast, odt and fb2 more than twice as fast).
803−
804− In addition, the new parser gives us better error reporting than
805− xml-light. We report XML errors, when possible, using the new
806− `PandocXMLError` constructor in `PandocError`.
807−
808− These changes revealed the need for some changes in the tests. The
809− docbook-reader.docbook test lacked definitions for the entities it used;
810− these have been added. And the docx golden tests have been updated,
811− because the new parser does not preserve the order of attributes.
812−
813− * DocBook reader:
814−
815− + Avoid expensive tree normalization step, as it is not necessary
816− with the new XML parser.
817− + Support `informalfigure` (#7079) (Nils Carlson).
818−
819− * Docx reader:
820−
821− + Use Map instead of list for Namespaces. This gives a speedup of
822− about 5-10%. With this and the XML parsing changes, the docx reader
823− is now about twice as fast as in the previous release.
824−
825− * HTML reader:
826−
827− + Small performance tweaks.
828− + Also, remove exported class `NamedTag(..)` [API change]. This was just
829− intended to smooth over the transition from String to Text and is no
830− longer needed.
831− + As a result, the functions `isInlineTag` and `isBlockTag`
832− are no longer polymorphic; they apply to a `Tag Text` [API change].
833− + Do a lookahead to find the right parser to use. This takes
834− benchmarks from 34ms to 23ms, with less allocation.
835− + Fix bad handling of empty `src` attribute in `iframe` (#7099).
836− If `src` is empty, we simply skip the `iframe`.
837− If `src` is invalid or cannot be fetched, we issue a warning
838− nd skip instead of failing with an error.
839−
840− * JATS reader:
841−
842− + Avoid tree normalization, which is no longer necessary given the
843− new XML parser.
844−
845− * LaTeX reader:
846−
847− + Don't export `tokenize`, `untokenize` [API change]. These are internal
848− implementation details, which were only exported for testing.
849− They don't belong in the public API.
850− + Improved efficiency of the parser. With these changes the reader
851− is almost twice as fast as in the last release in our benchmarks.
852− + Code cleanup, removing some unnecessary things.
853− + Rewrite `withRaw` so it doesn't rely on fragile assumptions
854− about token positions (which break when macros are expanded)
855− (#7092). This requires the addition of `sEnableWithRaw` and
856− `sRawTokens` in `LaTeXState`, and a new combinator `disablingWithRaw`
857− to disable collecting of raw tokens in certain contexts.
858− Add `parseFromToks` to Text.Pandoc.Readers.LaTeX.Parsing.
859− Fix parsing of single character tokens so it doesn't mess
860− up the new raw token collecting. These changes slightly increase
861− allocations and have a small performance impact.
862− + Handle some bibtex/biblatex-specific commands that used to be
863− dealt with in pandoc-citeproc (#7049).
864− + Optimize `satisfyTok`, avoiding unnecessary macro expansion steps.
865− Benchmarks after this change show 2/3 of the run time and 2/3 of the
866− allocation of the Feb. 10 benchmarks.
867− + Removed `sExpanded` in state. This isn't actually needed and checking
868− it doesn't change anything.
869− + Improve `braced'`. Remove the parameter, have it parse the
870− opening brace, and make it more efficient.
871− + Factor out pieces of the LaTeX reader to make the module smaller.
872− This reduces memory demands when compiling. Created
873− Text.Pandoc.Readers.{LaTeX,Math,Citation,Table,Macro,Inline}.
874− Changed Text.Pandoc.Readers.LaTeX.SIunitx to export a command map
875− instead of individual commands.
876− + Handle table cells containing `&` in `\verb` (#7129).
877−
878− * Make Text.Pandoc.Readers.LaTeX.Types an unexported module [API change].
879−
880− * Markdown reader:
881−
882− + Improved handling of mmd link attributes in references (#7080).
883− Previously they only worked for links that had titles.
884− + Improved efficiency of the parser (benchmarks show a 15% speedup).
885−
886− * OPML reader:
887−
888− + Avoid tree normalization, which is no longer necessary with the
889− new XML parser.
890−
891− * ODT reader:
892−
893− + Finer-grained errors on parse failure (#7091).
894− + Give more information if the zip container can't be unpacked.
895−
896− * Org reader:
897−
898− + Support `task_lists` extension (Albert Krewinkel, #6336).
899− + Fix bug in org-ref citation parsing (Albert Krewinkel, #7101).
900− The org-ref syntax allows to list multiple citations separated by
901− comma. Previously commas were accepted as part of the citation id,
902− so all citation lists were parsed as one single citation.
903−
904− * RST reader:
905−
906− + Use `getTimestamp` instead of `getCurrentTime` to fetch timestamp.
907− Setting `SOURCE_DATE_EPOCH` will allow reproducible builds.
908− + RST reader: fix handling of header in CSV tables (#7064).
909− The interpretation of this line is not affected by the delim option.
910−
911− * Jira reader:
912−
913− + Modified the Doc parser to skip leading blank lines. This fixes
914− parsing of documents which start with multiple blank lines (Albert
915− Krewinkel, #7095).
916− + Prevent URLs within link aliases to be treated as autolinks (Albert
917− Krewinkel, #6944).
918−
919− * Text.Pandoc.Shared
920−
921− + Remove formerly exported functions that are no longer used in the
922− code base: `splitByIndices`, `splitStringByIndicies`, `substitute`,
923− and `underlineSpan` (which had been deprecated in April 2020)
924− [API change].
925− + Export `handleTaskListItem` (Albert Krewinkel) [API change].
926− + Change `defaultUserDataDirs` to `defaultUserDataDir` [API
927− change]. We determine what is the default user data directory
928− by seeing whether the XDG directory and/or legacy
929− directory exist.
930−
931− * BibTeX writer:
932−
933− + BibTeX writer: use doclayout and doctemplate. This change allows
934− bibtex/biblatex output to wrap as other formats do,
935− depending on the settings of `--wrap` and `--columns` (#7068).
936−
937− * CSL JSON writer:
938−
939− + Output `[]` if no references in input, instead of raising a
940− PandocAppError as before.
941−
942− * Docx writer:
943−
944− + Use `getTimestamp` instead of `getCurrentTime` for timestamp.
945− Setting `SOURCE_DATE_EPOCH` will allow reproducible builds.
946−
947− * EPUB writer:
948−
949− + Use `getTimestamp` instead of `getCurrentTime` for timestamp.
950− Setting `SOURCE_DATE_EPOCH` will allow reproducible builds (#7093).
951− This does not suffice to fully enable reproducible in EPUB, since
952− a unique id is still being generated for each build.
953− + Support `belongs-to-collection` metadata (#7063) (Nick Berendsen).
954−
955− * JATS writer:
956−
957− + Escape special chars in reference elements (Albert Krewinkel).
958− Prevents the generation of invalid markup if a citation element
959− contains an ampersand or another character with a special meaning
960− in XML.
961−
962− * Jira writer:
963−
964− + Use Span identifiers as anchors (Albert Krewinkel).
965− + Use `{noformat}` instead of `{code}` for unknown languages (Albert
966− Krewinkel). Code blocks which are not marked as a language supported
967− by Jira are rendered as preformatted text via `{noformat}` blocks.
968−
969− * LaTeX writer:
970−
971− + Adjust hypertargets to beginnings of paragraphs (#7078).
972− Use `\vadjust pre` so that the hypertarget takes you to the beginning
973− of the paragraph rather than one line down.
974− This makes a particular difference for links to citations using
975− `--citeproc` and `link-citations: true`.
976− + Change BCP47 lang tag from `jp` to `ja` (Mauro Bieg, #7047).
977− + Use function instead of map for accent lookup (should be
978− more efficient).
979− + Split the module to make it easier to compile on low-memory
980− systems: added Text.Pandoc.Writers.LaTeX.{Util,Citation,Lang}.
981−
982− * Markdown writer:
983−
984− + Handle math right before digit. We insert an HTML comment to
985− avoid a `$` right before a digit, which pandoc will not recognize
986− as a math delimiter.
987− + Split the module to make it easier to compile on low-memory
988− systems: added Text.Pandoc.Writers.Markdown.{Types,Inline}.
989−
990− * ODT writer:
991−
992− + Use `getTimestamp` instead of `getCurrentTime` for timestamp.
993− Setting `SOURCE_DATE_EPOCH` will allow reproducible builds.
994− + Update default ODT style (Lorenzo). Previously, the "First paragraph"
995− style inherited from "Standard" but not from "Text body." Now
996− it is adjusted to inherit from "Text body", to avoid some ugly
997− spacing issues. It may be necessary to update a custom `reference.odt`
998− in light of this change.
999−
1000− * Org writer:
1001−
1002− + Support `task_lists` extension (Albert Krewinkel, #6336).
1003−
1004− * Pptx writer:
1005−
1006− + Use `getTimestamp` instead of `getCurrentTime` for timestamp.
1007− Setting `SOURCE_DATE_EPOCH` will allow reproducible builds.
1008−
1009− * JATS templates: tag `author.name` as `string-name` (Albert Krewinkel).
1010− The partitioning the components of a name into surname, given names,
1011− etc. is not always possible or not available. Using `author.name`
1012− allows to give the full name as a fallback to be used when
1013− `author.surname` is not available.
1014−
1015− * Add default templates for bibtex and biblatex, so that
1016− the variables `header-include`, `include-before`, `include-after`
1017− (or alternatively the command line options
1018− `--include-in-header`, `--include-before-body`, `--include-after-body`)
1019− may be used.
1020−
1021− * LaTeX template:
1022−
1023− + Update to iftex package (#7073) (Andrew Dunning)
1024− + Wrap url colours in braces (#7121) (Loïc Grobol).
1025−
1026− * revealjs template: Add 'center' option for vertical slide centering.
1027− (maurerle, #7104).
1028−
1029− * Text.Pandoc.XML: Improve efficiency of `fromEntities`.
1030−
1031− * Text.Pandoc.MIME
1032−
1033− + Add exported function `getCharset` [API change].
1034−
1035− * Text.Pandoc.UTF8: change IO functions to return Text, not String
1036− [API change]. This affects `readFile`, `getContents`, `writeFileWith`,
1037− `writeFile`, `putStrWith`, `putStr`, `putStrLnWith`, `putStrLn`.
1038− `hPutStrWith`, `hPutStr`, `hPutStrLnWith`, `hPutStrLn`, `hGetContents`.
1039− This avoids the need to uselessly create a linked list of characters
1040− when emiting output.
1041−
1042− * Text.Pandoc.App
1043−
1044− + Add `parseOptionsFromArgs` [API change, new exported function].
1045− + Add fields for CSL options to `Opt` [API change]:
1046− `optCSL`, `optbibliography`, `optCitationAbbreviations`.
1047−
1048− * Text.Pandoc.Citeproc.BibTeX
1049−
1050− + `Text.Pandoc.Citeproc.writeBibTeXString` now returns
1051− `Doc Text` instead of `Text` (#7068).
1052− + Correctly handle `pages` (= `page` in CSL) (#7067).
1053− + Correctly handle BibLaTeX `langid` (= `language` in CSL, #7067).
1054− + In BibTeX output, protect foreign titles since there's no language
1055− field (#7067).
1056− + Clean up BibTeX parsing (#7049). Previously there was a messy code
1057− path that gave strange results in some cases, not passing through raw
1058− tex but trying to extract a string content. This was an artefact of
1059− trying to handle some special bibtex-specific commands in the BibTeX
1060− reader. Now we just handle these in the LaTeX reader and simplify
1061− parsing in the BibTeX reader. This does mean that more raw tex will
1062− be passed through (and currently this is not sensitive to the
1063− `raw_tex` extension; this should be fixed).
1064−
1065− * Text.Pandoc.Citeproc.MetaValue
1066−
1067− + Correctly parse "raw" date value in markdown references metadata.
1068− (See jgm/citeproc#53.)
1069−
1070− * Text.Pandoc.Citeproc
1071−
1072− + Use https URLs for links (Salim B, #7122).
1073−
1074− * Text.Pandoc.Class
1075−
1076− + Add `getTimestamp` [API change]. This attempts to read the
1077− `SOURCE_DATE_EPOCH` environment variable and parse a UTC time
1078− from it (treating it as a unix date stamp, see
1079− https://reproducible-builds.org/specs/source-date-epoch/). If the
1080− variable is not set or can't be parsed as a unix date stamp, then the
1081− function returns the current date.
1082−
1083− * Text.Pandoc.Error
1084−
1085− + Add `PandocUnsupportedCharsetError` constructor for
1086− `PandocError` [API change].
1087− + Export `renderError` [API change].
1088− + Refactor `handleError` to use `renderError`. This allows us render
1089− error messages without exiting.
1090−
1091− * Text.Pandoc.Extensions
1092−
1093− + `Ext_task_lists` is now supported by org (and turned
1094− on by default) (Albert Krewinkel, #6336).
1095− + Remove `Ext_fenced_code_attributes` from allowed commonmark attributes
1096− (#7097). This attribute was listed as allowed, but it didn't actually
1097− do anything. Use `attributes` for code attributes and more.
1098−
1099− * Lua subsystem:
1100−
1101− + Always load built-in Lua scripts from default data-dir (Albert
1102− Krewinkel). The Lua modules `pandoc` and `pandoc.List` are now always
1103− loaded from the system's default data directory. Loading from a
1104− different directory by overriding the default path, e.g. via
1105− `--data-dir`, is no longer supported to avoid unexpected behavior
1106− and to address security concerns.
1107− + Add module "pandoc.path" (Albert Krewinkel, #6001, #6565).
1108− The module allows to work with file paths in a convenient and
1109− platform-independent manner.
1110− + Use strict evaluation when retrieving AST value from the stack
1111− (Albert Krewinkel, #6674).
1112−
1113− * Text.Pandoc.PDF
1114−
1115− + Disable `smart` extension when building PDF via LaTeX.
1116− This is to prevent accidental creation of ligatures like
1117− `` ?` `` and `` !` `` (especially in languages with quotations like
1118− German), and similar ligature issues. (See jgm/citeproc#54.)
1119−
1120− * Text.Pandoc.CSV:
1121−
1122− + Fix parsing of unquoted values (#7112). Previously we didn't allow
1123− unescaped quotes in unquoted values, but they are allowed
1124− in CSV.
1125−
1126− * Test suite:
1127−
1128− + Use a more robust method for testing the executable. Many
1129− of our tests require running the pandoc executable. This
1130− is problematic for a few different reasons. First,
1131− cabal-install will sometimes run the test suite after
1132− building the library but before building the executable,
1133− which means the executable isn't in place for the tests.
1134− One can work around that by first building, then building
1135− and running the tests, but that's fragile. Second, we
1136− have to find the executable. So far, we've done that using
1137− a function `findPandoc` that attempts to locate it
1138− relative to the test executable (which can be located
1139− using findExecutablePath). But the logic here is delicate
1140− and work with every combination of options. To solve both
1141− problems, we add an `--emulate` option to the
1142− `test-pandoc` executable. When `--emulate` occurs as the
1143− first argument passed to `test-pandoc`, the program simply
1144− emulates the regular pandoc executable, using the rest of
1145− the arguments (after `--emulate`). Thus, `test-pandoc
1146− --emulate -f markdown -t latex` is just like `pandoc -f
1147− markdown -t latex`. Since all the work is done by library
1148− functions, implementing this emulation just takes a couple
1149− lines of code and should be entirely reliable. With this
1150− change, we can test the pandoc executable by running the
1151− test program itself (locatable using `findExecutablePath`)
1152− with the `--emulate` option. This removes the need for the
1153− fragile `findPandoc` step, and it means we can run our
1154− integration tests even when we're just building the
1155− library, not the executable. [Note: part of this change
1156− involved simplifying some complex handling to set
1157− environment variables for dynamic library paths. I have
1158− tested a build with `--enable-dynamic-executable`, and it
1159− works, but further testing may be needed.]
1160− + Print accurate location if a test fails (Albert
1161− Krewinkel). Ensures that tasty-hunit reports the location
1162− of the failing test instead of the location of the helper
1163− `test` function.
1164−
1165− * Documentation: Update URLs and use `https` where possible (#7122,
1166− Salim B).
1167−
1168− * Add `doc/libraries.md`, a description of libraries that support pandoc.
1169−
1170− * MANUAL.txt
1171−
1172− + MANUAL: block-level formatting is not allowed in line blocks (#7107).
1173− + Clarify `tex_math_dollars` extension. Note that no blank lines
1174− are allowed between the delimiters in display math.
1175− + Add MANUAL section on reproducible builds.
1176− + Document no template fallback for absolute path (#7077, Nixon
1177− Enraght-Moony.)
1178− + Improve docs for cite-method.
1179− + Update README and man page.
1180−
1181− * Makefile: in `make bench`, create CSV files for comparison and compare
1182− against previous benchmark run. Add timestamp to CSV filenames.
1183−
1184− * cabal.project: don't explicitly set -trypandoc.
1185− If we do, this can't be overridden on the cabal command line.
1186−
1187− * doc/lua-filters.md: improve documentation for
1188− `pandoc.mediabag.insert`, `pandoc.mediabag.fetch`,
1189− `directory`, `normalize` (Albert Krewinkel).
1190−
1191− * Allow base64-bytestring-1.2.* (Dmitrii Kovanikov)
1192−
1193− * Require jira-wiki-markup 1.3.3 (Albert Krewinkel)
1194−
1195− * Require citeproc 0.3.0.8, which correctly titlecases when titles
1196− contain non-ASCII characters.
1197−
1198− * Use skylighting 0.10.4. This version of skylighting uses xml-conduit
1199− rather than hxt. This speeds up parsing of XML syntax definitions
1200− fourfold, and removes four packages from pandoc's dependency graph:
1201− hxt-charproperties, hxt-unicode, hxt-regex-xmlschema, hxt.
1202−
1203− * Add script `tools/parseTimings.pl` to help pin down which
1204− modules take the most time and memory to compile.
1205−
1206− * Avoid unnecessary use of NoImplicitPrelude pragma (#7089) (Albert
1207− Krewinkel)
1208−
1209− * Benchmarks
1210−
1211− + Use the lighter-weight tasty-bench instead of criterion.
1212− + Run writer benchmarks for binary formats too.
1213− + Alphabetize benchmarks.
1214− + Don't run benchmarks for bibliography formats
1215− (yet; we need a special input for them).
1216− + Show allocation data
1217− + Clean up benchmark code.
1218− + Allow specifying patterns using `-p blah'.
1219−
1220− * trypandoc: add 2 second timeout.
1221−
1222− * Use `-split-sections` in creating linux release binary.
1223− This reduces executable size significantly (by about 30%).
1224−
1225− * Remove `weigh-pandoc`. It's not really useful any more, now that our
1226− regular benchmarks include data on allocation.
1227−
1228− * Improve linux package build process and add script to
1229− automate building an arm64 binary package.
1230−
1231−
1232−## pandoc 2.11.4 (2021-01-22)
1233−
1234− * Add `biblatex`, `bibtex` as output formats (closes #7040).
1235−
1236− * Recognize more extensions as markdown by default (#7034):
1237− `mkdn`, `mkd`, `mdwn`, `mdown`, `Rmd`.
1238−
1239− * Implement defaults file inheritance (#6924, David Martschenko).
1240− Allow defaults files to inherit options from other defaults files by
1241− specifying them with the following syntax:
1242− `defaults: [list of defaults files or single defaults file]`.
1243−
1244− * Fix infinite HTTP requests when writing epubs from URL source (#7013).
1245− Due to a bug in code added to avoid overwriting the cover image
1246− if it had the form `fileX.YYY`, pandoc made an endless sequence
1247− of HTTP requests when writing epub with input from a URL.
1248−
1249− * Org reader:
1250−
1251− + Allow multiple pipe chars in todo sequences (Albert Krewinkel, #7014).
1252− Additional pipe chars, used to separate "action" state from "no further
1253− action" states, are ignored. E.g., for the following sequence, both
1254− `DONE` and `FINISHED` are states with no further action required:
1255− `#+TODO: UNFINISHED | DONE | FINISHED`.
1256− + Restructure output of captioned code blocks (Albert Krewinkel, #6977).
1257− The Div wrapper of code blocks with captions now has the class
1258− "captioned-content". The caption itself is added as a Plain block
1259− inside a Div of class "caption". This makes it easier to write filters
1260− which match on captioned code blocks. Existing filters will need to be
1261− updated.
1262− + Mark verbatim code with class `verbatim` (Dimitri Sabadie, #6998).
1263−
1264− * LaTeX reader:
1265−
1266− + Handle `filecontents` environment (#7003).
1267− + Put contents of unknown environments in a Div when `raw_tex` is not
1268− enabled (#6997). (When `raw_tex` is enabled, the whole environment is
1269− parsed as a raw block.) The class name is the name of the environment.
1270− Previously, we just included the contents without the surrounding Div,
1271− but having a record of the environment's boundaries and name can be
1272− useful.
1273−
1274− * Mediawiki reader:
1275−
1276− + Allow space around storng/emph delimiters (#6993).
1277−
1278− * New module Text.Pandoc.Writers.BibTeX, exporting
1279− writeBibTeX and writeBibLaTeX. [API change]
1280−
1281− * LaTeX writer:
1282−
1283− + Revert table line height increase in 2.11.3 (#6996).
1284− In 2.11.3 we started adding `\addlinespace`, which produced less dense
1285− tables. This wasn't an intentional change; I misunderstood a comment in
1286− the discussion leading up to the change. This commit restores the earlier
1287− default table appearance. Note that if you want a less dense table, you
1288− can use something like `\def\arraystretch{1.5}` in your header.
1289−
1290− * EPUB writer:
1291−
1292− + Adjust internal links to identifiers defined in raw HTML sections
1293− after splitting into chapters (#7000).
1294− + Recognize `Format "html4"`, `Format "html5"` as raw HTML.
1295− + Adjust internal links to images, links, and tables after splitting into
1296− chapters. Previously we only did this for Div and Span and Header
1297− elements (see #7000).
1298−
1299− * Ms writer:
1300−
1301− + Don't justify text inside table cells.
1302−
1303− * JATS writer:
1304−
1305− + Use `<element-citation>` if `element_citations`
1306− extension is enabled (Albert Krewinkel).
1307− + Fix citations (Albert Krewinkel, #7018). By default
1308− we use formatted citations.
1309− + Ensure that `<disp-quote>` is always wrapped in `<p>` (#7041).
1310−
1311− * Markdown writer:
1312−
1313− + Cleaned up raw formats. We now react appropriately
1314− to `gfm`, `commonmark`, and `commonmark_x` as raw formats.
1315−
1316− * RST writer:
1317−
1318− + Fix bug with dropped content from inside spans with a class in
1319− some cases (#7039).
1320−
1321− * Docx writer:
1322−
1323− + Handle table header using styles (#7008). Instead of hard-coding
1324− the border and header cell vertical alignment, we now let this
1325− be determined by the Table style, making use of Word's
1326− "conditional formatting" for the table's first row. For
1327− headerless tables, we use the tblLook element to tell Word
1328− not to apply conditional first-row formatting.
1329−
1330− * Commonmark writer:
1331−
1332− + Implement start number on ordered lists (#7009). Previously they always
1333− started at 1, but according to the spec the start number is respected.
1334−
1335− * HTML writer:
1336−
1337− + Fix implicit_figure at end of footnotes (#7006).
1338−
1339− * ConTeXt template: Remove `\setupthinrules` from default template.
1340− The width parameter this used is not actually supported,
1341− and the command didn't do anything.
1342−
1343− * Text.Pandoc.Extensions:
1344−
1345− + Add `Ext_element_citations` constructor (Albert Krewinkel).
1346−
1347− * Text.Pandoc.Citeproc.BibTeX: New unexported function
1348− `writeBibtexString`.
1349−
1350− * Text.Pandoc.Citeproc:
1351−
1352− + Use finer grained imports (Albert Krewinkel).
1353− + Factor out and export `getStyle` [API change].
1354− + Export `getReferences` [API change, #7106].
1355− + Factor out getLang.
1356−
1357− * Text.Pandoc.Parsing: modify `gridTableWith'` for headerless tables.
1358− If the table lacks a header, the header row should be an empty
1359− list. Previously we got a list of empty cells, which caused
1360− an empty header to be emitted instead of no header. In LaTeX/PDF
1361− output that meant we got a double top line with space between.
1362−
1363− * ImageSize: use `viewBox` for SVG if no length, width attributes (#7045).
1364− This change allows pandoc to extract size information from more SVGs.
1365−
1366− * Add simple default.nix.
1367−
1368− * Use commonmark 0.1.1.3.
1369−
1370− * Use citeproc 0.3.0.5.
1371−
1372− * Update default CSL to use latest chicago-author-date.csl.
1373−
1374− * CONTRIBUTING.md: add note on GNU xargs.
1375−
1376− * MANUAL.txt:
1377−
1378− + Update description of `-L`/`--lua-filter`.
1379− + Document use of citations in note styles (#6828).
1380−
1381−## pandoc 2.11.3.2 (2020-12-29)
1382−
1383− * HTML reader: use renderTags' from Text.Pandoc.Shared (Albert Krewinkel).
1384− A side effect of this change is that empty `<col>` elements are written
1385− as self-closing tags in raw HTML blocks.
1386−
1387− * Asciidoc writer: Add support for writing nested tables (#6972, timo-a).
1388− Asciidoc supports one level of nesting. If deeper tables are to be
1389− written, they are omitted and a warning is issued.
1390−
1391− * Docx writer: fix nested tables with captions (#6983).
1392− Previously we got unreadable content, because docx seems
1393− to want a `<w:p>` element (even an empty one) at the end of
1394− every table cell.
1395−
1396− * Powerpoint writer: allow arbitrary OOXML in raw inline elements
1397− (Albert Krewinkel). The raw text is now included verbatim in the
1398− output. Previously is was parsed into XML elements, which prevented
1399− the inclusion of partial XML snippets.
1400−
1401− * LaTeX writer: support colspans and rowspans in tables (#6950,
1402− Albert Krewinkel). Note that the multirow package is needed for
1403− rowspans. It is included in the latex template under a variable,
1404− so that it won't be used unless needed for a table.
1405−
1406− * HTML writer: don't include p tags in CSL bibliography entries
1407− (#6966). Fixes a regression in 2.11.3.
1408−
1409− * Add `meta-description` variable to HTML templates (#6982). This
1410− is populated by the writer by stringifying the `description`
1411− field of metadata (Jerry Sky). The `description` meta tag will
1412− make the generated HTML documents more complete and SEO-friendly.
1413−
1414− * Citeproc: fix handling of empty URL variables (`DOI`, etc.).
1415− The `linkifyVariables` function was changing these to links
1416− which then got treated as non-empty by citeproc, leading
1417− to wrong results (e.g. ignoring nonempty URL when empty DOI is present).
1418− See jgm/citeproc#41.
1419−
1420− * Use citeproc 0.3.0.3. Fixes an issue in author-only citations when
1421− both an author and translator are present, and an issue with
1422− citation group delimiters.
1423−
1424− * Require texmath 0.12.1. This improves siunitx support in math,
1425− fixes bugs with `\*mod` family operators and arrays, and avoids
1426− italicizing symbols and operator names in docx output.
1427−
1428− * Ensure that the perl interpreter used for filters with `.pl`
1429− extension (wuffi).
1430−
1431− * MANUAL: note that textarea content is never parsed as Markdown
1432− (Albert Krewinkel).
1433−
1434−
1435−## pandoc 2.11.3.1 (2020-12-18)
1436−
1437− * Added some missing files to extra-source-files and data
1438− files, so they are included in the sdist tarball. Closes #6961.
1439− Cleaned up some extraneous data and test files, and added
1440− a CI check to ensure that the test and data files included
1441− in the sdist match what is in the git repository.
1442−
1443− * Use citeproc 0.3.0.1, which avoids removing nonbreaking
1444− space at the end of the `initialize-with` attribute. (Some
1445− journals require nonbreaking space after initials, and this
1446− makes that possible.)
1447−
1448−## pandoc 2.11.3 (2020-12-17)
1449−
1450− * With `--bibliography` (or `bibliography` in metadata), a
1451− URL may now be provided, and pandoc will fetch the resource.
1452− In addition, if a file path is provided and it is not
1453− found relative to the working directory, the resource
1454− path will be searched (#6940).
1455−
1456− * Add `sourcepos` extension for `commonmark`, `gfm`, `commonmark_x`
1457− (#4565). With the `sourcepos` extension set set, `data-pos`
1458− attributes are added to the AST by the commonmark reader. No other
1459− readers are affected. The `data-pos` attributes are put on elements
1460− that accept attributes; for other elements, an enlosing Div or Span
1461− is added to hold the attributes.
1462−
1463− * Change extensions for `commonmark_x`: replace `auto_identifiers`
1464− with `gfm_auto_identifiers` (#6863). `commonmark_x` never actually
1465− supported `auto_identifiers` (it didn't do anything), because the
1466− underlying library implements gfm-style identifiers only. Attempts
1467− to add the `auto_identifiers` extension to `commonmark` will now
1468− fail with an error.
1469−
1470− * HTML reader:
1471−
1472− + Split module into several submodules (Albert Krewinkel). Reducing
1473− module size should reduce memory use during compilation.
1474− + Support advanced table features (Albert Krewinkel):
1475− block level content in captions, row and colspans,
1476− body headers, row head columns, footers, attributes.
1477− + Disable round-trip testing for tables. Information for cell
1478− alignment in a column is not preserved during round-trips (Albert
1479− Krewinkel).
1480− + Allow finer grained options for tag omission (Albert Krewinkel).
1481− + Simplify list attribute handling (Albert Krewinkel).
1482− + Pay attention to `lang` attributes on body element (#6938).
1483− These (as well as `lang` attributes on the html element) should update
1484− lang in metadata.
1485− + Retain attribute prefixes and avoid duplicates (#6938).
1486− Previously we stripped attribute prefixes, reading `xml:lang` as
1487− `lang` for example. This resulted in two duplicate `lang`
1488− attributes when `xml:lang` and `lang` were both used. This commit
1489− causes the prefixes to be retained, and also avoids invald
1490− duplicate attributes.
1491−
1492− * Commonmark reader:
1493−
1494− + Refactor `specFor`.
1495− + Set input name to `""` to avoid clutter in sourcepos output.
1496−
1497− * Org reader:
1498−
1499− + Parse `#+LANGUAGE` into `lang` metadata field (#6845, Albert
1500− Krewinkel).
1501− + Preserve targets of spurious links (#6916, Albert
1502− Krewinkel). Links with (internal) targets that the reader doesn't
1503− know about are converted into emphasized text. Information on the
1504− link target is now preserved by wrapping the text in a Span of class
1505− `spurious-link`, with an attribute `target` set to the link's
1506− original target. This allows to recover and fix broken or unknown
1507− links with filters.
1508−
1509− * DocBook reader:
1510−
1511− + Table text width support (#6791, Nils Carlson).
1512− Table width in relation to text width is not natively supported
1513− by docbook but is by the docbook `fo` stylesheets through an XML
1514− processing instruction, `<?dbfo table-width="50%"?>`.
1515−
1516− * LaTeX reader:
1517−
1518− + Improve parsing of command options (#6869, #6873).
1519− In cases where we run into trouble parsing inlines til the
1520− closing `]`, e.g. quotes, we return a plain string with the
1521− option contents. Previously we mistakenly included the brackets
1522− in this string.
1523− + Preserve center environment (#6852, Igor Pashev).
1524− The contents of the `center` environment are put in a `Div`
1525− with class `center`.
1526− + Don't parse `\rule` with width 0 as horizontal rule. These are
1527− sometimes used as spacers in LaTeX.
1528− + Don't apply theorem default styling to a figure inside (#6925).
1529− If we put an image in italics, then when rendering to Markdown
1530− we no longer get an implicit figure.
1531−
1532− * Dokuwiki reader:
1533−
1534− + Handle unknown interwiki links better (#6932).
1535− DokuWiki lets the user define his own Interwiki links. Previously
1536− pandoc reacted to these by emitting a google search link, which is
1537− not helpful. Instead, we now just emit the full URL including the
1538− wikilink prefix, e.g. `faquk>FAQ-mathml`. This at least gives users
1539− the ability to modify the links using filters.
1540−
1541− * Markdown writer:
1542−
1543− + Properly handle boolean values in writing YAML metadata (#6388).
1544− + Ensure that a new csl-block begins on a new line (#6921).
1545− This just looks better and doesn't affect the semantics.
1546−
1547− * RST writer:
1548−
1549− + Better image handling (#6948). An image alone in its paragraph
1550− (but not a figure) is now rendered as an independent image, with an
1551− `alt` attribute if a description is supplied. An inline image that
1552− is not alone in its paragraph will be rendered, as before, using a
1553− substitution. Such an image cannot have a "center", "left", or
1554− "right" alignment, so the classes `align-center`, `align-left`, or
1555− `align-right` are ignored. However, `align-top`, `align-middle`,
1556− `align-bottom` will generate a corresponding `align` attribute.
1557−
1558− * Docx writer:
1559−
1560− + Keep raw openxml strings verbatim (#6933, Albert Krewinkel).
1561− + Use Content instead of Element. This allows us to inject
1562− raw OpenXML into the document without reparsing it into an
1563− Element, which is necessary if you want to inject an open
1564− tag or close tag.
1565− + Fix bullets/lists indentation, so that the first level is slightly
1566− indented to the right instead of right on the margin (cholonam).
1567− + Support bold and italic in "complex script" (#6911).
1568− Previously bold and italics didn't work properly in LTR
1569− text. This commit causes the w:bCs and w:iCs attributes
1570− to be used, in addition to w:b and w:i, for bold and
1571− italics respectively.
1572−
1573− * ICML writer:
1574−
1575− + Fix image bounding box for custom widths/heighta (Mauro Bieg, #6936).
1576−
1577− * LaTeX writer:
1578−
1579− + Improve table spacing (#6842, #6860).
1580− Remove the `\strut` that was added at the end of minipage
1581− environments in cells. Replace `\tabularnewline` with
1582− `\\ \addlinespace`.
1583− + Improve calculation of column spacing (#6883).
1584− + Extract table handling into separate module (Albert Krewinkel).
1585− + Fix bug with nested `csl-` display Spans (#6921).
1586− + Improve longtable output (#6883). Don't create minipages for
1587− regular paragraphs. Put width and alignment information in the
1588− longtable column descriptors.
1589−
1590− * OpenDocument writer:
1591−
1592− + Support for table width as a percentage of text width
1593− (#6792, Nils Carson).
1594− + Implement Div and Span ident support (#6755, Nils Carson).
1595− Spans and Divs containing an ident in the Attr will become bookmarks
1596− or sections with idents in OpenDocument format.
1597− + Add two extensions, `xrefs_name` and `xrefs_number` (#6774, Nils
1598− Carlson). Links to headings, figures and tables inside the
1599− document are substituted with cross-references that will use the
1600− name or caption of the referenced item for `xrefs_name` or the
1601− number for `xrefs_number`. For the `xrefs_number` to be useful
1602− heading numbers must be enabled in the generated document and
1603− table and figure captions must be enabled using for example the
1604− `native_numbering` extension. In order for numbers and reference
1605− text to be updated the generated document must be refreshed.
1606−
1607− * JATS writer:
1608−
1609− + Support advanced table features (Albert Krewinkel).
1610− + Support author affiliations (#6687, Albert Krewinkel).
1611−
1612− * Docbook writer:
1613−
1614− + Use correct id attribute consistently (Jan Tojnar).
1615− DocBook5 should always use `xml:id` instead of `id`.
1616− + Handle admonition titles better (Jan Tojnar).
1617− Docbook reader produces a `Div` with `title` class for `<title>`
1618− element within an “admonition” element. Markdown writer then turns
1619− this into a fenced div with `title` class attribute. Since fenced
1620− divs are block elements, their content is recognized as a
1621− paragraph by the Markdown reader. This is an issue for Docbook
1622− writer because it would produce an invalid DocBook document from
1623− such AST – the `<title>` element can only contain “inline”
1624− elements. Handle this special case separately by unwrapping
1625− the paragraph before creating the `<title>` element.
1626− + Add XML namespaces to top-level elements (#6923, Jan Tojnar).
1627− Previously, we only added `xmlns` attributes to chapter
1628− elements, even when running with `--top-level-division=section`.
1629− These namespaces are now added to part and section elements too,
1630− when they are the selected top-level divisions.
1631− We do not need to add namespaces to documents produced with
1632− `--standalone` flag, since those will already have xmlns attribute on
1633− the root element in the template.
1634−
1635− * HTML writer:
1636−
1637− + Fix handling of nested `csl-` display spans (#6921).
1638− Previously inner Spans used to represent CSL display attributes were
1639− not rendered as div tags as intended.
1640−
1641− * EPUB writer:
1642−
1643− + Include title page in landmarks (#6919).
1644− Note that the toc is also included if `--toc` is specified.
1645− + Add frontmatter type on body element for nav.xhtml (#6918).
1646−
1647− * EPUB templates: use preserveAspectRatio="xMidYMid" for cover image (#6895,
1648− Shin Sang-jae). This change affects both the epub2 and the epub3
1649− templates. It avoids distortion of the cover image by requiring that the
1650− aspect ratio be preserved.
1651−
1652− * LaTeX template:
1653−
1654− + Include `csquotes` package if `csquotes` variable set.
1655− + Put back `amssymb`. We need it for checkboxes in todo lists,
1656− and maybe for other things. In this location it seems compatible
1657− with the cases that prompted #6469 and PR #6762.
1658− + Disable language-specific shorthands in babel (#6817, #6887).
1659− Babel defines "shorthands" for some languages, and these can
1660− produce unexpected results. For example, in Spanish, `1.22`
1661− gets rendered as `122`, and `et~al.` as `etal`.
1662− One would think that babel's `shorthands=off` option (which
1663− we were using) would disable these, but it doesn't. So we
1664− remove `shorthands=off` and add some code that redefines
1665− the shorthands macro. Eventually this will be fixed in babel,
1666− I hope, and we can revert to something simpler.
1667−
1668− * JATS template: allow array of persistent institute ids in `pid`
1669− (Albert Krewinkel).
1670−
1671− * Text.Pandoc.Parsing: minor code and efficiency improvements.
1672−
1673− * Text.Pandoc.Extension:
1674−
1675− + Add `Ext_sourcepos` constructor for `Extension` [API change].
1676− + Add `Ext_xrefs_name` and `Ext_xrefs_number` constructors for
1677− `Extension` (Nils Carson) [API change].
1678−
1679− * Text.Pandoc.Citeproc:
1680−
1681− + Fix truncation of `[Citation]` list in `Cite` inside footnotes (#6890).
1682− This affected author-in-text citations in footnotes. It didn't cause
1683− problems for the printed output, but for filters that expected the
1684− citation id and other information.
1685− + Allow the use of both inline and external references (#6951),
1686− as with pandoc-citeproc. References defined in the document's
1687− metadata take priority over references with the same id defined in
1688− an external bibliography.
1689− + Use `fetchItem` to get external bibliography (#6940).
1690− + Ensure that BCP47 lang codes can be used. We ignore the variants
1691− and just use the base lang code and country code when passing off
1692− to citeproc.
1693− + Citeproc BibTeX parser: revert change in `getRawField`
1694− which was made (for reasons forgotten) when transferring
1695− this code from pandoc-citeproc. The change led to `--` in
1696− URLs being interpreted as en-dashes, which is unwanted (#6874).
1697−
1698− * Text.Pandoc.ImageSize:
1699−
1700− + Default to DPI 72 if the format specifies DPI of 0 (#6880).
1701− This shouldn't happen, in general, but it can happen with
1702− JPEGs that don't conform to the spec. Having a DPI of 0
1703− will blow up size calculations (division by 0).
1704− + ImageSize: use JuicyPixels to determine size for png, jpeg, and
1705− gif, instead of doing our own binary parsing (#6936). This
1706− gives more reliable results.
1707−
1708− * Text.Pandoc.CSS:
1709−
1710− + Remove `foldOrElse` (internal module) (Albert Krewinkel).
1711−
1712− * Use skylighting 0.10.2 (#6625).
1713−
1714− * Use citeproc 0.3. This fixes issues with references with
1715− duplicate ids (jgm/citeproc#36).
1716−
1717− * Use doctemplates 0.9. This fixes issues with boolean
1718− metadata values in the Markdown writer (#6388)
1719− and in `meta-json` (#6650). It also fixes
1720− issues with nested for loops in templates.
1721−
1722− * Add translations zh-Hans.yaml and zh-Hant.yaml (#6904, #6909,
1723− Kolen Cheung, taotieren).
1724−
1725− * Add tests: True to cabal.project.
1726− This fixes some CI failures for cabal.
1727−
1728− * Normalize test/tables/*.native (#6888, Kolen Cheung).
1729−
1730− * Move executable to `app` directory to avoid problems with cabal repl.
1731−
1732− * CONTRIBUTING: add section "How can I help?" (#6892, Albert Krewinkel).
1733− Also adds a paragraph aimed at highlighting the importance of feature
1734− maintenance.
1735−
1736− * MANUAL: Document that --number-sections works in `ms` (#6935).
1737−
1738−
1739−## pandoc 2.11.2 (2020-11-19)
1740−
1741− * Default to using ATX (`##`-style) headings for Markdown output
1742− (#6662, Aner Lucero). Previously we used Setext (underlined) headings
1743− by default for levels 1--2.
1744−
1745− * Add option `--markdown-headings=atx|setext`, and deprecate
1746− `--atx-headers` (#6662, Aner Lucero).
1747−
1748− * Support `markdown-headings` in defaults files.
1749−
1750− * Fix corner case in YAML metadata parsing (#6823). Previously YAML
1751− metadata would sometimes not get recognized if a field ended with a
1752− newline followed by spaces.
1753−
1754− * `--self-contained`: increase coverage (#6854).
1755− Previously we only self-contained attributes for certain tag names
1756− (`img`, `embed`, `video`, `input`, `audio`, `source`, `track`,
1757− `section`). Now we self-contain any occurrence of `src`,
1758− `data-src`, `poster`, or `data-background-image`, on any tag; and
1759− also `href` on `link` tags.
1760−
1761− * Markdown reader:
1762−
1763− + Fix detection of locators following in-text citations.
1764− Prevously, if we had `@foo [p. 33; @bar]`, the `p. 33` would be
1765− incorrectly parsed as a prefix of `@bar` rather than a suffix of
1766− `@foo`.
1767− + Improve period suppression algorithm for citations in notes
1768− in note citation styles (#6835).
1769− + Don't increment `stateNoteNumber` for example list references.
1770− This helps with #6836 (a bug in which example list references
1771− disturb calculation of citation note number and affect when
1772− `ibid` is triggered).
1773−
1774− * LaTeX reader:
1775−
1776− + Move `getNextNumber` from Readers.LaTeX to Readers.LaTeX.Parsing.
1777− + Fix negative numbers in siunitx commands. A change in pandoc 2.11
1778− broke negative numbers, e.g. `\SI{-33}{\celcius}` or `\num{-3}`.
1779− This fixes the regression.
1780−
1781− * DocBook reader: drop period in formalpara title
1782− and put it in a div with class `formalpara-title`, so that
1783− people can reformat with filters (#6562).
1784−
1785− * Man reader: improve handling of `.IP` (#6858). We now better handle
1786− `.IP` when it is used with non-bullet, non-numbered lists, creating a
1787− definition list. We also skip blank lines like groff itself.
1788−
1789− * Bibtex reader: fall back on `en-US` if locale for LANG not found.
1790− This reproduces earlier pandoc-citeproc behavior (jgm/citeproc#26).
1791−
1792− * JATS writer:
1793−
1794− + Wrap all tables (Albert Krewinkel).
1795− All `<table>` elements are put inside `<table-wrap>` elements, as the
1796− former are not valid as immediate child elements of `<body>`.
1797− + Move Table handling to separate module (Albert Krewinkel).
1798− Adds two new unexported modules:
1799− Text.Pandoc.Writers.JATS.Types, Text.Pandoc.Writers.JATS.Table.
1800−
1801− * Org writer:
1802−
1803− + Replace org #+KEYWORDS with #+keywords (TEC).
1804− As of ~2 years ago, lower case keywords became the standard (though
1805− they are handled case insensitive, as always).
1806− + Update org supported languages and identifiers according to the
1807− current list contained in
1808− <https://orgmode.org/worg/org-contrib/babel/languages/index.html>
1809− (TEC).
1810−
1811− * Only use `filterIpynbOutput` if input format is ipynb (#6841).
1812− Before this change content could go missing from divs with class
1813− `output`, even when non-ipynb was being converted.
1814−
1815− * When checking reader/writer name, check base name now that we permit
1816− extensions on formats other than markdown.
1817−
1818− * Text.Pandoc.PDF: Fix `changePathSeparators` for Windows (#6173).
1819− Previously a path beginning with a drive, like `C:\foo\bar`, was
1820− translated to `C:\/foo/bar`, which caused problems.
1821− With this fix, the backslashes are removed.
1822−
1823− * Text.Pandoc.Logging:
1824−
1825− + Add constructor `ATXHeadingInLHS` to `LogMessage` [API change].
1826− + Add constructor `EnvironmentVariableUndefined` to
1827− `LogMessage` [API change].
1828−
1829− * Fix error that is given when people specify `doc` output (#6834,
1830− gison93).
1831−
1832− * LaTeX template: add a `\break` after parbox in `CSLRightInline`.
1833− This should fix spacing problems between entries with numeric styles.
1834− Also fix number of params on `CSLReferences`.
1835−
1836− * reveal.js template: Put quotes around `controlsLayout`,
1837− `controlsBackArrows`, and `display`, since these require strings.
1838− Add `showSlideNumber`, `hashOneBasedIndex`, `pause`.
1839−
1840− * Use citeproc 0.2. This fixes a bug with title case around parentheses.
1841−
1842− * pandoc.cabal: remove 'static' flag.
1843− This isn't really necessary and can be misleading (e.g. on macOS,
1844− where a fully static build isn't possible). cabal's new option
1845− `--enable-executable-static` does the same. On stack you can add
1846− something like this to the options for your executable in package.yaml:
1847−
1848− ld-options: -static -pthread
1849−
1850− * Remove obsolete bibutils flag setting in `linux/make_artifacts.sh`.
1851−
1852− * Manual:
1853−
1854− + Correct `link-citation` -> `link-citations`.
1855− + Add a sentence about `pagetitle` for HTML (#6843, Alex Toldaiev).
1856−
1857− * INSTALL.md: Remove references to `pandoc-citeproc` (#6857).
1858−
1859− * CONTRIBUTING: describe hlint and how it's used (#6840, Albert
1860− Krewinkel).
1861−
1862−## pandoc 2.11.1.1 (2020-11-07)
1863−
1864− * Citeproc: improve punctuation in in-text note citations (#6813).
1865− Previously in-text note citations inside a footnote would sometimes have
1866− the final period stripped, even if it was needed (e.g. on the end of
1867− 'ibid').
1868−
1869− * Use citeproc 0.1.1.1. This improves the decision about when
1870− to use `ibid` in cases where citations are used inside
1871− a footnote (#6813).
1872−
1873− * Support `nocase` spans for `csljson` output.
1874−
1875− * Require latest commonmark, commonmark-extensions.
1876− This fixes a bug with `autolink_bare_uris` and commonmark.
1877−
1878− * LaTeX reader: better handling of `\\` inside math in table cells (#6811).
1879−
1880− * DokuWiki writer: translate language names for code elements
1881− and improve whitespace (#6807).
1882−
1883− * MediaWiki writer: use `syntaxhighlight` tag instead of deprecated
1884− `source` for highlighted code (#6810). Also support `startFrom`
1885− attribute and `numberLines`.
1886−
1887− * Lint code in PRs and when committing to master (#6790,
1888− Albert Krewinkel).
1889−
1890− * doc/filters.md: describe technical details of filter invocations (#6815,
1891− Albert Krewinkel).
1892−
1893−
1894−## pandoc 2.11.1 (2020-11-03)
1895−
1896− * DocBook Reader: fix duplicate bibliography bug (#6773, Nils Carlson).
1897−
1898− * HTML reader:
1899−
1900− + Parse contents of iframes (#6770).
1901− + Parse inline svg as image unless `raw_html` is set in the reader (in
1902− which case the svg is passed through as raw HTML) (#6770).
1903−
1904− * LaTeX reader:
1905−
1906− + Fix bug parsing macro arguments (#6796). If `\cL` is
1907− defined as `\mathcal{L}`, and `\til` as `\tilde{#1}`, then
1908− `\til\cL` should expand to `\tilde{\mathcal{L}}`, but
1909− pandoc was expanding it to `\tilde\mathcal{L}`. This is
1910− fixed by parsing the arguments in "verbatim mode" when the
1911− macro expands arguments at the point of use.
1912− + Properly support optional (cite) argument for
1913− `\blockquote` from `csquotes` (#6802).
1914−
1915− * LaTeX writer: Improved calculation of table column widths.
1916− We now have LaTeX do the calculation, using `\tabcolsep`.
1917− So we should now have accurate relative column widths no
1918− matter what the text width. The default template has been modified to load
1919− the calc package if tables are used.
1920−
1921− * HTML writer: Fix duplicate "class" attribute for table
1922− rows (Andy Morris).
1923−
1924− * Text.Pandoc.Filter: allow shorter YAML representation of Citeproc
1925− (Albert Krewinkel). The map-based YAML representation of filters expects
1926− `type` and `path` fields. The path field had to be present for all filter
1927− types, but is not used for citeproc filters. The field can now be omitted
1928− when type is "citeproc", as described in the MANUAL.
1929−
1930− * Text.Pandoc.Error: Add `PandocBibliographyError` constructor
1931− for `PandocError` [API change]. This ensures that bibliography parsing
1932− errors generate messages that include the bibliography file name --
1933− otherwise it can be quite mysterious where it is coming from.
1934−
1935− * Citeproc: properly handle `csl` field with `data:` URI (#6783).
1936− This is used with the JATS writer, so this fixes a regression
1937− in pandoc 2.11 with JATS output and citeproc.
1938−
1939− * Allow `citation-abbreviations` in defaults file.
1940−
1941− * JATS templates: ensure `jats_publishing` output is valid
1942− (Albert Krewinkel).
1943−
1944− * LaTeX template: Fix `CSLRightInline`, so that it does not
1945− run over the right margin.
1946−
1947− * HTML template: default CSS tweaks (Mauro Bieg and John
1948− MacFarlane).
1949−
1950− - Fix margin before codeblock
1951− - Add `monobackgroundcolor` variable, making the background color
1952− and padding of code optional.
1953− - Ensure that backgrounds from highlighting styles take precedence over
1954− monobackgroundcolor
1955− - Remove list markers from TOC
1956− - Add margin-bottom where needed
1957− - Remove italics from blockquote styling
1958− - Change borders and spacing in tables to be more consistent with other
1959− output formats
1960− - Style h5, h6
1961− - Set font-size for print media to 12pt.
1962− - Reduce interline space.
1963− - Reduce interparagraph space.
1964− - Reduce line width.
1965− - Remove the special `line-height: 1` for table cells.
1966− - Remove the special line-height for pre.
1967− - Ensure that there is a bit more space before a heading
1968− than after.
1969− - Slightly reduced space after title header.
1970− - Add CSS example to MANUAL
1971−
1972− * man template: Change comment that triggers `tbl` from
1973− `.\"t` to `'\" t`, as specified in groff_man(7) (#6803).
1974−
1975− * Use latest commonmark, commonmark-extensions.
1976− This fixes a bug with nested blocks in footnotes with the
1977− `footnote` extension to `commonmark`. See jgm/commonmark-hs#63.
1978−
1979− * Citeproc: use comma for in-text citations inside footnotes.
1980− When an author-in-text citation like `@foo` occurs in a footnote,
1981− we now render it with: `AUTHOR NAME + COMMA + SPACE + REST`.
1982− Previously we rendered: `AUTHOR NAME + SPACE + "(" + REST + ")"`.
1983− This gives better results. Note that normal citations are still
1984− rendered in parentheses.
1985−
1986− * Use latest citeproc:
1987−
1988− + citeproc no longer capitalizes notes, so we do it
1989− in pandoc when appropriate.
1990− + Closes #6783.
1991−
1992− * Clarify manual on `--track-changes` (#6801).
1993−
1994− * Add `doc/jats.md` to document pandoc's handling of JATS
1995− (#6794, Albert Krewinkel).
1996−
1997− * Fix code example in lua-filters.md (#6795).
1998−
1999−## pandoc 2.11.0.4 (2020-10-21)
2000−
2001− * Commonmark writer: fix regression with fenced divs (#6768).
2002− Starting with 2.10.1, fenced divs no longer render with
2003− HTML div tags in commonmark output. This is a regression
2004− due to our transition from cmark-gfm. This commit fixes it.
2005−
2006− * Use released version of citeproc. (This fixes a mis-step
2007− in the 2.11.0.3 release, which is now deprecated.)
2008−
2009− * Use latest sylighting, with support for `groovy`.
2010−
2011− * Document that --html-q-tags requires the smart extension on the reader
2012− (#6766).
2013−
2014−## pandoc 2.11.0.3 (2020-10-20)
2015−
2016− * Use latest citeproc (closes #6765). This fixes a problem with
2017− author-in-text citations for references including both an author
2018− and an editor. Previously, both were included in the text, but only
2019− the author should be.
2020−
2021− * With `--citeproc`, ensure that the final period is removed when
2022− citations that occur in notes in note-based styles get put in
2023− parentheses. See jgm/citeproc#20.
2024−
2025− * Normalize rewritten image paths with `--extract-media` (#6761).
2026− This change will avoid mixed paths like this one when
2027− `--extract-media` is used with a Word file:
2028− `![](C:\Git\TIJ4\Markdown/media/image30.wmf)`. Instead we'll get
2029− `![](C:\Git\TIJ4\Markdown`media`image30.wmf)`.
2030−
2031− * Modify `--version` output. Use space more efficiently and report the
2032− citeproc and ipynb versions, along with skylighting, texmath, and
2033− pandoc-types. Drop the word "default" before "user data directory."
2034−
2035− * DocBook reader: bibliomisc and anchor support (#6754, Nils Carlson).
2036− Also ensure that bibliodiv without a title no longer results in
2037− an empty Header.
2038−
2039− * ConTeXt template: adds `\setupinterlinespace` to fonts larger
2040− than normal (#6763, Denis Maier).
2041−
2042− * LaTeX template: Do not load amssymb if not needed (#6469, Angelo Peronio).
2043− See <https://tex.stackexchange.com/a/549938>.
2044−
2045− * Relax upper bound on hslua, allow hslua-1.3.* (Albert Krewinkel).
2046−
2047− * MANUAL:
2048−
2049− + Improve explanation of "indent" variable (#6767, Cyrus Yip).
2050− + Remove org from list of input formats supporting raw_tex (#6753,
2051− Nick Fleisher).
2052−
2053−
2054−## pandoc 2.11.0.2 (2020-10-15)
2055−
2056− * Fix handling of `xdata` in bibtex/biblatex bibliographies (#6752).
2057−
2058− * Fix some small typos in the API documentation (#6751, Michael Hoffmann).
2059−
2060− * Require citeproc 0.1.0.2. This fixes a regression from pandoc-citeproc
2061− involving spacing between components of a reference in certain styles
2062− (e.g. `cell.csl`).
2063−
2064− * Fix typos in comments, doc strings, error messages, and tests
2065− (Albert Krewinkel, #6738).
2066−
2067−## pandoc 2.11.0.1 (2020-10-13)
2068−
2069− * LaTeX reader: support more acronym commands (#6746):
2070− `\acl`, `\aclp`, and capitalized versions of already
2071− supported commands.
2072−
2073− * Commonmark reader: add `pipe_table` extension *after* defaults (#6739).
2074− Otherwise we get bad results for non-table, non-paragraph
2075− lines containing pipe characters.
2076−
2077− * Markdown writer: Fix autolinks rendering for gfm (#6740).
2078− Previously, autolinks rendered as raw HTML, due to the
2079− `class="uri"` added by pandoc's markdown reader.
2080−
2081− * LaTeX writer:
2082−
2083− + Escape option values in lstlistings environment (#6742).
2084− + Fix handling of `lang` `pt-BR` (#2953). For polyglossia we now
2085− use `\setmainlanguage[variant=brazilian]{portuguese}` and for babel
2086− `\usepackage[shorthands=off,main=brazilian]{babel}`.
2087−
2088− * Depend on latest citeproc (0.1.0.1).
2089−
2090− + This fixes the citation number issue with ieee.csl and other
2091− styles that do not explicitly sort bibliographies (#6741). (Pandoc
2092− was numbering them by their order in the bibliography file,
2093− rather than the order cited, as required by the CSL spec.)
2094− + Fixes groupin/collapsing with citation items with prefixes.
2095−
2096− * default.latex: fix `CSLReference` macro definition.
2097−
2098− * Fix MANUAL.txt CSL JSON conversion examples.
2099−
2100− * Fix spelling errors in changelog, MANUAL.txt, `doc/org.md` (#6738).
2101−
2102−
2103−## pandoc 2.11 (2020-10-11)
2104−
2105− * Add `--citeproc` (`-C`) option to trigger built-in citation processing.
2106− It is no longer necessary to use the external `pandoc-citeproc`
2107− filter. `--citeproc` behaves like a filter and can be positioned
2108− relative to other filters as they appear on the command line.
2109−
2110− The new built-in citation processing uses the citeproc library,
2111− a reimplementation of CSL citation processing that fixes many
2112− of the shortcomings of pandoc-citeproc. In general, citation
2113− processing should work much the same as it did with pandoc-citeproc,
2114− but with greater fidelity to CSL styles and better performance.
2115− (The tests from the pandoc-citeproc package have been carried
2116− over to pandoc.) The following differences should be noted:
2117−
2118− - At this point, only some of the writers (HTML, ms, LaTeX) properly
2119− interpret CSL display styles. You should get decent output in
2120− all formats (at least as good as with pandoc-citeproc), but
2121− indentation and block-alignment may not be right.
2122−
2123− - pandoc-citeproc searches the `~/.csl` directory for `.csl`
2124− styles. Pandoc instead searches the `csl` subdirectory of
2125− the pandoc user data directory (e.g., `~/.pandoc/csl` or
2126− `~/.local/share/pandoc/csl`). Users who already keep
2127− CSL styles in `~/.csl` may find it convenient to add a
2128− symlink.
2129−
2130− - Some of the bibliography formats supported by pandoc-citeproc (via
2131− hs-bibutils) are no longer supported: Copac, EndNote,
2132− ISI, MEDLINE, MODS, and RIS. If you use one of these formats,
2133− you may use the `bibutils` utility to convert to BibLaTeX.
2134− We now support only BibTeX, BibLaTeX, CSL JSON,
2135− and pandoc's YAML/Markdown analogue of CSL JSON.
2136−
2137− - pandoc-citeproc would always retrieve the independent parent
2138− of a dependent style by doing an HTTP request. pandoc will
2139− now first seek the independent parent locally (in the resource
2140− path or in the `csl` subdirectory of the pandoc user data
2141− directory) before resorting to HTTP. In addition, you may
2142− omit the `.csl` extension, e.g. `--csl zoology`.
2143−
2144− - Using the `--bibliography` option (or including
2145− `bibliography` in YAML metadata) no longer triggers
2146− citation processing implicitly: one must always use the
2147− `--citeproc` option if citation processing is wanted.
2148−
2149− * Add `csljson` as and input and output format. This allows pandoc
2150− to convert between `csljson` and other bibliography formats
2151− (e.g. `-f csljson -t markdown -s` or `-f bibtex -t csljson`),
2152− and to generate formatted versions of CSL JSON bibliographies
2153− (e.g., `pandoc -f csljson --citeproc pl.json -o pl.pdf`).
2154−
2155− * Added `bibtex`, `biblatex` as input formats. This allows pandoc
2156− to convert between BibLaTeX and BibTeX and other bibliography formats,
2157− and to generated formatted versions of BibTeX/BibLaTeX bibliographies
2158− (e.g., `pandoc -f biblatex --citeproc pl.bib -o pl.pdf`).
2159−
2160− * Raise informative errors when YAML metadata parsing fails (#6730).
2161− Previously the command would succeed, returning empty metadata,
2162− with no errors or warnings.
2163−
2164− * Sort languages in `--list-highlight-languages` output (#6718,
2165− Albert Krewinkel). Languages were previously sorted by their
2166− long name, which leads to unexpected results).
2167−
2168− * Add CSS to default HTML template (#6601, Mauro Bieg). This
2169− greatly improves the default typography in pandoc's HTML
2170− output. The CSS is sensitive to a number of variables
2171− (e.g. `mainfont`, `fontsize`, `linestretch`): see the manual for
2172− details. To restore the earlier, more spartan output, you can
2173− disable this with `-M document-css=false`.
2174−
2175− * Support `--toc-depth` option for ODT writer (#6696, niszet).
2176−
2177− * Fix issues with Windows UNC paths with some options (#5127).
2178−
2179− * Remove `fenced_code_blocks` and `backtick_code_blocks` from allowed
2180− `commonmark` and `gfm` extensions. These shouldn't really be counted
2181− as extensions, because they can't be disabled in commonmark.
2182− Adjust markdown writer to check for the commonmark variant in addition
2183− to extensions.
2184−
2185− * Add these extensions to `gfm` and `commonmark`:
2186− `fenced_code_blocks`, `backtick_code_blocks`, `fenced_code_attributes`.
2187− These can't really be disabled in the reader, but they need to be enabled
2188− in the writer or we just get indented code.
2189−
2190− * Make sure proper set of extensions is recognized for `commonmark_x`.
2191−
2192− * Allow `gfm_auto_identifiers`, `ascii_identifiers` extensions for `docx`.
2193−
2194− * Markdown reader:
2195−
2196− + Add `Maybe FilePath` parameter to `yamlToMeta` [API change].
2197− + Export `yamlToRefs` [API change], a version of `yamlToMeta`
2198− specialized to references.
2199− + Set `citationNoteNum` accurately in citations.
2200− + Revise abbreviation support. Don't insert a nonbreaking space after a
2201− potential abbreviation if it comes right before a note or citation.
2202− This causes problems for citeproc's moving of note citations.
2203−
2204− * LaTeX reader:
2205−
2206− + Support missing siunitx commands (#6658).
2207− + Support `squared`, `cubed`, `tothe` in siunitx (#6657).
2208− + Improved uncertainty handling in slunitx.
2209− + Factored out siunitx stuff into separate unexposed module.
2210− + Fix improper empty cell filtering (#6689, Christian Despres).
2211− + Fix parsing of "show name" in `\newtheorem` (#6734).
2212− Previously we were just treating it as a string and
2213− ignoring accents and formatting.
2214− + Prevent wrong nesting of `\multirow` and `\multicolumn` table
2215− cells (#6603, Laurent P. René de Cotret).
2216− + Table cell parser not consuming spaces correctly (#6596,
2217− Laurent P. René de Cotret).
2218− + Change `SIRange` to `SIrange` (#6617, Emerson Harkin).
2219− + Allow blank lines inside `\author` (#6324).
2220−
2221− * DocBook reader:
2222−
2223− + Don't squelch space at end of emphasis and other inline elements;
2224− instead, move it outside the element (#6719).
2225− + Implement table cell alignment (#6698, Nils Carlson).
2226− + Implement column span support for tables (#6492, Nils Carlson).
2227− + Update list of block level tags (#6610).
2228−
2229−
2230− * JATS reader:
2231−
2232− + Don't squelch space at end of emphasis and other inline elements;
2233− instead, move it outside the element (#6719).
2234−
2235− * RST reader:
2236−
2237− + Apply `.. class::` directly to following Header rather than creating
2238− a surrounding Div (#6699).
2239−
2240− * Docx reader:
2241−
2242− + Allow empty dates in comments and tracked changes (#6726, Diego
2243− Balseiro).
2244−
2245− * Markdown writer:
2246−
2247− + Be less aggressive about using quotes for YAML values,
2248− allowing e.g. a quotation mark or bracket as long as it's not at the
2249− beginning of the line.
2250− + Use double quotes for YAML metadata (#6727).
2251− + Sort YAML metadata keys in Markdown output case-insensitive.
2252−
2253−
2254− * Asciidoc writer:
2255−
2256− + Support asciidoctor's block figures (#6538, argent0).
2257−
2258− * LaTeX writer:
2259−
2260− + Fix spacing issue with list in definition list.
2261− When a list occurs at the beginning of a definition list definition,
2262− it can start on the same line as the label, which looks bad.
2263− Fix that by starting such lists with an `\item[]`.
2264−
2265− * HTML writer:
2266−
2267− + Support intermediate table headers (#5314, Albert Krewinkel).
2268− + Support attributes on all table elements (Albert Krewinkel).
2269− + Render table footers if present (#6314, Albert Krewinkel).
2270− + Fix addition of `doc-biblioentry` role.
2271− + Support colspans and rowspans in HTML tables (#6312, Albert Krewinkel).
2272−
2273− * ICML writer:
2274−
2275− + Support internal document links (#5541, Leonard Rosenthol).
2276− + Changed default link state to invisible (#6676, Leonard Rosenthol).
2277−
2278− * Docx writer:
2279−
2280− + Better handle list items whose contents are lists (#5948, Michael
2281− Hoffmann). If the first element of a bulleted or ordered list is
2282− another list, then that first item would previously disappear if the
2283− target format is docx.
2284− + Separate adjacent tables (#4315). Word combines adjacent tables,
2285− so to prevent this we insert an empty paragraph between two
2286− adjacent tables.
2287−
2288− * Org writer:
2289−
2290− + Don't force blank line after headings (#6554).
2291−
2292− * OpenDocument writer:
2293−
2294− + Implement table cell alignment (#6700 Nils Carson, Mauro Bieg).
2295− + New table cell support with row and column spans (#6682, Nils Carson).
2296− + Syntax highlighting for inline code (#6711, niszet).
2297−
2298− * Add Text.Pandoc.Citeproc module, exporting `processCitations`
2299− [API change]. This depends on several other, unexported
2300− modules under Text.Pandoc.Citeproc.
2301−
2302− * Add module Text.Pandoc.Writers.CslJson, exporting `writeCslJson`.
2303− [API change]
2304−
2305− * Add module Text.Pandoc.Readers.CslJson, exporting `readCslJson`.
2306− [API change]
2307−
2308− * Add module Text.Pandoc.Readers.BibTeX, exporting `readBibTeX` and
2309− `readBibLaTeX`. [API change]
2310−
2311− * Text.Pandoc.Filter: Add `CiteprocFilter` constructor to Filter.
2312− [API change] This runs the processCitations transformation.
2313− We need to treat it like a filter so it can be placed
2314− in the sequence of filter runs (after some, before others).
2315− In FromYAML, this is parsed from `citeproc` or `{type: citeproc}`,
2316− so this special filter may be specified either way in a defaults file
2317− (or by `citeproc: true`, though this gives no control of positioning
2318− relative to other filters).
2319−
2320− * Add new exported module Text.Pandoc.Writers.AnnotatedTable [API change]
2321− (#6655, Christian Despres). This module (which should generally
2322− be imported qualified to avoid name conflicts) provides a
2323− `Table` type that mirrors the structure of a pandoc `Table`,
2324− but with added inferred information so that the writers do not have to
2325− lay out tables themselves. The `toTable` and `fromTable` functions convert
2326− between an annotated `Table` and a regular pandoc `Table`. In addition to
2327− producing a `Table` with coherent and well-formed annotations, the
2328− `toTable` function also normalizes its input table like the table
2329− builder does. Tests ensure that `toTable` normalizes tables exactly
2330− like the table builder, and that its annotations are coherent.
2331−
2332− * Text.Pandoc.Logging:
2333−
2334− + Remove unused `CouldNotParseYamlMetadata` constructor for `LogMessage`
2335− [API change].
2336− + Add `CiteprocWarning` constructor to `LogMessage` [API change].
2337−
2338− * Text.Pandoc.Readers.Metadata: export `yamlBsToRefs` [API change].
2339− These allow specifying an id filter so we parse only references
2340− that are used in the document.
2341−
2342− * Text.Pandoc.Parsing:
2343−
2344− + Export ParseError [API change].
2345− + Add `stateInNote` and `stateNoteNumber` to `ParserState`
2346− [API change]. These are used to populate note numbers for citation
2347− processing.
2348−
2349− * Fix apparent typos in sample.lua (#6729, William Lupton).
2350− Also make the writer less aggressive in escaping quotes.
2351−
2352− * Text.Pandoc.Options:
2353−
2354− + `defaultMathJaxURL`: use `tex-chtml-full` instead of `tex-mml-chtml`
2355− (#6599, Kolen Cheung). This drops the MathML support (which we
2356− don't need for HTML math rendering) and includes the full JavaScript,
2357− which makes it possible to use `--self-contained` (though there may
2358− still be issues if the required math fonts aren't available). This
2359− change should also reduce latency in pages with lots of formulas.
2360− + Add `/tex-chtml-full.js` to `defaultMathJaxURL` (#6593) Previously we
2361− added this in processing command line options, but not in processing
2362− defaults files, which was inconsistent.
2363−
2364− * epub.css: Fix cover page selectors and add note explaining their use
2365− (#6649, a-vrma).
2366−
2367− * Add data files needed for Text.Pandoc.Citeproc: these include
2368− `default.csl` in the data directory and a `citeproc` directory that
2369− is only used at compile-time for biblatex localizations. Note that we've
2370− added `file-embed` as a mandatory rather than a conditional
2371− dependency, because of the biblatex localization files.
2372−
2373− * Lua filters:
2374−
2375− + Add SimpleTable for backwards compatibility (#6575, Albert Krewinkel).
2376− A new type `SimpleTable` is made available to Lua filters. It is
2377− similar to the `Table` type in pandoc versions before 2.10;
2378− conversion functions from and to the new Table type are provided.
2379− Old filters using tables now require minimal changes and can use, e.g.,
2380−
2381− if PANDOC_VERSION > {2,10,1} then
2382− pandoc.Table = pandoc.SimpleTable
2383− end
2384−
2385− and
2386−
2387− function Table (tbl)
2388− tbl = pandoc.utils.to_simple_table(tbl)
2389− …
2390− return pandoc.utils.from_simple_table(tbl)
2391− end
2392−
2393− to work with the current pandoc version.
2394−
2395− + Make `attr` argument optional in `Table` constructor (Albert Krewinkel).
2396− This changes the Lua API. It is highly unlikely for this change to affect
2397− existing filters, since the documentation for the new Table constructor
2398− (and type) was incomplete and partly wrong before. The Lua API is now
2399− more consistent, as all constructors for elements with attributes now
2400− take attributes as the last parameter.
2401−
2402− * MANUAL.txt:
2403−
2404− * Add a dedicated Citations section which consolidates the information
2405− the manual used to contain about citation processing, and incorporates
2406− some information formerly found in the pandoc-citeproc man page.
2407− + Add note about lualatex using `selnolig`.
2408− + Remove duplicate `seriespage` (#6568, Blake Eryx).
2409− + Remove lists of support extensions for markdown variants (#6604).
2410− Instead, offer the advice to use `--list-extensions=FORMAT`.
2411− + Fix position of attributes in header (Albert Krewinkel).
2412− + Delete obsolete section on compact and loose lists (#6684).
2413−
2414−
2415− * doc/lua-filters.md:
2416−
2417− + Add info on how to debug Lua filters (#6732, Ian Max Andolina).
2418− + Document Underline type and constructor (Albert Krewinkel).
2419− + Document `body` field (Albert Krewinkel).
2420− + Add missing header attribute
2421− + Add missing Link.title field (Albert Krewinkel).
2422− + Make the setting-the-date example conditional (the-solipsist).
2423− This makes the example a bit more realistic.
2424− + Remove outdated link table example.
2425−
2426− * doc/org.md:
2427−
2428− + Add section on tables (Albert Krewinkel).
2429− + Add section on handling of unknown directives (Albert Krewinkel).
2430−
2431− * CONTRIBUTING.md: fix typo (#6584, Dmitry Volodin).
2432−
2433− * Use golden test framework for command tests. This means that
2434− `--accept` can be used to update expected output.
2435−
2436− * Use the `smart` extension when generating pandoc's man page (#6613).
2437−
2438− * Release-candidate: don't build windows i386.
2439− So far we haven't been able to figure out how to get
2440− stack to use a 32-bit ghc.
2441−
2442− * Use `null` instead of deprecated `Builder.isNull`.
2443−
2444− * Makefile:
2445−
2446− + Fix macospkg target to fetch target from S3 artifacts.
2447− + Fix pandoc-templates target to include all partials.
2448−
2449− * Remove duplicated dependency in pandoc.cabal (#6591, Felix Yan).
2450−
2451− * Sort build depends in pandoc.cabal alphabetically (#6691,
2452− Albert Krewinkel).
2453−
2454− * Add .travis.yml for macos release candidate build (#6622).
2455− We need to build the release candidate on Travis rather
2456− than GitHub actions, because GH has macos 10.15, and
2457− binaries compiled on that OS will not work with 10.13.
2458− This build is only triggered on `rc/*` branches.
2459−
2460− * Remove instructions for building pandoc-citeproc from CI and
2461− release binary build instructions. We will no longer distribute
2462− pandoc-citeproc.
2463−
2464− * Fix math rendering in trypandoc (this broke after
2465− commit d8ad766d17603784b86fc5c2e1b22864125d04d1).
2466−
2467− * Use latest versions of skylighting, commonmark (#6589),
2468− comonmark-extensions, commonmark-pandoc, texmath.
2469−
2470− * Relax version bounds for hslua, hslua-module-text, bytestring.
2471−
2472− * Use released pandoc-types 1.22. This changes the JSON
2473− encoding slightly for the new table types introduced
2474− in 1.21, so they're more consistent with the rest.
2475− Developers of libraries for pandoc filters will want
2476− to take note.
2477−
2478− * Fix hlint suggestions, update hlint.yaml (#6680, Christian Despres).
2479−
2480− * Code cleanup (#6678, Joseph C. Sible).
2481−
2482− * Add haddocks to functions in Text.Pandoc.Writers.Shared (Albert
2483− Krewinkel).
2484−
2485− * Remove duplicate `tshow` definition.
2486−
2487− * Linux release candidate build: use ghc-musl container. This simplifies
2488− our build process (over using a customized alpine container).
2489−
2490−
2491−## pandoc 2.10.1 (2020-07-23)
2492−
2493− * Add `commonmark_x` output format. This is `commonmark` with a number
2494− of useful pandoc extensions enabled.
2495−
2496− * Many more extensions now work with `commonmark` and `gfm`.
2497−
2498− * Add generic `attributes` extension. This allows attributes to
2499− be added to any block or inline element in a uniform way. Since
2500− the Pandoc AST doesn't include attributes on each element type,
2501− the attributes will sometimes be added by creating a surrounding
2502− Div or Span container. Currently this extension is only
2503− compatible with the `commonmark` and `gfm` readers.
2504−
2505− To add an attribute to a block-level element, e.g. a paragraph,
2506− put it before the block:
2507− ```
2508− {#mypara}
2509− This is a paragraph.
2510− ```
2511− Multiple attributes may be used and will be combined:
2512− ```
2513− {#mypara}
2514− {.blue .warning key="val"}
2515− This is a paragraph.
2516− ```
2517− To add an attribute to an inline-level element, put it
2518− immediately after the element:
2519− ```
2520− *emphasized text*{.special}
2521− ```
2522−
2523− * Support `--number-sections` for docx output (#1413).
2524−
2525− * LaTeX reader:
2526−
2527− + Support `\SIRange` reader (#6418, Emerson Harkin).
2528− + Support table col-span and row-span (#6311, Laurent P. René de Cotret).
2529− Supports `\multirow` and `\multicolumn`.
2530− + Support amsthm: `\newtheorem`, `\theoremstyle`, and theorem and
2531− proof environments, including labels and references. The only thing
2532− that is unsupported is the second optional argument, which causes
2533− numbering to be reset after the specified series is incremented.
2534− + Moved some code to T.P.LaTeX.Parsing. We need to reduce the size
2535− of the LaTeX reader to ease compilation on resource-limited systems.
2536−
2537− * RST reader:
2538−
2539− + Fix csv tables with multiline cells (#6549).
2540− + Fix spurious newlines in some attributes from directives.
2541− + Avoid extra newline in included code blocks.
2542−
2543− * Commonmark reader:
2544−
2545− + Switch from cmark-gfm to commonmark-hs for commonmark and gfm
2546− parsing. This avoids depending on a C library
2547− and allows us to support more pandoc extensions for
2548− `commonmark` and `gfm`.
2549−
2550− * DocBook reader:
2551−
2552− + Parse releaseinfo as metadata (#6542).
2553−
2554− * Docx reader:
2555−
2556− + Only use `bCs/iCs` on runs with `rtl` or `cs` property (#6514, Nikolay
2557− Yakimov).
2558− + Code cleanup/refactoring (Nikolay Yakimov).
2559−
2560− * Org reader (Albert Krewinkel):
2561−
2562− + Respect export setting which disables entities
2563− MathML-like entities, e.g., `\alpha`, can be disabled with the
2564− `#+OPTION: e:nil` export setting (Albert Krewinkel).
2565− + Respect export setting disabling footnotes. Footnotes can be removed
2566− from the final document with the `#+OPTION: f:nil` export setting.
2567− + Respect tables-excluding export setting. Tables can be removed from
2568− the final document with the `#+OPTION: |:nil` export setting.
2569−
2570− * Markdown writer:
2571−
2572− + Move `asciify` out of `escapeString`. Otherwise `unsmartify`
2573− doesn't catch quotes that have already been turned to entities.
2574− + Add `writeCommonmark` (new exported function, API change).
2575− + Use unicode super/subscript characters when possible if the
2576− `superscript` or `subscript` extension or `raw_html` aren't available.
2577− + Render caption as following paragraph when `table_caption` extension
2578− is not enabled.
2579− + Use numerical labels for reference links that are longer
2580− than 999 characters or contain square brackets, for conformity
2581− with commonmark (#6560).
2582−
2583− * Commonmark writer:
2584−
2585− + Instead of using cmark-gfm, use `writeCommonmark` from the
2586− Markdown writer. This function calls the markdown writer
2587− with appropriate extensions and a few small modifications
2588− (e.g. not requiring backslashes before spaces inside
2589− super/subscripts). With this change `comonmark` and
2590− `gfm` output can be used with a wider selection of
2591− extensions.
2592−
2593− * Jira writer: keep image caption as alt attribute (#6529, Albert
2594− Krewinkel).
2595−
2596− * HTML writer:
2597−
2598− + Improve alt-text/caption handling for HTML5 (#6491, Albert Krewinkel).
2599− Screen readers read an image's `alt` attribute and the figure caption,
2600− both of which come from the same source in pandoc. The figure caption is
2601− hidden from screen readers with the `aria-hidden` attribute. This
2602− improves accessibility. For HTML4, where `aria-hidden` is not allowed,
2603− pandoc still uses an empty `alt` attribute to avoid duplicate contents.
2604−
2605− * Ms writer:
2606−
2607− + Fix code highlighting with blank lines. Previously blank lines
2608− were simply omitted from highlighted code.
2609− + Escape starting periods in ms writer code blocks (#6505, Michael
2610− Hoffmann). If a line of ms code block output starts with a period (.),
2611− it should be prepended by `\&` so that it is not interpreted as a roff
2612− command.
2613−
2614− * Text.Pandoc.Extensions:
2615−
2616− + Add `raw_markdown` extension (which only affects `ipynb`
2617− input).
2618− + Trim down `githubMarkdownExtensions`.
2619− Previously it included all of the following, which make
2620− sense for the legacy `markdown_github` but not for `gfm`,
2621− since they are part of base commonmark and thus
2622− can't be turned off in `gfm`:
2623−
2624− - `Ext_all_symbols_escapable`
2625− - `Ext_backtick_code_blocks`
2626− - `Ext_fenced_code_blocks`
2627− - `Ext_space_in_atx_header`
2628− - `Ext_intraword_underscores`
2629− - `Ext_lists_without_preceding_blankline`
2630− - `Ext_shortcut_reference_links`
2631−
2632− These have been removed from `githubMarkdownExtensions`, though
2633− they're still turned on for legacy `markdown_github`.
2634− + Add `Ext_attributes` constructor for `Extension` [API change].
2635−
2636− * LaTeX template: use selnolig to selectively suppress ligatures with
2637− lualatex (#6534).
2638−
2639− * Benchmark bytestring readers (Nikolay Yakimov).
2640−
2641− * Documentation:
2642−
2643− + Update using-the-pandoc-api.md (favonia).
2644− + Fix Typos in lua-filters.md (tajmone).
2645− + Rewrite Raw HTML/TeX section in MANUAL.txt to avoid duplicate
2646− headings for the extensions.
2647− + Fix typo in MANUAL.txt (Benjamin Wuethrich).
2648− + Remove duplicate 'titlepage' in MANUAL.txt (Blake Eryx).
2649− + CONTRIBUTING.md: Advertise the official nightlies in GitHub actions.
2650− Replaces #6500, thanks to @ickc.
2651−
2652−
2653−
2654−## pandoc 2.10 (2020-06-29)
2655−
2656− * Use pandoc-types 1.21. This adds two things:
2657−
2658− + A native Underline constructor for Inline (#6277, Vaibhav Sagar).
2659− + More expressive types for tables (#1024, Christian Despres).
2660− Tables can now take attributes; and rowspans and colspans,
2661− column headers, multiple row headers, table head and foot
2662− can all be represented. (Note, however, that reader and
2663− writer support for these features is still lacking, so
2664− most users won't see any differences in table conversion
2665− yet. These changes just lay the foundation for further
2666− improvements.)
2667−
2668− * Support new Underline element in readers and writers (#6277,
2669− Vaibhav Sagar).
2670−
2671− * Support new Table type (Christian Despres).
2672− The Builder.simpleTable now only adds a row to the TableHead
2673− when the given header row is not null. This uncovered an
2674− inconsistency in the readers: some would unconditionally
2675− emit a header filled with empty cells, even if the header
2676− was not present. Now every reader has the conditional
2677− behaviour. Only the XWiki writer depended on the header row
2678− being always present; it now pads its head as necessary.
2679−
2680− * Add an option to disable certificate validation (#6156, Cédric Couralet,
2681− Cécile Chemin, Juliette Fourcot). This commit adds the option
2682− `--no-check-certificate`, which disables certificate checking when
2683− resources are fetched by HTTP.
2684−
2685− * Unify defaults and markdown metadata parsers (#6328, Nikolay
2686− Yakimov). Clean up code in Text.Pandoc.Readers.Metadata and
2687− properly handle errors in `yamlToMeta`. This fixes parsing
2688− of Boolean fields in metadata withinin defaults files and reduces
2689− code duplication.
2690−
2691− * Docbook reader:
2692−
2693− + Implement `<procedure>` (#6442, Mathieu Boespflug).
2694− + Implement `<phrase>` (#6438, Mathieu Boespflug).
2695− + Treat envar and systemitem like code (#6435, Mathieu Boespflug).
2696− + Implement `<replaceable>` (#6437, Mathieu Boespflug)
2697− + Map `<simplesect>` to unnumbered section (#6436, Mathieu Boespflug).
2698−
2699− * JATS reader:
2700−
2701− + Handle "label" element in section title (#6288).
2702− + Parse abstract element into metadata field of same name
2703− (#6480, Albert Krewinkel).
2704−
2705− * Jira reader (Albert Krewinkel):
2706−
2707− + Resolve multiple parsing problems, including issues with empty
2708− table cells, faulty recognition of closing emphasis characters, and
2709− parsing of image attributes (#6212, #6219, #6220).
2710− + Two consecutive markup chars are now parsed verbatim (#6343);
2711− styled text must not be empty.
2712− + Newlines are no longer allowed within styled text (#6325).
2713− + Links to anchors are now parsed as links (#6407).
2714− + Retain image attributes (#6234). Jira images attributes as in
2715− `!image.jpg|align=right!` are retained as key-value pairs. Thumbnail
2716− images, such as `!example.gif|thumbnail!`, are marked by a
2717− `thumbnail` class in their attributes.
2718− + Use Underline for inserted text (#6237). Previously, the span was
2719− marked with the non-standard class `inserted`.
2720− + Improve icon conversion for `(/)`, `(x)`, `(!)`, `(?)`
2721− `(+)`, `(-)`, `(off)`, `(*)`. (#6236, #6264).
2722− + Support citations, attachment links, and user links (#6231, #6238,
2723− #6239).
2724− + Resolve parsing issues of blockquote, color (#6233, #6235).
2725−
2726− * HTML reader:
2727−
2728− + Parse attributes into table attributes.
2729− + Support `<bdo>` (#5794, Tristan de Cacqueray).
2730− + Add `summary` to list of block-level HTML tags (#6385).
2731− This improves support for summary/details inside Markdown.
2732− NOTE: you need to include a blank line before the closing
2733− `</details>`, if you want the last part of the content to
2734− be parsed as a paragraph.
2735− + Fix parsing unclosed th elements in a table (#6247).
2736−
2737− * Commonmark reader: Implement `implicit_figures` extension (#6350).
2738−
2739− * Markdown Reader:
2740−
2741− + Fix inline code in lists (#6284, Nikolay Yakimov).
2742− Previously inline code containing list markers was sometimes
2743− parsed incorrectly.
2744− + Don't require blank line after grid table (#6481).
2745− This allows grid tables to be enclosed in fenced divs with no
2746− intervening blank lines.
2747−
2748− * LaTeX reader:
2749−
2750− + Don't parse beyond `\end{document}` (#6380).
2751− This required some internal changes to `\subfile` handling.
2752− + Better handling of `\lettrine`. SmallCaps instead of Span
2753− for the part after the initial capital. Ensure that both
2754− arguments are parsed, so that in Markdown both
2755− are treated as raw LateX. (Closes #6258.)
2756−
2757− * Org reader (Albert Krewinkel):
2758−
2759− + Recognize images with uppercase extensions (#6472).
2760− + Keep unknown keyword lines as raw org. The lines of unknown
2761− keywords, like `#+SOMEWORD: value` are no longer read as metadata,
2762− but kept as raw `org` blocks. This ensures that more information
2763− is retained when round-tripping org-mode files; additionally,
2764− this change makes it possible to support non-standard org
2765− extensions via filters.
2766− + Unify keyword handling. Handling of export settings and other
2767− keywords (like `#+LINK`) has been combined and unified.
2768− + Support `LATEX_HEADER_EXTRA` and `HTML_HEAD_EXTRA`
2769− settings. These export settings are treated like their non-extra
2770− counterparts, i.e., the values are added to the `header-includes`
2771− metadata list.
2772− + Allow multiple `#+SUBTITLE` export settings. The values of all
2773− lines are read as inlines and collected in the `subtitle`
2774− metadata field.
2775− + Read `#+INSTITUTE` values as text with markup. The value is
2776− stored in the `institute` metadata field and used in the
2777− default beamer presentation template.
2778− + The behavior of the `#+AUTHOR` and `#+KEYWORD` export
2779− settings has changed: Org now allows multiple such lines
2780− and adds a space between the contents of each line. Pandoc
2781− now always parses these settings as meta inlines; setting
2782− values are no longer treated as comma-separated lists.
2783− Note that a Lua filter can be used to restore the previous
2784− behavior.
2785− + Read description lines as inlines (#6485). `#+DESCRIPTION` lines
2786− are now treated as text with markup. If multiple such
2787− lines are given, then all lines are read and separated by soft
2788− linebreaks.
2789− + Honor tex export option (#4070). The `tex` export option can be set
2790− with `#+OPTION: tex:nil` and allows three settings:
2791− `t` (the default) causes LaTeX fragments to be parsed as TeX or added
2792− as raw TeX. `nil` removes all LaTeX fragments from the document.
2793− `verbatim` treats LaTeX as text.
2794−
2795−
2796− * RST reader:
2797−
2798− + Pass arbitrary attributes through in code blocks (#6465).
2799− Exceptions: name (which becomes the id), class (which becomes the
2800− classes), and number-lines (which is treated specially to fit
2801− with pandoc highlighting).
2802− + Handle `date::` directive (#6276).
2803−
2804− * Textile reader: support `pre.` for code blocks (#6454).
2805−
2806− * Ipynb reader:
2807−
2808− + Implement `raw_markdown` extension (#5408). Specifying
2809− `-f ipynb+raw_markdown` will cause Markdown cells
2810− to be represented as raw Markdown blocks, instead of being
2811− parsed. This is not what you want when going from `ipynb`
2812− to other formats, but it may be useful when going from `ipynb`
2813− to Markdown or to `ipynb`, to avoid semantically insignificant
2814− changes in the contents of the Markdown cells that might
2815− otherwise be introduced.
2816− + Handle application/pdf output as image (#6430).
2817− + Properly handle image/svg+xml as an image (#6430).
2818−
2819− * Docx reader:
2820−
2821− + Distinguish between docx parsing and docx container unpacking errors.
2822−
2823− * MediaWiki reader:
2824−
2825− + Fix `gfm_auto_identifiers` so that `-` is not replaced by `_` (#6335).
2826−
2827− * Vimwiki reader:
2828−
2829− + Add nested syntax highlighting (#6256, Vlad Hanciuta).
2830− Nested syntaxes are specified like this:
2831− ```
2832− {{{sql
2833− SELECT * FROM table
2834− }}}
2835− ```
2836− The preformatted code block parser has been extended to check if the
2837− first attribute of the block is not a `key=value` pair, and in that
2838− case it will be considered as a class.
2839−
2840−
2841− * Jira writer (Albert Krewinkel):
2842−
2843− + Always escape braces (#6478). Braces are now always escaped, even
2844− within words or when surrounded by whitespace. Jira and
2845− Confluence treat braces specially.
2846− + Convert Underline to inserted text (`+inserted+`).
2847− + Add image attributes (#6234). Image attributes are added
2848− to the output as image parameters. If the image has a
2849− class "thumbnail", then a thumbnail image is generated;
2850− all other attributes are discarded in this case.
2851−
2852− * LaTeX writer:
2853−
2854− + Ensure that `-M csquotes` works even in fragment mode (#6265).
2855− + Escape `^` specially for listings (#6460).
2856− + Create hypertarget for links with identifier (#6360).
2857− + Distinguish between single and double quotes when using enquote
2858− package (#6457, dbecher-ito).
2859− + Add support for customizable alignment of columns in beamer (#6331,
2860− andrebauer).
2861− + Add support for customizable alignment of columns in beamer
2862− (#4805, #4150, andrebauer).
2863−
2864− * HTML writer:
2865−
2866− + Use CSS in favor of `<br>` for display math (#6372)
2867− Some CSS to ensure that display math is
2868− displayed centered and on a new line is now included
2869− in the default HTML-based templates; this may be
2870− overridden if the user wants a different behavior.
2871−
2872− * Org writer:
2873−
2874− + Clean-up Div handling (Albert Krewinkel).
2875−
2876− * Docx writer:
2877−
2878− + Enable column and row bands for tables (#6371).
2879− This change will not have any effect with the default style.
2880− However, it enables users to use a style (via a reference.docx)
2881− that turns on row and/or column bands.
2882−
2883− * OpenDocument (and ODT) writer:
2884−
2885− + Add custom-style "Abstract" in metadata abstract.
2886− This ensures that the abstract is rendered with style Abstract.
2887− + Enable custom-style attribute on a Div.
2888− This allows you to apply a custom style to contained paragraphs.
2889−
2890− * DocBook writer:
2891−
2892− + Add id of figure to enclosed image.
2893− + Add personname element to docbook author (#6244).
2894−
2895− * FB2 writer:
2896−
2897− + Properly handle cover-image containing spaces (#6391).
2898−
2899− * Markdown writer:
2900−
2901− + Ensure consistent padding for pipe tables (#6240).
2902− + Avoid unnecessary escapes before intraword `_` when
2903− `intraword_underscores` extension is enabled (#6296).
2904−
2905− * RST writer:
2906−
2907− + Properly handle images with same alt text (#6194).
2908− Previously we created duplicate references for these in rendering RST.
2909−
2910− * AsciiDoc writer:
2911−
2912− + Add blank line after Div (#6308).
2913−
2914− * Haddock Writer:
2915−
2916− + Support Haddock tables (Joe Hermaszewski).
2917− See this PR on Haddock for details on the table format:
2918− <https://github.com/haskell/haddock/pull/718>.
2919−
2920− * PowerPoint writer (Jesse Rosenthal):
2921−
2922− + Write math input verbatim in speaker notes (#6301).
2923− OMML in speaker notes would lead to corrupt PowerPoint output. We now
2924− output the OMML verbatim as LaTeX in the speaker notes.
2925−
2926− * LaTeX template: Make polyglossia package options list-aware
2927− (#6444, Frederik Elwert).
2928−
2929− * Reveal.js template:
2930−
2931− + Update template for reveal.js 4.0.0 (#6390, Salim B).
2932− + Update template with newly available options (#6347, Jake Zimmerman).
2933− + Use CDN version of revealjs v4 by default (#6408).
2934−
2935− * opendocument template: Add abstract and subtitle to opendocument
2936− template (#6369).
2937−
2938− * reference.odt: clean up styles. Add Abstract.
2939− Change Author, Date to centered paragraphs with no character
2940− styling.
2941−
2942− * epub.css: wrap overlong lines in highlighted code blocks (#6242).
2943− This fixes a problem in iBooks v2.4 with our earlier
2944− horizontally scrolling code blocks. The problem seems to
2945− be a bug in iBooks, not pandoc, but since iBooks is a major
2946− target we're changing pandoc's default behavior so that
2947− pandoc-produced epubs work on that platform.
2948−
2949− * Text.Pandoc.PDF:
2950−
2951− + Use `--enable-local-file-access` in invoking `wkhtmltopdf` (#6474).
2952− `wkhtmltopdf` changed in recent versions to require this for
2953− access to local files. This fixes PDF via HTML5 with `--css`.
2954− + Send verbose output to stderr, not stdout (#6483).
2955−
2956− * Text.Pandoc.MIME: Fix MIME type for TrueType fonts in EPUBs
2957− (#6464, Michael Reed).
2958−
2959− * Text.Pandoc.Shared:
2960−
2961− + `makeSections`: omit number attribute when unnumbered class
2962− is present (#6339). Previously the attribute was included but given
2963− an empty value, and this caused the table of contents creation
2964− functions in Text.Pandoc.Writers.Shared to think these items had
2965− numbers, which meant that they were included in the TOC even if the
2966− `unlisted` class was used.
2967− + Deprecate `underlineSpan` in Shared in favor of
2968− `Text.Pandoc.Builder.underline` (Vaibhav Sagar).
2969− + `renderTags'`: use self-closing tag for col element (#6295).
2970−
2971− * Text.Pandoc.UUID: Fix `getRandomUUID`, which previously would
2972− return the same value twice in a row. Make `getRandomUUID`
2973− polymorphic in PandocMonad. Remove `getUUID` (#6228, Joseph C. Sible).
2974−
2975− * Text.Pandoc.Class: Generalize `PandocIO` functions to `MonadIO`.
2976−
2977− * Fixed Katex standalone script (#6399, Lucas Escot).
2978− Global macros are now persistent when using the HTML Writer with the
2979− `--katex` option.
2980−
2981− * Lua subsystem (Albert Krewinkel):
2982−
2983− + Use new type PandocLua for all pandoc Lua operations (API change).
2984− The new type `PandocLua` is an instance of the `PandocMonad` typeclass
2985− and can thus be used in a way similar to `PandocIO`.
2986− + Use PandocError for exceptions in Lua subsystem (API change).
2987− The PandocError type is used throughout the Lua subsystem. All Lua
2988− functions throw an exception of this type if an error occurs. The
2989− `LuaException` type is removed and no longer exported from
2990− `Text.Pandoc.Lua`. In its place, a new constructor `PandocLuaError`
2991− is added to PandocError.
2992−
2993− * Lua filters: improve error messages for failing filters (#6332,
2994− Albert Krewinkel). Print the Lua error properly instead of
2995− displaying their `show` string.
2996−
2997− * Use latest skylighting. This fixes a bug with lua multiline
2998− comments (and may improve handling of other syntaxes as well).
2999− IT also adds `aria-hidden="true"` to the empty a elements, which
3000− helps people who use screen readers.
3001−
3002− * Use latest texmath.
3003−
3004− * Require latest doctemplates 0.8.2.
3005− This adds support for template pipes `first`, `rest`,
3006− `last`, `allbutlast`.
3007−
3008− * Revert 0e48a02 and dependency on base-noprelude, which hasn't
3009− been updated for ghc 8.10 (see #6187).
3010−
3011− * Dependency adjustments:
3012−
3013− + Allow haddock-library 1.9.x.
3014− + Allow hslua 1.1 (#6243, Felix Yan).
3015− + Allow base64-bytestring 1.1.
3016− + Use latest jira-wiki-markup.
3017− + Allow http-client 0.7.
3018− + Allow tasty 1.3.x.
3019− + Allow aeson 1.5 (#6400, Felix Yan).
3020− + Remove unused dependency `vector` (#6462, Laurent P. René de Cotret).
3021− + Bump QuickCheck upper bound.
3022−
3023− * Significant code cleanup and simplification (Joseph C. Sible, #6223,
3024− #6209, #6225, #6229, #6226, #6340).
3025−
3026− * Remove unnecessary hlint ignores (#6341, Joseph C. Sible).
3027−
3028− * Remove obsolete RelaxedPolyRec extension (#6487, Nikolay Yakimov).
3029−
3030− * trypandoc improvements (Mike Tzou):
3031−
3032− + Add standalone option to the command text (#6210).
3033− + Update third party libraries.
3034−
3035− * MANUAL.txt:
3036−
3037− + Clarify template partial naming (#6476, Mauro Bieg).
3038− + Describe `jira` as "Jira/Confluence wiki markup" (#6351, Albert
3039− Krewinkel). In the past, Jira's wiki markup was also used by -- and
3040− could be imported into -- Atlassian Confluence.
3041− + Add link to print-css.rocks (#6272, Mauro Bieg).
3042− + Clarify pipe table column width adjustment (#6254).
3043− + Fix ATX header syntax.
3044− + Fix misleading note about image size conversions (#6353).
3045− + Update links to reveal.js documentation (#6386, Salim B).
3046− + Separate adjacent verbatim code blocks (#6307, tom-audm).
3047−
3048− * org.md:
3049−
3050− + Document behavior of `smart` extension (#4387, Albert Krewinkel).
3051− + Describe all supported export options in detail.
3052−
3053− * lua-filters.md:
3054−
3055− + Fix description of BulletList Lua type (Levi Gruspe).
3056− + Use pandoc.system module in TikZ example (Albert
3057− Krewinkel). Showcase temporary directory handling with
3058− `with_temporary_directory` and `with_working_directory`.
3059−
3060− * INSTALL.md: fix FreeBSD port link (#6422, Mo).
3061− The FreeBSD port was renamed from pandoc to hs-pandoc in 2010.
3062− The old pandoc port is still at version 1.5.1.1
3063−
3064− * Propagate `(DY)LD_LIBRARY_PATH` in tests (#6376, Lila).
3065−
3066− * Bump `cabal-version` to 2.2 (#6377).
3067−
3068− * Make it possible to compile using Stack on NixOS (#6439, Mathieu
3069− Boespflug).
3070−
3071− * CI action to check for commit message length (Nikolay Yakimov, #6398).
3072−
3073−
3074## pandoc 2.9.2.1 (2020-03-23)
3## pandoc 2.9.2.1 (2020-03-23)
3075
4
3076 * Markdown reader: Fix table alignment when heading begins with t (#6153).
5 * Markdown reader: Fix table alignment when heading begins with t (#6153).
@@ -3635,7 +564,7 @@
3635 The main impact of this change is better reflowing of
564 The main impact of this change is better reflowing of
3636 content interpolated into templates. Previously,
565 content interpolated into templates. Previously,
3637 interpolated variables were rendered independently and
566 interpolated variables were rendered independently and
3638− interpolated as strings, which could lead to overly long
567+ intepolated as strings, which could lead to overly long
3639 lines. Now the templates interpolated as Doc values which
568 lines. Now the templates interpolated as Doc values which
3640 may include breaking spaces, and reflowing occurs after
569 may include breaking spaces, and reflowing occurs after
3641 template interpolation rather than before.
570 template interpolation rather than before.
@@ -4114,7 +1043,7 @@
4114 a margin and font size according to their level.
1043 a margin and font size according to their level.
4115 Furthermore this commit allows changing the font with which code is
1044 Furthermore this commit allows changing the font with which code is
4116 formatted via the `monofont` option.
1045 formatted via the `monofont` option.
4117− + Start numbering at appropriate numbers (Jesse Rosenthal, #5709).
1046+ + Start numbering at appopriate numbers (Jesse Rosenthal, #5709).
4118 Starting numbers for ordered lists were previously ignored. Now
1047 Starting numbers for ordered lists were previously ignored. Now
4119 we specify the number if it is something other than 1.
1048 we specify the number if it is something other than 1.
4120
1049
@@ -5433,7 +2362,7 @@
5433 * Man/Ms writers: Don't escape `-` as `\-`. The `\-` gets rendered
2362 * Man/Ms writers: Don't escape `-` as `\-`. The `\-` gets rendered
5434 in HTML and PDF as a unicode minus sign.
2363 in HTML and PDF as a unicode minus sign.
5435
2364
5436− * Ms writer: Ensure we have a newline after .EN in display math (#5251).
2365+ * Ms writer: Ensure we have a newline after .EN in disply math (#5251).
5437
2366
5438 * RST writer: Don't wrap simple table header lines (#5128).
2367 * RST writer: Don't wrap simple table header lines (#5128).
5439
2368
@@ -5565,7 +2494,7 @@
5565 + Set default listings language for lua, assembler (#5227, John
2494 + Set default listings language for lua, assembler (#5227, John
5566 MacFarlane). Otherwise we get an error when trying to compile code
2495 MacFarlane). Otherwise we get an error when trying to compile code
5567 with lua or assembler code. To change the default dialect
2496 with lua or assembler code. To change the default dialect
5568− (currently 5.3 for lua and x86masm for assembler), you can use
2497+ (currenty 5.3 for lua and x86masm for assembler), you can use
5569 `--include-in-header` to inject something like
2498 `--include-in-header` to inject something like
5570 `\lstset{defaultdialect=[5.2]Lua}`.
2499 `\lstset{defaultdialect=[5.2]Lua}`.
5571
2500
@@ -9262,7 +6191,7 @@
9262
6191
9263 * Removed `hard_line_breaks` extension from `markdown_github` (#3594).
6192 * Removed `hard_line_breaks` extension from `markdown_github` (#3594).
9264 GitHub has two Markdown modes, one for long-form documents like READMEs
6193 GitHub has two Markdown modes, one for long-form documents like READMEs
9265− and one for short things like issue comments. In issue comments, a line
6194+ and one for short things like issue coments. In issue comments, a line
9266 break is treated as a hard line break. In README, wikis, etc., it is
6195 break is treated as a hard line break. In README, wikis, etc., it is
9267 treated as a space as in regular Markdown. Since pandoc is more likely to
6196 treated as a space as in regular Markdown. Since pandoc is more likely to
9268 be used to convert long-form documents from GitHub Markdown,
6197 be used to convert long-form documents from GitHub Markdown,
@@ -9615,7 +6544,7 @@
9615 top-level `Text.Pandoc` module.
6544 top-level `Text.Pandoc` module.
9616
6545
9617 + Changed `StringWriter` -> `TextWriter`.
6546 + Changed `StringWriter` -> `TextWriter`.
9618− + `getWriter` now returns a pair of a reader and
6547+ + `getWriter` now retuns a pair of a reader and
9619 `Extensions`, instead of building the extensions into the
6548 `Extensions`, instead of building the extensions into the
9620 reader (#3659). The calling code must explicitly set
6549 reader (#3659). The calling code must explicitly set
9621 `readerExtensions` using the `Extensions` returned. The
6550 `readerExtensions` using the `Extensions` returned. The
@@ -10567,7 +7496,7 @@
10567 + Use `unicode-math` (Vaclav Haisman). Use `mathspec` with only
7496 + Use `unicode-math` (Vaclav Haisman). Use `mathspec` with only
10568 XeLaTeX on request.
7497 XeLaTeX on request.
10569 + Don't load `fontspec` before `unicode-math` (over there).
7498 + Don't load `fontspec` before `unicode-math` (over there).
10570− The `unicode-math` package loads `fontspec` so explicit loading of
7499+ The `unicode-math` package loads `fontspec` so explict loading of
10571 `fontspec` before `unicode-math` is not necessary.
7500 `fontspec` before `unicode-math` is not necessary.
10572 + Use `unicode-math` by default in default.latex template. mathspec will
7501 + Use `unicode-math` by default in default.latex template. mathspec will
10573 be used in xelatex if the `mathspec` variable is set; otherwise
7502 be used in xelatex if the `mathspec` variable is set; otherwise
@@ -11248,7 +8177,7 @@
11248 is now used in parsing RST and Markdown line blocks, DocBook
8177 is now used in parsing RST and Markdown line blocks, DocBook
11249 `linegroup`/`line` combinations, and Org-mode `VERSE` blocks.
8178 `linegroup`/`line` combinations, and Org-mode `VERSE` blocks.
11250 Previously `Para` blocks with hard linebreaks were used. `LineBlock`s
8179 Previously `Para` blocks with hard linebreaks were used. `LineBlock`s
11251− are handled specially in the following output formats: AsciiDoc
8180+ are handled specially in the following ouput formats: AsciiDoc
11252 (as `[verse]` blocks), ConTeXt (`\startlines`/`\endlines`),
8181 (as `[verse]` blocks), ConTeXt (`\startlines`/`\endlines`),
11253 HTML (`div` with a style), Markdown (line blocks if `line_blocks`
8182 HTML (`div` with a style), Markdown (line blocks if `line_blocks`
11254 is enabled), Org-mode (`VERSE` blocks), RST (line blocks). In
8183 is enabled), Org-mode (`VERSE` blocks), RST (line blocks). In
@@ -11395,7 +8324,7 @@
11395 comma-separated list.
8324 comma-separated list.
11396 + Give precedence to later meta lines. The last meta-line of any given
8325 + Give precedence to later meta lines. The last meta-line of any given
11397 type is the significant line. Previously the value of the first line
8326 type is the significant line. Previously the value of the first line
11398− was kept, even if more lines of the same type were encountered.
8327+ was kept, even if more lines of the same type were encounterd.
11399 + Read LaTeX_header as header-includes. LaTeX-specific header commands
8328 + Read LaTeX_header as header-includes. LaTeX-specific header commands
11400 can be defined in `#+LaTeX_header` lines. They are parsed as
8329 can be defined in `#+LaTeX_header` lines. They are parsed as
11401 format-specific inlines to ensure that they will only show up in LaTeX
8330 format-specific inlines to ensure that they will only show up in LaTeX
@@ -11443,7 +8372,7 @@
11443 be able to figure out internal links to a header in a docx if the
8372 be able to figure out internal links to a header in a docx if the
11444 anchor span was empty. We change that to read the inlines out of the
8373 anchor span was empty. We change that to read the inlines out of the
11445 first anchor span in a header.
8374 first anchor span in a header.
11446− + Let headers use existing id. Previously we always generated an id for
8375+ + Let headers use exisiting id. Previously we always generated an id for
11447 headers (since they wouldn't bring one from Docx). Now we let it use an
8376 headers (since they wouldn't bring one from Docx). Now we let it use an
11448 existing one if possible. This should allow us to recurs through anchor
8377 existing one if possible. This should allow us to recurs through anchor
11449 spans.
8378 spans.
@@ -12022,7 +8951,7 @@
12022 character. Empty rows where parsed as alignment rows and dropped from
8951 character. Empty rows where parsed as alignment rows and dropped from
12023 the output.
8952 the output.
12024 + Fix spacing after LaTeX-style symbols.
8953 + Fix spacing after LaTeX-style symbols.
12025− The org-reader was dropping space after unescaped LaTeX-style symbol
8954+ The org-reader was droping space after unescaped LaTeX-style symbol
12026 commands: `\ForAll \Auml` resulted in `∀Ä` but should give `∀ Ä`
8955 commands: `\ForAll \Auml` resulted in `∀Ä` but should give `∀ Ä`
12027 instead. This seems to be because the LaTeX-reader treats the
8956 instead. This seems to be because the LaTeX-reader treats the
12028 command-terminating space as part of the command. Dropping the trailing
8957 command-terminating space as part of the command. Dropping the trailing
@@ -12357,7 +9286,7 @@
12357
9286
12358 * Entity handling fixes: improved handling of entities like
9287 * Entity handling fixes: improved handling of entities like
12359 `&lang;` that require a trailing semicolon. Allow uppercase
9288 `&lang;` that require a trailing semicolon. Allow uppercase
12360− `x` in numerical hexadecimal character references, working
9289+ `x` in numerical hexidecimal character references, working
12361 around a tagsoup bug.
9290 around a tagsoup bug.
12362
9291
12363 * `stack.yaml` - use lts-4.0, but with older aeson to avoid excessive
9292 * `stack.yaml` - use lts-4.0, but with older aeson to avoid excessive
@@ -13842,7 +10771,7 @@
13842 * `Text.Pandoc.Shared`:
10771 * `Text.Pandoc.Shared`:
13843
10772
13844 + Make safeRead safe (#1801, Matthew Pickering).
10773 + Make safeRead safe (#1801, Matthew Pickering).
13845− + Added `mapLeft`, `hush` (Matthew Pickering).
10774+ + Addded `mapLeft`, `hush` (Matthew Pickering).
13846
10775
13847 * `Text.Pandoc.Pretty`:
10776 * `Text.Pandoc.Pretty`:
13848
10777
@@ -13910,7 +10839,7 @@
13910
10839
13911 + Use `text:p` instead of `text:h` for title.
10840 + Use `text:p` instead of `text:h` for title.
13912 Using `text:h` causes problems with numbering. Closes #2059.
10841 Using `text:h` causes problems with numbering. Closes #2059.
13913− Thanks to @nkalvi for diagnosing this.
10842+ Thansk to @nkalvi for diagnosing this.
13914
10843
13915 * reveal.js template:
10844 * reveal.js template:
13916
10845
@@ -14176,7 +11105,7 @@
14176 * RST writer:
11105 * RST writer:
14177
11106
14178 + Ensure blank line after figure.
11107 + Ensure blank line after figure.
14179− + Avoid excess whitespace after last list item (#1777).
11108+ + Avoid exces whitespace after last list item (#1777).
14180 + Wrap line blocks with spaces before continuations (#1656).
11109 + Wrap line blocks with spaces before continuations (#1656).
14181 + Fixed double-rendering of footnotes in RST tables (#1769).
11110 + Fixed double-rendering of footnotes in RST tables (#1769).
14182
11111
@@ -14238,7 +11167,7 @@
14238 + Renumber header and footer relationships to avoid collisions (Jesse
11167 + Renumber header and footer relationships to avoid collisions (Jesse
14239 Rosenthal). We previously took the old relationship names of the
11168 Rosenthal). We previously took the old relationship names of the
14240 headers and footer in secptr. That led to collisions. We now make
11169 headers and footer in secptr. That led to collisions. We now make
14241− a map of available names in the relationships file, and then rename
11170+ a map of availabl names in the relationships file, and then rename
14242 in secptr.
11171 in secptr.
14243
11172
14244 * ConTeXt writer:
11173 * ConTeXt writer:
@@ -14961,7 +11890,7 @@
14961 different versions of the `directory` library.
11890 different versions of the `directory` library.
14962
11891
14963 + Added `Text.Pandoc.Compat.Except` to allow building against
11892 + Added `Text.Pandoc.Compat.Except` to allow building against
14964− different versions of `mtl`.
11893+ different verions of `mtl`.
14965
11894
14966 * Code cleanup in some writers, using Reader monad to avoid
11895 * Code cleanup in some writers, using Reader monad to avoid
14967 passing options parameter around (Matej Kollar).
11896 passing options parameter around (Matej Kollar).
@@ -16600,7 +13529,7 @@
16600 + Include HTML TOC, even in epub2. The TOC is included in `<spine>`,
13529 + Include HTML TOC, even in epub2. The TOC is included in `<spine>`,
16601 but `linear` is set to `no` unless the `--toc` option is specified.
13530 but `linear` is set to `no` unless the `--toc` option is specified.
16602 Include `<guide>` element in OPF. This should allow the TOC to
13531 Include `<guide>` element in OPF. This should allow the TOC to
16603− be usable in Kindles when converted with kindlegen. Closes #773.
13532+ be useable in Kindles when converted with kindlegen. Closes #773.
16604
13533
16605 * `Text.Pandoc.Parsing`: Optimized `oneOfStringsCI`.
13534 * `Text.Pandoc.Parsing`: Optimized `oneOfStringsCI`.
16606 This dramatically reduces the speed penalty that comes from enabling the
13535 This dramatically reduces the speed penalty that comes from enabling the
@@ -17196,7 +14125,7 @@
17196 be a parenthesized emphasized "hello".
14125 be a parenthesized emphasized "hello".
17197 The new list is taken from the PHP source of textile 2.4.
14126 The new list is taken from the PHP source of textile 2.4.
17198 + Fixed autolinks. Previously the textile reader and writer
14127 + Fixed autolinks. Previously the textile reader and writer
17199− incorrectly implemented RST-style autolinks for URLs and email
14128+ incorrectly implented RST-style autolinks for URLs and email
17200 addresses. This has been fixed. Now an autolink is done this way:
14129 addresses. This has been fixed. Now an autolink is done this way:
17201 `"$":http://myurl.com`.
14130 `"$":http://myurl.com`.
17202 + Fixed footnotes bug in textile. This affected notes occurring
14131 + Fixed footnotes bug in textile. This affected notes occurring
@@ -18259,7 +15188,7 @@
18259 Items are no longer installed as root.
15188 Items are no longer installed as root.
18260 Man pages are zipped and given proper permissions.
15189 Man pages are zipped and given proper permissions.
18261
15190
18262− * Modified windows installer generator to use cabal-dev.
15191+ * Modified windows installer generater to use cabal-dev.
18263
15192
18264 * Setup: Making man pages now works with cabal-dev (at least on OSX). In
15193 * Setup: Making man pages now works with cabal-dev (at least on OSX). In
18265 Setup.hs we now invoke 'runghc' in a way that points it to the correct
15194 Setup.hs we now invoke 'runghc' in a way that points it to the correct
citeproc/biblatex-localization/.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/UKenglish.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/USenglish.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/american.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/australian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/austrian.lbx.stringsdeleted−1
@@ -1 +0,0 @@
1−january|J\"anner|J\"an\adddot
citeproc/biblatex-localization/brazil.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/brazilian.lbx.stringsdeleted−233
@@ -1,233 +0,0 @@
1−bibliography|Bibliografia|Bibliografia
2−references|Refer\^encias|Refer\^encias
3−shorthands|Lista de abreviaturas|Abreviaturas
4−editor|editor|ed\adddot
5−editors|editores|ed\adddot
6−compiler|compilador|comp\adddot
7−compilers|compiladores|comp\adddot
8−redactor|redator|red\adddot
9−redactors|redatores|red\adddot
10−reviser|revisor|rev\adddot
11−revisers|revisores|rev\adddot
12−founder|fundador|fund\adddot
13−founders|fundadores|fund\adddot
14−continuator|continuador|cont\adddot
15−continuators|continuadores|cont\adddot
16−collaborator|colaborador|colab\adddot
17−collaborators|colaboradores|colab\adddot
18−translator|tradutor|trad\adddot
19−translators|tradutores|trad\adddot
20−commentator|coment\'ario|coment\adddot
21−commentators|coment\'ario|coment\adddot
22−annotator|notas|notas
23−annotators|notas|notas
24−commentary|coment\'ario|coment\adddot
25−annotations|notas|notas
26−foreword|pref\'acio|pref\adddot
27−afterword|posf\'acio|posf\adddot
28−organizer|organizador|org\adddot
29−organizers|organizadores|org\adddot
30−byauthor|por|por
31−byeditor|editado por|ed\adddotspace por
32−bycompiler|compilado por|comp\adddotspace por
33−byredactor|redigido por|red\adddotspace por
34−byreviser|revisado por|rev\adddotspace por
35−byreviewer|resenhado por|res\adddotspace por
36−byfounder|fundado por|fund\adddotspace por
37−bycontinuator|continuado por|cont\adddotspace por
38−bytranslator|traduzido \lbx@lfromlang\ por|trad\adddot\ \lbx@sfromlang\ por
39−bycommentator|comentado por|coment\adddot\ por
40−byannotator|anotado por|anot\adddot\ por
41−byorganizer|organizado por|org\adddotspace por
42−withcommentator|com coment\'ario de|com coment\adddot\ de
43−withannotator|com notas de|com notas de
44−withforeword|com pref\'acio de|com pref\adddot\ de
45−withafterword|com posf\'acio de|com posf\adddot\ de
46−and|e|e
47−andothers|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
48−andmore|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
49−volume|volume|vol\adddot
50−volumes|volumes|vol\adddot
51−involumes|em|em
52−jourvol|volume|v\adddot
53−jourser|s\'erie|s\'er\adddot
54−book|livro|livro
55−part|parte|parte
56−issue|n\'umero|n\'um\adddot
57−newseries|nova s\'erie|nova s\'er\adddot
58−oldseries|s\'erie antiga|s\'er\adddot\ antiga
59−reprint|reimpress\~ao|reimpr\adddot
60−reprintof|reimpress\~ao de|reimpr\adddotspace de
61−reprintas|reimpresso como|reimpr\adddotspace como
62−reprintfrom|reimpresso de|reimpr\adddotspace de
63−translationas|traduzido como|trad\adddotspace como
64−translationfrom|traduzido do|trad\adddotspace do
65−reviewof|resenha de|res\adddotspace de
66−origpubas|originalmente publicado como|orig\adddotspace pub\adddotspace como
67−origpubin|originalmente publicado em|orig\adddotspace pub\adddotspace em
68−astitle|como|como
69−bypublisher|por|por
70−nodate|sem\space data|s\adddot d\adddot
71−page|p\'agina|p\adddot
72−pages|p\'aginas|pp\adddot
73−column|coluna|col\adddot
74−columns|colunas|col\adddot
75−line|linha|l\adddot
76−lines|linhas|ll\adddot
77−verse|verso|v\adddot
78−verses|versos|vv\adddot
79−paragraph|par\'agrafo|par\adddot
80−paragraphs|par\'agrafos|par\adddot
81−pagetotal|p\'agina|p\adddot
82−pagetotals|p\'aginas|pp\adddot
83−columntotal|coluna|col\adddot
84−columntotals|colunas|col\adddot
85−linetotal|linha|l\adddot
86−linetotals|linhas|ll\adddot
87−versetotal|verso|v\adddot
88−versetotals|versos|vv\adddot
89−paragraphtotal|par\'agrafo|par\adddot
90−paragraphtotals|par\'agrafos|par\adddot
91−in|em|em
92−inseries|em|em
93−ofseries|de|de
94−number|n\'umero|n\adddot
95−chapter|cap\'\i tulo|cap\adddot
96−bathesis|trabalho de conclus\~ao|trab\adddotspace de conc\adddot
97−phdthesis|tese de doutorado|tese de dout\adddot
98−candthesis||
99−resreport|relat\'orio de pesquisa|rel\adddotspace de pesq\adddot
100−techreport|relat\'orio t\'ecnico|rel\adddotspace t\'ecn\adddot
101−software|software|software
102−datacd|CD-ROM|CD-ROM
103−audiocd|CD de \'audio|CD de \'audio
104−version|vers\~ao|vers\~ao
105−urlfrom|dispon\'ivel em|disp\adddotspace em
106−urlseen|acesso em|acesso em
107−submitted|submetido|submetido
108−inpress|no prelo|no prelo
109−prepublished|pr\'e-publicado|pr\'e-publicado
110−citedas|doravante citado como|doravante citado como
111−thiscite|especialmente|esp\adddot
112−seenote|ver nota|ver nota
113−quotedin|apud|apud
114−idem|idem|idem
115−idemsm|idem|idem
116−idemsf|eadem|eadem
117−idemsn|idem|idem
118−idempm|eidem|eidem
119−idempf|eaedem|eaedem
120−idempn|eadem|eadem
121−idempp|eidem|eidem
122−ibidem|ibidem|ibid\adddot
123−opcit|op\adddotspace cit\adddot|op\adddotspace cit\adddot
124−loccit|loc\adddotspace cit\adddot|loc\adddotspace cit\adddot
125−confer|cf\adddot|cf\adddot
126−sequens|sq\adddot|sq\adddot
127−sequentes|sqq\adddot|sqq\adddot
128−passim|passim|passim
129−see|ver|ver
130−seealso|ver tamb\'em|ver tamb\'em
131−backrefpage|ver p\'agina|ver p\adddot
132−backrefpages|ver p\'aginas|ver pp\adddot
133−january|janeiro|jan\adddot
134−february|fevereiro|fev\adddot
135−april|abril|abr\adddot
136−may|maio|mai\adddot
137−june|junho|jun\adddot
138−july|julho|jul\adddot
139−august|agosto|ago\adddot
140−september|setembro|set\adddot
141−october|outubro|out\adddot
142−november|novembro|nov\adddot
143−december|dezembro|dez\adddot
144−langamerican|ingl\^es|ingl\^es
145−langbulgarian|b\'ulgaro|b\'ulgaro
146−langcatalan|catal\~ao|catal\~ao
147−langcroatian|croata|croata
148−langczech|tcheco|tcheco
149−langdanish|dinamarqu\^es|dinamarqu\^es
150−langenglish|ingl\^es|ingl\^es
151−langfinnish|finland\^es|finland\^es
152−langestonian|estoniano|estoniano
153−langfrench|franc\^es|franc\^es
154−langgalician|galego|galego
155−langgerman|alem\~ao|alem\~ao
156−langgreek|grego|grego
157−langhungarian|h\'ungaro|h\'ungaro
158−langitalian|italiano|italiano
159−langjapanese|japon\^es|japon\^es
160−langlatin|latim|latim
161−langlatvian|let\~ao|let\~ao
162−langlithuanian|lituano|lituano
163−langnorwegian|noruegu\^es|noruegu\^es
164−langpolish|polon\^es|polon\^es
165−langrussian|russo|russo
166−langserbian|s\'ervio|s\'ervio
167−langslovak|eslovaco|eslovaco
168−langslovene|esloveno|esloveno
169−langspanish|espanhol|espanhol
170−langswedish|sueco|sueco
171−langturkish|turco|turco
172−langukrainian|ucraniano|ucraniano
173−fromamerican|do ingl\^es|do ingl\^es
174−frombulgarian|do b\'ulgaro|do b\'ulgaro
175−fromcatalan|do catal\~ao|do catal\~ao
176−fromcroatian|do croata|do croata
177−fromczech|do tcheco|do tcheco
178−fromdanish|do dinamarqu\^es|do dinamarqu\^es
179−fromenglish|do ingl\^es|do ingl\^es
180−fromestonian|do estoniano|do estoniano
181−fromfinnish|do finland\^es|do finland\^es
182−fromfrench|do franc\^es|do franc\^es
183−fromgalician|do galego|do galego
184−fromgerman|do alem\~ao|do alem\~ao
185−fromgreek|do grego|do grego
186−fromhungarian|do h\'ungaro|do h\'ungaro
187−fromitalian|do italiano|do italiano
188−fromjapanese|do japon\^es|do japon\^es
189−fromlatin|do latim|do latim
190−fromlatvian|do let\~ao|do let\~ao
191−fromlithuanian|do lituano|do lituano
192−fromnorwegian|do noruegu\^es|do noruegu\^es
193−frompolish|do polon\^es|do polon\^es
194−fromrussian|do russo|do russo
195−fromserbian|do s\'ervio|do s\'ervio
196−fromslovak|do eslovaco|do eslovaco
197−fromslovene|do esloveno|do esloveno
198−fromspanish|do espanhol|do espanhol
199−fromswedish|do sueco|do sueco
200−fromturkish|do turco|do turco
201−fromukrainian|do ucraniano|do ucraniano
202−countryde|Alemanha|DE
203−countryeu|Uni\~ao Europeia|EU
204−countryep|Uni\~ao Europeia|EP
205−countryuk|Reino Unido|GB
206−countryus|Estados Unidos|US
207−patent|patente|pat\adddot
208−patentde|patente alem\~a|pat\adddot\ alem\~a
209−patenteu|patente europeia|pat\adddot\ europeia
210−patentfr|patente francesa|pat\adddot\ francesa
211−patentuk|patente brit\^anica|pat\adddot\ brit\^anica
212−patentus|patente americana|pat\adddot\ americana
213−patreq|pedido de patente|ped\adddot\ de pat\adddot
214−patreqde|pedido de patente alem\~a|ped\adddot\ de pat\adddot\ alem\~a
215−patreqeu|pedido de patente europeia|ped\adddot\ de pat\adddot\ europeia
216−patreqfr|pedido de patente francesa|ped\adddot\ de pat\adddot\ francesa
217−patrequk|pedido de patente brit\^anica|ped\adddot\ de pat\adddot\ brit\^anica
218−patrequs|pedido de patente americana|ped\adddot\ de pat\adddot\ americana
219−file|arquivo|arquivo
220−library|biblioteca|biblioteca
221−abstract|resumo|resumo
222−annotation|notas|notas
223−commonera|Era Comum|EC
224−beforecommonera|antes da Era Comum|AEC
225−annodomini|depois de Cristo|d\adddot C\adddot
226−beforechrist|antes de Cristo|a\adddot C\adddot
227−circa|circa|ca\adddot
228−spring|primavera|primavera
229−summer|ver\~ao|ver\~ao
230−autumn|outono|outono
231−winter|inverno|inverno
232−am|AM|AM
233−pm|PM|PM
citeproc/biblatex-localization/british.lbx.stringsdeleted−3
@@ -1,3 +0,0 @@
1−organizer|organiser|org\adddot
2−organizers|organisers|orgs\adddot
3−byorganizer|organised by|org\adddotspace by
citeproc/biblatex-localization/bulgarian.lbx.stringsdeleted−28
@@ -1,28 +0,0 @@
1−bibliography|Библиография|Библиография
2−references|Литература|Литература
3−shorthands|Списък на съкращенията|Съкращения
4−editor|редактор|ред\adddot
5−editors|редактори|ред\adddot
6−compiler|съставител|съст\adddot
7−compilers|съставители|съст\adddot
8−redactor|редактор|ред\adddot
9−redactors|редактори|ред\adddot
10−reviser|коректор|кор\adddotspace кор\adddot
11−revisers|коректор|кор\adddotspace кор\adddot
12−founder|основател|осн\adddot
13−founders|основатели|осн\adddot
14−continuator|продължител|прод\adddot
15−continuators|продължител|прод\adddot
16−collaborator|участник|участ\adddot
17−collaborators|участници|участ\adddot
18−translator|преводач|прев\adddot
19−translators|преводачи|прев\adddot
20−commentator|коментатор|комент\adddot
21−commentators|коментатори|комент\adddot
22−annotator|бележки|бел\adddot
23−annotators|бележки|бел\adddot
24−commentary|комментар|комент\adddot
25−annotations|бележки|бел\adddot
26−introduction|уводна статия|ув\adddotspace ст\adddot
27−foreword|предговор|предг\adddot
28−afterword|послеслов|послесл\adddot
citeproc/biblatex-localization/canadian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/catalan.lbx.stringsdeleted−158
@@ -1,158 +0,0 @@
1−bibliography|Bibliografia|Bibliografia
2−references|Refer\`encies|Refer\`encies
3−shorthands|Llista d'abreviatures|Abreviatures
4−editor|editor|ed\adddot
5−editors|editors|ed\adddot
6−compiler|compilador|comp\adddot
7−compilers|compiladors|comp\adddot
8−redactor|redactor|red\adddot
9−redactors|redactors|red\adddot
10−reviser|revisor|rev\adddot
11−revisers|revisors|rev\adddot
12−founder|fundador|fund\adddot
13−founders|fundadors|fund\adddot
14−continuator|continuador|cont\adddot
15−continuators|continuadors|cont\adddot
16−collaborator|co\l.laborador|co\l.l\adddot
17−collaborators|co\l.laboradors|co\l.l\adddot
18−translator|traductor|trad\adddot
19−translators|traductors|trad\adddot
20−commentator|comentarista|com\adddot
21−commentators|comentaristes|com\adddot
22−annotator|anotador|anot\adddot
23−annotators|anotadors|anot\adddot
24−commentary|comentari|com\adddot
25−annotations|notes|n\adddot
26−introduction|introducci\'o|intr\adddot
27−foreword|pr\`oleg|pr\`ol\adddot
28−editortr|editor i traductor|ed\adddotspace i trad\adddot
29−editorstr|editors i traductors|ed\adddotspace i trad\adddot
30−editorco|editor i comentarista|ed\adddotspace i com\adddot
31−editorsco|editors i comentaristes|ed\adddotspace i com\adddot
32−editoran|editor i anotador|ed\adddotspace i anot\adddot
33−editorsan|editors i anotadors|ed\adddotspace i anot\adddot
34−organizer|organitzador|org\adddot
35−organizers|organitzadors|org\adddot
36−byorganizer|organitzat per|org\adddotspace per
37−byauthor|per|per
38−byeditor|edici\'o a cura \smartof|ed\adddotspace\smartof
39−bycompiler|compilaci\'o a cura \smartof|comp\adddotspace\smartof
40−byredactor|redacci\'o a cura \smartof|red\adddotspace\smartof
41−byreviser|revisi\'o a cura \smartof|rev\adddotspace\smartof
42−byreviewer|ressenya a cura \smartof|ress\adddotspace\smartof
43−byfounder|fundat per|fund\adddotspace per
44−bycontinuator|continuat per|cont\adddotspace per
45−bycollaborator|amb la co\l.laboraci\'o \smartof|amb la co\l.l\adddotspace\smartof
46−bytranslator|traducci\'o \lbx@fromlang\ a cura \smartof|trad\adddotspace\lbx@fromlang\ \smartof
47−bycommentator|comentari a cura \smartof|com\adddotspace\smartof
48−byannotator|notes a cura \smartof|n\adddotspace\smartof
49−withcommentator|amb un comentari a cura \smartof|amb un com\adddotspace\smartof
50−withannotator|amb notes a cura \smartof|amb n\adddotspace\smartof
51−withintroduction|amb una introducci\'o a cura \smartof|amb una intr\adddotspace\smartof
52−withforeword|amb un pr\`oleg a cura \smartof|amb un pr\`ol\adddotspace\smartof
53−and|i|i
54−andothers|et al\adddot|et al\adddot
55−andmore|i m\'es|i m\'es
56−volume|volum|vol\adddot
57−volumes|volums|vol\adddot
58−involumes|en|en
59−jourvol|volum|vol\adddot
60−jourser|s\`erie|s\`er\adddot
61−book|llibre|llib\adddot
62−part|part|part
63−issue|n\'umero|n\'um\adddot
64−newseries|s\`erie nova|s\`erie nova
65−oldseries|s\`erie antiga|s\`erie ant\adddot
66−edition|edici\'o|ed\adddot
67−reprint|reimpressi\'o|reimpr\adddot
68−reprintof|reimpressi\'o \smartof|reimpr\adddotspace\smartof
69−reprintas|reimpr\`es com|reimpr\adddotspace com
70−reprintfrom|reimpr\`es \smartof|reimpr\adddotspace\smartof
71−reviewof|ressenya \smartof|ress\adddotspace\smartof
72−translationof|traducci\'o \smartof|trad\adddotspace\smartof
73−origpubas|publicat origin\`ariament com|pub\adddotspace orig\adddotspace com
74−origpubin|publicat origin\`ariament el|pub\adddotspace orig\adddotspace el
75−astitle|com|com
76−bypublisher|per|per
77−page|p\`agina|p\`ag\adddot
78−pages|p\`agines|p\`ag\adddot
79−column|columna|col\adddot
80−columns|columnes|cols\adddot
81−nodate|sine data|s\adddotspace d\adddot
82−verse|vers|v\adddot
83−verses|versos|v\adddot
84−section|apartat|\S
85−sections|apartats|\S
86−paragraph|par\`agraf|\P
87−paragraphs|par\`agrafs|\P
88−pagetotal|p\`agina|p\`ag\adddot
89−pagetotals|p\`agines|p\`ag\adddot
90−columntotal|columna|col\adddot
91−columntotals|columnes|col\adddot
92−versetotal|vers|v\adddot
93−versetotals|versos|v\adddot
94−sectiontotal|secci\'o|\S
95−sectiontotals|seccions|\S
96−paragraphtotal|par\`agrafs|\P
97−paragraphtotals|par\`agrafs|\P
98−in|a|a
99−inseries|a|a
100−ofseries|\smartof|\smartof
101−number|n\'umero|n\'um\adddot
102−bathesis|treball final de grau|treb\adddotspace fin\adddotspace de gr\adddot
103−mathesis|treball final de m\`aster|treb\adddotspace fin\adddotspace de m\`ast\adddot
104−phdthesis|tesi doctoral|tesi doct\adddot
105−candthesis|tesi de candidatura|tesi de cand\adddot
106−resreport|informe de recerca|inf\adddotspace de rec\adddot
107−techreport|informe t\`ecnic|inf\adddotspace t\`ec\adddot
108−software|programari|prog\adddot
109−datacd|CD de dades|CD de dades
110−audiocd|CD d'\`audio|CD d'\`audio
111−version|versi\'o|vers\adddot
112−urlfrom|disponible a|disp\adddotspace a
113−urlseen|consultat|cons\adddot
114−inpreparation|en preparaci\'o|en prep\adddot
115−inpress|a impremta|a impr\adddot
116−prepublished|pre-publicat|pre-publicat
117−submitted|enviat a publicar|env\adddotspace a pub\adddot
118−forthcoming|properament|prop\adddot
119−citedas|d'ara endavant citat com|d'ara end\adddotspace cit\adddotspace com
120−thiscite|concretament|concr\adddot
121−seenote|vegeu la nota|v\adddotspace la n\adddot
122−quotedin|citat a|cit\adddotspace a
123−opcit|\`op\adddotspace cit\adddot|\`op\adddotspace cit\adddot
124−loccit|loc\adddotspace cit\adddot|loc\adddotspace cit\adddot
125−confer|cf\adddot|cf\adddot
126−sequens|seq\adddot|seq\adddot
127−sequentes|et seq\adddot|et seq\adddot
128−passim|p\`assim|p\`assim
129−see|vegeu|v\adddot
130−seealso|vegeu tamb\'e|v\adddotspace tamb\'e
131−backrefpage|vegeu la p\`agina|v\adddotspace la p\`ag\adddot
132−backrefpages|vegeu les p\`agines|v\adddotspace les p\`ag\adddot
133−january|gener|gen\adddot
134−february|febrer|febr\adddot
135−april|abril|abr\adddot
136−may|maig|maig
137−june|juny|juny
138−july|juliol|jul\adddot
139−august|agost|ag\adddot
140−september|setembre|set\adddot
141−october|octubre|oct\adddot
142−november|novembre|nov\adddot
143−december|desembre|des\adddot
144−langamerican|angl\`es americ\`a|ang\adddotspace amer\adddot
145−langbrazilian|portugu\`es brasiler|port\adddotspace bras\adddot
146−langbulgarian|b\'ulgar|b\'ulg\adddot
147−langcatalan|catal\`a|cat\adddot
148−langczech|txec|txec
149−langcroatian|croat|croat
150−langdanish|dan\`es|dan\adddot
151−langdutch|neerland\`es|neerl\adddot
152−langenglish|angl\`es|ang\adddot
153−langestonian|estoni\`a|eston\adddot
154−langfinnish|fin\`es|fin\adddot
155−langfrench|franc\`es|fr\adddot
156−langgalician|gallec|gal\adddot
157−langgerman|alemany|al\adddot
158−langgreek|grec|grec
citeproc/biblatex-localization/croatian.lbx.stringsdeleted−214
@@ -1,214 +0,0 @@
1−bibliography|Bibliografija|Bibliografija
2−references|Literatura|Literatura
3−shorthands|Popis kratica|Kratice
4−editor|urednik|ur\adddot
5−editors|urednici|ur\adddot
6−redactor|redaktor|redaktor
7−redactors|redaktori|redaktori
8−reviser|korektor|korektor
9−revisers|korektori|korektori
10−collaborator|suradnik|sur\adddot
11−collaborators|suradnici|sur\adddot
12−translator|prijevod|prev\adddot
13−translators|prijevod|prev\adddot
14−commentator|komentator|komentator
15−commentators|komentatori|komentatori
16−commentary|komentar|komentar
17−introduction|uvod|uvod
18−foreword|predgovor|predgovor
19−afterword|pogovor|pogovor
20−editortr|prijevod i obrada|ur\adddotspace i prev\adddot
21−editorstr|prijevod i obrada|ur\adddotspace i prev\adddot
22−organizer|organizacija|organizacija
23−organizers|organizacija|organizacija
24−byorganizer|organizacija|organizacija
25−byauthor|autor|autor
26−byeditor|obrada|ur\adddot
27−byredactor|redaktura|red\adddot
28−byreviser|korektura|kor\adddot
29−byreviewer|recenzija|recenzija
30−bycontinuator|nastavio|nastavio
31−bycollaborator|u suradnji s|u sur\adddotspace s
32−bycommentator|komentari|komentari
33−withcommentator|komentari|komentari
34−withintroduction|uvod|uvod
35−withforeword|predgovor|predgovor
36−withafterword|pogovor|pogovor
37−and|i|i
38−andothers|i drugi|i dr\adddot
39−andmore|i drugi|i dr\adddot
40−volume|sv\adddot|sv\adddot
41−volumes|sv\adddot|sv\adddot
42−involumes|u|u
43−jourvol|sv\adddot|sv\adddot
44−jourser|serija|serija
45−book|knjiga|knj\adddot
46−part|dio|dio
47−issue|izd\adddot|izd\adddot
48−newseries|nova serija|nova serija
49−oldseries|stara serija|stara serija
50−edition|izdanje|izdanje
51−reprint|pretisak|pretisak
52−reprintof|pretisak|pretisak
53−reprintas|iznova otisnuto kao|iznova otisnuto kao
54−reprintfrom|iznova otisnut|iznova otisnut
55−translationof|prijevod|prijevod
56−translationas|prev\adddotspace kao|prev\adddotspace kao
57−translationfrom|prijevod|prijevod
58−reviewof|osvrt na|osvrt na
59−origpubas|izvorno obj\adddotspace kao|izv\adddotspace obj\adddotspace kao
60−origpubin|izvorno obj\adddot|izv\adddotspace obj\adddot
61−astitle|kao|kao
62−bypublisher||
63−nodate|bez datuma|bez datuma
64−page|stranica|str\adddot
65−pages|stranice|str\adddot
66−column|stupac|stupac
67−columns|stupci|stupci
68−line|linija|l\adddot
69−lines|linije|ll\adddot
70−verse|stih|stih
71−verses|stihovi|stihovi
72−section|odjeljak|\S
73−sections|odjeljci|\S\S
74−paragraph|stavak|st\adddot
75−paragraphs|stavci|st\adddot
76−pagetotal|str\adddot|str\adddot
77−pagetotals|str\adddot|str\adddot
78−columntotal|stupac|stupac
79−columntotals|stupaca|stupaca
80−linetotal|linija|lin\adddot
81−linetotals|linija|lin\adddot
82−versetotal|stih|st\adddot
83−versetotals|stihova|st\adddot
84−sectiontotal|odjeljak|odj\adddot
85−sectiontotals|odjeljaka|odj\adddot
86−paragraphtotal|stavak|st\adddot
87−paragraphtotals|stavaka|st\adddot
88−in||
89−inseries|u seriji|u seriji
90−ofseries|iz serije|iz serije
91−number|broj|br\adddot
92−chapter|poglavlje|pogl\adddot
93−bathesis|diplomski rad|dipl\adddotspace rad
94−mathesis|magistarski rad|mag\adddotspace rad
95−phdthesis|doktorska disertacija|disertacija
96−software|softver|softver
97−datacd|CD-ROM|CD-ROM
98−audiocd|audio CD|audio CD
99−version|verzija|verzija
100−url|adresa|adresa
101−urlfrom|dostupno na|dost\adddotspace na
102−urlseen|pogledano|pogledano
103−inpreparation|u pripremi|u pripremi
104−submitted|predan|predan
105−inpress|u tisku|u tisku
106−prepublished|pred objavom|pred obj\adddot
107−citedas|dalje citirano kao|dalje citirano kao
108−thiscite|napose|napose
109−quotedin|citirano u|citirano u
110−idem|idem|idem
111−idemsm|idem|idem
112−idemsf|eadem|eadem
113−idemsn|idem|idem
114−idempm|eidem|eidem
115−idempf|eaedem|eaedem
116−idempn|eadem|eadem
117−idempp|eidem|eidem
118−ibidem|ibidem|ibid\adddot
119−opcit|op\adddotspace cit\adddot|op\adddotspace cit\adddot
120−loccit|loc\adddotspace cit\adddot|loc\adddotspace cit\adddot
121−confer|usporedi|usp\adddot
122−sequens|sq\adddot|sq\adddot
123−sequentes|sqq\adddot|sqq\adddot
124−passim|passim|pass\adddot
125−see|vidi|v\adddot
126−seealso|pogledaj i|pogl\adddotspace i
127−backrefpage|citirano na stranci|cit\adddotspace na str\adddot
128−backrefpages|cited on pages|cit\adddotspace na str\adddot
129−april|travanj|travanj
130−may|svibanj|svibanj
131−june|lipanj|lipanj
132−july|srpanj|srpanj
133−august|kolovoz|kolovoz
134−september|rujan|rujan
135−october|listopad|listopad
136−november|studeni|studeni
137−december|prosinac|prosinac
138−dateapril|travnja|travnja
139−datemay|svibnja|svibnja
140−datejune|lipnja|lipnja
141−datejuly|srpnja|srpnja
142−dateaugust|kolovoza|kolovoza
143−dateseptember|rujna|rujna
144−dateoctober|listopada|listopada
145−datenovember|studenoga|studenoga
146−datedecember|prosinca|prosinca
147−langamerican|engleski|engleski
148−langbrazilian|portugalski|portugalski
149−langbulgarian|bugarski|bugarski
150−langcatalan|katalonski|katalonski
151−langcroatian|hrvatski|hrvatski
152−langdanish|danski|danski
153−langdutch|nizozemski|nizozemski
154−langenglish|engleski|engleski
155−langestonian|estonski|estonski
156−langfinnish|finski|finski
157−langfrench|francuski|francuski
158−langgalician|galicijski|galicijski
159−langhungarian|ma\dj arski|ma\dj arski
160−langitalian|talijanski|talijanski
161−langjapanese|japanski|japanski
162−langlatin|latinski|latinski
163−langlatvian|letonski|letonski
164−langpolish|poljski|poljski
165−langportuguese|portugalski|portugalski
166−langrussian|ruski|ruski
167−langslovene|slovenski|slovenski
168−langukrainian|ukrajinski|ukrajinski
169−fromamerican|s engleskog|s engleskog
170−frombrazilian|s portugalskog|s portugalskog
171−frombulgarian|s bugarskog|s bugarskog
172−fromcatalan|s katalonskog|s katalonskog
173−fromcroatian|s hrvatskog|s hrvatskog
174−fromdanish|s danskog|s danskog
175−fromdutch|s nizozemskog|s nizozemskog
176−fromenglish|s engleskog|s engleskog
177−fromestonian|s estonskog|s estonskog
178−fromfinnish|s finskog|s finskog
179−fromfrench|s francuskog|s francuskog
180−fromgalician|s galicijskog|s galicijskog
181−fromhungarian|s ma\dj arskog|s ma\dj arskog
182−fromitalian|s talijanskog|s talijanskog
183−fromjapanese|s japanskog|s japanskog
184−fromlatin|s latinskog|s latinskog
185−fromlatvian|s letonskog|s letonskog
186−frompolish|s poljskog|s poljskog
187−fromportuguese|s portugalskog|s portugalskog
188−fromrussian|s ruskog|s ruskog
189−fromslovene|sa slovenskog|sa slovenskog
190−fromukrainian|s ukrajinskog|s ukrajinskog
191−countryeu|Europska unija|EU
192−countryep|Europska unija|EP
193−countryfr|Francuska|FR
194−countryuk|Velika Britanija|GB
195−patent|patent|pat\adddot
196−patenteu|europski patent|europski pat\adddot
197−patentfr|francuski patent|francuski pat\adddot
198−patentuk|britanski patent|britanski pat\adddot
199−patentus|US patent|US pat\adddot
200−patreq|patentni zahtjev|pat\adddot\ zahtjev
201−patreqeu|europski patentni zahtjev|EU pat\adddotspace zahtjev
202−patrequs|US patentni zahtjev|US pat\adddot\ zahtjev
203−file|datoteka|datoteka
204−library|biblioteka|biblioteka
205−commonera|n\adddotspace e\adddot|n\adddotspace e\adddot
206−beforecommonera|pr\adddotspace n\adddotspace e\adddot|pr\adddotspace n\adddotspace e\adddot
207−annodomini|poslije Krista|p\adddotspace Kr\adddot
208−beforechrist|prije Krista|pr\adddotspace Kr\adddot
209−circa|oko|cca\adddot
210−summer|ljeto|ljeto
211−autumn|jesen|jesen
212−winter|zima|zima
213−am|prije podne|AM
214−pm|poslije podne|PM
citeproc/biblatex-localization/czech.lbx.stringsdeleted−91
@@ -1,91 +0,0 @@
1−bibliography|Bibliografie|Bibliografie
2−references|Odkazy|Odkazy
3−shorthands|Seznam zkratek|Zkratky
4−editor|editor|ed\adddot
5−compiler|sestavil|sest\adddot
6−compilers|sestavili|sest\adddot
7−redactor|redaktor|red\adddot
8−reviser|korektor|kor\adddot
9−founder|zakladatel|zakl\adddot
10−annotations|anotace|anot\adddot
11−afterword|doslov|dosl\adddot
12−byauthor||
13−bycompiler|sestaveno|sest\adddot
14−withannotator|s\addnbspace anotacemi od|s\addnbspace anot\adddot\ od
15−withafterword|s\addnbspace doslovem od|s\addnbspace dosl\adddot\ od
16−and|a|a
17−andothers|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
18−andmore|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
19−volume|svazek|sv\adddot
20−volumes|svazky|sv\adddot
21−involumes|in|in
22−book|kniha|kniha
23−reprint|dotisk|dotisk
24−reprintof|dotisk|dotisk
25−reprintas|dotisknuto jako|dotisknuto jako
26−reprintfrom|dotisknuto z\addnbspace|dotisknuto z\addnbspace
27−reviewof|recenze|recenz\adddot
28−astitle|jako|jako
29−bypublisher||
30−page|strana|s\adddot
31−pages|strany|s\adddot
32−column|sloupec|sl\adddot
33−columns|sloupce|sl\adddot
34−section|sekce|\S
35−sections|sekce|\S\S
36−paragraph|odstavec|ods\adddot
37−paragraphs|odstavce|ods\adddot
38−pagetotal|strana|s\adddot
39−pagetotals|strany|s\adddot
40−columntotal|sloupec|sl\adddot
41−columntotals|sloupce|sl\adddot
42−sectiontotal|sekce|\S
43−sectiontotals|sekce|\S\S
44−paragraphtotal|odstavec|ods\adddot
45−paragraphtotals|odstavce|ods\adddot
46−in|in|in
47−inseries|in|in
48−ofseries|z|z
49−chapter|kapitola|kap\adddot
50−datacd|CD-ROM|CD-ROM
51−audiocd|audio CD|audio CD
52−version|verze|ver\adddot
53−url|URL|URL
54−inpress|v\addnbspace tisku|v\addnbspace tisku
55−idem|idem|idem
56−idemsm|idem|idem
57−idemsf|eadem|eadem
58−idemsn|idem|idem
59−idempm|eidem|eidem
60−idempf|eaedem|eaedem
61−idempn|eadem|eadem
62−idempp|eidem|eidem
63−ibidem|ibidem|ibid\adddot
64−opcit|op\adddotspace cit\adddot|op\adddotspace cit\adddot
65−loccit|loc\adddotspace cit\adddot|loc\adddotspace cit\adddot
66−confer|cf\adddot|cf\adddot
67−sequens|sq\adddot|sq\adddot
68−sequentes|sqq\adddot|sqq\adddot
69−passim|passim|pass\adddot
70−see|viz|viz
71−january|leden|led\adddot
72−april|duben|dub\adddot
73−august|srpen|srp\adddot
74−november|listopad|lis\adddot
75−december|prosinec|pros\adddot
76−langlatin|latina|lat\adddot
77−fromlatin|z\addnbspace latiny|z\addnbspace lat\adddot
78−countryfr|Francie|FR
79−patent|patent|pat\adddot
80−patentus|US patent|US pat\adddot
81−file|soubor|soub\adddot
82−library|knihovna|knih\adddot
83−abstract|abstrakt|abst\adddot
84−annotation|anotace|anot\adddot
85−annodomini|po Kristu|po Kr\adddot
86−circa|cirka|ca\adddot
87−spring|jaro|jaro
88−autumn|podzim|podzim
89−winter|zima|zima
90−am|AM|AM
91−pm|PM|PM
citeproc/biblatex-localization/danish.lbx.stringsdeleted−106
@@ -1,106 +0,0 @@
1−bibliography|Bibliografi|Bibliografi
2−references|Litteraturhenvisninger|Litteratur
3−shorthands|Forkortelser|Forkortelser
4−editor|redakt\o r|red\adddot
5−editors|redakt\o rer|red\adddot
6−compiler|kompilator|kompilator
7−compilers|kompilatorer|kompilatorer
8−redactor|medredakt\o r|medred\adddot
9−redactors|medredakt\o rer|medred\adddot
10−reviser|revision|rev\adddot
11−revisers|revision|rev\adddot
12−founder|stifter|stifter
13−founders|stiftere|stiftere
14−continuator|videref\o rer|videref\adddot
15−continuators|videref\o rere|videref\adddot
16−collaborator|medarbejder|medarb\adddot
17−collaborators|medarbejdere|medarb\adddot
18−translator|overs\ae tter|overs\adddot
19−translators|overs\ae ttere|overs\adddot
20−commentator|kommentator|komm\adddot
21−commentators|kommentatorer|komm\adddot
22−annotator|kommentator|komm\adddot
23−annotators|kommentatorer|komm\adddot
24−commentary|kommentar|komm\adddot
25−annotations|annoteringer|ann\adddot
26−introduction|indledning|indl\adddot
27−foreword|forord|forord
28−afterword|efterord|efterord
29−organizer|organisator|org\adddot
30−organizers|organisatorer|org\adddot
31−byorganizer|organiseret af|org\adddotspace av
32−byauthor|af|af
33−byeditor|redigeret af|red\adddotspace af
34−bycompiler|kompileret af|komp\adddotspace af
35−byredactor|bearbejdet af|bearb\adddotspace af
36−byreviser|revideret af|rev\adddotspace af
37−byreviewer|bed\o mt af|bed\adddotspace af
38−byfounder|stiftet af|stiftet af
39−bycontinuator|videref\o rt af|videref\adddotspace af
40−bycollaborator|i samarbejde med|i samarb\adddotspace m\adddot
41−bycommentator|kommenteret af|komm\adddot\ af
42−byannotator|annoteret af|ann\adddot\ af
43−withcommentator|med kommentarer af|m\adddotspace komm\adddot\ af
44−withannotator|med annoteringer af|m\adddotspace ann\adddot\ af
45−withintroduction|med indledning af|m\adddotspace indl\adddot\ af
46−withforeword|med forord af|m\adddotspace forord af
47−withafterword|med efterord af|m\adddotspace efterord af
48−and|og|og
49−andothers|med flere|m.fl\adddot
50−andmore|med mere|m.m\adddot
51−volume|bind|bd\adddot
52−volumes|bind|bd\adddot
53−involumes|i|i
54−jourvol|\aa rgang|\aa rg\adddot
55−jourser|r\ae kke|rk\adddot
56−book|bog|bog
57−part|del|del
58−issue|nummer|nr\adddot
59−newseries|ny r\ae kke|ny rk\adddot
60−oldseries|gammel r\ae kke|gl. rk\adddot
61−edition|udgave|udg\adddot
62−reprint|genoptryk|genoptr\adddot
63−reprintof|genoptryk af|genoptr\adddot\ af
64−reprintas|genoptryk under titlen|genoptr\adddot\ under titlen
65−reprintfrom|genoptryk fra|genoptr\adddot\ fra
66−translationof|overs\ae ttelse af|overs\adddot\ af
67−translationas|oversat under titlen|overs\adddotspace\ under titlen
68−translationfrom|oversat fra|overs\adddotspace\ fra
69−reviewof|bed\o mmelse af|bed\adddotspace af
70−origpubas|oprindeligt udgivet som|opr\adddot\ udg\adddot\ som
71−origpubin|oprindeligt udgivet i|opr\adddot\ udg\adddot\ i
72−astitle|under titlen|under titlen
73−bypublisher|af|af
74−nodate|uden \aa rstal|u.\aa\adddot
75−page|side|s\adddot
76−pages|sider|s\adddot
77−column|spalte|sp\adddot
78−columns|spalter|sp\adddot
79−line|linje|l\adddot
80−lines|linjer|l\adddot
81−verse|vers|v\adddot
82−verses|vers|v\adddot
83−section|paragraf|par\adddot
84−sections|paragraffer|par\adddot
85−paragraph|afsnit|afsn\adddot
86−paragraphs|afsnit|afsn\adddot
87−pagetotal|side|s\adddot
88−pagetotals|sider|s\adddot
89−columntotal|spalte|sp\adddot
90−columntotals|spalter|sp\adddot
91−line|linje|l\adddot
92−lines|linjer|l\adddot
93−verse|vers|v\adddot
94−verses|vers|v\adddot
95−linetotal|linje|l\adddot
96−linetotals|linje|l\adddot
97−versetotal|vers|v\adddot
98−versetotals|vers|v\adddot
99−sectiontotal|paragraf|par\adddot
100−sectiontotals|paragraffer|par\adddot
101−paragraphtotal|afsnit|afsn\adddot
102−paragraphtotals|afsnit|afsn\adddot
103−in|i|i
104−inseries|i r\ae kken|i rk\adddot
105−ofseries|fra r\ae kken|fra rk\adddot
106−number|nummer|nr\adddot
citeproc/biblatex-localization/dutch.lbx.stringsdeleted−23
@@ -1,23 +0,0 @@
1−bibliography|Bibliografie|Bibliografie
2−references|Referenties|Referenties
3−shorthands|Lijst van afkortingen|Afkortingen
4−editor|redacteur|red\adddot
5−editors|redacteurs|red\adddot
6−compiler|samensteller|samenst\adddot
7−compilers|samenstellers|samenst\adddot
8−founder|oprichter|opr\adddot
9−founders|oprichters|opr\adddot
10−continuator|opvolger|opv\adddot
11−continuators|opvolgers|opv\adddot
12−redactor|redacteur|red\adddot
13−redactors|redacteuren|red\adddot
14−reviser|revisor|rev\adddot
15−revisers|revisors|rev\adddot
16−collaborator|medewerker|med\adddot
17−collaborators|medewerkers|med\adddot
18−translator|vertaler|vert\adddot
19−translators|vertalers|vert\adddot
20−commentator|commentator|comm\adddot
21−commentators|commentatoren|comm\adddot
22−annotator|annotator|annot\adddot
23−annotators|annotatoren|annot\adddot
citeproc/biblatex-localization/english.lbx.stringsdeleted−254
@@ -1,254 +0,0 @@
1−bibliography|Bibliography|Bibliography
2−references|References|References
3−shorthands|List of Abbreviations|Abbreviations
4−editor|editor|ed\adddot
5−editors|editors|eds\adddot
6−compiler|compiler|comp\adddot
7−compilers|compilers|comp\adddot
8−redactor|redactor|red\adddot
9−redactors|redactors|red\adddot
10−reviser|reviser|rev\adddot
11−revisers|revisers|rev\adddot
12−founder|founder|found\adddot
13−founders|founders|found\adddot
14−continuator|continued|cont\adddot
15−continuators|continued|cont\adddot
16−collaborator|collaborator|collab\adddot
17−collaborators|collaborators|collab\adddot
18−translator|translator|trans\adddot
19−translators|translators|trans\adddot
20−commentator|commentator|comm\adddot
21−commentators|commentators|comm\adddot
22−annotator|annotator|annot\adddot
23−annotators|annotators|annot\adddot
24−commentary|commentary|comm\adddot
25−annotations|annotations|annot\adddot
26−introduction|introduction|intro\adddot
27−foreword|foreword|forew\adddot
28−afterword|afterword|afterw\adddot
29−organizer|organizer|org\adddot
30−organizers|organizers|orgs\adddot
31−byorganizer|organized by|org\adddotspace by
32−byauthor|by|by
33−byeditor|edited by|ed\adddotspace by
34−bycompiler|compiled by|comp\adddotspace by
35−byredactor|redacted by|red\adddotspace by
36−byreviser|revised by|rev\adddotspace by
37−byreviewer|reviewed by|rev\adddotspace by
38−byfounder|founded by|found\adddotspace by
39−bycontinuator|continued by|cont\adddotspace by
40−bycollaborator|in collaboration with|in collab\adddotspace with
41−bytranslator|translated \lbx@lfromlang\ by|trans\adddot\ \lbx@sfromlang\ by
42−bycommentator|commented by|comm\adddot\ by
43−byannotator|annotated by|annot\adddot\ by
44−withcommentator|with a commentary by|with a comment\adddot\ by
45−withannotator|with annotations by|with annots\adddot\ by
46−withintroduction|with an introduction by|with an intro\adddot\ by
47−withforeword|with a foreword by|with a forew\adddot\ by
48−withafterword|with an afterword by|with an afterw\adddot\ by
49−and|and|and
50−andothers|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
51−andmore|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
52−volume|volume|vol\adddot
53−volumes|volumes|vols\adddot
54−involumes|in|in
55−jourvol|volume|vol\adddot
56−jourser|series|ser\adddot
57−book|book|book
58−part|part|part
59−issue|issue|issue
60−newseries|new series|new ser\adddot
61−oldseries|old series|old ser\adddot
62−edition|edition|ed\adddot
63−reprint|reprint|repr\adddot
64−reprintof|reprint of|repr\adddotspace of
65−reprintas|reprinted as|rpt\adddotspace as
66−reprintfrom|reprinted from|repr\adddotspace from
67−reviewof|review of|rev\adddotspace of
68−translationof|translation of|trans\adddotspace of
69−translationas|translated as|trans\adddotspace as
70−translationfrom|translated from|trans\adddotspace from
71−origpubas|originally published as|orig\adddotspace pub\adddotspace as
72−origpubin|originally published in|orig\adddotspace pub\adddotspace in
73−astitle|as|as
74−bypublisher|by|by
75−nodate|no date|n\adddot d\adddot
76−page|page|p\adddot
77−pages|pages|pp\adddot
78−column|column|col\adddot
79−columns|columns|cols\adddot
80−line|line|l\adddot
81−lines|lines|ll\adddot
82−verse|verse|v\adddot
83−verses|verses|vv\adddot
84−section|section|\S
85−sections|sections|\S\S
86−paragraph|paragraph|par\adddot
87−paragraphs|paragraphs|par\adddot
88−pagetotal|page|p\adddot
89−pagetotals|pages|pp\adddot
90−columntotal|column|col\adddot
91−columntotals|columns|cols\adddot
92−linetotal|line|l\adddot
93−linetotals|lines|ll\adddot
94−versetotal|verse|v\adddot
95−versetotals|verses|vv\adddot
96−sectiontotal|section|\S
97−sectiontotals|sections|\S\S
98−paragraphtotal|paragraph|par\adddot
99−paragraphtotals|paragraphs|par\adddot
100−in|in|in
101−inseries|in|in
102−ofseries|of|of
103−number|number|no\adddot
104−chapter|chapter|chap\adddot
105−bathesis|Bachelor's thesis|BA\addabbrvspace thesis
106−mathesis|Master's thesis|MA\addabbrvspace thesis
107−phdthesis|PhD\addabbrvspace thesis|PhD\addabbrvspace thesis
108−candthesis|Candidate thesis|Cand\adddotspace thesis
109−resreport|research report|research rep\adddot
110−techreport|technical report|tech\adddotspace rep\adddot
111−software|computer software|comp\adddotspace software
112−datacd|CD-ROM|CD-ROM
113−audiocd|audio CD|audio CD
114−version|version|version
115−url|address|address
116−urlfrom|available from|available from
117−urlseen|visited on|visited on
118−inpreparation|in preparation|in preparation
119−submitted|submitted|submitted
120−forthcoming|forthcoming|forthcoming
121−inpress|in press|in press
122−prepublished|pre-published|pre-published
123−citedas|henceforth cited as|henceforth cited as
124−thiscite|especially|esp\adddot
125−seenote|see note|see n\adddot
126−quotedin|quoted in|qtd\adddotspace in
127−idem|idem|idem
128−idemsm|idem|idem
129−idemsf|eadem|eadem
130−idemsn|idem|idem
131−idempm|eidem|eidem
132−idempf|eaedem|eaedem
133−idempn|eadem|eadem
134−idempp|eidem|eidem
135−ibidem|ibidem|ibid\adddot
136−opcit|op\adddotspace cit\adddot|op\adddotspace cit\adddot
137−loccit|loc\adddotspace cit\adddot|loc\adddotspace cit\adddot
138−confer|cf\adddot|cf\adddot
139−sequens|sq\adddot|sq\adddot
140−sequentes|sqq\adddot|sqq\adddot
141−passim|passim|pass\adddot
142−see|see|see
143−seealso|see also|see also
144−backrefpage|cited on page|cit\adddotspace on p\adddot
145−backrefpages|cited on pages|cit\adddotspace on pp\adddot
146−january|January|Jan\adddot
147−february|February|Feb\adddot
148−march|March|Mar\adddot
149−april|April|Apr\adddot
150−may|May|May
151−june|June|June
152−july|July|July
153−august|August|Aug\adddot
154−september|September|Sept\adddot
155−october|October|Oct\adddot
156−november|November|Nov\adddot
157−december|December|Dec\adddot
158−langamerican|American|American
159−langbrazilian|Brazilian|Brazilian
160−langbulgarian|Bulgarian|Bulgarian
161−langcatalan|Catalan|Catalan
162−langcroatian|Croatian|Croatian
163−langczech|Czech|Czech
164−langdanish|Danish|Danish
165−langdutch|Dutch|Dutch
166−langenglish|English|English
167−langestonian|Estonian|Estonian
168−langfinnish|Finnish|Finnish
169−langfrench|French|French
170−langgalician|Galician|Galician
171−langgerman|German|German
172−langgreek|Greek|Greek
173−langhungarian|Hungarian|Hungarian
174−langitalian|Italian|Italian
175−langjapanese|Japanese|Japanese
176−langlatin|Latin|Latin
177−langlatvian|Latvian|Latvian
178−langlithuanian|Lithuanian|Lithuanian
179−langnorwegian|Norwegian|Norwegian
180−langpolish|Polish|Polish
181−langportuguese|Portuguese|Portuguese
182−langrussian|Russian|Russian
183−langserbian|Serbian|Serbian
184−langslovak|Slovak|Slovak
185−langslovene|Slovene|Slovene
186−langspanish|Spanish|Spanish
187−langswedish|Swedish|Swedish
188−langturkish|Turkish|Turkish
189−langukrainian|Ukrainian|Ukrainian
190−fromamerican|from the American|from the American
191−frombrazilian|from the Brazilian|from the Brazilian
192−frombulgarian|from the Bulgarian|from the Bulgarian
193−fromcatalan|from the Catalan|from the Catalan
194−fromcroatian|from the Croatian|from the Croatian
195−fromczech|from the Czech|from the Czech
196−fromdanish|from the Danish|from the Danish
197−fromdutch|from the Dutch|from the Dutch
198−fromenglish|from the English|from the English
199−fromestonian|from the Estonian|from the Estonian
200−fromfinnish|from the Finnish|from the Finnish
201−fromfrench|from the French|from the French
202−fromgalician|from the Galician|from the Galician
203−fromgerman|from the German|from the German
204−fromgreek|from the Greek|from the Greek
205−fromhungarian|from the Hungarian|from the Hungarian
206−fromitalian|from the Italian|from the Italian
207−fromjapanese|from the Japanese|from the Japanese
208−fromlatin|from the Latin|from the Latin
209−fromlatvian|from the Latvian|from the Latvian
210−fromlithuanian|from the Lithuanian|from the Lithuanian
211−fromnorwegian|from the Norwegian|from the Norwegian
212−frompolish|from the Polish|from the Polish
213−fromportuguese|from the Portuguese|from the Portuguese
214−fromrussian|from the Russian|from the Russian
215−fromserbian|from the Serbian|from the Serbian
216−fromslovak|from the Slovak|from the Slovak
217−fromslovene|from the Slovene|from the Slovene
218−fromspanish|from the Spanish|from the Spanish
219−fromswedish|from the Swedish|from the Swedish
220−fromturkish|from the Turkish|from the Turkish
221−fromukrainian|from the Ukrainian|from the Ukrainian
222−countryde|Germany|DE
223−countryeu|European Union|EU
224−countryep|European Union|EP
225−countryfr|France|FR
226−countryuk|United Kingdom|GB
227−countryus|United States of America|US
228−patent|patent|pat\adddot
229−patentde|German patent|German pat\adddot
230−patenteu|European patent|European pat\adddot
231−patentfr|French patent|French pat\adddot
232−patentuk|British patent|British pat\adddot
233−patentus|U.S\adddotspace patent|U.S\adddotspace pat\adddot
234−patreq|patent request|pat\adddot\ req\adddot
235−patreqde|German patent request|German pat\adddot\ req\adddot
236−patreqeu|European patent request|European pat\adddot\ req\adddot
237−patreqfr|French patent request|French pat\adddot\ req\adddot
238−patrequk|British patent request|British pat\adddot\ req\adddot
239−patrequs|U.S\adddotspace patent request|U.S\adddotspace pat\adddot\ req\adddot
240−file|file|file
241−library|library|library
242−abstract|abstract|abstract
243−annotation|annotations|annotations
244−commonera|Common Era|CE
245−beforecommonera|Before Common Era|BCE
246−annodomini|Anno Domini|AD
247−beforechrist|Before Christ|BC
248−circa|circa|ca\adddot
249−spring|Spring|Spr\adddot
250−summer|Summer|Sum\adddot
251−autumn|Autumn|Aut\adddot
252−winter|Winter|Win\adddot
253−am|AM|AM
254−pm|PM|PM
citeproc/biblatex-localization/estonian.lbx.stringsdeleted−178
@@ -1,178 +0,0 @@
1−bibliography|bibliograafia|bibliograafia
2−references|viited|viited
3−editor|toimetaja|toim\adddot
4−editors|toimetajad|toim\adddot
5−compiler|koostaja|koost\adddot
6−compilers|koostajad|koost\adddot
7−redactor|toimetaja|toim\adddot
8−redactors|toimetajad|toim\adddot
9−reviser|toimetaja|toim\adddot
10−revisers|toimetajad|toim\adddot
11−founder|asutaja|asutaja
12−founders|asutajad|asutajad
13−commentator|kommenteerija|kommenteerija
14−commentators|kommenteerijad|kommenteerijad
15−annotator|kommenteerija|kommenteerija
16−annotators|kommenteerijad|kommenteerijad
17−commentary|kommentaarid|kommentaarid
18−annotations|kommentaarid|kommentaarid
19−introduction|sissejuhatus|sissejuhatus
20−organizer|korraldaja|korraldaja
21−organizers|korraldajad|korraldajad
22−byorganizer|korraldanud|korraldanud
23−byauthor|kirjutanud|kirj\adddot
24−byeditor|toimetanud|toim\adddot
25−bycompiler|koostanud|koost\adddot
26−byredactor|toimetanud|toim\adddot
27−byreviewer|vaadanud|vaadanud
28−byfounder|asutanud|asutanud
29−bycommentator|kommenteerinud|kommenteerinud
30−byannotator|kommenteerinud|kommenteerinud
31−withcommentator|koos kommentaaridega|koos kommentaaridega
32−withannotator|koos kommentaaridega|koos kommentaaridega
33−withintroduction|koos tutvustusega|koos tutvustusega
34−and|ja|ja
35−involumes|osas|osas
36−jourser|seeria|seeria
37−book|raamat|raamat
38−part|osa|osa
39−issue|number|nr\adddot
40−newseries|uus seerias|uus seer\adddot
41−oldseries|vana seeria|vana seer\adddot
42−reviewof|arvustus teosest|arvustus teosest
43−origpubas|algselt avaldatud kui|algselt avaldatud kui
44−origpubin|algselt avaldatud aastal|algselt avaldatud aastal
45−astitle|pealkirjaga|pealkirjaga
46−column|veerg|veerg
47−columns|veerud|veerud
48−line|rida|rida
49−lines|read|read
50−verse|salm|salm
51−verses|salmid|salmid
52−section|jagu|jagu
53−sections|jaod|jaod
54−columntotal|veerge kokku|veerge kokku
55−columntotals|veergusid kokku|veergusid kokku
56−linetotal|ridu kokku|ridu kokku
57−linetotals|ridasid kokku|ridasid kokku
58−versetotal|salmi kokku|salmi kokku
59−versetotals|salmesid kokku|salmesid kokku
60−sectiontotal|jagusid kokku|jagusid kokku
61−sectiontotals|jagusid kokku|jagusid kokku
62−in|teoses|teoses
63−inseries|sarjas|sarjas
64−ofseries|sarjast|sarjast
65−number|number|nr
66−resreport|uuringuraport|uuringuraport
67−techreport|tehniline raport|tehniline raport
68−software|tarkvara|tarkvara
69−datacd|CD-ROM|CD-ROM
70−audiocd|audioplaat|audioplaat
71−version|versioon|versioon
72−url|aadress|aadress
73−urlfrom|saadaval|saadaval
74−urlseen|vaadatud|vaadatud
75−inpreparation|koostamisel|koostamisel
76−submitted|esitatud|esitatud
77−forthcoming|tulevases|tulevases
78−citedas|edaspidi viidatud kui|edaspidi viidatud kui
79−thiscite|eriti|eriti
80−quotedin|noteeritud|noteeritud
81−see|vaata|vt
82−seealso|vaata ka|vt ka
83−backrefpage|viidatud lehel|viidatud lehel
84−january|jaanuar|jaanuar
85−february|veebruar|veebruar
86−april|aprill|aprill
87−may|mai|mai
88−june|juuni|juuni
89−july|juuli|juuli
90−august|august|august
91−september|september|september
92−october|oktoober|oktoober
93−november|november|november
94−december|detsember|detsember
95−langamerican|Ameerika inglise keel|Ameerika inglise keel
96−langbrazilian|brasiilia keel|brasiilia keel
97−langbulgarian|bulgaaria keel|bulgaaria keel
98−langcatalan|katalaani keel|katalaani keel
99−langcroatian|horvaadi keel|horvaadi keel
100−langdanish|taani keel|taani keel
101−langdutch|hollandi keel|hollandi keel
102−langenglish|inglise keel|inglise keel
103−langestonian|eesti keel|eesti keel
104−langfinnish|soome keel|soome keel
105−langfrench|prantsuse keel|prantsuse keel
106−langgalician|galeegi keel|galeegi keel
107−langgerman|saksa keel|saksa keel
108−langgreek|kreeka keel|kreeka keel
109−langhungarian|ungari keel|ungari keel
110−langitalian|itaalia keel|itaalia keel
111−langjapanese|jaapani keel|jaapani keel
112−langlatin|ladina keel|ladina keel
113−langnorwegian|norra keel|norra keel
114−langpolish|poola keel|poola keel
115−langportuguese|portugali keel|portugali keel
116−langrussian|vene keel|vene keel
117−langslovak|slovakia keel|slovakia keel
118−langslovene|sloveeni keel|sloveeni keel
119−langspanish|hispaania keel|hispaania keel
120−langswedish|rootsi keel|rootsi keel
121−langukrainian|ukraina keel|ukraina keel
122−fromamerican|Ameerika inglise keelest|Ameerika inglise keelest
123−frombrazilian|brasiilia keelest|brasiilia keelest
124−frombulgarian|bulgaaria keelest|bulgaaria keelest
125−fromcatalan|katalani keelest|kalatalani keelest
126−fromcroatian|horvaadi keelest|horvaadi keelest
127−fromdanish|taani keelest|taani keelest
128−fromdutch|hollandi keelest|hollandi keelest
129−fromenglish|inglise keelest|inglise keelest
130−fromestonian|eesti keelest|eesti keelest
131−fromfinnish|soome keelest|soome keelest
132−fromfrench|prantsuse keelest|prantsuse keelest
133−fromgalician|galeegi keelest|galeegi keelest
134−fromgerman|saksa keelest|saksa keelest
135−fromgreek|kreeka keelest|kreeka keelest
136−fromhungarian|ungari keelest|ungari keelest
137−fromitalian|itaalia keelest|itaalia keelest
138−fromjapanese|jaapani keelest|jaapani keelest
139−fromlatin|ladina keelest|ladina keelest
140−fromnorwegian|norra keelest|norra keelest
141−fromportuguese|portugali keelest|portugali keelest
142−fromrussian|vene keelest|vene keelest
143−fromslovak|slovakia keelest|slovakia keelest
144−fromslovene|sloveenia keelest|sloveenia keelest
145−fromspanish|hispaania keelest|hispaania keelest
146−fromswedish|rootsi keelest|rootsi keelest
147−fromukrainian|ukraina keelest|ukraina keelest
148−countryde|Saksamaa|DE
149−countryeu|Euroopa Liit|EL
150−countryep|Euroopa Parlament|EP
151−countryfr|Prantsusmaa|FR
152−countryuk|Suurbritannia|GB
153−countryus|Ameerika|US
154−patent|patent|pat\adddot
155−patentde|Saksa patent|Saksa pat\adddot
156−patenteu|Euroopa patent|Euroopa pat\adddot
157−patentfr|Prantsuse patent|Prantsuse pat\adddot
158−patentuk|Briti patent|Briti pat\adddot
159−patentus|U.S\adddotspace patent|U.S\adddotspace pat\adddot
160−patreq|patendi taotlus|pat\adddotspace taotl\adddot
161−patreqde|Saksa patendi taotlus|Saksa pat\adddotspace taotl\adddot
162−patreqeu|Euroopa patendi taotlus|Euroopa pat\adddotspace taotl\adddot
163−patreqfr|Prantsuse patendi taotlus|Prantsuse pat\adddotspace taotl\adddot
164−patrequk|Briti patendi taotlus|Briti pat\adddotspace taotl\adddot
165−patrequs|U.S\adddotspace patendi taotlus.|U.S\adddotspace pat\adddotspace taotl\adddot
166−file|fail|fail
167−library|raamatukogu|raamatukogu
168−abstract|teesid|teesid
169−annotation|kommentaarid|kommentaarid
170−commonera|meie ajaarvamise j\"argi|m\adddot a\adddot j
171−beforecommonera|enne meie ajaarvamist|e\adddot m\adddot a
172−annodomini|p\"arast Kristust|pKr
173−beforechrist|enne Kristust|eKr
174−spring|kevadel|kevadel
175−summer|suvel|suvel
176−winter|talvel|talvel
177−am|AM|AM
178−pm|PM|PM
citeproc/biblatex-localization/finnish.lbx.stringsdeleted−254
@@ -1,254 +0,0 @@
1−bibliography|Kirjallisuusluettelo|Kirjallisuus
2−references|Viitteet|Viitteet
3−shorthands|Lyhenteet|Lyhenteet
4−editor|toimittanut|toim\adddot
5−editors|toimittaneet|toim\adddot
6−compiler|koontanut|koontanut
7−compilers|koontaneet|koontaneet
8−redactor|toimittanut|toim\adddot
9−redactors|toimittaneet|toim\adddot
10−reviser|toimittanut|toim\adddot
11−revisers|toimittaneet|toim\adddot
12−founder|perustaja|perustaja
13−founders|perustajat|perustajat
14−continuator|jatkaja|jatkaja
15−continuators|jatkajat|jatkajat
16−collaborator|avustaja|avustaja
17−collaborators|avustajat|avustajat
18−translator|k\"a\"ant\"anyt|k\"a\"ant\adddot
19−translators|k\"a\"ant\"anyt|k\"a\"ant\adddot
20−commentator|kommentaarin kirjoittanut|kommentaarin kirjoittanut
21−commentators|kommentaarin kirjoittaneet|kommentaarin kirjoittaneet
22−annotator|selityksin varustanut|selityksin varustanut
23−annotators|selityksin varustaneet|selityksin varustaneet
24−commentary|kommentaari|kommentaari
25−annotations|selitykset|selitykset
26−introduction|johdanto|johdanto
27−foreword|esipuhe|esipuhe
28−afterword|j\"alkisanat|j\"alkisanat
29−organizer|toimittanut|toim\adddot
30−organizers|toimittaneet|toim\adddot
31−byorganizer|toimittanut|toim\adddot
32−byauthor|kirjoittanut|kirj\adddot
33−byeditor|toimittanut|toim\adddot
34−bycompiler|koontanut|koontanut
35−byredactor|toimittanut|toim\adddot
36−byreviser|toimittanut|toim\adddot
37−byreviewer|toimittanut|toim\adddot
38−byfounder|perustanut|perustanut
39−bycontinuator|jatkanut|jatkanut
40−bycollaborator|yhteisty\"oss\"a|yhteisty\"oss\"a
41−bytranslator|\lbx@lfromlang k\"a\"ant\"anyt|\lbx@sfromlang k\"a\"ant\adddot
42−bycommentator|kommentaarin kirjoittanut|kommentaarin kirjoittanut
43−byannotator|selityksin varustanut|selityksin varustanut
44−withcommentator|kommentaarin kirjoittanut|kommentaarin kirjoittanut
45−withannotator|selityksin varustanut|selityksin varustanut
46−withintroduction|johdannon kirjottanut|johdannon kirjottanut
47−withforeword|esipuheen kirjoittanut|esipuheen kirjoittanut
48−withafterword|j\"alkisanat kirjoittanut|j\"alkisanat kirjoittanut
49−and|ja|ja
50−andothers|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
51−andmore|jne\adddot|jne\adddot
52−volume|volyymi|vol\adddot
53−volumes|volyymit|vol\adddot
54−involumes||
55−jourvol|volyymi|vol\adddot
56−jourser|sarja|sarja
57−book|kirja|kirja
58−part|osa|osa
59−issue|numero|numero
60−newseries|uusi sarja|uusi sarja
61−oldseries|vanha sarja|vanha sarja
62−edition|painos|painos
63−reprint|j\"alkipainos|j\"alkipainos
64−reprintof|julkaistu aiemmin nimell\"a|julkaistu aiemmin nimell\"a
65−reprintas|julkaistu uudelleen nimell\"a|julkaistu uudelleen nimell\"a
66−reprintfrom|julkaistu aiemmin nimell\"a|julkaistu aiemmin nimell\"a
67−translationof|k\"a\"ann\"os teoksesta|k\"a\"ann\"os teoksesta
68−translationas|k\"a\"annetty nimell\"a|k\"a\"annetty nimell\"a
69−translationfrom|k\"a\"annetty kielest\"a|k\"a\"annetty kielest\"a
70−reviewof|arvostelu teoksesta|arvostelu teoksesta
71−origpubas|julkaistu ensi kerran nimell\"a|julkaistu ensi kerran nimell\"a
72−origpubin|julkaistu ensi kerran vuonna|julkaistu ensi kerran vuonna
73−astitle|nimell\"a|nimell\"a
74−bypublisher|julkaissut|julkaissut
75−page|sivu|s\adddot
76−pages|sivut|s\adddot
77−column|palsta|palsta
78−columns|palstat|palstat
79−line|rivi|rivi
80−lines|rivit|rivit
81−nodate|ei julkaisup\"aiv\"a\"a|ei julkaisup\"aiv\"a\"a
82−verse|s\"ae|s\"ae
83−verses|s\"akeet|s\"akeet
84−section|kohta|kohta
85−sections|kohdat|kohdat
86−paragraph|kappale|kappale
87−paragraphs|kappaleet|kappaleet
88−pagetotal|sivu|s\adddot
89−pagetotals|sivut|s\adddot
90−columntotal|palsta|palsta
91−columntotals|palstat|palstat
92−linetotal|rivi|rivi
93−linetotals|rivit|rivit
94−versetotal|s\"ae|s\"ae
95−versetotals|s\"akeet|s\"akeet
96−sectiontotal|kohta|kohta
97−sectiontotals|kohdat|kohdat
98−paragraphtotal|kappale|kappale
99−paragraphtotals|kappaleet|kappaleet
100−in|teoksessa|teoksessa
101−inseries|sarjassa|sarjassa
102−ofseries|sarjassa|sarjassa
103−number|numero|nro
104−chapter|luku|luku
105−bathesis|tutkielma|tutkielma
106−mathesis|tutkielma|tutkielma
107−phdthesis|tohtorinv\"ait\"oskirja|tohtorinv\"ait\"oskirja
108−candthesis|kanditaatintutkielma|kanditaatintutkielma
109−resreport|tutkimusraportti|tutkimusraportti
110−techreport|tekninen raportti|tekninen raportti
111−software|ohjelmisto|ohjelmisto
112−datacd|data-CD|data-CD
113−audiocd|\"a\"ani-CD|\"a\"ani-CD
114−version|versio|versio
115−url|url|url
116−urlfrom|saatavilla osoitteesta|saatavilla osoitteesta
117−urlseen|viitattu|viitattu
118−inpreparation|valmisteilla|valmisteilla
119−submitted|l\"ahetetty|l\"ahetetty
120−forthcoming|hyv\"aksytty julkaistavaksi|hyv\"aksytty julkaistavaksi
121−inpress|painossa|painossa
122−prepublished|esijulkaistu|esijulkaistu
123−citedas|jatkossa|jatkossa
124−thiscite|sama|sama
125−seenote|katso viite|katso viite
126−quotedin|lainattu teoksessa|lainattu teoksessa
127−idem|idem|id\adddot
128−idemsf|idem|id\adddot
129−idemsm|idem|id\adddot
130−idemsn|idem|id\adddot
131−idempf|idem|id\adddot
132−idempm|idem|id\adddot
133−idempn|idem|id\adddot
134−idempp|idem|id\adddot
135−ibidem|ibidem|ibid\adddot
136−opcit|op\adddotspace cit\adddot|op\adddotspace cit\adddot
137−loccit|loc\adddotspace cit\adddot|loc\adddotspace cit\adddot
138−confer|cf\adddot|cf\adddot
139−sequens|sq\adddot|sq\adddot
140−sequentes|sqq\adddot|sqq\adddot
141−passim|passim|pass\adddot
142−see|katso|ks\adddot
143−seealso|katso my\"os|katso my\"os
144−backrefpage|katso sivu|ks\adddotspace s\adddot
145−backrefpages|katso sivut|ks\adddotspace s\adddot
146−january|tammikuuta|tammikuuta
147−february|helmikuuta|helmikuuta
148−march|maaliskuuta|maaliskuuta
149−april|huhtikuuta|huhtikuuta
150−may|toukokuuta|toukokuuta
151−june|kes\"akuuta|kes\"akuuta
152−july|hein\"akuuta|hein\"akuuta
153−august|elokuuta|elokuuta
154−september|syyskuuta|syyskuuta
155−october|lokakuuta|lokakuuta
156−november|marraskuuta|marraskuuta
157−december|joulukuuta|joulukuuta
158−basicjanuary|tammikuu|tammikuu
159−basicfebruary|helmikuu|helmikuu
160−basicmarch|maaliskuu|maaliskuu
161−basicapril|huhtikuu|huhtikuu
162−basicmay|toukokuu|toukokuu
163−basicjune|kes\"akuu|kes\"akuu
164−basicjuly|hein\"akuu|hein\"akuu
165−basicaugust|elokuu|elokuu
166−basicseptember|syyskuu|syyskuu
167−basicoctober|lokakuu|lokakuu
168−basicnovember|marraskuu|marraskuu
169−basicdecember|joulukuu|joulukuu
170−langamerican|amerikanenglanti|amerikanenglanti
171−langbrazilian|brasilianportugali|brasilianportugali
172−langbulgarian|bulgaria|bulgaria
173−langcatalan|katalonia|katalonia
174−langcroatian|kroatia|kroatia
175−langdanish|tanska|tanska
176−langdutch|hollanti|hollanti
177−langenglish|englanti|englanti
178−langestonian|viro|viro
179−langfinnish|suomi|suomi
180−langfrench|ranska|ranska
181−langgalician|galicia|galicia
182−langgerman|saksa|saksa
183−langgreek|kreikka|kreikka
184−langhungarian|unkari|unkari
185−langitalian|italia|italia
186−langlatin|latina|latina
187−langlatvian|latvia|latvia
188−langnorwegian|norja|norja
189−langpolish|puola|puola
190−langportuguese|portugali|portugali
191−langrussian|ven\"aj\"a|ven\"aj\"a
192−langslovak|slovakia|slovakia
193−langslovene|slovenia|slovenia
194−langspanish|espanja|espanja
195−langswedish|ruotsi|ruotsi
196−fromamerican|englannin kielest\"a|englannin kielest\"a
197−frombrazilian|portugalin kielest\"a|portugalin kielest\"a
198−frombulgarian|bulgarian kielest\"a|bulgarian kielest\"a
199−fromcatalan|katalonian kielest\"a|katalonian kielest\"a
200−fromcroatian|kroatian kielest\"a|kroatian kielest\"a
201−fromdanish|tanskan kielest\"a|tanskan kielest\"a
202−fromdutch|hollannin kielest\"a|hollannin kielest\"a
203−fromenglish|englannin kielest\"a|englannin kielest\"a
204−fromestonian|viron kielest\"a|viron kielest\"a
205−fromfinnish|suomen kielest\"a|suomen kielest\"a
206−fromfrench|ranskan kielest\"a|ranskan kielest\"a
207−fromgalician|galician kielest\"a|galician kielest\"a
208−fromgerman|saksan kielest\"a|saksan kielest\"a
209−fromgreek|kreikan kielest\"a|kreikan kielest\"a
210−fromhungarian|unkarin kielest\"a|unkarin kielest\"a
211−fromitalian|italian kielest\"a|italian kielest\"a
212−fromlatin|latinan kielest\"a|latinan kielest\"a
213−fromlatvian|latvian kielest\"a|latvian kielest\"a
214−fromnorwegian|norjan kielest\"a|norjan kielest\"a
215−frompolish|puolan kielest\"a|puolan kielest\"a
216−fromportuguese|portugalin kielest\"a|portugalin kielest\"a
217−fromrussian|ven\"aj\"an kielest\"a|ven\"aj\"an kielest\"a
218−fromslovak|slovakian kielest\"a|slovakian kielest\"a
219−fromslovene|slovenian kielest\"a|slovenian kielest\"a
220−fromspanish|espanjan kielest\"a|espanjan kielest\"a
221−fromswedish|ruotsin kielest\"a|ruotsin kielest\"a
222−countryde|Saksa|DE
223−countryeu|Euroopan Unioni|EU
224−countryep|Euroopan Unioni|EP
225−countryfr|Ranska|FR
226−countryuk|Iso-Britannia|GB
227−countryus|Yhdysvallat|US
228−patent|patentti|pat\adddot
229−patentde|saksalainen patentti|saksalainen pat\adddot
230−patenteu|Euroopan Unionin patentti|Euroopan Unionin pat\adddot
231−patentfr|ranskalainen patentti|ranskalainen pat\adddot
232−patentuk|isobritannialainen patentti|isobritannialainen pat\adddot
233−patentus|yhdysvaltalainen patentti|yhdysvaltalainen pat\adddot
234−patreq|patenttihakemus|pat\adddot\ hak\adddot
235−patreqde|saksalainen patenttihakemus|saksalainen pat\adddot\ hak\adddot
236−patreqeu|Euroopan Unionin patenttihakemus|Euroopan Unionin pat\adddot\ hak\adddot
237−patreqfr|ranskalainen patenttihakemus|ranskalainen pat\adddot\ hak\adddot
238−patrequk|isobritannialainen patenttihakemus|isobritannialainen pat\adddot\ hak\adddot
239−patrequs|yhdysvaltalainen patenttihakemus|yhdysvaltalainen pat\adddot\ hak\adddot
240−file|tiedosto|tiedosto
241−library|kirjasto|kirjasto
242−abstract|tiivistelm\"a|tiivistelm\"a
243−annotation|selitykset|selitykset
244−commonera|j\"alkeen ajanlaskun alun|jaa\adddot
245−beforecommonera|ennen ajanlaskun alkua|eaa\adddot
246−annodomini|j\"alkeen Kristuksen syntym\"an|jKr\adddot
247−beforechrist|ennen Kristuksen syntym\"a\"a|eKr\adddot
248−circa|noin|n\adddot
249−spring|kev\"at|kev\"at
250−summer|kes\"a|kes\"a
251−autumn|syksy|syksy
252−winter|talvi|talvi
253−am|ap\adddot|ip\adddot
254−pm|ip\adddot|ip\adddot
citeproc/biblatex-localization/french.lbx.stringsdeleted−245
@@ -1,245 +0,0 @@
1−bibliography|Bibliographie|Bibliographie
2−references|R\'ef\'erences|R\'ef\'erences
3−shorthands|Liste des abr\'eviations|Abr\'eviations
4−editor|\'editeur|\'ed\adddot
5−editors|\'editeurs|\'ed\adddot
6−compiler|compilateur|comp\adddot
7−compilers|compilateurs|comp\adddot
8−redactor|r\'edacteur|r\'ed\adddot
9−redactors|r\'edacteurs|r\'ed\adddot
10−reviser|r\'eviseur|r\'ev\adddot
11−revisers|r\'eviseurs|r\'ev\adddot
12−founder|fondateur|fond\adddot
13−founders|fondateurs|fond\adddot
14−continuator|continuateur|cont\adddot
15−continuators|continuateurs|cont\adddot
16−collaborator|collaborateur|coll\adddot
17−collaborators|collaborateurs|coll\adddot
18−translator|traducteur|trad\adddot
19−translators|traducteurs|trad\adddot
20−commentator|commentateur|comm\adddot
21−commentators|commentateurs|comm\adddot
22−annotator|annotateur|annot\adddot
23−annotators|annotateurs|annot\adddot
24−commentary|commentaires|comment\adddot
25−annotations|annotations|annot\adddot
26−introduction|introduction|introd\adddot
27−foreword|pr\'eface|pr\'ef\adddot
28−afterword|postface|postf\adddot
29−editortr|\'editeur et traducteur|\'ed\adddotspace et trad\adddot
30−editorstr|\'editeurs et traducteurs|\'ed\adddotspace et trad\adddot
31−organizer|organisateur|org\adddot
32−organizers|organisateurs|org\adddot
33−byorganizer|organis\'e par|org\adddotspace par
34−byauthor|par|par
35−byeditor|sous la direction \smartof|sous la dir\adddotspace\smartof
36−bycompiler|compil\'e par|comp\adddotspace par
37−byredactor|r\'edig\'e par|r\'ed\adddotspace par
38−byreviser|r\'evis\'e par|r\'ev\adddotspace par
39−byreviewer|examin\'e par|ex\adddotspace par
40−byfounder|d\'ecouvert par|d\'ecouv\adddotspace par
41−bycontinuator|continu\'e par|cont\adddotspace par
42−bytranslator|traduit \lbx@lfromlang\ par|trad\adddotspace \lbx@sfromlang\ par
43−bycommentator|comment\'e par|comm\adddotspace par
44−byannotator|annot\'e par|annot\adddotspace par
45−withcommentator|avec des commentaires \smartof|avec des comment\adddotspace\smartof
46−withannotator|avec des annotations \smartof|avec des annot\adddotspace\smartof
47−withintroduction|avec une introduction \smartof|avec une introd\adddotspace\smartof
48−withforeword|avec une pr\'eface \smartof|avec une pr\'ef\adddotspace\smartof
49−withafterword|avec une postface \smartof|avec une postf\adddotspace\smartof
50−and|et|et
51−andothers|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
52−andmore|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
53−volume|tome|t\adddot
54−volumes|tomes|t\adddot
55−involumes|en|en
56−jourvol|tome|t\adddot
57−jourser|s\'erie|s\'er\adddot
58−book|livre|livre
59−part|partie|partie
60−issue|\'edition|\'ed\adddot
61−newseries|nouvelle s\'erie|nouv\adddotspace s\'er\adddot
62−oldseries|ancienne s\'erie|anc\adddotspace s\'er\adddot
63−edition|\'edition|\'ed\adddot
64−reprint|r\'eimpression|r\'eimpr\adddot
65−reprintof|r\'eimpression de|r\'eimpr\adddotspace de
66−reprintas|r\'eimpression sous le titre|r\'eimpr\adddotspace sous le titre
67−reprintfrom|r\'eimpression \`a partir \smartof|r\'eimpr\adddotspace \`a part\adddotspace\smartof
68−translationof|traduction de|trad\adddotspace de
69−translationas|traduit sous le titre|trad\adddotspace sous le titre
70−translationfrom|traduit de|trad\adddotspace de
71−reviewof|critique de|crit.\adddotspace de
72−origpubas|publi\'e \`a l'origine sous le titre|pub\adddotspace \`a l'orig\adddotspace sous le titre
73−origpubin|publi\'e \`a l'origine en|pub\adddotspace \`a l'orig\adddotspace en
74−astitle|sous le titre|sous le titre
75−bypublisher|par|par
76−page|page|p\adddot
77−pages|pages|p\adddot
78−column|colonne|col\adddot
79−columns|colonnes|col\adddot
80−line|ligne|l\adddot
81−lines|lignes|l\adddot
82−verse|vers|v\adddot
83−verses|vers|v\adddot
84−section|section|sect\adddot
85−sections|sections|sect\adddot
86−paragraph|paragraphe|\S
87−paragraphs|paragraphes|\S
88−pagetotal|page|p\adddot
89−pagetotals|pages|p\adddot
90−columntotal|colonne|col\adddot
91−columntotals|colonnes|col\adddot
92−linetotal|ligne|l\adddot
93−linetotals|lignes|l\adddot
94−versetotal|vers|v\adddot
95−versetotals|vers|v\adddot
96−sectiontotal|section|sect\adddot
97−sectiontotals|sections|sect\adddot
98−paragraphtotal|paragraphe|\S
99−paragraphtotals|paragraphes|\S
100−in|in|in
101−inseries|in|in
102−ofseries|de|de
103−number|num\'ero|n\textsuperscript{o
104−chapter|chapitre|chap\adddot
105−bathesis|m\'emoire de bachelor|m\'em\adddotspace de bach\adddot
106−mathesis|m\'emoire de master|m\'em\adddotspace de mast\adddot
107−phdthesis|th\`ese de doctorat|th\`ese de doct\adddot
108−candthesis|th\`ese de candidature|th\`ese de cand\adddot
109−resreport|rapport scientifique|rapp\adddotspace scient\adddot
110−techreport|rapport technique|rapp\adddotspace tech\adddot
111−software|logiciel|logiciel
112−datacd|c\'ed\'erom|c\'ed\'erom
113−audiocd|disque compact audio|CD
114−version|version|version
115−url|adresse|adresse
116−urlfrom|disponible \`a l'adresse|disp\adddotspace \`a l'adr\adddot
117−urlseen|visit\'e le|visit\'e le
118−inpreparation|en pr\'eparation|en pr\'ep\adddot
119−submitted|soumis|soumis
120−inpress|sous presse|sous presse
121−prepublished|pr\'epubli\'e|pr\'epubl\adddot
122−citedas|d\'esign\'e ci-apr\`es par|ci-apr\`es
123−thiscite|sp\'ecialement|sp\'ec\adddot
124−seenote|voir note|cf\adddotspace note
125−quotedin|cit\'e dans|cit\'e dans
126−idem|idem|idem
127−idemsm|idem|idem
128−idemsf|eadem|eadem
129−idemsn|idem|idem
130−idempm|eidem|eidem
131−idempf|eaedem|eaedem
132−idempn|eadem|eadem
133−idempp|eidem|eidem
134−ibidem|ibidem|ibid\adddot
135−opcit|op\adddotspace cit\adddot|op\adddotspace cit\adddot
136−loccit|loc\adddotspace cit\adddot|loc\adddotspace cit\adddot
137−confer|cf\adddot|cf\adddot
138−sequens|sq\adddot|sq\adddot
139−sequentes|sqq\adddot|sqq\adddot
140−passim|passim|pass\adddot
141−see|cf\adddot|cf\adddot
142−seealso|cf\adddotspace aussi|cf\adddotspace aussi
143−backrefpage|cf\adddotspace page|cf\adddotspace p\adddot
144−backrefpages|cf\adddotspace pages|cf\adddotspace p\adddot
145−january|janvier|jan\adddot
146−february|f\'evrier|f\'ev\adddot
147−march|mars|mars
148−april|avril|avr\adddot
149−may|mai|mai
150−june|juin|juin
151−july|juillet|juill\adddot
152−august|ao\^ut|ao\^ut
153−september|septembre|sept\adddot
154−october|octobre|oct\adddot
155−november|novembre|nov\adddot
156−december|d\'ecembre|d\'ec\adddot
157−langamerican|am\'ericain|am\'ericain
158−langbrazilian|br\'esilien|br\'esilien
159−langbulgarian|bulgare|bulgare
160−langcatalan|catalan|catalan
161−langcroatian|croate|croate
162−langczech|tch\`eque|tch\`eque
163−langdanish|danois|danois
164−langdutch|n\'eerlandais|n\'eerlandais
165−langenglish|anglais|anglais
166−langestonian|estonien|estonien
167−langfinnish|finnois|finnois
168−langgalician|galicien|galicien
169−langgerman|allemand|allemand
170−langgreek|grec|grec
171−langhungarian|hongrois|hongrois
172−langitalian|italien|italien
173−langjapanese|japonais|japonais
174−langlatin|latin|latin
175−langlatvian|letton|letton
176−langnorwegian|norv\'egien|norv\'egien
177−langpolish|polonais|polonais
178−langportuguese|portugais|portugais
179−langrussian|russe|russe
180−langserbian|serbe|serbe
181−langslovak|slovaque|slovaque
182−langslovene|slov\`ene|slov\`ene
183−langspanish|espagnol|espagnol
184−langswedish|su\'edois|su\'edois
185−langukrainian|ukrainien|ukrainien
186−fromamerican|de l'am\'ericain|de l'am\'ericain
187−frombrazilian|du br\'esilien|du br\'esilien
188−frombulgarian|du bulgare|du bulgare
189−fromcatalan|du catalan|du catalan
190−fromcroatian|du croate|du croate
191−fromczech|du tch\`eque|du tch\`eque
192−fromdanish|du danois|du danois
193−fromdutch|du n\'eerlandais|du n\'eerlandais
194−fromenglish|de l'anglais|de l'anglais
195−fromestonian|de l'estonien|de l'estonien
196−fromfinnish|du finnois|du finnois
197−fromgalician|du galicien|du galicien
198−fromgerman|de l'allemand|de l'allemand
199−fromgreek|du grec|du grec
200−fromhungarian|du hongrois|du hongrois
201−fromitalian|de l'italien|de l'italien
202−fromjapanese|du japonais|du japonais
203−fromlatin|du latin|du latin
204−fromlatvian|du letton|du letton
205−fromnorwegian|du norv\'egien|du norv\'egien
206−frompolish|du polonais|du polonais
207−fromportuguese|du portugais|du portugais
208−fromrussian|du russe|du russe
209−fromserbian|du serbe|du serbe
210−fromslovak|du slovaque|du slovaque
211−fromslovene|du slov\`ene|du slov\`ene
212−fromspanish|de l'espagnol|de l'espagnol
213−fromswedish|du su\'edois|du su\'edois
214−fromukrainian|de l'ukrainien|de l'ukrainien
215−countryde|Allemagne|DE
216−countryeu|Union europ\'eenne|EU
217−countryep|Union europ\'eenne|EP
218−countryfr|France|FR
219−countryuk|Royaume-Uni|GB
220−countryus|\'Etats-Unis|US
221−patent|brevet|brev\adddot
222−patentde|brevet allemand|brev\adddotspace allem\adddot
223−patenteu|brevet europ\'een|brev\adddotspace europ\adddot
224−patentuk|brevet britannique|brev\adddotspace brit\adddot
225−patentus|brevet am\'ericain|brev\adddotspace am\'er\adddot
226−patreq|demande de brevet|demande de brev\adddot
227−patreqde|demande de brevet allemand|demande de brev\adddotspace allem\adddot
228−patreqeu|demande de brevet europ\'een|demande de brev\adddotspace europ\adddot
229−patrequk|demande de brevet britannique|demande de brev\adddotspace brit\adddot
230−patrequs|demande de brevet am\'ericain|demande de brev\adddotspace am\'er\adddot
231−file|fichier|fichier
232−library|biblioth\`eque|biblioth\adddot
233−abstract|r\'esum\'e|r\'es\adddot
234−annotation|annotations|annotations
235−commonera|de l'\`ere commune|EC
236−beforecommonera|avant l'\`ere commune|AEC
237−annodomini|apr\`es J\'esus-Christ|apr\adddotspace J\adddot-C\adddot
238−beforechrist|avant J\'esus-Christ|av\adddotspace J\adddot-C\adddot
239−circa|vers|vers
240−spring|printemps|printemps
241−summer|\'et\'e|\'et\'e
242−autumn|automne|automne
243−winter|hiver|hiver
244−am|AM|AM
245−pm|PM|PM
citeproc/biblatex-localization/galician.lbx.stringsdeleted−28
@@ -1,28 +0,0 @@
1−bibliography|Bibliograf\'ia|Bibliograf\'ia
2−references|Referencias|Referencias
3−shorthands|Lista de abreviaturas|Abreviaturas
4−editor|editor|ed\adddot
5−editors|editores|eds\adddot
6−compiler|compilador|comp\adddot
7−compilers|compiladores|comp\adddot
8−redactor|redactor|red\adddot
9−redactors|redactores|red\adddot
10−reviser|revisor|rev\adddot
11−revisers|revisores|revs\adddot
12−founder|fundador|fund\adddot
13−founders|fundadores|fund\adddot
14−continuator|continuador|cont\adddot
15−continuators|continuadores|cont\adddot
16−collaborator|colaborador|col\adddot
17−collaborators|colaboradores|cols\adddot
18−translator|tradutor|trad\adddot
19−translators|tradutores|trads\adddot
20−commentator|comentador|coment\adddot
21−commentators|comentadores|coments\adddot
22−annotator|anotador|anot\adddot
23−annotators|anotadores|anots\adddot
24−commentary|comentario|coment\adddot
25−annotations|notas|notas
26−introduction|introduci\'on|introd\adddot
27−foreword|prefacio|pref\adddot
28−afterword|posfacio|posf\adddot
citeproc/biblatex-localization/german.lbx.stringsdeleted−28
@@ -1,28 +0,0 @@
1−bibliography|Literaturverzeichnis|Literatur
2−references|Literaturverzeichnis|Literatur
3−shorthands|Sigelverzeichnis|Sigel
4−editor|Herausgeber|Hrsg\adddot
5−editors|Herausgeber|Hrsg\adddot
6−compiler|Kompilator|Komp\adddot
7−compilers|Kompilatoren|Komp\adddot
8−redactor|Bearbeiter|Bearb\adddot
9−redactors|Bearbeiter|Bearb\adddot
10−reviser|\"Uberarbeiter|\"Uberarb\adddot
11−revisers|\"Uberarbeiter|\"Uberarb\adddot
12−founder|Begr\"under|Begr\adddot
13−founders|Begr\"under|Begr\adddot
14−continuator|Fortf\"uhrer|Fortf\adddot
15−continuators|Fortf\"uhrer|Fortf\adddot
16−collaborator|Mitarbeiter|Mitarb\adddot
17−collaborators|Mitarbeiter|Mitarb\adddot
18−translator|\"Ubersetzer|\"Ubers\adddot
19−translators|\"Ubersetzer|\"Ubers\adddot
20−commentator|Kommentator|Komm\adddot
21−commentators|Kommentatoren|Komm\adddot
22−annotator|Kommentator|Komm\adddot
23−annotators|Kommentatoren|Komm\adddot
24−commentary|Kommentar|Komm\adddot
25−annotations|Erl\"auterungen|Erl\"aut\adddot
26−introduction|Einleitung|Einl\adddot
27−foreword|Vorwort|Vorw\adddot
28−afterword|Nachwort|Nachw\adddot
citeproc/biblatex-localization/greek.lbx.stringsdeleted−9
@@ -1,9 +0,0 @@
1−bibliography|Βιβλιογραφία|Βιβλιογραφία
2−references|Αναφορές|Αναφορές
3−shorthands|Κατάλογος συντμήσεων|Συντμήσεις
4−editor|επιμελητής|επιμελητής
5−editors|επιμελητές|επιμελητές
6−compiler|συντάκτης|συντάκτης
7−compilers|συντάκτες|συντάκτες
8−redactor|συντάκτης|συντάκτης
9−redactors|συντάκτες|συντάκτες
citeproc/biblatex-localization/hungarian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/icelandic.lbx.stringsdeleted−7
@@ -1,7 +0,0 @@
1−bibliography|Heimildaskr\'a|Heimildaskr\'a
2−references|Heimildir|Heimildir
3−shorthands|Listi yfir skammstafanir|Skammstafanir
4−editor|ristj\'ori|ritstj\adddot
5−editors|ritstj\'orar|ritstj\adddot
6−compiler|samantekt|samantekt
7−compilers|samantekt|samantekt
citeproc/biblatex-localization/italian.lbx.stringsdeleted−9
@@ -1,9 +0,0 @@
1−bibliography|Bibliografia|Bibliografia
2−references|Riferimenti bibliografici|Riferimenti bibliografici
3−shorthands|Elenco delle sigle|Sigle
4−editor|curatore|cur\adddot
5−editors|curatori|cur\adddot
6−compiler|compilatore|comp\adddot
7−compilers|compilatori|comp\adddot
8−redactor|redattore|red\adddot
9−redactors|redattori|red\adddot
citeproc/biblatex-localization/latvian.lbx.stringsdeleted−75
@@ -1,75 +0,0 @@
1−redactor|redaktors|redakt\adddot
2−redactors|redaktori|radakt\adddot
3−reviser|revidents|revid\adddot
4−revisers|revidenti|revid\adddot
5−introduction|ievads|ievads
6−byeditor|izdevis|izdevis
7−bytranslator|tulkojis|tulk\adddot
8−withintroduction|ar ievadu no|ar ievadu no
9−byeditortr|izdevis un tulkojis|izdev\adddotspace un tulk\adddot
10−and|un|un
11−andothers|un citi|u\adddotspace c\adddot
12−jourvol|izdevums|izdev\adddot
13−issue|izdevums|izdev\adddot
14−edition|izdevums|izdev\adddot
15−translationof|tulkojums no|tulk\adddotspace no
16−translationfrom|tulkots no|tulk\adddotspace no
17−reviewof|recenzija|recenz\adddot
18−bypublisher|no|no
19−nodate|bez datuma|bez dat\adddot
20−page|lappuse|lpp\adddot
21−pages|lappuses|lpp\adddot
22−column|sleja|sleja
23−columns|slejas|slejas
24−line|rinda|rinda
25−lines|rindas|rindas
26−verse|pants|pants
27−verses|panti|panti
28−paragraph|rindkopa|rindk\adddot
29−paragraphs|rindkopas|rindk\adddot
30−pagetotal|lappuse|lpp\adddot
31−pagetotals|lappuses|lpp\adddot
32−columntotal|sleja|sleja
33−columntotals|slejas|slejas
34−linetotal|rinda|rinda
35−linetotals|rindas|rindas
36−versetotal|pants|pants
37−versetotals|panti|panti
38−paragraphtotal|rindkopa|rindk\adddot
39−paragraphtotals|rindkopas|rindk\adddot
40−in||
41−number|numurs|nr\adddot
42−datacd|datu CD|datu CD
43−audiocd|audio CD|audio CD
44−version|versija|versija
45−url|pieejams|pieejams
46−urlfrom|pieejams no|pieejams no
47−inpreparation|tiek gatavots|tiek gatavots
48−submitted|iesniegts|iesniegts
49−march|marts|marts
50−may|maijs|maijs
51−august|augusts|aug\adddot
52−september|septembris|sept\adddot
53−october|oktobris|okt\adddot
54−november|novembris|nov\adddot
55−december|decembris|dec\adddot
56−langfinnish|somu|somu
57−langrussian|krievu|krievu
58−langswedish|zviedru|zviedru
59−fromfinnish|no somu|no somu
60−fromrussian|no krievu|no krievu
61−fromswedish|no zviedru|no zviedru
62−countryep|Eiropas Parlaments|EP
63−countryfr|Francija|FR
64−patent|patents|patents
65−patenteu|Eiropas patents|Eiropas pat\adddot
66−patentus|ASV patents|ASV pat\adddot
67−file|fails|fails
68−circa|ap|ap
69−spring|pavasaris|pav\adddot
70−summer|vasara|vas\adddot
71−autumn|rudens|rud\adddot
72−winter|ziema|ziema
73−am|AM|AM
74−pm|PM|PM
75−dateyear|gada|g\adddot
citeproc/biblatex-localization/lithuanian.lbx.stringsdeleted−31
@@ -1,31 +0,0 @@
1−bibliography|Bibliografija|Bibliografija
2−references|Literatūros sąrašas|Literatūra
3−shorthands|Santrumpų sąrašas|Santrumpos
4−editor|sudarytojas|sud\adddot
5−editors|sudarytojai|sud\adddot
6−compiler|parengėjas|pareng\adddot
7−compilers|parengėjai|pareng\adddot
8−redactor|redaktorius|red\adddot
9−redactors|redaktoriai|red\adddot
10−reviser|korektorius|kor\adddot
11−revisers|korektoriai|kor\adddot
12−founder|pradininkas|prad\adddot
13−founders|pradininkai|prad\adddot
14−continuator|tęsėjas|tęs\adddot
15−continuators|tęsėjai|tęs\adddot
16−collaborator|bendradarbis|bendr\adddot
17−collaborators|bendradarbiai|bendr\adddot
18−translator|vertėjas|vert\adddot
19−translators|vertėjai|vert\adddot
20−commentator|komentarų autorius|koment\adddotspace aut\adddot
21−commentators|komentarų autoriai|koment\adddotspace aut\adddot
22−annotator|paaiškinimų autorius|paaišk\adddotspace aut\adddot
23−annotators|paaiškinimų autoriai|paaišk\adddotspace aut\adddot
24−commentary|komentarai|koment\adddot
25−annotations|paaiškinimai|paaišk\adddot
26−introduction|įvadas|įv\adddot
27−foreword|pratarmė|prat\adddot
28−afterword|pabaigos žodis|pab\adddotspace žodis
29−organizer|organizatorius|org\adddot
30−organizers|organizatoriai|org\adddot
31−byorganizer|organizavo|org\adddot
citeproc/biblatex-localization/magyar.lbx.stringsdeleted−29
@@ -1,29 +0,0 @@
1−bibliography|Irodalomjegyz\'ek|Irodalom
2−references|Hivatkoz\'asok|Hivatkoz\'asok
3−shorthands|R\"ovid\'it\'esek jegyz\'eke|R\"ovid\'it\'esek
4−compiler|\"ossze\'all\'it\'o|\"ossze\'all\adddot
5−compilers|\"ossze\'all\'it\'ok|\"ossze\'all\adddot
6−reviser|korrektor|korr\adddot
7−revisers|korrektorok|korr\adddot
8−founder|alap\'it\'o|alap\adddot
9−founders|alap\'it\'ok|alap\adddot
10−%continuator||
11−%continuators||
12−translator|ford\'it\'o|ford\adddot
13−translators|ford\'it\'ok|ford\adddot
14−commentator|komment\'ator|komm\adddot
15−commentators|komment\'atorok|komm\adddot
16−annotator|jegyzetek \'ir\'oja|jegyz\adddot
17−annotators|jegyzetek \'ir\'oi|jegyz\adddot
18−commentary|komment\'ar|komm\adddot
19−annotations|jegyzetek|jegyz\adddot
20−introduction|bevezet\'es|bev\adddot
21−afterword|ut\'osz\'o|ut\'osz\'o
22−byorganizer|szervezte|szerv\adddot
23−byauthor|\'irta|\'irta
24−byeditor|szerkesztette|szerk\adddot
25−bycompiler|\"ossze\'all\'itotta|\"ossze\'all\adddot
26−byredactor|sajt\'o al\'a rendezte|kiad\adddot
27−byreviser|jav\'itotta|jav\adddot
28−byreviewer|b\'ir\'alta|b\'ir\adddot
29−byfounder|alap\'itotta|alap\adddot
citeproc/biblatex-localization/naustrian.lbx.stringsdeleted−2
@@ -1,2 +0,0 @@
1−citedas|im Folgenden zitiert als|im Folgenden zit\adddotspace als
2−january|J\"anner|J\"an\adddot
citeproc/biblatex-localization/newzealand.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/ngerman.lbx.stringsdeleted−1
@@ -1 +0,0 @@
1−citedas|im Folgenden zitiert als|im Folgenden zit\adddotspace als
citeproc/biblatex-localization/norsk.lbx.stringsdeleted−98
@@ -1,98 +0,0 @@
1−bibliography|Bibliografi|Bibliografi
2−references|Referanser|Referanser
3−shorthands|Forkortelser|Forkortelser
4−compiler|kompilator|komp\adddot
5−compilers|kompilatorer|komp\adddot
6−redactor|bearbeidelse|bearb\adddot
7−redactors|bearbeidelse|bearb\adddot
8−reviser|revisjon|rev\adddot
9−revisers|revisjon|rev\adddot
10−founder|grunnlegger|grunnl\adddot
11−founders|grunnleggere|grunnl\adddot
12−collaborator|samarbeid|samarb\adddot
13−collaborators|samarbeid|samarb\adddot
14−translator|oversetter|overs\adddot
15−translators|oversettere|overs\adddot
16−commentator|kommentarer|komm\adddot
17−commentators|kommentarer|komm\adddot
18−annotator|forklaringer|forkl\adddot
19−annotators|forklaringer|forkl\adddot
20−commentary|kommentarer|komm\adddot
21−annotations|forklaringer|forkl\adddot
22−introduction|innledning|innl\adddot
23−foreword|forord|forord
24−afterword|etterord|etterord
25−organizer|organisator|org\adddot
26−organizers|organisatorer|org\adddot
27−byorganizer|organisert av|org\adddotspace av
28−byauthor|av|av
29−byeditor|redigert av|red\adddotspace av
30−bycompiler|kompilert av|komp\adddotspace av
31−byredactor|bearbeidet av|bearb\adddotspace av
32−byreviser|revidert av|rev\adddotspace av
33−byreviewer|kritikk ved|krit\adddotspace ved
34−byfounder|grunnlagt av|grunnl\adddotspace av
35−bycollaborator|i samarbeid med|i samarb\adddotspace med
36−bytranslator|oversatt \lbx@lfromlang\ av|overs\adddot\ \lbx@sfromlang\ av
37−bycommentator|kommentert av|komm\adddot\ av
38−byannotator|forklart av|forkl\adddot\ av
39−withcommentator|med kommentarer av|med komm\adddot\ av
40−withannotator|med forklaringer av|med forkl\adddot\ av
41−withintroduction|med innledning av|med innl\adddot\ av
42−withforeword|med forord av|med forord av
43−withafterword|med etterord av|med etterord av
44−and|og|og
45−andothers|med flere|mfl\adddot
46−andmore|med mer|m.m\adddot
47−volume|bind|bd\adddot
48−volumes|bind|bd\adddot
49−involumes|i|i
50−jourser|serie|ser\adddot
51−book|bok|bok
52−part|del|del
53−issue|nummer|nr\adddot
54−newseries|ny serie|ny ser\adddot
55−oldseries|gammel serie|gl\adddotspace ser\adddot
56−edition|utgave|utg\adddot
57−reprint|opptrykk|opptr\adddot
58−reprintof|opptrykk av|opptr\adddotspace av
59−reprintas|trykt om som|tr\adddotspace om som
60−reprintfrom|opptrykk fra|opptr\adddotspace fra
61−translationof|oversettelse av|overs\adddotspace av
62−translationas|oversatt som|overs\adddotspace som
63−translationfrom|oversatt fra|overs\adddotspace fra
64−reviewof|kritikk av|krit\adddotspace av
65−origpubas|opprinnelig utgitt som|oppr\adddot\ utg\adddot\ som
66−origpubin|opprinnelig utgitt i|oppr\adddot\ utg\adddot\ i
67−astitle|som|som
68−bypublisher|av|av
69−nodate|udatert|udatert
70−page|side|s\adddot
71−pages|sider|s\adddot
72−column|spalte|sp\adddot
73−columns|spalter|sp\adddot
74−line|linje|l\adddot
75−lines|linjer|l\adddot
76−verse|vers|v\adddot
77−verses|vers|v\adddot
78−section|avsnitt|avsn\adddot
79−sections|avsnitt|avsn\adddot
80−paragraph|avsnitt|avsn\adddot
81−paragraphs|avsnitt|avsn\adddot
82−pagetotal|side|s\adddot
83−pagetotals|sider|s\adddot
84−columntotal|spalte|sp\adddot
85−columntotals|spalter|sp\adddot
86−linetotal|linje|l\adddot
87−linetotals|linjer|l\adddot
88−versetotal|vers|v\adddot
89−versetotals|vers|v\adddot
90−sectiontotal|avsnitt|avsn\adddot
91−sectiontotals|avsnitt|avsn\adddot
92−paragraphtotal|avsnitt|avsn\adddot
93−paragraphtotals|avsnitt|avsn\adddot
94−in|i|i
95−inseries|i|i
96−ofseries|av|av
97−number|nummer|nr\adddot
98−chapter|kapittel|kap\adddot
citeproc/biblatex-localization/nswissgerman.lbx.stringsdeleted−2
@@ -1,2 +0,0 @@
1−citedas|im Folgenden zitiert als|im Folgenden zit\adddotspace als
2−countryuk|Grossbritannien|GB
citeproc/biblatex-localization/nynorsk.lbx.stringsdeleted−28
@@ -1,28 +0,0 @@
1−references|Referansar|Referansar
2−shorthands|Forkortingar|Forkortingar
3−compilers|kompilatorar|komp\adddot
4−redactor|omarbeiding|omarb\adddot
5−redactors|omarbeiding|omarb\adddot
6−founder|grunnleggjar|grunnl\adddot
7−founders|grunnleggjarar|grunnl\adddot
8−translator|omsetjar|oms\adddot
9−translators|omsetjarar|oms\adddot
10−commentator|kommentarar|komm\adddot
11−commentators|kommentarar|komm\adddot
12−annotator|forklaringar|forkl\adddot
13−annotators|forklaringar|forkl\adddot
14−commentary|kommentarar|komm\adddot
15−annotations|forklaringar|forkl\adddot
16−introduction|innleiing|innl\adddot
17−organizers|organisatorar|org\adddot
18−byredactor|omarbeidd av|omarb\adddotspace av
19−withcommentator|med kommentarar av|med komm\adddot\ av
20−withannotator|med forklaringar av|med forkl\adddot\ av
21−withintroduction|med innleiing av|med innl\adddot\ av
22−andothers|med fleire|mfl\adddot
23−andmore|med meir|m.m\adddot
24−oldseries|gamal serie|gl\adddotspace ser\adddot
25−translationof|omsetjing av|oms\adddotspace av
26−translationas|omsett som|oms\adddotspace som
27−origpubas|opphavleg utgitt som|opph\adddot\ utg\adddot\ som
28−origpubin|opphavleg utgitt i|opph\adddot\ utg\adddot\ i
citeproc/biblatex-localization/polish.lbx.stringsdeleted−100
@@ -1,100 +0,0 @@
1−bibliography|Bibliografia|Bibliografia
2−references|Bibliografia|Bibliografia
3−editor|redaktor|red\adddot
4−editors|redaktorzy|red\adddot
5−compiler|redaktor|red\adddot
6−compilers|redaktorzy|red\adddot
7−redactor|redaktor|red\adddot
8−redactors|redaktorzy|red\adddot
9−reviser|korektor|kor\adddot
10−revisers|korektorzy|kor\adddot
11−collaborator|uczestnik|ucz\adddot
12−collaborators|uczestnicy|ucz\adddot
13−translator|t\l umacz|t\l um\adddot
14−translators|t\l umacze|t\l um\adddot
15−commentator|komentator|kom\adddot
16−commentators|komentatorzy|kom\adddot
17−annotator|uwaga|uw\adddot
18−annotators|uwagi|uw\adddot
19−commentary|komentarz|kom\adddot
20−annotations|komentarze|kom\adddot
21−foreword|przedmowa|przedm\adddot
22−afterword|pos\l owie|pos\l \adddot
23−editortr|redaktor i t\l umacz|red\adddotspace i per\adddot
24−editorstr|redaktorzy i t\l umacze|red\adddotspace i per\adddot
25−editorco|redaktor i komentator|red\adddotspace i kom\adddot
26−translatorco|t\l umacz i komentator|t\l um\adddotspace i kom\adddot
27−translatorsco|t\l umacze i komentatorzy|t\l um\adddotspace i kom\adddot
28−organizer|organizator|org\adddot
29−organizers|organizatorzy|org\adddot
30−byorganizer|organizowane|org\adddot
31−byauthor|autorstwo|aut\adddot
32−byeditor|redagowa\l|red\adddot
33−byredactor|zredagowano|zred\adddot
34−byreviser|poprawione|popr\adddot
35−byreviewer|recenzja|rec\adddot
36−bytranslator|t\l umaczenie \lbx@lfromlang|t\l um\adddotspace \lbx@sfromlang
37−bycommentator|skomentowane przez|skom\adddot
38−byannotator|uwagi od|uw\adddot
39−withcommentator|komentarze|kom\adddot
40−withannotator|uwagi|uw\adddot
41−withforeword|przedmowa|przedm\adddot
42−withafterword|pos\l owie|pos\l \adddot
43−byeditoran|zredagowany i z uwagami|zredag\adddotspace i z uw\adddot
44−byeditoraf|zredagowany, z pos\l owiem|zred., z pos\l \adddot
45−byeditorcofo|zredagowany, komentarze i przedmowa|zred., kom\adddotspace i przedm\adddot
46−byeditorcoaf|zredagowany, komentarze i pos\l owie|zred., kom\adddotspace i pos\l \adddot
47−byeditoranfo|zredagowany, uwagi i przedmowa|zred., uw\adddotspace i przedm\adddot
48−byeditoranaf|zredagowany, uwagi i pos\l owie|zred., uw\adddotspace i pos\l \adddot
49−and|i|i
50−andothers|i inni|i in\adddot
51−andmore|i inni|i in\adddot
52−volume|tom|t\adddot
53−volumes|tomy|t\adddot
54−involumes|w|w
55−jourvol|tom|t\adddot
56−jourser|seria|ser\adddot
57−issue|wydanie|wyd\adddot
58−newseries|nowa seria|now\adddotspace ser\adddot
59−oldseries|stara seria|star\adddotspace ser\adddot
60−edition|wydruk|wyd\adddot
61−reprint|przedruk|przedr\adddot
62−reprintof|przedruk|przedr\adddot
63−reprintas|przedrukowano jako|przedr\adddotspace jako
64−reprintfrom|przedrukowano z|przedr\adddotspace z
65−translationof|t\l umaczenie|t\l um\adddot
66−translationas|t\l umaczenie jako|t\l um\adddotspace jako
67−translationfrom|t\l umaczenie z|t\l um\adddotspace z
68−reviewof|recenzja na\addcolon|rec\adddotspace na\addcolon
69−origpubin|pierwodruk wydano w|pierw\adddotspace wyd\adddotspace w
70−astitle|pod tytu\l em|pod tyt\adddot
71−page|strona|s\adddot
72−pages|strony|s\adddot
73−column|kolumna|kol\adddot
74−columns|kolumny|kol\adddot
75−line|linijka|l\adddot
76−lines|linijki|l\adddot
77−nodate|bez daty|b\adddot d\adddot
78−verse|werset|wer\adddot
79−verses|wersety|wer\adddot
80−section|paragraf|par\adddot
81−sections|paragrafy|par\adddot
82−paragraph|akapit|akap\adddot
83−paragraphs|akapity|akap\adddot
84−pagetotal|strona|s\adddot
85−pagetotals|strony|s\adddot
86−columntotal|kolumna|kol\adddot
87−columntotals|kolumny|kol\adddot
88−linetotal|wers|wer\adddot
89−linetotals|wersy|wer\adddot
90−versetotal|wiersz|wier\adddot
91−versetotals|wiersze|wier\adddot
92−sectiontotal|paragraf|par\adddot
93−sectiontotals|paragrafy|par\adddot
94−paragraphtotal|akapit|akap\adddot
95−paragraphtotals|akapit|akap\adddot
96−in|w|w
97−inseries|w|w
98−ofseries|z|z
99−number|numer|nr\adddot
100−chapter|rozdzia\l |rozd\adddot
citeproc/biblatex-localization/portuges.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/portuguese.lbx.stringsdeleted−95
@@ -1,95 +0,0 @@
1−bibliography|Bibliografia|Bibliografia
2−references|Refer\^encias|Refer\^encias
3−shorthands|Lista de Abreviaturas|Abreviaturas
4−editor|editor|ed\adddot
5−editors|editores|eds\adddot
6−compiler|compilador|comp\adddot
7−compilers|compiladores|comp\adddot
8−redactor|redator|red\adddot
9−redactors|redatores|red\adddot
10−reviser|revisor|rev\adddot
11−revisers|revisores|rev\adddot
12−founder|fundador|fund\adddot
13−founders|fundadores|fund\adddot
14−continuator|continuador|cont\adddot
15−continuators|continuadores|cont\adddot
16−collaborator|colaborador|col\adddot
17−collaborators|colaboradores|col\adddot
18−translator|tradutor|trad\adddot
19−translators|tradutores|trad\adddot
20−commentator|comentador|coment\adddot
21−commentators|comentadores|coment\adddot
22−annotator|anotador|anot\adddot
23−annotators|anotadores|anot\adddot
24−commentary|coment\'ario|coment\adddot
25−annotations|notas|notas
26−foreword|pref\'acio|pref\adddot
27−afterword|posf\'acio|posf\adddot
28−organizer|organizador|org\adddot
29−organizers|organizadores|orgs\adddot
30−byorganizer|organizado por|org\adddotspace por
31−byauthor|por|por
32−byeditor|editado por|ed\adddotspace por
33−bycompiler|compilado por|comp\adddotspace por
34−byredactor|redigido por|red\adddotspace por
35−byreviser|revisto por|rev\adddotspace por
36−byreviewer|resenhado por|res\adddotspace por
37−byfounder|fundado por|fund\adddotspace por
38−bycontinuator|continuado por|cont\adddotspace por
39−bytranslator|traduzido \lbx@lfromlang\ por|trad\adddot\ \lbx@sfromlang\ por
40−bycommentator|comentado por|coment\adddot\ por
41−byannotator|notas de|notas de
42−withcommentator|com coment\'arios de|com coment\adddot\ de
43−withannotator|com notas de|com notas de
44−withforeword|com pref\'acio de|com pref\adddot\ de
45−withafterword|com posf\'acio de|com posf\adddot\ de
46−and|e|e
47−andothers|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
48−andmore|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
49−volume|volume|vol\adddot
50−volumes|volumes|vols\adddot
51−involumes|em|em
52−jourvol|volume|vol\adddot
53−jourser|s\'erie|s\'er\adddot
54−book|livro|livro
55−part|parte|parte
56−issue|n\'umero|n\'umero
57−newseries|nova s\'erie|nova s\'er\adddot
58−oldseries|s\'erie antiga|s\'er\adddot\ antiga
59−reprint|reimpress\~ao|reimpr\adddot
60−reprintof|reimpress\~ao de|reimpr\adddotspace de
61−reprintas|reimpresso como|reimpr\adddotspace como
62−reprintfrom|reimpresso|reimpr\adddot
63−translationas|traduzido como|trad\adddotspace como
64−translationfrom|traduzido do|trad\adddotspace do
65−reviewof|resenha de|res\adddotspace de
66−origpubas|originalmente publicado como|orig\adddotspace pub\adddotspace como
67−origpubin|originalmente publicado em|orig\adddotspace pub\adddotspace em
68−astitle|como|como
69−bypublisher|por|por
70−nodate|sem data|s\adddot d\adddot
71−page|p\'agina|p\adddot
72−pages|p\'aginas|pp\adddot
73−column|coluna|col\adddot
74−columns|colunas|cols\adddot
75−line|linha|l\adddot
76−lines|linhas|ll\adddot
77−verse|verso|v\adddot
78−verses|versos|vv\adddot
79−paragraph|par\'agrafo|par\adddot
80−paragraphs|par\'agrafo|par\adddot
81−pagetotal|p\'agina|p\adddot
82−pagetotals|p\'aginas|pp\adddot
83−columntotal|coluna|col\adddot
84−columntotals|colunas|cols\adddot
85−linetotal|linha|l\adddot
86−linetotals|linhas|ll\adddot
87−versetotal|verso|v\adddot
88−versetotals|versos|vv\adddot
89−paragraphtotal|par\'agrafo|par\adddot
90−paragraphtotals|par\'agrafo|par\adddot
91−in|em|em
92−inseries|em|em
93−ofseries|de|de
94−number|n\'umero|n\adddot\textordmasculine
95−chapter|cap\'\i tulo|cap\adddot
citeproc/biblatex-localization/russian.lbx.stringsdeleted−102
@@ -1,102 +0,0 @@
1−bibliography|Список литературы|Список литературы
2−references|Список литературы|Список литературы
3−shorthands|Список сокращений|Сокращения
4−editor|редактор|ред\adddot
5−editors|редакторы|ред\adddot
6−compiler|составитель|сост\adddot
7−compilers|составители|сост\adddot
8−redactor|редактор|ред\adddot
9−redactors|редакторы|ред\adddot
10−reviser|ревизионный корректор|ревиз\adddotspace кор\adddot
11−revisers|ревизионные корректоры|ревиз\adddotspace кор\adddot
12−founder|основатель|осн\adddot
13−founders|основатели|осн\adddot
14−continuator|продолжатель|прод\adddot
15−continuators|продолжатели|прод\adddot
16−collaborator|участник|участ\adddot
17−collaborators|участники|участ\adddot
18−translator|переводчик|пер\adddot
19−translators|переводчики|пер\adddot
20−commentator|комментатор|коммент\adddot
21−commentators|комментаторы|коммент\adddot
22−annotator|примечания|примеч\adddot
23−annotators|примечания|примеч\adddot
24−commentary|комментарий|коммент\adddot
25−annotations|примечания|примеч\adddot
26−introduction|вступительная статья|вступ\adddotspace ст\adddot
27−foreword|предисловие|предисл\adddot
28−afterword|послесловие|послесл\adddot
29−organizer|организатор|орг\adddot
30−organizers|организаторы|орг\adddot
31−byorganizer|организатор|орг\adddot
32−byauthor||
33−byeditor|под редакцией|под\addabbrvspace ред\adddot
34−bycompiler|составитель|сост\adddot
35−byredactor|под редакцией|под\addabbrvspace ред\adddot
36−byreviser|исправлено|испр\adddot
37−byreviewer|рецензия|рец\adddot
38−byfounder|учредитель|учр\adddot
39−bycontinuator|продолжение|продолж\adddot
40−bycollaborator|при участии|при\addabbrvspace уч\adddot
41−bytranslator|перевод \lbx@lfromlang|пер\adddot\ \lbx@sfromlang
42−bycommentator|комментарии|коммент\adddot
43−byannotator|примечания|примеч\adddot
44−withcommentator|комментарии|коммент\adddot
45−withannotator|примечания|примеч\adddot
46−withintroduction|вступительная статья|вступ\adddotspace ст\adddot
47−withforeword|предисловие|предисл\adddot
48−withafterword|послесловие|послесл\adddot
49−and|и|и
50−andothers|и\addabbrvspace др\adddot|и\addabbrvspace др\adddot
51−andmore|и\addabbrvspace др\adddot|и\addabbrvspace др\adddot
52−volume|том|т\adddot
53−volumes|томах|т\adddot
54−involumes|в|в
55−jourvol|том|т\adddot
56−jourser|серия|сер\adddot
57−book|книга|кн\adddot
58−part|часть|ч\adddot
59−issue|выпуск|вып\adddot
60−newseries|новая серия|нов\adddotspace сер\adddot
61−oldseries|старая серия|стар\adddotspace сер\adddot
62−edition|издание|изд\adddot
63−reprint|переиздание|переизд\adddot
64−reprintof|переиздание|переизд\adddot
65−reprintas|переиздано как|переизд\adddotspace как
66−reprintfrom|переиздано с|переизд\adddotspace с
67−translationof|перевод по изданию\addcolon|пер\adddotspace по изд\adddot\addcolon
68−translationas|перевод\addcolon|пер\adddot\addcolon
69−translationfrom|перевод с|пер\adddotspace с
70−reviewof|рецензия на\addcolon|рец\adddotspace на\addcolon
71−astitle|\addcolon|\addcolon
72−bypublisher|\addcomma|\addcomma
73−nodate|б\adddot г\adddot|б\adddot г\adddot
74−page|страница|с\adddot
75−pages|страницы|с\adddot
76−column|колонка|кол\adddot
77−columns|колонки|кол\adddot
78−line|строка|строка
79−lines|строки|строка
80−verse|стих|стих
81−verses|стихи|стихи
82−section|параграф|\S
83−sections|параграфы|\S\S
84−paragraph|абзац|абз\adddot
85−paragraphs|абзацы|абз\adddot
86−pagetotal|страница|с\adddot
87−pagetotals|страницы|с\adddot
88−columntotal|колонка|кол\adddot
89−columntotals|колонки|кол\adddot
90−linetotal|строка|строка
91−linetotals|строки|строка
92−versetotal|стих|стих
93−versetotals|стихи|стихи
94−sectiontotal|параграф|\S
95−sectiontotals|параграфы|\S\S
96−paragraphtotal|абзац|абз\adddot
97−paragraphtotals|абзацы|абз\adddot
98−in|в|в
99−inseries|в|в
100−ofseries|из|из
101−number|номер|№
102−chapter|глава|гл\adddot
citeproc/biblatex-localization/serbian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/serbianc.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/slovak.lbx.stringsdeleted−82
@@ -1,82 +0,0 @@
1−references|Referencie|Referencie
2−shorthands|Zoznam skratiek|Skratky
3−editor|editor|ed\adddot
4−editors|editori|ed\adddot
5−compilers|zostavovatelia|zost\adddot
6−redactor|redaktor|red\adddot
7−redactors|redaktori|red\adddot
8−reviser|korektor|kor\adddot
9−revisers|korektori|kor\adddot
10−founders|zakladatelia|zakl\adddot
11−translators|prekladatelia|prekl\adddot
12−foreword|predhovor|predh\adddot
13−afterword|doslov|dosl\adddot
14−byauthor||
15−withforeword|s\addnbspace predhovorom od|s\addnbspace predh\adddot\ od
16−withafterword|s\addnbspace doslovom od|s\addnbspace dosl\adddot\ od
17−and|a|a
18−andothers|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
19−andmore|et\addabbrvspace al\adddot|et\addabbrvspace al\adddot
20−involumes|in|in
21−book|kniha|kniha
22−edition|vydanie|vyd\adddot
23−reviewof|recenzia|recenz\adddot
24−translationof|preklad|prekl\adddot
25−astitle|ako|ako
26−bypublisher||
27−page|strana|s\adddot
28−pages|strany|s\adddot
29−line|riadok|r\adddot
30−lines|riadky|r\adddot
31−section|sekcia|\S
32−sections|sekcie|\S\S
33−paragraph|odsek|ods\adddot
34−paragraphs|odseky|ods\adddot
35−pagetotal|strana|s\adddot
36−pagetotals|strany|s\adddot
37−linetotal|riadok|r\adddot
38−linetotals|riadky|r\adddot
39−sectiontotal|sekcia|\S
40−sectiontotals|sekcie|\S\S
41−paragraphtotal|odsek|ods\adddot
42−paragraphtotals|odseky|ods\adddot
43−in|in|in
44−inseries|in|in
45−ofseries|z|z
46−chapter|kapitola|kap\adddot
47−datacd|CD-ROM|CD-ROM
48−audiocd|audio CD|audio CD
49−version|verzia|ver\adddot
50−url|URL|URL
51−idem|idem|idem
52−idemsm|idem|idem
53−idemsf|eadem|eadem
54−idemsn|idem|idem
55−idempm|eidem|eidem
56−idempf|eaedem|eaedem
57−idempn|eadem|eadem
58−idempp|eidem|eidem
59−ibidem|ibidem|ibid\adddot
60−opcit|op\adddotspace cit\adddot|op\adddotspace cit\adddot
61−loccit|loc\adddotspace cit\adddot|loc\adddotspace cit\adddot
62−confer|cf\adddot|cf\adddot
63−sequens|sq\adddot|sq\adddot
64−sequentes|sqq\adddot|sqq\adddot
65−passim|passim|pass\adddot
66−march|marec|mar\adddot
67−august|august|aug\adddot
68−september|september|sept\adddot
69−november|november|nov\adddot
70−december|december|dec\adddot
71−countryde|Nemecko|DE
72−patent|patent|pat\adddot
73−patentus|US patent|US pat\adddot
74−abstract|abstrakt|abst\adddot
75−annodomini|po Kristovi|po Kr\adddot
76−beforechrist|pred Kristom|pred Kr\adddot
77−circa|cirka|ca\adddot
78−spring|jar|jar
79−summer|leto|leto
80−winter|zima|zima
81−am|AM|AM
82−pm|PM|PM
citeproc/biblatex-localization/slovene.lbx.stringsdeleted−28
@@ -1,28 +0,0 @@
1−bibliography|Literatura|Literatura
2−references|Literatura|Literatura
3−shorthands|Kratice|Kratice
4−editor|urednik|ur\adddot
5−editors|uredniki|ur\adddot
6−compiler|sestavljalec|sest\adddot
7−compilers|sestavljalci|sest\adddot
8−redactor|redaktor|redaktor
9−redactors|redaktorji|redaktorji
10−reviser|korektor|korektor
11−revisers|korektorji|korektorji
12−founder|snovalec|snovalec
13−founders|snovalci|snovalci
14−continuator|nadaljevalec|nadaljevalec
15−continuators|nadaljevalci|nadaljevalci
16−collaborator|sodelavec|sod\adddot
17−collaborators|sodelavci|sod\adddot
18−translator|prevajalec|prev\adddot
19−translators|prevajalci|prev\adddot
20−commentator|komentator|komentator
21−commentators|komentatorji|komentatorji
22−annotator|anotator|anotator
23−annotators|anotatorji|anotatorji
24−commentary|komentar|komentar
25−annotations|opombe|op\adddot
26−introduction|uvod|uvod
27−foreword|predgovor|predg\adddot
28−afterword|spremna beseda|spr\adddotspace b\adddot
citeproc/biblatex-localization/slovenian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/spanish.lbx.stringsdeleted−190
@@ -1,190 +0,0 @@
1−references|Referencias|Referencias
2−shorthands|Lista de abreviaturas|Abreviaturas
3−editor|edici\'on|ed\adddot
4−editors|edici\'on|eds\adddot
5−commentator|comentario|com\adddot
6−commentators|comentarios|coms\adddot
7−annotator|anotaciones|anot\adddot
8−annotators|anotaciones|anots\adddot
9−commentary|comentario|com\adddot
10−annotations|notas|notas
11−introduction|introducci\'on|intr\adddot
12−foreword|pr\'ologo|pr\'ol\adddot
13−organizer|organizaci\'on|org\adddot
14−organizers|organizaci\'on|orgs\adddot
15−byorganizer|organizado por|org\adddotspace por
16−byauthor|de|de
17−byeditor|editado por|ed\adddotspace por
18−bycompiler|compilado por|comp\adddotspace por
19−byredactor|redacci\'on de|red\adddotspace de
20−byreviser|revisado por|rev\adddotspace por
21−byfounder|fundado por|fund\adddotspace por
22−bycontinuator|continuado por|cont\adddotspace por
23−bytranslator|traducido \lbx@lfromlang\ por|trad\adddot \lbx@sfromlang\ por
24−bycommentator|comentado por|com\adddotspace por
25−byannotator|anotado por|anot\adddotspace por
26−withcommentator|con comentario de|con com\adddotspace de
27−withannotator|con notas de|con notas de
28−withintroduction|con introduci\'on de|con intr\adddotspace de
29−withforeword|con pr\'ologo de|con pr\'ol\adddotspace de
30−and|y|y
31−andothers|y~col\adddot|y~col\adddot
32−andmore|et\adddotspace al\adddot|et\adddotspace al\adddot
33−volume|volumen|vol\adddot
34−volumes|vol\'umenes|vols\adddot
35−involumes|en|en
36−jourvol|volumen|vol\adddot
37−jourser|\'epoca|\'ep\adddot
38−book|libro|libro
39−part|parte|parte
40−issue|n\'umero|n\'um\adddot
41−newseries|nueva \'epoca|n\adddotspace \'ep\adddot
42−oldseries|antigua \'epoca|ant\adddotspace \'ep\adddot
43−edition|edici\'on|ed\adddot
44−reprintas|reimpreso como|reimp\adddotspace como
45−translationas|traducido como|trad\adddotspace como
46−translationfrom|traducido del|trad\adddotspace del
47−origpubas|publicado originalmente como|pub\adddotspace orig\adddotspace como
48−origpubin|publicado originalmente en|pub\adddot orig\adddot en
49−bypublisher|por la editorial|por la ed\adddot
50−page|p\'agina|p\'ag\adddot
51−pages|p\'aginas|p\'ags\adddot
52−column|columna|col\adddot
53−columns|columnas|cols\adddot
54−verse|verso|v\adddot
55−verses|versos|vv\adddot
56−sections|secciones|secs\adddot
57−pagetotal|p\'agina|p\'ag\adddot
58−pagetotals|p\'aginas|p\'ags\adddot
59−columntotal|columna|col\adddot
60−columntotals|columnas|cols\adddot
61−versetotal|verso|v\adddot
62−versetotals|versos|vv\adddot
63−sectiontotals|secciones|secs\adddot
64−in|en|en
65−inseries|en|en
66−ofseries|de|de
67−number|n\'umero|n\sptext{o
68−chapter|cap\'itulo|cap\adddot
69−bathesis|Tesis de licenciatura|Tesis de lic\adddot
70−phdthesis|Tesis doctoral|Tesis doct\adddot
71−candthesis|Tesis de candidatura doctoral|Tesis de cand\adddotspace doct\adddot
72−techreport|informe t\'ecnico|inf\adddotspace t\'ec\adddot
73−software|programa|prog\adddot
74−datacd|disco de datos|CD de datos
75−audiocd|disco de audio|CD de audio
76−version|versi\'on|ver\adddot
77−url|direcci\'on|direcci\'on
78−urlfrom|disponible desde|disp\adddotspace desde
79−urlseen|visitado|visitado
80−submitted|enviado|enviado
81−forthcoming|pr\'oximamente|prox\adddot
82−inpress|en prensa|en prensa
83−prepublished|previamente publicado|prepublicado
84−citedas|citado en adelante como|cit\adddotspace en adelante como
85−thiscite|especialmente|esp\adddot
86−seenote|ver nota|ver n\adddot
87−quotedin|citado en|cit\adddotspace en
88−loccit|loc\adddotspace cit\adddot|loc\adddot cit\adddot
89−confer|cf\adddot|cf\adddot
90−sequens|s\adddot|s\adddot
91−sequentes|ss\adddot|ss\adddot
92−passim|p\'assim|p\'assim
93−see|v\'ease|vid\adddot
94−seealso|v\'ease tambi\'en|vid\adddotspace tambi\'en
95−backrefpage|v\'ease p\'agina|vid\adddotspace p\'ag\adddot
96−backrefpages|v\'eanse p\'aginas|vid\adddotspace p\'ags\adddot
97−january|enero|ene\adddot
98−february|febrero|feb\adddot
99−march|marzo|mar\adddot
100−april|abril|abr\adddot
101−may|mayo|mayo
102−june|junio|jun\adddot
103−july|julio|jul\adddot
104−august|agosto|ago\adddot
105−september|septiembre|sep\adddot
106−october|octubre|oct\adddot
107−november|noviembre|nov\adddot
108−december|diciembre|dic\adddot
109−langbrazilian|brasile\~no|brasile\~no
110−langbulgarian|b\'ulgaro|b\'ulgaro
111−langcroatian|croata|croata
112−langczech|checo|checo
113−langdanish|dan\'es|dan\'es
114−langdutch|neerland\'es|neerland\'es
115−langenglish|ingl\'es|ingl\'es
116−langestonian|estonio|estonio
117−langfrench|franc\'es|franc\'es
118−langgalician|gallego|gallego
119−langgerman|alem\'an|alem\'an
120−langgreek|griego|griego
121−langhungarian|h\'ungaro|h\'ungaro
122−langitalian|italiano|italiano
123−langjapanese|japon\'es|japon\'es
124−langlatvian|lituano|lituano
125−langnorwegian|noruego|noruego
126−langpolish|polaco|polaco
127−langportuguese|portugu\'es|portugu\'es
128−langrussian|ruso|ruso
129−langslovak|eslovaco|eslovaco
130−langslovene|esloveno|esloveno
131−langspanish|espa\~nol|espa\~nol
132−langswedish|sueco|sueco
133−langukrainian|ucraniano|ucraniano
134−frombrazilian|del brasile\~no|del brasile\~no
135−frombulgarian|del b\'ulgaro|del b\'ulgaro
136−fromcroatian|del croata|del croata
137−fromczech|del checo|del checo
138−fromdanish|del dan\'es|del dan\'es
139−fromdutch|del neerland\'es|del neerland\'es
140−fromenglish|del ingl\'es|del ingl\'es
141−fromestonian|del estonio|del estonio
142−fromfrench|del franc\'es|del franc\'es
143−fromgalician|del gallego|del gallego
144−fromgerman|del alem\'an|del alem\'an
145−fromgreek|del griego|del griego
146−fromhungarian|del h\'ungaro|del h\'ungaro
147−fromitalian|del italiano|del italiano
148−fromjapanese|del japon\'es|del japon\'es
149−fromlatvian|del lituano|del lituano
150−fromnorwegian|del noruego|del noruego
151−frompolish|del polaco|del polaco
152−fromportuguese|del portugu\'es|del portugu\'es
153−fromrussian|del ruso|del ruso
154−fromslovak|del eslovaco|del eslovaco
155−fromslovene|del esloveno|del esloveno
156−fromspanish|del espa\~nol|del espa\~nol
157−fromswedish|del sueco|del sueco
158−fromukrainian|del ucraniano|del ucraniano
159−countryde|Alemania|DE
160−countryeu|Uni\'on Europea|EU
161−countryep|Uni\'on Europea|EP
162−countryfr|Francia|FR
163−countryuk|Reino Unido|GB
164−countryus|Estados Unidos|US
165−patent|patente|pat\adddot
166−patentde|patente alemana|pat\adddotspace alemana
167−patenteu|patente europea|pat\adddotspace europea
168−patentfr|patente francesa|pat\adddotspace francesa
169−patentuk|patente brit\'anica|pat\adddotspace brit\'anica
170−patentus|patente estadounidense|pat\adddotspace estadounidense
171−patreq|solicitud de patente|sol\adddotspace de pat\adddot
172−patreqde|solicitud de patente alemana|sol\adddotspace de pat\adddot alemana
173−patreqeu|solicitud de patente europea|sol\adddotspace de pat\adddot europea
174−patreqfr|solicitud de patente francesa|sol\adddotspace de pat\adddot francesa
175−patrequk|solicitud de patente brit\'anica|sol\adddotspace de pat\adddot brit\'anica
176−patrequs|solicitud de patente estadounidense|sol\adddotspace de pat\adddot estadounidense
177−file|archivo|archivo
178−library|biblioteca|bibl\adddot
179−abstract|resumen|resumen
180−commonera|era com\'un|e\adddotspace c\adddot
181−beforecommonera|antes de la era com\'un|a\adddotspace e\adddotspace c\adddot
182−annodomini|despu\'es de Cristo|d\adddotspace C\adddot
183−beforechrist|antes de Cristo|a\adddotspace C\adddot
184−circa|circa|ca\adddot
185−spring|primavera|prim\adddot
186−summer|verano|ver\adddot
187−autumn|oto\~no|ot\adddot
188−winter|invierno|inv\adddot
189−am|a\adddotspace m\adddot|a\adddot m\adddot
190−pm|p\adddotspace m\adddot|p\adddot m\adddot
citeproc/biblatex-localization/swedish.lbx.stringsdeleted−9
@@ -1,9 +0,0 @@
1−bibliography|Litteraturf\"orteckning|Litteratur
2−references|Referenser|Referenser
3−shorthands|F\"orkortningar|F\"orkortningar
4−editor|utgivare|utg\adddot
5−editors|utgivare|utg\adddot
6−compiler|sammanst\"allare|sammanst\adddot
7−compilers|sammanst\"allare|sammanst\adddot
8−redactor|redakt\"or|red\adddot
9−redactors|redakt\"orer|red\adddot
citeproc/biblatex-localization/swissgerman.lbx.stringsdeleted−1
@@ -1 +0,0 @@
1−countryuk|Grossbritannien|GB
citeproc/biblatex-localization/turkish.lbx.stringsdeleted−157
@@ -1,157 +0,0 @@
1−references|Kaynaklar|Kaynaklar
2−shorthands|K\i saltmalar dizini|K\i saltmalar
3−compiler|derleyen|der\adddot
4−compilers|derleyenler|der\adddot
5−redactor|yay\i na haz\i rlayan|yay\adddot\ haz\adddot
6−redactors|yay\i na haz\i rlayanlar|yay\adddot\ haz\adddot
7−reviser|tashih eden|tashih\adddot
8−revisers|tashih edenler|tashih\adddot
9−founder|kurucu|kur\adddot
10−founders|kurucular|kur\adddot
11−continuator|tamamlayan|tam\adddot
12−continuators|tamamlayanlar|tam\adddot
13−collaborator|ortak|ortak
14−collaborators|ortaklar|ortaklar
15−commentator|yorumlayan|yrm\adddot
16−commentators|yorumlayanlar|yrm\adddot
17−commentary|yorum|yrm\adddot
18−byauthor|yazar|yazar
19−bycompiler|derleyen|der\adddot
20−byredactor|yay\i na haz\i rlayan|yay\adddot\ haz\adddot
21−byreviser|tashih|tashih
22−byfounder|kurucu|kur\adddot
23−bycontinuator|tamamlayan|tam\adddot
24−bycommentator|yorumlayan|yrm\adddot
25−withcommentator|yorumlar\i yla katk\i da bulunan|yrm\adddot\ kat\adddot\ bul\adddot
26−and|ve|ve
27−volume|cilt|c\adddot
28−volumes|cilt|c\adddot
29−jourvol|cilt|c\adddot
30−jourser|seri|seri
31−book|kitap|kitap
32−part|k\i s\i m|k\i s\i m
33−issue|say\i|say\i
34−newseries|yeni seri|yeni seri
35−oldseries|eski seri|eski seri
36−edition|bask\i|bs\adddot
37−reprint|yeni bask\i s\i|yeni bask\i s\i
38−reprintof|yeni bask\i s\i|yeni bask\i s\i
39−reprintas|yeni bask\i s\i|yeni bask\i s\i
40−reprintfrom|yeni bask\i s\i|yeni bask\i s\i
41−reviewof|derlenen eser|der\adddot\ eser
42−origpubas|as\i l eser|as\i l eser
43−origpubin|as\i l eser yay\i n tarihi|as\i l eser yay\i n tarihi
44−bypublisher|yay\i n evi|yay\i n evi
45−nodate|tarih yok|t\adddot y\adddot
46−page|sayfa|s\adddot
47−pages|sayfalar|ss\adddot
48−line|sat\i r|sat\adddot
49−lines|sat\i rlar|sat\adddot
50−verse|m\i sra|m\i s\adddot
51−verses|m\i sralar|m\i s\adddot
52−paragraph|paragraf|par\adddot
53−paragraphs|paragraflar|par\adddot
54−pagetotal|toplam sayfa|s\adddot
55−pagetotals|toplam sayfalar|ss\adddot
56−linetotal|toplam sat\i r|sat\adddot
57−linetotals|toplam sat\i rlar|sat\adddot
58−versetotal|toplam m\i sra|m\i s\adddot
59−versetotals|toplam m\i sralar|m\i s\adddot
60−paragraphtotal|toplam paragraf|par\adddot
61−paragraphtotals|toplam paragraflar|par\adddot
62−inseries|serilerde|serilerde
63−ofseries|serilerde|serilerde
64−number|numara|no\adddot
65−bathesis|lisans tezi|lis\adddot\ tezi
66−phdthesis|doktora tezi|dok\adddot\ tezi
67−candthesis|aday tezi|aday tezi
68−techreport|teknik rapor|tek\adddot\ rap\adddot
69−software|bilgisayar yaz\i l\i m\i|bilg\adddot\ yaz\adddot
70−datacd|CD|CD
71−audiocd|ses CD'si|ses CD'si
72−version|versiyon|ver\adddot
73−forthcoming|yak\i nda|yak\i nda
74−prepublished|taslak bas\i m\i|taslak bas\i m\i
75−citedas|at\i f olarak|at\i f olarak
76−seenote|nota bak\i n\i z|nota bkz\adddot
77−quotedin|al\i nt\i|al\i nt\i
78−idem|ayn\i|ayn\i
79−idemsm|ayn\i|ayn\i
80−idemsf|ayn\i|ayn\i
81−idemsn|ayn\i|ayn\i
82−idempm|ayn\i lar\i|ayn\i lar\i
83−idempf|ayn\i lar\i|ayn\i lar\i
84−idempn|ayn\i lar\i|ayn\i lar\i
85−idempp|ayn\i lar\i|ayn\i lar\i
86−loccit|at\i f yap\i lan yer|at\i f yap\adddot\ yer
87−sequens|takip eden|takip eden
88−sequentes|takip eden|takip eden
89−passim|rastgele|rastgele
90−see|bak\i n\i z|bkz\adddot
91−seealso|ayr\i ca bak\i n\i z|ayr\i ca bkz\adddot
92−january|Ocak|Ocak
93−march|Mart|Mar\adddot
94−april|Nisan|Nis\adddot
95−may|May\i s|May\adddot
96−june|Haziran|Haz\adddot
97−july|Temmuz|Tem\adddot
98−october|Ekim|Ekim
99−november|Kas\i m|Kas\adddot
100−december|Aral\i k|Ara\adddot
101−langamerican|Amerikanca|Amerikanca
102−langbrazilian|Brezilyanca|Brezilyanca
103−langbulgarian|Bulgarca|Bulgarca
104−langcatalan|Katalanca|Katalanca
105−langdanish|Danimarkanca|Danimarkanca
106−langestonian|Estonca|Estonca
107−langfinnish|Fince|Fince
108−langfrench|Frans\i zca|Frans\i zca
109−langgalician|Galce|Galce
110−langgerman|Almanca|Almanca
111−langgreek|Yunanca|Yunanca
112−langhungarian|Macarca|Macarca
113−langjapanese|Japonca|Japonca
114−langlatin|Latince|Latince
115−langlatvian|Letonca|Letonca
116−langlithuanian|Litvanca|Litvanca
117−langpolish|Polonyaca|Polonyaca
118−langportuguese|Portekizce|Portekizce
119−langslovene|Slovence|Slovence
120−langukrainian|Ukraynaca|Ukraynaca
121−fromamerican|Amerikanca'dan|Amerikanca'dan
122−frombrazilian|Brezilyanca'dan|Brezilyanca'dan
123−frombulgarian|Bulgarca'dan|Bulgarca'dan
124−fromcatalan|Katalanca'dan|Katalanca'dan
125−fromdanish|Danimarkanca'dan|Danimarkanca'dan
126−fromestonian|Estonyaca'dan|Estonyaca'dan
127−fromfinnish|Fince'den|Fince'den
128−fromfrench|Frans\i zca'dan|Frans\i zca'dan
129−fromgalician|Galyaca'dan|Galyaca'dan
130−fromgerman|Almanca'dan|Almanca'dan
131−fromgreek|Yunanca'dan|Yunanca'dan
132−fromhungarian|Macarca'dan|Macarca'dan
133−fromjapanese|Japonca'dan|Japonca'dan
134−fromlatin|Latince'den|Latince'den
135−fromlatvian|Latvianca'dan|Latvianca'dan
136−fromlithuanian|Litvanca'dan|Litvanca'dan
137−frompolish|Polonyaca'dan|Polonyaca'dan
138−fromportuguese|Portekizce'den|Portekizce'den
139−fromslovene|Slovence'den|Slovence'den
140−fromukrainian|Ukraynaca'dan|Ukraynaca'dan
141−countryde|Almanya|DE
142−countryfr|Fransa|FR
143−patent|patent|pat\adddot
144−patentde|Alman patenti|Alman pat\adddot
145−patenteu|Avrupa patenti|Avrupa pat\adddot
146−patentfr|Frans\i z patenti|Frans\i z pat\adddot
147−patentus|Amerika patenti|Amerika pat\adddot
148−patreq|patent beklemede|pat\adddot\ bek\adddot
149−patreqde|Alman patenti beklemede|Alman pat\adddot\ bek\adddot
150−patreqeu|Avrupa patenti beklemede|Avrupa pat\adddot\ bek\adddot
151−patreqfr|Frans\i z patenti beklemede|Frans\i z pat\adddot\ bek\adddot
152−patrequs|Amerika patenti beklemede|Amerika pat\adddot\ bek\adddot
153−file|dosya|dosya
154−commonera|milattan sonra|MS
155−annodomini|milattan sonra|MS
156−summer|Yaz|Yaz
157−autumn|Sonbahar|Sonbahar
citeproc/biblatex-localization/ukrainian.lbx.stringsdeleted−102
@@ -1,102 +0,0 @@
1−bibliography|Перелік літератури|Література
2−references|Перелік літератури|Література
3−shorthands|Перелік скорочень|Скорочення
4−editor|редактор|ред\adddot
5−editors|редактори|ред\adddot
6−compiler|укладач|уклад\adddot
7−compilers|укладачі|уклад\adddot
8−redactor|редактор|ред\adddot
9−redactors|редактори|ред\adddot
10−reviser|ревізійний коректор|ревіз\adddotspace кор\adddot
11−revisers|ревізійні коректори|ревіз\adddotspace кор\adddot
12−founder|засновник|засн\adddot
13−founders|засновник|засн\adddot
14−continuator|продовжувач|прод\adddot
15−continuators|продовжувачі|прод\adddot
16−collaborator|учасник|учас\adddot
17−collaborators|учасники|учас\adddot
18−translator|перекладач|пер\adddot
19−translators|перекладачі|пер\adddot
20−commentator|коментатор|комент\adddot
21−commentators|коментатори|комент\adddot
22−annotator|примітки|прим\adddot
23−annotators|примітки|прим\adddot
24−commentary|коментар|комент\adddot
25−annotations|примітки|прим\adddot
26−introduction|вступна стаття|вступ\adddotspace ст\adddot
27−foreword|передмова|передм\adddot
28−afterword|післямова|післям\adddot
29−organizer|організатор|орг\adddot
30−organizers|організатори|орг\adddot
31−byorganizer|організатор|орг\adddot
32−byauthor|згідно автора|згідн\adddot авт\adddot
33−byeditor|за редакцією|за\addabbrvspace ред\adddot
34−bycompiler|укладач|уклад\adddot
35−byredactor|за редакцією|за\addabbrvspace ред\adddot
36−byreviser|виправлено|випр\adddot
37−byreviewer|рецензія|рец\adddot
38−byfounder|засновник|засн\adddot
39−bycontinuator|продовження|продовж\adddot
40−bycollaborator|за участю|за\addabbrvspace уч\adddot
41−bytranslator|переклад \lbx@lfromlang|пер\adddot\ \lbx@sfromlang
42−bycommentator|коментарі|комент\adddot
43−byannotator|примітки|прим\adddot
44−withcommentator|коментарі|комент\adddot
45−withannotator|примітки|прим\adddot
46−withintroduction|вступна стаття|вступ\adddotspace ст\adddot
47−withforeword|передмовие|передм\adddot
48−withafterword|післямовие|післям\adddot
49−and|та|та
50−andothers|та\addabbrvspace ін\adddot|та\addabbrvspace ін\adddot
51−andmore|та\addabbrvspace ін\adddot|та\addabbrvspace ін\adddot
52−volume|том|т\adddot
53−volumes|томах|т\adddot
54−involumes|в|в
55−jourvol|том|т\adddot
56−jourser|серія|сер\adddot
57−book|книга|кн\adddot
58−part|частина|ч\adddot
59−issue|випуск|вип\adddot
60−newseries|нова серія|нов\adddotspace сер\adddot
61−oldseries|стара серія|стар\adddotspace сер\adddot
62−edition|видання|вид\adddot
63−reprint|перевидання|перевид\adddot
64−reprintof|перевидання|перевид\adddot
65−reprintas|перевидано як|перевид\adddotspace як
66−reprintfrom|перевидано з|перевид\adddotspace з
67−translationof|переклад по виданню\addcolon|пер\adddotspace по вид\adddot\addcolon
68−translationas|переклад\addcolon|пер\adddot\addcolon
69−translationfrom|переклад з|пер\adddotspace з
70−reviewof|рецензія на\addcolon|рец\adddotspace на\addcolon
71−astitle|\addcolon|\addcolon
72−bypublisher|\addcomma|\addcomma
73−nodate|б\adddot р\adddot|б\adddot р\adddot
74−page|сторінка|с\adddot
75−pages|сторінки|с\adddot
76−column|колонка|кол\adddot
77−columns|колонки|кол\adddot
78−line|рядок|рядок
79−lines|рядки|рядки
80−verse|вірш|вірш
81−verses|вірші|вірші
82−section|параграф|\S
83−sections|параграфи|\S\S
84−paragraph|абзац|абз\adddot
85−paragraphs|абзаци|абз\adddot
86−pagetotal|сторінка|с\adddot
87−pagetotals|сторінки|с\adddot
88−columntotal|колонка|кол\adddot
89−columntotals|колонки|кол\adddot
90−linetotal|рядок|рядок
91−linetotals|рядки|рядки
92−versetotal|вірш|вірш
93−versetotals|вірші|вірші
94−sectiontotal|параграф|\S
95−sectiontotals|параграфи|\S\S
96−paragraphtotal|абзац|абз\adddot
97−paragraphtotals|абзаци|абз\adddot
98−in|в|в
99−inseries|в|в
100−ofseries|із|із
101−number|номер|№
102−chapter|глава|гл\adddot
data/default.csldeleted−658
@@ -1,658 +0,0 @@
1−<?xml version="1.0" encoding="utf-8"?>
2−<style xmlns="http://purl.org/net/xbiblio/csl" class="in-text" version="1.0" demote-non-dropping-particle="display-and-sort" page-range-format="chicago">
3− <info>
4− <title>Chicago Manual of Style 17th edition (author-date)</title>
5− <id>http://www.zotero.org/styles/chicago-author-date</id>
6− <link href="http://www.zotero.org/styles/chicago-author-date" rel="self"/>
7− <link href="http://www.chicagomanualofstyle.org/tools_citationguide.html" rel="documentation"/>
8− <author>
9− <name>Julian Onions</name>
10− <email>julian.onions@gmail.com</email>
11− </author>
12− <contributor>
13− <name>Sebastian Karcher</name>
14− </contributor>
15− <contributor>
16− <name>Richard Karnesky</name>
17− <email>karnesky+zotero@gmail.com</email>
18− <uri>http://arc.nucapt.northwestern.edu/Richard_Karnesky</uri>
19− </contributor>
20− <contributor>
21− <name>Andrew Dunning</name>
22− <email>andrew.dunning@utoronto.ca</email>
23− <uri>https://orcid.org/0000-0003-0464-5036</uri>
24− </contributor>
25− <contributor>
26− <name>Matthew Roth</name>
27− <email>matthew.g.roth@yale.edu</email>
28− <uri> https://orcid.org/0000-0001-7902-6331</uri>
29− </contributor>
30− <contributor>
31− <name>Brenton M. Wiernik</name>
32− </contributor>
33− <category citation-format="author-date"/>
34− <category field="generic-base"/>
35− <summary>The author-date variant of the Chicago style</summary>
36− <updated>2018-01-24T12:00:00+00:00</updated>
37− <rights license="http://creativecommons.org/licenses/by-sa/3.0/">This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 License</rights>
38− </info>
39− <locale xml:lang="en">
40− <terms>
41− <term name="editor" form="verb-short">ed.</term>
42− <term name="container-author" form="verb">by</term>
43− <term name="translator" form="verb-short">trans.</term>
44− <term name="editortranslator" form="verb">edited and translated by</term>
45− <term name="translator" form="short">trans.</term>
46− </terms>
47− </locale>
48− <macro name="secondary-contributors">
49− <choose>
50− <if type="chapter entry-dictionary entry-encyclopedia paper-conference" match="none">
51− <group delimiter=". ">
52− <names variable="editor translator" delimiter=". ">
53− <label form="verb" text-case="capitalize-first" suffix=" "/>
54− <name and="text" delimiter=", "/>
55− </names>
56− <names variable="director" delimiter=". ">
57− <label form="verb" text-case="capitalize-first" suffix=" "/>
58− <name and="text" delimiter=", "/>
59− </names>
60− </group>
61− </if>
62− </choose>
63− </macro>
64− <macro name="container-contributors">
65− <choose>
66− <if type="chapter entry-dictionary entry-encyclopedia paper-conference" match="any">
67− <group prefix=", " delimiter=", ">
68− <names variable="container-author" delimiter=", ">
69− <label form="verb" suffix=" "/>
70− <name and="text" delimiter=", "/>
71− </names>
72− <names variable="editor translator" delimiter=", ">
73− <label form="verb" suffix=" "/>
74− <name and="text" delimiter=", "/>
75− </names>
76− </group>
77− </if>
78− </choose>
79− </macro>
80− <macro name="editor">
81− <names variable="editor">
82− <name name-as-sort-order="first" and="text" sort-separator=", " delimiter=", " delimiter-precedes-last="always"/>
83− <label form="short" prefix=", "/>
84− </names>
85− </macro>
86− <macro name="translator">
87− <names variable="translator">
88− <name name-as-sort-order="first" and="text" sort-separator=", " delimiter=", " delimiter-precedes-last="always"/>
89− <label form="short" prefix=", "/>
90− </names>
91− </macro>
92− <macro name="recipient">
93− <choose>
94− <if type="personal_communication">
95− <choose>
96− <if variable="genre">
97− <text variable="genre" text-case="capitalize-first"/>
98− </if>
99− <else>
100− <text term="letter" text-case="capitalize-first"/>
101− </else>
102− </choose>
103− </if>
104− </choose>
105− <names variable="recipient" delimiter=", ">
106− <label form="verb" prefix=" " text-case="lowercase" suffix=" "/>
107− <name and="text" delimiter=", "/>
108− </names>
109− </macro>
110− <macro name="substitute-title">
111− <choose>
112− <if type="article-magazine article-newspaper review review-book" match="any">
113− <text macro="container-title"/>
114− </if>
115− </choose>
116− </macro>
117− <macro name="contributors">
118− <group delimiter=". ">
119− <names variable="author">
120− <name and="text" name-as-sort-order="first" sort-separator=", " delimiter=", " delimiter-precedes-last="always"/>
121− <label form="short" prefix=", "/>
122− <substitute>
123− <names variable="editor"/>
124− <names variable="translator"/>
125− <names variable="director"/>
126− <text macro="substitute-title"/>
127− <text macro="title"/>
128− </substitute>
129− </names>
130− <text macro="recipient"/>
131− </group>
132− </macro>
133− <macro name="contributors-short">
134− <names variable="author">
135− <name form="short" and="text" delimiter=", " initialize-with=". "/>
136− <substitute>
137− <names variable="editor"/>
138− <names variable="translator"/>
139− <names variable="director"/>
140− <text macro="substitute-title"/>
141− <text macro="title"/>
142− </substitute>
143− </names>
144− </macro>
145− <macro name="interviewer">
146− <names variable="interviewer" delimiter=", ">
147− <label form="verb" prefix=" " text-case="capitalize-first" suffix=" "/>
148− <name and="text" delimiter=", "/>
149− </names>
150− </macro>
151− <macro name="archive">
152− <group delimiter=". ">
153− <text variable="archive_location" text-case="capitalize-first"/>
154− <text variable="archive"/>
155− <text variable="archive-place"/>
156− </group>
157− </macro>
158− <macro name="access">
159− <group delimiter=". ">
160− <choose>
161− <if type="graphic report" match="any">
162− <text macro="archive"/>
163− </if>
164− <else-if type="article-journal bill book chapter legal_case legislation motion_picture paper-conference" match="none">
165− <text macro="archive"/>
166− </else-if>
167− </choose>
168− <choose>
169− <if type="webpage post-weblog" match="any">
170− <date variable="issued" form="text"/>
171− </if>
172− </choose>
173− <choose>
174− <if variable="issued" match="none">
175− <group delimiter=" ">
176− <text term="accessed" text-case="capitalize-first"/>
177− <date variable="accessed" form="text"/>
178− </group>
179− </if>
180− </choose>
181− <choose>
182− <if type="legal_case" match="none">
183− <choose>
184− <if variable="DOI">
185− <text variable="DOI" prefix="https://doi.org/"/>
186− </if>
187− <else>
188− <text variable="URL"/>
189− </else>
190− </choose>
191− </if>
192− </choose>
193− </group>
194− </macro>
195− <macro name="title">
196− <choose>
197− <if variable="title" match="none">
198− <choose>
199− <if type="personal_communication" match="none">
200− <text variable="genre" text-case="capitalize-first"/>
201− </if>
202− </choose>
203− </if>
204− <else-if type="bill book graphic legislation motion_picture song" match="any">
205− <text variable="title" text-case="title" font-style="italic"/>
206− <group prefix=" (" suffix=")" delimiter=" ">
207− <text term="version"/>
208− <text variable="version"/>
209− </group>
210− </else-if>
211− <else-if variable="reviewed-author">
212− <choose>
213− <if variable="reviewed-title">
214− <group delimiter=". ">
215− <text variable="title" text-case="title" quotes="true"/>
216− <group delimiter=", ">
217− <text variable="reviewed-title" text-case="title" font-style="italic" prefix="Review of "/>
218− <names variable="reviewed-author">
219− <label form="verb-short" text-case="lowercase" suffix=" "/>
220− <name and="text" delimiter=", "/>
221− </names>
222− </group>
223− </group>
224− </if>
225− <else>
226− <group delimiter=", ">
227− <text variable="title" text-case="title" font-style="italic" prefix="Review of "/>
228− <names variable="reviewed-author">
229− <label form="verb-short" text-case="lowercase" suffix=" "/>
230− <name and="text" delimiter=", "/>
231− </names>
232− </group>
233− </else>
234− </choose>
235− </else-if>
236− <else-if type="legal_case interview patent" match="any">
237− <text variable="title"/>
238− </else-if>
239− <else>
240− <text variable="title" text-case="title" quotes="true"/>
241− </else>
242− </choose>
243− </macro>
244− <macro name="edition">
245− <choose>
246− <if type="bill book graphic legal_case legislation motion_picture report song" match="any">
247− <choose>
248− <if is-numeric="edition">
249− <group delimiter=" " prefix=". ">
250− <number variable="edition" form="ordinal"/>
251− <text term="edition" form="short" strip-periods="true"/>
252− </group>
253− </if>
254− <else>
255− <text variable="edition" text-case="capitalize-first" prefix=". "/>
256− </else>
257− </choose>
258− </if>
259− <else-if type="chapter entry-dictionary entry-encyclopedia paper-conference" match="any">
260− <choose>
261− <if is-numeric="edition">
262− <group delimiter=" " prefix=", ">
263− <number variable="edition" form="ordinal"/>
264− <text term="edition" form="short"/>
265− </group>
266− </if>
267− <else>
268− <text variable="edition" prefix=", "/>
269− </else>
270− </choose>
271− </else-if>
272− </choose>
273− </macro>
274− <macro name="locators">
275− <choose>
276− <if type="article-journal">
277− <choose>
278− <if variable="volume">
279− <text variable="volume" prefix=" "/>
280− <group prefix=" (" suffix=")">
281− <choose>
282− <if variable="issue">
283− <text variable="issue"/>
284− </if>
285− <else>
286− <date variable="issued">
287− <date-part name="month"/>
288− </date>
289− </else>
290− </choose>
291− </group>
292− </if>
293− <else-if variable="issue">
294− <group delimiter=" " prefix=", ">
295− <text term="issue" form="short"/>
296− <text variable="issue"/>
297− <date variable="issued" prefix="(" suffix=")">
298− <date-part name="month"/>
299− </date>
300− </group>
301− </else-if>
302− <else>
303− <date variable="issued" prefix=", ">
304− <date-part name="month"/>
305− </date>
306− </else>
307− </choose>
308− </if>
309− <else-if type="legal_case">
310− <text variable="volume" prefix=", "/>
311− <text variable="container-title" prefix=" "/>
312− <text variable="page" prefix=" "/>
313− </else-if>
314− <else-if type="bill book graphic legal_case legislation motion_picture report song" match="any">
315− <group prefix=". " delimiter=". ">
316− <group>
317− <text term="volume" form="short" text-case="capitalize-first" suffix=" "/>
318− <number variable="volume" form="numeric"/>
319− </group>
320− <group>
321− <number variable="number-of-volumes" form="numeric"/>
322− <text term="volume" form="short" prefix=" " plural="true"/>
323− </group>
324− </group>
325− </else-if>
326− <else-if type="chapter entry-dictionary entry-encyclopedia paper-conference" match="any">
327− <choose>
328− <if variable="page" match="none">
329− <group prefix=". ">
330− <text term="volume" form="short" text-case="capitalize-first" suffix=" "/>
331− <number variable="volume" form="numeric"/>
332− </group>
333− </if>
334− </choose>
335− </else-if>
336− </choose>
337− </macro>
338− <macro name="locators-chapter">
339− <choose>
340− <if type="chapter entry-dictionary entry-encyclopedia paper-conference" match="any">
341− <choose>
342− <if variable="page">
343− <group prefix=", ">
344− <text variable="volume" suffix=":"/>
345− <text variable="page"/>
346− </group>
347− </if>
348− </choose>
349− </if>
350− </choose>
351− </macro>
352− <macro name="locators-article">
353− <choose>
354− <if type="article-newspaper">
355− <group prefix=", " delimiter=", ">
356− <group delimiter=" ">
357− <text variable="edition"/>
358− <text term="edition"/>
359− </group>
360− <group>
361− <text term="section" form="short" suffix=" "/>
362− <text variable="section"/>
363− </group>
364− </group>
365− </if>
366− <else-if type="article-journal">
367− <choose>
368− <if variable="volume issue" match="any">
369− <text variable="page" prefix=": "/>
370− </if>
371− <else>
372− <text variable="page" prefix=", "/>
373− </else>
374− </choose>
375− </else-if>
376− </choose>
377− </macro>
378− <macro name="point-locators">
379− <choose>
380− <if variable="locator">
381− <choose>
382− <if locator="page" match="none">
383− <choose>
384− <if type="bill book graphic legal_case legislation motion_picture report song" match="any">
385− <choose>
386− <if variable="volume">
387− <group>
388− <text term="volume" form="short" suffix=" "/>
389− <number variable="volume" form="numeric"/>
390− <label variable="locator" form="short" prefix=", " suffix=" "/>
391− </group>
392− </if>
393− <else>
394− <label variable="locator" form="short" suffix=" "/>
395− </else>
396− </choose>
397− </if>
398− <else>
399− <label variable="locator" form="short" suffix=" "/>
400− </else>
401− </choose>
402− </if>
403− <else-if type="bill book graphic legal_case legislation motion_picture report song" match="any">
404− <number variable="volume" form="numeric" suffix=":"/>
405− </else-if>
406− </choose>
407− <text variable="locator"/>
408− </if>
409− </choose>
410− </macro>
411− <macro name="container-prefix">
412− <text term="in" text-case="capitalize-first"/>
413− </macro>
414− <macro name="container-title">
415− <choose>
416− <if type="chapter entry-dictionary entry-encyclopedia paper-conference" match="any">
417− <text macro="container-prefix" suffix=" "/>
418− </if>
419− </choose>
420− <choose>
421− <if type="webpage">
422− <text variable="container-title" text-case="title"/>
423− </if>
424− <else-if type="legal_case" match="none">
425− <group delimiter=" ">
426− <text variable="container-title" text-case="title" font-style="italic"/>
427− <choose>
428− <if type="post-weblog">
429− <text value="(blog)"/>
430− </if>
431− </choose>
432− </group>
433− </else-if>
434− </choose>
435− </macro>
436− <macro name="publisher">
437− <group delimiter=": ">
438− <text variable="publisher-place"/>
439− <text variable="publisher"/>
440− </group>
441− </macro>
442− <macro name="date">
443− <choose>
444− <if variable="issued">
445− <group delimiter=" ">
446− <date variable="original-date" form="text" date-parts="year" prefix="(" suffix=")"/>
447− <date variable="issued">
448− <date-part name="year"/>
449− </date>
450− </group>
451− </if>
452− <else-if variable="status">
453− <text variable="status" text-case="capitalize-first"/>
454− </else-if>
455− <else>
456− <text term="no date" form="short"/>
457− </else>
458− </choose>
459− </macro>
460− <macro name="date-in-text">
461− <choose>
462− <if variable="issued">
463− <group delimiter=" ">
464− <date variable="original-date" form="text" date-parts="year" prefix="[" suffix="]"/>
465− <date variable="issued">
466− <date-part name="year"/>
467− </date>
468− </group>
469− </if>
470− <else-if variable="status">
471− <text variable="status"/>
472− </else-if>
473− <else>
474− <text term="no date" form="short"/>
475− </else>
476− </choose>
477− </macro>
478− <macro name="day-month">
479− <date variable="issued">
480− <date-part name="month"/>
481− <date-part name="day" prefix=" "/>
482− </date>
483− </macro>
484− <macro name="collection-title">
485− <choose>
486− <if match="none" type="article-journal">
487− <choose>
488− <if match="none" is-numeric="collection-number">
489− <group delimiter=", ">
490− <text variable="collection-title" text-case="title"/>
491− <text variable="collection-number"/>
492− </group>
493− </if>
494− <else>
495− <group delimiter=" ">
496− <text variable="collection-title" text-case="title"/>
497− <text variable="collection-number"/>
498− </group>
499− </else>
500− </choose>
501− </if>
502− </choose>
503− </macro>
504− <macro name="collection-title-journal">
505− <choose>
506− <if type="article-journal">
507− <group delimiter=" ">
508− <text variable="collection-title"/>
509− <text variable="collection-number"/>
510− </group>
511− </if>
512− </choose>
513− </macro>
514− <macro name="event">
515− <group delimiter=" ">
516− <choose>
517− <if variable="genre">
518− <text term="presented at"/>
519− </if>
520− <else>
521− <text term="presented at" text-case="capitalize-first"/>
522− </else>
523− </choose>
524− <text variable="event"/>
525− </group>
526− </macro>
527− <macro name="description">
528− <choose>
529− <if type="interview">
530− <group delimiter=". ">
531− <text macro="interviewer"/>
532− <text variable="medium" text-case="capitalize-first"/>
533− </group>
534− </if>
535− <else-if type="patent">
536− <group delimiter=" " prefix=". ">
537− <text variable="authority"/>
538− <text variable="number"/>
539− </group>
540− </else-if>
541− <else>
542− <text variable="medium" text-case="capitalize-first" prefix=". "/>
543− </else>
544− </choose>
545− <choose>
546− <if variable="title" match="none"/>
547− <else-if type="thesis personal_communication speech" match="any"/>
548− <else>
549− <group delimiter=" " prefix=". ">
550− <text variable="genre" text-case="capitalize-first"/>
551− <choose>
552− <if type="report">
553− <text variable="number"/>
554− </if>
555− </choose>
556− </group>
557− </else>
558− </choose>
559− </macro>
560− <macro name="issue">
561− <choose>
562− <if type="legal_case">
563− <text variable="authority" prefix=". "/>
564− </if>
565− <else-if type="speech">
566− <group prefix=". " delimiter=", ">
567− <group delimiter=" ">
568− <text variable="genre" text-case="capitalize-first"/>
569− <text macro="event"/>
570− </group>
571− <text variable="event-place"/>
572− <text macro="day-month"/>
573− </group>
574− </else-if>
575− <else-if type="article-newspaper article-magazine personal_communication" match="any">
576− <date variable="issued" form="text" prefix=", "/>
577− </else-if>
578− <else-if type="patent">
579− <group delimiter=", " prefix=", ">
580− <group delimiter=" ">
581− <!--Needs Localization-->
582− <text value="filed"/>
583− <date variable="submitted" form="text"/>
584− </group>
585− <group delimiter=" ">
586− <choose>
587− <if variable="issued submitted" match="all">
588− <text term="and"/>
589− </if>
590− </choose>
591− <!--Needs Localization-->
592− <text value="issued"/>
593− <date variable="issued" form="text"/>
594− </group>
595− </group>
596− </else-if>
597− <else-if type="article-journal" match="any"/>
598− <else>
599− <group prefix=". " delimiter=", ">
600− <choose>
601− <if type="thesis">
602− <text variable="genre" text-case="capitalize-first"/>
603− </if>
604− </choose>
605− <text macro="publisher"/>
606− </group>
607− </else>
608− </choose>
609− </macro>
610− <citation et-al-min="4" et-al-use-first="1" disambiguate-add-year-suffix="true" disambiguate-add-names="true" disambiguate-add-givenname="true" givenname-disambiguation-rule="primary-name" collapse="year" after-collapse-delimiter="; ">
611− <layout prefix="(" suffix=")" delimiter="; ">
612− <group delimiter=", ">
613− <choose>
614− <if variable="issued accessed" match="any">
615− <group delimiter=" ">
616− <text macro="contributors-short"/>
617− <text macro="date-in-text"/>
618− </group>
619− </if>
620− <!---comma before forthcoming and n.d.-->
621− <else>
622− <group delimiter=", ">
623− <text macro="contributors-short"/>
624− <text macro="date-in-text"/>
625− </group>
626− </else>
627− </choose>
628− <text macro="point-locators"/>
629− </group>
630− </layout>
631− </citation>
632− <bibliography hanging-indent="true" et-al-min="11" et-al-use-first="7" subsequent-author-substitute="&#8212;&#8212;&#8212;" entry-spacing="0">
633− <sort>
634− <key macro="contributors"/>
635− <key variable="issued"/>
636− <key variable="title"/>
637− </sort>
638− <layout suffix=".">
639− <group delimiter=". ">
640− <text macro="contributors"/>
641− <text macro="date"/>
642− <text macro="title"/>
643− </group>
644− <text macro="description"/>
645− <text macro="secondary-contributors" prefix=". "/>
646− <text macro="container-title" prefix=". "/>
647− <text macro="container-contributors"/>
648− <text macro="edition"/>
649− <text macro="locators-chapter"/>
650− <text macro="collection-title-journal" prefix=", " suffix=", "/>
651− <text macro="locators"/>
652− <text macro="collection-title" prefix=". "/>
653− <text macro="issue"/>
654− <text macro="locators-article"/>
655− <text macro="access" prefix=". "/>
656− </layout>
657− </bibliography>
658−</style>
data/docx/word/settings.xml+16−6
@@ -1,6 +1,6 @@
1<?xml version="1.0" encoding="UTF-8"?>
1<?xml version="1.0" encoding="UTF-8"?>
2<w:settings xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:m="http://schemas.openxmlformats.org/officeDocument/2006/math" xmlns:v="urn:schemas-microsoft-com:vml" xmlns:w10="urn:schemas-microsoft-com:office:word" xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:sl="http://schemas.openxmlformats.org/schemaLibrary/2006/main">
2<w:settings xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:m="http://schemas.openxmlformats.org/officeDocument/2006/math" xmlns:v="urn:schemas-microsoft-com:vml" xmlns:w10="urn:schemas-microsoft-com:office:word" xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:sl="http://schemas.openxmlformats.org/schemaLibrary/2006/main">
3− <w:zoom w:percent="100" />
3+ <w:zoom w:percent="90" />
4 <w:embedSystemFonts />
4 <w:embedSystemFonts />
5 <w:proofState w:spelling="clean" w:grammar="clean" />
5 <w:proofState w:spelling="clean" w:grammar="clean" />
6 <w:stylePaneFormatFilter w:val="0004" />
6 <w:stylePaneFormatFilter w:val="0004" />
@@ -17,21 +17,31 @@
17 <w:characterSpacingControl w:val="doNotCompress" />
17 <w:characterSpacingControl w:val="doNotCompress" />
18 <w:savePreviewPicture />
18 <w:savePreviewPicture />
19 <w:rsids>
19 <w:rsids>
20+ <w:rsidRoot w:val="00590D07" />
21+ <w:rsid w:val="00011C8B" />
22+ <w:rsid w:val="004E29B3" />
23+ <w:rsid w:val="00590D07" />
24+ <w:rsid w:val="00784D58" />
25+ <w:rsid w:val="008D6863" />
26+ <w:rsid w:val="00B86B75" />
27+ <w:rsid w:val="00BC48D5" />
28+ <w:rsid w:val="00C36279" />
29+ <w:rsid w:val="00E315A3" />
20 </w:rsids>
30 </w:rsids>
21 <m:mathPr>
31 <m:mathPr>
22− <m:mathFont m:val="Cambria Math" />
32+ <m:mathFont m:val="Lucida Grande" />
23 <m:brkBin m:val="before" />
33 <m:brkBin m:val="before" />
24 <m:brkBinSub m:val="--" />
34 <m:brkBinSub m:val="--" />
25− <m:smallFrac m:val="0" />
35+ <m:smallFrac m:val="false" />
26− <m:dispDef />
36+ <m:dispDef m:val="false" />
27 <m:lMargin m:val="0" />
37 <m:lMargin m:val="0" />
28 <m:rMargin m:val="0" />
38 <m:rMargin m:val="0" />
29 <m:wrapRight />
39 <m:wrapRight />
30 <m:intLim m:val="subSup" />
40 <m:intLim m:val="subSup" />
31− <m:naryLim m:val="undOvr" />
41+ <m:naryLim m:val="subSup" />
32 </m:mathPr>
42 </m:mathPr>
33 <w:themeFontLang w:val="en-US" />
43 <w:themeFontLang w:val="en-US" />
34 <w:clrSchemeMapping w:bg1="light1" w:t1="dark1" w:bg2="light2" w:t2="dark2" w:accent1="accent1" w:accent2="accent2" w:accent3="accent3" w:accent4="accent4" w:accent5="accent5" w:accent6="accent6" w:hyperlink="hyperlink" w:followedHyperlink="followedHyperlink" />
44 <w:clrSchemeMapping w:bg1="light1" w:t1="dark1" w:bg2="light2" w:t2="dark2" w:accent1="accent1" w:accent2="accent2" w:accent3="accent3" w:accent4="accent4" w:accent5="accent5" w:accent6="accent6" w:hyperlink="hyperlink" w:followedHyperlink="followedHyperlink" />
35 <w:decimalSymbol w:val="." />
45 <w:decimalSymbol w:val="." />
36 <w:listSeparator w:val="," />
46 <w:listSeparator w:val="," />
37−</w:settings>
47+</w:settings>
data/docx/word/styles.xml−19
@@ -350,21 +350,6 @@
350 <w:right w:w="108" w:type="dxa" />
350 <w:right w:w="108" w:type="dxa" />
351 </w:tblCellMar>
351 </w:tblCellMar>
352 </w:tblPr>
352 </w:tblPr>
353− <w:tblStylePr w:type="firstRow">
354− <w:tblPr>
355− <w:jc w:val="left"/>
356− <w:tblInd w:w="0" w:type="dxa"/>
357− </w:tblPr>
358− <w:trPr>
359− <w:jc w:val="left"/>
360− </w:trPr>
361− <w:tcPr>
362− <w:vAlign w:val="bottom"/>
363− <w:tcBorders>
364− <w:bottom w:val="single"/>
365− </w:tcBorders>
366− </w:tcPr>
367− </w:tblStylePr>
368 </w:style>
353 </w:style>
369 <w:style w:type="paragraph" w:customStyle="1" w:styleId="DefinitionTerm">
354 <w:style w:type="paragraph" w:customStyle="1" w:styleId="DefinitionTerm">
370 <w:name w:val="Definition Term" />
355 <w:name w:val="Definition Term" />
@@ -429,10 +414,6 @@
429 <w:sz w:val="22" />
414 <w:sz w:val="22" />
430 </w:rPr>
415 </w:rPr>
431 </w:style>
416 </w:style>
432− <w:style w:type="character" w:customStyle="1" w:styleId="SectionNumber">
433− <w:name w:val="Section Number" />
434− <w:basedOn w:val="BodyTextChar" />
435− </w:style>
436 <w:style w:type="character" w:styleId="FootnoteReference">
417 <w:style w:type="character" w:styleId="FootnoteReference">
437 <w:name w:val="Footnote Reference" />
418 <w:name w:val="Footnote Reference" />
438 <w:basedOn w:val="BodyTextChar" />
419 <w:basedOn w:val="BodyTextChar" />
data/epub.css+2−3
@@ -7,10 +7,9 @@ h3 { text-align: left; }
7h4 { text-align: left; }
7h4 { text-align: left; }
8h5 { text-align: left; }
8h5 { text-align: left; }
9h6 { text-align: left; }
9h6 { text-align: left; }
10−/* For title, author, and date on the cover page */
11h1.title { }
10h1.title { }
12−p.author { }
11+h2.author { }
13−p.date { }
12+h3.date { }
14nav#toc ol,
13nav#toc ol,
15nav#landmarks ol { padding: 0; margin-left: 1em; }
14nav#landmarks ol { padding: 0; margin-left: 1em; }
16nav#toc ol li,
15nav#toc ol li,
test/command/jats.csl → data/jats.cslrenamed+7−12
@@ -26,8 +26,8 @@
26 <text variable="citation-number" prefix="{{jats}}id=&quot;ref-{{/jats}}" suffix="{{jats}}&quot;&gt;{{/jats}}"/>
26 <text variable="citation-number" prefix="{{jats}}id=&quot;ref-{{/jats}}" suffix="{{jats}}&quot;&gt;{{/jats}}"/>
27 </macro>
27 </macro>
28 <macro name="author">
28 <macro name="author">
29− <names variable="author">
29+ <names variable="author" delimiter=" ">
30− <name prefix="{{jats}}&lt;name&gt;{{/jats}}" suffix="{{jats}}&lt;/name&gt;{{/jats}}" name-as-sort-order="all" sort-separator="">
30+ <name prefix="{{jats}}&lt;name&gt;{{/jats}}" suffix="{{jats}}&lt;/name&gt;{{/jats}}" name-as-sort-order="all" sort-separator=" ">
31 <name-part name="family" text-case="capitalize-first" prefix="{{jats}}&lt;surname&gt;{{/jats}}" suffix="{{jats}}&lt;/surname&gt;{{/jats}}"/>
31 <name-part name="family" text-case="capitalize-first" prefix="{{jats}}&lt;surname&gt;{{/jats}}" suffix="{{jats}}&lt;/surname&gt;{{/jats}}"/>
32 <name-part name="given" text-case="capitalize-first" prefix="{{jats}}&lt;given-names&gt;{{/jats}}" suffix="{{jats}}&lt;/given-names&gt;{{/jats}}"/>
32 <name-part name="given" text-case="capitalize-first" prefix="{{jats}}&lt;given-names&gt;{{/jats}}" suffix="{{jats}}&lt;/given-names&gt;{{/jats}}"/>
33 </name>
33 </name>
@@ -37,9 +37,9 @@
37 </names>
37 </names>
38 </macro>
38 </macro>
39
39
40− <macro name="editor">
40+ <macro name="editor" delimiter=" ">
41 <names variable="editor" prefix="{{jats}}&lt;person-group person-group-type=&quot;editor&quot;&gt;{{/jats}}" suffix="{{jats}}&lt;/person-group&gt;{{/jats}}">
41 <names variable="editor" prefix="{{jats}}&lt;person-group person-group-type=&quot;editor&quot;&gt;{{/jats}}" suffix="{{jats}}&lt;/person-group&gt;{{/jats}}">
42− <name prefix="{{jats}}&lt;name&gt;{{/jats}}" suffix="{{jats}}&lt;/name&gt;{{/jats}}" name-as-sort-order="all" sort-separator="">
42+ <name prefix="{{jats}}&lt;name&gt;{{/jats}}" suffix="{{jats}}&lt;/name&gt;{{/jats}}" name-as-sort-order="all" sort-separator=" ">
43 <name-part name="family" text-case="capitalize-first" prefix="{{jats}}&lt;surname&gt;{{/jats}}" suffix="{{jats}}&lt;/surname&gt;{{/jats}}"/>
43 <name-part name="family" text-case="capitalize-first" prefix="{{jats}}&lt;surname&gt;{{/jats}}" suffix="{{jats}}&lt;/surname&gt;{{/jats}}"/>
44 <name-part name="given" text-case="capitalize-first" prefix="{{jats}}&lt;given-names&gt;{{/jats}}" suffix="{{jats}}&lt;/given-names&gt;{{/jats}}"/>
44 <name-part name="given" text-case="capitalize-first" prefix="{{jats}}&lt;given-names&gt;{{/jats}}" suffix="{{jats}}&lt;/given-names&gt;{{/jats}}"/>
45 </name>
45 </name>
@@ -64,7 +64,7 @@
64 <if type="book" match="any">
64 <if type="book" match="any">
65 <group prefix="{{jats}}&lt;source&gt;{{/jats}}" suffix="{{jats}}&lt;/source&gt;{{/jats}}">
65 <group prefix="{{jats}}&lt;source&gt;{{/jats}}" suffix="{{jats}}&lt;/source&gt;{{/jats}}">
66 <text variable="title"/>
66 <text variable="title"/>
67− </group>
67+ </group>
68 </if>
68 </if>
69 <else>
69 <else>
70 <group prefix="{{jats}}&lt;article-title&gt;{{/jats}}" suffix="{{jats}}&lt;/article-title&gt;{{/jats}}">
70 <group prefix="{{jats}}&lt;article-title&gt;{{/jats}}" suffix="{{jats}}&lt;/article-title&gt;{{/jats}}">
@@ -90,18 +90,14 @@
90 </choose>
90 </choose>
91 <choose>
91 <choose>
92 <if match="any" variable="PMID">
92 <if match="any" variable="PMID">
93− <group prefix="{{jats}}&lt;ext-link ext-link-type=&quot;pmid&quot; {{/jats}}" suffix="{{jats}}&lt;/ext-link&gt;{{/jats}}">
93+ <group prefix="{{jats}}&lt;pub-id pub-id-type=&quot;pmid&quot;&gt;{{/jats}}" suffix="{{jats}}&lt;/pub-id&gt;{{/jats}}">
94− <text variable="PMID" prefix="{{jats}}xlink:href=&quot;http://www.ncbi.nlm.nih.gov/pubmed/{{/jats}}" suffix="{{jats}}&quot; xlink:type=&quot;simple&quot;&gt;{{/jats}}"/>
95 <text variable="PMID"/>
94 <text variable="PMID"/>
96 </group>
95 </group>
97 </if>
96 </if>
98 </choose>
97 </choose>
99 <choose>
98 <choose>
100 <if variable="URL" match="any">
99 <if variable="URL" match="any">
101− <group prefix="{{jats}}&lt;ext-link ext-link-type=&quot;uri&quot; {{/jats}}" suffix="{{jats}}&lt;/ext-link&gt;{{/jats}}">
100+ <text variable="URL" />
102− <text variable="URL" prefix="{{jats}}xlink:href=&quot;{{/jats}}" suffix="{{jats}}&quot; xlink:type=&quot;simple&quot;&gt;{{/jats}}"/>
103− <text variable="URL"/>
104− </group>
105 </if>
101 </if>
106 </choose>
102 </choose>
107 </macro>
103 </macro>
@@ -205,4 +201,3 @@
205 </layout>
201 </layout>
206 </bibliography>
202 </bibliography>
207</style>
203</style>
208−
data/make-reference-files.hsnew file+27
@@ -0,0 +1,27 @@
1+import System.Environment
2+import System.Directory
3+import Codec.Archive.Zip
4+import qualified Data.ByteString.Lazy as BS
5+import qualified Control.Exception as E
6+import System.IO.Error (isDoesNotExistError)
7+import System.FilePath
8+
9+mkzip :: String -> IO ()
10+mkzip fmt = do
11+ let dir = "data" </> fmt
12+ output = "data" </> "reference" <.> fmt
13+ cd <- getCurrentDirectory
14+ setCurrentDirectory dir
15+ archive <- addFilesToArchive [OptRecursive] emptyArchive ["."]
16+ setCurrentDirectory cd
17+ removeIfExists output
18+ BS.writeFile output $ fromArchive archive
19+
20+removeIfExists :: FilePath -> IO ()
21+removeIfExists fileName = removeFile fileName `E.catch` handleExists
22+ where handleExists e
23+ | isDoesNotExistError e = return ()
24+ | otherwise = E.throwIO e
25+
26+main :: IO ()
27+main = getArgs >>= mkzip . (!!0)
data/odt/styles.xml+1−1
@@ -350,7 +350,7 @@ xmlns:css3t="http://www.w3.org/TR/css3-text/" office:version="1.2">
350 </style:style>
350 </style:style>
351 <style:style style:name="First_20_paragraph"
351 <style:style style:name="First_20_paragraph"
352 style:display-name="First paragraph" style:family="paragraph"
352 style:display-name="First paragraph" style:family="paragraph"
353− style:parent-style-name="Text_20_body"
353+ style:parent-style-name="Standard"
354 style:next-style-name="Text_20_body" style:class="text" />
354 style:next-style-name="Text_20_body" style:class="text" />
355 <style:style style:name="Numbering_20_Symbols"
355 <style:style style:name="Numbering_20_Symbols"
356 style:display-name="Numbering Symbols" style:family="text" />
356 style:display-name="Numbering Symbols" style:family="text" />
data/pandoc.lua+3−27
@@ -556,18 +556,18 @@ M.RawBlock = M.Block:create_constructor(
556
556
557--- Creates a table element.
557--- Creates a table element.
558-- @function Table
558-- @function Table
559+-- @tparam Attr attr attributes
559-- @tparam Caption caption table caption
560-- @tparam Caption caption table caption
560-- @tparam {ColSpec,...} colspecs column alignments and widths
561-- @tparam {ColSpec,...} colspecs column alignments and widths
561-- @tparam TableHead head table head
562-- @tparam TableHead head table head
562-- @tparam {TableBody,..} bodies table bodies
563-- @tparam {TableBody,..} bodies table bodies
563-- @treturn TableFoot foot table foot
564-- @treturn TableFoot foot table foot
564−-- @tparam[opt] Attr attr attributes
565M.Table = M.Block:create_constructor(
565M.Table = M.Block:create_constructor(
566 "Table",
566 "Table",
567− function(caption, colspecs, head, bodies, foot, attr)
567+ function(attr, caption, colspecs, head, bodies, foot)
568 return {
568 return {
569 c = {
569 c = {
570− ensureAttr(attr),
570+ attr,
571 caption,
571 caption,
572 List:new(colspecs),
572 List:new(colspecs),
573 head,
573 head,
@@ -1058,30 +1058,6 @@ M.ListAttributes.behavior.__pairs = function(t)
1058 return make_next_function(fields), t, nil
1058 return make_next_function(fields), t, nil
1059end
1059end
1060
1060
1061−--
1062−-- Legacy and compatibility types
1063−--
1064−
1065−--- Creates a simple (old style) table element.
1066−-- @function SimpleTable
1067−-- @tparam {Inline,...} caption table caption
1068−-- @tparam {AlignDefault|AlignLeft|AlignRight|AlignCenter,...} aligns alignments
1069−-- @tparam {int,...} widths column widths
1070−-- @tparam {Block,...} headers header row
1071−-- @tparam {{Block,...}} rows table rows
1072−-- @treturn Block table element
1073−M.SimpleTable = function(caption, aligns, widths, headers, rows)
1074− return {
1075− caption = ensureInlineList(caption),
1076− aligns = List:new(aligns),
1077− widths = List:new(widths),
1078− headers = List:new(headers),
1079− rows = List:new(rows),
1080− tag = "SimpleTable",
1081− t = "SimpleTable",
1082− }
1083−end
1084−
1085
1061
1086------------------------------------------------------------------------
1062------------------------------------------------------------------------
1087-- Constants
1063-- Constants
data/sample.lua+8−7
@@ -21,7 +21,7 @@ local stringify = (require "pandoc.utils").stringify
21-- configure the writer.
21-- configure the writer.
22local meta = PANDOC_DOCUMENT.meta
22local meta = PANDOC_DOCUMENT.meta
23
23
24−-- Choose the image format based on the value of the
24+-- Chose the image format based on the value of the
25-- `image_format` meta value.
25-- `image_format` meta value.
26local image_format = meta.image_format
26local image_format = meta.image_format
27 and stringify(meta.image_format)
27 and stringify(meta.image_format)
@@ -45,9 +45,9 @@ local function escape(s, in_attribute)
45 return '&gt;'
45 return '&gt;'
46 elseif x == '&' then
46 elseif x == '&' then
47 return '&amp;'
47 return '&amp;'
48− elseif in_attribute and x == '"' then
48+ elseif x == '"' then
49 return '&quot;'
49 return '&quot;'
50− elseif in_attribute and x == "'" then
50+ elseif x == "'" then
51 return '&#39;'
51 return '&#39;'
52 else
52 else
53 return x
53 return x
@@ -141,8 +141,8 @@ function Strikeout(s)
141 return '<del>' .. s .. '</del>'
141 return '<del>' .. s .. '</del>'
142end
142end
143
143
144−function Link(s, tgt, tit, attr)
144+function Link(s, src, tit, attr)
145− return "<a href='" .. escape(tgt,true) .. "' title='" ..
145+ return "<a href='" .. escape(src,true) .. "' title='" ..
146 escape(tit,true) .. "'>" .. s .. "</a>"
146 escape(tit,true) .. "'>" .. s .. "</a>"
147end
147end
148
148
@@ -271,7 +271,7 @@ end
271
271
272-- Convert pandoc alignment to something HTML can use.
272-- Convert pandoc alignment to something HTML can use.
273-- align is AlignLeft, AlignRight, AlignCenter, or AlignDefault.
273-- align is AlignLeft, AlignRight, AlignCenter, or AlignDefault.
274−local function html_align(align)
274+function html_align(align)
275 if align == 'AlignLeft' then
275 if align == 'AlignLeft' then
276 return 'left'
276 return 'left'
277 elseif align == 'AlignRight' then
277 elseif align == 'AlignRight' then
@@ -286,7 +286,7 @@ end
286function CaptionedImage(src, tit, caption, attr)
286function CaptionedImage(src, tit, caption, attr)
287 return '<div class="figure">\n<img src="' .. escape(src,true) ..
287 return '<div class="figure">\n<img src="' .. escape(src,true) ..
288 '" title="' .. escape(tit,true) .. '"/>\n' ..
288 '" title="' .. escape(tit,true) .. '"/>\n' ..
289− '<p class="caption">' .. escape(caption) .. '</p>\n</div>'
289+ '<p class="caption">' .. caption .. '</p>\n</div>'
290end
290end
291
291
292-- Caption is a string, aligns is an array of strings,
292-- Caption is a string, aligns is an array of strings,
@@ -357,3 +357,4 @@ meta.__index =
357 return function() return "" end
357 return function() return "" end
358 end
358 end
359setmetatable(_G, meta)
359setmetatable(_G, meta)
360+
data/templates/.github/ISSUE_TEMPLATE.mdnew file+3
@@ -0,0 +1,3 @@
1+This repository is now maintained as a subtree of
2+[jgm/pandoc](https://github.com/jgm/pandoc). Please open
3+your issue there, not here.
data/templates/.github/PULL_REQUEST_TEMPLATE.mdnew file+4
@@ -0,0 +1,4 @@
1+This repository is now maintained as a subtree of
2+[jgm/pandoc](https://github.com/jgm/pandoc). Please open
3+your pull request there, not here.
4+
data/templates/README.markdownnew file+49
@@ -0,0 +1,49 @@
1+The [pandoc-templates] repository contains default templates for [pandoc].
2+
3+If you use custom templates, we recommend forking this
4+repository, so that you can integrate changes to the default
5+templates in future pandoc releases.
6+
7+This repository is a subtree of [pandoc]; it will be updated
8+each time there is a new pandoc release. However, changes to
9+templates are made first in [pandoc]; thus, issues and pull
10+requests should be made [pandoc]'s issue tracker rather than
11+here.
12+
13+[pandoc]: https://github.com/jgm/pandoc
14+[pandoc-templates]: https://github.com/jgm/pandoc-templates
15+
16+All of the templates in this repository are dual licensed, under both
17+the GPL (v2 or higher, same as pandoc) and the BSD 3-clause license
18+(included below).
19+
20+Copyright (c) 2014--2019, John MacFarlane
21+
22+All rights reserved.
23+
24+Redistribution and use in source and binary forms, with or without
25+modification, are permitted provided that the following conditions are met:
26+
27+* Redistributions of source code must retain the above copyright
28+ notice, this list of conditions and the following disclaimer.
29+
30+* Redistributions in binary form must reproduce the above
31+ copyright notice, this list of conditions and the following
32+ disclaimer in the documentation and/or other materials provided
33+ with the distribution.
34+
35+* Neither the name of John MacFarlane nor the names of other
36+ contributors may be used to endorse or promote products derived
37+ from this software without specific prior written permission.
38+
39+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
40+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
41+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
42+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
43+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
44+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
45+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
46+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
47+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
48+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
49+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
data/templates/affiliations.jatsdeleted−38
@@ -1,38 +0,0 @@
1−$--
2−$-- Affiliations
3−$--
4−$for(affiliation)$
5−<aff id="aff-$affiliation.id$">
6−$-- wrap affiliation if it has a known institution identifier
7−$if(affiliation.group)$
8−<institution content-type="group">$affiliation.group$</institution>
9−$endif$
10−$if(affiliation.department)$
11−<institution content-type="dept">$affiliation.department$</institution>
12−$endif$
13−<institution-wrap>
14−$if(affiliation.organization)$
15−<institution>$affiliation.organization$</institution>
16−$else$
17−<institution>$affiliation.name$</institution>
18−$endif$
19−$if(affiliation.isni)$
20−<institution-id institution-id-type="ISNI">$affiliation.isni$</institution-id>
21−$endif$
22−$if(affiliation.ringgold)$
23−<institution-id institution-id-type="Ringgold">$affiliation.ringgold$</institution-id>
24−$endif$
25−$if(affiliation.ror)$
26−<institution-id institution-id-type="ROR">$affiliation.ror$</institution-id>
27−$endif$
28−$for(affiliation.pid)$
29−<institution-id institution-id-type="$affiliation.pid.type$">$affiliation.pid.id$</institution-id>
30−$endfor$
31−</institution-wrap>$if(affiliation.street-address)$,
32−$for(affiliation.street-address)$
33−<addr-line>$affiliation.street-address$</addr-line>$sep$,
34−$endfor$
35−$else$$if(affiliation.city)$, <city>$affiliation.city$</city>$endif$$endif$$if(affiliation.country)$,
36−<country$if(affiliation.country-code)$ country="$affiliation.country-code$"$endif$>$affiliation.country$</country>$endif$
37−</aff>
38−$endfor$
data/templates/article.jats_publishing+7−23
@@ -14,13 +14,6 @@ $endif$
14$if(journal.pmc)$
14$if(journal.pmc)$
15<journal-id journal-id-type="pmc">$journal.pmc$</journal-id>
15<journal-id journal-id-type="pmc">$journal.pmc$</journal-id>
16$endif$
16$endif$
17−$-- Fallback: an empty journal-id in case none is available.
18−$if(journal.publisher-id)$
19−$elseif(journal.nlm-ta)$
20−$elseif(journal.pmc)$
21−$else$
22−<journal-id></journal-id>
23−$endif$
24<journal-title-group>
17<journal-title-group>
25$if(journal.title)$
18$if(journal.title)$
26<journal-title>$journal.title$</journal-title>
19<journal-title>$journal.title$</journal-title>
@@ -30,16 +23,10 @@ $if(journal.abbrev-title)$
30$endif$
23$endif$
31</journal-title-group>
24</journal-title-group>
32$if(journal.pissn)$
25$if(journal.pissn)$
33−<issn publication-format="print">$journal.pissn$</issn>
26+<issn pub-type="ppub">$journal.pissn$</issn>
34$endif$
27$endif$
35$if(journal.eissn)$
28$if(journal.eissn)$
36−<issn publication-format="electronic">$journal.eissn$</issn>
29+<issn pub-type="epub">$journal.eissn$</issn>
37−$endif$
38−$-- At least one issn element is required; use empty issn as fallback
39−$if(journal.pissn)$
40−$elseif(journal.eissn)$
41−$else$
42−<issn></issn>
43$endif$
30$endif$
44<publisher>
31<publisher>
45<publisher-name>$journal.publisher-name$</publisher-name>
32<publisher-name>$journal.publisher-name$</publisher-name>
@@ -86,7 +73,7 @@ $endif$
86$if(author)$
73$if(author)$
87<contrib-group>
74<contrib-group>
88$for(author)$
75$for(author)$
89−<contrib contrib-type="author"$if(author.equal-contrib)$ equal-contrib="true"$endif$>
76+<contrib contrib-type="author">
90$if(author.orcid)$
77$if(author.orcid)$
91<contrib-id contrib-id-type="orcid">$author.orcid$</contrib-id>
78<contrib-id contrib-id-type="orcid">$author.orcid$</contrib-id>
92$endif$
79$endif$
@@ -95,23 +82,20 @@ $if(author.surname)$
95<surname>$author.surname$</surname>
82<surname>$author.surname$</surname>
96<given-names>$author.given-names$</given-names>
83<given-names>$author.given-names$</given-names>
97</name>
84</name>
98−$elseif(author.name)$
99−<string-name>$author.name$</string-name>
100$else$
85$else$
101<string-name>$author$</string-name>
86<string-name>$author$</string-name>
102$endif$
87$endif$
103$if(author.email)$
88$if(author.email)$
104<email>$author.email$</email>
89<email>$author.email$</email>
105$endif$
90$endif$
106−$for(author.affiliation)$
91+$if(author.aff-id)$
107−<xref ref-type="aff" rid="aff-$author.affiliation$"/>
92+<xref ref-type="aff" rid="aff-$contrib.aff-id$"/>
108−$endfor$
93+$endif$
109$if(author.cor-id)$
94$if(author.cor-id)$
110<xref ref-type="corresp" rid="cor-$author.cor-id$"><sup>*</sup></xref>
95<xref ref-type="corresp" rid="cor-$author.cor-id$"><sup>*</sup></xref>
111$endif$
96$endif$
112</contrib>
97</contrib>
113$endfor$
98$endfor$
114−${ affiliations.jats() }
115</contrib-group>
99</contrib-group>
116$endif$
100$endif$
117$if(article.author-notes)$
101$if(article.author-notes)$
@@ -130,7 +114,7 @@ $endif$
130</author-notes>
114</author-notes>
131$endif$
115$endif$
132$if(date)$
116$if(date)$
133−<pub-date date-type="$if(date.type)$$date.type$$else$pub$endif$" publication-format="electronic"$if(date.iso-8601)$ iso-8601-date="$date.iso-8601$"$endif$>
117+<pub-date pub-type="epub"$if(date.iso-8601)$ iso-8601-date="$date.iso-8601$"$endif$>
134$if(date.day)$
118$if(date.day)$
135<day>$date.day$</day>
119<day>$date.day$</day>
136$endif$
120$endif$
data/templates/default.biblatexdeleted−10
@@ -1,10 +0,0 @@
1−$for(header-includes)$
2−$header-includes$
3−$endfor$
4−$for(include-before)$
5−$include-before$
6−$endfor$
7−$body$
8−$for(include-after)$
9−$include-after$
10−$endfor$
data/templates/default.bibtexdeleted−10
@@ -1,10 +0,0 @@
1−$for(header-includes)$
2−$header-includes$
3−$endfor$
4−$for(include-before)$
5−$include-before$
6−$endfor$
7−$body$
8−$for(include-after)$
9−$include-after$
10−$endfor$
data/templates/default.context+8−10
@@ -51,7 +51,6 @@ $endif$
51
51
52% use microtypography
52% use microtypography
53\definefontfeature[default][default][script=latn, protrusion=quality, expansion=quality, itlc=yes, textitalics=yes, onum=yes, pnum=yes]
53\definefontfeature[default][default][script=latn, protrusion=quality, expansion=quality, itlc=yes, textitalics=yes, onum=yes, pnum=yes]
54−\definefontfeature[default:tnum][default][tnum=yes, pnum=no]
55\definefontfeature[smallcaps][script=latn, protrusion=quality, expansion=quality, smcp=yes, onum=yes, pnum=yes]
54\definefontfeature[smallcaps][script=latn, protrusion=quality, expansion=quality, smcp=yes, onum=yes, pnum=yes]
56\setupalign[hz,hanging]
55\setupalign[hz,hanging]
57\setupitaliccorrection[global, always]
56\setupitaliccorrection[global, always]
@@ -73,9 +72,9 @@ $if(interlinespace)$
73\setupinterlinespace[$for(interlinespace)$$interlinespace$$sep$,$endfor$]
72\setupinterlinespace[$for(interlinespace)$$interlinespace$$sep$,$endfor$]
74$endif$
73$endif$
75
74
76−\setuphead[chapter] [style=\tfd\setupinterlinespace,header=empty]
75+\setuphead[chapter] [style=\tfd,header=empty]
77−\setuphead[section] [style=\tfc\setupinterlinespace]
76+\setuphead[section] [style=\tfc]
78−\setuphead[subsection] [style=\tfb\setupinterlinespace]
77+\setuphead[subsection] [style=\tfb]
79\setuphead[subsubsection] [style=\bf]
78\setuphead[subsubsection] [style=\bf]
80\setuphead[subsubsubsection] [style=\sc]
79\setuphead[subsubsubsection] [style=\sc]
81\setuphead[subsubsubsubsection][style=\it]
80\setuphead[subsubsubsubsection][style=\it]
@@ -98,12 +97,11 @@ $endif$
98\setupitemize[autointro] % prevent orphan list intro
97\setupitemize[autointro] % prevent orphan list intro
99\setupitemize[indentnext=no]
98\setupitemize[indentnext=no]
100
99
101−\defineitemgroup[enumerate]
102−\setupenumerate[each][fit][itemalign=left,distance=.5em,style={\feature[+][default:tnum]}]
103−
104\setupfloat[figure][default={here,nonumber}]
100\setupfloat[figure][default={here,nonumber}]
105\setupfloat[table][default={here,nonumber}]
101\setupfloat[table][default={here,nonumber}]
106
102
103+\setupthinrules[width=15em] % width of horizontal rules
104+
107\setupxtable[frame=off]
105\setupxtable[frame=off]
108\setupxtable[head][topframe=on,bottomframe=on]
106\setupxtable[head][topframe=on,bottomframe=on]
109\setupxtable[body][]
107\setupxtable[body][]
@@ -164,12 +162,12 @@ $endfor$
164$if(toc)$
162$if(toc)$
165\completecontent
163\completecontent
166$endif$
164$endif$
167−$if(lof)$
168−\completelistoffigures
169−$endif$
170$if(lot)$
165$if(lot)$
171\completelistoftables
166\completelistoftables
172$endif$
167$endif$
168+$if(lof)$
169+\completelistoffigures
170+$endif$
173
171
174$body$
172$body$
175
173
data/templates/default.dzslides+1−1
@@ -171,7 +171,7 @@ $if(subtitle)$
171 <h1 class="subtitle">$subtitle$</h1>
171 <h1 class="subtitle">$subtitle$</h1>
172$endif$
172$endif$
173 <footer>
173 <footer>
174− $if(author)$<span class="author">$for(author)$$author$$sep$, $endfor$</span> · $endif$$if(institute)$<span class="institute">$for(institute)$$institute$$sep$, $endfor$</span> · $endif$$if(date)$<span class="date">$date$</span>$endif$
174+ $if(author)$<span class="author">$for(author)$$author$$sep$, $endfor$</span>$endif$ · $if(date)$<span class="date">$date$</span>$endif$
175 </footer>
175 </footer>
176</section>
176</section>
177$endif$
177$endif$
data/templates/default.epub2+1−1
@@ -48,7 +48,7 @@ $endif$
48$else$
48$else$
49$if(coverpage)$
49$if(coverpage)$
50<div id="cover-image">
50<div id="cover-image">
51−<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="100%" height="100%" viewBox="0 0 $cover-image-width$ $cover-image-height$" preserveAspectRatio="xMidYMid">
51+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="100%" height="100%" viewBox="0 0 $cover-image-width$ $cover-image-height$" preserveAspectRatio="none">
52<image width="$cover-image-width$" height="$cover-image-height$" xlink:href="../media/$cover-image$" />
52<image width="$cover-image-width$" height="$cover-image-height$" xlink:href="../media/$cover-image$" />
53</svg>
53</svg>
54</div>
54</div>
data/templates/default.epub3+1−1
@@ -49,7 +49,7 @@ $endif$
49$else$
49$else$
50$if(coverpage)$
50$if(coverpage)$
51<div id="cover-image">
51<div id="cover-image">
52−<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="100%" height="100%" viewBox="0 0 $cover-image-width$ $cover-image-height$" preserveAspectRatio="xMidYMid">
52+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="100%" height="100%" viewBox="0 0 $cover-image-width$ $cover-image-height$" preserveAspectRatio="none">
53<image width="$cover-image-width$" height="$cover-image-height$" xlink:href="../media/$cover-image$" />
53<image width="$cover-image-width$" height="$cover-image-height$" xlink:href="../media/$cover-image$" />
54</svg>
54</svg>
55</div>
55</div>
data/templates/default.html4−3
@@ -12,9 +12,6 @@ $if(date-meta)$
12$endif$
12$endif$
13$if(keywords)$
13$if(keywords)$
14 <meta name="keywords" content="$for(keywords)$$keywords$$sep$, $endfor$" />
14 <meta name="keywords" content="$for(keywords)$$keywords$$sep$, $endfor$" />
15−$endif$
16−$if(description-meta)$
17− <meta name="description" content="$description-meta$" />
18$endif$
15$endif$
19 <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$</title>
16 <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$</title>
20 <style type="text/css">
17 <style type="text/css">
data/templates/default.html5−3
@@ -12,9 +12,6 @@ $if(date-meta)$
12$endif$
12$endif$
13$if(keywords)$
13$if(keywords)$
14 <meta name="keywords" content="$for(keywords)$$keywords$$sep$, $endfor$" />
14 <meta name="keywords" content="$for(keywords)$$keywords$$sep$, $endfor$" />
15−$endif$
16−$if(description-meta)$
17− <meta name="description" content="$description-meta$" />
18$endif$
15$endif$
19 <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$</title>
16 <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$</title>
20 <style>
17 <style>
data/templates/default.jats_articleauthoring+4−7
@@ -19,7 +19,7 @@ $endif$
19$if(author)$
19$if(author)$
20<contrib-group>
20<contrib-group>
21$for(author)$
21$for(author)$
22−<contrib contrib-type="author"$if(author.equal-contrib)$ equal-contrib="true"$endif$>
22+<contrib contrib-type="author">
23$if(author.orcid)$
23$if(author.orcid)$
24<contrib-id contrib-id-type="orcid">$author.orcid$</contrib-id>
24<contrib-id contrib-id-type="orcid">$author.orcid$</contrib-id>
25$endif$
25$endif$
@@ -28,23 +28,20 @@ $if(author.surname)$
28<surname>$author.surname$</surname>
28<surname>$author.surname$</surname>
29<given-names>$author.given-names$</given-names>
29<given-names>$author.given-names$</given-names>
30</name>
30</name>
31−$elseif(author.name)$
32−<string-name>$author.name$</string-name>
33$else$
31$else$
34<string-name>$author$</string-name>
32<string-name>$author$</string-name>
35$endif$
33$endif$
36$if(author.email)$
34$if(author.email)$
37<email>$author.email$</email>
35<email>$author.email$</email>
38$endif$
36$endif$
39−$for(author.affiliation)$
37+$if(author.aff-id)$
40−<xref ref-type="aff" rid="aff-$author.affiliation$"/>
38+<xref ref-type="aff" rid="aff-$contrib.aff-id$"/>
41−$endfor$
39+$endif$
42$if(author.cor-id)$
40$if(author.cor-id)$
43<xref ref-type="corresp" rid="cor-$author.cor-id$"><sup>*</sup></xref>
41<xref ref-type="corresp" rid="cor-$author.cor-id$"><sup>*</sup></xref>
44$endif$
42$endif$
45</contrib>
43</contrib>
46$endfor$
44$endfor$
47−${ affiliations.jats() }
48</contrib-group>
45</contrib-group>
49$endif$
46$endif$
50$if(copyright)$
47$if(copyright)$
data/templates/default.latex+28−80
@@ -2,7 +2,7 @@
2\PassOptionsToPackage{unicode$for(hyperrefoptions)$,$hyperrefoptions$$endfor$}{hyperref}
2\PassOptionsToPackage{unicode$for(hyperrefoptions)$,$hyperrefoptions$$endfor$}{hyperref}
3\PassOptionsToPackage{hyphens}{url}
3\PassOptionsToPackage{hyphens}{url}
4$if(colorlinks)$
4$if(colorlinks)$
5−\PassOptionsToPackage{dvipsnames,svgnames,x11names}{xcolor}
5+\PassOptionsToPackage{dvipsnames,svgnames*,x11names*}{xcolor}
6$endif$
6$endif$
7$if(dir)$
7$if(dir)$
8$if(latex-dir-rtl)$
8$if(latex-dir-rtl)$
@@ -89,7 +89,6 @@ $endif$
89$if(beamerarticle)$
89$if(beamerarticle)$
90\usepackage{beamerarticle} % needs to be loaded first
90\usepackage{beamerarticle} % needs to be loaded first
91$endif$
91$endif$
92−\usepackage{amsmath,amssymb}
93$if(fontfamily)$
92$if(fontfamily)$
94\usepackage[$for(fontfamilyoptions)$$fontfamilyoptions$$sep$,$endfor$]{$fontfamily$}
93\usepackage[$for(fontfamilyoptions)$$fontfamilyoptions$$sep$,$endfor$]{$fontfamily$}
95$else$
94$else$
@@ -98,14 +97,15 @@ $endif$
98$if(linestretch)$
97$if(linestretch)$
99\usepackage{setspace}
98\usepackage{setspace}
100$endif$
99$endif$
101−\usepackage{iftex}
100+\usepackage{amssymb,amsmath}
102−\ifPDFTeX
101+\usepackage{ifxetex,ifluatex}
102+\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
103 \usepackage[$if(fontenc)$$fontenc$$else$T1$endif$]{fontenc}
103 \usepackage[$if(fontenc)$$fontenc$$else$T1$endif$]{fontenc}
104 \usepackage[utf8]{inputenc}
104 \usepackage[utf8]{inputenc}
105 \usepackage{textcomp} % provide euro and other symbols
105 \usepackage{textcomp} % provide euro and other symbols
106\else % if luatex or xetex
106\else % if luatex or xetex
107$if(mathspec)$
107$if(mathspec)$
108− \ifXeTeX
108+ \ifxetex
109 \usepackage{mathspec}
109 \usepackage{mathspec}
110 \else
110 \else
111 \usepackage{unicode-math}
111 \usepackage{unicode-math}
@@ -129,7 +129,7 @@ $for(fontfamilies)$
129$endfor$
129$endfor$
130$if(mathfont)$
130$if(mathfont)$
131$if(mathspec)$
131$if(mathspec)$
132− \ifXeTeX
132+ \ifxetex
133 \setmathfont(Digits,Latin,Greek)[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
133 \setmathfont(Digits,Latin,Greek)[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
134 \else
134 \else
135 \setmathfont[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
135 \setmathfont[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
@@ -139,42 +139,23 @@ $else$
139$endif$
139$endif$
140$endif$
140$endif$
141$if(CJKmainfont)$
141$if(CJKmainfont)$
142− \ifXeTeX
142+ \ifxetex
143 \usepackage{xeCJK}
143 \usepackage{xeCJK}
144 \setCJKmainfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
144 \setCJKmainfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
145 \fi
145 \fi
146$endif$
146$endif$
147$if(luatexjapresetoptions)$
147$if(luatexjapresetoptions)$
148− \ifLuaTeX
148+ \ifluatex
149 \usepackage[$for(luatexjapresetoptions)$$luatexjapresetoptions$$sep$,$endfor$]{luatexja-preset}
149 \usepackage[$for(luatexjapresetoptions)$$luatexjapresetoptions$$sep$,$endfor$]{luatexja-preset}
150 \fi
150 \fi
151$endif$
151$endif$
152$if(CJKmainfont)$
152$if(CJKmainfont)$
153− \ifLuaTeX
153+ \ifluatex
154 \usepackage[$for(luatexjafontspecoptions)$$luatexjafontspecoptions$$sep$,$endfor$]{luatexja-fontspec}
154 \usepackage[$for(luatexjafontspecoptions)$$luatexjafontspecoptions$$sep$,$endfor$]{luatexja-fontspec}
155 \setmainjfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
155 \setmainjfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
156 \fi
156 \fi
157$endif$
157$endif$
158\fi
158\fi
159−$if(zero-width-non-joiner)$
160−%% Support for zero-width non-joiner characters.
161−\makeatletter
162−\def\zerowidthnonjoiner{%
163− % Prevent ligatures and adjust kerning, but still support hyphenating.
164− \texorpdfstring{%
165− \textormath{\nobreak\discretionary{-}{}{\kern.03em}%
166− \ifvmode\else\nobreak\hskip\z@skip\fi}{}%
167− }{}%
168−}
169−\makeatother
170−\ifPDFTeX
171− \DeclareUnicodeCharacter{200C}{\zerowidthnonjoiner}
172−\else
173− \catcode`^^^^200c=\active
174− \protected\def ^^^^200c{\zerowidthnonjoiner}
175−\fi
176−%% End of ZWNJ support
177−$endif$
178$if(beamer)$
159$if(beamer)$
179$if(theme)$
160$if(theme)$
180\usetheme[$for(themeoptions)$$themeoptions$$sep$,$endfor$]{$theme$}
161\usetheme[$for(themeoptions)$$themeoptions$$sep$,$endfor$]{$theme$}
@@ -238,10 +219,10 @@ $if(keywords)$
238$endif$
219$endif$
239$if(colorlinks)$
220$if(colorlinks)$
240 colorlinks=true,
221 colorlinks=true,
241− linkcolor={$if(linkcolor)$$linkcolor$$else$Maroon$endif$},
222+ linkcolor=$if(linkcolor)$$linkcolor$$else$Maroon$endif$,
242− filecolor={$if(filecolor)$$filecolor$$else$Maroon$endif$},
223+ filecolor=$if(filecolor)$$filecolor$$else$Maroon$endif$,
243− citecolor={$if(citecolor)$$citecolor$$else$Blue$endif$},
224+ citecolor=$if(citecolor)$$citecolor$$else$Blue$endif$,
244− urlcolor={$if(urlcolor)$$urlcolor$$else$Blue$endif$},
225+ urlcolor=$if(urlcolor)$$urlcolor$$else$Blue$endif$,
245$else$
226$else$
246 hidelinks,
227 hidelinks,
247$endif$
228$endif$
@@ -273,11 +254,7 @@ $if(highlighting-macros)$
273$highlighting-macros$
254$highlighting-macros$
274$endif$
255$endif$
275$if(tables)$
256$if(tables)$
276−\usepackage{longtable,booktabs,array}
257+\usepackage{longtable,booktabs}
277−$if(multirow)$
278−\usepackage{multirow}
279−$endif$
280−\usepackage{calc} % for calculating minipage widths
281$if(beamer)$
258$if(beamer)$
282\usepackage{caption}
259\usepackage{caption}
283% Make caption package work with longtable
260% Make caption package work with longtable
@@ -344,36 +321,11 @@ $endif$
344$if(pagestyle)$
321$if(pagestyle)$
345\pagestyle{$pagestyle$}
322\pagestyle{$pagestyle$}
346$endif$
323$endif$
347−$if(csl-refs)$
348−\newlength{\cslhangindent}
349−\setlength{\cslhangindent}{1.5em}
350−\newlength{\csllabelwidth}
351−\setlength{\csllabelwidth}{3em}
352−\newlength{\cslentryspacingunit} % times entry-spacing
353−\setlength{\cslentryspacingunit}{\parskip}
354−\newenvironment{CSLReferences}[2] % #1 hanging-ident, #2 entry spacing
355− {% don't indent paragraphs
356− \setlength{\parindent}{0pt}
357− % turn on hanging indent if param 1 is 1
358− \ifodd #1
359− \let\oldpar\par
360− \def\par{\hangindent=\cslhangindent\oldpar}
361− \fi
362− % set entry spacing
363− \setlength{\parskip}{#2\cslentryspacingunit}
364− }%
365− {}
366−\usepackage{calc}
367−\newcommand{\CSLBlock}[1]{#1\hfill\break}
368−\newcommand{\CSLLeftMargin}[1]{\parbox[t]{\csllabelwidth}{#1}}
369−\newcommand{\CSLRightInline}[1]{\parbox[t]{\linewidth - \csllabelwidth}{#1}\break}
370−\newcommand{\CSLIndent}[1]{\hspace{\cslhangindent}#1}
371−$endif$
372$for(header-includes)$
324$for(header-includes)$
373$header-includes$
325$header-includes$
374$endfor$
326$endfor$
375$if(lang)$
327$if(lang)$
376−\ifXeTeX
328+\ifxetex
377 % Load polyglossia as late as possible: uses bidi with RTL langages (e.g. Hebrew, Arabic)
329 % Load polyglossia as late as possible: uses bidi with RTL langages (e.g. Hebrew, Arabic)
378 \usepackage{polyglossia}
330 \usepackage{polyglossia}
379 \setmainlanguage[$for(polyglossia-lang.options)$$polyglossia-lang.options$$sep$,$endfor$]{$polyglossia-lang.name$}
331 \setmainlanguage[$for(polyglossia-lang.options)$$polyglossia-lang.options$$sep$,$endfor$]{$polyglossia-lang.name$}
@@ -381,24 +333,18 @@ $for(polyglossia-otherlangs)$
381 \setotherlanguage[$for(polyglossia-otherlangs.options)$$polyglossia-otherlangs.options$$sep$,$endfor$]{$polyglossia-otherlangs.name$}
333 \setotherlanguage[$for(polyglossia-otherlangs.options)$$polyglossia-otherlangs.options$$sep$,$endfor$]{$polyglossia-otherlangs.name$}
382$endfor$
334$endfor$
383\else
335\else
384− \usepackage[$for(babel-otherlangs)$$babel-otherlangs$,$endfor$main=$babel-lang$]{babel}
336+ \usepackage[shorthands=off,$for(babel-otherlangs)$$babel-otherlangs$,$endfor$main=$babel-lang$]{babel}
385−% get rid of language-specific shorthands (see #6817):
386−\let\LanguageShortHands\languageshorthands
387−\def\languageshorthands#1{}
388$if(babel-newcommands)$
337$if(babel-newcommands)$
389 $babel-newcommands$
338 $babel-newcommands$
390$endif$
339$endif$
391\fi
340\fi
392$endif$
341$endif$
393−\ifLuaTeX
394− \usepackage{selnolig} % disable illegal ligatures
395−\fi
396$if(dir)$
342$if(dir)$
397−\ifXeTeX
343+\ifxetex
398 % Load bidi as late as possible as it modifies e.g. graphicx
344 % Load bidi as late as possible as it modifies e.g. graphicx
399 \usepackage{bidi}
345 \usepackage{bidi}
400\fi
346\fi
401−\ifPDFTeX
347+\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
402 \TeXXeTstate=1
348 \TeXXeTstate=1
403 \newcommand{\RL}[1]{\beginR #1\endR}
349 \newcommand{\RL}[1]{\beginR #1\endR}
404 \newcommand{\LR}[1]{\beginL #1\endL}
350 \newcommand{\LR}[1]{\beginL #1\endL}
@@ -416,11 +362,13 @@ $for(bibliography)$
416\addbibresource{$bibliography$}
362\addbibresource{$bibliography$}
417$endfor$
363$endfor$
418$endif$
364$endif$
419−$if(nocite-ids)$
365+$if(csl-refs)$
420−\nocite{$for(nocite-ids)$$it$$sep$, $endfor$}
366+\newlength{\cslhangindent}
421−$endif$
367+\setlength{\cslhangindent}{1.5em}
422−$if(csquotes)$
368+\newenvironment{cslreferences}%
423−\usepackage{csquotes}
369+ {$if(csl-hanging-indent)$\setlength{\parindent}{0pt}%
370+ \everypar{\setlength{\hangindent}{\cslhangindent}}\ignorespaces$endif$}%
371+ {\par}
424$endif$
372$endif$
425
373
426$if(title)$
374$if(title)$
@@ -494,12 +442,12 @@ $endif$
494}
442}
495$endif$
443$endif$
496$endif$
444$endif$
497−$if(lof)$
498−\listoffigures
499−$endif$
500$if(lot)$
445$if(lot)$
501\listoftables
446\listoftables
502$endif$
447$endif$
448+$if(lof)$
449+\listoffigures
450+$endif$
503$if(linestretch)$
451$if(linestretch)$
504\setstretch{$linestretch$}
452\setstretch{$linestretch$}
505$endif$
453$endif$
data/templates/default.man+1−1
@@ -1,5 +1,5 @@
1$if(has-tables)$
1$if(has-tables)$
2−'\" t
2+.\"t
3$endif$
3$endif$
4$if(pandoc-version)$
4$if(pandoc-version)$
5.\" Automatically generated by Pandoc $pandoc-version$
5.\" Automatically generated by Pandoc $pandoc-version$
data/templates/default.opendocument+1−1
@@ -31,7 +31,7 @@ $include-before$
31$endfor$
31$endfor$
32$if(toc)$
32$if(toc)$
33<text:table-of-content>
33<text:table-of-content>
34− <text:table-of-content-source text:outline-level="$toc-depth$">
34+ <text:table-of-content-source text:outline-level="10">
35 <text:index-title-template text:style-name="Contents_20_Heading">$toc-title$</text:index-title-template>
35 <text:index-title-template text:style-name="Contents_20_Heading">$toc-title$</text:index-title-template>
36 <text:table-of-content-entry-template text:outline-level="1"
36 <text:table-of-content-entry-template text:outline-level="1"
37 text:style-name="Contents_20_1">
37 text:style-name="Contents_20_1">
data/templates/default.org+3−3
@@ -1,12 +1,12 @@
1$if(title)$
1$if(title)$
2−#+title: $title$
2+#+TITLE: $title$
3
3
4$endif$
4$endif$
5$if(author)$
5$if(author)$
6−#+author: $for(author)$$author$$sep$; $endfor$
6+#+AUTHOR: $for(author)$$author$$sep$; $endfor$
7$endif$
7$endif$
8$if(date)$
8$if(date)$
9−#+date: $date$
9+#+DATE: $date$
10
10
11$endif$
11$endif$
12$for(header-includes)$
12$for(header-includes)$
data/templates/default.revealjs+122−84
@@ -52,9 +52,6 @@ $endif$
52$for(author)$
52$for(author)$
53 <p class="author">$author$</p>
53 <p class="author">$author$</p>
54$endfor$
54$endfor$
55−$for(institute)$
56− <p class="institute">$institute$</p>
57−$endfor$
58$if(date)$
55$if(date)$
59 <p class="date">$date$</p>
56 <p class="date">$date$</p>
60$endif$
57$endif$
@@ -62,12 +59,7 @@ $endif$
62$endif$
59$endif$
63$if(toc)$
60$if(toc)$
64<section id="$idprefix$TOC">
61<section id="$idprefix$TOC">
65−<nav role="doc-toc">
66−$if(toc-title)$
67−<h2 id="$idprefix$toc-title">$toc-title$</h2>
68−$endif$
69$table-of-contents$
62$table-of-contents$
70−</nav>
71</section>
63</section>
72$endif$
64$endif$
73
65
@@ -77,7 +69,7 @@ $body$
77
69
78 <script src="$revealjs-url$/dist/reveal.js"></script>
70 <script src="$revealjs-url$/dist/reveal.js"></script>
79
71
80− <!-- reveal.js plugins -->
72+ // reveal.js plugins
81 <script src="$revealjs-url$/plugin/notes/notes.js"></script>
73 <script src="$revealjs-url$/plugin/notes/notes.js"></script>
82 <script src="$revealjs-url$/plugin/search/search.js"></script>
74 <script src="$revealjs-url$/plugin/search/search.js"></script>
83 <script src="$revealjs-url$/plugin/zoom/zoom.js"></script>
75 <script src="$revealjs-url$/plugin/zoom/zoom.js"></script>
@@ -90,198 +82,244 @@ $endif$
90 // Full list of configuration options available at:
82 // Full list of configuration options available at:
91 // https://revealjs.com/config/
83 // https://revealjs.com/config/
92 Reveal.initialize({
84 Reveal.initialize({
85+$if(controls)$
93 // Display controls in the bottom right corner
86 // Display controls in the bottom right corner
94 controls: $controls$,
87 controls: $controls$,
95−
88+$endif$
89+$if(controlsTutorial)$
96 // Help the user learn the controls by providing hints, for example by
90 // Help the user learn the controls by providing hints, for example by
97 // bouncing the down arrow when they first encounter a vertical slide
91 // bouncing the down arrow when they first encounter a vertical slide
98 controlsTutorial: $controlsTutorial$,
92 controlsTutorial: $controlsTutorial$,
99−
93+$endif$
94+$if(controlsLayout)$
100 // Determines where controls appear, "edges" or "bottom-right"
95 // Determines where controls appear, "edges" or "bottom-right"
101− controlsLayout: '$controlsLayout$',
96+ controlsLayout: $controlsLayout$,
102−
97+$endif$
98+$if(controlsBackArrows)$
103 // Visibility rule for backwards navigation arrows; "faded", "hidden"
99 // Visibility rule for backwards navigation arrows; "faded", "hidden"
104 // or "visible"
100 // or "visible"
105− controlsBackArrows: '$controlsBackArrows$',
101+ controlsBackArrows: $controlsBackArrows$,
106−
102+$endif$
103+$if(progress)$
107 // Display a presentation progress bar
104 // Display a presentation progress bar
108 progress: $progress$,
105 progress: $progress$,
109−
106+$endif$
107+$if(slideNumber)$
110 // Display the page number of the current slide
108 // Display the page number of the current slide
111 slideNumber: $slideNumber$,
109 slideNumber: $slideNumber$,
112−
110+$endif$
113− // 'all', 'print', or 'speaker'
111+$if(hash)$
114− showSlideNumber: '$showSlideNumber$',
115−
116 // Add the current slide number to the URL hash so that reloading the
112 // Add the current slide number to the URL hash so that reloading the
117 // page/copying the URL will return you to the same slide
113 // page/copying the URL will return you to the same slide
118 hash: $hash$,
114 hash: $hash$,
119−
115+$endif$
120− // Start with 1 for the hash rather than 0
121− hashOneBasedIndex: $hashOneBasedIndex$,
122−
123− // Flags if we should monitor the hash and change slides accordingly
124− respondToHashChanges: $respondToHashChanges$,
125−
126 // Push each slide change to the browser history
116 // Push each slide change to the browser history
117+$if(history)$
127 history: $history$,
118 history: $history$,
128−
119+$else$
120+ history: true,
121+$endif$
122+$if(keyboard)$
129 // Enable keyboard shortcuts for navigation
123 // Enable keyboard shortcuts for navigation
130 keyboard: $keyboard$,
124 keyboard: $keyboard$,
131−
125+$endif$
126+$if(overview)$
132 // Enable the slide overview mode
127 // Enable the slide overview mode
133 overview: $overview$,
128 overview: $overview$,
134−
129+$endif$
135− // Disables the default reveal.js slide layout (scaling and centering)
130+$if(center)$
136− // so that you can use custom CSS layout
137− disableLayout: false,
138−
139 // Vertical centering of slides
131 // Vertical centering of slides
140 center: $center$,
132 center: $center$,
141−
133+$endif$
134+$if(touch)$
142 // Enables touch navigation on devices with touch input
135 // Enables touch navigation on devices with touch input
143 touch: $touch$,
136 touch: $touch$,
144−
137+$endif$
138+$if(loop)$
145 // Loop the presentation
139 // Loop the presentation
146 loop: $loop$,
140 loop: $loop$,
147−
141+$endif$
142+$if(rtl)$
148 // Change the presentation direction to be RTL
143 // Change the presentation direction to be RTL
149 rtl: $rtl$,
144 rtl: $rtl$,
150−
145+$endif$
146+$if(navigationMode)$
151 // see https://revealjs.com/vertical-slides/#navigation-mode
147 // see https://revealjs.com/vertical-slides/#navigation-mode
152 navigationMode: '$navigationMode$',
148 navigationMode: '$navigationMode$',
153−
149+$endif$
150+$if(shuffle)$
154 // Randomizes the order of slides each time the presentation loads
151 // Randomizes the order of slides each time the presentation loads
155 shuffle: $shuffle$,
152 shuffle: $shuffle$,
156−
153+$endif$
154+$if(fragments)$
157 // Turns fragments on and off globally
155 // Turns fragments on and off globally
158 fragments: $fragments$,
156 fragments: $fragments$,
159−
157+$endif$
158+$if(fragmentInURL)$
160 // Flags whether to include the current fragment in the URL,
159 // Flags whether to include the current fragment in the URL,
161 // so that reloading brings you to the same fragment position
160 // so that reloading brings you to the same fragment position
162 fragmentInURL: $fragmentInURL$,
161 fragmentInURL: $fragmentInURL$,
163−
162+$endif$
163+$if(embedded)$
164 // Flags if the presentation is running in an embedded mode,
164 // Flags if the presentation is running in an embedded mode,
165 // i.e. contained within a limited portion of the screen
165 // i.e. contained within a limited portion of the screen
166 embedded: $embedded$,
166 embedded: $embedded$,
167−
167+$endif$
168+$if(help)$
168 // Flags if we should show a help overlay when the questionmark
169 // Flags if we should show a help overlay when the questionmark
169 // key is pressed
170 // key is pressed
170 help: $help$,
171 help: $help$,
171−
172+$endif$
172− // Flags if it should be possible to pause the presentation (blackout)
173+$if(showNotes)$
173− pause: $pause$,
174−
175 // Flags if speaker notes should be visible to all viewers
174 // Flags if speaker notes should be visible to all viewers
176 showNotes: $showNotes$,
175 showNotes: $showNotes$,
177−
176+$endif$
177+$if(autoPlayMedia)$
178− // Global override for autoplaying embedded media (null/true/false)
178+ // Global override for autoplaying embedded media (video/audio/iframe)
179+ // - null: Media will only autoplay if data-autoplay is present
180+ // - true: All media will autoplay, regardless of individual setting
181+ // - false: No media will autoplay, regardless of individual setting
179 autoPlayMedia: $autoPlayMedia$,
182 autoPlayMedia: $autoPlayMedia$,
180−
183+$endif$
184+$if(preloadIframes)$
181− // Global override for preloading lazy-loaded iframes (null/true/false)
185+ // Global override for preloading lazy-loaded iframes
186+ // - null: Iframes with data-src AND data-preload will be loaded when within
187+ // the viewDistance, iframes with only data-src will be loaded when visible
188+ // - true: All iframes with data-src will be loaded when within the viewDistance
189+ // - false: All iframes with data-src will be loaded only when visible
182 preloadIframes: $preloadIframes$,
190 preloadIframes: $preloadIframes$,
183−
191+$endif$
192+$if(autoSlide)$
184 // Number of milliseconds between automatically proceeding to the
193 // Number of milliseconds between automatically proceeding to the
185 // next slide, disabled when set to 0, this value can be overwritten
194 // next slide, disabled when set to 0, this value can be overwritten
186 // by using a data-autoslide attribute on your slides
195 // by using a data-autoslide attribute on your slides
187 autoSlide: $autoSlide$,
196 autoSlide: $autoSlide$,
188−
197+$endif$
198+$if(autoSlideStoppable)$
189 // Stop auto-sliding after user input
199 // Stop auto-sliding after user input
190 autoSlideStoppable: $autoSlideStoppable$,
200 autoSlideStoppable: $autoSlideStoppable$,
191−
201+$endif$
202+$if(autoSlideMethod)$
192 // Use this method for navigation when auto-sliding
203 // Use this method for navigation when auto-sliding
193 autoSlideMethod: $autoSlideMethod$,
204 autoSlideMethod: $autoSlideMethod$,
194−
205+$endif$
206+$if(defaultTiming)$
195 // Specify the average time in seconds that you think you will spend
207 // Specify the average time in seconds that you think you will spend
196 // presenting each slide. This is used to show a pacing timer in the
208 // presenting each slide. This is used to show a pacing timer in the
197 // speaker view
209 // speaker view
198 defaultTiming: $defaultTiming$,
210 defaultTiming: $defaultTiming$,
199−
211+$endif$
212+$if(totalTime)$
213+ // Specify the total time in seconds that is available to
214+ // present. If this is set to a nonzero value, the pacing
215+ // timer will work out the time available for each slide,
216+ // instead of using the defaultTiming value
217+ totalTime: $totalTime$,
218+$endif$
219+$if(minimumTimePerSlide)$
220+ // Specify the minimum amount of time you want to allot to
221+ // each slide, if using the totalTime calculation method. If
222+ // the automated time allocation causes slide pacing to fall
223+ // below this threshold, then you will see an alert in the
224+ // speaker notes window
225+ minimumTimePerSlide: $minimumTimePerSlide$,
226+$endif$
227+$if(mouseWheel)$
200 // Enable slide navigation via mouse wheel
228 // Enable slide navigation via mouse wheel
201 mouseWheel: $mouseWheel$,
229 mouseWheel: $mouseWheel$,
202−
230+$endif$
203− // The display mode that will be used to show slides
231+$if(rollingLinks)$
204− display: '$display$',
232+ // Apply a 3D roll to links on hover
205−
233+ rollingLinks: $rollingLinks$,
234+$endif$
235+$if(hideInactiveCursor)$
206 // Hide cursor if inactive
236 // Hide cursor if inactive
207 hideInactiveCursor: $hideInactiveCursor$,
237 hideInactiveCursor: $hideInactiveCursor$,
208−
238+$endif$
239+$if(hideCursorTime)$
209 // Time before the cursor is hidden (in ms)
240 // Time before the cursor is hidden (in ms)
210 hideCursorTime: $hideCursorTime$,
241 hideCursorTime: $hideCursorTime$,
211−
242+$endif$
243+$if(hideAddressBar)$
244+ // Hides the address bar on mobile devices
245+ hideAddressBar: $hideAddressBar$,
246+$endif$
247+$if(previewLinks)$
212 // Opens links in an iframe preview overlay
248 // Opens links in an iframe preview overlay
213 previewLinks: $previewLinks$,
249 previewLinks: $previewLinks$,
214−
250+$endif$
251+$if(transition)$
252+ // Transition style
215− // Transition style (none/fade/slide/convex/concave/zoom)
253+ transition: '$transition$', // none/fade/slide/convex/concave/zoom
216− transition: '$transition$',
254+$endif$
217−
255+$if(transitionSpeed)$
218− // Transition speed (default/fast/slow)
256+ // Transition speed
219− transitionSpeed: '$transitionSpeed$',
257+ transitionSpeed: '$transitionSpeed$', // default/fast/slow
220−
258+$endif$
259+$if(backgroundTransition)$
221 // Transition style for full page slide backgrounds
260 // Transition style for full page slide backgrounds
222− // (none/fade/slide/convex/concave/zoom)
261+ backgroundTransition: '$backgroundTransition$', // none/fade/slide/convex/concave/zoom
223− backgroundTransition: '$backgroundTransition$',
262+$endif$
224−
263+$if(viewDistance)$
225 // Number of slides away from the current that are visible
264 // Number of slides away from the current that are visible
226 viewDistance: $viewDistance$,
265 viewDistance: $viewDistance$,
227−
266+$endif$
267+$if(mobileViewDistance)$
228 // Number of slides away from the current that are visible on mobile
268 // Number of slides away from the current that are visible on mobile
229 // devices. It is advisable to set this to a lower number than
269 // devices. It is advisable to set this to a lower number than
230 // viewDistance in order to save resources.
270 // viewDistance in order to save resources.
231 mobileViewDistance: $mobileViewDistance$,
271 mobileViewDistance: $mobileViewDistance$,
272+$endif$
232$if(parallaxBackgroundImage)$
273$if(parallaxBackgroundImage)$
233−
234 // Parallax background image
274 // Parallax background image
235 parallaxBackgroundImage: '$parallaxBackgroundImage$', // e.g. "'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg'"
275 parallaxBackgroundImage: '$parallaxBackgroundImage$', // e.g. "'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg'"
236$else$
276$else$
237$if(background-image)$
277$if(background-image)$
238−
239 // Parallax background image
278 // Parallax background image
240 parallaxBackgroundImage: '$background-image$', // e.g. "'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg'"
279 parallaxBackgroundImage: '$background-image$', // e.g. "'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg'"
241$endif$
280$endif$
242$endif$
281$endif$
243$if(parallaxBackgroundSize)$
282$if(parallaxBackgroundSize)$
244−
245 // Parallax background size
283 // Parallax background size
246 parallaxBackgroundSize: '$parallaxBackgroundSize$', // CSS syntax, e.g. "2100px 900px"
284 parallaxBackgroundSize: '$parallaxBackgroundSize$', // CSS syntax, e.g. "2100px 900px"
247$endif$
285$endif$
248$if(parallaxBackgroundHorizontal)$
286$if(parallaxBackgroundHorizontal)$
249−
250 // Amount to move parallax background (horizontal and vertical) on slide change
287 // Amount to move parallax background (horizontal and vertical) on slide change
251 // Number, e.g. 100
288 // Number, e.g. 100
252 parallaxBackgroundHorizontal: $parallaxBackgroundHorizontal$,
289 parallaxBackgroundHorizontal: $parallaxBackgroundHorizontal$,
253$endif$
290$endif$
254$if(parallaxBackgroundVertical)$
291$if(parallaxBackgroundVertical)$
255−
256 parallaxBackgroundVertical: $parallaxBackgroundVertical$,
292 parallaxBackgroundVertical: $parallaxBackgroundVertical$,
257$endif$
293$endif$
258$if(width)$
294$if(width)$
259−
260 // The "normal" size of the presentation, aspect ratio will be preserved
295 // The "normal" size of the presentation, aspect ratio will be preserved
261 // when the presentation is scaled to fit different resolutions. Can be
296 // when the presentation is scaled to fit different resolutions. Can be
262 // specified using percentage units.
297 // specified using percentage units.
263 width: $width$,
298 width: $width$,
264$endif$
299$endif$
265$if(height)$
300$if(height)$
266−
267 height: $height$,
301 height: $height$,
268$endif$
302$endif$
269$if(margin)$
303$if(margin)$
270−
271 // Factor of the display size that should remain empty around the content
304 // Factor of the display size that should remain empty around the content
272 margin: $margin$,
305 margin: $margin$,
273$endif$
306$endif$
274$if(minScale)$
307$if(minScale)$
275−
276 // Bounds for smallest/largest possible scale to apply to content
308 // Bounds for smallest/largest possible scale to apply to content
277 minScale: $minScale$,
309 minScale: $minScale$,
278$endif$
310$endif$
279$if(maxScale)$
311$if(maxScale)$
280−
281 maxScale: $maxScale$,
312 maxScale: $maxScale$,
282$endif$
313$endif$
314+$if(zoomKey)$
315+ // Modifier key used to click-zoom to part of the slide
316+ zoomKey: '$zoomKey$',
317+$endif$
318+$if(display)$
319+ // The display mode that will be used to show slides
320+ display: $display$,
321+$endif$
283$if(mathjax)$
322$if(mathjax)$
284−
285 math: {
323 math: {
286 mathjax: '$mathjaxurl$',
324 mathjax: '$mathjaxurl$',
287 config: 'TeX-AMS_HTML-full',
325 config: 'TeX-AMS_HTML-full',
data/templates/default.s5−3
@@ -61,9 +61,6 @@ $endif$
61$if(author)$
61$if(author)$
62 <h3 class="author">$for(author)$$author$$sep$<br/>$endfor$</h3>
62 <h3 class="author">$for(author)$$author$$sep$<br/>$endfor$</h3>
63$endif$
63$endif$
64−$if(institute)$
65− <h3 class="institute">$for(institute)$$institute$$sep$<br/>$endfor$</h3>
66−$endif$
67$if(date)$
64$if(date)$
68 <h4 class="date">$date$</h4>
65 <h4 class="date">$date$</h4>
69$endif$
66$endif$
data/templates/default.slideous−7
@@ -63,16 +63,9 @@ $if(title)$
63$if(subtitle)$
63$if(subtitle)$
64 <h1 class="subtitle">$subtitle$</h1>
64 <h1 class="subtitle">$subtitle$</h1>
65$endif$
65$endif$
66−$if(author)$
67 <p class="author">
66 <p class="author">
68$for(author)$$author$$sep$<br/>$endfor$
67$for(author)$$author$$sep$<br/>$endfor$
69 </p>
68 </p>
70−$endif$
71−$if(institute)$
72− <p class="institute">
73−$for(institute)$$institute$$sep$<br/>$endfor$
74− </p>
75−$endif$
76$if(date)$
69$if(date)$
77 <p class="date">$date$</p>
70 <p class="date">$date$</p>
78$endif$
71$endif$
data/templates/default.slidy−5
@@ -52,11 +52,6 @@ $if(author)$
52$for(author)$$author$$sep$<br/>$endfor$
52$for(author)$$author$$sep$<br/>$endfor$
53 </p>
53 </p>
54$endif$
54$endif$
55−$if(institute)$
56− <p class="institute">
57−$for(institute)$$institute$$sep$<br/>$endfor$
58− </p>
59−$endif$
60$if(date)$
55$if(date)$
61 <p class="date">$date$</p>
56 <p class="date">$date$</p>
62$endif$
57$endif$
data/templates/styles.html−165
@@ -1,144 +1,3 @@
1−$if(document-css)$
2−html {
3− line-height: $if(linestretch)$$linestretch$$else$1.5$endif$;
4− font-family: $if(mainfont)$$mainfont$$else$Georgia, serif$endif$;
5− font-size: $if(fontsize)$$fontsize$$else$20px$endif$;
6− color: $if(fontcolor)$$fontcolor$$else$#1a1a1a$endif$;
7− background-color: $if(backgroundcolor)$$backgroundcolor$$else$#fdfdfd$endif$;
8−}
9−body {
10− margin: 0 auto;
11− max-width: 36em;
12− padding-left: $if(margin-left)$$margin-left$$else$50px$endif$;
13− padding-right: $if(margin-right)$$margin-right$$else$50px$endif$;
14− padding-top: $if(margin-top)$$margin-top$$else$50px$endif$;
15− padding-bottom: $if(margin-bottom)$$margin-bottom$$else$50px$endif$;
16− hyphens: auto;
17− overflow-wrap: break-word;
18− text-rendering: optimizeLegibility;
19− font-kerning: normal;
20−}
21−@media (max-width: 600px) {
22− body {
23− font-size: 0.9em;
24− padding: 1em;
25− }
26−}
27−@media print {
28− body {
29− background-color: transparent;
30− color: black;
31− font-size: 12pt;
32− }
33− p, h2, h3 {
34− orphans: 3;
35− widows: 3;
36− }
37− h2, h3, h4 {
38− page-break-after: avoid;
39− }
40−}
41−p {
42− margin: 1em 0;
43−}
44−a {
45− color: $if(linkcolor)$$linkcolor$$else$#1a1a1a$endif$;
46−}
47−a:visited {
48− color: $if(linkcolor)$$linkcolor$$else$#1a1a1a$endif$;
49−}
50−img {
51− max-width: 100%;
52−}
53−h1, h2, h3, h4, h5, h6 {
54− margin-top: 1.4em;
55−}
56−h5, h6 {
57− font-size: 1em;
58− font-style: italic;
59−}
60−h6 {
61− font-weight: normal;
62−}
63−ol, ul {
64− padding-left: 1.7em;
65− margin-top: 1em;
66−}
67−li > ol, li > ul {
68− margin-top: 0;
69−}
70−blockquote {
71− margin: 1em 0 1em 1.7em;
72− padding-left: 1em;
73− border-left: 2px solid #e6e6e6;
74− color: #606060;
75−}
76−code {
77− font-family: $if(monofont)$$monofont$$else$Menlo, Monaco, 'Lucida Console', Consolas, monospace$endif$;
78−$if(monobackgroundcolor)$
79− background-color: $monobackgroundcolor$;
80− padding: .2em .4em;
81−$endif$
82− font-size: 85%;
83− margin: 0;
84−}
85−pre {
86− margin: 1em 0;
87−$if(monobackgroundcolor)$
88− background-color: $monobackgroundcolor$;
89− padding: 1em;
90−$endif$
91− overflow: auto;
92−}
93−pre code {
94− padding: 0;
95− overflow: visible;
96− overflow-wrap: normal;
97−}
98−.sourceCode {
99− background-color: transparent;
100− overflow: visible;
101−}
102−hr {
103− background-color: #1a1a1a;
104− border: none;
105− height: 1px;
106− margin: 1em 0;
107−}
108−table {
109− margin: 1em 0;
110− border-collapse: collapse;
111− width: 100%;
112− overflow-x: auto;
113− display: block;
114− font-variant-numeric: lining-nums tabular-nums;
115−}
116−table caption {
117− margin-bottom: 0.75em;
118−}
119−tbody {
120− margin-top: 0.5em;
121− border-top: 1px solid $if(fontcolor)$$fontcolor$$else$#1a1a1a$endif$;
122− border-bottom: 1px solid $if(fontcolor)$$fontcolor$$else$#1a1a1a$endif$;
123−}
124−th {
125− border-top: 1px solid $if(fontcolor)$$fontcolor$$else$#1a1a1a$endif$;
126− padding: 0.25em 0.5em 0.25em 0.5em;
127−}
128−td {
129− padding: 0.125em 0.5em 0.25em 0.5em;
130−}
131−header {
132− margin-bottom: 4em;
133− text-align: center;
134−}
135−#TOC li {
136− list-style: none;
137−}
138−#TOC a:not(:hover) {
139− text-decoration: none;
140−}
141−$endif$
142code{white-space: pre-wrap;}
1code{white-space: pre-wrap;}
143span.smallcaps{font-variant: small-caps;}
2span.smallcaps{font-variant: small-caps;}
144span.underline{text-decoration: underline;}
3span.underline{text-decoration: underline;}
@@ -154,27 +13,3 @@ $endif$
154$if(displaymath-css)$
13$if(displaymath-css)$
155.display.math{display: block; text-align: center; margin: 0.5rem auto;}
14.display.math{display: block; text-align: center; margin: 0.5rem auto;}
156$endif$
15$endif$
157−$if(csl-css)$
158−div.csl-bib-body { }
159−div.csl-entry {
160− clear: both;
161−$if(csl-entry-spacing)$
162− margin-bottom: $csl-entry-spacing$;
163−$endif$
164−}
165−.hanging div.csl-entry {
166− margin-left:2em;
167− text-indent:-2em;
168−}
169−div.csl-left-margin {
170− min-width:2em;
171− float:left;
172−}
173−div.csl-right-inline {
174− margin-left:2em;
175− padding-left:1em;
176−}
177−div.csl-indent {
178− margin-left: 2em;
179−}
180−$endif$
data/translations/zh-Hans.yamldeleted−22
@@ -1,22 +0,0 @@
1−Abstract: 摘要
2−Appendix: 附录
3−Bibliography: 文献目录
4−Cc: 副本
5−Chapter: 章
6−Contents: 目录
7−Encl: 附件
8−Figure: 图
9−Glossary: 术语
10−Index: 索引
11−Listing: 列表
12−ListOfFigures: 附图目录
13−ListOfTables: 表格索引
14−Page: 页
15−Part: 段
16−Preface: 序
17−Proof: 校对
18−References: 参考文献
19−See: 见
20−SeeAlso: 参见
21−Table: 表
22−To: 到
data/translations/zh-Hant.yamldeleted−22
@@ -1,22 +0,0 @@
1−Abstract: 摘要
2−Appendix: 附錄
3−Bibliography: 文獻目錄
4−Cc: 副本
5−Chapter: 章
6−Contents: 目錄
7−Encl: 附件
8−Figure: 圖
9−Glossary: 術語
10−Index: 索引
11−Listing: 列表
12−ListOfFigures: 附圖目錄
13−ListOfTables: 表格索引
14−Page: 頁
15−Part: 段
16−Preface: 序
17−Proof: 校對
18−References: 參考文獻
19−See: 見
20−SeeAlso: 參見
21−Table: 表
22−To: 到
data/vimwiki.cssnew file+82
@@ -0,0 +1,82 @@
1+pre{
2+ font-size: 1.5em
3+}
4+
5+img {vertical-align: middle}
6+
7+body {font-family: Tahoma, Geneva, sans-serif; margin: 1em 2em 1em 2em; font-size: 120%; line-height: 130%;}
8+h1, h2, h3, h4, h5, h6 {font-family: Trebuchet MS, Helvetica, sans-serif; font-weight: bold; line-height:100%; margin-top: 1.5em; margin-bottom: 0.5em;}
9+h1 {font-size: 2.6em; color: #000000;}
10+h2 {font-size: 2.2em; color: #404040;}
11+h3 {font-size: 1.8em; color: #707070;}
12+h4 {font-size: 1.4em; color: #909090;}
13+h5 {font-size: 1.3em; color: #989898;}
14+h6 {font-size: 1.2em; color: #9c9c9c;}
15+p, pre, blockquote, table, ul, ol, dl {margin-top: 1em; margin-bottom: 1em;}
16+ul ul, ul ol, ol ol, ol ul {margin-top: 0.5em; margin-bottom: 0.5em;}
17+li {margin: 0.3em auto;}
18+ul {margin-left: 2em; padding-left: 0.5em;}
19+dt {font-weight: bold;}
20+img {border: none;}
21+pre {border-left: 1px solid #ccc; margin-left: 2em; padding-left: 0.5em;}
22+blockquote {padding: 0.4em; background-color: #f6f5eb;}
23+th, td {border: 1px solid #ccc; padding: 0.3em;}
24+th {background-color: #f0f0f0;}
25+hr {border: none; border-top: 1px solid #ccc; width: 100%;}
26+del {text-decoration: line-through; color: #777777;}
27+.toc li {list-style-type: none;}
28+.todo {font-weight: bold; background-color: #f0ece8; color: #a03020;}
29+.justleft {text-align: left;}
30+.justright {text-align: right;}
31+.justcenter {text-align: center;}
32+.center {margin-left: auto; margin-right: auto;}
33+div.center > table {margin-left: auto; margin-right: auto;}
34+.tag {background-color: #eeeeee; font-family: monospace; padding: 2px;}
35+
36+/* classes for items of todo lists */
37+.done0 {
38+ /* list-style: none; */
39+ background-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA8AAAAPCAYAAAA71pVKAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAAxQAAAMUBHc26qAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAA7SURBVCiR7dMxEgAgCANBI3yVRzF5KxNbW6wsuH7LQ2YKQK1mkswBVERYF5Os3UV3gwd/jF2SkXy66gAZkxS6BniubAAAAABJRU5ErkJggg==);
40+ background-repeat: no-repeat;
41+ background-position: 0 .2em;
42+ padding-left: 1.5em;
43+}
44+.done1 {
45+ background-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA8AAAAPCAYAAAA71pVKAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAAxQAAAMUBHc26qAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAABtSURBVCiR1ZO7DYAwDER9BDmTeZQMFXmUbGYpOjrEryA0wOvO8itOslFrJYAug5BMM4BeSkmjsrv3aVTa8p48Xw1JSkSsWVUFwD05IqS1tmYzk5zzae9jnVVVzGyXb8sALjse+euRkEzu/uirFomVIdDGOLjuAAAAAElFTkSuQmCC);
46+ background-repeat: no-repeat;
47+ background-position: 0 .15em;
48+ padding-left: 1.5em;
49+}
50+.done2 {
51+ background-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA8AAAAPCAYAAAA71pVKAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAAxQAAAMUBHc26qAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAB1SURBVCiRzdO5DcAgDAVQGxjAYgTvxlDIu1FTIRYAp8qlFISkSH7l5kk+ZIwxKiI2mIyqWoeILYRgZ7GINDOLjnmF3VqklKCUMgTee2DmM661Qs55iI3Zm/1u5h9sm4ig9z4ERHTFzLyd4G4+nFlVrYg8+qoF/c0kdpeMsmcAAAAASUVORK5CYII=);
52+ background-repeat: no-repeat;
53+ background-position: 0 .15em;
54+ padding-left: 1.5em;
55+}
56+.done3 {
57+ background-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA8AAAAPCAYAAAA71pVKAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAAxQAAAMUBHc26qAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAABoSURBVCiR7dOxDcAgDATA/0DtUdiKoZC3YhLkHjkVKF3idJHiztKfvrHZWnOSE8Fx95RJzlprimJVnXktvXeY2S0SEZRSAAAbmxnGGKH2I5T+8VfxPhIReQSuuY3XyYWa3T2p6quvOgGrvSFGlewuUAAAAABJRU5ErkJggg==);
58+ background-repeat: no-repeat;
59+ background-position: 0 .15em;
60+ padding-left: 1.5em;
61+}
62+.done4 {
63+ background-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABIAAAAQCAYAAAAbBi9cAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAAzgAAAM4BlP6ToAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIISURBVDiNnZQ9SFtRFMd/773kpTaGJoQk1im4VDpWQcTNODhkFBcVTCNCF0NWyeDiIIiCm82QoIMIUkHUxcFBg1SEQoZszSat6cdTn1qNue92CMbEr9Sey+XC/Z/zu+f8h6ukUil3sVg0+M+4cFxk42/jH2wAqqqKSCSiPQdwcHHAnDHH9s/tN1h8V28ETdP+eU8fT9Nt62ancYdIPvJNtsu87bmjrJlrTDVM4RROJs1JrHPrD4Bar7A6cpc54iKOaTdJXCUI2UMVrQZ0Js7YPN18ECKkYNQcJe/OE/4dZsw7VqNXQMvHy3QZXQypQ6ycrtwDjf8aJ+PNEDSCzLpn7+m2pD8ZKHlKarYhy6XjEoCYGcN95qansQeA3fNdki+SaJZGTMQIOoL3W/Z89rxv+tokubNajlvk/vm+LFpF2XnUKZHI0I+QrI7Dw0OZTqdzUkpsM7mZTyfy5OPGyw1tK7AFSvmB/Ks8w8YwbUYbe6/3QEKv0vugfxWPnMLJun+d/kI/WLdizpNjMbAIKrhMF4OuwadBALqqs+RfInwUvuNi+fBd+wjogfogAFVRmffO02q01mZZ0HHdgXIzdz0QQLPezIQygX6llxNKKgOFARYCC49CqhoHIUTlss/Vx2phlYwjw8j1CAlfAiwQiJpiy7o1VHnsG5FISkoJu7Q/2YmmaV+i0ei7v38L2CBguSi5AAAAAElFTkSuQmCC);
64+ background-repeat: no-repeat;
65+ background-position: 0 .15em;
66+ padding-left: 1.5em;
67+}
68+
69+*:not(pre) > code {
70+ font-family: Monaco,"Courier New","DejaVu Sans Mono","Bitstream Vera Sans Mono",monospace;
71+ -webkit-border-radius: 1px;
72+ -moz-border-radius: 1px;
73+ border-radius: 1px;
74+ -moz-background-clip: padding;
75+ -webkit-background-clip: padding-box;
76+ background-clip: padding-box;
77+ padding: 0px 3px;
78+ display: inline-block;
79+ color: #52595d;
80+ border: 1px solid #ccc;
81+ background-color: #f9f9f9;
82+}
default.nixdeleted−13
@@ -1,13 +0,0 @@
1−# default.nix
2−let
3− pkgs = import <nixpkgs> { };
4−in
5− pkgs.haskellPackages.developPackage {
6− root = ./.;
7− modifier = drv:
8− pkgs.haskell.lib.addBuildTools drv (with pkgs.haskellPackages;
9− [ cabal-install
10− ghcid
11− ]);
12− }
13−
doc/epub.md+2−9
@@ -141,15 +141,8 @@ Pandoc has an EPUB3 writer. It renders LaTeX math into MathML, which
141EPUB3 readers are supposed to support (but unfortunately few do).
141EPUB3 readers are supposed to support (but unfortunately few do).
142
142
143Of course, this isn't much help if you want EPUB2 output (`pandoc -t epub2`)
143Of course, this isn't much help if you want EPUB2 output (`pandoc -t epub2`)
144−or target readers that don't support MathML. Then you have two options:
144+or target readers that don't support MathML. Then you should try using the
145−
146−1. Use the [`--webtex`](https://pandoc.org/MANUAL.html#option--webtex) option,
147− which will use a web service to convert the TeX to an image.
145+`--webtex` option, which will use a web service to convert the TeX to an image.
148−2. Use the [`--gladtex`](https://pandoc.org/MANUAL.html#option--gladtex) option
149− to convert maths into SVG images on your local machine.
150−
151−Both GladTeX and WebTeX add the LaTeX source of the formula as alternative text
152−of the image, increasing accessibility for blind users.
153
146
154[KindleGen]: https://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000765211
147[KindleGen]: https://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000765211
155[EPUB]: https://en.wikipedia.org/wiki/EPUB
148[EPUB]: https://en.wikipedia.org/wiki/EPUB
doc/faqs.mddeleted−128
@@ -1,128 +0,0 @@
1−% FAQs
2−
3−::: faqs
4−
5−## How can I convert a whole directory of files from Markdown to RTF?
6−
7−On linux or OSX:
8−
9− for f in *.txt; do pandoc "$f" -s -o "${f%.txt}.rtf"; done
10−
11−
12−In Windows Powershell:
13−
14− gci -r -i *.txt |foreach{$rtf=$_.directoryname+"\"+$_.basename+".rtf";pandoc -f markdown -s $_.name -o $rtf}
15−
16−## I used pandoc to convert a document to ICML (or OPML or RTF), and when I try to open it I'm told it's invalid. What have I done wrong?
17−
18−Be sure to use the `-s` or `--standalone` flag, or you just get a
19−fragment, not a full document with the required header:
20−
21− pandoc -s -f markdown -t icml -o my.icml my.md
22−
23−## I get a blank document when I try to convert a markdown document in Chinese to PDF.
24−
25−By default, pandoc uses pdflatex to generate the PDF, and pdflatex
26−doesn't handle Chinese characters. But you can change the default to
27−use xelatex instead. You should also make sure you're using a font
28−with Chinese glyphs. For example:
29−
30− pandoc -o c.pdf --pdf-engine=xelatex -V mainfont='Adobe Ming Std'
31−
32−## The Windows installer does a single user install, rather than installing pandoc for all users. How can I install pandoc for all users?
33−
34−Run the following command as admin:
35−
36− msiexec /i pandoc-VERSION.msi ALLUSERS=1
37−
38−This will put pandoc in `C:\Program Files\Pandoc`.
39−You can install Pandoc to a different directory by setting APPLICATIONFOLDER parameter,
40−for example:
41−
42− msiexec /i pandoc-1.11.1.msi ALLUSERS=1 APPLICATIONFOLDER="C:\Pandoc"
43−
44−## How do I change the margins in PDF output?
45−
46−The option
47−
48− -V geometry:margin=1in
49−
50−will set the margins to one inch on each side. If you don't want uniform
51−margins, you can do something like
52−
53− -V geometry:"top=2cm, bottom=1.5cm, left=1cm, right=1cm"
54−
55−Or
56−
57− -V geometry:"left=3cm, width=10cm"
58−
59−For more options, see the documentation for the LaTeX [geometry
60−package](https://www.ctan.org/pkg/geometry).
61−
62−## How does pandoc compare to multimarkdown?
63−
64−Here is a [wiki
65−page](https://github.com/jgm/pandoc/wiki/Pandoc-vs-Multimarkdown)
66−comparing the two.
67−
68−## When I specify an image width of 50% and convert to LaTeX, pandoc sets the height to textheight and the aspect ratio isn't preserved. How can I prevent this?
69−
70−For example, if you convert an image with `{width="50%"}`, the LaTeX produced
71−will be `\includegraphics[width=0.5\textwidth,height=\textheight]`.
72−
73−This output presupposes the following code in pandoc's default latex
74−template:
75−
76−```
77−% Scale images if necessary, so that they will not overflow the page
78−% margins by default, and it is still possible to overwrite the defaults
79−% using explicit options in \includegraphics[width, height, ...]{}
80−\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
81−```
82−
83−If you don't have this in your custom template, you should
84−add it. If we didn't set the `height` explicitly in this way,
85−the image would not be resized correctly unless it was
86−being resized to smaller than its original size.
87−
88−## Pandoc sometimes uses too much memory. How can I limit the memory used by pandoc?
89−
90−`pandoc +RTS -M30m -RTS` will limit heap memory to 30MB.
91−When converting a document requires more than this, an out of
92−memory error will be issued.
93−
94−## When using `--include-in-header` with PDF or LaTeX output, how do I reference tex declarations coming after `$header-includes$` in the default template?
95−
96−For various reasons, the `$header-includes$` are not at the very
97−end of the LaTeX preamble. This poses a problem when the code
98−you are inserting depends on declarations in the preamble coming
99−after the `$header-includes$` location. For example, you might
100−want to reference the `\author` and `\title` metadata values
101−(set at the very bottom of the preamble) and present them in
102−margins. In that case you can wrap your code in `etoolbox`'s
103−`\AtEndPreamble`. The technique is demonstrated in [this
104−gist](https://gist.github.com/JohnLukeBentley/9dda6166b9ee5c4127afd2b8cd16b70a).
105−When using `\AtEndPreamble`, keep any `makeatletter` or
106−`makeatother` outside of the `\AtEndPreamble`, as shown in the
107−example.
108−
109−## How can I convert PDFs to other formats using pandoc?
110−
111−You can't. You can try opening the PDF in Word or Google Docs
112−and saving in a format from which pandoc can convert directly.
113−
114−## Do I really need to install a 1 GB TeX installation to produce a PDF using pandoc?
115−
116−No. You can get by with a relatively small TeX installation,
117−for example, by starting with MacTeX's Basic TeX distribution
118−and using the `tlmgr` tool to install a few packages required by pandoc
119−(see https://pandoc.org/MANUAL.html#creating-a-pdf).
120−
121−Or, you can produce PDFs via HTML and `wkhtmltopdf`,
122−or via groff ms and `pdfroff`. (These don't produce as nice
123−topography as TeX, particularly when it comes to math, but they
124−may be fine for many purposes.)
125−
126−
127−:::
128−
doc/filters.md+6−91
@@ -253,15 +253,12 @@ repository](https://github.com/jgm/pandocfilters).
253
253
254For a more Pythonic alternative to pandocfilters, see
254For a more Pythonic alternative to pandocfilters, see
255the [panflute](https://pypi.org/project/panflute) library.
255the [panflute](https://pypi.org/project/panflute) library.
256−Don't like Python? There are also ports of pandocfilters in
256+Don't like Python? There are also ports of pandocfilters in
257−
258−- [PHP](https://github.com/vinai/pandocfilters-php),
257+[PHP](https://github.com/vinai/pandocfilters-php),
259−- [perl](https://metacpan.org/pod/Pandoc::Filter),
258+[perl](https://metacpan.org/pod/Pandoc::Filter),
260−- TypeScript/JavaScript via Node.js
261− - [pandoc-filter](https://github.com/mvhenderson/pandoc-filter-node),
259+[javascript/node.js](https://github.com/mvhenderson/pandoc-filter-node),
262− - [node-pandoc-filter](https://github.com/mu-io/node-pandoc-filter),
263−- [Groovy](https://github.com/dfrommi/groovy-pandoc), and
260+[Groovy](https://github.com/dfrommi/groovy-pandoc), and
264−- [Ruby](https://heerdebeer.org/Software/markdown/paru/).
261+[Ruby](https://heerdebeer.org/Software/markdown/paru/).
265
262
266Starting with pandoc 2.0, pandoc includes built-in support for
263Starting with pandoc 2.0, pandoc includes built-in support for
267writing filters in lua. The lua interpreter is built in to
264writing filters in lua. The lua interpreter is built in to
@@ -394,8 +391,6 @@ automatically assign it `Just` the target format or `Nothing`.
394
391
395We compile our script:
392We compile our script:
396
393
397− # first, make sure pandoc-types is installed:
398− cabal install --lib pandoc-types --package-env .
399 ghc --make handleRuby
394 ghc --make handleRuby
400
395
401Then run it:
396Then run it:
@@ -430,83 +425,3 @@ the Japanese characters (e.g. "Noto Sans CJK TC"), and add
4305. Find all code blocks with class `python` and run them
4255. Find all code blocks with class `python` and run them
431 using the python interpreter, printing the results to the console.
426 using the python interpreter, printing the results to the console.
432
427
433−# Technical details of JSON filters
434−
435−A JSON filter is any program which can consume and produce a
436−valid pandoc JSON document representation. This section describes
437−the technical details surrounding the invocation of filters.
438−
439−## Arguments
440−
441−The program will always be called with the target format as the
442−only argument. A pandoc invocation like
443−
444− pandoc --filter demo --to=html
445−
446−will cause pandoc to call the program `demo` with argument `html`.
447−
448−## Environment variables
449−
450−Pandoc sets additional environment variables before calling a
451−filter.
452−
453−`PANDOC_VERSION`
454−: The version of the pandoc binary used to process the document.
455− Example: `2.11.1`.
456−
457−`PANDOC_READER_OPTIONS`
458−: JSON object representation of the options passed to the input
459− parser.
460−
461− Object fields:
462−
463− `readerAbbreviations`
464− : set of known abbreviations (array of strings).
465−
466− `readerColumns`
467− : number of columns in terminal; an integer.
468−
469− `readerDefaultImageExtension`
470− : default extension for images; a string.
471−
472− `readerExtensions`
473− : integer representation of the syntax extensions bit
474− field.
475−
476− `readerIndentedCodeClasses`
477− : default classes for indented code blocks; array of
478− strings.
479−
480− `readerStandalone`
481− : whether the input was a standalone document with header;
482− either `true` or `false`.
483−
484− `readerStripComments`
485− : HTML comments are stripped instead of parsed as raw HTML;
486− either `true` or `false`.
487−
488− `readerTabStop`
489− : width (i.e. equivalent number of spaces) of tab stops;
490− integer.
491−
492− `readerTrackChanges`
493− : track changes setting for docx; one of
494− `"accept-changes"`, `"reject-changes"`, and
495− `"all-changes"`.
496−
497−## Supported interpreters
498−
499−Files passed to the `--filter`/`-F` parameter are expected to be
500−executable. However, if the executable bit is not set, then
501−pandoc tries to guess a suitable interpreter from the file
502−extension.
503−
504− file extension interpreter
505− ---------------- --------------
506− .py `python`
507− .hs `runhaskell`
508− .pl `perl`
509− .rb `ruby`
510− .php `php`
511− .js `node`
512− .r `Rscript`
doc/jats.mddeleted−414
@@ -1,414 +0,0 @@
1−---
2−title: JATS
3−author: Albert Krewinkel
4−---
5−
6−This document describes pandoc's handling of JATS.
7−
8−Metadata Values
9−===============
10−
11−`abstract`
12−: Article summary. Added via the document's front matter via the
13− [`<abstract>`][elem:abstract] element.
14−
15−`author`
16−: list of article contributors. Each author should have a surname
17− and a given name listed in the entry; if the author has no
18− `surname` value, then the item will be used as the contributors
19− [`string-name`][elem:string-name].
20−
21− `orcid`
22− : the contributor's ORCID identifier.
23−
24− `surname`
25− : surname of the contributor. Usually the family name in
26− western names.
27−
28− See [`<surname>`][elem:surname].
29−
30− `given-names`
31− : personal names of the contributor; this includes middle
32− names (if any) in western-style names.
33−
34− See [`<given-names>`][elem:given-names].
35−
36− `name`
37− : full name of the author; included only as a fallback if
38− `author.surname` is not available. Tagged with
39− [`<string-name>`][elem:string-name].
40−
41− `email`
42− : the contributor's email address.
43−
44− Used as the contents of the [`<email>`][elem:given-names]
45− element.
46−
47− `affiliation`
48− : list of affiliation identifiers; marks the organizations
49− with which an author is affiliated. Each identifier in this
50− list must also occur as the `id` of an affiliation listed in
51− the top-level `affiliation` list.
52−
53− `equal-contrib`
54− : boolean attribute used to mark authors who contributed
55− equally to the work. The
56− [`equal-contrib`][attr:equal-contrib] attribute is added
57− to the author's [`<contrib>`] element if this is set to a
58− truthy value.
59−
60− `cor-id`
61− : identifier linking to the contributor's correspondence
62− information. The info itself must be stored in as an item in
63− `article.author-notes.corresp`. If the `cor-id` value is
64− then, an [`<xref>`][elem:xref] link of
65− [`ref-type`][attr:ref-type] `corresp` is added. The
66− [`rid`][attr:rid] attribute is set to `cor-<ID>`, where
67− `<ID>` is the stringified value of this attribute.
68−
69−`affiliation`
70−: the list of organizations with which contributors are
71− affiliated. Each institution is added as an [`<aff>`] element to
72− the author's contrib-group.
73−
74− The fields are given in the order in which they are included in
75− the output.
76−
77− `id`
78− : internal identifier; used as the [`<aff>`] element's `id`
79− value, prefixed with `aff-`.
80−
81− `group`
82− : name of the research group or other low-level organizational
83− structure; used as value of an [`<institution>`] element with
84− [`content-type`][attr:content-type] set to `group`.
85−
86− `department`
87− : name of the department or other mid-level organizational
88− structure; used as value of an [`<institution>`] element with
89− [`content-type`][attr:content-type] set to `dept`.
90−
91− `organization`
92− : name of the company, university, or other top-level
93− organizational structure; used as value of an
94− [`<institution>`] element. The institution element is wrapped
95− in an [`<institution-wrap>`] element; any identifiers, like
96− `ringgold` or `ror`, are added to the wrapper and must hence
97− belong to this organization (not the department or group).
98−
99− `isni`
100− : International Standard Name Identifier of the organization.
101− Added via an [`<institution-id>`] element with
102− [`institution-id-type`](attr:institution-id-type) set to
103− `ISNI`.
104−
105− `ringgold`
106− : [Ringgold] identifier of the organization. Added via an
107− [`<institution-id>`] element with
108− [`institution-id-type`](attr:institution-id-type) set to
109− `Ringgold`.
110−
111− `ror`
112− : Research Organization Registry identifier of the
113− organization. Added via an [`<institution-id>`] element with
114− [`institution-id-type`](attr:institution-id-type) set to
115− `ROR`.
116−
117− `pid`
118− : Array of persistent identifiers which are added as
119− [`<institution-id>`] elements. Each item must contain a map
120− with keys `type`, used as
121− [`institution-id-type`](attr:institution-id-type), and `id`,
122− used as element content.
123−
124− `street-address`
125− : The organization's street address; each list item is wrapped
126− in an [`<addr-line>`] element, separated by a comma and
127− space (`, `).
128−
129− `city`
130− : City in which the organization is located; used only if
131− `street-address` is not given, in which case the value is
132− wrapped in a [`<city>`] element.
133−
134− `country`
135− : Country in which the organization is located; used as the
136− value of a [`<country>`] element.
137−
138− `country-code`
139− : Two letter ISO-3166-1 country identifier; used as the
140− [`country`][attr:country] attribute in element [`<country>`]
141− (if the latter is present).
142−
143−`copyright`
144−: Licensing and copyright information. This information is
145− rendered via the [`<permissions>`][elem:permissions] element.
146−
147− The variables `type`, `link`, and `text` should always be used
148− together.
149−
150− `statement`
151− : the year of copyright; used as content of the
152− [`<copyright-statement>`][elem:copyright-statement]
153−
154− `year`
155− : the year of copyright; used as content of the
156− [`<copyright-year>`][elem:copyright-year]
157−
158− `holder`
159− : the copyright holder; included via the
160− [`<copyright-holder>`][elem:copyright-holder] element.
161−
162− `text`
163− : inline text setting the license under which the text is
164− published; included via the
165− [`<license-p>`][elem:copyright-holder] element.
166−
167− `type`
168− : type of the license; used as value of the
169− [`license-type`][attr:license-type] attribute.
170−
171− `link`
172− : external link describing the license; used as value of a
173− `xlink:href` attribute in the `<license>` element.
174−
175−`date`
176−: publication date. This value should usually be a string
177− representation of a date. Pandoc will parse and deconstruct the
178− date into the components given below. It is also possible to
179− pass these components directly.
180−
181− The publication date is recorded in the document via the
182− [`<pub-date>`] element and its sub-elements. The
183− [`publication-format`][attr:publication-format] attribute is
184− always set to `electronic`.
185−
186− `iso-8601`
187− : ISO-8601 representation of the publication date. Used as the
188− value of the [`<pub-date>`] element's
189− [`iso-8601-date`][attr:iso-8601-date] attribute.
190−
191− This value is set automatically if pandoc can parse the
192− `date` value as a date.
193−
194− `day`, `month`, `year`
195− : Day, month, and year of the publication date. Only the
196− publication year is required. The values are used as the
197− contents of the elements with the respective names.
198−
199− The values are set automatically if pandoc can parse the
200− `date` value as a date.
201−
202− `type`
203− : The type of event marked by this date. The value is set as
204− the [`date-type`][attr:date-type] attribute on the
205− [`<pub-date>`] element and defaults to "pub" if not
206− specified.
207−
208−`article`
209−: information concerning the article that identifies or describes
210− it. The key-value pairs within this map are typically used
211− within the [`<article-meta>`][elem:article-meta] element.
212−
213− `publisher-id`
214− : external article identifier assigned by the publisher. Used
215− as the content of the [`<article-id>`][elem:article-id]
216− element with attribute [`pub-id-type`][attr:pub-id-type] set
217− to `publisher-id`.
218−
219− `doi`
220− : Digital Object Identifier (DOI) assigned to the article.
221− Used as the content of the [`<article-id>`][elem:article-id]
222− element with attribute [`pub-id-type`][attr:pub-id-type] set
223− to `doi`.
224−
225− `pmid`
226− : PubMed Identifier (PubMed ID) assigned to the article. Used
227− as the content of the [`<article-id>`][elem:article-id]
228− element with attribute [`pub-id-type`][attr:pub-id-type] set
229− to `pmid`.
230−
231− `pmcid`
232− : PubMed Central Identifier assigned to the article. Used as
233− the content of the [`<article-id>`][elem:article-id] element
234− with attribute [`pub-id-type`][attr:pub-id-type] set to
235− `pmcid`.
236−
237− `art-access-id`
238− : generic article accession identifier. Used as the content of
239− the [`<article-id>`][elem:article-id] element with attribute
240− [`pub-id-type`][attr:pub-id-type] set to `art-access-id`.
241−
242− `heading`
243− : name of a subject or topic describing the article. Used as
244− the content of the [`<subject>`][elem:subject] element,
245− nested in a [`<subj-group>`][elem:subj-group] element which
246− has `heading` as its
247− [`subj-group-type`][attr:subj-group-type] attribute.
248−
249− `categories`
250− : list a subject or topic describing the article. Items are
251− each used as the content a the [`<subject>`][elem:subject]
252− element, grouped in a single
253− [`<subj-group>`][elem:subj-group] element with its
254− [`subj-group-type`][attr:subj-group-type] attribute set to
255− `categories`.
256−
257− `author-notes`
258− : Additional information about authors, like conflict of
259− interest statements and corresponding author contact info.
260− Wrapped in an [`<author-notes>`][elem:author-notes] element.
261−
262− `conflict`
263− : Conflict of interest statement. Rendered as a footnote
264− ([`<fn>`][elem:fn]) of [`fn-type`](attr:fn-type)
265− `conflict`.
266−
267− `con`
268− : Contributed-by information. Rendered as a footnote
269− ([`<fn>`][elem:fn]) of [`fn-type`](attr:fn-type) `con`.
270−
271− `corresp`
272− : Correspondence information. This must be a list of
273− contributor correspondence items, where each item must
274− have the properties `id` and `email`. The info is then
275− rendered via a [`<corresp>`][elem:corresp] element.
276−
277− `funding-statement`
278− : Prose describing the funding. Added to the article's
279− frontmatter via the
280− [`funding-statement`][elem:funding-statement] element.
281−
282−`journal`
283−: information on the journal in which the article is published.
284− This must be a map; the following key/value pairs are
285− recognized.
286−
287− `publisher-id`
288− : journal identifier assigned by the publisher. Used as
289− content of element [`<journal-id>`][elem:journal-id] with
290− attribute [`journal-id-type`][attr:journal-id-type] set to
291− `publisher-id`.
292−
293− `nlm-ta`
294− : journal identifier assigned by PubMed. Used as content of
295− element [`<journal-id>`][elem:journal-id] with attribute
296− [`journal-id-type`][attr:journal-id-type] set to `nlm-ta`.
297−
298− `pmc`
299− : journal identifier assigned by PubMed Central. Used as
300− content of element [`<journal-id>`][elem:journal-id] with
301− attribute [`journal-id-type`][attr:journal-id-type] set to
302− `pmc`.
303−
304− `title`
305− : full title of the journal in which the article is published.
306− Used as content of the
307− [`<journal-title>`][elem:journal-title] element.
308−
309− `abbrev-title`
310− : short form of the journal title. Used as content of the
311− [`<abbrev-journal-title>`][elem:abbrev-journal-title]
312− element.
313−
314− `pissn`
315− : ISSN identifier of the publication's print version. Used as
316− content of the [`<issn>`][elem:issn] element with the
317− [`publication-format`][attr:publication-format] attribute
318− set to `print`.
319−
320− `eissn`
321− : ISSN identifier of the publication's electronic version.
322− Used as content of the [`<issn>`][elem:issn] element with
323− the [`publication-format`][attr:publication-format]
324− attribute set to `electronic`.
325−
326− `publisher-name`
327− : name of the publishing entity (person, company, or other).
328− Used as the content of the
329− [`<publisher-name>`][elem:publisher-name] element.
330−
331− `publisher-loc`
332− : place of publication. Used as the content of the
333− [`<publisher-loc>`][elem:publisher-loc] element.
334−
335−`notes`
336−: Additional notes concerning the whole article. Added to the
337− article's frontmatter via the [`<notes>`][elem:notes] element.
338−
339−`tags`
340−: list of keywords. Items are used as contents of the
341− [`<kwd>`][elem:kwd] element; the elements are grouped in a
342− [`<kwd-group>`][elem:kwd-group] with the
343− [`kwd-group-type`][attr:kwd-group-type] value `author`.
344−
345−Required Metadata
346−-----------------
347−
348−Pandoc will try to generate a valid JATS document even when
349−information is missing, filling in placeholders or using empty
350−values. This circumvents the intend to ensure a minimum set of
351−information being present in documents of a certain tag set. It is
352−hence recommended to always provide the information listed below.
353−
354−### Publishing Tag Set
355−
356−Required metadata values:
357−
358−- One or more of `journal.publisher-id`, `journal.nlm-ta`,
359− `journal.pmc`.
360−- One or more of `journal.pissn`, `journal.eissn`.
361−
362−[Ringgold]: https://ringgold.com/
363−[attr:content-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/content-type.html
364−[attr:date-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/date-type.html
365−[attr:equal-contrib]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/equal-contrib.html
366−[attr:fn-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/fn-type.html
367−[attr:institution-id-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/institution-id-type.html
368−[attr:iso-8601-date]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/iso-8601-date.html
369−[attr:journal-id-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/journal-id-type.html
370−[attr:kwd-group-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/kwd-group-type.html
371−[attr:license-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/license-type.html
372−[attr:pub-id-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/pub-id-type.html
373−[attr:publication-format]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/publication-format.html
374−[attr:ref-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/ref-type.html
375−[attr:rid]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/rid.html
376−[attr:subj-group-type]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/attribute/subj-group-type.html
377−[elem:abbrev-journal-title]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/abbrev-journal-title.html
378−[elem:abstract]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/abstract.html
379−[elem:article-id]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/article-id.html
380−[elem:article-meta]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/article-meta.html
381−[elem:copyright-holder]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/copyright-holder.html
382−[elem:copyright-statement]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/copyright-statement.html
383−[elem:copyright-year]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/copyright-year.html
384−[elem:corresp]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/corresp.html
385−[elem:email]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/email.html
386−[elem:fn]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/fn.html
387−[elem:funding-statement]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/funding-statement.html
388−[elem:given-names]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/given-names.html
389−[elem:issn]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/issn.html
390−[elem:journal-id]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/journal-id.html
391−[elem:journal-title]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/journal-title.html
392−[elem:kwd-group]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/kwd-group.html
393−[elem:kwd]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/kwd.html
394−[elem:license-p]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/license-p.html
395−[elem:license]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/license.html
396−[elem:notes]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/notes.html
397−[elem:permissions]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/permissions.html
398−[elem:publisher-loc]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/publisher-loc.html
399−[elem:publisher-name]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/publisher-name.html
400−[elem:string-name]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/string-name.html
401−[elem:subj-group]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/subj-group.html
402−[elem:subject]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/subject.html
403−[elem:surname]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/surname.html
404−[elem:xref]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/xref.html
405−
406−[`<addr-line>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/addr-line.html
407−[`<aff>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/aff.html
408−[`<city>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/city.html
409−[`<contrib>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/contrib.html
410−[`<country>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/country.html
411−[`<institution-id>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/institution-id.html
412−[`<institution-wrap>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/institution-wrap.html
413−[`<institution>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/institution.html
414−[`<pub-date>`]: https://jats.nlm.nih.gov/publishing/tag-library/1.2/element/pub-date.html
doc/libraries.mddeleted−63
@@ -1,63 +0,0 @@
1−---
2−title: The pandoc family of libraries
3−author: John MacFarlane
4−---
5−
6−The following Haskell libraries have been developed to support
7−pandoc:
8−
9−[skylighting-core] and [skylighting]
10−: Syntax highlighting engine supporting over 140 languages.
11−
12−[citeproc]
13−: Citation processing using CSL stylesheets.
14−
15−[texmath]
16−: Conversion of math between tex, Word equation, MathML, and GNU eqn.
17−
18−[unicode-collation]
19−: Proper Unicode collation (sorting).
20−
21−[doclayout]
22−: Combinators for laying out a textual document, with support
23− for line wrapping, tabular layout, and more.
24−
25−[doctemplates]
26−: Supports pandoc's templates.
27−
28−[commonmark], [commonmark-extensions], and [commonmark-pandoc]
29−: Efficient, standards-compliant parser for commonmark and extensions.
30−
31−[ipynb]
32−: Representation of Jupyter notebooks and conversion to and
33− from JSON.
34−
35−[zip-archive]
36−: A pure zip file creator and extractor, used by pandoc for
37− docx, ODT, and EPUB.
38−
39−[rfc5051]
40−: Simple unicode collation (used for citation sorting).
41−
42−[emojis]
43−: Conversion between emoji characters and aliases.
44−
45−[jira-wiki-markup]
46−: Support for parsing Jira wiki syntax.
47−
48−[skylighting]: https://hackage.haskell.org/package/skylighting
49−[skylighting-core]: https://hackage.haskell.org/package/skylighting-core
50−[citeproc]: https://hackage.haskell.org/package/citeproc
51−[texmath]: https://hackage.haskell.org/package/texmath
52−[doclayout]: https://hackage.haskell.org/package/doclayout
53−[doctemplates]: https://hackage.haskell.org/package/doctemplates
54−[commonmark]: https://hackage.haskell.org/package/commonmark
55−[commonmark-extensions]: https://hackage.haskell.org/package/commonmark-extensions
56−[commonmark-pandoc]: https://hackage.haskell.org/package/commonmark-pandoc
57−[ipynb]: https://hackage.haskell.org/package/ipynb
58−[zip-archive]: https://hackage.haskell.org/package/zip-archive
59−[rfc5051]: https://hackage.haskell.org/package/rfc5051
60−[emojis]: https://hackage.haskell.org/package/emojis
61−[jira-wiki-markup]: https://hackage.haskell.org/package/jira-wiki-markup
62−[unicode-collation]: https://hackage.haskell.org/package/unicode-collation
63−
doc/lua-filters.md+77−525
@@ -32,7 +32,7 @@ Starting with version 2.0, pandoc makes it possible to write
32filters in Lua without any external dependencies at all. A Lua
32filters in Lua without any external dependencies at all. A Lua
33interpreter (version 5.3) and a Lua library for creating pandoc
33interpreter (version 5.3) and a Lua library for creating pandoc
34filters is built into the pandoc executable. Pandoc data types
34filters is built into the pandoc executable. Pandoc data types
35−are marshaled to Lua directly, avoiding the overhead of writing
35+are marshalled to Lua directly, avoiding the overhead of writing
36JSON to stdout and reading it from stdin.
36JSON to stdout and reading it from stdin.
37
37
38Here is an example of a Lua filter that converts strong emphasis
38Here is an example of a Lua filter that converts strong emphasis
@@ -75,7 +75,7 @@ Python (`smallcaps.py`):
75 `pandoc --lua-filter ./smallcaps.lua` 1.03s
75 `pandoc --lua-filter ./smallcaps.lua` 1.03s
76
76
77As you can see, the Lua filter avoids the substantial overhead
77As you can see, the Lua filter avoids the substantial overhead
78−associated with marshaling to and from JSON over a pipe.
78+associated with marshalling to and from JSON over a pipe.
79
79
80# Lua filter structure
80# Lua filter structure
81
81
@@ -109,7 +109,7 @@ element filtering function. In other words, filter entries will
109be called for each corresponding element in the document,
109be called for each corresponding element in the document,
110getting the respective element as input.
110getting the respective element as input.
111
111
112−The return of a filter function must be one of the following:
112+The return of a filter function must one of the following:
113
113
114- nil: this means that the object should remain unchanged.
114- nil: this means that the object should remain unchanged.
115- a pandoc object: this must be of the same type as the input
115- a pandoc object: this must be of the same type as the input
@@ -138,7 +138,7 @@ elements.
138
138
139## Filters on element sequences
139## Filters on element sequences
140
140
141−For some filtering tasks, it is necessary to know the order
141+For some filtering tasks, the it is necessary to know the order
142in which elements occur in the document. It is not enough then to
142in which elements occur in the document. It is not enough then to
143inspect a single element at a time.
143inspect a single element at a time.
144
144
@@ -292,7 +292,7 @@ use-case would be to load additional modules, or even to alter
292default modules.
292default modules.
293
293
294The following snippet is an example of code that might be useful
294The following snippet is an example of code that might be useful
295−when added to `init.lua`. The snippet adds all Unicode-aware
295+when added to `init.lua`. The snippet adds all unicode-aware
296functions defined in the [`text` module](#module-text) to the
296functions defined in the [`text` module](#module-text) to the
297default `string` module, prefixed with the string `uc_`.
297default `string` module, prefixed with the string `uc_`.
298
298
@@ -305,29 +305,6 @@ end
305This makes it possible to apply these functions on strings using
305This makes it possible to apply these functions on strings using
306colon syntax (`mystring:uc_upper()`).
306colon syntax (`mystring:uc_upper()`).
307
307
308−# Debugging Lua filters
309−
310−It is possible to use a debugging interface to halt execution and
311−step through a Lua filter line by line as it is run inside Pandoc.
312−This is accomplished using the remote-debugging interface of the
313−package [`mobdebug`](https://github.com/pkulchenko/MobDebug).
314−Although mobdebug can be run from the terminal, it is more useful
315−run within the donation-ware Lua editor and IDE,
316−[ZeroBrane](https://studio.zerobrane.com/). ZeroBrane offers a
317−REPL console and UI to step-through and view all variables and
318−state.
319−
320−If you already have Lua 5.3 installed, you can add
321−[`mobdebug`](https://luarocks.org/modules/paulclinger/mobdebug)
322−and its dependency
323−[`luasocket`](https://luarocks.org/modules/luasocket/luasocket)
324−using [`luarocks`](https://luarocks.org), which should then be
325−available on the path. ZeroBrane also includes both of these in
326−its package, so if you don't want to install Lua separately, you
327−should add/modify your `LUA_PATH` and `LUA_CPATH` to include the
328−correct locations; [see detailed instructions
329−here](https://studio.zerobrane.com/doc-remote-debugging).
330−
331# Examples
308# Examples
332
309
333The following filters are presented as examples. A repository of
310The following filters are presented as examples. A repository of
@@ -385,14 +362,48 @@ end
385## Setting the date in the metadata
362## Setting the date in the metadata
386
363
387This filter sets the date in the document's metadata to the
364This filter sets the date in the document's metadata to the
388−current date, if a date isn't already set:
365+current date:
389
366
390``` lua
367``` lua
391function Meta(m)
368function Meta(m)
392− if m.date == nil then
393− m.date = os.date("%B %e, %Y")
369+ m.date = os.date("%B %e, %Y")
394− return m
370+ return m
371+end
372+```
373+
374+## Extracting information about links
375+
376+This filter prints a table of all the URLs linked to in the
377+document, together with the number of links to that URL.
378+
379+``` lua
380+links = {}
381+
382+function Link (el)
383+ if links[el.target] then
384+ links[el.target] = links[el.target] + 1
385+ else
386+ links[el.target] = 1
395 end
387 end
388+ return el
389+end
390+
391+function Doc (blocks, meta)
392+ function strCell(str)
393+ return {pandoc.Plain{pandoc.Str(str)}}
394+ end
395+ local caption = {pandoc.Str "Link", pandoc.Space(), pandoc.Str "count"}
396+ local aligns = {pandoc.AlignDefault, pandoc.AlignLeft}
397+ local widths = {0.8, 0.2}
398+ local headers = {strCell "Target", strCell "Count"}
399+ local rows = {}
400+ for link, count in pairs(links) do
401+ rows[#rows + 1] = {strCell(link), strCell(count)}
402+ end
403+ return pandoc.Doc(
404+ {pandoc.Table(caption, aligns, widths, headers, rows)},
405+ meta
406+ )
396end
407end
397```
408```
398
409
@@ -1093,33 +1104,21 @@ Values of this type can be created with the
1093
1104
1094Fields:
1105Fields:
1095
1106
1096−`attr`
1097−: table attributes ([Attr])
1098−
1099`caption`
1107`caption`
1100−: table caption ([Caption])
1108+: table caption ([List] of [Inlines])
1101
1109
1102−`colspecs`
1110+`aligns`
1103−: column specifications, i.e., alignments and widths ([List] of
1111+: column alignments ([List] of [Alignment]s)
1104− [ColSpec]s)
1105
1112
1106−`head`
1113+`widths`
1107−: table head ([TableHead])
1114+: column widths (number)
1108
1115
1109−`bodies`
1116+`headers`
1110−: table bodies ([List] of [TableBody]s)
1117+: header row ([List] of [table cells](#type-table-cell))
1111
1118
1112−`foot`
1119+`rows`
1113−: table foot ([TableFoot])
1120+: table rows ([List] of [List]s of [table
1114−
1121+ cells](#type-table-cell))
1115−`identifier`
1116−: alias for `attr.identifier` (string)
1117−
1118−`classes`
1119−: alias for `attr.classes` ([List] of strings)
1120−
1121−`attributes`
1122−: alias for `attr.attributes` ([Attributes])
1123
1122
1124`tag`, `t`
1123`tag`, `t`
1125: the literal `Table` (string)
1124: the literal `Table` (string)
@@ -1128,7 +1127,7 @@ A [table cell]{#type-table-cell} is a list of blocks.
1128
1127
1129*[Alignment]{#type-alignment}* is a string value indicating the
1128*[Alignment]{#type-alignment}* is a string value indicating the
1130horizontal alignment of a table column. `AlignLeft`,
1129horizontal alignment of a table column. `AlignLeft`,
1131−`AlignRight`, and `AlignCenter` leads cell content to be
1130+`AlignRight`, and `AlignCenter` leads cell content tob be
1132left-aligned, right-aligned, and centered, respectively. The
1131left-aligned, right-aligned, and centered, respectively. The
1133default alignment is `AlignDefault` (often equivalent to
1132default alignment is `AlignDefault` (often equivalent to
1134centered).
1133centered).
@@ -1260,9 +1259,6 @@ Fields:
1260`target`
1259`target`
1261: the link target (string)
1260: the link target (string)
1262
1261
1263−`title`
1264−: brief link description
1265−
1266`identifier`
1262`identifier`
1267: alias for `attr.identifier` (string)
1263: alias for `attr.identifier` (string)
1268
1264
@@ -1488,22 +1484,6 @@ Fields:
1488`tag`, `t`
1484`tag`, `t`
1489: the literal `Superscript` (string)
1485: the literal `Superscript` (string)
1490
1486
1491−### Underline {#type-underline}
1492−
1493−Underlined text
1494−
1495−Values of this type can be created with the
1496−[`pandoc.Underline`](#pandoc.underline) constructor.
1497−
1498−Fields:
1499−
1500−`content`
1501−: inline content ([List] of [Inlines])
1502−
1503−`tag`, `t`
1504−: the literal `Underline` (string)
1505−
1506−
1507## Element components
1487## Element components
1508
1488
1509### Attr {#type-attr}
1489### Attr {#type-attr}
@@ -1513,7 +1493,7 @@ with the [`pandoc.Attr`](#pandoc.attr) constructor. For
1513convenience, it is usually not necessary to construct the value
1493convenience, it is usually not necessary to construct the value
1514directly if it is part of an element, and it is sufficient to
1494directly if it is part of an element, and it is sufficient to
1515pass an HTML-like table. E.g., to create a span with identifier
1495pass an HTML-like table. E.g., to create a span with identifier
1516−"text" and classes "a" and "b", one can write:
1496+"text" and classes "a" and "b", on can write:
1517
1497
1518 local span = pandoc.Span('text', {id = 'text', class = 'a b'})
1498 local span = pandoc.Span('text', {id = 'text', class = 'a b'})
1519
1499
@@ -1540,41 +1520,6 @@ Fields:
1540List of key/value pairs. Values can be accessed by using keys as
1520List of key/value pairs. Values can be accessed by using keys as
1541indices to the list table.
1521indices to the list table.
1542
1522
1543−### Caption {#type-caption}
1544−
1545−The caption of a table, with an optional short caption.
1546−
1547−Fields:
1548−
1549−`long`
1550−: long caption (list of [Blocks])
1551−
1552−`short`
1553−: short caption (list of [Inlines])
1554−
1555−### Cell {#type-cell}
1556−
1557−A table cell.
1558−
1559−Fields:
1560−
1561−`attr`
1562−: cell attributes
1563−
1564−`alignment`
1565−: individual cell alignment ([Alignment]).
1566−
1567−`contents`
1568−: cell contents (list of [Blocks]).
1569−
1570−`col_span`
1571−: number of columns occupied by the cell; the height of the cell
1572− (integer).
1573−
1574−`row_span`
1575−: number of rows occupied by the cell; the height of the cell
1576− (integer).
1577−
1578### Citation {#type-citation}
1523### Citation {#type-citation}
1579
1524
1580Single citation entry
1525Single citation entry
@@ -1605,17 +1550,6 @@ Fields:
1605`hash`
1550`hash`
1606: hash (integer)
1551: hash (integer)
1607
1552
1608−### ColSpec {#type-colspec}
1609−
1610−Column alignment and width specification for a single table
1611−column.
1612−
1613−This is a pair with the following components:
1614−
1615−1. cell alignment ([Alignment]).
1616−2. table column width, as a fraction of the total table width
1617− (number).
1618−
1619### ListAttributes {#type-listattributes}
1553### ListAttributes {#type-listattributes}
1620
1554
1621List attributes
1555List attributes
@@ -1639,53 +1573,6 @@ Fields:
1639: delimiter of list numbers; one of `DefaultDelim`, `Period`,
1573: delimiter of list numbers; one of `DefaultDelim`, `Period`,
1640 `OneParen`, and `TwoParens` (string)
1574 `OneParen`, and `TwoParens` (string)
1641
1575
1642−### Row {#type-row}
1643−
1644−A table row.
1645−
1646−Tuple fields:
1647−
1648−1. row attributes
1649−2. row cells (list of [Cells])
1650−
1651−### TableBody {#type-tablebody}
1652−
1653−A body of a table, with an intermediate head and the specified
1654−number of row header columns.
1655−
1656−Fields:
1657−
1658−`attr`
1659−: table body attributes ([Attr])
1660−
1661−`body`
1662−: table body rows (list of [Rows])
1663−
1664−`head`
1665−: intermediate head (list of [Rows])
1666−
1667−`row_head_columns`
1668−: number of columns taken up by the row head of each row of a
1669− [TableBody]. The row body takes up the remaining columns.
1670−
1671−### TableFoot {#type-tablefoot}
1672−
1673−The foot of a table.
1674−
1675−This is a pair with the following components:
1676−
1677−1. attributes
1678−2. foot rows ([Rows])
1679−
1680−### TableHead {#type-tablehead}
1681−
1682−The head of a table.
1683−
1684−This is a pair with the following components:
1685−
1686−1. attributes
1687−2. head rows ([Rows])
1688−
1689## ReaderOptions {#type-readeroptions}
1576## ReaderOptions {#type-readeroptions}
1690
1577
1691Pandoc reader options
1578Pandoc reader options
@@ -1769,7 +1656,7 @@ A list is any Lua table with integer indices. Indices start at
1769one, so if `alist = {'value'}` then `alist[1] == 'value'`.
1656one, so if `alist = {'value'}` then `alist[1] == 'value'`.
1770
1657
1771Lists, when part of an element, or when generated during
1658Lists, when part of an element, or when generated during
1772−marshaling, are made instances of the `pandoc.List` type for
1659+marshalling, are made instances of the `pandoc.List` type for
1773convenience. The `pandoc.List` type is defined in the
1660convenience. The `pandoc.List` type is defined in the
1774[*pandoc.List*](#module-pandoc.list) module. See there for
1661[*pandoc.List*](#module-pandoc.list) module. See there for
1775available methods.
1662available methods.
@@ -1783,36 +1670,6 @@ table into a List.
1783A pandoc log message. Objects have no fields, but can be
1670A pandoc log message. Objects have no fields, but can be
1784converted to a string via `tostring`.
1671converted to a string via `tostring`.
1785
1672
1786−## SimpleTable {#type-simpletable}
1787−
1788−A simple table is a table structure which resembles the old (pre
1789−pandoc 2.10) Table type. Bi-directional conversion from and to
1790−[Tables](#type-table) is possible with the
1791−[`pandoc.utils.to_simple_table`](#pandoc.utils.to_simple_table)
1792−and
1793−[`pandoc.utils.from_simple_table`](#pandoc.utils.from_simple_table)
1794−function, respectively. Instances of this type can also be created
1795−directly with the [`pandoc.SimpleTable`](#pandoc.simpletable)
1796−constructor.
1797−
1798−Fields:
1799−
1800−`caption`:
1801−: [List] of [Inlines]
1802−
1803−`aligns`:
1804−: column alignments ([List] of [Alignments](#type-alignment))
1805−
1806−`widths`:
1807−: column widths; a ([List] of numbers)
1808−
1809−`headers`:
1810−: table header row ([List] of lists of [Blocks])
1811−
1812−`rows`:
1813−: table rows ([List] of rows, where a row is a list of lists of
1814− [Blocks])
1815−
1816## Version {#type-version}
1673## Version {#type-version}
1817
1674
1818A version object. This represents a software version like
1675A version object. This represents a software version like
@@ -1866,11 +1723,8 @@ Usage:
1866[Attributes]: #type-attributes
1723[Attributes]: #type-attributes
1867[Block]: #type-block
1724[Block]: #type-block
1868[Blocks]: #type-block
1725[Blocks]: #type-block
1869−[Caption]: #type-caption
1870−[Cells]: #type-cell
1871[Citation]: #type-citation
1726[Citation]: #type-citation
1872[Citations]: #type-citation
1727[Citations]: #type-citation
1873−[ColSpec]: #type-colspec
1874[CommonState]: #type-commonstate
1728[CommonState]: #type-commonstate
1875[Image]: #type-image
1729[Image]: #type-image
1876[Inline]: #type-inline
1730[Inline]: #type-inline
@@ -1884,12 +1738,6 @@ Usage:
1884[LogMessage]: #type-logmessage
1738[LogMessage]: #type-logmessage
1885[Pandoc]: #type-pandoc
1739[Pandoc]: #type-pandoc
1886[Para]: #type-para
1740[Para]: #type-para
1887−[Rows]: #type-row
1888−[SimpleTable]: #type-simpletable
1889−[Table]: #type-table
1890−[TableBody]: #type-tablebody
1891−[TableFoot]: #type-tablefoot
1892−[TableHead]: #type-tablehead
1893[Version]: #type-version
1741[Version]: #type-version
1894[`pandoc.utils.equals`]: #pandoc.utils.equals
1742[`pandoc.utils.equals`]: #pandoc.utils.equals
1895
1743
@@ -2196,29 +2044,26 @@ format, and functions to filter and modify a subtree.
2196
2044
2197 Returns: [RawBlock](#type-rawblock) object
2045 Returns: [RawBlock](#type-rawblock) object
2198
2046
2199−[`Table (caption, colspecs, head, bodies, foot[, attr])`]{#pandoc.table}
2047+[`Table (caption, aligns, widths, headers, rows)`]{#pandoc.table}
2200
2048
2201: Creates a table element.
2049: Creates a table element.
2202
2050
2203 Parameters:
2051 Parameters:
2204
2052
2205 `caption`:
2053 `caption`:
2206− : table [caption](#type-caption)
2054+ : table caption
2207−
2208− `colspecs`:
2209− : column alignments and widths (list of [ColSpec](#type-colspec)s)
2210
2055
2211− `head`:
2056+ `aligns`:
2212− : [table head](#type-tablehead)
2057+ : alignments
2213
2058
2214− `bodies`:
2059+ `widths`:
2215− : [table bodies](#type-tablebody)
2060+ : column widths
2216
2061
2217− `foot`:
2062+ `headers`:
2218− : [table foot](#type-tablefoot)
2063+ : header row
2219
2064
2220− `attr`:
2065+ `rows`:
2221− : element attributes
2066+ : table rows
2222
2067
2223 Returns: [Table](#type-table) object
2068 Returns: [Table](#type-table) object
2224
2069
@@ -2254,7 +2099,7 @@ format, and functions to filter and modify a subtree.
2254
2099
2255[`Emph (content)`]{#pandoc.emph}
2100[`Emph (content)`]{#pandoc.emph}
2256
2101
2257−: Creates an inline element representing emphasized text.
2102+: Creates an inline element representing emphasised text.
2258
2103
2259 Parameters:
2104 Parameters:
2260
2105
@@ -2457,7 +2302,7 @@ format, and functions to filter and modify a subtree.
2457
2302
2458[`Strikeout (content)`]{#pandoc.strikeout}
2303[`Strikeout (content)`]{#pandoc.strikeout}
2459
2304
2460−: Creates text which is struck out.
2305+: Creates text which is striked out.
2461
2306
2462 Parameters:
2307 Parameters:
2463
2308
@@ -2500,17 +2345,6 @@ format, and functions to filter and modify a subtree.
2500
2345
2501 Returns: [Superscript](#type-superscript) object
2346 Returns: [Superscript](#type-superscript) object
2502
2347
2503−[`Underline (content)`]{#pandoc.underline}
2504−
2505−: Creates an Underline inline element
2506−
2507− Parameters:
2508−
2509− `content`:
2510− : inline content
2511−
2512− Returns: [Underline](#type-underline) object
2513−
2514## Element components
2348## Element components
2515
2349
2516[`Attr ([identifier[, classes[, attributes]]])`]{#pandoc.attr}
2350[`Attr ([identifier[, classes[, attributes]]])`]{#pandoc.attr}
@@ -2573,52 +2407,6 @@ format, and functions to filter and modify a subtree.
2573
2407
2574 Returns: [ListAttributes](#type-listattributes) object
2408 Returns: [ListAttributes](#type-listattributes) object
2575
2409
2576−## Legacy types
2577−
2578−[`SimpleTable (caption, aligns, widths, headers, rows)`]{#pandoc.simpletable}
2579−
2580−: Creates a simple table resembling the old (pre pandoc 2.10)
2581− table type.
2582−
2583− Parameters:
2584−
2585− `caption`:
2586− : [List] of [Inlines]
2587−
2588− `aligns`:
2589− : column alignments ([List] of [Alignments](#type-alignment))
2590−
2591− `widths`:
2592− : column widths; a ([List] of numbers)
2593−
2594− `headers`:
2595− : table header row ([List] of lists of [Blocks])
2596−
2597− `rows`:
2598− : table rows ([List] of rows, where a row is a list of lists
2599− of [Blocks])
2600−
2601− Returns: [SimpleTable] object
2602−
2603− Usage:
2604−
2605− local caption = "Overview"
2606− local aligns = {pandoc.AlignDefault, pandoc.AlignDefault}
2607− local widths = {0, 0} -- let pandoc determine col widths
2608− local headers = {{pandoc.Plain({pandoc.Str "Language"})},
2609− {pandoc.Plain({pandoc.Str "Typing"})}}
2610− local rows = {
2611− {{pandoc.Plain "Haskell"}, {pandoc.Plain "static"}},
2612− {{pandoc.Plain "Lua"}, {pandoc.Plain "Dynamic"}},
2613− }
2614− simple_table = pandoc.SimpleTable(
2615− caption,
2616− aligns,
2617− widths,
2618− headers,
2619− rows
2620− )
2621−
2622## Constants
2410## Constants
2623
2411
2624[`AuthorInText`]{#pandoc.authorintext}
2412[`AuthorInText`]{#pandoc.authorintext}
@@ -2743,21 +2531,9 @@ format, and functions to filter and modify a subtree.
2743Runs command with arguments, passing it some input, and returns
2531Runs command with arguments, passing it some input, and returns
2744the output.
2532the output.
2745
2533
2746−Parameters:
2747−
2748−`command`
2749−: program to run; the executable will be resolved using default
2750− system methods (string).
2751−
2752−`args`
2753−: list of arguments to pass to the program (list of strings).
2754−
2755−`input`
2756−: data which is piped into the program via stdin (string).
2757−
2758Returns:
2534Returns:
2759
2535
2760−- Output of command, i.e. data printed to stdout (string)
2536+- Output of command.
2761
2537
2762Raises:
2538Raises:
2763
2539
@@ -2893,31 +2669,11 @@ Returns:
2893
2669
2894- Whether the two objects represent the same element (boolean)
2670- Whether the two objects represent the same element (boolean)
2895
2671
2896−### from\_simple\_table {#pandoc.utils.from_simple_table}
2897−
2898−`from_simple_table (table)`
2899−
2900−Creates a [Table] block element from a [SimpleTable]. This is
2901−useful for dealing with legacy code which was written for pandoc
2902−versions older than 2.10.
2903−
2904−Returns:
2905−
2906−- table block element ([Table])
2907−
2908−Usage:
2909−
2910− local simple = pandoc.SimpleTable(table)
2911− -- modify, using pre pandoc 2.10 methods
2912− simple.caption = pandoc.SmallCaps(simple.caption)
2913− -- create normal table block again
2914− table = pandoc.utils.from_simple_table(simple)
2915−
2916### make\_sections {#pandoc.utils.make_sections}
2672### make\_sections {#pandoc.utils.make_sections}
2917
2673
2918`make_sections (number_sections, base_level, blocks)`
2674`make_sections (number_sections, base_level, blocks)`
2919
2675
2920−Converts list of [Blocks](#type-block) into sections.
2676+Converst list of [Blocks](#type-block) into sections.
2921`Div`s will be created beginning at each `Header`
2677`Div`s will be created beginning at each `Header`
2922and containing following content until the next `Header`
2678and containing following content until the next `Header`
2923of comparable level. If `number_sections` is true,
2679of comparable level. If `number_sections` is true,
@@ -3032,24 +2788,6 @@ Usage:
3032 local pandoc_birth_year = to_roman_numeral(2006)
2788 local pandoc_birth_year = to_roman_numeral(2006)
3033 -- pandoc_birth_year == 'MMVI'
2789 -- pandoc_birth_year == 'MMVI'
3034
2790
3035−### to\_simple\_table {#pandoc.utils.to_simple_table}
3036−
3037−`to_simple_table (table)`
3038−
3039−Creates a [SimpleTable] out of a [Table] block.
3040−
3041−Returns:
3042−
3043−- a simple table object ([SimpleTable])
3044−
3045−Usage:
3046−
3047− local simple = pandoc.utils.to_simple_table(table)
3048− -- modify, using pre pandoc 2.10 methods
3049− simple.caption = pandoc.SmallCaps(simple.caption)
3050− -- create normal table block again
3051− table = pandoc.utils.from_simple_table(simple)
3052−
3053# Module pandoc.mediabag
2791# Module pandoc.mediabag
3054
2792
3055The `pandoc.mediabag` module allows accessing pandoc's media
2793The `pandoc.mediabag` module allows accessing pandoc's media
@@ -3084,8 +2822,7 @@ Clear-out the media bag, deleting all items.
3084
2822
3085`insert (filepath, mime_type, contents)`
2823`insert (filepath, mime_type, contents)`
3086
2824
3087−Adds a new entry to pandoc's media bag. Replaces any existing
2825+Adds a new entry to pandoc's media bag.
3088−mediabag entry with the same `filepath`.
3089
2826
3090Parameters:
2827Parameters:
3091
2828
@@ -3093,7 +2830,7 @@ Parameters:
3093: filename and path relative to the output folder.
2830: filename and path relative to the output folder.
3094
2831
3095`mime_type`:
2832`mime_type`:
3096−: the file's MIME type; use `nil` if unknown or unavailable.
2833+: the file's MIME type
3097
2834
3098`contents`:
2835`contents`:
3099: the binary contents of the file.
2836: the binary contents of the file.
@@ -3177,22 +2914,12 @@ Usage:
3177
2914
3178### fetch {#pandoc.mediabag.fetch}
2915### fetch {#pandoc.mediabag.fetch}
3179
2916
3180−`fetch (source)`
2917+`fetch (source, base_url)`
3181
2918
3182Fetches the given source from a URL or local file. Returns two
2919Fetches the given source from a URL or local file. Returns two
3183values: the contents of the file and the MIME type (or an empty
2920values: the contents of the file and the MIME type (or an empty
3184string).
2921string).
3185
2922
3186−The function will first try to retrieve `source` from the
3187−mediabag; if that fails, it will try to download it or read it
3188−from the local file system while respecting pandoc's "resource
3189−path" setting.
3190−
3191−Parameters:
3192−
3193−`source`:
3194−: path to a resource; either a local file path or URI
3195−
3196Returns:
2923Returns:
3197
2924
3198- the entries MIME type, or nil if the file was not found.
2925- the entries MIME type, or nil if the file was not found.
@@ -3201,11 +2928,11 @@ Returns:
3201Usage:
2928Usage:
3202
2929
3203 local diagram_url = "https://pandoc.org/diagram.jpg"
2930 local diagram_url = "https://pandoc.org/diagram.jpg"
3204− local mt, contents = pandoc.mediabag.fetch(diagram_url)
2931+ local mt, contents = pandoc.mediabag.fetch(diagram_url, ".")
3205
2932
3206# Module pandoc.List
2933# Module pandoc.List
3207
2934
3208−This module defines pandoc's list type. It comes with useful
2935+The this module defines pandoc's list type. It comes with useful
3209methods and convenience functions.
2936methods and convenience functions.
3210
2937
3211## Constructor
2938## Constructor
@@ -3308,7 +3035,7 @@ methods and convenience functions.
3308[`pandoc.List:insert ([pos], value)`]{#pandoc.list:insert}
3035[`pandoc.List:insert ([pos], value)`]{#pandoc.list:insert}
3309
3036
3310: Inserts element `value` at position `pos` in list, shifting
3037: Inserts element `value` at position `pos` in list, shifting
3311− elements to the next-greater index if necessary.
3038+ elements to the next-greater indix if necessary.
3312
3039
3313 This function is identical to
3040 This function is identical to
3314 [`table.insert`](https://www.lua.org/manual/5.3/manual.html#6.6).
3041 [`table.insert`](https://www.lua.org/manual/5.3/manual.html#6.6).
@@ -3355,7 +3082,7 @@ methods and convenience functions.
3355 Parameters:
3082 Parameters:
3356
3083
3357 `pos`:
3084 `pos`:
3358− : position of the list value that will be removed; defaults
3085+ : position of the list value that will be remove; defaults
3359 to the index of the last element
3086 to the index of the last element
3360
3087
3361 Returns: the removed element
3088 Returns: the removed element
@@ -3387,181 +3114,6 @@ methods and convenience functions.
3387 `comp`:
3114 `comp`:
3388 : Comparison function as described above.
3115 : Comparison function as described above.
3389
3116
3390−# Module pandoc.path
3391−
3392−Module for file path manipulations.
3393−
3394−## Static Fields {#pandoc.path-fields}
3395−
3396−### separator {#pandoc.path.separator}
3397−
3398−The character that separates directories.
3399−
3400−### search_path_separator {#pandoc.path.search_path_separator}
3401−
3402−The character that is used to separate the entries in the `PATH`
3403−environment variable.
3404−
3405−## Functions {#pandoc.path-functions}
3406−
3407−### directory (filepath) {#pandoc.path.directory}
3408−
3409−Gets the directory name, i.e., removes the last directory
3410−separator and everything after from the given path.
3411−
3412−Parameters:
3413−
3414−filepath
3415−: path (string)
3416−
3417−Returns:
3418−
3419−- The filepath up to the last directory separator. (string)
3420−
3421−### filename (filepath) {#pandoc.path.filename}
3422−
3423−Get the file name.
3424−
3425−Parameters:
3426−
3427−filepath
3428−: path (string)
3429−
3430−Returns:
3431−
3432−- File name part of the input path. (string)
3433−
3434−### is_absolute (filepath) {#pandoc.path.is_absolute}
3435−
3436−Checks whether a path is absolute, i.e. not fixed to a root.
3437−
3438−Parameters:
3439−
3440−filepath
3441−: path (string)
3442−
3443−Returns:
3444−
3445−- `true` iff `filepath` is an absolute path, `false` otherwise.
3446− (boolean)
3447−
3448−### is_relative (filepath) {#pandoc.path.is_relative}
3449−
3450−Checks whether a path is relative or fixed to a root.
3451−
3452−Parameters:
3453−
3454−filepath
3455−: path (string)
3456−
3457−Returns:
3458−
3459−- `true` iff `filepath` is a relative path, `false` otherwise.
3460− (boolean)
3461−
3462−### join (filepaths) {#pandoc.path.join}
3463−
3464−Join path elements back together by the directory separator.
3465−
3466−Parameters:
3467−
3468−filepaths
3469−: path components (list of strings)
3470−
3471−Returns:
3472−
3473−- The joined path. (string)
3474−
3475−### make_relative (path, root[, unsafe]) {#pandoc.path.make_relative}
3476−
3477−Contract a filename, based on a relative path. Note that the
3478−resulting path will usually not introduce `..` paths, as the
3479−presence of symlinks means `../b` may not reach `a/b` if it starts
3480−from `a/c`. For a worked example see [this blog
3481−post](https://neilmitchell.blogspot.co.uk/2015/10/filepaths-are-subtle-symlinks-are-hard.html).
3482−
3483−Set `unsafe` to a truthy value to a allow `..` in paths.
3484−
3485−Parameters:
3486−
3487−path
3488−: path to be made relative (string)
3489−
3490−root
3491−: root path (string)
3492−
3493−unsafe
3494−: whether to allow `..` in the result. (boolean)
3495−
3496−Returns:
3497−
3498−- contracted filename (string)
3499−
3500−### normalize (filepath) {#pandoc.path.normalize}
3501−
3502−Normalizes a path.
3503−
3504−- `//` makes sense only as part of a (Windows) network drive;
3505− elsewhere, multiple slashes are reduced to a single
3506− `path.separator` (platform dependent).
3507−- `/` becomes `path.separator` (platform dependent)
3508−- `./` -\> ''
3509−- an empty path becomes `.`
3510−
3511−Parameters:
3512−
3513−filepath
3514−: path (string)
3515−
3516−Returns:
3517−
3518−- The normalized path. (string)
3519−
3520−### split (filepath) {#pandoc.path.split}
3521−
3522−Splits a path by the directory separator.
3523−
3524−Parameters:
3525−
3526−filepath
3527−: path (string)
3528−
3529−Returns:
3530−
3531−- List of all path components. (list of strings)
3532−
3533−### split_extension (filepath) {#pandoc.path.split_extension}
3534−
3535−Splits the last extension from a file path and returns the parts. The
3536−extension, if present, includes the leading separator; if the path has
3537−no extension, then the empty string is returned as the extension.
3538−
3539−Parameters:
3540−
3541−filepath
3542−: path (string)
3543−
3544−Returns:
3545−
3546−- filepath without extension (string)
3547−
3548−- extension or empty string (string)
3549−
3550−### split_search_path (search_path) {#pandoc.path.split_search_path}
3551−
3552−Takes a string and splits it on the `search_path_separator` character.
3553−Blank items are ignored on Windows, and converted to `.` on Posix. On
3554−Windows path elements are stripped of quotes.
3555−
3556−Parameters:
3557−
3558−search_path
3559−: platform-specific search path (string)
3560−
3561−Returns:
3562−
3563−- list of directories in search path (list of strings)
3564−
3565# Module pandoc.system
3117# Module pandoc.system
3566
3118
3567Access to system information and functionality.
3119Access to system information and functionality.
doc/org.md+8−193
@@ -14,18 +14,18 @@ The following export keywords are supported:
14
14
15- AUTHOR: comma-separated list of author(s); fully supported.
15- AUTHOR: comma-separated list of author(s); fully supported.
16
16
17−- CREATOR: output generator; passed as plain-text metadata entry
17+- CREATOR: output generator; passed as metadata entry, but
18− `creator`, but not used by any default templates.
18+ ignored by most output formats.
19
19
20- DATE: creation or publication date; well supported by pandoc.
20- DATE: creation or publication date; well supported by pandoc.
21
21
22−- EMAIL: author email address; passed as plain-text metadata
22+- EMAIL: author email address; passed as metadata entry, but not
23− field `email`, but not used by any default templates.
23+ included in most output formats.
24
24
25−- LANGUAGE: document language; included as plain-text metadata
25+- LANGUAGE: currently unsupported; use `#+LANG:` instead.
26− field `lang`. The value should be a [BCP47 language tag].
27
26
28−- SELECT_TAGS: tags which select a tree for export.
27+- SELECT_TAGS: tags which select a tree for export. Currently
28+ *unsupported*.
29
29
30- EXCLUDE\_TAGS: tags which prevent a subtree from being
30- EXCLUDE\_TAGS: tags which prevent a subtree from being
31 exported. Fully supported.
31 exported. Fully supported.
@@ -36,136 +36,6 @@ The following export keywords are supported:
36 defaults to stdout unless a target has to be given as a command
36 defaults to stdout unless a target has to be given as a command
37 line option.
37 line option.
38
38
39−::: {.alert .alert-info}
40−Pandoc tries to be compatible with org-mode when exporting an org document. If
41−you find some behavior confusing, please do refer to org-mode
42−[Export-Settings](https://orgmode.org/manual/Export-Settings.html)
43−documentation. For example, a common confusion
44−([#3214](https://github.com/jgm/pandoc/issues/3214 "Problem with headers lower
45−then 3 in org-mode reader"), [#5169](https://github.com/jgm/pandoc/issues/5169
46−"org mode headings past level three converted to numbered outline list"),
47−[#6145](https://github.com/jgm/pandoc/issues/6145 "Headers 4 levels deep render
48−differently"), [#7236](https://github.com/jgm/pandoc/issues/7236 "In Org mode,
49−Header with level > 3 are not recognized as headers")) is treatment of headers
50−with level > 3 differently because org-mode sets `org-export-headline-levels`
51−(configurable with `#+OPTIONS: H:3`) to 3 by default.
52−:::
53−
54−[BCP47 language tag]: https://tools.ietf.org/html/bcp47
55−
56−Format-specific options
57−-----------------------
58−
59−Emacs Org-mode supports additional export options which work for
60−specific export formats. Some of these options' behavior differs
61−in Org-mode depending on the output format, while pandoc is
62−format-agnostic when parsing; differences are noted where they
63−occur.
64−
65−- DESCRIPTION: the document's description; pandoc parses this
66− option as text with markup into the `description` metadata
67− field. The field is not used in default templates.
68−
69− Pandoc follows the LaTeX exporter in that it allows markup in
70− the description. In contrast, the Org-mode HTML exporter treats
71− the description as plain text.
72−
73−- LATEX\_HEADER and LATEX_HEADER_EXTRA: arbitrary lines to add to
74− the document's preamble. Contrary to Org-mode, these lines are
75− not inserted before the hyperref settings, but close to the end
76− of the preamble.
77−
78− The contents of this option are stored as a list of raw LaTeX
79− lines in the `header-includes` metadata field.
80−
81−- LATEX\_CLASS: the LaTeX document class; like Org-mode, pandoc
82− uses `article` as the default class.
83−
84− The contents of this option are stored as plain text in the
85− `documentclass` metadata field.
86−
87−- LATEX\_CLASS\_OPTIONS: Options for the LaTeX document class;
88− fully supported.
89−
90− The contents of this option are stored as plain text in the
91− `classoption` metadata field.
92−
93−- SUBTITLE: the document's subtitle; fully supported.
94−
95− The content of this option is stored as inlines in the
96− `subtitle` metadata field.
97−
98−- HTML\_HEAD and HTML\_HEAD\_EXTRA: arbitrary lines to add to the
99− HTML document's head; fully supported.
100−
101− The contents of these options are stored as a list of raw HTML
102− lines in the `header-includes` metadata field.
103−
104−Pandoc-specific options
105−-----------------------
106−
107−Pandoc recognizes some export options not used by Emacs Org.
108−
109−- NOCITE: this field adds the listed citations to the
110− bibliography, without the need to mention them to the text. The
111− special value `@*` causes all available references to be added
112− the bibliography.
113−
114−- HEADER-INCLUDES: like HTML_HEAD and, LATEX_HEADER, but treats
115− the option's value as normal text with markup.
116−
117−- INSTITUTE: Affiliation of the author; the value is read as text
118− with markup and is stored in the `institute` metadata field. The
119− field is included by default on the title slide of beamer
120− presentations.
121−
122−Other options
123−-------------
124−
125−Any export option or directive not listed above has no effect when
126−parsing with pandoc. However, the information is retained as a
127−*raw block*. It can be accessed through a
128−[filter](https://pandoc.org/filters.html) and will be included in
129−org output.
130−
131−### Directives as metadata
132−
133−As an example, we will restore an old behavior of pandoc versions
134−prior to 2.10. Unknown keywords were treated as variable
135−definitions, and were added the document's metadata. Typing
136−`#+key: value` in the org-file used to have the same effect as
137−running pandoc with the `--metadata key=value` option.
138−
139−Since pandoc 2.10, each unhandled line starting with `#+` is kept
140−internally as a raw block with format `org`. This block can be
141−inspected and processed by a filter. Below is a [Lua
142−filter](https://pandoc.org/lua-filters.html) which converts these
143−unhandled lines into metadata key-value pairs.
144−
145−``` lua
146−-- intermediate store for variables and their values
147−local variables = {}
148−
149−--- Function called for each raw block element.
150−function RawBlock (raw)
151− -- Don't do anything unless the block contains *org* markup.
152− if raw.format ~= 'org' then return nil end
153−
154− -- extract variable name and value
155− local name, value = raw.text:match '#%+(%w+):%s*(.+)$'
156− if name and value then
157− variables[name] = value
158− end
159−end
160−
161−-- Add the extracted variables to the document's metadata.
162−function Meta (meta)
163− for name, value in pairs(variables) do
164− meta[name] = value
165− end
166− return meta
167−end
168−```
169
39
170Citations
40Citations
171=========
41=========
@@ -223,7 +93,7 @@ Example:
223
93
224### Parenthetical citation
94### Parenthetical citation
225
95
226−Citations surrounded by parentheses. The syntax is identical to
96+Citations surrounded by parantheses. The syntax is identical to
227in-text citations, except for the additional parentheses enclosing
97in-text citations, except for the additional parentheses enclosing
228the initial `cite` tag.
98the initial `cite` tag.
229
99
@@ -281,34 +151,6 @@ Use normal latex citation commands like `\cite{x}` or
281[org-ref]: https://github.com/jkitchin/org-ref
151[org-ref]: https://github.com/jkitchin/org-ref
282[John Kitchen]: https://kitchingroup.cheme.cmu.edu/
152[John Kitchen]: https://kitchingroup.cheme.cmu.edu/
283
153
284−Tables
285−======
286−
287−Pandoc supports normal org tables (sometimes called "pipe tables")
288−and grid tables (tables created by [table.el]).
289−
290−Column widths
291−-------------
292−
293−Org mode tables don't allow line-breaks within cells, and lines
294−which contain text can get very long. This often leads to tables
295−which run off the page when exporting, especially when exporting
296−to PDF via LaTeX. Overlong lines in the source text are this is
297−usually hidden by setting a [column width], but the default Emacs
298−exporters ignore that setting. Pandoc deviates from Emacs's
299−behavior and uses this information to resize the table columns
300−when exporting.
301−
302−Limitations
303−-----------
304−
305−There is no support yet for cells spanning multiple columns or
306−rows. The table.el grid tables allows rowspans and colspans and so
307−does pandoc's internal structure since 2.10, but the parser has
308−not been updated yet.
309−
310−[table.el]: http://table.sourceforge.net/
311−[column width]: https://orgmode.org/manual/Column-Width-and-Alignment.html
312
154
313Emphasis rules
155Emphasis rules
314==============
156==============
@@ -340,33 +182,6 @@ be parsed using default emphasis rules:
340 #+pandoc-emphasis-pre:
182 #+pandoc-emphasis-pre:
341 #+pandoc-emphasis-post:
183 #+pandoc-emphasis-post:
342
184
343−`smart` extension
344−=================
345−
346−Org-mode allows to insert certain characters via special character
347−sequences. For example, instead of typing the Unicode /HORIZONTAL
348−ELLISPIS/ character `…` by hand, one can instead type tree dots
349−`...`. En dashes and em dashes can be written as `--` and `---`
350−respectively. Furthermore, quotation marks (`"`) and
351−apostrophe-quotes (`'`) can be treated in a "smart" way,
352−potentially replacing them with proper, language specific unicode
353−quotation characters.
354−
355−Like in Markdown, these behaviors can be turned on all-at-once by
356−enabling the `smart` extension. However, disabling `smart` (the
357−default) will *not* necessarily disable smart quotes and special
358−strings. Instead, it will just result in the default Org mode
359−behavior.
360−
361−The special string feature can be turned off via the `#+OPTIONS:
362−-:nil` [export setting]. There are currently no command line flags
363−which control these features. As a workaround, one can use process
364−substitution, a feature supported by most shells. It allows to
365−provide the options line on the command line:
366−
367− pandoc -f org <(printf "#+OPTIONS: -:nil\n") …
368−
369−[export setting]: https://orgmode.org/manual/Export-Settings.html
370
185
371Currently unsupported features
186Currently unsupported features
372==============================
187==============================
doc/using-the-pandoc-api.md+16−30
@@ -14,7 +14,7 @@ and types is available at
14Pandoc is structured as a set of *readers*, which translate
14Pandoc is structured as a set of *readers*, which translate
15various input formats into an abstract syntax tree (the
15various input formats into an abstract syntax tree (the
16Pandoc AST) representing a structured document, and a set of
16Pandoc AST) representing a structured document, and a set of
17−*writers*, which render this AST into various output formats.
17+*writers*, which render this AST into various input formats.
18Pictorially:
18Pictorially:
19
19
20```
20```
@@ -90,14 +90,8 @@ Some notes:
90Let's look at the types of `readMarkdown` and `writeRST`:
90Let's look at the types of `readMarkdown` and `writeRST`:
91
91
92```haskell
92```haskell
93−readMarkdown :: (PandocMonad m, ToSources a)
93+readMarkdown :: PandocMonad m => ReaderOptions -> Text -> m Pandoc
94− => ReaderOptions
95− -> a
96− -> m Pandoc
97−writeRST :: PandocMonad m
94+writeRST :: PandocMonad m => WriterOptions -> Pandoc -> m Text
98− => WriterOptions
99− -> Pandoc
100− -> m Text
101```
95```
102
96
103The `PandocMonad m =>` part is a typeclass constraint.
97The `PandocMonad m =>` part is a typeclass constraint.
@@ -126,7 +120,7 @@ getVerbosity :: PandocMonad m => m Verbosity
126-- | Set the verbosity level.
120-- | Set the verbosity level.
127setVerbosity :: PandocMonad m => Verbosity -> m ()
121setVerbosity :: PandocMonad m => Verbosity -> m ()
128
122
129−-- Get the accumulated log messages (in temporal order).
123+-- Get the accomulated log messages (in temporal order).
130getLog :: PandocMonad m => m [LogMessage]
124getLog :: PandocMonad m => m [LogMessage]
131getLog = reverse <$> getsCommonState stLog
125getLog = reverse <$> getsCommonState stLog
132
126
@@ -139,7 +133,7 @@ report :: PandocMonad m => LogMessage -> m ()
139-- | Fetch an image or other item from the local filesystem or the net.
133-- | Fetch an image or other item from the local filesystem or the net.
140-- Returns raw content and maybe mime type.
134-- Returns raw content and maybe mime type.
141fetchItem :: PandocMonad m
135fetchItem :: PandocMonad m
142− => Text
136+ => String
143 -> m (B.ByteString, Maybe MimeType)
137 -> m (B.ByteString, Maybe MimeType)
144
138
145-- Set the resource path searched by 'fetchItem'.
139-- Set the resource path searched by 'fetchItem'.
@@ -161,13 +155,6 @@ Note that `PandocIO` is an instance of `MonadIO`, so you can
161use `liftIO` to perform arbitrary IO operations inside a pandoc
155use `liftIO` to perform arbitrary IO operations inside a pandoc
162conversion chain.
156conversion chain.
163
157
164−`readMarkdown` is polymorphic in its second argument, which
165−can be any type that is an instance of the `ToSources`
166−typeclass. You can use `Text`, as in the example above.
167−But you can also use `[(FilePath, Text)]`, if the input comes
168−from multiple files and you want to track source positions
169−accurately.
170−
171# Options
158# Options
172
159
173The first argument of each reader or writer is for
160The first argument of each reader or writer is for
@@ -190,8 +177,7 @@ Some particularly important options to know about:
1901. `writerTemplate`: By default, this is `Nothing`, which
1771. `writerTemplate`: By default, this is `Nothing`, which
191 means that a document fragment will be produced. If you
178 means that a document fragment will be produced. If you
192 want a full document, you need to specify `Just template`,
179 want a full document, you need to specify `Just template`,
193− where `template` is a `Template Text` from
194− [Text.Pandoc.Templates] containing the template's
180+ where `template` is a String containing the template's
195 contents (not the path).
181 contents (not the path).
196
182
1972. `readerExtensions` and `writerExtensions`: These specify
1832. `readerExtensions` and `writerExtensions`: These specify
@@ -213,8 +199,8 @@ of the Monoid typeclass and can easily be concatenated:
213import Text.Pandoc.Builder
199import Text.Pandoc.Builder
214
200
215mydoc :: Pandoc
201mydoc :: Pandoc
216−mydoc = doc $ header 1 (text (T.pack "Hello!"))
202+mydoc = doc $ header 1 (text "Hello!")
217− <> para (emph (text (T.pack "hello world")) <> text (T.pack "."))
203+ <> para (emph (text "hello world") <> text ".")
218
204
219main :: IO ()
205main :: IO ()
220main = print mydoc
206main = print mydoc
@@ -261,16 +247,16 @@ import qualified Data.Text as T
261import Data.List (intersperse)
247import Data.List (intersperse)
262
248
263data Station = Station{
249data Station = Station{
264− address :: T.Text
250+ address :: String
265− , name :: T.Text
251+ , name :: String
266− , cardsAccepted :: [T.Text]
252+ , cardsAccepted :: [String]
267 } deriving Show
253 } deriving Show
268
254
269instance FromJSON Station where
255instance FromJSON Station where
270 parseJSON (Object v) = Station <$>
256 parseJSON (Object v) = Station <$>
271 v .: "street_address" <*>
257 v .: "street_address" <*>
272 v .: "station_name" <*>
258 v .: "station_name" <*>
273− (T.words <$> (v .:? "cards_accepted" .!= ""))
259+ (words <$> (v .:? "cards_accepted" .!= ""))
274 parseJSON _ = mzero
260 parseJSON _ = mzero
275
261
276createLetter :: [Station] -> Pandoc
262createLetter :: [Station] -> Pandoc
@@ -328,7 +314,7 @@ users to override the system defaults. If you want to disable
328this behavior, use `setUserDataDir Nothing`.
314this behavior, use `setUserDataDir Nothing`.
329
315
330To render a template, use `renderTemplate'`, which takes two
316To render a template, use `renderTemplate'`, which takes two
331−arguments, a template (Text) and a context (any instance
317+arguments, a template (String) and a context (any instance
332of ToJSON). If you want to create a context from the metadata
318of ToJSON). If you want to create a context from the metadata
333part of a Pandoc document, use `metaToJSON'` from
319part of a Pandoc document, use `metaToJSON'` from
334[Text.Pandoc.Writers.Shared]. If you also want to incorporate
320[Text.Pandoc.Writers.Shared]. If you also want to incorporate
@@ -350,7 +336,7 @@ use `throwError`.
350In addition to errors, which stop execution of the conversion
336In addition to errors, which stop execution of the conversion
351pipeline, one can generate informational messages.
337pipeline, one can generate informational messages.
352Use `report` from [Text.Pandoc.Class] to issue a `LogMessage`.
338Use `report` from [Text.Pandoc.Class] to issue a `LogMessage`.
353−For a list of constructors for `LogMessage`, see
339+For a list of cosntructors for `LogMessage`, see
354[Text.Pandoc.Logging]. Note that each type of log message
340[Text.Pandoc.Logging]. Note that each type of log message
355is associated with a verbosity level. The verbosity level
341is associated with a verbosity level. The verbosity level
356(`setVerbosity`/`getVerbosity`) determines whether the report
342(`setVerbosity`/`getVerbosity`) determines whether the report
@@ -426,7 +412,7 @@ concatenated together. Here's an example that returns a
426list of the URLs linked to in a document:
412list of the URLs linked to in a document:
427
413
428```haskell
414```haskell
429−listURLs :: Pandoc -> [Text]
415+listURLs :: Pandoc -> [String]
430listURLs = query urls
416listURLs = query urls
431 where urls (Link _ _ (src, _)) = [src]
417 where urls (Link _ _ (src, _)) = [src]
432 urls _ = []
418 urls _ = []
@@ -445,7 +431,7 @@ structure and calling this function.
4451. Pandoc's parsers can exhibit pathological behavior on some
4311. Pandoc's parsers can exhibit pathological behavior on some
446 inputs. So it is always a good idea to wrap uses of pandoc
432 inputs. So it is always a good idea to wrap uses of pandoc
447 in a timeout function (e.g. `System.Timeout.timeout` from `base`)
433 in a timeout function (e.g. `System.Timeout.timeout` from `base`)
448− to prevent DoS attacks.
434+ to prevent DOS attacks.
449
435
4502. If pandoc generates HTML from untrusted user input, it is
4362. If pandoc generates HTML from untrusted user input, it is
451 always a good idea to filter the generated HTML through
437 always a good idea to filter the generated HTML through
linux/Dockerfilenew file+30
@@ -0,0 +1,30 @@
1+# USE ALPINE LINUX
2+FROM alpine:3.11
3+RUN apk --no-cache add \
4+ alpine-sdk \
5+ bash \
6+ ca-certificates \
7+ cabal \
8+ dpkg \
9+ fakeroot \
10+ ghc \
11+ git \
12+ gmp-dev \
13+ xz \
14+ zlib-dev \
15+ zlib-static
16+RUN mkdir -p /usr/src/ && \
17+ git clone https://github.com/jgm/pandoc /usr/src/pandoc
18+WORKDIR /usr/src/pandoc
19+CMD cabal --version && \
20+ ghc --version && \
21+ git pull && \
22+ git checkout -b work $TREE && \
23+ cabal new-update && \
24+ cabal new-clean && \
25+ cabal new-configure --enable-tests -f-export-dynamic -fstatic -fembed_data_files -fbibutils --ghc-options '-optc-Os -optl=-pthread -optl=-static -fPIC -split-sections' . pandoc-citeproc && \
26+ cabal new-build . pandoc-citeproc && \
27+ cabal new-test -j1 . pandoc-citeproc && \
28+ for f in $(find dist-newstyle -name 'pandoc*' -type f -perm +400); do cp $f /artifacts/; done && \
29+ bash linux/make_deb.sh && \
30+ bash linux/make_tarball.sh
linux/Makefilenew file+18
@@ -0,0 +1,18 @@
1+TREE?=HEAD
2+ARTIFACTS=`pwd`/artifacts
3+REVISION?=1
4+
5+build:
6+ mkdir -p $(ARTIFACTS)
7+ docker build -t alpine-pandoc .
8+ docker run --env TREE=$(TREE) --env REVISION=$(REVISION) \
9+ -v $(ARTIFACTS):/artifacts alpine-pandoc
10+
11+interact:
12+ docker run --env TREE=$(TREE) --env REVISION=$(REVISION) \
13+ -v $(ARTIFACTS):/artifacts -it alpine-pandoc bash
14+
15+setup:
16+ docker pull alpine:edge
17+
18+.PHONY: build setup interact
linux/control.in+1−1
@@ -5,7 +5,7 @@ Priority: optional
5Architecture: ARCHITECTURE
5Architecture: ARCHITECTURE
6Installed-Size: INSTALLED_SIZE
6Installed-Size: INSTALLED_SIZE
7Depends: libc6 (>= 2.13), libgmp10, zlib1g (>= 1:1.1.4)
7Depends: libc6 (>= 2.13), libgmp10, zlib1g (>= 1:1.1.4)
8−Replaces: pandoc-data
8+Replaces: pandoc-data, pandoc-citeproc
9Suggests: texlive-latex-recommended, texlive-xetex,
9Suggests: texlive-latex-recommended, texlive-xetex,
10 texlive-fonts-recommended
10 texlive-fonts-recommended
11Maintainer: John MacFarlane <jgm@berkeley.edu>
11Maintainer: John MacFarlane <jgm@berkeley.edu>
linux/make_artifacts.shdeleted−84
@@ -1,84 +0,0 @@
1−set -e
2−
3−MACHINE=$(uname -m)
4−case "$MACHINE" in
5− x86_64) ARCHITECTURE=amd64;;
6− i686) ARCHITECTURE=i386;;
7− i386) ARCHITECTURE=i386;;
8− aarch64) ARCHITECTURE=arm64;;
9− *) ARCHITECTURE=unknown;;
10−esac
11−
12−ARTIFACTS="${ARTIFACTS:-/artifacts}"
13−
14−# This is our sentinel that tells us when we're done.
15−rm -f $ARTIFACTS/DONE
16−
17−clean_up() {
18− echo "All done!" > "$ARTIFACTS/DONE"
19−}
20−trap clean_up EXIT
21−
22−# build binaries
23−
24−cabal --version
25−ghc --version
26−
27−cabal v2-update
28−cabal v2-clean
29−cabal v2-configure --enable-tests -f-export-dynamic -fembed_data_files --enable-executable-static --ghc-options '-j4 +RTS -A256m -RTS -split-sections -optc-Os -optl=-pthread' pandoc
30−cabal v2-build -j4
31−cabal v2-test -j4
32−for f in $(find dist-newstyle -name 'pandoc' -type f -perm /400); do cp $f /artifacts/; done
33−
34−# make deb
35−
36−VERSION=`$ARTIFACTS/pandoc --version | awk '{print $2; exit;}'`
37−REVISION=${REVISION:-1}
38−DEBVER=$VERSION-$REVISION
39−BASE=pandoc-$DEBVER-$ARCHITECTURE
40−DIST=`pwd`/$BASE
41−DEST=$DIST/usr
42−COPYRIGHT=$DEST/share/doc/pandoc/copyright
43−
44−mkdir -p $DEST/bin
45−mkdir -p $DEST/share/man/man1
46−mkdir -p $DEST/share/doc/pandoc
47−
48−find $DIST -type d | xargs chmod 755
49−cp $ARTIFACTS/pandoc $DEST/bin/
50−strip $DEST/bin/pandoc
51−cp /mnt/man/pandoc.1 $DEST/share/man/man1/pandoc.1
52−gzip -9 $DEST/share/man/man1/pandoc.1
53−
54−cp /mnt/COPYRIGHT $COPYRIGHT
55−echo "" >> $COPYRIGHT
56−
57−INSTALLED_SIZE=$(du -k -s $DEST | awk '{print $1}')
58−mkdir $DIST/DEBIAN
59−perl -pe "s/VERSION/$DEBVER/" linux/control.in | \
60− perl -pe "s/ARCHITECTURE/$ARCHITECTURE/" | \
61− perl -pe "s/INSTALLED_SIZE/$INSTALLED_SIZE/" \
62− > $DIST/DEBIAN/control
63−
64−# we limit compression to avoid OOM error
65−fakeroot dpkg-deb -Zgzip -z9 --build $DIST
66−rm -rf $DIST
67−cp $BASE.deb $ARTIFACTS/
68−
69−# Make tarball
70−
71−TARGET=pandoc-$VERSION
72−cd $ARTIFACTS
73−rm -rf $TARGET
74−mkdir $TARGET
75−mkdir $TARGET/bin $TARGET/share $TARGET/share/man $TARGET/share/man/man1
76−cp /mnt/man/pandoc.1 $TARGET/share/man/man1
77−mv pandoc $TARGET/bin
78−strip $TARGET/bin/pandoc
79−gzip -9 $TARGET/share/man/man1/pandoc.1
80−
81−tar cvzf $TARGET-linux-$ARCHITECTURE.tar.gz $TARGET
82−rm -r $TARGET
83−
84−exit 0
linux/make_deb.shnew file+51
@@ -0,0 +1,51 @@
1+set -e
2+
3+MACHINE=$(uname -m)
4+case "$MACHINE" in
5+ x86_64) ARCHITECTURE=amd64;;
6+ i686) ARCHITECTURE=i386;;
7+ i386) ARCHITECTURE=i386;;
8+esac
9+
10+ARTIFACTS="${ARTIFACTS:-/artifacts}"
11+
12+VERSION=`$ARTIFACTS/pandoc --version | awk '{print $2; exit;}'`
13+REVISION=${REVISION:-1}
14+DEBVER=$VERSION-$REVISION
15+BASE=pandoc-$DEBVER-$ARCHITECTURE
16+DIST=`pwd`/$BASE
17+DEST=$DIST/usr
18+COPYRIGHT=$DEST/share/doc/pandoc/copyright
19+
20+PANDOC_CITEPROC_VERSION=`$ARTIFACTS/pandoc-citeproc --version | awk '{print $2;}'`
21+
22+mkdir -p $DEST/bin
23+mkdir -p $DEST/share/man/man1
24+mkdir -p $DEST/share/doc/pandoc
25+
26+mkdir -p $DEST/share/doc/pandoc-citeproc
27+find $DIST -type d | xargs chmod 755
28+cp $ARTIFACTS/pandoc $DEST/bin/
29+cp $ARTIFACTS/pandoc-citeproc $DEST/bin/
30+strip $DEST/bin/pandoc
31+strip $DEST/bin/pandoc-citeproc
32+cp man/pandoc.1 $DEST/share/man/man1/pandoc.1
33+$ARTIFACTS/pandoc-citeproc --man > $DEST/share/man/man1/pandoc-citeproc.1
34+gzip -9 $DEST/share/man/man1/pandoc.1
35+gzip -9 $DEST/share/man/man1/pandoc-citeproc.1
36+
37+cp COPYRIGHT $COPYRIGHT
38+echo "" >> $COPYRIGHT
39+echo "pandoc-citeproc" >> $COPYRIGHT
40+$ARTIFACTS/pandoc-citeproc --license >> $COPYRIGHT
41+
42+INSTALLED_SIZE=$(du -k -s $DEST | awk '{print $1}')
43+mkdir $DIST/DEBIAN
44+perl -pe "s/VERSION/$DEBVER/" linux/control.in | \
45+ perl -pe "s/ARCHITECTURE/$ARCHITECTURE/" | \
46+ perl -pe "s/INSTALLED_SIZE/$INSTALLED_SIZE/" \
47+ > $DIST/DEBIAN/control
48+
49+fakeroot dpkg-deb --build $DIST
50+rm -rf $DIST
51+cp $BASE.deb $ARTIFACTS/
linux/make_tarball.shnew file+19
@@ -0,0 +1,19 @@
1+set -e
2+
3+ARTIFACTS="${ARTIFACTS:-/artifacts}"
4+VERSION=`$ARTIFACTS/pandoc --version | awk '{print $2; exit;}'`
5+TARGET=pandoc-$VERSION
6+
7+cd $ARTIFACTS
8+rm -rf $TARGET
9+mkdir $TARGET
10+mkdir $TARGET/bin $TARGET/share $TARGET/share/man $TARGET/share/man/man1
11+./pandoc-citeproc --man > $TARGET/share/man/man1/pandoc-citeproc.1
12+cp /usr/src/pandoc/man/pandoc.1 $TARGET/share/man/man1
13+mv pandoc pandoc-citeproc $TARGET/bin
14+strip $TARGET/bin/pandoc
15+strip $TARGET/bin/pandoc-citeproc
16+gzip -9 $TARGET/share/man/man1/pandoc.1
17+gzip -9 $TARGET/share/man/man1/pandoc-citeproc.1
18+tar cvzf $TARGET-linux-amd64.tar.gz $TARGET
19+rm -r $TARGET
macos/Makefile+2−1
@@ -6,8 +6,9 @@ ALL=$(BASE)-macOS.pkg $(BASE)-macOS.zip
6all: $(ALL) notarize
6all: $(ALL) notarize
7
7
8signed.txt: $(DEST)
8signed.txt: $(DEST)
9− chmod +x $(DEST)/bin/pandoc
9+ chmod +x $(DEST)/bin/pandoc $(DEST)/bin/pandoc-citeproc
10 codesign --force --options runtime -s "5U2WKE6DES" $(DEST)/bin/pandoc
10 codesign --force --options runtime -s "5U2WKE6DES" $(DEST)/bin/pandoc
11+ codesign --force --options runtime -s "5U2WKE6DES" $(DEST)/bin/pandoc-citeproc
11 echo "SIGNED" > signed.txt
12 echo "SIGNED" > signed.txt
12
13
13pandoc.pkg: signed.txt
14pandoc.pkg: signed.txt
man/pandoc.1+707−1323
@@ -1,13 +1,13 @@
1−'\" t
1+.\"t
2−.\" Automatically generated by Pandoc 2.14.0.1
2+.\" Automatically generated by Pandoc 2.9.2
3.\"
3.\"
4−.TH "Pandoc User\[cq]s Guide" "" "June 20, 2021" "pandoc 2.14.0.3" ""
4+.TH "Pandoc User\[aq]s Guide" "" "March 23, 2020" "pandoc 2.9.2.1" ""
5.hy
5.hy
6.SH NAME
6.SH NAME
7pandoc - general markup converter
7pandoc - general markup converter
8.SH SYNOPSIS
8.SH SYNOPSIS
9.PP
9.PP
10−\f[C]pandoc\f[R] [\f[I]options\f[R]] [\f[I]input-file\f[R]]\&...
10+\f[C]pandoc\f[R] [\f[I]options\f[R]] [\f[I]input-file\f[R]]...
11.SH DESCRIPTION
11.SH DESCRIPTION
12.PP
12.PP
13Pandoc is a Haskell library for converting from one markup format to
13Pandoc is a Haskell library for converting from one markup format to
@@ -20,10 +20,10 @@ For the full lists of input and output formats, see the \f[C]--from\f[R]
20and \f[C]--to\f[R] options below.
20and \f[C]--to\f[R] options below.
21Pandoc can also produce PDF output: see creating a PDF, below.
21Pandoc can also produce PDF output: see creating a PDF, below.
22.PP
22.PP
23−Pandoc\[cq]s enhanced version of Markdown includes syntax for tables,
23+Pandoc\[aq]s enhanced version of Markdown includes syntax for tables,
24definition lists, metadata blocks, footnotes, citations, math, and much
24definition lists, metadata blocks, footnotes, citations, math, and much
25more.
25more.
26−See below under Pandoc\[cq]s Markdown.
26+See below under Pandoc\[aq]s Markdown.
27.PP
27.PP
28Pandoc has a modular design: it consists of a set of readers, which
28Pandoc has a modular design: it consists of a set of readers, which
29parse text in a given format and produce a native representation of the
29parse text in a given format and produce a native representation of the
@@ -33,15 +33,15 @@ Thus, adding an input or output format requires only adding a reader or
33writer.
33writer.
34Users can also run custom pandoc filters to modify the intermediate AST.
34Users can also run custom pandoc filters to modify the intermediate AST.
35.PP
35.PP
36−Because pandoc\[cq]s intermediate representation of a document is less
36+Because pandoc\[aq]s intermediate representation of a document is less
37expressive than many of the formats it converts between, one should not
37expressive than many of the formats it converts between, one should not
38expect perfect conversions between every format and every other.
38expect perfect conversions between every format and every other.
39Pandoc attempts to preserve the structural elements of a document, but
39Pandoc attempts to preserve the structural elements of a document, but
40not formatting details such as margin size.
40not formatting details such as margin size.
41And some document elements, such as complex tables, may not fit into
41And some document elements, such as complex tables, may not fit into
42−pandoc\[cq]s simple document model.
42+pandoc\[aq]s simple document model.
43−While conversions from pandoc\[cq]s Markdown to all formats aspire to be
43+While conversions from pandoc\[aq]s Markdown to all formats aspire to be
44−perfect, conversions from formats more expressive than pandoc\[cq]s
44+perfect, conversions from formats more expressive than pandoc\[aq]s
45Markdown can be expected to be lossy.
45Markdown can be expected to be lossy.
46.SS Using pandoc
46.SS Using pandoc
47.PP
47.PP
@@ -57,9 +57,9 @@ pandoc -o output.html input.txt
57.fi
57.fi
58.PP
58.PP
59By default, pandoc produces a document fragment.
59By default, pandoc produces a document fragment.
60−To produce a standalone document (e.g.\ a valid HTML file including
60+To produce a standalone document (e.g.
61−\f[C]<head>\f[R] and \f[C]<body>\f[R]), use the \f[C]-s\f[R] or
61+a valid HTML file including \f[C]<head>\f[R] and \f[C]<body>\f[R]), use
62−\f[C]--standalone\f[R] flag:
62+the \f[C]-s\f[R] or \f[C]--standalone\f[R] flag:
63.IP
63.IP
64.nf
64.nf
65\f[C]
65\f[C]
@@ -115,10 +115,10 @@ pandoc -o hello.tex hello.txt
115.PP
115.PP
116will convert \f[C]hello.txt\f[R] from Markdown to LaTeX.
116will convert \f[C]hello.txt\f[R] from Markdown to LaTeX.
117If no output file is specified (so that output goes to
117If no output file is specified (so that output goes to
118−\f[I]stdout\f[R]), or if the output file\[cq]s extension is unknown, the
118+\f[I]stdout\f[R]), or if the output file\[aq]s extension is unknown, the
119output format will default to HTML.
119output format will default to HTML.
120If no input file is specified (so that input comes from
120If no input file is specified (so that input comes from
121−\f[I]stdin\f[R]), or if the input files\[cq] extensions are unknown, the
121+\f[I]stdin\f[R]), or if the input files\[aq] extensions are unknown, the
122input format will be assumed to be Markdown.
122input format will be assumed to be Markdown.
123.SS Character encoding
123.SS Character encoding
124.PP
124.PP
@@ -172,15 +172,15 @@ You can then test it with \f[C]pdflatex test.tex\f[R].
172When using LaTeX, the following packages need to be available (they are
172When using LaTeX, the following packages need to be available (they are
173included with all recent versions of TeX Live): \f[C]amsfonts\f[R],
173included with all recent versions of TeX Live): \f[C]amsfonts\f[R],
174\f[C]amsmath\f[R], \f[C]lm\f[R], \f[C]unicode-math\f[R],
174\f[C]amsmath\f[R], \f[C]lm\f[R], \f[C]unicode-math\f[R],
175−\f[C]iftex\f[R], \f[C]listings\f[R] (if the \f[C]--listings\f[R] option
175+\f[C]ifxetex\f[R], \f[C]ifluatex\f[R], \f[C]listings\f[R] (if the
176+\f[C]--listings\f[R] option is used), \f[C]fancyvrb\f[R],
176−is used), \f[C]fancyvrb\f[R], \f[C]longtable\f[R], \f[C]booktabs\f[R],
177+\f[C]longtable\f[R], \f[C]booktabs\f[R], \f[C]graphicx\f[R] (if the
177−\f[C]graphicx\f[R] (if the document contains images),
178+document contains images), \f[C]hyperref\f[R], \f[C]xcolor\f[R],
178−\f[C]hyperref\f[R], \f[C]xcolor\f[R], \f[C]ulem\f[R], \f[C]geometry\f[R]
179−(with the \f[C]geometry\f[R] variable set), \f[C]setspace\f[R] (with
179+\f[C]ulem\f[R], \f[C]geometry\f[R] (with the \f[C]geometry\f[R] variable
180+set), \f[C]setspace\f[R] (with \f[C]linestretch\f[R]), and
180−\f[C]linestretch\f[R]), and \f[C]babel\f[R] (with \f[C]lang\f[R]).
181+\f[C]babel\f[R] (with \f[C]lang\f[R]).
181The use of \f[C]xelatex\f[R] or \f[C]lualatex\f[R] as the PDF engine
182The use of \f[C]xelatex\f[R] or \f[C]lualatex\f[R] as the PDF engine
182requires \f[C]fontspec\f[R].
183requires \f[C]fontspec\f[R].
183−\f[C]lualatex\f[R] uses \f[C]selnolig\f[R].
184\f[C]xelatex\f[R] uses \f[C]polyglossia\f[R] (with \f[C]lang\f[R]),
184\f[C]xelatex\f[R] uses \f[C]polyglossia\f[R] (with \f[C]lang\f[R]),
185\f[C]xecjk\f[R], and \f[C]bidi\f[R] (with the \f[C]dir\f[R] variable
185\f[C]xecjk\f[R], and \f[C]bidi\f[R] (with the \f[C]dir\f[R] variable
186set).
186set).
@@ -227,18 +227,10 @@ Specify input format.
227\f[I]FORMAT\f[R] can be:
227\f[I]FORMAT\f[R] can be:
228.RS
228.RS
229.IP \[bu] 2
229.IP \[bu] 2
230−\f[C]bibtex\f[R] (BibTeX bibliography)
231−.IP \[bu] 2
232−\f[C]biblatex\f[R] (BibLaTeX bibliography)
233−.IP \[bu] 2
234\f[C]commonmark\f[R] (CommonMark Markdown)
230\f[C]commonmark\f[R] (CommonMark Markdown)
235.IP \[bu] 2
231.IP \[bu] 2
236−\f[C]commonmark_x\f[R] (CommonMark Markdown with extensions)
237−.IP \[bu] 2
238\f[C]creole\f[R] (Creole 1.0)
232\f[C]creole\f[R] (Creole 1.0)
239.IP \[bu] 2
233.IP \[bu] 2
240−\f[C]csljson\f[R] (CSL JSON bibliography)
241−.IP \[bu] 2
242\f[C]csv\f[R] (CSV table)
234\f[C]csv\f[R] (CSV table)
243.IP \[bu] 2
235.IP \[bu] 2
244\f[C]docbook\f[R] (DocBook)
236\f[C]docbook\f[R] (DocBook)
@@ -263,13 +255,13 @@ if you need extensions not supported in \f[C]gfm\f[R].
263.IP \[bu] 2
255.IP \[bu] 2
264\f[C]jats\f[R] (JATS XML)
256\f[C]jats\f[R] (JATS XML)
265.IP \[bu] 2
257.IP \[bu] 2
266−\f[C]jira\f[R] (Jira/Confluence wiki markup)
258+\f[C]jira\f[R] (Jira wiki markup)
267.IP \[bu] 2
259.IP \[bu] 2
268\f[C]json\f[R] (JSON version of native AST)
260\f[C]json\f[R] (JSON version of native AST)
269.IP \[bu] 2
261.IP \[bu] 2
270\f[C]latex\f[R] (LaTeX)
262\f[C]latex\f[R] (LaTeX)
271.IP \[bu] 2
263.IP \[bu] 2
272−\f[C]markdown\f[R] (Pandoc\[cq]s Markdown)
264+\f[C]markdown\f[R] (Pandoc\[aq]s Markdown)
273.IP \[bu] 2
265.IP \[bu] 2
274\f[C]markdown_mmd\f[R] (MultiMarkdown)
266\f[C]markdown_mmd\f[R] (MultiMarkdown)
275.IP \[bu] 2
267.IP \[bu] 2
@@ -319,18 +311,10 @@ Specify output format.
319.IP \[bu] 2
311.IP \[bu] 2
320\f[C]beamer\f[R] (LaTeX beamer slide show)
312\f[C]beamer\f[R] (LaTeX beamer slide show)
321.IP \[bu] 2
313.IP \[bu] 2
322−\f[C]bibtex\f[R] (BibTeX bibliography)
323−.IP \[bu] 2
324−\f[C]biblatex\f[R] (BibLaTeX bibliography)
325−.IP \[bu] 2
326\f[C]commonmark\f[R] (CommonMark Markdown)
314\f[C]commonmark\f[R] (CommonMark Markdown)
327.IP \[bu] 2
315.IP \[bu] 2
328−\f[C]commonmark_x\f[R] (CommonMark Markdown with extensions)
329−.IP \[bu] 2
330\f[C]context\f[R] (ConTeXt)
316\f[C]context\f[R] (ConTeXt)
331.IP \[bu] 2
317.IP \[bu] 2
332−\f[C]csljson\f[R] (CSL JSON bibliography)
333−.IP \[bu] 2
334\f[C]docbook\f[R] or \f[C]docbook4\f[R] (DocBook 4)
318\f[C]docbook\f[R] or \f[C]docbook4\f[R] (DocBook 4)
335.IP \[bu] 2
319.IP \[bu] 2
336\f[C]docbook5\f[R] (DocBook 5)
320\f[C]docbook5\f[R] (DocBook 5)
@@ -351,8 +335,8 @@ if you need extensions not supported in \f[C]gfm\f[R].
351.IP \[bu] 2
335.IP \[bu] 2
352\f[C]haddock\f[R] (Haddock markup)
336\f[C]haddock\f[R] (Haddock markup)
353.IP \[bu] 2
337.IP \[bu] 2
354−\f[C]html\f[R] or \f[C]html5\f[R] (HTML, i.e.\ HTML5/XHTML polyglot
338+\f[C]html\f[R] or \f[C]html5\f[R] (HTML, i.e.
355−markup)
339+HTML5/XHTML polyglot markup)
356.IP \[bu] 2
340.IP \[bu] 2
357\f[C]html4\f[R] (XHTML 1.0 Transitional)
341\f[C]html4\f[R] (XHTML 1.0 Transitional)
358.IP \[bu] 2
342.IP \[bu] 2
@@ -368,7 +352,7 @@ markup)
368.IP \[bu] 2
352.IP \[bu] 2
369\f[C]jats\f[R] (alias for \f[C]jats_archiving\f[R])
353\f[C]jats\f[R] (alias for \f[C]jats_archiving\f[R])
370.IP \[bu] 2
354.IP \[bu] 2
371−\f[C]jira\f[R] (Jira/Confluence wiki markup)
355+\f[C]jira\f[R] (Jira wiki markup)
372.IP \[bu] 2
356.IP \[bu] 2
373\f[C]json\f[R] (JSON version of native AST)
357\f[C]json\f[R] (JSON version of native AST)
374.IP \[bu] 2
358.IP \[bu] 2
@@ -376,7 +360,7 @@ markup)
376.IP \[bu] 2
360.IP \[bu] 2
377\f[C]man\f[R] (roff man)
361\f[C]man\f[R] (roff man)
378.IP \[bu] 2
362.IP \[bu] 2
379−\f[C]markdown\f[R] (Pandoc\[cq]s Markdown)
363+\f[C]markdown\f[R] (Pandoc\[aq]s Markdown)
380.IP \[bu] 2
364.IP \[bu] 2
381\f[C]markdown_mmd\f[R] (MultiMarkdown)
365\f[C]markdown_mmd\f[R] (MultiMarkdown)
382.IP \[bu] 2
366.IP \[bu] 2
@@ -457,15 +441,16 @@ On *nix and macOS systems this will be the \f[C]pandoc\f[R] subdirectory
457of the XDG data directory (by default, \f[C]$HOME/.local/share\f[R],
441of the XDG data directory (by default, \f[C]$HOME/.local/share\f[R],
458overridable by setting the \f[C]XDG_DATA_HOME\f[R] environment
442overridable by setting the \f[C]XDG_DATA_HOME\f[R] environment
459variable).
443variable).
460−If that directory does not exist and \f[C]$HOME/.pandoc\f[R] exists, it
444+If that directory does not exist, \f[C]$HOME/.pandoc\f[R] will be used
461−will be used (for backwards compatibility).
445+(for backwards compatibility).
462−On Windows the default user data directory is
446+In Windows the default user data directory is
463\f[C]C:\[rs]Users\[rs]USERNAME\[rs]AppData\[rs]Roaming\[rs]pandoc\f[R].
447\f[C]C:\[rs]Users\[rs]USERNAME\[rs]AppData\[rs]Roaming\[rs]pandoc\f[R].
464You can find the default user data directory on your system by looking
448You can find the default user data directory on your system by looking
465at the output of \f[C]pandoc --version\f[R].
449at the output of \f[C]pandoc --version\f[R].
466−Data files placed in this directory (for example,
467−\f[C]reference.odt\f[R], \f[C]reference.docx\f[R], \f[C]epub.css\f[R],
450+A \f[C]reference.odt\f[R], \f[C]reference.docx\f[R], \f[C]epub.css\f[R],
451+\f[C]templates\f[R], \f[C]slidy\f[R], \f[C]slideous\f[R], or
452+\f[C]s5\f[R] directory placed in this directory will override
468−\f[C]templates\f[R]) will override pandoc\[cq]s normal defaults.
453+pandoc\[aq]s normal defaults.
469.TP
454.TP
470\f[B]\f[CB]-d\f[B]\f[R] \f[I]FILE\f[R], \f[B]\f[CB]--defaults=\f[B]\f[R]\f[I]FILE\f[R]
455\f[B]\f[CB]-d\f[B]\f[R] \f[I]FILE\f[R], \f[B]\f[CB]--defaults=\f[B]\f[R]\f[I]FILE\f[R]
471Specify a set of default option settings.
456Specify a set of default option settings.
@@ -496,6 +481,7 @@ eval \[dq]$(pandoc --bash-completion)\[dq]
496.TP
481.TP
497\f[B]\f[CB]--verbose\f[B]\f[R]
482\f[B]\f[CB]--verbose\f[B]\f[R]
498Give verbose debugging output.
483Give verbose debugging output.
484+Currently this only has an effect with PDF output.
499.TP
485.TP
500\f[B]\f[CB]--quiet\f[B]\f[R]
486\f[B]\f[CB]--quiet\f[B]\f[R]
501Suppress warning messages.
487Suppress warning messages.
@@ -518,7 +504,7 @@ List supported output formats, one per line.
518List supported extensions for \f[I]FORMAT\f[R], one per line, preceded
504List supported extensions for \f[I]FORMAT\f[R], one per line, preceded
519by a \f[C]+\f[R] or \f[C]-\f[R] indicating whether it is enabled by
505by a \f[C]+\f[R] or \f[C]-\f[R] indicating whether it is enabled by
520default in \f[I]FORMAT\f[R].
506default in \f[I]FORMAT\f[R].
521−If \f[I]FORMAT\f[R] is not specified, defaults for pandoc\[cq]s Markdown
507+If \f[I]FORMAT\f[R] is not specified, defaults for pandoc\[aq]s Markdown
522are given.
508are given.
523.TP
509.TP
524\f[B]\f[CB]--list-highlight-languages\f[B]\f[R]
510\f[B]\f[CB]--list-highlight-languages\f[B]\f[R]
@@ -563,7 +549,7 @@ This option is useful for converting word processing documents where
563users have used empty paragraphs to create inter-paragraph space.
549users have used empty paragraphs to create inter-paragraph space.
564.TP
550.TP
565\f[B]\f[CB]--indented-code-classes=\f[B]\f[R]\f[I]CLASSES\f[R]
551\f[B]\f[CB]--indented-code-classes=\f[B]\f[R]\f[I]CLASSES\f[R]
566−Specify classes to use for indented code blocks\[en]for example,
552+Specify classes to use for indented code blocks--for example,
567\f[C]perl,numberLines\f[R] or \f[C]haskell\f[R].
553\f[C]perl,numberLines\f[R] or \f[C]haskell\f[R].
568Multiple classes may be separated by spaces or commas.
554Multiple classes may be separated by spaces or commas.
569.TP
555.TP
@@ -585,7 +571,7 @@ Reading binary files (docx, odt, epub) implies \f[C]--file-scope\f[R].
585Specify an executable to be used as a filter transforming the pandoc AST
571Specify an executable to be used as a filter transforming the pandoc AST
586after the input is parsed and before the output is written.
572after the input is parsed and before the output is written.
587The executable should read JSON from stdin and write JSON to stdout.
573The executable should read JSON from stdin and write JSON to stdout.
588−The JSON must be formatted like pandoc\[cq]s own JSON input and output.
574+The JSON must be formatted like pandoc\[aq]s own JSON input and output.
589The name of the output format will be passed to the filter as the first
575The name of the output format will be passed to the filter as the first
590argument.
576argument.
591Hence,
577Hence,
@@ -625,13 +611,13 @@ above).
625.IP "3." 3
611.IP "3." 3
626\f[C]$PATH\f[R] (executable only)
612\f[C]$PATH\f[R] (executable only)
627.PP
613.PP
628−Filters, Lua-filters, and citeproc processing are applied in the order
614+Filters and Lua-filters are applied in the order specified on the
629−specified on the command line.
615+command line.
630.RE
616.RE
631.TP
617.TP
632\f[B]\f[CB]-L\f[B]\f[R] \f[I]SCRIPT\f[R], \f[B]\f[CB]--lua-filter=\f[B]\f[R]\f[I]SCRIPT\f[R]
618\f[B]\f[CB]-L\f[B]\f[R] \f[I]SCRIPT\f[R], \f[B]\f[CB]--lua-filter=\f[B]\f[R]\f[I]SCRIPT\f[R]
633Transform the document in a similar fashion as JSON filters (see
619Transform the document in a similar fashion as JSON filters (see
634−\f[C]--filter\f[R]), but use pandoc\[cq]s built-in Lua filtering system.
620+\f[C]--filter\f[R]), but use pandoc\[aq]s build-in Lua filtering system.
635The given Lua script is expected to return a list of Lua filters which
621The given Lua script is expected to return a list of Lua filters which
636will be applied in order.
622will be applied in order.
637Each Lua filter must contain element-transforming functions indexed by
623Each Lua filter must contain element-transforming functions indexed by
@@ -641,19 +627,31 @@ applied.
641.PP
627.PP
642The \f[C]pandoc\f[R] Lua module provides helper functions for element
628The \f[C]pandoc\f[R] Lua module provides helper functions for element
643creation.
629creation.
644−It is always loaded into the script\[cq]s Lua environment.
630+It is always loaded into the script\[aq]s Lua environment.
645.PP
631.PP
646−See the Lua filters documentation for further details.
632+The following is an example Lua script for macro-expansion:
633+.IP
634+.nf
635+\f[C]
636+function expand_hello_world(inline)
637+ if inline.c == \[aq]{{helloworld}}\[aq] then
638+ return pandoc.Emph{ pandoc.Str \[dq]Hello, World\[dq] }
639+ else
640+ return inline
641+ end
642+end
643+
644+return {{Str = expand_hello_world}}
645+\f[R]
646+.fi
647.PP
647.PP
648In order of preference, pandoc will look for Lua filters in
648In order of preference, pandoc will look for Lua filters in
649.IP "1." 3
649.IP "1." 3
650−a specified full or relative path
650+a specified full or relative path (executable or non-executable)
651.IP "2." 3
651.IP "2." 3
652−\f[C]$DATADIR/filters\f[R] where \f[C]$DATADIR\f[R] is the user data
652+\f[C]$DATADIR/filters\f[R] (executable or non-executable) where
653−directory (see \f[C]--data-dir\f[R], above).
653+\f[C]$DATADIR\f[R] is the user data directory (see \f[C]--data-dir\f[R],
654−.PP
654+above).
655−Filters, Lua filters, and citeproc processing are applied in the order
656−specified on the command line.
657.RE
655.RE
658.TP
656.TP
659\f[B]\f[CB]-M\f[B]\f[R] \f[I]KEY\f[R][\f[B]\f[CB]=\f[B]\f[R]\f[I]VAL\f[R]], \f[B]\f[CB]--metadata=\f[B]\f[R]\f[I]KEY\f[R][\f[B]\f[CB]:\f[B]\f[R]\f[I]VAL\f[R]]
657\f[B]\f[CB]-M\f[B]\f[R] \f[I]KEY\f[R][\f[B]\f[CB]=\f[B]\f[R]\f[I]VAL\f[R]], \f[B]\f[CB]--metadata=\f[B]\f[R]\f[I]KEY\f[R][\f[B]\f[CB]:\f[B]\f[R]\f[I]VAL\f[R]]
@@ -693,13 +691,13 @@ Specify the number of spaces per tab (default is 4).
693.TP
691.TP
694\f[B]\f[CB]--track-changes=accept\f[B]\f[R]|\f[B]\f[CB]reject\f[B]\f[R]|\f[B]\f[CB]all\f[B]\f[R]
692\f[B]\f[CB]--track-changes=accept\f[B]\f[R]|\f[B]\f[CB]reject\f[B]\f[R]|\f[B]\f[CB]all\f[B]\f[R]
695Specifies what to do with insertions, deletions, and comments produced
693Specifies what to do with insertions, deletions, and comments produced
696−by the MS Word \[lq]Track Changes\[rq] feature.
694+by the MS Word \[dq]Track Changes\[dq] feature.
697−\f[C]accept\f[R] (the default) processes all the insertions and
695+\f[C]accept\f[R] (the default), inserts all insertions, and ignores all
698deletions.
696deletions.
699−\f[C]reject\f[R] ignores them.
697+\f[C]reject\f[R] inserts all deletions and ignores insertions.
700Both \f[C]accept\f[R] and \f[C]reject\f[R] ignore comments.
698Both \f[C]accept\f[R] and \f[C]reject\f[R] ignore comments.
701−\f[C]all\f[R] includes all insertions, deletions, and comments, wrapped
699+\f[C]all\f[R] puts in insertions, deletions, and comments, wrapped in
702−in spans with \f[C]insertion\f[R], \f[C]deletion\f[R],
700+spans with \f[C]insertion\f[R], \f[C]deletion\f[R],
703\f[C]comment-start\f[R], and \f[C]comment-end\f[R] classes,
701\f[C]comment-start\f[R], and \f[C]comment-end\f[R] classes,
704respectively.
702respectively.
705The author and time of change is included.
703The author and time of change is included.
@@ -716,11 +714,11 @@ Extract images and other media contained in or linked from the source
716document to the path \f[I]DIR\f[R], creating it if necessary, and adjust
714document to the path \f[I]DIR\f[R], creating it if necessary, and adjust
717the images references in the document so they point to the extracted
715the images references in the document so they point to the extracted
718files.
716files.
719−Media are downloaded, read from the file system, or extracted from a
720−binary container (e.g.\ docx), as needed.
717+If the source format is a binary container (docx, epub, or odt), the
721−The original file paths are used if they are relative paths not
718+media is extracted from the container and the original filenames are
722−containing \f[C]..\f[R].
719+used.
720+Otherwise the media is read from the file system or downloaded, and new
723−Otherwise filenames are constructed from the SHA1 hash of the contents.
721+filenames are constructed based on SHA1 hashes of the contents.
724.TP
722.TP
725\f[B]\f[CB]--abbreviations=\f[B]\f[R]\f[I]FILE\f[R]
723\f[B]\f[CB]--abbreviations=\f[B]\f[R]\f[I]FILE\f[R]
726Specifies a custom abbreviations file, with abbreviations one to a line.
724Specifies a custom abbreviations file, with abbreviations one to a line.
@@ -730,14 +728,14 @@ system default.
730To see the system default, use
728To see the system default, use
731\f[C]pandoc --print-default-data-file=abbreviations\f[R].
729\f[C]pandoc --print-default-data-file=abbreviations\f[R].
732The only use pandoc makes of this list is in the Markdown reader.
730The only use pandoc makes of this list is in the Markdown reader.
733−Strings found in this list will be followed by a nonbreaking space, and
731+Strings ending in a period that are found in this list will be followed
732+by a nonbreaking space, so that the period will not produce
734−the period will not produce sentence-ending space in formats like LaTeX.
733+sentence-ending space in formats like LaTeX.
735−The strings may not contain spaces.
736.SS General writer options
734.SS General writer options
737.TP
735.TP
738\f[B]\f[CB]-s\f[B]\f[R], \f[B]\f[CB]--standalone\f[B]\f[R]
736\f[B]\f[CB]-s\f[B]\f[R], \f[B]\f[CB]--standalone\f[B]\f[R]
739−Produce output with an appropriate header and footer (e.g.\ a standalone
737+Produce output with an appropriate header and footer (e.g.
740−HTML, LaTeX, TEI, or RTF file, not a fragment).
738+a standalone HTML, LaTeX, TEI, or RTF file, not a fragment).
741This option is set automatically for \f[C]pdf\f[R], \f[C]epub\f[R],
739This option is set automatically for \f[C]pdf\f[R], \f[C]epub\f[R],
742\f[C]epub3\f[R], \f[C]fb2\f[R], \f[C]docx\f[R], and \f[C]odt\f[R]
740\f[C]epub3\f[R], \f[C]fb2\f[R], \f[C]docx\f[R], and \f[C]odt\f[R]
743output.
741output.
@@ -897,7 +895,8 @@ Implies \f[C]--standalone\f[R].
897.TP
895.TP
898\f[B]\f[CB]-B\f[B]\f[R] \f[I]FILE\f[R], \f[B]\f[CB]--include-before-body=\f[B]\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
896\f[B]\f[CB]-B\f[B]\f[R] \f[I]FILE\f[R], \f[B]\f[CB]--include-before-body=\f[B]\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
899Include contents of \f[I]FILE\f[R], verbatim, at the beginning of the
897Include contents of \f[I]FILE\f[R], verbatim, at the beginning of the
898+document body (e.g.
900−document body (e.g.\ after the \f[C]<body>\f[R] tag in HTML, or the
899+after the \f[C]<body>\f[R] tag in HTML, or the
901\f[C]\[rs]begin{document}\f[R] command in LaTeX).
900\f[C]\[rs]begin{document}\f[R] command in LaTeX).
902This can be used to include navigation bars or banners in HTML
901This can be used to include navigation bars or banners in HTML
903documents.
902documents.
@@ -923,23 +922,20 @@ Note that, if \f[C]--resource-path\f[R] is specified, the working
923directory must be explicitly listed or it will not be searched.
922directory must be explicitly listed or it will not be searched.
924For example: \f[C]--resource-path=.:test\f[R] will search the working
923For example: \f[C]--resource-path=.:test\f[R] will search the working
925directory and the \f[C]test\f[R] subdirectory, in that order.
924directory and the \f[C]test\f[R] subdirectory, in that order.
926−This option can be used repeatedly.
925+.RS
927−Search path components that come later on the command line will be
926+.PP
928−searched before those that come earlier, so
927+\f[C]--resource-path\f[R] only has an effect if (a) the output format
929−\f[C]--resource-path foo:bar --resource-path baz:bim\f[R] is equivalent
928+embeds images (for example, \f[C]docx\f[R], \f[C]pdf\f[R], or
930−to \f[C]--resource-path baz:bim:foo:bar\f[R].
929+\f[C]html\f[R] with \f[C]--self-contained\f[R]) or (b) it is used
930+together with \f[C]--extract-media\f[R].
931+.RE
931.TP
932.TP
932\f[B]\f[CB]--request-header=\f[B]\f[R]\f[I]NAME\f[R]\f[B]\f[CB]:\f[B]\f[R]\f[I]VAL\f[R]
933\f[B]\f[CB]--request-header=\f[B]\f[R]\f[I]NAME\f[R]\f[B]\f[CB]:\f[B]\f[R]\f[I]VAL\f[R]
933Set the request header \f[I]NAME\f[R] to the value \f[I]VAL\f[R] when
934Set the request header \f[I]NAME\f[R] to the value \f[I]VAL\f[R] when
934making HTTP requests (for example, when a URL is given on the command
935making HTTP requests (for example, when a URL is given on the command
935line, or when resources used in a document must be downloaded).
936line, or when resources used in a document must be downloaded).
936−If you\[cq]re behind a proxy, you also need to set the environment
937+If you\[aq]re behind a proxy, you also need to set the environment
937variable \f[C]http_proxy\f[R] to \f[C]http://...\f[R].
938variable \f[C]http_proxy\f[R] to \f[C]http://...\f[R].
938−.TP
939−\f[B]\f[CB]--no-check-certificate\f[B]\f[R]
940−Disable the certificate verification to allow access to unsecure HTTP
941−resources (for example when the certificate is no longer valid or self
942−signed).
943.SS Options affecting specific writers
939.SS Options affecting specific writers
944.TP
940.TP
945\f[B]\f[CB]--self-contained\f[B]\f[R]
941\f[B]\f[CB]--self-contained\f[B]\f[R]
@@ -947,7 +943,7 @@ Produce a standalone HTML file with no external dependencies, using
947\f[C]data:\f[R] URIs to incorporate the contents of linked scripts,
943\f[C]data:\f[R] URIs to incorporate the contents of linked scripts,
948stylesheets, images, and videos.
944stylesheets, images, and videos.
949Implies \f[C]--standalone\f[R].
945Implies \f[C]--standalone\f[R].
950−The resulting file should be \[lq]self-contained,\[rq] in the sense that
946+The resulting file should be \[dq]self-contained,\[dq] in the sense that
951it needs no external files and no net access to be displayed properly by
947it needs no external files and no net access to be displayed properly by
952a browser.
948a browser.
953This option works only with HTML output formats, including
949This option works only with HTML output formats, including
@@ -963,14 +959,12 @@ left alone; the documents they link to will not be incorporated in the
963document.
959document.
964Limitation: resources that are loaded dynamically through JavaScript
960Limitation: resources that are loaded dynamically through JavaScript
965cannot be incorporated; as a result, \f[C]--self-contained\f[R] does not
961cannot be incorporated; as a result, \f[C]--self-contained\f[R] does not
966−work with \f[C]--mathjax\f[R], and some advanced features (e.g.\ zoom or
962+work with \f[C]--mathjax\f[R], and some advanced features (e.g.
967−speaker notes) may not work in an offline \[lq]self-contained\[rq]
963+zoom or speaker notes) may not work in an offline
968−\f[C]reveal.js\f[R] slide show.
964+\[dq]self-contained\[dq] \f[C]reveal.js\f[R] slide show.
969.TP
965.TP
970\f[B]\f[CB]--html-q-tags\f[B]\f[R]
966\f[B]\f[CB]--html-q-tags\f[B]\f[R]
971Use \f[C]<q>\f[R] tags for quotes in HTML.
967Use \f[C]<q>\f[R] tags for quotes in HTML.
972−(This option only has an effect if the \f[C]smart\f[R] extension is
973−enabled for the input format used.)
974.TP
968.TP
975\f[B]\f[CB]--ascii\f[B]\f[R]
969\f[B]\f[CB]--ascii\f[B]\f[R]
976Use only ASCII characters in output.
970Use only ASCII characters in output.
@@ -988,24 +982,21 @@ By default inline links are used.
988The placement of link references is affected by the
982The placement of link references is affected by the
989\f[C]--reference-location\f[R] option.
983\f[C]--reference-location\f[R] option.
990.TP
984.TP
991−\f[B]\f[CB]--reference-location=block\f[B]\f[R]|\f[B]\f[CB]section\f[B]\f[R]|\f[B]\f[CB]document\f[B]\f[R]
985+\f[B]\f[CB]--reference-location = block\f[B]\f[R]|\f[B]\f[CB]section\f[B]\f[R]|\f[B]\f[CB]document\f[B]\f[R]
992Specify whether footnotes (and references, if \f[C]reference-links\f[R]
986Specify whether footnotes (and references, if \f[C]reference-links\f[R]
993is set) are placed at the end of the current (top-level) block, the
987is set) are placed at the end of the current (top-level) block, the
994current section, or the document.
988current section, or the document.
995The default is \f[C]document\f[R].
989The default is \f[C]document\f[R].
996Currently only affects the markdown writer.
990Currently only affects the markdown writer.
997.TP
991.TP
998−\f[B]\f[CB]--markdown-headings=setext\f[B]\f[R]|\f[B]\f[CB]atx\f[B]\f[R]
999−Specify whether to use ATX-style (\f[C]#\f[R]-prefixed) or Setext-style
1000−(underlined) headings for level 1 and 2 headings in Markdown output.
1001−(The default is \f[C]atx\f[R].) ATX-style headings are always used for
1002−levels 3+.
1003−This option also affects Markdown cells in \f[C]ipynb\f[R] output.
1004−.TP
1005\f[B]\f[CB]--atx-headers\f[B]\f[R]
992\f[B]\f[CB]--atx-headers\f[B]\f[R]
1006−\f[I]Deprecated synonym for \f[CI]--markdown-headings=atx\f[I].\f[R]
993+Use ATX-style headings in Markdown output.
994+The default is to use setext-style headings for levels 1 to 2, and then
995+ATX headings.
996+(Note: for \f[C]gfm\f[R] output, ATX headings are always used.) This
997+option also affects markdown cells in \f[C]ipynb\f[R] output.
1007.TP
998.TP
1008−\f[B]\f[CB]--top-level-division=default\f[B]\f[R]|\f[B]\f[CB]section\f[B]\f[R]|\f[B]\f[CB]chapter\f[B]\f[R]|\f[B]\f[CB]part\f[B]\f[R]
999+\f[B]\f[CB]--top-level-division=[default|section|chapter|part]\f[B]\f[R]
1009Treat top-level headings as the given division type in LaTeX, ConTeXt,
1000Treat top-level headings as the given division type in LaTeX, ConTeXt,
1010DocBook, and TEI output.
1001DocBook, and TEI output.
1011The hierarchy order is part, chapter, then section; all headings are
1002The hierarchy order is part, chapter, then section; all headings are
@@ -1022,22 +1013,21 @@ become \f[C]\[rs]part{..}\f[R], while second-level headings remain as
1022their default type.
1013their default type.
1023.TP
1014.TP
1024\f[B]\f[CB]-N\f[B]\f[R], \f[B]\f[CB]--number-sections\f[B]\f[R]
1015\f[B]\f[CB]-N\f[B]\f[R], \f[B]\f[CB]--number-sections\f[B]\f[R]
1025−Number section headings in LaTeX, ConTeXt, HTML, Docx, ms, or EPUB
1016+Number section headings in LaTeX, ConTeXt, HTML, or EPUB output.
1026−output.
1027By default, sections are not numbered.
1017By default, sections are not numbered.
1028Sections with class \f[C]unnumbered\f[R] will never be numbered, even if
1018Sections with class \f[C]unnumbered\f[R] will never be numbered, even if
1029\f[C]--number-sections\f[R] is specified.
1019\f[C]--number-sections\f[R] is specified.
1030.TP
1020.TP
1031−\f[B]\f[CB]--number-offset=\f[B]\f[R]\f[I]NUMBER\f[R][\f[B]\f[CB],\f[B]\f[R]\f[I]NUMBER\f[R]\f[B]\f[CB],\f[B]\f[R]\f[I]\&...\f[R]]
1021+\f[B]\f[CB]--number-offset=\f[B]\f[R]\f[I]NUMBER\f[R][\f[B]\f[CB],\f[B]\f[R]\f[I]NUMBER\f[R]\f[B]\f[CB],\f[B]\f[R]\f[I]...\f[R]]
1032Offset for section headings in HTML output (ignored in other output
1022Offset for section headings in HTML output (ignored in other output
1033formats).
1023formats).
1034The first number is added to the section number for top-level headings,
1024The first number is added to the section number for top-level headings,
1035the second for second-level headings, and so on.
1025the second for second-level headings, and so on.
1036So, for example, if you want the first top-level heading in your
1026So, for example, if you want the first top-level heading in your
1037−document to be numbered \[lq]6\[rq], specify
1027+document to be numbered \[dq]6\[dq], specify
1038\f[C]--number-offset=5\f[R].
1028\f[C]--number-offset=5\f[R].
1039If your document starts with a level-2 heading which you want to be
1029If your document starts with a level-2 heading which you want to be
1040−numbered \[lq]1.5\[rq], specify \f[C]--number-offset=1,4\f[R].
1030+numbered \[dq]1.5\[dq], specify \f[C]--number-offset=1,4\f[R].
1041Offsets are 0 by default.
1031Offsets are 0 by default.
1042Implies \f[C]--number-sections\f[R].
1032Implies \f[C]--number-sections\f[R].
1043.TP
1033.TP
@@ -1202,8 +1192,6 @@ Verbatim Char
1202Footnote Reference
1192Footnote Reference
1203.IP \[bu] 2
1193.IP \[bu] 2
1204Hyperlink
1194Hyperlink
1205−.IP \[bu] 2
1206−Section Number
1207.PP
1195.PP
1208Table style:
1196Table style:
1209.IP \[bu] 2
1197.IP \[bu] 2
@@ -1336,7 +1324,7 @@ body { font-family: \[dq]DejaVuSans\[dq]; }
1336.TP
1324.TP
1337\f[B]\f[CB]--epub-chapter-level=\f[B]\f[R]\f[I]NUMBER\f[R]
1325\f[B]\f[CB]--epub-chapter-level=\f[B]\f[R]\f[I]NUMBER\f[R]
1338Specify the heading level at which to split the EPUB into separate
1326Specify the heading level at which to split the EPUB into separate
1339−\[lq]chapter\[rq] files.
1327+\[dq]chapter\[dq] files.
1340The default is to split into chapters at level-1 headings.
1328The default is to split into chapters at level-1 headings.
1341This option only affects the internal composition of the EPUB, not the
1329This option only affects the internal composition of the EPUB, not the
1342way chapters and sections are displayed to users.
1330way chapters and sections are displayed to users.
@@ -1378,8 +1366,7 @@ depending on the output format specified using \f[C]-t/--to\f[R]:
1378\f[C]-t context\f[R]: \f[C]context\f[R]
1366\f[C]-t context\f[R]: \f[C]context\f[R]
1379.IP \[bu] 2
1367.IP \[bu] 2
1380\f[C]-t html\f[R]: \f[C]wkhtmltopdf\f[R] (other options:
1368\f[C]-t html\f[R]: \f[C]wkhtmltopdf\f[R] (other options:
1381−\f[C]prince\f[R], \f[C]weasyprint\f[R]; see print-css.rocks for a good
1369+\f[C]prince\f[R], \f[C]weasyprint\f[R])
1382−introduction to PDF generation from HTML/CSS.)
1383.IP \[bu] 2
1370.IP \[bu] 2
1384\f[C]-t ms\f[R]: \f[C]pdfroff\f[R]
1371\f[C]-t ms\f[R]: \f[C]pdfroff\f[R]
1385.RE
1372.RE
@@ -1388,69 +1375,47 @@ introduction to PDF generation from HTML/CSS.)
1388Use the given string as a command-line argument to the
1375Use the given string as a command-line argument to the
1389\f[C]pdf-engine\f[R].
1376\f[C]pdf-engine\f[R].
1390For example, to use a persistent directory \f[C]foo\f[R] for
1377For example, to use a persistent directory \f[C]foo\f[R] for
1391−\f[C]latexmk\f[R]\[cq]s auxiliary files, use
1378+\f[C]latexmk\f[R]\[aq]s auxiliary files, use
1392\f[C]--pdf-engine-opt=-outdir=foo\f[R].
1379\f[C]--pdf-engine-opt=-outdir=foo\f[R].
1393Note that no check for duplicate options is done.
1380Note that no check for duplicate options is done.
1394.SS Citation rendering
1381.SS Citation rendering
1395.TP
1382.TP
1396−\f[B]\f[CB]-C\f[B]\f[R], \f[B]\f[CB]--citeproc\f[B]\f[R]
1397−Process the citations in the file, replacing them with rendered
1398−citations and adding a bibliography.
1399−Citation processing will not take place unless bibliographic data is
1400−supplied, either through an external file specified using the
1401−\f[C]--bibliography\f[R] option or the \f[C]bibliography\f[R] field in
1402−metadata, or via a \f[C]references\f[R] section in metadata containing a
1403−list of citations in CSL YAML format with Markdown formatting.
1404−The style is controlled by a CSL stylesheet specified using the
1405−\f[C]--csl\f[R] option or the \f[C]csl\f[R] field in metadata.
1406−(If no stylesheet is specified, the \f[C]chicago-author-date\f[R] style
1407−will be used by default.) The citation processing transformation may be
1408−applied before or after filters or Lua filters (see \f[C]--filter\f[R],
1409−\f[C]--lua-filter\f[R]): these transformations are applied in the order
1410−they appear on the command line.
1411−For more information, see the section on Citations.
1412−.TP
1413\f[B]\f[CB]--bibliography=\f[B]\f[R]\f[I]FILE\f[R]
1383\f[B]\f[CB]--bibliography=\f[B]\f[R]\f[I]FILE\f[R]
1414−Set the \f[C]bibliography\f[R] field in the document\[cq]s metadata to
1384+Set the \f[C]bibliography\f[R] field in the document\[aq]s metadata to
1415−\f[I]FILE\f[R], overriding any value set in the metadata.
1385+\f[I]FILE\f[R], overriding any value set in the metadata, and process
1386+citations using \f[C]pandoc-citeproc\f[R].
1387+(This is equivalent to
1388+\f[C]--metadata bibliography=FILE --filter pandoc-citeproc\f[R].) If
1389+\f[C]--natbib\f[R] or \f[C]--biblatex\f[R] is also supplied,
1390+\f[C]pandoc-citeproc\f[R] is not used, making this equivalent to
1391+\f[C]--metadata bibliography=FILE\f[R].
1416If you supply this argument multiple times, each \f[I]FILE\f[R] will be
1392If you supply this argument multiple times, each \f[I]FILE\f[R] will be
1417added to bibliography.
1393added to bibliography.
1418−If \f[I]FILE\f[R] is a URL, it will be fetched via HTTP.
1419−If \f[I]FILE\f[R] is not found relative to the working directory, it
1420−will be sought in the resource path (see \f[C]--resource-path\f[R]).
1421.TP
1394.TP
1422\f[B]\f[CB]--csl=\f[B]\f[R]\f[I]FILE\f[R]
1395\f[B]\f[CB]--csl=\f[B]\f[R]\f[I]FILE\f[R]
1423−Set the \f[C]csl\f[R] field in the document\[cq]s metadata to
1396+Set the \f[C]csl\f[R] field in the document\[aq]s metadata to
1424\f[I]FILE\f[R], overriding any value set in the metadata.
1397\f[I]FILE\f[R], overriding any value set in the metadata.
1425−(This is equivalent to \f[C]--metadata csl=FILE\f[R].) If \f[I]FILE\f[R]
1398+(This is equivalent to \f[C]--metadata csl=FILE\f[R].) This option is
1426−is a URL, it will be fetched via HTTP.
1399+only relevant with \f[C]pandoc-citeproc\f[R].
1427−If \f[I]FILE\f[R] is not found relative to the working directory, it
1428−will be sought in the resource path (see \f[C]--resource-path\f[R]) and
1429−finally in the \f[C]csl\f[R] subdirectory of the pandoc user data
1430−directory.
1431.TP
1400.TP
1432\f[B]\f[CB]--citation-abbreviations=\f[B]\f[R]\f[I]FILE\f[R]
1401\f[B]\f[CB]--citation-abbreviations=\f[B]\f[R]\f[I]FILE\f[R]
1433−Set the \f[C]citation-abbreviations\f[R] field in the document\[cq]s
1402+Set the \f[C]citation-abbreviations\f[R] field in the document\[aq]s
1434metadata to \f[I]FILE\f[R], overriding any value set in the metadata.
1403metadata to \f[I]FILE\f[R], overriding any value set in the metadata.
1435(This is equivalent to
1404(This is equivalent to
1436−\f[C]--metadata citation-abbreviations=FILE\f[R].) If \f[I]FILE\f[R] is
1405+\f[C]--metadata citation-abbreviations=FILE\f[R].) This option is only
1437−a URL, it will be fetched via HTTP.
1406+relevant with \f[C]pandoc-citeproc\f[R].
1438−If \f[I]FILE\f[R] is not found relative to the working directory, it
1439−will be sought in the resource path (see \f[C]--resource-path\f[R]) and
1440−finally in the \f[C]csl\f[R] subdirectory of the pandoc user data
1441−directory.
1442.TP
1407.TP
1443\f[B]\f[CB]--natbib\f[B]\f[R]
1408\f[B]\f[CB]--natbib\f[B]\f[R]
1444Use \f[C]natbib\f[R] for citations in LaTeX output.
1409Use \f[C]natbib\f[R] for citations in LaTeX output.
1445−This option is not for use with the \f[C]--citeproc\f[R] option or with
1410+This option is not for use with the \f[C]pandoc-citeproc\f[R] filter or
1446−PDF output.
1411+with PDF output.
1447It is intended for use in producing a LaTeX file that can be processed
1412It is intended for use in producing a LaTeX file that can be processed
1448with \f[C]bibtex\f[R].
1413with \f[C]bibtex\f[R].
1449.TP
1414.TP
1450\f[B]\f[CB]--biblatex\f[B]\f[R]
1415\f[B]\f[CB]--biblatex\f[B]\f[R]
1451Use \f[C]biblatex\f[R] for citations in LaTeX output.
1416Use \f[C]biblatex\f[R] for citations in LaTeX output.
1452−This option is not for use with the \f[C]--citeproc\f[R] option or with
1417+This option is not for use with the \f[C]pandoc-citeproc\f[R] filter or
1453−PDF output.
1418+with PDF output.
1454It is intended for use in producing a LaTeX file that can be processed
1419It is intended for use in producing a LaTeX file that can be processed
1455with \f[C]bibtex\f[R] or \f[C]biber\f[R].
1420with \f[C]bibtex\f[R] or \f[C]biber\f[R].
1456.SS Math rendering in HTML
1421.SS Math rendering in HTML
@@ -1491,7 +1456,7 @@ For SVG images you can for example use
1491If no URL is specified, the CodeCogs URL generating PNGs will be used
1456If no URL is specified, the CodeCogs URL generating PNGs will be used
1492(\f[C]https://latex.codecogs.com/png.latex?\f[R]).
1457(\f[C]https://latex.codecogs.com/png.latex?\f[R]).
1493Note: the \f[C]--webtex\f[R] option will affect Markdown output as well
1458Note: the \f[C]--webtex\f[R] option will affect Markdown output as well
1494−as HTML, which is useful if you\[cq]re targeting a version of Markdown
1459+as HTML, which is useful if you\[aq]re targeting a version of Markdown
1495without native math support.
1460without native math support.
1496.TP
1461.TP
1497\f[B]\f[CB]--katex\f[B]\f[R][\f[B]\f[CB]=\f[B]\f[R]\f[I]URL\f[R]]
1462\f[B]\f[CB]--katex\f[B]\f[R][\f[B]\f[CB]=\f[B]\f[R]\f[I]URL\f[R]]
@@ -1504,16 +1469,16 @@ inserted.
1504.TP
1469.TP
1505\f[B]\f[CB]--gladtex\f[B]\f[R]
1470\f[B]\f[CB]--gladtex\f[B]\f[R]
1506Enclose TeX math in \f[C]<eq>\f[R] tags in HTML output.
1471Enclose TeX math in \f[C]<eq>\f[R] tags in HTML output.
1507−The resulting HTML can then be processed by GladTeX to produce SVG
1472+The resulting HTML can then be processed by GladTeX to produce images of
1508−images of the typeset formulas and an HTML file with these images
1473+the typeset formulas and an HTML file with links to these images.
1509−embedded.
1474+So, the procedure is:
1510.RS
1475.RS
1511.IP
1476.IP
1512.nf
1477.nf
1513\f[C]
1478\f[C]
1514pandoc -s --gladtex input.md -o myfile.htex
1479pandoc -s --gladtex input.md -o myfile.htex
1515−gladtex -d image_dir myfile.htex
1480+gladtex -d myfile-images myfile.htex
1516−# produces myfile.html and images in image_dir
1481+# produces myfile.html and images in myfile-images
1517\f[R]
1482\f[R]
1518.fi
1483.fi
1519.RE
1484.RE
@@ -1602,11 +1567,6 @@ T}@T{
1602PandocUnsupportedExtensionError
1567PandocUnsupportedExtensionError
1603T}
1568T}
1604T{
1569T{
1605−24
1606−T}@T{
1607−PandocCiteprocError
1608−T}
1609−T{
161031
157031
1611T}@T{
1571T}@T{
1612PandocEpubSubdirectoryError
1572PandocEpubSubdirectoryError
@@ -1617,11 +1577,6 @@ T}@T{
1617PandocPDFError
1577PandocPDFError
1618T}
1578T}
1619T{
1579T{
1620−44
1621−T}@T{
1622−PandocXMLError
1623−T}
1624−T{
162547
158047
1626T}@T{
1581T}@T{
1627PandocPDFProgramNotFoundError
1582PandocPDFProgramNotFoundError
@@ -1682,11 +1637,6 @@ T}@T{
1682PandocIpynbDecodingError
1637PandocIpynbDecodingError
1683T}
1638T}
1684T{
1639T{
1685−94
1686−T}@T{
1687−PandocUnsupportedCharsetError
1688−T}
1689−T{
169097
164097
1691T}@T{
1641T}@T{
1692PandocCouldNotFindDataFileError
1642PandocCouldNotFindDataFileError
@@ -1719,16 +1669,6 @@ input-files:
1719- content.md
1669- content.md
1720# or you may use input-file: with a single value
1670# or you may use input-file: with a single value
1721
1671
1722−# Include options from the specified defaults files.
1723−# The files will be searched for first in the working directory
1724−# and then in the defaults subdirectory of the user data directory.
1725−# The files are included in the same order in which they appear in
1726−# the list. Options specified in this defaults file always have
1727−# priority over the included ones.
1728−defaults:
1729−- defsA
1730−- defsB
1731−
1732template: letter
1672template: letter
1733standalone: true
1673standalone: true
1734self-contained: false
1674self-contained: false
@@ -1756,24 +1696,11 @@ include-after-body: []
1756include-in-header: []
1696include-in-header: []
1757resource-path: [\[dq].\[dq]]
1697resource-path: [\[dq].\[dq]]
1758
1698
1759−# turn on built-in citation processing. Note that if you need
1760−# control over when the citeproc processing is done relative
1761−# to other filters, you should instead use \[ga]citeproc\[ga] in the
1762−# list of \[ga]filters\[ga] (see below).
1763−citeproc: true
1764−csl: ieee
1765−bibliography:
1766−- foobar.bib
1767−- barbaz.json
1768−citation-abbreviations: abbrevs.json
1769−
1770−# Filters will be assumed to be Lua filters if they have
1699+# filters will be assumed to be Lua filters if they have
1771# the .lua extension, and json filters otherwise. But
1700# the .lua extension, and json filters otherwise. But
1772−# the filter type can also be specified explicitly, as shown.
1701+# the filter type can also be specified explicitly, as shown:
1773−# Filters are run in the order specified.
1774−# To include the built-in citeproc filter, use either \[ga]citeproc\[ga]
1775−# or \[ga]{type: citeproc}\[ga].
1776filters:
1702filters:
1703+- pandoc-citeproc
1777- wordcount.lua
1704- wordcount.lua
1778- type: json
1705- type: json
1779 path: foo.lua
1706 path: foo.lua
@@ -1786,11 +1713,8 @@ data-dir:
1786verbosity: INFO
1713verbosity: INFO
1787log-file: log.json
1714log-file: log.json
1788
1715
1789−# citeproc, natbib, or biblatex. This only affects LaTeX
1716+# citeproc, natbib, or biblatex
1790−# output. If you want to use citeproc to format citations,
1791−# you should also set \[aq]citeproc: true\[aq] (see above).
1792cite-method: citeproc
1717cite-method: citeproc
1793−
1794# part, chapter, section, or default:
1718# part, chapter, section, or default:
1795top-level-division: chapter
1719top-level-division: chapter
1796abbreviations:
1720abbreviations:
@@ -1859,7 +1783,7 @@ epub-cover-image: cover.jpg
1859reference-links: true
1783reference-links: true
1860# block, section, or document
1784# block, section, or document
1861reference-location: block
1785reference-location: block
1862−markdown-headings: setext
1786+atx-headers: false
1863
1787
1864# accept, reject, or all
1788# accept, reject, or all
1865track-changes: accept
1789track-changes: accept
@@ -1891,38 +1815,6 @@ verbosity: INFO
1891\f[R]
1815\f[R]
1892.fi
1816.fi
1893.PP
1817.PP
1894−In fields that expect a file path (or list of file paths), the following
1895−syntax may be used to interpolate environment variables:
1896−.IP
1897−.nf
1898−\f[C]
1899−csl: ${HOME}/mycsldir/special.csl
1900−\f[R]
1901−.fi
1902−.PP
1903−\f[C]${USERDATA}\f[R] may also be used; this will always resolve to the
1904−user data directory that is current when the defaults file is parsed,
1905−regardless of the setting of the environment variable
1906−\f[C]USERDATA\f[R].
1907−.PP
1908−\f[C]${.}\f[R] will resolve to the directory containing the default file
1909−itself.
1910−This allows you to refer to resources contained in that directory:
1911−.IP
1912−.nf
1913−\f[C]
1914−epub-cover-image: ${.}/cover.jpg
1915−epub-metadata: ${.}/meta.xml
1916−resource-path:
1917−- . # the working directory from which pandoc is run
1918−- ${.}/images # the images subdirectory of the directory
1919− # containing this defaults file
1920−\f[R]
1921−.fi
1922−.PP
1923−This environment variable interpolation syntax \f[I]only\f[R] works in
1924−fields that expect file paths.
1925−.PP
1926Default files can be placed in the \f[C]defaults\f[R] subdirectory of
1818Default files can be placed in the \f[C]defaults\f[R] subdirectory of
1927the user data directory and used from any directory.
1819the user data directory and used from any directory.
1928For example, one could create a file specifying defaults for writing
1820For example, one could create a file specifying defaults for writing
@@ -1979,10 +1871,10 @@ arbitrary information at any point in the file.
1979They may be set at the command line using the \f[C]-V/--variable\f[R]
1871They may be set at the command line using the \f[C]-V/--variable\f[R]
1980option.
1872option.
1981If a variable is not set, pandoc will look for the key in the
1873If a variable is not set, pandoc will look for the key in the
1982−document\[cq]s metadata, which can be set using either YAML metadata
1874+document\[aq]s metadata, which can be set using either YAML metadata
1983blocks or with the \f[C]-M/--metadata\f[R] option.
1875blocks or with the \f[C]-M/--metadata\f[R] option.
1984In addition, some variables are given default values by pandoc.
1876In addition, some variables are given default values by pandoc.
1985−See Variables below for a list of variables used in pandoc\[cq]s default
1877+See Variables below for a list of variables used in pandoc\[aq]s default
1986templates.
1878templates.
1987.PP
1879.PP
1988If you use custom templates, you may need to revise them as pandoc
1880If you use custom templates, you may need to revise them as pandoc
@@ -1999,8 +1891,8 @@ be treated as a comment and omitted from the output.
1999.SS Delimiters
1891.SS Delimiters
2000.PP
1892.PP
2001To mark variables and control structures in the template, either
1893To mark variables and control structures in the template, either
2002−\f[C]$\f[R]\&...\f[C]$\f[R] or \f[C]${\f[R]\&...\f[C]}\f[R] may be used
1894+\f[C]$\f[R]...\f[C]$\f[R] or \f[C]${\f[R]...\f[C]}\f[R] may be used as
2003−as delimiters.
1895+delimiters.
2004The styles may also be mixed in the same template, but the opening and
1896The styles may also be mixed in the same template, but the opening and
2005closing delimiter must match in each case.
1897closing delimiter must match in each case.
2006The opening delimiter may be followed by one or more spaces or tabs,
1898The opening delimiter may be followed by one or more spaces or tabs,
@@ -2161,29 +2053,19 @@ ${ endfor }
2161.fi
2053.fi
2162.SS Partials
2054.SS Partials
2163.PP
2055.PP
2164−Partials (subtemplates stored in different files) may be included by
2056+Partials (subtemplates stored in different files) may be included using
2165−using the name of the partial, followed by \f[C]()\f[R], for example:
2057+the syntax
2166−.IP
2167−.nf
2168−\f[C]
2169−${ styles() }
2170−\f[R]
2171−.fi
2172−.PP
2173−Partials will be sought in the directory containing the main template.
2174−The file name will be assumed to have the same extension as the main
2175−template if it lacks an extension.
2176−When calling the partial, the full name including file extension can
2177−also be used:
2178.IP
2058.IP
2179.nf
2059.nf
2180\f[C]
2060\f[C]
2181−${ styles.html() }
2061+${ boilerplate() }
2182\f[R]
2062\f[R]
2183.fi
2063.fi
2184.PP
2064.PP
2185−(If a partial is not found in the directory of the template and the
2065+Partials will be sought in the directory containing the main template,
2186−template path is given as a relative path, it will also be sought in the
2066+and will be assumed to have the same extension as the main template if
2067+they lack an explicit extension.
2068+(If the partials are not found here, they will also be sought in the
2187\f[C]templates\f[R] subdirectory of the user data directory.)
2069\f[C]templates\f[R] subdirectory of the user data directory.)
2188.PP
2070.PP
2189Partials may optionally be applied to variables using a colon:
2071Partials may optionally be applied to variables using a colon:
@@ -2233,7 +2115,7 @@ an explicit \f[C]for\f[R] loop) cannot contain interpolated variables or
2233other template directives.
2115other template directives.
2234.SS Nesting
2116.SS Nesting
2235.PP
2117.PP
2236−To ensure that content is \[lq]nested,\[rq] that is, subsequent lines
2118+To ensure that content is \[dq]nested,\[dq] that is, subsequent lines
2237indented, use the \f[C]\[ha]\f[R] directive:
2119indented, use the \f[C]\[ha]\f[R] directive:
2238.IP
2120.IP
2239.nf
2121.nf
@@ -2275,7 +2157,7 @@ will produce
2275.PP
2157.PP
2276If a variable occurs by itself on a line, preceded by whitespace and not
2158If a variable occurs by itself on a line, preceded by whitespace and not
2277followed by further text or directives on the same line, and the
2159followed by further text or directives on the same line, and the
2278−variable\[cq]s value contains multiple lines, it will be nested
2160+variable\[aq]s value contains multiple lines, it will be nested
2279automatically.
2161automatically.
2280.SS Breakable spaces
2162.SS Breakable spaces
2281.PP
2163.PP
@@ -2350,18 +2232,6 @@ for a textual value, number of elements for a map or array.
2350\f[C]reverse\f[R]: Reverses a textual value or array, and has no effect
2232\f[C]reverse\f[R]: Reverses a textual value or array, and has no effect
2351on other values.
2233on other values.
2352.IP \[bu] 2
2234.IP \[bu] 2
2353−\f[C]first\f[R]: Returns the first value of an array, if applied to a
2354−non-empty array; otherwise returns the original value.
2355−.IP \[bu] 2
2356−\f[C]last\f[R]: Returns the last value of an array, if applied to a
2357−non-empty array; otherwise returns the original value.
2358−.IP \[bu] 2
2359−\f[C]rest\f[R]: Returns all but the first value of an array, if applied
2360−to a non-empty array; otherwise returns the original value.
2361−.IP \[bu] 2
2362−\f[C]allbutlast\f[R]: Returns all but the last value of an array, if
2363−applied to a non-empty array; otherwise returns the original value.
2364−.IP \[bu] 2
2365\f[C]chomp\f[R]: Removes trailing newlines (and breakable space).
2235\f[C]chomp\f[R]: Removes trailing newlines (and breakable space).
2366.IP \[bu] 2
2236.IP \[bu] 2
2367\f[C]nowrap\f[R]: Disables line wrapping on breakable spaces.
2237\f[C]nowrap\f[R]: Disables line wrapping on breakable spaces.
@@ -2417,8 +2287,7 @@ including a title block in the document itself, you can set the
2417\f[C]title-meta\f[R], \f[C]author-meta\f[R], and \f[C]date-meta\f[R]
2287\f[C]title-meta\f[R], \f[C]author-meta\f[R], and \f[C]date-meta\f[R]
2418variables.
2288variables.
2419(By default these are set automatically, based on \f[C]title\f[R],
2289(By default these are set automatically, based on \f[C]title\f[R],
2420−\f[C]author\f[R], and \f[C]date\f[R].) The page title in HTML is set by
2290+\f[C]author\f[R], and \f[C]date\f[R].)
2421−\f[C]pagetitle\f[R], which is equal to \f[C]title\f[R] by default.
2422.RE
2291.RE
2423.TP
2292.TP
2424\f[B]\f[CB]subtitle\f[B]\f[R]
2293\f[B]\f[CB]subtitle\f[B]\f[R]
@@ -2508,81 +2377,13 @@ For bidirectional documents, native pandoc \f[C]span\f[R]s and
2508\f[C]div\f[R]s with the \f[C]dir\f[R] attribute (value \f[C]rtl\f[R] or
2377\f[C]div\f[R]s with the \f[C]dir\f[R] attribute (value \f[C]rtl\f[R] or
2509\f[C]ltr\f[R]) can be used to override the base direction in some output
2378\f[C]ltr\f[R]) can be used to override the base direction in some output
2510formats.
2379formats.
2511−This may not always be necessary if the final renderer (e.g.\ the
2380+This may not always be necessary if the final renderer (e.g.
2512−browser, when generating HTML) supports the Unicode Bidirectional
2381+the browser, when generating HTML) supports the Unicode Bidirectional
2513Algorithm.
2382Algorithm.
2514.PP
2383.PP
2515When using LaTeX for bidirectional documents, only the \f[C]xelatex\f[R]
2384When using LaTeX for bidirectional documents, only the \f[C]xelatex\f[R]
2516engine is fully supported (use \f[C]--pdf-engine=xelatex\f[R]).
2385engine is fully supported (use \f[C]--pdf-engine=xelatex\f[R]).
2517.RE
2386.RE
2518−.SS Variables for HTML
2519−.TP
2520−\f[B]\f[CB]document-css\f[B]\f[R]
2521−Enables inclusion of most of the CSS in the \f[C]styles.html\f[R]
2522−partial (have a look with
2523−\f[C]pandoc --print-default-data-file=templates/styles.html\f[R]).
2524−Unless you use \f[C]--css\f[R], this variable is set to \f[C]true\f[R]
2525−by default.
2526−You can disable it with e.g.\ \f[C]pandoc -M document-css=false\f[R].
2527−.TP
2528−\f[B]\f[CB]mainfont\f[B]\f[R]
2529−sets the CSS \f[C]font-family\f[R] property on the \f[C]html\f[R]
2530−element.
2531−.TP
2532−\f[B]\f[CB]fontsize\f[B]\f[R]
2533−sets the base CSS \f[C]font-size\f[R], which you\[cq]d usually set to
2534−e.g.\ \f[C]20px\f[R], but it also accepts \f[C]pt\f[R] (12pt = 16px in
2535−most browsers).
2536−.TP
2537−\f[B]\f[CB]fontcolor\f[B]\f[R]
2538−sets the CSS \f[C]color\f[R] property on the \f[C]html\f[R] element.
2539−.TP
2540−\f[B]\f[CB]linkcolor\f[B]\f[R]
2541−sets the CSS \f[C]color\f[R] property on all links.
2542−.TP
2543−\f[B]\f[CB]monofont\f[B]\f[R]
2544−sets the CSS \f[C]font-family\f[R] property on \f[C]code\f[R] elements.
2545−.TP
2546−\f[B]\f[CB]monobackgroundcolor\f[B]\f[R]
2547−sets the CSS \f[C]background-color\f[R] property on \f[C]code\f[R]
2548−elements and adds extra padding.
2549−.TP
2550−\f[B]\f[CB]linestretch\f[B]\f[R]
2551−sets the CSS \f[C]line-height\f[R] property on the \f[C]html\f[R]
2552−element, which is preferred to be unitless.
2553−.TP
2554−\f[B]\f[CB]backgroundcolor\f[B]\f[R]
2555−sets the CSS \f[C]background-color\f[R] property on the \f[C]html\f[R]
2556−element.
2557−.TP
2558−\f[B]\f[CB]margin-left\f[B]\f[R], \f[B]\f[CB]margin-right\f[B]\f[R], \f[B]\f[CB]margin-top\f[B]\f[R], \f[B]\f[CB]margin-bottom\f[B]\f[R]
2559−sets the corresponding CSS \f[C]padding\f[R] properties on the
2560−\f[C]body\f[R] element.
2561−.PP
2562−To override or extend some CSS for just one document, include for
2563−example:
2564−.IP
2565−.nf
2566−\f[C]
2567−---
2568−header-includes: |
2569− <style>
2570− blockquote {
2571− font-style: italic;
2572− }
2573− tr.even {
2574− background-color: #f0f0f0;
2575− }
2576− td, th {
2577− padding: 0.5em 2em 0.5em 0.5em;
2578− }
2579− tbody {
2580− border-bottom: none;
2581− }
2582− </style>
2583−---
2584−\f[R]
2585−.fi
2586.SS Variables for HTML math
2387.SS Variables for HTML math
2587.TP
2388.TP
2588\f[B]\f[CB]classoption\f[B]\f[R]
2389\f[B]\f[CB]classoption\f[B]\f[R]
@@ -2590,14 +2391,14 @@ when using KaTeX, you can render display math equations flush left using
2590YAML metadata or with \f[C]-M classoption=fleqn\f[R].
2391YAML metadata or with \f[C]-M classoption=fleqn\f[R].
2591.SS Variables for HTML slides
2392.SS Variables for HTML slides
2592.PP
2393.PP
2593−These affect HTML output when [producing slide shows with pandoc].
2394+These affect HTML output when producing slide shows with pandoc.
2594−.TP
2395+.PP
2595−\f[B]\f[CB]institute\f[B]\f[R]
2396+All reveal.js configuration options are available as variables.
2596−author affiliations: can be a list when there are multiple authors
2397+To turn off boolean flags that default to true in reveal.js, use
2398+\f[C]0\f[R].
2597.TP
2399.TP
2598\f[B]\f[CB]revealjs-url\f[B]\f[R]
2400\f[B]\f[CB]revealjs-url\f[B]\f[R]
2599−base URL for reveal.js documents (defaults to
2401+base URL for reveal.js documents (defaults to \f[C]reveal.js\f[R])
2600−\f[C]https://unpkg.com/reveal.js\[at]\[ha]4/\f[R])
2601.TP
2402.TP
2602\f[B]\f[CB]s5-url\f[B]\f[R]
2403\f[B]\f[CB]s5-url\f[B]\f[R]
2603base URL for S5 documents (defaults to \f[C]s5/default\f[R])
2404base URL for S5 documents (defaults to \f[C]s5/default\f[R])
@@ -2612,10 +2413,6 @@ base URL for Slideous documents (defaults to \f[C]slideous\f[R])
2612\f[B]\f[CB]title-slide-attributes\f[B]\f[R]
2413\f[B]\f[CB]title-slide-attributes\f[B]\f[R]
2613additional attributes for the title slide of reveal.js slide shows.
2414additional attributes for the title slide of reveal.js slide shows.
2614See background in reveal.js and beamer for an example.
2415See background in reveal.js and beamer for an example.
2615−.PP
2616−All reveal.js configuration options are available as variables.
2617−To turn off boolean flags that default to true in reveal.js, use
2618−\f[C]0\f[R].
2619.SS Variables for Beamer slides
2416.SS Variables for Beamer slides
2620.PP
2417.PP
2621These variables change the appearance of PDF slides using
2418These variables change the appearance of PDF slides using
@@ -2644,7 +2441,7 @@ navigation symbols; other valid values are \f[C]frame\f[R],
2644\f[C]vertical\f[R], and \f[C]horizontal\f[R])
2441\f[C]vertical\f[R], and \f[C]horizontal\f[R])
2645.TP
2442.TP
2646\f[B]\f[CB]section-titles\f[B]\f[R]
2443\f[B]\f[CB]section-titles\f[B]\f[R]
2647−enables \[lq]title pages\[rq] for new sections (default is true)
2444+enables \[dq]title pages\[dq] for new sections (default is true)
2648.TP
2445.TP
2649\f[B]\f[CB]theme\f[B]\f[R], \f[B]\f[CB]colortheme\f[B]\f[R], \f[B]\f[CB]fonttheme\f[B]\f[R], \f[B]\f[CB]innertheme\f[B]\f[R], \f[B]\f[CB]outertheme\f[B]\f[R]
2446\f[B]\f[CB]theme\f[B]\f[R], \f[B]\f[CB]colortheme\f[B]\f[R], \f[B]\f[CB]fonttheme\f[B]\f[R], \f[B]\f[CB]innertheme\f[B]\f[R], \f[B]\f[CB]outertheme\f[B]\f[R]
2650beamer themes
2447beamer themes
@@ -2696,8 +2493,8 @@ header-includes: |
2696.RE
2493.RE
2697.TP
2494.TP
2698\f[B]\f[CB]classoption\f[B]\f[R]
2495\f[B]\f[CB]classoption\f[B]\f[R]
2496+option for document class, e.g.
2699−option for document class, e.g.\ \f[C]oneside\f[R]; repeat for multiple
2497+\f[C]oneside\f[R]; repeat for multiple options:
2700−options:
2701.RS
2498.RS
2702.IP
2499.IP
2703.nf
2500.nf
@@ -2718,8 +2515,8 @@ document class: usually one of the standard classes, \f[C]article\f[R],
2718default to smaller margins; or \f[C]memoir\f[R]
2515default to smaller margins; or \f[C]memoir\f[R]
2719.TP
2516.TP
2720\f[B]\f[CB]geometry\f[B]\f[R]
2517\f[B]\f[CB]geometry\f[B]\f[R]
2721−option for \f[C]geometry\f[R] package, e.g.\ \f[C]margin=1in\f[R];
2518+option for \f[C]geometry\f[R] package, e.g.
2722−repeat for multiple options:
2519+\f[C]margin=1in\f[R]; repeat for multiple options:
2723.RS
2520.RS
2724.IP
2521.IP
2725.nf
2522.nf
@@ -2735,8 +2532,8 @@ geometry:
2735.RE
2532.RE
2736.TP
2533.TP
2737\f[B]\f[CB]hyperrefoptions\f[B]\f[R]
2534\f[B]\f[CB]hyperrefoptions\f[B]\f[R]
2738−option for \f[C]hyperref\f[R] package, e.g.\ \f[C]linktoc=all\f[R];
2535+option for \f[C]hyperref\f[R] package, e.g.
2739−repeat for multiple options:
2536+\f[C]linktoc=all\f[R]; repeat for multiple options:
2740.RS
2537.RS
2741.IP
2538.IP
2742.nf
2539.nf
@@ -2752,13 +2549,12 @@ hyperrefoptions:
2752.RE
2549.RE
2753.TP
2550.TP
2754\f[B]\f[CB]indent\f[B]\f[R]
2551\f[B]\f[CB]indent\f[B]\f[R]
2755−if true, pandoc will use document class settings for indentation (the
2552+uses document class settings for indentation (the default LaTeX template
2756−default LaTeX template otherwise removes indentation and adds space
2553+otherwise removes indentation and adds space between paragraphs)
2757−between paragraphs)
2758.TP
2554.TP
2759\f[B]\f[CB]linestretch\f[B]\f[R]
2555\f[B]\f[CB]linestretch\f[B]\f[R]
2760−adjusts line spacing using the \f[C]setspace\f[R] package,
2556+adjusts line spacing using the \f[C]setspace\f[R] package, e.g.
2761−e.g.\ \f[C]1.25\f[R], \f[C]1.5\f[R]
2557+\f[C]1.25\f[R], \f[C]1.5\f[R]
2762.TP
2558.TP
2763\f[B]\f[CB]margin-left\f[B]\f[R], \f[B]\f[CB]margin-right\f[B]\f[R], \f[B]\f[CB]margin-top\f[B]\f[R], \f[B]\f[CB]margin-bottom\f[B]\f[R]
2559\f[B]\f[CB]margin-left\f[B]\f[R], \f[B]\f[CB]margin-right\f[B]\f[R], \f[B]\f[CB]margin-top\f[B]\f[R], \f[B]\f[CB]margin-bottom\f[B]\f[R]
2764sets margins if \f[C]geometry\f[R] is not used (otherwise
2560sets margins if \f[C]geometry\f[R] is not used (otherwise
@@ -2770,7 +2566,8 @@ control \f[C]\[rs]pagestyle{}\f[R]: the default article class supports
2770numbers), and \f[C]headings\f[R] (section titles in running heads)
2566numbers), and \f[C]headings\f[R] (section titles in running heads)
2771.TP
2567.TP
2772\f[B]\f[CB]papersize\f[B]\f[R]
2568\f[B]\f[CB]papersize\f[B]\f[R]
2569+paper size, e.g.
2773−paper size, e.g.\ \f[C]letter\f[R], \f[C]a4\f[R]
2570+\f[C]letter\f[R], \f[C]a4\f[R]
2774.TP
2571.TP
2775\f[B]\f[CB]secnumdepth\f[B]\f[R]
2572\f[B]\f[CB]secnumdepth\f[B]\f[R]
2776numbering depth for sections (with \f[C]--number-sections\f[R] option or
2573numbering depth for sections (with \f[C]--number-sections\f[R] option or
@@ -2895,32 +2692,35 @@ list of options for natbib
2895Pandoc uses these variables when creating a PDF with ConTeXt.
2692Pandoc uses these variables when creating a PDF with ConTeXt.
2896.TP
2693.TP
2897\f[B]\f[CB]fontsize\f[B]\f[R]
2694\f[B]\f[CB]fontsize\f[B]\f[R]
2898−font size for body text (e.g.\ \f[C]10pt\f[R], \f[C]12pt\f[R])
2695+font size for body text (e.g.
2696+\f[C]10pt\f[R], \f[C]12pt\f[R])
2899.TP
2697.TP
2900\f[B]\f[CB]headertext\f[B]\f[R], \f[B]\f[CB]footertext\f[B]\f[R]
2698\f[B]\f[CB]headertext\f[B]\f[R], \f[B]\f[CB]footertext\f[B]\f[R]
2901text to be placed in running header or footer (see ConTeXt Headers and
2699text to be placed in running header or footer (see ConTeXt Headers and
2902Footers); repeat up to four times for different placement
2700Footers); repeat up to four times for different placement
2903.TP
2701.TP
2904\f[B]\f[CB]indenting\f[B]\f[R]
2702\f[B]\f[CB]indenting\f[B]\f[R]
2905−controls indentation of paragraphs, e.g.\ \f[C]yes,small,next\f[R] (see
2703+controls indentation of paragraphs, e.g.
2906−ConTeXt Indentation); repeat for multiple options
2704+\f[C]yes,small,next\f[R] (see ConTeXt Indentation); repeat for multiple
2705+options
2907.TP
2706.TP
2908\f[B]\f[CB]interlinespace\f[B]\f[R]
2707\f[B]\f[CB]interlinespace\f[B]\f[R]
2909−adjusts line spacing, e.g.\ \f[C]4ex\f[R] (using
2708+adjusts line spacing, e.g.
2910−\f[C]setupinterlinespace\f[R]); repeat for multiple options
2709+\f[C]4ex\f[R] (using \f[C]setupinterlinespace\f[R]); repeat for multiple
2710+options
2911.TP
2711.TP
2912\f[B]\f[CB]layout\f[B]\f[R]
2712\f[B]\f[CB]layout\f[B]\f[R]
2913options for page margins and text arrangement (see ConTeXt Layout);
2713options for page margins and text arrangement (see ConTeXt Layout);
2914repeat for multiple options
2714repeat for multiple options
2915.TP
2715.TP
2916\f[B]\f[CB]linkcolor\f[B]\f[R], \f[B]\f[CB]contrastcolor\f[B]\f[R]
2716\f[B]\f[CB]linkcolor\f[B]\f[R], \f[B]\f[CB]contrastcolor\f[B]\f[R]
2917−color for links outside and inside a page, e.g.\ \f[C]red\f[R],
2717+color for links outside and inside a page, e.g.
2918−\f[C]blue\f[R] (see ConTeXt Color)
2718+\f[C]red\f[R], \f[C]blue\f[R] (see ConTeXt Color)
2919.TP
2719.TP
2920\f[B]\f[CB]linkstyle\f[B]\f[R]
2720\f[B]\f[CB]linkstyle\f[B]\f[R]
2921−typeface style for links, e.g.\ \f[C]normal\f[R], \f[C]bold\f[R],
2721+typeface style for links, e.g.
2722+\f[C]normal\f[R], \f[C]bold\f[R], \f[C]slanted\f[R],
2922−\f[C]slanted\f[R], \f[C]boldslanted\f[R], \f[C]type\f[R], \f[C]cap\f[R],
2723+\f[C]boldslanted\f[R], \f[C]type\f[R], \f[C]cap\f[R], \f[C]small\f[R]
2923−\f[C]small\f[R]
2924.TP
2724.TP
2925\f[B]\f[CB]lof\f[B]\f[R], \f[B]\f[CB]lot\f[B]\f[R]
2725\f[B]\f[CB]lof\f[B]\f[R], \f[B]\f[CB]lot\f[B]\f[R]
2926include list of figures, list of tables
2726include list of figures, list of tables
@@ -2938,13 +2738,16 @@ page number style and location (using \f[C]setuppagenumbering\f[R]);
2938repeat for multiple options
2738repeat for multiple options
2939.TP
2739.TP
2940\f[B]\f[CB]papersize\f[B]\f[R]
2740\f[B]\f[CB]papersize\f[B]\f[R]
2741+paper size, e.g.
2941−paper size, e.g.\ \f[C]letter\f[R], \f[C]A4\f[R], \f[C]landscape\f[R]
2742+\f[C]letter\f[R], \f[C]A4\f[R], \f[C]landscape\f[R] (see ConTeXt Paper
2942−(see ConTeXt Paper Setup); repeat for multiple options
2743+Setup); repeat for multiple options
2943.TP
2744.TP
2944\f[B]\f[CB]pdfa\f[B]\f[R]
2745\f[B]\f[CB]pdfa\f[B]\f[R]
2945adds to the preamble the setup necessary to generate PDF/A of the type
2746adds to the preamble the setup necessary to generate PDF/A of the type
2747+specified, e.g.
2946−specified, e.g.\ \f[C]1a:2005\f[R], \f[C]2a\f[R].
2748+\f[C]1a:2005\f[R], \f[C]2a\f[R].
2749+If no type is specified (i.e.
2947−If no type is specified (i.e.\ the value is set to True, by e.g.
2750+the value is set to True, by e.g.
2948\f[C]--metadata=pdfa\f[R] or \f[C]pdfa: true\f[R] in a YAML metadata
2751\f[C]--metadata=pdfa\f[R] or \f[C]pdfa: true\f[R] in a YAML metadata
2949block), \f[C]1b:2005\f[R] will be used as default, for reasons of
2752block), \f[C]1b:2005\f[R] will be used as default, for reasons of
2950backwards compatibility.
2753backwards compatibility.
@@ -2959,7 +2762,8 @@ See also ConTeXt PDFA for more details.
2959.TP
2762.TP
2960\f[B]\f[CB]pdfaiccprofile\f[B]\f[R]
2763\f[B]\f[CB]pdfaiccprofile\f[B]\f[R]
2961when used in conjunction with \f[C]pdfa\f[R], specifies the ICC profile
2764when used in conjunction with \f[C]pdfa\f[R], specifies the ICC profile
2962−to use in the PDF, e.g.\ \f[C]default.cmyk\f[R].
2765+to use in the PDF, e.g.
2766+\f[C]default.cmyk\f[R].
2963If left unspecified, \f[C]sRGB.icc\f[R] is used as default.
2767If left unspecified, \f[C]sRGB.icc\f[R] is used as default.
2964May be repeated to include multiple profiles.
2768May be repeated to include multiple profiles.
2965Note that the profiles have to be available on the system.
2769Note that the profiles have to be available on the system.
@@ -2967,17 +2771,17 @@ They can be obtained from ConTeXt ICC Profiles.
2967.TP
2771.TP
2968\f[B]\f[CB]pdfaintent\f[B]\f[R]
2772\f[B]\f[CB]pdfaintent\f[B]\f[R]
2969when used in conjunction with \f[C]pdfa\f[R], specifies the output
2773when used in conjunction with \f[C]pdfa\f[R], specifies the output
2970−intent for the colors,
2774+intent for the colors, e.g.
2971−e.g.\ \f[C]ISO coated v2 300\[rs]letterpercent\[rs]space (ECI)\f[R] If
2775+\f[C]ISO coated v2 300\[rs]letterpercent\[rs]space (ECI)\f[R] If left
2972−left unspecified, \f[C]sRGB IEC61966-2.1\f[R] is used as default.
2776+unspecified, \f[C]sRGB IEC61966-2.1\f[R] is used as default.
2973.TP
2777.TP
2974\f[B]\f[CB]toc\f[B]\f[R]
2778\f[B]\f[CB]toc\f[B]\f[R]
2975include table of contents (can also be set using
2779include table of contents (can also be set using
2976\f[C]--toc/--table-of-contents\f[R])
2780\f[C]--toc/--table-of-contents\f[R])
2977.TP
2781.TP
2978\f[B]\f[CB]whitespace\f[B]\f[R]
2782\f[B]\f[CB]whitespace\f[B]\f[R]
2979−spacing between paragraphs, e.g.\ \f[C]none\f[R], \f[C]small\f[R] (using
2783+spacing between paragraphs, e.g.
2980−\f[C]setupwhitespace\f[R])
2784+\f[C]none\f[R], \f[C]small\f[R] (using \f[C]setupwhitespace\f[R])
2981.TP
2785.TP
2982\f[B]\f[CB]includesource\f[B]\f[R]
2786\f[B]\f[CB]includesource\f[B]\f[R]
2983include all source documents as file attachments in the PDF file
2787include all source documents as file attachments in the PDF file
@@ -3015,16 +2819,20 @@ section number in man pages
3015.SS Variables for ms
2819.SS Variables for ms
3016.TP
2820.TP
3017\f[B]\f[CB]fontfamily\f[B]\f[R]
2821\f[B]\f[CB]fontfamily\f[B]\f[R]
3018−font family (e.g.\ \f[C]T\f[R] or \f[C]P\f[R])
2822+font family (e.g.
2823+\f[C]T\f[R] or \f[C]P\f[R])
3019.TP
2824.TP
3020\f[B]\f[CB]indent\f[B]\f[R]
2825\f[B]\f[CB]indent\f[B]\f[R]
3021−paragraph indent (e.g.\ \f[C]2m\f[R])
2826+paragraph indent (e.g.
2827+\f[C]2m\f[R])
3022.TP
2828.TP
3023\f[B]\f[CB]lineheight\f[B]\f[R]
2829\f[B]\f[CB]lineheight\f[B]\f[R]
3024−line height (e.g.\ \f[C]12p\f[R])
2830+line height (e.g.
2831+\f[C]12p\f[R])
3025.TP
2832.TP
3026\f[B]\f[CB]pointsize\f[B]\f[R]
2833\f[B]\f[CB]pointsize\f[B]\f[R]
3027−point size (e.g.\ \f[C]10p\f[R])
2834+point size (e.g.
2835+\f[C]10p\f[R])
3028.SS Variables set automatically
2836.SS Variables set automatically
3029.PP
2837.PP
3030Pandoc sets these variables automatically in response to options or
2838Pandoc sets these variables automatically in response to options or
@@ -3040,9 +2848,10 @@ in all HTML based formats (dzslides, epub, html, html4, html5, revealjs,
3040s5, slideous, slidy).
2848s5, slideous, slidy).
3041The recognized formats for \f[C]date\f[R] are: \f[C]mm/dd/yyyy\f[R],
2849The recognized formats for \f[C]date\f[R] are: \f[C]mm/dd/yyyy\f[R],
3042\f[C]mm/dd/yy\f[R], \f[C]yyyy-mm-dd\f[R] (ISO 8601),
2850\f[C]mm/dd/yy\f[R], \f[C]yyyy-mm-dd\f[R] (ISO 8601),
2851+\f[C]dd MM yyyy\f[R] (e.g.
3043−\f[C]dd MM yyyy\f[R] (e.g.\ either \f[C]02 Apr 2018\f[R] or
2852+either \f[C]02 Apr 2018\f[R] or \f[C]02 April 2018\f[R]),
3044−\f[C]02 April 2018\f[R]), \f[C]MM dd, yyyy\f[R]
2853+\f[C]MM dd, yyyy\f[R] (e.g.
3045−(e.g.\ \f[C]Apr. 02, 2018\f[R] or
2854+\f[C]Apr. 02, 2018\f[R] or
3046\f[C]April 02, 2018),\f[R]yyyy[mm[dd]]]\f[C](e.g.\f[R]20180402,
2855\f[C]April 02, 2018),\f[R]yyyy[mm[dd]]]\f[C](e.g.\f[R]20180402,
3047\f[C]201804\f[R] or \f[C]2018\f[R]).
2856\f[C]201804\f[R] or \f[C]2018\f[R]).
3048.TP
2857.TP
@@ -3059,7 +2868,7 @@ contents specified by \f[C]-A/--include-after-body\f[R] (may have
3059multiple values)
2868multiple values)
3060.TP
2869.TP
3061\f[B]\f[CB]meta-json\f[B]\f[R]
2870\f[B]\f[CB]meta-json\f[B]\f[R]
3062−JSON representation of all of the document\[cq]s metadata.
2871+JSON representation of all of the document\[aq]s metadata.
3063Field values are transformed to the selected output format.
2872Field values are transformed to the selected output format.
3064.TP
2873.TP
3065\f[B]\f[CB]numbersections\f[B]\f[R]
2874\f[B]\f[CB]numbersections\f[B]\f[R]
@@ -3087,7 +2896,8 @@ $endif$
3087Similarly, \f[C]outputfile\f[R] can be \f[C]-\f[R] if output goes to the
2896Similarly, \f[C]outputfile\f[R] can be \f[C]-\f[R] if output goes to the
3088terminal.
2897terminal.
3089.PP
2898.PP
3090−If you need absolute paths, use e.g.\ \f[C]$curdir$/$sourcefile$\f[R].
2899+If you need absolute paths, use e.g.
2900+\f[C]$curdir$/$sourcefile$\f[R].
3091.RE
2901.RE
3092.TP
2902.TP
3093\f[B]\f[CB]curdir\f[B]\f[R]
2903\f[B]\f[CB]curdir\f[B]\f[R]
@@ -3108,12 +2918,12 @@ An extension can be enabled by adding \f[C]+EXTENSION\f[R] to the format
3108name and disabled by adding \f[C]-EXTENSION\f[R].
2918name and disabled by adding \f[C]-EXTENSION\f[R].
3109For example, \f[C]--from markdown_strict+footnotes\f[R] is strict
2919For example, \f[C]--from markdown_strict+footnotes\f[R] is strict
3110Markdown with footnotes enabled, while
2920Markdown with footnotes enabled, while
3111−\f[C]--from markdown-footnotes-pipe_tables\f[R] is pandoc\[cq]s Markdown
2921+\f[C]--from markdown-footnotes-pipe_tables\f[R] is pandoc\[aq]s Markdown
3112without footnotes or pipe tables.
2922without footnotes or pipe tables.
3113.PP
2923.PP
3114The markdown reader and writer make by far the most use of extensions.
2924The markdown reader and writer make by far the most use of extensions.
3115Extensions only used by them are therefore covered in the section
2925Extensions only used by them are therefore covered in the section
3116−Pandoc\[cq]s Markdown below (See Markdown variants for
2926+Pandoc\[aq]s Markdown below (See Markdown variants for
3117\f[C]commonmark\f[R] and \f[C]gfm\f[R].) In the following, extensions
2927\f[C]commonmark\f[R] and \f[C]gfm\f[R].) In the following, extensions
3118that also work for other formats are covered.
2928that also work for other formats are covered.
3119.PP
2929.PP
@@ -3126,7 +2936,7 @@ Markdown cells in Jupyter notebooks (as do command-line options like
3126Interpret straight quotes as curly quotes, \f[C]---\f[R] as em-dashes,
2936Interpret straight quotes as curly quotes, \f[C]---\f[R] as em-dashes,
3127\f[C]--\f[R] as en-dashes, and \f[C]...\f[R] as ellipses.
2937\f[C]--\f[R] as en-dashes, and \f[C]...\f[R] as ellipses.
3128Nonbreaking spaces are inserted after certain abbreviations, such as
2938Nonbreaking spaces are inserted after certain abbreviations, such as
3129−\[lq]Mr.\[rq]
2939+\[dq]Mr.\[dq]
3130.PP
2940.PP
3131This extension can be enabled/disabled for the following formats:
2941This extension can be enabled/disabled for the following formats:
3132.TP
2942.TP
@@ -3276,7 +3086,7 @@ letters are omitted.
3276.SS Extension: \f[C]gfm_auto_identifiers\f[R]
3086.SS Extension: \f[C]gfm_auto_identifiers\f[R]
3277.PP
3087.PP
3278Changes the algorithm used by \f[C]auto_identifiers\f[R] to conform to
3088Changes the algorithm used by \f[C]auto_identifiers\f[R] to conform to
3279−GitHub\[cq]s method.
3089+GitHub\[aq]s method.
3280Spaces are converted to dashes (\f[C]-\f[R]), uppercase characters to
3090Spaces are converted to dashes (\f[C]-\f[R]), uppercase characters to
3281lowercase characters, and punctuation characters other than \f[C]-\f[R]
3091lowercase characters, and punctuation characters other than \f[C]-\f[R]
3282and \f[C]_\f[R] are removed.
3092and \f[C]_\f[R] are removed.
@@ -3286,29 +3096,32 @@ Emojis are replaced by their names.
3286The extensions \f[C]tex_math_dollars\f[R],
3096The extensions \f[C]tex_math_dollars\f[R],
3287\f[C]tex_math_single_backslash\f[R], and
3097\f[C]tex_math_single_backslash\f[R], and
3288\f[C]tex_math_double_backslash\f[R] are described in the section about
3098\f[C]tex_math_double_backslash\f[R] are described in the section about
3289−Pandoc\[cq]s Markdown.
3099+Pandoc\[aq]s Markdown.
3290.PP
3100.PP
3291However, they can also be used with HTML input.
3101However, they can also be used with HTML input.
3292This is handy for reading web pages formatted using MathJax, for
3102This is handy for reading web pages formatted using MathJax, for
3293example.
3103example.
3294.SS Raw HTML/TeX
3104.SS Raw HTML/TeX
3295.PP
3105.PP
3106+The following extensions (especially how they affect Markdown
3296−The following extensions are described in more detail in their
3107+input/output) are also described in more detail in their respective
3297−respective sections of Pandoc\[cq]s Markdown:
3108+sections of Pandoc\[aq]s Markdown.
3298−.IP \[bu] 2
3109+.SS Extension: \f[C]raw_html\f[R]
3110+.PP
3299−\f[C]raw_html\f[R] allows HTML elements which are not representable in
3111+When converting from HTML, parse elements to raw HTML which are not
3300−pandoc\[cq]s AST to be parsed as raw HTML.
3112+representable in pandoc\[aq]s AST.
3301By default, this is disabled for HTML input.
3113By default, this is disabled for HTML input.
3302−.IP \[bu] 2
3114+.SS Extension: \f[C]raw_tex\f[R]
3115+.PP
3303−\f[C]raw_tex\f[R] allows raw LaTeX, TeX, and ConTeXt to be included in a
3116+Allows raw LaTeX, TeX, and ConTeXt to be included in a document.
3304−document.
3117+.PP
3305This extension can be enabled/disabled for the following formats (in
3118This extension can be enabled/disabled for the following formats (in
3306addition to \f[C]markdown\f[R]):
3119addition to \f[C]markdown\f[R]):
3307−.RS 2
3308.TP
3120.TP
3309input formats
3121input formats
3310−\f[C]latex\f[R], \f[C]textile\f[R], \f[C]html\f[R] (environments,
3122+\f[C]latex\f[R], \f[C]org\f[R], \f[C]textile\f[R], \f[C]html\f[R]
3311−\f[C]\[rs]ref\f[R], and \f[C]\[rs]eqref\f[R] only), \f[C]ipynb\f[R]
3123+(environments, \f[C]\[rs]ref\f[R], and \f[C]\[rs]eqref\f[R] only),
3124+\f[C]ipynb\f[R]
3312.TP
3125.TP
3313output formats
3126output formats
3314\f[C]textile\f[R], \f[C]commonmark\f[R]
3127\f[C]textile\f[R], \f[C]commonmark\f[R]
@@ -3319,22 +3132,26 @@ with mime type \f[C]text/html\f[R] in output cells.
3319Since the \f[C]ipynb\f[R] reader attempts to preserve the richest
3132Since the \f[C]ipynb\f[R] reader attempts to preserve the richest
3320possible outputs when several options are given, you will get best
3133possible outputs when several options are given, you will get best
3321results if you disable \f[C]raw_html\f[R] and \f[C]raw_tex\f[R] when
3134results if you disable \f[C]raw_html\f[R] and \f[C]raw_tex\f[R] when
3322−converting to formats like \f[C]docx\f[R] which don\[cq]t allow raw
3135+converting to formats like \f[C]docx\f[R] which don\[aq]t allow raw
3323\f[C]html\f[R] or \f[C]tex\f[R].
3136\f[C]html\f[R] or \f[C]tex\f[R].
3324−.RE
3137+.SS Extension: \f[C]native_divs\f[R]
3325−.IP \[bu] 2
3138+.PP
3326−\f[C]native_divs\f[R] causes HTML \f[C]div\f[R] elements to be parsed as
3139+This extension is enabled by default for HTML input.
3327−native pandoc Div blocks.
3140+This means that \f[C]div\f[R]s are parsed to pandoc native elements.
3328−If you want them to be parsed as raw HTML, use
3329−\f[C]-f html-native_divs+raw_html\f[R].
3330−.IP \[bu] 2
3331−\f[C]native_spans\f[R] causes HTML \f[C]span\f[R] elements to be parsed
3332−as native pandoc Span inlines.
3333−If you want them to be parsed as raw HTML, use
3141+(Alternatively, you can parse them to raw HTML using
3334−\f[C]-f html-native_spans+raw_html\f[R].
3142+\f[C]-f html-native_divs+raw_html\f[R].)
3143+.PP
3144+When converting HTML to Markdown, for example, you may want to drop all
3335−If you want to drop all \f[C]div\f[R]s and \f[C]span\f[R]s when
3145+\f[C]div\f[R]s and \f[C]span\f[R]s:
3336−converting HTML to Markdown, you can use
3146+.IP
3147+.nf
3148+\f[C]
3337−\f[C]pandoc -f html-native_divs-native_spans -t markdown\f[R].
3149+pandoc -f html-native_divs-native_spans -t markdown
3150+\f[R]
3151+.fi
3152+.SS Extension: \f[C]native_spans\f[R]
3153+.PP
3154+Analogous to \f[C]native_divs\f[R] above.
3338.SS Literate Haskell support
3155.SS Literate Haskell support
3339.SS Extension: \f[C]literate_haskell\f[R]
3156.SS Extension: \f[C]literate_haskell\f[R]
3340.PP
3157.PP
@@ -3353,22 +3170,23 @@ the formats above, pandoc will treat the document as literate Haskell
3353source.
3170source.
3354This means that
3171This means that
3355.IP \[bu] 2
3172.IP \[bu] 2
3356−In Markdown input, \[lq]bird track\[rq] sections will be parsed as
3173+In Markdown input, \[dq]bird track\[dq] sections will be parsed as
3357Haskell code rather than block quotations.
3174Haskell code rather than block quotations.
3358Text between \f[C]\[rs]begin{code}\f[R] and \f[C]\[rs]end{code}\f[R]
3175Text between \f[C]\[rs]begin{code}\f[R] and \f[C]\[rs]end{code}\f[R]
3359will also be treated as Haskell code.
3176will also be treated as Haskell code.
3360−For ATX-style headings the character `=' will be used instead of `#'.
3177+For ATX-style headings the character \[aq]=\[aq] will be used instead of
3178+\[aq]#\[aq].
3361.IP \[bu] 2
3179.IP \[bu] 2
3362In Markdown output, code blocks with classes \f[C]haskell\f[R] and
3180In Markdown output, code blocks with classes \f[C]haskell\f[R] and
3363\f[C]literate\f[R] will be rendered using bird tracks, and block
3181\f[C]literate\f[R] will be rendered using bird tracks, and block
3364quotations will be indented one space, so they will not be treated as
3182quotations will be indented one space, so they will not be treated as
3365Haskell code.
3183Haskell code.
3366In addition, headings will be rendered setext-style (with underlines)
3184In addition, headings will be rendered setext-style (with underlines)
3367−rather than ATX-style (with `#' characters).
3185+rather than ATX-style (with \[aq]#\[aq] characters).
3368−(This is because ghc treats `#' characters in column 1 as introducing
3186+(This is because ghc treats \[aq]#\[aq] characters in column 1 as
3369−line numbers.)
3187+introducing line numbers.)
3370.IP \[bu] 2
3188.IP \[bu] 2
3371−In restructured text input, \[lq]bird track\[rq] sections will be parsed
3189+In restructured text input, \[dq]bird track\[dq] sections will be parsed
3372as Haskell code.
3190as Haskell code.
3373.IP \[bu] 2
3191.IP \[bu] 2
3374In restructured text output, code blocks with class \f[C]haskell\f[R]
3192In restructured text output, code blocks with class \f[C]haskell\f[R]
@@ -3404,8 +3222,9 @@ writes HTML with the Haskell code in bird tracks, so it can be copied
3404and pasted as literate Haskell source.
3222and pasted as literate Haskell source.
3405.PP
3223.PP
3406Note that GHC expects the bird tracks in the first column, so indented
3224Note that GHC expects the bird tracks in the first column, so indented
3225+literate code blocks (e.g.
3407−literate code blocks (e.g.\ inside an itemized environment) will not be
3226+inside an itemized environment) will not be picked up by the Haskell
3408−picked up by the Haskell compiler.
3227+compiler.
3409.SS Other extensions
3228.SS Other extensions
3410.SS Extension: \f[C]empty_paragraphs\f[R]
3229.SS Extension: \f[C]empty_paragraphs\f[R]
3411.PP
3230.PP
@@ -3428,43 +3247,6 @@ This extension can be enabled/disabled for the following formats:
3428.TP
3247.TP
3429output formats
3248output formats
3430\f[C]odt\f[R], \f[C]opendocument\f[R]
3249\f[C]odt\f[R], \f[C]opendocument\f[R]
3431−.SS Extension: \f[C]xrefs_name\f[R]
3432−.PP
3433−Links to headings, figures and tables inside the document are
3434−substituted with cross-references that will use the name or caption of
3435−the referenced item.
3436−The original link text is replaced once the generated document is
3437−refreshed.
3438−This extension can be combined with \f[C]xrefs_number\f[R] in which case
3439−numbers will appear before the name.
3440−.PP
3441−Text in cross-references is only made consistent with the referenced
3442−item once the document has been refreshed.
3443−.PP
3444−This extension can be enabled/disabled for the following formats:
3445−.TP
3446−output formats
3447−\f[C]odt\f[R], \f[C]opendocument\f[R]
3448−.SS Extension: \f[C]xrefs_number\f[R]
3449−.PP
3450−Links to headings, figures and tables inside the document are
3451−substituted with cross-references that will use the number of the
3452−referenced item.
3453−The original link text is discarded.
3454−This extension can be combined with \f[C]xrefs_name\f[R] in which case
3455−the name or caption numbers will appear after the number.
3456−.PP
3457−For the \f[C]xrefs_number\f[R] to be useful heading numbers must be
3458−enabled in the generated document, also table and figure captions must
3459−be enabled using for example the \f[C]native_numbering\f[R] extension.
3460−.PP
3461−Numbers in cross-references are only visible in the final document once
3462−it has been refreshed.
3463−.PP
3464−This extension can be enabled/disabled for the following formats:
3465−.TP
3466−output formats
3467−\f[C]odt\f[R], \f[C]opendocument\f[R]
3468.SS Extension: \f[C]styles\f[R]
3250.SS Extension: \f[C]styles\f[R]
3469.PP
3251.PP
3470When converting from docx, read all docx styles as divs (for paragraph
3252When converting from docx, read all docx styles as divs (for paragraph
@@ -3479,33 +3261,20 @@ input formats
3479.PP
3261.PP
3480In the \f[C]muse\f[R] input format, this enables Text::Amuse extensions
3262In the \f[C]muse\f[R] input format, this enables Text::Amuse extensions
3481to Emacs Muse markup.
3263to Emacs Muse markup.
3482−.SS Extension: \f[C]raw_markdown\f[R]
3483−.PP
3484−In the \f[C]ipynb\f[R] input format, this causes Markdown cells to be
3485−included as raw Markdown blocks (allowing lossless round-tripping)
3486−rather than being parsed.
3487−Use this only when you are targeting \f[C]ipynb\f[R] or a markdown-based
3488−output format.
3489.SS Extension: \f[C]citations\f[R]
3264.SS Extension: \f[C]citations\f[R]
3490.PP
3265.PP
3491−Some aspects of Pandoc\[cq]s Markdown citation syntax are also accepted
3266+Some aspects of Pandoc\[aq]s Markdown citation syntax are also accepted
3492in \f[C]org\f[R] input.
3267in \f[C]org\f[R] input.
3493−.SS Extension: \f[C]element_citations\f[R]
3494−.PP
3495−In the \f[C]jats\f[R] output formats, this causes reference items to be
3496−replaced with \f[C]<element-citation>\f[R] elements.
3497−These elements are not influenced by CSL styles, but all information on
3498−the item is included in tags.
3499.SS Extension: \f[C]ntb\f[R]
3268.SS Extension: \f[C]ntb\f[R]
3500.PP
3269.PP
3501In the \f[C]context\f[R] output format this enables the use of Natural
3270In the \f[C]context\f[R] output format this enables the use of Natural
3502Tables (TABLE) instead of the default Extreme Tables (xtables).
3271Tables (TABLE) instead of the default Extreme Tables (xtables).
3503Natural tables allow more fine-grained global customization but come at
3272Natural tables allow more fine-grained global customization but come at
3504a performance penalty compared to extreme tables.
3273a performance penalty compared to extreme tables.
3505−.SH PANDOC\[cq]S MARKDOWN
3274+.SH PANDOC\[aq]S MARKDOWN
3506.PP
3275.PP
3507Pandoc understands an extended and slightly revised version of John
3276Pandoc understands an extended and slightly revised version of John
3508−Gruber\[cq]s Markdown syntax.
3277+Gruber\[aq]s Markdown syntax.
3509This document explains the syntax, noting differences from standard
3278This document explains the syntax, noting differences from standard
3510Markdown.
3279Markdown.
3511Except where noted, these differences can be suppressed by using the
3280Except where noted, these differences can be suppressed by using the
@@ -3522,15 +3291,15 @@ easy to read:
3522.RS
3291.RS
3523.PP
3292.PP
3524A Markdown-formatted document should be publishable as-is, as plain
3293A Markdown-formatted document should be publishable as-is, as plain
3525−text, without looking like it\[cq]s been marked up with tags or
3294+text, without looking like it\[aq]s been marked up with tags or
3526formatting instructions.
3295formatting instructions.
3527−\[en] John Gruber
3296+-- John Gruber
3528.RE
3297.RE
3529.PP
3298.PP
3530−This principle has guided pandoc\[cq]s decisions in finding syntax for
3299+This principle has guided pandoc\[aq]s decisions in finding syntax for
3531tables, footnotes, and other extensions.
3300tables, footnotes, and other extensions.
3532.PP
3301.PP
3533−There is, however, one respect in which pandoc\[cq]s aims are different
3302+There is, however, one respect in which pandoc\[aq]s aims are different
3534from the original aims of Markdown.
3303from the original aims of Markdown.
3535Whereas Markdown was originally designed with HTML generation in mind,
3304Whereas Markdown was originally designed with HTML generation in mind,
3536pandoc is designed for multiple output formats.
3305pandoc is designed for multiple output formats.
@@ -3555,7 +3324,7 @@ a hard line break, since trailing spaces in the cells are ignored.
3555There are two kinds of headings: Setext and ATX.
3324There are two kinds of headings: Setext and ATX.
3556.SS Setext-style headings
3325.SS Setext-style headings
3557.PP
3326.PP
3558−A setext-style heading is a line of text \[lq]underlined\[rq] with a row
3327+A setext-style heading is a line of text \[dq]underlined\[dq] with a row
3559of \f[C]=\f[R] signs (for a level-one heading) or \f[C]-\f[R] signs (for
3328of \f[C]=\f[R] signs (for a level-one heading) or \f[C]-\f[R] signs (for
3560a level-two heading):
3329a level-two heading):
3561.IP
3330.IP
@@ -3646,7 +3415,7 @@ My other heading {#foo}
3646(This syntax is compatible with PHP Markdown Extra.)
3415(This syntax is compatible with PHP Markdown Extra.)
3647.PP
3416.PP
3648Note that although this syntax allows assignment of classes and
3417Note that although this syntax allows assignment of classes and
3649−key/value attributes, writers generally don\[cq]t use all of this
3418+key/value attributes, writers generally don\[aq]t use all of this
3650information.
3419information.
3651Identifiers, classes, and key/value attributes are used in HTML and
3420Identifiers, classes, and key/value attributes are used in HTML and
3652HTML-based formats such as EPUB and slidy.
3421HTML-based formats such as EPUB and slidy.
@@ -3761,7 +3530,7 @@ indented more than three spaces.)
3761\f[R]
3530\f[R]
3762.fi
3531.fi
3763.PP
3532.PP
3764−A \[lq]lazy\[rq] form, which requires the \f[C]>\f[R] character only on
3533+A \[dq]lazy\[dq] form, which requires the \f[C]>\f[R] character only on
3765the first line of each block, is also allowed:
3534the first line of each block, is also allowed:
3766.IP
3535.IP
3767.nf
3536.nf
@@ -3979,9 +3748,6 @@ begin with a space.
3979\f[R]
3748\f[R]
3980.fi
3749.fi
3981.PP
3750.PP
3982−Inline formatting (such as emphasis) is allowed in the content, but not
3983−block-level formatting (such as block quotes or lists).
3984−.PP
3985This syntax is borrowed from reStructuredText.
3751This syntax is borrowed from reStructuredText.
3986.SS Lists
3752.SS Lists
3987.SS Bullet lists
3753.SS Bullet lists
@@ -3999,8 +3765,8 @@ Here is a simple example:
3999\f[R]
3765\f[R]
4000.fi
3766.fi
4001.PP
3767.PP
4002−This will produce a \[lq]compact\[rq] list.
3768+This will produce a \[dq]compact\[dq] list.
4003−If you want a \[lq]loose\[rq] list, in which each item is formatted as a
3769+If you want a \[dq]loose\[dq] list, in which each item is formatted as a
4004paragraph, put spaces between the items:
3770paragraph, put spaces between the items:
4005.IP
3771.IP
4006.nf
3772.nf
@@ -4028,7 +3794,7 @@ List items look best if subsequent lines are flush with the first line
4028\f[R]
3794\f[R]
4029.fi
3795.fi
4030.PP
3796.PP
4031−But Markdown also allows a \[lq]lazy\[rq] format:
3797+But Markdown also allows a \[dq]lazy\[dq] format:
4032.IP
3798.IP
4033.nf
3799.nf
4034\f[C]
3800\f[C]
@@ -4091,7 +3857,7 @@ character after the list marker of the containing list item.
4091.fi
3857.fi
4092.PP
3858.PP
4093As noted above, Markdown allows you to write list items
3859As noted above, Markdown allows you to write list items
4094−\[lq]lazily,\[rq] instead of indenting continuation lines.
3860+\[dq]lazily,\[dq] instead of indenting continuation lines.
4095However, if there are multiple paragraphs or other blocks in a list
3861However, if there are multiple paragraphs or other blocks in a list
4096item, the first line of each must be indented.
3862item, the first line of each must be indented.
4097.IP
3863.IP
@@ -4145,8 +3911,8 @@ They must be separated from the text that follows by at least one space,
4145and, if the list marker is a capital letter with a period, by at least
3911and, if the list marker is a capital letter with a period, by at least
4146two spaces.
3912two spaces.
4147.PP
3913.PP
4148−The \f[C]fancy_lists\f[R] extension also allows `\f[C]#\f[R]' to be used
3914+The \f[C]fancy_lists\f[R] extension also allows \[aq]\f[C]#\f[R]\[aq] to
4149−as an ordered list marker in place of a numeral:
3915+be used as an ordered list marker in place of a numeral:
4150.IP
3916.IP
4151.nf
3917.nf
4152\f[C]
3918\f[C]
@@ -4239,7 +4005,7 @@ one or more block elements (paragraph, code block, list, etc.), each
4239indented four spaces or one tab stop.
4005indented four spaces or one tab stop.
4240The body of the definition (including the first line, aside from the
4006The body of the definition (including the first line, aside from the
4241colon or tilde) should be indented four spaces.
4007colon or tilde) should be indented four spaces.
4242−However, as with other Markdown lists, you can \[lq]lazily\[rq] omit
4008+However, as with other Markdown lists, you can \[dq]lazily\[dq] omit
4243indentation except at the beginning of a paragraph or other block
4009indentation except at the beginning of a paragraph or other block
4244element:
4010element:
4245.IP
4011.IP
@@ -4273,16 +4039,16 @@ Term 2
4273.fi
4039.fi
4274.PP
4040.PP
4275Note that space between items in a definition list is required.
4041Note that space between items in a definition list is required.
4276−(A variant that loosens this requirement, but disallows \[lq]lazy\[rq]
4042+(A variant that loosens this requirement, but disallows \[dq]lazy\[dq]
4277hard wrapping, can be activated with \f[C]compact_definition_lists\f[R]:
4043hard wrapping, can be activated with \f[C]compact_definition_lists\f[R]:
4278−see Non-default extensions, below.)
4044+see Non-pandoc extensions, below.)
4279.SS Numbered example lists
4045.SS Numbered example lists
4280.SS Extension: \f[C]example_lists\f[R]
4046.SS Extension: \f[C]example_lists\f[R]
4281.PP
4047.PP
4282The special list marker \f[C]\[at]\f[R] can be used for sequentially
4048The special list marker \f[C]\[at]\f[R] can be used for sequentially
4283numbered examples.
4049numbered examples.
4284−The first list item with a \f[C]\[at]\f[R] marker will be numbered `1',
4050+The first list item with a \f[C]\[at]\f[R] marker will be numbered
4285−the next `2', and so on, throughout the document.
4051+\[aq]1\[aq], the next \[aq]2\[aq], and so on, throughout the document.
4286The numbered examples need not occur in a single list; each new list
4052The numbered examples need not occur in a single list; each new list
4287using \f[C]\[at]\f[R] will take up where the last stopped.
4053using \f[C]\[at]\f[R] will take up where the last stopped.
4288So, for example:
4054So, for example:
@@ -4318,6 +4084,39 @@ That is, example lists always behave as if the \f[C]four_space_rule\f[R]
4318extension is set.
4084extension is set.
4319This is because example labels tend to be long, and indenting content to
4085This is because example labels tend to be long, and indenting content to
4320the first non-space character after the label would be awkward.
4086the first non-space character after the label would be awkward.
4087+.SS Compact and loose lists
4088+.PP
4089+Pandoc behaves differently from \f[C]Markdown.pl\f[R] on some \[dq]edge
4090+cases\[dq] involving lists.
4091+Consider this source:
4092+.IP
4093+.nf
4094+\f[C]
4095++ First
4096++ Second:
4097+ - Fee
4098+ - Fie
4099+ - Foe
4100+
4101++ Third
4102+\f[R]
4103+.fi
4104+.PP
4105+Pandoc transforms this into a \[dq]compact list\[dq] (with no
4106+\f[C]<p>\f[R] tags around \[dq]First\[dq], \[dq]Second\[dq], or
4107+\[dq]Third\[dq]), while Markdown puts \f[C]<p>\f[R] tags around
4108+\[dq]Second\[dq] and \[dq]Third\[dq] (but not \[dq]First\[dq]), because
4109+of the blank space around \[dq]Third\[dq].
4110+Pandoc follows a simple rule: if the text is followed by a blank line,
4111+it is treated as a paragraph.
4112+Since \[dq]Second\[dq] is followed by a list, and not a blank line, it
4113+isn\[aq]t treated as a paragraph.
4114+The fact that the list is followed by a blank line is irrelevant.
4115+(Note: Pandoc works this way even when the \f[C]markdown_strict\f[R]
4116+format is specified.
4117+This behavior is consistent with the official Markdown syntax
4118+description, even though it is different from that of
4119+\f[C]Markdown.pl\f[R].)
4321.SS Ending a list
4120.SS Ending a list
4322.PP
4121.PP
4323What if you want to put an indented code block after a list?
4122What if you want to put an indented code block after a list?
@@ -4335,8 +4134,8 @@ Trouble! Here pandoc (like other Markdown implementations) will treat
4335\f[C]{ my code block }\f[R] as the second paragraph of item two, and not
4134\f[C]{ my code block }\f[R] as the second paragraph of item two, and not
4336as a code block.
4135as a code block.
4337.PP
4136.PP
4338−To \[lq]cut off\[rq] the list after item two, you can insert some
4137+To \[dq]cut off\[dq] the list after item two, you can insert some
4339−non-indented content, like an HTML comment, which won\[cq]t produce
4138+non-indented content, like an HTML comment, which won\[aq]t produce
4340visible output in any format:
4139visible output in any format:
4341.IP
4140.IP
4342.nf
4141.nf
@@ -4532,7 +4331,7 @@ can be omitted for a headerless table.
4532The cells of grid tables may contain arbitrary block elements (multiple
4331The cells of grid tables may contain arbitrary block elements (multiple
4533paragraphs, code blocks, lists, etc.).
4332paragraphs, code blocks, lists, etc.).
4534Cells that span multiple columns or rows are not supported.
4333Cells that span multiple columns or rows are not supported.
4535−Grid tables can be created easily using Emacs\[cq] table-mode
4334+Grid tables can be created easily using Emacs\[aq] table-mode
4536(\f[C]M-x table-insert\f[R]).
4335(\f[C]M-x table-insert\f[R]).
4537.PP
4336.PP
4538Alignments can be specified as with pipe tables, by putting colons at
4337Alignments can be specified as with pipe tables, by putting colons at
@@ -4605,7 +4404,7 @@ orange|3.09
4605.PP
4404.PP
4606The cells of pipe tables cannot contain block elements like paragraphs
4405The cells of pipe tables cannot contain block elements like paragraphs
4607and lists, and cannot span multiple lines.
4406and lists, and cannot span multiple lines.
4608−If a pipe table contains a row whose Markdown content is wider than the
4407+If a pipe table contains a row whose printable content is wider than the
4609column width (see \f[C]--columns\f[R]), then the table will take up the
4408column width (see \f[C]--columns\f[R]), then the table will take up the
4610full text width and the cell contents will wrap, with the relative cell
4409full text width and the cell contents will wrap, with the relative cell
4611widths determined by the number of dashes in the line separating the
4410widths determined by the number of dashes in the line separating the
@@ -4616,7 +4415,7 @@ lines are wider than column width, then cell contents will not be
4616wrapped, and the cells will be sized to their contents.
4415wrapped, and the cells will be sized to their contents.
4617.PP
4416.PP
4618Note: pandoc also recognizes pipe tables of the following form, as can
4417Note: pandoc also recognizes pipe tables of the following form, as can
4619−be produced by Emacs\[cq] orgtbl-mode:
4418+be produced by Emacs\[aq] orgtbl-mode:
4620.IP
4419.IP
4621.nf
4420.nf
4622\f[C]
4421\f[C]
@@ -4629,7 +4428,7 @@ be produced by Emacs\[cq] orgtbl-mode:
4629.PP
4428.PP
4630The difference is that \f[C]+\f[R] is used instead of \f[C]|\f[R].
4429The difference is that \f[C]+\f[R] is used instead of \f[C]|\f[R].
4631Other orgtbl features are not supported.
4430Other orgtbl features are not supported.
4632−In particular, to get non-default column alignment, you\[cq]ll need to
4431+In particular, to get non-default column alignment, you\[aq]ll need to
4633add colons as above.
4432add colons as above.
4634.SS Metadata blocks
4433.SS Metadata blocks
4635.SS Extension: \f[C]pandoc_title_block\f[R]
4434.SS Extension: \f[C]pandoc_title_block\f[R]
@@ -4655,11 +4454,7 @@ no author, you need a blank line:
4655\f[C]
4454\f[C]
4656%
4455%
4657% Author
4456% Author
4658−\f[R]
4457+
4659−.fi
4660−.IP
4661−.nf
4662−\f[C]
4663% My title
4458% My title
4664%
4459%
4665% June 15, 2006
4460% June 15, 2006
@@ -4684,17 +4479,9 @@ So, all of the following are equivalent:
4684\f[C]
4479\f[C]
4685% Author One
4480% Author One
4686 Author Two
4481 Author Two
4687−\f[R]
4482+
4688−.fi
4689−.IP
4690−.nf
4691−\f[C]
4692% Author One; Author Two
4483% Author One; Author Two
4693−\f[R]
4484+
4694−.fi
4695−.IP
4696−.nf
4697−\f[C]
4698% Author One;
4485% Author One;
4699 Author Two
4486 Author Two
4700\f[R]
4487\f[R]
@@ -4707,13 +4494,13 @@ All three metadata fields may contain standard inline formatting
4707.PP
4494.PP
4708Title blocks will always be parsed, but they will affect the output only
4495Title blocks will always be parsed, but they will affect the output only
4709when the \f[C]--standalone\f[R] (\f[C]-s\f[R]) option is chosen.
4496when the \f[C]--standalone\f[R] (\f[C]-s\f[R]) option is chosen.
4710−In HTML output, titles will appear twice: once in the document head
4497+In HTML output, titles will appear twice: once in the document head --
4711−\[en] this is the title that will appear at the top of the window in a
4498+this is the title that will appear at the top of the window in a browser
4712−browser \[en] and once at the beginning of the document body.
4499+-- and once at the beginning of the document body.
4713The title in the document head can have an optional prefix attached
4500The title in the document head can have an optional prefix attached
4714(\f[C]--title-prefix\f[R] or \f[C]-T\f[R] option).
4501(\f[C]--title-prefix\f[R] or \f[C]-T\f[R] option).
4715The title in the body appears as an H1 element with class
4502The title in the body appears as an H1 element with class
4716−\[lq]title\[rq], so it can be suppressed or reformatted with CSS.
4503+\[dq]title\[dq], so it can be suppressed or reformatted with CSS.
4717If a title prefix is specified with \f[C]-T\f[R] and no title block
4504If a title prefix is specified with \f[C]-T\f[R] and no title block
4718appears in the document, the title prefix will be used by itself as the
4505appears in the document, the title prefix will be used by itself as the
4719HTML title.
4506HTML title.
@@ -4742,7 +4529,7 @@ will yield a man page with the title \f[C]PANDOC\f[R] and section 1.
4742\f[R]
4529\f[R]
4743.fi
4530.fi
4744.PP
4531.PP
4745−will also have \[lq]Pandoc User Manuals\[rq] in the footer.
4532+will also have \[dq]Pandoc User Manuals\[dq] in the footer.
4746.IP
4533.IP
4747.nf
4534.nf
4748\f[C]
4535\f[C]
@@ -4750,7 +4537,7 @@ will also have \[lq]Pandoc User Manuals\[rq] in the footer.
4750\f[R]
4537\f[R]
4751.fi
4538.fi
4752.PP
4539.PP
4753−will also have \[lq]Version 4.0\[rq] in the header.
4540+will also have \[dq]Version 4.0\[dq] in the header.
4754.SS Extension: \f[C]yaml_metadata_block\f[R]
4541.SS Extension: \f[C]yaml_metadata_block\f[R]
4755.PP
4542.PP
4756A YAML metadata block is a valid YAML object, delimited by a line of
4543A YAML metadata block is a valid YAML object, delimited by a line of
@@ -4796,9 +4583,7 @@ All of the metadata will appear in a single block at the beginning of
4796the document.
4583the document.
4797.PP
4584.PP
4798Note that YAML escaping rules must be followed.
4585Note that YAML escaping rules must be followed.
4799−Thus, for example, if a title contains a colon, it must be quoted, and
4586+Thus, for example, if a title contains a colon, it must be quoted.
4800−if it contains a backslash escape, then it must be ensured that it is
4801−not treated as a YAML escape sequence.
4802The pipe character (\f[C]|\f[R]) can be used to begin an indented block
4587The pipe character (\f[C]|\f[R]) can be used to begin an indented block
4803that will be interpreted literally, without need for escaping.
4588that will be interpreted literally, without need for escaping.
4804This form is necessary when the field contains blank lines or
4589This form is necessary when the field contains blank lines or
@@ -4820,13 +4605,6 @@ abstract: |
4820\f[R]
4605\f[R]
4821.fi
4606.fi
4822.PP
4607.PP
4823−The literal block after the \f[C]|\f[R] must be indented relative to the
4824−line containing the \f[C]|\f[R].
4825−If it is not, the YAML will be invalid and pandoc will not interpret it
4826−as metadata.
4827−For an overview of the complex rules governing YAML, see the Wikipedia
4828−entry on YAML syntax.
4829−.PP
4830Template variables will be set automatically from the metadata.
4608Template variables will be set automatically from the metadata.
4831Thus, for example, in writing HTML, the variable \f[C]abstract\f[R] will
4609Thus, for example, in writing HTML, the variable \f[C]abstract\f[R] will
4832be set to the HTML equivalent of the Markdown in the \f[C]abstract\f[R]
4610be set to the HTML equivalent of the Markdown in the \f[C]abstract\f[R]
@@ -4875,7 +4653,7 @@ $endfor$
4875\f[R]
4653\f[R]
4876.fi
4654.fi
4877.PP
4655.PP
4878−Raw content to include in the document\[cq]s header may be specified
4656+Raw content to include in the document\[aq]s header may be specified
4879using \f[C]header-includes\f[R]; however, it is important to mark up
4657using \f[C]header-includes\f[R]; however, it is important to mark up
4880this content as raw code for a particular output format, using the
4658this content as raw code for a particular output format, using the
4881\f[C]raw_attribute\f[R] extension), or it will be interpreted as
4659\f[C]raw_attribute\f[R] extension), or it will be interpreted as
@@ -4892,21 +4670,6 @@ header-includes:
4892 \[ga]\[ga]\[ga]
4670 \[ga]\[ga]\[ga]
4893\f[R]
4671\f[R]
4894.fi
4672.fi
4895−.PP
4896−Note: the \f[C]yaml_metadata_block\f[R] extension works with
4897−\f[C]commonmark\f[R] as well as \f[C]markdown\f[R] (and it is enabled by
4898−default in \f[C]gfm\f[R] and \f[C]commonmark_x\f[R]).
4899−However, in these formats the following restrictions apply:
4900−.IP \[bu] 2
4901−The YAML metadata block must occur at the beginning of the document (and
4902−there can be only one).
4903−If multiple files are given as arguments to pandoc, only the first can
4904−be a YAML metadata block.
4905−.IP \[bu] 2
4906−The leaf nodes of the YAML structure are parsed in isolation from each
4907−other and from the rest of the document.
4908−So, for example, you can\[cq]t use a reference link in these contexts if
4909−the link definition is somewhere else in the document.
4910.SS Backslash escapes
4673.SS Backslash escapes
4911.SS Extension: \f[C]all_symbols_escapable\f[R]
4674.SS Extension: \f[C]all_symbols_escapable\f[R]
4912.PP
4675.PP
@@ -4937,7 +4700,7 @@ instead of
4937\f[R]
4700\f[R]
4938.fi
4701.fi
4939.PP
4702.PP
4940−This rule is easier to remember than standard Markdown\[cq]s rule, which
4703+This rule is easier to remember than standard Markdown\[aq]s rule, which
4941allows only the following characters to be backslash-escaped:
4704allows only the following characters to be backslash-escaped:
4942.IP
4705.IP
4943.nf
4706.nf
@@ -4953,15 +4716,16 @@ A backslash-escaped space is parsed as a nonbreaking space.
4953In TeX output, it will appear as \f[C]\[ti]\f[R].
4716In TeX output, it will appear as \f[C]\[ti]\f[R].
4954In HTML and XML output, it will appear as a literal unicode nonbreaking
4717In HTML and XML output, it will appear as a literal unicode nonbreaking
4955space character (note that it will thus actually look
4718space character (note that it will thus actually look
4956−\[lq]invisible\[rq] in the generated HTML source; you can still use the
4719+\[dq]invisible\[dq] in the generated HTML source; you can still use the
4957\f[C]--ascii\f[R] command-line option to make it appear as an explicit
4720\f[C]--ascii\f[R] command-line option to make it appear as an explicit
4958entity).
4721entity).
4959.PP
4722.PP
4960−A backslash-escaped newline (i.e.\ a backslash occurring at the end of a
4723+A backslash-escaped newline (i.e.
4961−line) is parsed as a hard line break.
4724+a backslash occurring at the end of a line) is parsed as a hard line
4725+break.
4962It will appear in TeX output as \f[C]\[rs]\[rs]\f[R] and in HTML as
4726It will appear in TeX output as \f[C]\[rs]\[rs]\f[R] and in HTML as
4963\f[C]<br />\f[R].
4727\f[C]<br />\f[R].
4964−This is a nice alternative to Markdown\[cq]s \[lq]invisible\[rq] way of
4728+This is a nice alternative to Markdown\[aq]s \[dq]invisible\[dq] way of
4965indicating hard line breaks using two trailing spaces on a line.
4729indicating hard line breaks using two trailing spaces on a line.
4966.PP
4730.PP
4967Backslash escapes do not work in verbatim contexts.
4731Backslash escapes do not work in verbatim contexts.
@@ -5038,8 +4802,8 @@ If the superscripted or subscripted text contains spaces, these spaces
5038must be escaped with backslashes.
4802must be escaped with backslashes.
5039(This is to prevent accidental superscripting and subscripting through
4803(This is to prevent accidental superscripting and subscripting through
5040the ordinary use of \f[C]\[ti]\f[R] and \f[C]\[ha]\f[R], and also bad
4804the ordinary use of \f[C]\[ti]\f[R] and \f[C]\[ha]\f[R], and also bad
5041−interactions with footnotes.) Thus, if you want the letter P with `a
4805+interactions with footnotes.) Thus, if you want the letter P with \[aq]a
5042−cat' in subscripts, use \f[C]P\[ti]a\[rs] cat\[ti]\f[R], not
4806+cat\[aq] in subscripts, use \f[C]P\[ti]a\[rs] cat\[ti]\f[R], not
5043\f[C]P\[ti]a cat\[ti]\f[R].
4807\f[C]P\[ti]a cat\[ti]\f[R].
5044.SS Verbatim
4808.SS Verbatim
5045.PP
4809.PP
@@ -5119,16 +4883,14 @@ The opening \f[C]$\f[R] must have a non-space character immediately to
5119its right, while the closing \f[C]$\f[R] must have a non-space character
4883its right, while the closing \f[C]$\f[R] must have a non-space character
5120immediately to its left, and must not be followed immediately by a
4884immediately to its left, and must not be followed immediately by a
5121digit.
4885digit.
5122−Thus, \f[C]$20,000 and $30,000\f[R] won\[cq]t parse as math.
4886+Thus, \f[C]$20,000 and $30,000\f[R] won\[aq]t parse as math.
5123If for some reason you need to enclose text in literal \f[C]$\f[R]
4887If for some reason you need to enclose text in literal \f[C]$\f[R]
5124−characters, backslash-escape them and they won\[cq]t be treated as math
4888+characters, backslash-escape them and they won\[aq]t be treated as math
5125delimiters.
4889delimiters.
5126.PP
4890.PP
5127For display math, use \f[C]$$\f[R] delimiters.
4891For display math, use \f[C]$$\f[R] delimiters.
5128(In this case, the delimiters may be separated from the formula by
4892(In this case, the delimiters may be separated from the formula by
5129−whitespace.
4893+whitespace.)
5130−However, there can be no blank lines betwen the opening and closing
5131−\f[C]$$\f[R] delimiters.)
5132.PP
4894.PP
5133TeX math will be printed in all output formats.
4895TeX math will be printed in all output formats.
5134How it is rendered depends on the output format:
4896How it is rendered depends on the output format:
@@ -5159,7 +4921,7 @@ Texinfo
5159It will be rendered inside a \f[C]\[at]math\f[R] command.
4921It will be rendered inside a \f[C]\[at]math\f[R] command.
5160.TP
4922.TP
5161roff man, Jira markup
4923roff man, Jira markup
5162−It will be rendered verbatim without \f[C]$\f[R]\[cq]s.
4924+It will be rendered verbatim without \f[C]$\f[R]\[aq]s.
5163.TP
4925.TP
5164MediaWiki, DokuWiki
4926MediaWiki, DokuWiki
5165It will be rendered inside \f[C]<math>\f[R] tags.
4927It will be rendered inside \f[C]<math>\f[R] tags.
@@ -5217,7 +4979,7 @@ Note that even if \f[C]raw_html\f[R] is disabled, tables will be
5217rendered with HTML syntax if they cannot use pipe syntax.
4979rendered with HTML syntax if they cannot use pipe syntax.
5218.SS Extension: \f[C]markdown_in_html_blocks\f[R]
4980.SS Extension: \f[C]markdown_in_html_blocks\f[R]
5219.PP
4981.PP
5220−Standard Markdown allows you to include HTML \[lq]blocks\[rq]: blocks of
4982+Standard Markdown allows you to include HTML \[dq]blocks\[dq]: blocks of
5221HTML between balanced tags that are separated from the surrounding text
4983HTML between balanced tags that are separated from the surrounding text
5222with blank lines, and start and end at the left margin.
4984with blank lines, and start and end at the left margin.
5223Within these blocks, everything is interpreted as HTML, not Markdown; so
4985Within these blocks, everything is interpreted as HTML, not Markdown; so
@@ -5254,9 +5016,8 @@ into
5254.PP
5016.PP
5255whereas \f[C]Markdown.pl\f[R] will preserve it as is.
5017whereas \f[C]Markdown.pl\f[R] will preserve it as is.
5256.PP
5018.PP
5257−There is one exception to this rule: text between \f[C]<script>\f[R],
5019+There is one exception to this rule: text between \f[C]<script>\f[R] and
5258−\f[C]<style>\f[R], and \f[C]<textarea>\f[R] tags is not interpreted as
5020+\f[C]<style>\f[R] tags is not interpreted as Markdown.
5259−Markdown.
5260.PP
5021.PP
5261This departure from standard Markdown should make it easier to mix
5022This departure from standard Markdown should make it easier to mix
5262Markdown with HTML block elements.
5023Markdown with HTML block elements.
@@ -5556,7 +5317,7 @@ slide shows and EPUB), LaTeX, and ConTeXt.
5556.PP
5317.PP
5557A link immediately preceded by a \f[C]!\f[R] will be treated as an
5318A link immediately preceded by a \f[C]!\f[R] will be treated as an
5558image.
5319image.
5559−The link text will be used as the image\[cq]s alt text:
5320+The link text will be used as the image\[aq]s alt text:
5560.IP
5321.IP
5561.nf
5322.nf
5562\f[C]
5323\f[C]
@@ -5571,7 +5332,7 @@ The link text will be used as the image\[cq]s alt text:
5571.PP
5332.PP
5572An image with nonempty alt text, occurring by itself in a paragraph,
5333An image with nonempty alt text, occurring by itself in a paragraph,
5573will be rendered as a figure with a caption.
5334will be rendered as a figure with a caption.
5574−The image\[cq]s alt text will be used as the caption.
5335+The image\[aq]s alt text will be used as the caption.
5575.IP
5336.IP
5576.nf
5337.nf
5577\f[C]
5338\f[C]
@@ -5580,8 +5341,9 @@ The image\[cq]s alt text will be used as the caption.
5580.fi
5341.fi
5581.PP
5342.PP
5582How this is rendered depends on the output format.
5343How this is rendered depends on the output format.
5344+Some output formats (e.g.
5583−Some output formats (e.g.\ RTF) do not yet support figures.
5345+RTF) do not yet support figures.
5584−In those formats, you\[cq]ll just get an image in a paragraph by itself,
5346+In those formats, you\[aq]ll just get an image in a paragraph by itself,
5585with no caption.
5347with no caption.
5586.PP
5348.PP
5587If you just want a regular inline image, just make sure it is not the
5349If you just want a regular inline image, just make sure it is not the
@@ -5636,12 +5398,11 @@ For example:
5636\f[R]
5398\f[R]
5637.fi
5399.fi
5638.IP \[bu] 2
5400.IP \[bu] 2
5639−Dimensions may be converted to a form that is compatible with the output
5401+Dimensions are converted to inches for output in page-based formats like
5640−format (for example, dimensions given in pixels will be converted to
5402+LaTeX.
5641−inches when converting HTML to LaTeX).
5403+Dimensions are converted to pixels for output in HTML-like formats.
5642−Conversion between pixels and physical measurements is affected by the
5404+Use the \f[C]--dpi\f[R] option to specify the number of pixels per inch.
5643−\f[C]--dpi\f[R] option (by default, 96 dpi is assumed, unless the image
5405+The default is 96dpi.
5644−itself contains dpi information).
5645.IP \[bu] 2
5406.IP \[bu] 2
5646The \f[C]%\f[R] unit is generally relative to some available space.
5407The \f[C]%\f[R] unit is generally relative to some available space.
5647For example the above example will render to the following.
5408For example the above example will render to the following.
@@ -5652,7 +5413,7 @@ HTML:
5652.IP \[bu] 2
5413.IP \[bu] 2
5653LaTeX:
5414LaTeX:
5654\f[C]\[rs]includegraphics[width=0.5\[rs]textwidth,height=\[rs]textheight]{file.jpg}\f[R]
5415\f[C]\[rs]includegraphics[width=0.5\[rs]textwidth,height=\[rs]textheight]{file.jpg}\f[R]
5655−(If you\[cq]re using a custom template, you need to configure
5416+(If you\[aq]re using a custom template, you need to configure
5656\f[C]graphicx\f[R] as in the default template.)
5417\f[C]graphicx\f[R] as in the default template.)
5657.IP \[bu] 2
5418.IP \[bu] 2
5658ConTeXt:
5419ConTeXt:
@@ -5735,7 +5496,7 @@ immediately by attributes:
5735.SS Footnotes
5496.SS Footnotes
5736.SS Extension: \f[C]footnotes\f[R]
5497.SS Extension: \f[C]footnotes\f[R]
5737.PP
5498.PP
5738−Pandoc\[cq]s Markdown allows footnotes, using the following syntax:
5499+Pandoc\[aq]s Markdown allows footnotes, using the following syntax:
5739.IP
5500.IP
5740.nf
5501.nf
5741\f[C]
5502\f[C]
@@ -5784,82 +5545,207 @@ note.]
5784.fi
5545.fi
5785.PP
5546.PP
5786Inline and regular footnotes may be mixed freely.
5547Inline and regular footnotes may be mixed freely.
5787−.SS Citation syntax
5548+.SS Citations
5788.SS Extension: \f[C]citations\f[R]
5549.SS Extension: \f[C]citations\f[R]
5789.PP
5550.PP
5790−To cite a bibliographic item with an identifier foo, use the syntax
5551+Using an external filter, \f[C]pandoc-citeproc\f[R], pandoc can
5791−\f[C]\[at]foo\f[R].
5552+automatically generate citations and a bibliography in a number of
5792−Normal citations should be included in square brackets, with semicolons
5553+styles.
5793−separating distinct items:
5554+Basic usage is
5794−.IP
5795−.nf
5796−\f[C]
5797−Blah blah [\[at]doe99; \[at]smith2000; \[at]smith2004].
5798−\f[R]
5799−.fi
5800−.PP
5801−How this is rendered depends on the citation style.
5802−In an author-date style, it might render as
5803−.IP
5804−.nf
5805−\f[C]
5806−Blah blah (Doe 1999, Smith 2000, 2004).
5807−\f[R]
5808−.fi
5809−.PP
5810−In a footnote style, it might render as
5811.IP
5555.IP
5812.nf
5556.nf
5813\f[C]
5557\f[C]
5814−Blah blah.[\[ha]1]
5558+pandoc --filter pandoc-citeproc myinput.txt
5815−
5816−[\[ha]1]: John Doe, \[dq]Frogs,\[dq] *Journal of Amphibians* 44 (1999);
5817−Susan Smith, \[dq]Flies,\[dq] *Journal of Insects* (2000);
5818−Susan Smith, \[dq]Bees,\[dq] *Journal of Insects* (2004).
5819\f[R]
5559\f[R]
5820.fi
5560.fi
5821.PP
5561.PP
5822−See the CSL user documentation for more information about CSL styles and
5562+In order to use this feature, you will need to specify a bibliography
5823−how they affect rendering.
5563+file using the \f[C]bibliography\f[R] metadata field in a YAML metadata
5564+section, or \f[C]--bibliography\f[R] command line argument.
5565+You can supply multiple \f[C]--bibliography\f[R] arguments or set
5566+\f[C]bibliography\f[R] metadata field to YAML array, if you want to use
5567+multiple bibliography files.
5568+The bibliography may have any of these formats:
5824.PP
5569.PP
5825−Unless a citation key start with a letter, digit, or \f[C]_\f[R], and
5570+.TS
5826−contains only alphanumerics and internal punctuation characters
5571+tab(@);
5827−(\f[C]:.#$%&-+?<>\[ti]/\f[R]), it must be surrounded by curly braces,
5572+l l.
5828−which are not considered part of the key.
5573+T{
5829−In \f[C]\[at]Foo_bar.baz.\f[R], the key is \f[C]Foo_bar.baz\f[R].
5574+Format
5830−The final period is not \f[I]internal\f[R] punctuation, so it is not
5575+T}@T{
5831−included in the key.
5576+File extension
5832−In \f[C]\[at]{Foo_bar.baz.}\f[R], the key is \f[C]Foo_bar.baz.\f[R],
5577+T}
5833−including the final period.
5578+_
5834−The curly braces are recommended if you use URLs as keys:
5579+T{
5835−\f[C][\[at]{https://example.com/bib?name=foobar&date=2000}, p. 33]\f[R].
5580+BibLaTeX
5581+T}@T{
5582+\&.bib
5583+T}
5584+T{
5585+BibTeX
5586+T}@T{
5587+\&.bibtex
5588+T}
5589+T{
5590+Copac
5591+T}@T{
5592+\&.copac
5593+T}
5594+T{
5595+CSL JSON
5596+T}@T{
5597+\&.json
5598+T}
5599+T{
5600+CSL YAML
5601+T}@T{
5602+\&.yaml
5603+T}
5604+T{
5605+EndNote
5606+T}@T{
5607+\&.enl
5608+T}
5609+T{
5610+EndNote XML
5611+T}@T{
5612+\&.xml
5613+T}
5614+T{
5615+ISI
5616+T}@T{
5617+\&.wos
5618+T}
5619+T{
5620+MEDLINE
5621+T}@T{
5622+\&.medline
5623+T}
5624+T{
5625+MODS
5626+T}@T{
5627+\&.mods
5628+T}
5629+T{
5630+RIS
5631+T}@T{
5632+\&.ris
5633+T}
5634+.TE
5836.PP
5635.PP
5837−Citation items may optionally include a prefix, a locator, and a suffix.
5636+Note that \f[C].bib\f[R] can be used with both BibTeX and BibLaTeX
5838−In
5637+files; use \f[C].bibtex\f[R] to force BibTeX.
5839−.IP
5840−.nf
5841−\f[C]
5842−Blah blah [see \[at]doe99, pp. 33-35 and *passim*; \[at]smith04, chap. 1].
5843−\f[R]
5844−.fi
5845.PP
5638.PP
5846−The first item (\f[C]doe99\f[R]) has prefix \f[C]see\f[R], locator
5639+Note that \f[C]pandoc-citeproc --bib2json\f[R] and
5847−\f[C]pp. 33-35\f[R], and suffix \f[C]and *passim*\f[R].
5640+\f[C]pandoc-citeproc --bib2yaml\f[R] can produce \f[C].json\f[R] and
5848−The second item (\f[C]smith04\f[R]) has locator \f[C]chap. 1\f[R] and no
5641+\f[C].yaml\f[R] files from any of the supported formats.
5849−prefix or suffix.
5850.PP
5642.PP
5851−Pandoc uses some heuristics to separate the locator from the rest of the
5643+In-field markup: In BibTeX and BibLaTeX databases, pandoc-citeproc
5852−subject.
5644+parses a subset of LaTeX markup; in CSL YAML databases, pandoc Markdown;
5645+and in CSL JSON databases, an HTML-like markup:
5646+.TP
5647+\f[B]\f[CB]<i>...</i>\f[B]\f[R]
5648+italics
5649+.TP
5650+\f[B]\f[CB]<b>...</b>\f[B]\f[R]
5651+bold
5652+.TP
5653+\f[B]\f[CB]<span style=\[dq]font-variant:small-caps;\[dq]>...</span>\f[B]\f[R] or \f[B]\f[CB]<sc>...</sc>\f[B]\f[R]
5654+small capitals
5655+.TP
5656+\f[B]\f[CB]<sub>...</sub>\f[B]\f[R]
5657+subscript
5658+.TP
5659+\f[B]\f[CB]<sup>...</sup>\f[B]\f[R]
5660+superscript
5661+.TP
5662+\f[B]\f[CB]<span class=\[dq]nocase\[dq]>...</span>\f[B]\f[R]
5663+prevent a phrase from being capitalized as title case
5664+.PP
5665+\f[C]pandoc-citeproc -j\f[R] and \f[C]-y\f[R] interconvert the CSL JSON
5666+and CSL YAML formats as far as possible.
5667+.PP
5668+As an alternative to specifying a bibliography file using
5669+\f[C]--bibliography\f[R] or the YAML metadata field
5670+\f[C]bibliography\f[R], you can include the citation data directly in
5671+the \f[C]references\f[R] field of the document\[aq]s YAML metadata.
5672+The field should contain an array of YAML-encoded references, for
5673+example:
5674+.IP
5675+.nf
5676+\f[C]
5677+---
5678+references:
5679+- type: article-journal
5680+ id: WatsonCrick1953
5681+ author:
5682+ - family: Watson
5683+ given: J. D.
5684+ - family: Crick
5685+ given: F. H. C.
5686+ issued:
5687+ date-parts:
5688+ - - 1953
5689+ - 4
5690+ - 25
5691+ title: \[aq]Molecular structure of nucleic acids: a structure for deoxyribose
5692+ nucleic acid\[aq]
5693+ title-short: Molecular structure of nucleic acids
5694+ container-title: Nature
5695+ volume: 171
5696+ issue: 4356
5697+ page: 737-738
5698+ DOI: 10.1038/171737a0
5699+ URL: https://www.nature.com/articles/171737a0
5700+ language: en-GB
5701+\&...
5702+\f[R]
5703+.fi
5704+.PP
5705+(\f[C]pandoc-citeproc --bib2yaml\f[R] can produce these from a
5706+bibliography file in one of the supported formats.)
5707+.PP
5708+Citations and references can be formatted using any style supported by
5709+the Citation Style Language, listed in the Zotero Style Repository.
5710+These files are specified using the \f[C]--csl\f[R] option or the
5711+\f[C]csl\f[R] metadata field.
5712+By default, \f[C]pandoc-citeproc\f[R] will use the Chicago Manual of
5713+Style author-date format.
5714+The CSL project provides further information on finding and editing
5715+styles.
5716+.PP
5717+To make your citations hyperlinks to the corresponding bibliography
5718+entries, add \f[C]link-citations: true\f[R] to your YAML metadata.
5719+.PP
5720+Citations go inside square brackets and are separated by semicolons.
5721+Each citation must have a key, composed of \[aq]\[at]\[aq] + the
5722+citation identifier from the database, and may optionally have a prefix,
5723+a locator, and a suffix.
5724+The citation key must begin with a letter, digit, or \f[C]_\f[R], and
5725+may contain alphanumerics, \f[C]_\f[R], and internal punctuation
5726+characters (\f[C]:.#$%&-+?<>\[ti]/\f[R]).
5727+Here are some examples:
5728+.IP
5729+.nf
5730+\f[C]
5731+Blah blah [see \[at]doe99, pp. 33-35; also \[at]smith04, chap. 1].
5732+
5733+Blah blah [\[at]doe99, pp. 33-35, 38-39 and *passim*].
5734+
5735+Blah blah [\[at]smith04; \[at]doe99].
5736+\f[R]
5737+.fi
5738+.PP
5853−It is sensitive to the locator terms defined in the CSL locale files.
5739+\f[C]pandoc-citeproc\f[R] detects locator terms in the CSL locale files.
5854−Either abbreviated or unabbreviated forms are accepted.
5740+Either abbreviated or unabbreviated forms are accepted.
5855−In the \f[C]en-US\f[R] locale, locator terms can be written in either
5741+In the \f[C]en-US\f[R] locale, locator terms can be written in either
5856−singular or plural forms, as \f[C]book\f[R],
5742+singular or plural forms, as \f[C]book\f[R],
5857−\f[C]bk.\f[R]/\f[C]bks.\f[R]; \f[C]chapter\f[R],
5743+\f[C]bk.\f[R]/\f[C]bks.\f[R]; \f[C]chapter\f[R],
5858−\f[C]chap.\f[R]/\f[C]chaps.\f[R]; \f[C]column\f[R],
5744+\f[C]chap.\f[R]/\f[C]chaps.\f[R]; \f[C]column\f[R],
5859−\f[C]col.\f[R]/\f[C]cols.\f[R]; \f[C]figure\f[R],
5745+\f[C]col.\f[R]/\f[C]cols.\f[R]; \f[C]figure\f[R],
5860−\f[C]fig.\f[R]/\f[C]figs.\f[R]; \f[C]folio\f[R],
5746+\f[C]fig.\f[R]/\f[C]figs.\f[R]; \f[C]folio\f[R],
5861−\f[C]fol.\f[R]/\f[C]fols.\f[R]; \f[C]number\f[R],
5747+\f[C]fol.\f[R]/\f[C]fols.\f[R]; \f[C]number\f[R],
5862−\f[C]no.\f[R]/\f[C]nos.\f[R]; \f[C]line\f[R],
5748+\f[C]no.\f[R]/\f[C]nos.\f[R]; \f[C]line\f[R],
5863\f[C]l.\f[R]/\f[C]ll.\f[R]; \f[C]note\f[R], \f[C]n.\f[R]/\f[C]nn.\f[R];
5749\f[C]l.\f[R]/\f[C]ll.\f[R]; \f[C]note\f[R], \f[C]n.\f[R]/\f[C]nn.\f[R];
5864\f[C]opus\f[R], \f[C]op.\f[R]/\f[C]opp.\f[R]; \f[C]page\f[R],
5750\f[C]opus\f[R], \f[C]op.\f[R]/\f[C]opp.\f[R]; \f[C]page\f[R],
5865\f[C]p.\f[R]/\f[C]pp.\f[R]; \f[C]paragraph\f[R],
5751\f[C]p.\f[R]/\f[C]pp.\f[R]; \f[C]paragraph\f[R],
@@ -5870,17 +5756,17 @@ singular or plural forms, as \f[C]book\f[R],
5870\f[C]v.\f[R]/\f[C]vv.\f[R]; \f[C]volume\f[R],
5756\f[C]v.\f[R]/\f[C]vv.\f[R]; \f[C]volume\f[R],
5871\f[C]vol.\f[R]/\f[C]vols.\f[R]; \f[C]\[ps]\f[R]/\f[C]\[ps]\[ps]\f[R];
5757\f[C]vol.\f[R]/\f[C]vols.\f[R]; \f[C]\[ps]\f[R]/\f[C]\[ps]\[ps]\f[R];
5872\f[C]\[sc]\f[R]/\f[C]\[sc]\[sc]\f[R].
5758\f[C]\[sc]\f[R]/\f[C]\[sc]\[sc]\f[R].
5873−If no locator term is used, \[lq]page\[rq] is assumed.
5759+If no locator term is used, \[dq]page\[dq] is assumed.
5874.PP
5760.PP
5875−In complex cases, you can force something to be treated as a locator by
5761+\f[C]pandoc-citeproc\f[R] will use heuristics to distinguish the locator
5876−enclosing it in curly braces or prevent parsing the suffix as locator by
5762+from the suffix.
5877−prepending curly braces:
5763+In complex cases, the locator can be enclosed in curly braces (using
5764+\f[C]pandoc-citeproc\f[R] 0.15 and higher only):
5878.IP
5765.IP
5879.nf
5766.nf
5880\f[C]
5767\f[C]
5881[\[at]smith{ii, A, D-Z}, with a suffix]
5768[\[at]smith{ii, A, D-Z}, with a suffix]
5882[\[at]smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
5769[\[at]smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
5883−[\[at]smith{}, 99 years later]
5884\f[R]
5770\f[R]
5885.fi
5771.fi
5886.PP
5772.PP
@@ -5894,8 +5780,7 @@ Smith says blah [-\[at]smith04].
5894\f[R]
5780\f[R]
5895.fi
5781.fi
5896.PP
5782.PP
5897−You can also write an author-in-text citation, by omitting the square
5783+You can also write an in-text citation, as follows:
5898−brackets:
5899.IP
5784.IP
5900.nf
5785.nf
5901\f[C]
5786\f[C]
@@ -5905,96 +5790,84 @@ brackets:
5905\f[R]
5790\f[R]
5906.fi
5791.fi
5907.PP
5792.PP
5908−This will cause the author\[cq]s name to be rendered, followed by the
5793+If the style calls for a list of works cited, it will be placed in a div
5909−bibliographical details.
5794+with id \f[C]refs\f[R], if one exists:
5910−Use this form when you want to make the citation the subject of a
5795+.IP
5911−sentence.
5796+.nf
5797+\f[C]
5798+::: {#refs}
5799+:::
5800+\f[R]
5801+.fi
5912.PP
5802.PP
5913−When you are using a note style, it is usually better to let citeproc
5803+Otherwise, it will be placed at the end of the document.
5914−create the footnotes from citations rather than writing an explicit
5804+Generation of the bibliography can be suppressed by setting
5915−note.
5805+\f[C]suppress-bibliography: true\f[R] in the YAML metadata.
5916−If you do write an explicit note that contains a citation, note that
5917−normal citations will be put in parentheses, while author-in-text
5918−citations will not.
5919−For this reason, it is sometimes preferable to use the author-in-text
5920−style inside notes when using a note style.
5921−.SS Non-default extensions
5922.PP
5806.PP
5923−The following Markdown syntax extensions are not enabled by default in
5807+If you wish the bibliography to have a section heading, you can set
5924−pandoc, but may be enabled by adding \f[C]+EXTENSION\f[R] to the format
5808+\f[C]reference-section-title\f[R] in the metadata, or put the heading at
5925−name, where \f[C]EXTENSION\f[R] is the name of the extension.
5809+the beginning of the div with id \f[C]refs\f[R] (if you are using it) or
5926−Thus, for example, \f[C]markdown+hard_line_breaks\f[R] is Markdown with
5810+at the end of your document:
5927−hard line breaks.
5811+.IP
5928−.SS Extension: \f[C]rebase_relative_paths\f[R]
5812+.nf
5813+\f[C]
5814+last paragraph...
5815+
5816+# References
5817+\f[R]
5818+.fi
5929.PP
5819.PP
5930−Rewrite relative paths for Markdown links and images, depending on the
5820+The bibliography will be inserted after this heading.
5931−path of the file containing the link or image link.
5821+Note that the \f[C]unnumbered\f[R] class will be added to this heading,
5932−For each link or image, pandoc will compute the directory of the
5822+so that the section will not be numbered.
5933−containing file, relative to the working directory, and prepend the
5934−resulting path to the link or image path.
5935.PP
5823.PP
5936−The use of this extension is best understood by example.
5824+If you want to include items in the bibliography without actually citing
5937−Suppose you have a a subdirectory for each chapter of a book,
5825+them in the body text, you can define a dummy \f[C]nocite\f[R] metadata
5938−\f[C]chap1\f[R], \f[C]chap2\f[R], \f[C]chap3\f[R].
5826+field and put the citations there:
5939−Each contains a file \f[C]text.md\f[R] and a number of images used in
5940−the chapter.
5941−You would like to have \f[C]![image](spider.jpg)\f[R] in
5942−\f[C]chap1/text.md\f[R] refer to \f[C]chap1/spider.jpg\f[R] and
5943−\f[C]![image](spider.jpg)\f[R] in \f[C]chap2/text.md\f[R] refer to
5944−\f[C]chap2/spider.jpg\f[R].
5945−To do this, use
5946.IP
5827.IP
5947.nf
5828.nf
5948\f[C]
5829\f[C]
5949−pandoc chap*/*.md -f markdown+rebase_relative_paths
5830+---
5831+nocite: |
5832+ \[at]item1, \[at]item2
5833+\&...
5834+
5835+\[at]item3
5950\f[R]
5836\f[R]
5951.fi
5837.fi
5952.PP
5838.PP
5953−Without this extension, you would have to use
5839+In this example, the document will contain a citation for
5954−\f[C]![image](chap1/spider.jpg)\f[R] in \f[C]chap1/text.md\f[R] and
5840+\f[C]item3\f[R] only, but the bibliography will contain entries for
5955−\f[C]![image](chap2/spider.jpg)\f[R] in \f[C]chap2/text.md\f[R].
5841+\f[C]item1\f[R], \f[C]item2\f[R], and \f[C]item3\f[R].
5956−Links with relative paths will be rewritten in the same way as images.
5957.PP
5842.PP
5958−Absolute paths and URLs are not changed.
5843+It is possible to create a bibliography with all the citations, whether
5959−Neither are empty paths or paths consisting entirely of a fragment,
5844+or not they appear in the document, by using a wildcard:
5960−e.g., \f[C]#foo\f[R].
5845+.IP
5846+.nf
5847+\f[C]
5848+---
5849+nocite: |
5850+ \[at]*
5851+\&...
5852+\f[R]
5853+.fi
5961.PP
5854.PP
5962−Note that relative paths in reference links and images will be rewritten
5855+For LaTeX output, you can also use \f[C]natbib\f[R] or
5963−relative to the file containing the link reference definition, not the
5856+\f[C]biblatex\f[R] to render the bibliography.
5964−file containing the reference link or image itself, if these differ.
5857+In order to do so, specify bibliography files as outlined above, and add
5965−.SS Extension: \f[C]attributes\f[R]
5858+\f[C]--natbib\f[R] or \f[C]--biblatex\f[R] argument to \f[C]pandoc\f[R]
5859+invocation.
5860+Bear in mind that bibliography files have to be in respective format
5861+(either BibTeX or BibLaTeX).
5966.PP
5862.PP
5967−Allows attributes to be attached to any inline or block-level element.
5863+For more information, see the pandoc-citeproc man page.
5968−The syntax for the attributes is the same as that used in
5864+.SS Non-pandoc extensions
5969−\f[C]header_attributes\f[R].
5970−.IP \[bu] 2
5971−Attributes that occur immediately after an inline element affect that
5972−element.
5973−If they follow a space, then they belong to the space.
5974−(Hence, this option subsumes \f[C]inline_code_attributes\f[R] and
5975−\f[C]link_attributes\f[R].)
5976−.IP \[bu] 2
5977−Attributes that occur immediately before a block element, on a line by
5978−themselves, affect that element.
5979−.IP \[bu] 2
5980−Consecutive attribute specifiers may be used, either for blocks or for
5981−inlines.
5982−Their attributes will be combined.
5983−.IP \[bu] 2
5984−Attributes that occur at the end of the text of a Setext or ATX heading
5985−(separated by whitespace from the text) affect the heading element.
5986−(Hence, this option subsumes \f[C]header_attributes\f[R].)
5987−.IP \[bu] 2
5988−Attributes that occur after the opening fence in a fenced code block
5989−affect the code block element.
5990−(Hence, this option subsumes \f[C]fenced_code_attributes\f[R].)
5991−.IP \[bu] 2
5992−Attributes that occur at the end of a reference link definition affect
5993−links that refer to that definition.
5994.PP
5865.PP
5995−Note that pandoc\[cq]s AST does not currently allow attributes to be
5866+The following Markdown syntax extensions are not enabled by default in
5996−attached to arbitrary elements.
5867+pandoc, but may be enabled by adding \f[C]+EXTENSION\f[R] to the format
5997−Hence a Span or Div container will be added if needed.
5868+name, where \f[C]EXTENSION\f[R] is the name of the extension.
5869+Thus, for example, \f[C]markdown+hard_line_breaks\f[R] is Markdown with
5870+hard line breaks.
5998.SS Extension: \f[C]old_dashes\f[R]
5871.SS Extension: \f[C]old_dashes\f[R]
5999.PP
5872.PP
6000Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
5873Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
@@ -6006,7 +5879,7 @@ It is selected automatically for \f[C]textile\f[R] input.
6006.PP
5879.PP
6007Allow \f[C]<\f[R] and \f[C]>\f[R] to be backslash-escaped, as they can
5880Allow \f[C]<\f[R] and \f[C]>\f[R] to be backslash-escaped, as they can
6008be in GitHub flavored Markdown but not original Markdown.
5881be in GitHub flavored Markdown but not original Markdown.
6009−This is implied by pandoc\[cq]s default \f[C]all_symbols_escapable\f[R].
5882+This is implied by pandoc\[aq]s default \f[C]all_symbols_escapable\f[R].
6010.SS Extension: \f[C]lists_without_preceding_blankline\f[R]
5883.SS Extension: \f[C]lists_without_preceding_blankline\f[R]
6011.PP
5884.PP
6012Allow a list to occur right after a paragraph, with no intervening blank
5885Allow a list to occur right after a paragraph, with no intervening blank
@@ -6130,7 +6003,7 @@ in several respects:
6130No blank line is required between consecutive items of the definition
6003No blank line is required between consecutive items of the definition
6131list.
6004list.
6132.IP \[bu] 2
6005.IP \[bu] 2
6133−To get a \[lq]tight\[rq] or \[lq]compact\[rq] list, omit space between
6006+To get a \[dq]tight\[dq] or \[dq]compact\[dq] list, omit space between
6134consecutive items; the space between a term and its definition does not
6007consecutive items; the space between a term and its definition does not
6135affect anything.
6008affect anything.
6136.IP \[bu] 2
6009.IP \[bu] 2
@@ -6141,489 +6014,64 @@ be indented four spaces.
6141Use Project Gutenberg conventions for \f[C]plain\f[R] output: all-caps
6014Use Project Gutenberg conventions for \f[C]plain\f[R] output: all-caps
6142for strong emphasis, surround by underscores for regular emphasis, add
6015for strong emphasis, surround by underscores for regular emphasis, add
6143extra blank space around headings.
6016extra blank space around headings.
6144−.SS Extension: \f[C]sourcepos\f[R]
6145−.PP
6146−Include source position attributes when parsing \f[C]commonmark\f[R].
6147−For elements that accept attributes, a \f[C]data-pos\f[R] attribute is
6148−added; other elements are placed in a surrounding Div or Span elemnet
6149−with a \f[C]data-pos\f[R] attribute.
6150.SS Markdown variants
6017.SS Markdown variants
6151.PP
6018.PP
6152−In addition to pandoc\[cq]s extended Markdown, the following Markdown
6019+In addition to pandoc\[aq]s extended Markdown, the following Markdown
6153variants are supported:
6020variants are supported:
6154−.IP \[bu] 2
6155−\f[C]markdown_phpextra\f[R] (PHP Markdown Extra)
6156−.IP \[bu] 2
6157−\f[C]markdown_github\f[R] (deprecated GitHub-Flavored Markdown)
6158−.IP \[bu] 2
6159−\f[C]markdown_mmd\f[R] (MultiMarkdown)
6160−.IP \[bu] 2
6161−\f[C]markdown_strict\f[R] (Markdown.pl)
6162−.IP \[bu] 2
6163−\f[C]commonmark\f[R] (CommonMark)
6164−.IP \[bu] 2
6165−\f[C]gfm\f[R] (Github-Flavored Markdown)
6166−.IP \[bu] 2
6167−\f[C]commonmark_x\f[R] (CommonMark with many pandoc extensions)
6168−.PP
6169−To see which extensions are supported for a given format, and which are
6170−enabled by default, you can use the command
6171−.IP
6172−.nf
6173−\f[C]
6174−pandoc --list-extensions=FORMAT
6175−\f[R]
6176−.fi
6177−.PP
6178−where \f[C]FORMAT\f[R] is replaced with the name of the format.
6179−.PP
6180−Note that the list of extensions for \f[C]commonmark\f[R],
6181−\f[C]gfm\f[R], and \f[C]commonmark_x\f[R] are defined relative to
6182−default commonmark.
6183−So, for example, \f[C]backtick_code_blocks\f[R] does not appear as an
6184−extension, since it is enabled by default and cannot be disabled.
6185−.SH CITATIONS
6186−.PP
6187−When the \f[C]--citeproc\f[R] option is used, pandoc can automatically
6188−generate citations and a bibliography in a number of styles.
6189−Basic usage is
6190−.IP
6191−.nf
6192−\f[C]
6193−pandoc --citeproc myinput.txt
6194−\f[R]
6195−.fi
6196−.PP
6197−To use this feature, you will need to have
6198−.IP \[bu] 2
6199−a document containing citations (see Extension: \f[C]citations\f[R]);
6200−.IP \[bu] 2
6201−a source of bibliographic data: either an external bibliography file or
6202−a list of \f[C]references\f[R] in the document\[cq]s YAML metadata
6203−.IP \[bu] 2
6204−optionally, a CSL citation style.
6205−.SS Specifying bibliographic data
6206−.PP
6207−You can specify an external bibliography using the
6208−\f[C]bibliography\f[R] metadata field in a YAML metadata section or the
6209−\f[C]--bibliography\f[R] command line argument.
6210−If you want to use multiple bibliography files, you can supply multiple
6211−\f[C]--bibliography\f[R] arguments or set \f[C]bibliography\f[R]
6212−metadata field to YAML array.
6213−A bibliography may have any of these formats:
6214−.PP
6215−.TS
6216−tab(@);
6217−l l.
6218−T{
6219−Format
6220−T}@T{
6221−File extension
6222−T}
6223−_
6224−T{
6225−BibLaTeX
6226−T}@T{
6227−\&.bib
6228−T}
6229−T{
6230−BibTeX
6231−T}@T{
6232−\&.bibtex
6233−T}
6234−T{
6235−CSL JSON
6236−T}@T{
6237−\&.json
6238−T}
6239−T{
6240−CSL YAML
6241−T}@T{
6242−\&.yaml
6243−T}
6244−.TE
6245−.PP
6246−Note that \f[C].bib\f[R] can be used with both BibTeX and BibLaTeX
6247−files; use the extension \f[C].bibtex\f[R] to force interpretation as
6248−BibTeX.
6249−.PP
6250−In BibTeX and BibLaTeX databases, pandoc parses LaTeX markup inside
6251−fields such as \f[C]title\f[R]; in CSL YAML databases, pandoc Markdown;
6252−and in CSL JSON databases, an HTML-like markup:
6253−.TP
6254−\f[B]\f[CB]<i>...</i>\f[B]\f[R]
6255−italics
6256−.TP
6257−\f[B]\f[CB]<b>...</b>\f[B]\f[R]
6258−bold
6259−.TP
6260−\f[B]\f[CB]<span style=\[dq]font-variant:small-caps;\[dq]>...</span>\f[B]\f[R] or \f[B]\f[CB]<sc>...</sc>\f[B]\f[R]
6261−small capitals
6262−.TP
6263−\f[B]\f[CB]<sub>...</sub>\f[B]\f[R]
6264−subscript
6265−.TP
6266−\f[B]\f[CB]<sup>...</sup>\f[B]\f[R]
6267−superscript
6268−.TP
6269−\f[B]\f[CB]<span class=\[dq]nocase\[dq]>...</span>\f[B]\f[R]
6270−prevent a phrase from being capitalized as title case
6271−.PP
6272−As an alternative to specifying a bibliography file using
6273−\f[C]--bibliography\f[R] or the YAML metadata field
6274−\f[C]bibliography\f[R], you can include the citation data directly in
6275−the \f[C]references\f[R] field of the document\[cq]s YAML metadata.
6276−The field should contain an array of YAML-encoded references, for
6277−example:
6278−.IP
6279−.nf
6280−\f[C]
6281−---
6282−references:
6283−- type: article-journal
6284− id: WatsonCrick1953
6285− author:
6286− - family: Watson
6287− given: J. D.
6288− - family: Crick
6289− given: F. H. C.
6290− issued:
6291− date-parts:
6292− - - 1953
6293− - 4
6294− - 25
6295− title: \[aq]Molecular structure of nucleic acids: a structure for
6296− deoxyribose nucleic acid\[aq]
6297− title-short: Molecular structure of nucleic acids
6298− container-title: Nature
6299− volume: 171
6300− issue: 4356
6301− page: 737-738
6302− DOI: 10.1038/171737a0
6303− URL: https://www.nature.com/articles/171737a0
6304− language: en-GB
6305−\&...
6306−\f[R]
6307−.fi
6308−.PP
6309−If both an external bibliography and inline (YAML metadata) references
6310−are provided, both will be used.
6311−In case of conflicting \f[C]id\f[R]s, the inline references will take
6312−precedence.
6313−.PP
6314−Note that \f[C]pandoc\f[R] can be used to produce such a YAML metadata
6315−section from a BibTeX, BibLaTeX, or CSL JSON bibliography:
6316−.IP
6317−.nf
6318−\f[C]
6319−pandoc chem.bib -s -f biblatex -t markdown
6320−pandoc chem.json -s -f csljson -t markdown
6321−\f[R]
6322−.fi
6323−.PP
6324−Indeed, \f[C]pandoc\f[R] can convert between any of these citation
6325−formats:
6326−.IP
6327−.nf
6328−\f[C]
6329−pandoc chem.bib -s -f biblatex -t csljson
6330−pandoc chem.yaml -s -f markdown -t biblatex
6331−\f[R]
6332−.fi
6333−.PP
6334−Running pandoc on a bibliography file with the \f[C]--citeproc\f[R]
6335−option will create a formatted bibliography in the format of your
6336−choice:
6337−.IP
6338−.nf
6339−\f[C]
6340−pandoc chem.bib -s --citeproc -o chem.html
6341−pandoc chem.bib -s --citeproc -o chem.pdf
6342−\f[R]
6343−.fi
6344−.SS Capitalization in titles
6345−.PP
6346−If you are using a bibtex or biblatex bibliography, then observe the
6347−following rules:
6348−.IP \[bu] 2
6349−English titles should be in title case.
6350−Non-English titles should be in sentence case, and the \f[C]langid\f[R]
6351−field in biblatex should be set to the relevant language.
6352−(The following values are treated as English: \f[C]american\f[R],
6353−\f[C]british\f[R], \f[C]canadian\f[R], \f[C]english\f[R],
6354−\f[C]australian\f[R], \f[C]newzealand\f[R], \f[C]USenglish\f[R], or
6355−\f[C]UKenglish\f[R].)
6356−.IP \[bu] 2
6357−As is standard with bibtex/biblatex, proper names should be protected
6358−with curly braces so that they won\[cq]t be lowercased in styles that
6359−call for sentence case.
6360−For example:
6361−.RS 2
6362−.IP
6363−.nf
6364−\f[C]
6365−title = {My Dinner with {Andre}}
6366−\f[R]
6367−.fi
6368−.RE
6369−.IP \[bu] 2
6370−In addition, words that should remain lowercase (or camelCase) should be
6371−protected:
6372−.RS 2
6373−.IP
6374−.nf
6375−\f[C]
6376−title = {Spin Wave Dispersion on the {nm} Scale}
6377−\f[R]
6378−.fi
6379−.PP
6380−Though this is not necessary in bibtex/biblatex, it is necessary with
6381−citeproc, which stores titles internally in sentence case, and converts
6382−to title case in styles that require it.
6383−Here we protect \[lq]nm\[rq] so that it doesn\[cq]t get converted to
6384−\[lq]Nm\[rq] at this stage.
6385−.RE
6386−.PP
6387−If you are using a CSL bibliography (either JSON or YAML), then observe
6388−the following rules:
6389−.IP \[bu] 2
6390−All titles should be in sentence case.
6391−.IP \[bu] 2
6392−Use the \f[C]language\f[R] field for non-English titles to prevent their
6393−conversion to title case in styles that call for this.
6394−(Conversion happens only if \f[C]language\f[R] begins with \f[C]en\f[R]
6395−or is left empty.)
6396−.IP \[bu] 2
6397−Protect words that should not be converted to title case using this
6398−syntax:
6399−.RS 2
6400−.IP
6401−.nf
6402−\f[C]
6403−Spin wave dispersion on the <span class=\[dq]nocase\[dq]>nm</span> scale
6404−\f[R]
6405−.fi
6406−.RE
6407−.SS Conference Papers, Published vs.\ Unpublished
6408−.PP
6409−For a formally published conference paper, use the biblatex entry type
6410−\f[C]inproceedings\f[R] (which will be mapped to CSL
6411−\f[C]paper-conference\f[R]).
6412−.PP
6413−For an unpublished manuscript, use the biblatex entry type
6414−\f[C]unpublished\f[R] without an \f[C]eventtitle\f[R] field (this entry
6415−type will be mapped to CSL \f[C]manuscript\f[R]).
6416−.PP
6417−For a talk, an unpublished conference paper, or a poster presentation,
6418−use the biblatex entry type \f[C]unpublished\f[R] with an
6419−\f[C]eventtitle\f[R] field (this entry type will be mapped to CSL
6420−\f[C]speech\f[R]).
6421−Use the biblatex \f[C]type\f[R] field to indicate the type,
6422−e.g.\ \[lq]Paper\[rq], or \[lq]Poster\[rq].
6423−\f[C]venue\f[R] and \f[C]eventdate\f[R] may be useful too, though
6424−\f[C]eventdate\f[R] will not be rendered by most CSL styles.
6425−Note that \f[C]venue\f[R] is for the event\[cq]s venue, unlike
6426−\f[C]location\f[R] which describes the publisher\[cq]s location; do not
6427−use the latter for an unpublished conference paper.
6428−.SS Specifying a citation style
6429−.PP
6430−Citations and references can be formatted using any style supported by
6431−the Citation Style Language, listed in the Zotero Style Repository.
6432−These files are specified using the \f[C]--csl\f[R] option or the
6433−\f[C]csl\f[R] (or \f[C]citation-style\f[R]) metadata field.
6434−By default, pandoc will use the Chicago Manual of Style author-date
6435−format.
6436−(You can override this default by copying a CSL style of your choice to
6437−\f[C]default.csl\f[R] in your user data directory.) The CSL project
6438−provides further information on finding and editing styles.
6439−.PP
6440−The \f[C]--citation-abbreviations\f[R] option (or the
6441−\f[C]citation-abbreviations\f[R] metadata field) may be used to specify
6442−a JSON file containing abbreviations of journals that should be used in
6443−formatted bibliographies when \f[C]form=\[dq]short\[dq]\f[R] is
6444−specified.
6445−The format of the file can be illustrated with an example:
6446−.IP
6447−.nf
6448−\f[C]
6449−{ \[dq]default\[dq]: {
6450− \[dq]container-title\[dq]: {
6451− \[dq]Lloyd\[aq]s Law Reports\[dq]: \[dq]Lloyd\[aq]s Rep\[dq],
6452− \[dq]Estates Gazette\[dq]: \[dq]EG\[dq],
6453− \[dq]Scots Law Times\[dq]: \[dq]SLT\[dq]
6454− }
6455− }
6456−}
6457−\f[R]
6458−.fi
6459−.SS Citations in note styles
6460−.PP
6461−Pandoc\[cq]s citation processing is designed to allow you to move
6462−between author-date, numerical, and note styles without modifying the
6463−markdown source.
6464−When you\[cq]re using a note style, avoid inserting footnotes manually.
6465−Instead, insert citations just as you would in an author-date
6466−style\[em]for example,
6467−.IP
6468−.nf
6469−\f[C]
6470−Blah blah [\[at]foo, p. 33].
6471−\f[R]
6472−.fi
6473−.PP
6474−The footnote will be created automatically.
6475−Pandoc will take care of removing the space and moving the note before
6476−or after the period, depending on the setting of
6477−\f[C]notes-after-punctuation\f[R], as described below in Other relevant
6478−metadata fields.
6479−.PP
6480−In some cases you may need to put a citation inside a regular footnote.
6481−Normal citations in footnotes (such as \f[C][\[at]foo, p. 33]\f[R]) will
6482−be rendered in parentheses.
6483−In-text citations (such as \f[C]\[at]foo [p. 33]\f[R]) will be rendered
6484−without parentheses.
6485−(A comma will be added if appropriate.) Thus:
6486−.IP
6487−.nf
6488−\f[C]
6489−[\[ha]1]: Some studies [\[at]foo; \[at]bar, p. 33] show that
6490−frubulicious zoosnaps are quantical. For a survey
6491−of the literature, see \[at]baz [chap. 1].
6492−\f[R]
6493−.fi
6494−.SS Raw content in a style
6495−.PP
6496−To include raw content in a prefix, suffix, delimiter, or term, surround
6497−it with these tags indicating the format:
6498−.IP
6499−.nf
6500−\f[C]
6501−{{jats}}&lt;ref&gt;{{/jats}}
6502−\f[R]
6503−.fi
6504−.PP
6505−Without the tags, the string will be interpreted as a string and escaped
6506−in the output, rather than being passed through raw.
6507−.PP
6508−This feature allows stylesheets to be customized to give different
6509−output for different output formats.
6510−However, stylesheets customized in this way will not be usable by other
6511−CSL implementations.
6512−.SS Placement of the bibliography
6513−.PP
6514−If the style calls for a list of works cited, it will be placed in a div
6515−with id \f[C]refs\f[R], if one exists:
6516−.IP
6517−.nf
6518−\f[C]
6519−::: {#refs}
6520−:::
6521−\f[R]
6522−.fi
6523−.PP
6524−Otherwise, it will be placed at the end of the document.
6525−Generation of the bibliography can be suppressed by setting
6526−\f[C]suppress-bibliography: true\f[R] in the YAML metadata.
6527−.PP
6528−If you wish the bibliography to have a section heading, you can set
6529−\f[C]reference-section-title\f[R] in the metadata, or put the heading at
6530−the beginning of the div with id \f[C]refs\f[R] (if you are using it) or
6531−at the end of your document:
6532−.IP
6533−.nf
6534−\f[C]
6535−last paragraph...
6536−
6537−# References
6538−\f[R]
6539−.fi
6540−.PP
6541−The bibliography will be inserted after this heading.
6542−Note that the \f[C]unnumbered\f[R] class will be added to this heading,
6543−so that the section will not be numbered.
6544−.SS Including uncited items in the bibliography
6545−.PP
6546−If you want to include items in the bibliography without actually citing
6547−them in the body text, you can define a dummy \f[C]nocite\f[R] metadata
6548−field and put the citations there:
6549−.IP
6550−.nf
6551−\f[C]
6552−---
6553−nocite: |
6554− \[at]item1, \[at]item2
6555−\&...
6556−
6557−\[at]item3
6558−\f[R]
6559−.fi
6560−.PP
6561−In this example, the document will contain a citation for
6562−\f[C]item3\f[R] only, but the bibliography will contain entries for
6563−\f[C]item1\f[R], \f[C]item2\f[R], and \f[C]item3\f[R].
6564−.PP
6565−It is possible to create a bibliography with all the citations, whether
6566−or not they appear in the document, by using a wildcard:
6567−.IP
6568−.nf
6569−\f[C]
6570−---
6571−nocite: |
6572− \[at]*
6573−\&...
6574−\f[R]
6575−.fi
6576−.PP
6577−For LaTeX output, you can also use \f[C]natbib\f[R] or
6578−\f[C]biblatex\f[R] to render the bibliography.
6579−In order to do so, specify bibliography files as outlined above, and add
6580−\f[C]--natbib\f[R] or \f[C]--biblatex\f[R] argument to \f[C]pandoc\f[R]
6581−invocation.
6582−Bear in mind that bibliography files have to be in either BibTeX (for
6583−\f[C]--natbib\f[R]) or BibLaTeX (for \f[C]--biblatex\f[R]) format.
6584−.SS Other relevant metadata fields
6585−.PP
6586−A few other metadata fields affect bibliography formatting:
6587−.TP
6588−\f[B]\f[CB]link-citations\f[B]\f[R]
6589−If true, citations will be hyperlinked to the corresponding bibliography
6590−entries (for author-date and numerical styles only).
6591.TP
6021.TP
6592−\f[B]\f[CB]lang\f[B]\f[R]
6022+\f[B]\f[CB]markdown_phpextra\f[B]\f[R] (PHP Markdown Extra)
6593−The \f[C]lang\f[R] field will affect how the style is localized, for
6023+\f[C]footnotes\f[R], \f[C]pipe_tables\f[R], \f[C]raw_html\f[R],
6594−example in the translation of labels, the use of quotation marks, and
6024+\f[C]markdown_attribute\f[R], \f[C]fenced_code_blocks\f[R],
6595−the way items are sorted.
6025+\f[C]definition_lists\f[R], \f[C]intraword_underscores\f[R],
6596−(For backwards compatibility, \f[C]locale\f[R] may be used instead of
6026+\f[C]header_attributes\f[R], \f[C]link_attributes\f[R],
6597−\f[C]lang\f[R], but this use is deprecated.)
6027+\f[C]abbreviations\f[R], \f[C]shortcut_reference_links\f[R],
6598−.RS
6028+\f[C]spaced_reference_links\f[R].
6599−.PP
6029+.TP
6600−A BCP 47 language tag is expected: for example, \f[C]en\f[R],
6030+\f[B]\f[CB]markdown_github\f[B]\f[R] (deprecated GitHub-Flavored Markdown)
6601−\f[C]de\f[R], \f[C]en-US\f[R], \f[C]fr-CA\f[R], \f[C]ug-Cyrl\f[R].
6031+\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]fenced_code_blocks\f[R],
6602−The unicode extension syntax (after \f[C]-u-\f[R]) may be used to
6032+\f[C]auto_identifiers\f[R], \f[C]gfm_auto_identifiers\f[R],
6603−specify options for collation (sorting) more precisely.
6033+\f[C]backtick_code_blocks\f[R], \f[C]autolink_bare_uris\f[R],
6604−Here are some examples:
6034+\f[C]space_in_atx_header\f[R], \f[C]intraword_underscores\f[R],
6605−.IP \[bu] 2
6035+\f[C]strikeout\f[R], \f[C]task_lists\f[R], \f[C]emoji\f[R],
6606−\f[C]zh-u-co-pinyin\f[R] \[en] Chinese with the Pinyin collation.
6036+\f[C]shortcut_reference_links\f[R], \f[C]angle_brackets_escapable\f[R],
6607−.IP \[bu] 2
6037+\f[C]lists_without_preceding_blankline\f[R].
6608−\f[C]es-u-co-trad\f[R] \[en] Spanish with the traditional collation
6038+.TP
6609−(with \f[C]Ch\f[R] sorting after \f[C]C\f[R]).
6039+\f[B]\f[CB]markdown_mmd\f[B]\f[R] (MultiMarkdown)
6610−.IP \[bu] 2
6040+\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]markdown_attribute\f[R],
6611−\f[C]fr-u-kb\f[R] \[en] French with \[lq]backwards\[rq] accent sorting
6041+\f[C]mmd_link_attributes\f[R], \f[C]tex_math_double_backslash\f[R],
6612−(with \f[C]cot\['e]\f[R] sorting after \f[C]c\[^o]te\f[R]).
6042+\f[C]intraword_underscores\f[R], \f[C]mmd_title_block\f[R],
6613−.IP \[bu] 2
6043+\f[C]footnotes\f[R], \f[C]definition_lists\f[R],
6614−\f[C]en-US-u-kf-upper\f[R] \[en] English with uppercase letters sorting
6044+\f[C]all_symbols_escapable\f[R], \f[C]implicit_header_references\f[R],
6615−before lower (default is lower before upper).
6045+\f[C]auto_identifiers\f[R], \f[C]mmd_header_identifiers\f[R],
6616−.RE
6046+\f[C]shortcut_reference_links\f[R], \f[C]implicit_figures\f[R],
6617−.TP
6047+\f[C]superscript\f[R], \f[C]subscript\f[R],
6618−\f[B]\f[CB]notes-after-punctuation\f[B]\f[R]
6048+\f[C]backtick_code_blocks\f[R], \f[C]spaced_reference_links\f[R],
6619−If true (the default), pandoc will put footnote citations after
6049+\f[C]raw_attribute\f[R].
6620−following punctuation.
6050+.TP
6621−For example, if the source contains \f[C]blah blah [\[at]jones99].\f[R],
6051+\f[B]\f[CB]markdown_strict\f[B]\f[R] (Markdown.pl)
6622−the result will look like \f[C]blah blah.[\[ha]1]\f[R], with the note
6052+\f[C]raw_html\f[R], \f[C]shortcut_reference_links\f[R],
6623−moved after the period and the space collapsed.
6053+\f[C]spaced_reference_links\f[R].
6624−If false, the space will still be collapsed, but the footnote will not
6054+.PP
6625−be moved after the punctuation.
6055+We also support \f[C]commonmark\f[R] and \f[C]gfm\f[R] (GitHub-Flavored
6056+Markdown, which is implemented as a set of extensions on
6057+\f[C]commonmark\f[R]).
6058+.PP
6059+Note, however, that \f[C]commonmark\f[R] and \f[C]gfm\f[R] have limited
6060+support for extensions.
6061+Only those listed below (and \f[C]smart\f[R], \f[C]raw_tex\f[R], and
6062+\f[C]hard_line_breaks\f[R]) will work.
6063+The extensions can, however, all be individually disabled.
6064+Also, \f[C]raw_tex\f[R] only affects \f[C]gfm\f[R] output, not input.
6065+.TP
6066+\f[B]\f[CB]gfm\f[B]\f[R] (GitHub-Flavored Markdown)
6067+\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]fenced_code_blocks\f[R],
6068+\f[C]auto_identifiers\f[R], \f[C]gfm_auto_identifiers\f[R],
6069+\f[C]backtick_code_blocks\f[R], \f[C]autolink_bare_uris\f[R],
6070+\f[C]space_in_atx_header\f[R], \f[C]intraword_underscores\f[R],
6071+\f[C]strikeout\f[R], \f[C]task_lists\f[R], \f[C]emoji\f[R],
6072+\f[C]shortcut_reference_links\f[R], \f[C]angle_brackets_escapable\f[R],
6073+\f[C]lists_without_preceding_blankline\f[R].
6626−.SH SLIDE SHOWS
6074+.SH PRODUCING SLIDE SHOWS WITH PANDOC
6627.PP
6075.PP
6628You can use pandoc to produce an HTML + JavaScript slide presentation
6076You can use pandoc to produce an HTML + JavaScript slide presentation
6629that can be viewed via a web browser.
6077that can be viewed via a web browser.
@@ -6632,7 +6080,7 @@ reveal.js.
6632You can also produce a PDF slide show using LaTeX \f[C]beamer\f[R], or
6080You can also produce a PDF slide show using LaTeX \f[C]beamer\f[R], or
6633slides shows in Microsoft PowerPoint format.
6081slides shows in Microsoft PowerPoint format.
6634.PP
6082.PP
6635−Here\[cq]s the Markdown source for a simple slide show,
6083+Here\[aq]s the Markdown source for a simple slide show,
6636\f[C]habits.txt\f[R]:
6084\f[C]habits.txt\f[R]:
6637.IP
6085.IP
6638.nf
6086.nf
@@ -6734,26 +6182,21 @@ A heading at the slide level always starts a new slide.
6734.IP \[bu] 2
6182.IP \[bu] 2
6735Headings \f[I]below\f[R] the slide level in the hierarchy create
6183Headings \f[I]below\f[R] the slide level in the hierarchy create
6736headings \f[I]within\f[R] a slide.
6184headings \f[I]within\f[R] a slide.
6737−(In beamer, a \[lq]block\[rq] will be created.
6738−If the heading has the class \f[C]example\f[R], an
6739−\f[C]exampleblock\f[R] environment will be used; if it has the class
6740−\f[C]alert\f[R], an \f[C]alertblock\f[R] will be used; otherwise a
6741−regular \f[C]block\f[R] will be used.)
6742.IP \[bu] 2
6185.IP \[bu] 2
6743Headings \f[I]above\f[R] the slide level in the hierarchy create
6186Headings \f[I]above\f[R] the slide level in the hierarchy create
6744−\[lq]title slides,\[rq] which just contain the section title and help to
6187+\[dq]title slides,\[dq] which just contain the section title and help to
6745break the slide show into sections.
6188break the slide show into sections.
6746Non-slide content under these headings will be included on the title
6189Non-slide content under these headings will be included on the title
6747slide (for HTML slide shows) or in a subsequent slide with the same
6190slide (for HTML slide shows) or in a subsequent slide with the same
6748title (for beamer).
6191title (for beamer).
6749.IP \[bu] 2
6192.IP \[bu] 2
6750−A title page is constructed automatically from the document\[cq]s title
6193+A title page is constructed automatically from the document\[aq]s title
6751block, if present.
6194block, if present.
6752(In the case of beamer, this can be disabled by commenting out some
6195(In the case of beamer, this can be disabled by commenting out some
6753lines in the default template.)
6196lines in the default template.)
6754.PP
6197.PP
6755These rules are designed to support many different styles of slide show.
6198These rules are designed to support many different styles of slide show.
6756−If you don\[cq]t care about structuring your slides into sections and
6199+If you don\[aq]t care about structuring your slides into sections and
6757subsections, you can just use level-1 headings for all each slide.
6200subsections, you can just use level-1 headings for all each slide.
6758(In that case, level-1 will be the slide level.) But you can also
6201(In that case, level-1 will be the slide level.) But you can also
6759structure the slide show into sections, as in the example above.
6202structure the slide show into sections, as in the example above.
@@ -6765,8 +6208,8 @@ It is not recommended that you use deeper nesting of section levels with
6765reveal.js.
6208reveal.js.
6766.SS Incremental lists
6209.SS Incremental lists
6767.PP
6210.PP
6768−By default, these writers produce lists that display \[lq]all at
6211+By default, these writers produce lists that display \[dq]all at
6769−once.\[rq] If you want your lists to display incrementally (one item at
6212+once.\[dq] If you want your lists to display incrementally (one item at
6770a time), use the \f[C]-i\f[R] option.
6213a time), use the \f[C]-i\f[R] option.
6771If you want a particular list to depart from the default, put it in a
6214If you want a particular list to depart from the default, put it in a
6772\f[C]div\f[R] block with class \f[C]incremental\f[R] or
6215\f[C]div\f[R] block with class \f[C]incremental\f[R] or
@@ -6819,7 +6262,7 @@ Note: Neither the \f[C]-i/--incremental\f[R] option nor any of the
6819methods described here currently works for PowerPoint output.
6262methods described here currently works for PowerPoint output.
6820.SS Inserting pauses
6263.SS Inserting pauses
6821.PP
6264.PP
6822−You can add \[lq]pauses\[rq] within a slide by including a paragraph
6265+You can add \[dq]pauses\[dq] within a slide by including a paragraph
6823containing three dots, separated by spaces:
6266containing three dots, separated by spaces:
6824.IP
6267.IP
6825.nf
6268.nf
@@ -6842,7 +6285,7 @@ in \f[C]$DATADIR/s5/default\f[R] (for S5), \f[C]$DATADIR/slidy\f[R] (for
6842Slidy), or \f[C]$DATADIR/slideous\f[R] (for Slideous), where
6285Slidy), or \f[C]$DATADIR/slideous\f[R] (for Slideous), where
6843\f[C]$DATADIR\f[R] is the user data directory (see \f[C]--data-dir\f[R],
6286\f[C]$DATADIR\f[R] is the user data directory (see \f[C]--data-dir\f[R],
6844above).
6287above).
6845−The originals may be found in pandoc\[cq]s system data directory
6288+The originals may be found in pandoc\[aq]s system data directory
6846(generally \f[C]$CABALDIR/pandoc-VERSION/s5/default\f[R]).
6289(generally \f[C]$CABALDIR/pandoc-VERSION/s5/default\f[R]).
6847Pandoc will look there for any files it does not find in the user data
6290Pandoc will look there for any files it does not find in the user data
6848directory.
6291directory.
@@ -6928,51 +6371,6 @@ contents...
6928::::::::::::::
6371::::::::::::::
6929\f[R]
6372\f[R]
6930.fi
6373.fi
6931−.SS Additional columns attributes in beamer
6932−.PP
6933−The div containers with classes \f[C]columns\f[R] and \f[C]column\f[R]
6934−can optionally have an \f[C]align\f[R] attribute.
6935−The class \f[C]columns\f[R] can optionally have a \f[C]totalwidth\f[R]
6936−attribute or an \f[C]onlytextwidth\f[R] class.
6937−.IP
6938−.nf
6939−\f[C]
6940−:::::::::::::: {.columns align=center totalwidth=8em}
6941−::: {.column width=\[dq]40%\[dq]}
6942−contents...
6943−:::
6944−::: {.column width=\[dq]60%\[dq] align=bottom}
6945−contents...
6946−:::
6947−::::::::::::::
6948−\f[R]
6949−.fi
6950−.PP
6951−The \f[C]align\f[R] attributes on \f[C]columns\f[R] and \f[C]column\f[R]
6952−can be used with the values \f[C]top\f[R], \f[C]top-baseline\f[R],
6953−\f[C]center\f[R] and \f[C]bottom\f[R] to vertically align the columns.
6954−It defaults to \f[C]top\f[R] in \f[C]columns\f[R].
6955−.PP
6956−The \f[C]totalwidth\f[R] attribute limits the width of the columns to
6957−the given value.
6958−.IP
6959−.nf
6960−\f[C]
6961−:::::::::::::: {.columns align=top .onlytextwidth}
6962−::: {.column width=\[dq]40%\[dq] align=center}
6963−contents...
6964−:::
6965−::: {.column width=\[dq]60%\[dq]}
6966−contents...
6967−:::
6968−::::::::::::::
6969−\f[R]
6970−.fi
6971−.PP
6972−The class \f[C]onlytextwidth\f[R] sets the \f[C]totalwidth\f[R] to
6973−\f[C]\[rs]textwidth\f[R].
6974−.PP
6975−See Section 12.7 of the Beamer User\[cq]s Guide for more details.
6976.SS Frame attributes in beamer
6374.SS Frame attributes in beamer
6977.PP
6375.PP
6978Sometimes it is necessary to add the LaTeX \f[C][fragile]\f[R] option to
6376Sometimes it is necessary to add the LaTeX \f[C][fragile]\f[R] option to
@@ -6988,7 +6386,7 @@ introducing the slide:
6988.fi
6386.fi
6989.PP
6387.PP
6990All of the other frame attributes described in Section 8.1 of the Beamer
6388All of the other frame attributes described in Section 8.1 of the Beamer
6991−User\[cq]s Guide may also be used: \f[C]allowdisplaybreaks\f[R],
6389+User\[aq]s Guide may also be used: \f[C]allowdisplaybreaks\f[R],
6992\f[C]allowframebreaks\f[R], \f[C]b\f[R], \f[C]c\f[R], \f[C]t\f[R],
6390\f[C]allowframebreaks\f[R], \f[C]b\f[R], \f[C]c\f[R], \f[C]t\f[R],
6993\f[C]environment\f[R], \f[C]label\f[R], \f[C]plain\f[R],
6391\f[C]environment\f[R], \f[C]label\f[R], \f[C]plain\f[R],
6994\f[C]shrink\f[R], \f[C]standout\f[R], \f[C]noframenumbering\f[R].
6392\f[C]shrink\f[R], \f[C]standout\f[R], \f[C]noframenumbering\f[R].
@@ -7013,7 +6411,7 @@ To set an image for a particular reveal.js slide, add
7013\f[C]{data-background-image=\[dq]/path/to/image\[dq]}\f[R] to the first
6411\f[C]{data-background-image=\[dq]/path/to/image\[dq]}\f[R] to the first
7014slide-level heading on the slide (which may even be empty).
6412slide-level heading on the slide (which may even be empty).
7015.PP
6413.PP
7016−In reveal.js\[cq]s overview mode, the parallaxBackgroundImage will show
6414+In reveal.js\[aq]s overview mode, the parallaxBackgroundImage will show
7017up only on the first slide.
6415up only on the first slide.
7018.PP
6416.PP
7019Other reveal.js background settings also work on individual slides,
6417Other reveal.js background settings also work on individual slides,
@@ -7049,7 +6447,7 @@ Slide 1 has background_image.png as its background.
7049Slide 2 has a special image for its background, even though the heading has no content.
6447Slide 2 has a special image for its background, even though the heading has no content.
7050\f[R]
6448\f[R]
7051.fi
6449.fi
7052−.SH EPUBS
6450+.SH CREATING EPUBS WITH PANDOC
7053.SS EPUB Metadata
6451.SS EPUB Metadata
7054.PP
6452.PP
7055EPUB metadata may be specified using the \f[C]--epub-metadata\f[R]
6453EPUB metadata may be specified using the \f[C]--epub-metadata\f[R]
@@ -7103,8 +6501,8 @@ Valid values for \f[C]type\f[R] are \f[C]main\f[R], \f[C]subtitle\f[R],
7103Either a string value, or an object with fields \f[C]role\f[R],
6501Either a string value, or an object with fields \f[C]role\f[R],
7104\f[C]file-as\f[R], and \f[C]text\f[R], or a list of such objects.
6502\f[C]file-as\f[R], and \f[C]text\f[R], or a list of such objects.
7105Valid values for \f[C]role\f[R] are MARC relators, but pandoc will
6503Valid values for \f[C]role\f[R] are MARC relators, but pandoc will
7106−attempt to translate the human-readable versions (like \[lq]author\[rq]
6504+attempt to translate the human-readable versions (like \[dq]author\[dq]
7107−and \[lq]editor\[rq]) to the appropriate marc relators.
6505+and \[dq]editor\[dq]) to the appropriate marc relators.
7108.TP
6506.TP
7109\f[B]\f[CB]contributor\f[B]\f[R]
6507\f[B]\f[CB]contributor\f[B]\f[R]
7110Same format as \f[C]creator\f[R].
6508Same format as \f[C]creator\f[R].
@@ -7139,16 +6537,6 @@ A string value.
7139\f[B]\f[CB]rights\f[B]\f[R]
6537\f[B]\f[CB]rights\f[B]\f[R]
7140A string value.
6538A string value.
7141.TP
6539.TP
7142−\f[B]\f[CB]belongs-to-collection\f[B]\f[R]
7143−A string value.
7144−identifies the name of a collection to which the EPUB Publication
7145−belongs.
7146−.TP
7147−\f[B]\f[CB]group-position\f[B]\f[R]
7148−The \f[C]group-position\f[R] field indicates the numeric position in
7149−which the EPUB Publication belongs relative to other works belonging to
7150−the same \f[C]belongs-to-collection\f[R] field.
7151−.TP
7152\f[B]\f[CB]cover-image\f[B]\f[R]
6540\f[B]\f[CB]cover-image\f[B]\f[R]
7153A string value (path to cover image).
6541A string value (path to cover image).
7154.TP
6542.TP
@@ -7303,6 +6691,16 @@ T}@T{
7303frontmatter
6691frontmatter
7304T}
6692T}
7305T{
6693T{
6694+seriespage
6695+T}@T{
6696+frontmatter
6697+T}
6698+T{
6699+titlepage
6700+T}@T{
6701+frontmatter
6702+T}
6703+T{
7306appendix
6704appendix
7307T}@T{
6705T}@T{
7308backmatter
6706backmatter
@@ -7343,7 +6741,7 @@ For example:
7343</audio>
6741</audio>
7344\f[R]
6742\f[R]
7345.fi
6743.fi
7346−.SH JUPYTER NOTEBOOKS
6744+.SH CREATING JUPYTER NOTEBOOKS WITH PANDOC
7347.PP
6745.PP
7348When creating a Jupyter notebook, pandoc will try to infer the notebook
6746When creating a Jupyter notebook, pandoc will try to infer the notebook
7349structure.
6747structure.
@@ -7458,7 +6856,7 @@ hello
7458If you include raw HTML or TeX in an output cell, use the [raw
6856If you include raw HTML or TeX in an output cell, use the [raw
7459attribute][Extension: \f[C]fenced_attribute\f[R]], as shown in the last
6857attribute][Extension: \f[C]fenced_attribute\f[R]], as shown in the last
7460cell of the example above.
6858cell of the example above.
7461−Although pandoc can process \[lq]bare\[rq] raw HTML and TeX, the result
6859+Although pandoc can process \[dq]bare\[dq] raw HTML and TeX, the result
7462is often interspersed raw elements and normal textual elements, and in
6860is often interspersed raw elements and normal textual elements, and in
7463an output cell pandoc expects a single, connected raw block.
6861an output cell pandoc expects a single, connected raw block.
7464To avoid using raw HTML or TeX except when marked explicitly using raw
6862To avoid using raw HTML or TeX except when marked explicitly using raw
@@ -7511,10 +6909,10 @@ pandoc --highlight-style my.theme
7511.fi
6909.fi
7512.PP
6910.PP
7513If you are not satisfied with the built-in highlighting, or you want
6911If you are not satisfied with the built-in highlighting, or you want
7514−highlight a language that isn\[cq]t supported, you can use the
6912+highlight a language that isn\[aq]t supported, you can use the
7515\f[C]--syntax-definition\f[R] option to load a KDE-style XML syntax
6913\f[C]--syntax-definition\f[R] option to load a KDE-style XML syntax
7516definition file.
6914definition file.
7517−Before writing your own, have a look at KDE\[cq]s repository of syntax
6915+Before writing your own, have a look at KDE\[aq]s repository of syntax
7518definitions.
6916definitions.
7519.PP
6917.PP
7520To disable highlighting, use the \f[C]--no-highlight\f[R] option.
6918To disable highlighting, use the \f[C]--no-highlight\f[R] option.
@@ -7523,7 +6921,7 @@ To disable highlighting, use the \f[C]--no-highlight\f[R] option.
7523Custom styles can be used in the docx and ICML formats.
6921Custom styles can be used in the docx and ICML formats.
7524.SS Output
6922.SS Output
7525.PP
6923.PP
7526−By default, pandoc\[cq]s docx and ICML output applies a predefined set
6924+By default, pandoc\[aq]s docx and ICML output applies a predefined set
7527of styles for blocks such as paragraphs and block quotes, and uses
6925of styles for blocks such as paragraphs and block quotes, and uses
7528largely default formatting (italics, bold) for inlines.
6926largely default formatting (italics, bold) for inlines.
7529This will work for most purposes, especially alongside a
6927This will work for most purposes, especially alongside a
@@ -7544,7 +6942,7 @@ So, for example, using the \f[C]bracketed_spans\f[R] syntax,
7544\f[R]
6942\f[R]
7545.fi
6943.fi
7546.PP
6944.PP
7547−would produce a docx file with \[lq]Get out\[rq] styled with character
6945+would produce a docx file with \[dq]Get out\[dq] styled with character
7548style \f[C]Emphatically\f[R].
6946style \f[C]Emphatically\f[R].
7549Similarly, using the \f[C]fenced_divs\f[R] syntax,
6947Similarly, using the \f[C]fenced_divs\f[R] syntax,
7550.IP
6948.IP
@@ -7575,13 +6973,13 @@ character style (perhaps to change their color), you can write a filter
7575which will transform all italicized inlines to inlines within an
6973which will transform all italicized inlines to inlines within an
7576\f[C]Emphasis\f[R] custom-style \f[C]span\f[R].
6974\f[C]Emphasis\f[R] custom-style \f[C]span\f[R].
7577.PP
6975.PP
7578−For docx output, you don\[cq]t need to enable any extensions for custom
6976+For docx output, you don\[aq]t need to enable any extensions for custom
7579styles to work.
6977styles to work.
7580.SS Input
6978.SS Input
7581.PP
6979.PP
7582The docx reader, by default, only reads those styles that it can convert
6980The docx reader, by default, only reads those styles that it can convert
7583into pandoc elements, either by direct conversion or interpreting the
6981into pandoc elements, either by direct conversion or interpreting the
7584−derivation of the input document\[cq]s styles.
6982+derivation of the input document\[aq]s styles.
7585.PP
6983.PP
7586By enabling the \f[C]styles\f[R] extension in the docx reader
6984By enabling the \f[C]styles\f[R] extension in the docx reader
7587(\f[C]-f docx+styles\f[R]), you can produce output that maintains the
6985(\f[C]-f docx+styles\f[R]), you can produce output that maintains the
@@ -7664,20 +7062,6 @@ need to specify a template manually using \f[C]--template\f[R] or add a
7664new default template with the name
7062new default template with the name
7665\f[C]default.NAME_OF_CUSTOM_WRITER.lua\f[R] to the \f[C]templates\f[R]
7063\f[C]default.NAME_OF_CUSTOM_WRITER.lua\f[R] to the \f[C]templates\f[R]
7666subdirectory of your user data directory (see Templates).
7064subdirectory of your user data directory (see Templates).
7667−.SH REPRODUCIBLE BUILDS
7668−.PP
7669−Some of the document formats pandoc targets (such as EPUB, docx, and
7670−ODT) include build timestamps in the generated document.
7671−That means that the files generated on successive builds will differ,
7672−even if the source does not.
7673−To avoid this, set the \f[C]SOURCE_DATE_EPOCH\f[R] environment variable,
7674−and the timestamp will be taken from it instead of the current time.
7675−\f[C]SOURCE_DATE_EPOCH\f[R] should contain an integer unix timestamp
7676−(specifying the number of second since midnight UTC January 1, 1970).
7677−.PP
7678−Some document formats also include a unique identifier.
7679−For EPUB, this can be set explicitly by setting the \f[C]identifier\f[R]
7680−metadata field (see EPUB Metadata, above).
7681.SH A NOTE ON SECURITY
7065.SH A NOTE ON SECURITY
7682.PP
7066.PP
7683If you use pandoc to convert user-contributed content in a web
7067If you use pandoc to convert user-contributed content in a web
@@ -7696,7 +7080,7 @@ fully isolates pandoc from your file system, by running the pandoc
7696operations in the \f[C]PandocPure\f[R] monad.
7080operations in the \f[C]PandocPure\f[R] monad.
7697See the document Using the pandoc API for more details.
7081See the document Using the pandoc API for more details.
7698.IP "3." 3
7082.IP "3." 3
7699−Pandoc\[cq]s parsers can exhibit pathological performance on some corner
7083+Pandoc\[aq]s parsers can exhibit pathological performance on some corner
7700cases.
7084cases.
7701It is wise to put any pandoc operations under a timeout, to avoid DOS
7085It is wise to put any pandoc operations under a timeout, to avoid DOS
7702attacks that exploit these issues.
7086attacks that exploit these issues.
@@ -7708,16 +7092,16 @@ The HTML generated by pandoc is not guaranteed to be safe.
7708If \f[C]raw_html\f[R] is enabled for the Markdown input, users can
7092If \f[C]raw_html\f[R] is enabled for the Markdown input, users can
7709inject arbitrary HTML.
7093inject arbitrary HTML.
7710Even if \f[C]raw_html\f[R] is disabled, users can include dangerous
7094Even if \f[C]raw_html\f[R] is disabled, users can include dangerous
7711−content in URLs and attributes.
7095+content in attributes for headings, spans, and code blocks.
7712To be safe, you should run all the generated HTML through an HTML
7096To be safe, you should run all the generated HTML through an HTML
7713sanitizer.
7097sanitizer.
7714.SH AUTHORS
7098.SH AUTHORS
7715.PP
7099.PP
7716−Copyright 2006\[en]2021 John MacFarlane (jgm\[at]berkeley.edu).
7100+Copyright 2006--2020 John MacFarlane (jgm\[at]berkeley.edu).
7717Released under the GPL, version 2 or greater.
7101Released under the GPL, version 2 or greater.
7718This software carries no warranty of any kind.
7102This software carries no warranty of any kind.
7719(See COPYRIGHT for full copyright and warranty notices.) For a full list
7103(See COPYRIGHT for full copyright and warranty notices.) For a full list
7720of contributors, see the file AUTHORS.md in the pandoc source code.
7104of contributors, see the file AUTHORS.md in the pandoc source code.
7721.PP
7105.PP
7722The Pandoc source code and all documentation may be downloaded
7106The Pandoc source code and all documentation may be downloaded
7723−from <https://pandoc.org>.
7107+from <http://pandoc.org>.
man/pandoc.1.after+1−1
@@ -1,3 +1,3 @@
1.PP
1.PP
2The Pandoc source code and all documentation may be downloaded
2The Pandoc source code and all documentation may be downloaded
3−from <https://pandoc.org>.
3+from <http://pandoc.org>.
pandoc.cabal+239−222
@@ -1,18 +1,17 @@
1cabal-version: 2.2
1cabal-version: 2.2
2name: pandoc
2name: pandoc
3−version: 2.14.0.3
3+version: 2.9.2.1
4build-type: Simple
4build-type: Simple
5license: GPL-2.0-or-later
5license: GPL-2.0-or-later
6license-file: COPYING.md
6license-file: COPYING.md
7−copyright: (c) 2006-2021 John MacFarlane
7+copyright: (c) 2006-2020 John MacFarlane
8author: John MacFarlane <jgm@berkeley.edu>
8author: John MacFarlane <jgm@berkeley.edu>
9maintainer: John MacFarlane <jgm@berkeley.edu>
9maintainer: John MacFarlane <jgm@berkeley.edu>
10bug-reports: https://github.com/jgm/pandoc/issues
10bug-reports: https://github.com/jgm/pandoc/issues
11stability: alpha
11stability: alpha
12homepage: https://pandoc.org
12homepage: https://pandoc.org
13category: Text
13category: Text
14−tested-with: GHC == 8.2.2, GHC == 8.4.4, GHC == 8.6.5,
14+tested-with: GHC == 8.0.2, GHC == 8.2.2, GHC == 8.4.4, GHC == 8.6.5
15− GHC == 8.8.4, GHC == 8.10.2, GHC == 9.0.1
16synopsis: Conversion between markup formats
15synopsis: Conversion between markup formats
17description: Pandoc is a Haskell library for converting from one markup
16description: Pandoc is a Haskell library for converting from one markup
18 format to another, and a command-line tool that uses
17 format to another, and a command-line tool that uses
@@ -22,15 +21,14 @@ description: Pandoc is a Haskell library for converting from one markup
22 TikiWiki markup, Jira markup, Creole 1.0, Haddock markup,
21 TikiWiki markup, Jira markup, Creole 1.0, Haddock markup,
23 OPML, Emacs Org-Mode, Emacs Muse, txt2tags, ipynb (Jupyter
22 OPML, Emacs Org-Mode, Emacs Muse, txt2tags, ipynb (Jupyter
24 notebooks), Vimwiki, Word Docx, ODT, EPUB, FictionBook2,
23 notebooks), Vimwiki, Word Docx, ODT, EPUB, FictionBook2,
25− roff man, Textile, BibTeX, BibLaTeX, CSL JSON,
26− , and CSV, and it can write Markdown,
24+ roff man, Textile, and CSV, and it can write Markdown,
27 reStructuredText, XHTML, HTML 5, LaTeX, ConTeXt, DocBook,
25 reStructuredText, XHTML, HTML 5, LaTeX, ConTeXt, DocBook,
28 JATS, OPML, TEI, OpenDocument, ODT, Word docx,
26 JATS, OPML, TEI, OpenDocument, ODT, Word docx,
29 PowerPoint pptx, RTF, MediaWiki, DokuWiki, XWiki,
27 PowerPoint pptx, RTF, MediaWiki, DokuWiki, XWiki,
30 ZimWiki, Textile, Jira, roff man, roff ms, plain text,
28 ZimWiki, Textile, Jira, roff man, roff ms, plain text,
31 Emacs Org-Mode, AsciiDoc, Haddock markup,
29 Emacs Org-Mode, AsciiDoc, Haddock markup,
32 EPUB (v2 and v3), ipynb, FictionBook2,
30 EPUB (v2 and v3), ipynb, FictionBook2,
33− InDesign ICML, Muse, CSL JSON, LaTeX beamer slides,
31+ InDesign ICML, Muse, LaTeX beamer slides,
34 and several kinds of HTML/JavaScript slide shows
32 and several kinds of HTML/JavaScript slide shows
35 (S5, Slidy, Slideous, DZSlides, reveal.js).
33 (S5, Slidy, Slideous, DZSlides, reveal.js).
36 .
34 .
@@ -56,8 +54,6 @@ data-files:
56 data/templates/default.icml
54 data/templates/default.icml
57 data/templates/default.opml
55 data/templates/default.opml
58 data/templates/default.latex
56 data/templates/default.latex
59− data/templates/default.bibtex
60− data/templates/default.biblatex
61 data/templates/default.context
57 data/templates/default.context
62 data/templates/default.texinfo
58 data/templates/default.texinfo
63 data/templates/default.jira
59 data/templates/default.jira
@@ -86,7 +82,6 @@ data-files:
86 data/templates/default.epub2
82 data/templates/default.epub2
87 data/templates/default.epub3
83 data/templates/default.epub3
88 data/templates/article.jats_publishing
84 data/templates/article.jats_publishing
89− data/templates/affiliations.jats
90 -- translations
85 -- translations
91 data/translations/*.yaml
86 data/translations/*.yaml
92 -- source files for reference.docx
87 -- source files for reference.docx
@@ -182,9 +177,8 @@ data-files:
182 data/pandoc.List.lua
177 data/pandoc.List.lua
183 -- bash completion template
178 -- bash completion template
184 data/bash_completion.tpl
179 data/bash_completion.tpl
185− -- citeproc
180+ -- jats csl
186− data/default.csl
181+ data/jats.csl
187− citeproc/biblatex-localization/*.lbx.strings
188 -- documentation
182 -- documentation
189 MANUAL.txt, COPYRIGHT
183 MANUAL.txt, COPYRIGHT
190extra-source-files:
184extra-source-files:
@@ -206,27 +200,12 @@ extra-source-files:
206 test/bodybg.gif
200 test/bodybg.gif
207 test/*.native
201 test/*.native
208 test/command/*.md
202 test/command/*.md
209− test/command/*.csl
210− test/command/biblio.bib
211− test/command/averroes.bib
212 test/command/A.txt
203 test/command/A.txt
213 test/command/B.txt
204 test/command/B.txt
214 test/command/C.txt
205 test/command/C.txt
215 test/command/D.txt
206 test/command/D.txt
216− test/command/01.csv
217− test/command/chap1/spider.png
218− test/command/chap2/spider.png
219− test/command/chap1/text.md
220− test/command/chap2/text.md
221 test/command/defaults1.yaml
207 test/command/defaults1.yaml
222 test/command/defaults2.yaml
208 test/command/defaults2.yaml
223− test/command/defaults3.yaml
224− test/command/defaults4.yaml
225− test/command/defaults5.yaml
226− test/command/defaults6.yaml
227− test/command/defaults7.yaml
228− test/command/defaults8.yaml
229− test/command/defaults9.yaml
230 test/command/3533-rst-csv-tables.csv
209 test/command/3533-rst-csv-tables.csv
231 test/command/3880.txt
210 test/command/3880.txt
232 test/command/5182.txt
211 test/command/5182.txt
@@ -298,7 +277,6 @@ extra-source-files:
298 test/tables.opendocument
277 test/tables.opendocument
299 test/tables.org
278 test/tables.org
300 test/tables.asciidoc
279 test/tables.asciidoc
301− test/tables.asciidoctor
302 test/tables.haddock
280 test/tables.haddock
303 test/tables.texinfo
281 test/tables.texinfo
304 test/tables.rst
282 test/tables.rst
@@ -308,11 +286,6 @@ extra-source-files:
308 test/tables.muse
286 test/tables.muse
309 test/tables.custom
287 test/tables.custom
310 test/tables.xwiki
288 test/tables.xwiki
311− test/tables/*.html4
312− test/tables/*.html5
313− test/tables/*.latex
314− test/tables/*.native
315− test/tables/*.jats_archiving
316 test/testsuite.txt
289 test/testsuite.txt
317 test/writer.latex
290 test/writer.latex
318 test/writer.context
291 test/writer.context
@@ -333,7 +306,6 @@ extra-source-files:
333 test/writer.opendocument
306 test/writer.opendocument
334 test/writer.org
307 test/writer.org
335 test/writer.asciidoc
308 test/writer.asciidoc
336− test/writer.asciidoctor
337 test/writer.haddock
309 test/writer.haddock
338 test/writer.rst
310 test/writer.rst
339 test/writer.icml
311 test/writer.icml
@@ -392,6 +364,10 @@ source-repository head
392 type: git
364 type: git
393 location: git://github.com/jgm/pandoc.git
365 location: git://github.com/jgm/pandoc.git
394
366
367+flag static
368+ Description: Use static linking for pandoc executable.
369+ Default: False
370+
395flag embed_data_files
371flag embed_data_files
396 Description: Embed data files in binary for relocatable executable.
372 Description: Embed data files in binary for relocatable executable.
397 Default: False
373 Default: False
@@ -400,116 +376,101 @@ flag trypandoc
400 Description: Build trypandoc cgi executable.
376 Description: Build trypandoc cgi executable.
401 Default: False
377 Default: False
402
378
403−common common-options
379+library
404− default-language: Haskell2010
405− build-depends: base >= 4.9 && < 5
380+ build-depends: base >= 4.9 && < 5,
406− ghc-options: -Wall -fno-warn-unused-do-bind
381+ syb >= 0.1 && < 0.8,
407− -Wincomplete-record-updates
382+ containers >= 0.4.2.1 && < 0.7,
408− -Wnoncanonical-monad-instances
383+ unordered-containers >= 0.2 && < 0.3,
409−
384+ parsec >= 3.1 && < 3.2,
385+ mtl >= 2.2 && < 2.3,
386+ exceptions >= 0.8 && < 0.11,
387+ filepath >= 1.1 && < 1.5,
388+ process >= 1.2.3 && < 1.7,
389+ directory >= 1.2.3 && < 1.4,
390+ bytestring >= 0.9 && < 0.11,
391+ text >= 1.1.1.0 && < 1.3,
392+ time >= 1.5 && < 1.10,
393+ safe >= 0.3 && < 0.4,
394+ zip-archive >= 0.2.3.4 && < 0.5,
395+ HTTP >= 4000.0.5 && < 4000.4,
396+ texmath >= 0.12.0.2 && < 0.13,
397+ xml >= 1.3.12 && < 1.4,
398+ split >= 0.2 && < 0.3,
399+ random >= 1 && < 1.2,
400+ pandoc-types >= 1.21 && < 1.22,
401+ aeson >= 0.7 && < 1.6,
402+ scientific >= 0.3 && < 0.4,
403+ aeson-pretty >= 0.8.5 && < 0.9,
404+ tagsoup >= 0.14.6 && < 0.15,
405+ base64-bytestring >= 0.1 && < 1.2,
406+ zlib >= 0.5 && < 0.7,
407+ skylighting >= 0.8.5 && < 0.9,
408+ skylighting-core >= 0.8.5 && < 0.9,
409+ data-default >= 0.4 && < 0.8,
410+ temporary >= 1.1 && < 1.4,
411+ blaze-html >= 0.9 && < 0.10,
412+ blaze-markup >= 0.8 && < 0.9,
413+ jira-wiki-markup >= 1.3.1 && < 1.4,
414+ hslua >= 1.1 && < 1.2,
415+ hslua-module-system >= 0.2 && < 0.3,
416+ hslua-module-text >= 0.2.1 && < 0.3,
417+ binary >= 0.5 && < 0.11,
418+ SHA >= 1.6 && < 1.7,
419+ haddock-library >= 1.8 && < 1.10,
420+ deepseq >= 1.3 && < 1.5,
421+ JuicyPixels >= 3.1.6.1 && < 3.4,
422+ Glob >= 0.7 && < 0.11,
423+ cmark-gfm >= 0.2 && < 0.3,
424+ doctemplates >= 0.8.2 && < 0.9,
425+ network-uri >= 2.6 && < 2.7,
426+ network >= 2.6,
427+ connection >= 0.3.1,
428+ http-client >= 0.4.30 && < 0.8,
429+ http-client-tls >= 0.2.4 && < 0.4,
430+ http-types >= 0.8 && < 0.13,
431+ case-insensitive >= 1.2 && < 1.3,
432+ unicode-transforms >= 0.3 && < 0.4,
433+ HsYAML >= 0.2 && < 0.3,
434+ doclayout >= 0.3 && < 0.4,
435+ ipynb >= 0.1 && < 0.2,
436+ attoparsec >= 0.12 && < 0.14,
437+ text-conversions >= 0.3 && < 0.4,
438+ emojis >= 0.1 && < 0.2
439+ if os(windows) && arch(i386)
440+ build-depends: basement >= 0.0.10,
441+ foundation >= 0.0.23
442+ -- basement 0.0.9 won't build on 32-bit windows.
410 if impl(ghc < 8.4)
443 if impl(ghc < 8.4)
411− hs-source-dirs: prelude
444+ hs-source-dirs: prelude
412− other-modules: Prelude
445+ other-modules: Prelude
413− build-depends: base-compat >= 0.9
446+ build-depends: base-compat >= 0.9
414− other-extensions: NoImplicitPrelude
415−
416 if os(windows)
447 if os(windows)
417 cpp-options: -D_WINDOWS
448 cpp-options: -D_WINDOWS
418−
449+ else
450+ build-depends: unix >= 2.4 && < 2.8
451+ if flag(embed_data_files)
452+ cpp-options: -DEMBED_DATA_FILES
453+ build-depends: file-embed >= 0.0 && < 0.1
454+ other-modules: Text.Pandoc.Data
455+ if os(windows)
456+ cpp-options: -D_WINDOWS
457+ ghc-options: -Wall -fno-warn-unused-do-bind
458+ -Wincomplete-record-updates
459+ -Wnoncanonical-monad-instances
419 -- Later:
460 -- Later:
420 -- -Wpartial-fields (currently used in Powerpoint writer)
461 -- -Wpartial-fields (currently used in Powerpoint writer)
421 -- -Wmissing-export-lists (currently some Odt modules violate this)
462 -- -Wmissing-export-lists (currently some Odt modules violate this)
422 -- -Wredundant-constraints (problematic if we want to support older base)
463 -- -Wredundant-constraints (problematic if we want to support older base)
423 if impl(ghc >= 8.2)
464 if impl(ghc >= 8.2)
424− ghc-options: -Wcpp-undef
465+ ghc-options: -Wcpp-undef
425 if impl(ghc >= 8.4)
466 if impl(ghc >= 8.4)
426− ghc-options: -Wincomplete-uni-patterns
467+ ghc-options: -Wincomplete-uni-patterns
427− -Widentities
468+ -Widentities
469+ -Werror=missing-home-modules
428− -fhide-source-paths
470+ -fhide-source-paths
429−
430−common common-executable
431− import: common-options
432− build-depends: pandoc
433− ghc-options: -rtsopts -with-rtsopts=-A8m -threaded
434−
435
471
436−library
472+ default-language: Haskell2010
437− import: common-options
473+ other-extensions: NoImplicitPrelude
438− build-depends: Glob >= 0.7 && < 0.11,
439− HTTP >= 4000.0.5 && < 4000.4,
440− HsYAML >= 0.2 && < 0.3,
441− JuicyPixels >= 3.1.6.1 && < 3.4,
442− SHA >= 1.6 && < 1.7,
443− aeson >= 0.7 && < 1.6,
444− aeson-pretty >= 0.8.5 && < 0.9,
445− array >= 0.5 && < 0.6,
446− attoparsec >= 0.12 && < 0.15,
447− base64-bytestring >= 0.1 && < 1.3,
448− binary >= 0.7 && < 0.11,
449− blaze-html >= 0.9 && < 0.10,
450− blaze-markup >= 0.8 && < 0.9,
451− bytestring >= 0.9 && < 0.12,
452− case-insensitive >= 1.2 && < 1.3,
453− citeproc >= 0.4.0.1 && < 0.4.1,
454− commonmark >= 0.2.1 && < 0.3,
455− commonmark-extensions >= 0.2.1.2 && < 0.3,
456− commonmark-pandoc >= 0.2.1.1 && < 0.3,
457− connection >= 0.3.1,
458− containers >= 0.4.2.1 && < 0.7,
459− data-default >= 0.4 && < 0.8,
460− deepseq >= 1.3 && < 1.5,
461− directory >= 1.2.3 && < 1.4,
462− doclayout >= 0.3.0.1 && < 0.4,
463− doctemplates >= 0.9 && < 0.10,
464− emojis >= 0.1 && < 0.2,
465− exceptions >= 0.8 && < 0.11,
466− file-embed >= 0.0 && < 0.1,
467− filepath >= 1.1 && < 1.5,
468− haddock-library >= 1.10 && < 1.11,
469− hslua >= 1.1 && < 1.4,
470− hslua-module-path >= 0.1.0 && < 0.2.0,
471− hslua-module-system >= 0.2 && < 0.3,
472− hslua-module-text >= 0.2.1 && < 0.4,
473− http-client >= 0.4.30 && < 0.8,
474− http-client-tls >= 0.2.4 && < 0.4,
475− http-types >= 0.8 && < 0.13,
476− ipynb >= 0.1 && < 0.2,
477− jira-wiki-markup >= 1.4 && < 1.5,
478− mtl >= 2.2 && < 2.3,
479− network >= 2.6,
480− network-uri >= 2.6 && < 2.8,
481− pandoc-types >= 1.22 && < 1.23,
482− parsec >= 3.1 && < 3.2,
483− process >= 1.2.3 && < 1.7,
484− random >= 1 && < 1.3,
485− safe >= 0.3.18 && < 0.4,
486− scientific >= 0.3 && < 0.4,
487− skylighting >= 0.10.5.2 && < 0.10.6,
488− skylighting-core >= 0.10.5.2 && < 0.10.6,
489− split >= 0.2 && < 0.3,
490− syb >= 0.1 && < 0.8,
491− tagsoup >= 0.14.6 && < 0.15,
492− temporary >= 1.1 && < 1.4,
493− texmath >= 0.12.3 && < 0.12.4,
494− text >= 1.1.1.0 && < 1.3,
495− text-conversions >= 0.3 && < 0.4,
496− time >= 1.5 && < 1.12,
497− unicode-transforms >= 0.3 && < 0.4,
498− unordered-containers >= 0.2 && < 0.3,
499− xml >= 1.3.12 && < 1.4,
500− xml-conduit >= 1.9.1.1 && < 1.10,
501− unicode-collation >= 0.1.1 && < 0.2,
502− zip-archive >= 0.2.3.4 && < 0.5,
503− zlib >= 0.5 && < 0.7
504− if os(windows) && arch(i386)
505− build-depends: basement >= 0.0.10,
506− foundation >= 0.0.23
507− -- basement 0.0.9 won't build on 32-bit windows.
508− if !os(windows)
509− build-depends: unix >= 2.4 && < 2.8
510− if flag(embed_data_files)
511− cpp-options: -DEMBED_DATA_FILES
512− other-modules: Text.Pandoc.Data
513 hs-source-dirs: src
474 hs-source-dirs: src
514
475
515 exposed-modules: Text.Pandoc,
476 exposed-modules: Text.Pandoc,
@@ -517,18 +478,16 @@ library
517 Text.Pandoc.Options,
478 Text.Pandoc.Options,
518 Text.Pandoc.Extensions,
479 Text.Pandoc.Extensions,
519 Text.Pandoc.Shared,
480 Text.Pandoc.Shared,
520− Text.Pandoc.Sources,
521 Text.Pandoc.MediaBag,
481 Text.Pandoc.MediaBag,
522 Text.Pandoc.Error,
482 Text.Pandoc.Error,
523 Text.Pandoc.Filter,
483 Text.Pandoc.Filter,
524 Text.Pandoc.Readers,
484 Text.Pandoc.Readers,
525 Text.Pandoc.Readers.HTML,
485 Text.Pandoc.Readers.HTML,
526 Text.Pandoc.Readers.LaTeX,
486 Text.Pandoc.Readers.LaTeX,
487+ Text.Pandoc.Readers.LaTeX.Types,
527 Text.Pandoc.Readers.Markdown,
488 Text.Pandoc.Readers.Markdown,
528 Text.Pandoc.Readers.CommonMark,
489 Text.Pandoc.Readers.CommonMark,
529 Text.Pandoc.Readers.Creole,
490 Text.Pandoc.Readers.Creole,
530− Text.Pandoc.Readers.BibTeX,
531− Text.Pandoc.Readers.CslJson,
532 Text.Pandoc.Readers.MediaWiki,
491 Text.Pandoc.Readers.MediaWiki,
533 Text.Pandoc.Readers.Vimwiki,
492 Text.Pandoc.Readers.Vimwiki,
534 Text.Pandoc.Readers.RST,
493 Text.Pandoc.Readers.RST,
@@ -587,12 +546,9 @@ library
587 Text.Pandoc.Writers.FB2,
546 Text.Pandoc.Writers.FB2,
588 Text.Pandoc.Writers.TEI,
547 Text.Pandoc.Writers.TEI,
589 Text.Pandoc.Writers.Muse,
548 Text.Pandoc.Writers.Muse,
590− Text.Pandoc.Writers.CslJson,
591 Text.Pandoc.Writers.Math,
549 Text.Pandoc.Writers.Math,
592 Text.Pandoc.Writers.Shared,
550 Text.Pandoc.Writers.Shared,
593 Text.Pandoc.Writers.OOXML,
551 Text.Pandoc.Writers.OOXML,
594− Text.Pandoc.Writers.AnnotatedTable,
595− Text.Pandoc.Writers.BibTeX,
596 Text.Pandoc.Lua,
552 Text.Pandoc.Lua,
597 Text.Pandoc.PDF,
553 Text.Pandoc.PDF,
598 Text.Pandoc.UTF8,
554 Text.Pandoc.UTF8,
@@ -607,8 +563,8 @@ library
607 Text.Pandoc.Asciify,
563 Text.Pandoc.Asciify,
608 Text.Pandoc.Emoji,
564 Text.Pandoc.Emoji,
609 Text.Pandoc.ImageSize,
565 Text.Pandoc.ImageSize,
610− Text.Pandoc.Class,
566+ Text.Pandoc.BCP47,
611− Text.Pandoc.Citeproc
567+ Text.Pandoc.Class
612 other-modules: Text.Pandoc.App.CommandLineOptions,
568 other-modules: Text.Pandoc.App.CommandLineOptions,
613 Text.Pandoc.App.FormatHeuristics,
569 Text.Pandoc.App.FormatHeuristics,
614 Text.Pandoc.App.Opt,
570 Text.Pandoc.App.Opt,
@@ -627,19 +583,8 @@ library
627 Text.Pandoc.Readers.Docx.Parse.Styles,
583 Text.Pandoc.Readers.Docx.Parse.Styles,
628 Text.Pandoc.Readers.Docx.Util,
584 Text.Pandoc.Readers.Docx.Util,
629 Text.Pandoc.Readers.Docx.Fields,
585 Text.Pandoc.Readers.Docx.Fields,
630− Text.Pandoc.Readers.HTML.Parsing,
631− Text.Pandoc.Readers.HTML.Table,
632− Text.Pandoc.Readers.HTML.TagCategories,
633− Text.Pandoc.Readers.HTML.Types,
634− Text.Pandoc.Readers.LaTeX.Inline,
635− Text.Pandoc.Readers.LaTeX.Citation,
636− Text.Pandoc.Readers.LaTeX.Lang,
637− Text.Pandoc.Readers.LaTeX.Macro,
638− Text.Pandoc.Readers.LaTeX.Math,
639 Text.Pandoc.Readers.LaTeX.Parsing,
586 Text.Pandoc.Readers.LaTeX.Parsing,
640− Text.Pandoc.Readers.LaTeX.SIunitx,
587+ Text.Pandoc.Readers.LaTeX.Lang,
641− Text.Pandoc.Readers.LaTeX.Table,
642− Text.Pandoc.Readers.LaTeX.Types,
643 Text.Pandoc.Readers.Odt.Base,
588 Text.Pandoc.Readers.Odt.Base,
644 Text.Pandoc.Readers.Odt.Namespaces,
589 Text.Pandoc.Readers.Odt.Namespaces,
645 Text.Pandoc.Readers.Odt.StyleReader,
590 Text.Pandoc.Readers.Odt.StyleReader,
@@ -663,21 +608,6 @@ library
663 Text.Pandoc.Readers.Metadata,
608 Text.Pandoc.Readers.Metadata,
664 Text.Pandoc.Readers.Roff,
609 Text.Pandoc.Readers.Roff,
665 Text.Pandoc.Writers.Docx.StyleMap,
610 Text.Pandoc.Writers.Docx.StyleMap,
666− Text.Pandoc.Writers.Docx.Table,
667− Text.Pandoc.Writers.Docx.Types,
668− Text.Pandoc.Writers.GridTable
669− Text.Pandoc.Writers.JATS.References,
670− Text.Pandoc.Writers.JATS.Table,
671− Text.Pandoc.Writers.JATS.Types,
672− Text.Pandoc.Writers.LaTeX.Caption,
673− Text.Pandoc.Writers.LaTeX.Notes,
674− Text.Pandoc.Writers.LaTeX.Table,
675− Text.Pandoc.Writers.LaTeX.Lang,
676− Text.Pandoc.Writers.LaTeX.Types,
677− Text.Pandoc.Writers.LaTeX.Citation,
678− Text.Pandoc.Writers.LaTeX.Util,
679− Text.Pandoc.Writers.Markdown.Types,
680− Text.Pandoc.Writers.Markdown.Inline,
681 Text.Pandoc.Writers.Roff,
611 Text.Pandoc.Writers.Roff,
682 Text.Pandoc.Writers.Powerpoint.Presentation,
612 Text.Pandoc.Writers.Powerpoint.Presentation,
683 Text.Pandoc.Writers.Powerpoint.Output,
613 Text.Pandoc.Writers.Powerpoint.Output,
@@ -694,7 +624,6 @@ library
694 Text.Pandoc.Lua.Marshaling.MediaBag,
624 Text.Pandoc.Lua.Marshaling.MediaBag,
695 Text.Pandoc.Lua.Marshaling.PandocError,
625 Text.Pandoc.Lua.Marshaling.PandocError,
696 Text.Pandoc.Lua.Marshaling.ReaderOptions,
626 Text.Pandoc.Lua.Marshaling.ReaderOptions,
697− Text.Pandoc.Lua.Marshaling.SimpleTable,
698 Text.Pandoc.Lua.Marshaling.Version,
627 Text.Pandoc.Lua.Marshaling.Version,
699 Text.Pandoc.Lua.Module.MediaBag,
628 Text.Pandoc.Lua.Module.MediaBag,
700 Text.Pandoc.Lua.Module.Pandoc,
629 Text.Pandoc.Lua.Module.Pandoc,
@@ -705,10 +634,6 @@ library
705 Text.Pandoc.Lua.PandocLua,
634 Text.Pandoc.Lua.PandocLua,
706 Text.Pandoc.Lua.Util,
635 Text.Pandoc.Lua.Util,
707 Text.Pandoc.Lua.Walk,
636 Text.Pandoc.Lua.Walk,
708− Text.Pandoc.XML.Light,
709− Text.Pandoc.XML.Light.Types,
710− Text.Pandoc.XML.Light.Proc,
711− Text.Pandoc.XML.Light.Output,
712 Text.Pandoc.CSS,
637 Text.Pandoc.CSS,
713 Text.Pandoc.CSV,
638 Text.Pandoc.CSV,
714 Text.Pandoc.RoffChar,
639 Text.Pandoc.RoffChar,
@@ -716,61 +641,127 @@ library
716 Text.Pandoc.Translations,
641 Text.Pandoc.Translations,
717 Text.Pandoc.Slides,
642 Text.Pandoc.Slides,
718 Text.Pandoc.Image,
643 Text.Pandoc.Image,
719− Text.Pandoc.Citeproc.BibTeX,
720− Text.Pandoc.Citeproc.CslJson,
721− Text.Pandoc.Citeproc.Data,
722− Text.Pandoc.Citeproc.Locator,
723− Text.Pandoc.Citeproc.MetaValue,
724− Text.Pandoc.Citeproc.Util,
725 Paths_pandoc
644 Paths_pandoc
726 autogen-modules: Paths_pandoc
645 autogen-modules: Paths_pandoc
727 buildable: True
646 buildable: True
728
647
729executable pandoc
648executable pandoc
730− import: common-executable
649+ build-depends: pandoc, base >= 4.8 && < 5
650+ if impl(ghc < 8.4)
651+ hs-source-dirs: prelude
652+ other-modules: Prelude
653+ build-depends: base-compat >= 0.9
654+ if flag(static)
655+ ld-options: -static
656+ default-language: Haskell2010
657+ other-extensions: NoImplicitPrelude
731− hs-source-dirs: app
658+ hs-source-dirs: .
732 main-is: pandoc.hs
659 main-is: pandoc.hs
733 buildable: True
660 buildable: True
734 other-modules: Paths_pandoc
661 other-modules: Paths_pandoc
662+ ghc-options: -rtsopts -with-rtsopts=-K16m -threaded
663+ -Wall -fno-warn-unused-do-bind
664+ -Wincomplete-record-updates
665+ -Wnoncanonical-monad-instances
666+ if impl(ghc >= 8.2)
667+ ghc-options: -Wcpp-undef
668+ if impl(ghc >= 8.4)
669+ ghc-options: -Wincomplete-uni-patterns
670+ -Widentities
671+ -Werror=missing-home-modules
672+ -fhide-source-paths
735
673
736executable trypandoc
674executable trypandoc
737− import: common-executable
738 main-is: trypandoc.hs
675 main-is: trypandoc.hs
739 hs-source-dirs: trypandoc
676 hs-source-dirs: trypandoc
677+ default-language: Haskell2010
678+ other-extensions: NoImplicitPrelude
740 if flag(trypandoc)
679 if flag(trypandoc)
741− build-depends: aeson, http-types, text, wai >= 0.3, wai-extra >= 3.0.24
680+ build-depends: base, aeson, pandoc,
681+ text, wai-extra, wai >= 0.3, http-types
742 buildable: True
682 buildable: True
743 else
683 else
744 buildable: False
684 buildable: False
685+ if impl(ghc < 8.4)
686+ hs-source-dirs: prelude
687+ other-modules: Prelude
688+ build-depends: base-compat >= 0.9
689+ ghc-options: -rtsopts -with-rtsopts=-K16m -threaded
690+ -Wall -fno-warn-unused-do-bind
691+ -Wincomplete-record-updates
692+ -Wnoncanonical-monad-instances
693+ if impl(ghc >= 8.2)
694+ ghc-options: -Wcpp-undef
695+ if impl(ghc >= 8.4)
696+ ghc-options: -Wincomplete-uni-patterns
697+ -Widentities
698+ -Werror=missing-home-modules
699+ -fhide-source-paths
700+
701+benchmark weigh-pandoc
702+ type: exitcode-stdio-1.0
703+ main-is: weigh-pandoc.hs
704+ hs-source-dirs: benchmark
705+ build-depends: pandoc,
706+ base >= 4.8 && < 5,
707+ text,
708+ weigh >= 0.0 && < 0.1,
709+ mtl >= 2.2 && < 2.3
710+ if impl(ghc < 8.4)
711+ hs-source-dirs: prelude
712+ other-modules: Prelude
713+ build-depends: base-compat >= 0.9
714+ default-language: Haskell2010
715+ other-extensions: NoImplicitPrelude
716+ ghc-options: -rtsopts -with-rtsopts=-K16m -threaded
717+ -Wall -fno-warn-unused-do-bind
718+ -Wincomplete-record-updates
719+ -Wnoncanonical-monad-instances
720+ if impl(ghc >= 8.2)
721+ ghc-options: -Wcpp-undef
722+ if impl(ghc >= 8.4)
723+ ghc-options: -Wincomplete-uni-patterns
724+ -Widentities
725+ -Werror=missing-home-modules
726+ -fhide-source-paths
727+
745
728
746test-suite test-pandoc
729test-suite test-pandoc
747− import: common-executable
748 type: exitcode-stdio-1.0
730 type: exitcode-stdio-1.0
749 main-is: test-pandoc.hs
731 main-is: test-pandoc.hs
750 hs-source-dirs: test
732 hs-source-dirs: test
751− build-depends: pandoc,
733+ build-depends: base >= 4.8 && < 5,
752− Diff >= 0.2 && < 0.5,
734+ pandoc,
753− Glob >= 0.7 && < 0.11,
735+ pandoc-types >= 1.21 && < 1.22,
754− QuickCheck >= 2.4 && < 2.15,
736+ mtl >= 2.2 && < 2.3,
755− bytestring >= 0.9 && < 0.12,
737+ bytestring >= 0.9 && < 0.11,
756− containers >= 0.4.2.1 && < 0.7,
738+ base64-bytestring >= 0.1 && < 1.2,
739+ exceptions >= 0.8 && < 0.11,
740+ text >= 1.1.1.0 && < 1.3,
741+ time >= 1.5 && < 1.10,
757− directory >= 1.2.3 && < 1.4,
742+ directory >= 1.2.3 && < 1.4,
758− doctemplates >= 0.9 && < 0.10,
743+ exceptions >= 0.8 && < 0.11,
759− exceptions >= 0.8 && < 0.11,
760− filepath >= 1.1 && < 1.5,
744+ filepath >= 1.1 && < 1.5,
761− hslua >= 1.1 && < 1.4,
745+ hslua >= 1.1 && < 1.2,
762− mtl >= 2.2 && < 2.3,
763− pandoc-types >= 1.22 && < 1.23,
764− process >= 1.2.3 && < 1.7,
746+ process >= 1.2.3 && < 1.7,
765− tasty >= 0.11 && < 1.5,
747+ temporary >= 1.1 && < 1.4,
748+ Diff >= 0.2 && < 0.5,
766− tasty-golden >= 2.3 && < 2.4,
749+ tasty >= 0.11 && < 1.4,
767− tasty-hunit >= 0.9 && < 0.11,
750+ tasty-hunit >= 0.9 && < 0.11,
768− tasty-lua >= 0.2 && < 0.3,
751+ tasty-lua >= 0.2 && < 0.3,
769− tasty-quickcheck >= 0.8 && < 0.11,
752+ tasty-quickcheck >= 0.8 && < 0.11,
770− text >= 1.1.1.0 && < 1.3,
753+ tasty-golden >= 2.3 && < 2.4,
771− time >= 1.5 && < 1.12,
754+ QuickCheck >= 2.4 && < 2.15,
772− xml >= 1.3.12 && < 1.4,
755+ containers >= 0.4.2.1 && < 0.7,
756+ executable-path >= 0.0 && < 0.1,
773− zip-archive >= 0.2.3.4 && < 0.5
757+ zip-archive >= 0.2.3.4 && < 0.5,
758+ xml >= 1.3.12 && < 1.4,
759+ doctemplates >= 0.8.2 && < 0.9,
760+ Glob >= 0.7 && < 0.11
761+ if impl(ghc < 8.4)
762+ hs-source-dirs: prelude
763+ other-modules: Prelude
764+ build-depends: base-compat >= 0.9
774 other-modules: Tests.Old
765 other-modules: Tests.Old
775 Tests.Command
766 Tests.Command
776 Tests.Helpers
767 Tests.Helpers
@@ -824,21 +815,47 @@ test-suite test-pandoc
824 Tests.Writers.FB2
815 Tests.Writers.FB2
825 Tests.Writers.Powerpoint
816 Tests.Writers.Powerpoint
826 Tests.Writers.OOXML
817 Tests.Writers.OOXML
827− Tests.Writers.Ms
818+ if os(windows)
828− Tests.Writers.AnnotatedTable
819+ cpp-options: -D_WINDOWS
820+ default-language: Haskell2010
821+ other-extensions: NoImplicitPrelude
822+ ghc-options: -rtsopts -with-rtsopts=-K16m -threaded
823+ -Wall -fno-warn-unused-do-bind
824+ -Wincomplete-record-updates
825+ -Wnoncanonical-monad-instances
826+ if impl(ghc >= 8.2)
827+ ghc-options: -Wcpp-undef
828+ if impl(ghc >= 8.4)
829+ ghc-options: -Wincomplete-uni-patterns
830+ -Widentities
831+ -Werror=missing-home-modules
832+ -fhide-source-paths
833+
829
834
830benchmark benchmark-pandoc
835benchmark benchmark-pandoc
831− import: common-executable
832 type: exitcode-stdio-1.0
836 type: exitcode-stdio-1.0
833 main-is: benchmark-pandoc.hs
837 main-is: benchmark-pandoc.hs
834 hs-source-dirs: benchmark
838 hs-source-dirs: benchmark
835− build-depends: bytestring,
839+ build-depends: pandoc,
836− containers,
840+ time, bytestring, containers,
837− -- gauge >= 0.2 && < 0.3,
841+ base >= 4.8 && < 5,
838− tasty-bench >= 0.2 && <= 0.3,
842+ text >= 1.1.1.0 && < 1.3,
839− mtl >= 2.2 && < 2.3,
843+ mtl >= 2.2 && < 2.3,
840− text >= 1.1.1.0 && < 1.3,
844+ criterion >= 1.0 && < 1.6
841− time,
845+ if impl(ghc < 8.4)
842− deepseq
846+ hs-source-dirs: prelude
843− -- we increase heap size to avoid benchmarking garbage collection:
847+ other-modules: Prelude
848+ build-depends: base-compat >= 0.9
849+ default-language: Haskell2010
850+ other-extensions: NoImplicitPrelude
844− ghc-options: -rtsopts -with-rtsopts=-A8m -threaded
851+ ghc-options: -rtsopts -with-rtsopts=-K16m -threaded
852+ -Wall -fno-warn-unused-do-bind
853+ -Wincomplete-record-updates
854+ -Wnoncanonical-monad-instances
855+ if impl(ghc >= 8.2)
856+ ghc-options: -Wcpp-undef
857+ if impl(ghc >= 8.4)
858+ ghc-options: -Wincomplete-uni-patterns
859+ -Widentities
860+ -Werror=missing-home-modules
861+ -fhide-source-paths
app/pandoc.hs → pandoc.hsrenamed+3−1
@@ -1,6 +1,7 @@
1+{-# LANGUAGE NoImplicitPrelude #-}
1{- |
2{- |
2 Module : Main
3 Module : Main
3− Copyright : Copyright (C) 2006-2021 John MacFarlane
4+ Copyright : Copyright (C) 2006-2020 John MacFarlane
4 License : GNU GPL, version 2 or above
5 License : GNU GPL, version 2 or above
5
6
6 Maintainer : John MacFarlane <jgm@berkeley@edu>
7 Maintainer : John MacFarlane <jgm@berkeley@edu>
@@ -11,6 +12,7 @@ Parses command-line options and calls the appropriate readers and
11writers.
12writers.
12-}
13-}
13module Main where
14module Main where
15+import Prelude
14import qualified Control.Exception as E
16import qualified Control.Exception as E
15import Text.Pandoc.App (convertWithOpts, defaultOpts, options, parseOptions)
17import Text.Pandoc.App (convertWithOpts, defaultOpts, options, parseOptions)
16import Text.Pandoc.Error (handleError)
18import Text.Pandoc.Error (handleError)
release.nixdeleted−4
@@ -1,4 +0,0 @@
1−let
2− pkgs = import <nixpkgs> { };
3−in
4− pkgs.haskellPackages.callPackage ./project.nix { }
shell.nixdeleted−106
@@ -1,106 +0,0 @@
1−{nixpkgs ? import <nixpkgs> {} }:
2−let
3− inherit (nixpkgs) pkgs;
4− inherit (pkgs) haskellPackages;
5−
6− haskellDeps = ps: with ps; [
7− Diff
8− Glob
9− HTTP
10− HTTP
11− HsYAML
12− JuicyPixels
13− QuickCheck
14− SHA
15− aeson
16− aeson-pretty
17− attoparsec
18− base
19− base-compat
20− base64-bytestring
21− binary
22− blaze-html
23− blaze-markup
24− bytestring
25− case-insensitive
26− citeproc
27− commonmark
28− commonmark-extensions
29− commonmark-pandoc
30− conduit-extra
31− connection
32− connection
33− containers
34− data-default
35− deepseq
36− directory
37− doclayout
38− doctemplates
39− emojis
40− exceptions
41− file-embed
42− filepath
43− haddock-library
44− hsc2hs
45− hslua
46− hslua-module-system
47− hslua-module-text
48− http-client
49− http-client
50− http-client-tls
51− http-client-tls
52− http-types
53− ipynb
54− jira-wiki-markup
55− mtl
56− network
57− network
58− network-uri
59− pandoc-types
60− parsec
61− process
62− random
63− safe
64− scientific
65− skylighting
66− skylighting-core
67− socks
68− split
69− streaming-commons
70− syb
71− tagsoup
72− tasty
73− tasty-golden
74− tasty-hunit
75− tasty-lua
76− tasty-quickcheck
77− temporary
78− texmath
79− text
80− text-conversions
81− time
82− tls
83− unicode-transforms
84− unordered-containers
85− weigh
86− xml
87− xml-conduit
88− zip-archive
89− zlib
90− ];
91−
92− ghc = haskellPackages.ghcWithPackages haskellDeps;
93−
94− nixPackages = [
95− pkgs.zlib
96− ghc
97− pkgs.gdb
98− haskellPackages.ghcid
99− haskellPackages.cabal2nix
100− haskellPackages.cabal-install
101− ];
102−in
103−pkgs.stdenv.mkDerivation {
104− name = "env";
105− buildInputs = nixPackages;
106−}
src/Text/Pandoc.hs+1−1
@@ -3,7 +3,7 @@
3{-# LANGUAGE ScopedTypeVariables #-}
3{-# LANGUAGE ScopedTypeVariables #-}
4{- |
4{- |
5 Module : Text.Pandoc
5 Module : Text.Pandoc
6− Copyright : Copyright (C) 2006-2021 John MacFarlane
6+ Copyright : Copyright (C) 2006-2020 John MacFarlane
7 License : GNU GPL, version 2 or above
7 License : GNU GPL, version 2 or above
8
8
9 Maintainer : John MacFarlane <jgm@berkeley.edu>
9 Maintainer : John MacFarlane <jgm@berkeley.edu>
src/Text/Pandoc/App.hs+66−98
@@ -1,10 +1,9 @@
1−{-# LANGUAGE LambdaCase #-}
2{-# LANGUAGE OverloadedStrings #-}
1{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE CPP #-}
2{-# LANGUAGE CPP #-}
4{-# LANGUAGE ScopedTypeVariables #-}
3{-# LANGUAGE ScopedTypeVariables #-}
5{- |
4{- |
6 Module : Text.Pandoc.App
5 Module : Text.Pandoc.App
7− Copyright : Copyright (C) 2006-2021 John MacFarlane
6+ Copyright : Copyright (C) 2006-2020 John MacFarlane
8 License : GNU GPL, version 2 or above
7 License : GNU GPL, version 2 or above
9
8
10 Maintainer : John MacFarlane <jgm@berkeley@edu>
9 Maintainer : John MacFarlane <jgm@berkeley@edu>
@@ -20,16 +19,14 @@ module Text.Pandoc.App (
20 , Filter(..)
19 , Filter(..)
21 , defaultOpts
20 , defaultOpts
22 , parseOptions
21 , parseOptions
23− , parseOptionsFromArgs
24 , options
22 , options
25 , applyFilters
23 , applyFilters
26 ) where
24 ) where
27import qualified Control.Exception as E
25import qualified Control.Exception as E
28−import Control.Monad ( (>=>), when )
26+import Control.Monad
29−import Control.Monad.Trans ( MonadIO(..) )
27+import Control.Monad.Trans
30import Control.Monad.Except (throwError)
28import Control.Monad.Except (throwError)
31import qualified Data.ByteString as BS
29import qualified Data.ByteString as BS
32−import qualified Data.ByteString.Char8 as B8
33import qualified Data.ByteString.Lazy as BL
30import qualified Data.ByteString.Lazy as BL
34import Data.Char (toLower)
31import Data.Char (toLower)
35import Data.Maybe (fromMaybe, isJust, isNothing)
32import Data.Maybe (fromMaybe, isJust, isNothing)
@@ -43,25 +40,23 @@ import qualified Data.Text.Encoding.Error as TSE
43import Network.URI (URI (..), parseURI)
40import Network.URI (URI (..), parseURI)
44import System.Directory (doesDirectoryExist)
41import System.Directory (doesDirectoryExist)
45import System.Exit (exitSuccess)
42import System.Exit (exitSuccess)
46−import System.FilePath ( takeBaseName, takeExtension )
43+import System.FilePath
47import System.IO (nativeNewline, stdout)
44import System.IO (nativeNewline, stdout)
48import qualified System.IO as IO (Newline (..))
45import qualified System.IO as IO (Newline (..))
49import Text.Pandoc
46import Text.Pandoc
50−import Text.Pandoc.Builder (setMeta)
51−import Text.Pandoc.MIME (getCharset)
52import Text.Pandoc.App.FormatHeuristics (formatFromFilePaths)
47import Text.Pandoc.App.FormatHeuristics (formatFromFilePaths)
53import Text.Pandoc.App.Opt (Opt (..), LineEnding (..), defaultOpts,
48import Text.Pandoc.App.Opt (Opt (..), LineEnding (..), defaultOpts,
54− IpynbOutput (..))
49+ IpynbOutput (..) )
55−import Text.Pandoc.App.CommandLineOptions (parseOptions, parseOptionsFromArgs,
50+import Text.Pandoc.App.CommandLineOptions (parseOptions, options)
56− options)
57import Text.Pandoc.App.OutputSettings (OutputSettings (..), optToOutputSettings)
51import Text.Pandoc.App.OutputSettings (OutputSettings (..), optToOutputSettings)
58−import Text.Collate.Lang (Lang (..), parseLang)
52+import Text.Pandoc.BCP47 (Lang (..), parseBCP47)
53+import Text.Pandoc.Builder (setMeta)
59import Text.Pandoc.Filter (Filter (JSONFilter, LuaFilter), applyFilters)
54import Text.Pandoc.Filter (Filter (JSONFilter, LuaFilter), applyFilters)
60import Text.Pandoc.PDF (makePDF)
55import Text.Pandoc.PDF (makePDF)
61−import Text.Pandoc.SelfContained (makeSelfContained)
56+import Text.Pandoc.SelfContained (makeDataURI, makeSelfContained)
62import Text.Pandoc.Shared (eastAsianLineBreakFilter, stripEmptyParagraphs,
57import Text.Pandoc.Shared (eastAsianLineBreakFilter, stripEmptyParagraphs,
63 headerShift, isURI, tabFilter, uriPathToPath, filterIpynbOutput,
58 headerShift, isURI, tabFilter, uriPathToPath, filterIpynbOutput,
64− defaultUserDataDir, tshow)
59+ defaultUserDataDirs, tshow, findM)
65import Text.Pandoc.Writers.Shared (lookupMetaString)
60import Text.Pandoc.Writers.Shared (lookupMetaString)
66import Text.Pandoc.Readers.Markdown (yamlToMeta)
61import Text.Pandoc.Readers.Markdown (yamlToMeta)
67import qualified Text.Pandoc.UTF8 as UTF8
62import qualified Text.Pandoc.UTF8 as UTF8
@@ -72,29 +67,34 @@ import System.Posix.Terminal (queryTerminal)
72
67
73convertWithOpts :: Opt -> IO ()
68convertWithOpts :: Opt -> IO ()
74convertWithOpts opts = do
69convertWithOpts opts = do
75− datadir <- case optDataDir opts of
76− Nothing -> do
77− d <- defaultUserDataDir
78− exists <- doesDirectoryExist d
79− return $ if exists
80− then Just d
81− else Nothing
82− Just _ -> return $ optDataDir opts
83−
84 let outputFile = fromMaybe "-" (optOutputFile opts)
70 let outputFile = fromMaybe "-" (optOutputFile opts)
85 let filters = optFilters opts
71 let filters = optFilters opts
86 let verbosity = optVerbosity opts
72 let verbosity = optVerbosity opts
87
73
88 when (optDumpArgs opts) $
74 when (optDumpArgs opts) $
89− do UTF8.hPutStrLn stdout (T.pack outputFile)
75+ do UTF8.hPutStrLn stdout outputFile
90− mapM_ (UTF8.hPutStrLn stdout . T.pack)
91− (fromMaybe ["-"] $ optInputFiles opts)
76+ mapM_ (UTF8.hPutStrLn stdout) (fromMaybe ["-"] $ optInputFiles opts)
92 exitSuccess
77 exitSuccess
93
78
79+ let isPandocCiteproc (JSONFilter f) = takeBaseName f == "pandoc-citeproc"
80+ isPandocCiteproc _ = False
81+ -- --bibliography implies -F pandoc-citeproc for backwards compatibility:
82+ let needsCiteproc = isJust (lookupMeta "bibliography"
83+ (optMetadata opts)) &&
84+ optCiteMethod opts `notElem` [Natbib, Biblatex] &&
85+ not (any isPandocCiteproc filters)
86+ let filters' = filters ++ [ JSONFilter "pandoc-citeproc" | needsCiteproc ]
87+
94 let sources = case optInputFiles opts of
88 let sources = case optInputFiles opts of
95 Just xs | not (optIgnoreArgs opts) -> xs
89 Just xs | not (optIgnoreArgs opts) -> xs
96 _ -> ["-"]
90 _ -> ["-"]
97
91
92+ datadir <- case optDataDir opts of
93+ Nothing -> do
94+ ds <- defaultUserDataDirs
95+ findM doesDirectoryExist ds
96+ Just _ -> return $ optDataDir opts
97+
98 let runIO' :: PandocIO a -> IO a
98 let runIO' :: PandocIO a -> IO a
99 runIO' f = do
99 runIO' f = do
100 (res, reports) <- runIOorExplode $ do
100 (res, reports) <- runIOorExplode $ do
@@ -140,10 +140,9 @@ convertWithOpts opts = do
140 (map (T.pack . takeExtension) sources) "markdown"
140 (map (T.pack . takeExtension) sources) "markdown"
141 return "markdown"
141 return "markdown"
142
142
143− let readerNameBase = T.takeWhile (\c -> c /= '+' && c /= '-') readerName
144 let pdfOutput = map toLower (takeExtension outputFile) == ".pdf"
143 let pdfOutput = map toLower (takeExtension outputFile) == ".pdf"
145
144
146− when (pdfOutput && readerNameBase == "latex") $
145+ when (pdfOutput && readerName == "latex") $
147 case optInputFiles opts of
146 case optInputFiles opts of
148 Just (inputFile:_) -> report $ UnusualConversion $ T.pack $
147 Just (inputFile:_) -> report $ UnusualConversion $ T.pack $
149 "to convert a .tex file to PDF, you get better results by using pdflatex "
148 "to convert a .tex file to PDF, you get better results by using pdflatex "
@@ -154,34 +153,24 @@ convertWithOpts opts = do
154 (reader :: Reader PandocIO, readerExts) <- getReader readerName
153 (reader :: Reader PandocIO, readerExts) <- getReader readerName
155
154
156 let convertTabs = tabFilter (if optPreserveTabs opts ||
155 let convertTabs = tabFilter (if optPreserveTabs opts ||
157− readerNameBase == "t2t" ||
156+ readerName == "t2t" ||
158− readerNameBase == "man"
157+ readerName == "man"
159 then 0
158 then 0
160 else optTabStop opts)
159 else optTabStop opts)
161
160
162
161
163− let readSources :: [FilePath] -> PandocIO [(FilePath, Text)]
162+ let readSources :: [FilePath] -> PandocIO Text
164− readSources srcs =
163+ readSources srcs = convertTabs . T.intercalate (T.pack "\n") <$>
165− mapM (\fp -> do
166− t <- readSource fp
164+ mapM readSource srcs
167− return (if fp == "-" then "" else fp, convertTabs t)) srcs
168
165
169
166
170 outputSettings <- optToOutputSettings opts
167 outputSettings <- optToOutputSettings opts
171 let format = outputFormat outputSettings
168 let format = outputFormat outputSettings
172 let writer = outputWriter outputSettings
169 let writer = outputWriter outputSettings
173 let writerName = outputWriterName outputSettings
170 let writerName = outputWriterName outputSettings
174− let writerNameBase = T.takeWhile (\c -> c /= '+' && c /= '-') writerName
175 let writerOptions = outputWriterOptions outputSettings
171 let writerOptions = outputWriterOptions outputSettings
176
172
177− let bibOutput = writerNameBase == "bibtex" ||
178− writerNameBase == "biblatex" ||
179− writerNameBase == "csljson"
180−
181− let standalone = optStandalone opts ||
173+ let standalone = optStandalone opts || not (isTextFormat format) || pdfOutput
182− not (isTextFormat format) ||
183− pdfOutput ||
184− bibOutput
185
174
186 -- We don't want to send output to the terminal if the user
175 -- We don't want to send output to the terminal if the user
187 -- does 'pandoc -t docx input.txt'; though we allow them to
176 -- does 'pandoc -t docx input.txt'; though we allow them to
@@ -201,9 +190,20 @@ convertWithOpts opts = do
201 Nothing -> readDataFile "abbreviations"
190 Nothing -> readDataFile "abbreviations"
202 Just f -> readFileStrict f
191 Just f -> readFileStrict f
203
192
193+ metadata <- if format == "jats" &&
194+ isNothing (lookupMeta "csl" (optMetadata opts)) &&
195+ isNothing (lookupMeta "citation-style"
196+ (optMetadata opts))
197+ then do
198+ jatsCSL <- readDataFile "jats.csl"
199+ let jatsEncoded = makeDataURI
200+ ("application/xml", jatsCSL)
201+ return $ setMeta "csl" jatsEncoded $ optMetadata opts
202+ else return $ optMetadata opts
203+
204 case lookupMetaString "lang" (optMetadata opts) of
204 case lookupMetaString "lang" (optMetadata opts) of
205− "" -> setTranslations $ Lang "en" Nothing (Just "US") [] [] []
205+ "" -> setTranslations $ Lang "en" "" "US" []
206− l -> case parseLang l of
206+ l -> case parseBCP47 l of
207 Left _ -> report $ InvalidLang l
207 Left _ -> report $ InvalidLang l
208 Right l' -> setTranslations l'
208 Right l' -> setTranslations l'
209
209
@@ -223,9 +223,8 @@ convertWithOpts opts = do
223 metadataFromFile <-
223 metadataFromFile <-
224 case optMetadataFiles opts of
224 case optMetadataFiles opts of
225 [] -> return mempty
225 [] -> return mempty
226− paths -> mconcat <$>
226+ paths -> mapM readFileLazy paths >>=
227− mapM (\path -> do raw <- readFileLazy path
228− yamlToMeta readerOpts (Just path) raw) paths
227+ fmap mconcat . mapM (yamlToMeta readerOpts)
229
228
230 let transforms = (case optShiftHeadingLevelBy opts of
229 let transforms = (case optShiftHeadingLevelBy opts of
231 0 -> id
230 0 -> id
@@ -241,7 +240,6 @@ convertWithOpts opts = do
241 then (eastAsianLineBreakFilter :)
240 then (eastAsianLineBreakFilter :)
242 else id) .
241 else id) .
243 (case optIpynbOutput opts of
242 (case optIpynbOutput opts of
244− _ | readerNameBase /= "ipynb" -> id
245 IpynbOutputAll -> id
243 IpynbOutputAll -> id
246 IpynbOutputNone -> (filterIpynbOutput Nothing :)
244 IpynbOutputNone -> (filterIpynbOutput Nothing :)
247 IpynbOutputBest -> (filterIpynbOutput (Just $
245 IpynbOutputBest -> (filterIpynbOutput (Just $
@@ -257,51 +255,31 @@ convertWithOpts opts = do
257 let sourceToDoc :: [FilePath] -> PandocIO Pandoc
255 let sourceToDoc :: [FilePath] -> PandocIO Pandoc
258 sourceToDoc sources' =
256 sourceToDoc sources' =
259 case reader of
257 case reader of
260− TextReader r
258+ TextReader r
261− | readerNameBase == "json" ->
262− mconcat <$> mapM (readSource >=> r readerOpts) sources'
263− | optFileScope opts ->
259+ | optFileScope opts || readerName == "json" ->
264− -- Read source and convert tabs (see #6709)
265− let readSource' = fmap convertTabs . readSource
266− in mconcat <$> mapM (readSource' >=> r readerOpts) sources'
260+ mconcat <$> mapM (readSource >=> r readerOpts) sources'
267− | otherwise ->
261+ | otherwise ->
268− readSources sources' >>= r readerOpts
262+ readSources sources' >>= r readerOpts
269− ByteStringReader r ->
263+ ByteStringReader r ->
270− mconcat <$> mapM (readFile' >=> r readerOpts) sources'
264+ mconcat <$> mapM (readFile' >=> r readerOpts) sources'
271−
265+
272−
266+
273− when (readerNameBase == "markdown_github" ||
267+ when (readerName == "markdown_github" ||
274− writerNameBase == "markdown_github") $
268+ writerName == "markdown_github") $
275 report $ Deprecated "markdown_github" "Use gfm instead."
269 report $ Deprecated "markdown_github" "Use gfm instead."
276
270
277 mapM_ (uncurry setRequestHeader) (optRequestHeaders opts)
271 mapM_ (uncurry setRequestHeader) (optRequestHeaders opts)
278
272
279 setNoCheckCertificate (optNoCheckCertificate opts)
273 setNoCheckCertificate (optNoCheckCertificate opts)
280
274
281− let isPandocCiteproc (JSONFilter f) = takeBaseName f == "pandoc-citeproc"
282− isPandocCiteproc _ = False
283−
284− when (any isPandocCiteproc filters) $
285− report $ Deprecated "pandoc-citeproc filter"
286− "Use --citeproc instead."
287−
288− let cslMetadata =
289− maybe id (setMeta "csl") (optCSL opts) .
290− (case optBibliography opts of
291− [] -> id
292− xs -> setMeta "bibliography" xs) .
293− maybe id (setMeta "citation-abbreviations")
294− (optCitationAbbreviations opts) $ mempty
295−
296 doc <- sourceToDoc sources >>=
275 doc <- sourceToDoc sources >>=
297 ( (if isJust (optExtractMedia opts)
276 ( (if isJust (optExtractMedia opts)
298 then fillMediaBag
277 then fillMediaBag
299 else return)
278 else return)
300 >=> return . adjustMetadata (metadataFromFile <>)
279 >=> return . adjustMetadata (metadataFromFile <>)
301− >=> return . adjustMetadata (<> optMetadata opts)
280+ >=> return . adjustMetadata (<> metadata)
302− >=> return . adjustMetadata (<> cslMetadata)
303 >=> applyTransforms transforms
281 >=> applyTransforms transforms
304− >=> applyFilters readerOpts filters [T.unpack format]
282+ >=> applyFilters readerOpts filters' [T.unpack format]
305 >=> maybe return extractMedia (optExtractMedia opts)
283 >=> maybe return extractMedia (optExtractMedia opts)
306 )
284 )
307
285
@@ -366,18 +344,7 @@ readSource src = case parseURI src of
366 _ -> PandocAppError (tshow e))
344 _ -> PandocAppError (tshow e))
367
345
368readURI :: FilePath -> PandocIO Text
346readURI :: FilePath -> PandocIO Text
369−readURI src = do
370− (bs, mt) <- openURL (T.pack src)
347+readURI src = UTF8.toText . fst <$> openURL (T.pack src)
371− case mt >>= getCharset of
372− Just "UTF-8" -> return $ UTF8.toText bs
373− Just "ISO-8859-1" -> return $ T.pack $ B8.unpack bs
374− Just charset -> throwError $ PandocUnsupportedCharsetError charset
375− Nothing -> liftIO $ -- try first as UTF-8, then as latin1
376− E.catch (return $! UTF8.toText bs)
377− (\case
378− TSE.DecodeError{} ->
379− return $ T.pack $ B8.unpack bs
380− e -> E.throwIO e)
381
348
382readFile' :: MonadIO m => FilePath -> m BL.ByteString
349readFile' :: MonadIO m => FilePath -> m BL.ByteString
383readFile' "-" = liftIO BL.getContents
350readFile' "-" = liftIO BL.getContents
@@ -388,5 +355,6 @@ writeFnBinary "-" = liftIO . BL.putStr
388writeFnBinary f = liftIO . BL.writeFile (UTF8.encodePath f)
355writeFnBinary f = liftIO . BL.writeFile (UTF8.encodePath f)
389
356
390writerFn :: MonadIO m => IO.Newline -> FilePath -> Text -> m ()
357writerFn :: MonadIO m => IO.Newline -> FilePath -> Text -> m ()
358+-- TODO this implementation isn't maximally efficient:
391−writerFn eol "-" = liftIO . UTF8.putStrWith eol
359+writerFn eol "-" = liftIO . UTF8.putStrWith eol . T.unpack
392−writerFn eol f = liftIO . UTF8.writeFileWith eol f
360+writerFn eol f = liftIO . UTF8.writeFileWith eol f . T.unpack
src/Text/Pandoc/App/CommandLineOptions.hs+77−123
@@ -1,12 +1,11 @@
1{-# LANGUAGE CPP #-}
1{-# LANGUAGE CPP #-}
2−{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE ScopedTypeVariables #-}
2{-# LANGUAGE ScopedTypeVariables #-}
4{-# LANGUAGE TupleSections #-}
3{-# LANGUAGE TupleSections #-}
5{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
6{-# LANGUAGE FlexibleContexts #-}
5{-# LANGUAGE FlexibleContexts #-}
7{- |
6{- |
8 Module : Text.Pandoc.App.CommandLineOptions
7 Module : Text.Pandoc.App.CommandLineOptions
9− Copyright : Copyright (C) 2006-2021 John MacFarlane
8+ Copyright : Copyright (C) 2006-2020 John MacFarlane
10 License : GNU GPL, version 2 or above
9 License : GNU GPL, version 2 or above
11
10
12 Maintainer : John MacFarlane <jgm@berkeley@edu>
11 Maintainer : John MacFarlane <jgm@berkeley@edu>
@@ -17,7 +16,6 @@ Does a pandoc conversion based on command-line options.
17-}
16-}
18module Text.Pandoc.App.CommandLineOptions (
17module Text.Pandoc.App.CommandLineOptions (
19 parseOptions
18 parseOptions
20− , parseOptionsFromArgs
21 , options
19 , options
22 , engines
20 , engines
23 , lookupHighlightStyle
21 , lookupHighlightStyle
@@ -26,12 +24,11 @@ module Text.Pandoc.App.CommandLineOptions (
26import Control.Monad
24import Control.Monad
27import Control.Monad.Trans
25import Control.Monad.Trans
28import Control.Monad.Except (throwError)
26import Control.Monad.Except (throwError)
29−import Control.Monad.State.Strict
30import Data.Aeson.Encode.Pretty (encodePretty', Config(..), keyOrder,
27import Data.Aeson.Encode.Pretty (encodePretty', Config(..), keyOrder,
31 defConfig, Indent(..), NumberFormat(..))
28 defConfig, Indent(..), NumberFormat(..))
32import Data.Bifunctor (second)
29import Data.Bifunctor (second)
33import Data.Char (toLower)
30import Data.Char (toLower)
34−import Data.List (intercalate, sort, foldl')
31+import Data.List (intercalate, sort)
35#ifdef _WINDOWS
32#ifdef _WINDOWS
36#if MIN_VERSION_base(4,12,0)
33#if MIN_VERSION_base(4,12,0)
37import Data.List (isPrefixOf)
34import Data.List (isPrefixOf)
@@ -48,13 +45,10 @@ import System.FilePath
48import System.IO (stdout)
45import System.IO (stdout)
49import Text.DocTemplates (Context (..), ToContext (toVal), Val (..))
46import Text.DocTemplates (Context (..), ToContext (toVal), Val (..))
50import Text.Pandoc
47import Text.Pandoc
51−import Text.Pandoc.Builder (setMeta)
52−import Text.Pandoc.App.Opt (Opt (..), LineEnding (..), IpynbOutput (..),
48+import Text.Pandoc.App.Opt (Opt (..), LineEnding (..), IpynbOutput (..), addMeta)
53− DefaultsState (..), applyDefaults,
54− fullDefaultsPath)
55import Text.Pandoc.Filter (Filter (..))
49import Text.Pandoc.Filter (Filter (..))
56import Text.Pandoc.Highlighting (highlightingStyles)
50import Text.Pandoc.Highlighting (highlightingStyles)
57−import Text.Pandoc.Shared (ordNub, elemText, safeStrRead, defaultUserDataDir)
51+import Text.Pandoc.Shared (ordNub, elemText, safeStrRead, defaultUserDataDirs, findM)
58import Text.Printf
52import Text.Printf
59
53
60#ifdef EMBED_DATA_FILES
54#ifdef EMBED_DATA_FILES
@@ -69,19 +63,16 @@ import qualified Data.ByteString as BS
69import qualified Data.ByteString.Lazy as B
63import qualified Data.ByteString.Lazy as B
70import qualified Data.Map as M
64import qualified Data.Map as M
71import qualified Data.Text as T
65import qualified Data.Text as T
66+import qualified Data.YAML as Y
72import qualified Text.Pandoc.UTF8 as UTF8
67import qualified Text.Pandoc.UTF8 as UTF8
73
68
74parseOptions :: [OptDescr (Opt -> IO Opt)] -> Opt -> IO Opt
69parseOptions :: [OptDescr (Opt -> IO Opt)] -> Opt -> IO Opt
75parseOptions options' defaults = do
70parseOptions options' defaults = do
76 rawArgs <- map UTF8.decodeArg <$> getArgs
71 rawArgs <- map UTF8.decodeArg <$> getArgs
77 prg <- getProgName
72 prg <- getProgName
78− parseOptionsFromArgs options' defaults prg rawArgs
79
73
80−parseOptionsFromArgs
81− :: [OptDescr (Opt -> IO Opt)] -> Opt -> String -> [String] -> IO Opt
82−parseOptionsFromArgs options' defaults prg rawArgs = do
83 let (actions, args, unrecognizedOpts, errors) =
74 let (actions, args, unrecognizedOpts, errors) =
84− getOpt' Permute options' (map UTF8.decodeArg rawArgs)
75+ getOpt' Permute options' rawArgs
85
76
86 let unknownOptionErrors =
77 let unknownOptionErrors =
87 foldr (handleUnrecognizedOption . takeWhile (/= '=')) []
78 foldr (handleUnrecognizedOption . takeWhile (/= '=')) []
@@ -93,7 +84,7 @@ parseOptionsFromArgs options' defaults prg rawArgs = do
93 ("Try " ++ prg ++ " --help for more information.")
84 ("Try " ++ prg ++ " --help for more information.")
94
85
95 -- thread option data structure through all supplied option actions
86 -- thread option data structure through all supplied option actions
96− opts <- foldl' (>>=) (return defaults) actions
87+ opts <- foldl (>>=) (return defaults) actions
97 let mbArgs = case args of
88 let mbArgs = case args of
98 [] -> Nothing
89 [] -> Nothing
99 xs -> Just xs
90 xs -> Just xs
@@ -174,11 +165,7 @@ options =
174
165
175 , Option "d" ["defaults"]
166 , Option "d" ["defaults"]
176 (ReqArg
167 (ReqArg
177− (\arg opt -> runIOorExplode $ do
178− let defsState = DefaultsState { curDefaults = Nothing,
179− inheritanceGraph = [] }
180− fp <- fullDefaultsPath (optDataDir opt) arg
181− evalStateT (applyDefaults opt fp) defsState
168+ (\arg opt -> applyDefaults opt arg
182 )
169 )
183 "FILE")
170 "FILE")
184 ""
171 ""
@@ -288,32 +275,28 @@ options =
288 , Option "" ["resource-path"]
275 , Option "" ["resource-path"]
289 (ReqArg
276 (ReqArg
290 (\arg opt -> return opt { optResourcePath =
277 (\arg opt -> return opt { optResourcePath =
291− splitSearchPath arg ++
278+ splitSearchPath arg })
292− optResourcePath opt })
293 "SEARCHPATH")
279 "SEARCHPATH")
294 "" -- "Paths to search for images and other resources"
280 "" -- "Paths to search for images and other resources"
295
281
296 , Option "H" ["include-in-header"]
282 , Option "H" ["include-in-header"]
297 (ReqArg
283 (ReqArg
298 (\arg opt -> return opt{ optIncludeInHeader =
284 (\arg opt -> return opt{ optIncludeInHeader =
299− optIncludeInHeader opt ++
285+ optIncludeInHeader opt ++ [arg] })
300− [normalizePath arg] })
301 "FILE")
286 "FILE")
302 "" -- "File to include at end of header (implies -s)"
287 "" -- "File to include at end of header (implies -s)"
303
288
304 , Option "B" ["include-before-body"]
289 , Option "B" ["include-before-body"]
305 (ReqArg
290 (ReqArg
306 (\arg opt -> return opt{ optIncludeBeforeBody =
291 (\arg opt -> return opt{ optIncludeBeforeBody =
307− optIncludeBeforeBody opt ++
292+ optIncludeBeforeBody opt ++ [arg] })
308− [normalizePath arg] })
309 "FILE")
293 "FILE")
310 "" -- "File to include before document body"
294 "" -- "File to include before document body"
311
295
312 , Option "A" ["include-after-body"]
296 , Option "A" ["include-after-body"]
313 (ReqArg
297 (ReqArg
314 (\arg opt -> return opt{ optIncludeAfterBody =
298 (\arg opt -> return opt{ optIncludeAfterBody =
315− optIncludeAfterBody opt ++
299+ optIncludeAfterBody opt ++ [arg] })
316− [normalizePath arg] })
317 "FILE")
300 "FILE")
318 "" -- "File to include after document body"
301 "" -- "File to include after document body"
319
302
@@ -325,8 +308,7 @@ options =
325 , Option "" ["highlight-style"]
308 , Option "" ["highlight-style"]
326 (ReqArg
309 (ReqArg
327 (\arg opt ->
310 (\arg opt ->
328− return opt{ optHighlightStyle = Just $
311+ return opt{ optHighlightStyle = Just $ T.pack arg })
329− T.pack $ normalizePath arg })
330 "STYLE|FILE")
312 "STYLE|FILE")
331 "" -- "Style for highlighted code"
313 "" -- "Style for highlighted code"
332
314
@@ -414,7 +396,7 @@ options =
414 , Option "" ["reference-doc"]
396 , Option "" ["reference-doc"]
415 (ReqArg
397 (ReqArg
416 (\arg opt ->
398 (\arg opt ->
417− return opt { optReferenceDoc = Just $ normalizePath arg })
399+ return opt { optReferenceDoc = Just arg })
418 "FILE")
400 "FILE")
419 "" -- "Path of custom reference doc"
401 "" -- "Path of custom reference doc"
420
402
@@ -439,8 +421,7 @@ options =
439
421
440 , Option "" ["abbreviations"]
422 , Option "" ["abbreviations"]
441 (ReqArg
423 (ReqArg
442− (\arg opt -> return opt { optAbbreviations =
424+ (\arg opt -> return opt { optAbbreviations = Just arg })
443− Just $ normalizePath arg })
444 "FILE")
425 "FILE")
445 "" -- "Specify file for custom abbreviations"
426 "" -- "Specify file for custom abbreviations"
446
427
@@ -542,26 +523,9 @@ options =
542
523
543 , Option "" ["atx-headers"]
524 , Option "" ["atx-headers"]
544 (NoArg
525 (NoArg
545− (\opt -> do
546− deprecatedOption "--atx-headers"
547− "Use --markdown-headings=atx instead."
548− return opt { optSetextHeaders = False } ))
526+ (\opt -> return opt { optSetextHeaders = False } ))
549 "" -- "Use atx-style headers for markdown"
527 "" -- "Use atx-style headers for markdown"
550
528
551− , Option "" ["markdown-headings"]
552− (ReqArg
553− (\arg opt -> do
554− headingFormat <- case arg of
555− "setext" -> pure True
556− "atx" -> pure False
557− _ -> E.throwIO $ PandocOptionError $ T.pack
558− ("Unknown markdown heading format: " ++ arg ++
559− ". Expecting atx or setext")
560− pure opt { optSetextHeaders = headingFormat }
561− )
562− "setext|atx")
563− ""
564−
565 , Option "" ["listings"]
529 , Option "" ["listings"]
566 (NoArg
530 (NoArg
567 (\opt -> return opt { optListings = True }))
531 (\opt -> return opt { optListings = True }))
@@ -642,24 +606,21 @@ options =
642 (ReqArg
606 (ReqArg
643 (\arg opt ->
607 (\arg opt ->
644 return opt { optVariables =
608 return opt { optVariables =
645− setVariable "epub-cover-image"
609+ setVariable "epub-cover-image" (T.pack arg) $
646− (T.pack $ normalizePath arg) $
647 optVariables opt })
610 optVariables opt })
648 "FILE")
611 "FILE")
649 "" -- "Path of epub cover image"
612 "" -- "Path of epub cover image"
650
613
651 , Option "" ["epub-metadata"]
614 , Option "" ["epub-metadata"]
652 (ReqArg
615 (ReqArg
653− (\arg opt -> return opt { optEpubMetadata = Just $
616+ (\arg opt -> return opt { optEpubMetadata = Just arg })
654− normalizePath arg })
655 "FILE")
617 "FILE")
656 "" -- "Path of epub metadata file"
618 "" -- "Path of epub metadata file"
657
619
658 , Option "" ["epub-embed-font"]
620 , Option "" ["epub-embed-font"]
659 (ReqArg
621 (ReqArg
660 (\arg opt ->
622 (\arg opt ->
661− return opt{ optEpubFonts = normalizePath arg :
623+ return opt{ optEpubFonts = arg : optEpubFonts opt })
662− optEpubFonts opt })
663 "FILE")
624 "FILE")
664 "" -- "Directory of fonts to embed"
625 "" -- "Directory of fonts to embed"
665
626
@@ -686,17 +647,10 @@ options =
686 "all|none|best")
647 "all|none|best")
687 "" -- "Starting number for sections, subsections, etc."
648 "" -- "Starting number for sections, subsections, etc."
688
649
689− , Option "C" ["citeproc"]
690− (NoArg
691− (\opt -> return opt { optFilters =
692− optFilters opt ++ [CiteprocFilter] }))
693− "" -- "Process citations"
694−
695 , Option "" ["bibliography"]
650 , Option "" ["bibliography"]
696 (ReqArg
651 (ReqArg
697 (\arg opt -> return opt{ optMetadata =
652 (\arg opt -> return opt{ optMetadata =
698− addMeta "bibliography"
653+ addMeta "bibliography" arg $
699− (normalizePath arg) $
700 optMetadata opt })
654 optMetadata opt })
701 "FILE")
655 "FILE")
702 ""
656 ""
@@ -705,8 +659,7 @@ options =
705 (ReqArg
659 (ReqArg
706 (\arg opt ->
660 (\arg opt ->
707 return opt{ optMetadata =
661 return opt{ optMetadata =
708− addMeta "csl" (normalizePath arg) $
709− optMetadata opt })
662+ addMeta "csl" arg $ optMetadata opt })
710 "FILE")
663 "FILE")
711 ""
664 ""
712
665
@@ -714,8 +667,8 @@ options =
714 (ReqArg
667 (ReqArg
715 (\arg opt ->
668 (\arg opt ->
716 return opt{ optMetadata =
669 return opt{ optMetadata =
717− addMeta "citation-abbreviations"
670+ addMeta "citation-abbreviations" arg $
718− (normalizePath arg) $ optMetadata opt })
671+ optMetadata opt })
719 "FILE")
672 "FILE")
720 ""
673 ""
721
674
@@ -746,7 +699,8 @@ options =
746 , Option "" ["mathjax"]
699 , Option "" ["mathjax"]
747 (OptArg
700 (OptArg
748 (\arg opt -> do
701 (\arg opt -> do
749− let url' = maybe defaultMathJaxURL T.pack arg
702+ let url' = maybe (defaultMathJaxURL <>
703+ "tex-mml-chtml.js") T.pack arg
750 return opt { optHTMLMathMethod = MathJax url'})
704 return opt { optHTMLMathMethod = MathJax url'})
751 "URL")
705 "URL")
752 "" -- "Use MathJax for HTML math"
706 "" -- "Use MathJax for HTML math"
@@ -798,8 +752,7 @@ options =
798
752
799 , Option "" ["log"]
753 , Option "" ["log"]
800 (ReqArg
754 (ReqArg
801− (\arg opt -> return opt{ optLogFile = Just $
755+ (\arg opt -> return opt{ optLogFile = Just arg })
802− normalizePath arg })
803 "FILE")
756 "FILE")
804 "" -- "Log messages in JSON format to this file."
757 "" -- "Log messages in JSON format to this file."
805
758
@@ -814,10 +767,10 @@ options =
814 map (\c -> ['-',c]) shorts ++
767 map (\c -> ['-',c]) shorts ++
815 map ("--" ++) longs
768 map ("--" ++) longs
816 let allopts = unwords (concatMap optnames options)
769 let allopts = unwords (concatMap optnames options)
817− UTF8.hPutStrLn stdout $ T.pack $ printf tpl allopts
770+ UTF8.hPutStrLn stdout $ printf tpl allopts
818− (T.unpack $ T.unwords readersNames)
771+ (unwords readersNames)
819− (T.unpack $ T.unwords writersNames)
772+ (unwords writersNames)
820− (T.unpack $ T.unwords $ map fst highlightingStyles)
773+ (unwords $ map (T.unpack . fst) highlightingStyles)
821 (unwords datafiles)
774 (unwords datafiles)
822 exitSuccess ))
775 exitSuccess ))
823 "" -- "Print bash completion script"
776 "" -- "Print bash completion script"
@@ -856,7 +809,7 @@ options =
856 else if extensionEnabled x allExts
809 else if extensionEnabled x allExts
857 then '-'
810 then '-'
858 else ' ') : drop 4 (show x)
811 else ' ') : drop 4 (show x)
859− mapM_ (UTF8.hPutStrLn stdout . T.pack . showExt)
812+ mapM_ (UTF8.hPutStrLn stdout . showExt)
860 [ex | ex <- extList, extensionEnabled ex allExts]
813 [ex | ex <- extList, extensionEnabled ex allExts]
861 exitSuccess )
814 exitSuccess )
862 "FORMAT")
815 "FORMAT")
@@ -870,14 +823,14 @@ options =
870 , sShortname s `notElem`
823 , sShortname s `notElem`
871 [T.pack "Alert", T.pack "Alert_indent"]
824 [T.pack "Alert", T.pack "Alert_indent"]
872 ]
825 ]
873− mapM_ (UTF8.hPutStrLn stdout . T.pack) (sort langs)
826+ mapM_ (UTF8.hPutStrLn stdout) langs
874 exitSuccess ))
827 exitSuccess ))
875 ""
828 ""
876
829
877 , Option "" ["list-highlight-styles"]
830 , Option "" ["list-highlight-styles"]
878 (NoArg
831 (NoArg
879 (\_ -> do
832 (\_ -> do
880− mapM_ (UTF8.hPutStrLn stdout . fst) highlightingStyles
833+ mapM_ (UTF8.hPutStrLn stdout . T.unpack . fst) highlightingStyles
881 exitSuccess ))
834 exitSuccess ))
882 ""
835 ""
883
836
@@ -895,7 +848,7 @@ options =
895 | T.null t -> -- e.g. for docx, odt, json:
848 | T.null t -> -- e.g. for docx, odt, json:
896 E.throwIO $ PandocCouldNotFindDataFileError $ T.pack
849 E.throwIO $ PandocCouldNotFindDataFileError $ T.pack
897 ("templates/default." ++ arg)
850 ("templates/default." ++ arg)
898− | otherwise -> write t
851+ | otherwise -> write . T.unpack $ t
899 Left e -> E.throwIO e
852 Left e -> E.throwIO e
900 exitSuccess)
853 exitSuccess)
901 "FORMAT")
854 "FORMAT")
@@ -916,7 +869,9 @@ options =
916 , Option "" ["print-highlight-style"]
869 , Option "" ["print-highlight-style"]
917 (ReqArg
870 (ReqArg
918 (\arg opt -> do
871 (\arg opt -> do
919− let write = maybe B.putStr B.writeFile $ optOutputFile opt
872+ let write = case optOutputFile opt of
873+ Just f -> B.writeFile f
874+ Nothing -> B.putStr
920 sty <- runIOorExplode $ lookupHighlightStyle arg
875 sty <- runIOorExplode $ lookupHighlightStyle arg
921 write $ encodePretty'
876 write $ encodePretty'
922 defConfig{confIndent = Spaces 4
877 defConfig{confIndent = Spaces 4
@@ -941,13 +896,11 @@ options =
941 (NoArg
896 (NoArg
942 (\_ -> do
897 (\_ -> do
943 prg <- getProgName
898 prg <- getProgName
944− defaultDatadir <- defaultUserDataDir
899+ defaultDatadirs <- defaultUserDataDirs
945− UTF8.hPutStrLn stdout
946− $ T.pack
947− $ prg ++ " " ++ T.unpack pandocVersion ++
900+ UTF8.hPutStrLn stdout (prg ++ " " ++ T.unpack pandocVersion ++
948− compileInfo ++
901+ compileInfo ++ "\nDefault user data directory: " ++
949− "\nUser data directory: " ++ defaultDatadir ++
902+ intercalate " or " defaultDatadirs ++
950− ('\n':copyrightMessage)
903+ ('\n':copyrightMessage))
951 exitSuccess ))
904 exitSuccess ))
952 "" -- "Print version"
905 "" -- "Print version"
953
906
@@ -955,7 +908,7 @@ options =
955 (NoArg
908 (NoArg
956 (\_ -> do
909 (\_ -> do
957 prg <- getProgName
910 prg <- getProgName
958− UTF8.hPutStr stdout (T.pack $ usageMessage prg options)
911+ UTF8.hPutStr stdout (usageMessage prg options)
959 exitSuccess ))
912 exitSuccess ))
960 "" -- "Show help"
913 "" -- "Show help"
961 ]
914 ]
@@ -976,16 +929,16 @@ usageMessage programName = usageInfo (programName ++ " [OPTIONS] [FILES]")
976
929
977copyrightMessage :: String
930copyrightMessage :: String
978copyrightMessage = intercalate "\n" [
931copyrightMessage = intercalate "\n" [
979− "Copyright (C) 2006-2021 John MacFarlane. Web: https://pandoc.org",
932+ "Copyright (C) 2006-2020 John MacFarlane",
933+ "Web: https://pandoc.org",
980− "This is free software; see the source for copying conditions. There is no",
934+ "This is free software; see the source for copying conditions.",
981− "warranty, not even for merchantability or fitness for a particular purpose." ]
935+ "There is no warranty, not even for merchantability or fitness",
936+ "for a particular purpose." ]
982
937
983compileInfo :: String
938compileInfo :: String
984compileInfo =
939compileInfo =
985− "\nCompiled with pandoc-types " ++ VERSION_pandoc_types ++
940+ "\nCompiled with pandoc-types " ++ VERSION_pandoc_types ++ ", texmath " ++
986− ", texmath " ++ VERSION_texmath ++ ", skylighting " ++
941+ VERSION_texmath ++ ", skylighting " ++ VERSION_skylighting
987− VERSION_skylighting ++ ",\nciteproc " ++ VERSION_citeproc ++
988− ", ipynb " ++ VERSION_ipynb
989
942
990handleUnrecognizedOption :: String -> [String] -> [String]
943handleUnrecognizedOption :: String -> [String] -> [String]
991handleUnrecognizedOption "--smart" =
944handleUnrecognizedOption "--smart" =
@@ -1016,16 +969,38 @@ handleUnrecognizedOption "-R" = handleUnrecognizedOption "--parse-raw"
1016handleUnrecognizedOption x =
969handleUnrecognizedOption x =
1017 (("Unknown option " ++ x ++ ".") :)
970 (("Unknown option " ++ x ++ ".") :)
1018
971
1019−readersNames :: [Text]
972+readersNames :: [String]
1020−readersNames = sort (map fst (readers :: [(Text, Reader PandocIO)]))
973+readersNames = sort (map (T.unpack . fst) (readers :: [(Text, Reader PandocIO)]))
1021
974
1022−writersNames :: [Text]
975+writersNames :: [String]
1023writersNames = sort
976writersNames = sort
1024− ("pdf" : map fst (writers :: [(Text, Writer PandocIO)]))
977+ ("pdf" : map (T.unpack . fst) (writers :: [(Text, Writer PandocIO)]))
1025
978
1026splitField :: String -> (String, String)
979splitField :: String -> (String, String)
1027splitField = second (tailDef "true") . break (`elemText` ":=")
980splitField = second (tailDef "true") . break (`elemText` ":=")
1028
981
982+-- | Apply defaults from --defaults file.
983+applyDefaults :: Opt -> FilePath -> IO Opt
984+applyDefaults opt file = runIOorExplode $ do
985+ let fp = if null (takeExtension file)
986+ then addExtension file "yaml"
987+ else file
988+ setVerbosity $ optVerbosity opt
989+ dataDirs <- liftIO defaultUserDataDirs
990+ let fps = fp : case optDataDir opt of
991+ Nothing -> map (</> ("defaults" </> fp))
992+ dataDirs
993+ Just dd -> [dd </> "defaults" </> fp]
994+ fp' <- fromMaybe fp <$> findM fileExists fps
995+ inp <- readFileLazy fp'
996+ case Y.decode1 inp of
997+ Right (f :: Opt -> Opt) -> return $ f opt
998+ Left (errpos, errmsg) -> throwError $
999+ PandocParseError $ T.pack $
1000+ "Error parsing " ++ fp' ++ " line " ++
1001+ show (Y.posLine errpos) ++ " column " ++
1002+ show (Y.posColumn errpos) ++ ":\n" ++ errmsg
1003+
1029lookupHighlightStyle :: PandocMonad m => String -> m Style
1004lookupHighlightStyle :: PandocMonad m => String -> m Style
1030lookupHighlightStyle s
1005lookupHighlightStyle s
1031 | takeExtension s == ".theme" = -- attempt to load KDE theme
1006 | takeExtension s == ".theme" = -- attempt to load KDE theme
@@ -1043,7 +1018,7 @@ lookupHighlightStyle s
1043deprecatedOption :: String -> String -> IO ()
1018deprecatedOption :: String -> String -> IO ()
1044deprecatedOption o msg =
1019deprecatedOption o msg =
1045 runIO (report $ Deprecated (T.pack o) (T.pack msg)) >>=
1020 runIO (report $ Deprecated (T.pack o) (T.pack msg)) >>=
1046− \case
1021+ \r -> case r of
1047 Right () -> return ()
1022 Right () -> return ()
1048 Left e -> E.throwIO e
1023 Left e -> E.throwIO e
1049
1024
@@ -1054,27 +1029,6 @@ setVariable key val (Context ctx) = Context $ M.alter go key ctx
1054 go (Just (ListVal xs)) = Just $ ListVal $ xs ++ [toVal val]
1029 go (Just (ListVal xs)) = Just $ ListVal $ xs ++ [toVal val]
1055 go (Just x) = Just $ ListVal [x, toVal val]
1030 go (Just x) = Just $ ListVal [x, toVal val]
1056
1031
1057−addMeta :: String -> String -> Meta -> Meta
1058−addMeta k v meta =
1059− case lookupMeta k' meta of
1060− Nothing -> setMeta k' v' meta
1061− Just (MetaList xs) ->
1062− setMeta k' (MetaList (xs ++ [v'])) meta
1063− Just x -> setMeta k' (MetaList [x, v']) meta
1064− where
1065− v' = readMetaValue v
1066− k' = T.pack k
1067−
1068−readMetaValue :: String -> MetaValue
1069−readMetaValue s
1070− | s == "true" = MetaBool True
1071− | s == "True" = MetaBool True
1072− | s == "TRUE" = MetaBool True
1073− | s == "false" = MetaBool False
1074− | s == "False" = MetaBool False
1075− | s == "FALSE" = MetaBool False
1076− | otherwise = MetaString $ T.pack s
1077−
1078-- On Windows with ghc 8.6+, we need to rewrite paths
1032-- On Windows with ghc 8.6+, we need to rewrite paths
1079-- beginning with \\ to \\?\UNC\. -- See #5127.
1033-- beginning with \\ to \\?\UNC\. -- See #5127.
1080normalizePath :: FilePath -> FilePath
1034normalizePath :: FilePath -> FilePath
src/Text/Pandoc/App/FormatHeuristics.hs+8−20
@@ -1,7 +1,7 @@
1{-# LANGUAGE OverloadedStrings #-}
1{-# LANGUAGE OverloadedStrings #-}
2{- |
2{- |
3 Module : Text.Pandoc.App.FormatHeuristics
3 Module : Text.Pandoc.App.FormatHeuristics
4− Copyright : Copyright (C) 2006-2021 John MacFarlane
4+ Copyright : Copyright (C) 2006-2020 John MacFarlane
5 License : GNU GPL, version 2 or above
5 License : GNU GPL, version 2 or above
6
6
7 Maintainer : John MacFarlane <jgm@berkeley@edu>
7 Maintainer : John MacFarlane <jgm@berkeley@edu>
@@ -15,24 +15,18 @@ module Text.Pandoc.App.FormatHeuristics
15 ) where
15 ) where
16
16
17import Data.Char (toLower)
17import Data.Char (toLower)
18−import Data.Foldable (asum)
19import Data.Text (Text)
18import Data.Text (Text)
20import System.FilePath (takeExtension)
19import System.FilePath (takeExtension)
21
20
22−-- | Determines default format based on file extensions; uses the format
21+-- Determine default format based on file extensions.
23−-- of the first extension that's associated with a format.
24−--
25−-- Examples:
26−--
27−-- > formatFromFilePaths ["text.unknown", "no-extension"]
28−-- Nothing
29−--
30−-- > formatFromFilePaths ["my.md", "other.rst"]
31−-- Just "markdown"
32formatFromFilePaths :: [FilePath] -> Maybe Text
22formatFromFilePaths :: [FilePath] -> Maybe Text
33−formatFromFilePaths = asum . map formatFromFilePath
23+formatFromFilePaths [] = Nothing
24+formatFromFilePaths (x:xs) =
25+ case formatFromFilePath x of
26+ Just f -> Just f
27+ Nothing -> formatFromFilePaths xs
34
28
35−-- | Determines format based on file extension.
29+-- Determine format based on file extension
36formatFromFilePath :: FilePath -> Maybe Text
30formatFromFilePath :: FilePath -> Maybe Text
37formatFromFilePath x =
31formatFromFilePath x =
38 case takeExtension (map toLower x) of
32 case takeExtension (map toLower x) of
@@ -54,11 +48,6 @@ formatFromFilePath x =
54 ".lhs" -> Just "markdown+lhs"
48 ".lhs" -> Just "markdown+lhs"
55 ".ltx" -> Just "latex"
49 ".ltx" -> Just "latex"
56 ".markdown" -> Just "markdown"
50 ".markdown" -> Just "markdown"
57− ".mkdn" -> Just "markdown"
58− ".mkd" -> Just "markdown"
59− ".mdwn" -> Just "markdown"
60− ".mdown" -> Just "markdown"
61− ".Rmd" -> Just "markdown"
62 ".md" -> Just "markdown"
51 ".md" -> Just "markdown"
63 ".ms" -> Just "ms"
52 ".ms" -> Just "ms"
64 ".muse" -> Just "muse"
53 ".muse" -> Just "muse"
@@ -85,6 +74,5 @@ formatFromFilePath x =
85 ".xhtml" -> Just "html"
74 ".xhtml" -> Just "html"
86 ".ipynb" -> Just "ipynb"
75 ".ipynb" -> Just "ipynb"
87 ".csv" -> Just "csv"
76 ".csv" -> Just "csv"
88− ".bib" -> Just "biblatex"
89 ['.',y] | y `elem` ['1'..'9'] -> Just "man"
77 ['.',y] | y `elem` ['1'..'9'] -> Just "man"
90 _ -> Nothing
78 _ -> Nothing
src/Text/Pandoc/App/Opt.hs+60−287

This diff is too big to show here.

src/Text/Pandoc/App/OutputSettings.hs+3−3

This diff is too big to show here.

src/Text/Pandoc/Asciify.hs+391−14

This diff is too big to show here.

src/Text/Pandoc/BCP47.hsnew file+112

This diff is too big to show here.

src/Text/Pandoc/CSS.hs+25−24

This diff is too big to show here.

src/Text/Pandoc/CSV.hs+3−2

This diff is too big to show here.

src/Text/Pandoc/Citeproc.hsdeleted−661

This diff is too big to show here.

src/Text/Pandoc/Citeproc/BibTeX.hsdeleted−1476

This diff is too big to show here.

src/Text/Pandoc/Citeproc/CslJson.hsdeleted−37

This diff is too big to show here.

src/Text/Pandoc/Citeproc/Data.hsdeleted−32

This diff is too big to show here.

src/Text/Pandoc/Citeproc/Locator.hsdeleted−295

This diff is too big to show here.

src/Text/Pandoc/Citeproc/MetaValue.hsdeleted−255

This diff is too big to show here.

src/Text/Pandoc/Citeproc/Util.hsdeleted−70

This diff is too big to show here.

src/Text/Pandoc/Class/CommonState.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Class/IO.hs+24−24

This diff is too big to show here.

src/Text/Pandoc/Class/PandocMonad.hs+45−52

This diff is too big to show here.

src/Text/Pandoc/Data.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Error.hs+53−111

This diff is too big to show here.

src/Text/Pandoc/Extensions.hs+18−107

This diff is too big to show here.

src/Text/Pandoc/Filter.hs+7−18

This diff is too big to show here.

src/Text/Pandoc/Filter/JSON.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Filter/Lua.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Filter/Path.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Highlighting.hs+6−6

This diff is too big to show here.

src/Text/Pandoc/Image.hs+2−1

This diff is too big to show here.

src/Text/Pandoc/ImageSize.hs+341−61

This diff is too big to show here.

src/Text/Pandoc/Logging.hs+57−88

This diff is too big to show here.

src/Text/Pandoc/Lua.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Lua/ErrorConversion.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Lua/Filter.hs+4−7

This diff is too big to show here.

src/Text/Pandoc/Lua/Global.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Lua/Init.hs+5−16

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling.hs+2−2

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/AST.hs+85−81

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/AnyValue.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/CommonState.hs+2−2

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/Context.hs+2−3

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/List.hs+2−2

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/MediaBag.hs+3−3

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/PandocError.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/ReaderOptions.hs+2−2

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/SimpleTable.hsdeleted−59

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/Version.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/MediaBag.hs+17−18

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/Pandoc.hs+23−29

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/System.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/Types.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/Utils.hs+9−47

This diff is too big to show here.

src/Text/Pandoc/Lua/Packages.hs+27−10

This diff is too big to show here.

src/Text/Pandoc/Lua/PandocLua.hs+13−20

This diff is too big to show here.

src/Text/Pandoc/Lua/Util.hs+3−3

This diff is too big to show here.

src/Text/Pandoc/Lua/Walk.hs+2−2

This diff is too big to show here.

src/Text/Pandoc/MIME.hs+3−26

This diff is too big to show here.

src/Text/Pandoc/MediaBag.hs+15−46

This diff is too big to show here.

src/Text/Pandoc/Options.hs+21−25

This diff is too big to show here.

src/Text/Pandoc/PDF.hs+36−58

This diff is too big to show here.

src/Text/Pandoc/Parsing.hs+277−427

This diff is too big to show here.

src/Text/Pandoc/Process.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Readers.hs+45−61

This diff is too big to show here.

src/Text/Pandoc/Readers/BibTeX.hsdeleted−77

This diff is too big to show here.

src/Text/Pandoc/Readers/CSV.hs+10−10

This diff is too big to show here.

src/Text/Pandoc/Readers/CommonMark.hs+197−91

This diff is too big to show here.

src/Text/Pandoc/Readers/Creole.hs+7−6

This diff is too big to show here.

src/Text/Pandoc/Readers/CslJson.hsdeleted−54

This diff is too big to show here.

src/Text/Pandoc/Readers/DocBook.hs+141−274

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx.hs+104−119

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Combine.hs+67−44

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Parse.hs+130−221

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Parse/Styles.hs+31−44

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Util.hs+26−28

This diff is too big to show here.

src/Text/Pandoc/Readers/DokuWiki.hs+10−11

This diff is too big to show here.

src/Text/Pandoc/Readers/EPUB.hs+39−46

This diff is too big to show here.

src/Text/Pandoc/Readers/FB2.hs+51−57

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML.hs+563−266

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/Parsing.hsdeleted−225

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/Table.hsdeleted−283

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/TagCategories.hsdeleted−78

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/Types.hsdeleted−97

This diff is too big to show here.

src/Text/Pandoc/Readers/Haddock.hs+8−12

This diff is too big to show here.

src/Text/Pandoc/Readers/Ipynb.hs+5−11

This diff is too big to show here.

src/Text/Pandoc/Readers/JATS.hs+68−63

This diff is too big to show here.

src/Text/Pandoc/Readers/Jira.hs+11−15

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX.hs+1504−291

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Citation.hsdeleted−210

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Inline.hsdeleted−397

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Lang.hs+122−201

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Macro.hsdeleted−184

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Math.hsdeleted−221

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Parsing.hs+54−361

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/SIunitx.hsdeleted−434

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Table.hsdeleted−378

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Types.hs+2−15

This diff is too big to show here.

src/Text/Pandoc/Readers/Man.hs+18−39

This diff is too big to show here.

src/Text/Pandoc/Readers/Markdown.hs+267−388

This diff is too big to show here.

src/Text/Pandoc/Readers/MediaWiki.hs+19−24

This diff is too big to show here.

src/Text/Pandoc/Readers/Metadata.hs+67−136

This diff is too big to show here.

src/Text/Pandoc/Readers/Muse.hs+10−11

This diff is too big to show here.

src/Text/Pandoc/Readers/Native.hs+6−8

This diff is too big to show here.

src/Text/Pandoc/Readers/OPML.hs+36−22

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt.hs+25−28

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Arrows/State.hs+2−2

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/ContentReader.hs+18−25

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/Namespaces.hs+1−2

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/Utils.hs+26−10

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/XMLConverter.hs+15−15

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Namespaces.hs+5−6

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/StyleReader.hs+17−21

This diff is too big to show here.

src/Text/Pandoc/Readers/Org.hs+8−5

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/BlockStarts.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Blocks.hs+61−116

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/DocumentTree.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/ExportSettings.hs+10−34

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Inlines.hs+28−46

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Meta.hs+112−137

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/ParserState.hs+2−18

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Parsing.hs+6−6

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Shared.hs+5−4

This diff is too big to show here.

src/Text/Pandoc/Readers/RST.hs+122−102

This diff is too big to show here.

src/Text/Pandoc/Readers/Roff.hs+18−16

This diff is too big to show here.

src/Text/Pandoc/Readers/TWiki.hs+36−14

This diff is too big to show here.

src/Text/Pandoc/Readers/Textile.hs+93−99

This diff is too big to show here.

src/Text/Pandoc/Readers/TikiWiki.hs+7−6

This diff is too big to show here.

src/Text/Pandoc/Readers/Txt2Tags.hs+24−50

This diff is too big to show here.

src/Text/Pandoc/Readers/Vimwiki.hs+7−12

This diff is too big to show here.

src/Text/Pandoc/RoffChar.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/SelfContained.hs+12−16

This diff is too big to show here.

src/Text/Pandoc/Shared.hs+107−56

This diff is too big to show here.

src/Text/Pandoc/Slides.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Sources.hsdeleted−195

This diff is too big to show here.

src/Text/Pandoc/Templates.hs+1−7

This diff is too big to show here.

src/Text/Pandoc/Translations.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/UTF8.hs+24−21

This diff is too big to show here.

src/Text/Pandoc/UUID.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Writers.hs+4−13

This diff is too big to show here.

src/Text/Pandoc/Writers/AnnotatedTable.hsdeleted−323

This diff is too big to show here.

src/Text/Pandoc/Writers/AsciiDoc.hs+38−84

This diff is too big to show here.

src/Text/Pandoc/Writers/BibTeX.hsdeleted−61

This diff is too big to show here.

src/Text/Pandoc/Writers/CommonMark.hs+352−2

This diff is too big to show here.

src/Text/Pandoc/Writers/ConTeXt.hs+41−47

This diff is too big to show here.

src/Text/Pandoc/Writers/CslJson.hsdeleted−91

This diff is too big to show here.

src/Text/Pandoc/Writers/Custom.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Writers/Docbook.hs+37−118

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx.hs+404−286

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx/StyleMap.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx/Table.hsdeleted−227

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx/Types.hsdeleted−185

This diff is too big to show here.

src/Text/Pandoc/Writers/DokuWiki.hs+16−29

This diff is too big to show here.

src/Text/Pandoc/Writers/EPUB.hs+225−280

This diff is too big to show here.

src/Text/Pandoc/Writers/FB2.hs+78−62

This diff is too big to show here.

src/Text/Pandoc/Writers/GridTable.hsdeleted−157

This diff is too big to show here.

src/Text/Pandoc/Writers/HTML.hs+127−412

This diff is too big to show here.

src/Text/Pandoc/Writers/Haddock.hs+3−14

This diff is too big to show here.

src/Text/Pandoc/Writers/ICML.hs+61−102

This diff is too big to show here.

src/Text/Pandoc/Writers/Ipynb.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS.hs+122−115

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS/References.hsdeleted−164

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS/Table.hsdeleted−268

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS/Types.hsdeleted−57

This diff is too big to show here.

src/Text/Pandoc/Writers/Jira.hs+30−54

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX.hs+805−128

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Caption.hsdeleted−47

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Citation.hsdeleted−181

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Lang.hsdeleted−192

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Notes.hsdeleted−34

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Table.hsdeleted−307

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Types.hsdeleted−83

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Util.hsdeleted−275

This diff is too big to show here.

src/Text/Pandoc/Writers/Man.hs+5−5

This diff is too big to show here.

src/Text/Pandoc/Writers/Markdown.hs+681−173

This diff is too big to show here.

src/Text/Pandoc/Writers/Markdown/Inline.hsdeleted−616

This diff is too big to show here.

src/Text/Pandoc/Writers/Markdown/Types.hsdeleted−81

This diff is too big to show here.

src/Text/Pandoc/Writers/MediaWiki.hs+3−10

This diff is too big to show here.

src/Text/Pandoc/Writers/Ms.hs+24−96

This diff is too big to show here.

src/Text/Pandoc/Writers/Muse.hs+3−6

This diff is too big to show here.

src/Text/Pandoc/Writers/Native.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Writers/ODT.hs+23−29

This diff is too big to show here.

src/Text/Pandoc/Writers/OOXML.hs+22−22

This diff is too big to show here.

src/Text/Pandoc/Writers/OPML.hs+2−2

This diff is too big to show here.

src/Text/Pandoc/Writers/OpenDocument.hs+115−269

This diff is too big to show here.

src/Text/Pandoc/Writers/Org.hs+43−67

This diff is too big to show here.

src/Text/Pandoc/Writers/Powerpoint.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Writers/Powerpoint/Output.hs+163−186

This diff is too big to show here.

src/Text/Pandoc/Writers/Powerpoint/Presentation.hs+10−6

This diff is too big to show here.

src/Text/Pandoc/Writers/RST.hs+22−38

This diff is too big to show here.

src/Text/Pandoc/Writers/RTF.hs+14−20

This diff is too big to show here.

src/Text/Pandoc/Writers/Roff.hs+2−2

This diff is too big to show here.

src/Text/Pandoc/Writers/Shared.hs+13−41

This diff is too big to show here.

src/Text/Pandoc/Writers/TEI.hs+7−8

This diff is too big to show here.

src/Text/Pandoc/Writers/Texinfo.hs+16−23

This diff is too big to show here.

src/Text/Pandoc/Writers/Textile.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Writers/XWiki.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/Writers/ZimWiki.hs+3−5

This diff is too big to show here.

src/Text/Pandoc/XML.hs+21−44

This diff is too big to show here.

src/Text/Pandoc/XML/Light.hsdeleted−89

This diff is too big to show here.

src/Text/Pandoc/XML/Light/Output.hsdeleted−234

This diff is too big to show here.

src/Text/Pandoc/XML/Light/Proc.hsdeleted−139

This diff is too big to show here.

src/Text/Pandoc/XML/Light/Types.hsdeleted−193

This diff is too big to show here.

stack.yaml+26−11

This diff is too big to show here.

test/Tests/Command.hs+47−74

This diff is too big to show here.

test/Tests/Helpers.hs+37−25

This diff is too big to show here.

test/Tests/Lua.hs+4−2

This diff is too big to show here.

test/Tests/Lua/Module.hs+1−3

This diff is too big to show here.

test/Tests/Old.hs+34−39

This diff is too big to show here.

test/Tests/Readers/Creole.hs+3−1

This diff is too big to show here.

test/Tests/Readers/Docx.hs+8−30

This diff is too big to show here.

test/Tests/Readers/DokuWiki.hs+2

This diff is too big to show here.

test/Tests/Readers/EPUB.hs+4−2

This diff is too big to show here.

test/Tests/Readers/FB2.hs+2

This diff is too big to show here.

test/Tests/Readers/HTML.hs+19−24

This diff is too big to show here.

test/Tests/Readers/JATS.hs+2−18

This diff is too big to show here.

test/Tests/Readers/Jira.hs+3−23

This diff is too big to show here.

test/Tests/Readers/LaTeX.hs+24−93

This diff is too big to show here.

test/Tests/Readers/Man.hs+3−2

This diff is too big to show here.

test/Tests/Readers/Markdown.hs+10−8

This diff is too big to show here.

test/Tests/Readers/Muse.hs+3−1

This diff is too big to show here.

test/Tests/Readers/Odt.hs+3−2

This diff is too big to show here.

test/Tests/Readers/Org.hs+1−1

This diff is too big to show here.

test/Tests/Readers/Org/Block.hs+24−22

This diff is too big to show here.

test/Tests/Readers/Org/Block/CodeBlock.hs+38−36

This diff is too big to show here.

test/Tests/Readers/Org/Block/Figure.hs+11−9

This diff is too big to show here.

test/Tests/Readers/Org/Block/Header.hs+6−4

This diff is too big to show here.

test/Tests/Readers/Org/Block/List.hs+3−14

This diff is too big to show here.

test/Tests/Readers/Org/Block/Table.hs+6−4

This diff is too big to show here.

test/Tests/Readers/Org/Directive.hs+4−105

This diff is too big to show here.

test/Tests/Readers/Org/Inline.hs+7−9

This diff is too big to show here.

test/Tests/Readers/Org/Inline/Citation.hs+3−41

This diff is too big to show here.

test/Tests/Readers/Org/Inline/Note.hs+3−1

This diff is too big to show here.

test/Tests/Readers/Org/Inline/Smart.hs+3−1

This diff is too big to show here.

test/Tests/Readers/Org/Meta.hs+112−200

This diff is too big to show here.

test/Tests/Readers/Org/Shared.hs+3−1

This diff is too big to show here.

test/Tests/Readers/RST.hs+3−1

This diff is too big to show here.

test/Tests/Readers/Txt2Tags.hs+4−2

This diff is too big to show here.

test/Tests/Shared.hs+21−19

This diff is too big to show here.

test/Tests/Writers/AnnotatedTable.hsdeleted−253

This diff is too big to show here.

test/Tests/Writers/AsciiDoc.hs+2

This diff is too big to show here.

test/Tests/Writers/ConTeXt.hs+115−122

This diff is too big to show here.

test/Tests/Writers/Docbook.hs+2−103

This diff is too big to show here.

test/Tests/Writers/Docx.hs+2−25

This diff is too big to show here.

test/Tests/Writers/FB2.hs+2

This diff is too big to show here.

test/Tests/Writers/HTML.hs+54−57

This diff is too big to show here.

test/Tests/Writers/JATS.hs+93−135

This diff is too big to show here.

test/Tests/Writers/Jira.hs+3−61

This diff is too big to show here.

test/Tests/Writers/LaTeX.hs+2

This diff is too big to show here.

test/Tests/Writers/Markdown.hs+3−3

This diff is too big to show here.

test/Tests/Writers/Ms.hsdeleted−35

This diff is too big to show here.

test/Tests/Writers/Muse.hs+1

This diff is too big to show here.

test/Tests/Writers/Native.hs+2

This diff is too big to show here.

test/Tests/Writers/OOXML.hs+5−6

This diff is too big to show here.

test/Tests/Writers/Org.hs+13−46

This diff is too big to show here.

test/Tests/Writers/Plain.hs+2

This diff is too big to show here.

test/Tests/Writers/Powerpoint.hs+2

This diff is too big to show here.

test/Tests/Writers/RST.hs+2

This diff is too big to show here.

test/Tests/Writers/TEI.hs+2

This diff is too big to show here.

test/command/01.csvdeleted−4

This diff is too big to show here.

test/command/1279.md+1−1

This diff is too big to show here.

test/command/1608.mddeleted−41

This diff is too big to show here.

test/command/1881.md+13−13

This diff is too big to show here.

test/command/2103.mddeleted−8

This diff is too big to show here.

test/command/2378.md+3−3

This diff is too big to show here.

test/command/2874.md+2−2

This diff is too big to show here.

test/command/3516.md+5−1

This diff is too big to show here.

test/command/3577.md+3−3

This diff is too big to show here.

test/command/3587.md+8−98

This diff is too big to show here.

test/command/3674.md+1−1

This diff is too big to show here.

test/command/3706.md+8−8

This diff is too big to show here.

test/command/3734.md+1−1

This diff is too big to show here.

test/command/3736.md+6−3

This diff is too big to show here.

test/command/3752.mddeleted−60

This diff is too big to show here.

test/command/3792.md+1−1

This diff is too big to show here.

test/command/3824.md−1

This diff is too big to show here.

test/command/4063.mddeleted−29

This diff is too big to show here.

test/command/4164.md+9−5

This diff is too big to show here.

test/command/4186.md+8−8

This diff is too big to show here.

test/command/4420.md+11

This diff is too big to show here.

test/command/4442.md+1−1

This diff is too big to show here.

test/command/4465.mddeleted−15

This diff is too big to show here.

test/command/4528.md+1−1

This diff is too big to show here.

test/command/4677.md+1−1

This diff is too big to show here.

test/command/4742.md+2−2

This diff is too big to show here.

test/command/5099.md+1−1

This diff is too big to show here.

test/command/5121.md+3−2

This diff is too big to show here.

test/command/5178.md+10−10

This diff is too big to show here.

test/command/5304.md+1−1

This diff is too big to show here.

test/command/5321.md+2−2

This diff is too big to show here.

test/command/5367.md+10−9

This diff is too big to show here.

test/command/5519.md+1−1

This diff is too big to show here.

test/command/5541-localLink.mddeleted−149

This diff is too big to show here.

test/command/5541-nesting.mddeleted−98

This diff is too big to show here.

test/command/5541-urlLink.mddeleted−112

This diff is too big to show here.

test/command/5627.md+4−4

This diff is too big to show here.

test/command/5642.md+1−1

This diff is too big to show here.

test/command/5650.md+4−4

This diff is too big to show here.

test/command/5686.md+1−1

This diff is too big to show here.

test/command/5708.md+5−1

This diff is too big to show here.

test/command/5849-prefix.md+6−5

This diff is too big to show here.

test/command/5986.md+2−3

This diff is too big to show here.

test/command/6026.mddeleted−19

This diff is too big to show here.

test/command/6137.md+25−26

This diff is too big to show here.

test/command/6324.mddeleted−17

This diff is too big to show here.

test/command/6388.mddeleted−16

This diff is too big to show here.

test/command/6481.mddeleted−38

This diff is too big to show here.

test/command/6541.mddeleted−27

This diff is too big to show here.

test/command/6549.mddeleted−26

This diff is too big to show here.

test/command/6620.mddeleted−18

This diff is too big to show here.

test/command/6658.mddeleted−75

This diff is too big to show here.

test/command/6675.mddeleted−134

This diff is too big to show here.

test/command/6699.mddeleted−13

This diff is too big to show here.

test/command/6709.mddeleted−11

This diff is too big to show here.

test/command/6719.mddeleted−18

This diff is too big to show here.

test/command/6723.mddeleted−32

This diff is too big to show here.

test/command/6739.mddeleted−21

This diff is too big to show here.

test/command/6740.mddeleted−7

This diff is too big to show here.

test/command/6741.mddeleted−145

This diff is too big to show here.

test/command/6752.mddeleted−36

This diff is too big to show here.

test/command/6755.mddeleted−11

This diff is too big to show here.

test/command/6765.mddeleted−31

This diff is too big to show here.

test/command/6768.mddeleted−21

This diff is too big to show here.

test/command/6774.mddeleted−63

This diff is too big to show here.

test/command/6783.mddeleted−26

This diff is too big to show here.

test/command/6791.mddeleted−32

This diff is too big to show here.

test/command/6792.mddeleted−66

This diff is too big to show here.

test/command/6796.mddeleted−16

This diff is too big to show here.

test/command/6802.mddeleted−9

This diff is too big to show here.

test/command/6836.mddeleted−17

This diff is too big to show here.

test/command/6837.mddeleted−29

This diff is too big to show here.

test/command/6844.mddeleted−27

This diff is too big to show here.

test/command/6855.mddeleted−12

This diff is too big to show here.

test/command/6858.mddeleted−52

This diff is too big to show here.

test/command/6869.mddeleted−6

This diff is too big to show here.

test/command/6873.mddeleted−7

This diff is too big to show here.

test/command/6890.mddeleted−36

This diff is too big to show here.

test/command/6925.mddeleted−34

This diff is too big to show here.

test/command/6948.mddeleted−31

This diff is too big to show here.

test/command/6951.mddeleted−18

This diff is too big to show here.

test/command/6958.mddeleted−10

This diff is too big to show here.

test/command/6993.mddeleted−21

This diff is too big to show here.

test/command/7003.mddeleted−37

This diff is too big to show here.

test/command/7006.mddeleted−20

This diff is too big to show here.

test/command/7009.mddeleted−8

This diff is too big to show here.

test/command/7016.mddeleted−48

This diff is too big to show here.

test/command/7041.mddeleted−23

This diff is too big to show here.

test/command/7042.mddeleted−146

This diff is too big to show here.

test/command/7058.mddeleted−6

This diff is too big to show here.

test/command/7064.mddeleted−32

This diff is too big to show here.

test/command/7067.mddeleted−90

This diff is too big to show here.

test/command/7080.mddeleted−8

This diff is too big to show here.

test/command/7092.mddeleted−8

This diff is too big to show here.

test/command/7099.mddeleted−18

This diff is too big to show here.

test/command/7112.mddeleted−15

This diff is too big to show here.

test/command/7129.mddeleted−27

This diff is too big to show here.

test/command/7132.mddeleted−10

This diff is too big to show here.

test/command/7134.mddeleted−16

This diff is too big to show here.

test/command/7145.mddeleted−12

This diff is too big to show here.

test/command/7155.mddeleted−15

This diff is too big to show here.

test/command/7173.mddeleted−137

This diff is too big to show here.

test/command/7208.mddeleted−6

This diff is too big to show here.

test/command/7214.mddeleted−28

This diff is too big to show here.

test/command/7216.mddeleted−19

This diff is too big to show here.

test/command/7266.mddeleted−10

This diff is too big to show here.

test/command/7272.mddeleted−27

This diff is too big to show here.

test/command/7278.mddeleted−38

This diff is too big to show here.

test/command/7282.mddeleted−7

This diff is too big to show here.

test/command/7288.mddeleted−40

This diff is too big to show here.

test/command/7299.mddeleted−23

This diff is too big to show here.

test/command/7321.mddeleted−24

This diff is too big to show here.

test/command/7323.mddeleted−29

This diff is too big to show here.

test/command/7324.mddeleted−25

This diff is too big to show here.

test/command/7339.mddeleted−11

This diff is too big to show here.

test/command/7340.mddeleted−6

This diff is too big to show here.

test/command/7376.mddeleted−16

This diff is too big to show here.

test/command/7394.mddeleted−85

This diff is too big to show here.

test/command/7397.mddeleted−14

This diff is too big to show here.

test/command/7400.mddeleted−9

This diff is too big to show here.

test/command/7416.mddeleted−19

This diff is too big to show here.

test/command/advanced-optical-materials.csldeleted−155

This diff is too big to show here.

test/command/annales.csldeleted−334

This diff is too big to show here.

test/command/apa.csldeleted−474

This diff is too big to show here.

test/command/archeologie-medievale.csldeleted−291

This diff is too big to show here.

test/command/averroes.bibdeleted−95

This diff is too big to show here.

test/command/biblatex-266.mddeleted−34

This diff is too big to show here.

test/command/biblatex-aksin.mddeleted−78

This diff is too big to show here.

test/command/biblatex-almendro.mddeleted−71

This diff is too big to show here.

test/command/biblatex-angenendt.mddeleted−66

This diff is too big to show here.

test/command/biblatex-aristotle-anima.mddeleted−62

This diff is too big to show here.

test/command/biblatex-aristotle-physics.mddeleted−63

This diff is too big to show here.

test/command/biblatex-aristotle-poetics.mddeleted−65

This diff is too big to show here.

test/command/biblatex-aristotle-rhetoric.mddeleted−80

This diff is too big to show here.

test/command/biblatex-article.mddeleted−128

This diff is too big to show here.

test/command/biblatex-augustine.mddeleted−56

This diff is too big to show here.

test/command/biblatex-averroes-bland.mddeleted−85

This diff is too big to show here.

test/command/biblatex-averroes-hannes.mddeleted−84

This diff is too big to show here.

test/command/biblatex-averroes-hercz.mddeleted−85

This diff is too big to show here.

test/command/biblatex-baez-article.mddeleted−76

This diff is too big to show here.

test/command/biblatex-baez-online.mddeleted−69

This diff is too big to show here.

test/command/biblatex-basic.mddeleted−71

This diff is too big to show here.

test/command/biblatex-bertram.mddeleted−66

This diff is too big to show here.

test/command/biblatex-bibstring-resolution.mddeleted−20

This diff is too big to show here.

test/command/biblatex-book-averroes.mddeleted−129

This diff is too big to show here.

test/command/biblatex-book-coleridge.mddeleted−59

This diff is too big to show here.

test/command/biblatex-book-title-maintitle-series.mddeleted−39

This diff is too big to show here.

test/command/biblatex-book-vazques-de-parga.mddeleted−48

This diff is too big to show here.

test/command/biblatex-brandt.mddeleted−88

This diff is too big to show here.

test/command/biblatex-britannica.mddeleted−85

This diff is too big to show here.

test/command/biblatex-chiu.mddeleted−77

This diff is too big to show here.

test/command/biblatex-cicero.mddeleted−82

This diff is too big to show here.

test/command/biblatex-cms.mddeleted−81

This diff is too big to show here.

test/command/biblatex-coleridge.mddeleted−86

This diff is too big to show here.

test/command/biblatex-companion.mddeleted−70

This diff is too big to show here.

test/command/biblatex-cotton.mddeleted−69

This diff is too big to show here.

test/command/biblatex-crossref-inbook-mvbook.mddeleted−58

This diff is too big to show here.

test/command/biblatex-crossref-nested.mddeleted−100

This diff is too big to show here.

test/command/biblatex-ctan.mddeleted−73

This diff is too big to show here.

test/command/biblatex-dates.mddeleted−162

This diff is too big to show here.

test/command/biblatex-doody.mddeleted−101

This diff is too big to show here.

test/command/biblatex-edtf-date.mddeleted−72

This diff is too big to show here.

test/command/biblatex-escapedquotes.mddeleted−51

This diff is too big to show here.

test/command/biblatex-formatting.mddeleted−23

This diff is too big to show here.

test/command/biblatex-gaonkar-in.mddeleted−62

This diff is too big to show here.

test/command/biblatex-gaonkar.mddeleted−59

This diff is too big to show here.

test/command/biblatex-geer.mddeleted−70

This diff is too big to show here.

test/command/biblatex-gerhardt.mddeleted−64

This diff is too big to show here.

test/command/biblatex-gillies.mddeleted−69

This diff is too big to show here.

test/command/biblatex-glashow.mddeleted−51

This diff is too big to show here.

test/command/biblatex-gonzalez.mddeleted−62

This diff is too big to show here.

test/command/biblatex-hammond.mddeleted−63

This diff is too big to show here.

test/command/biblatex-herrmann.mddeleted−70

This diff is too big to show here.

test/command/biblatex-hyman.mddeleted−79

This diff is too big to show here.

test/command/biblatex-iliad.mddeleted−68

This diff is too big to show here.

test/command/biblatex-inbook-title-booktitle-maintitle-series-2.mddeleted−48

This diff is too big to show here.

test/command/biblatex-inbook-title-booktitle-maintitle-series.mddeleted−44

This diff is too big to show here.

test/command/biblatex-inbook.mddeleted−147

This diff is too big to show here.

test/command/biblatex-incollection-2.mddeleted−98

This diff is too big to show here.

test/command/biblatex-incollection.mddeleted−130

This diff is too big to show here.

test/command/biblatex-inproceedings.mddeleted−88

This diff is too big to show here.

test/command/biblatex-issue288.mddeleted−35

This diff is too big to show here.

test/command/biblatex-itzhaki.mddeleted−82

This diff is too big to show here.

test/command/biblatex-jaffe.mddeleted−82

This diff is too big to show here.

test/command/biblatex-jcg.mddeleted−54

This diff is too big to show here.

test/command/biblatex-kant-kpv.mddeleted−90

This diff is too big to show here.

test/command/biblatex-kant-ku.mddeleted−82

This diff is too big to show here.

test/command/biblatex-kastenholz.mddeleted−126

This diff is too big to show here.

test/command/biblatex-knuth-ct-a.mddeleted−78

This diff is too big to show here.

test/command/biblatex-knuth-ct-b.mddeleted−70

This diff is too big to show here.

test/command/biblatex-knuth-ct-c.mddeleted−69

This diff is too big to show here.

test/command/biblatex-knuth-ct-d.mddeleted−71

This diff is too big to show here.

test/command/biblatex-knuth-ct-e.mddeleted−66

This diff is too big to show here.

test/command/biblatex-knuth-ct-related.mddeleted−72

This diff is too big to show here.

test/command/biblatex-knuth-ct.mddeleted−66

This diff is too big to show here.

test/command/biblatex-kowalik.mddeleted−68

This diff is too big to show here.

test/command/biblatex-kullback-related.mddeleted−62

This diff is too big to show here.

test/command/biblatex-kullback-reprint.mddeleted−71

This diff is too big to show here.

test/command/biblatex-kullback.mddeleted−52

This diff is too big to show here.

test/command/biblatex-laufenberg.mddeleted−109

This diff is too big to show here.

test/command/biblatex-loh.mddeleted−65

This diff is too big to show here.

test/command/biblatex-malinowski.mddeleted−67

This diff is too big to show here.

test/command/biblatex-manual.mddeleted−51

This diff is too big to show here.

test/command/biblatex-markey.mddeleted−65

This diff is too big to show here.

test/command/biblatex-maron.mddeleted−70

This diff is too big to show here.

test/command/biblatex-massa.mddeleted−56

This diff is too big to show here.

test/command/biblatex-moore-related.mddeleted−66

This diff is too big to show here.

test/command/biblatex-moore.mddeleted−56

This diff is too big to show here.

test/command/biblatex-moraux.mddeleted−94

This diff is too big to show here.

test/command/biblatex-murray.mddeleted−105

This diff is too big to show here.

test/command/biblatex-nietzsche-historie.mddeleted−100

This diff is too big to show here.

test/command/biblatex-nietzsche-ksa.mddeleted−89

This diff is too big to show here.

test/command/biblatex-nietzsche-ksa1.mddeleted−95

This diff is too big to show here.

test/command/biblatex-online.mddeleted−64

This diff is too big to show here.

test/command/biblatex-options-url-false-doi-false.mddeleted−57

This diff is too big to show here.

test/command/biblatex-padhye.mddeleted−117

This diff is too big to show here.

test/command/biblatex-patent.mddeleted−158

This diff is too big to show here.

test/command/biblatex-periodical.mddeleted−31

This diff is too big to show here.

test/command/biblatex-piccato.mddeleted−59

This diff is too big to show here.

test/command/biblatex-pines.mddeleted−77

This diff is too big to show here.

test/command/biblatex-quotes.mddeleted−44

This diff is too big to show here.

test/command/biblatex-reese.mddeleted−71

This diff is too big to show here.

test/command/biblatex-report.mddeleted−119

This diff is too big to show here.

test/command/biblatex-salam.mddeleted−69

This diff is too big to show here.

test/command/biblatex-sarfraz.mddeleted−65

This diff is too big to show here.

test/command/biblatex-shore.mddeleted−66

This diff is too big to show here.

test/command/biblatex-sigfridsson.mddeleted−106

This diff is too big to show here.

test/command/biblatex-sorace.mddeleted−65

This diff is too big to show here.

test/command/biblatex-spiegelberg.mddeleted−74

This diff is too big to show here.

test/command/biblatex-springer.mddeleted−58

This diff is too big to show here.

test/command/biblatex-strings.mddeleted−46

This diff is too big to show here.

test/command/biblatex-test-case-conversion.mddeleted−73

This diff is too big to show here.

test/command/biblatex-textnormal.mddeleted−17

This diff is too big to show here.

test/command/biblatex-thesis.mddeleted−68

This diff is too big to show here.

test/command/biblatex-title-and-shorttitle.mddeleted−76

This diff is too big to show here.

test/command/biblatex-vangennep-related.mddeleted−69

This diff is too big to show here.

test/command/biblatex-vangennep-trans.mddeleted−69

This diff is too big to show here.

test/command/biblatex-vangennep.mddeleted−61

This diff is too big to show here.

test/command/biblatex-vazques-de-parga-mvbook.mddeleted−75

This diff is too big to show here.

test/command/biblatex-vazques-de-parga.mddeleted−74

This diff is too big to show here.

test/command/biblatex-video.mddeleted−19

This diff is too big to show here.

test/command/biblatex-vizedom-related.mddeleted−68

This diff is too big to show here.

test/command/biblatex-wassenberg.mddeleted−83

This diff is too big to show here.

test/command/biblatex-weinberg.mddeleted−52

This diff is too big to show here.

test/command/biblatex-westfahl-frontier.mddeleted−60

This diff is too big to show here.

test/command/biblatex-westfahl-space.mddeleted−106

This diff is too big to show here.

test/command/biblatex-wilde.mddeleted−65

This diff is too big to show here.

test/command/biblatex-worman.mddeleted−60

This diff is too big to show here.

test/command/biblatex-yoon.mddeleted−67

This diff is too big to show here.

test/command/biblio.bibdeleted−26

This diff is too big to show here.

test/command/bibtex-basic.mddeleted−71

This diff is too big to show here.

test/command/bioethics.csldeleted−226

This diff is too big to show here.

test/command/chap1/spider.pngdeleted

Binary file not shown.

test/command/chap1/text.mddeleted−17

This diff is too big to show here.

test/command/chap2/spider.pngdeleted

Binary file not shown.

test/command/chap2/text.mddeleted−5

This diff is too big to show here.

test/command/chicago-annotated-bibliography.csldeleted−1207

This diff is too big to show here.

test/command/chicago-author-date-with-original-date-and-status.csldeleted−575

This diff is too big to show here.

test/command/chicago-fullnote-bibliography.csldeleted−1430

This diff is too big to show here.

test/command/chicago-note-bibliography.csldeleted−1005

This diff is too big to show here.

test/command/chinese-gb7714-2005-numeric.csldeleted−213

This diff is too big to show here.

test/command/cite-in-inline-note.md+1−1

This diff is too big to show here.

test/command/citeproc-17.mddeleted−17

This diff is too big to show here.

test/command/citeproc-20.mddeleted−25

This diff is too big to show here.

test/command/citeproc-7a.mddeleted−42

This diff is too big to show here.

test/command/citeproc-7b.mddeleted−36

This diff is too big to show here.

test/command/citeproc-author-in-text-suffix.mddeleted−6

This diff is too big to show here.

test/command/custom-attributes.htmlnew file+16

This diff is too big to show here.

test/command/defaults-inheritance-1.mddeleted−6

This diff is too big to show here.

test/command/defaults-inheritance-2.mddeleted−5

This diff is too big to show here.

test/command/defaults-inheritance-3.mddeleted−6

This diff is too big to show here.

test/command/defaults3.yamldeleted−4

This diff is too big to show here.

test/command/defaults4.yamldeleted−3

This diff is too big to show here.

test/command/defaults5.yamldeleted−2

This diff is too big to show here.

test/command/defaults6.yamldeleted−2

This diff is too big to show here.

test/command/defaults7.yamldeleted−2

This diff is too big to show here.

test/command/defaults8.yamldeleted−2

This diff is too big to show here.

test/command/defaults9.yamldeleted−1

This diff is too big to show here.

test/command/din-1505-2.csldeleted−406

This diff is too big to show here.

test/command/docbook-bibliography.mddeleted−20

This diff is too big to show here.

test/command/duplicate_attributes.mddeleted−7

This diff is too big to show here.

test/command/empty-inline-code.txtnew file+6

This diff is too big to show here.

test/command/gfm.md+4−4

This diff is too big to show here.

test/command/harvard-university-of-kent.csldeleted−253

This diff is too big to show here.

test/command/ieee.csldeleted−339

This diff is too big to show here.

test/command/issue160.csldeleted−28

This diff is too big to show here.

test/command/issue437.csldeleted−26

This diff is too big to show here.

test/command/issue58.csldeleted−553

This diff is too big to show here.

test/command/latex-center.mddeleted−13

This diff is too big to show here.

test/command/le-tapuscrit-note.csldeleted−496

This diff is too big to show here.

test/command/lists-inside-definition.mddeleted−67

This diff is too big to show here.

test/command/locators.csldeleted−68

This diff is too big to show here.

test/command/mmd-metadata.mddeleted−20

This diff is too big to show here.

test/command/modern-humanities-research-association.csldeleted−445

This diff is too big to show here.

test/command/nested-table-to-asciidoc-6942.mddeleted−82

This diff is too big to show here.

test/command/newif.mddeleted−55

This diff is too big to show here.

test/command/oscola.csldeleted−680

This diff is too big to show here.

test/command/pandoc-citeproc-118.mddeleted−28

This diff is too big to show here.

test/command/pandoc-citeproc-119.mddeleted−38

This diff is too big to show here.

test/command/pandoc-citeproc-13.mddeleted−29

This diff is too big to show here.

test/command/pandoc-citeproc-136.mddeleted−23

This diff is too big to show here.

test/command/pandoc-citeproc-14.mddeleted−77

This diff is too big to show here.

test/command/pandoc-citeproc-152.mddeleted−63

This diff is too big to show here.

test/command/pandoc-citeproc-160.mddeleted−44

This diff is too big to show here.

test/command/pandoc-citeproc-175.mddeleted−43

This diff is too big to show here.

test/command/pandoc-citeproc-197.mddeleted−31

This diff is too big to show here.

test/command/pandoc-citeproc-213.mddeleted−33

This diff is too big to show here.

test/command/pandoc-citeproc-25.mddeleted−30

This diff is too big to show here.

test/command/pandoc-citeproc-250.mddeleted−21

This diff is too big to show here.

test/command/pandoc-citeproc-27.mddeleted−38

This diff is too big to show here.

test/command/pandoc-citeproc-292.mddeleted−43

This diff is too big to show here.

test/command/pandoc-citeproc-301.mddeleted−25

This diff is too big to show here.

test/command/pandoc-citeproc-307.mddeleted−31

This diff is too big to show here.

test/command/pandoc-citeproc-31.mddeleted−48

This diff is too big to show here.

test/command/pandoc-citeproc-312.mddeleted−171

This diff is too big to show here.

test/command/pandoc-citeproc-320.mddeleted−254

This diff is too big to show here.

test/command/pandoc-citeproc-320a.mddeleted−87

This diff is too big to show here.

test/command/pandoc-citeproc-322.mddeleted−35

This diff is too big to show here.

test/command/pandoc-citeproc-325.mddeleted−30

This diff is too big to show here.

test/command/pandoc-citeproc-327.mddeleted−51

This diff is too big to show here.

test/command/pandoc-citeproc-338.mddeleted−35

This diff is too big to show here.

test/command/pandoc-citeproc-351.mddeleted−27

This diff is too big to show here.

test/command/pandoc-citeproc-356.mddeleted−20

This diff is too big to show here.

test/command/pandoc-citeproc-360.mddeleted−35

This diff is too big to show here.

test/command/pandoc-citeproc-361.mddeleted−80

This diff is too big to show here.

test/command/pandoc-citeproc-365.mddeleted−39

This diff is too big to show here.

test/command/pandoc-citeproc-371.mddeleted−40

This diff is too big to show here.

test/command/pandoc-citeproc-38.mddeleted−29

This diff is too big to show here.

test/command/pandoc-citeproc-386.mddeleted−35

This diff is too big to show here.

test/command/pandoc-citeproc-392.mddeleted−29

This diff is too big to show here.

test/command/pandoc-citeproc-399.mddeleted−45

This diff is too big to show here.

test/command/pandoc-citeproc-401.mddeleted−59

This diff is too big to show here.

test/command/pandoc-citeproc-408.mddeleted−39

This diff is too big to show here.

test/command/pandoc-citeproc-416.mddeleted−60

This diff is too big to show here.

test/command/pandoc-citeproc-437.mddeleted−23

This diff is too big to show here.

test/command/pandoc-citeproc-47.mddeleted−112

This diff is too big to show here.

test/command/pandoc-citeproc-51.mddeleted−45

This diff is too big to show here.

test/command/pandoc-citeproc-53.mddeleted−56

This diff is too big to show here.

test/command/pandoc-citeproc-57.mddeleted−37

This diff is too big to show here.

test/command/pandoc-citeproc-58.mddeleted−32

This diff is too big to show here.

test/command/pandoc-citeproc-61.mddeleted−77

This diff is too big to show here.

test/command/pandoc-citeproc-64.mddeleted−24

This diff is too big to show here.

test/command/pandoc-citeproc-65.mddeleted−38

This diff is too big to show here.

test/command/pandoc-citeproc-68.mddeleted−56

This diff is too big to show here.

test/command/pandoc-citeproc-7.mddeleted−31

This diff is too big to show here.

test/command/pandoc-citeproc-70.mddeleted−73

This diff is too big to show here.

test/command/pandoc-citeproc-75.mddeleted−67

This diff is too big to show here.

test/command/pandoc-citeproc-76.mddeleted−64

This diff is too big to show here.

test/command/pandoc-citeproc-77.mddeleted−67

This diff is too big to show here.

test/command/pandoc-citeproc-82.mddeleted−39

This diff is too big to show here.

test/command/pandoc-citeproc-87.mddeleted−156

This diff is too big to show here.

test/command/pandoc-citeproc-chicago-author-date.mddeleted−109

This diff is too big to show here.

test/command/pandoc-citeproc-chicago-fullnote-bibliography.mddeleted−134

This diff is too big to show here.

test/command/pandoc-citeproc-ieee.mddeleted−113

This diff is too big to show here.

test/command/pandoc-citeproc-locators-delimited.mddeleted−127

This diff is too big to show here.

test/command/pandoc-citeproc-locators-integrated.mddeleted−159

This diff is too big to show here.

test/command/pandoc-citeproc-move-period-inside-quote.mddeleted−52

This diff is too big to show here.

test/command/pandoc-citeproc-no-author.mddeleted−73

This diff is too big to show here.

test/command/pandoc-citeproc-number-of-volumes.mddeleted−29

This diff is too big to show here.

test/command/pandoc-citeproc-page-range.mddeleted−32

This diff is too big to show here.

test/command/sage-harvard.csldeleted−202

This diff is too big to show here.

test/command/science.csldeleted−245

This diff is too big to show here.

test/command/style399.csldeleted−12

This diff is too big to show here.

test/command/svg.md+15−17

This diff is too big to show here.

test/command/table-with-cell-align.mddeleted−82

This diff is too big to show here.

test/command/table-with-column-span.mddeleted−276

This diff is too big to show here.

test/command/toc.md+20−11

This diff is too big to show here.

test/command/unicode-collation.mddeleted−130

This diff is too big to show here.

test/command/vancouver.csldeleted−351

This diff is too big to show here.

test/command/yaml-metadata-blocks.md+3−3

This diff is too big to show here.

test/command/zeitschrift-fur-kunstgeschichte.csldeleted−346

This diff is too big to show here.

test/docbook-reader.docbook+2−9

This diff is too big to show here.

test/docx/0_level_headers.native+2−2

This diff is too big to show here.

test/docx/golden/block_quotes.docx

Binary file not shown.

test/docx/golden/codeblock.docx

Binary file not shown.

test/docx/golden/comments.docx

Binary file not shown.

test/docx/golden/custom_style_no_reference.docx

Binary file not shown.

test/docx/golden/custom_style_preserve.docx

Binary file not shown.

test/docx/golden/custom_style_reference.docx

Binary file not shown.

test/docx/golden/definition_list.docx

Binary file not shown.

test/docx/golden/document-properties-short-desc.docx

Binary file not shown.

test/docx/golden/document-properties.docx

Binary file not shown.

test/docx/golden/headers.docx

Binary file not shown.

test/docx/golden/image.docx

Binary file not shown.

test/docx/golden/inline_code.docx

Binary file not shown.

test/docx/golden/inline_formatting.docx

Binary file not shown.

test/docx/golden/inline_images.docx

Binary file not shown.

test/docx/golden/link_in_notes.docx

Binary file not shown.

test/docx/golden/links.docx

Binary file not shown.

test/docx/golden/lists.docx

Binary file not shown.

test/docx/golden/lists_continuing.docx

Binary file not shown.

test/docx/golden/lists_multiple_initial.docxdeleted

Binary file not shown.

test/docx/golden/lists_restarting.docx

Binary file not shown.

test/docx/golden/nested_anchors_in_header.docx

Binary file not shown.

test/docx/golden/notes.docx

Binary file not shown.

test/docx/golden/raw-blocks.docxdeleted

Binary file not shown.

test/docx/golden/raw-bookmarks.docxdeleted

Binary file not shown.

test/docx/golden/table_one_row.docx

Binary file not shown.

test/docx/golden/table_with_list_cell.docx

Binary file not shown.

test/docx/golden/tables-default-widths.docxdeleted

Binary file not shown.

test/docx/golden/tables.docx

Binary file not shown.

test/docx/golden/track_changes_deletion.docx

Binary file not shown.

test/docx/golden/track_changes_insertion.docx

Binary file not shown.

test/docx/golden/track_changes_move.docx

Binary file not shown.

test/docx/golden/track_changes_scrubbed_metadata.docxdeleted

Binary file not shown.

test/docx/golden/unicode.docx

Binary file not shown.

test/docx/golden/verbatim_subsuper.docx

Binary file not shown.

test/docx/image_vml_as_object.docxdeleted

Binary file not shown.

test/docx/image_vml_as_object.nativedeleted−2

This diff is too big to show here.

test/docx/inline_formatting.native+1−1

This diff is too big to show here.

test/docx/lists_multiple_initial.nativedeleted−8

This diff is too big to show here.

test/docx/raw-blocks.nativedeleted−6

This diff is too big to show here.

test/docx/raw-bookmarks.nativedeleted−3

This diff is too big to show here.

test/docx/sdt_elements.native+10−9

This diff is too big to show here.

test/docx/table_captions_no_field.docxdeleted

Binary file not shown.

test/docx/table_captions_no_field.nativedeleted−34

This diff is too big to show here.

test/docx/table_captions_with_field.docxdeleted

Binary file not shown.

test/docx/table_captions_with_field.nativedeleted−54

This diff is too big to show here.

test/docx/table_header_rowspan.docxdeleted

Binary file not shown.

test/docx/table_header_rowspan.nativedeleted−189

This diff is too big to show here.

test/docx/table_one_header_row.docxdeleted

Binary file not shown.

test/docx/table_one_header_row.nativedeleted−18

This diff is too big to show here.

test/docx/table_one_row.docx

Binary file not shown.

test/docx/table_one_row.native+4−4

This diff is too big to show here.

test/docx/table_variable_width.native+17−12

This diff is too big to show here.

test/docx/table_with_list_cell.native+3−3

This diff is too big to show here.

test/docx/tables-default-widths.nativedeleted−92

This diff is too big to show here.

test/docx/tables.native+9−9

This diff is too big to show here.

test/docx/track_changes_scrubbed_metadata.docxdeleted

Binary file not shown.

test/docx/track_changes_scrubbed_metadata.nativedeleted−9

This diff is too big to show here.

test/epub/features.epub

Binary file not shown.

test/epub/features.native+3−3

This diff is too big to show here.

test/epub/wasteland.epub

Binary file not shown.

test/epub/wasteland.native+4−4

This diff is too big to show here.

test/fb2/images.fb2+1−1

This diff is too big to show here.

test/fb2/test.jpg

Binary file not shown.

test/grofftest.shnew file+26

This diff is too big to show here.

test/html-reader.html−76

This diff is too big to show here.

test/html-reader.native+37−148

This diff is too big to show here.

test/jats-reader.native+1−1

This diff is too big to show here.

test/jats-reader.xml−1

This diff is too big to show here.

test/jira-reader.native+1−1

This diff is too big to show here.

test/latex-reader.native+13−26

This diff is too big to show here.

test/lhs-test.html+3−135

This diff is too big to show here.

test/lhs-test.html+lhs+3−135

This diff is too big to show here.

test/lhs-test.latex+3−6

This diff is too big to show here.

test/lhs-test.latex+lhs+3−6

This diff is too big to show here.

test/lua/module/pandoc-path.luadeleted−44

This diff is too big to show here.

test/lua/module/pandoc-utils.lua−66

This diff is too big to show here.

test/markdown-citations.native+14−14

This diff is too big to show here.

test/markdown-reader-more.native+34−6

This diff is too big to show here.

test/odt/native/tab.nativedeleted−1

This diff is too big to show here.

test/odt/odt/tab.odtdeleted

Binary file not shown.

test/org-select-tags.org+2−2

This diff is too big to show here.

test/pipe-tables.native+10−2

This diff is too big to show here.

test/pptx/code-custom.pptx

Binary file not shown.

test/pptx/code-custom_templated.pptx

Binary file not shown.

test/pptx/code.pptx

Binary file not shown.

test/pptx/code_templated.pptx

Binary file not shown.

test/pptx/document-properties-short-desc.pptx

Binary file not shown.

test/pptx/document-properties-short-desc_templated.pptx

Binary file not shown.

test/pptx/document-properties.pptx

Binary file not shown.

test/pptx/document-properties_templated.pptx

Binary file not shown.

test/pptx/endnotes.pptx

Binary file not shown.

test/pptx/endnotes_templated.pptx

Binary file not shown.

test/pptx/endnotes_toc.pptx

Binary file not shown.

test/pptx/endnotes_toc_templated.pptx

Binary file not shown.

test/pptx/images.pptx

Binary file not shown.

test/pptx/images_templated.pptx

Binary file not shown.

test/pptx/inline_formatting.pptx

Binary file not shown.

test/pptx/inline_formatting_templated.pptx

Binary file not shown.

test/pptx/lists.pptx

Binary file not shown.

test/pptx/lists_templated.pptx

Binary file not shown.

test/pptx/raw_ooxml.native+1−1

This diff is too big to show here.

test/pptx/raw_ooxml.pptx

Binary file not shown.

test/pptx/raw_ooxml_templated.pptx

Binary file not shown.

test/pptx/reference_depth.pptx

Binary file not shown.

test/pptx/remove_empty_slides.pptx

Binary file not shown.

test/pptx/remove_empty_slides_templated.pptx

Binary file not shown.

test/pptx/slide_breaks.pptx

Binary file not shown.

test/pptx/slide_breaks_slide_level_1.pptx

Binary file not shown.

test/pptx/slide_breaks_slide_level_1_templated.pptx

Binary file not shown.

test/pptx/slide_breaks_templated.pptx

Binary file not shown.

test/pptx/slide_breaks_toc.pptx

Binary file not shown.

test/pptx/slide_breaks_toc_templated.pptx

Binary file not shown.

test/pptx/speaker_notes.pptx

Binary file not shown.

test/pptx/speaker_notes_after_metadata.pptx

Binary file not shown.

test/pptx/speaker_notes_after_metadata_templated.pptx

Binary file not shown.

test/pptx/speaker_notes_afterheader.pptx

Binary file not shown.

test/pptx/speaker_notes_afterheader_templated.pptx

Binary file not shown.

test/pptx/speaker_notes_afterseps.pptx

Binary file not shown.

test/pptx/speaker_notes_afterseps_templated.pptx

Binary file not shown.

test/pptx/speaker_notes_templated.pptx

Binary file not shown.

test/pptx/start_numbering_at.pptx

Binary file not shown.

test/pptx/start_numbering_at_templated.pptx

Binary file not shown.

test/pptx/tables.pptx

Binary file not shown.

test/pptx/tables_templated.pptx

Binary file not shown.

test/pptx/two_column.pptx

Binary file not shown.

test/pptx/two_column_templated.pptx

Binary file not shown.

test/rst-reader.native+21−3

This diff is too big to show here.

test/s5-fancy.html+1−1

This diff is too big to show here.

test/tables-rstsubset.native+9−1

This diff is too big to show here.

test/tables.jats_archiving+156−156

This diff is too big to show here.

test/tables.jats_articleauthoring+156−156

This diff is too big to show here.

test/tables.jats_publishing+156−156

This diff is too big to show here.

test/tables.latex+101−65

This diff is too big to show here.

test/tables.ms−44

This diff is too big to show here.

test/tables.org+3−3

This diff is too big to show here.

test/tables/nordics.html4deleted−59

This diff is too big to show here.

test/tables/nordics.html5deleted−59

This diff is too big to show here.

test/tables/nordics.jats_archivingdeleted−58

This diff is too big to show here.

test/tables/nordics.latexdeleted−42

This diff is too big to show here.

test/tables/nordics.nativedeleted−73

This diff is too big to show here.

test/tables/planets.html4deleted−133

This diff is too big to show here.

test/tables/planets.html5deleted−133

This diff is too big to show here.

test/tables/planets.jats_archivingdeleted−128

This diff is too big to show here.

test/tables/planets.latexdeleted−30

This diff is too big to show here.

test/tables/planets.nativedeleted−241

This diff is too big to show here.

test/tables/students.html4deleted−55

This diff is too big to show here.

test/tables/students.html5deleted−55

This diff is too big to show here.

test/tables/students.jats_archivingdeleted−56

This diff is too big to show here.

test/tables/students.latexdeleted−31

This diff is too big to show here.

test/tables/students.nativedeleted−54

This diff is too big to show here.

test/test-pandoc.hs+8−22

This diff is too big to show here.

test/textile-reader.native+1−1

This diff is too big to show here.

test/textile-reader.textile+1−1

This diff is too big to show here.

test/txt2tags.native+1−1

This diff is too big to show here.

test/txt2tags.t2t+1−1

This diff is too big to show here.

test/writer.asciidoc+1−1

This diff is too big to show here.

test/writer.asciidoctor+1−1

This diff is too big to show here.

test/writer.context+43−45

This diff is too big to show here.

test/writer.custom+2−2

This diff is too big to show here.

test/writer.dokuwiki−11

This diff is too big to show here.

test/writer.html4−131

This diff is too big to show here.

test/writer.html5+1−132

This diff is too big to show here.

test/writer.icml+29−65

This diff is too big to show here.

test/writer.jats_archiving+8−12

This diff is too big to show here.

test/writer.jats_articleauthoring+1−1

This diff is too big to show here.

test/writer.jats_publishing+8−12

This diff is too big to show here.

test/writer.jira+38−26

This diff is too big to show here.

test/writer.latex+3−6

This diff is too big to show here.

test/writer.markdown+55−28

This diff is too big to show here.

test/writer.ms+1−1

This diff is too big to show here.

test/writer.opml+1−1

This diff is too big to show here.

test/writer.org+118−91

This diff is too big to show here.

test/writer.zimwiki+3−3

This diff is too big to show here.

test/writers-lang-and-dir.context+5−7

This diff is too big to show here.

test/writers-lang-and-dir.latex+7−13

This diff is too big to show here.

tools/build-arm.shdeleted−110

This diff is too big to show here.

tools/changelog-helper.sh+4−11

This diff is too big to show here.

tools/parseTimings.pldeleted−33

This diff is too big to show here.

trypandoc/index.html+1−1

This diff is too big to show here.

trypandoc/trypandoc.hs+10−4

This diff is too big to show here.

windows/Makefile+1−1

This diff is too big to show here.

windows/pandoc.wxs+4−2

This diff is too big to show here.