pandoc-citeproc - Online di Cloud

PROGRAM:

NAMA

pandoc-citeproc - filter untuk menyelesaikan kutipan dalam dokumen pandoc.

RINGKASAN

pandoc-citeproc [opsi] [file..]

DESKRIPSI

Eksekusi pandoc-citeproc memiliki dua mode, mode filter dan mode konversi.

Filter mode
Jalankan tanpa opsi, ini bertindak sebagai filter yang mengambil dokumen Pandoc yang disandikan JSON,
memformat kutipan dan menambahkan bibliografi, dan mengembalikan dokumen pandoc yang disandikan JSON.
Kutipan akan diselesaikan, dan bibliografi akan dimasukkan ke dalam elemen Div dengan id
referensi Jika tidak ada Div seperti itu, satu akan dibuat dan ditambahkan ke akhir dokumen
(kecuali bidang metadata supresi-bibliografi disetel ke nilai sebenarnya). Jika Anda menginginkan
bibliografi untuk memiliki header bagian, letakkan header bagian di akhir dokumen Anda.
(Lihat halaman manual pandoc_markdown (5) di bawah "Kutipan" untuk detail tentang cara menyandikan
kutipan dalam penurunan harga pandoc.)

Untuk memproses kutipan dengan pandoc, panggil pandoc-citeproc sebagai filter:

pandoc --filter pandoc-citeproc masukan.md -s -o keluaran.html

pandoc-citeproc akan mencari bidang metadata berikut di input:

bibliografi
Jalur, atau daftar jalur YAML, dari file bibliografi yang akan digunakan. Ini mungkin ada di mana saja
format yang didukung oleh bibutil.

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 umumnya dapat digunakan dengan file BibTeX dan BibLaTeX, tetapi Anda
dapat menggunakan .bibtex untuk memaksa BibTeX.

referensi
Daftar referensi YAML. Setiap referensi adalah objek YAML. Formatnya adalah
pada dasarnya format CSL JSON. Berikut ini contohnya:

- ID: doe2006
penulis:
keluarga: Doe
diberikan: [John, F.]
judul : artikel
halaman: 33-34
dikabarkan:
tahun: 2006
jenis: artikel-jurnal
volume: 6
wadah-judul: Jurnal Studi Generik

Isi bidang akan ditafsirkan sebagai penurunan harga jika sesuai: jadi, untuk
contoh, penekanan dan penekanan kuat dapat digunakan dalam pengajuan judul. Matematika teks sederhana
juga akan diurai dan dirender dengan tepat.

csl or gaya kutipan
Jalur atau URL file gaya CSL. Jika file tidak ditemukan relatif terhadap pekerjaan
direktori, pandoc-citeproc akan mencari di direktori $HOME/.csl (atau
C:\Users\USERNAME\AppData\Roaming\csl di Windows 7). Jika ini dibiarkan,
pandoc-citeproc akan mencari $HOME/.pandoc/default.csl, dan jika ini bukan
sekarang, ia akan menggunakan chicago-author-date.csl, cari dulu di $HOME/.csl lalu
dalam file datanya sendiri.

tautan-kutipan
Jika ini memiliki nilai yang benar, kutipan dalam gaya penulis-tanggal dan numerik akan menjadi
hyperlink ke entri bibliografi yang sesuai. Standarnya bukan untuk menambahkan
hyperlink.

kutipan-singkatan
Jalur ke file JSON singkatan CSL. Jika file tidak ditemukan relatif terhadap
direktori kerja, pandoc-citeproc akan mencari di direktori $HOME/.csl (atau
C:\Users\USERNAME\AppData\Roaming\csl di Windows 7). Formatnya dijelaskan di sini
(http://citationstylist.org/2011/10/19/abbreviations-for-zotero-test-release).
Berikut adalah contoh singkatnya:

{ "bawaan": {
"judul wadah": {
"Laporan Hukum Lloyd": "Lloyd's Rep",
"Estates Gazette": "EG",
"Waktu Hukum Skotlandia": "SLT"
}
}
}

lang Lokal untuk digunakan dalam memformat kutipan. Jika ini tidak disetel, lokal diambil
dari atribut default-locale dari file CSL. en-US digunakan jika lokalnya adalah
tidak ditentukan dalam metadata atau file CSL. (Untuk mundur
kompatibilitas, lokal bidang dapat digunakan sebagai ganti lang, tetapi lang ini harus
digunakan ke depan.)

menekan-bibliografi
Jika ini memiliki nilai yang benar, daftar pustaka akan ditinggalkan. Jika tidak
bibliografi akan dimasukkan ke dalam setiap elemen Div dengan referensi id. Jika tidak ada
Div tersebut, satu akan dibuat di akhir dokumen.

referensi-bagian-judul
Jika ini memiliki nilai, header bagian dengan judul ini akan ditambahkan sebelum
bibliografi. Jika referensi-bagian-judul tidak ditentukan dan dokumen berakhir
dengan tajuk bagian, tajuk terakhir ini akan diperlakukan sebagai daftar pustaka
tajuk.

Metadata harus berisi referensi atau daftar pustaka atau keduanya sebagai sumber
referensi. csl dan citation-abbreviation adalah opsional. Jika csl tidak disediakan, a
stylesheet default akan digunakan (baik ~/.pandoc/default.csl atau versi dari
chicago-penulis-date.csl).

mengubah mode
Jika opsi --bib2yaml atau --bib2json digunakan, pandoc-citeproc tidak akan memproses
kutipan; sebagai gantinya, ia akan memperlakukan inputnya (dari stdin atau file) sebagai bibliografi dan
mengubahnya menjadi bagian metadata YAML pandoc, cocok untuk dimasukkan dalam pandoc
document (--bib2yaml), atau sebagai bibliografi CSL JSON, cocok untuk diimpor ke zotero
(--bib2json).

Opsi --format dapat digunakan untuk menentukan format bibliografi, meskipun ketika file
digunakan, pandoc-citeproc umumnya dapat menebak ini dari ekstensi.

Mode ini menggantikan program biblio2yaml yang lama.

PILIHAN

-H, --membantu
Mencetak informasi penggunaan.

-V, --Versi: kapan
Versi cetak.

-y, --bib2yaml
Konversi bibliografi ke YAML yang cocok untuk dimasukkan dalam metadata pandoc.

-J, --bib2json
Konversi bibliografi ke CSL JSON yang cocok untuk diimpor ke Zotero.

-f FORMAT, --format=FORMAT
Tentukan format bibliografi yang akan dikonversi. Nilai hukum adalah biblatex, bibtex,
ris, catatan akhir, endnotexml, isi, medline, copac, mods, dan json.

CATATAN

Umum
Jika Anda menggunakan database biblatex, ikuti dengan cermat spesifikasi di "Panduan Database"
bagian dari manual biblatex (saat ini 2.8a).

Jika Anda menggunakan database CSL-YAML atau CSL-JSON, atau bagian metadata CSL-YAML di
dokumen penurunan harga, ikuti "Spesifikasi Bahasa Gaya Kutipan 1.0.1 Bahasa"
(<http://citationstyles.org/downloads/specification.html>). Yang sangat relevan adalah
<http://citationstyles.org/downloads/specification.html#appendix-iii-types> (yang juga tidak
komentar tentang penggunaan atau menentukan bidang wajib dan opsional) dan
<http://citationstyles.org/downloads/specification.html#appendix-iv-variables> (yang tidak
berisi komentar).

Judul: Judul vs Kalimat Kasus
Jika Anda menggunakan bibtex atau biblatex bibliografi, maka perhatikan aturan berikut:

· Judul bahasa Inggris harus dalam kasus judul. Judul non-Inggris harus dalam kasus kalimat,
dan bidang langid di biblatex harus disetel ke bahasa yang relevan. (Pengikut
nilai diperlakukan sebagai bahasa Inggris: Amerika, Inggris, Kanada, Inggris, Australia,
Selandia baru, USenglish, atau UKenglish.)

· Seperti standar dengan bibtex/biblatex, nama yang tepat harus dilindungi dengan kurung kurawal
sehingga mereka tidak akan menjadi huruf kecil dalam gaya yang membutuhkan kasus kalimat. Sebagai contoh:

title = {Makan Malam Saya dengan {Andre}}

· Selain itu, kata-kata yang harus tetap huruf kecil (atau camelCase) harus dilindungi:

title = {Dispersi Gelombang Putar pada Skala {nm}}

Meskipun ini tidak diperlukan dalam bibtex/biblatex, ini diperlukan dengan citeproc, yang
menyimpan judul secara internal dalam kasus kalimat, dan mengkonversi ke kasus judul dalam gaya yang
membutuhkannya. Di sini kami melindungi "nm" agar tidak diubah menjadi "Nm" saat ini
panggung.

Jika Anda menggunakan bibliografi CSL (baik JSON atau YAML), maka perhatikan hal berikut:
aturan:

· Semua judul harus dalam kasus kalimat.

· Gunakan bidang bahasa untuk judul non-bahasa Inggris untuk mencegah konversi ke huruf besar/kecil
dalam gaya yang menyerukan ini. (Konversi hanya terjadi jika bahasa dimulai dengan en atau is
dibiarkan kosong.)

· Lindungi kata-kata yang tidak boleh diubah menjadi huruf besar dengan menggunakan sintaks ini:

Dispersi gelombang spin pada skala nm

Konferensi Dokumen, Diterbitkan vs Unpublished
Untuk makalah konferensi yang diterbitkan secara resmi, gunakan inproceedings jenis entri biblatex
(yang akan dipetakan ke konferensi kertas CSL).

Untuk manuskrip yang tidak diterbitkan, gunakan jenis entri biblatex tidak diterbitkan tanpa
bidang eventtitle (jenis entri ini akan dipetakan ke manuskrip CSL).

Untuk ceramah, makalah konferensi yang tidak diterbitkan, atau presentasi poster, gunakan biblatex
jenis entri tidak diterbitkan dengan bidang judul acara (jenis entri ini akan dipetakan ke CSL
pidato). Gunakan bidang jenis biblatex untuk menunjukkan jenisnya, misalnya "Kertas", atau "Poster".
tempat dan tanggal acara mungkin berguna juga, meskipun tanggal acara tidak akan dirender oleh sebagian besar CSL
gaya. Perhatikan bahwa tempat adalah untuk tempat acara, tidak seperti lokasi yang menggambarkan
lokasi penerbit; jangan gunakan yang terakhir untuk makalah konferensi yang tidak diterbitkan.

PENULIS

Andrea Rossato dan John MacFarlane.

Gunakan pandoc-citeproc online menggunakan layanan onworks.net