pandoc-citeproc - آنلاین در ابر

برنامه:

نام

pandoc-citeproc - فیلتر برای حل نقل قول ها در یک سند pandoc.

خلاصه

pandoc-citeproc [گزینه ها] [پرونده..]

شرح

فایل اجرایی pandoc-citeproc دارای دو حالت فیلتر حالت و حالت تبدیل است.

فیلتر حالت
بدون گزینه اجرا شود، به عنوان فیلتری عمل می کند که یک سند Pandoc رمزگذاری شده با JSON را می گیرد.
استنادها را قالب بندی می کند و یک کتابنامه اضافه می کند و یک سند pandoc کدگذاری شده با JSON را برمی گرداند.
نقل‌قول‌ها حل می‌شوند و کتاب‌شناسی با شناسه در یک عنصر Div درج می‌شود
مراجع اگر چنین Div وجود نداشته باشد، یکی ایجاد می شود و به انتهای سند اضافه می شود
(مگر اینکه فیلد فراداده suppress-bibliography روی مقدار واقعی تنظیم شده باشد). اگر مایل هستید
کتابشناسی برای داشتن سرصفحه بخش، سرصفحه بخش را در انتهای سند خود قرار دهید.
(برای جزئیات بیشتر در مورد نحوه رمزگذاری، به صفحه man pandoc_markdown (5) در زیر "Citations" مراجعه کنید.
نقل‌قول‌ها در علامت‌گذاری pandoc.)

برای پردازش نقل قول ها با pandoc، pandoc-citeproc را به عنوان فیلتر فراخوانی کنید:

pandoc -- فیلتر pandoc-citeproc input.md -s -o output.html

pandoc-citeproc فیلدهای ابرداده زیر را در ورودی جستجو می کند:

کتابشناسی
مسیر، یا فهرست YAML از مسیرها، از فایل های کتابشناسی برای استفاده. اینها ممکن است در هر کدام باشند
از فرمت های پشتیبانی شده توسط bibutils.

فرمت پسوند فایل
──────────────────
BibLaTeX .bib
BibTeX .bibtex
Copac .copac
CSL JSON .json
CSL YAML .yaml
EndNote .enl
EndNote XML .xml
ISI .wos
MEDLINE .medline
MODS .mods
RIS .ris

توجه داشته باشید که .bib به طور کلی می تواند با هر دو فایل BibTeX و BibLaTeX استفاده شود، اما شما
می تواند از .bibtex برای اجبار BibTeX استفاده کند.

منابع
فهرست YAML از مراجع. هر مرجع یک شی YAML است. فرمت است
اساسا فرمت CSL JSON. به عنوان مثال:

- شناسه: doe2006
نویسنده:
خانواده: گوزن
داده شده: [جان، اف.]
عنوان: مقاله
صفحه: 33-34
صادر شده:
سال: 2006
نوع: مقاله-ژورنال
حجم: 6
ظرف-عنوان: مجله مطالعات عمومی

محتویات فیلدها در صورت لزوم به عنوان علامت گذاری تفسیر می شود: بنابراین، برای
به عنوان مثال، تاکید و تاکید قوی را می توان در فایل های عنوان استفاده کرد. ریاضی متن ساده
همچنین به درستی تجزیه و ارائه خواهد شد.

CSL or به سبک نقل قول
مسیر یا URL یک فایل سبک CSL. اگر فایل نسبت به کار پیدا نشد
دایرکتوری، pandoc-citeproc در دایرکتوری $HOME/.csl (یا
C:\Users\USERNAME\AppData\Roaming\csl در ویندوز 7). اگر این کار کنار گذاشته شود،
pandoc-citeproc $HOME/.pandoc/default.csl را جستجو می کند، و اگر اینطور نیست
در حال حاضر، از chicago-author-date.csl استفاده خواهد کرد، ابتدا در $HOME/.csl و سپس
در فایل های داده خودش

پیوند-استنادها
اگر این مقدار واقعی باشد، نقل‌قول در سبک‌های تاریخ نویسنده و عددی خواهد بود
به مدخل های کتابشناسی مربوطه خود پیوند داده شده است. پیش فرض اضافه کردن نیست
لینک های پیوندی

استناد-اختصارات
مسیر یک فایل JSON مخفف CSL. اگر فایل نسبت به پیدا نشد
دایرکتوری کاری، pandoc-citeproc در دایرکتوری $HOME/.csl (یا
C:\Users\USERNAME\AppData\Roaming\csl در ویندوز 7). قالب در اینجا توضیح داده شده است
(http://citationstylist.org/2011/10/19/abbreviations-for-zotero-test-release).
در اینجا یک مثال کوتاه است:

{ "پیش فرض": {
"container-title": {
"گزارش های قانون لوید": "نماینده لویدز"،
"Estates Gazette": "EG"
"Scots Law Times": "SLT"
}
}
}

ارسال به دوست محلی برای استفاده در قالب بندی نقل قول ها. اگر این تنظیم نشده باشد، محلی گرفته می شود
از ویژگی پیش فرض محلی فایل CSL. en-US اگر محلی باشد استفاده می شود
در فراداده یا فایل CSL مشخص نشده است. (برای عقب
سازگاری، محلی فیلد را می توان به جای lang استفاده کرد، اما این زبان باید
در آینده مورد استفاده قرار گیرد.)

سرکوب-کتابشناسی
اگر این مقدار واقعی باشد، کتابشناسی کنار گذاشته می شود. در غیر این صورت الف
کتابشناسی در هر عنصر Div با id ref درج خواهد شد. اگر وجود ندارد
چنین Div، یکی در انتهای سند ایجاد خواهد شد.

مرجع-بخش-عنوان
اگر این مقدار داشته باشد، یک هدر بخش با این عنوان قبل از اضافه می شود
کتابشناسی - فهرست کتب. اگر مرجع-بخش-عنوان مشخص نشده باشد و سند به پایان برسد
با یک سرفصل بخش، این سرصفحه نهایی به عنوان کتابشناسی در نظر گرفته می شود
سرتیتر.

ابرداده باید شامل منابع یا کتابشناسی یا هر دو به عنوان منبع باشد
منابع. csl و citation-اختصارات اختیاری هستند. اگر csl ارائه نشده باشد، الف
از شیوه نامه پیش فرض استفاده خواهد شد (یا ~/.pandoc/default.csl یا نسخه ای از
chicago-author-date.csl).

تبدیل حالت
اگر از گزینه --bib2yaml یا --bib2json استفاده شود، pandoc-citeproc پردازش نمی کند
استناد؛ در عوض، ورودی خود را (از stdin یا فایل‌ها) به عنوان کتاب‌شناسی و
تبدیل آن به یک بخش فراداده YAML pandoc، مناسب برای گنجاندن در یک pandoc
سند (--bib2yaml)، یا به عنوان کتابنامه CSL JSON، مناسب برای وارد کردن به zotero
(--bib2json).

گزینه --format را می توان برای تعیین فرمت کتابشناسی، هرچند زمانی که فایل ها هستند، استفاده کرد
استفاده شده، pandoc-citeproc به طور کلی می تواند این را از پسوند حدس بزند.

این حالت جایگزین برنامه قدیمی biblio2yaml می شود.

OPTIONS

-h، --کمک
اطلاعات استفاده چاپ

-V، - نسخه
نسخه چاپی

-y، --bib2yaml
کتابشناسی را به YAML مناسب برای گنجاندن در فراداده pandoc تبدیل کنید.

-j، --bib2json
کتابشناسی را به CSL JSON مناسب برای وارد کردن به Zotero تبدیل کنید.

-f FORMAT, --فرمت=FORMAT
فرمت کتابشناسی برای تبدیل را مشخص کنید. ارزش های قانونی عبارتند از biblatex، bibtex،
ris، endnote، endnotexml، isi، medline، copac، mods و json.

NOTES

سوالات عمومی
اگر از پایگاه داده biblatex استفاده می کنید، مشخصات موجود در "راهنمای پایگاه داده" را به دقت دنبال کنید.
بخش کتابچه راهنمای biblatex (در حال حاضر 2.8a).

اگر از یک پایگاه داده CSL-YAML یا CSL-JSON یا یک بخش فراداده CSL-YAML در خود استفاده می کنید
سند علامت گذاری، "مشخصات زبان سبک نقل قول 1.0.1" را دنبال کنید
(<http://citationstyles.org/downloads/specification.html>). به خصوص مرتبط هستند
<http://citationstyles.org/downloads/specification.html#appendix-iii-types> (که هیچکدام
نظر در مورد استفاده و یا فیلدهای ضروری و اختیاری را مشخص نمی کند) و
<http://citationstyles.org/downloads/specification.html#appendix-iv-variables> (که انجام می دهد
حاوی نظرات).

عنوان: عنوان در مقابل حکم مورد
اگر از کتابشناسی bibtex یا biblatex استفاده می کنید، قوانین زیر را رعایت کنید:

· عناوین انگلیسی باید با حروف عنوان باشند. عناوین غیر انگلیسی باید در حروف جمله باشند،
و قسمت langid در biblatex باید روی زبان مربوطه تنظیم شود. (به شرح زیر
ارزش ها به عنوان انگلیسی در نظر گرفته می شوند: آمریکایی، بریتانیایی، کانادایی، انگلیسی، استرالیایی،
نیوزلند، ایالات متحده انگلیسی، یا بریتانیایی.)

· همانطور که در مورد bibtex/biblatex استاندارد است، نام های مناسب باید با بریس های مجعد محافظت شوند.
به طوری که در سبک هایی که حروف جمله را می طلبد کوچک نشوند. مثلا:

عنوان = {شام من با {آندره}}

· علاوه بر این، کلماتی که باید با حروف کوچک باقی بمانند (یا camelCase) باید محافظت شوند:

عنوان = {پراکندگی موج چرخشی در مقیاس {nm}}

اگرچه این در bibtex/biblatex ضروری نیست، اما با citeproc ضروری است
عناوین را به صورت داخلی در حروف جمله ذخیره می کند و در سبک هایی به حروف عنوان تبدیل می کند
آن را نیاز دارد. در اینجا ما از "nm" محافظت می کنیم تا در این زمان به "Nm" تبدیل نشود
مرحله.

اگر از کتابنامه CSL (JSON یا YAML) استفاده می کنید، موارد زیر را رعایت کنید
قوانین:

· تمام عناوین باید در حروف جمله باشند.

· از فیلد زبان برای عناوین غیرانگلیسی استفاده کنید تا از تبدیل آنها به حروف عنوان جلوگیری کنید
در سبک هایی که به این امر نیاز دارند. (تبدیل فقط در صورتی اتفاق می افتد که زبان با en یا is شروع شود
خالی بماند.)

· با استفاده از این نحو از کلماتی که نباید به حروف عنوان تبدیل شوند محافظت کنید:

پراکندگی موج اسپین در مقیاس نانومتر

کنفرانس اوراق، منتشر شده در مقابل منتشر نشده
برای مقاله کنفرانسی که به طور رسمی منتشر شده است، از نوع ورودی biblatex inproceedings استفاده کنید
(که به مقاله کنفرانس CSL نگاشت خواهد شد).

برای یک نسخه خطی منتشر نشده، از نوع ورودی biblatex منتشر نشده و بدون علامت استفاده کنید
فیلد عنوان رویداد (این نوع ورودی به دستنوشته CSL نگاشت خواهد شد).

برای سخنرانی، مقاله کنفرانس منتشر نشده یا ارائه پوستر، از biblatex استفاده کنید
نوع ورودی با یک قسمت عنوان رویداد منتشر نشده است (این نوع ورودی به CSL نگاشت می شود
سخن، گفتار). از فیلد نوع biblatex برای نشان دادن نوع استفاده کنید، به عنوان مثال "کاغذ" یا "پوستر".
مکان و تاریخ رویداد نیز ممکن است مفید باشند، اگرچه تاریخ رویداد توسط اکثر CSL ارائه نخواهد شد
سبک ها توجه داشته باشید که مکان برای محل برگزاری رویداد است، بر خلاف مکانی که توضیح می دهد
محل ناشر؛ از دومی برای مقاله کنفرانسی منتشر نشده استفاده نکنید.

AUTHORS

آندریا روساتو و جان مک فارلین.

از pandoc-citeproc به صورت آنلاین با استفاده از خدمات onworks.net استفاده کنید