git.iko.soy/typeable/pandoc
on master help sign in
.circleci/config.yml+64−122
since splitsnapshots
unifiedsplit
@@ -1,130 +1,72 @@
1version: "2.1"
1version: "2.1"
2−
2+jobs:
3−env: &env
3+ build:
4+ macos:
5+ xcode: 11.1.0
4 environment:
6 environment:
5− LC_ALL: "C.UTF-8"
7+ HOMEBREW_NO_AUTO_UPDATE: 1
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
38 steps:
8 steps:
39− - checkout
9+ - checkout
40− - *preinstall
10+ - restore_cache:
41− - *restore
11+ # See https://circleci.com/docs/2.0/caching/
42− - run:
12+ name: Restore Cached Dependencies
43− name: install cabal
13+ keys:
44− command: apt-get install -y cabal-install-2.4
14+ - stack-dependencies-{{ checksum "stack.yaml" }}
45− - run:
15+ - run:
46− name: install ghc
16+ name: Install stack
47− command: |
17+ command: stack --version || (curl -sSL https://get.haskellstack.org/ | sh -s - -f)
48− apt-get install -y ghc-<< parameters.ghcversion >>
18+ - run:
49− - run:
19+ name: Resolve/Update Dependencies
50− name: build and test project
20+ command: stack --no-terminal setup
51− command: |
21+ - run:
52− set -e
22+ name: Run tests
53− cabal v2-update
23+ command: stack --no-terminal test
54− TMPDIR=`mktemp -d -t circleci.XXXXXXX`
24+ - run:
55− cabal v2-sdist --output-dir=${TMPDIR}
25+ name: Install executable
56− cd ${TMPDIR}
26+ command: stack --no-terminal install
57− tar xvzf *.tar.gz
27+ - run:
58− cd *
28+ name: Create artifacts
59− cabal v2-build -w ghc-<< parameters.ghcversion >> -j2 --disable-optimization --dependencies-only --enable-tests --enable-benchmarks
29+ command: |
60− cabal v2-build -w ghc-<< parameters.ghcversion >> -j2 --disable-optimization --enable-tests --enable-benchmarks 2>build.log
30+ export VERSION=$(grep '^[Vv]ersion:' pandoc.cabal | awk '{print $$2;}')
61− cat build.log
31+ export ARTIFACTS=macos-release-candidate
62− # fail if we had warnings in local build
32+ export RESOURCES=${ARTIFACTS}/Resources
63− # this is to work around the fact that cabal v2 doesn't allow
33+ export ROOT=${ARTIFACTS}/pandoc
64− # us to use -Werror for just local build:
34+ export DEST=${ROOT}/usr/local
65− # https://github.com/haskell/cabal/issues/4247
35+ export ME=$(whoami)
66− ! grep -q "[Ww]arning:" build.log
36+ export BASE=pandoc-$VERSION
67− cabal v2-test -w ghc-<< parameters.ghcversion >> -j2 --disable-optimization --enable-tests
37+ mkdir -p ${ARTIFACTS}
68− cabal v2-haddock -w ghc-<< parameters.ghcversion >>
38+ mkdir -p ${RESOURCES}
69− cabal check
39+ mkdir -p ${DEST}/bin
70− - *save
40+ mkdir -p ${DEST}/share/man/man1
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}
71
50
72−#-----------------------------------------------------------------------------
51+ - save_cache:
73−# Build matrix
52+ name: Cache Dependencies
74−#-----------------------------------------------------------------------------
53+ key: stack-dependencies-{{ checksum "stack.yaml" }}
54+ paths:
55+ - "/root/.stack"
56+ - ".stack-work"
57+ - "/usr/local/bin/stack"
75
58
76−jobs:
59+ - store_artifacts:
77− cabal-ghc-8_8_1:
60+ # https://circleci.com/docs/2.0/artifacts/
78− <<: *env
61+ path: macos-release-candidate.zip
79− steps:
62+ destination: macos-release-candidate.zip
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
119
63
120workflows:
64workflows:
121− version: "2.1"
65+ version: 2
122− build:
66+ release:
123 jobs:
67 jobs:
124− - cabal-ghc-8_6_5
68+ - build:
125− - cabal-ghc-8_4_4
69+ filters:
126− - cabal-ghc-8_2_2
70+ branches:
127− - cabal-ghc-8_0_2
71+ only:
128− - stack-ghc-8_6
72+ - /rc\/.*/
129− # - cabal-ghc-8_8_1
130−
.editorconfig+8
@@ -8,6 +8,14 @@ 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+
11[*.{markdown,md}]
19[*.{markdown,md}]
12trim_trailing_whitespace = false
20trim_trailing_whitespace = false
13
21
.github/FUNDING.yml+1−1
@@ -1 +1 @@
1−github: [jgm]
1+github: [jgm,tarleb]
.github/ISSUE_TEMPLATEdeleted−11
@@ -1,11 +0,0 @@
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.mdnew file+25
@@ -0,0 +1,25 @@
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.ymlnew file+9
@@ -0,0 +1,9 @@
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.mdnew file+21
@@ -0,0 +1,21 @@
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+196−27
@@ -5,7 +5,7 @@ on:
5 branches:
5 branches:
6 - '*'
6 - '*'
7 - '!rc/*'
7 - '!rc/*'
8− ignore-paths:
8+ paths-ignore:
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− ignore-paths:
23+ paths-ignore:
24 - 'doc/**'
24 - 'doc/**'
25 - 'MANUAL.txt'
25 - 'MANUAL.txt'
26 - '*.md'
26 - '*.md'
@@ -38,49 +38,130 @@ on:
38jobs:
38jobs:
39 linux:
39 linux:
40
40
41− runs-on: ubuntu-latest
41+ runs-on: ubuntu-18.04
42 strategy:
42 strategy:
43 fail-fast: true
43 fail-fast: true
44 matrix:
44 matrix:
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: ''
48 - ghc: '8.2.2'
51 - ghc: '8.2.2'
49 cabal: '2.4'
52 cabal: '2.4'
53+ prefix: 'v2-'
54+ cabalopts: ''
55+ testopts: ''
50 - ghc: '8.4.4'
56 - ghc: '8.4.4'
51 cabal: '2.4'
57 cabal: '2.4'
58+ prefix: 'v2-'
59+ cabalopts: '-f-embed_data_files'
60+ testopts: ''
52 - ghc: '8.6.5'
61 - ghc: '8.6.5'
53− cabal: '2.4'
62+ cabal: '3.2'
63+ prefix: ''
64+ cabalopts: ''
65+ testopts: '--test-option=--hide-successes'
66+ - ghc: '8.8.4'
67+ cabal: '3.2'
68+ prefix: ''
69+ cabalopts: ''
70+ testopts: '--test-option=--hide-successes'
54− - ghc: '8.8.1'
71+ - ghc: '8.10.4'
55− cabal: '3.0'
72+ 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'
56 steps:
81 steps:
57− - uses: actions/checkout@v1
82+ - uses: actions/checkout@v2
83+
84+ # needed by memory
85+ - name: Install numa
86+ run: sudo apt-get install libnuma-dev
87+
88+ # need to install older cabal/ghc versions from ppa repository
89+
90+ - name: Install recent cabal/ghc
91+ uses: haskell/actions/setup@v1
92+ with:
93+ ghc-version: ${{ matrix.versions.ghc }}
94+ cabal-version: ${{ matrix.versions.cabal }}
95+
96+ # declare/restore cached things
97+ # caching doesn't work for scheduled runs yet
98+ # https://github.com/actions/cache/issues/63
99+
100+ - name: Cache cabal global package db
101+ id: cabal-global
102+ uses: actions/cache@v2
103+ with:
104+ path: |
105+ ~/.cabal
106+ key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-global-${{ hashFiles('cabal.project') }}
107+
108+ - name: Cache cabal work
109+ id: cabal-local
110+ uses: actions/cache@v2
111+ with:
112+ path: |
113+ dist-newstyle
114+ key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-local
115+
58 - name: Install dependencies
116 - name: Install dependencies
59 run: |
117 run: |
60− export PATH=/opt/cabal/${{ matrix.versions.cabal }}/bin:/opt/ghc/${{ matrix.versions.ghc }}/bin:$PATH
118+ cabal ${{ matrix.versions.prefix }}update
61− cabal v2-update
62− cabal v2-build --dependencies-only --enable-tests --disable-optimization
119+ cabal ${{ matrix.versions.prefix }}build ${{ matrix.versions.cabalopts }} --dependencies-only --enable-tests --disable-optimization
120+
63 - name: Build and test
121 - name: Build and test
64 run: |
122 run: |
65− export PATH=/opt/cabal/${{ matrix.versions.cabal }}/bin:/opt/ghc/${{ matrix.versions.ghc }}/bin:$PATH
66− cabal v2-build --enable-tests --disable-optimization 2>&1 | tee build.log
123+ cabal ${{ matrix.versions.prefix }}build ${{ matrix.versions.cabalopts }} --enable-tests --disable-optimization 2>&1 | tee build.log
67 # fail if warnings in local build
124 # fail if warnings in local build
68 ! grep -q ": *[Ww]arning:" build.log || exit 1
125 ! grep -q ": *[Ww]arning:" build.log || exit 1
69− cabal v2-test --disable-optimization
126+ cabal ${{ matrix.versions.prefix }}test ${{ matrix.versions.cabalopts }} --disable-optimization ${{ matrix.versions.testopts }}
70
127
71 windows:
128 windows:
72
129
73− runs-on: windows-latest
130+ runs-on: windows-2019
74
131
75 steps:
132 steps:
76− - uses: actions/checkout@v1
133+ - uses: actions/checkout@v2
134+
135+ # We should have ghc 8.10, cabal, stack pre-installed
136+ # - uses: haskell/actions/setup@v1
137+ # with:
138+ # enable-stack: true
139+ # stack-version: 'latest'
140+
141+ # declare/restore cached things
142+ # caching doesn't work for scheduled runs yet
143+ # https://github.com/actions/cache/issues/63
144+
77− - name: Install stack
145+ - name: Cache stack global package db
78− shell: cmd
146+ id: stack-global-package-db
79− run: |
147+ uses: actions/cache@v2
80− choco install haskell-stack
148+ with:
149+ path: |
150+ C:\Users\runneradmin\AppData\Roaming\stack\
151+ key: ${{ runner.os }}-appdata-roaming-stack-${{ hashFiles('stack.yaml') }}
152+
153+ # stack's local package dbs for the project and each package
154+ # - name: Cache .stack-work
155+ # uses: actions/cache@v1
156+ # with:
157+ # path: .stack-work
158+ # key: ${{ runner.os }}-stack-work-${{ hashFiles('stack.yaml') }}
159+ # restore-keys: ${{ runner.os }}-stack-work
160+
81 - name: Install dependencies
161 - name: Install dependencies
82 run: |
162 run: |
83 stack update
163 stack update
164+ stack install happy
84 stack test --dependencies-only --fast
165 stack test --dependencies-only --fast
85 - name: Build and test
166 - name: Build and test
86 shell: cmd
167 shell: cmd
@@ -89,18 +170,106 @@ jobs:
89
170
90 macos:
171 macos:
91
172
92− runs-on: macOS-latest
173+ runs-on: macOS-10.15
174+ strategy:
175+ fail-fast: true
176+ matrix:
177+ versions:
178+ - ghc: '8.8.4'
179+ cabal: '3.2'
93
180
94 steps:
181 steps:
95− - uses: actions/checkout@v1
182+ - uses: actions/checkout@v2
96− - name: Install stack
183+
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
97 run: |
215 run: |
98− curl -L https://get.haskellstack.org/stable/osx-x86_64.tar.gz -o stack.tar.gz
216+ cabal v2-build --enable-tests --disable-optimization 2>&1 | tee build.log
99− tar xzvf stack.tar.gz --strip-components=1 'stack*/stack'
217+ # fail if warnings in local build
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+
243+ # declare/restore cached things
244+ # caching doesn't work for scheduled runs yet
245+ # https://github.com/actions/cache/issues/63
246+
247+ - name: Cache cabal global package db
248+ id: cabal-global
249+ uses: actions/cache@v2
250+ with:
251+ path: |
252+ ~/.cabal
253+ key: benchmark-${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-global-${{ hashFiles('cabal.project') }}
254+
255+ - name: Cache cabal work
256+ id: cabal-local
257+ uses: actions/cache@v2
258+ with:
259+ path: |
260+ dist-newstyle
261+ key: benchmark-${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-local
262+
100 - name: Install dependencies
263 - name: Install dependencies
101 run: |
264 run: |
265+ v2=$([ "${{ matrix.versions.cabal }}" = "2.2" ] && printf 'new' || printf 'v2')
102− ./stack update
266+ cabal $v2-update
103− ./stack test --dependencies-only --fast
267+ cabal $v2-build --dependencies-only --enable-optimization=1 --enable-benchmarks --disable-tests
268+
104 - name: Build and test
269 - name: Build and test
105 run: |
270 run: |
106− ./stack test --fast --test-arguments=--hide-successes
271+ v2=$([ "${{ matrix.versions.cabal }}" = "2.2" ] && printf 'new' || printf 'v2')
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/commit-validation.ymlnew file+38
@@ -0,0 +1,38 @@
1+name: commit-validation
2+on: [ push, pull_request ]
3+
4+jobs:
5+ check-commit-msg-length:
6+ runs-on: ubuntu-latest
7+ steps:
8+ - uses: actions/checkout@v1
9+ - name: Check commit message length
10+ run: |
11+ # Get last commit messages
12+ if [ "${{github.event_name}}" = "push" ]; then
13+ if [ "${{github.event.before}}" = "0000000000000000000000000000000000000000" ]; then
14+ # We are on a new branch
15+ current="$(echo '${{github.ref}}' | sed 's!^refs/heads!origin!')"
16+ readarray -t other < <(git show-ref | awk -F' ' '{ sub(/^refs\/remotes\//,"",$NF); }($NF != "'"$current"'"){print "^" $NF;}')
17+ LOG_RANGE=( "$current" "${other[@]}" )
18+ unset current other
19+ else
20+ # We are on existing branch
21+ LOG_RANGE=( "${{github.event.before}}.." )
22+ fi
23+ elif [ "${{github.event_name}}" = "pull_request" ]; then
24+ LOG_RANGE=( "origin/${{github.base_ref}}.." )
25+ fi
26+ if [[ -v LOG_RANGE ]]; then
27+ if git log --no-merges --pretty=format:"%s" "${LOG_RANGE[@]}" -- | grep -qE "^[^#].{78}"; then
28+ echo -e "Last commit log contains a line with more than 78 characters:\n"
29+ git log --no-merges --pretty=format:"%h: %s" "${LOG_RANGE[@]}" -- | grep -E "^[^:]+: [^#].{78}"
30+ echo
31+ exit 1
32+ else
33+ echo "Commit log looks good."
34+ fi
35+ unset LOG_RANGE
36+ else
37+ echo "Not checking commits on ${{github.event_name}}"
38+ fi
.github/workflows/format-validation.ymlnew file+88
@@ -0,0 +1,88 @@
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.ymlnew file+33
@@ -0,0 +1,33 @@
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+22−31
@@ -2,36 +2,36 @@ name: Nightly
2
2
3on:
3on:
4 schedule:
4 schedule:
5− - cron: '53 6 * * *'
5+ - cron: '53 7 * * *'
6
6
7jobs:
7jobs:
8 linux:
8 linux:
9
9
10− runs-on: ubuntu-latest
10+ runs-on: ubuntu-18.04
11 steps:
11 steps:
12− - uses: actions/checkout@v1
12+ - uses: actions/checkout@v2
13+
13 - name: Install recent cabal/ghc
14 - name: Install recent cabal/ghc
14− run: |
15+ uses: haskell/actions/setup@v1
15− sudo add-apt-repository ppa:hvr/ghc
16+ with:
16− sudo apt-get update
17+ ghc-version: '8.10.3'
17− sudo apt-get install ghc-8.6.5 cabal-install-2.4
18+ cabal-version: '3.2'
19+
18 - name: Install dependencies
20 - name: Install dependencies
19 run: |
21 run: |
20− export PATH=/opt/cabal/bin:/opt/ghc/bin:$PATH
22+ ghc --version
23+ cabal --version
21 cabal v2-update
24 cabal v2-update
22− cabal v2-build --dependencies-only . pandoc-citeproc
25+ cabal v2-build --dependencies-only
23 - name: Build
26 - name: Build
24 run: |
27 run: |
25− export PATH=/opt/cabal/bin:/opt/ghc/bin:$PATH
26− cabal v2-install . pandoc-citeproc
28+ cabal v2-install
27 strip $HOME/.cabal/bin/pandoc
29 strip $HOME/.cabal/bin/pandoc
28− strip $HOME/.cabal/bin/pandoc-citeproc
29 - name: Install artifact
30 - name: Install artifact
30 run: |
31 run: |
31 export ARTIFACTS=nightly-linux/pandoc-nightly-linux-$(date +%Y-%m-%d)
32 export ARTIFACTS=nightly-linux/pandoc-nightly-linux-$(date +%Y-%m-%d)
32 mkdir -p ${ARTIFACTS}
33 mkdir -p ${ARTIFACTS}
33 cp $HOME/.cabal/bin/pandoc ${ARTIFACTS}/
34 cp $HOME/.cabal/bin/pandoc ${ARTIFACTS}/
34− cp $HOME/.cabal/bin/pandoc-citeproc ${ARTIFACTS}/
35 cp COPYRIGHT ${ARTIFACTS}/
35 cp COPYRIGHT ${ARTIFACTS}/
36 echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
36 echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
37 - uses: actions/upload-artifact@master
37 - uses: actions/upload-artifact@master
@@ -41,25 +41,21 @@ jobs:
41
41
42 windows:
42 windows:
43
43
44− runs-on: windows-latest
44+ runs-on: windows-2019
45
45
46 steps:
46 steps:
47− - uses: actions/checkout@v1
47+ - uses: actions/checkout@v2
48− - name: Install stack
49− shell: cmd
50− run: |
51− choco install haskell-stack
52 - name: Install dependencies
48 - name: Install dependencies
53 run: |
49 run: |
54 stack update
50 stack update
55− stack build --dependencies-only pandoc pandoc-citeproc
51+ stack build --dependencies-only pandoc
56 - name: Build artifacts
52 - name: Build artifacts
57 shell: cmd
53 shell: cmd
58 run: |
54 run: |
59 for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
55 for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
60 set ARTIFACTS=%CD%\nightly-windows\pandoc-nightly-windows-%THEDATE%
56 set ARTIFACTS=%CD%\nightly-windows\pandoc-nightly-windows-%THEDATE%
61 mkdir %ARTIFACTS%
57 mkdir %ARTIFACTS%
62− stack build pandoc pandoc-citeproc
58+ stack build pandoc
63 forfiles /P .\.stack-work\install /M pandoc*.exe /S /C "cmd /C copy @path %%ARTIFACTS%%"
59 forfiles /P .\.stack-work\install /M pandoc*.exe /S /C "cmd /C copy @path %%ARTIFACTS%%"
64 copy COPYRIGHT %ARTIFACTS%
60 copy COPYRIGHT %ARTIFACTS%
65 ren %ARTIFACTS%\COPYRIGHT COPYRIGHT.txt
61 ren %ARTIFACTS%\COPYRIGHT COPYRIGHT.txt
@@ -71,26 +67,21 @@ jobs:
71
67
72 macos:
68 macos:
73
69
74− runs-on: macOS-latest
70+ runs-on: macOS-10.15
75
71
76 steps:
72 steps:
77− - uses: actions/checkout@v1
73+ - uses: actions/checkout@v2
78− - name: Install stack
79− run: |
80− curl -L https://get.haskellstack.org/stable/osx-x86_64.tar.gz -o stack.tar.gz
81− tar xzvf stack.tar.gz --strip-components=1 'stack*/stack'
82 - name: Install dependencies
74 - name: Install dependencies
83 run: |
75 run: |
84− ./stack update
76+ stack update
85− ./stack build --dependencies-only pandoc pandoc-citeproc
77+ stack build --dependencies-only pandoc
86 - name: Build artifacts
78 - name: Build artifacts
87 run: |
79 run: |
88 export ARTIFACTS=nightly-macos/pandoc-nightly-macos-$(date +%Y-%m-%d)
80 export ARTIFACTS=nightly-macos/pandoc-nightly-macos-$(date +%Y-%m-%d)
89 mkdir -p ${ARTIFACTS}
81 mkdir -p ${ARTIFACTS}
90− ./stack build pandoc pandoc-citeproc
82+ stack build pandoc
91 for f in $(find .stack-work/install -name 'pandoc*' -perm +001 -type f); do cp $f ${ARTIFACTS}/; done
83 for f in $(find .stack-work/install -name 'pandoc*' -perm +001 -type f); do cp $f ${ARTIFACTS}/; done
92 mv ${ARTIFACTS}/pandoc ${ARTIFACTS}/pandoc
84 mv ${ARTIFACTS}/pandoc ${ARTIFACTS}/pandoc
93− mv ${ARTIFACTS}/pandoc-citeproc ${ARTIFACTS}/pandoc-citeproc
94 cp COPYRIGHT ${ARTIFACTS}/
85 cp COPYRIGHT ${ARTIFACTS}/
95 echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
86 echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
96 - uses: actions/upload-artifact@master
87 - uses: actions/upload-artifact@master
.github/workflows/release-candidate.yml+17−80
@@ -8,7 +8,7 @@ on:
8jobs:
8jobs:
9 linux:
9 linux:
10
10
11− runs-on: ubuntu-latest
11+ runs-on: ubuntu-18.04
12 steps:
12 steps:
13 - uses: actions/checkout@v1
13 - uses: actions/checkout@v1
14 - name: Create linux package
14 - name: Create linux package
@@ -17,48 +17,32 @@ 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@master
20+ - uses: actions/upload-artifact@v2
21 with:
21 with:
22 name: linux-release-candidate
22 name: linux-release-candidate
23 path: linux-release-candidate
23 path: linux-release-candidate
24
24
25 windows:
25 windows:
26
26
27− runs-on: windows-latest
27+ runs-on: windows-2019
28 strategy:
28 strategy:
29 fail-fast: true
29 fail-fast: true
30 matrix:
30 matrix:
31 versions:
31 versions:
32 - osarch: "windows-x86_64"
32 - osarch: "windows-x86_64"
33 arch: "x64"
33 arch: "x64"
34− choco_opts: ""
35 stack_opts: "-j1"
34 stack_opts: "-j1"
36− - osarch: "windows-i386"
37− arch: "x86"
38− choco_opts: "--x86"
39− stack_opts: "-j1 --flag hslua:lua_32bits"
40−
41 steps:
35 steps:
42 - uses: actions/checkout@v1
36 - uses: actions/checkout@v1
43− - name: Install stack
44− shell: cmd
45− run: |
46− choco install haskell-stack ${{ matrix.versions.choco_opts }}
47 - name: Install dependencies
37 - name: Install dependencies
48 run: |
38 run: |
49 stack update
39 stack update
50− stack build ${{ matrix.versions.stack_opts }} --dependencies-only pandoc pandoc-citeproc
40+ stack build ${{ matrix.versions.stack_opts }} --dependencies-only pandoc
51 - name: Create windows package
41 - name: Create windows package
52 shell: cmd
42 shell: cmd
53 run: |
43 run: |
54 for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
44 for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
55− stack build ${{ matrix.versions.stack_opts }}pandoc pandoc-citeproc
45+ stack build ${{ matrix.versions.stack_opts }} pandoc
56− @set WINDOWS=%CD%\windows
57− forfiles /P .\.stack-work\install /M pandoc*.exe /S /C "cmd /C echo @path && echo %%WINDOWS%% && copy @path %%WINDOWS%%"
58− stack exec pandoc -- -s --toc MANUAL.txt -o windows\MANUAL.html
59− stack exec pandoc -- -s COPYING.md -t rtf -o windows\COPYING.rtf
60− copy COPYRIGHT windows\COPYRIGHT.txt
61− cd windows
62 for /f "tokens=1-2 delims= " %%a in ('stack exec pandoc -- --version') do (
46 for /f "tokens=1-2 delims= " %%a in ('stack exec pandoc -- --version') do (
63 @set VERSION=%%b
47 @set VERSION=%%b
64 goto :next
48 goto :next
@@ -69,78 +53,31 @@ jobs:
69 exit /b 1
53 exit /b 1
70 )
54 )
71 echo Detected version %VERSION%
55 echo Detected version %VERSION%
56+ @set WINDOWS=%CD%\windows
57+ @set RELEASE=%WINDOWS%\pandoc-%VERSION%
58+ mkdir %RELEASE%
59+ 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
61+ stack exec pandoc -- -s COPYING.md -t rtf -o %RELEASE%\COPYING.rtf
62+ copy %RELEASE%\COPYING.rtf %WINDOWS%
63+ copy COPYRIGHT %RELEASE%\COPYRIGHT.txt
64+ cd windows
72 echo Creating msi...
65 echo Creating msi...
73 dir
66 dir
74 @set WIXBIN="c:\Program Files (x86)\WiX Toolset v3.11\bin"
67 @set WIXBIN="c:\Program Files (x86)\WiX Toolset v3.11\bin"
75 @set WORKDIR=%CD%
68 @set WORKDIR=%CD%
76 echo Running candle...
69 echo Running candle...
77− %WIXBIN%\candle -arch ${{ matrix.versions.arch }} -dVERSION=%VERSION% -dBINPATH=%WORKDIR% *.wxs -out wixobj\
70+ %WIXBIN%\candle -arch ${{ matrix.versions.arch }} -dVERSION=%VERSION% -dBINPATH=%RELEASE% *.wxs -out wixobj\
78 if %errorlevel% neq 0 exit /b %errorlevel%
71 if %errorlevel% neq 0 exit /b %errorlevel%
79 echo Running light...
72 echo Running light...
80 %WIXBIN%\light -sw1076 -ext WixUIExtension -ext WixUtilExtension -cultures:en-us -loc Pandoc-en-us.wxl -out %WORKDIR%\pandoc-%VERSION%-${{ matrix.versions.osarch }}-UNSIGNED.msi wixobj\*.wixobj
73 %WIXBIN%\light -sw1076 -ext WixUIExtension -ext WixUtilExtension -cultures:en-us -loc Pandoc-en-us.wxl -out %WORKDIR%\pandoc-%VERSION%-${{ matrix.versions.osarch }}-UNSIGNED.msi wixobj\*.wixobj
81− 7z a "pandoc-%VERSION%-${{ matrix.versions.osarch }}.zip" pandoc.exe pandoc-citeproc.exe MANUAL.html COPYING.rtf
74+ 7z a "pandoc-%VERSION%-${{ matrix.versions.osarch }}.zip" pandoc-%VERSION%
82 cd ..
75 cd ..
83 mkdir windows-release-candidate
76 mkdir windows-release-candidate
84 copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}-UNSIGNED.msi windows-release-candidate
77 copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}-UNSIGNED.msi windows-release-candidate
85 copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}.zip windows-release-candidate
78 copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}.zip windows-release-candidate
86 copy windows\Makefile windows-release-candidate
79 copy windows\Makefile windows-release-candidate
87− - uses: actions/upload-artifact@master
80+ - uses: actions/upload-artifact@v2
88 with:
81 with:
89 name: windows-release-candidate
82 name: windows-release-candidate
90 path: windows-release-candidate
83 path: windows-release-candidate
91−
92− macos:
93−
94− runs-on: macOS-latest
95−
96− steps:
97− - uses: actions/checkout@v1
98− - name: Install stack
99− run: |
100− curl -L https://get.haskellstack.org/stable/osx-x86_64.tar.gz -o stack.tar.gz
101− tar xzvf stack.tar.gz --strip-components=1 'stack*/stack'
102− - name: Install dependencies
103− run: |
104− ./stack update
105− ./stack build --dependencies-only pandoc pandoc-citeproc
106− - name: Create macOS package
107− run: |
108− export VERSION=$(grep '^[Vv]ersion:' pandoc.cabal | awk '{print $$2;}')
109− export BASEDIR=$(pwd)
110− export ARTIFACTS=${BASEDIR}/macos-release-candidate
111− export DIST=${BASEDIR}/macos_package
112− export RESOURCES=${ARTIFACTS}/Resources
113− export ROOT=${DIST}/pandoc
114− export DEST=${ROOT}/usr/local
115− export ME=$(whoami)
116− export BASE=pandoc-$VERSION
117− mkdir -p ${ARTIFACTS}
118− mkdir -p ${DIST}
119− mkdir -p ${RESOURCES}
120− mkdir -p ${DEST}/bin
121− mkdir -p ${DEST}/share/man/man1
122− ./stack build pandoc pandoc-citeproc
123− for f in $(find .stack-work/install -name 'pandoc*' -perm +001 -type f); do cp $f ${DEST}/bin/; done
124− strip ${DEST}/bin/pandoc
125− strip ${DEST}/bin/pandoc-citeproc
126− cp man/pandoc.1 ${DEST}/share/man/man1/pandoc.1
127− ${DEST}/bin/pandoc-citeproc --man > \
128− $DEST/share/man/man1/pandoc-citeproc.1
129− ${DEST}/bin/pandoc -t html5 -s COPYING.md -Vpagetitle=License \
130− -o ${RESOURCES}/license.html
131− sed -e "s/PANDOCVERSION/${VERSION}/" macos/distribution.xml.in > ${ARTIFACTS}/distribution.xml
132−
133− chown -R $ME:staff ${DIST}
134− echo Creating pkg...
135− pkgbuild --root $ROOT --identifier net.johnmacfarlane.pandoc --version $VERSION --ownership recommended ${ARTIFACTS}/pandoc.pkg
136− echo Creating zip...
137− cd ${DEST}
138− cd ..
139− mv local ${BASE}
140− zip -r ${ARTIFACTS}/${BASE}-macOS.zip ${BASE}
141− echo -e "${BASE}-macOS.pkg: pandoc.pkg\n\tproductbuild --distribution distribution.xml --resources Resources --package-path $< --version ${VERSION} --sign 'Developer ID Installer: John Macfarlane' -o \$@\n" > ${ARTIFACTS}/Makefile
142− - uses: actions/upload-artifact@master
143− with:
144− name: macos-release-candidate
145− path: macos-release-candidate
146−
.gitignore+8
@@ -1,4 +1,6 @@
1*~
1*~
2+.DS_Store
3+*.orig
2deb/.vagrant
4deb/.vagrant
3dist/*
5dist/*
4MANUAL.*
6MANUAL.*
@@ -14,6 +16,10 @@ man/man?/*.html
14*.o
16*.o
15*.hi
17*.hi
16*.pyc
18*.pyc
19+.hie/
20+.policeman-evidence/
21+.projectile/
22+.vscode/
17/COPYING.rtf
23/COPYING.rtf
18/COPYRIGHT.txt
24/COPYRIGHT.txt
19/cabal-dev/
25/cabal-dev/
@@ -23,5 +29,7 @@ windows/*.wixobj
23data/reference.docx
29data/reference.docx
24data/reference.odt
30data/reference.odt
25.stack-work
31.stack-work
32+/stack.yaml.lock
26cabal.project.local
33cabal.project.local
27/dist-newstyle/
34/dist-newstyle/
35+pandoc-2*/
.hlint.yaml+94−54
@@ -2,71 +2,111 @@
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−
9# Specify additional command line arguments
5# Specify additional command line arguments
10#
6#
11−- arguments: [--color, --cpp-ansi]
7+- arguments: [--color=auto, --cpp-ansi]
12−
13
8
14−# Control which extensions/flags/modules/functions can be used
9+# Ignore some builtin hints
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#
10#
28−# - functions:
11+- ignore: {name: "Avoid lambda"}
29−# - {name: unsafePerformIO, within: []} # unsafePerformIO can only appear in no modules
12+- ignore: {name: "Use bimap"}
13+- ignore: {name: "Eta reduce"}
14+- ignore: {name: "Evaluate"}
15+- ignore: {name: "Reduce duplication"} # TODO: could be more fine-grained
16+- ignore: {name: "Use &&&"}
17+- ignore: {name: "Use String"}
18+- ignore: {name: "Use camelCase"}
19+- ignore: {name: "Use fmap"} # specific for GHC 7.8 compat
20+- ignore: {name: "Use isDigit"}
30
21
22+- ignore:
23+ name: "Monad law, left identity"
24+ within: Text.Pandoc.App.OutputSettings
31
25
32−# Add custom hints for this project
26+- ignore:
33−#
27+ name: "Move brackets to avoid $"
34−# Will suggest replacing "wibbleMany [myvar]" with "wibbleOne myvar"
28+ within: Text.Pandoc.Writers.CslJson
35−# - error: {lhs: "wibbleMany [x]", rhs: wibbleOne x}
36
29
30+- ignore:
31+ name: "Redundant <$>"
32+ within:
33+ - Text.Pandoc.Readers.Docx.Parse
34+ - Text.Pandoc.Writers.MediaWiki
35+ - Text.Pandoc.Writers.OpenDocument
36+ - Text.Pandoc.Writers.Powerpoint.Output
37+ - Text.Pandoc.Writers.Powerpoint.Presentation
37
38
38−# Turn on hints that are off by default
39+- ignore:
39−#
40+ name: "Redundant return"
40−# Ban "module X(module X) where", to require a real export list
41+ within: Text.Pandoc.Citeproc.BibTeX
41−# - warn: {name: Use explicit module export list}
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
42
43+# With recent hlint this rule has given false positives on TH
44+- ignore:
45+ name: "Redundant bracket"
49
46
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"}
57−- ignore: {name: "Avoid lambda"}
58−- ignore: {name: "Use String"}
59−- ignore: {name: "Use isDigit"}
60−- ignore: {name: "Eta reduce"}
61−- ignore: {name: "Use fmap"} # specific for GHC 7.8 compat
62−- ignore: {name: "Parse error"} # we trust the compiler over HLint
63−- ignore: {name: "Use =="} # Creates infinite loops in `EQ` using expressions
64−- ignore: {name: "Evaluate"}
65−- ignore: {name: "Use &&&"}
66−# - ignore: {name: "Redundant compare"}
67
47
68−# Define some custom infix operators
48+- ignore:
69−# - fixity: infixr 3 ~^#^~
49+ name: "Use <$>"
50+ within:
51+ - Text.Pandoc.Readers.LaTeX
52+ - Text.Pandoc.Readers.Markdown
70
53
54+- ignore:
55+ name: "Use camelCase"
56+ within:
57+ - Tests.Writers.Docbook
58+ - Tests.Writers.Native
59+ - Text.Pandoc.Citeproc
60+ - Text.Pandoc.Extensions
61+ - Text.Pandoc.Lua.Marshaling.Version
62+ - Text.Pandoc.Lua.Module.Pandoc
63+ - Text.Pandoc.Lua.Module.Utils
64+ - Text.Pandoc.Readers.Odt.ContentReader
65+ - Text.Pandoc.Readers.Odt.Namespaces
71
66
67+- ignore:
68+ name: "Use forM_"
69+ within:
70+ - Text.Pandoc.Readers.DocBook
72
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
112+# - fixity: infixr 3 ~^#^~
AUTHORS.md+62
@@ -1,11 +1,13 @@
1# Contributors
1# Contributors
2
2
3- Anabra
3- Anabra
4+- Aner Lucero
4- Arata Mizuki
5- Arata Mizuki
5- Arfon Smith
6- Arfon Smith
6- Aaron Wolen
7- Aaron Wolen
7- Albert Krewinkel
8- Albert Krewinkel
8- Alex Ivkin
9- Alex Ivkin
10+- Alex Toldaiev
9- Alex Vong
11- Alex Vong
10- Alexander Kondratskiy
12- Alexander Kondratskiy
11- Alexander Krotov
13- Alexander Krotov
@@ -17,6 +19,8 @@
17- Anders Waldenborg
19- Anders Waldenborg
18- Andreas Lööw
20- Andreas Lööw
19- Andrew Dunning
21- Andrew Dunning
22+- Andy Morris
23+- Anti-Distinctlyminty
20- Antoine Latter
24- Antoine Latter
21- Antonio Terceiro
25- Antonio Terceiro
22- Arata Mizuki
26- Arata Mizuki
@@ -31,13 +35,19 @@
31- Beni Cherniavsky-Paskin
35- Beni Cherniavsky-Paskin
32- Benoit Schweblin
36- Benoit Schweblin
33- Bjorn Buckwalter
37- Bjorn Buckwalter
38+- Blake Eryx
39+- Bodigrim
34- Bradley Kuhn
40- Bradley Kuhn
35- Brent Yorgey
41- Brent Yorgey
36- Brian Leung
42- Brian Leung
37- Bryan O'Sullivan
43- Bryan O'Sullivan
38- Caleb McDaniel
44- Caleb McDaniel
45+- Caleb Mclennan
39- Calvin Beck
46- Calvin Beck
40- Carlos Sosa
47- Carlos Sosa
48+- Cécile Chemin
49+- Cédric Couralet
50+- Charanjit Singh
41- Chris Black
51- Chris Black
42- Christian Conkle
52- Christian Conkle
43- Christian Despres
53- Christian Despres
@@ -55,24 +65,33 @@
55- Daniele D'Orazio
65- Daniele D'Orazio
56- David A Roberts
66- David A Roberts
57- David Lazar
67- David Lazar
68+- David Martschenko
58- David Röthlisberger
69- David Röthlisberger
59- Denis Laxalde
70- Denis Laxalde
60- Denis Maier
71- Denis Maier
61- Derek Chen-Becker
72- Derek Chen-Becker
73+- Diego Balseiro
74+- Dimitri Sabadie
62- Dmitry Pogodin
75- Dmitry Pogodin
76+- Dmitry Volodin
63- Douglas Calvert
77- Douglas Calvert
64- Eigil Rischel
78- Eigil Rischel
65- Emanuel Evans
79- Emanuel Evans
80+- Emerson Harkin
81+- Emily Bourke
66- Emily Eisenberg
82- Emily Eisenberg
67- Eric Kow
83- Eric Kow
84+- Erik Rask
68- Eric Seidel
85- Eric Seidel
69- Eric Schrijver
86- Eric Schrijver
87+- Ethan Riley
70- Étienne Bersac
88- Étienne Bersac
71- Felix Yan
89- Felix Yan
72- Félix Baylac-Jacqué
90- Félix Baylac-Jacqué
73- Florian Beeres
91- Florian Beeres
74- Florian Eitel
92- Florian Eitel
75- Florian Klink
93- Florian Klink
94+- Florian Kohrt
76- Francesco Occhipinti
95- Francesco Occhipinti
77- François Gannaz
96- François Gannaz
78- Frederik Elwert
97- Frederik Elwert
@@ -89,11 +108,13 @@
89- Gwern Branwen
108- Gwern Branwen
90- Hamish Mackenzie
109- Hamish Mackenzie
91- Hans-Peter Deifel
110- Hans-Peter Deifel
111+- Heiko Schlittermann
92- Henrik Tramberend
112- Henrik Tramberend
93- Henry de Valence
113- Henry de Valence
94- Hubert Plociniczak
114- Hubert Plociniczak
95- Ian Max Andolina
115- Ian Max Andolina
96- Igor Khorlo
116- Igor Khorlo
117+- Igor Pashev
97- Ilya V. Portnov
118- Ilya V. Portnov
98- Ivan Trubach
119- Ivan Trubach
99- Ivo Clarysse
120- Ivo Clarysse
@@ -101,11 +122,13 @@
101- J. B. Rainsberger
122- J. B. Rainsberger
102- J. Lewis Muir
123- J. Lewis Muir
103- Jaime Marquínez Ferrándiz
124- Jaime Marquínez Ferrándiz
125+- Jake Zimmerman
104- Jakob Voß
126- Jakob Voß
105- James Aspnes
127- James Aspnes
106- Jamie F. Olson
128- Jamie F. Olson
107- Jan Larres
129- Jan Larres
108- Jan Schulz
130- Jan Schulz
131+- Jan Tojnar
109- Jan-Otto Kröpke
132- Jan-Otto Kröpke
110- Jason Ronallo
133- Jason Ronallo
111- Jeff Arnold
134- Jeff Arnold
@@ -113,6 +136,7 @@
113- Jens Getreu
136- Jens Getreu
114- Jens Petersen
137- Jens Petersen
115- Jeroen de Haas
138- Jeroen de Haas
139+- Jerry Sky
116- Jesse Rosenthal
140- Jesse Rosenthal
117- Joe Hermaszewski
141- Joe Hermaszewski
118- Joe Hillenbrand
142- Joe Hillenbrand
@@ -126,7 +150,10 @@
126- Jose Luis Duran
150- Jose Luis Duran
127- José de Mattos Neto
151- José de Mattos Neto
128- Josef Svenningsson
152- Josef Svenningsson
153+- Joseph C. Sible
129- Julien Cretel
154- Julien Cretel
155+- Julien Dutant
156+- Juliette Fourcot
130- Juliusz Gonera
157- Juliusz Gonera
131- Justin Bogner
158- Justin Bogner
132- Jérémy Bobbio
159- Jérémy Bobbio
@@ -139,7 +166,13 @@
139- Krystof Beuermann
166- Krystof Beuermann
140- Herwig Stuetz
167- Herwig Stuetz
141- Lars-Dominik Braun
168- Lars-Dominik Braun
169+- Laurent P. René de Cotret
142- Leif Metcalf
170- Leif Metcalf
171+- Leonard Rosenthol
172+- Lila
173+- Loïc Grobol
174+- Lorenzo
175+- Lucas Escot
143- Luke Plant
176- Luke Plant
144- Marc Schreiber
177- Marc Schreiber
145- Mark Szepieniec
178- Mark Szepieniec
@@ -149,6 +182,7 @@
149- Matej Kollar
182- Matej Kollar
150- Mathias Schenner
183- Mathias Schenner
151- Mathias Walter
184- Mathias Walter
185+- Mathieu Boespflug
152- Mathieu Duponchelle
186- Mathieu Duponchelle
153- Matthew Doty
187- Matthew Doty
154- Matthew Eddey
188- Matthew Eddey
@@ -160,18 +194,23 @@
160- Merijn Verstraaten
194- Merijn Verstraaten
161- Michael Beaumont
195- Michael Beaumont
162- Michael Chladek
196- Michael Chladek
197+- Michael Hoffmann
163- Michael Peyton Jones
198- Michael Peyton Jones
199+- Michael Reed
164- Michael Snoyman
200- Michael Snoyman
165- Michael Thompson
201- Michael Thompson
202+- Mike Tzou
166- MinRK
203- MinRK
167- Morton Fox
204- Morton Fox
168- Nathan Gass
205- Nathan Gass
169- Neil Mayhew
206- Neil Mayhew
170- Nick Bart
207- Nick Bart
208+- Nick Berendsen
171- Nick Fleisher
209- Nick Fleisher
172- Nicolas Kaiser
210- Nicolas Kaiser
173- Nikolay Yakimov
211- Nikolay Yakimov
174- Nils Carlson
212- Nils Carlson
213+- Nixon Enraght-Moony
175- Nokome Bentley
214- Nokome Bentley
176- Ole Martin Ruud
215- Ole Martin Ruud
177- Oliver Matthews
216- Oliver Matthews
@@ -196,7 +235,9 @@
196- Raymond Ehlers
235- Raymond Ehlers
197- Recai Oktaş
236- Recai Oktaş
198- Roland Hieber
237- Roland Hieber
238+- Roman Beránek
199- RyanGlScott
239- RyanGlScott
240+- Salim B
200- Sascha Wilde
241- Sascha Wilde
201- Scott Morrison
242- Scott Morrison
202- Sebastian Talmon
243- Sebastian Talmon
@@ -205,12 +246,14 @@
205- Shahbaz Youssefi
246- Shahbaz Youssefi
206- Shaun Attfield
247- Shaun Attfield
207- Shim Myeongseob
248- Shim Myeongseob
249+- Shin Sang-jae
208- Sidarth Kapur
250- Sidarth Kapur
209- Sidharth Kapur
251- Sidharth Kapur
210- Simon Hengel
252- Simon Hengel
211- Stefan Dresselhaus
253- Stefan Dresselhaus
212- Sumit Sahrawat
254- Sumit Sahrawat
213- Tarik Graba
255- Tarik Graba
256+- Tatiana Porras
214- Thenaesh Elango
257- Thenaesh Elango
215- Thomas Hodgson
258- Thomas Hodgson
216- Thomas Weißschuh
259- Thomas Weißschuh
@@ -220,15 +263,18 @@
220- Tiziano Müller
263- Tiziano Müller
221- Todd Sifleet
264- Todd Sifleet
222- Tom Leese
265- Tom Leese
266+- Tristan de Cacqueray
223- Tristan Stenner
267- Tristan Stenner
224- Uli Köhler
268- Uli Köhler
225- Urs Liska
269- Urs Liska
226- Václav Zeman
270- Václav Zeman
227- Václav Haisman
271- Václav Haisman
272+- Vaibhav Sagar
228- Vanessa McHale
273- Vanessa McHale
229- Vasily Alferov
274- Vasily Alferov
230- Viktor Kronvall
275- Viktor Kronvall
231- Vincent
276- Vincent
277+- Vlad Hanciuta
232- Wandmalfarbe
278- Wandmalfarbe
233- Waldir Pimenta
279- Waldir Pimenta
234- Wikiwide
280- Wikiwide
@@ -238,20 +284,30 @@
238- Yoan Blanc
284- Yoan Blanc
239- Yuchen Pei
285- Yuchen Pei
240- Zihang Chen
286- Zihang Chen
287+- a-vrma
288+- andrebauer
289+- argent0
290+- badumont
241- blmage
291- blmage
242- bucklereed
292- bucklereed
243- bumper314
293- bumper314
244- chinapedia
294- chinapedia
295+- cholonam
245- csforste
296- csforste
297+- dbecher-ito
246- d-dorazio
298- d-dorazio
247- ebiim
299- ebiim
300+- favonia
248- infinity0x
301- infinity0x
249- jeongminkim-islab
302- jeongminkim-islab
250- kaizshang91
303- kaizshang91
251- lux-lth
304- lux-lth
252- lwolfsonkin
305- lwolfsonkin
306+- mbrackeantidot
253- nkalvi
307- nkalvi
254- niszet
308- niszet
309+- nuew
310+- obcat
255- oltolm
311- oltolm
256- oquechy
312- oquechy
257- quasicomputational
313- quasicomputational
@@ -262,7 +318,13 @@
262- rski
318- rski
263- shreevatsa.public
319- shreevatsa.public
264- takahashim
320- takahashim
321+- taotieren
322+- tecosaur
323+- TEC
265- tgkokk
324- tgkokk
325+- the-solipsist
326+- timo-a
266- thsutton
327- thsutton
267- vijayphoenix
328- vijayphoenix
268- wiefling
329- wiefling
330+- wuffi
CONTRIBUTING.md+134−30
@@ -1,6 +1,64 @@
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+
4Have a question?
62Have a question?
5----------------
63----------------
6
64
@@ -10,15 +68,21 @@ Ask on [pandoc-discuss].
10Found a bug?
68Found a bug?
11------------
69------------
12
70
13−Bug reports are welcome! Please report all bugs on pandoc's github
71+Bug reports are welcome! Please report all bugs on pandoc's GitHub
14[issue tracker].
72[issue tracker].
15
73
16Before you submit a bug report, search the [open issues] *and* [closed issues]
74Before you submit a bug report, search the [open issues] *and* [closed issues]
17to make sure the issue hasn't come up before. Also, check the [User's Guide] and
75to make sure the issue hasn't come up before. Also, check the [User's Guide] and
18[FAQs] for anything relevant.
76[FAQs] for anything relevant.
19
77
20−Make sure you can reproduce the bug with the [latest released version] of pandoc
78+Make sure you can reproduce the bug with the [latest released
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
21−(or, even better, the [development version]).
82+from source to test against 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.)
22
86
23Your report should give detailed, *reproducible* instructions, including
87Your report should give detailed, *reproducible* instructions, including
24
88
@@ -99,7 +163,12 @@ Explain the rationale for the feature you're requesting. Why would this
99feature be useful? Consider also any possible drawbacks, including backwards
163feature be useful? Consider also any possible drawbacks, including backwards
100compatibility, new library dependencies, and performance issues.
164compatibility, new library dependencies, and performance issues.
101
165
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+
102−It is best to discuss a potential new feature on [pandoc-discuss]
171+Any potential new feature is best discussed on [pandoc-discuss]
103before opening an issue.
172before opening an issue.
104
173
105Patches and pull requests
174Patches and pull requests
@@ -146,7 +215,7 @@ Please follow these guidelines:
146
215
14710. We aim for compatibility with ghc versions from 8.0 to the
21610. We aim for compatibility with ghc versions from 8.0 to the
148 latest release. All pull requests and commits are tested
217 latest release. All pull requests and commits are tested
149− automatically on CircleCI.
218+ automatically on GitHub Actions.
150
219
151Tests
220Tests
152-----
221-----
@@ -175,9 +244,16 @@ Or with stack:
175
244
176 stack test --test-arguments='-p markdown'
245 stack test --test-arguments='-p markdown'
177
246
178−It is often helpful to add `-j4` (run tests in parallel)
247+It is often helpful to add `-j4` (run tests in parallel) and
179−and `--hide-successes` (don't clutter output with successes)
248+`--hide-successes` (don't clutter output with successes) to the test
180−to the test arguments as well.
249+arguments as well. Collecting all options in a `cabal.project.local`
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
181
257
182If you add a new feature to pandoc, please add tests as well, following
258If you add a new feature to pandoc, please add tests as well, following
183the pattern of the existing tests. The test suite code is in
259the pattern of the existing tests. The test suite code is in
@@ -200,6 +276,35 @@ or Powerpoint to ensure that they weren't corrupted and that
200they had the expected result, and mention the Word/Powerpoint
276they had the expected result, and mention the Word/Powerpoint
201version and OS in your commit comment.
277version and OS in your commit comment.
202
278
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+
203Benchmarks
308Benchmarks
204----------
309----------
205
310
@@ -213,9 +318,6 @@ With stack:
213
318
214 stack bench
319 stack bench
215
320
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.)
219
321
220Using the REPL
322Using the REPL
221--------------
323--------------
@@ -227,10 +329,10 @@ a ghci REPL for working with pandoc. With [stack], use
227We recommend using the following `.ghci` file (which can be
329We recommend using the following `.ghci` file (which can be
228placed in the source directory):
330placed in the source directory):
229
331
230− :set -fobject-code
332+ :set -fobject-code
231− :set -XTypeSynonymInstances
333+ :set -XTypeSynonymInstances
232− :set -XScopedTypeVariables
334+ :set -XScopedTypeVariables
233− :set -XOverloadedStrings
335+ :set -XOverloadedStrings
234
336
235Profiling
337Profiling
236---------
338---------
@@ -274,7 +376,7 @@ The code
274--------
376--------
275
377
276Pandoc has a publicly accessible git repository on
378Pandoc has a publicly accessible git repository on
277−github: <http://github.com/jgm/pandoc>. To get a local copy of the source:
379+GitHub: <https://github.com/jgm/pandoc>. To get a local copy of the source:
278
380
279 git clone https://github.com/jgm/pandoc.git
381 git clone https://github.com/jgm/pandoc.git
280
382
@@ -284,7 +386,7 @@ the pandoc library is in `src/`, the source for the tests is in
284
386
285The modules `Text.Pandoc.Definition`, `Text.Pandoc.Builder`, and
387The modules `Text.Pandoc.Definition`, `Text.Pandoc.Builder`, and
286`Text.Pandoc.Generic` are in a separate library `pandoc-types`. The code can
388`Text.Pandoc.Generic` are in a separate library `pandoc-types`. The code can
287−be found in <http://github.com/jgm/pandoc-types>.
389+be found in <https://github.com/jgm/pandoc-types>.
288
390
289To build pandoc, you will need a working installation of the
391To build pandoc, you will need a working installation of the
290[Haskell platform].
392[Haskell platform].
@@ -304,11 +406,11 @@ The library is structured as follows:
304 tree automatically.
406 tree automatically.
305 - `Text.Pandoc.Readers.*` are the readers, and `Text.Pandoc.Writers.*`
407 - `Text.Pandoc.Readers.*` are the readers, and `Text.Pandoc.Writers.*`
306 are the writers.
408 are the writers.
307− - `Text.Pandoc.Biblio` is a utility module for formatting citations
409+ - `Text.Pandoc.Citeproc.*` contain the code for citation handling,
308− using citeproc-hs.
410+ including an interface to the [citeproc] library.
309 - `Text.Pandoc.Data` is used to embed data files when the `embed_data_files`
411 - `Text.Pandoc.Data` is used to embed data files when the `embed_data_files`
310− cabal flag is used. It is generated from `src/Text/Pandoc/Data.hsb` using
412+ cabal flag is used.
311− the preprocessor [hsb2hs].
413+ - `Text.Pandoc.Emoji` is a thin wrapper around [emojis].
312 - `Text.Pandoc.Highlighting` contains the interface to the
414 - `Text.Pandoc.Highlighting` contains the interface to the
313 skylighting library, which is used for code syntax highlighting.
415 skylighting library, which is used for code syntax highlighting.
314 - `Text.Pandoc.ImageSize` is a utility module containing functions for
416 - `Text.Pandoc.ImageSize` is a utility module containing functions for
@@ -319,7 +421,6 @@ The library is structured as follows:
319 - `Text.Pandoc.PDF` contains functions for producing a PDF from a
421 - `Text.Pandoc.PDF` contains functions for producing a PDF from a
320 LaTeX source.
422 LaTeX source.
321 - `Text.Pandoc.Parsing` contains parsing functions used in multiple readers.
423 - `Text.Pandoc.Parsing` contains parsing functions used in multiple readers.
322− - `Text.Pandoc.Pretty` is a pretty-printing library specialized to
323 the needs of pandoc.
424 the needs of pandoc.
324 - `Text.Pandoc.SelfContained` contains functions for making an HTML
425 - `Text.Pandoc.SelfContained` contains functions for making an HTML
325 file "self-contained," by importing remotely linked images, CSS,
426 file "self-contained," by importing remotely linked images, CSS,
@@ -346,14 +447,18 @@ you may want to consider submitting a pull request to the
346[open issues]: https://github.com/jgm/pandoc/issues
447[open issues]: https://github.com/jgm/pandoc/issues
347[closed issues]: https://github.com/jgm/pandoc/issues?q=is%3Aissue+is%3Aclosed
448[closed issues]: https://github.com/jgm/pandoc/issues?q=is%3Aissue+is%3Aclosed
348[latest released version]: https://github.com/jgm/pandoc/releases/latest
449[latest released version]: https://github.com/jgm/pandoc/releases/latest
349−[development version]: https://github.com/pandoc-extras/pandoc-nightly/releases/latest
450+[Nightly builds]: https://github.com/jgm/pandoc/actions?query=workflow%3ANightly
350−[pandoc-discuss]: http://groups.google.com/group/pandoc-discuss
451+[pandoc-discuss]: https://groups.google.com/group/pandoc-discuss
351[issue tracker]: https://github.com/jgm/pandoc/issues
452[issue tracker]: https://github.com/jgm/pandoc/issues
352−[User's Guide]: http://pandoc.org/MANUAL.html
453+[User's Guide]: https://pandoc.org/MANUAL.html
353−[FAQs]: http://pandoc.org/faqs.html
454+[FAQs]: https://pandoc.org/faqs.html
354−[EditorConfig]: http://editorconfig.org/
455+[EditorConfig]: https://editorconfig.org/
355−[Haskell platform]: http://www.haskell.org/platform/
456+[Haskell platform]: https://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
356−[hsb2hs]: http://hackage.haskell.org/package/hsb2hs
460+[hsb2hs]: https://hackage.haskell.org/package/hsb2hs
461+[pre-commit hook]: https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks
357[GitHub labels]: https://github.com/jgm/pandoc/labels
462[GitHub labels]: https://github.com/jgm/pandoc/labels
358[good first issue]:https://github.com/jgm/pandoc/labels/good%20first%20issue
463[good first issue]:https://github.com/jgm/pandoc/labels/good%20first%20issue
359[enhancement]: https://github.com/jgm/pandoc/labels/enhancement
464[enhancement]: https://github.com/jgm/pandoc/labels/enhancement
@@ -368,4 +473,3 @@ you may want to consider submitting a pull request to the
368[status:more-discussion-needed]: https://github.com/jgm/pandoc/labels/status:more-discussion-needed
473[status:more-discussion-needed]: https://github.com/jgm/pandoc/labels/status:more-discussion-needed
369[status:more-info-needed]: https://github.com/jgm/pandoc/labels/status:more-info-needed
474[status:more-info-needed]: https://github.com/jgm/pandoc/labels/status:more-info-needed
370[stack]: https://github.com/commercialhaskell/stack
475[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](http://www.gnu.org/licenses/lgpl.html) instead of this
360+License](https://www.gnu.org/licenses/lgpl.html) instead of this
361License.
361License.
COPYRIGHT+34−27
@@ -1,5 +1,5 @@
1Pandoc
1Pandoc
2−Copyright (C) 2006-2019 John MacFarlane <jgm at berkeley dot edu>
2+Copyright (C) 2006-2021 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]: http://www.gnu.org/copyleft/gpl.html
25+[GPL]: https://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]: http://pandoc.org
29+[Pandoc home page]: https://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-2019, John MacFarlane
40+Copyright (c) 2006-2021, John MacFarlane
41
41
42All rights reserved.
42All rights reserved.
43
43
@@ -73,29 +73,29 @@ 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--2019, John MacFarlane
76+Copyright (c) 2014--2021, John MacFarlane
77
77
78----------------------------------------------------------------------
78----------------------------------------------------------------------
79src/Text/Pandoc/Writers/Muse.hs
79src/Text/Pandoc/Writers/Muse.hs
80−Copyright (C) 2017-2019 Alexander Krotov
80+Copyright (C) 2017-2020 Alexander Krotov
81
81
82Released under the GNU General Public License version 2 or later.
82Released 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-2019 John MacFarlane and Peter Wang
86+Copyright (C) 2008-2021 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-2019 Andrea Rossato and John MacFarlane
92+Copyright (C) 2008-2021 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-2019 Puneeth Chaganti, John MacFarlane, and
98+Copyright (C) 2010-2021 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.
@@ -109,13 +109,13 @@ Released under the GNU General Public License version 2 or later.
109----------------------------------------------------------------------
109----------------------------------------------------------------------
110src/Text/Pandoc/Readers/Docx.hs
110src/Text/Pandoc/Readers/Docx.hs
111src/Text/Pandoc/Readers/Docx/*
111src/Text/Pandoc/Readers/Docx/*
112−Copyright (C) 2014-2019 Jesse Rosenthal
112+Copyright (C) 2014-2020 Jesse Rosenthal
113
113
114Released under the GNU General Public License version 2 or later.
114Released 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-2019 Paul Rivier and John MacFarlane
118+Copyright (C) 2010-2021 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-2018 Matthew Pickering
136+Copyright (C) 2014-2021 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,33 +141,49 @@ 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
145+
146+Released under the GNU General Public License version 2 or later.
147+
148+----------------------------------------------------------------------
149+src/Text/Pandoc/Lua.hs
150+src/Text/Pandoc/Lua/*
151+test/lua/*
152+Copyright (C) 2017--2021 Albert Krewinkel and John MacFarlane
153+
154+Released under the GNU General Public License version 2 or later.
155+
156+----------------------------------------------------------------------
157+src/Text/Pandoc/Readers/Jira.hs
158+src/Text/Pandoc/Writers/Jira.hs
159+test/Tests/Readers/Jira.hs
144−Copyright (C) 2014-2019 Albert Krewinkel
160+Copyright (C) 2019--2021 Albert Krewinkel
145
161
146Released under the GNU General Public License version 2 or later.
162Released under the GNU General Public License version 2 or later.
147
163
148----------------------------------------------------------------------
164----------------------------------------------------------------------
149src/Text/Pandoc/Readers/FB2.hs
165src/Text/Pandoc/Readers/FB2.hs
150−Copyright (C) 2018 Alexander Krotov
166+Copyright (C) 2018--2019 Alexander Krotov
151
167
152Released under the GNU General Public License version 2 or later.
168Released under the GNU General Public License version 2 or later.
153
169
154----------------------------------------------------------------------
170----------------------------------------------------------------------
155data/pandoc.lua
171data/pandoc.lua
156−Copyright (C) 2017-2019 Albert Krewinkel
172+Copyright (C) 2017-2021 Albert Krewinkel
157
173
158Released under the GNU General Public License version 2 or later.
174Released under the GNU General Public License version 2 or later.
159
175
160----------------------------------------------------------------------
176----------------------------------------------------------------------
161The dzslides template contains JavaScript and CSS from Paul Rouget's
177The dzslides template contains JavaScript and CSS from Paul Rouget's
162dzslides template.
178dzslides template.
163−http://github.com/paulrouget/dzslides
179+https://github.com/paulrouget/dzslides
164
180
165Released under the Do What the Fuck You Want To Public License.
181Released under the Do What the Fuck You Want To Public License.
166
182
167------------------------------------------------------------------------
183------------------------------------------------------------------------
168−Pandoc embeds a lua interpreter (via hslua).
184+Pandoc embeds a Lua interpreter (via hslua).
169
185
170−Copyright © 1994–2017 Lua.org, PUC-Rio.
186+Copyright © 1994–2020 Lua.org, PUC-Rio.
171
187
172Permission is hereby granted, free of charge, to any person obtaining
188Permission is hereby granted, free of charge, to any person obtaining
173a copy of this software and associated documentation files (the
189a copy of this software and associated documentation files (the
@@ -187,12 +203,3 @@ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
187LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
203LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
188OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
204OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
189WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
205WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
190−
191−------------------------------------------------------------------------
192−The template pandoc.jats is Copyright 2013--15 Martin Fenner,
193−released under GPL version 2 or later.
194−
195−The file data/jats.csl is derived from a csl file by Martin Fenner,
196−revised by Martin Paul Eve and then John MacFarlane.
197−"This work is licensed under a Creative Commons Attribution-ShareAlike 3.0
198−License. Originally by Martin Fenner."
INSTALL.md+119−107
@@ -12,118 +12,116 @@ under the heading for your operating system.
12
12
13## Windows
13## Windows
14
14
15− - There is a package installer at pandoc's [download page].
15+There is a package installer at pandoc's [download page].
16− This will install pandoc, replacing older versions, and
16+This will install pandoc, replacing older versions, and
17− update your path to include the directory where pandoc's
17+update your path to include the directory where pandoc's
18− binaries are installed.
18+binaries are installed.
19
19
20− - If you prefer not to use the msi installer, we also provide
20+If you prefer not to use the msi installer, we also provide
21− a zip file that contains pandoc's binaries and
21+a zip file that contains pandoc's binaries and
22− documentation. Simply unzip this file and move the binaries
22+documentation. Simply unzip this file and move the binaries
23− to a directory of your choice.
23+to a directory of your choice.
24
24
25− - Alternatively, you can install pandoc using
25+Alternatively, you can install pandoc using
26− [Chocolatey](https://chocolatey.org):
26+[Chocolatey](https://chocolatey.org):
27
27
28− choco install pandoc
28+ choco install pandoc
29
29
30− Chocolatey can also install other software that integrates with Pandoc.
30+Chocolatey can also install other software that integrates with Pandoc.
31− For example, to install `rsvg-convert` (from [librsvg], covering formats
31+For example, to install `rsvg-convert` (from [librsvg], covering formats
32− without SVG support), [Python] (to use Pandoc filters), and
32+without SVG support), [Python] (to use Pandoc filters), and
33− [MiKTeX] (to typeset PDFs with [LaTeX]):
33+[MiKTeX] (to typeset PDFs with [LaTeX]):
34
34
35− choco install rsvg-convert python miktex
35+ choco install rsvg-convert python miktex
36
36
37− - By default, Pandoc creates PDFs using LaTeX.
37+Using multiple installation methods can result in two separate
38− We recommend installing it via [MiKTeX].
38+installations of pandoc; it is recommended to properly uninstall
39+pandoc before switching to an alternative installation method.
39
40
40−## macOS
41+By default, Pandoc creates PDFs using LaTeX.
41−
42+We recommend installing it via [MiKTeX].
42− - There is a package installer at pandoc's [download page].
43− If you later want to uninstall the package, you can do so
44− by downloading [this script][uninstaller]
45− and running it with `perl uninstall-pandoc.pl`.
46
43
47− - Alternatively, you can install pandoc using
44+## macOS
48− [Homebrew](http://brew.sh):
49
45
50− brew install pandoc
46+There is a package installer at pandoc's [download page].
47+If you later want to uninstall the package, you can do so
48+by downloading [this script][uninstaller]
49+and running it with `perl uninstall-pandoc.pl`.
51
50
52− To include pandoc's citation parser:
51+Alternatively, you can install pandoc using
52+[Homebrew](https://brew.sh):
53
53
54− brew install pandoc-citeproc
54+ brew install pandoc
55
55
56− Homebrew can also install other software that integrates with Pandoc.
56+Homebrew can also install other software that integrates with Pandoc.
57− For example, to install [librsvg] (its `rsvg-convert` covers formats
57+For example, to install [librsvg] (its `rsvg-convert` covers formats
58− without SVG support), [Python] (to use Pandoc filters), and
58+without SVG support), [Python] (to use Pandoc filters), and
59− [BasicTeX] (to typeset PDFs with [LaTeX]):
59+[BasicTeX] (to typeset PDFs with [LaTeX]):
60
60
61− brew install librsvg python homebrew/cask/basictex
61+ brew install librsvg python homebrew/cask/basictex
62
62
63− Note: On unsupported versions of macOS (more than three releases old),
63+Note: On unsupported versions of macOS (more than three releases old),
64− Homebrew installs from source, which takes additional time and disk space
64+Homebrew installs from source, which takes additional time and disk space
65− for the `ghc` compiler and dependent Haskell libraries.
65+for the `ghc` compiler and dependent Haskell libraries.
66
66
67− - We also provide a zip file containing the binaries and man
67+We also provide a zip file containing the binaries and man
68− pages, for those who prefer not to use the installer. Simply
68+pages, for those who prefer not to use the installer. Simply
69− unzip the file and move the binaries and man pages to
69+unzip the file and move the binaries and man pages to
70− whatever directory you like.
70+whatever directory you like.
71
71
72− - By default, Pandoc creates PDFs using LaTeX. Because a full [MacTeX]
72+By default, Pandoc creates PDFs using LaTeX. Because a full [MacTeX]
73− installation uses four gigabytes of disk space, we recommend
73+installation uses four gigabytes of disk space, we recommend
74− [BasicTeX] or [TinyTeX](https://yihui.name/tinytex/)
74+[BasicTeX] or [TinyTeX](https://yihui.org/tinytex/)
75− and using the `tlmgr` tool to install additional packages
75+and using the `tlmgr` tool to install additional packages
76− as needed. If you receive errors warning of fonts not found:
76+as needed. If you receive errors warning of fonts not found:
77
77
78− tlmgr install collection-fontsrecommended
78+ tlmgr install collection-fontsrecommended
79
79
80## Linux
80## Linux
81
81
82− - Check whether the pandoc version in your package manager is
82+Check whether the pandoc version in your package manager is
83− not outdated. Pandoc is in the [Debian], [Ubuntu], [Slackware],
83+not outdated. Pandoc is in the [Debian], [Ubuntu], [Slackware],
84− [Arch], [Fedora], [NiXOS], [openSUSE], [gentoo] and [Void] repositories.
84+[Arch], [Fedora], [NiXOS], [openSUSE], [gentoo] and [Void] repositories.
85
85
86− - To get the latest release, we provide a binary package for amd64
86+To get the latest release, we provide a binary package for amd64
87− architecture on the **[download page]**.
87+architecture on the **[download page]**.
88
88
89− This provides both `pandoc` and `pandoc-citeproc`.
90− The executables are statically linked and
89+The executable is statically linked and
91− have no dynamic dependencies or dependencies on external
90+has no dynamic dependencies or dependencies on external
92− data files. Note: because of the static
91+data files. Note: because of the static
93− linking, the pandoc binary from this package cannot use lua
92+linking, the pandoc binary from this package cannot use lua
94− filters that require external lua modules written in C.
93+filters that require external lua modules written in C.
95
94
96− Both a tarball and a deb installer are provided. To install the deb:
95+Both a tarball and a deb installer are provided. To install the deb:
97
96
98− sudo dpkg -i $DEB
97+ sudo dpkg -i $DEB
99
98
100− where `$DEB` is the path to the downloaded deb. This will
99+where `$DEB` is the path to the downloaded deb. This will
101− install the `pandoc` and `pandoc-citeproc` executables and
100+install the `pandoc` executable and man page.
102− man pages.
103
101
104− If you use an RPM-based distro, you may be able to install
102+If you use an RPM-based distro, you may be able to install
105− the deb from our download page using `alien`.
103+the deb from our download page using `alien`.
106
104
107− On any distro, you may install from the tarball into `$DEST`
105+On any distro, you may install from the tarball into `$DEST`
108− (say, `/usr/local/` or `$HOME/.local`) by doing
106+(say, `/usr/local/` or `$HOME/.local`) by doing
109
107
110− tar xvzf $TGZ --strip-components 1 -C $DEST
108+ tar xvzf $TGZ --strip-components 1 -C $DEST
111
109
112− where `$TGZ` is the path to the downloaded zipped tarball.
110+where `$TGZ` is the path to the downloaded zipped tarball.
113− For Pandoc versions before 2.0, which don't provide
111+For Pandoc versions before 2.0, which don't provide
114− a tarball, try instead
112+a tarball, try instead
115
113
116− ar p $DEB data.tar.gz | tar xvz --strip-components 2 -C $DEST
114+ ar p $DEB data.tar.gz | tar xvz --strip-components 2 -C $DEST
117
115
118− - You can also install from source, using the
116+You can also install from source, using the
119− instructions below under [Compiling from source].
117+instructions below under [Compiling from source].
120− Note that most distros have the Haskell platform in their
118+Note that most distros have the Haskell platform in their
121− package repositories. For example, on Debian/Ubuntu,
119+package repositories. For example, on Debian/Ubuntu,
122− you can install it with `apt-get install haskell-platform`.
120+you can install it with `apt-get install haskell-platform`.
123
121
124− - For PDF output, you'll need LaTeX. We recommend installing
122+For PDF output, you'll need LaTeX. We recommend installing
125− [TeX Live](http://www.tug.org/texlive/) via your package
123+[TeX Live](https://www.tug.org/texlive/) via your package
126− manager. (On Debian/Ubuntu, `apt-get install texlive`.)
124+manager. (On Debian/Ubuntu, `apt-get install texlive`.)
127
125
128## Chrome OS
126## Chrome OS
129
127
@@ -140,7 +138,30 @@ device you are using.
140
138
141## BSD
139## BSD
142
140
143− - Pandoc is in the [NetBSD] and [FreeBSD ports] repositories.
141+Pandoc is in the [NetBSD] and [FreeBSD ports] repositories.
142+
143+## Docker
144+
145+The official Docker images for pandoc can be found at
146+<https://github.com/pandoc/dockerfiles> and at
147+[dockerhub](https://hub.docker.com/).
148+
149+The [pandoc/core](https://hub.docker.com/r/pandoc/core)
150+image contains `pandoc`.
151+
152+The [pandoc/latex](https://hub.docker.com/r/pandoc/latex)
153+image also contains the minimal LaTeX installation needed
154+to produce PDFs using pandoc.
155+
156+To run pandoc using Docker, converting `README.md` to `README.pdf`:
157+
158+ docker run --rm --volume "`pwd`:/data" --user `id -u`:`id -g` pandoc/latex README.md -o README.pdf
159+
160+## GitHub Actions
161+
162+Pandoc can be run through
163+[GitHub Actions](https://github.com/features/actions). For some
164+examples, see <https://github.com/pandoc/pandoc-action-example>.
144
165
145## Compiling from source
166## Compiling from source
146
167
@@ -221,28 +242,22 @@ The easiest way to build pandoc from source is to use [stack][stack]:
221
242
222 pandoc --help
243 pandoc --help
223
244
224− [Not sure where `$CABALDIR` is?](http://www.haskell.org/haskellwiki/Cabal-Install#The_cabal-install_configuration_file)
245+ [Not sure where `$CABALDIR` is?](https://wiki.haskell.org/Cabal-Install#The_cabal-install_configuration_file)
225
246
226−5. If you want to process citations with pandoc, you will also need to
227− install a separate package, `pandoc-citeproc`. This can be installed
228− using cabal:
229−
230− cabal install pandoc-citeproc
231−
232− By default `pandoc-citeproc` uses the "i;unicode-casemap" method
247+5. By default `pandoc` uses the "i;unicode-casemap" method
233 to sort bibliography entries (RFC 5051). If you would like to
248 to sort bibliography entries (RFC 5051). If you would like to
234 use the locale-sensitive unicode collation algorithm instead,
249 use the locale-sensitive unicode collation algorithm instead,
235− specify the `unicode_collation` flag:
250+ specify the `icu` flag (which affects the dependency `citeproc`):
236
251
237− cabal install pandoc-citeproc -funicode_collation
252+ cabal install pandoc -ficu
238
253
239 Note that this requires the `text-icu` library, which in turn
254 Note that this requires the `text-icu` library, which in turn
240 depends on the C library `icu4c`. Installation directions
255 depends on the C library `icu4c`. Installation directions
241 vary by platform. Here is how it might work on macOS with Homebrew:
256 vary by platform. Here is how it might work on macOS with Homebrew:
242
257
243 brew install icu4c
258 brew install icu4c
244− stack install pandoc-citeproc \
259+ stack install pandoc \
245− --flag "pandoc-citeproc:unicode_collation" \
260+ --flag "citeproc:icu" \
246 --extra-lib-dirs=/usr/local/opt/icu4c/lib \
261 --extra-lib-dirs=/usr/local/opt/icu4c/lib \
247 --extra-include-dirs=/usr/local/opt/icu4c/include
262 --extra-include-dirs=/usr/local/opt/icu4c/include
248
263
@@ -251,8 +266,6 @@ The easiest way to build pandoc from source is to use [stack][stack]:
251 accordingly. If `MANUAL.txt` has been modified, the man page can be
266 accordingly. If `MANUAL.txt` has been modified, the man page can be
252 rebuilt: `make man/pandoc.1`.
267 rebuilt: `make man/pandoc.1`.
253
268
254− The `pandoc-citeproc.1` man page will also be installed automatically.
255−
256
269
257### Custom cabal method
270### Custom cabal method
258
271
@@ -374,30 +387,29 @@ To run just the markdown benchmarks:
374
387
375
388
376[Arch]: https://www.archlinux.org/packages/community/x86_64/pandoc/
389[Arch]: https://www.archlinux.org/packages/community/x86_64/pandoc/
377−[Cabal User's Guide]: http://www.haskell.org/cabal/release/latest/doc/users-guide/builders.html#setup-configure-paths
390+[Cabal User's Guide]: https://cabal.readthedocs.io/
378[Debian]: https://packages.debian.org/pandoc
391[Debian]: https://packages.debian.org/pandoc
379[Fedora]: https://apps.fedoraproject.org/packages/pandoc
392[Fedora]: https://apps.fedoraproject.org/packages/pandoc
380−[FreeBSD ports]: http://www.freshports.org/textproc/pandoc/
393+[FreeBSD ports]: https://www.freshports.org/textproc/hs-pandoc/
381−[GHC]: http://www.haskell.org/ghc/
394+[GHC]: https://www.haskell.org/ghc/
382−[GPL]: http://www.gnu.org/copyleft/gpl.html
383−[Haskell platform]: http://hackage.haskell.org/platform/
395+[Haskell platform]: https://hackage.haskell.org/platform/
384−[MacPorts]: http://trac.macports.org/browser/trunk/dports/textproc/pandoc/Portfile
396+[MacPorts]: https://trac.macports.org/browser/trunk/dports/textproc/pandoc/Portfile
385[MacTeX]: https://tug.org/mactex/
397[MacTeX]: https://tug.org/mactex/
386−[BasicTeX]: http://www.tug.org/mactex/morepackages.html
398+[BasicTeX]: https://www.tug.org/mactex/morepackages.html
387[LaTeX]: https://www.latex-project.org
399[LaTeX]: https://www.latex-project.org
388−[MiKTeX]: http://miktex.org/
400+[MiKTeX]: https://miktex.org/
389[librsvg]: https://wiki.gnome.org/Projects/LibRsvg
401[librsvg]: https://wiki.gnome.org/Projects/LibRsvg
390[Python]: https://www.python.org
402[Python]: https://www.python.org
391−[NetBSD]: http://pkgsrc.se/wip/pandoc
403+[NetBSD]: https://pkgsrc.se/wip/pandoc
392[NixOS]: https://nixos.org/nixos/packages.html
404[NixOS]: https://nixos.org/nixos/packages.html
393[Slackware]: https://www.slackbuilds.org/result/?search=pandoc&sv=
405[Slackware]: https://www.slackbuilds.org/result/?search=pandoc&sv=
394[Ubuntu]: https://packages.ubuntu.com/pandoc
406[Ubuntu]: https://packages.ubuntu.com/pandoc
395[download page]: https://github.com/jgm/pandoc/releases/latest
407[download page]: https://github.com/jgm/pandoc/releases/latest
396−[gentoo]: http://packages.gentoo.org/package/app-text/pandoc
408+[gentoo]: https://packages.gentoo.org/package/app-text/pandoc
397[haskell repository]: https://wiki.archlinux.org/index.php/Haskell_Package_Guidelines#.5Bhaskell.5D
409[haskell repository]: https://wiki.archlinux.org/index.php/Haskell_Package_Guidelines#.5Bhaskell.5D
398[openSUSE]: https://software.opensuse.org/package/pandoc
410[openSUSE]: https://software.opensuse.org/package/pandoc
399−[source tarball]: http://hackage.haskell.org/package/pandoc
411+[source tarball]: https://hackage.haskell.org/package/pandoc
400[stack]: https://docs.haskellstack.org/en/stable/install_and_upgrade.html
412[stack]: https://docs.haskellstack.org/en/stable/install_and_upgrade.html
401−[cabal-install]: http://hackage.haskell.org/package/cabal-install
413+[cabal-install]: https://hackage.haskell.org/package/cabal-install
402[Void]: https://voidlinux.org/
414[Void]: https://voidlinux.org/
403[uninstaller]: https://raw.githubusercontent.com/jgm/pandoc/master/macos/uninstall-pandoc.pl
415[uninstaller]: https://raw.githubusercontent.com/jgm/pandoc/master/macos/uninstall-pandoc.pl
MANUAL.txt+1226−602
@@ -1,7 +1,7 @@
1---
1---
2title: Pandoc User's Guide
2title: Pandoc User's Guide
3author: John MacFarlane
3author: John MacFarlane
4−date: December 21, 2019
4+date: June 20, 2021
5---
5---
6
6
7# Synopsis
7# Synopsis
@@ -106,7 +106,7 @@ RTF, OPML, DocBook, and Texinfo), information about
106the character encoding is included in the document header, which
106the character encoding is included in the document header, which
107will only be included if you use the `-s/--standalone` option.
107will only be included if you use the `-s/--standalone` option.
108
108
109−[`iconv`]: http://www.gnu.org/software/libiconv/
109+[`iconv`]: https://www.gnu.org/software/libiconv/
110
110
111## Creating a PDF
111## Creating a PDF
112
112
@@ -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−[`ifxetex`], [`ifluatex`], [`listings`] (if the
139+[`iftex`], [`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`]. `xelatex` uses
146+the PDF engine requires [`fontspec`]. `lualatex` uses
147−[`polyglossia`] (with `lang`), [`xecjk`], and [`bidi`] (with the
147+[`selnolig`]. `xelatex` uses [`polyglossia`] (with `lang`),
148−`dir` variable set). If the `mathspec` variable is set,
148+[`xecjk`], and [`bidi`] (with the `dir` variable set). If the
149−`xelatex` will use [`mathspec`] instead of [`unicode-math`].
149+`mathspec` variable is set, `xelatex` will use [`mathspec`]
150−The [`upquote`] and [`microtype`] packages are used if
150+instead of [`unicode-math`]. The [`upquote`] and [`microtype`]
151−available, and [`csquotes`] will be used for [typography]
151+packages are used if available, and [`csquotes`] will be used
152−if the `csquotes` variable or metadata field is set to a
152+for [typography] if the `csquotes` variable or metadata field is
153−true value. The [`natbib`], [`biblatex`], [`bibtex`], and
153+set to a true value. The [`natbib`], [`biblatex`], [`bibtex`],
154−[`biber`] packages can optionally be used for [citation
154+and [`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
@@ -161,7 +161,7 @@ better line breaks in URLs), [`bookmark`] (for better PDF
161bookmarks), and [`footnotehyper`] or [`footnote`] (to allow
161bookmarks), and [`footnotehyper`] or [`footnote`] (to allow
162footnotes in tables).
162footnotes in tables).
163
163
164−[TeX Live]: http://www.tug.org/texlive/
164+[TeX Live]: https://www.tug.org/texlive/
165[`amsfonts`]: https://ctan.org/pkg/amsfonts
165[`amsfonts`]: https://ctan.org/pkg/amsfonts
166[`amsmath`]: https://ctan.org/pkg/amsmath
166[`amsmath`]: https://ctan.org/pkg/amsmath
167[`babel`]: https://ctan.org/pkg/babel
167[`babel`]: https://ctan.org/pkg/babel
@@ -180,8 +180,7 @@ 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−[`ifluatex`]: https://ctan.org/pkg/ifluatex
184−[`ifxetex`]: https://ctan.org/pkg/ifxetex
183+[`iftex`]: https://ctan.org/pkg/iftex
185[`listings`]: https://ctan.org/pkg/listings
184[`listings`]: https://ctan.org/pkg/listings
186[`lm`]: https://ctan.org/pkg/lm
185[`lm`]: https://ctan.org/pkg/lm
187[`longtable`]: https://ctan.org/pkg/longtable
186[`longtable`]: https://ctan.org/pkg/longtable
@@ -195,26 +194,27 @@ footnotes in tables).
195[`ulem`]: https://ctan.org/pkg/ulem
194[`ulem`]: https://ctan.org/pkg/ulem
196[`unicode-math`]: https://ctan.org/pkg/unicode-math
195[`unicode-math`]: https://ctan.org/pkg/unicode-math
197[`upquote`]: https://ctan.org/pkg/upquote
196[`upquote`]: https://ctan.org/pkg/upquote
198−[`weasyprint`]: http://weasyprint.org
197+[`weasyprint`]: https://weasyprint.org
199[`wkhtmltopdf`]: https://wkhtmltopdf.org
198[`wkhtmltopdf`]: https://wkhtmltopdf.org
200[`xcolor`]: https://ctan.org/pkg/xcolor
199[`xcolor`]: https://ctan.org/pkg/xcolor
201[`xecjk`]: https://ctan.org/pkg/xecjk
200[`xecjk`]: https://ctan.org/pkg/xecjk
202[`xurl`]: https://ctan.org/pkg/xurl
201[`xurl`]: https://ctan.org/pkg/xurl
202+[`selnolig`]: https://ctan.org/pkg/selnolig
203
203
204
204
205
205
206## Reading from the Web
206## Reading from the Web
207
207
208−Instead of an input file, an absolute URI may be given. In this case
208+Instead of an input file, an absolute URI may be given. In this case
209pandoc will fetch the content using HTTP:
209pandoc will fetch the content using HTTP:
210
210
211− pandoc -f html -t markdown http://www.fsf.org
211+ pandoc -f html -t markdown https://www.fsf.org
212
212
213It is possible to supply a custom User-Agent string or other
213It is possible to supply a custom User-Agent string or other
214header when requesting a document from a URL:
214header when requesting a document from a URL:
215
215
216 pandoc -f html -t markdown --request-header User-Agent:"Mozilla/5.0" \
216 pandoc -f html -t markdown --request-header User-Agent:"Mozilla/5.0" \
217− http://www.fsf.org
217+ https://www.fsf.org
218
218
219# Options
219# Options
220
220
@@ -225,8 +225,13 @@ 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)
228 - `commonmark` ([CommonMark] Markdown)
230 - `commonmark` ([CommonMark] Markdown)
231+ - `commonmark_x` ([CommonMark] Markdown with extensions)
229 - `creole` ([Creole 1.0])
232 - `creole` ([Creole 1.0])
233+ - `csljson` ([CSL JSON] bibliography)
234+ - `csv` ([CSV] table)
230 - `docbook` ([DocBook])
235 - `docbook` ([DocBook])
231 - `docx` ([Word docx])
236 - `docx` ([Word docx])
232 - `dokuwiki` ([DokuWiki markup])
237 - `dokuwiki` ([DokuWiki markup])
@@ -240,7 +245,7 @@ header when requesting a document from a URL:
240 - `html` ([HTML])
245 - `html` ([HTML])
241 - `ipynb` ([Jupyter notebook])
246 - `ipynb` ([Jupyter notebook])
242 - `jats` ([JATS] XML)
247 - `jats` ([JATS] XML)
243− - `jira` ([Jira] wiki markup)
248+ - `jira` ([Jira]/Confluence wiki markup)
244 - `json` (JSON version of native AST)
249 - `json` (JSON version of native AST)
245 - `latex` ([LaTeX])
250 - `latex` ([LaTeX])
246 - `markdown` ([Pandoc's Markdown])
251 - `markdown` ([Pandoc's Markdown])
@@ -275,8 +280,12 @@ header when requesting a document from a URL:
275 ::: {#output-formats}
280 ::: {#output-formats}
276 - `asciidoc` ([AsciiDoc]) or `asciidoctor` ([AsciiDoctor])
281 - `asciidoc` ([AsciiDoc]) or `asciidoctor` ([AsciiDoctor])
277 - `beamer` ([LaTeX beamer][`beamer`] slide show)
282 - `beamer` ([LaTeX beamer][`beamer`] slide show)
283+ - `bibtex` ([BibTeX] bibliography)
284+ - `biblatex` ([BibLaTeX] bibliography)
278 - `commonmark` ([CommonMark] Markdown)
285 - `commonmark` ([CommonMark] Markdown)
286+ - `commonmark_x` ([CommonMark] Markdown with extensions)
279 - `context` ([ConTeXt])
287 - `context` ([ConTeXt])
288+ - `csljson` ([CSL JSON] bibliography)
280 - `docbook` or `docbook4` ([DocBook] 4)
289 - `docbook` or `docbook4` ([DocBook] 4)
281 - `docbook5` (DocBook 5)
290 - `docbook5` (DocBook 5)
282 - `docx` ([Word docx])
291 - `docx` ([Word docx])
@@ -293,8 +302,11 @@ header when requesting a document from a URL:
293 - `html4` ([XHTML] 1.0 Transitional)
302 - `html4` ([XHTML] 1.0 Transitional)
294 - `icml` ([InDesign ICML])
303 - `icml` ([InDesign ICML])
295 - `ipynb` ([Jupyter notebook])
304 - `ipynb` ([Jupyter notebook])
296− - `jats` ([JATS] XML)
305+ - `jats_archiving` ([JATS] XML, Archiving and Interchange Tag Set)
306+ - `jats_articleauthoring` ([JATS] XML, Article Authoring Tag Set)
307+ - `jats_publishing` ([JATS] XML, Journal Publishing Tag Set)
308+ - `jats` (alias for `jats_archiving`)
297− - `jira` ([Jira] wiki markup)
309+ - `jira` ([Jira]/Confluence wiki markup)
298 - `json` (JSON version of native AST)
310 - `json` (JSON version of native AST)
299 - `latex` ([LaTeX])
311 - `latex` ([LaTeX])
300 - `man` ([roff man])
312 - `man` ([roff man])
@@ -325,7 +337,7 @@ header when requesting a document from a URL:
325 - `tei` ([TEI Simple])
337 - `tei` ([TEI Simple])
326 - `xwiki` ([XWiki markup])
338 - `xwiki` ([XWiki markup])
327 - `zimwiki` ([ZimWiki markup])
339 - `zimwiki` ([ZimWiki markup])
328− - the path of a custom lua writer, see [Custom writers] below
340+ - the path of a custom Lua writer, see [Custom writers] below
329 :::
341 :::
330
342
331 Note that `odt`, `docx`, `epub`, and `pdf` output will not be directed
343 Note that `odt`, `docx`, `epub`, and `pdf` output will not be directed
@@ -349,15 +361,15 @@ header when requesting a document from a URL:
349 will be used. On \*nix and macOS systems this will be the `pandoc`
361 will be used. On \*nix and macOS systems this will be the `pandoc`
350 subdirectory of the XDG data directory (by default,
362 subdirectory of the XDG data directory (by default,
351 `$HOME/.local/share`, overridable by setting the `XDG_DATA_HOME`
363 `$HOME/.local/share`, overridable by setting the `XDG_DATA_HOME`
352− environment variable). If that directory does not exist,
364+ environment variable). If that directory does not exist and
353− `$HOME/.pandoc` will be used (for backwards compatibility).
365+ `$HOME/.pandoc` exists, it will be used (for backwards compatibility).
354− In Windows the default user data directory is
366+ On Windows the default user data directory is
355 `C:\Users\USERNAME\AppData\Roaming\pandoc`.
367 `C:\Users\USERNAME\AppData\Roaming\pandoc`.
356 You can find the default user data directory on your system by
368 You can find the default user data directory on your system by
357 looking at the output of `pandoc --version`.
369 looking at the output of `pandoc --version`.
370+ Data files placed in this directory (for example, `reference.odt`,
358− A `reference.odt`, `reference.docx`, `epub.css`, `templates`,
371+ `reference.docx`, `epub.css`, `templates`) will override
359− `slidy`, `slideous`, or `s5` directory
360− placed in this directory will override pandoc's normal defaults.
372+ pandoc's normal defaults.
361
373
362`-d` *FILE*, `--defaults=`*FILE*
374`-d` *FILE*, `--defaults=`*FILE*
363
375
@@ -382,8 +394,7 @@ header when requesting a document from a URL:
382
394
383`--verbose`
395`--verbose`
384
396
385−: Give verbose debugging output. Currently this only has an effect
397+: Give verbose debugging output.
386− with PDF output.
387
398
388`--quiet`
399`--quiet`
389
400
@@ -432,59 +443,63 @@ header when requesting a document from a URL:
432
443
433: Show usage message.
444: Show usage message.
434
445
435−[Markdown]: http://daringfireball.net/projects/markdown/
446+[Markdown]: https://daringfireball.net/projects/markdown/
436−[CommonMark]: http://commonmark.org
447+[CommonMark]: https://commonmark.org
437[PHP Markdown Extra]: https://michelf.ca/projects/php-markdown/extra/
448[PHP Markdown Extra]: https://michelf.ca/projects/php-markdown/extra/
438[GitHub-Flavored Markdown]: https://help.github.com/articles/github-flavored-markdown/
449[GitHub-Flavored Markdown]: https://help.github.com/articles/github-flavored-markdown/
439−[MultiMarkdown]: http://fletcherpenney.net/multimarkdown/
450+[MultiMarkdown]: https://fletcherpenney.net/multimarkdown/
440−[reStructuredText]: http://docutils.sourceforge.net/docs/ref/rst/introduction.html
451+[reStructuredText]: https://docutils.sourceforge.io/docs/ref/rst/introduction.html
441−[S5]: http://meyerweb.com/eric/tools/s5/
452+[S5]: https://meyerweb.com/eric/tools/s5/
442−[Slidy]: http://www.w3.org/Talks/Tools/Slidy/
453+[Slidy]: https://www.w3.org/Talks/Tools/Slidy2/
443−[Slideous]: http://goessner.net/articles/slideous/
454+[Slideous]: https://goessner.net/articles/slideous/
444−[HTML]: http://www.w3.org/html/
455+[HTML]: https://www.w3.org/html/
445−[HTML5]: http://www.w3.org/TR/html5/
456+[HTML5]: https://html.spec.whatwg.org/
446[polyglot markup]: https://www.w3.org/TR/html-polyglot/
457[polyglot markup]: https://www.w3.org/TR/html-polyglot/
447−[XHTML]: http://www.w3.org/TR/xhtml1/
458+[XHTML]: https://www.w3.org/TR/xhtml1/
448−[LaTeX]: http://latex-project.org
459+[LaTeX]: https://www.latex-project.org/
449[`beamer`]: https://ctan.org/pkg/beamer
460[`beamer`]: https://ctan.org/pkg/beamer
450[Beamer User's Guide]: http://mirrors.ctan.org/macros/latex/contrib/beamer/doc/beameruserguide.pdf
461[Beamer User's Guide]: http://mirrors.ctan.org/macros/latex/contrib/beamer/doc/beameruserguide.pdf
451−[ConTeXt]: http://www.contextgarden.net/
462+[ConTeXt]: https://www.contextgarden.net/
452−[Rich Text Format]: http://en.wikipedia.org/wiki/Rich_Text_Format
463+[Rich Text Format]: https://en.wikipedia.org/wiki/Rich_Text_Format
453−[DocBook]: http://docbook.org
464+[DocBook]: https://docbook.org
454[JATS]: https://jats.nlm.nih.gov
465[JATS]: https://jats.nlm.nih.gov
455[Jira]: https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all
466[Jira]: https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all
456−[txt2tags]: http://txt2tags.org
467+[txt2tags]: https://txt2tags.org
457[EPUB]: http://idpf.org/epub
468[EPUB]: http://idpf.org/epub
458[OPML]: http://dev.opml.org/spec2.html
469[OPML]: http://dev.opml.org/spec2.html
459[OpenDocument]: http://opendocument.xml.org
470[OpenDocument]: http://opendocument.xml.org
460−[ODT]: http://en.wikipedia.org/wiki/OpenDocument
471+[ODT]: https://en.wikipedia.org/wiki/OpenDocument
461−[Textile]: http://redcloth.org/textile
472+[Textile]: https://www.promptworks.com/textile
462[MediaWiki markup]: https://www.mediawiki.org/wiki/Help:Formatting
473[MediaWiki markup]: https://www.mediawiki.org/wiki/Help:Formatting
463[DokuWiki markup]: https://www.dokuwiki.org/dokuwiki
474[DokuWiki markup]: https://www.dokuwiki.org/dokuwiki
464−[ZimWiki markup]: http://zim-wiki.org/manual/Help/Wiki_Syntax.html
475+[ZimWiki markup]: https://zim-wiki.org/manual/Help/Wiki_Syntax.html
465[XWiki markup]: https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/
476[XWiki markup]: https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/
466−[TWiki markup]: http://twiki.org/cgi-bin/view/TWiki/TextFormattingRules
477+[TWiki markup]: https://twiki.org/cgi-bin/view/TWiki/TextFormattingRules
467[TikiWiki markup]: https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax
478[TikiWiki markup]: https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax
468[Haddock markup]: https://www.haskell.org/haddock/doc/html/ch03s08.html
479[Haddock markup]: https://www.haskell.org/haddock/doc/html/ch03s08.html
469[Creole 1.0]: http://www.wikicreole.org/wiki/Creole1.0
480[Creole 1.0]: http://www.wikicreole.org/wiki/Creole1.0
470−[roff man]: http://man7.org/linux/man-pages/man7/groff_man.7.html
481+[CSV]: https://tools.ietf.org/html/rfc4180
482+[roff man]: https://man.cx/groff_man(7)
471−[roff ms]: http://man7.org/linux/man-pages/man7/groff_ms.7.html
483+[roff ms]: https://man.cx/groff_ms(7)
472[Haskell]: https://www.haskell.org
484[Haskell]: https://www.haskell.org
473−[GNU Texinfo]: http://www.gnu.org/software/texinfo/
485+[GNU Texinfo]: https://www.gnu.org/software/texinfo/
474−[Emacs Org mode]: http://orgmode.org
486+[Emacs Org mode]: https://orgmode.org
475−[AsciiDoc]: http://www.methods.co.nz/asciidoc/
487+[AsciiDoc]: https://www.methods.co.nz/asciidoc/
476[AsciiDoctor]: https://asciidoctor.org/
488[AsciiDoctor]: https://asciidoctor.org/
477−[DZSlides]: http://paulrouget.com/dzslides/
489+[DZSlides]: https://paulrouget.com/dzslides/
478[Word docx]: https://en.wikipedia.org/wiki/Office_Open_XML
490[Word docx]: https://en.wikipedia.org/wiki/Office_Open_XML
479[PDF]: https://www.adobe.com/pdf/
491[PDF]: https://www.adobe.com/pdf/
480−[reveal.js]: http://lab.hakim.se/reveal-js/
492+[reveal.js]: https://revealjs.com/
481[FictionBook2]: http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1
493[FictionBook2]: http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1
482[Jupyter notebook]: https://nbformat.readthedocs.io/en/latest/
494[Jupyter notebook]: https://nbformat.readthedocs.io/en/latest/
483−[InDesign ICML]: http://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf
495+[InDesign ICML]: https://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf
484[TEI Simple]: https://github.com/TEIC/TEI-Simple
496[TEI Simple]: https://github.com/TEIC/TEI-Simple
485[Muse]: https://amusewiki.org/library/manual
497[Muse]: https://amusewiki.org/library/manual
486[PowerPoint]: https://en.wikipedia.org/wiki/Microsoft_PowerPoint
498[PowerPoint]: https://en.wikipedia.org/wiki/Microsoft_PowerPoint
487[Vimwiki]: https://vimwiki.github.io
499[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
488
503
489## Reader options {.options}
504## Reader options {.options}
490
505
@@ -574,41 +589,32 @@ header when requesting a document from a URL:
574
589
575 3. `$PATH` (executable only)
590 3. `$PATH` (executable only)
576
591
577− Filters and lua-filters are applied in the order specified
592+ Filters, Lua-filters, and citeproc processing are applied in
578− on the command line.
593+ the order specified on the command line.
579
594
580`-L` *SCRIPT*, `--lua-filter=`*SCRIPT*
595`-L` *SCRIPT*, `--lua-filter=`*SCRIPT*
581
596
582: Transform the document in a similar fashion as JSON filters (see
597: Transform the document in a similar fashion as JSON filters (see
583− `--filter`), but use pandoc's build-in lua filtering system. The given
598+ `--filter`), but use pandoc's built-in Lua filtering system. The given
584− lua script is expected to return a list of lua filters which will be
599+ Lua script is expected to return a list of Lua filters which will be
585− applied in order. Each lua filter must contain element-transforming
600+ applied in order. Each Lua filter must contain element-transforming
586 functions indexed by the name of the AST element on which the filter
601 functions indexed by the name of the AST element on which the filter
587 function should be applied.
602 function should be applied.
588
603
589− The `pandoc` lua module provides helper functions for element
604+ The `pandoc` Lua module provides helper functions for element
590− creation. It is always loaded into the script's lua environment.
605+ creation. It is always loaded into the script's Lua environment.
591
606
592− The following is an example lua script for macro-expansion:
607+ See the [Lua filters documentation] for further details.
593
608
594− function expand_hello_world(inline)
609+ In order of preference, pandoc will look for Lua filters in
595− if inline.c == '{{helloworld}}' then
596− return pandoc.Emph{ pandoc.Str "Hello, World" }
597− else
598− return inline
599− end
600− end
601
610
602− return {{Str = expand_hello_world}}
611+ 1. a specified full or relative path
603
612
604− In order of preference, pandoc will look for lua filters in
613+ 2. `$DATADIR/filters` where `$DATADIR` is the user data
614+ directory (see `--data-dir`, above).
605
615
606− 1. a specified full or relative path (executable or
616+ Filters, Lua filters, and citeproc processing are applied in
607− non-executable)
617+ the order specified on the command line.
608−
609− 2. `$DATADIR/filters` (executable or non-executable)
610− where `$DATADIR` is the user data directory (see
611− `--data-dir`, above).
612
618
613`-M` *KEY*[`=`*VAL*], `--metadata=`*KEY*[`:`*VAL*]
619`-M` *KEY*[`=`*VAL*], `--metadata=`*KEY*[`:`*VAL*]
614
620
@@ -651,30 +657,30 @@ header when requesting a document from a URL:
651
657
652: Specifies what to do with insertions, deletions, and comments
658: Specifies what to do with insertions, deletions, and comments
653 produced by the MS Word "Track Changes" feature. `accept` (the
659 produced by the MS Word "Track Changes" feature. `accept` (the
654− default), inserts all insertions, and ignores all
660+ default) processes all the insertions and deletions.
655− deletions. `reject` inserts all deletions and ignores
656− insertions. Both `accept` and `reject` ignore comments. `all` puts
661+ `reject` ignores them. Both `accept` and `reject` ignore comments.
657− in insertions, deletions, and comments, wrapped in spans with
662+ `all` includes all insertions, deletions, and comments, wrapped
658− `insertion`, `deletion`, `comment-start`, and `comment-end`
663+ in spans with `insertion`, `deletion`, `comment-start`, and
659− classes, respectively. The author and time of change is
664+ `comment-end` classes, respectively. The author and time of
660− included. `all` is useful for scripting: only accepting changes
665+ change is included. `all` is useful for scripting: only
661− from a certain reviewer, say, or before a certain date. If a
666+ accepting changes from a certain reviewer, say, or before a
662− paragraph is inserted or deleted, `track-changes=all` produces a
667+ certain date. If a paragraph is inserted or deleted,
668+ `track-changes=all` produces a span with the class
663− span with the class `paragraph-insertion`/`paragraph-deletion`
669+ `paragraph-insertion`/`paragraph-deletion` before the
664− before the affected paragraph break. This option only affects the
670+ affected paragraph break. This option only affects the docx
665− docx reader.
671+ reader.
666
672
667`--extract-media=`*DIR*
673`--extract-media=`*DIR*
668
674
669: Extract images and other media contained in or linked from
675: Extract images and other media contained in or linked from
670 the source document to the path *DIR*, creating it if
676 the source document to the path *DIR*, creating it if
671 necessary, and adjust the images references in the document
677 necessary, and adjust the images references in the document
672− so they point to the extracted files. If the source format is
678+ so they point to the extracted files. Media are downloaded,
673− a binary container (docx, epub, or odt), the media is
679+ read from the file system, or extracted from a binary
674− extracted from the container and the original
680+ container (e.g. docx), as needed. The original file paths
675− filenames are used. Otherwise the media is read from the
681+ are used if they are relative paths not containing `..`.
676− file system or downloaded, and new filenames are constructed
682+ Otherwise filenames are constructed from the SHA1 hash of
677− based on SHA1 hashes of the contents.
683+ the contents.
678
684
679`--abbreviations=`*FILE*
685`--abbreviations=`*FILE*
680
686
@@ -685,14 +691,15 @@ header when requesting a document from a URL:
685 system default, use
691 system default, use
686 `pandoc --print-default-data-file=abbreviations`. The only
692 `pandoc --print-default-data-file=abbreviations`. The only
687 use pandoc makes of this list is in the Markdown reader.
693 use pandoc makes of this list is in the Markdown reader.
688− Strings ending in a period that are found in this list will
694+ Strings found in this list will be followed by a nonbreaking
689− be followed by a nonbreaking space, so that the period will
690− not produce sentence-ending space in formats like LaTeX.
695+ space, and the period will not produce sentence-ending space
696+ in formats like LaTeX. The strings may not contain spaces.
691
697
692[`pandocfilters`]: https://github.com/jgm/pandocfilters
698[`pandocfilters`]: https://github.com/jgm/pandocfilters
693[PHP]: https://github.com/vinai/pandocfilters-php
699[PHP]: https://github.com/vinai/pandocfilters-php
694[perl]: https://metacpan.org/pod/Pandoc::Filter
700[perl]: https://metacpan.org/pod/Pandoc::Filter
695[JavaScript/node.js]: https://github.com/mvhenderson/pandoc-filter-node
701[JavaScript/node.js]: https://github.com/mvhenderson/pandoc-filter-node
702+[Lua filters documentation]: https://pandoc.org/lua-filters.html
696
703
697## General writer options {.options}
704## General writer options {.options}
698
705
@@ -884,11 +891,11 @@ header when requesting a document from a URL:
884 will not be searched. For example:
891 will not be searched. For example:
885 `--resource-path=.:test` will search the working directory
892 `--resource-path=.:test` will search the working directory
886 and the `test` subdirectory, in that order.
893 and the `test` subdirectory, in that order.
887−
894+ This option can be used repeatedly. Search path components
888− `--resource-path` only has an effect if (a) the output
895+ that come later on the command line will be searched before
889− format embeds images (for example, `docx`, `pdf`, or `html`
896+ those that come earlier, so
890− with `--self-contained`) or (b) it is used together with
897+ `--resource-path foo:bar --resource-path baz:bim` is
891− `--extract-media`.
898+ equivalent to `--resource-path baz:bim:foo:bar`.
892
899
893`--request-header=`*NAME*`:`*VAL*
900`--request-header=`*NAME*`:`*VAL*
894
901
@@ -898,6 +905,12 @@ header when requesting a document from a URL:
898 downloaded). If you're behind a proxy, you also need to set
905 downloaded). If you're behind a proxy, you also need to set
899 the environment variable `http_proxy` to `http://...`.
906 the environment variable `http_proxy` to `http://...`.
900
907
908+`--no-check-certificate`
909+
910+: Disable the certificate verification to allow access to
911+ unsecure HTTP resources (for example when the certificate
912+ is no longer valid or self signed).
913+
901## Options affecting specific writers {.options}
914## Options affecting specific writers {.options}
902
915
903`--self-contained`
916`--self-contained`
@@ -923,7 +936,9 @@ header when requesting a document from a URL:
923
936
924`--html-q-tags`
937`--html-q-tags`
925
938
926−: Use `<q>` tags for quotes in HTML.
939+: Use `<q>` tags for quotes in HTML. (This option only has an
940+ effect if the `smart` extension is enabled for the input
941+ format used.)
927
942
928`--ascii`
943`--ascii`
929
944
@@ -941,37 +956,45 @@ header when requesting a document from a URL:
941 placement of link references is affected by the
956 placement of link references is affected by the
942 `--reference-location` option.
957 `--reference-location` option.
943
958
944−`--reference-location = block`|`section`|`document`
959+`--reference-location=block`|`section`|`document`
945
960
946: Specify whether footnotes (and references, if `reference-links` is
961: Specify whether footnotes (and references, if `reference-links` is
947 set) are placed at the end of the current (top-level) block, the
962 set) are placed at the end of the current (top-level) block, the
948 current section, or the document. The default is
963 current section, or the document. The default is
949 `document`. Currently only affects the markdown writer.
964 `document`. Currently only affects the markdown writer.
950
965
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+
951`--atx-headers`
974`--atx-headers`
952
975
953−: Use ATX-style headings in Markdown output. The default is
976+: *Deprecated synonym for `--markdown-headings=atx`.*
954− to use setext-style headings for levels 1 to 2, and then ATX headings.
955− (Note: for `gfm` output, ATX headings are always used.)
956− This option also affects markdown cells in `ipynb` output.
957
977
958−`--top-level-division=[default|section|chapter|part]`
978+`--top-level-division=default`|`section`|`chapter`|`part`
959
979
960−: Treat top-level headings as the given division type in LaTeX, ConTeXt,
980+: Treat top-level headings as the given division type in
961− DocBook, and TEI output. The hierarchy order is part, chapter, then section;
981+ LaTeX, ConTeXt, DocBook, and TEI output. The hierarchy
982+ order is part, chapter, then section; all headings are
962− all headings are shifted such that the top-level heading becomes the specified
983+ shifted such that the top-level heading becomes the
963− type. The default behavior is to determine the best division type via
984+ specified type. The default behavior is to determine the
964− heuristics: unless other conditions apply, `section` is chosen. When the
985+ best division type via heuristics: unless other conditions
986+ apply, `section` is chosen. When the `documentclass`
965− `documentclass` variable is set to `report`, `book`, or `memoir` (unless the
987+ variable is set to `report`, `book`, or `memoir` (unless the
966− `article` option is specified), `chapter` is implied as the setting for this
988+ `article` option is specified), `chapter` is implied as the
967− option. If `beamer` is the output format, specifying either `chapter` or
989+ setting for this option. If `beamer` is the output format,
990+ specifying either `chapter` or `part` will cause top-level
968− `part` will cause top-level headings to become `\part{..}`, while
991+ headings to become `\part{..}`, while second-level headings
969− second-level headings remain as their default type.
992+ remain as their default type.
970
993
971`-N`, `--number-sections`
994`-N`, `--number-sections`
972
995
973−: Number section headings in LaTeX, ConTeXt, HTML, or EPUB output.
996+: Number section headings in LaTeX, ConTeXt, HTML, Docx, ms, or EPUB
974− By default, sections are not numbered. Sections with class
997+ output. By default, sections are not numbered. Sections with class
975 `unnumbered` will never be numbered, even if `--number-sections`
998 `unnumbered` will never be numbered, even if `--number-sections`
976 is specified.
999 is specified.
977
1000
@@ -1113,6 +1136,7 @@ header when requesting a document from a URL:
1113 - Verbatim Char
1136 - Verbatim Char
1114 - Footnote Reference
1137 - Footnote Reference
1115 - Hyperlink
1138 - Hyperlink
1139+ - Section Number
1116
1140
1117 Table style:
1141 Table style:
1118
1142
@@ -1260,7 +1284,9 @@ header when requesting a document from a URL:
1260 - `-t latex` or none: `pdflatex` (other options: `xelatex`, `lualatex`,
1284 - `-t latex` or none: `pdflatex` (other options: `xelatex`, `lualatex`,
1261 `tectonic`, `latexmk`)
1285 `tectonic`, `latexmk`)
1262 - `-t context`: `context`
1286 - `-t context`: `context`
1263− - `-t html`: `wkhtmltopdf` (other options: `prince`, `weasyprint`)
1287+ - `-t html`: `wkhtmltopdf` (other options: `prince`, `weasyprint`;
1288+ see [print-css.rocks](https://print-css.rocks) for a good
1289+ introduction to PDF generation from HTML/CSS.)
1264 - `-t ms`: `pdfroff`
1290 - `-t ms`: `pdfroff`
1265
1291
1266`--pdf-engine-opt=`*STRING*
1292`--pdf-engine-opt=`*STRING*
@@ -1270,57 +1296,84 @@ header when requesting a document from a URL:
1270 auxiliary files, use `--pdf-engine-opt=-outdir=foo`.
1296 auxiliary files, use `--pdf-engine-opt=-outdir=foo`.
1271 Note that no check for duplicate options is done.
1297 Note that no check for duplicate options is done.
1272
1298
1273−[Dublin Core elements]: http://dublincore.org/documents/dces/
1299+[Dublin Core elements]: https://www.dublincore.org/specifications/dublin-core/dces/
1274−[ISO 8601 format]: http://www.w3.org/TR/NOTE-datetime
1300+[ISO 8601 format]: https://www.w3.org/TR/NOTE-datetime
1275[Encoding issue with the listings package]:
1301[Encoding issue with the listings package]:
1276 https://en.wikibooks.org/wiki/LaTeX/Source_Code_Listings#Encoding_issue
1302 https://en.wikibooks.org/wiki/LaTeX/Source_Code_Listings#Encoding_issue
1277
1303
1278## Citation rendering {.options}
1304## Citation rendering {.options}
1279
1305
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+
1280`--bibliography=`*FILE*
1325`--bibliography=`*FILE*
1281
1326
1282: Set the `bibliography` field in the document's metadata to *FILE*,
1327: Set the `bibliography` field in the document's metadata to *FILE*,
1283− overriding any value set in the metadata, and process citations
1328+ overriding any value set in the metadata. If you supply
1284− using `pandoc-citeproc`. (This is equivalent to
1285− `--metadata bibliography=FILE --filter pandoc-citeproc`.)
1286− If `--natbib` or `--biblatex` is also supplied, `pandoc-citeproc` is not
1287− used, making this equivalent to `--metadata bibliography=FILE`.
1288− If you supply this argument multiple times, each *FILE* will be added
1329+ this argument multiple times, each *FILE* will be added to
1289− to bibliography.
1330+ bibliography. If *FILE* is a URL, it will be fetched
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`).
1290
1334
1291`--csl=`*FILE*
1335`--csl=`*FILE*
1292
1336
1293: Set the `csl` field in the document's metadata to *FILE*,
1337: Set the `csl` field in the document's metadata to *FILE*,
1294 overriding any value set in the metadata. (This is equivalent to
1338 overriding any value set in the metadata. (This is equivalent to
1295− `--metadata csl=FILE`.)
1339+ `--metadata csl=FILE`.) If *FILE* is a URL, it will be
1296− This option is only relevant with `pandoc-citeproc`.
1340+ fetched via HTTP. If *FILE* is not found relative to the
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.
1297
1344
1298`--citation-abbreviations=`*FILE*
1345`--citation-abbreviations=`*FILE*
1299
1346
1300: Set the `citation-abbreviations` field in the document's metadata to
1347: Set the `citation-abbreviations` field in the document's metadata to
1301 *FILE*, overriding any value set in the metadata. (This is equivalent to
1348 *FILE*, overriding any value set in the metadata. (This is equivalent to
1302 `--metadata citation-abbreviations=FILE`.)
1349 `--metadata citation-abbreviations=FILE`.)
1303− This option is only relevant with `pandoc-citeproc`.
1350+ If *FILE* is a URL, it will be fetched via HTTP. If *FILE* is not
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.
1304
1354
1305`--natbib`
1355`--natbib`
1306
1356
1307−: Use [`natbib`] for citations in LaTeX output. This option is not for use
1357+: Use [`natbib`] for citations in LaTeX output. This option
1308− with the `pandoc-citeproc` filter or with PDF output. It is intended for
1358+ is not for use with the `--citeproc` option or with PDF
1359+ output. It is intended for use in producing a LaTeX file
1309− use in producing a LaTeX file that can be processed with [`bibtex`].
1360+ that can be processed with [`bibtex`].
1310
1361
1311`--biblatex`
1362`--biblatex`
1312
1363
1313−: Use [`biblatex`] for citations in LaTeX output. This option is not for use
1364+: Use [`biblatex`] for citations in LaTeX output. This option
1314− with the `pandoc-citeproc` filter or with PDF output. It is intended for
1365+ is not for use with the `--citeproc` option or with PDF
1366+ output. It is intended for use in producing a LaTeX file
1315− use in producing a LaTeX file that can be processed with [`bibtex`] or [`biber`].
1367+ that can be processed with [`bibtex`] or [`biber`].
1316
1368
1317## Math rendering in HTML {.options}
1369## Math rendering in HTML {.options}
1318
1370
1319−The default is to render TeX math as far as possible using Unicode characters.
1371+The default is to render TeX math as far as possible using
1372+Unicode characters. Formulas are put inside a `span` with
1320−Formulas are put inside a `span` with `class="math"`, so that they may be styled
1373+`class="math"`, so that they may be styled differently from the
1321−differently from the surrounding text if needed. However, this gives acceptable
1374+surrounding text if needed. However, this gives acceptable
1322−results only for basic math, usually you will want to use `--mathjax` or another
1375+results only for basic math, usually you will want to use
1323−of the following options.
1376+`--mathjax` or another of the following options.
1324
1377
1325`--mathjax`[`=`*URL*]
1378`--mathjax`[`=`*URL*]
1326
1379
@@ -1334,10 +1387,11 @@ of the following options.
1334
1387
1335`--mathml`
1388`--mathml`
1336
1389
1337−: Convert TeX math to [MathML] (in `epub3`, `docbook4`, `docbook5`, `jats`,
1390+: Convert TeX math to [MathML] (in `epub3`, `docbook4`,
1391+ `docbook5`, `jats`, `html4` and `html5`). This is the
1338− `html4` and `html5`). This is the default in `odt` output. Note that
1392+ default in `odt` output. Note that currently only Firefox
1339− currently only Firefox and Safari (and select e-book readers) natively
1393+ and Safari (and select e-book readers) natively support
1340− support MathML.
1394+ MathML.
1341
1395
1342`--webtex`[`=`*URL*]
1396`--webtex`[`=`*URL*]
1343
1397
@@ -1361,18 +1415,17 @@ of the following options.
1361`--gladtex`
1415`--gladtex`
1362
1416
1363: Enclose TeX math in `<eq>` tags in HTML output. The resulting HTML
1417: Enclose TeX math in `<eq>` tags in HTML output. The resulting HTML
1364− can then be processed by [GladTeX] to produce images of the typeset
1418+ can then be processed by [GladTeX] to produce SVG images of the typeset
1365− formulas and an HTML file with links to these images.
1419+ formulas and an HTML file with these images embedded.
1366− So, the procedure is:
1367
1420
1368 pandoc -s --gladtex input.md -o myfile.htex
1421 pandoc -s --gladtex input.md -o myfile.htex
1369− gladtex -d myfile-images myfile.htex
1422+ gladtex -d image_dir myfile.htex
1370− # produces myfile.html and images in myfile-images
1423+ # produces myfile.html and images in image_dir
1371
1424
1372−[MathML]: http://www.w3.org/Math/
1425+[MathML]: https://www.w3.org/Math/
1373[MathJax]: https://www.mathjax.org
1426[MathJax]: https://www.mathjax.org
1374[KaTeX]: https://github.com/Khan/KaTeX
1427[KaTeX]: https://github.com/Khan/KaTeX
1375−[GladTeX]: http://humenda.github.io/GladTeX/
1428+[GladTeX]: https://humenda.github.io/GladTeX/
1376
1429
1377## Options for wrapper scripts {.options}
1430## Options for wrapper scripts {.options}
1378
1431
@@ -1412,8 +1465,10 @@ Nonzero exit codes have the following meanings:
1412 21 PandocUnknownReaderError
1465 21 PandocUnknownReaderError
1413 22 PandocUnknownWriterError
1466 22 PandocUnknownWriterError
1414 23 PandocUnsupportedExtensionError
1467 23 PandocUnsupportedExtensionError
1468+ 24 PandocCiteprocError
1415 31 PandocEpubSubdirectoryError
1469 31 PandocEpubSubdirectoryError
1416 43 PandocPDFError
1470 43 PandocPDFError
1471+ 44 PandocXMLError
1417 47 PandocPDFProgramNotFoundError
1472 47 PandocPDFProgramNotFoundError
1418 61 PandocHttpError
1473 61 PandocHttpError
1419 62 PandocShouldNeverHappenError
1474 62 PandocShouldNeverHappenError
@@ -1426,6 +1481,7 @@ Nonzero exit codes have the following meanings:
1426 91 PandocMacroLoop
1481 91 PandocMacroLoop
1427 92 PandocUTF8DecodingError
1482 92 PandocUTF8DecodingError
1428 93 PandocIpynbDecodingError
1483 93 PandocIpynbDecodingError
1484+ 94 PandocUnsupportedCharsetError
1429 97 PandocCouldNotFindDataFileError
1485 97 PandocCouldNotFindDataFileError
1430 99 PandocResourceNotFound
1486 99 PandocResourceNotFound
1431----- ------------------------------------
1487----- ------------------------------------
@@ -1450,6 +1506,16 @@ input-files:
1450- content.md
1506- content.md
1451# or you may use input-file: with a single value
1507# or you may use input-file: with a single value
1452
1508
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+
1453template: letter
1519template: letter
1454standalone: true
1520standalone: true
1455self-contained: false
1521self-contained: false
@@ -1477,11 +1543,24 @@ include-after-body: []
1477include-in-header: []
1543include-in-header: []
1478resource-path: ["."]
1544resource-path: ["."]
1479
1545
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+
1480−# filters will be assumed to be lua filters if they have
1557+# Filters will be assumed to be Lua filters if they have
1481# the .lua extension, and json filters otherwise. But
1558# the .lua extension, and json filters otherwise. But
1482−# the filter type can also be specified explicitly, as shown:
1559+# 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}`.
1483filters:
1563filters:
1484−- pandoc-citeproc
1485- wordcount.lua
1564- wordcount.lua
1486- type: json
1565- type: json
1487 path: foo.lua
1566 path: foo.lua
@@ -1494,8 +1573,11 @@ data-dir:
1494verbosity: INFO
1573verbosity: INFO
1495log-file: log.json
1574log-file: log.json
1496
1575
1497−# citeproc, natbib, or biblatex
1576+# citeproc, natbib, or biblatex. This only affects LaTeX
1577+# output. If you want to use citeproc to format citations,
1578+# you should also set 'citeproc: true' (see above).
1498cite-method: citeproc
1579cite-method: citeproc
1580+
1499# part, chapter, section, or default:
1581# part, chapter, section, or default:
1500top-level-division: chapter
1582top-level-division: chapter
1501abbreviations:
1583abbreviations:
@@ -1564,7 +1646,7 @@ epub-cover-image: cover.jpg
1564reference-links: true
1646reference-links: true
1565# block, section, or document
1647# block, section, or document
1566reference-location: block
1648reference-location: block
1567−atx-headers: false
1649+markdown-headings: setext
1568
1650
1569# accept, reject, or all
1651# accept, reject, or all
1570track-changes: accept
1652track-changes: accept
@@ -1594,6 +1676,34 @@ one line:
1594verbosity: INFO
1676verbosity: INFO
1595```
1677```
1596
1678
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+
1597Default files can be placed in the `defaults` subdirectory of
1707Default files can be placed in the `defaults` subdirectory of
1598the user data directory and used from any directory. For
1708the user data directory and used from any directory. For
1599example, one could create a file specifying defaults for writing
1709example, one could create a file specifying defaults for writing
@@ -1803,17 +1913,26 @@ ${ endfor }
1803### Partials
1913### Partials
1804
1914
1805Partials (subtemplates stored in different files) may be
1915Partials (subtemplates stored in different files) may be
1806−included using the syntax
1916+included by using the name of the partial, followed
1917+by `()`, for example:
1807
1918
1808```
1919```
1809−${ boilerplate() }
1920+${ styles() }
1810```
1921```
1811
1922
1812Partials will be sought in the directory containing
1923Partials will be sought in the directory containing
1813−the main template, and will be assumed to have the
1924+the main template. The file name will be assumed to
1814−same extension as the main template if they lack
1925+have the same extension as the main template if it
1815−an explicit extension. (If the partials are not
1926+lacks an extension. When calling the partial, the
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
1816−found here, they will also be sought in the `templates`
1935+path, it will also be sought in the `templates`
1817subdirectory of the user data directory.)
1936subdirectory of the user data directory.)
1818
1937
1819Partials may optionally be applied to variables using
1938Partials may optionally be applied to variables using
@@ -1962,6 +2081,22 @@ Currently the following pipes are predefined:
1962- `reverse`: Reverses a textual value or array,
2081- `reverse`: Reverses a textual value or array,
1963 and has no effect on other values.
2082 and has no effect on other values.
1964
2083
2084+- `first`: Returns the first value of an array, if
2085+ applied to a non-empty array; otherwise returns
2086+ the original value.
2087+
2088+- `last`: Returns the last value of an array, if
2089+ applied to a non-empty array; otherwise returns
2090+ the original value.
2091+
2092+- `rest`: Returns all but the first value of an array, if
2093+ applied to a non-empty array; otherwise returns
2094+ the original value.
2095+
2096+- `allbutlast`: Returns all but the last value of an array, if
2097+ applied to a non-empty array; otherwise returns
2098+ the original value.
2099+
1965- `chomp`: Removes trailing newlines (and breakable space).
2100- `chomp`: Removes trailing newlines (and breakable space).
1966
2101
1967- `nowrap`: Disables line wrapping on breakable spaces.
2102- `nowrap`: Disables line wrapping on breakable spaces.
@@ -2015,7 +2150,8 @@ Currently the following pipes are predefined:
2015 including a title block in the document itself, you can
2150 including a title block in the document itself, you can
2016 set the `title-meta`, `author-meta`, and `date-meta`
2151 set the `title-meta`, `author-meta`, and `date-meta`
2017 variables. (By default these are set automatically, based
2152 variables. (By default these are set automatically, based
2018− on `title`, `author`, and `date`.)
2153+ on `title`, `author`, and `date`.) The page title in HTML
2154+ is set by `pagetitle`, which is equal to `title` by default.
2019
2155
2020`subtitle`
2156`subtitle`
2021: document subtitle, included in HTML, EPUB, LaTeX, ConTeXt, and docx
2157: document subtitle, included in HTML, EPUB, LaTeX, ConTeXt, and docx
@@ -2089,35 +2225,101 @@ ODT or pptx.
2089: the base script direction, either `rtl` (right-to-left)
2225: the base script direction, either `rtl` (right-to-left)
2090 or `ltr` (left-to-right).
2226 or `ltr` (left-to-right).
2091
2227
2092− For bidirectional documents, native pandoc `span`s and `div`s
2228+ For bidirectional documents, native pandoc `span`s and
2093− with the `dir` attribute (value `rtl` or `ltr`) can be used to
2229+ `div`s with the `dir` attribute (value `rtl` or `ltr`) can
2094− override the base direction in some output formats.
2230+ be used to override the base direction in some output
2095− This may not always be necessary if the final renderer
2231+ formats. This may not always be necessary if the final
2096− (e.g. the browser, when generating HTML) supports the
2232+ renderer (e.g. the browser, when generating HTML) supports
2097− [Unicode Bidirectional Algorithm].
2233+ the [Unicode Bidirectional Algorithm].
2098
2234
2099− When using LaTeX for bidirectional documents, only the `xelatex` engine
2235+ When using LaTeX for bidirectional documents, only the
2236+ `xelatex` engine is fully supported (use
2100− is fully supported (use `--pdf-engine=xelatex`).
2237+ `--pdf-engine=xelatex`).
2101
2238
2102[BCP 47]: https://tools.ietf.org/html/bcp47
2239[BCP 47]: https://tools.ietf.org/html/bcp47
2103−[Unicode Bidirectional Algorithm]: http://www.w3.org/International/articles/inline-bidi-markup/uba-basics
2240+[Unicode Bidirectional Algorithm]: https://www.w3.org/International/articles/inline-bidi-markup/uba-basics
2104[Language subtag lookup]: https://r12a.github.io/app-subtags/
2241[Language subtag lookup]: https://r12a.github.io/app-subtags/
2105
2242
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+
2106### Variables for HTML math
2306### Variables for HTML math
2107
2307
2108`classoption`
2308`classoption`
2109−: when using [KaTeX](#option--katex), you can render display math equations
2309+: when using [KaTeX](#option--katex), you can render display
2110− flush left using [YAML metadata](#layout) or with `-M classoption=fleqn`.
2310+math equations flush left using [YAML metadata](#layout) or with
2311+`-M classoption=fleqn`.
2111
2312
2112### Variables for HTML slides
2313### Variables for HTML slides
2113
2314
2114These affect HTML output when [producing slide shows with pandoc].
2315These affect HTML output when [producing slide shows with pandoc].
2115
2316
2116−All [reveal.js configuration options] are available as variables.
2317+`institute`
2117−To turn off boolean flags that default to true in reveal.js, use `0`.
2318+: author affiliations: can be a list when there are multiple authors
2118
2319
2119`revealjs-url`
2320`revealjs-url`
2120−: base URL for reveal.js documents (defaults to `reveal.js`)
2321+: base URL for reveal.js documents (defaults to
2322+ `https://unpkg.com/reveal.js@^4/`)
2121
2323
2122`s5-url`
2324`s5-url`
2123: base URL for S5 documents (defaults to `s5/default`)
2325: base URL for S5 documents (defaults to `s5/default`)
@@ -2133,7 +2335,10 @@ To turn off boolean flags that default to true in reveal.js, use `0`.
2133: additional attributes for the title slide of reveal.js slide shows.
2335: additional attributes for the title slide of reveal.js slide shows.
2134 See [background in reveal.js and beamer] for an example.
2336 See [background in reveal.js and beamer] for an example.
2135
2337
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+
2136−[reveal.js configuration options]: https://github.com/hakimel/reveal.js#configuration
2341+[reveal.js configuration options]: https://revealjs.com/config/
2137
2342
2138### Variables for Beamer slides
2343### Variables for Beamer slides
2139
2344
@@ -2218,9 +2423,10 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
2218 ...
2423 ...
2219
2424
2220`documentclass`
2425`documentclass`
2221−: document class: usually one of the standard classes, [`article`], [`book`],
2426+: document class: usually one of the standard classes,
2427+ [`article`], [`book`], and [`report`]; the [KOMA-Script]
2222− and [`report`]; the [KOMA-Script] equivalents, `scrartcl`, `scrbook`,
2428+ equivalents, `scrartcl`, `scrbook`, and `scrreprt`, which
2223− and `scrreprt`, which default to smaller margins; or [`memoir`]
2429+ default to smaller margins; or [`memoir`]
2224
2430
2225`geometry`
2431`geometry`
2226: option for [`geometry`] package, e.g. `margin=1in`;
2432: option for [`geometry`] package, e.g. `margin=1in`;
@@ -2245,8 +2451,9 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
2245 ...
2451 ...
2246
2452
2247`indent`
2453`indent`
2454+: if true, pandoc will use document class settings for
2248−: uses document class settings for indentation (the default LaTeX template
2455+ indentation (the default LaTeX template otherwise removes
2249− otherwise removes indentation and adds space between paragraphs)
2456+ indentation and adds space between paragraphs)
2250
2457
2251`linestretch`
2458`linestretch`
2252: adjusts line spacing using the [`setspace`]
2459: adjusts line spacing using the [`setspace`]
@@ -2271,8 +2478,8 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
2271#### Fonts
2478#### Fonts
2272
2479
2273`fontenc`
2480`fontenc`
2274−: allows font encoding to be specified through `fontenc` package (with `pdflatex`);
2481+: allows font encoding to be specified through `fontenc` package (with
2275− default is `T1` (see [LaTeX font encodings guide])
2482+ `pdflatex`); default is `T1` (see [LaTeX font encodings guide])
2276
2483
2277`fontfamily`
2484`fontfamily`
2278: font package for use with `pdflatex`:
2485: font package for use with `pdflatex`:
@@ -2342,7 +2549,8 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
2342: contents of acknowledgments footnote after document title
2549: contents of acknowledgments footnote after document title
2343
2550
2344`toc`
2551`toc`
2345−: include table of contents (can also be set using `--toc/--table-of-contents`)
2552+: include table of contents (can also be set using
2553+ `--toc/--table-of-contents`)
2346
2554
2347`toc-depth`
2555`toc-depth`
2348: level of section to include in table of contents
2556: level of section to include in table of contents
@@ -2367,7 +2575,7 @@ These variables function when using BibLaTeX for [citation rendering].
2367: list of options for natbib
2575: list of options for natbib
2368
2576
2369[KOMA-Script]: https://ctan.org/pkg/koma-script
2577[KOMA-Script]: https://ctan.org/pkg/koma-script
2370−[LaTeX Font Catalogue]: http://www.tug.dk/FontCatalogue/
2578+[LaTeX Font Catalogue]: https://tug.org/FontCatalogue/
2371[LaTeX font encodings guide]: https://ctan.org/pkg/encguide
2579[LaTeX font encodings guide]: https://ctan.org/pkg/encguide
2372[TeX Gyre]: http://www.gust.org.pl/projects/e-foundry/tex-gyre
2580[TeX Gyre]: http://www.gust.org.pl/projects/e-foundry/tex-gyre
2373[`article`]: https://ctan.org/pkg/article
2581[`article`]: https://ctan.org/pkg/article
@@ -2384,12 +2592,12 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
2384: font size for body text (e.g. `10pt`, `12pt`)
2592: font size for body text (e.g. `10pt`, `12pt`)
2385
2593
2386`headertext`, `footertext`
2594`headertext`, `footertext`
2387−: text to be placed in running header or footer (see [ConTeXt Headers and Footers]);
2595+: text to be placed in running header or footer (see [ConTeXt Headers and
2388− repeat up to four times for different placement
2596+ Footers]); repeat up to four times for different placement
2389
2597
2390`indenting`
2598`indenting`
2391−: controls indentation of paragraphs, e.g. `yes,small,next` (see [ConTeXt Indentation]);
2599+: controls indentation of paragraphs, e.g. `yes,small,next` (see
2392− repeat for multiple options
2600+ [ConTeXt Indentation]); repeat for multiple options
2393
2601
2394`interlinespace`
2602`interlinespace`
2395: adjusts line spacing, e.g. `4ex` (using [`setupinterlinespace`]);
2603: adjusts line spacing, e.g. `4ex` (using [`setupinterlinespace`]);
@@ -2400,16 +2608,19 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
2400 repeat for multiple options
2608 repeat for multiple options
2401
2609
2402`linkcolor`, `contrastcolor`
2610`linkcolor`, `contrastcolor`
2403−: color for links outside and inside a page, e.g. `red`, `blue` (see [ConTeXt Color])
2611+: color for links outside and inside a page, e.g. `red`, `blue` (see
2612+ [ConTeXt Color])
2404
2613
2405`linkstyle`
2614`linkstyle`
2406−: typeface style for links, e.g. `normal`, `bold`, `slanted`, `boldslanted`, `type`, `cap`, `small`
2615+: typeface style for links, e.g. `normal`, `bold`, `slanted`, `boldslanted`,
2616+ `type`, `cap`, `small`
2407
2617
2408`lof`, `lot`
2618`lof`, `lot`
2409: include list of figures, list of tables
2619: include list of figures, list of tables
2410
2620
2411`mainfont`, `sansfont`, `monofont`, `mathfont`
2621`mainfont`, `sansfont`, `monofont`, `mathfont`
2412−: font families: take the name of any system font (see [ConTeXt Font Switching])
2622+: font families: take the name of any system font (see
2623+ [ConTeXt Font Switching])
2413
2624
2414`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
2625`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
2415: sets margins, if `layout` is not used (otherwise `layout`
2626: sets margins, if `layout` is not used (otherwise `layout`
@@ -2424,16 +2635,18 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
2424 repeat for multiple options
2635 repeat for multiple options
2425
2636
2426`pdfa`
2637`pdfa`
2427−: adds to the preamble the setup necessary to generate PDF/A of the type
2638+: adds to the preamble the setup necessary to generate PDF/A
2428− specified, e.g. `1a:2005`, `2a`. If no type is specified (i.e. the value
2639+ of the type specified, e.g. `1a:2005`, `2a`. If no type is
2640+ specified (i.e. the value is set to True, by e.g.
2429− is set to True, by e.g. `--metadata=pdfa` or `pdfa: true` in a YAML metadata
2641+ `--metadata=pdfa` or `pdfa: true` in a YAML metadata block),
2430− block), `1b:2005` will be used as default, for reasons of backwards
2642+ `1b:2005` will be used as default, for reasons of backwards
2431− compatibility. Using `--variable=pdfa` without specified value is not supported.
2643+ compatibility. Using `--variable=pdfa` without specified value
2432− To successfully generate PDF/A the required ICC color profiles have to
2644+ is not supported. To successfully generate PDF/A the required
2433− be available and the content and all included files (such as images)
2645+ ICC color profiles have to be available and the content and all
2646+ included files (such as images) have to be standard conforming.
2434− have to be standard conforming. The ICC profiles and output intent
2647+ The ICC profiles and output intent may be specified using the
2435− may be specified using the variables `pdfaiccprofile` and `pdfaintent`.
2648+ variables `pdfaiccprofile` and `pdfaintent`. See also [ConTeXt
2436− See also [ConTeXt PDFA] for more details.
2649+ PDFA] for more details.
2437
2650
2438`pdfaiccprofile`
2651`pdfaiccprofile`
2439: when used in conjunction with `pdfa`, specifies the ICC profile to use
2652: when used in conjunction with `pdfa`, specifies the ICC profile to use
@@ -2448,10 +2661,12 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
2448 If left unspecified, `sRGB IEC61966-2.1` is used as default.
2661 If left unspecified, `sRGB IEC61966-2.1` is used as default.
2449
2662
2450`toc`
2663`toc`
2451−: include table of contents (can also be set using `--toc/--table-of-contents`)
2664+: include table of contents (can also be set using
2665+ `--toc/--table-of-contents`)
2452
2666
2453`whitespace`
2667`whitespace`
2454−: spacing between paragraphs, e.g. `none`, `small` (using [`setupwhitespace`])
2668+: spacing between paragraphs, e.g. `none`, `small` (using
2669+ [`setupwhitespace`])
2455
2670
2456`includesource`
2671`includesource`
2457: include all source documents as file attachments in the PDF file
2672: include all source documents as file attachments in the PDF file
@@ -2730,53 +2945,43 @@ reading web pages formatted using MathJax, for example.
2730
2945
2731## Raw HTML/TeX
2946## Raw HTML/TeX
2732
2947
2733−The following extensions (especially how they affect Markdown
2734−input/output) are also described in more detail in their respective
2948+The following extensions are described in more detail in
2735−sections of [Pandoc's Markdown].
2949+their respective sections of [Pandoc's Markdown]:
2736−
2737−#### Extension: `raw_html` {#raw_html}
2738−
2739−When converting from HTML, parse elements to raw HTML which are not
2740−representable in pandoc's AST.
2741−By default, this is disabled for HTML input.
2742−
2743−#### Extension: `raw_tex` {#raw_tex}
2744
2950
2745−Allows raw LaTeX, TeX, and ConTeXt to be included in a document.
2951+- [`raw_html`](#extension-raw_html) allows HTML elements which
2952+ are not representable in pandoc's AST to be parsed as raw HTML.
2953+ By default, this is disabled for HTML input.
2746
2954
2955+- [`raw_tex`](#extension-raw_tex) allows raw LaTeX, TeX, and ConTeXt
2747−This extension can be enabled/disabled for the following formats
2956+ to be included in a document. This extension can be enabled/disabled
2748−(in addition to `markdown`):
2957+ for the following formats (in addition to `markdown`):
2749
2958
2750−input formats
2959+ input formats
2751−: `latex`, `org`, `textile`, `html` (environments, `\ref`, and
2960+ : `latex`, `textile`, `html` (environments, `\ref`, and
2752− `\eqref` only), `ipynb`
2961+ `\eqref` only), `ipynb`
2753−
2754−output formats
2755−: `textile`, `commonmark`
2756−
2757−Note: as applied to `ipynb`, `raw_html` and `raw_tex` affect not
2758−only raw TeX in markdown cells, but data with mime type
2759−`text/html` in output cells. Since the `ipynb` reader attempts
2760−to preserve the richest possible outputs when several options
2761−are given, you will get best results if you disable `raw_html`
2762−and `raw_tex` when converting to formats like `docx` which don't
2763−allow raw `html` or `tex`.
2764−
2765−#### Extension: `native_divs` {#native_divs}
2766−
2767−This extension is enabled by default for HTML input. This means that
2768−`div`s are parsed to pandoc native elements. (Alternatively, you
2769−can parse them to raw HTML using `-f html-native_divs+raw_html`.)
2770−
2771−When converting HTML to Markdown, for example, you may want to drop all
2772−`div`s and `span`s:
2773
2962
2774− pandoc -f html-native_divs-native_spans -t markdown
2963+ output formats
2964+ : `textile`, `commonmark`
2775
2965
2776−#### Extension: `native_spans` {#native_spans}
2966+ Note: as applied to `ipynb`, `raw_html` and `raw_tex` affect not
2967+ only raw TeX in markdown cells, but data with mime type
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`.
2777
2973
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
2778−Analogous to `native_divs` above.
2977+ `-f html-native_divs+raw_html`.
2779
2978
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`.
2780
2985
2781## Literate Haskell support
2986## Literate Haskell support
2782
2987
@@ -2864,6 +3069,43 @@ This extension can be enabled/disabled for the following formats:
2864output formats
3069output formats
2865: `odt`, `opendocument`
3070: `odt`, `opendocument`
2866
3071
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+
2867#### Extension: `styles` #### {#ext-styles}
3109#### Extension: `styles` #### {#ext-styles}
2868
3110
2869When converting from docx, read all docx styles as divs (for
3111When converting from docx, read all docx styles as divs (for
@@ -2880,16 +3122,31 @@ input formats
2880In the `muse` input format, this enables Text::Amuse
3122In the `muse` input format, this enables Text::Amuse
2881extensions to Emacs Muse markup.
3123extensions to Emacs Muse markup.
2882
3124
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+
2883#### Extension: `citations` {#org-citations}
3133#### Extension: `citations` {#org-citations}
2884
3134
2885−Some aspects of [Pandoc's Markdown citation syntax](#citations) are also accepted
3135+Some aspects of [Pandoc's Markdown citation syntax](#citations)
2886−in `org` input.
3136+are also accepted 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.
2887
3144
2888#### Extension: `ntb` ####
3145#### Extension: `ntb` ####
2889
3146
2890In the `context` output format this enables the use of [Natural Tables
3147In the `context` output format this enables the use of [Natural Tables
2891−(TABLE)](http://wiki.contextgarden.net/TABLE) instead of the default
3148+(TABLE)](https://wiki.contextgarden.net/TABLE) instead of the default
2892−[Extreme Tables (xtables)](http://wiki.contextgarden.net/xtables).
3149+[Extreme Tables (xtables)](https://wiki.contextgarden.net/xtables).
2893Natural tables allow more fine-grained global customization but come
3150Natural tables allow more fine-grained global customization but come
2894at a performance penalty compared to extreme tables.
3151at a performance penalty compared to extreme tables.
2895
3152
@@ -2912,7 +3169,7 @@ easy to read:
2912> A Markdown-formatted document should be publishable as-is, as plain
3169> A Markdown-formatted document should be publishable as-is, as plain
2913> text, without looking like it's been marked up with tags or formatting
3170> text, without looking like it's been marked up with tags or formatting
2914> instructions.
3171> instructions.
2915−> -- [John Gruber](http://daringfireball.net/projects/markdown/syntax#philosophy)
3172+> -- [John Gruber](https://daringfireball.net/projects/markdown/syntax#philosophy)
2916
3173
2917This principle has guided pandoc's decisions in finding syntax for
3174This principle has guided pandoc's decisions in finding syntax for
2918tables, footnotes, and other extensions.
3175tables, footnotes, and other extensions.
@@ -2991,7 +3248,8 @@ pandoc does require the space.
2991
3248
2992### Heading identifiers ###
3249### Heading identifiers ###
2993
3250
3251+See also the [`auto_identifiers`
2994−See also the [`auto_identifiers` extension](#extension-auto_identifiers) above.
3252+extension](#extension-auto_identifiers) above.
2995
3253
2996#### Extension: `header_attributes` ####
3254#### Extension: `header_attributes` ####
2997
3255
@@ -3113,11 +3371,12 @@ block in a block quote, you need five spaces after the `>`:
3113
3371
3114#### Extension: `blank_before_blockquote` ####
3372#### Extension: `blank_before_blockquote` ####
3115
3373
3116−Standard Markdown syntax does not require a blank line before a block
3374+Standard Markdown syntax does not require a blank line before a
3117−quote. Pandoc does require this (except, of course, at the beginning of the
3375+block quote. Pandoc does require this (except, of course, at
3118−document). The reason for the requirement is that it is all too easy for a
3376+the beginning of the document). The reason for the requirement
3377+is that it is all too easy for a `>` to end up at the beginning
3119−`>` to end up at the beginning of a line by accident (perhaps through line
3378+of a line by accident (perhaps through line wrapping). So,
3120−wrapping). So, unless the `markdown_strict` format is used, the following does
3379+unless the `markdown_strict` format is used, the following does
3121not produce a nested block quote in pandoc:
3380not produce a nested block quote in pandoc:
3122
3381
3123 > This is a block quote.
3382 > This is a block quote.
@@ -3186,14 +3445,16 @@ this syntax:
3186 qsort (filter (>= x) xs)
3445 qsort (filter (>= x) xs)
3187 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3446 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3188
3447
3189−Here `mycode` is an identifier, `haskell` and `numberLines` are classes, and
3448+Here `mycode` is an identifier, `haskell` and `numberLines` are
3190−`startFrom` is an attribute with value `100`. Some output formats can use this
3449+classes, and `startFrom` is an attribute with value `100`. Some
3450+output formats can use this information to do syntax
3191−information to do syntax highlighting. Currently, the only output formats
3451+highlighting. Currently, the only output formats that uses this
3192−that uses this information are HTML, LaTeX, Docx, Ms, and PowerPoint. If
3452+information are HTML, LaTeX, Docx, Ms, and PowerPoint. If
3193−highlighting is supported for your output format and language, then the code
3453+highlighting is supported for your output format and language,
3194−block above will appear highlighted, with numbered lines. (To see which
3454+then the code block above will appear highlighted, with numbered
3195−languages are supported, type `pandoc --list-highlight-languages`.) Otherwise,
3455+lines. (To see which languages are supported, type `pandoc
3456+--list-highlight-languages`.) Otherwise, the code block above
3196−the code block above will appear as follows:
3457+will appear as follows:
3197
3458
3198 <pre id="mycode" class="haskell numberLines" startFrom="100">
3459 <pre id="mycode" class="haskell numberLines" startFrom="100">
3199 <code>
3460 <code>
@@ -3256,6 +3517,9 @@ line must begin with a space.
3256 | 200 Main St.
3517 | 200 Main St.
3257 | Berkeley, CA 94718
3518 | Berkeley, CA 94718
3258
3519
3520+Inline formatting (such as emphasis) is allowed in the content,
3521+but not block-level formatting (such as block quotes or lists).
3522+
3259This syntax is borrowed from [reStructuredText].
3523This syntax is borrowed from [reStructuredText].
3260
3524
3261## Lists
3525## Lists
@@ -3459,11 +3723,12 @@ a blank line, and must be followed by one or more definitions.
3459A definition begins with a colon or tilde, which may be indented one
3723A definition begins with a colon or tilde, which may be indented one
3460or two spaces.
3724or two spaces.
3461
3725
3462−A term may have multiple definitions, and each definition may consist of one or
3726+A term may have multiple definitions, and each definition may
3463−more block elements (paragraph, code block, list, etc.), each indented four
3727+consist of one or more block elements (paragraph, code block,
3728+list, etc.), each indented four spaces or one tab stop. The
3464−spaces or one tab stop. The body of the definition (including the first line,
3729+body of the definition (including the first line, aside from the
3465−aside from the colon or tilde) should be indented four spaces. However,
3730+colon or tilde) should be indented four spaces. However, as with
3466−as with other Markdown lists, you can "lazily" omit indentation except
3731+other Markdown lists, you can "lazily" omit indentation except
3467at the beginning of a paragraph or other block element:
3732at the beginning of a paragraph or other block element:
3468
3733
3469 Term 1
3734 Term 1
@@ -3489,9 +3754,10 @@ definition:
3489Note that space between items in a definition list is required.
3754Note that space between items in a definition list is required.
3490(A variant that loosens this requirement, but disallows "lazy"
3755(A variant that loosens this requirement, but disallows "lazy"
3491hard wrapping, can be activated with `compact_definition_lists`: see
3756hard wrapping, can be activated with `compact_definition_lists`: see
3492−[Non-pandoc extensions], below.)
3757+[Non-default extensions], below.)
3493
3758
3494−[^3]: I have been influenced by the suggestions of [David Wheeler](http://www.justatheory.com/computers/markup/modest-markdown-proposal.html).
3759+[^3]: I have been influenced by the suggestions of [David
3760+ Wheeler](https://justatheory.com/2009/02/modest-markdown-proposal/).
3495
3761
3496### Numbered example lists ###
3762### Numbered example lists ###
3497
3763
@@ -3527,30 +3793,6 @@ list marker. That is, example lists always behave as if the
3527labels tend to be long, and indenting content to the
3793labels tend to be long, and indenting content to the
3528first non-space character after the label would be awkward.
3794first non-space character after the label would be awkward.
3529
3795
3530−### Compact and loose lists ###
3531−
3532−Pandoc behaves differently from `Markdown.pl` on some "edge
3533−cases" involving lists. Consider this source:
3534−
3535− + First
3536− + Second:
3537− - Fee
3538− - Fie
3539− - Foe
3540−
3541− + Third
3542−
3543−Pandoc transforms this into a "compact list" (with no `<p>` tags around
3544−"First", "Second", or "Third"), while Markdown puts `<p>` tags around
3545−"Second" and "Third" (but not "First"), because of the blank space
3546−around "Third". Pandoc follows a simple rule: if the text is followed by
3547−a blank line, it is treated as a paragraph. Since "Second" is followed
3548−by a list, and not a blank line, it isn't treated as a paragraph. The
3549−fact that the list is followed by a blank line is irrelevant. (Note:
3550−Pandoc works this way even when the `markdown_strict` format is specified. This
3551−behavior is consistent with the official Markdown syntax description,
3552−even though it is different from that of `Markdown.pl`.)
3553−
3554
3796
3555### Ending a list ###
3797### Ending a list ###
3556
3798
@@ -3755,7 +3997,7 @@ and the same number of rows in each column. For example, the
3755Docutils [sample grid tables] will not render as expected with
3997Docutils [sample grid tables] will not render as expected with
3756Pandoc.
3998Pandoc.
3757
3999
3758−[sample grid tables]: http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables
4000+[sample grid tables]: https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#grid-tables
3759
4001
3760
4002
3761#### Extension: `pipe_tables` ####
4003#### Extension: `pipe_tables` ####
@@ -3788,7 +4030,7 @@ legal (though ugly) pipe table:
3788
4030
3789The cells of pipe tables cannot contain block elements like paragraphs
4031The cells of pipe tables cannot contain block elements like paragraphs
3790and lists, and cannot span multiple lines. If a pipe table contains a
4032and lists, and cannot span multiple lines. If a pipe table contains a
3791−row whose printable content is wider than the column width (see
4033+row whose Markdown content is wider than the column width (see
3792`--columns`), then the table will take up the full text width and
4034`--columns`), then the table will take up the full text width and
3793the cell contents will wrap, with the relative cell widths determined
4035the cell contents will wrap, with the relative cell widths determined
3794by the number of dashes in the line separating the table header from
4036by the number of dashes in the line separating the table header from
@@ -3828,30 +4070,42 @@ output.) The block may contain just a title, a title and an author,
3828or all three elements. If you want to include an author but no
4070or all three elements. If you want to include an author but no
3829title, or a title and a date but no author, you need a blank line:
4071title, or a title and a date but no author, you need a blank line:
3830
4072
4073+```
3831− %
4074+%
3832− % Author
4075+% Author
4076+```
3833
4077
4078+```
3834− % My title
4079+% My title
3835− %
4080+%
3836− % June 15, 2006
4081+% June 15, 2006
4082+```
3837
4083
3838The title may occupy multiple lines, but continuation lines must
4084The title may occupy multiple lines, but continuation lines must
3839begin with leading space, thus:
4085begin with leading space, thus:
3840
4086
4087+```
3841− % My title
4088+% My title
3842− on multiple lines
4089+ on multiple lines
4090+```
3843
4091
3844If a document has multiple authors, the authors may be put on
4092If a document has multiple authors, the authors may be put on
3845separate lines with leading space, or separated by semicolons, or
4093separate lines with leading space, or separated by semicolons, or
3846both. So, all of the following are equivalent:
4094both. So, all of the following are equivalent:
3847
4095
4096+```
3848− % Author One
4097+% Author One
3849− Author Two
4098+ Author Two
4099+```
3850
4100
4101+```
3851− % Author One; Author Two
4102+% Author One; Author Two
4103+```
3852
4104
4105+```
3853− % Author One;
4106+% Author One;
3854− Author Two
4107+ Author Two
4108+```
3855
4109
3856The date must fit on one line.
4110The date must fit on one line.
3857
4111
@@ -3925,10 +4179,12 @@ option is used. All of the metadata will appear in a single block
3925at the beginning of the document.
4179at the beginning of the document.
3926
4180
3927Note that [YAML] escaping rules must be followed. Thus, for example,
4181Note that [YAML] escaping rules must be followed. Thus, for example,
3928−if a title contains a colon, it must be quoted. The pipe character
4182+if a title contains a colon, it must be quoted, and if it contains a
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
3929−(`|`) can be used to begin an indented block that will be interpreted
4185+an indented block that will be interpreted literally, without need for
3930−literally, without need for escaping. This form is necessary
4186+escaping. This form is necessary when the field contains blank lines
3931−when the field contains blank lines or block-level formatting:
4187+or block-level formatting:
3932
4188
3933 ---
4189 ---
3934 title: 'This is the title: it contains a colon'
4190 title: 'This is the title: it contains a colon'
@@ -3942,6 +4198,12 @@ when the field contains blank lines or block-level formatting:
3942 It consists of two paragraphs.
4198 It consists of two paragraphs.
3943 ...
4199 ...
3944
4200
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+
3945Template variables will be set automatically from the metadata. Thus, for
4207Template variables will be set automatically from the metadata. Thus, for
3946example, in writing HTML, the variable `abstract` will be set to the HTML
4208example, in writing HTML, the variable `abstract` will be set to the HTML
3947equivalent of the Markdown in the `abstract` field:
4209equivalent of the Markdown in the `abstract` field:
@@ -3988,6 +4250,24 @@ will be interpreted as markdown. For example:
3988 \renewcommand{\section}[1]{\clearpage\oldsection{#1}}
4250 \renewcommand{\section}[1]{\clearpage\oldsection{#1}}
3989 ```
4251 ```
3990
4252
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+
3991## Backslash escapes
4271## Backslash escapes
3992
4272
3993#### Extension: `all_symbols_escapable` ####
4273#### Extension: `all_symbols_escapable` ####
@@ -4014,9 +4294,12 @@ which allows only the following characters to be backslash-escaped:
4014(However, if the `markdown_strict` format is used, the standard Markdown rule
4294(However, if the `markdown_strict` format is used, the standard Markdown rule
4015will be used.)
4295will be used.)
4016
4296
4017−A backslash-escaped space is parsed as a nonbreaking space. It will
4297+A backslash-escaped space is parsed as a nonbreaking space. In TeX output,
4018−appear in TeX output as `~` and in HTML and XML as `\&#160;` or
4298+it will appear as `~`. In HTML and XML output, it will appear as a
4019−`\&nbsp;`.
4299+literal unicode nonbreaking space character (note that it will thus
4300+actually look "invisible" in the generated HTML source; you can still
4301+use the `--ascii` command-line option to make it appear as an explicit
4302+entity).
4020
4303
4021A backslash-escaped newline (i.e. a backslash occurring at the end of
4304A backslash-escaped newline (i.e. a backslash occurring at the end of
4022a line) is parsed as a hard line break. It will appear in TeX output as
4305a line) is parsed as a hard line break. It will appear in TeX output as
@@ -4142,7 +4425,8 @@ you need to enclose text in literal `$` characters, backslash-escape
4142them and they won't be treated as math delimiters.
4425them and they won't be treated as math delimiters.
4143
4426
4144For display math, use `$$` delimiters. (In this case, the delimiters
4427For display math, use `$$` delimiters. (In this case, the delimiters
4145−may be separated from the formula by whitespace.)
4428+may be separated from the formula by whitespace. However, there can be
4429+no blank lines betwen the opening and closing `$$` delimiters.)
4146
4430
4147TeX math will be printed in all output formats. How it is rendered
4431TeX math will be printed in all output formats. How it is rendered
4148depends on the output format:
4432depends on the output format:
@@ -4205,7 +4489,7 @@ HTML, Slidy, DZSlides, S5, EPUB
4205 command-line options selected. Therefore see [Math rendering in HTML]
4489 command-line options selected. Therefore see [Math rendering in HTML]
4206 above.
4490 above.
4207
4491
4208−[interpreted text role `:math:`]: http://docutils.sourceforge.net/docs/ref/rst/roles.html#math
4492+[interpreted text role `:math:`]: https://docutils.sourceforge.io/docs/ref/rst/roles.html#math
4209
4493
4210## Raw HTML
4494## Raw HTML
4211
4495
@@ -4245,7 +4529,7 @@ Thus, for example, pandoc will turn
4245 <table>
4529 <table>
4246 <tr>
4530 <tr>
4247 <td>*one*</td>
4531 <td>*one*</td>
4248− <td>[a link](http://google.com)</td>
4532+ <td>[a link](https://google.com)</td>
4249 </tr>
4533 </tr>
4250 </table>
4534 </table>
4251
4535
@@ -4254,14 +4538,14 @@ into
4254 <table>
4538 <table>
4255 <tr>
4539 <tr>
4256 <td><em>one</em></td>
4540 <td><em>one</em></td>
4257− <td><a href="http://google.com">a link</a></td>
4541+ <td><a href="https://google.com">a link</a></td>
4258 </tr>
4542 </tr>
4259 </table>
4543 </table>
4260
4544
4261whereas `Markdown.pl` will preserve it as is.
4545whereas `Markdown.pl` will preserve it as is.
4262
4546
4263−There is one exception to this rule: text between `<script>` and
4547+There is one exception to this rule: text between `<script>`,
4264−`<style>` tags is not interpreted as Markdown.
4548+`<style>`, and `<textarea>` tags is not interpreted as Markdown.
4265
4549
4266This departure from standard Markdown should make it easier to mix
4550This departure from standard Markdown should make it easier to mix
4267Markdown with HTML block elements. For example, one can surround
4551Markdown with HTML block elements. For example, one can surround
@@ -4389,7 +4673,7 @@ Markdown allows links to be specified in several ways.
4389If you enclose a URL or email address in pointy brackets, it
4673If you enclose a URL or email address in pointy brackets, it
4390will become a link:
4674will become a link:
4391
4675
4392− <http://google.com>
4676+ <https://google.com>
4393 <sam@green.eggs.ham>
4677 <sam@green.eggs.ham>
4394
4678
4395### Inline links ###
4679### Inline links ###
@@ -4399,7 +4683,7 @@ followed by the URL in parentheses. (Optionally, the URL can
4399be followed by a link title, in quotes.)
4683be followed by a link title, in quotes.)
4400
4684
4401 This is an [inline link](/url), and here's [one with
4685 This is an [inline link](/url), and here's [one with
4402− a title](http://fsf.org "click here for a good time!").
4686+ a title](https://fsf.org "click here for a good time!").
4403
4687
4404There can be no space between the bracketed part and the parenthesized part.
4688There can be no space between the bracketed part and the parenthesized part.
4405The link text can contain formatting (such as emphasis), but the title cannot.
4689The link text can contain formatting (such as emphasis), but the title cannot.
@@ -4428,7 +4712,7 @@ Here are some examples:
4428
4712
4429 [my label 1]: /foo/bar.html "My title, optional"
4713 [my label 1]: /foo/bar.html "My title, optional"
4430 [my label 2]: /foo
4714 [my label 2]: /foo
4431− [my label 3]: http://fsf.org (The free software foundation)
4715+ [my label 3]: https://fsf.org (The free software foundation)
4432 [my label 4]: /bar#special 'A title in single quotes'
4716 [my label 4]: /bar#special 'A title in single quotes'
4433
4717
4434The URL may optionally be surrounded by angle brackets:
4718The URL may optionally be surrounded by angle brackets:
@@ -4437,7 +4721,7 @@ The URL may optionally be surrounded by angle brackets:
4437
4721
4438The title may go on the next line:
4722The title may go on the next line:
4439
4723
4440− [my label 3]: http://fsf.org
4724+ [my label 3]: https://fsf.org
4441 "The free software foundation"
4725 "The free software foundation"
4442
4726
4443Note that link labels are not case sensitive. So, this will work:
4727Note that link labels are not case sensitive. So, this will work:
@@ -4550,10 +4834,12 @@ For example:
4550![](file.jpg){ width=50% }
4834![](file.jpg){ width=50% }
4551```
4835```
4552
4836
4553−- Dimensions are converted to inches for output in page-based formats like
4837+- Dimensions may be converted to a form that is compatible with
4554− LaTeX. Dimensions are converted to pixels for output in HTML-like
4838+ the output format (for example, dimensions given in pixels will
4555− formats. Use the `--dpi` option to specify the number of pixels per
4839+ be converted to inches when converting HTML to LaTeX). Conversion
4556− inch. The default is 96dpi.
4840+ between pixels and physical measurements is affected by the
4841+ `--dpi` option (by default, 96 dpi is assumed, unless the image
4842+ itself contains dpi information).
4557- The `%` unit is generally relative to some available space.
4843- The `%` unit is generally relative to some available space.
4558 For example the above example will render to the following.
4844 For example the above example will render to the following.
4559 - HTML: `<img href="file.jpg" style="width: 50%;" />`
4845 - HTML: `<img href="file.jpg" style="width: 50%;" />`
@@ -4562,7 +4848,7 @@ For example:
4562 as in the default template.)
4848 as in the default template.)
4563 - ConTeXt: `\externalfigure[file.jpg][width=0.5\textwidth]`
4849 - ConTeXt: `\externalfigure[file.jpg][width=0.5\textwidth]`
4564- Some output formats have a notion of a class
4850- Some output formats have a notion of a class
4565− ([ConTeXt](http://wiki.contextgarden.net/Using_Graphics#Multiple_Image_Settings))
4851+ ([ConTeXt](https://wiki.contextgarden.net/Using_Graphics#Multiple_Image_Settings))
4566 or a unique identifier (LaTeX `\caption`), or both (HTML).
4852 or a unique identifier (LaTeX `\caption`), or both (HTML).
4567- When no `width` or `height` attributes are specified, the fallback
4853- When no `width` or `height` attributes are specified, the fallback
4568 is to look at the image resolution and the dpi metadata embedded in
4854 is to look at the image resolution and the dpi metadata embedded in
@@ -4670,142 +4956,72 @@ they cannot contain multiple paragraphs). The syntax is as follows:
4670
4956
4671Inline and regular footnotes may be mixed freely.
4957Inline and regular footnotes may be mixed freely.
4672
4958
4673−## Citations
4959+## Citation syntax
4674
4960
4675#### Extension: `citations` ####
4961#### Extension: `citations` ####
4676
4962
4677−Using an external filter, `pandoc-citeproc`, pandoc can automatically generate
4963+To cite a bibliographic item with an identifier foo, use the
4678−citations and a bibliography in a number of styles. Basic usage is
4964+syntax `@foo`. Normal citations should be included in square
4965+brackets, with semicolons separating distinct items:
4679
4966
4680− pandoc --filter pandoc-citeproc myinput.txt
4967+ Blah blah [@doe99; @smith2000; @smith2004].
4681
4968
4682−In order to use this feature, you will need to specify a bibliography file
4969+How this is rendered depends on the citation style. In an
4683−using the `bibliography` metadata field in a YAML metadata section, or
4970+author-date style, it might render as
4684−`--bibliography` command line argument. You can supply multiple `--bibliography`
4685−arguments or set `bibliography` metadata field to YAML array, if you want to
4686−use multiple bibliography files. The bibliography may have any of these
4687−formats:
4688
4971
4689− Format File extension
4972+ Blah blah (Doe 1999, Smith 2000, 2004).
4690− ------------ --------------
4691− BibLaTeX .bib
4692− BibTeX .bibtex
4693− Copac .copac
4694− CSL JSON .json
4695− CSL YAML .yaml
4696− EndNote .enl
4697− EndNote XML .xml
4698− ISI .wos
4699− MEDLINE .medline
4700− MODS .mods
4701− RIS .ris
4702
4973
4703−Note that `.bib` can be used with both BibTeX and BibLaTeX files;
4974+In a footnote style, it might render as
4704−use `.bibtex` to force BibTeX.
4705
4975
4706−Note that `pandoc-citeproc --bib2json` and `pandoc-citeproc --bib2yaml`
4976+ Blah blah.[^1]
4707−can produce `.json` and `.yaml` files from any of the supported formats.
4708
4977
4709−In-field markup: In BibTeX and BibLaTeX databases,
4978+ [^1]: John Doe, "Frogs," *Journal of Amphibians* 44 (1999);
4710−pandoc-citeproc parses a subset of LaTeX markup; in CSL YAML
4979+ Susan Smith, "Flies," *Journal of Insects* (2000);
4711−databases, pandoc Markdown; and in CSL JSON databases, an
4980+ Susan Smith, "Bees," *Journal of Insects* (2004).
4712−[HTML-like markup][CSL markup specs]:
4713
4981
4714−`<i>...</i>`
4982+See the [CSL user documentation] for more information about CSL
4715−: italics
4983+styles and how they affect rendering.
4716
4984
4717−`<b>...</b>`
4985+Unless a citation key start with a letter, digit, or `_`,
4718−: bold
4986+and contains only alphanumerics and internal punctuation
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]`.
4719
4994
4720−`<span style="font-variant:small-caps;">...</span>` or `<sc>...</sc>`
4995+Citation items may optionally include a prefix, a locator, and
4721−: small capitals
4996+a suffix. In
4722
4997
4723−`<sub>...</sub>`
4998+ Blah blah [see @doe99, pp. 33-35 and *passim*; @smith04, chap. 1].
4724−: subscript
4725
4999
4726−`<sup>...</sup>`
5000+The first item (`doe99`) has prefix `see `, locator `pp. 33-35`,
4727−: superscript
5001+and suffix `and *passim*`. The second item (`smith04`) has
4728−
5002+locator `chap. 1` and no prefix or suffix.
4729−`<span class="nocase">...</span>`
4730−: prevent a phrase from being capitalized as title case
4731
5003
4732−`pandoc-citeproc -j` and `-y` interconvert the CSL JSON
5004+Pandoc uses some heuristics to separate the locator from the
4733−and CSL YAML formats as far as possible.
5005+rest of the subject. It is sensitive to the locator terms
4734−
5006+defined in the [CSL locale files]. Either abbreviated or
4735−As an alternative to specifying a bibliography file using `--bibliography`
4736−or the YAML metadata field `bibliography`, you can include
4737−the citation data directly in the `references` field of the
4738−document's YAML metadata. The field should contain an array of
4739−YAML-encoded references, for example:
4740−
4741− ---
4742− references:
4743− - type: article-journal
4744− id: WatsonCrick1953
4745− author:
4746− - family: Watson
4747− given: J. D.
4748− - family: Crick
4749− given: F. H. C.
4750− issued:
4751− date-parts:
4752− - - 1953
4753− - 4
4754− - 25
4755− title: 'Molecular structure of nucleic acids: a structure for deoxyribose
4756− nucleic acid'
4757− title-short: Molecular structure of nucleic acids
4758− container-title: Nature
4759− volume: 171
4760− issue: 4356
4761− page: 737-738
4762− DOI: 10.1038/171737a0
4763− URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
4764− language: en-GB
4765− ...
4766−
4767−(`pandoc-citeproc --bib2yaml` can produce these from a bibliography file in one
4768−of the supported formats.)
4769−
4770−Citations and references can be formatted using any style supported by the
4771−[Citation Style Language], listed in the [Zotero Style Repository].
4772−These files are specified using the `--csl` option or the `csl` metadata field.
4773−By default, `pandoc-citeproc` will use the [Chicago Manual of Style] author-date
4774−format. The CSL project provides further information on [finding and editing styles].
4775−
4776−To make your citations hyperlinks to the corresponding bibliography
4777−entries, add `link-citations: true` to your YAML metadata.
4778−
4779−Citations go inside square brackets and are separated by semicolons.
4780−Each citation must have a key, composed of '@' + the citation
4781−identifier from the database, and may optionally have a prefix,
4782−a locator, and a suffix. The citation key must begin with a letter, digit,
4783−or `_`, and may contain alphanumerics, `_`, and internal punctuation
4784−characters (`:.#$%&-+?<>~/`). Here are some examples:
4785−
4786− Blah blah [see @doe99, pp. 33-35; also @smith04, chap. 1].
4787−
4788− Blah blah [@doe99, pp. 33-35, 38-39 and *passim*].
4789−
4790− Blah blah [@smith04; @doe99].
4791−
4792−`pandoc-citeproc` detects locator terms in the [CSL locale files].
4793−Either abbreviated or unabbreviated forms are accepted. In the `en-US`
5007+unabbreviated forms are accepted. In the `en-US` locale, locator
4794−locale, locator terms can be written in either singular or plural forms,
5008+terms can be written in either singular or plural forms, as
4795−as `book`, `bk.`/`bks.`; `chapter`, `chap.`/`chaps.`; `column`,
5009+`book`, `bk.`/`bks.`; `chapter`, `chap.`/`chaps.`; `column`,
4796−`col.`/`cols.`; `figure`, `fig.`/`figs.`; `folio`, `fol.`/`fols.`;
5010+`col.`/`cols.`; `figure`, `fig.`/`figs.`; `folio`,
4797−`number`, `no.`/`nos.`; `line`, `l.`/`ll.`; `note`, `n.`/`nn.`; `opus`,
5011+`fol.`/`fols.`; `number`, `no.`/`nos.`; `line`, `l.`/`ll.`;
5012+`note`, `n.`/`nn.`; `opus`, `op.`/`opp.`; `page`, `p.`/`pp.`;
4798−`op.`/`opp.`; `page`, `p.`/`pp.`; `paragraph`, `para.`/`paras.`; `part`,
5013+`paragraph`, `para.`/`paras.`; `part`, `pt.`/`pts.`; `section`,
4799−`pt.`/`pts.`; `section`, `sec.`/`secs.`; `sub verbo`, `s.v.`/`s.vv.`;
5014+`sec.`/`secs.`; `sub verbo`, `s.v.`/`s.vv.`; `verse`,
4800−`verse`, `v.`/`vv.`; `volume`, `vol.`/`vols.`; `¶`/`¶¶`; `§`/`§§`. If no
5015+`v.`/`vv.`; `volume`, `vol.`/`vols.`; `¶`/`¶¶`; `§`/`§§`. If no
4801locator term is used, "page" is assumed.
5016locator term is used, "page" is assumed.
4802
5017
4803−`pandoc-citeproc` will use heuristics to distinguish the locator
5018+In complex cases, you can force something to be treated as
4804−from the suffix. In complex cases, the locator can be enclosed
5019+a locator by enclosing it in curly braces or prevent parsing
4805−in curly braces (using `pandoc-citeproc` 0.15 and higher only):
5020+the suffix as locator by prepending curly braces:
4806
5021
4807 [@smith{ii, A, D-Z}, with a suffix]
5022 [@smith{ii, A, D-Z}, with a suffix]
4808 [@smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
5023 [@smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
5024+ [@smith{}, 99 years later]
4809
5025
4810A minus sign (`-`) before the `@` will suppress mention of
5026A minus sign (`-`) before the `@` will suppress mention of
4811the author in the citation. This can be useful when the
5027the author in the citation. This can be useful when the
@@ -4813,82 +5029,103 @@ author is already mentioned in the text:
4813
5029
4814 Smith says blah [-@smith04].
5030 Smith says blah [-@smith04].
4815
5031
4816−You can also write an in-text citation, as follows:
5032+You can also write an author-in-text citation, by omitting the
5033+square brackets:
4817
5034
4818 @smith04 says blah.
5035 @smith04 says blah.
4819
5036
4820 @smith04 [p. 33] says blah.
5037 @smith04 [p. 33] says blah.
4821
5038
4822−If the style calls for a list of works cited, it will be placed
5039+This will cause the author's name to be rendered, followed by
4823−in a div with id `refs`, if one exists:
5040+the bibliographical details. Use this form when you want to
4824−
5041+make the citation the subject of a sentence.
4825− ::: {#refs}
5042+
4826− :::
5043+When you are using a note style, it is usually better to let
4827−
5044+citeproc create the footnotes from citations rather than writing
4828−Otherwise, it will be placed at the end of the document.
5045+an explicit note. If you do write an explicit note that
4829−Generation of the bibliography can be suppressed by setting
5046+contains a citation, note that normal citations will be put in
4830−`suppress-bibliography: true` in the YAML metadata.
5047+parentheses, while author-in-text citations will not. For
4831−
5048+this reason, it is sometimes preferable to use the
4832−If you wish the bibliography to have a section heading, you can
5049+author-in-text style inside notes when using a note style.
4833−set `reference-section-title` in the metadata, or put the heading
5050+
4834−at the beginning of the div with id `refs` (if you are using it)
5051+[CSL user documentation]: https://citationstyles.org/authors/
4835−or at the end of your document:
5052+[CSL]: https://docs.citationstyles.org/en/stable/specification.html
4836−
4837− last paragraph...
4838−
4839− # References
4840−
4841−The bibliography will be inserted after this heading. Note that
4842−the `unnumbered` class will be added to this heading, so that the
4843−section will not be numbered.
4844−
4845−If you want to include items in the bibliography without actually
4846−citing them in the body text, you can define a dummy `nocite` metadata
4847−field and put the citations there:
4848−
4849− ---
4850− nocite: |
4851− @item1, @item2
4852− ...
4853−
4854− @item3
4855−
4856−In this example, the document will contain a citation for `item3`
4857−only, but the bibliography will contain entries for `item1`, `item2`, and
4858−`item3`.
4859−
4860−It is possible to create a bibliography with all the citations,
4861−whether or not they appear in the document, by using a wildcard:
4862−
4863− ---
4864− nocite: |
4865− @*
4866− ...
4867−
4868−For LaTeX output, you can also use [`natbib`] or [`biblatex`] to
4869−render the bibliography. In order to do so, specify bibliography
4870−files as outlined above, and add `--natbib` or `--biblatex`
4871−argument to `pandoc` invocation. Bear in mind that bibliography
4872−files have to be in respective format (either BibTeX or
4873−BibLaTeX).
4874−
4875−For more information, see the [pandoc-citeproc man page].
4876−
4877−[CSL markup specs]: http://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields
5053+[CSL markup specs]: https://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields
4878−[Chicago Manual of Style]: http://chicagomanualofstyle.org
5054+[Chicago Manual of Style]: https://chicagomanualofstyle.org
4879−[Citation Style Language]: http://citationstyles.org
5055+[Citation Style Language]: https://citationstyles.org
4880[Zotero Style Repository]: https://www.zotero.org/styles
5056[Zotero Style Repository]: https://www.zotero.org/styles
4881[finding and editing styles]: https://citationstyles.org/authors/
5057[finding and editing styles]: https://citationstyles.org/authors/
4882[CSL locale files]: https://github.com/citation-style-language/locales
5058[CSL locale files]: https://github.com/citation-style-language/locales
4883−[pandoc-citeproc man page]: https://github.com/jgm/pandoc-citeproc/blob/master/man/pandoc-citeproc.1.md
4884
5059
4885−## Non-pandoc extensions
5060+## Non-default extensions
4886
5061
4887The following Markdown syntax extensions are not enabled by default
5062The following Markdown syntax extensions are not enabled by default
4888in pandoc, but may be enabled by adding `+EXTENSION` to the format
5063in pandoc, but may be enabled by adding `+EXTENSION` to the format
4889name, where `EXTENSION` is the name of the extension. Thus, for
5064name, where `EXTENSION` is the name of the extension. Thus, for
4890example, `markdown+hard_line_breaks` is Markdown with hard line breaks.
5065example, `markdown+hard_line_breaks` is Markdown with hard line breaks.
4891
5066
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+
4892#### Extension: `old_dashes` ####
5129#### Extension: `old_dashes` ####
4893
5130
4894Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
5131Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
@@ -5001,7 +5238,7 @@ and image references. This extension should not be confused with the
5001
5238
5002 This is a reference ![image][ref] with multimarkdown attributes.
5239 This is a reference ![image][ref] with multimarkdown attributes.
5003
5240
5004− [ref]: http://path.to/image "Image title" width=20px height=30px
5241+ [ref]: https://path.to/image "Image title" width=20px height=30px
5005 id=myId class="myClass1 myClass2"
5242 id=myId class="myClass1 myClass2"
5006
5243
5007#### Extension: `mmd_header_identifiers` ####
5244#### Extension: `mmd_header_identifiers` ####
@@ -5044,58 +5281,382 @@ for regular emphasis, add extra blank space around headings.
5044
5281
5045 [Project Gutenberg]: https://www.gutenberg.org
5282 [Project Gutenberg]: https://www.gutenberg.org
5046
5283
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+
5047## Markdown variants
5291## Markdown variants
5048
5292
5049In addition to pandoc's extended Markdown, the following Markdown
5293In addition to pandoc's extended Markdown, the following Markdown
5050variants are supported:
5294variants are supported:
5051
5295
5052−`markdown_phpextra` (PHP Markdown Extra)
5296+- `markdown_phpextra` (PHP Markdown Extra)
5053−: `footnotes`, `pipe_tables`, `raw_html`, `markdown_attribute`,
5054− `fenced_code_blocks`, `definition_lists`, `intraword_underscores`,
5055− `header_attributes`, `link_attributes`, `abbreviations`,
5056− `shortcut_reference_links`, `spaced_reference_links`.
5057−
5058−`markdown_github` (deprecated GitHub-Flavored Markdown)
5297+- `markdown_github` (deprecated GitHub-Flavored Markdown)
5059−: `pipe_tables`, `raw_html`, `fenced_code_blocks`, `auto_identifiers`,
5060− `gfm_auto_identifiers`, `backtick_code_blocks`,
5061− `autolink_bare_uris`, `space_in_atx_header`,
5062− `intraword_underscores`, `strikeout`, `task_lists`, `emoji`,
5063− `shortcut_reference_links`, `angle_brackets_escapable`,
5064− `lists_without_preceding_blankline`.
5065−
5066−`markdown_mmd` (MultiMarkdown)
5298+- `markdown_mmd` (MultiMarkdown)
5067−: `pipe_tables`, `raw_html`, `markdown_attribute`, `mmd_link_attributes`,
5068− `tex_math_double_backslash`, `intraword_underscores`,
5069− `mmd_title_block`, `footnotes`, `definition_lists`,
5070− `all_symbols_escapable`, `implicit_header_references`,
5071− `auto_identifiers`, `mmd_header_identifiers`,
5072− `shortcut_reference_links`, `implicit_figures`,
5073− `superscript`, `subscript`, `backtick_code_blocks`,
5074− `spaced_reference_links`, `raw_attribute`.
5075−
5076−`markdown_strict` (Markdown.pl)
5299+- `markdown_strict` (Markdown.pl)
5077−: `raw_html`, `shortcut_reference_links`,
5300+- `commonmark` (CommonMark)
5078− `spaced_reference_links`.
5301+- `gfm` (Github-Flavored Markdown)
5079−
5302+- `commonmark_x` (CommonMark with many pandoc extensions)
5080−We also support `commonmark` and `gfm` (GitHub-Flavored Markdown,
5303+
5081−which is implemented as a set of extensions on `commonmark`).
5304+To see which extensions are supported for a given format,
5082−
5305+and which are enabled by default, you can use the command
5083−Note, however, that `commonmark` and `gfm` have limited support
5306+
5084−for extensions. Only those listed below (and `smart`,
5307+ pandoc --list-extensions=FORMAT
5085−`raw_tex`, and `hard_line_breaks`) will work. The extensions
5308+
5086−can, however, all be individually disabled. Also, `raw_tex`
5309+where `FORMAT` is replaced with the name of the format.
5087−only affects `gfm` output, not input.
5310+
5088−
5311+Note that the list of extensions for `commonmark`,
5089−`gfm` (GitHub-Flavored Markdown)
5312+`gfm`, and `commonmark_x` are defined relative to default
5090−: `pipe_tables`, `raw_html`, `fenced_code_blocks`, `auto_identifiers`,
5313+commonmark. So, for example, `backtick_code_blocks`
5091− `gfm_auto_identifiers`, `backtick_code_blocks`,
5314+does not appear as an extension, since it is enabled by
5092− `autolink_bare_uris`, `space_in_atx_header`,
5315+default and cannot be disabled.
5093− `intraword_underscores`, `strikeout`, `task_lists`, `emoji`,
5316+
5094− `shortcut_reference_links`, `angle_brackets_escapable`,
5317+# Citations
5095− `lists_without_preceding_blankline`.
5318+
5096−
5319+When the `--citeproc` option is used, pandoc can automatically generate
5097−
5320+citations and a bibliography in a number of styles. Basic usage is
5098−# Producing slide shows with pandoc
5321+
5322+ pandoc --citeproc myinput.txt
5323+
5324+To use this feature, you will need to have
5325+
5326+- a document containing citations (see [Extension: `citations`]);
5327+- a source of bibliographic data: either an external bibliography
5328+ file or a list of `references` in the document's YAML metadata
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
5099
5660
5100You can use pandoc to produce an HTML + JavaScript slide presentation
5661You can use pandoc to produce an HTML + JavaScript slide presentation
5101that can be viewed via a web browser. There are five ways to do this,
5662that can be viewed via a web browser. There are five ways to do this,
@@ -5143,18 +5704,21 @@ To produce an HTML/JavaScript slide show, simply type
5143
5704
5144where `FORMAT` is either `s5`, `slidy`, `slideous`, `dzslides`, or `revealjs`.
5705where `FORMAT` is either `s5`, `slidy`, `slideous`, `dzslides`, or `revealjs`.
5145
5706
5146−For Slidy, Slideous, reveal.js, and S5, the file produced by pandoc with the
5707+For Slidy, Slideous, reveal.js, and S5, the file produced by
5147−`-s/--standalone` option embeds a link to JavaScript and CSS files, which are
5708+pandoc with the `-s/--standalone` option embeds a link to
5709+JavaScript and CSS files, which are assumed to be available at
5148−assumed to be available at the relative path `s5/default` (for S5), `slideous`
5710+the relative path `s5/default` (for S5), `slideous` (for
5149−(for Slideous), `reveal.js` (for reveal.js), or at the Slidy website at
5711+Slideous), `reveal.js` (for reveal.js), or at the Slidy website
5150−`w3.org` (for Slidy). (These paths can be changed by setting the `slidy-url`,
5712+at `w3.org` (for Slidy). (These paths can be changed by setting
5713+the `slidy-url`, `slideous-url`, `revealjs-url`, or `s5-url`
5151−`slideous-url`, `revealjs-url`, or `s5-url` variables; see [Variables for HTML slides],
5714+variables; see [Variables for HTML slides], above.) For
5152−above.) For DZSlides, the (relatively short) JavaScript and CSS are included in
5715+DZSlides, the (relatively short) JavaScript and CSS are included
5153−the file by default.
5716+in the file by default.
5154−
5717+
5155−With all HTML slide formats, the `--self-contained` option can be used to
5718+With all HTML slide formats, the `--self-contained` option can
5156−produce a single file that contains all of the data necessary to display the
5719+be used to produce a single file that contains all of the data
5720+necessary to display the slide show, including linked scripts,
5157−slide show, including linked scripts, stylesheets, images, and videos.
5721+stylesheets, images, and videos.
5158
5722
5159To produce a PDF slide show using beamer, type
5723To produce a PDF slide show using beamer, type
5160
5724
@@ -5184,7 +5748,11 @@ rules:
5184 * A heading at the slide level always starts a new slide.
5748 * A heading at the slide level always starts a new slide.
5185
5749
5186 * Headings *below* the slide level in the hierarchy create
5750 * Headings *below* the slide level in the hierarchy create
5187− headings *within* a slide.
5751+ headings *within* a slide. (In beamer, a "block" will be
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.)
5188
5756
5189 * Headings *above* the slide level in the hierarchy create
5757 * Headings *above* the slide level in the hierarchy create
5190 "title slides," which just contain the section title
5758 "title slides," which just contain the section title
@@ -5335,6 +5903,41 @@ containers with class `column` and a `width` attribute:
5335 :::
5903 :::
5336 ::::::::::::::
5904 ::::::::::::::
5337
5905
5906+### Additional columns attributes in beamer
5907+
5908+The div containers with classes `columns` and `column` can optionally have
5909+an `align` attribute.
5910+The class `columns` can optionally have a `totalwidth` attribute or an
5911+`onlytextwidth` class.
5912+
5913+ :::::::::::::: {.columns align=center totalwidth=8em}
5914+ ::: {.column width="40%"}
5915+ contents...
5916+ :::
5917+ ::: {.column width="60%" align=bottom}
5918+ contents...
5919+ :::
5920+ ::::::::::::::
5921+
5922+The `align` attributes on `columns` and `column` can be used with the
5923+values `top`, `top-baseline`, `center` and `bottom` to vertically align
5924+the columns. It defaults to `top` in `columns`.
5925+
5926+The `totalwidth` attribute limits the width of the columns to the given value.
5927+
5928+ :::::::::::::: {.columns align=top .onlytextwidth}
5929+ ::: {.column width="40%" align=center}
5930+ contents...
5931+ :::
5932+ ::: {.column width="60%"}
5933+ contents...
5934+ :::
5935+ ::::::::::::::
5936+
5937+The class `onlytextwidth` sets the `totalwidth` to `\textwidth`.
5938+
5939+See Section 12.7 of the [Beamer User's Guide] for more details.
5940+
5338## Frame attributes in beamer
5941## Frame attributes in beamer
5339
5942
5340Sometimes it is necessary to add the LaTeX `[fragile]` option to
5943Sometimes it is necessary to add the LaTeX `[fragile]` option to
@@ -5379,9 +5982,8 @@ To add a background image to the automatically generated title slide, use the
5379`title-slide-attributes` variable in the YAML metadata block. It must contain
5982`title-slide-attributes` variable in the YAML metadata block. It must contain
5380a map of attribute names and values.
5983a map of attribute names and values.
5381
5984
5382−See the [reveal.js
5383−documentation](https://github.com/hakimel/reveal.js#slide-backgrounds)
5985+See the [reveal.js documentation](https://revealjs.com/backgrounds/) for more
5384−for more details.
5986+details.
5385
5987
5386For example in reveal.js:
5988For example in reveal.js:
5387
5989
@@ -5403,7 +6005,7 @@ Slide 1 has background_image.png as its background.
5403Slide 2 has a special image for its background, even though the heading has no content.
6005Slide 2 has a special image for its background, even though the heading has no content.
5404```
6006```
5405
6007
5406−# Creating EPUBs with pandoc
6008+# EPUBs
5407
6009
5408## EPUB Metadata
6010## EPUB Metadata
5409
6011
@@ -5483,6 +6085,15 @@ The following fields are recognized:
5483
6085
5484`rights`
6086`rights`
5485 ~ A string value.
6087 ~ 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.
5486
6097
5487`cover-image`
6098`cover-image`
5488 ~ A string value (path to cover image).
6099 ~ A string value (path to cover image).
@@ -5504,7 +6115,7 @@ The following fields are recognized:
5504 - `binding`: `true`|`false` (default `true`)
6115 - `binding`: `true`|`false` (default `true`)
5505 - `scroll-axis`: `vertical`|`horizontal`|`default`
6116 - `scroll-axis`: `vertical`|`horizontal`|`default`
5506
6117
5507−[MARC relators]: http://loc.gov/marc/relators/relaterm.html
6118+[MARC relators]: https://loc.gov/marc/relators/relaterm.html
5508[`spine` element]: http://idpf.org/epub/301/spec/epub-publications.html#sec-spine-elem
6119[`spine` element]: http://idpf.org/epub/301/spec/epub-publications.html#sec-spine-elem
5509
6120
5510## The `epub:type` attribute
6121## The `epub:type` attribute
@@ -5544,8 +6155,6 @@ halftitlepage frontmatter
5544seriespage frontmatter
6155seriespage frontmatter
5545foreword frontmatter
6156foreword frontmatter
5546preface frontmatter
6157preface frontmatter
5547−seriespage frontmatter
5548−titlepage frontmatter
5549appendix backmatter
6158appendix backmatter
5550colophon backmatter
6159colophon backmatter
5551bibliography backmatter
6160bibliography backmatter
@@ -5563,12 +6172,12 @@ instead, use raw HTML in your source and add `data-external="1"` to the tag
5563with the `src` attribute. For example:
6172with the `src` attribute. For example:
5564
6173
5565 <audio controls="1">
6174 <audio controls="1">
5566− <source src="http://example.com/music/toccata.mp3"
6175+ <source src="https://example.com/music/toccata.mp3"
5567 data-external="1" type="audio/mpeg">
6176 data-external="1" type="audio/mpeg">
5568 </source>
6177 </source>
5569 </audio>
6178 </audio>
5570
6179
5571−# Creating Jupyter notebooks with pandoc
6180+# Jupyter notebooks
5572
6181
5573When creating a [Jupyter notebook], pandoc will try to infer the
6182When creating a [Jupyter notebook], pandoc will try to infer the
5574notebook structure. Code blocks with the class `code` will be
6183notebook structure. Code blocks with the class `code` will be
@@ -5721,7 +6330,7 @@ Then edit `my.theme` and use it like this:
5721If you are not satisfied with the built-in highlighting, or you
6330If you are not satisfied with the built-in highlighting, or you
5722want highlight a language that isn't supported, you can use the
6331want highlight a language that isn't supported, you can use the
5723`--syntax-definition` option to load a [KDE-style XML syntax definition
6332`--syntax-definition` option to load a [KDE-style XML syntax definition
5724−file](https://docs.kde.org/stable5/en/applications/katepart/highlight.html).
6333+file](https://docs.kde.org/stable5/en/kate/katepart/highlight.html).
5725Before writing your own, have a look at KDE's [repository of syntax
6334Before writing your own, have a look at KDE's [repository of syntax
5726definitions](https://github.com/KDE/syntax-highlighting/tree/master/data/syntax).
6335definitions](https://github.com/KDE/syntax-highlighting/tree/master/data/syntax).
5727
6336
@@ -5778,7 +6387,7 @@ custom-style `span`.
5778For docx output, you don't need to enable any extensions for
6387For docx output, you don't need to enable any extensions for
5779custom styles to work.
6388custom styles to work.
5780
6389
5781−[pandoc filters]: http://pandoc.org/filters.html
6390+[pandoc filters]: https://pandoc.org/filters.html
5782
6391
5783## Input
6392## Input
5784
6393
@@ -5829,15 +6438,15 @@ same styles in your input and output files.
5829
6438
5830# Custom writers
6439# Custom writers
5831
6440
5832−Pandoc can be extended with custom writers written in [lua]. (Pandoc
6441+Pandoc can be extended with custom writers written in [Lua]. (Pandoc
5833−includes a lua interpreter, so lua need not be installed separately.)
6442+includes a Lua interpreter, so Lua need not be installed separately.)
5834
6443
5835−To use a custom writer, simply specify the path to the lua script
6444+To use a custom writer, simply specify the path to the Lua script
5836in place of the output format. For example:
6445in place of the output format. For example:
5837
6446
5838 pandoc -t data/sample.lua
6447 pandoc -t data/sample.lua
5839
6448
5840−Creating a custom writer requires writing a lua function for each
6449+Creating a custom writer requires writing a Lua function for each
5841possible element in a pandoc document. To get a documented example
6450possible element in a pandoc document. To get a documented example
5842which you can modify according to your needs, do
6451which you can modify according to your needs, do
5843
6452
@@ -5850,7 +6459,22 @@ default template with the name
5850`default.NAME_OF_CUSTOM_WRITER.lua` to the `templates`
6459`default.NAME_OF_CUSTOM_WRITER.lua` to the `templates`
5851subdirectory of your user data directory (see [Templates]).
6460subdirectory of your user data directory (see [Templates]).
5852
6461
5853−[lua]: http://www.lua.org
6462+[Lua]: https://www.lua.org
6463+
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).
5854
6478
5855# A note on security
6479# A note on security
5856
6480
@@ -5867,7 +6491,7 @@ application, here are some things to keep in mind:
5867 shelling out to the executable), it is possible to use it in a mode
6491 shelling out to the executable), it is possible to use it in a mode
5868 that fully isolates pandoc from your file system, by running the
6492 that fully isolates pandoc from your file system, by running the
5869 pandoc operations in the `PandocPure` monad. See the document
6493 pandoc operations in the `PandocPure` monad. See the document
5870− [Using the pandoc API](http://pandoc.org/using-the-pandoc-api.html)
6494+ [Using the pandoc API](https://pandoc.org/using-the-pandoc-api.html)
5871 for more details.
6495 for more details.
5872
6496
58733. Pandoc's parsers can exhibit pathological performance on some
64973. Pandoc's parsers can exhibit pathological performance on some
@@ -5880,17 +6504,17 @@ application, here are some things to keep in mind:
58804. The HTML generated by pandoc is not guaranteed to be safe.
65044. The HTML generated by pandoc is not guaranteed to be safe.
5881 If `raw_html` is enabled for the Markdown input, users can
6505 If `raw_html` is enabled for the Markdown input, users can
5882 inject arbitrary HTML. Even if `raw_html` is disabled,
6506 inject arbitrary HTML. Even if `raw_html` is disabled,
5883− users can include dangerous content in attributes for
6507+ users can include dangerous content in URLs and attributes.
5884− headings, spans, and code blocks. To be safe, you should
5885− run all the generated HTML through an HTML sanitizer.
6508+ To be safe, you should run all the generated HTML through
6509+ an HTML sanitizer.
5886
6510
5887# Authors
6511# Authors
5888
6512
5889−Copyright 2006--2019 John MacFarlane (jgm@berkeley.edu). Released
6513+Copyright 2006--2021 John MacFarlane (jgm@berkeley.edu). Released
5890under the [GPL], version 2 or greater. This software carries no
6514under the [GPL], version 2 or greater. This software carries no
5891warranty of any kind. (See COPYRIGHT for full copyright and
6515warranty of any kind. (See COPYRIGHT for full copyright and
5892warranty notices.) For a full list of contributors, see the file
6516warranty notices.) For a full list of contributors, see the file
5893AUTHORS.md in the pandoc source code.
6517AUTHORS.md in the pandoc source code.
5894
6518
5895−[GPL]: http://www.gnu.org/copyleft/gpl.html "GNU General Public License"
6519+[GPL]: https://www.gnu.org/copyleft/gpl.html "GNU General Public License"
5896[YAML]: https://yaml.org/spec/1.2/spec.html "YAML v1.2 Spec"
6520[YAML]: https://yaml.org/spec/1.2/spec.html "YAML v1.2 Spec"
Makefile+65−62
@@ -1,17 +1,32 @@
1version?=$(shell grep '^[Vv]ersion:' pandoc.cabal | awk '{print $$2;}')
1version?=$(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)
3−SOURCEFILES?=$(shell find pandoc.hs src test -name '*.hs')
3+SOURCEFILES?=$(shell git ls-tree -r master --name-only | grep "\.hs$$")
4BRANCH?=master
4BRANCH?=master
5−RESOLVER?=lts-13
5+ARCH=$(shell uname -m)
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
6−GHCOPTS=-fdiagnostics-color=always
16+GHCOPTS=-fdiagnostics-color=always -j4 +RTS -A8m -RTS
7WEBSITE=../../web/pandoc.org
17WEBSITE=../../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)",)
8
23
9quick:
24quick:
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)'
25+ stack install --ghc-options='$(GHCOPTS)' --install-ghc --flag 'pandoc:embed_data_files' --fast --test --ghc-options='$(GHCOPTS)' --test-arguments='-j4 --hide-successes $(TESTARGS)'
11
26
12quick-cabal:
27quick-cabal:
13 cabal new-configure . --ghc-options '$(GHCOPTS)' --disable-optimization --enable-tests
28 cabal new-configure . --ghc-options '$(GHCOPTS)' --disable-optimization --enable-tests
14− cabal new-build . --disable-optimization
29+ cabal new-build -j4 . --disable-optimization
15 cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
30 cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
16
31
17full-cabal:
32full-cabal:
@@ -20,7 +35,7 @@ full-cabal:
20 cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
35 cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
21
36
22full:
37full:
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)'
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)'
24
39
25ghci:
40ghci:
26 stack ghci --flag 'pandoc:embed_data_files'
41 stack ghci --flag 'pandoc:embed_data_files'
@@ -36,20 +51,29 @@ test:
36ghcid:
51ghcid:
37 ghcid -c "stack repl --flag 'pandoc:embed_data_files'"
52 ghcid -c "stack repl --flag 'pandoc:embed_data_files'"
38
53
39−bench:
54+ghcid-test:
40− stack bench --benchmark-arguments='$(BENCHARGS)' --ghc-options '$(GHCOPTS)'
55+ ghcid -c "stack repl --ghc-options=-XNoImplicitPrelude --flag 'pandoc:embed_data_files' --ghci-options=-fobject-code pandoc:lib pandoc:test-pandoc"
41
56
42−weigh:
57+bench:
58+ stack bench \
43− stack build --ghc-options '$(GHCOPTS)' pandoc:weigh-pandoc && stack exec weigh-pandoc
59+ --ghc-options '$(GHCOPTS)' \
60+ --benchmark-arguments='$(BENCHARGS)' 2>&1 | \
61+ tee "bench_latest.txt"
44
62
45reformat:
63reformat:
46 for f in $(SOURCEFILES); do echo $$f; stylish-haskell -i $$f ; done
64 for f in $(SOURCEFILES); do echo $$f; stylish-haskell -i $$f ; done
47
65
48−lint:
66+lint: hlint fix_spacing
67+
68+hlint:
49− for f in $(SOURCEFILES); do echo $$f; hlint --verbose --refactor --refactor-options='-i -s' $$f; done
69+ for f in $(SOURCEFILES); do echo $$f; hlint --verbose --refactor --refactor-options='-s -o -' $$f; done
70+
71+fix_spacing:
72+ # Fix trailing newlines and spaces at ends of lines
73+ for f in $(SOURCEFILES); do printf '%s\n' "`cat $$f`" | sed -e 's/ *$$//' > $$f.tmp; mv $$f.tmp $$f; done
50
74
51changes_github:
75changes_github:
52− pandoc --filter tools/extract-changes.hs changelog.md -t gfm --wrap=none | sed -e 's/\\#/#/g' | pbcopy
76+ pandoc --filter tools/extract-changes.hs changelog.md -t gfm --wrap=none --template tools/changes_template.html | sed -e 's/\\#/#/g' | pbcopy
53
77
54dist: man/pandoc.1
78dist: man/pandoc.1
55 cabal sdist
79 cabal sdist
@@ -58,48 +82,25 @@ dist: man/pandoc.1
58 cd pandoc-${version}
82 cd pandoc-${version}
59 stack setup && stack test && cd .. && rm -rf "pandoc-${version}"
83 stack setup && stack test && cd .. && rm -rf "pandoc-${version}"
60
84
61−packages: checkdocs winpkg debpkg macospkg
85+check: checkdocs check-cabal
62
86
63−checkdocs: README.md
87+checkdocs:
64− ! grep -n -e "\t" MANUAL.txt changelog
88+ ! grep -q -n -e "\t" MANUAL.txt changelog.md
65
89
66debpkg: man/pandoc.1
90debpkg: man/pandoc.1
67− make -C linux && \
91+ docker run -v `pwd`:/mnt \
68− cp linux/artifacts/pandoc-$(version)-*.* .
92+ -v `pwd`/linux/artifacts:/artifacts \
69−
93+ --user $(id -u):$(id -g) \
70−macospkg: man/pandoc.1
94+ -e REVISION=$(REVISION) \
71− ./macos/make_macos_package.sh
95+ -w /mnt \
72−
96+ --memory=0 \
73−winpkg: pandoc-$(version)-windows-i386.msi pandoc-$(version)-windows-i386.zip pandoc-$(version)-windows-x86_64.msi pandoc-$(version)-windows-x86_64.zip
97+ --rm \
74−
98+ $(DOCKERIMAGE) \
75−pandoc-$(version)-windows-%.zip: pandoc-$(version)-windows-%.msi
99+ bash \
76− ORIGDIR=`pwd` && \
100+ /mnt/linux/make_artifacts.sh 2>&1 > docker.log
77− CONTAINER=$(basename $<) && \
78− TEMPDIR=`mktemp -d` && \
79− msiextract -C $$TEMPDIR/msi $< && \
80− pushd $$TEMPDIR && \
81− mkdir $$CONTAINER && \
82− find msi -type f -exec cp {} $$CONTAINER/ \; && \
83− zip -r $$ORIGDIR/$@ $$CONTAINER && \
84− popd & \
85− rm -rf $$TEMPDIR
86−
87−pandoc-$(version)-windows-%.msi: pandoc-windows-%.msi
88− osslsigncode sign -pkcs12 ~/Private/SectigoCodeSigning.exp2023.p12 -in $< -i http://johnmacfarlane.net/ -t http://timestamp.comodoca.com/ -out $@ -askpass
89− rm $<
90−
91−.INTERMEDIATE: pandoc-windows-i386.msi pandoc-windows-x86_64.msi
92−
93−pandoc-windows-i386.msi:
94− JOBID=$(shell curl https://ci.appveyor.com/api/projects/jgm/pandoc | jq '.build.jobs[]| select(.name|test("i386")) | .jobId') && \
95− wget "https://ci.appveyor.com/api/buildjobs/$$JOBID/artifacts/windows%2F$@" -O $@
96−
97−pandoc-windows-x86_64.msi:
98− JOBID=$(shell curl https://ci.appveyor.com/api/projects/jgm/pandoc | jq '.build.jobs[]| select(.name|test("x86_64")) | .jobId') && \
99− wget "https://ci.appveyor.com/api/buildjobs/$$JOBID/artifacts/windows%2F$@" -O $@
100
101
101man/pandoc.1: MANUAL.txt man/pandoc.1.before man/pandoc.1.after
102man/pandoc.1: MANUAL.txt man/pandoc.1.before man/pandoc.1.after
102− pandoc $< -f markdown-smart -t man -s \
103+ pandoc $< -f markdown -t man -s \
103 --lua-filter man/manfilter.lua \
104 --lua-filter man/manfilter.lua \
104 --include-before-body man/pandoc.1.before \
105 --include-before-body man/pandoc.1.before \
105 --include-after-body man/pandoc.1.after \
106 --include-after-body man/pandoc.1.after \
@@ -107,16 +108,8 @@ man/pandoc.1: MANUAL.txt man/pandoc.1.before man/pandoc.1.after
107 --variable footer="pandoc $(version)" \
108 --variable footer="pandoc $(version)" \
108 -o $@
109 -o $@
109
110
110−doc/lua-filters.md: tools/ldoc.ltp data/pandoc.lua tools/update-lua-docs.lua
111− cp $@ $@.tmp
112− pandoc -t markdown --columns=64 --atx-headers \
113− -f markdown -t markdown --standalone\
114− --lua-filter tools/update-lua-docs.lua \
115− -o $@ $@.tmp
116− rm $@.tmp
117−
118README.md: README.template MANUAL.txt tools/update-readme.lua
111README.md: README.template MANUAL.txt tools/update-readme.lua
119− pandoc --lua-filter tools/update-readme.lua --reference-links \
112+ pandoc --lua-filter tools/update-readme.lua \
120 --reference-location=section -t gfm $< -o $@
113 --reference-location=section -t gfm $< -o $@
121
114
122download_stats:
115download_stats:
@@ -125,9 +118,9 @@ download_stats:
125
118
126pandoc-templates:
119pandoc-templates:
127 rm ../pandoc-templates/default.* ; \
120 rm ../pandoc-templates/default.* ; \
128− cp data/templates/default.* ../pandoc-templates/ ; \
121+ cp data/templates/* ../pandoc-templates/ ; \
129 pushd ../pandoc-templates/ && \
122 pushd ../pandoc-templates/ && \
130− git add default.* && \
123+ git add * && \
131 git commit -m "Updated templates for pandoc $(version)" && \
124 git commit -m "Updated templates for pandoc $(version)" && \
132 popd
125 popd
133
126
@@ -142,4 +135,14 @@ update-website:
142clean:
135clean:
143 stack clean
136 stack clean
144
137
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+
145−.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
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
README.md+125−108
@@ -8,11 +8,10 @@ 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)](http://hackage.haskell.org/package/pandoc)
11+release](https://img.shields.io/hackage/v/pandoc.svg?label=hackage)](https://hackage.haskell.org/package/pandoc)
12−[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](http://brewformulas.org/Pandoc)
12+[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](https://formulae.brew.sh/formula/pandoc)
13[![stackage LTS
13[![stackage LTS
14−package](http://stackage.org/package/pandoc/badge/lts)](http://stackage.org/lts/package/pandoc)
14+package](https://stackage.org/package/pandoc/badge/lts)](https://www.stackage.org/lts/package/pandoc-types)
15−[![CircleCI](https://circleci.com/gh/jgm/pandoc.svg?style=svg)](https://circleci.com/gh/jgm/pandoc)
16[![CI
15[![CI
17tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
16tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
18[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
17[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
@@ -21,64 +20,71 @@ groups](https://img.shields.io/badge/pandoc-discuss-red.svg?style=social)](https
21
20
22## The universal markup converter
21## The universal markup converter
23
22
24−Pandoc is a [Haskell](http://haskell.org) library for converting from
23+Pandoc is a [Haskell](https://haskell.org) library for converting from
25one markup format to another, and a command-line tool that uses this
24one markup format to another, and a command-line tool that uses this
26library. It can convert *from*
25library. It can convert *from*
27
26
28<div id="input-formats">
27<div id="input-formats">
29
28
29+- `bibtex` ([BibTeX](https://ctan.org/pkg/bibtex) bibliography)
30+- `biblatex` ([BibLaTeX](https://ctan.org/pkg/biblatex) bibliography)
30− - `commonmark` ([CommonMark](http://commonmark.org) Markdown)
31+- `commonmark` ([CommonMark](https://commonmark.org) Markdown)
32+- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with
33+ extensions)
31− - `creole` ([Creole 1.0](http://www.wikicreole.org/wiki/Creole1.0))
34+- `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− - `docbook` ([DocBook](http://docbook.org))
39+- `docbook` ([DocBook](https://docbook.org))
33− - `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
40+- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
34− - `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
41+- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
35− - `epub` ([EPUB](http://idpf.org/epub))
42+- `epub` ([EPUB](http://idpf.org/epub))
36− - `fb2`
43+- `fb2`
37 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
44 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
38 e-book)
45 e-book)
39− - `gfm` ([GitHub-Flavored
46+- `gfm` ([GitHub-Flavored
40 Markdown](https://help.github.com/articles/github-flavored-markdown/)),
47 Markdown](https://help.github.com/articles/github-flavored-markdown/)),
41 or the deprecated and less accurate `markdown_github`; use
48 or the deprecated and less accurate `markdown_github`; use
42 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
49 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
43 only if you need extensions not supported in
50 only if you need extensions not supported in
44 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
51 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
45− - `haddock` ([Haddock
52+- `haddock` ([Haddock
46 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
53 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
47− - `html` ([HTML](http://www.w3.org/html/))
54+- `html` ([HTML](https://www.w3.org/html/))
48− - `ipynb` ([Jupyter
55+- `ipynb` ([Jupyter
49 notebook](https://nbformat.readthedocs.io/en/latest/))
56 notebook](https://nbformat.readthedocs.io/en/latest/))
50− - `jats` ([JATS](https://jats.nlm.nih.gov) XML)
57+- `jats` ([JATS](https://jats.nlm.nih.gov) XML)
51− - `jira`
58+- `jira`
52− ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)
59+ ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence
53 wiki markup)
60 wiki markup)
54− - `json` (JSON version of native AST)
61+- `json` (JSON version of native AST)
55− - `latex` ([LaTeX](http://latex-project.org))
62+- `latex` ([LaTeX](https://www.latex-project.org/))
56− - `markdown` ([Pandoc’s
63+- `markdown` ([Pandoc’s
57 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
64 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
58− - `markdown_mmd`
65+- `markdown_mmd`
59− ([MultiMarkdown](http://fletcherpenney.net/multimarkdown/))
66+ ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
60− - `markdown_phpextra` ([PHP Markdown
67+- `markdown_phpextra` ([PHP Markdown
61 Extra](https://michelf.ca/projects/php-markdown/extra/))
68 Extra](https://michelf.ca/projects/php-markdown/extra/))
62− - `markdown_strict` (original unextended
69+- `markdown_strict` (original unextended
63− [Markdown](http://daringfireball.net/projects/markdown/))
70+ [Markdown](https://daringfireball.net/projects/markdown/))
64− - `mediawiki` ([MediaWiki
71+- `mediawiki` ([MediaWiki
65 markup](https://www.mediawiki.org/wiki/Help:Formatting))
72 markup](https://www.mediawiki.org/wiki/Help:Formatting))
66− - `man` ([roff
67− man](http://man7.org/linux/man-pages/man7/groff_man.7.html))
73+- `man` ([roff man](https://man.cx/groff_man(7)))
68− - `muse` ([Muse](https://amusewiki.org/library/manual))
74+- `muse` ([Muse](https://amusewiki.org/library/manual))
69− - `native` (native Haskell)
75+- `native` (native Haskell)
70− - `odt` ([ODT](http://en.wikipedia.org/wiki/OpenDocument))
76+- `odt` ([ODT](https://en.wikipedia.org/wiki/OpenDocument))
71− - `opml` ([OPML](http://dev.opml.org/spec2.html))
77+- `opml` ([OPML](http://dev.opml.org/spec2.html))
72− - `org` ([Emacs Org mode](http://orgmode.org))
78+- `org` ([Emacs Org mode](https://orgmode.org))
73− - `rst`
79+- `rst`
74− ([reStructuredText](http://docutils.sourceforge.net/docs/ref/rst/introduction.html))
80+ ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
75− - `t2t` ([txt2tags](http://txt2tags.org))
81+- `t2t` ([txt2tags](https://txt2tags.org))
76− - `textile` ([Textile](http://redcloth.org/textile))
82+- `textile` ([Textile](https://www.promptworks.com/textile))
77− - `tikiwiki` ([TikiWiki
83+- `tikiwiki` ([TikiWiki
78 markup](https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax))
84 markup](https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax))
79− - `twiki` ([TWiki
85+- `twiki` ([TWiki
80− markup](http://twiki.org/cgi-bin/view/TWiki/TextFormattingRules))
86+ markup](https://twiki.org/cgi-bin/view/TWiki/TextFormattingRules))
81− - `vimwiki` ([Vimwiki](https://vimwiki.github.io))
87+- `vimwiki` ([Vimwiki](https://vimwiki.github.io))
82
88
83</div>
89</div>
84
90
@@ -86,90 +92,101 @@ It can convert *to*
86
92
87<div id="output-formats">
93<div id="output-formats">
88
94
89− - `asciidoc` ([AsciiDoc](http://www.methods.co.nz/asciidoc/)) or
95+- `asciidoc` ([AsciiDoc](https://www.methods.co.nz/asciidoc/)) or
90 `asciidoctor` ([AsciiDoctor](https://asciidoctor.org/))
96 `asciidoctor` ([AsciiDoctor](https://asciidoctor.org/))
91− - `beamer` ([LaTeX beamer](https://ctan.org/pkg/beamer) slide show)
97+- `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)
92− - `commonmark` ([CommonMark](http://commonmark.org) Markdown)
100+- `commonmark` ([CommonMark](https://commonmark.org) Markdown)
101+- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with
102+ extensions)
93− - `context` ([ConTeXt](http://www.contextgarden.net/))
103+- `context` ([ConTeXt](https://www.contextgarden.net/))
104+- `csljson` ([CSL
105+ JSON](https://citeproc-js.readthedocs.io/en/latest/csl-json/markup.html)
106+ bibliography)
94− - `docbook` or `docbook4` ([DocBook](http://docbook.org) 4)
107+- `docbook` or `docbook4` ([DocBook](https://docbook.org) 4)
95− - `docbook5` (DocBook 5)
108+- `docbook5` (DocBook 5)
96− - `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
109+- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
97− - `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
110+- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
98− - `epub` or `epub3` ([EPUB](http://idpf.org/epub) v3 book)
111+- `epub` or `epub3` ([EPUB](http://idpf.org/epub) v3 book)
99− - `epub2` (EPUB v2)
112+- `epub2` (EPUB v2)
100− - `fb2`
113+- `fb2`
101 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
114 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
102 e-book)
115 e-book)
103− - `gfm` ([GitHub-Flavored
116+- `gfm` ([GitHub-Flavored
104 Markdown](https://help.github.com/articles/github-flavored-markdown/)),
117 Markdown](https://help.github.com/articles/github-flavored-markdown/)),
105 or the deprecated and less accurate `markdown_github`; use
118 or the deprecated and less accurate `markdown_github`; use
106 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
119 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
107 only if you need extensions not supported in
120 only if you need extensions not supported in
108 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
121 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
109− - `haddock` ([Haddock
122+- `haddock` ([Haddock
110 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
123 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
111− - `html` or `html5` ([HTML](http://www.w3.org/html/),
124+- `html` or `html5` ([HTML](https://www.w3.org/html/),
112− i.e. [HTML5](http://www.w3.org/TR/html5/)/XHTML [polyglot
125+ i.e. [HTML5](https://html.spec.whatwg.org/)/XHTML [polyglot
113 markup](https://www.w3.org/TR/html-polyglot/))
126 markup](https://www.w3.org/TR/html-polyglot/))
114− - `html4` ([XHTML](http://www.w3.org/TR/xhtml1/) 1.0 Transitional)
127+- `html4` ([XHTML](https://www.w3.org/TR/xhtml1/) 1.0 Transitional)
115− - `icml` ([InDesign
128+- `icml` ([InDesign
116− ICML](http://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf))
129+ ICML](https://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf))
117− - `ipynb` ([Jupyter
130+- `ipynb` ([Jupyter
118 notebook](https://nbformat.readthedocs.io/en/latest/))
131 notebook](https://nbformat.readthedocs.io/en/latest/))
132+- `jats_archiving` ([JATS](https://jats.nlm.nih.gov) XML, Archiving
133+ and Interchange Tag Set)
134+- `jats_articleauthoring` ([JATS](https://jats.nlm.nih.gov) XML,
135+ Article Authoring Tag Set)
119− - `jats` ([JATS](https://jats.nlm.nih.gov) XML)
136+- `jats_publishing` ([JATS](https://jats.nlm.nih.gov) XML, Journal
137+ Publishing Tag Set)
138+- `jats` (alias for `jats_archiving`)
120− - `jira`
139+- `jira`
121− ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)
140+ ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence
122 wiki markup)
141 wiki markup)
123− - `json` (JSON version of native AST)
142+- `json` (JSON version of native AST)
124− - `latex` ([LaTeX](http://latex-project.org))
143+- `latex` ([LaTeX](https://www.latex-project.org/))
125− - `man` ([roff
126− man](http://man7.org/linux/man-pages/man7/groff_man.7.html))
144+- `man` ([roff man](https://man.cx/groff_man(7)))
127− - `markdown` ([Pandoc’s
145+- `markdown` ([Pandoc’s
128 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
146 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
129− - `markdown_mmd`
147+- `markdown_mmd`
130− ([MultiMarkdown](http://fletcherpenney.net/multimarkdown/))
148+ ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
131− - `markdown_phpextra` ([PHP Markdown
149+- `markdown_phpextra` ([PHP Markdown
132 Extra](https://michelf.ca/projects/php-markdown/extra/))
150 Extra](https://michelf.ca/projects/php-markdown/extra/))
133− - `markdown_strict` (original unextended
151+- `markdown_strict` (original unextended
134− [Markdown](http://daringfireball.net/projects/markdown/))
152+ [Markdown](https://daringfireball.net/projects/markdown/))
135− - `mediawiki` ([MediaWiki
153+- `mediawiki` ([MediaWiki
136 markup](https://www.mediawiki.org/wiki/Help:Formatting))
154 markup](https://www.mediawiki.org/wiki/Help:Formatting))
137− - `ms` ([roff
138− ms](http://man7.org/linux/man-pages/man7/groff_ms.7.html))
155+- `ms` ([roff ms](https://man.cx/groff_ms(7)))
139− - `muse` ([Muse](https://amusewiki.org/library/manual)),
156+- `muse` ([Muse](https://amusewiki.org/library/manual)),
140− - `native` (native Haskell),
157+- `native` (native Haskell),
141− - `odt` ([OpenOffice text
158+- `odt` ([OpenOffice text
142− document](http://en.wikipedia.org/wiki/OpenDocument))
159+ document](https://en.wikipedia.org/wiki/OpenDocument))
143− - `opml` ([OPML](http://dev.opml.org/spec2.html))
160+- `opml` ([OPML](http://dev.opml.org/spec2.html))
144− - `opendocument` ([OpenDocument](http://opendocument.xml.org))
161+- `opendocument` ([OpenDocument](http://opendocument.xml.org))
145− - `org` ([Emacs Org mode](http://orgmode.org))
162+- `org` ([Emacs Org mode](https://orgmode.org))
146− - `pdf` ([PDF](https://www.adobe.com/pdf/))
163+- `pdf` ([PDF](https://www.adobe.com/pdf/))
147− - `plain` (plain text),
164+- `plain` (plain text),
148− - `pptx`
165+- `pptx`
149 ([PowerPoint](https://en.wikipedia.org/wiki/Microsoft_PowerPoint)
166 ([PowerPoint](https://en.wikipedia.org/wiki/Microsoft_PowerPoint)
150 slide show)
167 slide show)
151− - `rst`
168+- `rst`
152− ([reStructuredText](http://docutils.sourceforge.net/docs/ref/rst/introduction.html))
169+ ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
153− - `rtf` ([Rich Text
170+- `rtf` ([Rich Text
154− Format](http://en.wikipedia.org/wiki/Rich_Text_Format))
171+ Format](https://en.wikipedia.org/wiki/Rich_Text_Format))
155− - `texinfo` ([GNU Texinfo](http://www.gnu.org/software/texinfo/))
172+- `texinfo` ([GNU Texinfo](https://www.gnu.org/software/texinfo/))
156− - `textile` ([Textile](http://redcloth.org/textile))
173+- `textile` ([Textile](https://www.promptworks.com/textile))
157− - `slideous` ([Slideous](http://goessner.net/articles/slideous/) HTML
174+- `slideous` ([Slideous](https://goessner.net/articles/slideous/) HTML
158 and JavaScript slide show)
175 and JavaScript slide show)
159− - `slidy` ([Slidy](http://www.w3.org/Talks/Tools/Slidy/) HTML and
176+- `slidy` ([Slidy](https://www.w3.org/Talks/Tools/Slidy2/) HTML and
160 JavaScript slide show)
177 JavaScript slide show)
161− - `dzslides` ([DZSlides](http://paulrouget.com/dzslides/) HTML5 +
178+- `dzslides` ([DZSlides](https://paulrouget.com/dzslides/) HTML5 +
162 JavaScript slide show),
179 JavaScript slide show),
163− - `revealjs` ([reveal.js](http://lab.hakim.se/reveal-js/) HTML5 +
180+- `revealjs` ([reveal.js](https://revealjs.com/) HTML5 + JavaScript
164− JavaScript slide show)
181+ slide show)
165− - `s5` ([S5](http://meyerweb.com/eric/tools/s5/) HTML and JavaScript
182+- `s5` ([S5](https://meyerweb.com/eric/tools/s5/) HTML and JavaScript
166 slide show)
183 slide show)
167− - `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple))
184+- `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple))
168− - `xwiki` ([XWiki
185+- `xwiki` ([XWiki
169 markup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/))
186 markup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/))
170− - `zimwiki` ([ZimWiki
187+- `zimwiki` ([ZimWiki
171− markup](http://zim-wiki.org/manual/Help/Wiki_Syntax.html))
188+ markup](https://zim-wiki.org/manual/Help/Wiki_Syntax.html))
172− - the path of a custom lua writer, see [Custom
189+- the path of a custom Lua writer, see [Custom
173 writers](https://pandoc.org/MANUAL.html#custom-writers) below
190 writers](https://pandoc.org/MANUAL.html#custom-writers) below
174
191
175</div>
192</div>
@@ -188,7 +205,7 @@ convert this native representation into a target format. Thus, adding an
188input or output format requires only adding a reader or writer. Users
205input or output format requires only adding a reader or writer. Users
189can also run custom pandoc filters to modify the intermediate AST (see
206can also run custom pandoc filters to modify the intermediate AST (see
190the documentation for [filters](https://pandoc.org/filters.html) and
207the documentation for [filters](https://pandoc.org/filters.html) and
191−[lua filters](https://pandoc.org/lua-filters.html)).
208+[Lua filters](https://pandoc.org/lua-filters.html)).
192
209
193Because pandoc’s intermediate representation of a document is less
210Because pandoc’s intermediate representation of a document is less
194expressive than many of the formats it converts between, one should not
211expressive than many of the formats it converts between, one should not
@@ -221,7 +238,7 @@ opening a new issue.
221
238
222## License
239## License
223
240
224−© 2006-2018 John MacFarlane (jgm@berkeley.edu). Released under the
241+© 2006-2021 John MacFarlane (jgm@berkeley.edu). Released under the
225−[GPL](http://www.gnu.org/copyleft/gpl.html "GNU General Public License"),
242+[GPL](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html "GNU General Public License"),
226version 2 or greater. This software carries no warranty of any kind.
243version 2 or greater. This software carries no warranty of any kind.
227(See COPYRIGHT for full copyright and warranty notices.)
244(See COPYRIGHT for full copyright and warranty notices.)
README.template+7−8
@@ -7,10 +7,9 @@ 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)](http://hackage.haskell.org/package/pandoc)
10+[![hackage release](https://img.shields.io/hackage/v/pandoc.svg?label=hackage)](https://hackage.haskell.org/package/pandoc)
11−[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](http://brewformulas.org/Pandoc)
11+[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](https://formulae.brew.sh/formula/pandoc)
12−[![stackage LTS package](http://stackage.org/package/pandoc/badge/lts)](http://stackage.org/lts/package/pandoc)
12+[![stackage LTS package](https://stackage.org/package/pandoc/badge/lts)](https://www.stackage.org/lts/package/pandoc-types)
13−[![CircleCI](https://circleci.com/gh/jgm/pandoc.svg?style=svg)](https://circleci.com/gh/jgm/pandoc)
14[![CI tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
13[![CI tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
15[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
14[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
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)
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)
@@ -44,7 +43,7 @@ this native representation into a target format. Thus, adding an input
44or output format requires only adding a reader or writer. Users can also
43or output format requires only adding a reader or writer. Users can also
45run custom pandoc filters to modify the intermediate AST (see
44run custom pandoc filters to modify the intermediate AST (see
46the documentation for [filters](https://pandoc.org/filters.html)
45the documentation for [filters](https://pandoc.org/filters.html)
47−and [lua filters](https://pandoc.org/lua-filters.html)).
46+and [Lua filters](https://pandoc.org/lua-filters.html)).
48
47
49Because pandoc's intermediate representation of a document is less
48Because pandoc's intermediate representation of a document is less
50expressive than many of the formats it converts between, one should
49expressive than many of the formats it converts between, one should
@@ -82,9 +81,9 @@ new issue.
82License
81License
83-------
82-------
84
83
85−© 2006-2018 John MacFarlane (jgm@berkeley.edu). Released under the
84+© 2006-2021 John MacFarlane (jgm@berkeley.edu). Released under the
86[GPL], version 2 or greater. This software carries no warranty of
85[GPL], version 2 or greater. This software carries no warranty of
87any kind. (See COPYRIGHT for full copyright and warranty notices.)
86any kind. (See COPYRIGHT for full copyright and warranty notices.)
88
87
89−[GPL]: http://www.gnu.org/copyleft/gpl.html "GNU General Public License"
88+[GPL]: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html "GNU General Public License"
90−[Haskell]: http://haskell.org
89+[Haskell]: https://haskell.org
RELEASE-CHECKLIST+3−1
@@ -1,9 +1,11 @@
1+[ ] use 'policeman' to check API changes and version update
1[ ] make README.md and commit if needed
2[ ] make README.md and commit if needed
2[ ] make man/pandoc.1 and commit if needed
3[ ] make man/pandoc.1 and commit if needed
3[ ] Finalize changelog
4[ ] 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
7[ ] Use 'make' in macos and windows artifacts to sign code
9[ ] Use 'make' in macos and windows artifacts to sign code
8[ ] make update-website
10[ ] make update-website
9[ ] make trypandoc
11[ ] make trypandoc
SECURITY.mdnew file+12
@@ -0,0 +1,12 @@
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.
pandoc.hs → app/pandoc.hsrenamed+1−3
@@ -1,7 +1,6 @@
1−{-# LANGUAGE NoImplicitPrelude #-}
2{- |
1{- |
3 Module : Main
2 Module : Main
4− Copyright : Copyright (C) 2006-2018 John MacFarlane
3+ Copyright : Copyright (C) 2006-2021 John MacFarlane
5 License : GNU GPL, version 2 or above
4 License : GNU GPL, version 2 or above
6
5
7 Maintainer : John MacFarlane <jgm@berkeley@edu>
6 Maintainer : John MacFarlane <jgm@berkeley@edu>
@@ -12,7 +11,6 @@ Parses command-line options and calls the appropriate readers and
12writers.
11writers.
13-}
12-}
14module Main where
13module Main where
15−import Prelude
16import qualified Control.Exception as E
14import qualified Control.Exception as E
17import Text.Pandoc.App (convertWithOpts, defaultOpts, options, parseOptions)
15import Text.Pandoc.App (convertWithOpts, defaultOpts, options, parseOptions)
18import Text.Pandoc.Error (handleError)
16import Text.Pandoc.Error (handleError)
benchmark/benchmark-pandoc.hs+63−72
@@ -1,8 +1,6 @@
1−{-# LANGUAGE NoImplicitPrelude #-}
2{-# LANGUAGE OverloadedStrings #-}
1{-# LANGUAGE OverloadedStrings #-}
3−{-# LANGUAGE TupleSections #-}
4{-
2{-
5−Copyright (C) 2012-2019 John MacFarlane <jgm@berkeley.edu>
3+Copyright (C) 2012-2021 John MacFarlane <jgm@berkeley.edu>
6
4
7This program is free software; you can redistribute it and/or modify
5This program is free software; you can redistribute it and/or modify
8it under the terms of the GNU General Public License as published by
6it under the terms of the GNU General Public License as published by
@@ -18,95 +16,88 @@ You should have received a copy of the GNU General Public License
18along with this program; if not, write to the Free Software
16along with this program; if not, write to the Free Software
19Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20-}
18-}
21−import Prelude
22import Text.Pandoc
19import Text.Pandoc
23import Text.Pandoc.MIME
20import Text.Pandoc.MIME
24−import Text.Pandoc.Error (PandocError(..))
21+import Control.DeepSeq (force)
25import Control.Monad.Except (throwError)
22import Control.Monad.Except (throwError)
26import qualified Text.Pandoc.UTF8 as UTF8
23import qualified Text.Pandoc.UTF8 as UTF8
27import qualified Data.ByteString as B
24import qualified Data.ByteString as B
28import qualified Data.Text as T
25import qualified Data.Text as T
29−import Criterion.Main
26+import Test.Tasty.Bench
30−import Criterion.Types (Config(..))
27+-- import Gauge
31−import Data.List (intersect)
32−import Data.Maybe (mapMaybe)
33−import System.Environment (getArgs)
34import qualified Data.ByteString.Lazy as BL
28import qualified Data.ByteString.Lazy as BL
29+import Data.Maybe (mapMaybe)
30+import Data.List (sortOn)
35
31
36readerBench :: Pandoc
32readerBench :: Pandoc
37 -> T.Text
33 -> T.Text
38 -> Maybe Benchmark
34 -> Maybe Benchmark
39−readerBench doc name =
35+readerBench _ name
40− case res of
36+ | name `elem` ["bibtex", "biblatex", "csljson"] = Nothing
41− Right (readerFun, inp) ->
37+readerBench doc name = either (const Nothing) Just $
42− Just $ bench (T.unpack $ name <> " reader")
43− $ nf (\i -> either (error . show) id $ runPure (readerFun i))
44− inp
45− Left _ -> Nothing
46− where res = runPure $ do
38+ runPure $ do
47− (rdr, rexts) <- getReader name
39+ (rdr, rexts) <- getReader name
48− (wtr, wexts) <- getWriter name
40+ (wtr, wexts) <- getWriter name
49− case (rdr, wtr) of
41+ case (rdr, wtr) of
50− (TextReader r, TextWriter w) -> do
42+ (TextReader r, TextWriter w) -> do
51− setResourcePath ["../test"]
43+ inp <- w def{ writerWrapText = WrapAuto
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
52− inp <- w def{ writerWrapText = WrapAuto
49+ inp <- w def{ writerWrapText = WrapAuto
53− , writerExtensions = wexts } doc
50+ , writerExtensions = wexts
51+ , writerTemplate = tmpl } doc
52+ return $ bench (T.unpack name) $
53+ nf (either (error . show) id .
54− return $ (r def{ readerExtensions = rexts }, inp)
54+ runPure . r def{readerExtensions = rexts}) inp
55− _ -> throwError $ PandocSomeError $ "not a text format: "
55+ _ -> throwError $ PandocSomeError $ "text/bytestring format mismatch: "
56− <> name
56+ <> name
57
57
58getImages :: IO [(FilePath, MimeType, BL.ByteString)]
58getImages :: IO [(FilePath, MimeType, BL.ByteString)]
59getImages = do
59getImages = do
60− ll <- BL.readFile "test/lalune.jpg"
60+ ll <- B.readFile "test/lalune.jpg"
61− mv <- BL.readFile "test/movie.jpg"
61+ mv <- B.readFile "test/movie.jpg"
62− return [("lalune.jpg", "image/jpg", ll)
62+ return [("lalune.jpg", "image/jpg", BL.fromStrict ll)
63− ,("movie.jpg", "image/jpg", mv)]
63+ ,("movie.jpg", "image/jpg", BL.fromStrict mv)]
64
64
65+writerBench :: [(FilePath, MimeType, BL.ByteString)]
65−writerBench :: Pandoc
66+ -> Pandoc
66 -> T.Text
67 -> T.Text
67 -> Maybe Benchmark
68 -> Maybe Benchmark
68−writerBench doc name =
69+writerBench _ _ 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
69− case res of
74+ case wtr of
70− Right writerFun ->
75+ TextWriter writerFun ->
71− Just $ env getImages $ \imgs ->
76+ return $ bench (T.unpack name)
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 ->
72− bench (T.unpack $ name <> " writer")
83+ return $ bench (T.unpack name)
73 $ nf (\d -> either (error . show) id $
84 $ nf (\d -> either (error . show) id $
74− runPure (do mapM_
85+ runPure $ do
75− (\(fp, mt, bs) ->
76− insertMedia fp (Just mt) bs)
86+ mapM_ (\(fp,mt,bs) -> insertMedia fp (Just mt) bs) imgs
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 ->
84− return $ w def{ writerExtensions = wexts }
87+ writerFun def{ writerExtensions = wexts} d)
85− _ -> throwError $ PandocSomeError
88+ doc
86− $ "could not get text writer for " <> name
87
89
88main :: IO ()
90main :: IO ()
89main = do
91main = 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)])
102 inp <- UTF8.toText <$> B.readFile "test/testsuite.txt"
92 inp <- UTF8.toText <$> B.readFile "test/testsuite.txt"
103 let opts = def
93 let opts = def
104− let doc = either (error . show) id $ runPure $ readMarkdown opts inp
94+ let doc = either (error . show) force $ runPure $ readMarkdown opts inp
105− let readerBs = mapMaybe (readerBench doc)
95+ defaultMain
106− $ filter (/="haddock")
96+ [ env getImages $ \imgs ->
107− (matchedReaders `intersect` matchedWriters)
108− -- we need the corresponding writer to generate
109− -- input for the reader
110− let writerBs = mapMaybe (writerBench doc) matchedWriters
97+ bgroup "writers" $ mapMaybe (writerBench imgs doc . fst)
111− defaultMainWith defaultConfig{ timeLimit = 6.0 }
98+ (sortOn fst
112− (writerBs ++ readerBs)
99+ writers :: [(T.Text, Writer PandocPure)])
100+ , bgroup "readers" $ mapMaybe (readerBench doc . fst)
101+ (sortOn fst
102+ readers :: [(T.Text, Reader PandocPure)])
103+ ]
benchmark/weigh-pandoc.hsdeleted−52
@@ -1,52 +0,0 @@
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
51−
52−
cabal.project+9−10
@@ -1,14 +1,13 @@
1packages: pandoc.cabal
1packages: pandoc.cabal
2+tests: True
3+flags: +embed_data_files
2
4
3−package pandoc
5+source-repository-package
4− flags: +embed_data_files -trypandoc
6+ type: git
5− ghc-options: -j +RTS -A64m -RTS
7+ location: https://github.com/jgm/doctemplates
6−
8+ tag: 428c26d5303cf7a2b1051fe1ffd9aafe9ba71c81
7−package pandoc-citeproc
8− flags: +embed_data_files +bibutils -unicode_collation -test_citeproc -debug
9− ghc-options: -j +RTS -A64m -RTS
10
9
11source-repository-package
10source-repository-package
12− type: git
11+ type: git
13− location: https://github.com/jgm/pandoc-citeproc
12+ location: https://github.com/jgm/citeproc
14− tag: 0.16.4.1
13+ tag: 4ce0501cd6f9c86eee087afcf878c256e49b9615
changelog.md+3437−20
@@ -1,5 +1,3422 @@
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)
3075+
3076+ * Markdown reader: Fix table alignment when heading begins with t (#6153).
3077+ Due to a typo (`t` instead of `\t`) we were center aligning column
3078+ headings that begin with a lowercase `t`!
3079+
3080+ * Text.Pandoc.Readers.Roff:
3081+
3082+ + Fix parsing of `\.` in man/ms readers (#6175).
3083+ Previously due to a typo it was being parsed as `` ` ``.
3084+ + Fix parsing of `\'` in man/ms readers (#6175). It was being parsed
3085+ as a backtick.
3086+
3087+ * Jira reader (Albert Krewinkel):
3088+
3089+ + Fix parsing of tables without preceding blankline (#6198).
3090+ A bug was fixed which caused faulty parsing if a table was not
3091+ preceded by a newline and the first table cell had no space
3092+ after the initial `|` characters.
3093+ + Fix parsing of strikeout, emphasis (#6196). A bug was fixed which
3094+ caused non-emphasized text containing digits and/or non-special
3095+ symbols (like dots) to sometimes be parsed incorrectly.
3096+ + Support colored inline text, indented lists (#6183, #6184).
3097+
3098+ * Ms writer:
3099+
3100+ + Fix definition lists so indent even when paragraph indent is
3101+ set to 0 (as is the default). Also ensure indent for display math
3102+ that falls back to TeX.
3103+ + Use `.QS/.QE` instead of `.RS/.RE` for block quotes.
3104+
3105+ * EPUB writer: fix regression on detection of front/back/bodymatter
3106+ (#6170). This bug caused sections with epub:type `dedication` to be
3107+ misplaced in bodymatter instead of frontmatter as specified
3108+ in the manual. The same problem would affect other epub:types.
3109+ The pattern matching needed to be changed with the use of
3110+ `makeSection`.
3111+
3112+ * AsciiDoc writer: remove redundant `otherwise` guard in
3113+ `inlineToAsciiDoc` (#6146, Ryan Scott).
3114+
3115+ * Text.Pandoc.Class:
3116+
3117+ + Fix missing import when data files are not embedded (Albert Krewinkel).
3118+ + Subdivide Text.Pandoc.Class into small unexported modules
3119+ and ensure that all functions have Haddock documentation (#6106,
3120+ Albert Krewinkel).
3121+ + Finer grained imports of Text.Pandoc.Class submodules (#6203, Albert
3122+ Krewinkel).
3123+
3124+ * Text.Pandoc.XML: Add to list of HTML5 attributes:
3125+ `allow`, `autocapitalize`, `decoding`, `enterkeyhint`,
3126+ `imagesizes`, `imagesrcset`, `loading`.
3127+
3128+ * Use implicit Prelude (#6187, Albert Krewinkel).
3129+ The previous behavior was introduced as a fix for #4464. It seems that
3130+ this change alone did not fix the issue, and `stack ghci` and `cabal
3131+ repl` only work with GHC 8.4.1 or newer, as no custom Prelude is loaded
3132+ for these versions. Given this, it seems cleaner to revert to the
3133+ implicit Prelude.
3134+
3135+ * Always use custom prelude (#6187, Albert Krewinkel).
3136+ Previously, the custom prelude was used only with older GHC versions, as
3137+ a workaround for problems with ghci. The ghci problems are resolved by
3138+ replacing package `base` with `base-noprelude`, allowing for consistent
3139+ use of the custom prelude across all GHC versions.
3140+
3141+ * Remove outdated checks for no longer supported base versions
3142+ (Albert Krewinkel).
3143+
3144+ * PDF via wkhtmltopdf: put user-specified options last (#6171).
3145+ Certain options (e.g. `cover`) need to come after flags on
3146+ the command line.
3147+
3148+ * Text.Pandoc.App: set resource path at the beginning so it can affect
3149+ things like include-in-header (#5982).
3150+
3151+ * Change macOS release candidate CI process so that notarized
3152+ packages can be produced (#6169).
3153+
3154+ * Make MANUAL more explicit about nonbreaking space handling by
3155+ `all_symbols_escapable` (#6154, Fabien Schurter).
3156+
3157+ * trypandoc (Mike Tzou):
3158+
3159+ + Add checkbox for standalone option (#6189).
3160+ + Use strict mode for JavaScript code (#6188).
3161+ + Fetch resources over https (#6188).
3162+ + Remove unnecessary attributes on style, script elements (#6188).
3163+
3164+ * Use details tag to make GitHub releases changelog collapsible.
3165+
3166+ * Update filter code in doc/filters.md so it works with latest pandoc
3167+ (#6185).
3168+
3169+ * linux/Dockerfile: upgrade to alpine 3.11 (#6180, Albert Krewinkel).
3170+ This is used to build the static linux binaries.
3171+
3172+
3173+## pandoc 2.9.2 (2020-02-15)
3174+
3175+ * Add `csv` as an input format (#6100). The CSV table is converted into a
3176+ pandoc simple table. A new module Text.Pandoc.Readers.CSV
3177+ exports `readCSV` [API change].
3178+
3179+ * Introduce new format variants for JATS writer (#6014, Albert Krewinkel):
3180+
3181+ - `jats_archiving` for the "Archiving and Interchange Tag Set",
3182+ - `jats_publishing` for the "Journal Publishing Tag Set", and
3183+ - `jats_articleauthoring` for the "Article Authoring Tag Set."
3184+
3185+ The `jats` output format is now an alias for `jats_archiving`.
3186+ The module Text.Pandoc.Writers.JATS now exports
3187+ `writeJatsArchiving`, `writeJatsPublishing`, and
3188+ `writeJatsArticleAuthoring`, as well as the legacy
3189+ `writeJATS` [API change].
3190+
3191+ * `--defaults`: Support `bibliography` and `csl` fields.
3192+ Move `addMeta` from Text.Pandoc.App.CommandLineOptions to
3193+ Text.Pandoc.App.Opt (internal change).
3194+
3195+ * Add timing info for filters in `--verbose` mode (#6112).
3196+ When verbose mode is specified (verbosity == INFO), print a
3197+ notice when running a filter and when a filter completes (including
3198+ timing).
3199+
3200+ * LaTeX reader:
3201+
3202+ + Allow `&` in LaTeX citation keys (#6110).
3203+ + Improve caption and label parsing.
3204+ + Don't emit empty Span elements for labels.
3205+ + Put tables with labels in a surrounding Div.
3206+ + Resolve `\ref` to table numbers (#6137).
3207+ + Skip comments in more places where this is needed (#6114).
3208+ + Allow beamer overlays for all commands in all raw tex (#6043).
3209+ This affects parsing of raw tex in LaTeX and in Markdown and
3210+ other formats.
3211+ + Improve parsing of raw environments (#6034). If parsing fails
3212+ in a raw environment (e.g. due to special characters like unescaped
3213+ `_`), try again as a verbatim environment, which is less sensitive to
3214+ special characters. This allows us to capture special environments
3215+ that change catcodes as raw tex when `-f latex+raw_tex` is used.
3216+
3217+ * RST reader:
3218+
3219+ + Add highlight directive (#6140, Lucas Escot).
3220+
3221+ * MediaWiki writer:
3222+
3223+ + Prevent triple `[[[` which confuses MediaWiki (#6119).
3224+
3225+ * HTML reader:
3226+
3227+ + Don't parse `data-id` as `id` attribute. And similarly don't
3228+ parse any `data-X` as `X` when `X` is a valid HTML attribute.
3229+
3230+ * Org reader:
3231+
3232+ + Simplify parsing of sub- and superscripts (#6127, Albert Krewinkel).
3233+ Speeds up parsing of single-word, markup-less sub- and superscripts.
3234+
3235+ * LaTeX writer:
3236+
3237+ + Group biblatex citations even with prefix and suffix (#5849, Ethan
3238+ Riley). Previously biblatex citations were only grouped if there
3239+ was no prefix. This patch allows them to be grouped in subgroups split
3240+ by prefixes and suffixes, which allows better citation sorting.
3241+ + Fix regression in handling of columns in beamer slides (#6033).
3242+ Columns in title slides were causing problems with
3243+ slide division.
3244+ + Fix duplicate frame classes in LaTeX/Beamer output (#6107).
3245+
3246+ * HTML writer:
3247+
3248+ + Fix duplicate attributes on headings (#6062), regression from 2.7.x.
3249+ + Fix `--number-offset` with HTML TOC. Eventually it would be worth
3250+ adding a parameter to `makeSections` so this could be done at that
3251+ level; then it would also affect other writers that construct
3252+ TOC manually.
3253+ + reveal.js: restore old behavior for 2D nesting (#6032).
3254+ The fix to #6030 actually changed behavior, so that the
3255+ 2D nesting occurred at slide level N-1 and N, instead of
3256+ at the top-level section. This commit restores the v2.7.3 behavior.
3257+ If there are more than 2 levels, the top level is horizontal
3258+ and the rest are collapsed to vertical.
3259+ + reveal.js: ensure that pauses work even in title slides (#5819).
3260+
3261+ * Markdown writer:
3262+
3263+ + Fix regression: spurious dots in markdown_mmd metadata output (#6133).
3264+
3265+ * Docx writer:
3266+
3267+ + Fix regression with Compact style on tight lists (#6072).
3268+ Starting in 2.8, the docx writer no longer distinguishes between tight
3269+ and loose lists, since the Compact style is omitted. This is a
3270+ side-effect of the fix to #5670, as explained in the changelog. This
3271+ patch fixes the problem by extending the exception currently offered to
3272+ Plain blocks inside tables to Plain blocks inside list items.
3273+
3274+ * Jira writer:
3275+
3276+ + Fix output of table headers (Albert Krewinkel, #6035).
3277+
3278+ * Add Text.Pandoc.Image with unexported svgToPng.
3279+
3280+ * Text.Pandoc.XML: Export `html5Attributes`, `html4Attributes`,
3281+ `rdfaAttributes` (formerly unexported in Text.Pandoc.Writers.HTML).
3282+ [API change]
3283+
3284+ * Text.Pandoc.Shared: Export a new function `findM` (#6125,
3285+ Joseph C. Sible).
3286+
3287+ * Text.Pandoc.Logging: Add `RunningFilter`, `FilterCompleted`
3288+ constructors to LogMessage [API change].
3289+
3290+ * Text.Pandoc.CSV: fix bug in CSV parser; previously an extra blank record
3291+ would sometimes be inserted at the end.
3292+
3293+ * LaTeX template: add space option to xeCJK with PassOptionsToPackage
3294+ (#6002). Otherwise we can get a clash with documentclasses that
3295+ already load the package.
3296+
3297+ * Lua filters:
3298+
3299+ + Allow filtering of element lists (#6038, Albert Krewinkel). Lists of
3300+ Inline and Block elements can now be filtered via `Inlines` and
3301+ `Blocks` functions, respectively. This is helpful if a filter
3302+ conversion depends on the order of elements rather than a single
3303+ element. For example, the following filter can be used to remove all
3304+ spaces before a citation:
3305+
3306+ function isSpaceBeforeCite (spc, cite)
3307+ return spc and spc.t == 'Space'
3308+ and cite and cite.t == 'Cite'
3309+ end
3310+
3311+ function Inlines (inlines)
3312+ for i = #inlines-1,1,-1 do
3313+ if isSpaceBeforeCite(inlines[i], inlines[i+1]) then
3314+ inlines:remove(i)
3315+ end
3316+ end
3317+ return inlines
3318+ end
3319+
3320+ + Add methods `insert`, `remove`, and `sort` to pandoc.List
3321+ (Albert Krewinkel). Example of use:
3322+
3323+ local numbers = pandoc.List {2, 3, 1}
3324+ numbers:sort() -- numbers is now {1, 2, 3}
3325+ + Make `pandoc.List` a callable constructor (Albert Krewinkel).
3326+ It is now possible to construct a new List via
3327+ `pandoc.List()` instead of `pandoc.List:new()`.
3328+ + Add tests for pandoc.List module (Albert Krewinkel).
3329+
3330+ * Text.Pandoc.App.CommandLineOptions: Change `setVariable` to use `Text`
3331+ instead of `String`. This avoids some unnecessary unpacking.
3332+
3333+ * Use versioned directory for windows release zipfile.
3334+ Also remove old `make-windows-installer.bat`, superseded by GitHub
3335+ actions workflow, and modify `pandoc.wxs` for new paths.
3336+
3337+ * Extensive code cleanup (#6141, #6128, #6129, #6130, #6123,
3338+ #6105, 6102, #6117, #6124, #6115, #6116, #6111, Joseph C. Sible).
3339+
3340+ * Fix hlint warnings (Albert Krewinkel).
3341+
3342+ * Use latest doclayout, doctemplates (#6031). The new version of
3343+ doclayout fixes a memory leak that affected `--include-in-header` with
3344+ large files (and possibly other cases involving extremely long lines).
3345+
3346+ * Use latest texmath.
3347+
3348+ * Use latest skylighting and fix test suite (#6086).
3349+
3350+ * sample.lua: Fix typo in descriptive comments (#6136, Caleb Maclennan).
3351+ Fix typo in error message (#6135).
3352+
3353+ * Add Docker and GH Actions instructions/links to INSTALL.md.
3354+
3355+ * Update filter documentation (#6065). Improve cabal v2 instructions.
3356+ Remove example using pandoc API directly (we have other
3357+ docs for that and it was outdated).
3358+
3359+ * Lua filter docs:
3360+
3361+ + Cross-link constructors and types (Albert Krewinkel).
3362+ Thanks to @bpj for the idea.
3363+ + Sort pandoc.List methods alphabetically (Albert Krewinkel).
3364+ + Unify, fix anchors and internal links (#6061, Albert Krewinkel).
3365+ Links and anchors now follow consistent conventions, like
3366+ lowercase-only anchor names. This breaks some links to specific
3367+ sections in the document, but will make it much easier to link
3368+ documentation in the future.
3369+ + Clarify filter function execution order (#6059, Albert Krewinkel).
3370+
3371+ * In docs, update URLs and use `https:` wherever possible (#6090,
3372+ Salim B).
3373+
3374+## pandoc 2.9.1.1 (2020-01-05)
3375+
3376+ * Markdown reader:
3377+
3378+ + Fix parsing bug affected indented code after raw HTML (#6009, #5360).
3379+
3380+ * LaTeX writer:
3381+
3382+ + Fix regression in beamer slide structure with certain slide levels
3383+ (#6030).
3384+ + Allow framebreaks for beamer's TOC (Heiko Schlittermann, #6012)
3385+ + Properly handle unnumbered headings level 4+ (#6018).
3386+ Previously the `\paragraph` command was used instead of
3387+ `\paragraph*` for unnumbered level 4 headings.
3388+
3389+ * HTML writer:
3390+
3391+ + Fix revealjs slide structure regression with certain slide levels
3392+ (#6030).
3393+ + Add newlines to make slide show output more readable.
3394+
3395+ * Org writer:
3396+
3397+ + Remove extra spaces from table cells (Albert Krewinkel, #6024).
3398+
3399+ * JATS template: Update JATS dtd (Arfon Smith, #6020). Use the archiving
3400+ and interchange DTD rather than the more restrictive journal publishing
3401+ DTD (which doesn't permit ext-link as a valid child).
3402+
3403+ * Text.Pandoc.PDF: Fix `runTeXProgram` so that the input source is always
3404+ overwritten (#6027). Previously it wasn't overridden if the file already
3405+ existed, which led to bad results on subsequent runs when
3406+ `pdf-engine-opt=-output-directory=` was used to specify an explicit temp
3407+ dir.
3408+
3409+ * Text.Pandoc.BCP47: Change `getLang` to handle block-level contents
3410+ (#6008). Some readers (e.g. RST) will populate the `lang` metadata field
3411+ with block-level content. `getLang` has been modified to handle this.
3412+ Previously in these cases the LaTeX writer would not properly set the
3413+ "main language" of the document.
3414+
3415+ * Fix `test/tables.org` (Albert Krewinkel).
3416+
3417+ * Use HTTPS in copyright message (Felix Yan, #6010)
3418+
3419+
3## pandoc 2.9.1 (2019-12-23)
3420## pandoc 2.9.1 (2019-12-23)
4
3421
5 * Add Jira reader (Albert Krewinkel, #5556).
3422 * Add Jira reader (Albert Krewinkel, #5556).
@@ -218,7 +3635,7 @@
218 The main impact of this change is better reflowing of
3635 The main impact of this change is better reflowing of
219 content interpolated into templates. Previously,
3636 content interpolated into templates. Previously,
220 interpolated variables were rendered independently and
3637 interpolated variables were rendered independently and
221− intepolated as strings, which could lead to overly long
3638+ interpolated as strings, which could lead to overly long
222 lines. Now the templates interpolated as Doc values which
3639 lines. Now the templates interpolated as Doc values which
223 may include breaking spaces, and reflowing occurs after
3640 may include breaking spaces, and reflowing occurs after
224 template interpolation rather than before.
3641 template interpolation rather than before.
@@ -697,7 +4114,7 @@
697 a margin and font size according to their level.
4114 a margin and font size according to their level.
698 Furthermore this commit allows changing the font with which code is
4115 Furthermore this commit allows changing the font with which code is
699 formatted via the `monofont` option.
4116 formatted via the `monofont` option.
700− + Start numbering at appopriate numbers (Jesse Rosenthal, #5709).
4117+ + Start numbering at appropriate numbers (Jesse Rosenthal, #5709).
701 Starting numbers for ordered lists were previously ignored. Now
4118 Starting numbers for ordered lists were previously ignored. Now
702 we specify the number if it is something other than 1.
4119 we specify the number if it is something other than 1.
703
4120
@@ -2016,7 +5433,7 @@
2016 * Man/Ms writers: Don't escape `-` as `\-`. The `\-` gets rendered
5433 * Man/Ms writers: Don't escape `-` as `\-`. The `\-` gets rendered
2017 in HTML and PDF as a unicode minus sign.
5434 in HTML and PDF as a unicode minus sign.
2018
5435
2019− * Ms writer: Ensure we have a newline after .EN in disply math (#5251).
5436+ * Ms writer: Ensure we have a newline after .EN in display math (#5251).
2020
5437
2021 * RST writer: Don't wrap simple table header lines (#5128).
5438 * RST writer: Don't wrap simple table header lines (#5128).
2022
5439
@@ -2148,7 +5565,7 @@
2148 + Set default listings language for lua, assembler (#5227, John
5565 + Set default listings language for lua, assembler (#5227, John
2149 MacFarlane). Otherwise we get an error when trying to compile code
5566 MacFarlane). Otherwise we get an error when trying to compile code
2150 with lua or assembler code. To change the default dialect
5567 with lua or assembler code. To change the default dialect
2151− (currenty 5.3 for lua and x86masm for assembler), you can use
5568+ (currently 5.3 for lua and x86masm for assembler), you can use
2152 `--include-in-header` to inject something like
5569 `--include-in-header` to inject something like
2153 `\lstset{defaultdialect=[5.2]Lua}`.
5570 `\lstset{defaultdialect=[5.2]Lua}`.
2154
5571
@@ -5845,7 +9262,7 @@
5845
9262
5846 * Removed `hard_line_breaks` extension from `markdown_github` (#3594).
9263 * Removed `hard_line_breaks` extension from `markdown_github` (#3594).
5847 GitHub has two Markdown modes, one for long-form documents like READMEs
9264 GitHub has two Markdown modes, one for long-form documents like READMEs
5848− and one for short things like issue coments. In issue comments, a line
9265+ and one for short things like issue comments. In issue comments, a line
5849 break is treated as a hard line break. In README, wikis, etc., it is
9266 break is treated as a hard line break. In README, wikis, etc., it is
5850 treated as a space as in regular Markdown. Since pandoc is more likely to
9267 treated as a space as in regular Markdown. Since pandoc is more likely to
5851 be used to convert long-form documents from GitHub Markdown,
9268 be used to convert long-form documents from GitHub Markdown,
@@ -6198,7 +9615,7 @@
6198 top-level `Text.Pandoc` module.
9615 top-level `Text.Pandoc` module.
6199
9616
6200 + Changed `StringWriter` -> `TextWriter`.
9617 + Changed `StringWriter` -> `TextWriter`.
6201− + `getWriter` now retuns a pair of a reader and
9618+ + `getWriter` now returns a pair of a reader and
6202 `Extensions`, instead of building the extensions into the
9619 `Extensions`, instead of building the extensions into the
6203 reader (#3659). The calling code must explicitly set
9620 reader (#3659). The calling code must explicitly set
6204 `readerExtensions` using the `Extensions` returned. The
9621 `readerExtensions` using the `Extensions` returned. The
@@ -7150,7 +10567,7 @@
7150 + Use `unicode-math` (Vaclav Haisman). Use `mathspec` with only
10567 + Use `unicode-math` (Vaclav Haisman). Use `mathspec` with only
7151 XeLaTeX on request.
10568 XeLaTeX on request.
7152 + Don't load `fontspec` before `unicode-math` (over there).
10569 + Don't load `fontspec` before `unicode-math` (over there).
7153− The `unicode-math` package loads `fontspec` so explict loading of
10570+ The `unicode-math` package loads `fontspec` so explicit loading of
7154 `fontspec` before `unicode-math` is not necessary.
10571 `fontspec` before `unicode-math` is not necessary.
7155 + Use `unicode-math` by default in default.latex template. mathspec will
10572 + Use `unicode-math` by default in default.latex template. mathspec will
7156 be used in xelatex if the `mathspec` variable is set; otherwise
10573 be used in xelatex if the `mathspec` variable is set; otherwise
@@ -7831,7 +11248,7 @@
7831 is now used in parsing RST and Markdown line blocks, DocBook
11248 is now used in parsing RST and Markdown line blocks, DocBook
7832 `linegroup`/`line` combinations, and Org-mode `VERSE` blocks.
11249 `linegroup`/`line` combinations, and Org-mode `VERSE` blocks.
7833 Previously `Para` blocks with hard linebreaks were used. `LineBlock`s
11250 Previously `Para` blocks with hard linebreaks were used. `LineBlock`s
7834− are handled specially in the following ouput formats: AsciiDoc
11251+ are handled specially in the following output formats: AsciiDoc
7835 (as `[verse]` blocks), ConTeXt (`\startlines`/`\endlines`),
11252 (as `[verse]` blocks), ConTeXt (`\startlines`/`\endlines`),
7836 HTML (`div` with a style), Markdown (line blocks if `line_blocks`
11253 HTML (`div` with a style), Markdown (line blocks if `line_blocks`
7837 is enabled), Org-mode (`VERSE` blocks), RST (line blocks). In
11254 is enabled), Org-mode (`VERSE` blocks), RST (line blocks). In
@@ -7978,7 +11395,7 @@
7978 comma-separated list.
11395 comma-separated list.
7979 + Give precedence to later meta lines. The last meta-line of any given
11396 + Give precedence to later meta lines. The last meta-line of any given
7980 type is the significant line. Previously the value of the first line
11397 type is the significant line. Previously the value of the first line
7981− was kept, even if more lines of the same type were encounterd.
11398+ was kept, even if more lines of the same type were encountered.
7982 + Read LaTeX_header as header-includes. LaTeX-specific header commands
11399 + Read LaTeX_header as header-includes. LaTeX-specific header commands
7983 can be defined in `#+LaTeX_header` lines. They are parsed as
11400 can be defined in `#+LaTeX_header` lines. They are parsed as
7984 format-specific inlines to ensure that they will only show up in LaTeX
11401 format-specific inlines to ensure that they will only show up in LaTeX
@@ -8026,7 +11443,7 @@
8026 be able to figure out internal links to a header in a docx if the
11443 be able to figure out internal links to a header in a docx if the
8027 anchor span was empty. We change that to read the inlines out of the
11444 anchor span was empty. We change that to read the inlines out of the
8028 first anchor span in a header.
11445 first anchor span in a header.
8029− + Let headers use exisiting id. Previously we always generated an id for
11446+ + Let headers use existing id. Previously we always generated an id for
8030 headers (since they wouldn't bring one from Docx). Now we let it use an
11447 headers (since they wouldn't bring one from Docx). Now we let it use an
8031 existing one if possible. This should allow us to recurs through anchor
11448 existing one if possible. This should allow us to recurs through anchor
8032 spans.
11449 spans.
@@ -8605,7 +12022,7 @@
8605 character. Empty rows where parsed as alignment rows and dropped from
12022 character. Empty rows where parsed as alignment rows and dropped from
8606 the output.
12023 the output.
8607 + Fix spacing after LaTeX-style symbols.
12024 + Fix spacing after LaTeX-style symbols.
8608− The org-reader was droping space after unescaped LaTeX-style symbol
12025+ The org-reader was dropping space after unescaped LaTeX-style symbol
8609 commands: `\ForAll \Auml` resulted in `∀Ä` but should give `∀ Ä`
12026 commands: `\ForAll \Auml` resulted in `∀Ä` but should give `∀ Ä`
8610 instead. This seems to be because the LaTeX-reader treats the
12027 instead. This seems to be because the LaTeX-reader treats the
8611 command-terminating space as part of the command. Dropping the trailing
12028 command-terminating space as part of the command. Dropping the trailing
@@ -8940,7 +12357,7 @@
8940
12357
8941 * Entity handling fixes: improved handling of entities like
12358 * Entity handling fixes: improved handling of entities like
8942 `&lang;` that require a trailing semicolon. Allow uppercase
12359 `&lang;` that require a trailing semicolon. Allow uppercase
8943− `x` in numerical hexidecimal character references, working
12360+ `x` in numerical hexadecimal character references, working
8944 around a tagsoup bug.
12361 around a tagsoup bug.
8945
12362
8946 * `stack.yaml` - use lts-4.0, but with older aeson to avoid excessive
12363 * `stack.yaml` - use lts-4.0, but with older aeson to avoid excessive
@@ -10425,7 +13842,7 @@
10425 * `Text.Pandoc.Shared`:
13842 * `Text.Pandoc.Shared`:
10426
13843
10427 + Make safeRead safe (#1801, Matthew Pickering).
13844 + Make safeRead safe (#1801, Matthew Pickering).
10428− + Addded `mapLeft`, `hush` (Matthew Pickering).
13845+ + Added `mapLeft`, `hush` (Matthew Pickering).
10429
13846
10430 * `Text.Pandoc.Pretty`:
13847 * `Text.Pandoc.Pretty`:
10431
13848
@@ -10493,7 +13910,7 @@
10493
13910
10494 + Use `text:p` instead of `text:h` for title.
13911 + Use `text:p` instead of `text:h` for title.
10495 Using `text:h` causes problems with numbering. Closes #2059.
13912 Using `text:h` causes problems with numbering. Closes #2059.
10496− Thansk to @nkalvi for diagnosing this.
13913+ Thanks to @nkalvi for diagnosing this.
10497
13914
10498 * reveal.js template:
13915 * reveal.js template:
10499
13916
@@ -10759,7 +14176,7 @@
10759 * RST writer:
14176 * RST writer:
10760
14177
10761 + Ensure blank line after figure.
14178 + Ensure blank line after figure.
10762− + Avoid exces whitespace after last list item (#1777).
14179+ + Avoid excess whitespace after last list item (#1777).
10763 + Wrap line blocks with spaces before continuations (#1656).
14180 + Wrap line blocks with spaces before continuations (#1656).
10764 + Fixed double-rendering of footnotes in RST tables (#1769).
14181 + Fixed double-rendering of footnotes in RST tables (#1769).
10765
14182
@@ -10821,7 +14238,7 @@
10821 + Renumber header and footer relationships to avoid collisions (Jesse
14238 + Renumber header and footer relationships to avoid collisions (Jesse
10822 Rosenthal). We previously took the old relationship names of the
14239 Rosenthal). We previously took the old relationship names of the
10823 headers and footer in secptr. That led to collisions. We now make
14240 headers and footer in secptr. That led to collisions. We now make
10824− a map of availabl names in the relationships file, and then rename
14241+ a map of available names in the relationships file, and then rename
10825 in secptr.
14242 in secptr.
10826
14243
10827 * ConTeXt writer:
14244 * ConTeXt writer:
@@ -11544,7 +14961,7 @@
11544 different versions of the `directory` library.
14961 different versions of the `directory` library.
11545
14962
11546 + Added `Text.Pandoc.Compat.Except` to allow building against
14963 + Added `Text.Pandoc.Compat.Except` to allow building against
11547− different verions of `mtl`.
14964+ different versions of `mtl`.
11548
14965
11549 * Code cleanup in some writers, using Reader monad to avoid
14966 * Code cleanup in some writers, using Reader monad to avoid
11550 passing options parameter around (Matej Kollar).
14967 passing options parameter around (Matej Kollar).
@@ -13183,7 +16600,7 @@
13183 + Include HTML TOC, even in epub2. The TOC is included in `<spine>`,
16600 + Include HTML TOC, even in epub2. The TOC is included in `<spine>`,
13184 but `linear` is set to `no` unless the `--toc` option is specified.
16601 but `linear` is set to `no` unless the `--toc` option is specified.
13185 Include `<guide>` element in OPF. This should allow the TOC to
16602 Include `<guide>` element in OPF. This should allow the TOC to
13186− be useable in Kindles when converted with kindlegen. Closes #773.
16603+ be usable in Kindles when converted with kindlegen. Closes #773.
13187
16604
13188 * `Text.Pandoc.Parsing`: Optimized `oneOfStringsCI`.
16605 * `Text.Pandoc.Parsing`: Optimized `oneOfStringsCI`.
13189 This dramatically reduces the speed penalty that comes from enabling the
16606 This dramatically reduces the speed penalty that comes from enabling the
@@ -13779,7 +17196,7 @@
13779 be a parenthesized emphasized "hello".
17196 be a parenthesized emphasized "hello".
13780 The new list is taken from the PHP source of textile 2.4.
17197 The new list is taken from the PHP source of textile 2.4.
13781 + Fixed autolinks. Previously the textile reader and writer
17198 + Fixed autolinks. Previously the textile reader and writer
13782− incorrectly implented RST-style autolinks for URLs and email
17199+ incorrectly implemented RST-style autolinks for URLs and email
13783 addresses. This has been fixed. Now an autolink is done this way:
17200 addresses. This has been fixed. Now an autolink is done this way:
13784 `"$":http://myurl.com`.
17201 `"$":http://myurl.com`.
13785 + Fixed footnotes bug in textile. This affected notes occurring
17202 + Fixed footnotes bug in textile. This affected notes occurring
@@ -14842,7 +18259,7 @@
14842 Items are no longer installed as root.
18259 Items are no longer installed as root.
14843 Man pages are zipped and given proper permissions.
18260 Man pages are zipped and given proper permissions.
14844
18261
14845− * Modified windows installer generater to use cabal-dev.
18262+ * Modified windows installer generator to use cabal-dev.
14846
18263
14847 * Setup: Making man pages now works with cabal-dev (at least on OSX). In
18264 * Setup: Making man pages now works with cabal-dev (at least on OSX). In
14848 Setup.hs we now invoke 'runghc' in a way that points it to the correct
18265 Setup.hs we now invoke 'runghc' in a way that points it to the correct
citeproc/biblatex-localization/.stringsnew file

No changes to the content.

citeproc/biblatex-localization/UKenglish.lbx.stringsnew file

No changes to the content.

citeproc/biblatex-localization/USenglish.lbx.stringsnew file

No changes to the content.

citeproc/biblatex-localization/american.lbx.stringsnew file

No changes to the content.

citeproc/biblatex-localization/australian.lbx.stringsnew file

No changes to the content.

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

No changes to the content.

citeproc/biblatex-localization/brazilian.lbx.stringsnew file+233
@@ -0,0 +1,233 @@
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.stringsnew file+3
@@ -0,0 +1,3 @@
1+organizer|organiser|org\adddot
2+organizers|organisers|orgs\adddot
3+byorganizer|organised by|org\adddotspace by
citeproc/biblatex-localization/bulgarian.lbx.stringsnew file+28
@@ -0,0 +1,28 @@
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.stringsnew file

No changes to the content.

citeproc/biblatex-localization/catalan.lbx.stringsnew file+158
@@ -0,0 +1,158 @@
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.stringsnew file+214
@@ -0,0 +1,214 @@
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.stringsnew file+91
@@ -0,0 +1,91 @@
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.stringsnew file+106
@@ -0,0 +1,106 @@
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.stringsnew file+23
@@ -0,0 +1,23 @@
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.stringsnew file+254
@@ -0,0 +1,254 @@
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.stringsnew file+178
@@ -0,0 +1,178 @@
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.stringsnew file+254
@@ -0,0 +1,254 @@
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.stringsnew file+245
@@ -0,0 +1,245 @@
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.stringsnew file+28
@@ -0,0 +1,28 @@
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.stringsnew file+28
@@ -0,0 +1,28 @@
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.stringsnew file+9
@@ -0,0 +1,9 @@
1+bibliography|Βιβλιογραφία|Βιβλιογραφία
2+references|Αναφορές|Αναφορές
3+shorthands|Κατάλογος συντμήσεων|Συντμήσεις
4+editor|επιμελητής|επιμελητής
5+editors|επιμελητές|επιμελητές
6+compiler|συντάκτης|συντάκτης
7+compilers|συντάκτες|συντάκτες
8+redactor|συντάκτης|συντάκτης
9+redactors|συντάκτες|συντάκτες
citeproc/biblatex-localization/hungarian.lbx.stringsnew file

No changes to the content.

citeproc/biblatex-localization/icelandic.lbx.stringsnew file+7
@@ -0,0 +1,7 @@
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.stringsnew file+9
@@ -0,0 +1,9 @@
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.stringsnew file+75
@@ -0,0 +1,75 @@
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.stringsnew file+31
@@ -0,0 +1,31 @@
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.stringsnew file+29
@@ -0,0 +1,29 @@
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.stringsnew file+2
@@ -0,0 +1,2 @@
1+citedas|im Folgenden zitiert als|im Folgenden zit\adddotspace als
2+january|J\"anner|J\"an\adddot
citeproc/biblatex-localization/newzealand.lbx.stringsnew file

No changes to the content.

citeproc/biblatex-localization/ngerman.lbx.stringsnew file+1
@@ -0,0 +1 @@
1+citedas|im Folgenden zitiert als|im Folgenden zit\adddotspace als
citeproc/biblatex-localization/norsk.lbx.stringsnew file+98
@@ -0,0 +1,98 @@
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.stringsnew file+2
@@ -0,0 +1,2 @@
1+citedas|im Folgenden zitiert als|im Folgenden zit\adddotspace als
2+countryuk|Grossbritannien|GB
citeproc/biblatex-localization/nynorsk.lbx.stringsnew file+28
@@ -0,0 +1,28 @@
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.stringsnew file+100
@@ -0,0 +1,100 @@
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.stringsnew file

No changes to the content.

citeproc/biblatex-localization/portuguese.lbx.stringsnew file+95
@@ -0,0 +1,95 @@
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.stringsnew file+102
@@ -0,0 +1,102 @@
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.stringsnew file

No changes to the content.

citeproc/biblatex-localization/serbianc.lbx.stringsnew file

No changes to the content.

citeproc/biblatex-localization/slovak.lbx.stringsnew file+82
@@ -0,0 +1,82 @@
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.stringsnew file+28
@@ -0,0 +1,28 @@
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.stringsnew file

No changes to the content.

citeproc/biblatex-localization/spanish.lbx.stringsnew file+190
@@ -0,0 +1,190 @@
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.stringsnew file+9
@@ -0,0 +1,9 @@
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.stringsnew file+1
@@ -0,0 +1 @@
1+countryuk|Grossbritannien|GB
citeproc/biblatex-localization/turkish.lbx.stringsnew file+157
@@ -0,0 +1,157 @@
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.stringsnew file+102
@@ -0,0 +1,102 @@
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.cslnew file+658
@@ -0,0 +1,658 @@
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+6−16
@@ -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="90" />
3+ <w:zoom w:percent="100" />
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,31 +17,21 @@
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" />
30 </w:rsids>
20 </w:rsids>
31 <m:mathPr>
21 <m:mathPr>
32− <m:mathFont m:val="Lucida Grande" />
22+ <m:mathFont m:val="Cambria Math" />
33 <m:brkBin m:val="before" />
23 <m:brkBin m:val="before" />
34 <m:brkBinSub m:val="--" />
24 <m:brkBinSub m:val="--" />
35− <m:smallFrac m:val="false" />
25+ <m:smallFrac m:val="0" />
36− <m:dispDef m:val="false" />
26+ <m:dispDef />
37 <m:lMargin m:val="0" />
27 <m:lMargin m:val="0" />
38 <m:rMargin m:val="0" />
28 <m:rMargin m:val="0" />
39 <m:wrapRight />
29 <m:wrapRight />
40 <m:intLim m:val="subSup" />
30 <m:intLim m:val="subSup" />
41− <m:naryLim m:val="subSup" />
31+ <m:naryLim m:val="undOvr" />
42 </m:mathPr>
32 </m:mathPr>
43 <w:themeFontLang w:val="en-US" />
33 <w:themeFontLang w:val="en-US" />
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" />
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" />
45 <w:decimalSymbol w:val="." />
35 <w:decimalSymbol w:val="." />
46 <w:listSeparator w:val="," />
36 <w:listSeparator w:val="," />
47−</w:settings>
37+</w:settings>
data/docx/word/styles.xml+19
@@ -350,6 +350,21 @@
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>
353 </w:style>
368 </w:style>
354 <w:style w:type="paragraph" w:customStyle="1" w:styleId="DefinitionTerm">
369 <w:style w:type="paragraph" w:customStyle="1" w:styleId="DefinitionTerm">
355 <w:name w:val="Definition Term" />
370 <w:name w:val="Definition Term" />
@@ -414,6 +429,10 @@
414 <w:sz w:val="22" />
429 <w:sz w:val="22" />
415 </w:rPr>
430 </w:rPr>
416 </w:style>
431 </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>
417 <w:style w:type="character" w:styleId="FootnoteReference">
436 <w:style w:type="character" w:styleId="FootnoteReference">
418 <w:name w:val="Footnote Reference" />
437 <w:name w:val="Footnote Reference" />
419 <w:basedOn w:val="BodyTextChar" />
438 <w:basedOn w:val="BodyTextChar" />
data/epub.css+9−2
@@ -7,9 +7,10 @@ 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 */
10h1.title { }
11h1.title { }
11−h2.author { }
12+p.author { }
12−h3.date { }
13+p.date { }
13nav#toc ol,
14nav#toc ol,
14nav#landmarks ol { padding: 0; margin-left: 1em; }
15nav#landmarks ol { padding: 0; margin-left: 1em; }
15nav#toc ol li,
16nav#toc ol li,
@@ -23,3 +24,9 @@ span.underline{ text-decoration: underline; }
23q { quotes: "“" "”" "‘" "’"; }
24q { quotes: "“" "”" "‘" "’"; }
24div.column{ display: inline-block; vertical-align: top; width: 50%; }
25div.column{ display: inline-block; vertical-align: top; width: 50%; }
25div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
26div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
27+@media screen { /* Workaround for iBooks issue; see #6242 */
28+ .sourceCode {
29+ overflow: visible !important;
30+ white-space: pre-wrap !important;
31+ }
32+}
data/make-reference-files.hsdeleted−27
@@ -1,27 +0,0 @@
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+16−12
@@ -73,6 +73,21 @@ xmlns:css3t="http://www.w3.org/TR/css3-text/" office:version="1.2">
73 style:font-size-complex="12pt" style:language-complex="zxx"
73 style:font-size-complex="12pt" style:language-complex="zxx"
74 style:country-complex="none" />
74 style:country-complex="none" />
75 </style:default-style>
75 </style:default-style>
76+ <style:style style:name="Author" style:family="paragraph"
77+ style:parent-style-name="Standard" style:class="html">
78+ <style:paragraph-properties fo:text-align="center" />
79+ </style:style>
80+ <style:style style:name="Date" style:family="paragraph"
81+ style:parent-style-name="Standard" style:class="html">
82+ <style:paragraph-properties fo:text-align="center" />
83+ </style:style>
84+ <style:style style:name="Abstract" style:family="paragraph"
85+ style:parent-style-name="Standard" style:class="html">
86+ <style:paragraph-properties fo:margin-left="0.3937in"
87+ fo:margin-right="0.3937in" fo:margin-top="0.1in"
88+ fo:margin-bottom="0.1in" style:contextual-spacing="false"
89+ fo:text-indent="0in" style:auto-text-indent="false" />
90+ </style:style>
76 <style:default-style style:family="paragraph">
91 <style:default-style style:family="paragraph">
77 <style:paragraph-properties fo:hyphenation-ladder-count="no-limit"
92 <style:paragraph-properties fo:hyphenation-ladder-count="no-limit"
78 style:text-autospace="ideograph-alpha"
93 style:text-autospace="ideograph-alpha"
@@ -319,17 +334,6 @@ xmlns:css3t="http://www.w3.org/TR/css3-text/" office:version="1.2">
319 fo:margin-bottom="0in" style:contextual-spacing="false"
334 fo:margin-bottom="0in" style:contextual-spacing="false"
320 fo:text-indent="0in" style:auto-text-indent="false" />
335 fo:text-indent="0in" style:auto-text-indent="false" />
321 </style:style>
336 </style:style>
322− <style:style style:name="Date" style:family="paragraph"
323− style:parent-style-name="Standard"
324− style:next-style-name="Text_20_body">
325− <style:text-properties fo:font-style="italic" />
326− </style:style>
327− <style:style style:name="Author" style:family="paragraph"
328− style:parent-style-name="Standard" style:next-style-name="Date"
329− style:master-page-name="">
330− <style:paragraph-properties style:page-number="auto" />
331− <style:text-properties fo:font-style="italic" />
332− </style:style>
333 <style:style style:name="Horizontal_20_Line"
337 <style:style style:name="Horizontal_20_Line"
334 style:display-name="Horizontal Line" style:family="paragraph"
338 style:display-name="Horizontal Line" style:family="paragraph"
335 style:parent-style-name="Standard"
339 style:parent-style-name="Standard"
@@ -346,7 +350,7 @@ xmlns:css3t="http://www.w3.org/TR/css3-text/" office:version="1.2">
346 </style:style>
350 </style:style>
347 <style:style style:name="First_20_paragraph"
351 <style:style style:name="First_20_paragraph"
348 style:display-name="First paragraph" style:family="paragraph"
352 style:display-name="First paragraph" style:family="paragraph"
349− style:parent-style-name="Standard"
353+ style:parent-style-name="Text_20_body"
350 style:next-style-name="Text_20_body" style:class="text" />
354 style:next-style-name="Text_20_body" style:class="text" />
351 <style:style style:name="Numbering_20_Symbols"
355 <style:style style:name="Numbering_20_Symbols"
352 style:display-name="Numbering Symbols" style:family="text" />
356 style:display-name="Numbering Symbols" style:family="text" />
data/pandoc.List.lua+68−46
@@ -1,30 +1,32 @@
1--[[
1--[[
2List.lua
2List.lua
3
3
4−Copyright © 2017–2018 Albert Krewinkel
4+Copyright © 2017–2020 Albert Krewinkel
5
5
6−Permission to use, copy, modify, and/or distribute this software for any purpose
6+Permission to use, copy, modify, and/or distribute this software for any
7−with or without fee is hereby granted, provided that the above copyright notice
7+purpose with or without fee is hereby granted, provided that the above
8−and this permission notice appear in all copies.
8+copyright notice and this permission notice appear in all copies.
9
9
10−THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
10+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11−REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
11+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12−FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
12+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13−INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
13+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14−OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
15+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15−TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
16+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ]]
16−THIS SOFTWARE.
17−]]
18
17
19--- Pandoc's List type and helper methods
18--- Pandoc's List type and helper methods
20-- @classmod pandoc.List
19-- @classmod pandoc.List
21-- @author Albert Krewinkel
20-- @author Albert Krewinkel
22−-- @copyright © 2017–2018 Albert Krewinkel
21+-- @copyright © 2017–2020 Albert Krewinkel
23-- @license MIT
22-- @license MIT
24local List = {
23local List = {
25− _VERSION = "0.1.0"
24+ _VERSION = "1.0.0"
26}
25}
27
26
27+--- Create a new list.
28+-- @param[opt] o table that should be altered into a list (default: `{}`)
29+-- @return the altered input table
28function List:new (o)
30function List:new (o)
29 o = o or {}
31 o = o or {}
30 setmetatable(o, self)
32 setmetatable(o, self)
@@ -32,10 +34,6 @@ function List:new (o)
32 return o
34 return o
33end
35end
34
36
35−function List:__call (o)
36− return self:new(o)
37−end
38−
39--- Concatenates two lists.
37--- Concatenates two lists.
40-- @param list second list concatenated to the first
38-- @param list second list concatenated to the first
41-- @return a new list containing all elements from list1 and list2
39-- @return a new list containing all elements from list1 and list2
@@ -52,17 +50,30 @@ function List:clone ()
52 return lst
50 return lst
53end
51end
54
52
55−--- Checks if the list has an item equal to the given needle.
53+--- Adds the given list to the end of this list.
56−-- @param needle item to search for
54+-- @param list list to appended
57−-- @param init index at which the search is started
55+function List:extend (list)
58−-- @return true if a list item is equal to the needle, false otherwise
56+ for i = 1, #list do
59−function List:includes (needle, init)
57+ self[#self + 1] = list[i]
60− return not (List.find(self, needle, init) == nil)
58+ end
59+end
60+
61+--- Returns a new list containing all items satisfying a given condition.
62+-- @param pred condition items must satisfy.
63+-- @return a new list containing all items for which `test` was true.
64+function List:filter (pred)
65+ local res = setmetatable({}, getmetatable(self))
66+ for i = 1, #self do
67+ if pred(self[i], i) then
68+ res[#res + 1] = self[i]
69+ end
70+ end
71+ return res
61end
72end
62
73
63--- Returns the value and index of the first occurrence of the given item.
74--- Returns the value and index of the first occurrence of the given item.
64-- @param needle item to search for
75-- @param needle item to search for
65−-- @param init index at which the search is started
76+-- @param[opt] init index at which the search is started (default: 1)
66-- @return first item equal to the needle, or nil if no such item exists.
77-- @return first item equal to the needle, or nil if no such item exists.
67-- @return index of that element
78-- @return index of that element
68function List:find (needle, init)
79function List:find (needle, init)
@@ -72,7 +83,7 @@ end
72--- Returns the value and index of the first element for which the predicate
83--- Returns the value and index of the first element for which the predicate
73--- holds true.
84--- holds true.
74-- @param pred the predicate function
85-- @param pred the predicate function
75−-- @param init index at which the search is started
86+-- @param[opt] init index at which the search is started (default: 1)
76-- @return first item for which `test` succeeds, or nil if no such item exists.
87-- @return first item for which `test` succeeds, or nil if no such item exists.
77-- @return index of that element
88-- @return index of that element
78function List:find_if (pred, init)
89function List:find_if (pred, init)
@@ -85,16 +96,22 @@ function List:find_if (pred, init)
85 return nil
96 return nil
86end
97end
87
98
88−--- Adds the given list to the end of this list.
99+--- Checks if the list has an item equal to the given needle.
89−-- @param list list to appended
100+-- @param needle item to search for
101+-- @param[opt] init index at which the search is started; defaults to 1.
102+-- @return true if a list item is equal to the needle, false otherwise
90−function List:extend (list)
103+function List:includes (needle, init)
91− for i = 1, #list do
104+ return not (List.find(self, needle, init) == nil)
92− self[#self + 1] = list[i]
93− end
94end
105end
95
106
107+--- Insert an element into the list. Alias for `table.insert`.
108+-- @param list list
109+-- @param[opt] pos position at which the new element is to be inserted
110+-- @param value value to insert
111+List.insert = table.insert
112+
96−--- Returns a copy of the current list by applying the given function to all
113+--- Returns a copy of the current list by applying the given function to
97−-- elements.
114+-- all elements.
98-- @param fn function which is applied to all list items.
115-- @param fn function which is applied to all list items.
99function List:map (fn)
116function List:map (fn)
100 local res = setmetatable({}, getmetatable(self))
117 local res = setmetatable({}, getmetatable(self))
@@ -104,17 +121,22 @@ function List:map (fn)
104 return res
121 return res
105end
122end
106
123
107−--- Returns a new list containing all items satisfying a given condition.
124+--- Remove element from list (alias for `table.remove`)
108−-- @param pred condition items must satisfy.
125+-- @param list list
109−-- @return a new list containing all items for which `test` was true.
126+-- @param[opt] pos position of the element to be removed (default: #list)
110−function List:filter (pred)
127+-- @return the removed element
111− local res = setmetatable({}, getmetatable(self))
128+List.remove = table.remove
112− for i = 1, #self do
129+
113− if pred(self[i], i) then
130+--- Sort list in-place (alias for `table.sort`)
114− res[#res + 1] = self[i]
131+-- @param list list
115− end
132+-- @param[opt] comp comparison function; default to `<` operator.
116− end
133+List.sort = table.sort
117− return res
134+
118−end
135+-- Set metatable with __call metamethod. This allows the use of `List`
136+-- as a constructor function.
137+local ListMT = {
138+ __call = List.new
139+}
140+setmetatable(List, ListMT)
119
141
120return List
142return List
data/pandoc.lua+49−14
@@ -556,26 +556,27 @@ 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 {Inline,...} caption table caption
559+-- @tparam Caption caption table caption
560−-- @tparam {AlignDefault|AlignLeft|AlignRight|AlignCenter,...} aligns alignments
560+-- @tparam {ColSpec,...} colspecs column alignments and widths
561−-- @tparam {int,...} widths column widths
561+-- @tparam TableHead head table head
562−-- @tparam {Block,...} headers header row
562+-- @tparam {TableBody,..} bodies table bodies
563−-- @tparam {{Block,...}} rows table rows
564−-- @treturn Block table element
563+-- @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, aligns, widths, headers, rows)
567+ function(caption, colspecs, head, bodies, foot, attr)
568 return {
568 return {
569 c = {
569 c = {
570+ ensureAttr(attr),
570− ensureInlineList(caption),
571+ caption,
571− List:new(aligns),
572+ List:new(colspecs),
572− List:new(widths),
573+ head,
573− List:new(headers),
574+ List:new(bodies),
574− List:new(rows)
575+ foot
575 }
576 }
576 }
577 }
577 end,
578 end,
578− {"caption", "aligns", "widths", "headers", "rows"}
579+ {"attr", "caption", "colspecs", "head", "bodies", "foot"}
579)
580)
580
581
581
582
@@ -828,13 +829,23 @@ M.Subscript = M.Inline:create_constructor(
828--- Creates a Superscript inline element
829--- Creates a Superscript inline element
829-- @function Superscript
830-- @function Superscript
830-- @tparam {Inline,..} content inline content
831-- @tparam {Inline,..} content inline content
831−-- @treturn Inline strong element
832+-- @treturn Inline superscript element
832M.Superscript = M.Inline:create_constructor(
833M.Superscript = M.Inline:create_constructor(
833 "Superscript",
834 "Superscript",
834 function(content) return {c = ensureInlineList(content)} end,
835 function(content) return {c = ensureInlineList(content)} end,
835 "content"
836 "content"
836)
837)
837
838
839+--- Creates an Underline inline element
840+-- @function Underline
841+-- @tparam {Inline,..} content inline content
842+-- @treturn Inline underline element
843+M.Underline = M.Inline:create_constructor(
844+ "Underline",
845+ function(content) return {c = ensureInlineList(content)} end,
846+ "content"
847+)
848+
838
849
839------------------------------------------------------------------------
850------------------------------------------------------------------------
840-- Element components
851-- Element components
@@ -1047,6 +1058,30 @@ M.ListAttributes.behavior.__pairs = function(t)
1047 return make_next_function(fields), t, nil
1058 return make_next_function(fields), t, nil
1048end
1059end
1049
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+
1050
1085
1051------------------------------------------------------------------------
1086------------------------------------------------------------------------
1052-- Constants
1087-- Constants
data/sample.lua+9−11
@@ -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−-- Chose the image format based on the value of the
24+-- Choose 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)
@@ -33,7 +33,7 @@ local image_mime_type = ({
33 png = "image/png",
33 png = "image/png",
34 svg = "image/svg+xml",
34 svg = "image/svg+xml",
35 })[image_format]
35 })[image_format]
36− or error("unsupported image format `" .. img_format .. "`")
36+ or error("unsupported image format `" .. image_format .. "`")
37
37
38-- Character escaping
38-- Character escaping
39local function escape(s, in_attribute)
39local function escape(s, in_attribute)
@@ -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 x == '"' then
48+ elseif in_attribute and x == '"' then
49 return '&quot;'
49 return '&quot;'
50− elseif x == "'" then
50+ elseif in_attribute and x == "'" then
51 return '&#39;'
51 return '&#39;'
52 else
52 else
53 return x
53 return x
@@ -79,8 +79,7 @@ end
79-- body is a string, metadata is a table, variables is a table.
79-- body is a string, metadata is a table, variables is a table.
80-- This gives you a fragment. You could use the metadata table to
80-- This gives you a fragment. You could use the metadata table to
81-- fill variables in a custom lua template. Or, pass `--template=...`
81-- fill variables in a custom lua template. Or, pass `--template=...`
82−-- to pandoc, and pandoc will add do the template processing as
82+-- to pandoc, and pandoc will do the template processing as usual.
83−-- usual.
84function Doc(body, metadata, variables)
83function Doc(body, metadata, variables)
85 local buffer = {}
84 local buffer = {}
86 local function add(s)
85 local function add(s)
@@ -142,8 +141,8 @@ function Strikeout(s)
142 return '<del>' .. s .. '</del>'
141 return '<del>' .. s .. '</del>'
143end
142end
144
143
145−function Link(s, src, tit, attr)
144+function Link(s, tgt, tit, attr)
146− return "<a href='" .. escape(src,true) .. "' title='" ..
145+ return "<a href='" .. escape(tgt,true) .. "' title='" ..
147 escape(tit,true) .. "'>" .. s .. "</a>"
146 escape(tit,true) .. "'>" .. s .. "</a>"
148end
147end
149
148
@@ -272,7 +271,7 @@ end
272
271
273-- Convert pandoc alignment to something HTML can use.
272-- Convert pandoc alignment to something HTML can use.
274-- align is AlignLeft, AlignRight, AlignCenter, or AlignDefault.
273-- align is AlignLeft, AlignRight, AlignCenter, or AlignDefault.
275−function html_align(align)
274+local function html_align(align)
276 if align == 'AlignLeft' then
275 if align == 'AlignLeft' then
277 return 'left'
276 return 'left'
278 elseif align == 'AlignRight' then
277 elseif align == 'AlignRight' then
@@ -287,7 +286,7 @@ end
287function CaptionedImage(src, tit, caption, attr)
286function CaptionedImage(src, tit, caption, attr)
288 return '<div class="figure">\n<img src="' .. escape(src,true) ..
287 return '<div class="figure">\n<img src="' .. escape(src,true) ..
289 '" title="' .. escape(tit,true) .. '"/>\n' ..
288 '" title="' .. escape(tit,true) .. '"/>\n' ..
290− '<p class="caption">' .. caption .. '</p>\n</div>'
289+ '<p class="caption">' .. escape(caption) .. '</p>\n</div>'
291end
290end
292
291
293-- Caption is a string, aligns is an array of strings,
292-- Caption is a string, aligns is an array of strings,
@@ -358,4 +357,3 @@ meta.__index =
358 return function() return "" end
357 return function() return "" end
359 end
358 end
360setmetatable(_G, meta)
359setmetatable(_G, meta)
361−
data/templates/.github/ISSUE_TEMPLATE.mddeleted−3
@@ -1,3 +0,0 @@
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.mddeleted−4
@@ -1,4 +0,0 @@
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.markdowndeleted−49
@@ -1,49 +0,0 @@
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.jatsnew file+38
@@ -0,0 +1,38 @@
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/default.jats → data/templates/article.jats_publishingrenamed+27−16
@@ -1,13 +1,7 @@
1−<?xml version="1.0" encoding="utf-8" ?>
2−$if(xml-stylesheet)$
3−<?xml-stylesheet type="text/xsl" href="$xml-stylesheet$"?>
4−$endif$
5−<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Publishing DTD v1.1 20151215//EN"
6− "JATS-journalpublishing1.dtd">
7$if(article.type)$
1$if(article.type)$
8−<article xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink" dtd-version="1.1" article-type="$article.type$">
2+<article xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink" dtd-version="1.2" article-type="$article.type$">
9$else$
3$else$
10−<article xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink" dtd-version="1.1" article-type="other">
4+<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">
11$endif$
5$endif$
12<front>
6<front>
13<journal-meta>
7<journal-meta>
@@ -20,6 +14,13 @@ $endif$
20$if(journal.pmc)$
14$if(journal.pmc)$
21<journal-id journal-id-type="pmc">$journal.pmc$</journal-id>
15<journal-id journal-id-type="pmc">$journal.pmc$</journal-id>
22$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$
23<journal-title-group>
24<journal-title-group>
24$if(journal.title)$
25$if(journal.title)$
25<journal-title>$journal.title$</journal-title>
26<journal-title>$journal.title$</journal-title>
@@ -29,10 +30,16 @@ $if(journal.abbrev-title)$
29$endif$
30$endif$
30</journal-title-group>
31</journal-title-group>
31$if(journal.pissn)$
32$if(journal.pissn)$
32−<issn pub-type="ppub">$journal.pissn$</issn>
33+<issn publication-format="print">$journal.pissn$</issn>
33$endif$
34$endif$
34$if(journal.eissn)$
35$if(journal.eissn)$
35−<issn pub-type="epub">$journal.eissn$</issn>
36+<issn publication-format="electronic">$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>
36$endif$
43$endif$
37<publisher>
44<publisher>
38<publisher-name>$journal.publisher-name$</publisher-name>
45<publisher-name>$journal.publisher-name$</publisher-name>
@@ -79,7 +86,7 @@ $endif$
79$if(author)$
86$if(author)$
80<contrib-group>
87<contrib-group>
81$for(author)$
88$for(author)$
82−<contrib contrib-type="author">
89+<contrib contrib-type="author"$if(author.equal-contrib)$ equal-contrib="true"$endif$>
83$if(author.orcid)$
90$if(author.orcid)$
84<contrib-id contrib-id-type="orcid">$author.orcid$</contrib-id>
91<contrib-id contrib-id-type="orcid">$author.orcid$</contrib-id>
85$endif$
92$endif$
@@ -88,20 +95,23 @@ $if(author.surname)$
88<surname>$author.surname$</surname>
95<surname>$author.surname$</surname>
89<given-names>$author.given-names$</given-names>
96<given-names>$author.given-names$</given-names>
90</name>
97</name>
98+$elseif(author.name)$
99+<string-name>$author.name$</string-name>
91$else$
100$else$
92<string-name>$author$</string-name>
101<string-name>$author$</string-name>
93$endif$
102$endif$
94$if(author.email)$
103$if(author.email)$
95<email>$author.email$</email>
104<email>$author.email$</email>
96$endif$
105$endif$
97−$if(author.aff-id)$
106+$for(author.affiliation)$
98−<xref ref-type="aff" rid="aff-$contrib.aff-id$"/>
107+<xref ref-type="aff" rid="aff-$author.affiliation$"/>
99−$endif$
108+$endfor$
100$if(author.cor-id)$
109$if(author.cor-id)$
101<xref ref-type="corresp" rid="cor-$author.cor-id$"><sup>*</sup></xref>
110<xref ref-type="corresp" rid="cor-$author.cor-id$"><sup>*</sup></xref>
102$endif$
111$endif$
103</contrib>
112</contrib>
104$endfor$
113$endfor$
114+${ affiliations.jats() }
105</contrib-group>
115</contrib-group>
106$endif$
116$endif$
107$if(article.author-notes)$
117$if(article.author-notes)$
@@ -120,7 +130,7 @@ $endif$
120</author-notes>
130</author-notes>
121$endif$
131$endif$
122$if(date)$
132$if(date)$
123−<pub-date pub-type="epub"$if(date.iso-8601)$ iso-8601-date="$date.iso-8601$"$endif$>
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$>
124$if(date.day)$
134$if(date.day)$
125<day>$date.day$</day>
135<day>$date.day$</day>
126$endif$
136$endif$
@@ -164,8 +174,8 @@ $if(copyright.text)$
164<license license-type="$copyright.type$" xlink:href="$copyright.link$">
174<license license-type="$copyright.type$" xlink:href="$copyright.link$">
165<license-p>$copyright.text$</license-p>
175<license-p>$copyright.text$</license-p>
166</license>
176</license>
167−</permissions>
168$endif$
177$endif$
178+</permissions>
169$endif$
179$endif$
170$if(abstract)$
180$if(abstract)$
171<abstract>
181<abstract>
@@ -198,3 +208,4 @@ $back$
198$endif$
208$endif$
199</back>
209</back>
200</article>
210</article>
211+
data/templates/default.biblatexnew file+10
@@ -0,0 +1,10 @@
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.bibtexnew file+10
@@ -0,0 +1,10 @@
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+10−8
@@ -51,6 +51,7 @@ $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]
54\definefontfeature[smallcaps][script=latn, protrusion=quality, expansion=quality, smcp=yes, onum=yes, pnum=yes]
55\definefontfeature[smallcaps][script=latn, protrusion=quality, expansion=quality, smcp=yes, onum=yes, pnum=yes]
55\setupalign[hz,hanging]
56\setupalign[hz,hanging]
56\setupitaliccorrection[global, always]
57\setupitaliccorrection[global, always]
@@ -72,9 +73,9 @@ $if(interlinespace)$
72\setupinterlinespace[$for(interlinespace)$$interlinespace$$sep$,$endfor$]
73\setupinterlinespace[$for(interlinespace)$$interlinespace$$sep$,$endfor$]
73$endif$
74$endif$
74
75
75−\setuphead[chapter] [style=\tfd,header=empty]
76+\setuphead[chapter] [style=\tfd\setupinterlinespace,header=empty]
76−\setuphead[section] [style=\tfc]
77+\setuphead[section] [style=\tfc\setupinterlinespace]
77−\setuphead[subsection] [style=\tfb]
78+\setuphead[subsection] [style=\tfb\setupinterlinespace]
78\setuphead[subsubsection] [style=\bf]
79\setuphead[subsubsection] [style=\bf]
79\setuphead[subsubsubsection] [style=\sc]
80\setuphead[subsubsubsection] [style=\sc]
80\setuphead[subsubsubsubsection][style=\it]
81\setuphead[subsubsubsubsection][style=\it]
@@ -97,11 +98,12 @@ $endif$
97\setupitemize[autointro] % prevent orphan list intro
98\setupitemize[autointro] % prevent orphan list intro
98\setupitemize[indentnext=no]
99\setupitemize[indentnext=no]
99
100
101+\defineitemgroup[enumerate]
102+\setupenumerate[each][fit][itemalign=left,distance=.5em,style={\feature[+][default:tnum]}]
103+
100\setupfloat[figure][default={here,nonumber}]
104\setupfloat[figure][default={here,nonumber}]
101\setupfloat[table][default={here,nonumber}]
105\setupfloat[table][default={here,nonumber}]
102
106
103−\setupthinrules[width=15em] % width of horizontal rules
104−
105\setupxtable[frame=off]
107\setupxtable[frame=off]
106\setupxtable[head][topframe=on,bottomframe=on]
108\setupxtable[head][topframe=on,bottomframe=on]
107\setupxtable[body][]
109\setupxtable[body][]
@@ -162,12 +164,12 @@ $endfor$
162$if(toc)$
164$if(toc)$
163\completecontent
165\completecontent
164$endif$
166$endif$
165−$if(lot)$
166−\completelistoftables
167−$endif$
168$if(lof)$
167$if(lof)$
169\completelistoffigures
168\completelistoffigures
170$endif$
169$endif$
170+$if(lot)$
171+\completelistoftables
172+$endif$
171
173
172$body$
174$body$
173
175
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(date)$<span class="date">$date$</span>$endif$
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$
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="none">
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">
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="none">
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">
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,6 +12,9 @@ $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$" />
15$endif$
18$endif$
16 <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$</title>
19 <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$</title>
17 <style type="text/css">
20 <style type="text/css">
data/templates/default.html5+3
@@ -12,6 +12,9 @@ $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$" />
15$endif$
18$endif$
16 <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$</title>
19 <title>$if(title-prefix)$$title-prefix$ – $endif$$pagetitle$</title>
17 <style>
20 <style>
data/templates/default.jats_archivingnew file+7
@@ -0,0 +1,7 @@
1+<?xml version="1.0" encoding="utf-8" ?>
2+$if(xml-stylesheet)$
3+<?xml-stylesheet type="text/xsl" href="$xml-stylesheet$"?>
4+$endif$
5+<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Archiving and Interchange DTD v1.2 20190208//EN"
6+ "JATS-archivearticle1.dtd">
7+${ article.jats_publishing() }
data/templates/default.jats_articleauthoringnew file+93
@@ -0,0 +1,93 @@
1+<?xml version="1.0" encoding="utf-8" ?>
2+$if(xml-stylesheet)$
3+<?xml-stylesheet type="text/xsl" href="$xml-stylesheet$"?>
4+$endif$
5+<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Article Authoring DTD v1.2 20190208//EN"
6+ "JATS-articleauthoring1.dtd">
7+$if(article.type)$
8+<article xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink" dtd-version="1.2" article-type="$article.type$">
9+$else$
10+<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">
11+$endif$
12+<front>
13+<article-meta>
14+$if(title)$
15+<title-group>
16+<article-title>$title$</article-title>
17+</title-group>
18+$endif$
19+$if(author)$
20+<contrib-group>
21+$for(author)$
22+<contrib contrib-type="author"$if(author.equal-contrib)$ equal-contrib="true"$endif$>
23+$if(author.orcid)$
24+<contrib-id contrib-id-type="orcid">$author.orcid$</contrib-id>
25+$endif$
26+$if(author.surname)$
27+<name>
28+<surname>$author.surname$</surname>
29+<given-names>$author.given-names$</given-names>
30+</name>
31+$elseif(author.name)$
32+<string-name>$author.name$</string-name>
33+$else$
34+<string-name>$author$</string-name>
35+$endif$
36+$if(author.email)$
37+<email>$author.email$</email>
38+$endif$
39+$for(author.affiliation)$
40+<xref ref-type="aff" rid="aff-$author.affiliation$"/>
41+$endfor$
42+$if(author.cor-id)$
43+<xref ref-type="corresp" rid="cor-$author.cor-id$"><sup>*</sup></xref>
44+$endif$
45+</contrib>
46+$endfor$
47+${ affiliations.jats() }
48+</contrib-group>
49+$endif$
50+$if(copyright)$
51+<permissions>
52+$if(copyright.statement)$
53+<copyright-statement>$copyright.statement$</copyright-statement>
54+$endif$
55+$if(copyright.year)$
56+<copyright-year>$copyright.year$</copyright-year>
57+$endif$
58+$if(copyright.holder)$
59+<copyright-holder>$copyright.holder$</copyright-holder>
60+$endif$
61+$if(copyright.text)$
62+<license license-type="$copyright.type$" xlink:href="$copyright.link$">
63+<license-p>$copyright.text$</license-p>
64+</license>
65+$endif$
66+</permissions>
67+$endif$
68+<abstract>
69+$abstract$
70+</abstract>
71+$if(tags)$
72+<kwd-group kwd-group-type="author">
73+$for(tags)$
74+<kwd>$tags$</kwd>
75+$endfor$
76+</kwd-group>
77+$endif$
78+$if(article.funding-statement)$
79+<funding-group>
80+<funding-statement>$article.funding-statement$</funding-statement>
81+</funding-group>
82+$endif$
83+</article-meta>
84+</front>
85+<body>
86+$body$
87+</body>
88+<back>
89+$if(back)$
90+$back$
91+$endif$
92+</back>
93+</article>
data/templates/default.jats_publishingnew file+7
@@ -0,0 +1,7 @@
1+<?xml version="1.0" encoding="utf-8" ?>
2+$if(xml-stylesheet)$
3+<?xml-stylesheet type="text/xsl" href="$xml-stylesheet$"?>
4+$endif$
5+<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Publishing DTD v1.2 20190208//EN"
6+ "JATS-publishing1.dtd">
7+${ article.jats_publishing() }
data/templates/default.latex+86−31
@@ -2,13 +2,16 @@
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)$
9\PassOptionsToPackage{RTLdocument}{bidi}
9\PassOptionsToPackage{RTLdocument}{bidi}
10$endif$
10$endif$
11$endif$
11$endif$
12+$if(CJKmainfont)$
13+\PassOptionsToPackage{space}{xeCJK}
14+$endif$
12%
15%
13\documentclass[
16\documentclass[
14$if(fontsize)$
17$if(fontsize)$
@@ -86,6 +89,7 @@ $endif$
86$if(beamerarticle)$
89$if(beamerarticle)$
87\usepackage{beamerarticle} % needs to be loaded first
90\usepackage{beamerarticle} % needs to be loaded first
88$endif$
91$endif$
92+\usepackage{amsmath,amssymb}
89$if(fontfamily)$
93$if(fontfamily)$
90\usepackage[$for(fontfamilyoptions)$$fontfamilyoptions$$sep$,$endfor$]{$fontfamily$}
94\usepackage[$for(fontfamilyoptions)$$fontfamilyoptions$$sep$,$endfor$]{$fontfamily$}
91$else$
95$else$
@@ -94,15 +98,14 @@ $endif$
94$if(linestretch)$
98$if(linestretch)$
95\usepackage{setspace}
99\usepackage{setspace}
96$endif$
100$endif$
97−\usepackage{amssymb,amsmath}
101+\usepackage{iftex}
98−\usepackage{ifxetex,ifluatex}
102+\ifPDFTeX
99−\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
100 \usepackage[$if(fontenc)$$fontenc$$else$T1$endif$]{fontenc}
103 \usepackage[$if(fontenc)$$fontenc$$else$T1$endif$]{fontenc}
101 \usepackage[utf8]{inputenc}
104 \usepackage[utf8]{inputenc}
102 \usepackage{textcomp} % provide euro and other symbols
105 \usepackage{textcomp} % provide euro and other symbols
103\else % if luatex or xetex
106\else % if luatex or xetex
104$if(mathspec)$
107$if(mathspec)$
105− \ifxetex
108+ \ifXeTeX
106 \usepackage{mathspec}
109 \usepackage{mathspec}
107 \else
110 \else
108 \usepackage{unicode-math}
111 \usepackage{unicode-math}
@@ -126,7 +129,7 @@ $for(fontfamilies)$
126$endfor$
129$endfor$
127$if(mathfont)$
130$if(mathfont)$
128$if(mathspec)$
131$if(mathspec)$
129− \ifxetex
132+ \ifXeTeX
130 \setmathfont(Digits,Latin,Greek)[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
133 \setmathfont(Digits,Latin,Greek)[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
131 \else
134 \else
132 \setmathfont[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
135 \setmathfont[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
@@ -136,23 +139,42 @@ $else$
136$endif$
139$endif$
137$endif$
140$endif$
138$if(CJKmainfont)$
141$if(CJKmainfont)$
139− \ifxetex
142+ \ifXeTeX
140− \usepackage[space]{xeCJK}
143+ \usepackage{xeCJK}
141 \setCJKmainfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
144 \setCJKmainfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
142 \fi
145 \fi
143$endif$
146$endif$
144$if(luatexjapresetoptions)$
147$if(luatexjapresetoptions)$
145− \ifluatex
148+ \ifLuaTeX
146 \usepackage[$for(luatexjapresetoptions)$$luatexjapresetoptions$$sep$,$endfor$]{luatexja-preset}
149 \usepackage[$for(luatexjapresetoptions)$$luatexjapresetoptions$$sep$,$endfor$]{luatexja-preset}
147 \fi
150 \fi
148$endif$
151$endif$
149$if(CJKmainfont)$
152$if(CJKmainfont)$
150− \ifluatex
153+ \ifLuaTeX
151 \usepackage[$for(luatexjafontspecoptions)$$luatexjafontspecoptions$$sep$,$endfor$]{luatexja-fontspec}
154 \usepackage[$for(luatexjafontspecoptions)$$luatexjafontspecoptions$$sep$,$endfor$]{luatexja-fontspec}
152 \setmainjfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
155 \setmainjfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
153 \fi
156 \fi
154$endif$
157$endif$
155\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$
156$if(beamer)$
178$if(beamer)$
157$if(theme)$
179$if(theme)$
158\usetheme[$for(themeoptions)$$themeoptions$$sep$,$endfor$]{$theme$}
180\usetheme[$for(themeoptions)$$themeoptions$$sep$,$endfor$]{$theme$}
@@ -216,10 +238,10 @@ $if(keywords)$
216$endif$
238$endif$
217$if(colorlinks)$
239$if(colorlinks)$
218 colorlinks=true,
240 colorlinks=true,
219− linkcolor=$if(linkcolor)$$linkcolor$$else$Maroon$endif$,
241+ linkcolor={$if(linkcolor)$$linkcolor$$else$Maroon$endif$},
220− filecolor=$if(filecolor)$$filecolor$$else$Maroon$endif$,
242+ filecolor={$if(filecolor)$$filecolor$$else$Maroon$endif$},
221− citecolor=$if(citecolor)$$citecolor$$else$Blue$endif$,
243+ citecolor={$if(citecolor)$$citecolor$$else$Blue$endif$},
222− urlcolor=$if(urlcolor)$$urlcolor$$else$Blue$endif$,
244+ urlcolor={$if(urlcolor)$$urlcolor$$else$Blue$endif$},
223$else$
245$else$
224 hidelinks,
246 hidelinks,
225$endif$
247$endif$
@@ -251,7 +273,11 @@ $if(highlighting-macros)$
251$highlighting-macros$
273$highlighting-macros$
252$endif$
274$endif$
253$if(tables)$
275$if(tables)$
254−\usepackage{longtable,booktabs}
276+\usepackage{longtable,booktabs,array}
277+$if(multirow)$
278+\usepackage{multirow}
279+$endif$
280+\usepackage{calc} % for calculating minipage widths
255$if(beamer)$
281$if(beamer)$
256\usepackage{caption}
282\usepackage{caption}
257% Make caption package work with longtable
283% Make caption package work with longtable
@@ -318,30 +344,61 @@ $endif$
318$if(pagestyle)$
344$if(pagestyle)$
319\pagestyle{$pagestyle$}
345\pagestyle{$pagestyle$}
320$endif$
346$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$
321$for(header-includes)$
372$for(header-includes)$
322$header-includes$
373$header-includes$
323$endfor$
374$endfor$
324$if(lang)$
375$if(lang)$
325−\ifxetex
376+\ifXeTeX
326 % Load polyglossia as late as possible: uses bidi with RTL langages (e.g. Hebrew, Arabic)
377 % Load polyglossia as late as possible: uses bidi with RTL langages (e.g. Hebrew, Arabic)
327 \usepackage{polyglossia}
378 \usepackage{polyglossia}
328− \setmainlanguage[$polyglossia-lang.options$]{$polyglossia-lang.name$}
379+ \setmainlanguage[$for(polyglossia-lang.options)$$polyglossia-lang.options$$sep$,$endfor$]{$polyglossia-lang.name$}
329$for(polyglossia-otherlangs)$
380$for(polyglossia-otherlangs)$
330− \setotherlanguage[$polyglossia-otherlangs.options$]{$polyglossia-otherlangs.name$}
381+ \setotherlanguage[$for(polyglossia-otherlangs.options)$$polyglossia-otherlangs.options$$sep$,$endfor$]{$polyglossia-otherlangs.name$}
331$endfor$
382$endfor$
332\else
383\else
333− \usepackage[shorthands=off,$for(babel-otherlangs)$$babel-otherlangs$,$endfor$main=$babel-lang$]{babel}
384+ \usepackage[$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{}
334$if(babel-newcommands)$
388$if(babel-newcommands)$
335 $babel-newcommands$
389 $babel-newcommands$
336$endif$
390$endif$
337\fi
391\fi
338$endif$
392$endif$
393+\ifLuaTeX
394+ \usepackage{selnolig} % disable illegal ligatures
395+\fi
339$if(dir)$
396$if(dir)$
340−\ifxetex
397+\ifXeTeX
341 % Load bidi as late as possible as it modifies e.g. graphicx
398 % Load bidi as late as possible as it modifies e.g. graphicx
342 \usepackage{bidi}
399 \usepackage{bidi}
343\fi
400\fi
344−\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
401+\ifPDFTeX
345 \TeXXeTstate=1
402 \TeXXeTstate=1
346 \newcommand{\RL}[1]{\beginR #1\endR}
403 \newcommand{\RL}[1]{\beginR #1\endR}
347 \newcommand{\LR}[1]{\beginL #1\endL}
404 \newcommand{\LR}[1]{\beginL #1\endL}
@@ -359,13 +416,11 @@ $for(bibliography)$
359\addbibresource{$bibliography$}
416\addbibresource{$bibliography$}
360$endfor$
417$endfor$
361$endif$
418$endif$
362−$if(csl-refs)$
419+$if(nocite-ids)$
363−\newlength{\cslhangindent}
420+\nocite{$for(nocite-ids)$$it$$sep$, $endfor$}
364−\setlength{\cslhangindent}{1.5em}
421+$endif$
365−\newenvironment{cslreferences}%
422+$if(csquotes)$
366− {$if(csl-hanging-indent)$\setlength{\parindent}{0pt}%
423+\usepackage{csquotes}
367− \everypar{\setlength{\hangindent}{\cslhangindent}}\ignorespaces$endif$}%
368− {\par}
369$endif$
424$endif$
370
425
371$if(title)$
426$if(title)$
@@ -439,12 +494,12 @@ $endif$
439}
494}
440$endif$
495$endif$
441$endif$
496$endif$
442−$if(lot)$
443−\listoftables
444−$endif$
445$if(lof)$
497$if(lof)$
446\listoffigures
498\listoffigures
447$endif$
499$endif$
500+$if(lot)$
501+\listoftables
502+$endif$
448$if(linestretch)$
503$if(linestretch)$
449\setstretch{$linestretch$}
504\setstretch{$linestretch$}
450$endif$
505$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+7−1
@@ -14,18 +14,24 @@ $endfor$
14$if(title)$
14$if(title)$
15<text:p text:style-name="Title">$title$</text:p>
15<text:p text:style-name="Title">$title$</text:p>
16$endif$
16$endif$
17+$if(subtitle)$
18+<text:p text:style-name="Subtitle">$subtitle$</text:p>
19+$endif$
17$for(author)$
20$for(author)$
18<text:p text:style-name="Author">$author$</text:p>
21<text:p text:style-name="Author">$author$</text:p>
19$endfor$
22$endfor$
20$if(date)$
23$if(date)$
21<text:p text:style-name="Date">$date$</text:p>
24<text:p text:style-name="Date">$date$</text:p>
22$endif$
25$endif$
26+$if(abstract)$
27+$abstract$
28+$endif$
23$for(include-before)$
29$for(include-before)$
24$include-before$
30$include-before$
25$endfor$
31$endfor$
26$if(toc)$
32$if(toc)$
27<text:table-of-content>
33<text:table-of-content>
28− <text:table-of-content-source text:outline-level="10">
34+ <text:table-of-content-source text:outline-level="$toc-depth$">
29 <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>
30 <text:table-of-content-entry-template text:outline-level="1"
36 <text:table-of-content-entry-template text:outline-level="1"
31 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+134−93
@@ -16,30 +16,19 @@ $endif$
16 <meta name="apple-mobile-web-app-capable" content="yes">
16 <meta name="apple-mobile-web-app-capable" content="yes">
17 <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
17 <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
18 <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, minimal-ui">
18 <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, minimal-ui">
19− <link rel="stylesheet" href="$revealjs-url$/css/reset.css">
19+ <link rel="stylesheet" href="$revealjs-url$/dist/reset.css">
20− <link rel="stylesheet" href="$revealjs-url$/css/reveal.css">
20+ <link rel="stylesheet" href="$revealjs-url$/dist/reveal.css">
21 <style>
21 <style>
22 $styles.html()$
22 $styles.html()$
23 </style>
23 </style>
24$if(theme)$
24$if(theme)$
25− <link rel="stylesheet" href="$revealjs-url$/css/theme/$theme$.css" id="theme">
25+ <link rel="stylesheet" href="$revealjs-url$/dist/theme/$theme$.css" id="theme">
26$else$
26$else$
27− <link rel="stylesheet" href="$revealjs-url$/css/theme/black.css" id="theme">
27+ <link rel="stylesheet" href="$revealjs-url$/dist/theme/black.css" id="theme">
28$endif$
28$endif$
29$for(css)$
29$for(css)$
30 <link rel="stylesheet" href="$css$"/>
30 <link rel="stylesheet" href="$css$"/>
31$endfor$
31$endfor$
32− <!-- Printing and PDF exports -->
33− <script>
34− var link = document.createElement( 'link' );
35− link.rel = 'stylesheet';
36− link.type = 'text/css';
37− link.href = window.location.search.match( /print-pdf/gi ) ? '$revealjs-url$/css/print/pdf.css' : '$revealjs-url$/css/print/paper.css';
38− document.getElementsByTagName( 'head' )[0].appendChild( link );
39− </script>
40− <!--[if lt IE 9]>
41− <script src="$revealjs-url$/lib/js/html5shiv.js"></script>
42− <![endif]-->
43$if(math)$
32$if(math)$
44 $math$
33 $math$
45$endif$
34$endif$
@@ -63,6 +52,9 @@ $endif$
63$for(author)$
52$for(author)$
64 <p class="author">$author$</p>
53 <p class="author">$author$</p>
65$endfor$
54$endfor$
55+$for(institute)$
56+ <p class="institute">$institute$</p>
57+$endfor$
66$if(date)$
58$if(date)$
67 <p class="date">$date$</p>
59 <p class="date">$date$</p>
68$endif$
60$endif$
@@ -70,7 +62,12 @@ $endif$
70$endif$
62$endif$
71$if(toc)$
63$if(toc)$
72<section id="$idprefix$TOC">
64<section id="$idprefix$TOC">
65+<nav role="doc-toc">
66+$if(toc-title)$
67+<h2 id="$idprefix$toc-title">$toc-title$</h2>
68+$endif$
73$table-of-contents$
69$table-of-contents$
70+</nav>
74</section>
71</section>
75$endif$
72$endif$
76
73
@@ -78,165 +75,213 @@ $body$
78 </div>
75 </div>
79 </div>
76 </div>
80
77
81− <script src="$revealjs-url$/js/reveal.js"></script>
78+ <script src="$revealjs-url$/dist/reveal.js"></script>
79+
80+ <!-- reveal.js plugins -->
81+ <script src="$revealjs-url$/plugin/notes/notes.js"></script>
82+ <script src="$revealjs-url$/plugin/search/search.js"></script>
83+ <script src="$revealjs-url$/plugin/zoom/zoom.js"></script>
84+$if(mathjax)$
85+ <script src="$revealjs-url$/plugin/math/math.js"></script>
86+$endif$
82
87
83 <script>
88 <script>
84
89
85 // Full list of configuration options available at:
90 // Full list of configuration options available at:
86− // https://github.com/hakimel/reveal.js#configuration
91+ // https://revealjs.com/config/
87 Reveal.initialize({
92 Reveal.initialize({
88−$if(controls)$
89 // Display controls in the bottom right corner
93 // Display controls in the bottom right corner
90 controls: $controls$,
94 controls: $controls$,
91−$endif$
95+
92−$if(progress)$
96+ // Help the user learn the controls by providing hints, for example by
97+ // bouncing the down arrow when they first encounter a vertical slide
98+ controlsTutorial: $controlsTutorial$,
99+
100+ // Determines where controls appear, "edges" or "bottom-right"
101+ controlsLayout: '$controlsLayout$',
102+
103+ // Visibility rule for backwards navigation arrows; "faded", "hidden"
104+ // or "visible"
105+ controlsBackArrows: '$controlsBackArrows$',
106+
93 // Display a presentation progress bar
107 // Display a presentation progress bar
94 progress: $progress$,
108 progress: $progress$,
95−$endif$
109+
96−$if(slideNumber)$
97 // Display the page number of the current slide
110 // Display the page number of the current slide
98 slideNumber: $slideNumber$,
111 slideNumber: $slideNumber$,
99−$endif$
112+
113+ // 'all', 'print', or 'speaker'
114+ showSlideNumber: '$showSlideNumber$',
115+
116+ // 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
118+ hash: $hash$,
119+
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+
100 // Push each slide change to the browser history
126 // Push each slide change to the browser history
101−$if(history)$
102 history: $history$,
127 history: $history$,
103−$else$
128+
104− history: true,
105−$endif$
106−$if(keyboard)$
107 // Enable keyboard shortcuts for navigation
129 // Enable keyboard shortcuts for navigation
108 keyboard: $keyboard$,
130 keyboard: $keyboard$,
109−$endif$
131+
110−$if(overview)$
111 // Enable the slide overview mode
132 // Enable the slide overview mode
112 overview: $overview$,
133 overview: $overview$,
113−$endif$
134+
114−$if(center)$
135+ // Disables the default reveal.js slide layout (scaling and centering)
136+ // so that you can use custom CSS layout
137+ disableLayout: false,
138+
115 // Vertical centering of slides
139 // Vertical centering of slides
116 center: $center$,
140 center: $center$,
117−$endif$
141+
118−$if(touch)$
119 // Enables touch navigation on devices with touch input
142 // Enables touch navigation on devices with touch input
120 touch: $touch$,
143 touch: $touch$,
121−$endif$
144+
122−$if(loop)$
123 // Loop the presentation
145 // Loop the presentation
124 loop: $loop$,
146 loop: $loop$,
125−$endif$
147+
126−$if(rtl)$
127 // Change the presentation direction to be RTL
148 // Change the presentation direction to be RTL
128 rtl: $rtl$,
149 rtl: $rtl$,
129−$endif$
150+
130−$if(navigationMode)$
131− // see https://github.com/hakimel/reveal.js/#navigation-mode
151+ // see https://revealjs.com/vertical-slides/#navigation-mode
132 navigationMode: '$navigationMode$',
152 navigationMode: '$navigationMode$',
133−$endif$
153+
134−$if(fragments)$
154+ // Randomizes the order of slides each time the presentation loads
155+ shuffle: $shuffle$,
156+
135 // Turns fragments on and off globally
157 // Turns fragments on and off globally
136 fragments: $fragments$,
158 fragments: $fragments$,
137−$endif$
159+
138−$if(embedded)$
160+ // Flags whether to include the current fragment in the URL,
161+ // so that reloading brings you to the same fragment position
162+ fragmentInURL: $fragmentInURL$,
163+
139 // Flags if the presentation is running in an embedded mode,
164 // Flags if the presentation is running in an embedded mode,
140 // i.e. contained within a limited portion of the screen
165 // i.e. contained within a limited portion of the screen
141 embedded: $embedded$,
166 embedded: $embedded$,
142−$endif$
167+
143−$if(help)$
144 // Flags if we should show a help overlay when the questionmark
168 // Flags if we should show a help overlay when the questionmark
145 // key is pressed
169 // key is pressed
146 help: $help$,
170 help: $help$,
147−$endif$
171+
148−$if(showNotes)$
172+ // Flags if it should be possible to pause the presentation (blackout)
173+ pause: $pause$,
174+
149 // Flags if speaker notes should be visible to all viewers
175 // Flags if speaker notes should be visible to all viewers
150 showNotes: $showNotes$,
176 showNotes: $showNotes$,
151−$endif$
177+
152−$if(autoSlide)$
178+ // Global override for autoplaying embedded media (null/true/false)
179+ autoPlayMedia: $autoPlayMedia$,
180+
181+ // Global override for preloading lazy-loaded iframes (null/true/false)
182+ preloadIframes: $preloadIframes$,
183+
153 // Number of milliseconds between automatically proceeding to the
184 // Number of milliseconds between automatically proceeding to the
154 // next slide, disabled when set to 0, this value can be overwritten
185 // next slide, disabled when set to 0, this value can be overwritten
155 // by using a data-autoslide attribute on your slides
186 // by using a data-autoslide attribute on your slides
156 autoSlide: $autoSlide$,
187 autoSlide: $autoSlide$,
157−$endif$
188+
158−$if(autoSlideStoppable)$
159 // Stop auto-sliding after user input
189 // Stop auto-sliding after user input
160 autoSlideStoppable: $autoSlideStoppable$,
190 autoSlideStoppable: $autoSlideStoppable$,
161−$endif$
191+
162−$if(mouseWheel)$
192+ // Use this method for navigation when auto-sliding
193+ autoSlideMethod: $autoSlideMethod$,
194+
195+ // 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
197+ // speaker view
198+ defaultTiming: $defaultTiming$,
199+
163 // Enable slide navigation via mouse wheel
200 // Enable slide navigation via mouse wheel
164 mouseWheel: $mouseWheel$,
201 mouseWheel: $mouseWheel$,
165−$endif$
202+
166−$if(rollingLinks)$
203+ // The display mode that will be used to show slides
167− // Apply a 3D roll to links on hover
204+ display: '$display$',
168− rollingLinks: $rollingLinks$,
205+
169−$endif$
206+ // Hide cursor if inactive
170−$if(hideAddressBar)$
207+ hideInactiveCursor: $hideInactiveCursor$,
171− // Hides the address bar on mobile devices
208+
172− hideAddressBar: $hideAddressBar$,
209+ // Time before the cursor is hidden (in ms)
173−$endif$
210+ hideCursorTime: $hideCursorTime$,
174−$if(previewLinks)$
211+
175 // Opens links in an iframe preview overlay
212 // Opens links in an iframe preview overlay
176 previewLinks: $previewLinks$,
213 previewLinks: $previewLinks$,
177−$endif$
214+
178−$if(transition)$
179− // Transition style
180− transition: '$transition$', // none/fade/slide/convex/concave/zoom
215+ // Transition style (none/fade/slide/convex/concave/zoom)
181−$endif$
216+ transition: '$transition$',
182−$if(transitionSpeed)$
217+
183− // Transition speed
218+ // Transition speed (default/fast/slow)
184− transitionSpeed: '$transitionSpeed$', // default/fast/slow
219+ transitionSpeed: '$transitionSpeed$',
185−$endif$
220+
186−$if(backgroundTransition)$
187 // Transition style for full page slide backgrounds
221 // Transition style for full page slide backgrounds
188− backgroundTransition: '$backgroundTransition$', // none/fade/slide/convex/concave/zoom
222+ // (none/fade/slide/convex/concave/zoom)
189−$endif$
223+ backgroundTransition: '$backgroundTransition$',
190−$if(viewDistance)$
224+
191 // Number of slides away from the current that are visible
225 // Number of slides away from the current that are visible
192 viewDistance: $viewDistance$,
226 viewDistance: $viewDistance$,
193−$endif$
227+
228+ // 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
230+ // viewDistance in order to save resources.
231+ mobileViewDistance: $mobileViewDistance$,
194$if(parallaxBackgroundImage)$
232$if(parallaxBackgroundImage)$
233+
195 // Parallax background image
234 // Parallax background image
196 parallaxBackgroundImage: '$parallaxBackgroundImage$', // e.g. "'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg'"
235 parallaxBackgroundImage: '$parallaxBackgroundImage$', // e.g. "'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg'"
197$else$
236$else$
198$if(background-image)$
237$if(background-image)$
238+
199 // Parallax background image
239 // Parallax background image
200 parallaxBackgroundImage: '$background-image$', // e.g. "'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg'"
240 parallaxBackgroundImage: '$background-image$', // e.g. "'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg'"
201$endif$
241$endif$
202$endif$
242$endif$
203$if(parallaxBackgroundSize)$
243$if(parallaxBackgroundSize)$
244+
204 // Parallax background size
245 // Parallax background size
205 parallaxBackgroundSize: '$parallaxBackgroundSize$', // CSS syntax, e.g. "2100px 900px"
246 parallaxBackgroundSize: '$parallaxBackgroundSize$', // CSS syntax, e.g. "2100px 900px"
206$endif$
247$endif$
207$if(parallaxBackgroundHorizontal)$
248$if(parallaxBackgroundHorizontal)$
249+
208 // Amount to move parallax background (horizontal and vertical) on slide change
250 // Amount to move parallax background (horizontal and vertical) on slide change
209 // Number, e.g. 100
251 // Number, e.g. 100
210 parallaxBackgroundHorizontal: $parallaxBackgroundHorizontal$,
252 parallaxBackgroundHorizontal: $parallaxBackgroundHorizontal$,
211$endif$
253$endif$
212$if(parallaxBackgroundVertical)$
254$if(parallaxBackgroundVertical)$
255+
213 parallaxBackgroundVertical: $parallaxBackgroundVertical$,
256 parallaxBackgroundVertical: $parallaxBackgroundVertical$,
214$endif$
257$endif$
215$if(width)$
258$if(width)$
259+
216 // The "normal" size of the presentation, aspect ratio will be preserved
260 // The "normal" size of the presentation, aspect ratio will be preserved
217 // when the presentation is scaled to fit different resolutions. Can be
261 // when the presentation is scaled to fit different resolutions. Can be
218 // specified using percentage units.
262 // specified using percentage units.
219 width: $width$,
263 width: $width$,
220$endif$
264$endif$
221$if(height)$
265$if(height)$
266+
222 height: $height$,
267 height: $height$,
223$endif$
268$endif$
224$if(margin)$
269$if(margin)$
270+
225 // Factor of the display size that should remain empty around the content
271 // Factor of the display size that should remain empty around the content
226 margin: $margin$,
272 margin: $margin$,
227$endif$
273$endif$
228$if(minScale)$
274$if(minScale)$
275+
229 // Bounds for smallest/largest possible scale to apply to content
276 // Bounds for smallest/largest possible scale to apply to content
230 minScale: $minScale$,
277 minScale: $minScale$,
231$endif$
278$endif$
232$if(maxScale)$
279$if(maxScale)$
280+
233 maxScale: $maxScale$,
281 maxScale: $maxScale$,
234$endif$
282$endif$
235−$if(zoomKey)$
236− // Modifier key used to click-zoom to part of the slide
237− zoomKey: '$zoomKey$',
238−$endif$
239$if(mathjax)$
283$if(mathjax)$
284+
240 math: {
285 math: {
241 mathjax: '$mathjaxurl$',
286 mathjax: '$mathjaxurl$',
242 config: 'TeX-AMS_HTML-full',
287 config: 'TeX-AMS_HTML-full',
@@ -255,18 +300,14 @@ $if(mathjax)$
255 },
300 },
256$endif$
301$endif$
257
302
258− // Optional reveal.js plugins
303+ // reveal.js plugins
259− dependencies: [
304+ plugins: [
260− { src: '$revealjs-url$/lib/js/classList.js', condition: function() { return !document.body.classList; } },
261− { src: '$revealjs-url$/plugin/zoom-js/zoom.js', async: true },
262−$if(notes-server)$
263− { src: '$revealjs-url$/socket.io/socket.io.js', async: true },
264− { src: '$revealjs-url$/plugin/notes-server/client.js', async: true },
265−$endif$
266$if(mathjax)$
305$if(mathjax)$
267− { src: '$revealjs-url$/plugin/math/math.js', async: true },
306+ RevealMath,
268$endif$
307$endif$
269− { src: '$revealjs-url$/plugin/notes/notes.js', async: true }
308+ RevealNotes,
309+ RevealSearch,
310+ RevealZoom
270 ]
311 ]
271 });
312 });
272 </script>
313 </script>
data/templates/default.s5+3
@@ -61,6 +61,9 @@ $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$
64$if(date)$
67$if(date)$
65 <h4 class="date">$date$</h4>
68 <h4 class="date">$date$</h4>
66$endif$
69$endif$
data/templates/default.slideous+7
@@ -63,9 +63,16 @@ $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)$
66 <p class="author">
67 <p class="author">
67$for(author)$$author$$sep$<br/>$endfor$
68$for(author)$$author$$sep$<br/>$endfor$
68 </p>
69 </p>
70+$endif$
71+$if(institute)$
72+ <p class="institute">
73+$for(institute)$$institute$$sep$<br/>$endfor$
74+ </p>
75+$endif$
69$if(date)$
76$if(date)$
70 <p class="date">$date$</p>
77 <p class="date">$date$</p>
71$endif$
78$endif$
data/templates/default.slidy+5
@@ -52,6 +52,11 @@ $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$
55$if(date)$
60$if(date)$
56 <p class="date">$date$</p>
61 <p class="date">$date$</p>
57$endif$
62$endif$
data/templates/styles.html+168
@@ -1,3 +1,144 @@
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$
1code{white-space: pre-wrap;}
142code{white-space: pre-wrap;}
2span.smallcaps{font-variant: small-caps;}
143span.smallcaps{font-variant: small-caps;}
3span.underline{text-decoration: underline;}
144span.underline{text-decoration: underline;}
@@ -10,3 +151,30 @@ $endif$
10$if(highlighting-css)$
151$if(highlighting-css)$
11$highlighting-css$
152$highlighting-css$
12$endif$
153$endif$
154+$if(displaymath-css)$
155+.display.math{display: block; text-align: center; margin: 0.5rem auto;}
156+$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.yamlnew file+22
@@ -0,0 +1,22 @@
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.yamlnew file+22
@@ -0,0 +1,22 @@
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.cssdeleted−82
@@ -1,82 +0,0 @@
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.nixnew file+13
@@ -0,0 +1,13 @@
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+9−2
@@ -141,8 +141,15 @@ 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 should try using the
144+or target readers that don't support MathML. Then you have two options:
145+
146+1. Use the [`--webtex`](https://pandoc.org/MANUAL.html#option--webtex) option,
145−`--webtex` option, which will use a web service to convert the TeX to an image.
147+ 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.
146
153
147[KindleGen]: https://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000765211
154[KindleGen]: https://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000765211
148[EPUB]: https://en.wikipedia.org/wiki/EPUB
155[EPUB]: https://en.wikipedia.org/wiki/EPUB
doc/faqs.mdnew file+128
@@ -0,0 +1,128 @@
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+196−155
@@ -16,19 +16,52 @@ The pandoc AST format is defined in the module
16](https://hackage.haskell.org/package/pandoc-types/docs/Text-Pandoc-Definition.html).
16](https://hackage.haskell.org/package/pandoc-types/docs/Text-Pandoc-Definition.html).
17
17
18A "filter" is a program that modifies the AST, between the
18A "filter" is a program that modifies the AST, between the
19−reader and the writer:
19+reader and the writer.
20
20
21 INPUT --reader--> AST --filter--> AST --writer--> OUTPUT
21 INPUT --reader--> AST --filter--> AST --writer--> OUTPUT
22
22
23−Filters are "pipes" that read from standard input and write to
23+Pandoc supports two kinds of filters:
24−standard output. They consume and produce a JSON representation
25−of the pandoc AST. (In recent versions, this representation
26−includes a `pandoc-api-version` field which refers to a
27−version of `pandoc-types`.) Filters may be written in any programming
28−language. To use a filter, you need only specify it on the
29−command line using `--filter`, e.g.
30
24
25+- **Lua filters** use the Lua language to
26+ define transformations on the pandoc AST. They are
27+ described in a [separate document](lua-filters.html).
28+
29+- **JSON filters**, described here, are pipes that read from
30+ standard input and write to standard output, consuming and
31+ producing a JSON representation of the pandoc AST:
32+
33+ source format
34+ ↓
35+ (pandoc)
36+ ↓
37+ JSON-formatted AST
38+ ↓
39+ (JSON filter)
40+ ↓
41+ JSON-formatted AST
42+ ↓
43+ (pandoc)
44+ ↓
45+ target format
46+
47+Lua filters have a couple of advantages. They use a Lua
48+interpreter that is embedded in pandoc, so you don't need
49+to have any external software installed. And they are
50+usually faster than JSON filters. But if you wish to
51+write your filter in a language other than Lua, you may
52+prefer to use a JSON filter. JSON filters may be written
53+in any programming language.
54+
55+You can use a JSON filter directly in a pipeline:
56+
31− pandoc -s input.txt --filter pandoc-citeproc -o output.htl
57+ pandoc -s input.txt -t json | \
58+ pandoc-citeproc | \
59+ pandoc -s -f json -o output.html
60+
61+But it is more convenient to use the `--filter` option,
62+which handles the plumbing automatically:
63+
64+ pandoc -s input.txt --filter pandoc-citeproc -o output.html
32
65
33For a gentle introduction into writing your own filters,
66For a gentle introduction into writing your own filters,
34continue this guide. There’s also a [list of third party filters
67continue this guide. There’s also a [list of third party filters
@@ -37,7 +70,7 @@ on the wiki](https://github.com/jgm/pandoc/wiki/Pandoc-Filters).
37
70
38# A simple example
71# A simple example
39
72
40−Suppose you wanted to replace all level 2+ headers in a markdown
73+Suppose you wanted to replace all level 2+ headings in a markdown
41document with regular paragraphs, with text in italics. How would you go
74document with regular paragraphs, with text in italics. How would you go
42about doing this?
75about doing this?
43
76
@@ -47,10 +80,10 @@ like this:
47 perl -pe 's/^##+ (.*)$/\*\1\*/' source.txt
80 perl -pe 's/^##+ (.*)$/\*\1\*/' source.txt
48
81
49This should work most of the time. But don't forget
82This should work most of the time. But don't forget
50−that ATX style headers can end with a sequence of `#`s
83+that ATX style headings can end with a sequence of `#`s
51−that is not part of the header text:
84+that is not part of the heading text:
52
85
53− ## My header ##
86+ ## My heading ##
54
87
55And what if your document contains a line starting with `##` in an HTML
88And what if your document contains a line starting with `##` in an HTML
56comment or delimited code block?
89comment or delimited code block?
@@ -60,14 +93,14 @@ comment or delimited code block?
60 -->
93 -->
61
94
62 ~~~~
95 ~~~~
63− ### A third level header in standard markdown
96+ ### A third level heading in standard markdown
64 ~~~~
97 ~~~~
65
98
66−We don't want to touch *these* lines. Moreover, what about setext
99+We don't want to touch *these* lines. Moreover, what about Setext
67−style second-level headers?
100+style second-level heading?
68
101
69− A header
102+ A heading
70− --------
103+ ---------
71
104
72We need to handle those too. Finally, can we be sure that adding
105We need to handle those too. Finally, can we be sure that adding
73asterisks to each side of our string will put it in italics?
106asterisks to each side of our string will put it in italics?
@@ -76,25 +109,23 @@ end up with bold text, which is not what we want. And what if it contains
76a regular unescaped asterisk?
109a regular unescaped asterisk?
77
110
78How would you modify your regular expression to handle these cases? It
111How would you modify your regular expression to handle these cases? It
79−would be hairy, to say the least. What we need is a real parser.
112+would be hairy, to say the least.
80
113
81−Well, pandoc has a real markdown parser, the library function
114+A better approach is to let pandoc handle the parsing, and
82−`readMarkdown`. This transforms markdown text to an abstract syntax tree
115+then modify the AST before the document is written. For this,
83−(AST) that represents the document structure. Why not manipulate the
116+we can use a filter.
84−AST directly in a short Haskell script, then convert the result back to
85−markdown using `writeMarkdown`?
86
117
87−First, let's see what this AST looks like. We can use pandoc's `native`
118+To see what sort of AST is produced when pandoc parses our text,
88−output format:
119+we can use pandoc's `native` output format:
89
120
90~~~~
121~~~~
91% cat test.txt
122% cat test.txt
92−## my header
123+## my heading
93
124
94text with *italics*
125text with *italics*
95% pandoc -s -t native test.txt
126% pandoc -s -t native test.txt
96Pandoc (Meta {unMeta = fromList []})
127Pandoc (Meta {unMeta = fromList []})
97−[Header 3 ("my-header",[],[]) [Str "My",Space,Str "header"]
128+[Header 2 ("my-heading",[],[]) [Str "My",Space,Str "heading"]
98, Para [Str "text",Space,Str "with",Space,Emph [Str "italics"]] ]
129, Para [Str "text",Space,Str "with",Space,Emph [Str "italics"]] ]
99~~~~
130~~~~
100
131
@@ -106,136 +137,46 @@ the pandoc AST, see the [haddock documentation for `Text.Pandoc.Definition`].
106
137
107[haddock documentation for `Text.Pandoc.Definition`]: https://hackage.haskell.org/package/pandoc-types
138[haddock documentation for `Text.Pandoc.Definition`]: https://hackage.haskell.org/package/pandoc-types
108
139
109−Here's a short Haskell script that reads markdown, changes level
140+We can use Haskell to create a JSON filter that transforms this
110−2+ headers to regular paragraphs, and writes the result as markdown.
141+AST, replacing each `Header` block with level >= 2 with a `Para`
111−If you save it as `behead.hs`, you can run it using `runhaskell behead.hs`.
142+with its contents wrapped inside an `Emph` inline:
112−It will act like a unix pipe, reading from `stdin` and writing to `stdout`.
113−Or, if you want, you can compile it, using `ghc --make behead`, then run
114−the resulting executable `behead`.
115−
116−~~~~ {.haskell}
117−-- behead.hs
118−import Text.Pandoc
119−import Text.Pandoc.Walk (walk)
120−
121−behead :: Block -> Block
122−behead (Header n _ xs) | n >= 2 = Para [Emph xs]
123−behead x = x
124−
125−readDoc :: String -> Pandoc
126−readDoc s = readMarkdown def s
127−-- or, for pandoc 1.14 and greater, use:
128−-- readDoc s = case readMarkdown def s of
129−-- Right doc -> doc
130−-- Left err -> error (show err)
131−
132−writeDoc :: Pandoc -> String
133−writeDoc doc = writeMarkdown def doc
134−
135−main :: IO ()
136−main = interact (writeDoc . walk behead . readDoc)
137−~~~~
138−
139−The magic here is the `walk` function, which converts
140−our `behead` function (a function from `Block` to `Block`) to
141−a transformation on whole `Pandoc` documents.
142−(See the [haddock documentation for `Text.Pandoc.Walk`].)
143−
144−[haddock documentation for `Text.Pandoc.Walk`]: https://hackage.haskell.org/package/pandoc-types
145−
146−# Queries: listing URLs
147−
148−We can use this same technique to do much more complex transformations
149−and queries. Here's how we could extract all the URLs linked to in
150−a markdown document (again, not an easy task with regular expressions):
151−
152−~~~~ {.haskell}
153−-- extracturls.hs
154−import Text.Pandoc
155−
156−extractURL :: Inline -> [String]
157−extractURL (Link _ _ (u,_)) = [u]
158−extractURL (Image _ _ (u,_)) = [u]
159−extractURL _ = []
160−
161−extractURLs :: Pandoc -> [String]
162−extractURLs = query extractURL
163−
164−readDoc :: String -> Pandoc
165−readDoc = readMarkdown def
166−-- or, for pandoc 1.14, use:
167−-- readDoc s = case readMarkdown def s of
168−-- Right doc -> doc
169−-- Left err -> error (show err)
170−
171−main :: IO ()
172−main = interact (unlines . extractURLs . readDoc)
173−~~~~
174−
175−`query` is the query counterpart of `walk`: it lifts
176−a function that operates on `Inline` elements to one that operates
177−on the whole `Pandoc` AST. The results returned by applying
178−`extractURL` to each `Inline` element are concatenated in the
179−result.
180−
181−# JSON filters
182−
183−`behead.hs` is a very special-purpose program. It reads a
184−specific input format (markdown) and writes a specific output format
185−(HTML), with a specific set of options (here, the defaults).
186−But the basic operation it performs is one that would be useful
187−in many document transformations. It would be nice to isolate the
188−part of the program that transforms the pandoc AST, leaving the rest
189−to pandoc itself. What we want is a *filter* that *just* operates
190−on the AST---or rather, on a JSON representation of the AST that
191−pandoc can produce and consume:
192−
193− source format
194− ↓
195− (pandoc)
196− ↓
197− JSON-formatted AST
198− ↓
199− (filter)
200− ↓
201− JSON-formatted AST
202− ↓
203− (pandoc)
204− ↓
205− target format
206−
207−The module `Text.Pandoc.JSON` (from `pandoc-types`) contains a
208−function `toJSONFilter` that makes it easy to write such
209−filters. Here is a filter version of `behead.hs`:
210
143
211~~~~ {.haskell}
144~~~~ {.haskell}
212#!/usr/bin/env runhaskell
145#!/usr/bin/env runhaskell
213−-- behead2.hs
146+-- behead.hs
214import Text.Pandoc.JSON
147import Text.Pandoc.JSON
215
148
216main :: IO ()
149main :: IO ()
217main = toJSONFilter behead
150main = toJSONFilter behead
151+
152+behead :: Block -> Block
218− where behead (Header n _ xs) | n >= 2 = Para [Emph xs]
153+behead (Header n _ xs) | n >= 2 = Para [Emph xs]
219− behead x = x
154+behead x = x
220~~~~
155~~~~
221
156
222−It can be used this way:
157+The `toJSONFilter` function does two things. First, it lifts
158+the `behead` function (which maps `Block -> Block`) onto a
159+transformation of the entire `Pandoc` AST, walking the AST
160+and transforming each block. Second, it wraps this `Pandoc ->
161+Pandoc` transformation with the necessary JSON serialization
162+and deserialization, producing an executable that consumes
163+JSON from stdin and produces JSON to stdout.
223
164
224− pandoc -f SOURCEFORMAT -t json | runhaskell behead2.hs | \
165+To use the filter, make it executable:
225− pandoc -f json -t TARGETFORMAT
226
166
227−But it is easier to use the `--filter` option with pandoc:
167+ chmod +x behead.hs
228
168
229− pandoc -f SOURCEFORMAT -t TARGETFORMAT --filter ./behead2.hs
169+and then
230
170
231−Note that this approach requires that `behead2.hs` be executable,
171+ pandoc -f SOURCEFORMAT -t TARGETFORMAT --filter ./behead.hs
232−so we must
233
172
234− chmod +x behead2.hs
173+(It is also necessary that `pandoc-types` be installed in the
174+local package repository. To do this using cabal-install,
175+`cabal v2-update && cabal v2-install --lib pandoc-types`.)
235
176
236Alternatively, we could compile the filter:
177Alternatively, we could compile the filter:
237
178
238− ghc --make behead2.hs
179+ ghc -package-env=default --make behead.hs
239 pandoc -f SOURCEFORMAT -t TARGETFORMAT --filter ./behead
180 pandoc -f SOURCEFORMAT -t TARGETFORMAT --filter ./behead
240
181
241Note that if the filter is placed in the system PATH, then the initial
182Note that if the filter is placed in the system PATH, then the initial
@@ -243,6 +184,7 @@ Note that if the filter is placed in the system PATH, then the initial
243multiple instances of `--filter`: the filters will be applied in
184multiple instances of `--filter`: the filters will be applied in
244sequence.
185sequence.
245
186
187+
246# LaTeX for WordPress
188# LaTeX for WordPress
247
189
248Another easy example. WordPress blogs require a special format for
190Another easy example. WordPress blogs require a special format for
@@ -283,7 +225,7 @@ Here's our "beheading" filter in python:
283#!/usr/bin/env python
225#!/usr/bin/env python
284
226
285"""
227"""
286−Pandoc filter to convert all level 2+ headers to paragraphs with
228+Pandoc filter to convert all level 2+ headings to paragraphs with
287emphasized text.
229emphasized text.
288"""
230"""
289
231
@@ -311,12 +253,15 @@ repository](https://github.com/jgm/pandocfilters).
311
253
312For a more Pythonic alternative to pandocfilters, see
254For a more Pythonic alternative to pandocfilters, see
313the [panflute](https://pypi.org/project/panflute) library.
255the [panflute](https://pypi.org/project/panflute) library.
314−Don't like Python? There are also ports of pandocfilters in
256+Don't like Python? There are also ports of pandocfilters in
257+
315−[PHP](https://github.com/vinai/pandocfilters-php),
258+- [PHP](https://github.com/vinai/pandocfilters-php),
316−[perl](https://metacpan.org/pod/Pandoc::Filter),
259+- [perl](https://metacpan.org/pod/Pandoc::Filter),
260+- TypeScript/JavaScript via Node.js
317−[javascript/node.js](https://github.com/mvhenderson/pandoc-filter-node),
261+ - [pandoc-filter](https://github.com/mvhenderson/pandoc-filter-node),
262+ - [node-pandoc-filter](https://github.com/mu-io/node-pandoc-filter),
318−[Groovy](https://github.com/dfrommi/groovy-pandoc), and
263+- [Groovy](https://github.com/dfrommi/groovy-pandoc), and
319−[Ruby](https://heerdebeer.org/Software/markdown/paru/).
264+- [Ruby](https://heerdebeer.org/Software/markdown/paru/).
320
265
321Starting with pandoc 2.0, pandoc includes built-in support for
266Starting with pandoc 2.0, pandoc includes built-in support for
322writing filters in lua. The lua interpreter is built in to
267writing filters in lua. The lua interpreter is built in to
@@ -335,11 +280,14 @@ the file given?
335#!/usr/bin/env runhaskell
280#!/usr/bin/env runhaskell
336-- includes.hs
281-- includes.hs
337import Text.Pandoc.JSON
282import Text.Pandoc.JSON
283+import qualified Data.Text.IO as TIO
284+import qualified Data.Text as T
338
285
339doInclude :: Block -> IO Block
286doInclude :: Block -> IO Block
340doInclude cb@(CodeBlock (id, classes, namevals) contents) =
287doInclude cb@(CodeBlock (id, classes, namevals) contents) =
341 case lookup "include" namevals of
288 case lookup "include" namevals of
342− Just f -> return . (CodeBlock (id, classes, namevals)) =<< readFile f
289+ Just f -> CodeBlock (id, classes, namevals) <$>
290+ TIO.readFile (T.unpack f)
343 Nothing -> return cb
291 Nothing -> return cb
344doInclude x = return x
292doInclude x = return x
345
293
@@ -416,17 +364,23 @@ markdown link with a URL beginning with a hyphen is interpreted as ruby:
416 [はん](-飯)
364 [はん](-飯)
417
365
418~~~ {.haskell}
366~~~ {.haskell}
367+{-# LANGUAGE OverloadedStrings #-}
419-- handleruby.hs
368-- handleruby.hs
420import Text.Pandoc.JSON
369import Text.Pandoc.JSON
421import System.Environment (getArgs)
370import System.Environment (getArgs)
371+import qualified Data.Text as T
422
372
423handleRuby :: Maybe Format -> Inline -> Inline
373handleRuby :: Maybe Format -> Inline -> Inline
424−handleRuby (Just format) (Link _ [Str ruby] ('-':kanji,_))
374+handleRuby (Just format) x@(Link attr [Str ruby] (src,_)) =
375+ case T.uncons src of
376+ Just ('-',kanji)
425− | format == Format "html" = RawInline format
377+ | format == Format "html" -> RawInline format $
426− $ "<ruby>" ++ kanji ++ "<rp>(</rp><rt>" ++ ruby ++ "</rt><rp>)</rp></ruby>"
378+ "<ruby>" <> kanji <> "<rp>(</rp><rt>" <> ruby <>
379+ "</rt><rp>)</rp></ruby>"
427− | format == Format "latex" = RawInline format
380+ | format == Format "latex" -> RawInline format $
428− $ "\\ruby{" ++ kanji ++ "}{" ++ ruby ++ "}"
381+ "\\ruby{" <> kanji <> "}{" <> ruby <> "}"
429− | otherwise = Str ruby
382+ | otherwise -> Str ruby
383+ _ -> x
430handleRuby _ x = x
384handleRuby _ x = x
431
385
432main :: IO ()
386main :: IO ()
@@ -440,6 +394,8 @@ automatically assign it `Just` the target format or `Nothing`.
440
394
441We compile our script:
395We compile our script:
442
396
397+ # first, make sure pandoc-types is installed:
398+ cabal install --lib pandoc-types --package-env .
443 ghc --make handleRuby
399 ghc --make handleRuby
444
400
445Then run it:
401Then run it:
@@ -453,6 +409,11 @@ Then run it:
453 ^D
409 ^D
454 \ruby{飯}{はん}
410 \ruby{飯}{はん}
455
411
412+Note: to use this to generate PDFs via LaTeX, you'll need
413+to use `--pdf-engine=xelatex`, specify a `mainfont` that has
414+the Japanese characters (e.g. "Noto Sans CJK TC"), and add
415+`\usepackage{ruby}` to your template or header-includes.
416+
456# Exercises
417# Exercises
457
418
4581. Put all the regular text in a markdown document in ALL CAPS
4191. Put all the regular text in a markdown document in ALL CAPS
@@ -469,3 +430,83 @@ Then run it:
4695. Find all code blocks with class `python` and run them
4305. Find all code blocks with class `python` and run them
470 using the python interpreter, printing the results to the console.
431 using the python interpreter, printing the results to the console.
471
432
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.mdnew file+414
@@ -0,0 +1,414 @@
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.mdnew file+63
@@ -0,0 +1,63 @@
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+1370−543
@@ -2,7 +2,7 @@
2author:
2author:
3- Albert Krewinkel
3- Albert Krewinkel
4- John MacFarlane
4- John MacFarlane
5−date: 'December 6, 2017'
5+date: 'January 10, 2020'
6title: Pandoc Lua Filters
6title: Pandoc Lua Filters
7---
7---
8
8
@@ -28,14 +28,14 @@ in JSON form. One cannot simply provide a filter that can be
28used by anyone who has a certain version of the pandoc
28used by anyone who has a certain version of the pandoc
29executable.
29executable.
30
30
31−Starting with pandoc 2.0, we have made it possible to write
31+Starting with version 2.0, pandoc makes it possible to write
32−filters in lua without any external dependencies at all. A lua
32+filters in Lua without any external dependencies at all. A Lua
33−interpreter (version 5.3) and a lua library for creating pandoc
33+interpreter (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 marshalled to lua directly, avoiding the overhead of writing
35+are marshaled 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
38−Here is an example of a lua filter that converts strong emphasis
38+Here is an example of a Lua filter that converts strong emphasis
39to small caps:
39to small caps:
40
40
41``` lua
41``` lua
@@ -74,8 +74,8 @@ Python (`smallcaps.py`):
74 `pandoc --filter ./smallcaps.py` 1.40s
74 `pandoc --filter ./smallcaps.py` 1.40s
75 `pandoc --lua-filter ./smallcaps.lua` 1.03s
75 `pandoc --lua-filter ./smallcaps.lua` 1.03s
76
76
77−As you can see, the lua filter avoids the substantial overhead
77+As you can see, the Lua filter avoids the substantial overhead
78−associated with marshalling to and from JSON over a pipe.
78+associated with marshaling to and from JSON over a pipe.
79
79
80# Lua filter structure
80# Lua filter structure
81
81
@@ -91,10 +91,10 @@ then it would be applied like this:
91
91
92The `--lua-filter` option may be supplied multiple times. Pandoc
92The `--lua-filter` option may be supplied multiple times. Pandoc
93applies all filters (including JSON filters specified via
93applies all filters (including JSON filters specified via
94−`--filter` and lua filters specified via `--lua-filter`) in the
94+`--filter` and Lua filters specified via `--lua-filter`) in the
95order they appear on the command line.
95order they appear on the command line.
96
96
97−Pandoc expects each lua file to return a list of filters. The
97+Pandoc expects each Lua file to return a list of filters. The
98filters in that list are called sequentially, each on the result
98filters in that list are called sequentially, each on the result
99of the previous filter. If there is no value returned by the
99of the previous filter. If there is no value returned by the
100filter script, then pandoc will try to generate a single filter
100filter script, then pandoc will try to generate a single filter
@@ -104,12 +104,12 @@ those of pandoc elements (e.g., `Str`, `Para`, `Meta`, or
104
104
105For each filter, the document is traversed and each element
105For each filter, the document is traversed and each element
106subjected to the filter. Elements for which the filter contains
106subjected to the filter. Elements for which the filter contains
107−an entry (i.e. a function of the same name) are passed to lua
107+an entry (i.e. a function of the same name) are passed to Lua
108element filtering function. In other words, filter entries will
108element 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 one of the following:
112+The return of a filter function must be 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
@@ -136,6 +136,73 @@ Elements without matching functions are left untouched.
136See [module documentation](#module-pandoc) for a list of pandoc
136See [module documentation](#module-pandoc) for a list of pandoc
137elements.
137elements.
138
138
139+## Filters on element sequences
140+
141+For some filtering tasks, it is necessary to know the order
142+in which elements occur in the document. It is not enough then to
143+inspect a single element at a time.
144+
145+There are two special function names, which can be used to define
146+filters on lists of blocks or lists of inlines.
147+
148+[`Inlines (inlines)`]{#inlines-filter}
149+: If present in a filter, this function will be called on all
150+ lists of inline elements, like the content of a [Para]
151+ (paragraph) block, or the description of an [Image]. The
152+ `inlines` argument passed to the function will be a [List] of
153+ [Inlines] for each call.
154+
155+[`Blocks (blocks)`]{#blocks-filter}
156+: If present in a filter, this function will be called on all
157+ lists of block elements, like the content of a [MetaBlocks]
158+ meta element block, on each item of a list, and the main
159+ content of the [Pandoc] document. The `blocks` argument
160+ passed to the function will be a [List] of [Blocks] for each
161+ call.
162+
163+These filter functions are special in that the result must either
164+be nil, in which case the list is left unchanged, or must be a
165+list of the correct type, i.e., the same type as the input
166+argument. Single elements are **not** allowed as return values,
167+as a single element in this context usually hints at a bug.
168+
169+See ["Remove spaces before normal citations"][Inlines filter
170+example] for an example.
171+
172+This functionality has been added in pandoc 2.9.2.
173+
174+[Inlines filter example]: #remove-spaces-before-citations
175+
176+## Execution Order
177+
178+Element filter functions within a filter set are called in a
179+fixed order, skipping any which are not present:
180+
181+ 1. functions for [*Inline* elements](#type-inline),
182+ 2. the [`Inlines`](#inlines-filter) filter function,
183+ 2. functions for [*Block* elements](#type-block) ,
184+ 2. the [`Blocks`](#inlines-filter) filter function,
185+ 3. the [`Meta`](#type-meta) filter function, and last
186+ 4. the [`Pandoc`](#type-pandoc) filter function.
187+
188+It is still possible to force a different order by explicitly
189+returning multiple filter sets. For example, if the filter for
190+*Meta* is to be run before that for *Str*, one can write
191+
192+``` lua
193+-- ... filter definitions ...
194+
195+return {
196+ { Meta = Meta }, -- (1)
197+ { Str = Str } -- (2)
198+}
199+```
200+
201+Filter sets are applied in the order in which they are returned.
202+All functions in set (1) are thus run before those in (2),
203+causing the filter function for *Meta* to be run before the
204+filtering of *Str* elements is started.
205+
139## Global variables
206## Global variables
140
207
141Pandoc passes additional data to Lua filters by setting global
208Pandoc passes additional data to Lua filters by setting global
@@ -151,13 +218,12 @@ variables.
151: Table of the options which were provided to the parser.
218: Table of the options which were provided to the parser.
152
219
153`PANDOC_VERSION`
220`PANDOC_VERSION`
154−: Contains the pandoc version as a [Version
221+: Contains the pandoc version as a [Version] object which
155− object](#type-ref-Version) which behaves like a numerically
156− indexed table, most significant number first. E.g., for
222+ behaves like a numerically indexed table, most significant
223+ number first. E.g., for pandoc 2.7.3, the value of the
157− pandoc 2.7.3, the value of the variable is equivalent to a
224+ variable is equivalent to a table `{2, 7, 3}`. Use
158− table `{2, 7, 3}`. Use `tostring(PANDOC_VERSION)` to produce
225+ `tostring(PANDOC_VERSION)` to produce a version string. This
159− a version string. This variable is also set in custom
226+ variable is also set in custom writers.
160− writers.
161
227
162`PANDOC_API_VERSION`
228`PANDOC_API_VERSION`
163: Contains the version of the pandoc-types API against which
229: Contains the version of the pandoc-types API against which
@@ -176,12 +242,12 @@ variables.
176`PANDOC_STATE`
242`PANDOC_STATE`
177: The state shared by all readers and writers. It is used by
243: The state shared by all readers and writers. It is used by
178 pandoc to collect and pass information. The value of this
244 pandoc to collect and pass information. The value of this
179− variable is of type [CommonState](#type-ref-CommonState) and
245+ variable is of type [CommonState] and
180 is read-only.
246 is read-only.
181
247
182# Pandoc Module
248# Pandoc Module
183
249
184−The `pandoc` lua module is loaded into the filter's lua
250+The `pandoc` Lua module is loaded into the filter's Lua
185environment and provides a set of functions and constants to
251environment and provides a set of functions and constants to
186make creation and manipulation of elements easier. The global
252make creation and manipulation of elements easier. The global
187variable `pandoc` is bound to the module and should generally
253variable `pandoc` is bound to the module and should generally
@@ -195,22 +261,22 @@ functionalities.
195
261
196Element creator functions like `Str`, `Para`, and `Pandoc` are
262Element creator functions like `Str`, `Para`, and `Pandoc` are
197designed to allow easy creation of new elements that are simple
263designed to allow easy creation of new elements that are simple
198−to use and can be read back from the lua environment.
264+to use and can be read back from the Lua environment.
199−Internally, pandoc uses these functions to create the lua
265+Internally, pandoc uses these functions to create the Lua
200objects which are passed to element filter functions. This means
266objects which are passed to element filter functions. This means
201that elements created via this module will behave exactly as
267that elements created via this module will behave exactly as
202those elements accessible through the filter function parameter.
268those elements accessible through the filter function parameter.
203
269
204## Exposed pandoc functionality
270## Exposed pandoc functionality
205
271
206−Some pandoc functions have been made available in lua:
272+Some pandoc functions have been made available in Lua:
207
273
208−- [`walk_block`](#walk_block) and
274+- [`walk_block`](#pandoc.walk_block) and
209− [`walk_inline`](#walk_inline) allow filters to be applied
275+ [`walk_inline`](#pandoc.walk_inline) allow filters to be applied
210 inside specific block or inline elements;
276 inside specific block or inline elements;
211−- [`read`](#read) allows filters to parse strings into pandoc
277+- [`read`](#pandoc.read) allows filters to parse strings into pandoc
212 documents;
278 documents;
213−- [`pipe`](#pipe) runs an external command with input from and
279+- [`pipe`](#pandoc.pipe) runs an external command with input from and
214 output to strings;
280 output to strings;
215- the [`pandoc.mediabag`](#module-pandoc.mediabag) module
281- the [`pandoc.mediabag`](#module-pandoc.mediabag) module
216 allows access to the "mediabag," which stores binary content
282 allows access to the "mediabag," which stores binary content
@@ -226,7 +292,7 @@ use-case would be to load additional modules, or even to alter
226default modules.
292default modules.
227
293
228The following snippet is an example of code that might be useful
294The following snippet is an example of code that might be useful
229−when added to `init.lua`. The snippet adds all unicode-aware
295+when added to `init.lua`. The snippet adds all Unicode-aware
230functions defined in the [`text` module](#module-text) to the
296functions defined in the [`text` module](#module-text) to the
231default `string` module, prefixed with the string `uc_`.
297default `string` module, prefixed with the string `uc_`.
232
298
@@ -239,10 +305,33 @@ end
239This makes it possible to apply these functions on strings using
305This makes it possible to apply these functions on strings using
240colon syntax (`mystring:uc_upper()`).
306colon syntax (`mystring:uc_upper()`).
241
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+
242# Examples
331# Examples
243
332
244The following filters are presented as examples. A repository of
333The following filters are presented as examples. A repository of
245−useful lua filters (which may also serve as good examples) is
334+useful Lua filters (which may also serve as good examples) is
246available at <https://github.com/pandoc/lua-filters>.
335available at <https://github.com/pandoc/lua-filters>.
247
336
248## Macro substitution
337## Macro substitution
@@ -296,48 +385,42 @@ end
296## Setting the date in the metadata
385## Setting the date in the metadata
297
386
298This filter sets the date in the document's metadata to the
387This filter sets the date in the document's metadata to the
299−current date:
388+current date, if a date isn't already set:
300
389
301``` lua
390``` lua
302function Meta(m)
391function Meta(m)
392+ if m.date == nil then
303− m.date = os.date("%B %e, %Y")
393+ m.date = os.date("%B %e, %Y")
304− return m
394+ return m
395+ end
305end
396end
306```
397```
307
398
308−## Extracting information about links
399+## Remove spaces before citations
309
400
310−This filter prints a table of all the URLs linked to in the
401+This filter removes all spaces preceding an "author-in-text"
311−document, together with the number of links to that URL.
402+citation. In Markdown, author-in-text citations (e.g.,
403+`@citekey`), must be preceded by a space. If these spaces are
404+undesired, they must be removed with a filter.
312
405
313``` lua
406``` lua
314−links = {}
407+local function is_space_before_author_in_text(spc, cite)
315−
316−function Link (el)
317− if links[el.target] then
318− links[el.target] = links[el.target] + 1
319− else
320− links[el.target] = 1
321− end
322− return el
408+ return spc and spc.t == 'Space'
409+ and cite and cite.t == 'Cite'
410+ -- there must be only a single citation, and it must have
411+ -- mode 'AuthorInText'
412+ and #cite.citations == 1
413+ and cite.citations[1].mode == 'AuthorInText'
323end
414end
324
415
325−function Doc (blocks, meta)
416+function Inlines (inlines)
326− function strCell(str)
417+ -- Go from end to start to avoid problems with shifting indices.
327− return {pandoc.Plain{pandoc.Str(str)}}
418+ for i = #inlines-1, 1, -1 do
328− end
419+ if is_space_before_author_in_text(inlines[i], inlines[i+1]) then
329− local caption = {pandoc.Str "Link", pandoc.Space(), pandoc.Str "count"}
420+ inlines:remove(i)
330− local aligns = {pandoc.AlignDefault, pandoc.AlignLeft}
421+ end
331− local widths = {0.8, 0.2}
332− local headers = {strCell "Target", strCell "Count"}
333− local rows = {}
334− for link, count in pairs(links) do
335− rows[#rows + 1] = {strCell(link), strCell(count)}
336 end
422 end
337− return pandoc.Doc(
423+ return inlines
338− {pandoc.Table(caption, aligns, widths, headers, rows)},
339− meta
340− )
341end
424end
342```
425```
343
426
@@ -545,10 +628,10 @@ function CodeBlock(block)
545end
628end
546```
629```
547
630
548−## Building images with tikz
631+## Building images with Ti*k*Z
549
632
550−This filter converts raw LaTeX tikz environments into images. It
633+This filter converts raw LaTeX Ti*k*Z environments into images. It
551−works with both PDF and HTML output. The tikz code is compiled
634+works with both PDF and HTML output. The Ti*k*Z code is compiled
552to an image using `pdflatex`, and the image is converted from
635to an image using `pdflatex`, and the image is converted from
553pdf to svg format using
636pdf to svg format using
554[`pdf2svg`](https://github.com/dawbarton/pdf2svg), so both of
637[`pdf2svg`](https://github.com/dawbarton/pdf2svg), so both of
@@ -559,59 +642,68 @@ document is built. (A more sophisticated version of this might
559put these in a special cache directory.)
642put these in a special cache directory.)
560
643
561``` lua
644``` lua
645+local system = require 'pandoc.system'
646+
647+local tikz_doc_template = [[
648+\documentclass{standalone}
649+\usepackage{xcolor}
650+\usepackage{tikz}
651+\begin{document}
652+\nopagecolor
653+%s
654+\end{document}
655+]]
656+
562local function tikz2image(src, filetype, outfile)
657local function tikz2image(src, filetype, outfile)
563− local tmp = os.tmpname()
658+ system.with_temporary_directory('tikz2image', function (tmpdir)
564− local tmpdir = string.match(tmp, "^(.*[\\/])") or "."
659+ system.with_working_directory(tmpdir, function()
565− local f = io.open(tmp .. ".tex", 'w')
660+ local f = io.open('tikz.tex', 'w')
566− f:write("\\documentclass{standalone}\n\\usepackage{xcolor}\n\\usepackage{tikz}\n\\begin{document}\n\\nopagecolor\n")
661+ f:write(tikz_doc_template:format(src))
567− f:write(src)
568− f:write("\n\\end{document}\n")
569− f:close()
662+ f:close()
570− os.execute("pdflatex -output-directory " .. tmpdir .. " " .. tmp)
663+ os.execute('pdflatex tikz.tex')
571− if filetype == 'pdf' then
664+ if filetype == 'pdf' then
572− os.rename(tmp .. ".pdf", outfile)
665+ os.rename('tikz.pdf', outfile)
573− else
666+ else
574− os.execute("pdf2svg " .. tmp .. ".pdf " .. outfile)
667+ os.execute('pdf2svg tikz.pdf ' .. outfile)
575− end
668+ end
576− os.remove(tmp .. ".tex")
669+ end)
577− os.remove(tmp .. ".pdf")
670+ end)
578− os.remove(tmp .. ".log")
579− os.remove(tmp .. ".aux")
580end
671end
581
672
582extension_for = {
673extension_for = {
583− html = 'svg',
674+ html = 'svg',
584− html4 = 'svg',
675+ html4 = 'svg',
585− html5 = 'svg',
676+ html5 = 'svg',
586− latex = 'pdf',
677+ latex = 'pdf',
587− beamer = 'pdf' }
678+ beamer = 'pdf' }
588
679
589local function file_exists(name)
680local function file_exists(name)
590− local f = io.open(name, 'r')
681+ local f = io.open(name, 'r')
591− if f ~= nil then
682+ if f ~= nil then
592− io.close(f)
683+ io.close(f)
593− return true
684+ return true
594− else
685+ else
595− return false
686+ return false
596− end
687+ end
597end
688end
598
689
599local function starts_with(start, str)
690local function starts_with(start, str)
600− return str:sub(1, #start) == start
691+ return str:sub(1, #start) == start
601end
692end
602
693
603
694
604function RawBlock(el)
695function RawBlock(el)
605− if starts_with("\\begin{tikzpicture}", el.text) then
696+ if starts_with('\\begin{tikzpicture}', el.text) then
606− local filetype = extension_for[FORMAT] or "svg"
697+ local filetype = extension_for[FORMAT] or 'svg'
698+ local fname = system.get_working_directory() .. '/' ..
607− local fname = pandoc.sha1(el.text) .. "." .. filetype
699+ pandoc.sha1(el.text) .. '.' .. filetype
608− if not file_exists(fname) then
700+ if not file_exists(fname) then
609− tikz2image(el.text, filetype, fname)
701+ tikz2image(el.text, filetype, fname)
610− end
611− return pandoc.Para({pandoc.Image({}, fname)})
612− else
613− return el
614 end
702 end
703+ return pandoc.Para({pandoc.Image({}, fname)})
704+ else
705+ return el
706+ end
615end
707end
616```
708```
617
709
@@ -638,7 +730,7 @@ Example of use:
638# Lua type reference
730# Lua type reference
639
731
640This section describes the types of objects available to Lua
732This section describes the types of objects available to Lua
641−filters. See the [pandoc module](#module-pandoc%7D) for
733+filters. See the [pandoc module](#module-pandoc) for
642functions to create these objects.
734functions to create these objects.
643
735
644## Shared Properties
736## Shared Properties
@@ -655,72 +747,81 @@ Usage:
655 local emph = pandoc.Emph {pandoc.Str 'important'}
747 local emph = pandoc.Emph {pandoc.Str 'important'}
656 local cloned_emph = emph:clone() -- note the colon
748 local cloned_emph = emph:clone() -- note the colon
657
749
658−## Pandoc {#type-ref-pandoc}
750+## Pandoc {#type-pandoc}
659
751
660Pandoc document
752Pandoc document
661
753
754+Values of this type can be created with the
662−Object equality is determined via
755+[`pandoc.Pandoc`](#pandoc.pandoc) constructor. Object equality is
663−[`pandoc.utils.equals`](#utils-equals).
756+determined via [`pandoc.utils.equals`].
664
757
665`blocks`
758`blocks`
666−: document content ([List](#module-pandoc.list) of
759+: document content ([List] of [Blocks])
667− [Block](#type-ref-Block)s)
668
760
669`meta`
761`meta`
670−: document meta information ([Meta](#Meta) object)
762+: document meta information ([Meta] object)
671
763
672−## Meta {#type-ref-meta}
764+## Meta {#type-meta}
673
765
674Meta information on a document; string-indexed collection of
766Meta information on a document; string-indexed collection of
675−[MetaValue](#type-ref-MetaValue)s.
767+[MetaValues].
676
768
769+Values of this type can be created with the
677−Object equality is determined via
770+[`pandoc.Meta`](#pandoc.meta) constructor. Object equality is
678−[`pandoc.utils.equals`](#utils-equals).
771+determined via [`pandoc.utils.equals`].
679
772
680−## MetaValue {#type-ref-MetaValue}
773+## MetaValue {#type-metavalue}
681
774
682Document meta information items.
775Document meta information items.
683
776
684−Object equality is determined via
777+Object equality is determined via [`pandoc.utils.equals`].
685−[`pandoc.utils.equals`](#utils-equals).
686
778
687−### MetaBlocks {#type-ref-MetaBlocks}
779+### MetaBlocks {#type-metablocks}
688
780
689−A list of blocks usable as meta value
781+A list of blocks usable as meta value ([List] of [Blocks]).
690−([List](#module-pandoc.list) of [Block](#type-ref-Block)s)
691
782
692Fields:
783Fields:
693
784
694`tag`, `t`
785`tag`, `t`
695: the literal `MetaBlocks` (string)
786: the literal `MetaBlocks` (string)
696
787
697−### MetaBool {#type-ref-MetaBool}
788+### MetaBool {#type-metabool}
789+
790+Alias for Lua boolean, i.e. the values `true` and `false`.
698
791
699−Plain Lua boolean value (boolean)
792+### MetaInlines {#type-metainlines}
700
793
701−### MetaInlines {#type-ref-MetaInlines}
794+List of inlines used in metadata ([List] of [Inlines])
702
795
703−List of inlines used in metadata ([List](#module-pandoc.list) of
796+Values of this type can be created with the
704−[Inline](#type-ref-Inline)s)
797+[`pandoc.MetaInlines`](#pandoc.metainlines) constructor.
705
798
706Fields:
799Fields:
707
800
708`tag`, `t`
801`tag`, `t`
709: the literal `MetaInlines` (string)
802: the literal `MetaInlines` (string)
710
803
711−### MetaList {#type-ref-iMetaList}
804+### MetaList {#type-metalist}
712
805
713−A list of other [MetaValue](#type-ref-MetaValue)s.
806+A list of other metadata values ([List] of [MetaValues]).
714−([List](#module-pandoc.list))
807+
808+Values of this type can be created with the
809+[`pandoc.MetaList`](#pandoc.metalist) constructor.
715
810
716Fields:
811Fields:
717
812
718`tag`, `t`
813`tag`, `t`
719: the literal `MetaList` (string)
814: the literal `MetaList` (string)
720
815
816+All methods available for [List]s can be used on this type as
817+well.
818+
721−### MetaMap {#type-ref-MetaMap}
819+### MetaMap {#type-metamap}
722
820
723−A string-indexed map of meta-values. (table)
821+A string-indexed map of meta-values. (table).
822+
823+Values of this type can be created with the
824+[`pandoc.MetaMap`](#pandoc.metamap) constructor.
724
825
725Fields:
826Fields:
726
827
@@ -730,160 +831,198 @@ Fields:
730*Note*: The fields will be shadowed if the map contains a field
831*Note*: The fields will be shadowed if the map contains a field
731with the same name as those listed.
832with the same name as those listed.
732
833
733−### MetaString {#type-ref-MetaString}
834+### MetaString {#type-metastring}
734
835
735−Plain Lua string value (string)
836+Plain Lua string value (string).
736
837
737−## Block {#type-ref-Block}
838+## Block {#type-block}
738
839
739−Object equality is determined via
840+Object equality is determined via [`pandoc.utils.equals`].
740−[`pandoc.utils.equals`](#utils-equals).
741
841
742−### BlockQuote {#type-ref-BlockQuote}
842+### BlockQuote {#type-blockquote}
743
843
744−A block quote element
844+A block quote element.
745
845
846+Values of this type can be created with the
847+[`pandoc.BlockQuote`](#pandoc.blockquote) constructor.
848+
849+Fields:
850+
746−content:
851+`content`:
747−: block content ([List](#module-pandoc.list) of
852+: block content ([List] of [Blocks])
748− [Block](#type-ref-Block)s)
749
853
750`tag`, `t`
854`tag`, `t`
751: the literal `BlockQuote` (string)
855: the literal `BlockQuote` (string)
752
856
753−### BulletList {#type-ref-BulletList}
857+### BulletList {#type-bulletlist}
858+
859+A bullet list.
754
860
755−A bullet list
861+Values of this type can be created with the
862+[`pandoc.BulletList`](#pandoc.bulletlist) constructor.
863+
864+Fields:
756
865
757`content`
866`content`
758−: list of items ([List](#module-pandoc.list) of
867+: list items ([List] of [List] of [Blocks])
759− [Block](#type-ref-Block)s)
760
868
761`tag`, `t`
869`tag`, `t`
762: the literal `BulletList` (string)
870: the literal `BulletList` (string)
763
871
764−### CodeBlock {#type-ref-CodeBlock}
872+### CodeBlock {#type-codeblock}
765
873
766Block of code.
874Block of code.
767
875
876+Values of this type can be created with the
877+[`pandoc.CodeBlock`](#pandoc.codeblock) constructor.
878+
879+Fields:
880+
768`text`
881`text`
769: code string (string)
882: code string (string)
770
883
771`attr`
884`attr`
772−: element attributes ([Attr](#type-ref-Attr))
885+: element attributes ([Attr])
773
886
774`identifier`
887`identifier`
775: alias for `attr.identifier` (string)
888: alias for `attr.identifier` (string)
776
889
777`classes`
890`classes`
778−: alias for `attr.classes` ([List](#module-pandoc.list) of
891+: alias for `attr.classes` ([List] of strings)
779− strings)
780
892
781`attributes`
893`attributes`
782−: alias for `attr.attributes`
894+: alias for `attr.attributes` ([Attributes])
783− ([Attributes](#type-ref-Attributes))
784
895
785`tag`, `t`
896`tag`, `t`
786: the literal `CodeBlock` (string)
897: the literal `CodeBlock` (string)
787
898
788−### DefinitionList {#type-ref-DefinitionList}
899+### DefinitionList {#type-definitionlist}
789
900
790Definition list, containing terms and their explanation.
901Definition list, containing terms and their explanation.
791
902
903+Values of this type can be created with the
904+[`pandoc.DefinitionList`](#pandoc.definitionlist) constructor.
905+
906+Fields:
907+
792`content`
908`content`
793: list of items
909: list of items
794
910
795`tag`, `t`
911`tag`, `t`
796: the literal `DefinitionList` (string)
912: the literal `DefinitionList` (string)
797
913
798−### Div {#type-ref-Div}
914+### Div {#type-div}
799
915
800−Generic block container with attributes
916+Generic block container with attributes.
917+
918+Values of this type can be created with the
919+[`pandoc.Div`](#pandoc.div) constructor.
920+
921+Fields:
801
922
802`content`
923`content`
803−: block content ([List](#module-pandoc.list) of
924+: block content ([List] of [Blocks])
804− [Block](#type-ref-Block)s)
805
925
806`attr`
926`attr`
807−: element attributes ([Attr](#type-ref-Attr))
927+: element attributes ([Attr])
808
928
809`identifier`
929`identifier`
810: alias for `attr.identifier` (string)
930: alias for `attr.identifier` (string)
811
931
812`classes`
932`classes`
813−: alias for `attr.classes` ([List](#module-pandoc.list) of
933+: alias for `attr.classes` ([List] of
814 strings)
934 strings)
815
935
816`attributes`
936`attributes`
817−: alias for `attr.attributes`
937+: alias for `attr.attributes` ([Attributes])
818− ([Attributes](#type-ref-Attributes))
819
938
820`tag`, `t`
939`tag`, `t`
821: the literal `Div` (string)
940: the literal `Div` (string)
822
941
823−### Header {#type-ref-Header}
942+### Header {#type-header}
824
943
825Creates a header element.
944Creates a header element.
826
945
946+Values of this type can be created with the
947+[`pandoc.Header`](#pandoc.header) constructor.
948+
949+Fields:
950+
827`level`
951`level`
828: header level (integer)
952: header level (integer)
829
953
830`content`
954`content`
831−: inline content ([List](#module-pandoc.list) of
955+: inline content ([List] of [Inlines])
832− [Inline](#type-ref-Inline)s)
833
956
834`attr`
957`attr`
835−: element attributes ([Attr](#type-ref-Attr))
958+: element attributes ([Attr])
836
959
837`identifier`
960`identifier`
838: alias for `attr.identifier` (string)
961: alias for `attr.identifier` (string)
839
962
840`classes`
963`classes`
841−: alias for `attr.classes` ([List](#module-pandoc.list) of
964+: alias for `attr.classes` ([List] of strings)
842− strings)
843
965
844`attributes`
966`attributes`
845: alias for `attr.attributes`
967: alias for `attr.attributes`
846− ([Attributes](#type-ref-Attributes))
968+ ([Attributes])
847
969
848`tag`, `t`
970`tag`, `t`
849: the literal `Header` (string)
971: the literal `Header` (string)
850
972
851−### HorizontalRule {#type-ref-HorizontalRule}
973+### HorizontalRule {#type-horizontalrule}
852
974
853A horizontal rule.
975A horizontal rule.
854
976
977+Values of this type can be created with the
978+[`pandoc.HorizontalRule`](#pandoc.horizontalrule) constructor.
979+
980+Fields:
981+
855`tag`, `t`
982`tag`, `t`
856: the literal `HorizontalRule` (string)
983: the literal `HorizontalRule` (string)
857
984
858−### LineBlock {#type-ref-LineBlock}
985+### LineBlock {#type-lineblock}
859
986
860A line block, i.e. a list of lines, each separated from the next
987A line block, i.e. a list of lines, each separated from the next
861by a newline.
988by a newline.
862
989
990+Values of this type can be created with the
991+[`pandoc.LineBlock`](#pandoc.lineblock) constructor.
992+
993+Fields:
994+
863`content`
995`content`
864: inline content
996: inline content
865
997
866`tag`, `t`
998`tag`, `t`
867: the literal `LineBlock` (string)
999: the literal `LineBlock` (string)
868
1000
869−### Null {#type-ref-Null}
1001+### Null {#type-null}
870
1002
871A null element; this element never produces any output in the
1003A null element; this element never produces any output in the
872target format.
1004target format.
873
1005
1006+Values of this type can be created with the
1007+[`pandoc.Null`](#pandoc.null) constructor.
1008+
874`tag`, `t`
1009`tag`, `t`
875: the literal `Null` (string)
1010: the literal `Null` (string)
876
1011
877−### OrderedList {#type-ref-OrderedList}
1012+### OrderedList {#type-orderedlist}
878
1013
879An ordered list.
1014An ordered list.
880
1015
1016+Values of this type can be created with the
1017+[`pandoc.OrderedList`](#pandoc.orderedlist) constructor.
1018+
1019+Fields:
1020+
881`content`
1021`content`
882−: list items ([List](#module-pandoc.list) of
1022+: list items ([List] of [List] of [Blocks])
883− [Block](#type-ref-Block)s)
884
1023
885`listAttributes`
1024`listAttributes`
886−: list parameters ([ListAttributes](#ListAttributes))
1025+: list parameters ([ListAttributes])
887
1026
888`start`
1027`start`
889: alias for `listAttributes.start` (integer)
1028: alias for `listAttributes.start` (integer)
@@ -897,32 +1036,45 @@ An ordered list.
897`tag`, `t`
1036`tag`, `t`
898: the literal `OrderedList` (string)
1037: the literal `OrderedList` (string)
899
1038
900−### Para {#type-ref-Para}
1039+### Para {#type-para}
1040+
1041+A paragraph.
1042+
1043+Values of this type can be created with the
1044+[`pandoc.Para`](#pandoc.para) constructor.
901
1045
902−A paragraph
1046+Fields:
903
1047
904`content`
1048`content`
905−: inline content ([List](#module-pandoc.list) of
1049+: inline content ([List] of [Inlines])
906− [Inline](#type-ref-Inline)s)
907
1050
908`tag`, `t`
1051`tag`, `t`
909: the literal `Para` (string)
1052: the literal `Para` (string)
910
1053
911−### Plain {#type-ref-Plain}
1054+### Plain {#type-plain}
1055+
1056+Plain text, not a paragraph.
912
1057
913−Plain text, not a paragraph
1058+Values of this type can be created with the
1059+[`pandoc.Plain`](#pandoc.plain) constructor.
1060+
1061+Fields:
914
1062
915`content`
1063`content`
916−: inline content ([List](#module-pandoc.list) of
1064+: inline content ([List] of [Inlines])
917− [Inline](#type-ref-Inline)s)
918
1065
919`tag`, `t`
1066`tag`, `t`
920: the literal `Plain` (string)
1067: the literal `Plain` (string)
921
1068
922−### RawBlock {#type-ref-RawBlock}
1069+### RawBlock {#type-rawblock}
923
1070
924Raw content of a specified format.
1071Raw content of a specified format.
925
1072
1073+Values of this type can be created with the
1074+[`pandoc.RawBlock`](#pandoc.rawblock) constructor.
1075+
1076+Fields:
1077+
926`format`
1078`format`
927: format of content (string)
1079: format of content (string)
928
1080
@@ -932,106 +1084,133 @@ Raw content of a specified format.
932`tag`, `t`
1084`tag`, `t`
933: the literal `RawBlock` (string)
1085: the literal `RawBlock` (string)
934
1086
935−### Table {#type-ref-Table}
1087+### Table {#type-table}
936
1088
937A table.
1089A table.
938
1090
1091+Values of this type can be created with the
1092+[`pandoc.Table`](#pandoc.table) constructor.
1093+
1094+Fields:
1095+
1096+`attr`
1097+: table attributes ([Attr])
1098+
939`caption`
1099`caption`
940−: table caption ([List](#module-pandoc.list) of
1100+: table caption ([Caption])
941− [Inline](#type-ref-Inline)s)
1101+
1102+`colspecs`
1103+: column specifications, i.e., alignments and widths ([List] of
1104+ [ColSpec]s)
1105+
1106+`head`
1107+: table head ([TableHead])
1108+
1109+`bodies`
1110+: table bodies ([List] of [TableBody]s)
942
1111
943−`aligns`
1112+`foot`
944−: column alignments ([List](#module-pandoc.list) of
1113+: table foot ([TableFoot])
945− [Alignment](#type-ref-Alignment)s)
946
1114
947−`widths`
1115+`identifier`
948−: column widths (number)
1116+: alias for `attr.identifier` (string)
949
1117
950−`headers`
1118+`classes`
951−: header row ([List](#module-pandoc.list) of [table
1119+: alias for `attr.classes` ([List] of strings)
952− cells](#type-ref-table-cell))
953
1120
954−`rows`
1121+`attributes`
955−: table rows ([List](#module-pandoc.list) of
1122+: alias for `attr.attributes` ([Attributes])
956− [List](#module-pandoc.list)s of [table
957− cells](#type-ref-table-cell))
958
1123
959`tag`, `t`
1124`tag`, `t`
960: the literal `Table` (string)
1125: the literal `Table` (string)
961
1126
962−A [table cell]{#table-cell} is a list of blocks.
1127+A [table cell]{#type-table-cell} is a list of blocks.
963
1128
964−*[Alignment]{#Alignment}* is a string value indicating the
1129+*[Alignment]{#type-alignment}* is a string value indicating the
965horizontal alignment of a table column. `AlignLeft`,
1130horizontal alignment of a table column. `AlignLeft`,
966−`AlignRight`, and `AlignCenter` leads cell content tob be
1131+`AlignRight`, and `AlignCenter` leads cell content to be
967left-aligned, right-aligned, and centered, respectively. The
1132left-aligned, right-aligned, and centered, respectively. The
968default alignment is `AlignDefault` (often equivalent to
1133default alignment is `AlignDefault` (often equivalent to
969centered).
1134centered).
970
1135
971−## Inline {#type-ref-Inline}
1136+## Inline {#type-inline}
972
1137
973−Object equality is determined via
1138+Object equality is determined via [`pandoc.utils.equals`].
974−[`pandoc.utils.equals`](#utils-equals).
975
1139
976−### Cite {#type-ref-Cite}
1140+### Cite {#type-cite}
977
1141
978−Citation
1142+Citation.
1143+
1144+Values of this type can be created with the
1145+[`pandoc.Cite`](#pandoc.cite) constructor.
1146+
1147+Fields:
979
1148
980`content`
1149`content`
981−: ([List](#module-pandoc.list) of [Inline](#type-ref-Inline)s)
1150+: ([List] of [Inlines])
982
1151
983`citations`
1152`citations`
984−: citation entries ([List](#module-pandoc.list) of
1153+: citation entries ([List] of [Citations])
985− [citations](#type-ref-Citation))
986
1154
987`tag`, `t`
1155`tag`, `t`
988: the literal `Cite` (string)
1156: the literal `Cite` (string)
989
1157
990−### Code {#type-ref-Code}
1158+### Code {#type-code}
991
1159
992Inline code
1160Inline code
993
1161
1162+Values of this type can be created with the
1163+[`pandoc.Code`](#pandoc.code) constructor.
1164+
1165+Fields:
1166+
994`text`
1167`text`
995: code string (string)
1168: code string (string)
996
1169
997`attr`
1170`attr`
998−: attributes ([Attr](#type-ref-Attr))
1171+: attributes ([Attr])
999
1172
1000`identifier`
1173`identifier`
1001: alias for `attr.identifier` (string)
1174: alias for `attr.identifier` (string)
1002
1175
1003`classes`
1176`classes`
1004−: alias for `attr.classes` ([List](#module-pandoc.list) of
1177+: alias for `attr.classes` ([List] of strings)
1005− strings)
1006
1178
1007`attributes`
1179`attributes`
1008−: alias for `attr.attributes`
1180+: alias for `attr.attributes` ([Attributes])
1009− ([Attributes](#type-ref-Attributes))
1010
1181
1011`tag`, `t`
1182`tag`, `t`
1012: the literal `Code` (string)
1183: the literal `Code` (string)
1013
1184
1014−### Emph {#type-ref-Emph}
1185+### Emph {#type-emph}
1015
1186
1016Emphasized text
1187Emphasized text
1017
1188
1189+Values of this type can be created with the
1190+[`pandoc.Emph`](#pandoc.emph) constructor.
1191+
1192+Fields:
1193+
1018`content`
1194`content`
1019−: inline content ([List](#module-pandoc.list) of
1195+: inline content ([List] of [Inlines])
1020− [Inline](#type-ref-Inline)s)
1021
1196
1022`tag`, `t`
1197`tag`, `t`
1023: the literal `Emph` (string)
1198: the literal `Emph` (string)
1024
1199
1025−### Image {#type-ref-Image}
1200+### Image {#type-image}
1026
1201
1027Image: alt text (list of inlines), target
1202Image: alt text (list of inlines), target
1028
1203
1204+Values of this type can be created with the
1205+[`pandoc.Image`](#pandoc.image) constructor.
1206+
1207+Fields:
1208+
1029`attr`
1209`attr`
1030−: attributes ([Attr](#type-ref-Attr))
1210+: attributes ([Attr])
1031
1211
1032`caption`
1212`caption`
1033−: text used to describe the image ([List](#module-pandoc.list)
1213+: text used to describe the image ([List] of [Inlines])
1034− of [Inline](#type-ref-Inline)s)
1035
1214
1036`src`
1215`src`
1037: path to the image file (string)
1216: path to the image file (string)
@@ -1043,55 +1222,68 @@ Image: alt text (list of inlines), target
1043: alias for `attr.identifier` (string)
1222: alias for `attr.identifier` (string)
1044
1223
1045`classes`
1224`classes`
1046−: alias for `attr.classes` ([List](#module-pandoc.list) of
1225+: alias for `attr.classes` ([List] of strings)
1047− strings)
1048
1226
1049`attributes`
1227`attributes`
1050−: alias for `attr.attributes`
1228+: alias for `attr.attributes` ([Attributes])
1051− ([Attributes](#type-ref-Attributes))
1052
1229
1053`tag`, `t`
1230`tag`, `t`
1054: the literal `Image` (string)
1231: the literal `Image` (string)
1055
1232
1056−### LineBreak {#type-ref-LineBreak}
1233+### LineBreak {#type-linebreak}
1057
1234
1058Hard line break
1235Hard line break
1059
1236
1237+Values of this type can be created with the
1238+[`pandoc.LineBreak`](#pandoc.linebreak) constructor.
1239+
1240+Fields:
1241+
1060`tag`, `t`
1242`tag`, `t`
1061: the literal `LineBreak` (string)
1243: the literal `LineBreak` (string)
1062
1244
1063−### Link {#type-ref-Link}
1245+### Link {#type-link}
1064
1246
1065Hyperlink: alt text (list of inlines), target
1247Hyperlink: alt text (list of inlines), target
1066
1248
1249+Values of this type can be created with the
1250+[`pandoc.Link`](#pandoc.link) constructor.
1251+
1252+Fields:
1253+
1067`attr`
1254`attr`
1068−: attributes ([Attr](#type-ref-Attr))
1255+: attributes ([Attr])
1069
1256
1070`content`
1257`content`
1071−: text for this link ([List](#module-pandoc.list) of
1258+: text for this link ([List] of [Inlines])
1072− [Inline](#type-ref-Inline)s)
1073
1259
1074`target`
1260`target`
1075: the link target (string)
1261: the link target (string)
1076
1262
1263+`title`
1264+: brief link description
1265+
1077`identifier`
1266`identifier`
1078: alias for `attr.identifier` (string)
1267: alias for `attr.identifier` (string)
1079
1268
1080`classes`
1269`classes`
1081−: alias for `attr.classes` ([List](#module-pandoc.list) of
1270+: alias for `attr.classes` ([List] of strings)
1082− strings)
1083
1271
1084`attributes`
1272`attributes`
1085−: alias for `attr.attributes`
1273+: alias for `attr.attributes` ([Attributes])
1086− ([Attributes](#type-ref-Attributes))
1087
1274
1088`tag`, `t`
1275`tag`, `t`
1089: the literal `Link` (string)
1276: the literal `Link` (string)
1090
1277
1091−### Math {#type-ref-Math}
1278+### Math {#type-math}
1092
1279
1093TeX math (literal)
1280TeX math (literal)
1094
1281
1282+Values of this type can be created with the
1283+[`pandoc.Math`](#pandoc.math) constructor.
1284+
1285+Fields:
1286+
1095`mathtype`
1287`mathtype`
1096: specifier determining whether the math content should be
1288: specifier determining whether the math content should be
1097 shown inline (`InlineMath`) or on a separate line
1289 shown inline (`InlineMath`) or on a separate line
@@ -1103,35 +1295,49 @@ TeX math (literal)
1103`tag`, `t`
1295`tag`, `t`
1104: the literal `Math` (string)
1296: the literal `Math` (string)
1105
1297
1106−### Note {#type-ref-Note}
1298+### Note {#type-note}
1107
1299
1108Footnote or endnote
1300Footnote or endnote
1109
1301
1302+Values of this type can be created with the
1303+[`pandoc.Note`](#pandoc.note) constructor.
1304+
1305+Fields:
1306+
1110`content`
1307`content`
1111−: ([List](#module-pandoc.list) of [Block](#type-ref-Block)s)
1308+: ([List] of [Blocks])
1112
1309
1113`tag`, `t`
1310`tag`, `t`
1114: the literal `Note` (string)
1311: the literal `Note` (string)
1115
1312
1116−### Quoted {#type-ref-Quoted}
1313+### Quoted {#type-quoted}
1117
1314
1118Quoted text
1315Quoted text
1119
1316
1317+Values of this type can be created with the
1318+[`pandoc.Quoted`](#pandoc.quoted) constructor.
1319+
1320+Fields:
1321+
1120`quotetype`
1322`quotetype`
1121: type of quotes to be used; one of `SingleQuote` or
1323: type of quotes to be used; one of `SingleQuote` or
1122 `DoubleQuote` (string)
1324 `DoubleQuote` (string)
1123
1325
1124`content`
1326`content`
1125−: quoted text ([List](#module-pandoc.list) of
1327+: quoted text ([List] of [Inlines])
1126− [Inline](#type-ref-Inline)s)
1127
1328
1128`tag`, `t`
1329`tag`, `t`
1129: the literal `Quoted` (string)
1330: the literal `Quoted` (string)
1130
1331
1131−### RawInline {#type-ref-RawInline}
1332+### RawInline {#type-rawinline}
1132
1333
1133Raw inline
1334Raw inline
1134
1335
1336+Values of this type can be created with the
1337+[`pandoc.RawInline`](#pandoc.rawinline) constructor.
1338+
1339+Fields:
1340+
1135`format`
1341`format`
1136: the format of the content (string)
1342: the format of the content (string)
1137
1343
@@ -1141,119 +1347,173 @@ Raw inline
1141`tag`, `t`
1347`tag`, `t`
1142: the literal `RawInline` (string)
1348: the literal `RawInline` (string)
1143
1349
1144−### SmallCaps {#type-ref-SmallCaps}
1350+### SmallCaps {#type-smallcaps}
1145
1351
1146Small caps text
1352Small caps text
1147
1353
1354+Values of this type can be created with the
1355+[`pandoc.SmallCaps`](#pandoc.smallcaps) constructor.
1356+
1357+Fields:
1358+
1148`content`
1359`content`
1149−: ([List](#module-pandoc.list) of [Inline](#type-ref-Inline)s)
1360+: ([List] of [Inlines])
1150
1361
1151`tag`, `t`
1362`tag`, `t`
1152: the literal `SmallCaps` (string)
1363: the literal `SmallCaps` (string)
1153
1364
1154−### SoftBreak {#type-ref-SoftBreak}
1365+### SoftBreak {#type-softbreak}
1155
1366
1156Soft line break
1367Soft line break
1157
1368
1369+Values of this type can be created with the
1370+[`pandoc.SoftBreak`](#pandoc.softbreak) constructor.
1371+
1372+Fields:
1373+
1158`tag`, `t`
1374`tag`, `t`
1159: the literal `SoftBreak` (string)
1375: the literal `SoftBreak` (string)
1160
1376
1161−### Space {#type-ref-Space}
1377+### Space {#type-space}
1162
1378
1163Inter-word space
1379Inter-word space
1164
1380
1381+Values of this type can be created with the
1382+[`pandoc.Space`](#pandoc.space) constructor.
1383+
1384+Fields:
1385+
1165`tag`, `t`
1386`tag`, `t`
1166: the literal `Space` (string)
1387: the literal `Space` (string)
1167
1388
1168−### Span {#type-ref-Span}
1389+### Span {#type-span}
1169
1390
1170Generic inline container with attributes
1391Generic inline container with attributes
1171
1392
1393+Values of this type can be created with the
1394+[`pandoc.Span`](#pandoc.span) constructor.
1395+
1396+Fields:
1397+
1172`attr`
1398`attr`
1173−: attributes ([Attr](#type-ref-Attr))
1399+: attributes ([Attr])
1174
1400
1175`content`
1401`content`
1176−: wrapped content ([List](#module-pandoc.list) of
1402+: wrapped content ([List] of [Inlines])
1177− [Inline](#type-ref-Inline)s)
1178
1403
1179`identifier`
1404`identifier`
1180: alias for `attr.identifier` (string)
1405: alias for `attr.identifier` (string)
1181
1406
1182`classes`
1407`classes`
1183−: alias for `attr.classes` ([List](#module-pandoc.list) of
1408+: alias for `attr.classes` ([List] of strings)
1184− strings)
1185
1409
1186`attributes`
1410`attributes`
1187−: alias for `attr.attributes`
1411+: alias for `attr.attributes` ([Attributes])
1188− ([Attributes](#type-ref-Attributes))
1189
1412
1190`tag`, `t`
1413`tag`, `t`
1191: the literal `Span` (string)
1414: the literal `Span` (string)
1192
1415
1193−### Str {#type-ref-Str}
1416+### Str {#type-str}
1194
1417
1195Text
1418Text
1196
1419
1420+Values of this type can be created with the
1421+[`pandoc.Str`](#pandoc.str) constructor.
1422+
1423+Fields:
1424+
1197`text`
1425`text`
1198: content (string)
1426: content (string)
1199
1427
1200`tag`, `t`
1428`tag`, `t`
1201: the literal `Str` (string)
1429: the literal `Str` (string)
1202
1430
1203−### Strikeout {#type-ref-Strikeout}
1431+### Strikeout {#type-strikeout}
1204
1432
1205Strikeout text
1433Strikeout text
1206
1434
1435+Values of this type can be created with the
1436+[`pandoc.Strikeout`](#pandoc.strikeout) constructor.
1437+
1438+Fields:
1439+
1207`content`
1440`content`
1208−: inline content ([List](#module-pandoc.list) of
1441+: inline content ([List] of [Inlines])
1209− [Inline](#type-ref-Inline)s)
1210
1442
1211`tag`, `t`
1443`tag`, `t`
1212: the literal `Strikeout` (string)
1444: the literal `Strikeout` (string)
1213
1445
1214−### Strong {#type-ref-Strong}
1446+### Strong {#type-strong}
1215
1447
1216Strongly emphasized text
1448Strongly emphasized text
1217
1449
1450+Values of this type can be created with the
1451+[`pandoc.Strong`](#pandoc.strong) constructor.
1452+
1453+Fields:
1454+
1218`content`
1455`content`
1219−: inline content ([List](#module-pandoc.list) of
1456+: inline content ([List] of [Inlines])
1220− [Inline](#type-ref-Inline)s)
1221
1457
1222`tag`, `t`
1458`tag`, `t`
1223: the literal `Strong` (string)
1459: the literal `Strong` (string)
1224
1460
1225−### Subscript {#type-ref-Subscript}
1461+### Subscript {#type-subscript}
1226
1462
1227Subscripted text
1463Subscripted text
1228
1464
1465+Values of this type can be created with the
1466+[`pandoc.Subscript`](#pandoc.subscript) constructor.
1467+
1468+Fields:
1469+
1229`content`
1470`content`
1230−: inline content ([List](#module-pandoc.list) of
1471+: inline content ([List] of [Inlines])
1231− [Inline](#type-ref-Inline)s)
1232
1472
1233`tag`, `t`
1473`tag`, `t`
1234: the literal `Subscript` (string)
1474: the literal `Subscript` (string)
1235
1475
1236−### Superscript {#type-ref-Superscript}
1476+### Superscript {#type-superscript}
1237
1477
1238Superscripted text
1478Superscripted text
1239
1479
1480+Values of this type can be created with the
1481+[`pandoc.Superscript`](#pandoc.superscript) constructor.
1482+
1483+Fields:
1484+
1240`content`
1485`content`
1241−: inline content ([List](#module-pandoc.list) of
1486+: inline content ([List] of [Inlines])
1242− [Inline](#type-ref-Inline)s)
1243
1487
1244`tag`, `t`
1488`tag`, `t`
1245: the literal `Superscript` (string)
1489: the literal `Superscript` (string)
1246
1490
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+
1247## Element components
1507## Element components
1248
1508
1249−### Attr {#type-ref-Attr}
1509+### Attr {#type-attr}
1250
1510
1251A set of element attributes. Values of this type can be created
1511A set of element attributes. Values of this type can be created
1252−with the [`pandoc.Attr`](#Attr) constructor. For convenience, it
1512+with the [`pandoc.Attr`](#pandoc.attr) constructor. For
1253−is usually not necessary to construct the value directly if it is
1513+convenience, it is usually not necessary to construct the value
1254−part of an element, and it is sufficient to pass an HTML-like
1514+directly if it is part of an element, and it is sufficient to
1255−table. E.g., to create a span with identifier "text" and classes
1515+pass an HTML-like table. E.g., to create a span with identifier
1256−"a" and "b", on can write:
1516+"text" and classes "a" and "b", one can write:
1257
1517
1258 local span = pandoc.Span('text', {id = 'text', class = 'a b'})
1518 local span = pandoc.Span('text', {id = 'text', class = 'a b'})
1259
1519
@@ -1262,30 +1522,69 @@ This also works when using the `attr` setter:
1262 local span = pandoc.Span 'text'
1522 local span = pandoc.Span 'text'
1263 span.attr = {id = 'text', class = 'a b', other_attribute = '1'}
1523 span.attr = {id = 'text', class = 'a b', other_attribute = '1'}
1264
1524
1265−Object equality is determined via
1525+Object equality is determined via [`pandoc.utils.equals`].
1266−[`pandoc.utils.equals`](#utils-equals).
1526+
1527+Fields:
1267
1528
1268`identifier`
1529`identifier`
1269: element identifier (string)
1530: element identifier (string)
1270
1531
1271`classes`
1532`classes`
1272−: element classes ([List](#module-pandoc.list) of strings)
1533+: element classes ([List] of strings)
1273
1534
1274`attributes`
1535`attributes`
1275−: collection of key/value pairs
1536+: collection of key/value pairs ([Attributes])
1276− ([Attributes](#type-ref-Attributes))
1277
1537
1278−### Attributes {#type-ref-Attributes}
1538+### Attributes {#type-attributes}
1279
1539
1280List of key/value pairs. Values can be accessed by using keys as
1540List of key/value pairs. Values can be accessed by using keys as
1281indices to the list table.
1541indices to the list table.
1282
1542
1283−### Citation {#type-ref-Citation}
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}
1284
1579
1285Single citation entry
1580Single citation entry
1286
1581
1582+Values of this type can be created with the
1583+[`pandoc.Citation`](#pandoc.citation) constructor.
1584+
1287−Object equality is determined via
1585+Object equality is determined via [`pandoc.utils.equals`].
1288−[`pandoc.utils.equals`](#utils-equals).
1586+
1587+Fields:
1289
1588
1290`id`
1589`id`
1291: citation identifier, e.g., a bibtex key (string)
1590: citation identifier, e.g., a bibtex key (string)
@@ -1295,12 +1594,10 @@ Object equality is determined via
1295 `NormalCitation` (string)
1594 `NormalCitation` (string)
1296
1595
1297`prefix`
1596`prefix`
1298−: citation prefix ([List](#module-pandoc.list) of
1597+: citation prefix ([List] of [Inlines])
1299− [Inline](#type-ref-Inline)s)
1300
1598
1301`suffix`
1599`suffix`
1302−: citation suffix ([List](#module-pandoc.list) of
1600+: citation suffix ([List] of [Inlines])
1303− [Inline](#type-ref-Inline)s)
1304
1601
1305`note_num`
1602`note_num`
1306: note number (integer)
1603: note number (integer)
@@ -1308,12 +1605,27 @@ Object equality is determined via
1308`hash`
1605`hash`
1309: hash (integer)
1606: hash (integer)
1310
1607
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+
1311−### ListAttributes {#type-ref-ListAttributes}
1619+### ListAttributes {#type-listattributes}
1312
1620
1313List attributes
1621List attributes
1314
1622
1623+Values of this type can be created with the
1624+[`pandoc.ListAttributes`](#pandoc.listattributes) constructor.
1625+
1315−Object equality is determined via
1626+Object equality is determined via [`pandoc.utils.equals`].
1316−[`pandoc.utils.equals`](#utils-equals).
1627+
1628+Fields:
1317
1629
1318`start`
1630`start`
1319: number of the first list item (integer)
1631: number of the first list item (integer)
@@ -1327,10 +1639,59 @@ Object equality is determined via
1327: delimiter of list numbers; one of `DefaultDelim`, `Period`,
1639: delimiter of list numbers; one of `DefaultDelim`, `Period`,
1328 `OneParen`, and `TwoParens` (string)
1640 `OneParen`, and `TwoParens` (string)
1329
1641
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+
1330−## ReaderOptions {#type-ref-ReaderOptions}
1689+## ReaderOptions {#type-readeroptions}
1331
1690
1332Pandoc reader options
1691Pandoc reader options
1333
1692
1693+Fields:
1694+
1334`abbreviations`
1695`abbreviations`
1335: set of known abbreviations (set of strings)
1696: set of known abbreviations (set of strings)
1336
1697
@@ -1363,22 +1724,23 @@ Pandoc reader options
1363: track changes setting for docx; one of `AcceptChanges`,
1724: track changes setting for docx; one of `AcceptChanges`,
1364 `RejectChanges`, and `AllChanges` (string)
1725 `RejectChanges`, and `AllChanges` (string)
1365
1726
1366−## CommonState {#type-ref-CommonState}
1727+## CommonState {#type-commonstate}
1367
1728
1368The state used by pandoc to collect information and make it
1729The state used by pandoc to collect information and make it
1369available to readers and writers.
1730available to readers and writers.
1370
1731
1732+Fields:
1733+
1371`input_files`
1734`input_files`
1372: List of input files from command line
1735: List of input files from command line
1373− ([List](#module-pandoc.list) of strings)
1736+ ([List] of strings)
1374
1737
1375`output_file`
1738`output_file`
1376: Output file from command line (string or nil)
1739: Output file from command line (string or nil)
1377
1740
1378`log`
1741`log`
1379−: A list of log messages in reverse order
1742+: A list of log messages in reverse order ([List] of
1380− ([List](#module-pandoc.list) of
1381− [LogMessage](#type-ref-LogMessage)s)
1743+ [LogMessage]s)
1382
1744
1383`request_headers`
1745`request_headers`
1384: Headers to add for HTTP requests; table with header names as
1746: Headers to add for HTTP requests; table with header names as
@@ -1386,7 +1748,7 @@ available to readers and writers.
1386
1748
1387`resource_path`
1749`resource_path`
1388: Path to search for resources like included images
1750: Path to search for resources like included images
1389− ([List](#module-pandoc.list) of strings)
1751+ ([List] of strings)
1390
1752
1391`source_url`
1753`source_url`
1392: Absolute URL or directory of first source file (string or
1754: Absolute URL or directory of first source file (string or
@@ -1401,12 +1763,57 @@ available to readers and writers.
1401`verbosity`
1763`verbosity`
1402: Verbosity level; one of `INFO`, `WARNING`, `ERROR` (string)
1764: Verbosity level; one of `INFO`, `WARNING`, `ERROR` (string)
1403
1765
1404−## LogMessage {#type-ref-LogMessage}
1766+## List {#type-list}
1767+
1768+A list is any Lua table with integer indices. Indices start at
1769+one, so if `alist = {'value'}` then `alist[1] == 'value'`.
1405
1770
1771+Lists, when part of an element, or when generated during
1772+marshaling, are made instances of the `pandoc.List` type for
1773+convenience. The `pandoc.List` type is defined in the
1774+[*pandoc.List*](#module-pandoc.list) module. See there for
1775+available methods.
1776+
1777+Values of this type can be created with the
1778+[`pandoc.List`](#pandoc.list) constructor, turning a normal Lua
1779+table into a List.
1780+
1781+## LogMessage {#type-logmessage}
1782+
1406−A pandoc log message. Object have no fields, but can be
1783+A pandoc log message. Objects have no fields, but can be
1407converted to a string via `tostring`.
1784converted to a string via `tostring`.
1408
1785
1409−## Version {#type-ref-Version}
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}
1410
1817
1411A version object. This represents a software version like
1818A version object. This represents a software version like
1412"2.7.3". The object behaves like a numerically indexed table,
1819"2.7.3". The object behaves like a numerically indexed table,
@@ -1421,6 +1828,9 @@ Comparisons are performed element-wise, i.e.
1421
1828
1422 Version '1.12' > Version '1.9'
1829 Version '1.12' > Version '1.9'
1423
1830
1831+Values of this type can be created with the
1832+[`pandoc.types.Version`](#pandoc.types.version) constructor.
1833+
1424### `must_be_at_least`
1834### `must_be_at_least`
1425
1835
1426`must_be_at_least(actual, expected [, error_message])`
1836`must_be_at_least(actual, expected [, error_message])`
@@ -1432,10 +1842,10 @@ than the expected version.
1432Parameters:
1842Parameters:
1433
1843
1434`actual`
1844`actual`
1435−: actual version specifier ([Version](#type-ref-Version))
1845+: actual version specifier ([Version])
1436
1846
1437`expected`
1847`expected`
1438−: minimum expected version ([Version](#type-ref-Version))
1848+: minimum expected version ([Version])
1439
1849
1440`error_message`
1850`error_message`
1441: optional error message template. The string is used as
1851: optional error message template. The string is used as
@@ -1451,6 +1861,38 @@ Usage:
1451 'pandoc-types is too old: expected version %s, got %s'
1861 'pandoc-types is too old: expected version %s, got %s'
1452 )
1862 )
1453
1863
1864+[Alignment]: #type-alignment
1865+[Attr]: #type-attr
1866+[Attributes]: #type-attributes
1867+[Block]: #type-block
1868+[Blocks]: #type-block
1869+[Caption]: #type-caption
1870+[Cells]: #type-cell
1871+[Citation]: #type-citation
1872+[Citations]: #type-citation
1873+[ColSpec]: #type-colspec
1874+[CommonState]: #type-commonstate
1875+[Image]: #type-image
1876+[Inline]: #type-inline
1877+[Inlines]: #type-inline
1878+[List]: #type-list
1879+[ListAttributes]: #type-listattributes
1880+[Meta]: #type-meta
1881+[MetaBlocks]: #type-metablocks
1882+[MetaValue]: #type-metavalue
1883+[MetaValues]: #type-metavalue
1884+[LogMessage]: #type-logmessage
1885+[Pandoc]: #type-pandoc
1886+[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
1894+[`pandoc.utils.equals`]: #pandoc.utils.equals
1895+
1454# Module text
1896# Module text
1455
1897
1456UTF-8 aware text manipulation functions, implemented in Haskell.
1898UTF-8 aware text manipulation functions, implemented in Haskell.
@@ -1466,31 +1908,31 @@ function Str (s)
1466end
1908end
1467```
1909```
1468
1910
1469−### lower {#text-lower}
1911+### lower {#text.lower}
1470
1912
1471`lower (s)`
1913`lower (s)`
1472
1914
1473Returns a copy of a UTF-8 string, converted to lowercase.
1915Returns a copy of a UTF-8 string, converted to lowercase.
1474
1916
1475−### upper {#text-upper}
1917+### upper {#text.upper}
1476
1918
1477`upper (s)`
1919`upper (s)`
1478
1920
1479Returns a copy of a UTF-8 string, converted to uppercase.
1921Returns a copy of a UTF-8 string, converted to uppercase.
1480
1922
1481−### reverse {#text-reverse}
1923+### reverse {#text.reverse}
1482
1924
1483`reverse (s)`
1925`reverse (s)`
1484
1926
1485Returns a copy of a UTF-8 string, with characters reversed.
1927Returns a copy of a UTF-8 string, with characters reversed.
1486
1928
1487−### len {#text-len}
1929+### len {#text.len}
1488
1930
1489`len (s)`
1931`len (s)`
1490
1932
1491Returns the length of a UTF-8 string.
1933Returns the length of a UTF-8 string.
1492
1934
1493−### sub {#text-sub}
1935+### sub {#text.sub}
1494
1936
1495`sub (s)`
1937`sub (s)`
1496
1938
@@ -1499,11 +1941,13 @@ indexing rules.
1499
1941
1500# Module pandoc
1942# Module pandoc
1501
1943
1502−Lua functions for pandoc scripts.
1944+Lua functions for pandoc scripts; includes constructors for
1945+document tree elements, functions to parse text in a given
1946+format, and functions to filter and modify a subtree.
1503
1947
1504−## Pandoc Document
1948+## Pandoc
1505
1949
1506−[`Pandoc (blocks[, meta])`]{#Pandoc}
1950+[`Pandoc (blocks[, meta])`]{#pandoc.pandoc}
1507
1951
1508: A complete pandoc document
1952: A complete pandoc document
1509
1953
@@ -1515,9 +1959,11 @@ Lua functions for pandoc scripts.
1515 `meta`:
1959 `meta`:
1516 : document meta data
1960 : document meta data
1517
1961
1518−## Meta {#meta}
1962+ Returns: [Pandoc] object
1519
1963
1964+## Meta
1965+
1520−[`Meta (table)`]{#Meta}
1966+[`Meta (table)`]{#pandoc.meta}
1521
1967
1522: Create a new Meta object.
1968: Create a new Meta object.
1523
1969
@@ -1526,9 +1972,11 @@ Lua functions for pandoc scripts.
1526 `table`:
1972 `table`:
1527 : table containing document meta information
1973 : table containing document meta information
1528
1974
1975+ Returns: [Meta] object
1976+
1529−## MetaValue {#metavalue}
1977+## MetaValue
1530
1978
1531−[`MetaBlocks (blocks)`]{#MetaBlocks}
1979+[`MetaBlocks (blocks)`]{#pandoc.metablocks}
1532
1980
1533: Meta blocks
1981: Meta blocks
1534
1982
@@ -1537,7 +1985,9 @@ Lua functions for pandoc scripts.
1537 `blocks`:
1985 `blocks`:
1538 : blocks
1986 : blocks
1539
1987
1988+ Returns: [MetaBlocks] object
1989+
1540−[`MetaInlines (inlines)`]{#MetaInlines}
1990+[`MetaInlines (inlines)`]{#pandoc.metainlines}
1541
1991
1542: Meta inlines
1992: Meta inlines
1543
1993
@@ -1546,7 +1996,9 @@ Lua functions for pandoc scripts.
1546 `inlines`:
1996 `inlines`:
1547 : inlines
1997 : inlines
1548
1998
1999+ Returns: [MetaInlines] object
2000+
1549−[`MetaList (meta_values)`]{#MetaList}
2001+[`MetaList (meta_values)`]{#pandoc.metalist}
1550
2002
1551: Meta list
2003: Meta list
1552
2004
@@ -1555,7 +2007,9 @@ Lua functions for pandoc scripts.
1555 `meta_values`:
2007 `meta_values`:
1556 : list of meta values
2008 : list of meta values
1557
2009
2010+ Returns: [MetaList] object
2011+
1558−[`MetaMap (key_value_map)`]{#MetaMap}
2012+[`MetaMap (key_value_map)`]{#pandoc.metamap}
1559
2013
1560: Meta map
2014: Meta map
1561
2015
@@ -1564,7 +2018,9 @@ Lua functions for pandoc scripts.
1564 `key_value_map`:
2018 `key_value_map`:
1565 : a string-indexed map of meta values
2019 : a string-indexed map of meta values
1566
2020
2021+ Returns: [MetaMap] object
2022+
1567−[`MetaString (str)`]{#MetaString}
2023+[`MetaString (str)`]{#pandoc.metastring}
1568
2024
1569: Creates string to be used in meta data.
2025: Creates string to be used in meta data.
1570
2026
@@ -1573,7 +2029,9 @@ Lua functions for pandoc scripts.
1573 `str`:
2029 `str`:
1574 : string value
2030 : string value
1575
2031
2032+ Returns: [MetaString] object
2033+
1576−[`MetaBool (bool)`]{#MetaBool}
2034+[`MetaBool (bool)`]{#pandoc.metabool}
1577
2035
1578: Creates boolean to be used in meta data.
2036: Creates boolean to be used in meta data.
1579
2037
@@ -1582,13 +2040,11 @@ Lua functions for pandoc scripts.
1582 `bool`:
2040 `bool`:
1583 : boolean value
2041 : boolean value
1584
2042
1585−## Blocks
2043+ Returns: [MetaBool] object
1586
2044
1587−[`Block`]{#Block}
2045+## Blocks
1588−
1589−: Block elements
1590
2046
1591−[`BlockQuote (content)`]{#BlockQuote}
2047+[`BlockQuote (content)`]{#pandoc.blockquote}
1592
2048
1593: Creates a block quote element
2049: Creates a block quote element
1594
2050
@@ -1597,20 +2053,20 @@ Lua functions for pandoc scripts.
1597 `content`:
2053 `content`:
1598 : block content
2054 : block content
1599
2055
1600− Returns: block quote element
2056+ Returns: [BlockQuote] object
1601
2057
1602−[`BulletList (content)`]{#BulletList}
2058+[`BulletList (items)`]{#pandoc.bulletlist}
1603
2059
1604−: Creates a bullet (i.e.
2060+: Creates a bullet list.
1605
2061
1606 Parameters:
2062 Parameters:
1607
2063
1608− `content`:
2064+ `items`:
1609− : list of items
2065+ : list items
1610
2066
1611− Returns: bullet list element
2067+ Returns: [BulletList] object
1612
2068
1613−[`CodeBlock (text[, attr])`]{#CodeBlock}
2069+[`CodeBlock (text[, attr])`]{#pandoc.codeblock}
1614
2070
1615: Creates a code block element
2071: Creates a code block element
1616
2072
@@ -1622,9 +2078,9 @@ Lua functions for pandoc scripts.
1622 `attr`:
2078 `attr`:
1623 : element attributes
2079 : element attributes
1624
2080
1625− Returns: code block element
2081+ Returns: [CodeBlock] object
1626
2082
1627−[`DefinitionList (content)`]{#DefinitionList}
2083+[`DefinitionList (content)`]{#pandoc.definitionlist}
1628
2084
1629: Creates a definition list, containing terms and their
2085: Creates a definition list, containing terms and their
1630 explanation.
2086 explanation.
@@ -1634,9 +2090,9 @@ Lua functions for pandoc scripts.
1634 `content`:
2090 `content`:
1635 : list of items
2091 : list of items
1636
2092
1637− Returns: definition list element
2093+ Returns: [DefinitionList] object
1638
2094
1639−[`Div (content[, attr])`]{#Div}
2095+[`Div (content[, attr])`]{#pandoc.div}
1640
2096
1641: Creates a div element
2097: Creates a div element
1642
2098
@@ -1648,9 +2104,9 @@ Lua functions for pandoc scripts.
1648 `attr`:
2104 `attr`:
1649 : element attributes
2105 : element attributes
1650
2106
1651− Returns: div element
2107+ Returns: [Div] object
1652
2108
1653−[`Header (level, content[, attr])`]{#Header}
2109+[`Header (level, content[, attr])`]{#pandoc.header}
1654
2110
1655: Creates a header element.
2111: Creates a header element.
1656
2112
@@ -1665,15 +2121,15 @@ Lua functions for pandoc scripts.
1665 `attr`:
2121 `attr`:
1666 : element attributes
2122 : element attributes
1667
2123
1668− Returns: header element
2124+ Returns: [Header] object
1669
2125
1670−[`HorizontalRule ()`]{#HorizontalRule}
2126+[`HorizontalRule ()`]{#pandoc.horizontalrule}
1671
2127
1672: Creates a horizontal rule.
2128: Creates a horizontal rule.
1673
2129
1674− Returns: horizontal rule
2130+ Returns: [HorizontalRule] object
1675
2131
1676−[`LineBlock (content)`]{#LineBlock}
2132+[`LineBlock (content)`]{#pandoc.lineblock}
1677
2133
1678: Creates a line block element.
2134: Creates a line block element.
1679
2135
@@ -1682,15 +2138,15 @@ Lua functions for pandoc scripts.
1682 `content`:
2138 `content`:
1683 : inline content
2139 : inline content
1684
2140
1685− Returns: line block element
2141+ Returns: [LineBlock] object
1686
2142
1687−[`Null ()`]{#Null}
2143+[`Null ()`]{#pandoc.null}
1688
2144
1689: Creates a null element.
2145: Creates a null element.
1690
2146
1691− Returns: null element
2147+ Returns: [Null] object
1692
2148
1693−[`OrderedList (items[, listAttributes])`]{#OrderedList}
2149+[`OrderedList (items[, listAttributes])`]{#pandoc.orderedlist}
1694
2150
1695: Creates an ordered list.
2151: Creates an ordered list.
1696
2152
@@ -1702,9 +2158,9 @@ Lua functions for pandoc scripts.
1702 `listAttributes`:
2158 `listAttributes`:
1703 : list parameters
2159 : list parameters
1704
2160
1705− Returns: ordered list element
2161+ Returns: [OrderedList](#type-orderedlist) object
1706
2162
1707−[`Para (content)`]{#Para}
2163+[`Para (content)`]{#pandoc.para}
1708
2164
1709: Creates a para element.
2165: Creates a para element.
1710
2166
@@ -1713,9 +2169,9 @@ Lua functions for pandoc scripts.
1713 `content`:
2169 `content`:
1714 : inline content
2170 : inline content
1715
2171
1716− Returns: paragraph element
2172+ Returns: [Para](#type-para) object
1717
2173
1718−[`Plain (content)`]{#Plain}
2174+[`Plain (content)`]{#pandoc.plain}
1719
2175
1720: Creates a plain element.
2176: Creates a plain element.
1721
2177
@@ -1724,9 +2180,9 @@ Lua functions for pandoc scripts.
1724 `content`:
2180 `content`:
1725 : inline content
2181 : inline content
1726
2182
1727− Returns: plain element
2183+ Returns: [Plain](#type-plain) object
1728
2184
1729−[`RawBlock (format, text)`]{#RawBlock}
2185+[`RawBlock (format, text)`]{#pandoc.rawblock}
1730
2186
1731: Creates a raw content block of the specified format.
2187: Creates a raw content block of the specified format.
1732
2188
@@ -1738,38 +2194,37 @@ Lua functions for pandoc scripts.
1738 `text`:
2194 `text`:
1739 : string content
2195 : string content
1740
2196
1741− Returns: raw block element
2197+ Returns: [RawBlock](#type-rawblock) object
1742
2198
1743−[`Table (caption, aligns, widths, headers, rows)`]{#Table}
2199+[`Table (caption, colspecs, head, bodies, foot[, attr])`]{#pandoc.table}
1744
2200
1745: Creates a table element.
2201: Creates a table element.
1746
2202
1747 Parameters:
2203 Parameters:
1748
2204
1749 `caption`:
2205 `caption`:
1750− : table caption
2206+ : table [caption](#type-caption)
1751−
1752− `aligns`:
1753− : alignments
1754
2207
1755− `widths`:
2208+ `colspecs`:
1756− : column widths
2209+ : column alignments and widths (list of [ColSpec](#type-colspec)s)
1757
2210
1758− `headers`:
2211+ `head`:
1759− : header row
2212+ : [table head](#type-tablehead)
1760
2213
1761− `rows`:
2214+ `bodies`:
1762− : table rows
2215+ : [table bodies](#type-tablebody)
1763
2216
1764− Returns: table element
2217+ `foot`:
2218+ : [table foot](#type-tablefoot)
1765
2219
1766−## Inline {#inline}
2220+ `attr`:
2221+ : element attributes
1767
2222
1768−[`Inline`]{#Inline}
2223+ Returns: [Table](#type-table) object
1769
2224
1770−: Inline element class
2225+## Inline
1771
2226
1772−[`Cite (content, citations)`]{#Cite}
2227+[`Cite (content, citations)`]{#pandoc.cite}
1773
2228
1774: Creates a Cite inline element
2229: Creates a Cite inline element
1775
2230
@@ -1781,9 +2236,9 @@ Lua functions for pandoc scripts.
1781 `citations`:
2236 `citations`:
1782 : List of citations
2237 : List of citations
1783
2238
1784− Returns: citations element
2239+ Returns: [Cite](#type-cite) object
1785
2240
1786−[`Code (text[, attr])`]{#Code}
2241+[`Code (text[, attr])`]{#pandoc.code}
1787
2242
1788: Creates a Code inline element
2243: Creates a Code inline element
1789
2244
@@ -1795,20 +2250,20 @@ Lua functions for pandoc scripts.
1795 `attr`:
2250 `attr`:
1796 : additional attributes
2251 : additional attributes
1797
2252
1798− Returns: code element
2253+ Returns: [Code](#type-code) object
1799
2254
1800−[`Emph (content)`]{#Emph}
2255+[`Emph (content)`]{#pandoc.emph}
1801
2256
1802−: Creates an inline element representing emphasised text.
2257+: Creates an inline element representing emphasized text.
1803
2258
1804 Parameters:
2259 Parameters:
1805
2260
1806 `content`:
2261 `content`:
1807 : inline content
2262 : inline content
1808
2263
1809− Returns: emphasis element
2264+ Returns: [Emph](#type-emph) object
1810
2265
1811−[`Image (caption, src[, title[, attr]])`]{#Image}
2266+[`Image (caption, src[, title[, attr]])`]{#pandoc.image}
1812
2267
1813: Creates a Image inline element
2268: Creates a Image inline element
1814
2269
@@ -1826,15 +2281,15 @@ Lua functions for pandoc scripts.
1826 `attr`:
2281 `attr`:
1827 : additional attributes
2282 : additional attributes
1828
2283
1829− Returns: image element
2284+ Returns: [Image](#type-image) object
1830
2285
1831−[`LineBreak ()`]{#LineBreak}
2286+[`LineBreak ()`]{#pandoc.linebreak}
1832
2287
1833: Create a LineBreak inline element
2288: Create a LineBreak inline element
1834
2289
1835− Returns: linebreak element
2290+ Returns: [LineBreak](#type-linebreak) object
1836
2291
1837−[`Link (content, target[, title[, attr]])`]{#Link}
2292+[`Link (content, target[, title[, attr]])`]{#pandoc.link}
1838
2293
1839: Creates a link inline element, usually a hyperlink.
2294: Creates a link inline element, usually a hyperlink.
1840
2295
@@ -1852,9 +2307,9 @@ Lua functions for pandoc scripts.
1852 `attr`:
2307 `attr`:
1853 : additional attributes
2308 : additional attributes
1854
2309
1855− Returns: image element
2310+ Returns: [Link](#type-link) object
1856
2311
1857−[`Math (mathtype, text)`]{#Math}
2312+[`Math (mathtype, text)`]{#pandoc.math}
1858
2313
1859: Creates a Math element, either inline or displayed.
2314: Creates a Math element, either inline or displayed.
1860
2315
@@ -1866,31 +2321,31 @@ Lua functions for pandoc scripts.
1866 `text`:
2321 `text`:
1867 : Math content
2322 : Math content
1868
2323
1869− Returns: Math element
2324+ Returns: [Math](#type-math) object
1870
2325
1871−[`DisplayMath (text)`]{#DisplayMath}
2326+[`DisplayMath (text)`]{#pandoc.displaymath}
1872
2327
1873−: Creates a DisplayMath element (DEPRECATED).
2328+: Creates a math element of type "DisplayMath" (DEPRECATED).
1874
2329
1875 Parameters:
2330 Parameters:
1876
2331
1877 `text`:
2332 `text`:
1878 : Math content
2333 : Math content
1879
2334
1880− Returns: Math element
2335+ Returns: [Math](#type-math) object
1881
2336
1882−[`InlineMath (text)`]{#InlineMath}
2337+[`InlineMath (text)`]{#pandoc.inlinemath}
1883
2338
1884−: Creates an InlineMath inline element (DEPRECATED).
2339+: Creates a math element of type "InlineMath" (DEPRECATED).
1885
2340
1886 Parameters:
2341 Parameters:
1887
2342
1888 `text`:
2343 `text`:
1889 : Math content
2344 : Math content
1890
2345
1891− Returns: Math element
2346+ Returns: [Math](#type-math) object
1892
2347
1893−[`Note (content)`]{#Note}
2348+[`Note (content)`]{#pandoc.note}
1894
2349
1895: Creates a Note inline element
2350: Creates a Note inline element
1896
2351
@@ -1899,7 +2354,9 @@ Lua functions for pandoc scripts.
1899 `content`:
2354 `content`:
1900 : footnote block content
2355 : footnote block content
1901
2356
2357+ Returns: [Note](#type-note) object
2358+
1902−[`Quoted (quotetype, content)`]{#Quoted}
2359+[`Quoted (quotetype, content)`]{#pandoc.quoted}
1903
2360
1904: Creates a Quoted inline element given the quote type and
2361: Creates a Quoted inline element given the quote type and
1905 quoted content.
2362 quoted content.
@@ -1912,9 +2369,9 @@ Lua functions for pandoc scripts.
1912 `content`:
2369 `content`:
1913 : inline content
2370 : inline content
1914
2371
1915− Returns: quoted element
2372+ Returns: [Quoted](#type-quoted) object
1916
2373
1917−[`SingleQuoted (content)`]{#SingleQuoted}
2374+[`SingleQuoted (content)`]{#pandoc.singlequoted}
1918
2375
1919: Creates a single-quoted inline element (DEPRECATED).
2376: Creates a single-quoted inline element (DEPRECATED).
1920
2377
@@ -1923,11 +2380,9 @@ Lua functions for pandoc scripts.
1923 `content`:
2380 `content`:
1924 : inline content
2381 : inline content
1925
2382
1926− Returns: quoted element
2383+ Returns: [Quoted](#type-quoted)
1927−
1928− See also: [Quoted](#Quoted)
1929
2384
1930−[`DoubleQuoted (content)`]{#DoubleQuoted}
2385+[`DoubleQuoted (content)`]{#pandoc.doublequoted}
1931
2386
1932: Creates a single-quoted inline element (DEPRECATED).
2387: Creates a single-quoted inline element (DEPRECATED).
1933
2388
@@ -1936,13 +2391,11 @@ Lua functions for pandoc scripts.
1936 `content`:
2391 `content`:
1937 : inline content
2392 : inline content
1938
2393
1939− Returns: quoted element
2394+ Returns: [Quoted](#type-quoted)
1940
2395
1941− See also: [Quoted](#Quoted)
2396+[`RawInline (format, text)`]{#pandoc.rawinline}
1942
2397
1943−[`RawInline (format, text)`]{#RawInline}
1944−
1945−: Creates a RawInline inline element
2398+: Creates a raw inline element
1946
2399
1947 Parameters:
2400 Parameters:
1948
2401
@@ -1952,9 +2405,9 @@ Lua functions for pandoc scripts.
1952 `text`:
2405 `text`:
1953 : string content
2406 : string content
1954
2407
1955− Returns: raw inline element
2408+ Returns: [RawInline](#type-rawinline) object
1956
2409
1957−[`SmallCaps (content)`]{#SmallCaps}
2410+[`SmallCaps (content)`]{#pandoc.smallcaps}
1958
2411
1959: Creates text rendered in small caps
2412: Creates text rendered in small caps
1960
2413
@@ -1963,21 +2416,21 @@ Lua functions for pandoc scripts.
1963 `content`:
2416 `content`:
1964 : inline content
2417 : inline content
1965
2418
1966− Returns: smallcaps element
2419+ Returns: [SmallCaps](#type-smallcaps) object
1967
2420
1968−[`SoftBreak ()`]{#SoftBreak}
2421+[`SoftBreak ()`]{#pandoc.softbreak}
1969
2422
1970: Creates a SoftBreak inline element.
2423: Creates a SoftBreak inline element.
1971
2424
1972− Returns: softbreak element
2425+ Returns: [SoftBreak](#type-softbreak) object
1973
2426
1974−[`Space ()`]{#Space}
2427+[`Space ()`]{#pandoc.space}
1975
2428
1976: Create a Space inline element
2429: Create a Space inline element
1977
2430
1978− Returns: space element
2431+ Returns: [Space](#type-space) object
1979
2432
1980−[`Span (content[, attr])`]{#Span}
2433+[`Span (content[, attr])`]{#pandoc.span}
1981
2434
1982: Creates a Span inline element
2435: Creates a Span inline element
1983
2436
@@ -1989,9 +2442,9 @@ Lua functions for pandoc scripts.
1989 `attr`:
2442 `attr`:
1990 : additional attributes
2443 : additional attributes
1991
2444
1992− Returns: span element
2445+ Returns: [Span](#type-span) object
1993
2446
1994−[`Str (text)`]{#Str}
2447+[`Str (text)`]{#pandoc.str}
1995
2448
1996: Creates a Str inline element
2449: Creates a Str inline element
1997
2450
@@ -2000,20 +2453,20 @@ Lua functions for pandoc scripts.
2000 `text`:
2453 `text`:
2001 : content
2454 : content
2002
2455
2003− Returns: string element
2456+ Returns: [Str](#type-str) object
2004
2457
2005−[`Strikeout (content)`]{#Strikeout}
2458+[`Strikeout (content)`]{#pandoc.strikeout}
2006
2459
2007−: Creates text which is striked out.
2460+: Creates text which is struck out.
2008
2461
2009 Parameters:
2462 Parameters:
2010
2463
2011 `content`:
2464 `content`:
2012 : inline content
2465 : inline content
2013
2466
2014− Returns: strikeout element
2467+ Returns: [Strikeout](#type-strikeout) object
2015
2468
2016−[`Strong (content)`]{#Strong}
2469+[`Strong (content)`]{#pandoc.strong}
2017
2470
2018: Creates a Strong element, whose text is usually displayed in
2471: Creates a Strong element, whose text is usually displayed in
2019 a bold font.
2472 a bold font.
@@ -2023,9 +2476,9 @@ Lua functions for pandoc scripts.
2023 `content`:
2476 `content`:
2024 : inline content
2477 : inline content
2025
2478
2026− Returns: strong element
2479+ Returns: [Strong](#type-strong) object
2027
2480
2028−[`Subscript (content)`]{#Subscript}
2481+[`Subscript (content)`]{#pandoc.subscript}
2029
2482
2030: Creates a Subscript inline element
2483: Creates a Subscript inline element
2031
2484
@@ -2034,9 +2487,9 @@ Lua functions for pandoc scripts.
2034 `content`:
2487 `content`:
2035 : inline content
2488 : inline content
2036
2489
2037− Returns: subscript element
2490+ Returns: [Subscript](#type-subscript) object
2038
2491
2039−[`Superscript (content)`]{#Superscript}
2492+[`Superscript (content)`]{#pandoc.superscript}
2040
2493
2041: Creates a Superscript inline element
2494: Creates a Superscript inline element
2042
2495
@@ -2045,11 +2498,22 @@ Lua functions for pandoc scripts.
2045 `content`:
2498 `content`:
2046 : inline content
2499 : inline content
2047
2500
2048− Returns: strong element
2501+ Returns: [Superscript](#type-superscript) object
2502+
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
2049
2513
2050−## Element components {#element-components-create}
2514+## Element components
2051
2515
2052−[`Attr ([identifier[, classes[, attributes]]])`]{#Attr}
2516+[`Attr ([identifier[, classes[, attributes]]])`]{#pandoc.attr}
2053
2517
2054: Create a new set of attributes (Attr).
2518: Create a new set of attributes (Attr).
2055
2519
@@ -2064,9 +2528,9 @@ Lua functions for pandoc scripts.
2064 `attributes`:
2528 `attributes`:
2065 : table containing string keys and values
2529 : table containing string keys and values
2066
2530
2067− Returns: element attributes
2531+ Returns: [Attr](#type-attr) object
2068
2532
2069−[`Citation (id, mode[, prefix[, suffix[, note_num[, hash]]]])`]{#Citation}
2533+[`Citation (id, mode[, prefix[, suffix[, note_num[, hash]]]])`]{#pandoc.citation}
2070
2534
2071: Creates a single citation.
2535: Creates a single citation.
2072
2536
@@ -2090,7 +2554,9 @@ Lua functions for pandoc scripts.
2090 `hash`:
2554 `hash`:
2091 : hash number
2555 : hash number
2092
2556
2557+ Returns: [Citation](#type-citation) object
2558+
2093−[`ListAttributes ([start[, style[, delimiter]]])`]{#ListAttributes}
2559+[`ListAttributes ([start[, style[, delimiter]]])`]{#pandoc.listattributes}
2094
2560
2095: Creates a set of list attributes.
2561: Creates a set of list attributes.
2096
2562
@@ -2105,134 +2571,193 @@ Lua functions for pandoc scripts.
2105 `delimiter`:
2571 `delimiter`:
2106 : delimiter of list numbers
2572 : delimiter of list numbers
2107
2573
2108− Returns: list attributes table
2574+ Returns: [ListAttributes](#type-listattributes) object
2575+
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+ )
2109
2621
2110## Constants
2622## Constants
2111
2623
2112−[`AuthorInText`]{#AuthorInText}
2624+[`AuthorInText`]{#pandoc.authorintext}
2113
2625
2114: Author name is mentioned in the text.
2626: Author name is mentioned in the text.
2115
2627
2116− See also: [Citation](#Citation)
2628+ See also: [Citation](#type-citation)
2117
2629
2118−[`SuppressAuthor`]{#SuppressAuthor}
2630+[`SuppressAuthor`]{#pandoc.suppressauthor}
2119
2631
2120: Author name is suppressed.
2632: Author name is suppressed.
2121
2633
2122− See also: [Citation](#Citation)
2634+ See also: [Citation](#type-citation)
2123
2635
2124−[`NormalCitation`]{#NormalCitation}
2636+[`NormalCitation`]{#pandoc.normalcitation}
2125
2637
2126: Default citation style is used.
2638: Default citation style is used.
2127
2639
2128− See also: [Citation](#Citation)
2640+ See also: [Citation](#type-citation)
2129
2641
2130−[`AlignLeft`]{#AlignLeft}
2642+[`AlignLeft`]{#pandoc.alignleft}
2131
2643
2132: Table cells aligned left.
2644: Table cells aligned left.
2133
2645
2134− See also: [Table](#Table)
2646+ See also: [Table](#type-alignment)
2135
2647
2136−[`AlignRight`]{#AlignRight}
2648+[`AlignRight`]{#pandoc.alignright}
2137
2649
2138: Table cells right-aligned.
2650: Table cells right-aligned.
2139
2651
2140− See also: [Table](#Table)
2652+ See also: [Table](#type-alignment)
2141
2653
2142−[`AlignCenter`]{#AlignCenter}
2654+[`AlignCenter`]{#pandoc.aligncenter}
2143
2655
2144: Table cell content is centered.
2656: Table cell content is centered.
2145
2657
2146− See also: [Table](#Table)
2658+ See also: [Table](#type-alignment)
2147
2659
2148−[`AlignDefault`]{#AlignDefault}
2660+[`AlignDefault`]{#pandoc.aligndefault}
2149
2661
2150: Table cells are alignment is unaltered.
2662: Table cells are alignment is unaltered.
2151
2663
2152− See also: [Table](#Table)
2664+ See also: [Table](#type-alignment)
2153
2665
2154−[`DefaultDelim`]{#DefaultDelim}
2666+[`DefaultDelim`]{#pandoc.defaultdelim}
2155
2667
2156: Default list number delimiters are used.
2668: Default list number delimiters are used.
2157
2669
2158− See also: [OrderedList](#OrderedList)
2670+ See also: [ListAttributes](#type-listattributes)
2159
2671
2160−[`Period`]{#Period}
2672+[`Period`]{#pandoc.period}
2161
2673
2162: List numbers are delimited by a period.
2674: List numbers are delimited by a period.
2163
2675
2164− See also: [OrderedList](#OrderedList)
2676+ See also: [ListAttributes](#type-listattributes)
2165
2677
2166−[`OneParen`]{#OneParen}
2678+[`OneParen`]{#pandoc.oneparen}
2167
2679
2168: List numbers are delimited by a single parenthesis.
2680: List numbers are delimited by a single parenthesis.
2169
2681
2170− See also: [OrderedList](#OrderedList)
2682+ See also: [ListAttributes](#type-listattributes)
2171
2683
2172−[`TwoParens`]{#TwoParens}
2684+[`TwoParens`]{#pandoc.twoparens}
2173
2685
2174: List numbers are delimited by a double parentheses.
2686: List numbers are delimited by a double parentheses.
2175
2687
2176− See also: [OrderedList](#OrderedList)
2688+ See also: [ListAttributes](#type-listattributes)
2177
2689
2178−[`DefaultStyle`]{#DefaultStyle}
2690+[`DefaultStyle`]{#pandoc.defaultstyle}
2179
2691
2180: List are numbered in the default style
2692: List are numbered in the default style
2181
2693
2182− See also: [OrderedList](#OrderedList)
2694+ See also: [ListAttributes](#type-listattributes)
2183
2695
2184−[`Example`]{#Example}
2696+[`Example`]{#pandoc.example}
2185
2697
2186: List items are numbered as examples.
2698: List items are numbered as examples.
2187
2699
2188− See also: [OrderedList](#OrderedList)
2700+ See also: [ListAttributes](#type-listattributes)
2189
2701
2190−[`Decimal`]{#Decimal}
2702+[`Decimal`]{#pandoc.decimal}
2191
2703
2192: List are numbered using decimal integers.
2704: List are numbered using decimal integers.
2193
2705
2194− See also: [OrderedList](#OrderedList)
2706+ See also: [ListAttributes](#type-listattributes)
2195
2707
2196−[`LowerRoman`]{#LowerRoman}
2708+[`LowerRoman`]{#pandoc.lowerroman}
2197
2709
2198: List are numbered using lower-case roman numerals.
2710: List are numbered using lower-case roman numerals.
2199
2711
2200− See also: [OrderedList](#OrderedList)
2712+ See also: [ListAttributes](#type-listattributes)
2201
2713
2202−[`UpperRoman`]{#UpperRoman}
2714+[`UpperRoman`]{#pandoc.upperroman}
2203
2715
2204: List are numbered using upper-case roman numerals
2716: List are numbered using upper-case roman numerals
2205
2717
2206− See also: [OrderedList](#OrderedList)
2718+ See also: [ListAttributes](#type-listattributes)
2207
2719
2208−[`LowerAlpha`]{#LowerAlpha}
2720+[`LowerAlpha`]{#pandoc.loweralpha}
2209
2721
2210: List are numbered using lower-case alphabetic characters.
2722: List are numbered using lower-case alphabetic characters.
2211
2723
2212− See also: [OrderedList](#OrderedList)
2724+ See also: [ListAttributes](#type-listattributes)
2213
2725
2214−[`UpperAlpha`]{#UpperAlpha}
2726+[`UpperAlpha`]{#pandoc.upperalpha}
2215
2727
2216: List are numbered using upper-case alphabetic characters.
2728: List are numbered using upper-case alphabetic characters.
2217
2729
2218− See also: [OrderedList](#OrderedList)
2730+ See also: [ListAttributes](#type-listattributes)
2219
2731
2220−[`sha1`]{#sha1}
2732+[`sha1`]{#pandoc.sha1}
2221
2733
2222−: Functions which have moved to different modules
2734+: Alias for [`pandoc.utils.sha1`](#pandoc.utils.sha1)
2735+ (DEPRECATED).
2223
2736
2224## Helper functions
2737## Helper functions
2225
2738
2226−### pipe
2739+### pipe {#pandoc.pipe}
2227
2740
2228`pipe (command, args, input)`
2741`pipe (command, args, input)`
2229
2742
2230Runs command with arguments, passing it some input, and returns
2743Runs command with arguments, passing it some input, and returns
2231the output.
2744the output.
2232
2745
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+
2233Returns:
2758Returns:
2234
2759
2235−- Output of command.
2760+- Output of command, i.e. data printed to stdout (string)
2236
2761
2237Raises:
2762Raises:
2238
2763
@@ -2244,7 +2769,7 @@ Usage:
2244
2769
2245 local output = pandoc.pipe("sed", {"-e","s/a/b/"}, "abc")
2770 local output = pandoc.pipe("sed", {"-e","s/a/b/"}, "abc")
2246
2771
2247−### walk\_block
2772+### walk\_block {#pandoc.walk_block}
2248
2773
2249`walk_block (element, filter)`
2774`walk_block (element, filter)`
2250
2775
@@ -2256,12 +2781,12 @@ Parameters:
2256: the block element
2781: the block element
2257
2782
2258`filter`:
2783`filter`:
2259−: a lua filter (table of functions) to be applied within the
2784+: a Lua filter (table of functions) to be applied within the
2260 block element
2785 block element
2261
2786
2262Returns: the transformed block element
2787Returns: the transformed block element
2263
2788
2264−### walk\_inline
2789+### walk\_inline {#pandoc.walk_inline}
2265
2790
2266`walk_inline (element, filter)`
2791`walk_inline (element, filter)`
2267
2792
@@ -2273,12 +2798,12 @@ Parameters:
2273: the inline element
2798: the inline element
2274
2799
2275`filter`:
2800`filter`:
2276−: a lua filter (table of functions) to be applied within the
2801+: a Lua filter (table of functions) to be applied within the
2277 inline element
2802 inline element
2278
2803
2279Returns: the transformed inline element
2804Returns: the transformed inline element
2280
2805
2281−### read
2806+### read {#pandoc.read}
2282
2807
2283`read (markup[, format])`
2808`read (markup[, format])`
2284
2809
@@ -2312,11 +2837,11 @@ The module is loaded as part of the `pandoc` module and
2312available as `pandoc.utils`. In versions up-to and including
2837available as `pandoc.utils`. In versions up-to and including
2313pandoc 2.6, this module had to be loaded explicitly. Example:
2838pandoc 2.6, this module had to be loaded explicitly. Example:
2314
2839
2315− local utils = require 'pandoc.utils'
2840+ pandoc.utils = require 'pandoc.utils'
2316
2841
2317−Use this for backwards compatibility.
2842+Use the above for backwards compatibility.
2318
2843
2319−### blocks\_to\_inlines {#utils-blocks_to_inlines}
2844+### blocks\_to\_inlines {#pandoc.utils.blocks_to_inlines}
2320
2845
2321`blocks_to_inlines (blocks[, sep])`
2846`blocks_to_inlines (blocks[, sep])`
2322
2847
@@ -2325,16 +2850,16 @@ Squash a list of blocks into a list of inlines.
2325Parameters:
2850Parameters:
2326
2851
2327`blocks`:
2852`blocks`:
2328−: List of [Blocks](#Blocks) to be flattened.
2853+: List of [Blocks](#type-block) to be flattened.
2329
2854
2330`sep`:
2855`sep`:
2331−: List of [Inlines](#Inlines) inserted as separator between
2856+: List of [Inlines](#type-inline) inserted as separator between
2332 two consecutive blocks; defaults to
2857 two consecutive blocks; defaults to
2333 `{ pandoc.Space(), pandoc.Str'¶', pandoc.Space()}`.
2858 `{ pandoc.Space(), pandoc.Str'¶', pandoc.Space()}`.
2334
2859
2335Returns:
2860Returns:
2336
2861
2337−- List of [Inlines](#Inlines)
2862+- [List](#type-list) of [Inlines](#type-inline)
2338
2863
2339Usage:
2864Usage:
2340
2865
@@ -2349,7 +2874,7 @@ Usage:
2349 -- pandoc.Emph{ pandoc.Str 'Paragraph2' }
2874 -- pandoc.Emph{ pandoc.Str 'Paragraph2' }
2350 -- }
2875 -- }
2351
2876
2352−### equals {#utils-equals}
2877+### equals {#pandoc.utils.equals}
2353
2878
2354`equals (element1, element2)`
2879`equals (element1, element2)`
2355
2880
@@ -2360,22 +2885,39 @@ equal.
2360Parameters:
2885Parameters:
2361
2886
2362`element1`, `element2`:
2887`element1`, `element2`:
2363−: Objects to be compared. Acceptable input types are
2888+: Objects to be compared. Acceptable input types are [Pandoc],
2364− [Pandoc](#type-ref-pandoc), [Meta](#type-ref-meta),
2365− [MetaValue](#type-ref-MetaValue), [Block](#type-ref-Block),
2889+ [Meta], [MetaValue], [Block], [Inline], [Attr],
2366− [Inline](#type-ref-Inline), [Attr](#type-ref-Attr),
2367− [ListAttributes](#type-ref-ListAttributes), and
2890+ [ListAttributes], and [Citation].
2368− [Citation](#type-ref-Citation).
2369
2891
2370Returns:
2892Returns:
2371
2893
2372- Whether the two objects represent the same element (boolean)
2894- Whether the two objects represent the same element (boolean)
2373
2895
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+
2374−### make\_sections {#utils-make_sections}
2916+### make\_sections {#pandoc.utils.make_sections}
2375
2917
2376`make_sections (number_sections, base_level, blocks)`
2918`make_sections (number_sections, base_level, blocks)`
2377
2919
2378−Converst list of [Blocks](#Blocks) into sections.
2920+Converts list of [Blocks](#type-block) into sections.
2379`Div`s will be created beginning at each `Header`
2921`Div`s will be created beginning at each `Header`
2380and containing following content until the next `Header`
2922and containing following content until the next `Header`
2381of comparable level. If `number_sections` is true,
2923of comparable level. If `number_sections` is true,
@@ -2387,7 +2929,7 @@ is the level specified.
2387
2929
2388Returns:
2930Returns:
2389
2931
2390−- List of [Blocks](#Blocks).
2932+- List of [Blocks](#type-block).
2391
2933
2392Usage:
2934Usage:
2393
2935
@@ -2397,7 +2939,7 @@ Usage:
2397 }
2939 }
2398 local newblocks = pandoc.utils.make_sections(true, 1, blocks)
2940 local newblocks = pandoc.utils.make_sections(true, 1, blocks)
2399
2941
2400−### run\_json\_filter {#utils-run_json_filter}
2942+### run\_json\_filter {#pandoc.utils.run_json_filter}
2401
2943
2402`run_json_filter (doc, filter[, args])`
2944`run_json_filter (doc, filter[, args])`
2403
2945
@@ -2417,7 +2959,7 @@ Parameters:
2417
2959
2418Returns:
2960Returns:
2419
2961
2420−- ([Pandoc](#Pandoc)) Filtered document
2962+- ([Pandoc](#type-pandoc)) Filtered document
2421
2963
2422Usage:
2964Usage:
2423
2965
@@ -2430,7 +2972,7 @@ Usage:
2430 )
2972 )
2431 some_blocks = sub_doc.blocks -- some blocks with bib
2973 some_blocks = sub_doc.blocks -- some blocks with bib
2432
2974
2433−### normalize\_date {#utils-normalize_date}
2975+### normalize\_date {#pandoc.utils.normalize_date}
2434
2976
2435`normalize_date (date_string)`
2977`normalize_date (date_string)`
2436
2978
@@ -2443,7 +2985,7 @@ Returns:
2443
2985
2444- A date string, or nil when the conversion failed.
2986- A date string, or nil when the conversion failed.
2445
2987
2446−### sha1 {#utils-sha1}
2988+### sha1 {#pandoc.utils.sha1}
2447
2989
2448`sha1 (contents)`
2990`sha1 (contents)`
2449
2991
@@ -2457,7 +2999,7 @@ Usage:
2457
2999
2458 local fp = pandoc.utils.sha1("foobar")
3000 local fp = pandoc.utils.sha1("foobar")
2459
3001
2460−### stringify {#utils-stringify}
3002+### stringify {#pandoc.utils.stringify}
2461
3003
2462`stringify (element)`
3004`stringify (element)`
2463
3005
@@ -2474,7 +3016,7 @@ Usage:
2474 -- outputs "Moin"
3016 -- outputs "Moin"
2475 print(pandoc.utils.stringify(inline))
3017 print(pandoc.utils.stringify(inline))
2476
3018
2477−### to\_roman\_numeral {#utils-to_roman_numeral}
3019+### to\_roman\_numeral {#pandoc.utils.to_roman_numeral}
2478
3020
2479`to_roman_numeral (integer)`
3021`to_roman_numeral (integer)`
2480
3022
@@ -2490,6 +3032,24 @@ Usage:
2490 local pandoc_birth_year = to_roman_numeral(2006)
3032 local pandoc_birth_year = to_roman_numeral(2006)
2491 -- pandoc_birth_year == 'MMVI'
3033 -- pandoc_birth_year == 'MMVI'
2492
3034
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+
2493# Module pandoc.mediabag
3053# Module pandoc.mediabag
2494
3054
2495The `pandoc.mediabag` module allows accessing pandoc's media
3055The `pandoc.mediabag` module allows accessing pandoc's media
@@ -2502,7 +3062,7 @@ required, e.g.:
2502
3062
2503 local mb = require 'pandoc.mediabag'
3063 local mb = require 'pandoc.mediabag'
2504
3064
2505−### delete {#mediabag-delete}
3065+### delete {#pandoc.mediabag.delete}
2506
3066
2507`delete (filepath)`
3067`delete (filepath)`
2508
3068
@@ -2514,17 +3074,18 @@ Parameters:
2514: filename of the item to be deleted. The media bag will be
3074: filename of the item to be deleted. The media bag will be
2515 left unchanged if no entry with the given filename exists.
3075 left unchanged if no entry with the given filename exists.
2516
3076
2517−### empty {#mediabag-empty}
3077+### empty {#pandoc.mediabag.empty}
2518
3078
2519`empty ()`
3079`empty ()`
2520
3080
2521Clear-out the media bag, deleting all items.
3081Clear-out the media bag, deleting all items.
2522
3082
2523−### insert {#mediabag-insert}
3083+### insert {#pandoc.mediabag.insert}
2524
3084
2525`insert (filepath, mime_type, contents)`
3085`insert (filepath, mime_type, contents)`
2526
3086
2527−Adds a new entry to pandoc's media bag.
3087+Adds a new entry to pandoc's media bag. Replaces any existing
3088+mediabag entry with the same `filepath`.
2528
3089
2529Parameters:
3090Parameters:
2530
3091
@@ -2532,7 +3093,7 @@ Parameters:
2532: filename and path relative to the output folder.
3093: filename and path relative to the output folder.
2533
3094
2534`mime_type`:
3095`mime_type`:
2535−: the file's MIME type
3096+: the file's MIME type; use `nil` if unknown or unavailable.
2536
3097
2537`contents`:
3098`contents`:
2538: the binary contents of the file.
3099: the binary contents of the file.
@@ -2544,7 +3105,7 @@ Usage:
2544 local contents = "Hello, World!"
3105 local contents = "Hello, World!"
2545 pandoc.mediabag.insert(fp, mt, contents)
3106 pandoc.mediabag.insert(fp, mt, contents)
2546
3107
2547−### items {#mediabag-items}
3108+### items {#pandoc.mediabag.items}
2548
3109
2549`items ()`
3110`items ()`
2550
3111
@@ -2555,7 +3116,7 @@ processed one-by-one to avoid excessive memory use.
2555
3116
2556This function should be used only when full access to all items,
3117This function should be used only when full access to all items,
2557including their contents, is required. For all other cases,
3118including their contents, is required. For all other cases,
2558−[`list`](#mediabag-list) should be preferred.
3119+[`list`](#pandoc.mediabag.list) should be preferred.
2559
3120
2560Returns:
3121Returns:
2561
3122
@@ -2571,7 +3132,7 @@ Usage:
2571 -- print(fp, mt, contents)
3132 -- print(fp, mt, contents)
2572 end
3133 end
2573
3134
2574−### list {#mediabag-list}
3135+### list {#pandoc.mediabag.list}
2575
3136
2576`list ()`
3137`list ()`
2577
3138
@@ -2592,7 +3153,7 @@ Usage:
2592 end
3153 end
2593 print(sum)
3154 print(sum)
2594
3155
2595−### lookup {#mediabag-lookup}
3156+### lookup {#pandoc.mediabag.lookup}
2596
3157
2597`lookup (filepath)`
3158`lookup (filepath)`
2598
3159
@@ -2614,14 +3175,24 @@ Usage:
2614 local filename = "media/diagram.png"
3175 local filename = "media/diagram.png"
2615 local mt, contents = pandoc.mediabag.lookup(filename)
3176 local mt, contents = pandoc.mediabag.lookup(filename)
2616
3177
2617−### fetch {#mediabag-fetch}
3178+### fetch {#pandoc.mediabag.fetch}
2618
3179
2619−`fetch (source, base_url)`
3180+`fetch (source)`
2620
3181
2621Fetches the given source from a URL or local file. Returns two
3182Fetches the given source from a URL or local file. Returns two
2622values: the contents of the file and the MIME type (or an empty
3183values: the contents of the file and the MIME type (or an empty
2623string).
3184string).
2624
3185
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+
2625Returns:
3196Returns:
2626
3197
2627- the entries MIME type, or nil if the file was not found.
3198- the entries MIME type, or nil if the file was not found.
@@ -2630,15 +3201,24 @@ Returns:
2630Usage:
3201Usage:
2631
3202
2632 local diagram_url = "https://pandoc.org/diagram.jpg"
3203 local diagram_url = "https://pandoc.org/diagram.jpg"
2633− local mt, contents = pandoc.mediabag.fetch(diagram_url, ".")
3204+ local mt, contents = pandoc.mediabag.fetch(diagram_url)
2634
3205
2635# Module pandoc.List
3206# Module pandoc.List
2636
3207
2637−Pandoc\'s List type and helper methods
3208+This module defines pandoc's list type. It comes with useful
3209+methods and convenience functions.
3210+
3211+## Constructor
3212+
3213+[`pandoc.List([table])`]{#pandoc.list}
3214+
3215+: Create a new List. If the optional argument `table` is given,
3216+ set the metatable of that value to `pandoc.List`. This is an
3217+ alias for [`pandoc.List:new([table])`](#pandoc.list:new).
2638
3218
2639## Metamethods
3219## Metamethods
2640
3220
2641−[`pandoc.List:__concat (list)`]{#pandoc.List:__concat}
3221+[`pandoc.List:__concat (list)`]{#pandoc.list:__concat}
2642
3222
2643: Concatenates two lists.
3223: Concatenates two lists.
2644
3224
@@ -2652,26 +3232,20 @@ Pandoc\'s List type and helper methods
2652
3232
2653## Methods
3233## Methods
2654
3234
2655−[`pandoc.List:clone ()`]{#pandoc.List:clone}
3235+[`pandoc.List:clone ()`]{#pandoc.list:clone}
2656
3236
2657: Returns a (shallow) copy of the list.
3237: Returns a (shallow) copy of the list.
2658
3238
2659−[`pandoc.List:includes (needle, init)`]{#pandoc.List:includes}
3239+[`pandoc.List:extend (list)`]{#pandoc.list:extend}
2660
3240
2661−: Checks if the list has an item equal to the given needle.
3241+: Adds the given list to the end of this list.
2662
3242
2663 Parameters:
3243 Parameters:
2664
3244
2665− `needle`:
3245+ `list`:
2666− : item to search for
3246+ : list to appended
2667−
2668− `init`:
2669− : index at which the search is started
2670−
2671− Returns: true if a list item is equal to the needle, false
2672− otherwise
2673
3247
2674−[`pandoc.List:find (needle, init)`]{#pandoc.List:find}
3248+[`pandoc.List:find (needle, init)`]{#pandoc.list:find}
2675
3249
2676: Returns the value and index of the first occurrence of the
3250: Returns the value and index of the first occurrence of the
2677 given item.
3251 given item.
@@ -2687,7 +3261,7 @@ Pandoc\'s List type and helper methods
2687 Returns: first item equal to the needle, or nil if no such
3261 Returns: first item equal to the needle, or nil if no such
2688 item exists.
3262 item exists.
2689
3263
2690−[`pandoc.List:find_if (pred, init)`]{#pandoc.List:find_if}
3264+[`pandoc.List:find_if (pred, init)`]{#pandoc.list:find_if}
2691
3265
2692: Returns the value and index of the first element for which
3266: Returns the value and index of the first element for which
2693 the predicate holds true.
3267 the predicate holds true.
@@ -2703,16 +3277,51 @@ Pandoc\'s List type and helper methods
2703 Returns: first item for which \`test\` succeeds, or nil if
3277 Returns: first item for which \`test\` succeeds, or nil if
2704 no such item exists.
3278 no such item exists.
2705
3279
2706−[`pandoc.List:extend (list)`]{#pandoc.List:extend}
3280+[`pandoc.List:filter (pred)`]{#pandoc.list:filter}
2707
3281
2708−: Adds the given list to the end of this list.
3282+: Returns a new list containing all items satisfying a given
3283+ condition.
2709
3284
2710 Parameters:
3285 Parameters:
2711
3286
2712− `list`:
3287+ `pred`:
2713− : list to appended
3288+ : condition items must satisfy.
3289+
3290+ Returns: a new list containing all items for which \`test\`
3291+ was true.
3292+
3293+[`pandoc.List:includes (needle, init)`]{#pandoc.list:includes}
3294+
3295+: Checks if the list has an item equal to the given needle.
3296+
3297+ Parameters:
3298+
3299+ `needle`:
3300+ : item to search for
3301+
3302+ `init`:
3303+ : index at which the search is started
3304+
3305+ Returns: true if a list item is equal to the needle, false
3306+ otherwise
3307+
3308+[`pandoc.List:insert ([pos], value)`]{#pandoc.list:insert}
3309+
3310+: Inserts element `value` at position `pos` in list, shifting
3311+ elements to the next-greater index if necessary.
3312+
3313+ This function is identical to
3314+ [`table.insert`](https://www.lua.org/manual/5.3/manual.html#6.6).
3315+
3316+ Parameters:
2714
3317
3318+ `pos`:
3319+ : index of the new value; defaults to length of the list + 1
3320+
3321+ `value`:
3322+ : value to insert into the list
3323+
2715−[`pandoc.List:map (fn)`]{#pandoc.List:map}
3324+[`pandoc.List:map (fn)`]{#pandoc.list:map}
2716
3325
2717: Returns a copy of the current list by applying the given
3326: Returns a copy of the current list by applying the given
2718 function to all elements.
3327 function to all elements.
@@ -2722,36 +3331,254 @@ Pandoc\'s List type and helper methods
2722 `fn`:
3331 `fn`:
2723 : function which is applied to all list items.
3332 : function which is applied to all list items.
2724
3333
2725−[`pandoc.List:filter (pred)`]{#pandoc.List:filter}
3334+[`pandoc.List:new([table])`]{#pandoc.list:new}
2726
3335
2727−: Returns a new list containing all items satisfying a given
3336+: Create a new List. If the optional argument `table` is given,
2728− condition.
3337+ set the metatable of that value to `pandoc.List`.
2729
3338
2730 Parameters:
3339 Parameters:
2731
3340
2732− `pred`:
3341+ `table`:
2733− : condition items must satisfy.
3342+ : table which should be treatable as a list; defaults to an
3343+ empty table
2734
3344
2735− Returns: a new list containing all items for which \`test\`
3345+ Returns: the updated input value
2736− was true.
3346+
3347+[`pandoc.List:remove ([pos])`]{#pandoc.list:remove}
3348+
3349+: Removes the element at position `pos`, returning the value
3350+ of the removed element.
3351+
3352+ This function is identical to
3353+ [`table.remove`](https://www.lua.org/manual/5.3/manual.html#6.6).
3354+
3355+ Parameters:
3356+
3357+ `pos`:
3358+ : position of the list value that will be removed; defaults
3359+ to the index of the last element
3360+
3361+ Returns: the removed element
3362+
3363+[`pandoc.List:sort ([comp])`]{#pandoc.list:sort}
3364+
3365+: Sorts list elements in a given order, in-place. If `comp` is
3366+ given, then it must be a function that receives two list
3367+ elements and returns true when the first element must come
3368+ before the second in the final order (so that, after the
3369+ sort, `i < j` implies `not comp(list[j],list[i]))`. If comp
3370+ is not given, then the standard Lua operator `<` is used
3371+ instead.
3372+
3373+ Note that the comp function must define a strict partial
3374+ order over the elements in the list; that is, it must be
3375+ asymmetric and transitive. Otherwise, no valid sort may be
3376+ possible.
3377+
3378+ The sort algorithm is not stable: elements considered equal
3379+ by the given order may have their relative positions changed
3380+ by the sort.
3381+
3382+ This function is identical to
3383+ [`table.sort`](https://www.lua.org/manual/5.3/manual.html#6.6).
3384+
3385+ Parameters:
3386+
3387+ `comp`:
3388+ : Comparison function as described above.
3389+
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)
2737
3564
2738# Module pandoc.system
3565# Module pandoc.system
2739
3566
2740Access to system information and functionality.
3567Access to system information and functionality.
2741
3568
2742−## Static Fields {#system-fields}
3569+## Static Fields
2743
3570
2744−### arch {#system-arch}
3571+### arch {#pandoc.system.arch}
2745
3572
2746The machine architecture on which the program is running.
3573The machine architecture on which the program is running.
2747
3574
2748−### os {#system-os}
3575+### os {#pandoc.system.os}
2749
3576
2750The operating system on which the program is running.
3577The operating system on which the program is running.
2751
3578
2752−## Functions {#system-functions}
3579+## Functions
2753
3580
2754−### environment {#system-environment}
3581+### environment {#pandoc.system.environment}
2755
3582
2756`environment ()`
3583`environment ()`
2757
3584
@@ -2762,7 +3589,7 @@ Returns:
2762- A table mapping environment variables names to their string
3589- A table mapping environment variables names to their string
2763 value (table).
3590 value (table).
2764
3591
2765−### get\_working\_directory {#system-get_working_directory}
3592+### get\_working\_directory {#pandoc.system.get_working_directory}
2766
3593
2767`get_working_directory ()`
3594`get_working_directory ()`
2768
3595
@@ -2772,7 +3599,7 @@ Returns:
2772
3599
2773- The current working directory (string).
3600- The current working directory (string).
2774
3601
2775−### with\_environment {#system-with_environment}
3602+### with\_environment {#pandoc.system.with_environment}
2776
3603
2777`with_environment (environment, callback)`
3604`with_environment (environment, callback)`
2778
3605
@@ -2796,7 +3623,7 @@ Returns:
2796
3623
2797- The result(s) of the call to `callback`
3624- The result(s) of the call to `callback`
2798
3625
2799−### with\_temporary\_directory {#system-with_temporary_directory}
3626+### with\_temporary\_directory {#pandoc.system.with_temporary_directory}
2800
3627
2801`with_temporary_directory ([parent_dir,] templ, callback)`
3628`with_temporary_directory ([parent_dir,] templ, callback)`
2802
3629
@@ -2821,7 +3648,7 @@ Returns:
2821
3648
2822- The result of the call to `callback`.
3649- The result of the call to `callback`.
2823
3650
2824−### with\_working\_directory {#system-with_working_directory}
3651+### with\_working\_directory {#pandoc.system.with_working_directory}
2825
3652
2826`with_working_directory (directory, callback)`
3653`with_working_directory (directory, callback)`
2827
3654
@@ -2847,7 +3674,7 @@ Returns:
2847
3674
2848Constructors for types which are not part of the pandoc AST.
3675Constructors for types which are not part of the pandoc AST.
2849
3676
2850−### Version {#pandoc.types.Version}
3677+### Version {#pandoc.types.version}
2851
3678
2852`Version (version_specifier)`
3679`Version (version_specifier)`
2853
3680
@@ -2855,11 +3682,11 @@ Creates a Version object.
2855
3682
2856Parameters:
3683Parameters:
2857
3684
2858−`version`:
3685+`version_specifier`:
2859: Version specifier: this can be a version string like
3686: Version specifier: this can be a version string like
2860 `'2.7.3'`, a list of integers like `{2, 7, 3}`, a single
3687 `'2.7.3'`, a list of integers like `{2, 7, 3}`, a single
2861− integer, or a [Version](#type-ref-Version).
3688+ integer, or a [Version].
2862
3689
2863Returns:
3690Returns:
2864
3691
2865−- A new [Version](#type-ref-Version) object.
3692+- A new [Version] object.
doc/org.md+193−8
@@ -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 metadata entry, but
17+- CREATOR: output generator; passed as plain-text metadata entry
18− ignored by most output formats.
18+ `creator`, but not used by any default templates.
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 metadata entry, but not
22+- EMAIL: author email address; passed as plain-text metadata
23− included in most output formats.
23+ field `email`, but not used by any default templates.
24
24
25−- LANGUAGE: currently unsupported; use `#+LANG:` instead.
25+- LANGUAGE: document language; included as plain-text metadata
26+ field `lang`. The value should be a [BCP47 language tag].
26
27
27−- SELECT_TAGS: tags which select a tree for export. Currently
28+- SELECT_TAGS: tags which select a tree for export.
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,6 +36,136 @@ 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+```
39
169
40Citations
170Citations
41=========
171=========
@@ -93,7 +223,7 @@ Example:
93
223
94### Parenthetical citation
224### Parenthetical citation
95
225
96−Citations surrounded by parantheses. The syntax is identical to
226+Citations surrounded by parentheses. The syntax is identical to
97in-text citations, except for the additional parentheses enclosing
227in-text citations, except for the additional parentheses enclosing
98the initial `cite` tag.
228the initial `cite` tag.
99
229
@@ -151,6 +281,34 @@ Use normal latex citation commands like `\cite{x}` or
151[org-ref]: https://github.com/jkitchin/org-ref
281[org-ref]: https://github.com/jkitchin/org-ref
152[John Kitchen]: https://kitchingroup.cheme.cmu.edu/
282[John Kitchen]: https://kitchingroup.cheme.cmu.edu/
153
283
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
154
312
155Emphasis rules
313Emphasis rules
156==============
314==============
@@ -182,6 +340,33 @@ be parsed using default emphasis rules:
182 #+pandoc-emphasis-pre:
340 #+pandoc-emphasis-pre:
183 #+pandoc-emphasis-post:
341 #+pandoc-emphasis-post:
184
342
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
185
370
186Currently unsupported features
371Currently unsupported features
187==============================
372==============================
doc/using-the-pandoc-api.md+30−16
@@ -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 input formats.
17+*writers*, which render this AST into various output formats.
18Pictorially:
18Pictorially:
19
19
20```
20```
@@ -90,8 +90,14 @@ 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 => ReaderOptions -> Text -> m Pandoc
93+readMarkdown :: (PandocMonad m, ToSources a)
94+ => ReaderOptions
95+ -> a
96+ -> m Pandoc
94−writeRST :: PandocMonad m => WriterOptions -> Pandoc -> m Text
97+writeRST :: PandocMonad m
98+ => WriterOptions
99+ -> Pandoc
100+ -> m Text
95```
101```
96
102
97The `PandocMonad m =>` part is a typeclass constraint.
103The `PandocMonad m =>` part is a typeclass constraint.
@@ -120,7 +126,7 @@ getVerbosity :: PandocMonad m => m Verbosity
120-- | Set the verbosity level.
126-- | Set the verbosity level.
121setVerbosity :: PandocMonad m => Verbosity -> m ()
127setVerbosity :: PandocMonad m => Verbosity -> m ()
122
128
123−-- Get the accomulated log messages (in temporal order).
129+-- Get the accumulated log messages (in temporal order).
124getLog :: PandocMonad m => m [LogMessage]
130getLog :: PandocMonad m => m [LogMessage]
125getLog = reverse <$> getsCommonState stLog
131getLog = reverse <$> getsCommonState stLog
126
132
@@ -133,7 +139,7 @@ report :: PandocMonad m => LogMessage -> m ()
133-- | Fetch an image or other item from the local filesystem or the net.
139-- | Fetch an image or other item from the local filesystem or the net.
134-- Returns raw content and maybe mime type.
140-- Returns raw content and maybe mime type.
135fetchItem :: PandocMonad m
141fetchItem :: PandocMonad m
136− => String
142+ => Text
137 -> m (B.ByteString, Maybe MimeType)
143 -> m (B.ByteString, Maybe MimeType)
138
144
139-- Set the resource path searched by 'fetchItem'.
145-- Set the resource path searched by 'fetchItem'.
@@ -155,6 +161,13 @@ Note that `PandocIO` is an instance of `MonadIO`, so you can
155use `liftIO` to perform arbitrary IO operations inside a pandoc
161use `liftIO` to perform arbitrary IO operations inside a pandoc
156conversion chain.
162conversion chain.
157
163
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+
158# Options
171# Options
159
172
160The first argument of each reader or writer is for
173The first argument of each reader or writer is for
@@ -177,7 +190,8 @@ Some particularly important options to know about:
1771. `writerTemplate`: By default, this is `Nothing`, which
1901. `writerTemplate`: By default, this is `Nothing`, which
178 means that a document fragment will be produced. If you
191 means that a document fragment will be produced. If you
179 want a full document, you need to specify `Just template`,
192 want a full document, you need to specify `Just template`,
193+ where `template` is a `Template Text` from
180− where `template` is a String containing the template's
194+ [Text.Pandoc.Templates] containing the template's
181 contents (not the path).
195 contents (not the path).
182
196
1832. `readerExtensions` and `writerExtensions`: These specify
1972. `readerExtensions` and `writerExtensions`: These specify
@@ -199,8 +213,8 @@ of the Monoid typeclass and can easily be concatenated:
199import Text.Pandoc.Builder
213import Text.Pandoc.Builder
200
214
201mydoc :: Pandoc
215mydoc :: Pandoc
202−mydoc = doc $ header 1 (text "Hello!")
216+mydoc = doc $ header 1 (text (T.pack "Hello!"))
203− <> para (emph (text "hello world") <> text ".")
217+ <> para (emph (text (T.pack "hello world")) <> text (T.pack "."))
204
218
205main :: IO ()
219main :: IO ()
206main = print mydoc
220main = print mydoc
@@ -247,16 +261,16 @@ import qualified Data.Text as T
247import Data.List (intersperse)
261import Data.List (intersperse)
248
262
249data Station = Station{
263data Station = Station{
250− address :: String
264+ address :: T.Text
251− , name :: String
265+ , name :: T.Text
252− , cardsAccepted :: [String]
266+ , cardsAccepted :: [T.Text]
253 } deriving Show
267 } deriving Show
254
268
255instance FromJSON Station where
269instance FromJSON Station where
256 parseJSON (Object v) = Station <$>
270 parseJSON (Object v) = Station <$>
257 v .: "street_address" <*>
271 v .: "street_address" <*>
258 v .: "station_name" <*>
272 v .: "station_name" <*>
259− (words <$> (v .:? "cards_accepted" .!= ""))
273+ (T.words <$> (v .:? "cards_accepted" .!= ""))
260 parseJSON _ = mzero
274 parseJSON _ = mzero
261
275
262createLetter :: [Station] -> Pandoc
276createLetter :: [Station] -> Pandoc
@@ -314,7 +328,7 @@ users to override the system defaults. If you want to disable
314this behavior, use `setUserDataDir Nothing`.
328this behavior, use `setUserDataDir Nothing`.
315
329
316To render a template, use `renderTemplate'`, which takes two
330To render a template, use `renderTemplate'`, which takes two
317−arguments, a template (String) and a context (any instance
331+arguments, a template (Text) and a context (any instance
318of ToJSON). If you want to create a context from the metadata
332of ToJSON). If you want to create a context from the metadata
319part of a Pandoc document, use `metaToJSON'` from
333part of a Pandoc document, use `metaToJSON'` from
320[Text.Pandoc.Writers.Shared]. If you also want to incorporate
334[Text.Pandoc.Writers.Shared]. If you also want to incorporate
@@ -336,7 +350,7 @@ use `throwError`.
336In addition to errors, which stop execution of the conversion
350In addition to errors, which stop execution of the conversion
337pipeline, one can generate informational messages.
351pipeline, one can generate informational messages.
338Use `report` from [Text.Pandoc.Class] to issue a `LogMessage`.
352Use `report` from [Text.Pandoc.Class] to issue a `LogMessage`.
339−For a list of cosntructors for `LogMessage`, see
353+For a list of constructors for `LogMessage`, see
340[Text.Pandoc.Logging]. Note that each type of log message
354[Text.Pandoc.Logging]. Note that each type of log message
341is associated with a verbosity level. The verbosity level
355is associated with a verbosity level. The verbosity level
342(`setVerbosity`/`getVerbosity`) determines whether the report
356(`setVerbosity`/`getVerbosity`) determines whether the report
@@ -412,7 +426,7 @@ concatenated together. Here's an example that returns a
412list of the URLs linked to in a document:
426list of the URLs linked to in a document:
413
427
414```haskell
428```haskell
415−listURLs :: Pandoc -> [String]
429+listURLs :: Pandoc -> [Text]
416listURLs = query urls
430listURLs = query urls
417 where urls (Link _ _ (src, _)) = [src]
431 where urls (Link _ _ (src, _)) = [src]
418 urls _ = []
432 urls _ = []
@@ -431,7 +445,7 @@ structure and calling this function.
4311. Pandoc's parsers can exhibit pathological behavior on some
4451. Pandoc's parsers can exhibit pathological behavior on some
432 inputs. So it is always a good idea to wrap uses of pandoc
446 inputs. So it is always a good idea to wrap uses of pandoc
433 in a timeout function (e.g. `System.Timeout.timeout` from `base`)
447 in a timeout function (e.g. `System.Timeout.timeout` from `base`)
434− to prevent DOS attacks.
448+ to prevent DoS attacks.
435
449
4362. If pandoc generates HTML from untrusted user input, it is
4502. If pandoc generates HTML from untrusted user input, it is
437 always a good idea to filter the generated HTML through
451 always a good idea to filter the generated HTML through
linux/Dockerfiledeleted−23
@@ -1,23 +0,0 @@
1−# USE ALPINE LINUX
2−FROM alpine:3.10
3−RUN apk update
4−RUN apk add alpine-sdk git ca-certificates ghc gmp-dev zlib-dev bash dpkg fakeroot cabal
5−RUN mkdir -p /usr/src/
6−WORKDIR /usr/src/
7−RUN git clone https://github.com/jgm/pandoc
8−WORKDIR /usr/src/pandoc
9−RUN cabal update && \
10− cabal install cabal-install-2.4.0.0 && \
11− cp $HOME/.cabal/bin/cabal /usr/bin/
12−CMD cabal --version && \
13− ghc --version && \
14− git pull && \
15− git checkout -b work $TREE && \
16− cabal new-update && \
17− cabal new-clean && \
18− 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 && \
19− cabal new-build . pandoc-citeproc && \
20− cabal new-test -j1 . pandoc-citeproc && \
21− for f in $(find dist-newstyle -name 'pandoc*' -type f -perm +400); do cp $f /artifacts/; done && \
22− bash linux/make_deb.sh && \
23− bash linux/make_tarball.sh
linux/Makefiledeleted−18
@@ -1,18 +0,0 @@
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, pandoc-citeproc
8+Replaces: pandoc-data
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.shnew file+84
@@ -0,0 +1,84 @@
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.shdeleted−51
@@ -1,51 +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−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.shdeleted−19
@@ -1,19 +0,0 @@
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/Makefilenew file+35
@@ -0,0 +1,35 @@
1+VERSION=$(shell cat version.txt)
2+BASE=pandoc-$(VERSION)
3+DEST=pandoc/usr/local
4+ALL=$(BASE)-macOS.pkg $(BASE)-macOS.zip
5+
6+all: $(ALL) notarize
7+
8+signed.txt: $(DEST)
9+ chmod +x $(DEST)/bin/pandoc
10+ codesign --force --options runtime -s "5U2WKE6DES" $(DEST)/bin/pandoc
11+ echo "SIGNED" > signed.txt
12+
13+pandoc.pkg: signed.txt
14+ pkgbuild --root pandoc --identifier net.johnmacfarlane.pandoc --version $(VERSION) --ownership recommended $@
15+
16+$(BASE)-macOS.pkg: pandoc.pkg
17+ productbuild --distribution distribution.xml --resources Resources --package-path $< --version $(VERSION) --sign 'Developer ID Installer: John Macfarlane' $@
18+
19+$(BASE)-macOS.zip: signed.txt
20+ ln -s $(DEST) $(BASE)
21+ zip -r $@ $(BASE)
22+
23+gon.hcl: version.txt
24+ echo "notarize {\n path = \"$(BASE)-macOS.pkg\"\n bundle_id = \"org.pandoc.pandoc\"\n staple = true\n}\napple_id {\n username = \"jgm@berkeley.edu\"\n password = \"@env:AC_PASSWORD\"\n}" > $@
25+
26+notarize: gon.hcl $(BASE)-macOS.pkg
27+ gon -log-level=warn ./gon.hcl
28+
29+clean:
30+ rm signed.txt $(BASE) pandoc.pkg gon.hcl
31+
32+distclean: clean
33+ rm $(ALL)
34+
35+.PHONY: all clean distclean
macos/make_macos_package.shdeleted−86
@@ -1,86 +0,0 @@
1−#!/bin/bash -e
2−
3−LOCALBIN=$HOME/.local/bin
4−BASEDIR=`pwd`
5−DIST=`pwd`/macos_package
6−MACOS=`pwd`/macos
7−RESOURCES=$DIST/Resources
8−ROOT=$DIST/pandoc
9−DEST=$ROOT/usr/local
10−PANDOC=$DEST/bin/pandoc
11−SCRIPTS=$MACOS/macos-resources
12−ME=$(whoami)
13−PACKAGEMAKER=/Applications/PackageMaker.app/Contents/MacOS/PackageMaker
14−DEVELOPER_ID_APPLICATION=${DEVELOPER_ID_APPLICATION:-Developer ID Application: John Macfarlane}
15−DEVELOPER_ID_INSTALLER=${DEVELOPER_ID_INSTALLER:-Developer ID Installer: John Macfarlane}
16−
17−export MACMACOS_DEPLOYMENT_TARGET=10.7
18−
19−# echo Removing old files...
20−rm -rf $DIST
21−mkdir -p $DIST
22−mkdir -p $RESOURCES
23−mkdir -p $DEST/bin
24−mkdir -p $DEST/share/man/man1
25−
26−stack setup
27−
28−echo Building pandoc...
29−stack clean
30−stack install --ghc-options="-O2" --local-bin-path $DEST/bin/ pandoc pandoc-citeproc
31−
32−strip $DEST/bin/pandoc
33−strip $DEST/bin/pandoc-citeproc
34−
35−echo Getting man pages...
36−make man/pandoc.1
37−
38−# get pandoc-citeproc man page:
39−PANDOC_CITEPROC_VERSION=`$DEST/bin/pandoc-citeproc --version | awk '{print $2;exit;}'`
40−PANDOC_CITEPROC_TARBALL=https://hackage.haskell.org/package/pandoc-citeproc-${PANDOC_CITEPROC_VERSION}/pandoc-citeproc-${PANDOC_CITEPROC_VERSION}.tar.gz
41−curl ${PANDOC_CITEPROC_TARBALL} | tar xzC $DIST
42−PANDOC_CITEPROC_PATH=$DIST/pandoc-citeproc-${PANDOC_CITEPROC_VERSION}
43−
44−cp $PANDOC_CITEPROC_PATH/man/man1/pandoc-citeproc.1 $DEST/share/man/man1/
45−cp man/pandoc.1 $DEST/share/man/man1/
46−
47−chown -R $ME:staff $DIST
48−
49−echo Copying license...
50−$PANDOC --data data -t html5 -s COPYING.md -Vpagetitle="License" -o $RESOURCES/license.html
51−
52−# Removing executable signing because of a problem that arose in El Capitan
53−# "source=obsolete resource envelope"
54−
55−#echo Signing pandoc executable...
56−
57−#codesign --force --sign "${DEVELOPER_ID_APPLICATION}" $DEST/bin/pandoc
58−# make sure it's valid... returns nonzero exit code if it isn't:
59−#spctl --assess --type execute $DEST/bin/pandoc
60−
61−echo Creating macOS package...
62−
63−VERSION=`$DEST/bin/pandoc --version | awk '{print $2;exit;}'`
64−BASE=pandoc-$VERSION
65−
66−sed -e "s/PANDOCVERSION/$VERSION/" $MACOS/distribution.xml.in > $MACOS/distribution.xml
67−
68−pkgbuild --root $ROOT --identifier net.johnmacfarlane.pandoc --version $VERSION --ownership recommended $DIST/pandoc.pkg
69−productbuild --distribution $MACOS/distribution.xml --resources $DIST/Resources --package-path $DIST --version $VERSION --sign "${DEVELOPER_ID_INSTALLER}" $BASE-macOS.pkg
70−
71−# verify signature
72−spctl --assess --type install $BASE-macOS.pkg
73−
74−echo "Created $BASE-macOS.pkg"
75−
76−# create zip
77−cd $DEST
78−cd ..
79−mv local $BASE
80−zip -r $BASEDIR/$BASE-macOS.zip $BASE
81−cd $BASEDIR
82−
83−echo "Created $BASE-macOS.zip"
84−
85−# cleanup
86−rm -r $DIST
man/pandoc.1+1343−712

This diff is too big to show here.

man/pandoc.1.after+1−1

This diff is too big to show here.

pandoc.cabal+247−244

This diff is too big to show here.

prelude/Prelude.hs−2

This diff is too big to show here.

release.nixnew file+4

This diff is too big to show here.

shell.nixnew file+106

This diff is too big to show here.

src/Text/Pandoc.hs+1−1

This diff is too big to show here.

src/Text/Pandoc/App.hs+113−87

This diff is too big to show here.

src/Text/Pandoc/App/CommandLineOptions.hs+121−104

This diff is too big to show here.

src/Text/Pandoc/App/FormatHeuristics.hs+21−10

This diff is too big to show here.

src/Text/Pandoc/App/Opt.hs+298−28

This diff is too big to show here.

src/Text/Pandoc/App/OutputSettings.hs+15−21

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/BCP47.hsdeleted−110

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/CSV.hs+11−16

This diff is too big to show here.

src/Text/Pandoc/Citeproc.hsnew file+661

This diff is too big to show here.

src/Text/Pandoc/Citeproc/BibTeX.hsnew file+1476

This diff is too big to show here.

src/Text/Pandoc/Citeproc/CslJson.hsnew file+37

This diff is too big to show here.

src/Text/Pandoc/Citeproc/Data.hsnew file+32

This diff is too big to show here.

src/Text/Pandoc/Citeproc/Locator.hsnew file+295

This diff is too big to show here.

src/Text/Pandoc/Citeproc/MetaValue.hsnew file+255

This diff is too big to show here.

src/Text/Pandoc/Citeproc/Util.hsnew file+70

This diff is too big to show here.

src/Text/Pandoc/Class.hs+14−1055

This diff is too big to show here.

src/Text/Pandoc/Class/CommonState.hsnew file+83

This diff is too big to show here.

src/Text/Pandoc/Class/IO.hsnew file+231

This diff is too big to show here.

src/Text/Pandoc/Class/PandocIO.hsnew file+74

This diff is too big to show here.

src/Text/Pandoc/Class/PandocMonad.hsnew file+711

This diff is too big to show here.

src/Text/Pandoc/Class/PandocPure.hsnew file+218

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Emoji.hs−3

This diff is too big to show here.

src/Text/Pandoc/Error.hs+112−54

This diff is too big to show here.

src/Text/Pandoc/Extensions.hs+108−20

This diff is too big to show here.

src/Text/Pandoc/Filter.hs+37−13

This diff is too big to show here.

src/Text/Pandoc/Filter/JSON.hs+4−6

This diff is too big to show here.

src/Text/Pandoc/Filter/Lua.hs+9−10

This diff is too big to show here.

src/Text/Pandoc/Filter/Path.hs+2−4

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Image.hsnew file+37

This diff is too big to show here.

src/Text/Pandoc/ImageSize.hs+62−346

This diff is too big to show here.

src/Text/Pandoc/Logging.hs+100−60

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Lua/ErrorConversion.hsnew file+61

This diff is too big to show here.

src/Text/Pandoc/Lua/Filter.hs+86−40

This diff is too big to show here.

src/Text/Pandoc/Lua/Global.hs+2−4

This diff is too big to show here.

src/Text/Pandoc/Lua/Init.hs+41−69

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/AST.hs+169−75

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/List.hsnew file+43

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/PandocError.hsnew file+65

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/ReaderOptions.hs+6−7

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/SimpleTable.hsnew file+59

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/MediaBag.hs+47−71

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/Utils.hs+73−41

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Lua/PandocLua.hsnew file+141

This diff is too big to show here.

src/Text/Pandoc/Lua/Util.hs+12−22

This diff is too big to show here.

src/Text/Pandoc/Lua/Walk.hs+50−4

This diff is too big to show here.

src/Text/Pandoc/MIME.hs+29−7

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/PDF.hs+91−75

This diff is too big to show here.

src/Text/Pandoc/Parsing.hs+443−287

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers.hs+63−46

This diff is too big to show here.

src/Text/Pandoc/Readers/BibTeX.hsnew file+77

This diff is too big to show here.

src/Text/Pandoc/Readers/CSV.hsnew file+48

This diff is too big to show here.

src/Text/Pandoc/Readers/CommonMark.hs+92−187

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/CslJson.hsnew file+54

This diff is too big to show here.

src/Text/Pandoc/Readers/DocBook.hs+343−187

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx.hs+187−187

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Combine.hs+45−71

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Fields.hs+4−6

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Lists.hs+1−3

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Parse.hs+223−135

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Parse/Styles.hs+45−34

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Util.hs+29−29

This diff is too big to show here.

src/Text/Pandoc/Readers/DokuWiki.hs+21−16

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/FB2.hs+59−54

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML.hs+294−562

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/Parsing.hsnew file+225

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/Table.hsnew file+283

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/TagCategories.hsnew file+78

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/Types.hsnew file+97

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/Ipynb.hs+29−25

This diff is too big to show here.

src/Text/Pandoc/Readers/JATS.hs+105−105

This diff is too big to show here.

src/Text/Pandoc/Readers/Jira.hs+61−31

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX.hs+335−1498

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Citation.hsnew file+210

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Inline.hsnew file+397

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Macro.hsnew file+184

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Math.hsnew file+221

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Parsing.hs+374−63

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/SIunitx.hsnew file+434

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Table.hsnew file+378

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/Man.hs+65−42

This diff is too big to show here.

src/Text/Pandoc/Readers/Markdown.hs+447−298

This diff is too big to show here.

src/Text/Pandoc/Readers/MediaWiki.hs+38−26

This diff is too big to show here.

src/Text/Pandoc/Readers/Metadata.hs+142−82

This diff is too big to show here.

src/Text/Pandoc/Readers/Muse.hs+29−19

This diff is too big to show here.

src/Text/Pandoc/Readers/Native.hs+9−9

This diff is too big to show here.

src/Text/Pandoc/Readers/OPML.hs+23−39

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt.hs+30−29

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/ContentReader.hs+29−24

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/Fallible.hs−2

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/SetMap.hs−2

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/StyleReader.hs+22−20

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Blocks.hs+132−75

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/DocumentTree.hs+2−4

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/ExportSettings.hs+35−13

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Inlines.hs+59−44

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Meta.hs+138−115

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Readers/RST.hs+173−158

This diff is too big to show here.

src/Text/Pandoc/Readers/Roff.hs+20−23

This diff is too big to show here.

src/Text/Pandoc/Readers/TWiki.hs+26−44

This diff is too big to show here.

src/Text/Pandoc/Readers/Textile.hs+114−108

This diff is too big to show here.

src/Text/Pandoc/Readers/TikiWiki.hs+9−11

This diff is too big to show here.

src/Text/Pandoc/Readers/Txt2Tags.hs+59−32

This diff is too big to show here.

src/Text/Pandoc/Readers/Vimwiki.hs+29−22

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/SelfContained.hs+19−17

This diff is too big to show here.

src/Text/Pandoc/Shared.hs+85−126

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Sources.hsnew file+195

This diff is too big to show here.

src/Text/Pandoc/Templates.hs+11−4

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/UUID.hs+6−7

This diff is too big to show here.

src/Text/Pandoc/Writers.hs+21−8

This diff is too big to show here.

src/Text/Pandoc/Writers/AnnotatedTable.hsnew file+323

This diff is too big to show here.

src/Text/Pandoc/Writers/AsciiDoc.hs+90−43

This diff is too big to show here.

src/Text/Pandoc/Writers/BibTeX.hsnew file+61

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Writers/ConTeXt.hs+53−45

This diff is too big to show here.

src/Text/Pandoc/Writers/CslJson.hsnew file+91

This diff is too big to show here.

src/Text/Pandoc/Writers/Custom.hs+16−24

This diff is too big to show here.

src/Text/Pandoc/Writers/Docbook.hs+129−50

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx.hs+329−443

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx/StyleMap.hs+2−4

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx/Table.hsnew file+227

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx/Types.hsnew file+185

This diff is too big to show here.

src/Text/Pandoc/Writers/DokuWiki.hs+37−21

This diff is too big to show here.

src/Text/Pandoc/Writers/EPUB.hs+301−241

This diff is too big to show here.

src/Text/Pandoc/Writers/FB2.hs+74−93

This diff is too big to show here.

src/Text/Pandoc/Writers/GridTable.hsnew file+157

This diff is too big to show here.

src/Text/Pandoc/Writers/HTML.hs+488−523

This diff is too big to show here.

src/Text/Pandoc/Writers/Haddock.hs+21−8

This diff is too big to show here.

src/Text/Pandoc/Writers/ICML.hs+111−69

This diff is too big to show here.

src/Text/Pandoc/Writers/Ipynb.hs+9−12

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS.hs+200−146

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS/References.hsnew file+164

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS/Table.hsnew file+268

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS/Types.hsnew file+57

This diff is too big to show here.

src/Text/Pandoc/Writers/Jira.hs+97−31

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX.hs+184−811

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Caption.hsnew file+47

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Citation.hsnew file+181

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Lang.hsnew file+192

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Notes.hsnew file+34

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Table.hsnew file+307

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Types.hsnew file+83

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Util.hsnew file+275

This diff is too big to show here.

src/Text/Pandoc/Writers/Man.hs+15−14

This diff is too big to show here.

src/Text/Pandoc/Writers/Markdown.hs+199−689

This diff is too big to show here.

src/Text/Pandoc/Writers/Markdown/Inline.hsnew file+616

This diff is too big to show here.

src/Text/Pandoc/Writers/Markdown/Types.hsnew file+81

This diff is too big to show here.

src/Text/Pandoc/Writers/Math.hs+1−4

This diff is too big to show here.

src/Text/Pandoc/Writers/MediaWiki.hs+35−12

This diff is too big to show here.

src/Text/Pandoc/Writers/Ms.hs+110−36

This diff is too big to show here.

src/Text/Pandoc/Writers/Muse.hs+21−12

This diff is too big to show here.

src/Text/Pandoc/Writers/Native.hs+38−10

This diff is too big to show here.

src/Text/Pandoc/Writers/ODT.hs+37−35

This diff is too big to show here.

src/Text/Pandoc/Writers/OOXML.hs+23−25

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Writers/OpenDocument.hs+286−116

This diff is too big to show here.

src/Text/Pandoc/Writers/Org.hs+129−74

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Writers/Powerpoint/Output.hs+304−287

This diff is too big to show here.

src/Text/Pandoc/Writers/Powerpoint/Presentation.hs+36−33

This diff is too big to show here.

src/Text/Pandoc/Writers/RST.hs+76−41

This diff is too big to show here.

src/Text/Pandoc/Writers/RTF.hs+27−19

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Writers/Shared.hs+109−18

This diff is too big to show here.

src/Text/Pandoc/Writers/TEI.hs+16−16

This diff is too big to show here.

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

This diff is too big to show here.

src/Text/Pandoc/Writers/Textile.hs+46−42

This diff is too big to show here.

src/Text/Pandoc/Writers/XWiki.hs+29−28

This diff is too big to show here.

src/Text/Pandoc/Writers/ZimWiki.hs+14−8

This diff is too big to show here.

src/Text/Pandoc/XML.hs+404−25

This diff is too big to show here.

src/Text/Pandoc/XML/Light.hsnew file+89

This diff is too big to show here.

src/Text/Pandoc/XML/Light/Output.hsnew file+234

This diff is too big to show here.

src/Text/Pandoc/XML/Light/Proc.hsnew file+139

This diff is too big to show here.

src/Text/Pandoc/XML/Light/Types.hsnew file+193

This diff is too big to show here.

stack.yaml+13−21

This diff is too big to show here.

test/Tests/Command.hs+73−45

This diff is too big to show here.

test/Tests/Helpers.hs+25−37

This diff is too big to show here.

test/Tests/Lua.hs+40−12

This diff is too big to show here.

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

This diff is too big to show here.

test/Tests/Old.hs+46−31

This diff is too big to show here.

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

This diff is too big to show here.

test/Tests/Readers/Docx.hs+33−12

This diff is too big to show here.

test/Tests/Readers/DokuWiki.hs+10−18

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

test/Tests/Readers/HTML.hs+25−11

This diff is too big to show here.

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

This diff is too big to show here.

test/Tests/Readers/Jira.hs+97−7

This diff is too big to show here.

test/Tests/Readers/LaTeX.hs+98−23

This diff is too big to show here.

test/Tests/Readers/Man.hs+33−22

This diff is too big to show here.

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

This diff is too big to show here.

test/Tests/Readers/Muse.hs+88−81

This diff is too big to show here.

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

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+22−24

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

test/Tests/Readers/Org/Block/Table.hs+39−23

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

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

This diff is too big to show here.

test/Tests/Readers/Txt2Tags.hs+35−21

This diff is too big to show here.

test/Tests/Shared.hs+80−21

This diff is too big to show here.

test/Tests/Writers/AnnotatedTable.hsnew file+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+122−110

This diff is too big to show here.

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

This diff is too big to show here.

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

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+57−54

This diff is too big to show here.

test/Tests/Writers/JATS.hs+137−81

This diff is too big to show here.

test/Tests/Writers/Jira.hsnew file+124

This diff is too big to show here.

test/Tests/Writers/LaTeX.hs+1−3

This diff is too big to show here.

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

This diff is too big to show here.

test/Tests/Writers/Ms.hsnew file+35

This diff is too big to show here.

test/Tests/Writers/Muse.hs+16−9

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+6−5

This diff is too big to show here.

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

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+1−3

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.csvnew file+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/1592.md+21

This diff is too big to show here.

test/command/1608.mdnew file+41

This diff is too big to show here.

test/command/1881.md+50−18

This diff is too big to show here.

test/command/2103.mdnew file+8

This diff is too big to show here.

test/command/2118.md+1−1

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/3348.md+20−7

This diff is too big to show here.

test/command/3516.md+44−14

This diff is too big to show here.

test/command/3533-rst-csv-tables.md+77−25

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+98−8

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+37−17

This diff is too big to show here.

test/command/3708.md+20−7

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+3−6

This diff is too big to show here.

test/command/3752.mdnew file+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/4056.md+18−7

This diff is too big to show here.

test/command/4063.mdnew file+29

This diff is too big to show here.

test/command/4119.md+19−5

This diff is too big to show here.

test/command/4164.md+5−9

This diff is too big to show here.

test/command/4186.md+8−8

This diff is too big to show here.

test/command/4320.md+20−6

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.mdnew file+15

This diff is too big to show here.

test/command/4513.md+15−4

This diff is too big to show here.

test/command/4528.md+1−1

This diff is too big to show here.

test/command/4579.md+19−5

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/4805-beamer-columns-alignment.mdnew file+40

This diff is too big to show here.

test/command/5014.md+14−3

This diff is too big to show here.

test/command/5079.md+12−3

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+2−3

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/5360.mdnew file+19

This diff is too big to show here.

test/command/5367.md+9−10

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.mdnew file+149

This diff is too big to show here.

test/command/5541-nesting.mdnew file+98

This diff is too big to show here.

test/command/5541-urlLink.mdnew file+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/5655.md+2−2

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+15−5

This diff is too big to show here.

test/command/5711.md+12−3

This diff is too big to show here.

test/command/5819.mdnew file+18

This diff is too big to show here.

test/command/5849-prefix.mdnew file+31

This diff is too big to show here.

test/command/5986.md+3−2

This diff is too big to show here.

test/command/6009.mdnew file+18

This diff is too big to show here.

test/command/6026.mdnew file+19

This diff is too big to show here.

test/command/6030.mdnew file+96

This diff is too big to show here.

test/command/6033.mdnew file+91

This diff is too big to show here.

test/command/6034.mdnew file+11

This diff is too big to show here.

test/command/6043.mdnew file+8

This diff is too big to show here.

test/command/6062.mdnew file+6

This diff is too big to show here.

test/command/6107.mdnew file+27

This diff is too big to show here.

test/command/6114.mdnew file+7

This diff is too big to show here.

test/command/6119.mdnew file+10

This diff is too big to show here.

test/command/6133.mdnew file+12

This diff is too big to show here.

test/command/6137.mdnew file+47

This diff is too big to show here.

test/command/6194.mdnew file+14

This diff is too big to show here.

test/command/6265.mdnew file+6

This diff is too big to show here.

test/command/6288.mdnew file+8

This diff is too big to show here.

test/command/6296.mdnew file+14

This diff is too big to show here.

test/command/6308.mdnew file+18

This diff is too big to show here.

test/command/6324.mdnew file+17

This diff is too big to show here.

test/command/6360.mdnew file+6

This diff is too big to show here.

test/command/6385.mdnew file+18

This diff is too big to show here.

test/command/6388.mdnew file+16

This diff is too big to show here.

test/command/6481.mdnew file+38

This diff is too big to show here.

test/command/6541.mdnew file+27

This diff is too big to show here.

test/command/6549.mdnew file+26

This diff is too big to show here.

test/command/6620.mdnew file+18

This diff is too big to show here.

test/command/6658.mdnew file+75

This diff is too big to show here.

test/command/6675.mdnew file+134

This diff is too big to show here.

test/command/6699.mdnew file+13

This diff is too big to show here.

test/command/6709.mdnew file+11

This diff is too big to show here.

test/command/6719.mdnew file+18

This diff is too big to show here.

test/command/6723.mdnew file+32

This diff is too big to show here.

test/command/6739.mdnew file+21

This diff is too big to show here.

test/command/6740.mdnew file+7

This diff is too big to show here.

test/command/6741.mdnew file+145

This diff is too big to show here.

test/command/6752.mdnew file+36

This diff is too big to show here.

test/command/6755.mdnew file+11

This diff is too big to show here.

test/command/6765.mdnew file+31

This diff is too big to show here.

test/command/6768.mdnew file+21

This diff is too big to show here.

test/command/6774.mdnew file+63

This diff is too big to show here.

test/command/6783.mdnew file+26

This diff is too big to show here.

test/command/6791.mdnew file+32

This diff is too big to show here.

test/command/6792.mdnew file+66

This diff is too big to show here.

test/command/6796.mdnew file+16

This diff is too big to show here.

test/command/6802.mdnew file+9

This diff is too big to show here.

test/command/6836.mdnew file+17

This diff is too big to show here.

test/command/6837.mdnew file+29

This diff is too big to show here.

test/command/6844.mdnew file+27

This diff is too big to show here.

test/command/6855.mdnew file+12

This diff is too big to show here.

test/command/6858.mdnew file+52

This diff is too big to show here.

test/command/6869.mdnew file+6

This diff is too big to show here.

test/command/6873.mdnew file+7

This diff is too big to show here.

test/command/6890.mdnew file+36

This diff is too big to show here.

test/command/6925.mdnew file+34

This diff is too big to show here.

test/command/6948.mdnew file+31

This diff is too big to show here.

test/command/6951.mdnew file+18

This diff is too big to show here.

test/command/6958.mdnew file+10

This diff is too big to show here.

test/command/6993.mdnew file+21

This diff is too big to show here.

test/command/7003.mdnew file+37

This diff is too big to show here.

test/command/7006.mdnew file+20

This diff is too big to show here.

test/command/7009.mdnew file+8

This diff is too big to show here.

test/command/7016.mdnew file+48

This diff is too big to show here.

test/command/7041.mdnew file+23

This diff is too big to show here.

test/command/7042.mdnew file+146

This diff is too big to show here.

test/command/7058.mdnew file+6

This diff is too big to show here.

test/command/7064.mdnew file+32

This diff is too big to show here.

test/command/7067.mdnew file+90

This diff is too big to show here.

test/command/7080.mdnew file+8

This diff is too big to show here.

test/command/7092.mdnew file+8

This diff is too big to show here.

test/command/7099.mdnew file+18

This diff is too big to show here.

test/command/7112.mdnew file+15

This diff is too big to show here.

test/command/7129.mdnew file+27

This diff is too big to show here.

test/command/7132.mdnew file+10

This diff is too big to show here.

test/command/7134.mdnew file+16

This diff is too big to show here.

test/command/7145.mdnew file+12

This diff is too big to show here.

test/command/7155.mdnew file+15

This diff is too big to show here.

test/command/7173.mdnew file+137

This diff is too big to show here.

test/command/7208.mdnew file+6

This diff is too big to show here.

test/command/7214.mdnew file+28

This diff is too big to show here.

test/command/7216.mdnew file+19

This diff is too big to show here.

test/command/7266.mdnew file+10

This diff is too big to show here.

test/command/7272.mdnew file+27

This diff is too big to show here.

test/command/7278.mdnew file+38

This diff is too big to show here.

test/command/7282.mdnew file+7

This diff is too big to show here.

test/command/7288.mdnew file+40

This diff is too big to show here.

test/command/7299.mdnew file+23

This diff is too big to show here.

test/command/7321.mdnew file+24

This diff is too big to show here.

test/command/7323.mdnew file+29

This diff is too big to show here.

test/command/7324.mdnew file+25

This diff is too big to show here.

test/command/7339.mdnew file+11

This diff is too big to show here.

test/command/7340.mdnew file+6

This diff is too big to show here.

test/command/7376.mdnew file+16

This diff is too big to show here.

test/command/7394.mdnew file+85

This diff is too big to show here.

test/command/7397.mdnew file+14

This diff is too big to show here.

test/command/7400.mdnew file+9

This diff is too big to show here.

test/command/7416.mdnew file+19

This diff is too big to show here.

test/command/advanced-optical-materials.cslnew file+155

This diff is too big to show here.

test/command/annales.cslnew file+334

This diff is too big to show here.

test/command/apa.cslnew file+474

This diff is too big to show here.

test/command/archeologie-medievale.cslnew file+291

This diff is too big to show here.

test/command/averroes.bibnew file+95

This diff is too big to show here.

test/command/biblatex-266.mdnew file+34

This diff is too big to show here.

test/command/biblatex-aksin.mdnew file+78

This diff is too big to show here.

test/command/biblatex-almendro.mdnew file+71

This diff is too big to show here.

test/command/biblatex-angenendt.mdnew file+66

This diff is too big to show here.

test/command/biblatex-aristotle-anima.mdnew file+62

This diff is too big to show here.

test/command/biblatex-aristotle-physics.mdnew file+63

This diff is too big to show here.

test/command/biblatex-aristotle-poetics.mdnew file+65

This diff is too big to show here.

test/command/biblatex-aristotle-rhetoric.mdnew file+80

This diff is too big to show here.

test/command/biblatex-article.mdnew file+128

This diff is too big to show here.

test/command/biblatex-augustine.mdnew file+56

This diff is too big to show here.

test/command/biblatex-averroes-bland.mdnew file+85

This diff is too big to show here.

test/command/biblatex-averroes-hannes.mdnew file+84

This diff is too big to show here.

test/command/biblatex-averroes-hercz.mdnew file+85

This diff is too big to show here.

test/command/biblatex-baez-article.mdnew file+76

This diff is too big to show here.

test/command/biblatex-baez-online.mdnew file+69

This diff is too big to show here.

test/command/biblatex-basic.mdnew file+71

This diff is too big to show here.

test/command/biblatex-bertram.mdnew file+66

This diff is too big to show here.

test/command/biblatex-bibstring-resolution.mdnew file+20

This diff is too big to show here.

test/command/biblatex-book-averroes.mdnew file+129

This diff is too big to show here.

test/command/biblatex-book-coleridge.mdnew file+59

This diff is too big to show here.

test/command/biblatex-book-title-maintitle-series.mdnew file+39

This diff is too big to show here.

test/command/biblatex-book-vazques-de-parga.mdnew file+48

This diff is too big to show here.

test/command/biblatex-brandt.mdnew file+88

This diff is too big to show here.

test/command/biblatex-britannica.mdnew file+85

This diff is too big to show here.

test/command/biblatex-chiu.mdnew file+77

This diff is too big to show here.

test/command/biblatex-cicero.mdnew file+82

This diff is too big to show here.

test/command/biblatex-cms.mdnew file+81

This diff is too big to show here.

test/command/biblatex-coleridge.mdnew file+86

This diff is too big to show here.

test/command/biblatex-companion.mdnew file+70

This diff is too big to show here.

test/command/biblatex-cotton.mdnew file+69

This diff is too big to show here.

test/command/biblatex-crossref-inbook-mvbook.mdnew file+58

This diff is too big to show here.

test/command/biblatex-crossref-nested.mdnew file+100

This diff is too big to show here.

test/command/biblatex-ctan.mdnew file+73

This diff is too big to show here.

test/command/biblatex-dates.mdnew file+162

This diff is too big to show here.

test/command/biblatex-doody.mdnew file+101

This diff is too big to show here.

test/command/biblatex-edtf-date.mdnew file+72

This diff is too big to show here.

test/command/biblatex-escapedquotes.mdnew file+51

This diff is too big to show here.

test/command/biblatex-formatting.mdnew file+23

This diff is too big to show here.

test/command/biblatex-gaonkar-in.mdnew file+62

This diff is too big to show here.

test/command/biblatex-gaonkar.mdnew file+59

This diff is too big to show here.

test/command/biblatex-geer.mdnew file+70

This diff is too big to show here.

test/command/biblatex-gerhardt.mdnew file+64

This diff is too big to show here.

test/command/biblatex-gillies.mdnew file+69

This diff is too big to show here.

test/command/biblatex-glashow.mdnew file+51

This diff is too big to show here.

test/command/biblatex-gonzalez.mdnew file+62

This diff is too big to show here.

test/command/biblatex-hammond.mdnew file+63

This diff is too big to show here.

test/command/biblatex-herrmann.mdnew file+70

This diff is too big to show here.

test/command/biblatex-hyman.mdnew file+79

This diff is too big to show here.

test/command/biblatex-iliad.mdnew file+68

This diff is too big to show here.

test/command/biblatex-inbook-title-booktitle-maintitle-series-2.mdnew file+48

This diff is too big to show here.

test/command/biblatex-inbook-title-booktitle-maintitle-series.mdnew file+44

This diff is too big to show here.

test/command/biblatex-inbook.mdnew file+147

This diff is too big to show here.

test/command/biblatex-incollection-2.mdnew file+98

This diff is too big to show here.

test/command/biblatex-incollection.mdnew file+130

This diff is too big to show here.

test/command/biblatex-inproceedings.mdnew file+88

This diff is too big to show here.

test/command/biblatex-issue288.mdnew file+35

This diff is too big to show here.

test/command/biblatex-itzhaki.mdnew file+82

This diff is too big to show here.

test/command/biblatex-jaffe.mdnew file+82

This diff is too big to show here.

test/command/biblatex-jcg.mdnew file+54

This diff is too big to show here.

test/command/biblatex-kant-kpv.mdnew file+90

This diff is too big to show here.

test/command/biblatex-kant-ku.mdnew file+82

This diff is too big to show here.

test/command/biblatex-kastenholz.mdnew file+126

This diff is too big to show here.

test/command/biblatex-knuth-ct-a.mdnew file+78

This diff is too big to show here.

test/command/biblatex-knuth-ct-b.mdnew file+70

This diff is too big to show here.

test/command/biblatex-knuth-ct-c.mdnew file+69

This diff is too big to show here.

test/command/biblatex-knuth-ct-d.mdnew file+71

This diff is too big to show here.

test/command/biblatex-knuth-ct-e.mdnew file+66

This diff is too big to show here.

test/command/biblatex-knuth-ct-related.mdnew file+72

This diff is too big to show here.

test/command/biblatex-knuth-ct.mdnew file+66

This diff is too big to show here.

test/command/biblatex-kowalik.mdnew file+68

This diff is too big to show here.

test/command/biblatex-kullback-related.mdnew file+62

This diff is too big to show here.

test/command/biblatex-kullback-reprint.mdnew file+71

This diff is too big to show here.

test/command/biblatex-kullback.mdnew file+52

This diff is too big to show here.

test/command/biblatex-laufenberg.mdnew file+109

This diff is too big to show here.

test/command/biblatex-loh.mdnew file+65

This diff is too big to show here.

test/command/biblatex-malinowski.mdnew file+67

This diff is too big to show here.

test/command/biblatex-manual.mdnew file+51

This diff is too big to show here.

test/command/biblatex-markey.mdnew file+65

This diff is too big to show here.

test/command/biblatex-maron.mdnew file+70

This diff is too big to show here.

test/command/biblatex-massa.mdnew file+56

This diff is too big to show here.

test/command/biblatex-moore-related.mdnew file+66

This diff is too big to show here.

test/command/biblatex-moore.mdnew file+56

This diff is too big to show here.

test/command/biblatex-moraux.mdnew file+94

This diff is too big to show here.

test/command/biblatex-murray.mdnew file+105

This diff is too big to show here.

test/command/biblatex-nietzsche-historie.mdnew file+100

This diff is too big to show here.

test/command/biblatex-nietzsche-ksa.mdnew file+89

This diff is too big to show here.

test/command/biblatex-nietzsche-ksa1.mdnew file+95

This diff is too big to show here.

test/command/biblatex-online.mdnew file+64

This diff is too big to show here.

test/command/biblatex-options-url-false-doi-false.mdnew file+57

This diff is too big to show here.

test/command/biblatex-padhye.mdnew file+117

This diff is too big to show here.

test/command/biblatex-patent.mdnew file+158

This diff is too big to show here.

test/command/biblatex-periodical.mdnew file+31

This diff is too big to show here.

test/command/biblatex-piccato.mdnew file+59

This diff is too big to show here.

test/command/biblatex-pines.mdnew file+77

This diff is too big to show here.

test/command/biblatex-quotes.mdnew file+44

This diff is too big to show here.

test/command/biblatex-reese.mdnew file+71

This diff is too big to show here.

test/command/biblatex-report.mdnew file+119

This diff is too big to show here.

test/command/biblatex-salam.mdnew file+69

This diff is too big to show here.

test/command/biblatex-sarfraz.mdnew file+65

This diff is too big to show here.

test/command/biblatex-shore.mdnew file+66

This diff is too big to show here.

test/command/biblatex-sigfridsson.mdnew file+106

This diff is too big to show here.

test/command/biblatex-sorace.mdnew file+65

This diff is too big to show here.

test/command/biblatex-spiegelberg.mdnew file+74

This diff is too big to show here.

test/command/biblatex-springer.mdnew file+58

This diff is too big to show here.

test/command/biblatex-strings.mdnew file+46

This diff is too big to show here.

test/command/biblatex-test-case-conversion.mdnew file+73

This diff is too big to show here.

test/command/biblatex-textnormal.mdnew file+17

This diff is too big to show here.

test/command/biblatex-thesis.mdnew file+68

This diff is too big to show here.

test/command/biblatex-title-and-shorttitle.mdnew file+76

This diff is too big to show here.

test/command/biblatex-vangennep-related.mdnew file+69

This diff is too big to show here.

test/command/biblatex-vangennep-trans.mdnew file+69

This diff is too big to show here.

test/command/biblatex-vangennep.mdnew file+61

This diff is too big to show here.

test/command/biblatex-vazques-de-parga-mvbook.mdnew file+75

This diff is too big to show here.

test/command/biblatex-vazques-de-parga.mdnew file+74

This diff is too big to show here.

test/command/biblatex-video.mdnew file+19

This diff is too big to show here.

test/command/biblatex-vizedom-related.mdnew file+68

This diff is too big to show here.

test/command/biblatex-wassenberg.mdnew file+83

This diff is too big to show here.

test/command/biblatex-weinberg.mdnew file+52

This diff is too big to show here.

test/command/biblatex-westfahl-frontier.mdnew file+60

This diff is too big to show here.

test/command/biblatex-westfahl-space.mdnew file+106

This diff is too big to show here.

test/command/biblatex-wilde.mdnew file+65

This diff is too big to show here.

test/command/biblatex-worman.mdnew file+60

This diff is too big to show here.

test/command/biblatex-yoon.mdnew file+67

This diff is too big to show here.

test/command/biblio.bibnew file+26

This diff is too big to show here.

test/command/bibtex-basic.mdnew file+71

This diff is too big to show here.

test/command/bioethics.cslnew file+226

This diff is too big to show here.

test/command/chap1/spider.pngnew file

Binary file not shown.

test/command/chap1/text.mdnew file+17

This diff is too big to show here.

test/command/chap2/spider.pngnew file

Binary file not shown.

test/command/chap2/text.mdnew file+5

This diff is too big to show here.

test/command/chicago-annotated-bibliography.cslnew file+1207

This diff is too big to show here.

test/command/chicago-author-date-with-original-date-and-status.cslnew file+575

This diff is too big to show here.

test/command/chicago-fullnote-bibliography.cslnew file+1430

This diff is too big to show here.

test/command/chicago-note-bibliography.cslnew file+1005

This diff is too big to show here.

test/command/chinese-gb7714-2005-numeric.cslnew file+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.mdnew file+17

This diff is too big to show here.

test/command/citeproc-20.mdnew file+25

This diff is too big to show here.

test/command/citeproc-7a.mdnew file+42

This diff is too big to show here.

test/command/citeproc-7b.mdnew file+36

This diff is too big to show here.

test/command/citeproc-author-in-text-suffix.mdnew file+6

This diff is too big to show here.

test/command/csv.mdnew file+46

This diff is too big to show here.

test/command/custom-attributes.htmldeleted−16

This diff is too big to show here.

test/command/defaults-inheritance-1.mdnew file+6

This diff is too big to show here.

test/command/defaults-inheritance-2.mdnew file+5

This diff is too big to show here.

test/command/defaults-inheritance-3.mdnew file+6

This diff is too big to show here.

test/command/defaults3.yamlnew file+4

This diff is too big to show here.

test/command/defaults4.yamlnew file+3

This diff is too big to show here.

test/command/defaults5.yamlnew file+2

This diff is too big to show here.

test/command/defaults6.yamlnew file+2

This diff is too big to show here.

test/command/defaults7.yamlnew file+2

This diff is too big to show here.

test/command/defaults8.yamlnew file+2

This diff is too big to show here.

test/command/defaults9.yamlnew file+1

This diff is too big to show here.

test/command/din-1505-2.cslnew file+406

This diff is too big to show here.

test/command/docbook-bibliography.mdnew file+20

This diff is too big to show here.

test/command/duplicate_attributes.mdnew file+7

This diff is too big to show here.

test/command/empty-inline-code.txtdeleted−6

This diff is too big to show here.

test/command/gfm.md+52−18

This diff is too big to show here.

test/command/harvard-university-of-kent.cslnew file+253

This diff is too big to show here.

test/command/ieee.cslnew file+339

This diff is too big to show here.

test/command/issue160.cslnew file+28

This diff is too big to show here.

test/command/issue437.cslnew file+26

This diff is too big to show here.

test/command/issue58.cslnew file+553

This diff is too big to show here.

data/jats.csl → test/command/jats.cslrenamed+12−7

This diff is too big to show here.

test/command/latex-center.mdnew file+13

This diff is too big to show here.

test/command/latex-tabular-column-specs.md+31−10

This diff is too big to show here.

test/command/le-tapuscrit-note.cslnew file+496

This diff is too big to show here.

test/command/lettrine.md+2−2

This diff is too big to show here.

test/command/lists-inside-definition.mdnew file+67

This diff is too big to show here.

test/command/locators.cslnew file+68

This diff is too big to show here.

test/command/mmd-metadata.mdnew file+20

This diff is too big to show here.

test/command/modern-humanities-research-association.cslnew file+445

This diff is too big to show here.

test/command/nested-table-to-asciidoc-6942.mdnew file+82

This diff is too big to show here.

test/command/newif.mdnew file+55

This diff is too big to show here.

test/command/oscola.cslnew file+680

This diff is too big to show here.

test/command/pandoc-citeproc-118.mdnew file+28

This diff is too big to show here.

test/command/pandoc-citeproc-119.mdnew file+38

This diff is too big to show here.

test/command/pandoc-citeproc-13.mdnew file+29

This diff is too big to show here.

test/command/pandoc-citeproc-136.mdnew file+23

This diff is too big to show here.

test/command/pandoc-citeproc-14.mdnew file+77

This diff is too big to show here.

test/command/pandoc-citeproc-152.mdnew file+63

This diff is too big to show here.

test/command/pandoc-citeproc-160.mdnew file+44

This diff is too big to show here.

test/command/pandoc-citeproc-175.mdnew file+43

This diff is too big to show here.

test/command/pandoc-citeproc-197.mdnew file+31

This diff is too big to show here.

test/command/pandoc-citeproc-213.mdnew file+33

This diff is too big to show here.

test/command/pandoc-citeproc-25.mdnew file+30

This diff is too big to show here.

test/command/pandoc-citeproc-250.mdnew file+21

This diff is too big to show here.

test/command/pandoc-citeproc-27.mdnew file+38

This diff is too big to show here.

test/command/pandoc-citeproc-292.mdnew file+43

This diff is too big to show here.

test/command/pandoc-citeproc-301.mdnew file+25

This diff is too big to show here.

test/command/pandoc-citeproc-307.mdnew file+31

This diff is too big to show here.

test/command/pandoc-citeproc-31.mdnew file+48

This diff is too big to show here.

test/command/pandoc-citeproc-312.mdnew file+171

This diff is too big to show here.

test/command/pandoc-citeproc-320.mdnew file+254

This diff is too big to show here.

test/command/pandoc-citeproc-320a.mdnew file+87

This diff is too big to show here.

test/command/pandoc-citeproc-322.mdnew file+35

This diff is too big to show here.

test/command/pandoc-citeproc-325.mdnew file+30

This diff is too big to show here.

test/command/pandoc-citeproc-327.mdnew file+51

This diff is too big to show here.

test/command/pandoc-citeproc-338.mdnew file+35

This diff is too big to show here.

test/command/pandoc-citeproc-351.mdnew file+27

This diff is too big to show here.

test/command/pandoc-citeproc-356.mdnew file+20

This diff is too big to show here.

test/command/pandoc-citeproc-360.mdnew file+35

This diff is too big to show here.

test/command/pandoc-citeproc-361.mdnew file+80

This diff is too big to show here.

test/command/pandoc-citeproc-365.mdnew file+39

This diff is too big to show here.

test/command/pandoc-citeproc-371.mdnew file+40

This diff is too big to show here.

test/command/pandoc-citeproc-38.mdnew file+29

This diff is too big to show here.

test/command/pandoc-citeproc-386.mdnew file+35

This diff is too big to show here.

test/command/pandoc-citeproc-392.mdnew file+29

This diff is too big to show here.

test/command/pandoc-citeproc-399.mdnew file+45

This diff is too big to show here.

test/command/pandoc-citeproc-401.mdnew file+59

This diff is too big to show here.

test/command/pandoc-citeproc-408.mdnew file+39

This diff is too big to show here.

test/command/pandoc-citeproc-416.mdnew file+60

This diff is too big to show here.

test/command/pandoc-citeproc-437.mdnew file+23

This diff is too big to show here.

test/command/pandoc-citeproc-47.mdnew file+112

This diff is too big to show here.

test/command/pandoc-citeproc-51.mdnew file+45

This diff is too big to show here.

test/command/pandoc-citeproc-53.mdnew file+56

This diff is too big to show here.

test/command/pandoc-citeproc-57.mdnew file+37

This diff is too big to show here.

test/command/pandoc-citeproc-58.mdnew file+32

This diff is too big to show here.

test/command/pandoc-citeproc-61.mdnew file+77

This diff is too big to show here.

test/command/pandoc-citeproc-64.mdnew file+24

This diff is too big to show here.

test/command/pandoc-citeproc-65.mdnew file+38

This diff is too big to show here.

test/command/pandoc-citeproc-68.mdnew file+56

This diff is too big to show here.

test/command/pandoc-citeproc-7.mdnew file+31

This diff is too big to show here.

test/command/pandoc-citeproc-70.mdnew file+73

This diff is too big to show here.

test/command/pandoc-citeproc-75.mdnew file+67

This diff is too big to show here.

test/command/pandoc-citeproc-76.mdnew file+64

This diff is too big to show here.

test/command/pandoc-citeproc-77.mdnew file+67

This diff is too big to show here.

test/command/pandoc-citeproc-82.mdnew file+39

This diff is too big to show here.

test/command/pandoc-citeproc-87.mdnew file+156

This diff is too big to show here.

test/command/pandoc-citeproc-chicago-author-date.mdnew file+109

This diff is too big to show here.

test/command/pandoc-citeproc-chicago-fullnote-bibliography.mdnew file+134

This diff is too big to show here.

test/command/pandoc-citeproc-ieee.mdnew file+113

This diff is too big to show here.

test/command/pandoc-citeproc-locators-delimited.mdnew file+127

This diff is too big to show here.

test/command/pandoc-citeproc-locators-integrated.mdnew file+159

This diff is too big to show here.

test/command/pandoc-citeproc-move-period-inside-quote.mdnew file+52

This diff is too big to show here.

test/command/pandoc-citeproc-no-author.mdnew file+73

This diff is too big to show here.

test/command/pandoc-citeproc-number-of-volumes.mdnew file+29

This diff is too big to show here.

test/command/pandoc-citeproc-page-range.mdnew file+32

This diff is too big to show here.

test/command/refs.md+4−4

This diff is too big to show here.

test/command/sage-harvard.cslnew file+202

This diff is too big to show here.

test/command/science.cslnew file+245

This diff is too big to show here.

test/command/style399.cslnew file+12

This diff is too big to show here.

test/command/svg.md+17−15

This diff is too big to show here.

test/command/table-with-cell-align.mdnew file+82

This diff is too big to show here.

test/command/table-with-column-span.mdnew file+276

This diff is too big to show here.

test/command/tabularx.md+123−48

This diff is too big to show here.

test/command/toc.md+11−20

This diff is too big to show here.

test/command/unicode-collation.mdnew file+130

This diff is too big to show here.

test/command/vancouver.cslnew file+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.cslnew file+346

This diff is too big to show here.

test/creole-reader.native+53−16

This diff is too big to show here.

test/docbook-reader.docbook+39−2

This diff is too big to show here.

test/docbook-reader.native+293−107

This diff is too big to show here.

test/docx/0_level_headers.native+39−12

This diff is too big to show here.

test/docx/alternate_document_path.native+2−1

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.docxnew file

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.docxnew file

Binary file not shown.

test/docx/golden/raw-bookmarks.docxnew file

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.docxnew file

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.docxnew file

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.docxnew file

Binary file not shown.

test/docx/image_vml_as_object.nativenew file+2

This diff is too big to show here.

test/docx/inline_formatting.native+2−1

This diff is too big to show here.

test/docx/lists_multiple_initial.nativenew file+8

This diff is too big to show here.

test/docx/raw-blocks.nativenew file+6

This diff is too big to show here.

test/docx/raw-bookmarks.nativenew file+3

This diff is too big to show here.

test/docx/sdt_elements.native+24−10

This diff is too big to show here.

test/docx/table_captions_no_field.docxnew file

Binary file not shown.

test/docx/table_captions_no_field.nativenew file+34

This diff is too big to show here.

test/docx/table_captions_with_field.docxnew file

Binary file not shown.

test/docx/table_captions_with_field.nativenew file+54

This diff is too big to show here.

test/docx/table_header_rowspan.docxnew file

Binary file not shown.

test/docx/table_header_rowspan.nativenew file+189

This diff is too big to show here.

test/docx/table_one_header_row.docxnew file

Binary file not shown.

test/docx/table_one_header_row.nativenew file+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+18−7

This diff is too big to show here.

test/docx/table_variable_width.native+40−16

This diff is too big to show here.

test/docx/table_with_list_cell.native+25−11

This diff is too big to show here.

test/docx/tables-default-widths.nativenew file+92

This diff is too big to show here.

test/docx/tables.native+91−35

This diff is too big to show here.

test/docx/track_changes_scrubbed_metadata.docxnew file

Binary file not shown.

test/docx/track_changes_scrubbed_metadata.nativenew file+9

This diff is too big to show here.

test/dokuwiki_multiblock_table.native+41−18

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.shdeleted−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+492−132

This diff is too big to show here.

test/jats-reader.native+380−131

This diff is too big to show here.

test/jats-reader.xml+4−3

This diff is too big to show here.

test/jira-reader.native+2−2

This diff is too big to show here.

test/latex-reader.native+65−24

This diff is too big to show here.

test/lhs-test.html+136−3

This diff is too big to show here.

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

This diff is too big to show here.

test/lhs-test.latex+8−5

This diff is too big to show here.

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

This diff is too big to show here.

test/lua/blocks-filter.luanew file+8

This diff is too big to show here.

test/lua/inlines-filter.luanew file+19

This diff is too big to show here.

test/lua/meta.luanew file+6

This diff is too big to show here.

test/lua/module/pandoc-list.luanew file+160

This diff is too big to show here.

test/lua/module/pandoc-path.luanew file+44

This diff is too big to show here.

test/lua/module/pandoc-types.lua+3−4

This diff is too big to show here.

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

This diff is too big to show here.

test/lua/require-file.luanew file+2

This diff is too big to show here.

test/man-reader.native+192−72

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+185−73

This diff is too big to show here.

test/mediawiki-reader.native+225−69

This diff is too big to show here.

test/odt/native/simpleTable.native+1−1

This diff is too big to show here.

test/odt/native/simpleTableWithCaption.native+1−1

This diff is too big to show here.

test/odt/native/tab.nativenew file+1

This diff is too big to show here.

test/odt/native/tableWithContents.native+1−1

This diff is too big to show here.

test/odt/odt/tab.odtnew file

Binary file not shown.

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

This diff is too big to show here.

test/pipe-tables.native+315−104

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.native+48−18

This diff is too big to show here.

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.native+94−34

This diff is too big to show here.

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+169−61

This diff is too big to show here.

test/rst-reader.rst+24

This diff is too big to show here.

test/s5-basic.html+1

This diff is too big to show here.

test/s5-fancy.html+1−1

This diff is too big to show here.

test/s5-inserts.html+1

This diff is too big to show here.

test/tables-rstsubset.native+294−107

This diff is too big to show here.

test/tables.fb2+1−1

This diff is too big to show here.

test/tables.haddock+70−70

This diff is too big to show here.

test/tables.jatsdeleted−226

This diff is too big to show here.

test/tables.jats_archivingnew file+226

This diff is too big to show here.

test/tables.jats_articleauthoringnew file+226

This diff is too big to show here.

test/tables.jats_publishingnew file+226

This diff is too big to show here.

test/tables.jira+5

This diff is too big to show here.

test/tables.latex+65−101

This diff is too big to show here.

test/tables.ms+44

This diff is too big to show here.

test/tables.native+286−107

This diff is too big to show here.

test/tables.org+31−31

This diff is too big to show here.

test/tables.tei−12

This diff is too big to show here.

test/tables/nordics.html4new file+59

This diff is too big to show here.

test/tables/nordics.html5new file+59

This diff is too big to show here.

test/tables/nordics.jats_archivingnew file+58

This diff is too big to show here.

test/tables/nordics.latexnew file+42

This diff is too big to show here.

test/tables/nordics.nativenew file+73

This diff is too big to show here.

test/tables/planets.html4new file+133

This diff is too big to show here.

test/tables/planets.html5new file+133

This diff is too big to show here.

test/tables/planets.jats_archivingnew file+128

This diff is too big to show here.

test/tables/planets.latexnew file+30

This diff is too big to show here.

test/tables/planets.nativenew file+241

This diff is too big to show here.

test/tables/students.html4new file+55

This diff is too big to show here.

test/tables/students.html5new file+55

This diff is too big to show here.

test/tables/students.jats_archivingnew file+56

This diff is too big to show here.

test/tables/students.latexnew file+31

This diff is too big to show here.

test/tables/students.nativenew file+54

This diff is too big to show here.

test/test-pandoc.hs+25−9

This diff is too big to show here.

test/textile-reader.native+104−41

This diff is too big to show here.

test/textile-reader.textile+1−1

This diff is too big to show here.

test/tikiwiki-reader.native+120−38

This diff is too big to show here.

test/twiki-reader.native+110−34

This diff is too big to show here.

test/txt2tags.native+661−304

This diff is too big to show here.

test/txt2tags.t2t+1−1

This diff is too big to show here.

test/vimwiki-reader.native+206−68

This diff is too big to show here.

test/vimwiki-reader.wiki+6

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+45−43

This diff is too big to show here.

test/writer.custom+2−2

This diff is too big to show here.

test/writer.docbook4+8−4

This diff is too big to show here.

test/writer.docbook5+8−4

This diff is too big to show here.

test/writer.dokuwiki+11

This diff is too big to show here.

test/writer.html4+133−1

This diff is too big to show here.

test/writer.html5+134−2

This diff is too big to show here.

test/writer.icml+65−29

This diff is too big to show here.

test/writer.jats_archivingnew file+902

This diff is too big to show here.

test/writer.jats_articleauthoringnew file+874

This diff is too big to show here.

test/writer.jats → test/writer.jats_publishingrenamed+15−11

This diff is too big to show here.

test/writer.jira+30−42

This diff is too big to show here.

test/writer.latex+6−3

This diff is too big to show here.

test/writer.markdown+29−56

This diff is too big to show here.

test/writer.ms+54−54

This diff is too big to show here.

test/writer.opml+1−1

This diff is too big to show here.

test/writer.org+91−118

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+7−5

This diff is too big to show here.

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

This diff is too big to show here.

tools/build-arm.shnew file+110

This diff is too big to show here.

tools/changelog-helper.sh+11−4

This diff is too big to show here.

tools/changes_template.htmlnew file+6

This diff is too big to show here.

tools/ldoc.ltpdeleted−38

This diff is too big to show here.

tools/parseTimings.plnew file+33

This diff is too big to show here.

tools/update-lua-docs.luadeleted−49

This diff is too big to show here.

trypandoc/index.html+20−9

This diff is too big to show here.

trypandoc/trypandoc.hs+8−11

This diff is too big to show here.

windows/Makefile+1−1

This diff is too big to show here.

windows/Pandoc-en-us.wxl+1−1

This diff is too big to show here.

windows/make-windows-installer.batdeleted−29

This diff is too big to show here.

windows/pandoc.wxs+5−7

This diff is too big to show here.