Ini adalah perintah pandoc yang dapat dijalankan di penyedia hosting gratis OnWorks menggunakan salah satu dari beberapa stasiun kerja online gratis kami seperti Ubuntu Online, Fedora Online, emulator online Windows atau emulator online MAC OS
PROGRAM:
NAMA
pandoc - konverter markup umum
RINGKASAN
pandok [Pilihan] [file masukan] ...
DESKRIPSI
Pandoc adalah perpustakaan Haskell untuk mengonversi dari satu format markup ke format markup lainnya, dan a
alat baris perintah yang menggunakan perpustakaan ini. Itu bisa membaca Penurunan Harga, CommonMark, PHP Penurunan Harga
Ekstra, Penurunan Harga Rasa GitHub, dan (bagian dari) Tekstil, reStructuredText, HTML, LaTeX,
Markup MediaWiki, markup TWiki, markup Haddock, OPML, mode Emacs Org, DocBook, txt2tags,
EPUB, ODT dan Word docx; dan itu dapat menulis teks biasa, Penurunan Harga, CommonMark, PHP Penurunan Harga
Ekstra, Penurunan Harga Rasa GitHub, reStructuredText, XHTML, HTML5, LaTeX (termasuk beamer
tayangan slide), ConTeXt, RTF, OPML, DocBook, OpenDocument, ODT, Word docx, GNU Texinfo,
Markup MediaWiki, markup DokuWiki, markup Haddock, EPUB (v2 atau v3), FictionBook2, Tekstil,
halaman manual groff, mode Emacs Org, AsciiDoc, InDesign ICML, dan Slidy, Slideous, DZSlides,
tampilan slide mengungkapkan.js atau S5 HTML. Itu juga dapat menghasilkan output PDF pada sistem di mana LaTeX,
ConTeXt, atau wkhtmltopdf telah diinstal.
Versi penurunan harga Pandoc yang disempurnakan mencakup sintaks untuk catatan kaki, tabel, fleksibel
daftar terurut, daftar definisi, blok kode berpagar, superskrip dan subskrip,
coret, blok metadata, daftar isi otomatis, matematika LaTeX tertanam, kutipan,
dan Penurunan harga di dalam elemen blok HTML. (Peningkatan ini, dijelaskan di bawah di bawah
Penurunan harga Pandoc, dapat dinonaktifkan menggunakan format input atau output markdown_strict.)
Berbeda dengan kebanyakan alat yang ada untuk mengonversi Markdown ke HTML, yang menggunakan regex
substitusi, pandoc memiliki desain modular: terdiri dari satu set pembaca, yang mengurai
teks dalam format tertentu dan menghasilkan representasi asli dari dokumen, dan satu set
penulis, yang mengubah representasi asli ini menjadi format target. Jadi, menambahkan
format input atau output hanya membutuhkan penambahan pembaca atau penulis.
Karena representasi perantara pandoc dari sebuah dokumen kurang ekspresif daripada banyak dari
format yang dikonversi di antara, orang seharusnya tidak mengharapkan konversi sempurna di antara setiap
format dan lainnya. Pandoc mencoba untuk melestarikan elemen struktural dari a
dokumen, tetapi tidak memformat detail seperti ukuran margin. Dan beberapa elemen dokumen,
seperti tabel kompleks, mungkin tidak cocok dengan model dokumen sederhana pandoc. Ketika
konversi dari penurunan harga pandoc ke semua format bercita-cita menjadi sempurna, konversi dari
format yang lebih ekspresif daripada penurunan harga pandoc dapat diharapkan menjadi lossy.
Menggunakan pandoc
Jika tidak file masukan ditentukan, input dibaca dari stdin. Kalau tidak, file-input adalah
digabungkan (dengan baris kosong di antara masing-masing) dan digunakan sebagai input. Keluaran menuju ke stdout by
default (meskipun output ke stdout dinonaktifkan untuk keluaran odt, docx, epub, dan epub3
format). Untuk output ke file, gunakan opsi -o:
pandoc -o keluaran.html masukan.txt
Secara default, pandoc menghasilkan fragmen dokumen, bukan dokumen yang berdiri sendiri dengan yang tepat
header dan footer. Untuk menghasilkan dokumen mandiri, gunakan flag -s atau --standalone:
pandoc -s -o keluaran.html masukan.txt
Untuk informasi selengkapnya tentang bagaimana dokumen mandiri dibuat, lihat Templat, di bawah.
Alih-alih file, URI absolut dapat diberikan. Dalam hal ini pandoc akan mengambil
konten menggunakan HTTP:
pandoc -f html -t penurunan harga http://www.fsf.org
Jika beberapa file input diberikan, pandoc akan menggabungkan semuanya (dengan baris kosong
antara mereka) sebelum parsing. Fitur ini dinonaktifkan untuk format input biner seperti
EPUB, odt, dan docx.
Format input dan output dapat ditentukan secara eksplisit menggunakan opsi baris perintah.
Format input dapat ditentukan menggunakan opsi -r/--read atau -f/--from, output
format menggunakan opsi -w/--write atau -t/--to. Jadi, untuk mengonversi hello.txt dari penurunan harga
ke LaTeX, Anda bisa mengetik:
pandoc -f penurunan harga -t lateks hello.txt
Untuk mengonversi hello.html dari HTML ke Penurunan Harga:
pandoc -f html -t penurunan harga hello.html
Format output yang didukung tercantum di bawah ini di bawah opsi -t/--to. Masukan yang didukung
format tercantum di bawah ini di bawah opsi -f/--from. Perhatikan bahwa yang pertama, tekstil, lateks,
dan pembaca html tidak lengkap; ada beberapa konstruksi yang tidak mereka urai.
Jika format input atau output tidak ditentukan secara eksplisit, pandoc akan mencoba menebaknya
dari ekstensi nama file input dan output. Dengan demikian, misalnya,
pandoc -o halo.tex halo.txt
akan mengonversi hello.txt dari penurunan harga ke LaTeX. Jika tidak ada file output yang ditentukan (sehingga
keluaran menuju ke stdout), atau jika ekstensi file keluaran tidak diketahui, format keluaran
akan default ke HTML. Jika tidak ada file input yang ditentukan (sehingga input berasal dari stdin), atau
jika ekstensi file input tidak diketahui, format input akan dianggap sebagai
Penurunan harga kecuali ditentukan secara eksplisit.
Pandoc menggunakan pengkodean karakter UTF-8 untuk input dan output. Jika lokal Anda
pengkodean karakter bukan UTF-8, Anda harus menyalurkan input dan output melalui iconv:
iconv -t utf-8 input.txt | pandok | iconv -f utf-8
Perhatikan bahwa dalam beberapa format keluaran (seperti HTML, LaTeX, ConTeXt, RTF, OPML, DocBook, dan
Texinfo), informasi tentang pengkodean karakter disertakan dalam header dokumen,
yang hanya akan disertakan jika Anda menggunakan opsi -s/--standalone.
membuat a PDF
Untuk menghasilkan PDF, tentukan file keluaran dengan ekstensi .pdf. Secara default, pandoc akan
gunakan LaTeX untuk mengonversinya ke PDF:
pandoc tes.txt -o tes.pdf
Produksi PDF mengharuskan mesin LaTeX dipasang (lihat --latex-engine, di bawah),
dan mengasumsikan bahwa paket LaTeX berikut tersedia: amsfonts, amsmath, lm,
ifxetex, ifluatex, eurosym, listings (jika opsi --listings digunakan), fancyvrb,
longtable, booktabs, graphicx dan grffile (jika dokumen berisi gambar), hyperref,
ulem, geometri (dengan himpunan variabel geometri), setspace (dengan peregangan garis), dan babel
(dengan lang). Penggunaan xelatex atau lualatex sebagai mesin LaTeX membutuhkan fontspec;
xelatex menggunakan mathspec, polyglossia (dengan lang), xecjk, dan bidi (dengan variabel dir
mengatur). Paket upquote dan microtype digunakan jika tersedia, dan csquotes akan digunakan
untuk tanda baca cerdas jika ditambahkan ke template atau disertakan dalam file header apa pun. Itu
natbib, biblatex, bibtex, dan paket biber secara opsional dapat digunakan untuk kutipan
rendering. Ini disertakan dengan semua versi terbaru TeX Live.
Atau, pandoc dapat menggunakan ConTeXt atau wkhtmltopdf untuk membuat PDF. Untuk melakukan ini, tentukan
file keluaran dengan ekstensi .pdf, seperti sebelumnya, tetapi tambahkan -t konteks atau -t html5 ke
garis komando.
Output PDF dapat dikontrol menggunakan variabel untuk LaTeX (jika LaTeX digunakan) dan variabel
untuk ConTeXt (jika ConTeXt digunakan). Jika wkhtmltopdf digunakan, maka variabel margin-left,
margin-kanan, margin-atas, margin-bawah, dan ukuran kertas akan mempengaruhi output, seperti yang akan
--css.
PILIHAN
Umum Pilihan
-f FORMAT, -r FORMAT, --dari=FORMAT, --baca=FORMAT
Tentukan format masukan. FORMAT bisa asli (asli Haskell), json (versi JSON dari
AST asli), penurunan harga (Penurunan harga diperpanjang pandoc), penurunan harga_ketat (asli
penurunan harga yang tidak diperpanjang), penurunan harga_phpextra (Penurunan harga PHP Ekstra), penurunan harga_github
(Penurunan Harga dengan Rasa GitHub), tanda umum (Penurunan Mark Umum), tekstil (Tekstil),
pertama (reStructuredText), html (HTML), docbook (DocBook), t2t (txt2tags), docx
(docx), odt (ODT), epub (EPUB), opml (OPML), org (mode Emacs Org), mediawiki
(Markup MediaWiki), twiki (markup TWiki), haddock (markup Haddock), atau lateks
(Getah). Jika +lhs ditambahkan ke penurunan harga, pertama, lateks, atau html, inputnya adalah
diperlakukan sebagai sumber Haskell yang terpelajar: lihat dukungan Literate Haskell, di bawah. Penurunan harga
ekstensi sintaks dapat diaktifkan atau dinonaktifkan secara individual dengan menambahkan +EXTENSION
atau -EXTENSION ke nama format. Jadi, misalnya,
markdown_strict+footnotes+definition_lists adalah Markdown yang ketat dengan catatan kaki dan
daftar definisi diaktifkan, dan markdown-pipe_tables+hard_line_breaks adalah milik pandoc
Penurunan harga tanpa meja pipa dan dengan garis putus-putus. Lihat Penurunan Harga Pandoc,
di bawah ini, untuk daftar ekstensi dan namanya.
-t FORMAT, -w FORMAT, --ke=FORMAT, --tulis=FORMAT
Tentukan format keluaran. FORMAT bisa asli (asli Haskell), json (versi JSON
dari AST asli), polos (teks biasa), penurunan harga (Penurunan harga diperpanjang pandoc),
markdown_strict (Penurunan harga asli tanpa perpanjangan), markdown_phpextra (Penurunan harga PHP
Ekstra), markdown_github (GitHub-Flavored Markdown), commonmark (CommonMark
Penurunan harga), pertama (reStructuredText), html (XHTML), html5 (HTML5), lateks (LaTeX),
beamer (LaTeX beamer slide show), konteks (ConTeXt), man (groff man), mediawiki
(Markup MediaWiki), dokuwiki (markup DokuWiki), tekstil (Tekstil), org (Emacs Org
mode), texinfo (GNU Texinfo), opml (OPML), docbook (DocBook), dokumen terbuka
(OpenDocument), odt (dokumen teks OpenOffice), docx (Word docx), haddock (Haddock
markup), rtf (format teks kaya), epub (buku EPUB v2), epub3 (EPUB v3), fb2
(Buku FictionBook2), asciidoc (AsciiDoc), icml (InDesign ICML), slidy (Slidy HTML
dan tampilan slide javascript), slideous (tampilan slide HTML dan javascript),
dzslides (DZSlides HTML5 + tampilan slide javascript), expressjs (reveal.js HTML5 +
tampilan slide javascript), s5 (S5 HTML dan tampilan slide javascript), atau jalur a
custom lua writer (lihat Custom writer, di bawah). Perhatikan bahwa odt, epub, dan epub3
output tidak akan diarahkan ke stdout; nama file keluaran harus ditentukan menggunakan
opsi -o/--output. Jika +lhs ditambahkan ke penurunan harga, pertama, lateks, beamer, html,
atau html5, outputnya akan dirender sebagai sumber Haskell yang melek huruf: lihat Melek
Dukungan Haskell, di bawah. Ekstensi sintaks penurunan harga dapat diaktifkan secara individual atau
dinonaktifkan dengan menambahkan +EXTENSION atau -EXTENSION ke nama format, seperti yang dijelaskan
di atas di bawah -f.
-o FILE, --keluaran=FILE
Tulis keluaran ke FILE alih-alih stdout. Jika FILE adalah -, output akan menuju ke stdout.
(Pengecualian: jika format output adalah odt, docx, epub, atau epub3, output ke stdout adalah
dengan disabilitas.)
--data-dir=DIREKTORI
Tentukan direktori data pengguna untuk mencari file data pandoc. Jika opsi ini adalah
tidak ditentukan, direktori data pengguna default akan digunakan. Ini, di Unix:
$HOME/.pandoc
di Windows XP:
C:\Dokumen dan Pengaturan\NAMA PENGGUNA\Data Aplikasi\pandoc
dan di Windows Vista atau yang lebih baru:
C:\Users\USERNAME\AppData\Roaming\pandoc
Anda dapat menemukan direktori data pengguna default di sistem Anda dengan melihat di
keluaran pandoc --version. Sebuah reference.odt, reference.docx, epub.css, templates,
direktori slidy, slideous, atau s5 yang ditempatkan di direktori ini akan menimpa pandoc's
default biasa.
--bash-selesai
Buat skrip penyelesaian bash. Untuk mengaktifkan penyelesaian bash dengan pandoc, tambahkan ini
ke .bashrc Anda:
eval "$(pandoc --bash-completion)"
--bertele-tele
Berikan keluaran debugging verbose. Saat ini ini hanya berpengaruh dengan output PDF.
-di, --Versi: kapan
Versi cetak.
-H, --membantu
Tampilkan pesan penggunaan.
Pembaca Pilihan
-R, --parse-mentah
Parsing kode HTML yang tidak dapat diterjemahkan dan lingkungan LaTeX sebagai HTML mentah atau LaTeX,
bukannya mengabaikan mereka. Hanya memengaruhi input HTML dan LaTeX. HTML mentah bisa
dicetak dalam Markdown, reStructuredText, HTML, Slidy, Slideous, DZSlides, mengungkapkan.js,
dan keluaran S5; LaTeX mentah dapat dicetak dalam Markdown, reStructuredText, LaTeX, dan
keluaran ConTeXt. Standarnya adalah agar pembaca menghilangkan kode HTML yang tidak dapat diterjemahkan
dan lingkungan LaTeX. (Pembaca LaTeX memang melewati LaTeX yang tidak dapat diterjemahkan
perintah, bahkan jika -R tidak ditentukan.)
-S, --pintar
Menghasilkan output yang benar secara tipografis, mengubah tanda kutip lurus menjadi tanda kutip keriting,
--- untuk em-dash, -- untuk en-dash, dan ... untuk elips. Ruang tanpa putus adalah
disisipkan setelah singkatan tertentu, seperti "Mr." (Catatan: Opsi ini dipilih
secara otomatis ketika format output lateks atau konteks, kecuali --no-tex-ligatures
digunakan. Ini tidak berpengaruh untuk input lateks.)
--garis-garis-lama
Memilih perilaku pandoc <= 1.8.2.1 untuk menguraikan tanda hubung cerdas: - sebelum angka
adalah en-dash, dan -- adalah em-dash. Opsi ini dipilih secara otomatis untuk
masukan tekstil.
--tingkat-tajuk-dasar=NOMOR
Tentukan tingkat dasar untuk header (default ke 1).
--indentasi-kode-kelas=KELAS
Tentukan kelas yang akan digunakan untuk blok kode indentasi--misalnya, perl,numberLines atau
haskell. Beberapa kelas dapat dipisahkan dengan spasi atau koma.
--default-gambar-ekstensi=EXTENSION
Tentukan ekstensi default untuk digunakan saat jalur/URL gambar tidak memiliki ekstensi. Ini
memungkinkan Anda menggunakan sumber yang sama untuk format yang memerlukan berbagai jenis
gambar-gambar. Saat ini opsi ini hanya memengaruhi pembaca Markdown dan LaTeX.
--filter=DAPAT DILAKSANAKAN
Tentukan executable untuk digunakan sebagai filter yang mengubah AST pandoc setelah
input diuraikan dan sebelum output ditulis. Eksekusi harus membaca JSON
dari stdin dan tulis JSON ke stdout. JSON harus diformat seperti milik pandoc
masukan dan keluaran JSON. Nama format output akan diteruskan ke filter
sebagai argumen pertama. Karena itu,
pandoc --filter ./caps.py -t lateks
adalah setara dengan
pandoc -t json | ./caps.py lateks | pandoc -f json -t lateks
Formulir terakhir mungkin berguna untuk men-debug filter.
Filter dapat ditulis dalam bahasa apa pun. Text.Pandoc.JSON mengekspor ke JSONFilter ke
memudahkan penulisan filter di Haskell. Mereka yang lebih suka menulis filter di
python dapat menggunakan modul pandocfilters, dapat diinstal dari PyPI. Ada juga
pustaka filter pandoc di PHP, Perl, dan javascript/node.js.
Perhatikan bahwa DAPAT DILAKSANAKAN akan dicari di PATH pengguna, dan bukan di tempat kerja
direktori, jika tidak ada direktori yang disediakan. Jika Anda ingin menjalankan skrip dalam pekerjaan
direktori, awali nama file dengan ./.
-M KUNCI[=VAL], --metadata=KUNCI[:VAL]
Setel bidang metadata KUNCI ke nilai VAL. Nilai yang ditentukan pada baris perintah
menimpa nilai yang ditentukan dalam dokumen. Nilai akan diuraikan sebagai YAML boolean
atau nilai string. Jika tidak ada nilai yang ditentukan, nilai akan diperlakukan sebagai Boolean
benar. Seperti --variable, --metadata menyebabkan variabel template disetel. Tapi tidak seperti
--variable, --metadata mempengaruhi metadata dari dokumen yang mendasarinya (yaitu
dapat diakses dari filter dan dapat dicetak dalam beberapa format keluaran).
--normalisasi
Normalisasikan dokumen setelah membaca: gabungkan elemen Str atau Emph yang berdekatan, untuk
contoh, dan hapus Spasi berulang.
-P, --melestarikan-tab
Pertahankan tab alih-alih mengonversinya menjadi spasi (default). Perhatikan bahwa ini
hanya akan memengaruhi tab dalam rentang kode literal dan blok kode; tab dalam teks biasa
akan diperlakukan sebagai spasi.
--tab-berhenti=NOMOR
Tentukan jumlah spasi per tab (default adalah 4).
--track-changes=terima|tolak|semua
Menentukan apa yang harus dilakukan dengan penyisipan dan penghapusan yang dihasilkan oleh "Track" MS Word
Perubahan". terima (default), masukkan semua sisipan, dan abaikan semua
penghapusan. menolak sisipan semua penghapusan dan mengabaikan sisipan. semua menempatkan di keduanya
penyisipan dan penghapusan, dibungkus dalam rentang dengan kelas penyisipan dan penghapusan,
masing-masing. Penulis dan waktu perubahan disertakan. semuanya bermanfaat untuk
scripting: hanya menerima perubahan dari resensi tertentu, katakanlah, atau sebelum tertentu
tanggal. Opsi ini hanya memengaruhi pembaca docx.
--ekstrak-media=DIR
Ekstrak gambar dan media lain yang terkandung dalam wadah docx atau epub ke jalur
DIR, buat jika perlu, dan sesuaikan referensi gambar dalam dokumen sehingga
mereka menunjuk ke file yang diekstraksi. Opsi ini hanya memengaruhi docx dan epub
pembaca.
Umum penulis Pilihan
-S, --mandiri
Menghasilkan output dengan header dan footer yang sesuai (misalnya HTML mandiri,
LaTeX, atau file RTF, bukan fragmen). Opsi ini diatur secara otomatis untuk pdf,
keluaran epub, epub3, fb2, docx, dan odt.
--templat=FILE
penggunaan FILE sebagai template kustom untuk dokumen yang dihasilkan. Menyiratkan --mandiri.
Lihat Template, di bawah, untuk deskripsi sintaks template. Jika tidak ada ekstensi adalah
ditentukan, ekstensi yang sesuai dengan penulis akan ditambahkan, sehingga
--template=pencarian khusus untuk special.html untuk keluaran HTML. Jika template tidak
ditemukan, pandoc akan mencarinya di subdirektori template dari data pengguna
direktori (lihat --data-dir). Jika opsi ini tidak digunakan, template default
sesuai untuk format output yang akan digunakan (lihat -D/--print-default-template).
-V KUNCI[=VAL], --variabel=KUNCI[:VAL]
Setel variabel template KUNCI ke nilai VAL saat merender dokumen di
modus mandiri. Ini umumnya hanya berguna ketika opsi --template digunakan
untuk menentukan templat khusus, karena pandoc secara otomatis menyetel variabel yang digunakan dalam
template default. Jika tidak VAL ditentukan, kuncinya akan diberi nilai
benar.
-D FORMAT, --cetak-default-template=FORMAT
Cetak template default sistem untuk output FORMAT. (Lihat -t untuk daftar
mungkin FORMATs.) Template di direktori data pengguna diabaikan.
--cetak-default-file-data=FILE
Cetak file data default sistem. File dalam direktori data pengguna diabaikan.
--dpi=NOMOR
Tentukan nilai dpi (titik per inci) untuk konversi dari piksel ke
inci/sentimeter dan sebaliknya. Standarnya adalah 96dpi. Secara teknis, yang benar
istilahnya adalah ppi (piksel per inci).
--wrap=[otomatis|tidak ada|pertahankan]
Tentukan bagaimana teks dibungkus dalam output (kode sumber, bukan yang dirender
Versi: kapan). Dengan auto (default), pandoc akan mencoba untuk membungkus baris ke kolom
lebar ditentukan oleh --columns (default 80). Dengan tidak ada, pandoc tidak akan membungkus garis
sama sekali. Dengan melestarikan, pandoc akan berusaha untuk melestarikan pembungkus dari
dokumen sumber (yaitu, di mana ada baris baru nonsemantik di sumbernya, di sana
akan menjadi baris baru nonsemantik dalam output juga).
--tanpa bungkus
Sinonim yang tidak digunakan lagi untuk --wrap=none.
--kolom=NOMOR
Tentukan panjang garis dalam karakter (untuk pembungkusan teks). Ini hanya mempengaruhi
kode sumber yang dihasilkan, bukan tata letak pada halaman yang dirender.
--tok, --Daftar isi
Sertakan daftar isi yang dibuat secara otomatis (atau, dalam kasus lateks,
konteks, dan pertama, instruksi untuk membuatnya) dalam dokumen keluaran. Ini
opsi tidak berpengaruh pada man, docbook, slidy, slideous, s5, docx, atau output odt.
--toc-kedalaman=NOMOR
Tentukan jumlah tingkat bagian yang akan disertakan dalam daftar isi. Itu
defaultnya adalah 3 (yang berarti header level 1, 2, dan 3 akan terdaftar di
isi).
--tidak ada sorotan
Menonaktifkan penyorotan sintaks untuk blok kode dan sebaris, bahkan ketika bahasa
atribut diberikan.
--sorot-gaya=STYLE
Menentukan gaya pewarnaan yang akan digunakan dalam kode sumber yang disorot. Pilihannya adalah
pygments (default), kate, monokrom, espresso, zenburn, haddock, dan tango.
Untuk informasi selengkapnya tentang penyorotan sintaks di pandoc, lihat Penyorotan sintaks,
di bawah.
-H FILE, --termasuk-dalam-header=FILE
Sertakan isi FILE, verbatim, di akhir header. Ini bisa digunakan,
misalnya, untuk memasukkan CSS atau javascript khusus dalam dokumen HTML. Pilihan ini
dapat digunakan berulang kali untuk memasukkan beberapa file di header. Mereka akan
termasuk dalam urutan yang ditentukan. Menyiratkan --mandiri.
-B FILE, --termasuk-sebelum-tubuh=FILE
Sertakan isi FILE, verbatim, di awal badan dokumen (mis
setelah tag dalam HTML, atau perintah \begin{document} di LaTeX). Ini bisa
digunakan untuk menyertakan bilah navigasi atau spanduk dalam dokumen HTML. Opsi ini dapat
digunakan berulang kali untuk memasukkan banyak file. Mereka akan dimasukkan dalam pesanan
ditentukan. Menyiratkan --mandiri.
-A FILE, --termasuk-setelah-tubuh=FILE
Sertakan isi FILE, verbatim, di akhir badan dokumen (sebelum
tag dalam HTML, atau perintah \end{document} di LaTeX). Opsi ini dapat
digunakan berulang kali untuk memasukkan banyak file. Mereka akan dimasukkan dalam pesanan
ditentukan. Menyiratkan --mandiri.
Opsi mempengaruhi tertentu penulis
--mandiri
Menghasilkan file HTML mandiri tanpa ketergantungan eksternal, menggunakan data: URI untuk
menggabungkan konten skrip yang ditautkan, lembar gaya, gambar, dan video. Itu
file yang dihasilkan harus "mandiri", dalam arti tidak memerlukan eksternal
file dan tidak ada akses bersih untuk ditampilkan dengan benar oleh browser. Opsi ini berfungsi
hanya dengan format keluaran HTML, termasuk html, html5, html+lhs, html5+lhs, s5,
slide, slideous, dzslides, dan mengungkapkan. Skrip, gambar, dan lembar gaya di
URL absolut akan diunduh; yang ada di URL relatif akan dicari relatif terhadap
direktori kerja (jika file sumber pertama adalah lokal) atau relatif terhadap basis
URL (jika file sumber pertama jarak jauh). Batasan: sumber daya yang dimuat
secara dinamis melalui JavaScript tidak dapat digabungkan; hasil dari,
--self-contained tidak bekerja dengan --mathjax, dan beberapa fitur lanjutan (mis
zoom atau catatan pembicara) mungkin tidak berfungsi dalam slide pengungkapan.js "mandiri" offline
acara.
--html-q-tag
Gunakan tag untuk kutipan dalam HTML.
--ascii
Gunakan hanya karakter ascii dalam output. Saat ini hanya didukung untuk keluaran HTML
(yang menggunakan entitas numerik alih-alih UTF-8 saat opsi ini dipilih).
--referensi-tautan
Gunakan tautan bergaya referensi, bukan tautan sebaris, dalam menulis Penurunan harga atau
reStructuredText. Secara default, tautan sebaris digunakan.
--atx-header
Gunakan header gaya ATX di Markdown dan output asciidoc. Standarnya adalah menggunakan
header gaya settext untuk level 1-2, dan kemudian header ATX.
--bab
Perlakukan header tingkat atas sebagai bab dalam keluaran LaTeX, ConTeXt, dan DocBook. Kapan
kelas dokumen LaTeX diatur ke laporan, buku, atau memoar, opsi ini tersirat.
Jika beamer adalah format output, header tingkat atas akan menjadi \part{..}.
-N, --nomor-bagian
Judul bagian nomor dalam keluaran LaTeX, ConTeXt, HTML, atau EPUB. Secara default,
bagian tidak diberi nomor. Bagian dengan kelas yang tidak diberi nomor tidak akan pernah diberi nomor,
bahkan jika --number-sections ditentukan.
--nomor-offset=NOMOR[,NOMOR,...]
Offset untuk judul bagian dalam keluaran HTML (diabaikan dalam format keluaran lainnya). Itu
nomor pertama ditambahkan ke nomor bagian untuk tajuk tingkat atas, yang kedua untuk
header tingkat kedua, dan seterusnya. Jadi, misalnya, jika Anda ingin level atas pertama
header di dokumen Anda untuk diberi nomor "6", tentukan --number-offset=5. Jika Anda
dokumen dimulai dengan header level-2 yang ingin Anda beri nomor "1.5", tentukan
--number-offset=1,4. Offset adalah 0 secara default. Menyiratkan --number-bagian.
--tidak ada-tex-ligatur
Jangan gunakan pengikat TeX untuk tanda kutip, apostrof, dan tanda hubung (`...',
``..'', --, ---) saat menulis atau membaca LaTeX atau ConTeXt. Dalam membaca LaTeX, parse
karakter `, ', dan - secara harfiah, daripada menguraikan ligatur untuk kutipan
tanda dan tanda hubung. Dalam penulisan LaTeX atau ConTeXt, cetak tanda kutip unicode dan
karakter tanda hubung secara harfiah, daripada mengonversinya ke ASCII TeX standar
ligatur. Catatan: biasanya --smart dipilih secara otomatis untuk LaTeX dan ConTeXt
output, tetapi harus ditentukan secara eksplisit jika --no-tex-ligatures dipilih. Jika
Anda menggunakan tanda kutip keriting literal, tanda hubung, dan elips di sumber Anda, maka Anda dapat
ingin menggunakan --no-tex-ligatures tanpa --smart.
--daftar
Gunakan paket listing untuk blok kode LaTeX
-Saya, --tambahan
Jadikan item daftar dalam tayangan slide ditampilkan secara bertahap (satu per satu). Standarnya adalah
agar daftar ditampilkan sekaligus.
--level-slide=NOMOR
Menentukan bahwa header dengan level yang ditentukan membuat slide (untuk beamer, s5,
slide, slideous, dzslides). Header di atas level ini dalam hierarki digunakan untuk
bagi tayangan slide menjadi beberapa bagian; tajuk di bawah level ini buat subjudul
dalam satu slide. Standarnya adalah mengatur level slide berdasarkan konten
dokumen; lihat Menyusun tampilan slide.
--bagian-divs
Bungkus bagian dalam tag (atau tag dalam HTML5), dan lampirkan pengidentifikasi ke
penutup (atau ) daripada header itu sendiri. Lihat Tajuk
pengenal, di bawah ini.
--email-obfuscation=none|javascript|referensi
Tentukan metode untuk mengaburkan tautan mailto: dalam dokumen HTML. tidak ada daun
mailto: tautan apa adanya. javascript mengaburkannya menggunakan javascript.
referensi mengaburkan mereka dengan mencetak huruf mereka sebagai desimal atau heksadesimal
referensi karakter. Standarnya adalah javascript.
--id-awalan=STRING
Tentukan awalan yang akan ditambahkan ke semua pengenal yang dibuat secara otomatis dalam HTML dan
Keluaran DocBook, dan ke nomor catatan kaki dalam keluaran penurunan harga. Ini berguna untuk
mencegah pengidentifikasi duplikat saat membuat fragmen untuk dimasukkan ke dalam . lainnya
halaman.
-T STRING, --judul-awalan=STRING
Menentukan STRING sebagai awalan di awal judul yang muncul di HTML
header (tetapi tidak dalam judul seperti yang muncul di awal badan HTML).
Menyiratkan --mandiri.
-c URL, --css=URL
Tautan ke lembar gaya CSS. Opsi ini dapat digunakan berulang kali untuk menyertakan
beberapa file. Mereka akan dimasukkan dalam urutan yang ditentukan.
--referensi-odt=FILE
Gunakan file yang ditentukan sebagai referensi gaya dalam menghasilkan ODT. Untuk hasil terbaik,
referensi ODT harus merupakan versi modifikasi dari ODT yang diproduksi menggunakan pandoc.
Isi referensi ODT diabaikan, tetapi stylesheet-nya digunakan dalam
ODT baru. Jika tidak ada referensi ODT yang ditentukan pada baris perintah, pandoc akan terlihat
untuk file reference.odt di direktori data pengguna (lihat --data-dir). Jika ini adalah
tidak ditemukan juga, default yang masuk akal akan digunakan.
--referensi-docx=FILE
Gunakan file yang ditentukan sebagai referensi gaya dalam menghasilkan file docx. Untuk yang terbaik
hasil, referensi docx harus menjadi versi modifikasi dari file docx yang dihasilkan
menggunakan pandoc. Isi dari referensi docx diabaikan, tetapi stylesheet-nya
dan properti dokumen (termasuk margin, ukuran halaman, header, dan footer) digunakan
di docx baru. Jika tidak ada referensi docx yang ditentukan pada baris perintah, pandoc
akan mencari file reference.docx di direktori data pengguna (lihat --data-dir).
Jika ini juga tidak ditemukan, default yang masuk akal akan digunakan. Gaya berikut
digunakan oleh pandoc: [paragraph] Normal, Body Text, First Paragraph, Compact, Title,
Subjudul, Penulis, Tanggal, Abstrak, Daftar Pustaka, Judul 1, Judul 2, Judul 3,
Judul 4, Judul 5, Judul 6, Teks Blok, Teks Catatan Kaki, Istilah Definisi,
Definisi, Keterangan, Keterangan Tabel, Keterangan Gambar, Gambar, Gambar Dengan Keterangan, TOC
Menuju; [karakter] Font Paragraf Default, Karakter Teks Tubuh, Karakter Verbatim,
Referensi Catatan Kaki, Hyperlink; [tabel] Tabel Normal.
--epub-stylesheet=FILE
Gunakan file CSS yang ditentukan untuk menata gaya EPUB. Jika tidak ada stylesheet yang ditentukan,
pandoc akan mencari file epub.css di direktori data pengguna (lihat --data-dir).
Jika tidak ditemukan di sana, default yang masuk akal akan digunakan.
--epub-sampul-gambar=FILE
Gunakan gambar yang ditentukan sebagai sampul EPUB. Direkomendasikan agar gambar menjadi
lebar dan tinggi kurang dari 1000px. Perhatikan bahwa dalam dokumen sumber penurunan harga, Anda
juga dapat menentukan gambar sampul dalam blok metadata YAML (lihat Metadata EPUB, di bawah).
--epub-metadata=FILE
Lihat di file XML yang ditentukan untuk metadata EPUB. File harus berisi:
serangkaian elemen Dublin Core. Sebagai contoh:
Creative Commons
es-AR
Secara default, pandoc akan menyertakan elemen metadata berikut: (dari
judul dokumen), (dari penulis dokumen), (dari
tanggal dokumen, yang harus dalam format ISO 8601), (dari bahasa lang
variabel, atau, jika tidak disetel, lokal), dan (sebuah
UUID yang dibuat secara acak). Semua ini dapat ditimpa oleh elemen dalam
berkas metadata.
Catatan: jika dokumen sumber adalah Markdown, blok metadata YAML dalam dokumen dapat
digunakan sebagai gantinya. Lihat di bawah di bawah Metadata EPUB.
--epub-sematkan-font=FILE
Sematkan font yang ditentukan di EPUB. Opsi ini dapat diulang untuk disematkan
beberapa font. Wildcard juga dapat digunakan: misalnya, DejaVuSans-*.ttf.
Namun, jika Anda menggunakan wildcard pada baris perintah, pastikan untuk menghindarinya atau menempatkan
seluruh nama file dalam tanda kutip tunggal, untuk mencegahnya ditafsirkan oleh
kerang. Untuk menggunakan font yang disematkan, Anda perlu menambahkan deklarasi seperti
berikut ke CSS Anda (lihat --epub-stylesheet):
@font-wajah {
keluarga font: DejaVuSans;
gaya font: normal;
font-berat: normal;
src:url("DejaVuSans-Regular.ttf");
}
@font-wajah {
keluarga font: DejaVuSans;
gaya font: normal;
font-weight: bold;
src:url("DejaVuSans-Bold.ttf");
}
@font-wajah {
keluarga font: DejaVuSans;
gaya font: miring;
font-berat: normal;
src:url("DejaVuSans-Oblique.ttf");
}
@font-wajah {
keluarga font: DejaVuSans;
gaya font: miring;
font-weight: bold;
src:url("DejaVuSans-BoldOblique.ttf");
}
body { font-family: "DejaVuSans"; }
--epub-bab-tingkat=NOMOR
Tentukan tingkat header untuk membagi EPUB menjadi file "bab" yang terpisah.
Standarnya adalah membagi menjadi beberapa bab di header level 1. Opsi ini hanya memengaruhi
komposisi internal EPUB, bukan seperti bab dan bagian
ditampilkan kepada pengguna. Beberapa pembaca mungkin lambat jika file bab terlalu besar,
jadi untuk dokumen besar dengan beberapa header level 1, orang mungkin ingin menggunakan bab
tingkat 2 atau 3.
--mesin-lateks=pdflatex|lualatex|xelatex
Gunakan mesin LaTeX yang ditentukan saat menghasilkan keluaran PDF. Standarnya adalah pdflatex.
Jika mesin tidak ada di PATH Anda, jalur lengkap mesin dapat ditentukan
sini.
--lateks-mesin-opt=STRING
Gunakan string yang diberikan sebagai argumen baris perintah ke mesin lateks. Jika digunakan
beberapa kali, argumen disediakan dengan spasi di antara mereka. Perhatikan bahwa tidak
periksa opsi duplikat selesai.
Kutipan render
--bibliografi=FILE
Setel bidang bibliografi di metadata dokumen ke FILE, mengesampingkan nilai apa pun
diatur dalam metadata, dan proses kutipan menggunakan pandoc-citeproc. (Ini
setara dengan --metadata bibliography=FILE --filter pandoc-citeproc.) If --natbib
atau --biblatex juga disediakan, pandoc-citeproc tidak digunakan, membuat ini setara
ke --metadata bibliography=FILE. Jika Anda memberikan argumen ini beberapa kali, masing-masing
FILE akan ditambahkan ke daftar pustaka.
--csl=FILE
Setel bidang csl di metadata dokumen ke FILE, mengesampingkan nilai apa pun yang ditetapkan dalam
metadata. (Ini sama dengan --metadata csl=FILE.) Opsi ini hanya
relevan dengan pandoc-citeproc.
--kutipan-singkatan=FILE
Setel bidang kutipan-singkatan di metadata dokumen ke FILE, menimpa
nilai apa pun yang ditetapkan dalam metadata. (Ini setara dengan
--metadata citation-abbreviations=FILE.) Opsi ini hanya relevan dengan
pandoc-citeproc.
--natbib
Gunakan natbib untuk kutipan dalam keluaran LaTeX. Opsi ini tidak untuk digunakan dengan
filter pandoc-citeproc atau dengan keluaran PDF. Hal ini dimaksudkan untuk digunakan dalam memproduksi a
File LaTeX yang dapat diproses dengan bibtex.
--biblateks
Gunakan biblatex untuk kutipan dalam keluaran LaTeX. Opsi ini tidak untuk digunakan dengan
filter pandoc-citeproc atau dengan keluaran PDF. Hal ini dimaksudkan untuk digunakan dalam memproduksi a
File LaTeX yang dapat diproses dengan bibtex atau biber.
Matematika render in HTML
-m [URL], --latexmathml[=URL]
Gunakan LaTeXMathML untuk menampilkan matematika TeX yang disematkan dalam output HTML. Itu URL harus menunjuk
ke skrip pemuatan LaTeXMathML.js. Jika sebuah URL tidak disediakan, tautan ke
LaTeXMathML.js di Beranda LaTeXMathML akan dimasukkan.
--matematika[=URL]
Konversi matematika TeX ke MathML (dalam docbook serta html dan html5). Dalam mandiri
keluaran html, javascript kecil (atau tautan ke skrip semacam itu jika a URL disediakan)
akan dimasukkan yang memungkinkan MathML untuk dilihat di beberapa browser.
--jsmath[=URL]
Gunakan jsMath untuk menampilkan matematika TeX yang disematkan dalam output HTML. Itu URL harus menunjuk ke
skrip pemuatan jsMath (mis. jsMath/easy/load.js); jika disediakan, itu akan ditautkan
ke dalam header dokumen HTML mandiri. Jika sebuah URL tidak disediakan, tidak ada tautan
ke skrip beban jsMath akan dimasukkan; maka terserah kepada penulis untuk menyediakan
tautan seperti itu di templat HTML.
--mathjax[=URL]
Gunakan MathJax untuk menampilkan matematika TeX yang disematkan dalam output HTML. Itu URL harus menunjuk ke
skrip pemuatan MathJax.js. Jika sebuah URL tidak disediakan, tautan ke CDN MathJax
akan dimasukkan.
--senang
Lampirkan matematika TeX di tag dalam keluaran HTML. Ini kemudian dapat diproses oleh
gladTeX untuk menghasilkan tautan ke gambar rumus-rumus yang diset.
--mimeteks[=URL]
Render matematika TeX menggunakan skrip CGI mimeTeX. Jika URL tidak ditentukan, itu adalah
diasumsikan bahwa skrip berada di /cgi-bin/mimetex.cgi.
--webtex[=URL]
Render rumus TeX menggunakan skrip eksternal yang mengonversi rumus TeX menjadi gambar.
Rumus akan digabungkan dengan URL yang disediakan. Jika URL tidak ditentukan,
Google Chart API akan digunakan.
--katex[=URL]
Gunakan KaTeX untuk menampilkan matematika TeX yang disematkan dalam output HTML. Itu URL harus menunjuk ke
katex.js memuat skrip. Jika sebuah URL tidak disediakan, tautan ke KaTeX CDN akan
dimasukkan.
--katex-stylesheet=URL
URL harus menunjuk ke stylesheet katex.css. Jika opsi ini tidak ditentukan,
link ke KaTeX CDN akan dimasukkan. Perhatikan bahwa opsi ini tidak menyiratkan
--kateks.
Opsi untuk pembungkus script
--dump-args
Cetak informasi tentang argumen baris perintah ke stdout, lalu keluar. Pilihan ini
dimaksudkan terutama untuk digunakan dalam skrip pembungkus. Baris pertama keluaran
berisi nama file keluaran yang ditentukan dengan opsi -o, atau - (untuk
stdout) jika tidak ada file keluaran yang ditentukan. Baris yang tersisa berisi
argumen baris perintah, satu per baris, dalam urutan kemunculannya. Ini tidak
sertakan opsi pandoc reguler dan argumennya, tetapi sertakan opsi apa pun
muncul setelah -- pemisah di akhir baris.
--abaikan-args
Abaikan argumen baris perintah (untuk digunakan dalam skrip pembungkus). Opsi pandoc biasa
tidak diabaikan. Dengan demikian, misalnya,
pandoc --abaikan-args -o foo.html -s foo.txt -- -e latin1
adalah setara dengan
pandoc -o foo.html -s
TEMPLATES
Ketika opsi -s/--standalone digunakan, pandoc menggunakan template untuk menambahkan header dan footer
bahan yang diperlukan untuk dokumen yang berdiri sendiri. Untuk melihat template default yaitu
digunakan, ketik saja
pandoc -D *FORMAT*
dimana FORMAT adalah nama format keluaran. Templat khusus dapat ditentukan menggunakan
opsi --template. Anda juga dapat mengganti template default sistem untuk yang diberikan
format output FORMAT dengan meletakkan file templates/default.*FORMAT* di data pengguna
direktori (lihat --data-dir, di atas). Pengecualian: Untuk keluaran odt, sesuaikan
default.opendocument template. Untuk keluaran pdf, sesuaikan template default.latex.
Template berisi: variabel, yang memungkinkan penyertaan informasi sewenang-wenang kapan saja
titik dalam file. Variabel dapat diatur dalam dokumen menggunakan blok metadata YAML.
Mereka juga dapat diatur pada baris perintah menggunakan opsi -V/--variable: variabel diatur dalam
cara ini menimpa bidang metadata dengan nama yang sama.
Variabel set by pandoc
Beberapa variabel diatur secara otomatis oleh pandoc. Ini agak bervariasi tergantung pada
format output, tetapi sertakan bidang metadata serta berikut ini:
judul, Pengarang, tanggal
memungkinkan identifikasi aspek dasar dokumen. Termasuk dalam metadata PDF
melalui LaTeX dan ConTeXt. Ini dapat diatur melalui blok judul pandoc, yang
memungkinkan banyak penulis, atau melalui blok metadata YAML:
---
penulis:
- Aristoteles
-Peter Abelard
...
subtitle
subtitle dokumen, termasuk dalam HTML, EPUB, LaTeX, ConTeXt, dan Word docx; membuat
di LaTeX hanya saat menggunakan kelas dokumen yang mendukung \subtitle, seperti beamer
atau seri KOMA-Script (scrartcl, scrreprt, scrbook).
abstrak
ringkasan dokumen, termasuk dalam LaTeX, ConTeXt, AsciiDoc, dan Word docx
kata kunci
daftar kata kunci yang akan disertakan dalam metadata HTML, PDF, dan AsciiDoc; mungkin
diulang seperti untuk penulis, di atas
header-termasuk
konten yang ditentukan oleh -H/--include-in-header (mungkin memiliki beberapa nilai)
toc nilai non-null jika --toc/--table-of-contents ditentukan
judul toc
judul daftar isi (hanya berfungsi dengan EPUB dan docx)
termasuk-sebelum
konten yang ditentukan oleh -B/--include-before-body (mungkin memiliki beberapa nilai)
termasuk-setelah
konten yang ditentukan oleh -A/--include-after-body (mungkin memiliki beberapa nilai)
tubuh badan dokumen
meta-json
Representasi JSON dari semua metadata dokumen
Bahasa variabel
lang mengidentifikasi bahasa utama dokumen, menggunakan kode menurut BCP 47
(misalnya en atau en-GB). Untuk beberapa format output, pandoc akan mengonversinya menjadi
format yang sesuai disimpan dalam variabel tambahan babel-lang, polyglossia-lang
(LaTeX) dan konteks-lang (ConTeXt).
Span dan div pandoc asli dengan atribut lang (nilai dalam BCP 47) dapat digunakan
untuk mengganti bahasa dalam rentang tersebut.
bahasa lain
daftar bahasa lain yang digunakan dalam dokumen dalam metadata YAML, menurut
BCP 47. Misalnya: bahasa lain: [en-GB, fr]. Ini dibuat secara otomatis
dari atribut lang di semua rentang dan div tetapi dapat diganti. Saat ini
hanya digunakan oleh LaTeX melalui babel-otherlang yang dihasilkan dan
variabel polyglossia-otherlangs. Penulis LaTeX mengeluarkan perintah polyglossia dalam
teks tetapi variabel babel-newcommands berisi pemetaan untuk mereka ke
babel yang sesuai.
dir arah dasar dokumen, baik rtl (kanan-ke-kiri) atau ltr
(kiri ke kanan).
Untuk dokumen dua arah, span dan div pandoc asli dengan atribut dir
(nilai rtl atau ltr) dapat digunakan untuk mengganti arah dasar di beberapa keluaran
format. Ini mungkin tidak selalu diperlukan jika penyaji akhir (mis
browser, saat membuat HTML) mendukung Algoritma Dua Arah Unicode.
Saat menggunakan LaTeX untuk dokumen dua arah, hanya mesin xelatex yang sepenuhnya
didukung (gunakan --latex-engine=xelatex).
Variabel untuk slide
Variabel tersedia untuk memproduksi tayangan slide dengan pandoc, termasuk semua pengungkapan.js
opsi konfigurasi.
slide-url
URL dasar untuk dokumen Slidy (default ke http://www.w3.org/Talks/Tools/Slidy2)
url-slide
URL dasar untuk dokumen Slideous (default ke slideous)
s5-url URL dasar untuk dokumen S5 (default ke s5/default)
mengungkapkanjs-url
URL dasar untuk dokumen mengungkapkan.js (default untuk mengungkapkan.js)
tema, tema warna, tema font, tema dalam, tema luar
tema untuk dokumen beamer LaTeX
navigasi
mengontrol simbol navigasi dalam dokumen beamer (defaultnya kosong tanpa navigasi
simbol; nilai valid lainnya adalah bingkai, vertikal, dan horizontal).
bagian-judul
mengaktifkan "halaman judul" untuk bagian baru dalam dokumen beamer (default = true).
Variabel untuk Getah
Variabel LaTeX digunakan saat membuat PDF.
ukuran kertas
ukuran kertas, misalnya letter, A4
ukuran huruf
ukuran font untuk teks isi (misalnya 10pt, 12pt)
kelas dokumen
kelas dokumen, misalnya artikel, laporan, buku, memoar
pilihan kelas
pilihan untuk kelas dokumen, misalnya oneside; dapat diulang untuk beberapa opsi
geometri
pilihan untuk paket geometri, misalnya margin=1in; dapat diulang untuk beberapa opsi
margin-kiri, margin-kanan, margin-atas, margin bawah
menetapkan margin, jika geometri tidak digunakan (jika tidak, geometri menimpanya)
peregangan garis
menyesuaikan spasi baris menggunakan paket setspace, misalnya 1.25, 1.5
keluarga font
paket font untuk digunakan dengan pdflatex: TeX Live menyertakan banyak opsi, didokumentasikan dalam
Katalog Font LaTeX. Standarnya adalah Latin Modern.
fontfamilyoptions
opsi untuk paket yang digunakan sebagai fontfamily: misalnya osf,sc dengan fontfamily disetel ke
mathpazo memberi Palatino figur gaya lama dan topi kecil yang sebenarnya; mungkin
diulang untuk beberapa pilihan
font utama, sanfont, satu huruf, font matematika, CJKmainfont
keluarga font untuk digunakan dengan xelatex atau lualatex: ambil nama font sistem apa pun,
menggunakan paket fontspec. Perhatikan bahwa jika CJKmainfont digunakan, paket xecjk
harus tersedia.
font utama, sansfontoption, monofontop, Mathfontoptions, Pilihan CJK
opsi untuk digunakan dengan mainfont, sansfont, monofont, mathfont, CJKmainfont di xelatex
dan lualatex. Izinkan untuk setiap pilihan yang tersedia melalui fontspec, seperti
Fitur OpenType Numbers=OldStyle,Numbers=Proporsional. Dapat diulang untuk
beberapa pilihan.
fontenc
memungkinkan pengkodean font ditentukan melalui paket fontenc (dengan pdflatex);
defaultnya adalah T1 (lihat panduan untuk pengkodean font LaTeX)
tautan warna
tambahkan warna ke teks tautan; diaktifkan secara otomatis jika ada linkcolor, citecolor,
urlcolor, atau toccolor disetel
warna tautan, warna kutip, warna url, warna-warni
warna untuk tautan internal, tautan kutipan, tautan eksternal, dan tautan dalam tabel
isi: menggunakan salah satu warna LaTeX yang telah ditentukan sebelumnya
link-sebagai-catatan
menyebabkan tautan dicetak sebagai catatan kaki
indentasi menggunakan pengaturan kelas dokumen untuk indentasi (template LaTeX default sebaliknya
menghilangkan lekukan dan menambahkan spasi antar paragraf)
subparagraf
menonaktifkan perilaku default template LaTeX yang mendefinisikan ulang (sub)paragraf sebagai
bagian, mengubah tampilan judul bersarang di beberapa kelas
Terima kasih menentukan isi catatan kaki ucapan terima kasih setelah judul dokumen.
toc sertakan daftar isi (juga dapat diatur menggunakan --toc/--table-of-contents)
kedalaman toc
tingkat bagian untuk dimasukkan dalam daftar isi
lo, banyak
termasuk daftar gambar, daftar tabel
bibliografi
bibliografi yang akan digunakan untuk menyelesaikan referensi
gaya biblio
gaya bibliografi, bila digunakan dengan --natbib dan --biblatex.
pilihan biblatex
daftar opsi untuk biblatex.
Variabel untuk Konteks
ukuran kertas
ukuran kertas, misalnya letter, A4, landscape (lihat ConTeXt Paper Setup); boleh diulang
untuk beberapa pilihan
tata ruang pilihan untuk margin halaman dan pengaturan teks (lihat ConTeXt Layout); boleh diulang
untuk beberapa pilihan
margin-kiri, margin-kanan, margin-atas, margin bawah
mengatur margin, jika tata letak tidak digunakan (jika tidak tata letak menimpa ini)
ukuran huruf
ukuran font untuk teks isi (misalnya 10pt, 12pt)
font utama, sanfont, satu huruf, font matematika
keluarga font: ambil nama font sistem apa pun (lihat ConTeXt Font Switching)
warna tautan, warna kontras
warna untuk tautan di luar dan di dalam halaman, misalnya merah, biru (lihat Warna Konteks)
gaya tautan
gaya tipografi untuk link, misalnya normal, bold, slanted, boldslanted, type, cap,
kecil
indentasi
mengontrol indentasi paragraf, misalnya yes,small,next (lihat Indentasi Konteks);
dapat diulang untuk beberapa opsi
ruang putih
spasi antar paragraf, misalnya tidak ada, kecil (menggunakan setupwhitespace)
ruang interline
mengatur spasi baris, misalnya 4ex (menggunakan setupinterlinespace); dapat diulang untuk
banyak pilihan
teks header, catatan kaki
teks untuk ditempatkan di header atau footer yang sedang berjalan (lihat Header dan Footer ConTeXt);
dapat diulang hingga empat kali untuk penempatan yang berbeda
penomoran halaman
gaya dan lokasi nomor halaman (menggunakan penomoran halaman penyiapan); dapat diulang untuk
banyak pilihan
toc sertakan daftar isi (juga dapat diatur menggunakan --toc/--table-of-contents)
lo, banyak
termasuk daftar gambar, daftar tabel
Variabel untuk pria halaman
bagian
nomor bagian di halaman manual
Header tajuk di halaman manual
footer footer di halaman manual
menyesuaikan
menyesuaikan teks ke kiri (l), kanan (r), tengah (c), atau keduanya (b) margin
yg ditulis dgn tanda penghubung
jika benar (default), tanda hubung akan digunakan
Menggunakan variabel in template
Nama variabel adalah urutan alfanumerik, -, dan _, dimulai dengan huruf. SEBUAH
nama variabel yang dikelilingi tanda $ akan diganti dengan nilainya. Misalnya,
string $judul$ dalam
$judul$
akan diganti dengan judul dokumen.
Untuk menulis $ literal dalam template, gunakan $$.
Template mungkin berisi conditional. Sintaksnya adalah sebagai berikut:
$jika(variabel)$
X
$lain$
Y
$endif$
Ini akan menyertakan X dalam templat jika variabel memiliki nilai bukan nol; jika tidak maka akan
sertakan Y. X dan Y adalah placeholder untuk teks template yang valid, dan dapat menyertakan
variabel interpolasi atau kondisional lainnya. Bagian $else$ dapat dihilangkan.
Ketika variabel dapat memiliki beberapa nilai (misalnya, penulis dalam dokumen multi-penulis),
Anda dapat menggunakan kata kunci $for$:
$untuk(penulis)$
$akhir$
Anda dapat secara opsional menentukan pemisah yang akan digunakan di antara item yang berurutan:
$untuk(penulis)$$penulis$$sep$, $endfor$
Titik dapat digunakan untuk memilih bidang variabel yang mengambil objek sebagai nilainya. Jadi,
misalnya:
$penulis.nama$ ($penulis.afiliasi$)
Jika Anda menggunakan template khusus, Anda mungkin perlu merevisinya sebagai perubahan pandoc. Kami merekomendasikan
melacak perubahan pada template default, dan memodifikasi template kustom Anda
demikian. Cara mudah untuk melakukannya adalah dengan fork repositori pandoc-templates dan menggabungkannya
dalam perubahan setelah setiap rilis pandoc.
PANDOC'S PENURUNAN HARGA
Pandoc memahami versi Markdown John Gruber yang diperpanjang dan sedikit direvisi
sintaksis. Dokumen ini menjelaskan sintaks, mencatat perbedaan dari penurunan harga standar.
Kecuali jika disebutkan, perbedaan ini dapat ditekan dengan menggunakan markdown_strict
format alih-alih penurunan harga. Ekstensi dapat diaktifkan dengan menambahkan +EXTENSION ke
nama format dan dinonaktifkan dengan menambahkan -EXTENSION. Misalnya, markdown_strict+footnotes adalah
Markdown ketat dengan catatan kaki diaktifkan, sedangkan markdown-footnotes-pipe_tables adalah milik pandoc
Penurunan harga tanpa catatan kaki atau tabel pipa.
filsafat
Penurunan harga dirancang agar mudah ditulis, dan yang lebih penting, mudah dibaca:
Dokumen berformat penurunan harga harus dapat diterbitkan apa adanya, sebagai teks biasa, tanpa
tampak seperti telah ditandai dengan tag atau instruksi pemformatan. -- John
Gruber
Prinsip ini telah memandu keputusan pandoc dalam menemukan sintaks untuk tabel, catatan kaki, dan
ekstensi lainnya.
Namun, ada satu hal di mana tujuan pandoc berbeda dari tujuan aslinya
dari penurunan harga. Sedangkan penurunan harga awalnya dirancang dengan generasi HTML dalam pikiran,
pandoc dirancang untuk beberapa format output. Jadi, sementara pandoc memungkinkan penyematan
HTML mentah, itu mencegahnya, dan menyediakan cara lain yang non-HTML untuk merepresentasikan
elemen dokumen penting seperti daftar definisi, tabel, matematika, dan catatan kaki.
Paragraf
Paragraf adalah satu atau lebih baris teks yang diikuti oleh satu atau lebih baris kosong. baris baru
diperlakukan sebagai spasi, sehingga Anda dapat mengatur ulang paragraf sesuka Anda. Jika Anda membutuhkan yang sulit
jeda baris, letakkan dua spasi atau lebih di akhir baris.
Perpanjangan: escape_line_breaks
Garis miring terbalik yang diikuti oleh baris baru juga merupakan pemutusan garis keras. Catatan: dalam multiline dan grid
sel tabel, ini adalah satu-satunya cara untuk membuat jeda garis keras, karena spasi di belakang
sel diabaikan.
Header
Ada dua jenis header: Setext dan ATX.
Gaya-teks header
Header bergaya settext adalah baris teks "digarisbawahi" dengan deretan tanda = (untuk level
satu tajuk) atau - tanda (untuk tajuk tingkat dua):
Header tingkat satu
==================
Header level dua
------------------
Teks header dapat berisi pemformatan sebaris, seperti penekanan (lihat Pemformatan sebaris,
bawah).
gaya ATX header
Header gaya ATX terdiri dari satu hingga enam tanda # dan sebaris teks, opsional diikuti
oleh sejumlah # tanda. Banyaknya tanda # di awal baris adalah
tingkat kepala:
## Header level dua
### Header level tiga ###
Seperti header gaya settext, teks header dapat berisi pemformatan:
# Header tingkat satu dengan [link](/url) dan *penekanan*
Perpanjangan: blank_before_header
Sintaks Markdown standar tidak memerlukan baris kosong sebelum header. Pandoc melakukannya
memerlukan ini (kecuali, tentu saja, di awal dokumen). Alasan untuk
persyaratannya adalah terlalu mudah untuk # berakhir di awal baris dengan
kecelakaan (mungkin melalui pembungkus garis). Pertimbangkan, misalnya:
Saya suka beberapa rasa es krim mereka:
#22, misalnya, dan #5.
Header pengidentifikasi
Perpanjangan: header_atribut
Header dapat diberi atribut menggunakan sintaks ini di akhir baris yang berisi
teks judul:
{#identifier .class .class kunci=nilai kunci=nilai}
Jadi, misalnya, semua header berikut akan diberi pengidentifikasi foo:
# Header saya {#foo}
## Header saya ## {#foo}
Header saya yang lain {#foo}
---------------
(Sintaks ini kompatibel dengan PHP Markdown Extra.)
Perhatikan bahwa meskipun sintaks ini memungkinkan penetapan kelas dan atribut kunci/nilai,
penulis umumnya tidak menggunakan semua informasi ini. Pengidentifikasi, kelas, dan kunci/nilai
atribut yang digunakan dalam HTML dan format berbasis HTML seperti EPUB dan slidy. pengenal
digunakan untuk label dan jangkar tautan di LaTeX, ConTeXt, Textile, dan penulis AsciiDoc.
Header dengan kelas yang tidak diberi nomor tidak akan diberi nomor, meskipun --number-sections adalah
ditentukan. Tanda hubung tunggal (-) dalam konteks atribut sama dengan .unnumbered, dan
lebih disukai dalam dokumen non-Inggris. Jadi,
# Tajuk saya {-}
sama saja dengan
# Header saya {.unnumbered}
Perpanjangan: pengenal_otomatis
Header tanpa pengidentifikasi yang ditentukan secara eksplisit akan secara otomatis ditetapkan sebagai
pengenal unik berdasarkan teks header. Untuk mendapatkan pengidentifikasi dari header
teks,
· Hapus semua pemformatan, tautan, dll.
· Hapus semua catatan kaki.
· Hapus semua tanda baca, kecuali garis bawah, tanda hubung, dan titik.
· Ganti semua spasi dan baris baru dengan tanda hubung.
· Ubah semua karakter alfabet menjadi huruf kecil.
· Hapus semuanya hingga huruf pertama (pengidentifikasi tidak boleh dimulai dengan angka atau
tanda baca).
· Jika tidak ada yang tersisa setelah ini, gunakan bagian pengenal.
Dengan demikian, misalnya,
Pengidentifikasi Tajuk
────────────────────────────────────────────────── ──────
Pengidentifikasi header dalam HTML header-identifier-in-html
*Anjing*?--di rumah *saya*? anjing--di-rumahku
[HTML], [S5], atau [RTF]? html-s5-atau-rtf
3. Aplikasi aplikasi
Bagian 33
Aturan-aturan ini harus, dalam banyak kasus, memungkinkan seseorang untuk menentukan pengidentifikasi dari header
teks. Pengecualian adalah ketika beberapa header memiliki teks yang sama; dalam hal ini, yang pertama
akan mendapatkan pengenal seperti yang dijelaskan di atas; yang kedua akan mendapatkan pengidentifikasi yang sama dengan -1
ditambahkan; yang ketiga dengan -2; dan seterusnya.
Pengidentifikasi ini digunakan untuk menyediakan target tautan dalam daftar isi yang dihasilkan oleh
opsi --toc|--daftar isi. Mereka juga memudahkan untuk menyediakan tautan dari satu
bagian dari dokumen ke yang lain. Tautan ke bagian ini, misalnya, mungkin terlihat seperti
ini:
Lihat bagian di
[pengidentifikasi header](#header-identifiers-in-html-lateks-dan-konteks).
Namun, perhatikan bahwa metode menyediakan tautan ke bagian ini hanya berfungsi di HTML, LaTeX,
dan format ConTeXt.
Jika opsi --section-divs ditentukan, maka setiap bagian akan dibungkus dalam div (atau
bagian, jika --html5 ditentukan), dan pengidentifikasi akan dilampirkan ke lampiran
(atau ) tag daripada header itu sendiri. Ini memungkinkan seluruh bagian menjadi
dimanipulasi menggunakan javascript atau diperlakukan berbeda dalam CSS.
Perpanjangan: implisit_header_references
Pandoc berperilaku seolah-olah tautan referensi telah ditentukan untuk setiap tajuk. Jadi, alih-alih
[pengidentifikasi header](#header-identifiers-in-html)
Anda cukup menulis
[pengidentifikasi tajuk]
or
[pengidentifikasi tajuk][]
or
[bagian tentang pengidentifikasi header][pengidentifikasi header]
Jika ada beberapa tajuk dengan teks yang identik, referensi yang sesuai akan ditautkan
ke yang pertama saja, dan Anda harus menggunakan tautan eksplisit untuk menautkan ke yang lain, karena
dijelaskan di atas.
Seperti tautan referensi biasa, referensi ini tidak peka huruf besar/kecil.
Definisi referensi tautan eksplisit selalu diprioritaskan daripada referensi header implisit.
Jadi, dalam contoh berikut, tautan akan mengarah ke bilah, bukan ke #foo:
#foo
[foo]: batang
Lihat [foo]
Memblokir kutipan
Penurunan harga menggunakan konvensi email untuk mengutip blok teks. Kutipan blok adalah satu atau
lebih banyak paragraf atau elemen blok lainnya (seperti daftar atau header), dengan setiap baris
didahului oleh > karakter dan spasi opsional. (> tidak perlu dimulai dari kiri
margin, tetapi tidak boleh menjorok lebih dari tiga spasi.)
> Ini adalah kutipan blok. Ini
> paragraf memiliki dua baris.
>
> 1. Ini adalah daftar di dalam kutipan blok.
> 2. Item kedua.
Bentuk "malas", yang membutuhkan karakter > hanya pada baris pertama setiap blok, adalah
juga diperbolehkan:
> Ini adalah kutipan blok. Ini
paragraf memiliki dua baris.
> 1. Ini adalah daftar di dalam kutipan blok.
2. Barang kedua.
Di antara elemen blok yang dapat dimuat dalam kutipan blok adalah kutipan blok lainnya.
Artinya, kutipan blok dapat disarangkan:
> Ini adalah kutipan blok.
>
> > Kutipan blok dalam kutipan blok.
Jika karakter > diikuti dengan spasi opsional, spasi tersebut akan dianggap sebagai bagian dari
penanda kutipan blok dan bukan bagian dari lekukan konten. Jadi, untuk menempatkan
blok kode indentasi dalam kutipan blok, Anda memerlukan lima spasi setelah >:
> kode
Perpanjangan: blank_before_blockquote
Sintaks penurunan harga standar tidak memerlukan baris kosong sebelum kutipan blok. Pandoc melakukannya
memerlukan ini (kecuali, tentu saja, di awal dokumen). Alasan untuk
persyaratannya adalah terlalu mudah bagi > untuk berakhir di awal baris dengan
kecelakaan (mungkin melalui pembungkus garis). Jadi, kecuali format markdown_strict digunakan,
berikut ini tidak menghasilkan kutipan blok bersarang di pandoc:
> Ini adalah kutipan blok.
>> Bersarang.
Kata demi kata (kode) blok
Bertakuk kode blok
Blok teks yang diindentasi empat spasi (atau satu tab) diperlakukan sebagai teks verbatim: yaitu,
karakter khusus tidak memicu pemformatan khusus, dan semua spasi dan jeda baris adalah
diawetkan. Sebagai contoh,
jika (a > 3) {
moveShip(5 * gravitasi, BAWAH);
}
Lekukan awal (empat spasi atau satu tab) tidak dianggap sebagai bagian dari verbatim
teks, dan dihapus dalam output.
Catatan: baris kosong dalam teks verbatim tidak perlu dimulai dengan empat spasi.
Berpagar kode blok
Perpanjangan: pagar_kode_blok
Selain blok kode indentasi standar, pandoc mendukung berpagar blok kode. Ini
dimulai dengan deretan tiga tilde atau lebih (~) dan diakhiri dengan deretan tilde yang harus berada di
setidaknya sepanjang baris awal. Segala sesuatu di antara baris-baris ini diperlakukan sebagai kode. Tidak
diperlukan indentasi:
~~~~~~~
jika (a > 3) {
moveShip(5 * gravitasi, BAWAH);
}
~~~~~~~
Seperti blok kode biasa, blok kode berpagar harus dipisahkan dari teks di sekitarnya dengan
baris kosong.
Jika kode itu sendiri berisi deretan tilde atau backtick, gunakan saja deretan tilde yang lebih panjang
atau backtick di awal dan akhir:
~~~~~~~~~~~~~~~~
~~~~~~~~~~
kode termasuk tildes
~~~~~~~~~~
~~~~~~~~~~~~~~~~
Perpanjangan: backtick_code_blocks
Sama seperti fenced_code_blocks, tetapi menggunakan backticks (`) alih-alih tildes (~).
Perpanjangan: pagar_kode_atribut
Opsional, Anda dapat melampirkan atribut ke blok kode berpagar atau backtick menggunakan sintaks ini:
~~~~ {#mycode .haskell .numberLines startFrom="100"}
pengurutan [] = []
qsort (x:xs) = qsort (filter (< x) xs) ++ [x] ++
qsort (filter (>= x) xs)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Di sini mycode adalah pengidentifikasi, haskell dan numberLines adalah kelas, dan startFrom adalah
atribut dengan nilai 100. Beberapa format output dapat menggunakan informasi ini untuk melakukan sintaks
menyoroti. Saat ini, satu-satunya format keluaran yang menggunakan informasi ini adalah HTML dan
Getah. Jika penyorotan didukung untuk format dan bahasa keluaran Anda, maka kodenya
blok di atas akan muncul disorot, dengan garis bernomor. (Untuk melihat bahasa mana yang
didukung, lakukan pandoc --version.) Jika tidak, blok kode di atas akan muncul sebagai berikut:
...
Formulir pintasan juga dapat digunakan untuk menentukan bahasa blok kode:
``` haskell
pengurutan [] = []
`` ``
Ini sama dengan:
``` {.haskell}
pengurutan [] = []
`` ``
Jika ekstensi fenced_code_attributes dinonaktifkan, tetapi input berisi atribut kelas
untuk codeblock, atribut first class akan dicetak setelah pagar pembuka sebagai
kata telanjang.
Untuk mencegah semua penyorotan, gunakan tanda --no-highlight. Untuk mengatur gaya penyorotan,
gunakan --highlight-style. Untuk informasi lebih lanjut tentang penyorotan, lihat Penyorotan sintaks,
di bawah.
baris blok
Perpanjangan: baris_blok
Blok garis adalah barisan garis yang diawali dengan garis vertikal (|) diikuti spasi.
Pembagian menjadi garis akan dipertahankan dalam output, seperti halnya spasi terdepan;
jika tidak, garis akan diformat sebagai penurunan harga. Ini berguna untuk ayat dan
alamat:
| Paket limerick tertawa secara anatomis
| Dalam ruang yang cukup ekonomis.
| Tapi yang bagus yang pernah saya lihat
| Jadi jarang bersih
| Dan yang bersih jarang yang lucu
| 200 Jalan Utama
| Berkeley, CA 94718
Garis dapat dibungkus dengan keras jika diperlukan, tetapi garis lanjutan harus dimulai dengan a
ruang.
| Yang Benar Yang Terhormat Yang Paling Mulia dan Benar Samuel L.
Polisi, Jr.
| 200 Jalan Utama
| Berkeley, CA 94718
Sintaks ini dipinjam dari reStructuredText.
daftar
Peluru daftar
Daftar peluru adalah daftar item daftar berpoin. Item daftar berpoin dimulai dengan poin
(*, +, atau -). Berikut adalah contoh sederhana:
* satu
* dua
* tiga
Ini akan menghasilkan daftar "ringkas". Jika Anda ingin daftar "longgar", di mana setiap item adalah
diformat sebagai paragraf, beri spasi di antara item:
* satu
* dua
* tiga
Peluru tidak perlu rata dengan margin kiri; mereka mungkin menjorok satu, dua, atau
tiga spasi. Peluru harus diikuti dengan spasi.
Item daftar terlihat paling baik jika baris berikutnya rata dengan baris pertama (setelah poin):
*ini yang pertama buat saya
Daftar barang.
* dan kedua saya.
Tetapi penurunan harga juga memungkinkan format "malas":
*ini yang pertama buat saya
Daftar barang.
* dan kedua saya.
empat spasi memerintah
Item daftar mungkin berisi beberapa paragraf dan konten tingkat blok lainnya. Namun,
paragraf berikutnya harus didahului dengan baris kosong dan menjorok empat spasi atau satu tab.
Daftar akan terlihat lebih baik jika paragraf pertama sejajar dengan yang lainnya:
* Paragraf pertama.
Lanjutan.
* Paragraf kedua. Dengan blok kode, yang harus diindentasi
delapan spasi:
{ kode }
Item daftar dapat mencakup daftar lain. Dalam hal ini baris kosong sebelumnya adalah opsional.
Daftar bersarang harus diindentasi empat spasi atau satu tab:
* buah-buahan
+ apel
- jas hujan
- merah enak
+ pir
+ buah persik
* Sayuran
+ brokoli
+ lobak
Seperti disebutkan di atas, Penurunan harga memungkinkan Anda untuk menulis item daftar "dengan malas", alih-alih membuat indentasi
garis lanjutan. Namun, jika ada beberapa paragraf atau blok lain dalam daftar
item, baris pertama masing-masing harus menjorok.
+ Daftar malas, malas
barang.
+ Satu lagi; ini terlihat
buruk tetapi sah.
Paragraf kedua detik
Daftar barang.
Catatan: Meskipun aturan empat spasi untuk paragraf lanjutan berasal dari pejabat
Panduan sintaks penurunan harga, implementasi referensi, Markdown.pl, tidak mengikutinya. Jadi
pandoc akan memberikan hasil yang berbeda dari Markdown.pl ketika penulis telah menjorok
paragraf lanjutan kurang dari empat spasi.
Panduan sintaks penurunan harga tidak eksplisit apakah aturan empat spasi berlaku untuk semua
konten tingkat blok dalam item daftar; itu hanya menyebutkan paragraf dan blok kode. Tetapi
menyiratkan bahwa aturan berlaku untuk semua konten tingkat blok (termasuk daftar bersarang), dan
pandoc mengartikannya seperti itu.
Memerintahkan daftar
Daftar berurutan berfungsi seperti daftar berpoin, kecuali bahwa item dimulai dengan enumerator
ketimbang peluru.
Dalam Markdown standar, pencacah adalah angka desimal yang diikuti oleh titik dan spasi.
Angka-angka itu sendiri diabaikan, jadi tidak ada perbedaan antara daftar ini:
1. satu
2. dua
3. tiga
dan yang satu ini:
5. satu
7. dua
1. tiga
Perpanjangan: daftar_fancy
Tidak seperti penurunan harga standar, pandoc memungkinkan item daftar yang dipesan ditandai dengan huruf besar dan
huruf kecil dan angka romawi, selain angka arab. Daftar penanda mungkin
diapit dalam tanda kurung atau diikuti oleh tanda kurung siku tunggal atau titik. Mereka pasti
dipisahkan dari teks yang mengikuti setidaknya satu spasi, dan, jika penanda daftar adalah a
huruf kapital dengan titik, paling sedikit dua spasi.
Ekstensi fancy_lists juga memungkinkan '#' untuk digunakan sebagai penanda daftar berurutan sebagai pengganti
sebuah angka:
#. satu
#. dua
Perpanjangan: nomor awal
Pandoc juga memperhatikan jenis penanda daftar yang digunakan, dan nomor awal,
dan keduanya dipertahankan jika memungkinkan dalam format output. Jadi, berikut
menghasilkan daftar dengan angka yang diikuti oleh tanda kurung tunggal, dimulai dengan 9, dan a
sublist dengan angka romawi huruf kecil:
9) Kesembilan
10) Kesepuluh
11) Kesebelas
Saya. bawahan
ii. subdua
aku aku aku. subtiga
Pandoc akan memulai daftar baru setiap kali jenis penanda daftar yang berbeda digunakan. Sehingga
berikut akan membuat tiga daftar:
(2) Dua
(5) Tiga
1. Empat
* Lima
Jika penanda daftar default diinginkan, gunakan #.:
#. satu
#. dua
#. tiga
Definisi daftar
Perpanjangan: definisi_daftar
Pandoc mendukung daftar definisi, menggunakan sintaks PHP Markdown Extra dengan beberapa
ekstensi.
istilah 1
: Definisi 1
Term 2 dengan *markup sebaris*
: Definisi 2
{ beberapa kode, bagian dari Definisi 2 }
Paragraf ketiga dari definisi 2.
Setiap istilah harus sesuai dengan satu baris, yang secara opsional dapat diikuti oleh baris kosong, dan harus
diikuti oleh satu atau lebih definisi. Definisi dimulai dengan titik dua atau tilde, yang
dapat menjorok satu atau dua spasi.
Sebuah istilah mungkin memiliki beberapa definisi, dan setiap definisi dapat terdiri dari satu atau lebih blok
elemen (paragraf, blok kode, daftar, dll.), masing-masing menjorok empat spasi atau satu perhentian tab.
Badan definisi (termasuk baris pertama, selain dari titik dua atau tilde)
harus menjorok empat spasi. Namun, seperti daftar penurunan harga lainnya, Anda dapat "malas"
menghilangkan lekukan kecuali di awal paragraf atau elemen blok lainnya:
istilah 1
: Definisi
dengan kelanjutan yang malas.
Paragraf kedua dari definisi.
Jika Anda meninggalkan spasi sebelum definisi (seperti pada contoh di atas), teks dari
definisi akan diperlakukan sebagai paragraf. Dalam beberapa format output, ini berarti lebih besar
jarak antara pasangan istilah/definisi. Untuk daftar definisi yang lebih ringkas, hilangkan spasi
sebelum definisi:
istilah 1
~ Definisi 1
istilah 2
~ Definisi 2a
~ Definisi 2b
Perhatikan bahwa spasi di antara item dalam daftar definisi diperlukan. (Varian yang mengendur
persyaratan ini, tetapi melarang pembungkusan keras "malas", dapat diaktifkan dengan
compact_definition_lists: lihat Ekstensi non-pandoc, di bawah.)
Bernomor contoh daftar
Perpanjangan: contoh_daftar
Penanda daftar khusus @ dapat digunakan untuk contoh bernomor urut. Daftar pertama
item dengan penanda @ akan diberi nomor '1', berikutnya '2', dan seterusnya, sepanjang
dokumen. Contoh bernomor tidak perlu muncul dalam satu daftar; setiap daftar baru menggunakan @
akan mengambil tempat yang terakhir berhenti. Jadi, misalnya:
(@) Contoh pertama saya akan diberi nomor (1).
(@) Contoh kedua saya akan diberi nomor (2).
Penjelasan contoh.
(@) Contoh ketiga saya akan diberi nomor (3).
Contoh bernomor dapat diberi label dan dirujuk di tempat lain dalam dokumen:
(@baik) Ini adalah contoh yang baik.
Seperti yang diilustrasikan (@good), ...
Label dapat berupa string karakter alfanumerik, garis bawah, atau tanda hubung apa pun.
Padat dan longgar daftar
Pandoc berperilaku berbeda dari Markdown.pl pada beberapa "kasus tepi" yang melibatkan daftar.
Pertimbangkan sumber ini:
+ Pertama
+ Kedua:
- Biaya
- Fi
- Musuh
+ Ketiga
Pandoc mengubah ini menjadi "daftar ringkas" (tanpa tag di sekitar "Pertama", "Kedua",
atau "Ketiga"), sementara Markdown menempatkan tag di sekitar "Kedua" dan "Ketiga" (tetapi bukan "Pertama"),
karena ruang kosong di sekitar "Ketiga". Pandoc mengikuti aturan sederhana: jika teksnya
diikuti oleh baris kosong, itu diperlakukan sebagai paragraf. Karena "Kedua" diikuti oleh
list, dan bukan baris kosong, itu tidak diperlakukan sebagai paragraf. Fakta bahwa daftarnya adalah
diikuti oleh baris kosong tidak relevan. (Catatan: Pandoc bekerja dengan cara ini bahkan ketika
format markdown_strict ditentukan. Perilaku ini sesuai dengan pejabat
Deskripsi sintaks penurunan harga, meskipun berbeda dari penurunan harga.pl.)
Akhir a daftar
Bagaimana jika Anda ingin meletakkan blok kode indentasi setelah daftar?
- item satu
- item dua
{ blok kode saya }
Masalah! Di sini pandoc (seperti implementasi penurunan harga lainnya) akan memperlakukan { blok kode saya } sebagai
paragraf kedua dari item dua, dan bukan sebagai blok kode.
Untuk "memotong" daftar setelah item dua, Anda dapat menyisipkan beberapa konten non-indentasi, seperti
Komentar HTML, yang tidak akan menghasilkan keluaran yang terlihat dalam format apa pun:
- item satu
- item dua
{ blok kode saya }
Anda dapat menggunakan trik yang sama jika Anda menginginkan dua daftar berurutan alih-alih satu daftar besar:
1. satu
2. dua
3. tiga
1. satu
2. lakukan
3. pohon
Horisontal aturan
Baris yang berisi deretan tiga atau lebih karakter *, -, atau _ (opsional dipisahkan oleh
spasi) menghasilkan aturan horizontal:
* * * *
---------------
Meja
Empat jenis tabel dapat digunakan. Tiga jenis pertama mengandaikan penggunaan a
font lebar tetap, seperti Courier. Jenis keempat dapat digunakan dengan spasi proporsional
font, karena tidak memerlukan barisan kolom.
Perpanjangan: tabel_captions
Keterangan opsional dapat diberikan dengan semua 4 jenis tabel (seperti yang diilustrasikan dalam
contoh di bawah). Caption adalah paragraf yang diawali dengan string Table: (atau just :),
yang akan dicopot. Itu mungkin muncul sebelum atau sesudah tabel.
Perpanjangan: tabel_sederhana
Tabel sederhana terlihat seperti ini:
Kanan Kiri Tengah Default
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
Tabel: Demonstrasi sintaks tabel sederhana.
Judul dan baris tabel masing-masing harus muat dalam satu baris. Penjajaran kolom ditentukan oleh
posisi teks header relatif terhadap garis putus-putus di bawahnya:
· Jika garis putus-putus sejajar dengan teks header di sisi kanan tetapi melampauinya
di sebelah kiri, kolom rata kanan.
· Jika garis putus-putus sejajar dengan teks header di sisi kiri tetapi melampauinya
di sebelah kanan, kolom rata kiri.
· Jika garis putus-putus melampaui teks header di kedua sisi, kolom berada di tengah.
· Jika garis putus-putus rata dengan teks header di kedua sisi, perataan defaultnya adalah
digunakan (dalam banyak kasus, ini akan dibiarkan).
Tabel harus diakhiri dengan garis kosong, atau garis putus-putus diikuti oleh garis kosong.
Header kolom dapat dihilangkan, asalkan garis putus-putus digunakan untuk mengakhiri tabel. Untuk
contoh:
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
------- ------ ---------- -------
Ketika tajuk dihilangkan, perataan kolom ditentukan berdasarkan baris pertama
dari badan meja. Jadi, pada tabel di atas, kolomnya adalah kanan, kiri, tengah, dan
rata kanan, masing-masing.
Perpanjangan: multiline_tabel
Tabel multibaris memungkinkan header dan baris tabel menjangkau beberapa baris teks (tetapi sel
yang menjangkau beberapa kolom atau baris tabel tidak didukung). Berikut ini contohnya:
-------------------------------------------------- -----------
Tengah Default Kanan Kiri
Header Rata Rata
----------- ------- --------------- ----------------- --------
Baris pertama 12.0 Contoh baris yang
mencakup beberapa baris.
Baris kedua 5.0 Ini satu lagi. Catatan
garis kosong antara
baris.
-------------------------------------------------- -----------
Tabel: Berikut keterangannya. Itu juga bisa menjangkau
beberapa baris.
Ini berfungsi seperti tabel sederhana, tetapi dengan perbedaan berikut:
· Mereka harus dimulai dengan deretan tanda hubung, sebelum teks header (kecuali headernya
dihilangkan).
· Mereka harus diakhiri dengan sederet tanda hubung, lalu satu baris kosong.
· Baris harus dipisahkan dengan baris kosong.
Dalam tabel multiline, pengurai tabel memperhatikan lebar kolom, dan
penulis mencoba mereproduksi lebar relatif ini dalam output. Jadi, jika Anda menemukan salah satunya
kolom terlalu sempit di output, coba lebarkan di sumber penurunan harga.
Header dapat dihilangkan dalam tabel multiline serta tabel sederhana:
----------- ------- --------------- ----------------- --------
Baris pertama 12.0 Contoh baris yang
mencakup beberapa baris.
Baris kedua 5.0 Ini satu lagi. Catatan
garis kosong antara
baris.
----------- ------- --------------- ----------------- --------
: Berikut tabel multiline tanpa header.
Dimungkinkan untuk tabel multiline hanya memiliki satu baris, tetapi baris tersebut harus diikuti
dengan baris kosong (dan kemudian baris tanda hubung yang mengakhiri tabel), atau tabel mungkin
diartikan sebagai tabel sederhana.
Perpanjangan: tabel_grid
Tabel kisi terlihat seperti ini:
: Contoh tabel kisi.
+---------------+---------------+----------------- ---+
| Buah | Harga | Keuntungan |
+====================================================== ===+
| pisang | $1.34 | - pembungkus bawaan |
| | | - warna cerah |
+---------------+---------------+----------------- ---+
| Jeruk | $2.10 | - menyembuhkan penyakit kudis |
| | | - enak |
+---------------+---------------+----------------- ---+
Baris =s memisahkan header dari badan tabel, dan dapat dihilangkan untuk a
meja tanpa header. Sel-sel tabel kisi mungkin berisi elemen blok arbitrer (beberapa
paragraf, blok kode, daftar, dll.). Perataan tidak didukung, begitu pula sel yang
rentang beberapa kolom atau baris. Tabel kisi dapat dibuat dengan mudah menggunakan mode tabel Emacs.
Perpanjangan: pipa_tabel
Tabel pipa terlihat seperti ini:
| Benar | Kiri | Bawaan | Pusat |
|------:|:-----|--------|:------:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |
: Demonstrasi sintaks tabel pipa.
Sintaksnya identik dengan tabel PHP Markdown Extra. Pipa awal dan akhir
karakter adalah opsional, tetapi pipa diperlukan di antara semua kolom. Tanda titik dua menunjukkan
penjajaran kolom seperti yang ditunjukkan. Header tidak dapat dihilangkan. Untuk mensimulasikan tabel tanpa header,
sertakan header dengan sel kosong.
Karena pipa menunjukkan batas kolom, kolom tidak perlu disejajarkan secara vertikal, karena
mereka dalam contoh di atas. Jadi, ini adalah tabel pipa yang legal (meskipun jelek):
buah| harga
-----|-----:
apel|2.05
pir|1.37
oranye|3.09
Sel-sel tabel pipa tidak boleh berisi elemen blok seperti paragraf dan daftar, dan
tidak dapat menjangkau banyak baris. Jika tabel pipa berisi baris yang konten yang dapat dicetak adalah
lebih lebar dari lebar kolom (lihat --columns), maka isi sel akan dibungkus, dengan
lebar sel relatif ditentukan oleh lebar garis pemisah.
Catatan: pandoc juga mengenali tabel pipa dengan bentuk berikut, seperti yang dapat dihasilkan oleh
orgtbl-mode Emacs:
| satu | Dua |
|-----+-------|
| saya | meja |
| adalah | bagus |
Perbedaannya adalah bahwa + digunakan sebagai ganti |. Fitur orgtbl lainnya tidak didukung.
Secara khusus, untuk mendapatkan perataan kolom non-default, Anda harus menambahkan titik dua seperti di atas.
Metadata blok
Perpanjangan: pandoc_title_block
Jika file dimulai dengan blok judul
% judul
% pengarang (dipisahkan dengan titik koma)
% tanggal
itu akan diuraikan sebagai informasi bibliografi, bukan teks biasa. (Ini akan digunakan, untuk
misalnya, dalam judul LaTeX mandiri atau keluaran HTML.) Blok mungkin hanya berisi a
judul, judul dan penulis, atau ketiga elemen. Jika Anda ingin memasukkan seorang penulis tetapi
tanpa judul, atau judul dan tanggal tetapi tanpa penulis, Anda memerlukan baris kosong:
%
% Pengarang
% Judul saya
%
% 15 Juni 2006
Judul boleh menempati beberapa baris, tetapi baris lanjutan harus diawali dengan spasi,
demikian:
% Judul saya
pada banyak baris
Jika sebuah dokumen memiliki banyak penulis, penulis dapat ditempatkan pada baris terpisah dengan awalan
spasi, atau dipisahkan dengan titik koma, atau keduanya. Jadi, semua yang berikut ini setara:
% Penulis Satu
Penulis Dua
% Penulis Satu; Penulis Dua
% Penulis Satu;
Penulis Dua
Tanggal harus sesuai dengan satu baris.
Ketiga bidang metadata dapat berisi pemformatan sebaris standar (miring, tautan,
catatan kaki, dll).
Blok judul akan selalu diurai, tetapi akan memengaruhi output hanya ketika
--standalone (-s) opsi dipilih. Dalam output HTML, judul akan muncul dua kali: sekali di
kepala dokumen -- ini adalah judul yang akan muncul di bagian atas jendela di browser
-- dan sekali di awal badan dokumen. Judul di kepala dokumen bisa
memiliki awalan opsional yang dilampirkan (--title-prefix atau opsi -T). Judul dalam tubuh
muncul sebagai elemen H1 dengan kelas "judul", sehingga dapat ditekan atau diformat ulang dengan
CSS. Jika awalan judul ditentukan dengan -T dan tidak ada blok judul yang muncul di dokumen,
awalan judul akan digunakan dengan sendirinya sebagai judul HTML.
Penulis halaman manual mengekstrak judul, nomor bagian halaman manual, dan header dan footer lainnya
informasi dari baris judul. Judul diasumsikan menjadi kata pertama pada judul
baris, yang secara opsional dapat diakhiri dengan nomor bagian (satu digit) dalam tanda kurung.
(Seharusnya tidak ada spasi antara judul dan tanda kurung.) Apa pun setelah ini adalah
diasumsikan sebagai teks footer dan header tambahan. Karakter pipa tunggal (|) harus
digunakan untuk memisahkan teks footer dari teks header. Jadi,
% PANDOK(1)
akan menghasilkan halaman manual dengan judul PANDOC dan bagian 1.
% PANDOK(1) Panduan Pengguna Pandoc
juga akan memiliki "Pandoc User Manuals" di footer.
% PANDOK(1) Panduan Pengguna Pandoc | Versi 4.0
juga akan memiliki "Versi 4.0" di header.
Perpanjangan: yaml_metadata_block
Blok metadata YAML adalah objek YAML yang valid, dibatasi oleh garis tiga tanda hubung (---)
di bagian atas dan garis tiga tanda hubung (---) atau tiga titik (...) di bagian bawah. YAML
blok metadata dapat terjadi di mana saja dalam dokumen, tetapi jika tidak di awal, itu
harus didahului dengan baris kosong. (Perhatikan bahwa, karena cara pandoc menggabungkan
masukan file ketika beberapa disediakan, Anda juga dapat menyimpan metadata dalam YAML yang terpisah
file dan berikan ke pandoc sebagai argumen, bersama dengan file penurunan harga Anda:
pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o buku.html
Pastikan file YAML dimulai dengan --- dan diakhiri dengan --- atau ....)
Metadata akan diambil dari bidang objek YAML dan ditambahkan ke yang sudah ada
metadata dokumen. Metadata dapat berisi daftar dan objek (bersarang secara sewenang-wenang), tetapi semuanya
skalar string akan ditafsirkan sebagai Penurunan harga. Bidang dengan nama yang diakhiri dengan garis bawah
akan diabaikan oleh pandoc. (Mereka mungkin diberi peran oleh prosesor eksternal.)
Sebuah dokumen mungkin berisi beberapa blok metadata. Bidang metadata akan digabungkan
melalui bias kiri serikat: jika dua blok metadata mencoba menyetel bidang yang sama,
nilai dari blok pertama akan diambil.
Ketika pandoc digunakan dengan -t penurunan harga untuk membuat dokumen Penurunan harga, blok metadata YAML
akan diproduksi hanya jika opsi -s/--standalone digunakan. Semua metadata akan
muncul dalam satu blok di awal dokumen.
Perhatikan bahwa aturan pelolosan YAML harus diikuti. Jadi, misalnya, jika sebuah judul mengandung
titik dua, itu harus dikutip. Karakter pipa (|) dapat digunakan untuk memulai blok indentasi
yang akan ditafsirkan secara harfiah, tanpa perlu melarikan diri. Formulir ini diperlukan
ketika bidang berisi baris kosong:
---
judul: 'Ini adalah judul: mengandung titik dua'
penulis:
- nama: Penulis Satu
afiliasi: University of Somewhere
- nama: Penulis Dua
afiliasi: University of Nowhere
tags: [tidak ada, tidak ada]
abstrak: |
Ini abstraknya.
Terdiri dari dua paragraf.
...
Variabel template akan diatur secara otomatis dari metadata. Jadi, misalnya, dalam
menulis HTML, variabel abstrak akan disetel ke HTML yang setara dengan Penurunan Harga di
bidang abstrak:
Ini abstraknya.
Terdiri dari dua paragraf.
Catatan: Variabel penulis dalam template default mengharapkan daftar atau string sederhana. Ke
gunakan penulis terstruktur dalam contoh, Anda akan memerlukan templat khusus. Sebagai contoh:
$untuk(penulis)$
$jika(nama penulis)$
$penulis.nama$$if(penulis.afiliasi)$ ($penulis.afiliasi$)$endif$
$lain$
$penulis$
$endif$
$akhir$
Backslash lolos
Perpanjangan: all_symbols_escapable
Kecuali di dalam blok kode atau kode sebaris, tanda baca atau karakter spasi apa pun yang didahului oleh
garis miring terbalik akan diperlakukan secara harfiah, bahkan jika itu biasanya menunjukkan pemformatan.
Jadi, misalnya, jika seseorang menulis
*\*Halo\**
seseorang akan mendapatkan
*Halo*
alih-alih
Halo
Aturan ini lebih mudah diingat daripada aturan penurunan harga standar, yang hanya mengizinkan
karakter berikut untuk menghindari garis miring terbalik:
\`*_{}[]()>#+-.!
(Namun, jika format markdown_strict digunakan, aturan Markdown standar akan digunakan.)
Ruang dengan garis miring terbalik diuraikan sebagai ruang yang tidak terputus. Ini akan muncul di keluaran TeX
sebagai ~ dan dalam HTML dan XML sebagai \ atau \ .
Baris baru yang lolos dari garis miring terbalik (yaitu garis miring terbalik yang terjadi di akhir baris) diuraikan
sebagai istirahat garis keras. Ini akan muncul dalam keluaran TeX sebagai \\ dan dalam HTML sebagai . Ini
alternatif yang bagus untuk cara "tak terlihat" Markdown untuk menunjukkan jeda garis keras menggunakan dua
spasi tambahan pada garis.
Pelarian garis miring terbalik tidak berfungsi dalam konteks kata demi kata.
Cerdas tanda baca
Perpanjangan
Jika opsi --smart ditentukan, pandoc akan menghasilkan output yang benar secara tipografis,
mengonversi tanda kutip lurus menjadi tanda kutip keriting, --- menjadi tanda hubung, -- menjadi tanda hubung, dan ... menjadi
elips. Spasi nonbreaking disisipkan setelah singkatan tertentu, seperti "Mr."
Catatan: jika template LaTeX Anda atau file header yang disertakan memanggil paket csquotes,
pandoc akan mendeteksi ini secara otomatis dan menggunakan \enquote{...} untuk teks kutipan.
Di barisan format
Tekanan
Untuk menekankan beberapa teks, mengelilinginya dengan *s atau _, seperti ini:
Teks ini _ditekankan dengan garis bawah_, dan ini
adalah *ditekankan dengan tanda bintang*.
Ganda * atau _ menghasilkan kuat tekanan:
Ini adalah **penekanan kuat** dan __dengan garis bawah__.
Karakter * atau _ yang dikelilingi spasi, atau karakter dengan garis miring terbalik, tidak akan memicu penekanan:
Ini * tidak ditekankan *, dan \*bukan ini\*.
Perpanjangan: intraword_garis bawah
Karena _ terkadang digunakan di dalam kata dan pengenal, pandoc tidak menafsirkan _
dikelilingi oleh karakter alfanumerik sebagai penanda penekanan. Jika Anda ingin menekankan
hanya bagian dari sebuah kata, gunakan *:
layak*bisa*, bukan bisa*bisa*.
Menyerang
Perpanjangan: menyerang
Untuk mencoret bagian teks dengan garis horizontal, awali dan akhiri dengan ~~. Jadi,
sebagai contoh,
Ini ~~adalah teks yang dihapus.~~
Superskrip dan langganan
Perpanjangan: superskrip, subskrip
Superskrip dapat ditulis dengan mengapit teks superskrip dengan karakter ^;
subskrip dapat ditulis dengan mengapit teks bersubskrip dengan ~ karakter. Jadi, untuk
contoh,
H~2~O adalah cairan. 2^10^ adalah 1024.
Jika teks superskrip atau subskrip mengandung spasi, spasi ini harus diloloskan
dengan garis miring terbalik. (Ini untuk mencegah superskrip dan berlangganan yang tidak disengaja melalui
penggunaan biasa ~ dan ^.) Jadi, jika Anda ingin huruf P dengan 'kucing' di subskrip,
gunakan P~a\ cat~, bukan P~a cat~.
Kata demi kata
Untuk membuat rentang teks pendek kata demi kata, letakkan di dalam tanda centang belakang:
Apa perbedaan antara `>>=` dan `>>`?
Jika teks verbatim menyertakan backtick, gunakan backtick ganda:
Berikut adalah backtick literal `` ` ``.
(Spasi setelah backtick pembuka dan sebelum backtick penutup akan diabaikan.)
Aturan umumnya adalah bahwa rentang kata demi kata dimulai dengan string backticks berturut-turut
(opsional diikuti dengan spasi) dan diakhiri dengan string dengan jumlah backtick yang sama
(opsional didahului dengan spasi).
Perhatikan bahwa garis miring terbalik (dan konstruksi penurunan harga lainnya) tidak berfungsi secara verbatim
konteks:
Ini adalah garis miring terbalik diikuti oleh tanda bintang: `\*`.
Perpanjangan: inline_code_attributes
Atribut dapat dilampirkan ke teks kata demi kata, seperti halnya dengan blok kode berpagar:
`<$>`{.haskell}
Kecil topi
Untuk menulis huruf besar kecil, Anda dapat menggunakan tag rentang HTML:
topi kecil
(Titik koma adalah opsional dan mungkin ada spasi setelah titik dua.) Ini akan berfungsi di semua
format output yang mendukung huruf kecil.
Matematika
Perpanjangan: tex_math_dollar
Apa pun di antara dua karakter $ akan diperlakukan sebagai matematika TeX. $ pembuka harus memiliki
karakter non-spasi tepat di sebelah kanannya, sedangkan $ penutup harus memiliki karakter non-spasi
karakter tepat di sebelah kirinya, dan tidak boleh langsung diikuti oleh angka. Jadi,
$20,000 dan $30,000 tidak akan diuraikan sebagai matematika. Jika karena alasan tertentu Anda perlu menyertakan teks di
literal $ karakter, garis miring terbalik-escape mereka dan mereka tidak akan diperlakukan sebagai pembatas matematika.
Matematika TeX akan dicetak dalam semua format output. Bagaimana itu diberikan tergantung pada output
format:
Penurunan harga, Getah, Emacs organ mode, Konteks
Ini akan muncul kata demi kata antara $ karakter.
reStructuredText
Ini akan dirender menggunakan peran teks yang ditafsirkan :matematika:.
AsciiDoc
Ini akan dirender sebagai latexmath:[...].
Info Teks
Itu akan dirender di dalam perintah @math.
kasar pria
Itu akan diberikan kata demi kata tanpa $.
MediaWiki, DokuWiki
Itu akan ditampilkan di dalam tag.
Tekstil
Itu akan ditampilkan di dalam tag.
RTF, dokumen terbuka, ODT
Itu akan dirender, jika memungkinkan, menggunakan karakter unicode, dan sebaliknya
muncul kata demi kata.
DocBook
Jika flag --mathml digunakan, itu akan dirender menggunakan MathML dalam persamaan inline
atau tag informal. Kalau tidak, itu akan dirender, jika mungkin, menggunakan unicode
karakter.
Docx Ini akan dirender menggunakan markup matematika OMML.
Buku Fiksi2
Jika opsi --webtex digunakan, rumus dirender sebagai gambar menggunakan Google Charts
atau layanan web lain yang kompatibel, diunduh dan disematkan ke dalam e-book. Jika tidak,
mereka akan muncul kata demi kata.
HTML, licin, DZSlide, S5, EPUB
Cara matematika dirender dalam HTML akan bergantung pada opsi baris perintah yang dipilih:
1. Standarnya adalah membuat matematika TeX sejauh mungkin menggunakan karakter unicode,
seperti keluaran RTF, DocBook, dan OpenDocument. Rumus diletakkan di dalam rentang
dengan class="math", sehingga mereka dapat ditata berbeda dari sekitarnya
teks jika diperlukan.
2. Jika opsi --latexmathml digunakan, matematika TeX akan ditampilkan antara $ atau $$
karakter dan dimasukkan ke dalam tag dengan kelas LaTeX. Skrip LaTeXMathML akan
digunakan untuk merendernya sebagai formula. (Trik ini tidak bekerja di semua browser,
tetapi berfungsi di Firefox. Di browser yang tidak mendukung LaTeXMathML, TeX math
akan muncul kata demi kata di antara $ karakter.)
3. Jika opsi --jsmath digunakan, matematika TeX akan dimasukkan ke dalam tag (untuk
matematika sebaris) atau tag (untuk matematika tampilan) dengan matematika kelas. jsMath
script akan digunakan untuk merendernya.
4. Jika opsi --mimetex digunakan, skrip CGI mimeTeX akan dipanggil untuk
menghasilkan gambar untuk setiap rumus TeX. Ini harus bekerja di semua browser. Itu
--mimetex opsi mengambil URL opsional sebagai argumen. Jika tidak ada URL yang ditentukan, itu
akan diasumsikan bahwa skrip CGI mimeTeX ada di /cgi-bin/mimetex.cgi.
5. Jika opsi --gladtex digunakan, rumus TeX akan disertakan dalam tag di
keluaran HTML-nya. File htex yang dihasilkan kemudian dapat diproses oleh gladTeX,
yang akan menghasilkan file gambar untuk setiap formula dan file HTML dengan tautan ke
gambar-gambar ini. Jadi, prosedurnya adalah:
pandoc -s --gladtex file saya.txt -o file saya.htex
gladtex -d file-saya-gambar file-saya.htex
# menghasilkan myfile.html dan gambar di myfile-images
6. Jika opsi --webtex digunakan, rumus TeX akan dikonversi menjadi tag
yang menautkan ke skrip eksternal yang mengonversi rumus menjadi gambar. Rumusnya
akan dikodekan URL dan digabungkan dengan URL yang disediakan. Jika tidak ada URL
ditentukan, Google Chart API akan digunakan
(http://chart.apis.google.com/chart?cht=tx&chl=).
7. Jika opsi --mathjax digunakan, matematika TeX akan ditampilkan antara \(...\) (untuk
matematika inline) atau \[...\] (untuk matematika tampilan) dan dimasukkan ke dalam tag dengan kelas
matematika. Skrip MathJax akan digunakan untuk merendernya sebagai rumus.
Mentah HTML
Perpanjangan: mentah_html
Penurunan harga memungkinkan Anda untuk memasukkan HTML mentah (atau DocBook) di mana saja dalam dokumen (kecuali
konteks verbatim, di mana <, >, dan & ditafsirkan secara harfiah). (Secara teknis ini bukan
ekstensi, karena penurunan harga standar mengizinkannya, tetapi telah dibuat ekstensi sehingga
itu dapat dinonaktifkan jika diinginkan.)
HTML mentah dilewatkan tanpa perubahan dalam HTML, S5, Slidy, Slideous, DZSlides, EPUB,
Penurunan harga, dan keluaran Tekstil, dan ditekan dalam format lain.
Perpanjangan: penurunan harga_dalam_html_blok
Penurunan harga standar memungkinkan Anda untuk memasukkan "blok" HTML: blok HTML antara seimbang
tag yang dipisahkan dari teks di sekitarnya dengan garis kosong, dan dimulai dan diakhiri di
margin kiri. Di dalam blok ini, semuanya ditafsirkan sebagai HTML, bukan penurunan harga; jadi
(misalnya), * tidak berarti penekanan.
Pandoc berperilaku seperti ini ketika format markdown_strict digunakan; tetapi secara default, pandoc
menginterpretasikan materi antara tag blok HTML sebagai penurunan harga. Jadi, misalnya, pandoc akan
giliran
*satu*
[sebuah link](http://google.com)
ke
satu
<a href="/http://google.com">sebuah tautan
sedangkan Markdown.pl akan mempertahankannya apa adanya.
Ada satu pengecualian untuk aturan ini: teks di antara and tags is not
diartikan sebagai penurunan harga.
Keberangkatan dari Penurunan Harga standar ini akan mempermudah pencampuran Penurunan Harga dengan HTML
elemen blok. Misalnya, seseorang dapat mengelilingi blok teks Penurunan harga dengan tag
tanpa mencegahnya ditafsirkan sebagai Penurunan Harga.
Perpanjangan: asli_divs
Gunakan blok Div pandoc asli untuk konten di dalamnya tag. Sebagian besar ini seharusnya
berikan output yang sama dengan markdown_in_html_blocks, tetapi lebih mudah untuk menulis pandoc
filter untuk memanipulasi kelompok blok.
Perpanjangan: asli_spans
Gunakan blok Span pandoc asli untuk konten di dalam tag. Sebagian besar ini
seharusnya memberikan output yang sama dengan raw_html, tetapi akan lebih mudah untuk menulis filter pandoc ke
memanipulasi kelompok sebaris.
Mentah TeX
Perpanjangan: mentah_tex
Selain HTML mentah, pandoc memungkinkan LaTeX, TeX, dan ConTeXt mentah untuk disertakan dalam a
dokumen. Perintah Inline TeX akan dipertahankan dan diteruskan tidak berubah ke LaTeX dan
penulis ConTeXt. Jadi, misalnya, Anda dapat menggunakan LaTeX untuk menyertakan kutipan BibTeX:
Hasil ini dibuktikan dalam \cite{jones.1967}.
Perhatikan bahwa di lingkungan LaTeX, seperti
\begin{tabular}{|l|l|}\hline
Usia & Frekuensi \\ \hline
18--25 & 15 \\
26--35 & 33 \\
36--45 & 22 \\ \hline
\end{tabel}
materi antara tag awal dan akhir akan ditafsirkan sebagai LaTeX mentah, bukan sebagai
Penurunan harga.
LaTeX sebaris diabaikan dalam format keluaran selain penurunan harga, LaTeX, dan ConTeXt.
Getah Macro
Perpanjangan: latex_makros
Untuk format keluaran selain LaTeX, pandoc akan mengurai LaTeX \newcommand dan \renewcommand
definisi dan menerapkan makro yang dihasilkan ke semua matematika LaTeX. Jadi, misalnya,
berikut ini akan berfungsi di semua format output, bukan hanya LaTeX:
\perintah baru{\tuple}[1]{\langle #1 \rangle}
$\tupel{a, b, c}$
Dalam keluaran LaTeX, definisi \newcommand hanya akan diteruskan tanpa perubahan ke keluaran.
Link
Penurunan harga memungkinkan tautan untuk ditentukan dalam beberapa cara.
secara otomatis link
Jika Anda menyertakan URL atau alamat email dalam tanda kurung, itu akan menjadi tautan:
<http://google.com>
<[email dilindungi]>
Di barisan link
Tautan sebaris terdiri dari teks tautan dalam tanda kurung siku, diikuti oleh URL di
tanda kurung. (Secara opsional, URL dapat diikuti dengan judul tautan, dalam tanda kutip.)
Ini adalah [tautan sebaris](/url), dan ini [satu dengan
sebuah judul](http://fsf.org "klik di sini untuk bersenang-senang!").
Tidak boleh ada spasi antara bagian yang dikurung dan bagian yang dikurung. tautan
teks dapat berisi pemformatan (seperti penekanan), tetapi judul tidak dapat.
Alamat email di tautan sebaris tidak otomatis terdeteksi, jadi harus diawali dengan
mailto:
[Tuliskan aku!](mailto:[email dilindungi])
Referensi link
An eksplisit tautan referensi memiliki dua bagian, tautan itu sendiri dan definisi tautan, yang
dapat terjadi di tempat lain dalam dokumen (baik sebelum atau sesudah tautan).
Tautan terdiri dari teks tautan dalam tanda kurung siku, diikuti dengan label dalam tanda kurung siku.
(Mungkin ada spasi di antara keduanya.) Definisi tautan terdiri dari label tanda kurung,
diikuti oleh titik dua dan spasi, diikuti oleh URL, dan opsional (setelah spasi) a
judul tautan baik dalam tanda kutip atau dalam tanda kurung. Label tidak boleh diuraikan sebagai
kutipan (dengan asumsi ekstensi kutipan diaktifkan): kutipan lebih diutamakan daripada
label tautan.
Berikut adalah beberapa contoh:
[label saya 1]: /foo/bar.html "Judul saya, opsional"
[label saya 2]: /foo
[label saya 3]: http://fsf.org (Yayasan perangkat lunak bebas)
[label saya 4]: /bar#special 'Judul dalam tanda kutip tunggal'
URL secara opsional dapat dikelilingi oleh kurung sudut:
[label saya 5]:http://foo.bar.baz>
Judulnya mungkin ada di baris berikutnya:
[label saya 3]: http://fsf.org
"Dasar perangkat lunak bebas"
Perhatikan bahwa label tautan tidak peka huruf besar-kecil. Jadi, ini akan berhasil:
Ini [tautan saya][FOO]
[Foo]: /bar/baz
Dalam implisit tautan referensi, pasangan tanda kurung kedua kosong:
Lihat [situs web saya][].
[situs web saya]: http://foo.bar.baz
Catatan: Di Markdown.pl dan sebagian besar implementasi Markdown lainnya, definisi tautan referensi
tidak dapat terjadi dalam konstruksi bersarang seperti item daftar atau tanda kutip blok. Lift Pandoc
pembatasan yang tampak sewenang-wenang ini. Jadi yang berikut ini baik-baik saja di pandoc, meskipun tidak di
sebagian besar implementasi lainnya:
> Blok saya [kutipan].
>
> [kutipan]: /foo
Perpanjangan: tautan_referensi_pintasan
Di sebuah shortcut tautan referensi, pasangan tanda kurung kedua dapat dihilangkan seluruhnya:
Lihat [situs web saya].
[situs web saya]: http://foo.bar.baz
Intern link
Untuk menautkan ke bagian lain dari dokumen yang sama, gunakan yang dibuat secara otomatis
pengenal (lihat Pengidentifikasi tajuk). Sebagai contoh:
Lihat [Pengantar](#pengantar).
or
Lihat [Pengantar].
[Pengantar]: #perkenalan
Tautan internal saat ini didukung untuk format HTML (termasuk tayangan slide HTML dan
EPUB), LaTeX, dan ConTeXt.
Images
Sebuah link segera didahului oleh ! akan diperlakukan sebagai gambar. Teks tautan akan menjadi
digunakan sebagai teks alternatif gambar:
![rol film]
[rol film]: movie.gif
Perpanjangan: implisit_angka
Gambar yang muncul dengan sendirinya dalam paragraf akan ditampilkan sebagai gambar dengan keterangan.
(Dalam LaTeX, lingkungan gambar akan digunakan; dalam HTML, gambar akan ditempatkan di div
dengan figur kelas, bersama dengan keterangan di ap dengan keterangan kelas.) Alt . gambar
teks akan digunakan sebagai keterangan.
Jika Anda hanya menginginkan gambar sebaris biasa, pastikan itu bukan satu-satunya di
gugus kalimat. Salah satu cara untuk melakukannya adalah dengan menyisipkan spasi yang tidak terputus setelah gambar:
\
Perpanjangan: tautan_atribut
Atribut dapat diatur pada tautan dan gambar:
Sebaris {#id .class width=30 height=20px}
dan referensi ![image][ref] dengan atribut.
[ref]: foo.jpg "judul opsional" {#id .class key=val key2="val 2"}
(Sintaks ini kompatibel dengan PHP Markdown Extra ketika hanya #id dan .class yang digunakan.)
Untuk HTML dan EPUB, semua atribut kecuali lebar dan tinggi (tetapi termasuk srcset dan ukuran)
dilewatkan apa adanya. Penulis lain mengabaikan atribut yang tidak didukung oleh
format keluaran mereka.
Atribut lebar dan tinggi pada gambar diperlakukan secara khusus. Saat digunakan tanpa
unit, unit diasumsikan piksel. Namun, salah satu dari pengidentifikasi unit berikut
dapat digunakan: px, cm, mm, in, inci, dan %. Tidak boleh ada spasi di antara angka
dan unitnya. Sebagai contoh:
{ lebar=50% }
· Dimensi dikonversi ke inci untuk output dalam format berbasis halaman seperti LaTeX.
Dimensi dikonversi ke piksel untuk keluaran dalam format seperti HTML. Gunakan --dpi
opsi untuk menentukan jumlah piksel per inci. Standarnya adalah 96dpi.
· Unit % umumnya relatif terhadap beberapa ruang yang tersedia. Misalnya contoh di atas
akan membuat (HTML),
\includegraphics[width=0.5\textwidth]{file.jpg} (LaTeX), atau
\externalfigure[file.jpg][width=0.5\textwidth] (Konteks).
· Beberapa format output memiliki gagasan tentang kelas (ConTeXt) atau pengenal unik (LaTeX
\caption), atau keduanya (HTML).
· Ketika tidak ada atribut lebar atau tinggi yang ditentukan, mundurnya adalah dengan melihat gambar
resolusi dan metadata dpi yang disematkan dalam file gambar.
Catatan kaki
Perpanjangan: catatan kaki
Penurunan harga Pandoc memungkinkan catatan kaki, menggunakan sintaks berikut:
Berikut adalah referensi catatan kaki,[^1] dan lainnya.[^longnote]
[^1]: Ini catatan kakinya.
[^longnote]: Ini satu dengan banyak blok.
Paragraf berikutnya dibuat menjorok untuk menunjukkan bahwa mereka
milik catatan kaki sebelumnya.
{ beberapa.kode }
Seluruh paragraf dapat menjorok, atau hanya yang pertama
garis. Dengan cara ini, catatan kaki multi-paragraf berfungsi seperti
item daftar multi-paragraf.
Paragraf ini tidak akan menjadi bagian dari catatan, karena itu
tidak menjorok.
Pengidentifikasi dalam referensi catatan kaki tidak boleh berisi spasi, tab, atau baris baru. Ini
pengidentifikasi hanya digunakan untuk menghubungkan referensi catatan kaki dengan catatan itu sendiri; dalam
output, catatan kaki akan diberi nomor secara berurutan.
Catatan kaki itu sendiri tidak perlu ditempatkan di akhir dokumen. Mereka mungkin muncul
di mana saja kecuali di dalam elemen blok lainnya (daftar, kutipan blok, tabel, dll.).
Perpanjangan: catatan_sebaris
Catatan kaki sebaris juga diperbolehkan (meskipun, tidak seperti catatan biasa, catatan kaki tidak boleh berisi
beberapa paragraf). Sintaksnya adalah sebagai berikut:
Ini adalah catatan sebaris.^[Catatan sebaris lebih mudah ditulis, karena
Anda tidak perlu memilih pengenal dan bergerak ke bawah untuk mengetik
catatan.]
Catatan kaki sebaris dan reguler dapat dicampur secara bebas.
kutipan
Perpanjangan: kutipan
Menggunakan filter eksternal, pandoc-citeproc, pandoc dapat secara otomatis menghasilkan kutipan dan
bibliografi dalam beberapa gaya. Penggunaan dasar adalah
pandoc --filter pandoc-citeproc myinput.txt
Untuk menggunakan fitur ini, Anda perlu menentukan file bibliografi menggunakan
bidang metadata bibliografi di bagian metadata YAML, atau --bibliography baris perintah
argumen. Anda dapat menyediakan beberapa --bibliografi argumen atau mengatur metadata bibliografi
field ke array YAML, jika Anda ingin menggunakan beberapa file bibliografi. Daftar Pustaka boleh
memiliki salah satu format berikut:
Format file ekstensi
────────────────────────
BibLaTeX .bib
BibTeX .bibtex
copac .copac
CSL JSON .json
CSL YAML .yaml
Catatan Akhir .enl
XML Catatan Akhir .xml
ISI .wos
MEDLINE .medline
MODS .mods
RIS.ris
Perhatikan bahwa .bib dapat digunakan dengan file BibTeX dan BibLaTeX; gunakan .bibtex untuk memaksa
BibTeX.
Perhatikan bahwa pandoc-citeproc --bib2json dan pandoc-citeproc --bib2yaml dapat menghasilkan .json dan
file .yaml dari salah satu format yang didukung.
Markup dalam bidang: Dalam basis data BibTeX dan BibLaTeX, pandoc-citeproc mem-parsing subset dari
markup LaTeX; di database CSL YAML, pandoc Penurunan harga; dan dalam database CSL JSON, dan
Markup seperti HTML:
huruf miring
...
pin
style="font-variant:small-caps;">... or ...
modal kecil
...
subskrip
...
superskrip
kelas="nocase">...
mencegah frasa dikapitalisasi sebagai kasus judul
pandoc-citeproc -j dan -y mengonversi format CSL JSON dan CSL YAML sejauh
mungkin.
Sebagai alternatif untuk menentukan file bibliografi menggunakan --bibliography atau YAML
bibliografi bidang metadata, Anda dapat memasukkan data kutipan langsung di referensi
bidang metadata YAML dokumen. Bidang harus berisi larik yang dikodekan YAML
referensi, misalnya:
---
referensi:
- jenis: artikel-jurnal
ID: WatsonCrick1953
penulis:
- keluarga: Watson
diberikan: JD
- keluarga: Crick
diberikan: FHC
dikabarkan:
tanggal-bagian:
- - 1953
- 4
- 25
judul: 'Struktur molekul asam nukleat: struktur untuk deoksiribosa
asam nukleat'
judul-singkat: Struktur molekul asam nukleat
wadah-judul: Alam
volume: 171
edisi: 4356
halaman: 737-738
DOI: 10.1038/171737a0
URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
bahasa: en-GB
...
(pandoc-citeproc --bib2yaml dapat menghasilkan ini dari file bibliografi di salah satu dari
format yang didukung.)
Kutipan dan referensi dapat diformat menggunakan gaya apa pun yang didukung oleh Gaya Kutipan
Bahasa, tercantum dalam Repositori Gaya Zotero. File-file ini ditentukan menggunakan
--csl opsi atau bidang metadata csl. Secara default, pandoc-citeproc akan menggunakan Chicago
Manual format tanggal penulis Style. Proyek CSL memberikan informasi lebih lanjut tentang
menemukan dan mengedit gaya.
Untuk membuat kutipan Anda menjadi hyperlink ke entri bibliografi yang sesuai, tambahkan
link-citations: sesuai dengan metadata YAML Anda.
Kutipan dimasukkan ke dalam tanda kurung siku dan dipisahkan oleh titik koma. Setiap kutipan harus
memiliki kunci, terdiri dari '@' + pengenal kutipan dari database, dan mungkin
opsional memiliki awalan, pencari lokasi, dan akhiran. Kunci kutipan harus dimulai dengan a
huruf, angka, atau _, dan mungkin berisi alfanumerik, _, dan karakter tanda baca internal
(:.#$%&-+?<>~/). Berikut beberapa contohnya:
Bla bla [lihat @doe99, hlm. 33-35; juga @smith04, bab. 1].
Bla bla [@doe99, hlm. 33-35, 38-39 dan *passim*].
Bla bla [@smith04; @doe99].
pandoc-citeproc mendeteksi istilah locator dalam file lokal CSL. Baik disingkat atau
formulir yang tidak disingkat diterima. Di lokal en-US, istilah locator dapat ditulis dalam
bentuk tunggal atau jamak, seperti buku, bk./bks.; bab, bab./bab.; kolom,
kol./kol.; gambar, gambar/gambar; folio, fol./fols.; nomor, nomor/nomor; baris, l./ll.; catatan,
n./ n.; operasi, operasi/opp.; halaman, hal./hal.; paragraf, para./para.; bagian, pt./pts.; bagian,
detik/detik.; sub verbo, sv/s.vv.; ayat, v./vv.; volume, vol./vol.; /¶¶; /§§. Jika tidak
istilah locator digunakan, "halaman" diasumsikan.
Tanda minus (-) sebelum @ akan menghilangkan penyebutan penulis dalam kutipan. Ini
dapat berguna ketika penulis sudah disebutkan dalam teks:
Smith mengatakan bla [-@smith04].
Anda juga dapat menulis kutipan dalam teks, sebagai berikut:
@smith04 mengatakan bla.
@smith04 [hal. 33] kata bla.
Jika gaya meminta daftar karya yang dikutip, itu akan ditempatkan di akhir
dokumen. Biasanya, Anda ingin mengakhiri dokumen Anda dengan header yang sesuai:
paragraf terakhir...
# Referensi
Daftar pustaka akan disisipkan setelah header ini. Perhatikan bahwa kelas yang tidak bernomor akan
ditambahkan ke header ini, sehingga bagian tidak akan diberi nomor.
Jika Anda ingin memasukkan item dalam daftar pustaka tanpa benar-benar mengutipnya di badan
teks, Anda dapat menentukan bidang metadata nocite dummy dan meletakkan kutipan di sana:
---
tahu: |
@barang1, @barang2
...
@ item3
Dalam contoh ini, dokumen akan berisi kutipan untuk item3 saja, tetapi bibliografi
akan berisi entri untuk item1, item2, dan item3.
Untuk keluaran LaTeX atau PDF, Anda juga dapat menggunakan natbib atau biblatex untuk merender bibliografi. Di
untuk melakukannya, tentukan file bibliografi seperti yang diuraikan di atas, dan tambahkan --natbib atau
--biblatex argumen ke pandoc doa. Ingatlah bahwa file bibliografi harus
dalam format masing-masing (baik BibTeX atau BibLaTeX).
Untuk informasi lebih lanjut, lihat halaman manual pandoc-citeproc.
Non-pandok ekstensi
Ekstensi sintaks penurunan harga berikut tidak diaktifkan secara default di pandoc, tetapi mungkin:
diaktifkan dengan menambahkan +EXTENSION ke nama format, di mana EXTENSION adalah nama dari
perpanjangan. Jadi, misalnya, penurunan harga+hard_line_breaks adalah Penurunan harga dengan garis keras
istirahat.
Perpanjangan: list_without_preceding_blankline
Izinkan daftar muncul tepat setelah paragraf, tanpa mengganggu ruang kosong.
Perpanjangan: hard_line_break
Menyebabkan semua baris baru dalam paragraf ditafsirkan sebagai jeda baris keras alih-alih
spasi.
Perpanjangan: abaikan_line_breaks
Menyebabkan baris baru dalam paragraf diabaikan, daripada diperlakukan sebagai spasi atau
sebagai garis putus-putus. Opsi ini dimaksudkan untuk digunakan dengan bahasa-bahasa Asia Timur di mana
spasi tidak digunakan di antara kata-kata, tetapi teks dibagi menjadi beberapa baris agar mudah dibaca.
Perpanjangan: east_asian_line_breaks
Menyebabkan baris baru dalam paragraf diabaikan, daripada diperlakukan sebagai spasi atau
sebagai jeda garis keras, ketika terjadi di antara dua karakter lebar Asia Timur. Ini adalah sebuah
pilihan yang lebih baik daripada abaikan_line_breaks untuk teks yang menyertakan campuran seluruh Asia Timur
karakter dan karakter lainnya.
Perpanjangan: Emoji
Mengurai emoji tekstual seperti :smile: sebagai emotikon Unicode.
Perpanjangan: tex_math_single_backslash
Menyebabkan apa pun antara \( dan \) ditafsirkan sebagai matematika TeX sebaris, dan apa pun
antara \[ dan \] untuk ditafsirkan sebagai tampilan matematika TeX. Catatan: kelemahan dari ini
ekstensi adalah bahwa itu mencegah melarikan diri ( dan [.
Perpanjangan: tex_math_double_backslash
Menyebabkan apa pun antara \\( dan \\) ditafsirkan sebagai matematika TeX sebaris, dan apa pun
antara \\[ dan \\] untuk ditafsirkan sebagai tampilan matematika TeX.
Perpanjangan: penurunan harga_atribut
Secara default, pandoc menafsirkan materi di dalam tag level blok sebagai Penurunan harga. Ini
ekstensi mengubah perilaku sehingga Penurunan Harga hanya diuraikan di dalam tag tingkat blok jika
tag memiliki atribut penurunan harga=1.
Perpanjangan: mmd_title_block
Mengaktifkan blok judul gaya MultiMarkdown di bagian atas dokumen, misalnya:
Judul: Judul saya
Pengarang: John Doe
Tanggal: September 1, 2008
Komentar: Ini adalah contoh blok judul mmd, dengan
bidang yang mencakup beberapa baris.
Lihat dokumentasi MultiMarkdown untuk detailnya. Jika pandoc_title_block atau
yaml_metadata_block diaktifkan, ini akan didahulukan dari mmd_title_block.
Perpanjangan: singkatan
Parsing PHP Markdown Kunci singkatan ekstra, seperti
*[HTML]: Bahasa Markup Hypertext
Perhatikan bahwa model dokumen pandoc tidak mendukung singkatan, jadi jika ekstensi ini
diaktifkan, kunci singkatan hanya dilewati (sebagai lawan diuraikan sebagai
paragraf).
Perpanjangan: tautan otomatis_bare_uris
Membuat semua URI absolut menjadi tautan, meskipun tidak dikelilingi oleh tanda kurung kurawal <...>.
Perpanjangan: ascii_identifier
Menyebabkan pengenal yang dihasilkan oleh auto_identifiers menjadi ASCII murni. Aksen adalah
huruf latin beraksen dihilangkan, dan huruf non-latin dihilangkan.
Perpanjangan: mmd_link_atribut
Mengurai atribut nilai kunci gaya multimarkdown pada tautan dan referensi gambar. Ini
ekstensi tidak boleh bingung dengan ekstensi link_attributes.
Ini adalah referensi ![image][ref] dengan atribut multimarkdown.
[referensi]: http://path.to/image "Judul gambar" lebar=20px tinggi=30px
id=myId class="myClass1 myClass2"
Perpanjangan: mmd_header_identifiers
Mengurai pengidentifikasi tajuk gaya multimarkdown (dalam tanda kurung siku, setelah tajuk tetapi
sebelum tanda #s di header ATX).
Perpanjangan: daftar_definisi_kompak
Mengaktifkan sintaks daftar definisi pandoc 1.12.x dan sebelumnya. Sintaks ini berbeda
dari yang dijelaskan di atas di bawah daftar Definisi dalam beberapa hal:
· Tidak ada baris kosong yang diperlukan antara item berurutan dari daftar definisi.
· Untuk mendapatkan daftar "ketat" atau "ringkas", hilangkan spasi di antara item yang berurutan; ruang angkasa
antara istilah dan definisinya tidak mempengaruhi apa pun.
· Pembungkus paragraf yang malas tidak diperbolehkan: seluruh definisi harus menjorok empat
spasi.
Penurunan harga varian
Selain penurunan harga pandoc yang diperpanjang, varian penurunan harga berikut ini didukung:
penurunan harga_phpextra (PHP Penurunan harga Tambahan)
catatan kaki, tabel_pipa, raw_html, atribut_penurunan harga, blok_kode_pagar,
daftar_definisi, skor_bawah_intra, atribut_header, atribut_tautan,
singkatan, shortcut_reference_links.
penurunan harga_github (Rasa GitHub Penurunan harga)
pipa_tabel, raw_html, tex_math_single_backslash, blok_kode_pagar,
pengenal_otomatis, pengenal_ascii, blok_kode_backtick, tautan_otomatis_bare_uris,
intraword_underscores, coret, hard_line_breaks, emoji,
tautan_referensi_pintasan.
penurunan harga_mmd (Multi Markdown)
pipe_tables raw_html, markdown_attribute, mmd_link_attributes, raw_tex,
tex_math_double_backslash, intraword_underscores, mmd_title_block, catatan kaki,
definition_lists, all_symbols_escapable, implisit_header_references,
pengenal_otomatis, pengenal mmd_header, tautan_referensi_shortcut.
penurunan harga_ketat (Penurunan harga.pl)
mentah_html
Ekstensi dengan format lain dari Penurunan harga
Beberapa ekstensi yang dibahas di atas dapat digunakan dengan format selain penurunan harga:
· pengenal_otomatis dapat digunakan dengan input lateks, pertama, mediawiki, dan tekstil (dan digunakan
secara default).
· tex_math_dollars, tex_math_single_backslash, dan tex_math_double_backslash dapat digunakan
dengan masukan html. (Ini berguna untuk membaca halaman web yang diformat menggunakan MathJax, untuk
contoh.)
MENGHASILKAN SLIDE MENUNJUKKAN DENGAN PANDOK
Anda dapat menggunakan pandoc untuk menghasilkan presentasi slide HTML + javascript yang dapat dilihat
melalui peramban web. Ada lima cara untuk melakukan ini, menggunakan S5, DZSlides, Slidy, Slideous,
atau mengungkapkan.js. Anda juga dapat menghasilkan tayangan slide PDF menggunakan beamer LaTeX.
Berikut sumber penurunan harga untuk tayangan slide sederhana, habit.txt:
% Kebiasaan
% John Doe
% 22 Maret 2005
# Di pagi hari
## Bangun
- Matikan alarm
- Bangun dari tempat tidur
## Sarapan
- Makan telur
- Minum kopi
# Pada malam hari
## Makan malam
- Makan spageti
- Minum anggur
------------------
## Pergi tidur
- Dapatkan di tempat tidur
- Menghitung domba
Untuk menghasilkan tayangan slide HTML/javascript, cukup ketik
pandoc -t FORMAT -s kebiasaan.txt -o kebiasaan.html
di mana FORMAT adalah s5, slidy, slideous, dzslides, atau mengungkapkan.
Untuk Slidy, Slideous, mengungkapkan.js, dan S5, file yang dihasilkan oleh pandoc dengan
-s/--standalone option menyematkan tautan ke file javascript dan CSS, yang dianggap sebagai
tersedia di jalur relatif s5/default (untuk S5), slideous (untuk Slideous), mengungkapkan.js
(untuk mengungkapkan.js), atau di situs web Slidy di w3.org (untuk Slidy). (Jalan ini bisa menjadi
diubah dengan menyetel variabel slidy-url, slideous-url, expressjs-url, atau s5-url; melihat
Variabel untuk slide, di atas.) Untuk DZSlides, javascript dan css (relatif pendek) adalah
disertakan dalam file secara default.
Dengan semua format slide HTML, opsi --self-contained dapat digunakan untuk menghasilkan satu
file yang berisi semua data yang diperlukan untuk menampilkan tayangan slide, termasuk yang ditautkan
script, stylesheet, gambar, dan video.
Untuk menghasilkan tayangan slide PDF menggunakan beamer, ketik
pandoc -t beamer habit.txt -o habit.pdf
Perhatikan bahwa tayangan slide mengungkapkan.js juga dapat dikonversi ke PDF dengan mencetaknya ke file
dari peramban.
Penataan itu meluncur Menunjukkan
Secara default, meluncur tingkat adalah tingkat tajuk tertinggi dalam hierarki yang diikuti
langsung dengan konten, dan bukan header lain, di suatu tempat di dokumen. Dalam contoh
di atas, header level 1 selalu diikuti oleh header level 2, yang diikuti oleh
konten, jadi 2 adalah level slide. Default ini dapat diganti menggunakan --slide-level
.
Dokumen diukir menjadi slide sesuai dengan aturan berikut:
· Aturan horizontal selalu memulai slide baru.
· Header pada level slide selalu memulai slide baru.
· Header di bawah tingkat slide dalam hierarki buat tajuk dalam sebuah slide.
· Header atas tingkat slide dalam hierarki membuat "slide judul," yang hanya berisi
judul bagian dan bantuan untuk memecah tayangan slide menjadi beberapa bagian.
· Halaman judul dibuat secara otomatis dari blok judul dokumen, jika ada.
(Dalam kasus beamer, ini dapat dinonaktifkan dengan mengomentari beberapa baris di default
templat.)
Aturan ini dirancang untuk mendukung berbagai gaya peragaan slide. Jika tidak
peduli tentang penataan slide Anda menjadi beberapa bagian dan subbagian, Anda bisa menggunakan level 1
header untuk semua setiap slide. (Dalam hal ini, level 1 akan menjadi level slide.) Tapi Anda bisa
juga menyusun tampilan slide menjadi beberapa bagian, seperti pada contoh di atas.
Catatan: dalam tampilan slide mengungkapkan.js, jika level slide adalah 2, tata letak dua dimensi akan menjadi
diproduksi, dengan bangunan header level 1 secara horizontal dan bangunan header level 2
Tegak lurus. Anda tidak disarankan untuk menggunakan tingkat bagian yang bersarang lebih dalam dengan
mengungkapkan.js.
Tambahan daftar
Secara default, penulis ini menghasilkan daftar yang menampilkan "sekaligus". Jika Anda ingin daftar Anda
untuk menampilkan secara bertahap (satu item pada satu waktu), gunakan opsi -i. Jika Anda ingin
daftar tertentu untuk menyimpang dari default (yaitu, untuk ditampilkan secara bertahap tanpa
opsi -i dan sekaligus dengan opsi -i), masukkan dalam kutipan blok:
> - Makan spageti
> - Minum anggur
Dengan cara ini daftar inkremental dan nonincremental dapat dicampur dalam satu dokumen.
Memasukkan istirahat
Anda dapat menambahkan "jeda" dalam slide dengan memasukkan paragraf yang berisi tiga titik,
dipisahkan oleh spasi:
# Geser dengan jeda
konten sebelum jeda
. . .
konten setelah jeda
styling itu slide
Anda dapat mengubah gaya slide HTML dengan memasukkan file CSS yang disesuaikan ke dalam
$DATADIR/s5/default (untuk S5), $DATADIR/slidy (untuk Slidy), atau $DATADIR/slideous (untuk
Slideous), di mana $DATADIR adalah direktori data pengguna (lihat --data-dir, di atas). Itu
aslinya dapat ditemukan di direktori data sistem pandoc (umumnya
$CABALDIR/pandoc-VERSION/s5/default). Pandoc akan mencari file apa pun yang tidak ada di sana
temukan di direktori data pengguna.
Untuk dzslides, CSS disertakan dalam file HTML itu sendiri, dan dapat dimodifikasi di sana.
Semua opsi konfigurasi mengungkapkan.js dapat diatur melalui variabel. Misalnya, tema dapat
digunakan dengan mengatur variabel tema:
-V tema = bulan
Atau Anda dapat menentukan lembar gaya khusus menggunakan opsi --css.
Untuk menata slide beamer, Anda dapat menentukan tema, tema warna, tema font, tema dalam, dan
outertheme, menggunakan opsi -V:
pandoc -t beamer habit.txt -V theme:Warsawa -o habit.pdf
Perhatikan bahwa atribut header akan berubah menjadi atribut slide (pada a atau ) di
Format slide HTML, memungkinkan Anda untuk mengatur gaya slide individual. Di beamer, satu-satunya header
Atribut yang mempengaruhi slide adalah kelas allowframebreaks, yang menyetel
opsi allowframebreaks, menyebabkan beberapa slide dibuat jika kontennya terlalu penuh
bingkai. Ini direkomendasikan terutama untuk bibliografi:
# Referensi {.allowframebreaks}
Pembicara catatan
mengungkapkan.js memiliki dukungan yang baik untuk catatan pembicara. Anda dapat menambahkan catatan ke dokumen Penurunan harga Anda
demikian:
Ini catatan saya.
- Dapat berisi penurunan harga
- suka daftar ini
Untuk menampilkan jendela catatan, tekan s saat melihat presentasi. Catatan belum
didukung untuk format slide lain, tetapi catatan tidak akan muncul di slide itu sendiri.
Bingkai atribut in beamer
Terkadang perlu untuk menambahkan opsi LaTeX [rapuh] ke bingkai di beamer (untuk
misalnya, saat menggunakan lingkungan yang dicetak). Ini bisa dipaksakan dengan menambahkan rapuh
class ke header yang memperkenalkan slide:
# Slide rapuh {.fragile}
Semua atribut bingkai lain yang dijelaskan dalam Bagian 8.1 dari Panduan Pengguna Beamer dapat:
juga dapat digunakan: allowdisplaybreaks, allowframebreaks, b, c, t, environment, label, plain,
menyusut.
MENCIPTAKAN EPUB DENGAN PANDOK
EPUB Metadata
Metadata EPUB dapat ditentukan menggunakan opsi --epub-metadata, tetapi jika sumbernya
dokumen adalah penurunan harga, lebih baik menggunakan blok metadata YAML. Berikut ini contohnya:
---
Judul:
- jenis: utama
teks: Buku Saya
- jenis: subjudul
teks: Investigasi metadata
pencipta:
- peran: penulis
teks: John Smith
- peran: editor
teks: Sarah Jones
pengenal:
- skema: DOI
teks: doi:10.234234.234/33
penerbit: Pers Saya
hak: © 2007 John Smith, CC BY-NC
...
Bidang-bidang berikut diakui:
identifier
Baik nilai string atau objek dengan teks dan skema bidang. Nilai yang valid untuk
skema adalah ISBN-10, GTIN-13, UPC, ISMN-10, DOI, LCCN, GTIN-14, ISBN-13,
Nomor setoran resmi, URN, OCLC, ISMN-13, ISBN-A, JP, OLCC.
judul Baik nilai string, atau objek dengan bidang file-sebagai dan tipe, atau daftar semacam itu
objek. Nilai yang valid untuk jenis adalah utama, subjudul, pendek, koleksi, edisi,
diperpanjang.
pencipta
Baik nilai string, atau objek dengan peran bidang, file-sebagai, dan teks, atau daftar
dari objek-objek tersebut. Nilai yang valid untuk peran adalah relasi MARC, tetapi pandoc akan mencoba
untuk menerjemahkan versi yang dapat dibaca manusia (seperti "penulis" dan "editor") ke
hubungan marc yang sesuai.
penyumbang
Format yang sama dengan pencipta.
tanggal Nilai string dalam format YYYY-MM-DD. (Hanya tahun yang diperlukan.) Pandoc akan
mencoba mengonversi format tanggal umum lainnya.
lang (Atau warisan: bahasa)
Nilai string dalam format BCP 47. Pandoc akan default ke bahasa lokal jika
tidak ada yang ditentukan.
subyek
Nilai string atau daftar nilai tersebut.
deskripsi
Sebuah nilai string.
mengetik Sebuah nilai string.
format Sebuah nilai string.
hubungan
Sebuah nilai string.
liputan
Sebuah nilai string.
hak Sebuah nilai string.
gambar sampul
Nilai string (jalur ke gambar sampul).
stylesheet
Nilai string (jalur ke stylesheet CSS).
halaman-kemajuan-arah
Entah ltr atau rtl. Menentukan atribut page-progress-direction untuk
elemen tulang belakang.
Linked media
Secara default, pandoc akan mengunduh media yang ditautkan (termasuk audio dan video) dan menyertakannya
dalam wadah EPUB, menghasilkan EPUB mandiri sepenuhnya. Jika Anda ingin menautkan ke
sumber media eksternal sebagai gantinya, gunakan HTML mentah di sumber Anda dan tambahkan data-external="1" ke
tag dengan atribut src. Sebagai contoh:
<sumber src="/http://example.com/music/toccata.mp3"
data-external="1" type="audio/mpeg">
TERPELAJAR HASKELL SUPPORT
Jika Anda menambahkan +lhs (atau +literate_haskell) ke format input atau output yang sesuai
(penurunan harga, markdown_strict, pertama, atau lateks untuk input atau output; beamer, html atau html5 untuk
output saja), pandoc akan memperlakukan dokumen sebagai sumber Haskell yang melek huruf. Ini berarti bahwa
· Dalam input penurunan harga, bagian "jalur burung" akan diuraikan sebagai kode Haskell daripada
blok kutipan. Teks antara \begin{code} dan \end{code} juga akan diperlakukan sebagai
kode Haskell. Untuk header bergaya ATX, karakter '=' akan digunakan sebagai ganti '#'.
· Dalam output penurunan harga, blok kode dengan kelas haskell dan literate akan dirender menggunakan
jejak burung, dan kutipan blok akan diindentasi satu spasi, jadi tidak akan
diperlakukan sebagai kode Haskell. Selain itu, header akan dirender dengan gaya settext (dengan
garis bawah) daripada gaya ATX (dengan karakter '#'). (Ini karena ghc memperlakukan
'#' karakter di kolom 1 sebagai pengantar nomor baris.)
· Dalam input teks yang direstrukturisasi, bagian "jalur burung" akan diuraikan sebagai kode Haskell.
· Dalam output teks yang direstrukturisasi, blok kode dengan haskell kelas akan dirender menggunakan bird
trek.
· Dalam input LaTeX, teks dalam lingkungan kode akan diuraikan sebagai kode Haskell.
· Dalam keluaran LaTeX, blok kode dengan haskell kelas akan dirender di dalam kode
lingkungan.
· Dalam output HTML, blok kode dengan haskell kelas akan dirender dengan kelas
literatehaskell dan jejak burung.
contoh:
pandoc -f penurunan harga+lhs -t html
membaca sumber Haskell yang terpelajar yang diformat dengan konvensi penurunan harga dan menulis HTML biasa
(tanpa jejak burung).
pandoc -f penurunan harga+lhs -t html+lhs
menulis HTML dengan kode Haskell di jejak burung, sehingga dapat disalin dan ditempel sebagai
melek sumber Haskell.
SINTAKSIS SOROTAN
Pandoc akan secara otomatis menyorot sintaks dalam blok kode berpagar yang ditandai dengan
nama bahasa. Sorotan-kate perpustakaan Haskell digunakan untuk menyorot, yang
bekerja dalam output HTML, Docx, dan LaTeX/PDF. Skema warna dapat dipilih menggunakan
--sorotan-gaya pilihan. Skema warna default adalah pigmen, yang meniru
skema warna default yang digunakan oleh pygments library Python, tetapi pygments sebenarnya tidak
digunakan untuk melakukan penyorotan.
Untuk melihat daftar nama bahasa yang akan dikenali pandoc, ketik pandoc --version.
Untuk menonaktifkan penyorotan, gunakan opsi --no-highlight.
KUSTOM PENULIS
Pandoc dapat diperluas dengan penulis khusus yang ditulis dalam lua. (Pandoc termasuk lua
interpreter, jadi lua tidak perlu diinstal secara terpisah.)
Untuk menggunakan penulis kustom, cukup tentukan jalur ke skrip lua sebagai ganti output
format. Sebagai contoh:
pandoc -t data/sampel.lua
Membuat penulis kustom memerlukan penulisan fungsi lua untuk setiap elemen yang mungkin dalam a
dokumen pandoc. Untuk mendapatkan contoh terdokumentasi yang dapat Anda modifikasi sesuai dengan keinginan Anda
kebutuhan, lakukan
pandoc --print-default-data-file sampel.lua
PENULIS
© 2006-2015 John MacFarlane ([email dilindungi]). Dirilis di bawah GPL, versi 2 atau
lebih besar. Perangkat lunak ini tidak membawa jaminan apapun. (Lihat HAK CIPTA untuk selengkapnya
hak cipta dan pemberitahuan garansi.)
Kontributor termasuk Aaron Wolen, Albert Krewinkel, Alexander Kondratskiy, Alexander
Sulfrian, Alexander V Vershilov, Alfred Wechselberger, Andreas Low, Andrew Dunning,
Antoine Latter, Arata Mizuki, Arlo O'Keeffe, Artyom Kazak, Ben Gamari, Beni
Cherniavsky-Paskin, Bjorn Buckwalter, Bradley Kuhn, Brent Yorgey, Bryan O'Sullivan, B.
Scott Michel, Caleb McDaniel, Calvin Beck, Christoffer Ackelman, Christoffer Sawicki,
Clare Macrae, Clint Adams, Conal Elliott, Craig S.Bosma, Daniel Bergey, Daniel T.
Staal, David Lazar, David Röthlisberger, Denis Laxalde, Douglas Calvert, Douglas F.
Calvert, Eric Kow, Eric Seidel, Florian Eitel, François Gannaz, Freiric Barral, Fyodor
Sheremetyev, Gabor Pali, Gavin Beatty, Greg Maslov, Gregory Bataille, Greg Rundlett,
gwern, Gwern Branwen, Hans-Peter Deifel, Henry de Valence, Ilya V. Portnov, infinity0x,
Jaime Marquínez Ferrándiz, James Aspnes, Jamie F. Olson, Jan Larres, Jason Ronallo, Jeff
Arnold, Jeff Runningen, Jens Petersen, Jérémy Bobbio, Jesse Rosenthal, J. Lewis Muir, Joe
Hillenbrand, John MacFarlane, Jonas Smedegaard, Jonathan Daugherty, Josef Svenningsson,
Jose Luis Duran, Julien Cretel, Justin Bogner, Kelsey Hightower, Konstantin Zudov,
Lars-Dominik Braun, Luke Plant, Mark Szepieniec, Mark Wright, Masayoshi Takahashi, Matej
Kollar, Mathias Schenner, Matthew Pickering, Matthias CM Troffaes, Mauro Bieg, Max
Bolingbroke, Max Rydahl Andersen, Merijn Verstraaten, Michael Snoyman, Michael Thompson,
MinRK, Nathan Gass, Neil Mayhew, Nick Bart, Nicolas Kaiser, Nikolay Yakimov, nkalvi, Paulo
Tanimoto, Paul Rivier, Peter Wang, Philippe Ombredanne, Phillip Alday, Puneeth Chaganti,
qerub, Ralf Stephan, Recai Okta, rodja.trappe, RyanGlScott, Scott Morrison, Sergei
Trofimovich, Sergey Astanin, Shahbaz Youssefi, Shaun Attfield, shreevatsa.public, Simon
Hengel, Sumit Sahrawat, takahashim, thsutton, Tim Lin, Timothy Humphries, Todd Sifleet,
Tom Leese, Uli Köhler, Václav Zeman, Viktor Kronvall, Vincent, Wikiwide, dan Xavier Olive.
Kode sumber Pandoc dan semua dokumentasi dapat diunduh darihttp://pandoc.org>.
Gunakan pandoc online menggunakan layanan onworks.net
