باندوك - عبر الإنترنت في السحابة

برنامج:

اسم

pandoc - محول الترميز العام

موجز

باندوك [الخيارات] [ملف الإدخال] ...

الوصف

Pandoc هي مكتبة Haskell للتحويل من تنسيق ترميز إلى آخر ، وملف
أداة سطر الأوامر التي تستخدم هذه المكتبة. يمكنه قراءة Markdown و CommonMark و PHP Markdown
تخفيض السعر الإضافي ، GitHub-Flavored ، و (مجموعات فرعية) Textile ، reStructuredText ، HTML ، LaTeX ،
ترميز MediaWiki ، ترميز TWiki ، ترميز Haddock ، OPML ، وضع Emacs Org ، DocBook ، txt2tags ،
EPUB و ODT و Word docx ؛ ويمكنه كتابة نص عادي ، Markdown ، CommonMark ، PHP Markdown
Extra ، GitHub-Flavored Markdown ، reStructuredText ، XHTML ، HTML5 ، LaTeX (بما في ذلك مضخم الصوت)
عروض الشرائح) ، ConTeXt ، RTF ، OPML ، DocBook ، OpenDocument ، ODT ، Word docx ، GNU Texinfo ،
ترميز ميدياويكي ، ترميز DokuWiki ، ترميز Haddock ، EPUB (v2 أو v3) ، FictionBook2 ، Textile ،
صفحات groff man ، و Emacs Org mode ، و AsciiDoc ، و InDesign ICML ، و Slidy ، و Slideous ، و DZSlides ،
تكشف عن عروض شرائح HTML أو S5. يمكنه أيضًا إنتاج مخرجات PDF على الأنظمة التي يستخدم فيها LaTeX ،
تم تثبيت ConTeXt أو wkhtmltopdf.

تتضمن نسخة Pandoc المحسّنة من Markdown بنية الحواشي السفلية والجداول والمرنة
القوائم المرتبة ، قوائم التعريف ، كتل التعليمات البرمجية المسيجة ، النصوص المرتفعة والمنخفضة ،
الشطب ، كتل البيانات الوصفية ، جداول المحتويات التلقائية ، رياضيات LaTeX المضمنة ، الاقتباسات ،
و Markdown داخل عناصر كتلة HTML. (هذه التحسينات الموضحة أدناه
يمكن تعطيل Markdown الخاص بـ Pandoc باستخدام تنسيق الإدخال أو الإخراج markdown_strict.)

على عكس معظم الأدوات الموجودة لتحويل Markdown إلى HTML ، والتي تستخدم regex
البدائل ، pandoc لها تصميم معياري: فهو يتكون من مجموعة من القراء ، والتي تحلل
نص بتنسيق معين وإنتاج تمثيل أصلي للمستند ، ومجموعة من
الكتاب ، الذين يحولون هذا التمثيل الأصلي إلى تنسيق مستهدف. وبالتالي ، فإن إضافة ملف
يتطلب تنسيق الإدخال أو الإخراج إضافة قارئ أو كاتب فقط.

لأن تمثيل Pandoc الوسيط للمستند أقل تعبيرًا من العديد من ملفات
التنسيقات التي يتم التحويل بينها ، لا ينبغي للمرء أن يتوقع تحويلات مثالية بين كل
الشكل وكل الآخر. يحاول Pandoc الحفاظ على العناصر الهيكلية لـ
المستند ، ولكن ليس تفاصيل التنسيق مثل حجم الهامش. وبعض عناصر الوثيقة ،
مثل الجداول المعقدة ، قد لا تتناسب مع نموذج مستند Pandoc البسيط. بينما
التحويلات من Markdown في pandoc إلى جميع التنسيقات تطمح إلى أن تكون مثالية والتحويلات من
يمكن توقع أن تكون التنسيقات أكثر تعبيرًا من Markdown الخاصة بـ pandoc ضائعة.

باستخدام باندوك
إذا كانت الإجابة بلا ملف الإدخال محدد ، تتم قراءة الإدخال من ستدين. وإلا فإن ملفات الإدخال .
متسلسلة (مع وجود سطر فارغ بين كل منهما) واستخدامها كمدخل. يذهب الإخراج إلى المعياري by
الافتراضي (على الرغم من الإخراج إلى المعياري معطل لإخراج odt و docx و epub و epub3
تنسيقات). للإخراج إلى ملف ، استخدم الخيار -o:

باندوك -ooutput.html input.txt

بشكل افتراضي ، ينتج pandoc جزءًا من المستند ، وليس مستندًا منفردًا به ملف
رأس وتذييل الصفحة. لإنتاج مستند مستقل ، استخدم العلامة -s أو --standalone:

باندوك -s -ooutput.html input.txt

لمزيد من المعلومات حول كيفية إنتاج المستندات المستقلة ، راجع القوالب أدناه.

بدلاً من ملف ، يمكن إعطاء URI مطلق. في هذه الحالة ، سيقوم pandoc بإحضار ملف
المحتوى باستخدام HTTP:

pandoc -f html -t تخفيض السعر http://www.fsf.org

إذا تم تقديم ملفات إدخال متعددة ، فسيقوم pandoc بربطها جميعًا (بأسطر فارغة
بينهما) قبل الاعراب. تم تعطيل هذه الميزة لتنسيقات الإدخال الثنائية مثل
EPUB و odt و docx.

يمكن تحديد تنسيق المدخلات والمخرجات بشكل صريح باستخدام خيارات سطر الأوامر.
يمكن تحديد تنسيق الإدخال باستخدام -r / - read أو -f / - من الخيارات ، الإخراج
باستخدام خيارات -w / - write أو -t / - to. وبالتالي ، لتحويل hello.txt من Markdown
إلى LaTeX ، يمكنك كتابة:

pandoc -f تخفيض السعر -t اللاتكس hello.txt

لتحويل hello.html من HTML إلى Markdown:

pandoc -f html -t تخفيض السعر hello.html

يتم سرد تنسيقات الإخراج المدعومة أدناه ضمن الخيار -t / - to. المدخلات المدعومة
يتم سرد التنسيقات أدناه تحت الخيار -f / - from. لاحظ أن أول نسيج ، لاتكس ،
وقارئات html ليست كاملة ؛ هناك بعض التركيبات التي لا تحللها.

إذا لم يتم تحديد تنسيق الإدخال أو الإخراج بشكل صريح ، فسيحاول pandoc تخمينه
من امتدادات أسماء ملفات الإدخال والإخراج. وهكذا ، على سبيل المثال ،

باندوك -o hello.tex hello.txt

سيحول hello.txt من Markdown إلى LaTeX. إذا لم يتم تحديد ملف الإخراج (بحيث
يذهب الإخراج إلى المعياري) ، أو إذا كان امتداد ملف الإخراج غير معروف ، تنسيق الإخراج
سوف افتراضيًا إلى HTML. إذا لم يتم تحديد ملف إدخال (بحيث يأتي هذا الإدخال من ستدين)، أو
إذا كانت امتدادات ملفات الإدخال غير معروفة ، فسيتم افتراض أن تنسيق الإدخال هو
تخفيض السعر ما لم ينص صراحة.

يستخدم Pandoc ترميز أحرف UTF-8 لكل من الإدخال والإخراج. إذا كان لديك المحلية
ترميز الأحرف ليس UTF-8 ، يجب عليك توجيه الإدخال والإخراج من خلال iconv:

iconv -t utf-8 input.txt | باندوك | iconv -f utf-8

لاحظ أنه في بعض تنسيقات الإخراج (مثل HTML و LaTeX و ConTeXt و RTF و OPML و DocBook و
Texinfo) ، يتم تضمين معلومات حول ترميز الأحرف في رأس المستند ،
والذي سيتم تضمينه فقط إذا كنت تستخدم الخيار المستقل -s / -.

خلق a PDF
لإنتاج ملف PDF ، حدد ملف الإخراج بامتداد .pdf. افتراضيا ، سوف pandoc
استخدم LaTeX لتحويله إلى PDF:

اختبار باندوك.txt -o test.pdf

يتطلب إنتاج ملف PDF تثبيت محرك LaTeX (انظر - محرك لاتكس أدناه) ،
وتفترض أن حزم LaTeX التالية متوفرة: amsfonts و amsmath و lm و
ifxetex ، ifluatex ، eurosym ، القوائم (إذا تم استخدام خيار القوائم) ، fancyvrb ،
longtable و booktabs و Graphicx و grffile (إذا كان المستند يحتوي على صور) و hyperref و
ulem ، والهندسة (مع مجموعة المتغيرات الهندسية) ، و setpace (مع Linestretch) ، و babel
(مع لانج). يتطلب استخدام xelatex أو lualatex كمحرك LaTeX استخدام fontspec ؛
يستخدم xelatex mathspec و polyglossia (مع lang) و xecjk و bidi (مع متغير dir
تعيين). يتم استخدام حزم upquote و microtype إذا كانت متوفرة ، وسيتم استخدام csquotes
لعلامات الترقيم الذكية إذا تمت إضافتها إلى القالب أو تضمينها في أي ملف رأس. ال
يمكن استخدام حزم natbib و biblatex و bibtex و biber اختياريًا للاقتباس
استدعاء. يتم تضمين هذه مع جميع الإصدارات الحديثة من TeX Live.

بدلاً من ذلك ، يمكن لـ pandoc استخدام ConTeXt أو wkhtmltopdf لإنشاء ملف PDF. للقيام بذلك ، حدد
ملف إخراج بامتداد .pdf ، كما كان من قبل ، ولكن أضف سياق -t أو -t html5 إلى ملف
سطر الأوامر.

يمكن التحكم في إخراج PDF باستخدام متغيرات LaTeX (إذا تم استخدام LaTeX) والمتغيرات
لـ ConTeXt (إذا تم استخدام ConTeXt). إذا تم استخدام wkhtmltopdf ، فإن المتغيرات margin-left ،
سيؤثر margin-right و margin-top و margin-bottom و paperize على الإخراج ، كما هو الحال
--css.

OPTIONS

أسئلة عامة الخيارات
-f FORMAT, -r FORMAT, - من =FORMAT, - مقروء =FORMAT
حدد تنسيق الإدخال. FORMAT يمكن أن يكون أصليًا (أصلي Haskell) ، json (إصدار JSON من
الأصلي AST) ، تخفيض السعر (Markdown الموسعة لـ pandoc) ، markdown_strict (الأصلي
Markdown غير الممتد) ، markdown_phpextra (PHP Markdown Extra) ، markdown_github
(GitHub-Flavored Markdown) ، Commonmark (CommonMark Markdown) ، المنسوجات (Textile) ،
rst (reStructuredText) ، html (HTML) ، docbook (DocBook) ، t2t (txt2tags) ، docx
(docx) و odt (ODT) و epub (EPUB) و opml (OPML) و org (Emacs Org mode) و mediawiki
(ترميز ميدياويكي) ، تويكي (ترميز تويكي) ، حدوك (ترميز هادوك) ، أو لاتكس
(مطاط). إذا تم إلحاق + lhs بالعلامة التجارية أو الأولى أو اللاتكس أو html ، فسيكون الإدخال
تمت معاملته كمصدر متعلم هاسكل: انظر دعم القراءة والكتابة هاسكل أدناه. تخفيض السعر
يمكن تمكين ملحقات بناء الجملة أو تعطيلها بشكل فردي عن طريق إلحاق + تمديد
أو - EXTENSION إلى اسم التنسيق. لذلك ، على سبيل المثال ،
markdown_strict + footnotes + definition_lists هو Markdown صارم مع الحواشي السفلية و
تم تمكين قوائم التعريف ، و markdown-pipe_tables + hard_line_breaks هو pandoc's
تخفيض السعر بدون جداول الأنابيب ومع فواصل الأسطر الصلبة. انظر Markdown في Pandoc ،
أدناه ، للحصول على قائمة الامتدادات وأسمائها.

-t FORMAT, -w FORMAT, --إلى =FORMAT, - كتابة =FORMAT
حدد تنسيق الإخراج. FORMAT يمكن أن يكون أصليًا (أصلي Haskell) ، json (إصدار JSON
من AST الأصلي) ، عادي (نص عادي) ، تخفيض السعر (Markdown الموسع لـ pandoc) ،
markdown_strict (Markdown الأصلي غير الممتد) ، markdown_phpextra (PHP Markdown
Extra) ، markdown_github (GitHub-Flavored Markdown) ، Commonmark (CommonMark
Markdown) ، rst (reStructuredText) ، html (XHTML) ، html5 (HTML5) ، لاتكس (LaTeX) ،
المتعاطي (عرض شرائح LaTeX) ، السياق (ConTeXt) ، رجل (رجل groff) ، ميدياويكي
(MediaWiki markup) ، dokuwiki (DokuWiki markup) ، النسيج (Textile) ، org (Emacs Org
mode) ، texinfo (GNU Texinfo) ، opml (OPML) ، docbook (DocBook) ، opendocument
(OpenDocument) ، odt (مستند نصي OpenOffice) ، docx (Word docx) ، حدوك (Haddock)
markup) ، rtf (تنسيق نص منسق) ، epub (كتاب EPUB v2) ، epub3 (EPUB v3) ، fb2
(FictionBook2 e-book)، asciidoc (AsciiDoc)، icml (InDesign ICML)، Slidy (Slidy HTML
وعرض شرائح جافا سكريبت) ، سلايدوس ​​(عرض شرائح HTML وجافا سكريبت) ،
dzslides (عرض شرائح DZSlides HTML5 + javascript) ، يكشف عن js (يكشف .js HTML5 +
عرض شرائح جافا سكريبت) أو s5 (عرض شرائح بتنسيق HTML وجافا سكريبت S5) أو مسار
كاتب lua مخصص (انظر الكتاب المخصصين أدناه). لاحظ أن odt و epub و epub3
لن يتم توجيه الإخراج إلى المعياري؛ يجب تحديد اسم ملف الإخراج باستخدام
الخيار -o / - الإخراج. إذا تم إلحاق + lhs بالعلامة التجارية ، rst ، latex ، beamer ، html ،
أو html5 ، سيتم تقديم الإخراج كمصدر هاسكل متعلم: انظر القراءة والكتابة
دعم هاسكل ، أدناه. يمكن تمكين ملحقات بناء الجملة Markdown بشكل فردي أو
تم تعطيله من خلال إلحاق + EXTENSION أو -EXTENSION باسم التنسيق ، كما هو موضح
فوق تحت -f.

-o FILE, - الخرج =FILE
كتابة الإخراج إلى FILE بدلا من المعياري. إذا FILE هو - ، سيذهب الإخراج إلى المعياري.
(استثناء: إذا كان تنسيق الإخراج هو odt أو docx أو epub أو epub3 ، فإن الإخراج إلى stdout هو
عاجز.)

--data-dir =الدليل
حدد دليل بيانات المستخدم للبحث عن ملفات بيانات pandoc. إذا كان هذا الخيار
غير محدد ، سيتم استخدام دليل بيانات المستخدم الافتراضي. هذا في Unix:

$ HOME / .pandoc

في نظام التشغيل Windows XP:

C: \ Documents And Settings \ USERNAME \ Application Data \ pandoc

وفي نظام التشغيل Windows Vista أو أحدث:

C: \ Users \ USERNAME \ AppData \ Roaming \ pandoc

يمكنك العثور على دليل بيانات المستخدم الافتراضي على نظامك من خلال النظر في ملف
إخراج pandoc - الإصدار. مرجع.odt ، reference.docx ، epub.css ، قوالب ،
سيؤدي وضع الدليل المنزلق أو المنزلق أو s5 في هذا الدليل إلى تجاوز ملفات pandoc
الافتراضات العادية.

- باش - انجاز
إنشاء برنامج نصي لإكمال bash. لتمكين إكمال bash باستخدام pandoc ، أضف هذا
إلى bashrc الخاص بك:

Eval "$ (pandoc - bash-complete)"

- الإسراف
إعطاء إخراج التصحيح المطول. حاليًا هذا له تأثير فقط مع إخراج PDF.

-الخامس، --الإصدار
النسخة المطبوعة.

-ح ، --مساعدة
إظهار رسالة الاستخدام.

قارئ الخيارات
-R ، - خام
تحليل أكواد HTML غير القابلة للترجمة وبيئات LaTeX على هيئة HTML خام أو LaTeX ،
بدلا من تجاهلهم. يؤثر فقط على إدخال HTML و LaTeX. يمكن أن يكون Raw HTML
مطبوعة في Markdown ، و reStructuredText ، و HTML ، و Slidy ، و Slideous ، و DZSlides ، و يكشف.
و S5 الإخراج ؛ يمكن طباعة LaTeX الخام في Markdown و reStructuredText و LaTeX و
إخراج ConTeXt. الإعداد الافتراضي هو أن يحذف القراء أكواد HTML غير القابلة للترجمة
وبيئات LaTeX. (يمر قارئ LaTeX عبر LaTeX غير القابل للترجمة
الأوامر، حتى لو لم يتم تحديد -R.)

-س، --ذكي
إنتاج مخرجات صحيحة مطبعيًا ، وتحويل علامات الاقتباس المستقيمة إلى علامات اقتباس منحنية ،
- إلى شرطات em ، و - إلى شرطات ، و ... إلى علامات حذف. المساحات غير المنقسمة
يتم إدراجه بعد اختصارات معينة ، مثل "Mr." (ملاحظة: تم تحديد هذا الخيار
تلقائيًا عندما يكون تنسيق الإخراج عبارة عن مادة لاتكس أو سياق ، ما لم يكن - no-tex-ligatures
يستخدم. ليس له تأثير على إدخال اللاتكس.)

- شرطات قديمة
تحديد سلوك pandoc <= 1.8.2.1 لتحليل الشرطات الذكية: - قبل أي رقم
هي واصلة قصيرة ، و- هي شرطة طويلة. يتم تحديد هذا الخيار تلقائيًا لـ
مدخلات النسيج.

- مستوى الرأس الأساسي =عدد
حدد المستوى الأساسي للرؤوس (الافتراضي إلى 1).

- مسافات بين فئات الكود =الطبقات
حدد الفئات المراد استخدامها لمجموعات التعليمات البرمجية ذات المسافات البادئة - على سبيل المثال ، perl أو numberLines أو
هاسكل. يمكن فصل الفئات المتعددة بمسافات أو فواصل.

- امتداد الصورة الافتراضي =تمديد
حدد امتدادًا افتراضيًا لاستخدامه عندما لا تحتوي مسارات الصور / عناوين URL على امتداد. هذا
يسمح لك باستخدام نفس المصدر للتنسيقات التي تتطلب أنواعًا مختلفة من
الصور. لا يؤثر هذا الخيار حاليًا إلا على قارئي Markdown و LaTeX.

- عامل التصفية =تنفيذ
حدد ملفًا تنفيذيًا لاستخدامه كمرشح يحول pandoc AST بعد
يتم تحليل الإدخال وقبل كتابة الإخراج. يجب أن يقرأ الملف التنفيذي JSON
من stdin واكتب JSON إلى stdout. يجب تنسيق JSON مثل تنسيق pandoc الخاص
إدخال وإخراج JSON. سيتم تمرير اسم تنسيق الإخراج إلى عامل التصفية
كحجة أولى. لذلك،

pandoc - مرشح ./caps.py -t اللاتكس

ما يعادل

pandoc -t json | ./caps.py اللاتكس | pandoc -f json -t اللاتكس

قد يكون النموذج الأخير مفيدًا لتصحيح أخطاء عوامل التصفية.

يمكن كتابة المرشحات بأي لغة. Text.JSON يصدر إلى JSONFilter إلى
تسهيل كتابة المرشحات في هاسكل. أولئك الذين يفضلون كتابة المرشحات
يمكن للبايثون استخدام فلاتر باندوكفليتر الوحدة النمطية ، والتي يمكن تثبيتها من PyPI. هناك أيضا
مكتبات تصفية pandoc في PHP و perl و javascript / node.js.

نلاحظ أن تنفيذ سيتم البحث عنه في مسار المستخدم ، وليس في العمل
الدليل ، إذا لم يتم توفير دليل. إذا كنت ترغب في تشغيل برنامج نصي في العمل
الدليل ، استهل اسم الملف بـ./.

-M KEY[=فال], - البيانات الوصفية =KEY[:فال]
قم بتعيين حقل البيانات الوصفية KEY إلى القيمة فال. قيمة محددة في سطر الأوامر
يتجاوز قيمة محددة في الوثيقة. سيتم تحليل القيم على أنها YAML منطقية
أو قيم السلسلة. إذا لم يتم تحديد قيمة ، فسيتم التعامل مع القيمة على أنها قيمة منطقية
حقيقي. مثل - المتغير ، - البيانات الوصفية تؤدي إلى تعيين متغيرات القالب. ولكن خلافا ل
- متغير ، - تؤثر البيانات الوصفية على البيانات الوصفية للمستند الأساسي (وهو
يمكن الوصول إليها من المرشحات ويمكن طباعتها في بعض تنسيقات الإخراج).

- تطبيع
تسوية المستند بعد القراءة: دمج عناصر Str أو Emph المتجاورة ، لـ
على سبيل المثال ، وإزالة المسافات المكررة.

-p ، - علامات تبويب الحفظ
احتفظ بعلامات التبويب بدلاً من تحويلها إلى مسافات (الافتراضي). لاحظ أن هذا
سيؤثر فقط على علامات التبويب في امتدادات الكود الحرفي وكتل الكود ؛ علامات التبويب في النص العادي
سيتم التعامل معها على أنها مسافات.

- توقف علامة التبويب =عدد
حدد عدد المسافات لكل علامة تبويب (الافتراضي هو 4).

--track-Changes = قبول | رفض | الكل
يحدد ما يجب فعله مع عمليات الإدراج والحذف التي ينتجها مسار MS Word
التغييرات ". قبول (الافتراضي) ، وإدراج جميع الإدخالات ، وتجاهل الكل
الحذف. يُدرج رفض جميع عمليات الحذف ويتجاهل عمليات الإدراج. كل ما يضع في كليهما
عمليات الإدراج والحذف ، ملفوفة في مسافات مع فئات الإدراج والحذف ،
على التوالى. يتم تضمين المؤلف ووقت التغيير. كل ما هو مفيد ل
البرمجة النصية: قبول التغييرات فقط من مراجع معين ، على سبيل المثال ، أو قبل شخص معين
تاريخ. يؤثر هذا الخيار على قارئ docx فقط.

- وسائط المستخلص =DIR
استخرج الصور والوسائط الأخرى الموجودة في حاوية docx أو epub إلى المسار
DIR، وإنشائه إذا لزم الأمر ، وضبط مراجع الصور في المستند بذلك
يشيرون إلى الملفات المستخرجة. لا يؤثر هذا الخيار إلا على docx و epub
القراء.

أسئلة عامة كاتب الخيارات
-س، --مستقل
إنتاج مخرجات برأس وتذييل مناسبين (على سبيل المثال HTML مستقل ،
ملف LaTeX أو RTF ، وليس جزءًا). يتم تعيين هذا الخيار تلقائيًا لـ pdf ،
epub و epub3 و fb2 و docx و odt الإخراج.

- القالب =FILE
استعمل FILE كقالب مخصص للمستند الذي تم إنشاؤه. يوحي - مستقل.
انظر القوالب أدناه للحصول على وصف لبناء جملة القالب. إذا لم يكن هناك امتداد
المحدد ، سيتم إضافة امتداد مطابق للكاتب ، بحيث
--template = مظاهر خاصة عن special.html لمخرجات HTML. إذا لم يكن النموذج
تم العثور عليه ، سيبحث Pandoc عنه في الدليل الفرعي للقوالب لبيانات المستخدم
الدليل (انظر --data-dir). إذا لم يتم استخدام هذا الخيار ، فهو نموذج افتراضي
سيتم استخدام المناسب لتنسيق الإخراج (انظر - D / - print-default-template).

-V KEY[=فال], - متغير =KEY[:فال]
اضبط متغير القالب KEY إلى القيمة فال عند تقديم المستند بتنسيق
وضع مستقل. يكون هذا مفيدًا بشكل عام فقط عند استخدام الخيار --template
لتحديد قالب مخصص ، حيث يقوم pandoc تلقائيًا بتعيين المتغيرات المستخدمة في
القوالب الافتراضية. إذا كان الجواب لا فال محددًا ، سيتم إعطاء المفتاح القيمة
صحيح.

-D FORMAT, - print-default-template =FORMAT
اطبع نموذج النظام الافتراضي للمخرجات FORMAT. (انظر -t للحصول على قائمة
ممكن FORMATs.) يتم تجاهل القوالب الموجودة في دليل بيانات المستخدم.

- print-default-data-file =FILE
اطبع ملف بيانات افتراضي للنظام. يتم تجاهل الملفات الموجودة في دليل بيانات المستخدم.

- نقطة في البوصة =عدد
حدد قيمة dpi (نقاط لكل بوصة) للتحويل من بكسل إلى
بوصة / سم والعكس صحيح. الافتراضي هو 96 ديسيبل متوحد الخواص. من الناحية الفنية ، الصحيح
سيكون المصطلح نقطة في البوصة (بكسل لكل بوصة).

- التفاف = [تلقائي | لا شيء | حفظ]
تحديد كيفية التفاف النص في الإخراج (رمز المصدر ، وليس العرض
إصدار). باستخدام auto (الافتراضي) ، سيحاول pandoc التفاف الأسطر على العمود
العرض المحدد بواسطة - الأعمدة (الافتراضي 80). بدون أي شيء ، لن يقوم Pandoc بلف الخطوط
على الاطلاق. مع الاحتفاظ ، سيحاول pandoc الحفاظ على الغلاف من ملف
وثيقة المصدر (أي حيث توجد أسطر جديدة غير ذات دلالة في المصدر ، هناك
ستكون أسطرًا جديدة غير ذات دلالة في الإخراج أيضًا).

- لا التفاف
مرادف مهمل لـ --wrap = none.

- أعمدة =عدد
حدد طول الأسطر بالأحرف (لالتفاف النص). هذا يؤثر فقط على
تم إنشاء شفرة المصدر ، وليس التخطيط على الصفحة المعروضة.

--toc ، --جدول المحتويات
قم بتضمين جدول محتويات تم إنشاؤه تلقائيًا (أو ، في حالة اللاتكس ،
السياق ، وأول تعليمات لإنشاء واحد) في المستند الناتج. هذا
الخيار ليس له تأثير على إخراج man أو docbook أو slidy أو slideous أو s5 أو docx أو odt.

- عمق التحويل =عدد
حدد عدد مستويات الأقسام المراد تضمينها في جدول المحتويات. ال
الافتراضي هو 3 (مما يعني أنه سيتم إدراج رؤوس المستوى 1 و 2 و 3 في ملف
محتويات).

- لا تسليط الضوء
لإيقاف تمييز بناء الجملة لمجموعات التعليمات البرمجية والمضمنة ، حتى عند وجود لغة
السمة تعطى.

- تسليط الضوء على النمط =STYLE
يحدد نمط التلوين الذي سيتم استخدامه في كود المصدر المميز. الخيارات
pygments (الافتراضي) و kate و monochrome و espresso و zenburn و haddock و tango.
لمزيد من المعلومات حول تمييز بناء الجملة في pandoc ، راجع تمييز بناء الجملة ،
أدناه.

-H FILE, - تضمين في الرأس =FILE
تضمين محتويات FILE، حرفيا ، في نهاية الرأس. يمكن استخدام هذا ،
على سبيل المثال ، لتضمين CSS خاص أو جافا سكريبت في مستندات HTML. هذا الخيار
يمكن استخدامها بشكل متكرر لتضمين عدة ملفات في الرأس. سيكونون
المدرجة في الترتيب المحدد. يوحي - مستقل.

-B FILE, - تشمل ما قبل الجسم =FILE
تضمين محتويات FILE، حرفيا ، في بداية نص الوثيقة (على سبيل المثال ،
بعد في HTML ، أو الأمر \ start {document} في LaTeX). هذا يمكن
تستخدم لتضمين أشرطة التنقل أو اللافتات في مستندات HTML. هذا الخيار يمكن
يتم استخدامها بشكل متكرر لتضمين ملفات متعددة. سيتم تضمينها في الطلب
محدد. يوحي - مستقل.

-A FILE, - بما في ذلك ما بعد الجسم =FILE
تضمين محتويات FILE، حرفيًا ، في نهاية نص المستند (قبل ملف
في HTML ، أو الأمر \ end {document} في LaTeX). يمكن أن يكون هذا الخيار
يتم استخدامها بشكل متكرر لتضمين ملفات متعددة. سيتم تضمينها في الطلب
محدد. يوحي - مستقل.

مزيد من الخيارات تؤثر محدد الكتاب
- قائمة بذاتها
قم بإنشاء ملف HTML مستقل بدون تبعيات خارجية ، باستخدام البيانات: URIs to
دمج محتويات النصوص وأوراق الأنماط والصور ومقاطع الفيديو المرتبطة. ال
يجب أن يكون الملف الناتج "مكتفيًا ذاتيًا" بمعنى أنه لا يحتاج إلى خارجي
الملفات وعدم الوصول إلى الشبكة ليتم عرضها بشكل صحيح بواسطة المستعرض. يعمل هذا الخيار
فقط مع تنسيقات إخراج HTML ، بما في ذلك html ، و html5 ، و html + lhs ، و html5 + lhs ، و s5 ،
انزلاقي ، منزلق ، dzslides ، وكشف. النصوص والصور وأوراق الأنماط في
سيتم تنزيل عناوين URL المطلقة ؛ سيتم البحث عن تلك الموجودة في عناوين URL ذات الصلة بالنسبة إلى
دليل العمل (إذا كان الملف المصدر الأول محليًا) أو متعلقًا بالقاعدة
URL (إذا كان الملف المصدر الأول بعيدًا). القيد: الموارد التي تم تحميلها
ديناميكيًا من خلال JavaScript لا يمكن دمجه ؛ نتيجة ل،
- لا تعمل القائمة بذاتها مع --mathjax ، وبعض الميزات المتقدمة (على سبيل المثال
تكبير / تصغير أو ملاحظات المحاضر) في شريحة إظهار "قائمة بذاتها" في وضع عدم الاتصال
المعرض.

- html-q-tags
استخدم العلامات للاقتباسات في HTML.

--ascii
استخدم فقط أحرف أسكي في الإخراج. مدعوم حاليًا لمخرجات HTML فقط
(الذي يستخدم الكيانات الرقمية بدلاً من UTF-8 عند تحديد هذا الخيار).

- روابط مرجعية
استخدم روابط نمط المرجع ، بدلاً من الروابط المضمنة ، في كتابة Markdown أو
reStructuredText. يتم استخدام الروابط المضمنة بشكل افتراضي.

- رؤوس الاتكس
استخدم رؤوس نمط ATX في إخراج Markdown و asciidoc. الافتراضي هو استخدام
رؤوس setext-style للمستويات 1-2 ، ثم رؤوس ATX.

- فصول
تعامل مع رؤوس المستوى الأعلى كفصول في إخراج LaTeX و ConTeXt و DocBook. متى
تم تعيين فئة مستند LaTeX على تقرير أو كتاب أو مذكرات ، وهذا الخيار ضمني.
إذا كان المشعاع هو تنسيق الإخراج ، فإن رؤوس المستوى الأعلى ستصبح \ جزء {..}.

-ن، --عدد الأقسام
عناوين قسم الأرقام في إخراج LaTeX أو ConTeXt أو HTML أو EPUB. بشكل افتراضي،
الأقسام غير مرقمة. الأقسام ذات الفئة غير المرقمة لن يتم ترقيمها أبدًا ،
حتى إذا تم تحديد - عدد الأقسام.

- رقم الإزاحة =عدد[,عدد, ]
الإزاحة لعناوين الأقسام في إخراج HTML (يتم تجاهلها في تنسيقات الإخراج الأخرى). ال
يضاف الرقم الأول إلى رقم القسم لرؤوس المستوى الأعلى ، ويضاف الرقم الثاني إلى
رؤوس المستوى الثاني ، وما إلى ذلك. لذلك ، على سبيل المثال ، إذا كنت تريد المستوى الأعلى الأول
رأس في وثيقتك ليتم ترقيمها "6" ، حدد --number-offset = 5. إذا كان لديك
يبدأ المستند برأس المستوى 2 الذي تريد ترقيمه "1.5" ، حدد
- رقم الإزاحة = 1,4،0. الإزاحات هي XNUMX بشكل افتراضي. يعني - عدد المقاطع.

--لا تكس - الأربطة
لا تستخدم حروف الربط TeX لعلامات الاقتباس والفواصل العليا والشرطات (`` ... '،
".. '' ، - ، -) عند كتابة أو قراءة LaTeX أو ConTeXt. في قراءة LaTeX ، تحليل
الأحرف "و" و- حرفياً ، بدلاً من تحليل الحروف المركبة للاقتباس
علامات وشرطات. في كتابة LaTeX أو ConTeXt ، اطبع علامة اقتباس يونيكود و
شرطة الأحرف حرفيًا ، بدلاً من تحويلها إلى ASCII TeX القياسي
الأربطة. ملاحظة: عادةً ما يتم تحديد --smart تلقائيًا لـ LaTeX و ConTeXt
الإخراج ، ولكن يجب تحديده بشكل صريح إذا تم تحديد - no-tex-ligatures. لو
يمكنك استخدام علامات الاقتباس المتعرجة والشرطات والأشكال البيضاوية في مصدرك ، ثم يمكنك ذلك
تريد استخدام حروف مركبة - no-tex-without --smart.

- القوائم
استخدم حزمة القوائم لمجموعات أكواد LaTeX

-أنا، --تدريجي
جعل عناصر القائمة في عروض الشرائح تُعرض بشكل متزايد (واحدًا تلو الآخر). الافتراضي هو
لعرض القوائم كلها مرة واحدة.

- مستوى الانزلاق =عدد
يحدد أن الرؤوس ذات المستوى المحدد تُنشئ شرائح (للمشترك ، s5 ،
منزلق ، منزلق ، dzslides). يتم استخدام الرؤوس فوق هذا المستوى في التسلسل الهرمي
تقسيم عرض الشرائح إلى أقسام ؛ الرؤوس الموجودة أسفل هذا المستوى تنشئ عناوين فرعية
داخل شريحة. الإعداد الافتراضي هو تعيين مستوى الشريحة بناءً على محتويات ملف
وثيقة؛ انظر هيكلة عرض الشرائح.

- قسم- divs
أقسام التفاف في العلامات (أو العلامات في HTML5) ، وإرفاق المعرفات بـ
المرفق (أو ) بدلاً من العنوان نفسه. انظر رأس
المعرفات أدناه.

--email-obfuscation = لا شيء | جافا سكريبت | مراجع
حدد طريقة لإخفاء روابط mailto: في مستندات HTML. لا شيء يترك
mailto: الروابط كما هي. جافا سكريبت تحجبهم باستخدام جافا سكريبت.
المراجع تحجبها عن طريق طباعة أحرفها على شكل رقم عشري أو سداسي عشري
مراجع الأحرف. الافتراضي هو جافا سكريبت.

--id- بادئة =STRING
حدد بادئة لتتم إضافتها إلى جميع المعرفات التي يتم إنشاؤها تلقائيًا في HTML و
إخراج DocBook ، وإلى أرقام الحواشي السفلية في إخراج Markdown. هذا مفيد ل
منع المعرفات المكررة عند إنشاء أجزاء ليتم تضمينها في أخرى
الصفحات.

-T STRING, - العنوان-بادئة =STRING
تحديد STRING كبادئة في بداية العنوان الذي يظهر في HTML
header (ولكن ليس في العنوان كما يظهر في بداية نص HTML).
يوحي - مستقل.

-c URL, --css =URL
ارتباط بورقة أنماط CSS. يمكن استخدام هذا الخيار بشكل متكرر للتضمين
ملفات متعددة. سيتم تضمينها في الترتيب المحدد.

- المرجع- odt =FILE
استخدم الملف المحدد كمرجع نمط في إنتاج ODT. لأفضل النتائج،
يجب أن تكون ODT المرجعية نسخة معدلة من ODT يتم إنتاجها باستخدام pandoc.
يتم تجاهل محتويات مرجع ODT ، ولكن يتم استخدام أوراق الأنماط الخاصة به في ملف
ODT الجديد. إذا لم يتم تحديد مرجع ODT في سطر الأوامر ، فسيظهر pandoc
للحصول على ملف reference.odt في دليل بيانات المستخدم (انظر --data-dir). إن كان هذا
غير موجود أيضًا ، سيتم استخدام الإعدادات الافتراضية المعقولة.

- المرجع- docx =FILE
استخدم الملف المحدد كمرجع نمط في إنتاج ملف docx. للافضل
النتائج ، يجب أن يكون المرجع docx نسخة معدلة من ملف docx الذي تم إنتاجه
باستخدام pandoc. يتم تجاهل محتويات المرجع docx ، ولكن يتم تجاهل أوراق الأنماط الخاصة به
وخصائص المستند (بما في ذلك الهوامش وحجم الصفحة والرأس والتذييل)
في ملف docx الجديد. إذا لم يتم تحديد مرجع docx في سطر الأوامر ، فإن pandoc
سيبحث عن ملف reference.docx في دليل بيانات المستخدم (انظر --data-dir).
إذا لم يتم العثور على هذا أيضًا ، فسيتم استخدام الإعدادات الافتراضية المعقولة. الأنماط التالية
تستخدم بواسطة pandoc: [فقرة] عادي ، نص أساسي ، فقرة أولى ، مضغوط ، عنوان ،
العنوان الفرعي ، المؤلف ، التاريخ ، الملخص ، الببليوغرافيا ، العنوان 1 ، العنوان 2 ، العنوان 3 ،
العنوان 4 ، العنوان 5 ، العنوان 6 ، نص الكتلة ، نص الحاشية السفلية ، مصطلح التعريف ،
التعريف ، التسمية التوضيحية ، التسمية التوضيحية للجدول ، التسمية التوضيحية للصورة ، الشكل ، الشكل مع التسمية التوضيحية ، جدول المحتويات
عنوان؛ [حرف] خط الفقرة الافتراضي ، حرف نص أساسي ، حرف حرفي ،
مرجع حاشية سفلية ، ارتباط تشعبي ؛ [الجدول] الجدول العادي.

- epub-stylesheet =FILE
استخدم ملف CSS المحدد لتصميم EPUB. إذا لم يتم تحديد ورقة أنماط ،
سيبحث pandoc عن ملف epub.css في دليل بيانات المستخدم (انظر --data-dir).
إذا لم يتم العثور عليه هناك ، فسيتم استخدام الإعدادات الافتراضية المعقولة.

- epub-cover-image =FILE
استخدم الصورة المحددة كغلاف EPUB. من المستحسن أن تكون الصورة
أقل من 1000 بكسل في العرض والارتفاع. لاحظ أنه في مستند Markdown الخاص بك
يمكن أيضًا تحديد صورة الغلاف في كتلة بيانات تعريف YAML (انظر EPUB Metadata أدناه).

- epub-metadata =FILE
ابحث في ملف XML المحدد عن البيانات الوصفية لـ EPUB. يجب أن يحتوي الملف على
سلسلة من عناصر دبلن كور. على سبيل المثال:

المشاع الإبداعي
es-AR

بشكل افتراضي ، سيتضمن Pandoc عناصر البيانات الوصفية التالية: (من
عنوان الوثيقة) ، (من مؤلفي الوثيقة) ، (من
تاريخ المستند ، والذي يجب أن يكون بتنسيق ISO 8601) ، (من اللغة
متغير ، أو ، إذا لم يتم تعيينه ، الإعدادات المحلية) ، و (أ
UUID الذي تم إنشاؤه عشوائيًا). قد يتم تجاوز أي من هذه العناصر من خلال عناصر في
ملف البيانات الوصفية.

ملاحظة: إذا كان المستند المصدر هو Markdown ، فيمكن لكتلة بيانات تعريف YAML في المستند
يمكن استخدامها بدلا من ذلك. انظر أدناه أسفل البيانات الوصفية لـ EPUB.

--epub-embed-font =FILE
قم بتضمين الخط المحدد في EPUB. يمكن تكرار هذا الخيار للتضمين
خطوط متعددة. يمكن أيضًا استخدام أحرف البدل: على سبيل المثال ، DejaVuSans - *. ttf.
ومع ذلك ، إذا كنت تستخدم أحرف البدل في سطر الأوامر ، فتأكد من الهروب منها أو وضعها
اسم الملف بالكامل في علامات اقتباس مفردة ، لمنع تفسيرها بواسطة
صدَفَة. لاستخدام الخطوط المضمنة ، ستحتاج إلى إضافة تصريحات مثل
التالي إلى CSS الخاص بك (انظر --epub-stylesheet):

@ font-face {
عائلة الخطوط: DejaVuSans ؛
نمط الخط: عادي.
وزن الخط: عادي ؛
src: url ("DejaVuSans-Regular.ttf")؛
}
@ font-face {
عائلة الخطوط: DejaVuSans ؛
نمط الخط: عادي.
الخط الوزن: جريئة؛
src: url ("DejaVuSans-Bold.ttf") ؛
}
@ font-face {
عائلة الخطوط: DejaVuSans ؛
نمط الخط: مائل ؛
وزن الخط: عادي ؛
src: url ("DejaVuSans-Oblique.ttf") ؛
}
@ font-face {
عائلة الخطوط: DejaVuSans ؛
نمط الخط: مائل ؛
الخط الوزن: جريئة؛
src: url ("DejaVuSans-BoldOblique.ttf") ؛
}
body {font-family: "DejaVuSans" ؛ }

- مستوى الفصل - epub =عدد
حدد مستوى الرأس الذي تريد عنده تقسيم EPUB إلى ملفات "فصل" منفصلة.
الإعداد الافتراضي هو التقسيم إلى فصول في رؤوس المستوى 1. هذا الخيار يؤثر فقط
التكوين الداخلي لـ EPUB ، وليس الفصول والأقسام
المعروضة للمستخدمين. قد يكون بعض القراء بطيئين إذا كانت ملفات الفصول كبيرة جدًا ،
لذلك بالنسبة للمستندات الكبيرة التي تحتوي على عدد قليل من رؤوس المستوى 1 ، قد يرغب المرء في استخدام فصل
المستوى 2 أو 3.

- محرك اللاتكس = pdflatex | lualatex | xelatex
استخدم محرك LaTeX المحدد عند إنتاج مخرجات PDF. الافتراضي هو pdflatex.
إذا لم يكن المحرك في المسار الخاص بك ، فقد يتم تحديد المسار الكامل للمحرك
هنا.

--latex-engine-opt =STRING
استخدم السلسلة المحددة كوسيطة سطر أوامر لمحرك اللاتكس. إذا ما استخدمت
عدة مرات ، يتم تزويد الحجج بمسافات بينها. لاحظ أن لا
تحقق من وجود خيارات مكررة.

تنويه أداء
- ببليوغرافيا =FILE
عيّن حقل الببليوغرافيا في البيانات الوصفية للمستند إلى FILE، تجاوز أي قيمة
في البيانات الوصفية ، ومعالجة الاستشهادات باستخدام pandoc-citeproc. (هذا هو
ما يعادل - metadata bibliography = FILE - filter pandoc-citeproc.) إذا --natbib
أو يتم توفير --biblatex أيضًا ، ولا يتم استخدام pandoc-citeproc ، مما يجعل هذا مكافئًا
to - metadata bibliography = FILE. إذا قدمت هذه الوسيطة عدة مرات ، في كل مرة
FILE ستضاف إلى قائمة المراجع.

--csl =FILE
عيّن حقل csl في بيانات تعريف المستند إلى FILE، لتجاوز أي قيمة معيّنة فيها
البيانات الوصفية. (هذا يعادل --metadata csl = FILE.) هذا الخيار فقط
ذات الصلة بـ pandoc-citeproc.

- اختصارات الاستشهاد =FILE
عيّن حقل اختصارات الاقتباس في بيانات تعريف المستند إلى FILE، تجاوز
أي قيمة محددة في البيانات الوصفية. (هذا يعادل
- metadata citation-abbreviations = FILE.) هذا الخيار مناسب فقط لـ
باندوك-سيتيبروك.

--natbib
استخدم natbib للاقتباسات في إخراج LaTeX. هذا الخيار ليس للاستخدام مع
مرشح pandoc-citeproc أو إخراج PDF. الغرض منه هو استخدام في إنتاج
ملف LaTeX الذي يمكن معالجته باستخدام bibtex.

- ببلاتكس
استخدم biblatex للاقتباسات في إخراج LaTeX. هذا الخيار ليس للاستخدام مع
مرشح pandoc-citeproc أو إخراج PDF. الغرض منه هو استخدام في إنتاج
ملف LaTeX الذي يمكن معالجته باستخدام bibtex أو biber.

الرياضيات أداء in HTML
-m [URL], --latexmathml [=URL]
استخدم LaTeXMathML لعرض رياضيات TeX المضمنة في إخراج HTML. ال URL يجب أن تشير
إلى البرنامج النصي لتحميل LaTeXMathML.js. اذا كان URL لم يتم توفير ارتباط إلى
سيتم إدراج LaTeXMathML.js في الصفحة الرئيسية لـ LaTeXMathML.

- رياضيات [=URL]
تحويل الرياضيات TeX إلى MathML (في docbook وكذلك html و html5). في قائمة بذاتها
ناتج html ، أو ملف جافا سكريبت صغير (أو رابط لمثل هذا البرنامج النصي إذا كان ملف URL تم توفيره)
سيتم إدراجها للسماح بعرض MathML على بعض المتصفحات.

--jsmath [=URL]
استخدم jsMath لعرض رياضيات TeX المضمنة في إخراج HTML. ال URL يجب أن يشير إلى
برنامج تحميل jsMath (مثل jsMath / easy / load.js) ؛ إذا تم توفيره ، فسيتم ربطه
في رأس مستندات HTML المستقلة. اذا كان URL لم يتم توفير ، لا يوجد ارتباط
سيتم إدراج البرنامج النصي للتحميل jsMath ؛ ثم يعود الأمر إلى المؤلف لتقديمها
مثل هذا الارتباط في قالب HTML.

--ماثجاكس [=URL]
استخدم MathJax لعرض رياضيات TeX المضمنة في إخراج HTML. ال URL يجب أن يشير إلى
نص تحميل MathJax.js. اذا كان URL لم يتم توفير رابط إلى MathJax CDN
سيتم إدراجها.

- جلادتيكس
قم بتضمين رياضيات TeX بتنسيق العلامات في إخراج HTML. يمكن بعد ذلك معالجة هذه بواسطة
gladTeX لإنتاج روابط لصور صيغ التنضيد.

- ميميتكس [=URL]
تقديم الرياضيات TeX باستخدام البرنامج النصي mimeTeX CGI. لو URL لم يتم تحديده ، هو
يفترض أن النص موجود في /cgi-bin/mimetex.cgi.

- webtex [=URL]
عرض صيغ TeX باستخدام برنامج نصي خارجي يحول صيغ TeX إلى صور.
سيتم ربط الصيغة بعنوان URL المقدم. لو URL غير محدد ،
سيتم استخدام واجهة برمجة تطبيقات Google Chart.

- كاتكس [=URL]
استخدم KaTeX لعرض رياضيات TeX المضمنة في إخراج HTML. ال URL يجب أن يشير إلى
katex.js تحميل البرنامج النصي. اذا كان URL لم يتم توفير رابط إلى KaTeX CDN سيكون
المدرجة.

- katex-stylesheet =URL
إنّ كافة أنواع عهود الـ URL يجب أن يشير إلى ورقة أنماط katex.css. إذا لم يتم تحديد هذا الخيار ،
سيتم إدراج ارتباط إلى KaTeX CDN. لاحظ أن هذا الخيار لا يعني
- كاتكس.

مزيد من الخيارات لـ غلاف مخطوطات
- تفريغ أرجس
طباعة معلومات حول وسيطات سطر الأوامر إلى المعياري، ثم الخروج. هذا الخيار
الغرض الأساسي منه هو استخدامه في البرامج النصية المجمعة. السطر الأول من الإخراج
يحتوي على اسم ملف الإخراج المحدد بخيار -o ، أو - (لـ
المعياري) إذا لم يتم تحديد ملف الإخراج. تحتوي الأسطر المتبقية على الامتداد
وسيطات سطر الأوامر ، واحدة في كل سطر ، بالترتيب الذي تظهر به. هؤلاء لا
قم بتضمين خيارات pandoc العادية وحججها ، ولكن قم بتضمين أي خيارات
تظهر بعد الفاصل في نهاية السطر.

- إغينور-أرجس
تجاهل وسائط سطر الأوامر (للاستخدام في البرامج النصية المجمعة). خيارات باندوك العادية
لا يتم تجاهلها. وهكذا ، على سبيل المثال ،

pandoc --ignore-args -o foo.html -s foo.txt - -e latin1

ما يعادل

باندوك -o foo.html -s

TEMPLATES

عند استخدام الخيار -s / - قائم بذاته ، يستخدم pandoc قالبًا لإضافة رأس وتذييل الصفحة
المواد اللازمة لوثيقة قائمة بذاتها. لرؤية النموذج الافتراضي الذي هو
مستعملة ، اكتب فقط

pandoc -D * تنسيق *

أين FORMAT هو اسم تنسيق الإخراج. يمكن تحديد قالب مخصص باستخدام
الخيار --template. يمكنك أيضًا تجاوز قوالب النظام الافتراضية لملف
تنسيق الإخراج FORMAT عن طريق وضع ملف قوالب / افتراضي. * FORMAT * في بيانات المستخدم
الدليل (انظر --data-dir أعلاه). استثناءات: لإخراج odt ، قم بتخصيص ملف
default.opendocument template. لمخرجات pdf ، قم بتخصيص قالب default.latex.

تحتوي القوالب على المتغيرات، والتي تسمح بإدراج المعلومات التعسفية في أي
أشر في الملف. يمكن تعيين المتغيرات داخل المستند باستخدام مجموعات بيانات تعريف YAML.
يمكن أيضًا تعيينها في سطر الأوامر باستخدام الخيار -V / - variable: تعيين المتغيرات في
بهذه الطريقة تتجاوز حقول البيانات الوصفية التي تحمل الاسم نفسه.

المتغيرات طقم by باندوك
يتم تعيين بعض المتغيرات تلقائيًا بواسطة pandoc. هذه تختلف إلى حد ما اعتمادًا على
الناتج ، ولكن قم بتضمين حقول البيانات الوصفية بالإضافة إلى ما يلي:

عنوان، مؤلف، تاريخ
تسمح بتحديد الجوانب الأساسية للوثيقة. مضمن في بيانات تعريف PDF
من خلال LaTeX و ConTeXt. يمكن تعيين هذه من خلال كتلة عنوان pandoc ، والتي
يسمح للعديد من المؤلفين ، أو من خلال كتلة بيانات تعريف YAML:

---
مؤلف:
- أرسطو
- بيتر أبيلارد


عنوان فرعي
العنوان الفرعي للمستند ، مضمن في HTML و EPUB و LaTeX و ConTeXt و Word docx ؛ يجعل
في LaTeX فقط عند استخدام فئة المستند التي تدعم الترجمة ، مثل مضخم الصوت
أو سلسلة KOMA-Script (scrartcl و scrreprt و scrbook).

ملخص
ملخص المستند ، مضمن في LaTeX و ConTeXt و AsciiDoc و Word docx

الكلمات المفتاحية
قائمة الكلمات الرئيسية التي سيتم تضمينها في البيانات الوصفية بتنسيق HTML و PDF و AsciiDoc ؛ ربما
تكرر كما للمؤلف أعلاه

رأس يتضمن
المحتويات المحددة بواسطة -H / - include-in-header (قد تحتوي على قيم متعددة)

جدول المحتويات قيمة غير فارغة إذا تم تحديد --toc / - جدول المحتويات

عنوان toc
عنوان جدول المحتويات (يعمل فقط مع EPUB و docx)

تضمين من قبل
المحتويات المحددة بواسطة -B / - include-before-body (قد تحتوي على قيم متعددة)

تضمين بعد
المحتويات المحددة بواسطة -A / - include-after-body (قد تحتوي على قيم متعددة)

الجسد نص الوثيقة

ميتا جسون
تمثيل JSON لجميع البيانات الوصفية للمستند

اللغة المتغيرات
طويل يحدد اللغة الرئيسية للوثيقة ، باستخدام رمز وفقًا لـ BCP 47
(على سبيل المثال en أو en-GB). بالنسبة لبعض تنسيقات الإخراج ، سيقوم pandoc بتحويلها إلى ملف
التنسيق المناسب المخزن في المتغيرات الإضافية babel-lang و polyglossia-lang
(LaTeX) و Context-lang (ConTeXt).

يمكن استخدام pandoc الأصلي امتدادات و divs مع السمة lang (القيمة في BCP 47)
لتبديل اللغة في هذا النطاق.

com.otherlangs
قائمة باللغات الأخرى المستخدمة في المستند في البيانات الوصفية لـ YAML ، وفقًا لـ
BCP 47. على سبيل المثال: otherlangs: [en-GB، fr]. يتم إنشاء هذا تلقائيًا
من سمات lang في جميع الامتدادات و divs ولكن يمكن تجاوزها. حالياً
تستخدم فقط من قبل LaTeX من خلال babel-otherlangs التي تم إنشاؤها و
متغيرات polyglossia-otherlangs. يقوم كاتب LaTeX بإخراج أوامر polyglossia بتنسيق
يحتوي النص ولكن المتغير babel-newcommands على تعيينات لها إلى ملف
بابل المقابلة.

دير الاتجاه الأساسي للمستند ، إما rtl (من اليمين إلى اليسار) أو ltr
(من اليسار إلى اليمين).

للمستندات ثنائية الاتجاه ، يمتد pandoc الأصلي و divs بالسمة dir
(القيمة rtl أو ltr) يمكن استخدامها لتجاوز الاتجاه الأساسي في بعض المخرجات
الأشكال. قد لا يكون هذا ضروريًا دائمًا إذا كان العارض النهائي (مثل ملف
المتصفح ، عند إنشاء HTML) يدعم خوارزمية Unicode ثنائية الاتجاه.

عند استخدام LaTeX للمستندات ثنائية الاتجاه ، يكون محرك xelatex فقط هو الذي يعمل بشكل كامل
مدعوم (استخدم - محرك لاتكس = زيلاتكس).

المتغيرات لـ الشرائح
المتغيرات متاحة لإنتاج عروض الشرائح باستخدام pandoc ، بما في ذلك جميع revision.js
خيارات الإعداد.

انزلق عنوان url
عنوان URL الأساسي لمستندات Slidy (الافتراضي هو http://www.w3.org/Talks/Tools/Slidy2)

انزلق عنوان url
عنوان URL الأساسي للمستندات Slideous (الإعدادات الافتراضية هي slideous)

s5-url عنوان URL الأساسي لمستندات S5 (الافتراضي هو s5 / افتراضي)

تكشف عن رابط URL
عنوان URL الأساسي لمستنداتكشف.

موضوع، اللون ، الخط ، داخلي ، الخارج
موضوعات لوثائق LaTeX beamer

ملاحة
يتحكم في رموز التنقل في مستندات Beamer (الافتراضي فارغ لعدم التنقل
حرف او رمز؛ القيم الصالحة الأخرى هي الإطار والعمودي والأفقي).

عناوين الأقسام
تمكن على "صفحات العنوان" للأقسام الجديدة في وثائق المشعاع (الافتراضي = صحيح).

المتغيرات لـ مطاط
تُستخدم متغيرات LaTeX عند إنشاء ملف PDF.

حجم الورق
حجم الورق ، على سبيل المثال letter ، A4

حجم الخط
حجم الخط للنص الأساسي (على سبيل المثال ، 10 نقطة ، 12 نقطة)

فئة الوثائق
فئة الوثيقة ، على سبيل المثال مقالة ، تقرير ، كتاب ، مذكرات

com.classoption
خيار لفئة الوثيقة ، على سبيل المثال جانب واحد ؛ قد تتكرر لخيارات متعددة

علم الهندسة
خيار الحزمة الهندسية ، على سبيل المثال الهامش = 1 بوصة ؛ قد تتكرر لخيارات متعددة

الهامش الأيسر الهامش الأيمن الهامش العلوي الهامش السفلي
يحدد الهوامش ، إذا لم يتم استخدام الهندسة (وإلا فإن الهندسة تتخطى هذه)

تمدد
يضبط تباعد الأسطر باستخدام حزمة setpace ، على سبيل المثال 1.25 ، 1.5

خط العائلة
حزمة الخطوط للاستخدام مع pdflatex: تتضمن TeX Live العديد من الخيارات ، موثقة بتنسيق
كتالوج خطوط LaTeX. الافتراضي هو اللاتينية الحديثة.

com.fontfamilyoptions
خيارات الحزمة المستخدمة كعائلة fontfamily: على سبيل المثال ، osf ، sc مع تعيين fontfamily على
يقدم موقع mathpazo إلى Palatino أشكالًا قديمة الطراز وقبعات صغيرة حقيقية ؛ ربما
يتكرر لخيارات متعددة

الخط الرئيسي سانسفونت monofont ماثفونت CJKmainfont
عائلات الخطوط للاستخدام مع xelatex أو lualatex: خذ اسم أي خط نظام ،
باستخدام حزمة fontspec. لاحظ أنه إذا تم استخدام CJKmainfont ، فإن الحزمة xecjk
يجب أن تكون متاحة.

الخطوط الرئيسية ، sansfontoptions خيارات أحادية Mathfontoptions CJKoptions
خيارات لاستخدامها مع mainfont و sansfont و monofont و mathfont و CJKmainfont في xelatex
و lualatex. اسمح بأي اختيارات متاحة من خلال fontspec ، مثل ملف
ميزات OpenType Numbers = OldStyle ، Numbers = Proportional. يمكن أن تتكرر ل
خيارات متعددة.

فونتنس
يسمح بتحديد ترميز الخط من خلال حزمة fontenc (مع pdflatex) ؛
الافتراضي هو T1 (انظر دليل ترميزات خطوط LaTeX)

روابط ملونة
إضافة لون لربط النص ؛ ممكّن تلقائيًا إذا كان أي من linkcolor ، citecolor ،
تم تعيين urlcolor أو toccolor

linkcolor المدينة urlcolor توكولور
لون الروابط الداخلية وروابط الاقتباس والروابط الخارجية والروابط في جدول
المحتويات: يستخدم أيًا من ألوان LaTeX المحددة مسبقًا

روابط كملاحظات
يؤدي إلى طباعة الروابط في شكل هوامش

المسافة البادئة يستخدم إعدادات فئة المستند للمسافة البادئة (نموذج LaTeX الافتراضي بخلاف ذلك
يزيل المسافة البادئة ويضيف مسافة بين الفقرات)

فقرة فرعية
تعطيل السلوك الافتراضي لقالب LaTeX الذي يعيد تعريف الفقرات (الفرعية) على أنها
المقاطع ، وتغيير مظهر العناوين المتداخلة في بعض الفئات

شكر يحدد محتويات حاشية إقرارات الإقرار السفلية بعد عنوان المستند.

جدول المحتويات تضمين جدول المحتويات (يمكن أيضًا تعيينه باستخدام --toc / - جدول المحتويات)

العمق
مستوى القسم المراد تضمينه في جدول المحتويات

لوف الكثير
تشمل قائمة الأشكال ، قائمة الجداول

قائمة المراجع
ببليوغرافيا لاستخدامها في حل المراجع

على غرار الكتاب المقدس
أسلوب الببليوغرافيا ، عند استخدامه مع --natbib و - biblatex.

com.biblatexoptions
قائمة خيارات biblatex.

المتغيرات لـ سياق الكلام
حجم الورق
حجم الورق ، على سبيل المثال letter ، A4 ، أفقي (انظر ConTeXt Paper Setup) ؛ قد تتكرر
لخيارات متعددة

نسق خيارات لهوامش الصفحة وترتيب النص (انظر ConTeXt Layout) ؛ قد تتكرر
لخيارات متعددة

الهامش الأيسر الهامش الأيمن الهامش العلوي الهامش السفلي
يحدد الهوامش ، إذا لم يتم استخدام التخطيط (وإلا فسيتجاوز التخطيط هذه)

حجم الخط
حجم الخط للنص الأساسي (على سبيل المثال ، 10 نقطة ، 12 نقطة)

الخط الرئيسي سانسفونت monofont ماثفونت
عائلات الخطوط: خذ اسم أي خط نظام (انظر ConTeXt Font Switching)

linkcolor تباين اللون
لون الروابط خارج وداخل الصفحة ، مثل الأحمر والأزرق (انظر ConTeXt Color)

رابط
نمط محرف للروابط ، على سبيل المثال عادي ، غامق ، مائل ، بولسلانتيد ، نوع ، غطاء ،
صغير

المسافة البادئة
يتحكم في المسافة البادئة للفقرات ، على سبيل المثال ، نعم ، صغير ، التالي (انظر ConTeXt Indentation) ؛
قد تتكرر لخيارات متعددة

بيضاء
التباعد بين الفقرات ، على سبيل المثال لا شيء ، صغير (باستخدام مسافة الإعداد)

مساحة بين السطور
يضبط تباعد الأسطر ، على سبيل المثال 4ex (باستخدام setupinterlinespace) ؛ قد تتكرر ل
خيارات متعددة

نص العنوان نص سفلي
سيتم وضع النص في رأس أو تذييل التشغيل (انظر رؤوس وتذييلات ConTeXt) ؛
يمكن أن تتكرر حتى أربع مرات لمواضع مختلفة

ترقيم الصفحات
نمط رقم الصفحة والموقع (باستخدام الترقيم setuppagen) ؛ قد تتكرر ل
خيارات متعددة

جدول المحتويات تضمين جدول المحتويات (يمكن أيضًا تعيينه باستخدام --toc / - جدول المحتويات)

لوف الكثير
تشمل قائمة الأشكال ، قائمة الجداول

المتغيرات لـ رجل صفحات
قسم
رقم القسم في صفحات الدليل

رأس رأس في صفحات الرجل

تذييل تذييل في صفحات الدليل

تعديل
يضبط النص على الهوامش اليسرى (l) أو اليمنى (r) أو الوسط (c) أو كلاهما (b)

واصلة
إذا كان صحيحًا (الافتراضي) ، فسيتم استخدام الواصلة

باستخدام المتغيرات in النماذج
الأسماء المتغيرة هي تسلسلات من الحروف الأبجدية الرقمية - ، و _ ، تبدأ بحرف. أ
سيتم استبدال اسم المتغير المحاط بعلامات $ بقيمته. على سبيل المثال ، ملف
سلسلة $ title $ in

$ title $

سيتم استبداله بعنوان المستند.

لكتابة حرف $ في قالب ، استخدم $$.

قد تحتوي القوالب على شروط. بناء الجملة كما يلي:

$ if (متغير) $
X
$ else $
Y
$ endif $

سيشمل هذا X في القالب إذا كان للمتغير قيمة غير فارغة ؛ وإلا فإنه سوف
تضمين Y. X و Y هما عنصران نائبان لأي نص قالب صالح ، وقد يتضمنان
المتغيرات المقحمة أو الشروط الأخرى. قد يتم حذف قسم $ else $.

عندما يمكن أن تحتوي المتغيرات على قيم متعددة (على سبيل المثال ، المؤلف في مستند متعدد المؤلفين) ،
يمكنك استخدام $ for $ keyword:

$ لـ (المؤلف) $

endfor $

يمكنك تحديد فاصل اختياريًا لاستخدامه بين العناصر المتتالية:

$ لـ (المؤلف) $$ المؤلف $$ sep $ ، $ endfor $

يمكن استخدام النقطة لتحديد حقل متغير يأخذ كائنًا كقيمة له. لذا،
على سبيل المثال:

$ author.name $ ($ author.affiliation $)

إذا كنت تستخدم قوالب مخصصة ، فقد تحتاج إلى مراجعتها كتغييرات pandoc. نوصي
تتبع التغييرات في القوالب الافتراضية ، وتعديل القوالب المخصصة الخاصة بك
وفقاً لذلك. طريقة سهلة للقيام بذلك هي تفرع مستودع قوالب pandoc ودمجها
في التغييرات بعد كل إصدار pandoc.

باندوك تخفيض السعر

يفهم Pandoc نسخة موسعة ومُنقحة قليلاً من John Gruber's Markdown
بناء الجملة. يشرح هذا المستند بناء الجملة ، مع ملاحظة الاختلافات عن Markdown القياسي.
باستثناء ما يتم ملاحظته ، يمكن منع هذه الاختلافات باستخدام markdown_strict
تنسيق بدلاً من تخفيض السعر. يمكن تمكين الامتدادات عن طريق إضافة + EXTENSION إلى ملف
اسم التنسيق وتعطيله عن طريق إضافة -EXTENSION. على سبيل المثال ، markdown_strict + هوامش
Markdown صارم مع تمكين الحواشي السفلية ، بينما markdown-footnotes-pipe_tables هو pandoc
تخفيض السعر بدون هوامش أو جداول أنابيب.

فلسفة
تم تصميم Markdown ليكون سهل الكتابة ، والأهم من ذلك أنه سهل القراءة:

يجب أن يكون المستند المنسق Markdown قابلاً للنشر كما هو ، كنص عادي ، بدون
يبدو أنه قد تم ترميزه بالعلامات أو إرشادات التنسيق. -- جون
غروبر

لقد استرشد هذا المبدأ بقرارات Pandoc في إيجاد بناء الجملة للجداول والحواشي السفلية و
ملحقات أخرى.

ومع ذلك ، هناك جانب واحد تختلف فيه أهداف Pandoc عن الأهداف الأصلية
من Markdown. في حين تم تصميم Markdown في الأصل مع وضع إنشاء HTML في الاعتبار ،
تم تصميم pandoc لتنسيقات الإخراج المتعددة. وهكذا ، بينما يسمح pandoc بالتضمين
من HTML الخام ، فإنه يثبطها ، ويوفر طرقًا أخرى غير لغة HTML للتمثيل
عناصر وثيقة مهمة مثل قوائم التعريف والجداول والرياضيات والحواشي.

الفقرات
الفقرة هي سطر أو أكثر من النص متبوعًا بسطر فارغ واحد أو أكثر. نيولاينز
يتم التعامل معها على أنها مسافات ، لذا يمكنك إعادة تدفق فقراتك كما تريد. إذا كنت في حاجة ماسة
فاصل سطر ، ضع مسافتين أو أكثر في نهاية السطر.

التمديد: فواصل_خط_الهروب
الخط المائل العكسي متبوعًا بسطر جديد هو أيضًا فاصل سطر متشدد. ملاحظة: في خطوط متعددة وشبكة
خلايا الجدول ، هذه هي الطريقة الوحيدة لإنشاء فاصل أسطر صلب ، نظرًا لأن المسافات الزائدة في
يتم تجاهل الخلايا.

رؤوس
هناك نوعان من الرؤوس: Setext و ATX.

نمط Setext رؤوس
عنوان setext-style عبارة عن سطر من النص "تحته خط" مع صف من الإشارات = (للمستوى
رأس واحد) أو - علامات (لرأس المستوى الثاني):

رأس من المستوى الأول
==================

رأس من المستوى الثاني
------------------

يمكن أن يحتوي نص الرأس على تنسيق سطري ، مثل التركيز (انظر التنسيق المضمن ،
أدناه).

نمط ATX رؤوس
يتكون رأس نمط ATX من علامة واحدة إلى ست علامات وسطر نصي ، يتم اتباعه اختياريًا
بأي عدد من العلامات. عدد # علامات في بداية السطر هو
مستوى الرأس:

## رأس من المستوى الثاني

### رأس من المستوى الثالث ###

كما هو الحال مع رؤوس setext-style ، يمكن أن يحتوي نص الرأس على تنسيق:

# رأس من المستوى الأول مع [رابط] (/ url) و * تأكيد *

التمديد: فارغ_قبل_الرأس
لا تتطلب صيغة Markdown القياسية سطرًا فارغًا قبل العنوان. يفعل Pandoc
تتطلب هذا (باستثناء ، بالطبع ، في بداية المستند). سبب ال
الشرط هو أنه من السهل جدًا أن ينتهي # في بداية السطر
حادث (ربما من خلال التفاف الخط). ضع في اعتبارك ، على سبيل المثال:

أنا أحب العديد من نكهات الآيس كريم الخاصة بهم:
# 22 ، على سبيل المثال ، و # 5.

رأس معرفات
التمديد: header_attributes
يمكن تعيين سمات للعناوين باستخدام بناء الجملة هذا في نهاية السطر الذي يحتوي على
نص العنوان:

{#identifier .class .class key = value key = value}

وبالتالي ، على سبيل المثال ، سيتم تعيين جميع الرؤوس التالية للمعرف foo:

# رأسي {#foo}

## رأسي ## {#foo}

رأسي الآخر {#foo}
---------------

(هذه الصيغة متوافقة مع PHP Markdown Extra.)

لاحظ أنه على الرغم من أن بناء الجملة هذا يسمح بتعيين الفئات والسمات الرئيسية / القيمة ،
لا يستخدم الكتاب عمومًا كل هذه المعلومات. المعرفات والفئات والمفتاح / القيمة
تُستخدم السمات في التنسيقات المستندة إلى HTML و HTML مثل EPUB و slidy. معرفات
تُستخدم للتسميات ومثبتات الروابط في كتاب LaTeX و ConTeXt و Textile و AsciiDoc.

لن يتم ترقيم الرؤوس ذات الفئة غير المرقمة ، حتى لو كانت --number-section هي
محدد. واصلة واحدة (-) في سياق جدول البيانات تعادل .unnumbered و
يفضل استخدامه في المستندات غير الإنجليزية. لذا،

# رأسي {-}

هو مجرد نفس

# رأسي {.unnumbered}

التمديد: المعرفات التلقائية
سيتم تلقائيًا تعيين رأس بدون معرف محدد بشكل صريح
معرّف فريد يعتمد على نص العنوان. لاشتقاق المعرف من الرأس
النص،

· إزالة جميع التنسيقات والروابط وما إلى ذلك.

· إزالة كافة الحواشي.

· قم بإزالة جميع علامات الترقيم ، باستثناء الشرطات السفلية والواصلات والنقاط.

استبدال جميع المسافات والأسطر الجديدة بالواصلات.

تحويل جميع الأحرف الأبجدية إلى أحرف صغيرة.

· قم بإزالة كل شيء حتى الحرف الأول (قد لا تبدأ المعرفات برقم أو
علامة الترقيم).

· إذا لم يتبق شيء بعد ذلك ، فاستخدم قسم المعرف.

وهكذا ، على سبيل المثال ،

معرّف الرأس
────────────────────────────────────────────────── ──────
معرّفات الرأس في HTML header-identifiers-in-html
* كلاب *؟ - في * بيتي *؟ الكلاب - في منزلي
[HTML] أو [S5] أو [RTF]؟ html-s5-or-rtf
3. تطبيقات التطبيقات
قسم 33

يجب أن تسمح هذه القواعد ، في معظم الحالات ، لأحد بتحديد المعرف من الرأس
نص. الاستثناء هو عندما تحتوي عدة رؤوس على نفس النص ؛ في هذه الحالة ، الأول
سوف تحصل على معرف كما هو موضح أعلاه ؛ سيحصل الثاني على نفس المعرف مع -1
ملحق. الثالث مع -2 ؛ وما إلى ذلك وهلم جرا.

يتم استخدام هذه المعرفات لتوفير أهداف الارتباط في جدول المحتويات التي تم إنشاؤها بواسطة
الخيار --toc | - جدول المحتويات. كما أنها تجعل من السهل توفير روابط من موقع واحد
قسم من المستند إلى قسم آخر. رابط إلى هذا القسم ، على سبيل المثال ، قد يبدو مثل
هذه:

انظر قسم
[معرّفات الرأس] (# header-identifiers-in-html-latex-and-Context).

لاحظ ، مع ذلك ، أن طريقة توفير روابط للأقسام تعمل فقط في HTML و LaTeX و
وتنسيقات ConTeXt.

إذا تم تحديد الخيار --section-divs ، فسيتم التفاف كل قسم في div (أو
قسم ، إذا تم تحديد --html5) ، وسيتم إرفاق المعرف بالمرفق
(أو ) بدلاً من العنوان نفسه. هذا يسمح لأقسام كاملة أن تكون
تم التلاعب بها باستخدام جافا سكريبت أو تمت معالجتها بشكل مختلف في CSS.

التمديد: الضمنية_header_references
يتصرف Pandoc كما لو تم تحديد روابط مرجعية لكل رأس. لذا ، بدلا من

[معرّفات الرأس] (# header-identifiers-in-html)

يمكنك ببساطة الكتابة

[معرّفات الرأس]

or

[معرفات الرأس] []

or

[القسم الخاص بمعرفات الرأس] [معرفات الرأس]

إذا كانت هناك عدة رؤوس بنص متطابق ، فسيتم ربط المرجع المقابل
إلى الأول فقط ، وستحتاج إلى استخدام روابط صريحة للارتباط بالآخرين ، مثل
موصوف بالاعلى.

مثل الروابط المرجعية العادية ، فإن هذه المراجع غير حساسة لحالة الأحرف.

دائمًا ما تأخذ تعريفات مرجع الارتباط الصريح الأولوية على مراجع الرأس الضمنية.
لذلك ، في المثال التالي ، سيشير الرابط إلى شريط ، وليس إلى #foo:

# فو

[فو]: شريط

انظر [foo]

حظر الاقتباسات
يستخدم Markdown اصطلاحات البريد الإلكتروني لاقتباس كتل من النص. اقتباس الكتلة هو واحد أو
المزيد من الفقرات أو عناصر الكتلة الأخرى (مثل القوائم أو الرؤوس) ، مع كل سطر
مسبوقًا بحرف ومسافة اختيارية. (لا يجب أن تبدأ علامة> من اليسار
الهامش ، ولكن لا ينبغي أن تكون المسافة البادئة له أكثر من ثلاث مسافات.)

> هذا اقتباس كتلة. هذا
> الفقرة سطرين.
>
> 1. هذه قائمة داخل اقتباس كتلة.
> 2. البند الثاني.

النموذج "الكسول" ، الذي يتطلب الحرف> فقط في السطر الأول من كل كتلة ، هو
سمح أيضا:

> هذا اقتباس كتلة. هذا
الفقرة سطرين.

> 1. هذه قائمة داخل اقتباس كتلة.
2. البند الثاني.

من بين عناصر الكتلة التي يمكن احتواؤها في اقتباس الكتلة هي علامات اقتباس جماعية أخرى.
بمعنى ، يمكن أن تتداخل علامات الاقتباس:

> هذا اقتباس كتلة.
>
>> اقتباس كتلة داخل اقتباس كتلة.

إذا كان الحرف> متبوعًا بمسافة اختيارية ، فسيتم اعتبار هذه المساحة جزءًا من
علامة اقتباس الكتلة وليست جزءًا من المسافة البادئة للمحتويات. وهكذا ، لوضع ملف
مسافة بادئة لكتلة التعليمات البرمجية في اقتباس جماعي ، فأنت بحاجة إلى خمس مسافات بعد>:

> كود

التمديد: Blank_before_blockquote
لا تتطلب صيغة Markdown القياسية سطرًا فارغًا قبل اقتباس كتلة. يفعل Pandoc
تتطلب هذا (باستثناء ، بالطبع ، في بداية المستند). سبب ال
الشرط هو أنه من السهل جدًا أن ينتهي الأمر ب> في بداية السطر
حادث (ربما من خلال التفاف الخط). لذلك ، ما لم يتم استخدام تنسيق markdown_strict ،
ما يلي لا ينتج اقتباس كتلة متداخلة في pandoc:

> هذا اقتباس كتلة.
>> متداخل.

حرفي (شفرة) كتل
مسنن الكود كتل
يتم التعامل مع كتلة نص بها مسافة بادئة لأربع مسافات (أو علامة تبويب واحدة) كنص حرفي: أي ،
لا تؤدي الأحرف الخاصة إلى تنسيق خاص ، كما يتم تشغيل جميع المسافات وفواصل الأسطر
محفوظة. على سبيل المثال،

إذا (أ> 3) {
moveShip (5 * الجاذبية ، أسفل) ؛
}

لا تعتبر المسافة البادئة الأولية (أربع مسافات أو علامة تبويب واحدة) جزءًا من الحرف
النص ، وتتم إزالته في الإخراج.

ملاحظة: لا يجب أن تبدأ الأسطر الفارغة في النص الحرفي بأربع مسافات.

مسيجة الكود كتل
التمديد: كتل_رمز_المسيجة
بالإضافة إلى كتل التعليمات البرمجية القياسية ذات المسافة البادئة ، يدعم pandoc مسيجة كتل التعليمات البرمجية. هؤلاء
ابدأ بصف من ثلاثة أو أكثر من علامة التلدة (~) وتنتهي بصف من علامة التلدة التي يجب أن تكون عند
على الأقل طول صف البداية. كل شيء بين هذه الأسطر يتم التعامل معه على أنه كود. لا
المسافة البادئة ضرورية:

~~~~~~~
إذا (أ> 3) {
moveShip (5 * الجاذبية ، أسفل) ؛
}
~~~~~~~

مثل كتل التعليمات البرمجية العادية ، يجب فصل كتل التعليمات البرمجية المسيجة عن النص المحيط بواسطة
خطوط فارغة.

إذا كان الكود نفسه يحتوي على صف من علامات التلدة أو backticks ، فما عليك سوى استخدام صف أطول من علامة التلدة
أو backticks في البداية والنهاية:

~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~~~~~~~~~~
رمز بما في ذلك التلدة
~~~~~~~~~~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~

التمديد: backtick_code_blocks
مثل الكُلّات المُسَجَّلة بالرمز ، لكن تستخدم backticks (`) بدلاً من علامة التلدة (~).

التمديد: سمات_رمز_المسيجة
اختياريًا ، يمكنك إرفاق سمات لكتلة التعليمات البرمجية المسيجة أو backtick باستخدام هذه الصيغة:

~~~~ {#mycode .haskell .numberLines startFrom = "100"}
فرز [] = []
qsort (x: xs) = qsort (مرشح (<x) xs) ++ [x] ++
qsort (عامل التصفية (> = x) xs)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

هنا mycode هو معرف ، haskell و numberLines هي فئات ، و startFrom هو
السمة بقيمة 100. يمكن لبعض تنسيقات الإخراج استخدام هذه المعلومات للقيام بالصياغة
تسليط الضوء. حاليًا ، تنسيقات الإخراج الوحيدة التي تستخدم هذه المعلومات هي HTML و
مطاط. إذا كان التمييز مدعومًا لتنسيق الإخراج واللغة ، فسيكون الرمز
ستظهر الكتلة أعلاه مميزة ، مع خطوط مرقمة. (لمعرفة اللغات
مدعوم ، قم بإجراء pandoc --version.) وإلا ، فستظهر كتلة التعليمات البرمجية أعلاه على النحو التالي:







يمكن أيضًا استخدام نموذج اختصار لتحديد لغة كتلة التعليمات البرمجية:

"" هاسكل
فرز [] = []
`` `

وهذا يعادل:

"{.haskell}
فرز [] = []
`` `

إذا تم تعطيل ملحق fenced_code_attributes ، لكن الإدخال يحتوي على سمة (سمات) للفئة
بالنسبة للكتلة البرمجية ، ستتم طباعة سمة الدرجة الأولى بعد فتح السياج كملف
كلمة عارية.

لمنع كل التظليل ، استخدم علامة --لا تمييز. لتعيين نمط التمييز ،
استخدام - تسليط الضوء على النمط. لمزيد من المعلومات حول التمييز ، راجع تمييز بناء الجملة ،
أدناه.

لاين كتل
التمديد: line_blocks
كتلة الخط هي سلسلة من الأسطر تبدأ بشريط عمودي (|) متبوعًا بمسافة.
سيتم الاحتفاظ بالتقسيم إلى خطوط في الإخراج ، وكذلك أي مسافات بادئة ؛
وإلا ، سيتم تنسيق الخطوط كـ Markdown. هذا مفيد للآية و
عناوين:

| حزم ليمريك تضحك تشريحيًا
| في الفضاء يكون اقتصاديًا تمامًا.
| لكن الأشياء الجيدة التي رأيتها
| لذلك نادرا ما تكون نظيفة
| ونادرًا ما تكون الصور النقية هزلية

| 200 شارع رئيسي
| بيركلي ، كاليفورنيا 94718

يمكن تغليف الأسطر جيدًا إذا لزم الأمر ، ولكن يجب أن يبدأ سطر المتابعة بحرف a
الفضاء.

| صموئيل ل.
كونستابل الابن
| 200 شارع رئيسي
| بيركلي ، كاليفورنيا 94718

تم استعارة بناء الجملة هذا من reStructuredText.

قوائم
رصاصة القوائم
قائمة التعداد النقطي هي قائمة بعناصر قائمة ذات تعداد نقطي. يبدأ عنصر القائمة ذات التعداد النقطي برمز نقطي
(* أو + أو -). اليك مثال بسيط:

* واحد
* اثنين
* ثلاثة

سينتج عن ذلك قائمة "مضغوطة". إذا كنت تريد قائمة "فضفاضة" ، حيث يوجد كل عنصر
بتنسيق فقرة ، ضع مسافات بين العناصر:

* واحد

* اثنين

* ثلاثة

لا يلزم أن يكون الرصاص متدفقًا بالهامش الأيسر ؛ قد يتم وضع مسافة بادئة لها بمقدار واحد أو اثنين أو
ثلاث مسافات. يجب أن تتبع الرصاصة بمسافة بيضاء.

تبدو عناصر القائمة أفضل إذا كانت السطور التالية محاذية للسطر الأول (بعد التعداد النقطي):

* ها هو الأول
قائمة الاغراض.
* وثاني.

لكن Markdown يسمح أيضًا بتنسيق "كسول":

* ها هو الأول
قائمة الاغراض.
* وثاني.

إنّ كافة أنواع عهود الـ أربع مسافات حكم
قد يحتوي عنصر القائمة على فقرات متعددة ومحتوى آخر على مستوى الكتلة. لكن،
يجب أن يُسبَق الفقرات اللاحقة بسطر فارغ مع إضافة مسافة بادئة إلى أربع مسافات أو علامة جدولة.
ستبدو القائمة أفضل إذا تمت محاذاة الفقرة الأولى مع الباقي:

* الفقرة الأولى.

واصلت.

* الفقرة الثانية. مع كتلة التعليمات البرمجية ، والتي يجب أن تكون مسافة بادئة
ثمانية مسافات:

{ شفرة }

قد تتضمن عناصر القائمة قوائم أخرى. في هذه الحالة ، يكون السطر الفارغ السابق اختياريًا.
يجب وضع مسافة بادئة بين القائمة المتداخلة أربع مسافات أو علامة تبويب واحدة:

* الفاكهة
+ تفاح
- ماكنتوش
- أحمر لذيذ
+ الكمثرى
+ الخوخ
* خضروات
+ بروكلي
+ شارد

كما هو مذكور أعلاه ، يسمح لك Markdown بكتابة عناصر القائمة "كسول" بدلاً من المسافة البادئة
خطوط الاستمرارية. ومع ذلك ، إذا كانت هناك فقرات متعددة أو كتل أخرى في القائمة
العنصر ، يجب وضع مسافة بادئة للسطر الأول من كل عنصر.

+ قائمة كسول ، كسول
البند.

+ واحد آخر. هذا يبدو
سيء ولكنه قانوني.

الفقرة الثانية من الثانية
قائمة الاغراض.

ملحوظة: على الرغم من أن قاعدة الفراغ الأربعة لفقرات المتابعة تأتي من المسؤول
دليل صياغة Markdown ، التنفيذ المرجعي ، Markdown.pl ، لا يتبعه. لذا
سيعطي pandoc نتائج مختلفة عن Markdown.pl عندما يقوم المؤلفون بوضع مسافة بادئة
استمرار الفقرات أقل من أربعة مسافات.

لا يوضح دليل صياغة Markdown ما إذا كانت قاعدة المسافات الأربعة تنطبق على أم لا الكل
محتوى على مستوى الكتلة في عنصر قائمة ؛ يذكر فقط الفقرات وكتل التعليمات البرمجية. لكن ذلك
يشير ضمنيًا إلى أن القاعدة تنطبق على كل المحتوى على مستوى الكتلة (بما في ذلك القوائم المتداخلة) ، و
يفسرها باندوك بهذه الطريقة.

أمر القوائم
تعمل القوائم المرتبة تمامًا مثل القوائم النقطية ، باستثناء أن العناصر تبدأ بالعداد
بدلا من الرصاص.

في Markdown القياسي ، يعد العدادون أرقامًا عشرية متبوعة بنقطة ومسافة.
يتم تجاهل الأرقام نفسها ، لذلك لا فرق بين هذه القائمة:

1. واحد
2- اثنان
3. ثلاثة

و هذه:

5. واحد
7- اثنان
1. ثلاثة

التمديد: قوائم خيالية
على عكس Markdown القياسي ، يسمح pandoc بتمييز عناصر القائمة المرتبة بأحرف كبيرة و
أحرف صغيرة وأرقام رومانية ، بالإضافة إلى الأرقام العربية. قد تكون علامات القائمة
محاطًا بأقواس أو متبوعًا بأقواس أيمن واحدة أو نقطة. يجب أن يكونوا
مفصولة عن النص الذي يليه بمسافة واحدة على الأقل ، وإذا كانت علامة القائمة هي ملف
حرف كبير بنقطة ، بمسافتين على الأقل.

يسمح امتداد fancy_lists أيضًا باستخدام "#" كعلامة قائمة مرتبة بدلاً من
رقم:

#. واحد
#. اثنين

التمديد: البداية
يهتم Pandoc أيضًا بنوع علامة القائمة المستخدمة ورقم البداية ،
ويتم الاحتفاظ بكلاهما قدر الإمكان في تنسيق الإخراج. وبالتالي ، ما يلي
ينتج قائمة بأرقام متبوعة بقوس واحد ، بدءًا من 9 و a
قائمة فرعية بأرقام رومانية صغيرة:

9) تاسعا
10) العاشر
11) الحادي عشر
أنا. subone
ثانيا. فرعي
ثالثا. ثلاثة دون

سيبدأ Pandoc قائمة جديدة في كل مرة يتم فيها استخدام نوع مختلف من محدد القائمة. لذلك
سيُنشئ ما يلي ثلاث قوائم:

(2) اثنان
(5) ثلاثة
1. أربعة
* خمسة

إذا كانت علامات القائمة الافتراضية مطلوبة ، فاستخدم # .:

#. واحد
#. اثنين
#. ثلاثة

تعريف القوائم
التمديد: تعريف_قوائم
يدعم Pandoc قوائم التعريفات ، باستخدام صيغة PHP Markdown Extra مع بعضها
ملحقات.

مصطلح 1

: التعريف 1

الفصل 2 مع * العلامات المضمنة *

: التعريف 2

{بعض التعليمات البرمجية ، جزء من التعريف 2}

الفقرة الثالثة من التعريف 2.

يجب وضع كل مصطلح في سطر واحد ، والذي يمكن أن يتبعه بشكل اختياري سطر فارغ ، ويجب
يتبعه تعريف واحد أو أكثر. يبدأ التعريف بنقطتين أو تيلدا ، والتي
يمكن وضع مسافة بادئة بمسافة أو مسافتين.

قد يكون للمصطلح تعريفات متعددة ، وقد يتكون كل تعريف من كتلة واحدة أو أكثر
عناصر (فقرة ، كتلة رمز ، قائمة ، إلخ) ، كل مسافة بادئة لأربع مسافات أو علامة توقف واحدة.
نص التعريف (بما في ذلك السطر الأول ، بصرف النظر عن القولون أو التلدة)
يجب وضع مسافة بادئة لأربع مسافات. ومع ذلك ، كما هو الحال مع قوائم Markdown الأخرى ، يمكنك "كسول"
حذف المسافة البادئة باستثناء بداية فقرة أو عنصر كتلة آخر:

مصطلح 1

: تعريف
مع استمرار كسول.

الفقرة الثانية من التعريف.

إذا تركت مسافة قبل التعريف (كما في المثال أعلاه) ، فإن نص ملف
سيتم التعامل مع التعريف كفقرة. في بعض تنسيقات الإخراج ، سيعني هذا أكبر
التباعد بين أزواج المصطلح / التعريف. للحصول على قائمة تعريف أكثر إحكاما ، قم بحذف المسافة
قبل التعريف:

مصطلح 1
~ التعريف 1

مصطلح 2
~ التعريف 2a
~ التعريف 2 ب

لاحظ أن المسافة بين العناصر في قائمة التعريفات مطلوبة. (البديل الذي يخفف
يمكن تفعيل هذا المتطلب، ولكنه لا يسمح بالتغليف الصلب "الكسول" باستخدام
Compact_definition_lists: راجع الامتدادات غير التابعة لـ pandoc، أدناه.)

مرقمة مثال القوائم
التمديد: example_lists
يمكن استخدام علامة القائمة الخاصة @ للأمثلة المرقمة بالتسلسل. القائمة الأولى
سيتم ترقيم العنصر الذي يحمل علامة @ بالرقم "1" والرقم التالي "2" وهكذا طوال الوقت
وثيقة. ليس من الضروري أن تظهر الأمثلة المرقمة في قائمة واحدة؛ كل قائمة جديدة باستخدام @
سوف يستغرق حيث توقف الأخير. لذلك، على سبيل المثال:

(@) المثال الأول سيكون مرقمًا (1).
(@) المثال الثاني سيكون برقم (2).

شرح الأمثلة.

(@) المثال الثالث سيكون رقم (3).

يمكن تسمية الأمثلة المرقمة والإشارة إليها في مكان آخر من المستند:

(@good) هذا مثال جيد.

وكما يوضح (@good)،...

يمكن أن تكون التسمية أي سلسلة من الأحرف الأبجدية الرقمية أو الشرطات السفلية أو الواصلات.

مدمج و فضفاض القوائم
يتصرف Pandoc بشكل مختلف عن Markdown.pl في بعض "حالات الحافة" التي تتضمن قوائم.
خذ بعين الاعتبار هذا المصدر:

+ أولا
+ ثانيا:
- مصاريف
- فاي
- عدو

+ الثالث

يقوم Pandoc بتحويل هذا إلى "قائمة مضغوطة" (بدون أي العلامات حول "الأولى"، "الثانية"،
أو "الثالث")، بينما يضع تخفيض السعر علامات حول "الثانية" و"الثالثة" (ولكن ليس "الأولى")،
بسبب المساحة الفارغة حول "الثالث". يتبع Pandoc قاعدة بسيطة: إذا كان النص كذلك
متبوعًا بسطر فارغ، يتم التعامل معه كفقرة. نظرًا لأن كلمة "الثانية" متبوعة بـ a
القائمة، وليس سطرًا فارغًا، ولا يتم التعامل معها على أنها فقرة. حقيقة أن القائمة هي
متبوعًا بسطر فارغ غير ذي صلة. (ملاحظة: يعمل Pandoc بهذه الطريقة حتى عندما يكون ملف
تم تحديد تنسيق markdown_strict. وهذا السلوك يتفق مع المسؤول
وصف بناء جملة Markdown، على الرغم من أنه يختلف عن ذلك الموجود في Markdown.pl.)

إنهاء a الإدارية
ماذا لو كنت تريد وضع كتلة تعليمات برمجية ذات مسافة بادئة بعد القائمة؟

- البند الأول
- البند الثاني

{ كتلة التعليمات البرمجية الخاصة بي }

مشكلة! هنا، سوف يتعامل pandoc (مثل تطبيقات Markdown الأخرى) مع { my code block } على أنه
الفقرة الثانية من البند الثاني، وليس ككتلة تعليمات برمجية.

"لقص" القائمة بعد العنصر الثاني، يمكنك إدراج بعض المحتوى بدون مسافة بادئة، مثل
تعليق HTML، والذي لن ينتج عنه مخرجات مرئية بأي تنسيق:

- البند الأول
- البند الثاني



{ كتلة التعليمات البرمجية الخاصة بي }

يمكنك استخدام نفس الحيلة إذا كنت تريد قائمتين متتاليتين بدلاً من قائمة واحدة كبيرة:

1. واحد
2- اثنان
3. ثلاثة



1. واحد
2.دوس
3. تريس

أفقي القواعد
سطر يحتوي على صف مكون من ثلاثة أحرف * أو - أو _ أو أكثر (مفصولة بشكل اختياري بـ
مسافات) تنتج قاعدة أفقية:

* * * *

---------------

ترابيزات
يمكن استخدام أربعة أنواع من الجداول. الأنواع الثلاثة الأولى تفترض استخدام أ
الخط ذو العرض الثابت، مثل Courier. النوع الرابع يمكن استخدامه مع متباعدة بشكل متناسب
الخطوط، لأنها لا تتطلب اصطفاف الأعمدة.

التمديد: table_captions
يمكن توفير تسمية توضيحية بشكل اختياري مع جميع أنواع الجداول الأربعة (كما هو موضح في ملف
الأمثلة أدناه). التسمية التوضيحية هي فقرة تبدأ بالسلسلة الجدول: (أو فقط :)،
والتي سيتم تجريدها. وقد تظهر إما قبل الجدول أو بعده.

التمديد: simple_tables
تبدو الجداول البسيطة كما يلي:

يمين يسار وسط افتراضي
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1

الجدول: عرض بناء جملة جدول بسيط.

يجب أن يتناسب كل من الرؤوس وصفوف الجدول مع سطر واحد. يتم تحديد محاذاة الأعمدة بواسطة
موضع نص الرأس بالنسبة إلى الخط المتقطع الموجود أسفله:

· إذا كان الخط المتقطع متسقًا مع نص الرأس على الجانب الأيمن ولكنه يمتد إلى ما بعده
على اليسار، تتم محاذاة العمود إلى اليمين.

· إذا كان الخط المتقطع متسقًا مع نص الرأس على الجانب الأيسر ولكنه يمتد إلى ما بعده
على اليمين، تتم محاذاة العمود إلى اليسار.

· إذا كان الخط المتقطع يمتد إلى ما بعد نص الرأس على كلا الجانبين، فسيتم توسيط العمود.

· إذا كان الخط المتقطع متسقًا مع نص الرأس على كلا الجانبين، فستكون المحاذاة الافتراضية كذلك
المستخدمة (في معظم الحالات، سيتم ترك هذا).

يجب أن ينتهي الجدول بسطر فارغ، أو بخط من الشرطات يليه سطر فارغ.

يمكن حذف رؤوس الأعمدة، بشرط استخدام خط متقطع لإنهاء الجدول. ل
مثال:

------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
------- ------ ---------- -------

عند حذف الرؤوس، يتم تحديد محاذاة الأعمدة على أساس السطر الأول
من جسم الطاولة. لذلك، في الجداول أعلاه، ستكون الأعمدة هي اليمين واليسار والوسط و
محاذاة إلى اليمين، على التوالي.

التمديد: multiline_tables
تسمح الجداول متعددة الأسطر للرؤوس وصفوف الجدول بتوسيع عدة أسطر من النص (لكن الخلايا
التي تمتد عبر أعمدة أو صفوف متعددة من الجدول غير مدعومة). هنا مثال:

-------------------------------------------------- -----------
توسيط افتراضي يمين يسار
رأس محاذاة محاذاة محاذاة
----------- ------- ------------------------------- --------
الصف الأول 12.0 مثال على الصف الذي
يمتد لعدة خطوط.

الصف الثاني 5.0 هنا واحد آخر. ملحوظة
الخط الفارغ بين
صفوف.
-------------------------------------------------- -----------

الجدول: هنا التسمية التوضيحية. وقد تمتد أيضًا
خطوط متعددة.

تعمل هذه مثل الجداول البسيطة، ولكن مع الاختلافات التالية:

· يجب أن تبدأ بصف من الشرطات، قبل نص الرأس (ما لم تكن الرؤوس
محذوف).

· يجب أن تنتهي بصف من الشرطات، ثم سطر فارغ.

· يجب أن تكون الصفوف مفصولة بأسطر فارغة.

في الجداول متعددة الأسطر، يهتم محلل الجدول بعرض الأعمدة، و
يحاول الكتاب إعادة إنتاج هذه العروض النسبية في الإخراج. لذلك، إذا وجدت أن واحدا من
الأعمدة ضيقة جدًا في الإخراج، حاول توسيعها في مصدر Markdown.

يمكن حذف الرؤوس في الجداول متعددة الأسطر وكذلك الجداول البسيطة:

----------- ------- ------------------------------- --------
الصف الأول 12.0 مثال على الصف الذي
يمتد لعدة خطوط.

الصف الثاني 5.0 هنا واحد آخر. ملحوظة
الخط الفارغ بين
صفوف.
----------- ------- ------------------------------- --------

: إليك جدول متعدد الأسطر بدون رؤوس.

من الممكن أن يحتوي الجدول متعدد الأسطر على صف واحد فقط، ولكن يجب أن يتبع الصف
بواسطة سطر فارغ (ثم صف الشرطات الذي ينهي الجدول)، أو قد يكون الجدول
يتم تفسيره على أنه جدول بسيط.

التمديد: Grid_tables
تبدو جداول الشبكة كما يلي:

: نموذج جدول الشبكة.

+----------------------------------------------------------------------------------- ---+
| الفاكهة | السعر | المزايا |
+==================================================================================== ===+
| موز | 1.34 دولار | - غلاف مدمج |
| | | - لون زاهٍ |
+----------------------------------------------------------------------------------- ---+
| برتقال | 2.10 دولار | - يعالج الاسقربوط |
| | | - لذيذ |
+----------------------------------------------------------------------------------- ---+

يفصل صف =s الرأس عن نص الجدول، ويمكن حذفه لـ a
طاولة بلا رأس. قد تحتوي خلايا جداول الشبكة على عناصر كتلة عشوائية (متعددة
الفقرات، وكتل التعليمات البرمجية، والقوائم، وما إلى ذلك). المحاذاة غير مدعومة، ولا الخلايا التي تدعم ذلك
تمتد أعمدة أو صفوف متعددة. يمكن إنشاء جداول الشبكة بسهولة باستخدام وضع جدول Emacs.

التمديد: Pipe_tables
تبدو جداول الأنابيب كما يلي:

| حق | اليسار | الافتراضي | المركز |
|------:|:-----|---------|:------:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |

: مظاهرة بناء جملة جدول الأنابيب.

بناء الجملة مطابق لجداول PHP Markdown Extra. بداية ونهاية الأنابيب
الأحرف اختيارية، ولكن الأنابيب مطلوبة بين كافة الأعمدة. تشير النقطتان
محاذاة العمود كما هو موضح. لا يمكن حذف الرأس. لمحاكاة جدول بدون رأس،
تضمين رأس يحتوي على خلايا فارغة.

نظرًا لأن الأنابيب تشير إلى حدود الأعمدة، فلا يلزم محاذاة الأعمدة رأسيًا، كما هو الحال
هم في المثال أعلاه. إذن، هذه طاولة أنابيب قانونية تمامًا (رغم أنها قبيحة):

فاكهة| سعر
-----|-----:
تفاحة|2.05
كمثرى|1.37
برتقالي|3.09

لا يمكن أن تحتوي خلايا جداول توجيه الإخراج على عناصر كتلة مثل الفقرات والقوائم و
لا يمكن أن يمتد لعدة أسطر. إذا كان جدول توجيه الإخراج يحتوي على صف يكون محتواه القابل للطباعة
أكبر من عرض العمود (انظر --columns)، ثم ستلتف محتويات الخلية، مع
عروض الخلايا النسبية التي تحددها عروض الخطوط الفاصلة.

ملحوظة: يتعرف pandoc أيضًا على جداول الأنابيب بالشكل التالي، كما يمكن إنتاجها بواسطة
الوضع التنظيمي لـ Emacs:

| واحد | اثنان |
|-----+-------|
| بلدي | الجدول |
| هو | لطيف |

الفرق هو أنه يتم استخدام + بدلاً من |. ميزات orgtbl الأخرى غير مدعومة.
على وجه الخصوص، للحصول على محاذاة أعمدة غير افتراضية، ستحتاج إلى إضافة نقطتين كما هو مذكور أعلاه.

البيانات الوصفية كتل
التمديد: pandoc_title_block
إذا كان الملف يبدأ بكتلة عنوان

٪ عنوان
النسبة المئوية للمؤلفين (المؤلفين) (مفصولة بفواصل منقوطة)
٪ تاريخ

سيتم تحليلها على أنها معلومات ببليوغرافية، وليس نصًا عاديًا. (سيتم استخدامه ل
على سبيل المثال، في عنوان مخرجات LaTeX أو HTML المستقلة.) قد تحتوي الكتلة على فقط
العنوان، العنوان والمؤلف، أو العناصر الثلاثة جميعها. إذا كنت ترغب في تضمين مؤلف ولكن
بدون عنوان، أو عنوان وتاريخ ولكن بدون مؤلف، تحتاج إلى سطر فارغ:

%
٪ مؤلف

٪ لقبي
%
% 15 يونيو 2006

قد يشغل العنوان عدة أسطر، ولكن يجب أن تبدأ أسطر الاستمرار بمسافة بادئة،
على النحو التالي:

٪ لقبي
على خطوط متعددة

إذا كان المستند يحتوي على مؤلفين متعددين، فقد يتم وضع المؤلفين في أسطر منفصلة مع بادئة
مسافة، أو مفصولة بفواصل منقوطة، أو كليهما. إذن كل ما يلي متساوي:

% المؤلف واحد
المؤلف الثاني

% المؤلف واحد؛ المؤلف الثاني

% المؤلف واحد؛
المؤلف الثاني

يجب أن يتناسب التاريخ مع سطر واحد.

قد تحتوي جميع حقول بيانات التعريف الثلاثة على تنسيق قياسي مضمّن (خط مائل، روابط،
الحواشي، وما إلى ذلك).

سيتم دائمًا تحليل كتل العنوان، ولكنها لن تؤثر على الإخراج إلا عندما يكون
تم تحديد الخيار --standalone (-s). في مخرجات HTML، ستظهر العناوين مرتين: مرة واحدة في ملف
رأس المستند - هذا هو العنوان الذي سيظهر أعلى نافذة المتصفح
-- ومرة ​​واحدة في بداية نص المستند. يمكن أن يكون العنوان الموجود في رأس المستند
لديك بادئة اختيارية مرفقة (--title-prefix أو -T الخيار). العنوان في الجسد
يظهر كعنصر H1 مع "عنوان" فئة، بحيث يمكن منعه أو إعادة تنسيقه باستخدام
CSS. إذا تم تحديد بادئة عنوان بـ -T ولم تظهر كتلة عنوان في المستند،
سيتم استخدام بادئة العنوان بمفردها كعنوان HTML.

يقوم كاتب صفحة الدليل باستخراج عنوان ورقم قسم صفحة الدليل ورأس وتذييل آخر
المعلومات من سطر العنوان. من المفترض أن يكون العنوان هو الكلمة الأولى في العنوان
السطر، والذي قد ينتهي اختياريًا برقم قسم (مكون من رقم واحد) بين قوسين.
(يجب ألا يكون هناك مسافة بين العنوان والأقواس). أي شيء بعد ذلك يكون كذلك
من المفترض أن يكون نص تذييل ورأس إضافي. يجب أن يكون حرف توجيه واحد (|).
يستخدم لفصل نص التذييل عن نص الرأس. هكذا،

% باندوك(1)

سينتج عنه صفحة دليلية بعنوان PANDOC والقسم 1.

% باندوك(1) أدلة مستخدم باندوك

سيكون هناك أيضًا "أدلة مستخدم Pandoc" في التذييل.

% باندوك(1) أدلة مستخدم باندوك | الإصدار 4.0

سيكون هناك أيضًا "الإصدار 4.0" في الرأس.

التمديد: yaml_metadata_block
كتلة بيانات تعريف YAML هي كائن YAML صالح، محدد بخط من ثلاث شرطات (---)
في الأعلى وسطر من ثلاث شرطات (---) أو ثلاث نقاط (...) في الأسفل. يامل
قد تحدث كتلة بيانات التعريف في أي مكان في المستند، ولكن إذا لم تكن في البداية، فإنها
يجب أن يسبقه سطر فارغ. (لاحظ أنه بسبب الطريقة التي يتسلسل بها pandoc
input عندما يتم توفير العديد منها، يمكنك أيضًا الاحتفاظ بالبيانات التعريفية في ملف YAML منفصل
الملف وتمريره إلى pandoc كوسيطة، إلى جانب ملفات Markdown الخاصة بك:

pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o book.html

فقط تأكد من أن ملف YAML يبدأ بـ --- وينتهي بـ --- أو ....)

سيتم أخذ البيانات التعريفية من حقول كائن YAML وإضافتها إلى أي كائن موجود
البيانات التعريفية للوثيقة. يمكن أن تحتوي البيانات التعريفية على قوائم وكائنات (متداخلة بشكل عشوائي)، ولكن جميعها
سيتم تفسير الكميات القياسية للسلسلة على أنها Markdown. الحقول التي تنتهي أسماؤها بشرطة سفلية
سيتم تجاهله بواسطة pandoc. (قد يتم منحهم دورًا بواسطة معالجات خارجية.)

قد يحتوي المستند على كتل بيانات تعريف متعددة. سيتم دمج حقول البيانات التعريفية
من خلال متحيز لليسار الاتحاد: إذا حاولت كتلتان من البيانات الوصفية تعيين نفس الحقل، فسيتم
سيتم أخذ القيمة من الكتلة الأولى.

عندما يتم استخدام pandoc مع -t markdown لإنشاء مستند Markdown، فسيتم إنشاء كتلة بيانات تعريف YAML
سيتم إنتاجه فقط إذا تم استخدام الخيار -s/--standalone. جميع البيانات الوصفية سوف
تظهر في كتلة واحدة في بداية المستند.

لاحظ أنه يجب اتباع قواعد الهروب YAML. وبالتالي، على سبيل المثال، إذا كان العنوان يحتوي على أ
القولون، لا بد من نقله. يمكن استخدام حرف توجيه الإخراج (|) لبدء كتلة ذات مسافة بادئة
سيتم تفسير ذلك حرفيًا، دون الحاجة إلى الهروب. هذا النموذج ضروري
عندما يحتوي الحقل على أسطر فارغة:

---
title: "هذا هو العنوان: يحتوي على نقطتين"
مؤلف:
- الاسم : المؤلف واحد
الانتماء: جامعة مكان ما
- الاسم : المؤلف الثاني
الانتماء : جامعة العدم
العلامات: [لا شيء، لا شيء]
الملخص: |
هذا هو الملخص.

ويتكون من فقرتين.


سيتم تعيين متغيرات القالب تلقائيًا من البيانات التعريفية. وهكذا، على سبيل المثال، في
عند كتابة HTML، سيتم تعيين الملخص المتغير على ما يعادل HTML لـ Markdown
المجال الملخص:

هذا هو الملخص.
ويتكون من فقرتين.

ملاحظة: يتوقع متغير المؤلف في القوالب الافتراضية قائمة أو سلسلة بسيطة. ل
استخدم المؤلفين المنظمين في المثال، فستحتاج إلى قالب مخصص. على سبيل المثال:

$ لـ (المؤلف) $
$إذا(author.name)$
$author.name$$if(author.affiliation)$ ($author.affiliation$)$endif$
$ else $
$المؤلف$
$ endif $
endfor $

مائل الهروب
التمديد: all_symbols_escapable
باستثناء داخل مقطع التعليمات البرمجية أو التعليمات البرمجية المضمنة، فإن أي علامات ترقيم أو حرف مسافة يسبقه
سيتم التعامل مع الشرطة المائلة العكسية حرفيًا، حتى لو كانت تشير عادةً إلى التنسيق.
وهكذا، على سبيل المثال، إذا كان أحد يكتب

*\*مرحبًا\**

سوف يحصل المرء

*مرحبًا*

بدلا من

أهلا

هذه القاعدة أسهل في التذكر من قاعدة Markdown القياسية، والتي تسمح فقط بـ
الأحرف التالية المراد تخطيها بخط مائل عكسي:

\`*_{}[]()>#+-.!

(ومع ذلك، إذا تم استخدام تنسيق markdown_strict، فسيتم استخدام قاعدة Markdown القياسية.)

يتم تحليل مسافة تخطي الشرطة المائلة العكسية كمسافة غير منقسمة. سوف يظهر في إخراج TeX
كـ ~ وفي HTML وXML كـ \ أو \ .

يتم تحليل السطر الجديد الذي تم تجاوزه بشرطة مائلة عكسية (أي خط مائل عكسي يحدث في نهاية السطر)
ككسر متشدد. سيظهر في إخراج TeX كـ \\ وفي HTML كـ . هذا هو
بديل لطيف لطريقة Markdown "غير المرئية" للإشارة إلى فواصل الخطوط المتشددة باستخدام اثنين
مسافات زائدة على السطر.

لا تعمل عمليات الهروب من الخط المائل العكسي في السياقات الحرفية.

لوحة تحكم ذكية علامات ترقيم
تمديد
إذا تم تحديد خيار --smart، فسيقوم pandoc بإنتاج مخرجات صحيحة مطبعيًا،
تحويل علامات الاقتباس المستقيمة إلى علامات اقتباس متعرجة، --- إلى شرطات طويلة، -- إلى شرطات طويلة، و... إلى
الحذف. يتم إدراج مسافات غير منقسمة بعد اختصارات معينة، مثل "السيد."

ملاحظة: إذا كان قالب LaTeX أو أي ملف رأس مضمن يستدعي حزمة csquotes،
سيكتشف pandoc هذا تلقائيًا ويستخدم \enquote{...} للنص المقتبس.

في النسق التنسيق
تشديد
إلى التأكيد بعض النصوص، أحيطها بـ *s أو _، مثل هذا:

تم التأكيد على هذا النص بشرطات سفلية، وهذا
* تم التأكيد عليه بالعلامات النجمية *.

مزدوج * أو _ ينتج قوي تشديد:

هذا **تركيز قوي** و__مع شرطات سفلية__.

لن يؤدي الحرف * أو _ المحاط بمسافات أو الشرطة المائلة العكسية إلى تشغيل التركيز:

لم يتم التأكيد على هذا *، و \*ولا هذا أيضًا\*.

التمديد: intraword_underscores
نظرًا لأن _ يتم استخدامه أحيانًا داخل الكلمات والمعرفات، فإن pandoc لا يفسر _
محاطة بأحرف أبجدية رقمية كعلامة تأكيد. إذا كنت تريد التأكيد
مجرد جزء من الكلمة، استخدم *:

ممكن * ible *، غير ممكن * قادر *.

قذفة
التمديد: إضراب
لشطب قسم من النص بخط أفقي، ابدأه وإنهائه بـ ~~. هكذا،
على سبيل المثال،

هذا ~~نص محذوف.~~

مرتفع و الاشتراكات
التمديد: مرتفع, منخفض
يمكن كتابة الحروف المرتفعة عن طريق إحاطة النص المرتفع بأحرف ^؛
يمكن كتابة الاشتراكات من خلال إحاطة النص المكتوب بأحرف ~. وهكذا ل
مثال،

H~2~O سائل. 2^10^ يساوي 1024.

إذا كان النص المرتفع أو المنخفض يحتوي على مسافات، فيجب تجاوز هذه المسافات
مع خطوط مائلة عكسية. (وهذا لمنع الكتابة الفوقية والاشتراك من خلال
الاستخدام العادي لـ ~ و^.) وبالتالي، إذا كنت تريد الحرف P مع "قطة" في الحروف السفلية،
استخدم P~a\ cat~، وليس P~a cat~.

حرفي
لإنشاء فترة قصيرة من النص حرفيًا، ضعه داخل علامات التحديد الخلفية:

ما الفرق بين `>>=` و `>>`؟

إذا كان النص الحرفي يتضمن علامة نقر خلفية، فاستخدم علامات نقر خلفية مزدوجة:

هنا علامة خلفية حرفية `` ``.

(سيتم تجاهل المسافات بعد نقرات الفتح الخلفية وقبل نقرات الإغلاق الخلفية.)

القاعدة العامة هي أن الامتداد الحرفي يبدأ بسلسلة من النقرات الخلفية المتتالية
(متبوعة بمسافة اختياريًا) وتنتهي بسلسلة من نفس عدد النقرات الخلفية
(يُسبق اختياريًا بمسافة).

لاحظ أن عمليات الهروب من الخط المائل العكسي (وبنيات Markdown الأخرى) لا تعمل حرفيًا
السياقات:

هذه شرطة مائلة عكسية متبوعة بعلامة النجمة: `\*`.

التمديد: inline_code_attributes
يمكن إرفاق السمات بالنص الحرفي، تمامًا كما هو الحال مع كتل التعليمات البرمجية المسيجة:

`<$>`{.هاسكل}


صغير قبعات
لكتابة أحرف كبيرة صغيرة، يمكنك استخدام علامة امتداد HTML:

قبعات صغيرة

(الفاصلة المنقوطة اختيارية وقد يكون هناك مسافة بعد النقطتين.) سيعمل هذا في الكل
تنسيقات الإخراج التي تدعم الأحرف الكبيرة الصغيرة.

الرياضيات
التمديد: tex_math_dollars
سيتم التعامل مع أي شيء يتراوح بين حرفين $ على أنه رياضيات TeX. يجب أن يحتوي $ الافتتاحي على
حرف غير مسافات على يمينه مباشرة، بينما يجب أن يحتوي $ الإغلاق على مسافة غير
الحرف الموجود مباشرة على يساره، ويجب ألا يتبعه رقم على الفور. هكذا،
لن يتم تحليل مبلغ 20,000 دولار و30,000 دولار كحسابات رياضية. إذا كنت بحاجة لسبب ما إلى إرفاق النص
أحرف $ الحرفية، قم بتخطي الشرطة المائلة العكسية ولن يتم التعامل معها كمحددات رياضية.

ستتم طباعة TeX math بجميع تنسيقات الإخراج. تعتمد كيفية تقديمه على الإخراج
شكل:

تخفيض السعر، لاتيكس ، إيماكس المؤسسة الوضع، سياق الكلام
وسوف تظهر حرفيا بين أحرف $.

reStructuredText
سيتم تقديمه باستخدام دور النص المفسر:math:.

AsciiDoc
سيتم تقديمه كـ latexmath:[...].

تكسنفو
سيتم تقديمه داخل أمر @math.

جروف رجل
سيتم تقديمه حرفيًا بدون $.

ميدياويكي, دوكو ويكي
سيتم تقديمه في الداخل العلامات.

نسيج
سيتم تقديمه داخل العلامات.

رتف، مستند مفتوح, ODT
سيتم عرضه، إن أمكن، باستخدام أحرف Unicode، وسيتم خلاف ذلك
تظهر حرفيا

دوكبوك
إذا تم استخدام علامة --mathml، فسيتم عرضها باستخدام MathML في معادلة سطرية
أو علامة المعادلة غير الرسمية. وإلا فسيتم تقديمه، إن أمكن، باستخدام Unicode
حرفا.

دوكإكس سيتم تقديمه باستخدام ترميز الرياضيات OMML.

كتاب الخيال2
إذا تم استخدام خيار --webtex، فسيتم عرض الصيغ كصور باستخدام مخططات Google
أو أي خدمة ويب متوافقة أخرى، يتم تنزيلها ودمجها في الكتاب الإلكتروني. خلاف ذلك،
سوف تظهر حرفيا.

لغة البرمجة، زلق، شرائح دي زي, S5، EPUB
تعتمد طريقة عرض الرياضيات في HTML على خيارات سطر الأوامر المحددة:

1. الإعداد الافتراضي هو تقديم رياضيات TeX إلى أقصى حد ممكن باستخدام أحرف Unicode،
كما هو الحال مع مخرجات RTF وDocBook وOpenDocument. يتم وضع الصيغ داخل فترة
مع class = "math"، بحيث يمكن تصميمها بشكل مختلف عن البيئة المحيطة
النص إذا لزم الأمر.

2. إذا تم استخدام خيار --latexmathml، فسيتم عرض TeX math بين $ أو $$
الأحرف ووضع العلامات مع فئة LaTeX. سيقوم البرنامج النصي LaTeXMathML بذلك
يمكن استخدامها لتقديمها كصيغ. (هذه الخدعة لا تعمل في جميع المتصفحات،
لكنه يعمل في فايرفوكس. في المتصفحات التي لا تدعم LaTeXMathML، TeX math
سيظهر حرفيًا بين أحرف $.)

3. إذا تم استخدام خيار --jsmath، فسيتم وضع TeX math داخل العلامات (for
الرياضيات المضمنة) أو العلامات (لعرض الرياضيات) مع الرياضيات الصفية. jsMath
سيتم استخدام البرنامج النصي لعرضه.

4. إذا تم استخدام خيار --mimetex، فسيتم استدعاء البرنامج النصي mimeTeX CGI إليه
إنشاء صور لكل صيغة TeX. يجب أن يعمل هذا في جميع المتصفحات. ال
--mimetex يأخذ الخيار عنوان URL اختياريًا كوسيطة. إذا لم يتم تحديد عنوان URL، فسيتم ذلك
من المفترض أن البرنامج النصي mimeTeX CGI موجود في /cgi-bin/mimetex.cgi.

5. إذا تم استخدام خيار --gladtex، فسيتم تضمين صيغ TeX العلامات في
إخراج HTML. يمكن بعد ذلك معالجة ملف htex الناتج بواسطة GladTeX،
والتي ستنتج ملفات صور لكل صيغة وملف HTML مع روابط إلى
هذه الصور. إذن الإجراء هو:

pandoc -s --gladtex myfile.txt -o myfile.htex
Gladtex -d myfile-images myfile.htex
# ينتج myfile.html والصور في myfile-images

6. إذا تم استخدام خيار --webtex، فسيتم تحويل صيغ TeX إلى العلامات
التي ترتبط ببرنامج نصي خارجي يحول الصيغ إلى صور. الصيغة
سيتم ترميزه بعنوان URL ومتصلاً بعنوان URL المقدم. إذا لم يكن هناك عنوان URL
المحدد، سيتم استخدام Google Chart API
(http://chart.apis.google.com/chart?cht=tx&chl=).

7. إذا تم استخدام خيار --mathjax، فسيتم عرض TeX math بين \(...\) (لـ
الرياضيات المضمنة) أو \[...\] (لعرض الرياضيات) ووضع العلامات مع الفصل
الرياضيات. سيتم استخدام البرنامج النصي MathJax لعرضه كصيغ.

الخام HTML
التمديد: Raw_html
يسمح لك Markdown بإدراج HTML خام (أو DocBook) في أي مكان في المستند (باستثناء
السياقات الحرفية، حيث يتم تفسير < و> و& حرفيًا). (من الناحية الفنية هذا ليس كذلك
امتدادًا، نظرًا لأن Markdown القياسي يسمح بذلك، ولكن تم إنشاء امتداد لذلك
يمكن تعطيله إذا رغبت في ذلك.)

يتم تمرير HTML الخام دون تغيير في HTML، S5، Slidy، Slideous، DZSlides، EPUB،
تخفيض السعر، وإخراج النسيج، وقمعها في تنسيقات أخرى.

التمديد: markdown_in_html_blocks
يسمح لك Standard Markdown بتضمين "كتل" HTML: كتل HTML بين متوازنة
العلامات المفصولة عن النص المحيط بأسطر فارغة، وتبدأ وتنتهي عند
الهامش الأيسر. داخل هذه الكتل، يتم تفسير كل شيء على أنه HTML، وليس Markdown؛ لذا
(على سبيل المثال)، * لا تعني التوكيد.

يتصرف Pandoc بهذه الطريقة عند استخدام تنسيق markdown_strict؛ ولكن بشكل افتراضي، باندوك
يفسر المواد بين علامات كتلة HTML على أنها تخفيض السعر. وهكذا، على سبيل المثال، سوف باندوك
منعطف



*واحد*
[رابط](http://google.com)



إلى



واحد
<a href="/http://google.com">رابط



في حين أن Markdown.pl سوف يبقيه كما هو.

هناك استثناء واحد لهذه القاعدة: النص بين and tags is not
يتم تفسيره على أنه تخفيض السعر.

هذا الخروج عن Markdown القياسي من شأنه أن يسهل مزج Markdown مع HTML
عناصر الكتلة. على سبيل المثال، يمكن للمرء أن يحيط كتلة من نص Markdown بـ العلامات
دون منع تفسيرها على أنها تخفيض السعر.

التمديد: original_divs
استخدم كتل pandoc Div الأصلية للمحتوى الموجود بداخلها العلامات. بالنسبة للجزء الاكبر هذا ينبغي
تعطي نفس النتيجة مثل markdown_in_html_blocks، ولكنها تجعل من السهل كتابة pandoc
المرشحات لمعالجة مجموعات الكتل.

التمديد: original_spans
استخدم كتل pandoc Span الأصلية للمحتوى داخل العلامات. بالنسبة للجزء الاكبر هذا
يجب أن يعطي نفس الإخراج مثل Raw_html، ولكنه يسهل كتابة مرشحات Pandoc إليه
التعامل مع مجموعات من السطور.

الخام تكس
التمديد: Raw_tex
بالإضافة إلى HTML الخام، يسمح pandoc بتضمين LaTeX وTeX وConTeXt الخام في ملف
وثيقة. سيتم الاحتفاظ بأوامر Inline TeX وتمريرها دون تغيير إلى LaTeX و
مؤلفو ConTeXt. وبالتالي، على سبيل المثال، يمكنك استخدام LaTeX لتضمين استشهادات BibTeX:

تم إثبات هذه النتيجة في \cite{jones.1967}.

لاحظ أنه في بيئات LaTeX، مثل

\begin{tabular}{|l|l|}\hline
العمر والتكرار \\ \hline
18--25 و 15\
26--35 و 33\
36--45 و 22 \\ \ح
\ نهاية {جدول}

سيتم تفسير المادة الموجودة بين علامتي البداية والنهاية على أنها LaTeX خام، وليس على أنها
تخفيض السعر.

يتم تجاهل Inline LaTeX في تنسيقات الإخراج بخلاف Markdown وLaTeX وConTeXt.

مطاط وحدات الماكرو
التمديد: latex_macros
بالنسبة لتنسيقات الإخراج بخلاف LaTeX، سيقوم pandoc بتحليل LaTeX \newcommand و \renewcommand
التعريفات وتطبيق وحدات الماكرو الناتجة على جميع رياضيات LaTeX. لذلك، على سبيل المثال،
سيعمل ما يلي في جميع تنسيقات الإخراج، وليس فقط LaTeX:

\newcommand{\tuple}[1]{\langle #1 \rangle}

$\tuple{أ، ب، ج}$

في إخراج LaTeX، سيتم ببساطة تمرير تعريف \newcommand إلى الإخراج دون تغيير.

الروابط
يسمح Markdown بتحديد الروابط بعدة طرق.

أوتوماتيك وصلات
إذا قمت بإدراج عنوان URL أو عنوان بريد إلكتروني بين قوسين مدببين، فسيصبح رابطًا:

<http://google.com>
<سام@green.eggs.ham>

في النسق وصلات
يتكون الارتباط المضمن من نص الرابط بين قوسين مربعين، متبوعًا بعنوان URL الموجود
بين قوسين. (اختياريًا، يمكن أن يتبع عنوان URL عنوان الرابط بين علامتي اقتباس.)

هذا هو [رابط مضمن](/url)، وإليك [رابط به
عنوان](http://fsf.org "انقر هنا لقضاء وقت ممتع!").

لا يمكن أن يكون هناك مسافة بين الجزء الموجود بين قوسين والجزء الموجود بين قوسين. الرابط
يمكن أن يحتوي النص على تنسيق (مثل التوكيد)، ولكن لا يمكن أن يحتوي العنوان.

لا يتم اكتشاف عناوين البريد الإلكتروني الموجودة في الروابط المضمنة تلقائيًا، لذا يجب أن تكون مسبوقة بـ
ميلتو:

[اكتب لي!](ميلتو: sam@green.eggs.ham)

الرقم المرجعي وصلات
An صريح يتكون الرابط المرجعي من جزأين، الرابط نفسه وتعريف الرابط، والذي
قد يحدث في مكان آخر من المستند (إما قبل الارتباط أو بعده).

يتكون الرابط من نص الرابط بين قوسين مربعين، متبوعًا بالتسمية بين قوسين مربعين.
(يمكن أن يكون هناك مسافة بين الاثنين.) يتكون تعريف الارتباط من التسمية الموجودة بين قوسين،
متبوعة بنقطتين ومسافة، متبوعة بعنوان URL، واختياريًا (بعد مسافة) أ
عنوان الرابط إما بين علامتي اقتباس أو بين قوسين. يجب ألا تكون التسمية قابلة للتحليل كـ a
الاقتباس (بافتراض تمكين ملحق الاستشهادات): الاستشهادات لها الأسبقية
تسميات الارتباط.

وهنا بعض الأمثلة:

[تصنيفي 1]: /foo/bar.html "عنواني، اختياري"
[علامتي 2]: /foo
[علامتي 3]: http://fsf.org (مؤسسة البرمجيات الحرة)
[التسمية الخاصة بي 4]: /bar#special "عنوان بين علامتي اقتباس مفردتين"

يمكن أن يكون عنوان URL محاطًا بشكل اختياري بأقواس زاوية:

[علامتي 5]:http://foo.bar.baz>

قد يكون العنوان في السطر التالي:

[علامتي 3]: http://fsf.org
"مؤسسة البرمجيات الحرة"

لاحظ أن تسميات الارتباط ليست حساسة لحالة الأحرف. لذلك، سوف يعمل هذا:

هنا [الرابط الخاص بي] [FOO]

[فو]: /bar/baz

في ضمني الرابط المرجعي، الزوج الثاني من الأقواس فارغ:

راجع [موقع الويب الخاص بي] [].

[موقعي]: http://foo.bar.baz

ملحوظة: في Markdown.pl ومعظم تطبيقات Markdown الأخرى، قم بالإشارة إلى تعريفات الارتباط
لا يمكن أن يحدث في الإنشاءات المتداخلة مثل عناصر القائمة أو علامات الاقتباس. يرفع باندوك
هذا التقييد الظاهر التعسفي. لذلك فإن ما يلي جيد في pandoc، ولكن ليس في
معظم التطبيقات الأخرى:

> كتلتي [اقتباس].
>
> [اقتباس]: /foo

التمديد: Shortcut_reference_links
في باقة الاختصار الرابط المرجعي، قد يتم حذف الزوج الثاني من الأقواس بالكامل:

انظر [موقع الويب الخاص بي].

[موقعي]: http://foo.bar.baz

داخلي وصلات
للارتباط بقسم آخر من نفس المستند، استخدم الملف الذي تم إنشاؤه تلقائيًا
المعرف (انظر معرفات الرأس). على سبيل المثال:

راجع [المقدمة](#المقدمة).

or

انظر [المقدمة].

[المقدمة]: #المقدمة

الروابط الداخلية مدعومة حاليًا لتنسيقات HTML (بما في ذلك عروض شرائح HTML و
EPUB)، وLaTeX، وConTeXt.

صور منشأة بالذكاء الاصطناعي
رابط يسبقه مباشرة ! سيتم التعامل معها كصورة. سيكون نص الرابط
يستخدم كنص بديل للصورة:


![بكرة الفيلم]

[بكرة الفيلم]: movie.gif

التمديد: implicit_figures
سيتم عرض الصورة التي تحدث بمفردها في الفقرة كشكل مع تسمية توضيحية.
(في LaTeX، سيتم استخدام بيئة الشكل؛ وفي HTML، سيتم وضع الصورة في div
مع شكل الفصل، جنبًا إلى جنب مع تسمية توضيحية في ap مع تسمية توضيحية للفصل.) الصورة البديلة
سيتم استخدام النص كتسمية توضيحية.


إذا كنت تريد فقط صورة مضمنة عادية، فقط تأكد من أنها ليست الشيء الوحيد في
فقرة. إحدى الطرق للقيام بذلك هي إدراج مسافة غير منقسمة بعد الصورة:


التمديد: link_attributes
يمكن تعيين السمات على الروابط والصور:

سطر {#id .class width=30 height=20px}
ومرجع![صورة][المرجع] مع السمات.

[المرجع]: foo.jpg "عنوان اختياري" {#id .class key=val key2="val 2"}

(يتوافق بناء الجملة هذا مع PHP Markdown Extra عند استخدام #id و.class فقط.)

بالنسبة إلى HTML وEPUB، جميع السمات باستثناء العرض والارتفاع (ولكن بما في ذلك srcset والأحجام)
يتم تمريرها كما هي. يتجاهل الكتاب الآخرون السمات التي لا يدعمها
تنسيق الإخراج الخاص بهم.

يتم التعامل مع سمات العرض والارتفاع في الصور بشكل خاص. عندما تستخدم بدون
الوحدة، من المفترض أن تكون الوحدة عبارة عن بكسل. ومع ذلك، أي من معرفات الوحدة التالية
يمكن استخدامها: بكسل، سم، مم، بوصة، بوصة و٪. يجب ألا يكون هناك أي مسافات بين الرقم
والوحدة. على سبيل المثال:

{ width=50% }

· يتم تحويل الأبعاد إلى بوصة لإخراجها بتنسيقات مستندة إلى الصفحة مثل LaTeX.
يتم تحويل الأبعاد إلى وحدات بكسل للإخراج بتنسيقات تشبه HTML. استخدم --dpi
خيار لتحديد عدد البكسل في البوصة. الافتراضي هو 96 نقطة في البوصة.

· الوحدة المئوية تتعلق عمومًا ببعض المساحة المتاحة. على سبيل المثال المثال أعلاه
سوف يقدم ل (لغة ​​البرمجة)،
\includegraphics[width=0.5\textwidth]{file.jpg} (LaTeX)، أو
\externalfigure[file.jpg][width=0.5\textwidth] (ConTeXt).

· تحتوي بعض تنسيقات الإخراج على فكرة فئة (ConTeXt) أو معرف فريد (LaTeX
\caption)، أو كليهما (HTML).

· عندما لا يتم تحديد سمات العرض أو الارتفاع، يكون الإجراء الاحتياطي هو النظر إلى الصورة
الدقة والبيانات الوصفية للنقطة في البوصة المضمنة في ملف الصورة.

الحواشي
التمديد: الحواشي
يسمح Pandoc's Markdown بالحواشي السفلية باستخدام الصيغة التالية:

إليك مرجع الحاشية السفلية،[^1] وآخر.[^longnote]

[^1]: هذه هي الحاشية السفلية.

[^longnote]: هذه واحدة تحتوي على كتل متعددة.

يتم وضع مسافة بادئة للفقرات اللاحقة لإظهار أنها
تنتمي إلى الحاشية السابقة.

{ بعض الكود }

يمكن وضع مسافة بادئة للفقرة بأكملها، أو للفقرة الأولى فقط
خط. بهذه الطريقة، تعمل الحواشي السفلية متعددة الفقرات
عناصر القائمة متعددة الفقرات.

لن تكون هذه الفقرة جزءًا من الملاحظة، لأنها
لم يتم وضع مسافة بادئة.

لا يجوز أن تحتوي المعرفات الموجودة في مراجع الحواشي السفلية على مسافات أو علامات تبويب أو أسطر جديدة. هؤلاء
يتم استخدام المعرفات فقط لربط مرجع الحاشية السفلية بالملاحظة نفسها؛ في ال
الناتج، سيتم ترقيم الحواشي بالتسلسل.

ليس من الضروري وضع الحواشي السفلية نفسها في نهاية المستند. قد تظهر
في أي مكان باستثناء داخل عناصر الكتلة الأخرى (القوائم، علامات الاقتباس، الجداول، وما إلى ذلك).

التمديد: inline_notes
يُسمح أيضًا بالحواشي السفلية المضمنة (على الرغم من أنها، على عكس الملاحظات العادية، لا يمكن أن تحتوي على
فقرات متعددة). بناء الجملة هو كما يلي:

هذه ملاحظة مضمنة. ^[الملاحظات المضمنة أسهل في الكتابة، منذ ذلك الحين
ليس عليك اختيار معرف والانتقال لأسفل لكتابة
ملحوظة.]

يمكن خلط الحواشي السفلية والعادية بحرية.

الاستشهادات
التمديد: الاستشهادات
باستخدام مرشح خارجي، pandoc-citeproc، يمكن لـ pandoc إنشاء الاستشهادات تلقائيًا و
ببليوغرافيا في عدد من الأساليب. الاستخدام الأساسي هو

pandoc --filter pandoc-citeproc myinput.txt

من أجل استخدام هذه الميزة، سوف تحتاج إلى تحديد ملف قائمة المراجع باستخدام الملف
حقل بيانات تعريف الببليوغرافيا في قسم بيانات تعريف YAML، أو سطر أوامر --bibliography
دعوى. يمكنك توفير وسائط --bibliography متعددة أو تعيين بيانات تعريف الببليوغرافيا
الحقل إلى مصفوفة YAML، إذا كنت تريد استخدام ملفات ببليوغرافية متعددة. الببليوغرافيا قد
لديك أي من هذه التنسيقات:

تنسيق امتداد الملف
───────────────────────────
BibLaTeX .bib
BibTeX
كوباك كوباك

CSL JSON .json
CSL YAML .yaml
مذكرة النهاية .enl
النوتة XML .xml
ISI .wos
ميدلاين .ميدلاين
نماذج MODS
ريس .ريس

لاحظ أنه يمكن استخدام .bib مع كل من ملفات BibTeX وBibLaTeX؛ استخدم .bibtex للقوة
بيبيتكس.

لاحظ أن pandoc-citeproc --bib2json وpandoc-citeproc --bib2yaml يمكن أن ينتجا .json و
ملفات .yaml من أي من التنسيقات المدعومة.

الترميز الميداني: في قواعد بيانات BibTeX وBibLaTeX، يقوم pandoc-citeproc بتوزيع مجموعة فرعية من
ترميز LaTeX؛ في قواعد بيانات CSL YAML، pandoc Markdown؛ وفي قواعد بيانات CSL JSON، an
ترميز يشبه HTML:


المائل

...
الخطّ الغامق

<سبان ستايل = "font-variant:small-caps;">... or ...
عواصم صغيرة

...
منخفض

...
حرف فوقي

<سبان فئة = "نوكاسي">...
منع العبارة من الكتابة بالأحرف الكبيرة كحالة عنوان

يقوم pandoc-citeproc -j و -y بتحويل تنسيقات CSL JSON وCSL YAML بقدر ما
ممكن.

كبديل لتحديد ملف قائمة المراجع باستخدام --bibliography أو YAML
الببليوغرافيا الميدانية للبيانات الوصفية، يمكنك تضمين بيانات الاقتباس مباشرة في المراجع
حقل بيانات تعريف YAML للمستند. يجب أن يحتوي الحقل على مجموعة من ترميز YAML
المراجع، على سبيل المثال:

---
المراجع:
- النوع: مقالة يومية
المعرف: واتسون كريك 1953
مؤلف:
- العائلة : واتسون
المعطى: دينار
- العائلة : كريك
المعطى: FHC
صادر:
أجزاء التاريخ:
- - واحد
- 4
- 25
العنوان: "البنية الجزيئية للأحماض النووية: بنية الديوكسيريبوز".
حمض نووي'
عنوان قصير: التركيب الجزيئي للأحماض النووية
عنوان الحاوية: الطبيعة
الحجم: 171
العدد: 4356
الصفحة: 737-738
دوى: 10.1038/171737a0
URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
اللغة: en-GB


(يمكن لـ pandoc-citeproc --bib2yaml إنتاج هذه العناصر من ملف ببليوغرافي في أحد ملفات
التنسيقات المدعومة.)

يمكن تنسيق الاستشهادات والمراجع باستخدام أي نمط يدعمه نمط الاقتباس
اللغة مدرجة في Zotero Style Repository. يتم تحديد هذه الملفات باستخدام
خيار --csl أو حقل بيانات تعريف CSL. بشكل افتراضي، سيستخدم pandoc-citepro ملف Chicago
دليل أسلوب تنسيق تاريخ المؤلف. يوفر مشروع CSL مزيدًا من المعلومات حول
البحث عن الأنماط وتحريرها.

لجعل استشهاداتك مرتبطة ارتباطًا تشعبيًا بإدخالات المراجع المقابلة، قم بإضافة
اقتباسات الارتباط: مطابقة لبيانات تعريف YAML الخاصة بك.

توضع الاستشهادات بين قوسين مربعين ويتم الفصل بينها بفواصل منقوطة. يجب على كل اقتباس
لديك مفتاح يتكون من "@" + معرف الاقتباس من قاعدة البيانات، وقد
اختياريًا، يكون لديك بادئة ومحدد موقع ولاحقة. يجب أن يبدأ مفتاح الاقتباس بـ a
حرف أو رقم أو _، وقد يحتوي على حروف أبجدية رقمية و_ وأحرف ترقيم داخلية
(:.#$%&-+?<>~/). وهنا بعض الأمثلة:

بلاه بلاه [انظر @doe99، الصفحات من 33 إلى 35؛ أيضا @smith04، الفصل. 1].

بلاه بلاه [@doe99، الصفحات 33-35، 38-39 و *باسيم*].

بلاه بلاه [@ سميث04؛ @doe99].

يكتشف pandoc-citeproc مصطلحات محدد المواقع في ملفات لغة CSL. إما مختصرة أو
يتم قبول النماذج غير المختصرة. في لغة en-US، يمكن كتابة مصطلحات محدد المواقع
إما بصيغة المفرد أو الجمع، مثل book، bk./bks.; الفصل، الفصل./الفصول. عمود،
العقيد./الأعمدة.; الشكل، الشكل./التين. فوليو، فول./فولس.؛ رقم، رقم/رقم؛ الخط، ل./ل.؛ ملحوظة،
ن./ن.; التأليف، مرجع سابق/مقابل؛ الصفحة، ص/ص. الفقرة، الفقرة./الفقرات. جزء، نقطة/نقاط. قسم،
ثانية./ثانية.; الفعل الفرعي، SV/S.VV.؛ الآية، v./vv.؛ المجلد، المجلد./المجلدات. ¶/¶¶; §/§§. إذا لا
يتم استخدام مصطلح محدد المواقع، ويفترض "الصفحة".

علامة الطرح (-) قبل @ ستمنع ذكر المؤلف في الاقتباس. هذا
يمكن أن يكون مفيدًا عندما يكون المؤلف مذكورًا بالفعل في النص:

يقول سميث بلاه [-@smith04].

يمكنك أيضًا كتابة اقتباس في النص، على النحو التالي:

@smith04 يقول بلاه.

@ سميث04 [ص. 33] يقول بلاه.

إذا كان النمط يستدعي قائمة الأعمال المستشهد بها، فسيتم وضعها في نهاية الملف
وثيقة. عادةً، ستحتاج إلى إنهاء المستند برأس مناسب:

الفقرة الأخيرة...

# مراجع

سيتم إدراج قائمة المراجع بعد هذا الرأس. لاحظ أن الطبقة غير المرقمة سوف
تضاف إلى هذا الرأس، بحيث لا يتم ترقيم القسم.

إذا كنت تريد تضمين عناصر في قائمة المراجع دون الاستشهاد بها فعليًا في النص
نصًا، يمكنك تحديد حقل بيانات تعريف وهمية ووضع الاستشهادات هناك:

---
نوسيت: |
@ البند 1، @ العنصر 2


@ البند3

في هذا المثال، ستحتوي الوثيقة على اقتباس للبند 3 فقط، ولكن قائمة المراجع
سيحتوي على إدخالات للبند 1، والبند 2، والبند 3.

بالنسبة لمخرجات LaTeX أو PDF، يمكنك أيضًا استخدام natbib أو biblatex لعرض المراجع. في
للقيام بذلك، حدد ملفات المراجع كما هو موضح أعلاه، وأضف --natbib أو
--biblatex وسيطة لاستدعاء باندوك. ضع في اعتبارك أن ملفات الببليوغرافيا يجب أن تكون كذلك
بالتنسيق المعني (إما BibTeX أو BibLaTeX).

لمزيد من المعلومات، راجع صفحة الدليل pandoc-citeproc.

غير باندوك اضافات المتصفح
لا يتم تمكين ملحقات بناء جملة Markdown التالية افتراضيًا في pandoc، ولكن قد تكون كذلك
تم تمكينه عن طريق إضافة +EXTENSION إلى اسم التنسيق، حيث يكون EXTENSION هو اسم الملف
امتداد. وبالتالي، على سبيل المثال، markdown+hard_line_breaks هو Markdown بخط متشدد
فرامل.

التمديد: lists_without_preceding_blankline
السماح بظهور القائمة مباشرة بعد الفقرة، مع عدم وجود مسافة فارغة متداخلة.

التمديد: hard_line_breaks
يؤدي إلى تفسير كافة الأسطر الجديدة داخل الفقرة على أنها فواصل أسطر ثابتة بدلاً من
المسافات.

التمديد: تجاهل_السطر_فواصل
يؤدي إلى تجاهل الأسطر الجديدة داخل الفقرة، بدلاً من معاملتها كمسافات أو
كما فواصل الخط المتشدد. هذا الخيار مخصص للاستخدام مع لغات شرق آسيا حيث
لا يتم استخدام المسافات بين الكلمات، ولكن يتم تقسيم النص إلى أسطر لتسهيل القراءة.

التمديد: east_asian_line_breaks
يؤدي إلى تجاهل الأسطر الجديدة داخل الفقرة، بدلاً من معاملتها كمسافات أو
عندما ينكسر الخط المتشدد، عندما يحدث ذلك بين شخصيتين واسعتين من شرق آسيا. هذا ال
خيار أفضل منignore_line_breaks للنصوص التي تتضمن مزيجًا من شرق آسيا
الشخصيات والشخصيات الأخرى.

التمديد: الرموز التعبيرية
يوزع الرموز التعبيرية النصية مثل:smile: كرموز Unicode.

التمديد: tex_math_single_backslash
يؤدي إلى تفسير أي شيء بين \( و \) على أنه رياضيات TeX مضمّنة، وأي شيء
بين \[ و \] سيتم تفسيره على أنه عرض رياضيات TeX. ملحوظة: ومن عيوب هذا
الامتداد هو أنه يمنع الهروب ( و [.

التمديد: tex_math_double_backslash
يؤدي إلى تفسير أي شيء بين \\( و \\) على أنه رياضيات TeX مضمّنة، وأي شيء
بين \\[ و \\] ليتم تفسيرها على أنها عرض رياضيات TeX.

التمديد: markdown_attribute
افتراضيًا، يفسر pandoc المواد الموجودة داخل علامات مستوى الكتلة على أنها Markdown. هذا
يغير الامتداد السلوك بحيث يتم تحليل Markdown فقط داخل العلامات على مستوى الكتلة إذا
العلامات لها السمة تخفيض السعر=1.

التمديد: mmd_title_block
لتمكين قالب عنوان نمط MultiMarkdown في أعلى المستند، على سبيل المثال:

العنوان : عنواني
المؤلف: جون دو
التسجيل: سبتمبر 1، 2008
تعليق: هذه عينة من قالب عنوان mmd، مع
حقل يمتد على عدة أسطر.

راجع وثائق MultiMarkdown للحصول على التفاصيل. إذا كان pandoc_title_block أو
تم تمكين yaml_metadata_block، وستكون له الأولوية على mmd_title_block.

التمديد: الاختصارات
يوزع PHP Markdown مفاتيح الاختصار الإضافية، مثل

*[HTML]: لغة ترميز النص التشعبي

لاحظ أن نموذج مستند pandoc لا يدعم الاختصارات، لذا إذا كان هذا الامتداد
تم تمكينه، يتم ببساطة تخطي مفاتيح الاختصار (بدلاً من تحليلها كـ
الفقرات).

التمديد: autolink_bare_uris
يجعل كافة عناوين URI المطلقة في روابط، حتى عندما لا تكون محاطة بأقواس مدببة <...>.

التمديد: ascii_identifiers
يجعل المعرفات التي تنتجها المعرفات التلقائية هي ASCII خالصة. لهجات هي
تم تجريده من الحروف اللاتينية المميزة، وتم حذف الحروف غير اللاتينية.

التمديد: mmd_link_attributes
يوزع سمات القيمة الرئيسية لنمط multimarkdown على مراجع الارتباط والصور. هذا
لا ينبغي الخلط بين الامتداد وامتداد link_attributes.

هذا مرجع![image][ref] ذو سمات multimarkdown.

[المرجع]: http://path.to/image عرض "عنوان الصورة" = ارتفاع 20 بكسل = 30 بكسل
معرف = فئة myId = "myClass1 myClass2"

التمديد: mmd_header_identifiers
يوزع معرفات رأس نمط multimarkdown (بين قوسين مربعين، بعد الرأس ولكن
قبل أي #s زائدة في رأس ATX).

التمديد: Compact_definition_lists
ينشط بناء جملة قائمة التعريفات لـ pandoc 1.12.x والإصدارات الأقدم. يختلف بناء الجملة هذا
من تلك الموصوفة أعلاه ضمن قوائم التعريف في عدة جوانب:

· لا يلزم وجود سطر فارغ بين العناصر المتتالية لقائمة التعريف.

· للحصول على قائمة "ضيقة" أو "مدمجة"، قم بحذف المسافة بين العناصر المتتالية؛ الفضاء
بين المصطلح وتعريفه لا يؤثر على شيء.

· غير مسموح بالالتفاف البطيء للفقرات: يجب وضع مسافة بادئة للتعريف بأكمله بأربعة مسافة بادئة
المسافات.

تخفيض السعر المتغيرات
بالإضافة إلى Markdown الموسع الخاص بـ pandoc، يتم دعم متغيرات Markdown التالية:

markdown_phpextra (بي أتش بي تخفيض السعر إضافي)
الحواشي السفلية، Pipe_tables، Raw_html، Markdown_attribute، مسيجة_code_blocks،
قوائم التعريف، intraword_underscores، header_attributes، link_attributes،
الاختصارات، Shortcut_reference_links.

markdown_github (بنكهة جيثب تخفيض السعر)
جداول الأنابيب، الخام_أتش تي أم أل، tex_math_single_backslash، سياج_كود_بلوك،
المعرفات التلقائية، ومعرفات ascii، وbacktick_code_blocks، والارتباط التلقائي_bare_uris،
intraword_underscores، Strikeout، hard_line_breaks، الرموز التعبيرية،
Shortcut_reference_links.

markdown_mmd (متعدد التخفيض)
Pipe_tables Raw_html، markdown_attribute، mmd_link_attributes، Raw_tex،
tex_math_double_backslash، intraword_underscores، mmd_title_block، الحواشي،
قوائم_التعريفات، جميع_الرموز_القابلة للتهرب،_المراجع_الضمنية_للرأس،
المعرفات التلقائية، معرفات_رأس_mmd، الروابط_المرجعية المختصرة.

markdown_strict (تخفيض السعر.pl)
Raw_html

ملحقات مع صيغ أخرى من تخفيض السعر
يمكن استخدام بعض الإضافات التي تمت مناقشتها أعلاه مع تنسيقات أخرى غير Markdown:

· يمكن استخدام المعرفات التلقائية مع إدخالات اللاتكس، وrst، وmediawiki، والمنسوجات (ويتم استخدامها
بشكل افتراضي).

· يمكن استخدام tex_math_dollars و tex_math_single_backslash و tex_math_double_backslash
مع إدخال HTML. (هذا مفيد لقراءة صفحات الويب المنسقة باستخدام MathJax، لـ
مثال.)

إنتاج انزلق عروض مع باندوك

يمكنك استخدام pandoc لإنتاج عرض تقديمي لشرائح HTML + javascript يمكن مشاهدته
عبر متصفح الويب. هناك خمس طرق للقيام بذلك، باستخدام S5، DZSlides، Slidy، Slideous،
أو تكشف.js. يمكنك أيضًا إنتاج عرض شرائح بتنسيق PDF باستخدام جهاز LaTeX.

إليك مصدر Markdown لعرض شرائح بسيط، Habits.txt:

العادات %
٪ فلان الفلاني
22 مارس 2005

# في الصباح

## الاستيقاظ

- إيقاف التنبيه
- اخرج من السرير

## إفطار

- تناول البيض
- اشرب قهوه

# عند المساء

## عشاء

- تناول السباغيتي
- يشرب النبيذ

------------------


## الذهاب إلى النوم

- اذهب للسرير
- عد الأغنام

لإنتاج عرض شرائح HTML/javascript، اكتب ببساطة

pandoc -t FORMAT -s عادات.txt -o عادات.html

حيث يكون FORMAT إما s5 أو slidy أو Slideous أو dzslides أو كاشفة.

بالنسبة إلى Slidy وSlideous وrecover.js وS5، فإن الملف الذي تم إنتاجه بواسطة pandoc مع ملحق
-s/--خيار مستقل يتضمن رابطًا إلى ملفات جافا سكريبت وملفات CSS، والتي من المفترض أن تكون
متاح في المسار النسبي s5/default (لـ S5)، وslideous (لـ Slideous)، وrecover.js
(للكشف.js)، أو على موقع Slidy على w3.org (لـ Slidy). (هذه المسارات يمكن أن تكون
تم تغييره عن طريق تعيين متغيرات slidy-url، أو Slideous-url، أوrecoverjs-url، أو s5-url؛ يرى
متغيرات الشرائح أعلاه.) بالنسبة إلى DZSlides، فإن جافا سكريبت وCSS (القصيران نسبيًا) هما
المدرجة في الملف افتراضيا.

مع جميع تنسيقات شرائح HTML، يمكن استخدام الخيار --self-contained لإنتاج شريحة واحدة
يحتوي على كافة البيانات اللازمة لعرض عرض الشرائح، بما في ذلك البيانات المرتبطة
البرامج النصية وأوراق الأنماط والصور ومقاطع الفيديو.

لإنتاج عرض شرائح PDF باستخدام جهاز العرض، اكتب

pandoc -t متعاطي المخدرات عادات.txt -o عادات.pdf

لاحظ أنه يمكن أيضًا تحويل عرض الشرائح تكشف.js إلى ملف PDF عن طريق طباعته إلى ملف
من المتصفح.

هيكلة القادم حرك إظهار
افتراضيا، حرك مستوى هو أعلى مستوى رأس في التسلسل الهرمي المتبع
مباشرة حسب المحتوى، وليس رأسًا آخر، في مكان ما في المستند. في المثال
أعلاه، تكون رؤوس المستوى 1 متبوعة دائمًا برؤوس المستوى 2، والتي تليها
المحتوى، لذا فإن 2 هو مستوى الشريحة. يمكن تجاوز هذا الإعداد الافتراضي باستخدام --slide-level
الخيار.

يتم تقسيم المستند إلى شرائح وفقًا للقواعد التالية:

· القاعدة الأفقية تبدأ دائمًا شريحة جديدة.

· يؤدي الرأس الموجود على مستوى الشريحة دائمًا إلى بدء شريحة جديدة.

· الرؤوس أقل من يقوم مستوى الشريحة في التسلسل الهرمي بإنشاء الرؤوس في غضون شريحة.

· الرؤوس فوق يقوم مستوى الشريحة في التسلسل الهرمي بإنشاء "شرائح العنوان"، والتي تحتوي فقط على
عنوان القسم والمساعدة في تقسيم عرض الشرائح إلى أقسام.

· يتم إنشاء صفحة العنوان تلقائيًا من كتلة عنوان الوثيقة، إذا كانت موجودة.
(في حالة جهاز العرض، يمكن تعطيل هذا عن طريق التعليق على بعض السطور بشكل افتراضي
نموذج.)

تم تصميم هذه القواعد لدعم العديد من أنماط عرض الشرائح المختلفة. إذا لم تفعل ذلك
إذا كنت تهتم بتنظيم شرائحك إلى أقسام وأقسام فرعية، فيمكنك فقط استخدام المستوى 1
رؤوس لجميع الشرائح. (في هذه الحالة، سيكون المستوى 1 هو مستوى الشريحة.) ولكن يمكنك ذلك
قم أيضًا بتنظيم عرض الشرائح إلى أقسام، كما في المثال أعلاه.

ملاحظة: في عروض الشرائح تكشف.js، إذا كان مستوى الشريحة هو 2، فسيكون هناك تخطيط ثنائي الأبعاد
تم إنتاجه، مع بناء رؤوس المستوى الأول أفقيًا وبناء رؤوس المستوى الثاني
عموديا. لا يوصى باستخدام تداخل أعمق لمستويات الأقسام مع
كشف.js.

تزايدي القوائم
بشكل افتراضي، يقوم هؤلاء الكتاب بإنشاء قوائم تعرض "الكل مرة واحدة". إذا كنت تريد القوائم الخاصة بك
لعرضه بشكل متزايد (عنصر واحد في كل مرة)، استخدم الخيار -i. إذا كنت تريد أ
قائمة معينة للخروج عن القائمة الافتراضية (أي لعرضها بشكل متزايد دون الحاجة إلى
-i وكل ذلك مرة واحدة مع الخيار -i)، ضعه في علامة اقتباس:

> - تناول السباغيتي
> - شرب الخمر

وبهذه الطريقة يمكن دمج القوائم التزايدية وغير التزايدية في مستند واحد.

إدراج فواصل
يمكنك إضافة "إيقاف مؤقت" داخل الشريحة من خلال تضمين فقرة تحتوي على ثلاث نقاط،
مفصولة بمسافات:

# الشريحة مع وقفة

المحتوى قبل الإيقاف المؤقت

. . .

المحتوى بعد التوقف

تسريح الشعر القادم الشرائح
يمكنك تغيير نمط شرائح HTML عن طريق إضافة ملفات CSS مخصصة إليها
$DATADIR/s5/default (لـ S5)، أو $DATADIR/slidy (لـ Slidy)، أو $DATADIR/slideous (لـ
Slideous)، حيث $DATADIR هو دليل بيانات المستخدم (انظر --data-dir أعلاه). ال
يمكن العثور على النسخ الأصلية في دليل بيانات نظام pandoc (بشكل عام
$CABALDIR/pandoc-VERSION/s5/default). سيبحث Pandoc هناك عن أي ملفات لا يبحث عنها
تجد في دليل بيانات المستخدم.

بالنسبة إلى dzslides، يتم تضمين CSS في ملف HTML نفسه، ويمكن تعديله هناك.

يمكن ضبط كافة خيارات تكوين تكشف.js من خلال المتغيرات. على سبيل المثال، يمكن للموضوعات
يمكن استخدامها عن طريق تحديد متغير الموضوع:

-موضوع V = القمر

أو يمكنك تحديد ورقة أنماط مخصصة باستخدام خيار --css.

لتصميم شرائح العرض، يمكنك تحديد سمة، وسمة ملونة، وسمة خط، وسمة داخلية، و
المظهر الخارجي، باستخدام الخيار -V:

pandoc -t beamer عادات.txt -V theme:وارسو -o عادات.pdf

لاحظ أن سمات الرأس ستتحول إلى سمات شريحة (على ملف أو ) في
تنسيقات شرائح HTML، مما يسمح لك بتصميم الشرائح الفردية. في متعاطي المخدرات، الرأس الوحيد
السمة التي تؤثر على الشرائح هي فئةallowframebreaks، التي تحدد
خيارallowframebreaks، مما يؤدي إلى إنشاء شرائح متعددة في حالة امتلاء المحتوى بشكل زائد
الاطار. يوصى بهذا خاصة بالنسبة للببليوجرافيات:

# المراجع {.allowframebreaks}

مكبرات الصوت ملاحظات
يتمتع Detect.js بدعم جيد لملاحظات المتحدث. يمكنك إضافة ملاحظات إلى مستند Markdown الخاص بك
على النحو التالي:


هذه هي ملاحظتي.

- يمكن أن تحتوي على تخفيض السعر
- مثل هذه القائمة

</div>

لإظهار نافذة الملاحظات، اضغط على s أثناء مشاهدة العرض التقديمي. الملاحظات ليست بعد
مدعوم لتنسيقات الشرائح الأخرى، لكن الملاحظات لن تظهر على الشرائح نفسها.

هيكل سمات in متعاطي المخدرات
في بعض الأحيان يكون من الضروري إضافة خيار LaTeX [الهش] إلى إطار في جهاز العرض (لـ
على سبيل المثال، عند استخدام البيئة المسكوكة). يمكن فرض ذلك عن طريق إضافة الهش
فئة إلى رأس تقديم الشريحة:

# شريحة هشة {.هشة}

يجوز لجميع سمات الإطار الأخرى الموضحة في القسم 8.1 من دليل مستخدم Beamer
يمكن استخدامها أيضًا:allowdisplaybreaks،allowframebreaks، b، c، t، بيئة، تسمية، عادي،
إنكمش.

CREATING يبوبس مع باندوك

EPUB البيانات الوصفية
يمكن تحديد بيانات EPUB التعريفية باستخدام خيار --epub-metadata، ولكن إذا كان المصدر
المستند هو Markdown، فمن الأفضل استخدام كتلة البيانات التعريفية YAML. هنا مثال:

---
العنوان:
- النوع : رئيسي
النص: كتابي
- النوع: عنوان فرعي
النص: تحقيق في البيانات الوصفية
المنشئ:
- الدور: المؤلف
النص: جون سميث
- الدور: محرر
النص: سارة جونز
المعرف:
- المخطط: DOI
النص: دوى:10.234234.234/33
الناشر: مطبعتي
الحقوق: © 2007 جون سميث، CC BY-NC


يتم التعرف على الحقول التالية:

معرف
إما قيمة سلسلة أو كائن يحتوي على حقول نص ومخطط. القيم الصالحة ل
المخطط هو ISBN-10، GTIN-13، UPC، ISMN-10، DOI، LCCN، GTIN-14، ISBN-13،
رقم الإيداع القانوني، URN، OCLC، ISMN-13، ISBN-A، JP، OLCC.

الاسم إما قيمة سلسلة، أو كائن به حقول ملف باسم ونوع، أو قائمة من هذا القبيل
أشياء. القيم الصالحة للنوع هي الرئيسية، العنوان الفرعي، القصير، المجموعة، الطبعة،
وسعوا.

الخالق
إما قيمة سلسلة، أو كائن له دور الحقول، وملف باسم، ونص، أو قائمة
من مثل هذه الكائنات. القيم الصالحة للدور هي علاقات مارك، لكن pandoc سيحاول
لترجمة الإصدارات التي يمكن قراءتها بواسطة الإنسان (مثل "المؤلف" و"المحرر") إلى ملف
علاقات مارك المناسبة.

مساهم
نفس التنسيق كمنشئ.

تاريخ قيمة سلسلة بتنسيق YYYY-MM-DD. (السنة فقط ضرورية.) سوف يفعلها باندوك
حاول تحويل تنسيقات التاريخ الشائعة الأخرى.

طويل (أو إرث: لغة)
قيمة سلسلة بتنسيق BCP 47. سوف يقوم Pandoc بالإعداد الافتراضي للغة المحلية إذا
لم يتم تحديد أي شيء.

موضوع
قيمة سلسلة أو قائمة بهذه القيم.

وصف
قيمة سلسلة.

نوع قيمة سلسلة.

شكل قيمة سلسلة.

علاقة
قيمة سلسلة.

تغطية
قيمة سلسلة.

حقوق قيمة سلسلة.

صورة الغلاف
قيمة سلسلة (المسار إلى صورة الغلاف).

أنماط
قيمة سلسلة (المسار إلى ورقة أنماط CSS).

اتجاه تقدم الصفحة
إما لتر أو رتل. يحدد سمة اتجاه تقدم الصفحة لـ
عنصر العمود الفقري

مرتبط وسائل الإعلام
افتراضيًا، سيقوم pandoc بتنزيل الوسائط المرتبطة (بما في ذلك الصوت والفيديو) وتضمينها
في حاوية EPUB، مما ينتج عنه ملف EPUB مستقل تمامًا. إذا كنت تريد الارتباط به
بدلاً من ذلك، استخدم موارد الوسائط الخارجية، استخدم HTML الخام في المصدر وأضف data-external="1" إلى
العلامة مع سمة src. على سبيل المثال:


<المصدر سرك = "/http://example.com/music/toccata.mp3"
البيانات الخارجية = "1" نوع = "الصوت/mpeg">

مثقف. متعلم هاسكل الدعم

إذا قمت بإلحاق +lhs (أو +literate_haskell) بتنسيق الإدخال أو الإخراج المناسب
(markdown أو markdown_strict أو rst أو latex للإدخال أو الإخراج؛ أو beamer أو html أو html5 لـ
الإخراج فقط)، سيعامل pandoc المستند كمصدر هاسكل المتعلم. هذا يعني ذاك

· في إدخال تخفيض السعر، سيتم تحليل أقسام "مسار الطيور" كرمز هاسكل بدلاً من ذلك
كتلة الاقتباسات. سيتم أيضًا التعامل مع النص الموجود بين \begin{code} و\end{code} على أنه
كود هاسكل. بالنسبة للرؤوس ذات نمط ATX، سيتم استخدام الحرف "=" بدلاً من "#".

· في تخفيض السعر الناتج، سيتم عرض كتل التعليمات البرمجية مع فئات هاسكل ومحو الأمية باستخدام
سيتم وضع مسافة بادئة لمسارات الطيور والاقتباسات الجماعية بمسافة واحدة، لذا لن تكون كذلك
يتم التعامل معها كرمز هاسكل. بالإضافة إلى ذلك، سيتم عرض الرؤوس بنمط النص (مع
تسطير) بدلاً من نمط ATX (بأحرف "#"). (وهذا لأن ghc يعامل
الأحرف "#" في العمود 1 كأرقام أسطر مقدمة.)

· في إدخال النص المعاد هيكلته، سيتم تحليل أقسام "مسار الطيور" كرمز هاسكل.

· في إعادة هيكلة إخراج النص، سيتم عرض كتل التعليمات البرمجية ذات فئة haskell باستخدام الطيور
المسارات.

· في إدخال LaTeX، سيتم تحليل النص الموجود في بيئات التعليمات البرمجية كرمز Haskell.

· في مخرجات LaTeX، سيتم عرض كتل التعليمات البرمجية ذات فئة haskell داخل التعليمات البرمجية
البيئات.

· في إخراج HTML، سيتم عرض كتل التعليمات البرمجية ذات فئة هاسكل مع فئة
مسارات هاسكل والطيور.

أمثلة:

باندوك -f تخفيض السعر+lhs -t html

يقرأ مصدر Haskell المنسق باصطلاحات Markdown ويكتب HTML العادي
(بدون آثار الطيور).

باندوك -f تخفيض السعر+lhs -t html+lhs

يكتب HTML مع كود هاسكل في مسارات الطيور، بحيث يمكن نسخه ولصقه كـ
مصدر هاسكل المتعلم.

بناء الجملة تسليط الضوء

سيقوم Pandoc تلقائيًا بتمييز بناء الجملة في كتل التعليمات البرمجية المسيجة التي تم تمييزها بـ
اسم اللغة. يتم استخدام مكتبة Haskell Highlighting-Kate لتسليط الضوء على ما
يعمل في إخراج HTML وDocx وLaTeX/PDF. يمكن اختيار نظام الألوان باستخدام
- خيار تسليط الضوء على النمط. نظام الألوان الافتراضي هو pygments، الذي يقلد
نظام الألوان الافتراضي الذي تستخدمه أصباغ مكتبة بايثون، ولكن الأصباغ ليست كذلك في الواقع
تستخدم للقيام تسليط الضوء.

لرؤية قائمة بأسماء اللغات التي سيتعرف عليها pandoc، اكتب pandoc --version.

لتعطيل التمييز، استخدم خيار --no-highlight.

CUSTOM الكتاب

يمكن تمديد Pandoc بكتابة مخصصة مكتوبة بلغة Lua. (يتضمن Pandoc لوا
مترجم، لذا لا يلزم تثبيت lua بشكل منفصل.)

لاستخدام كاتب مخصص، ما عليك سوى تحديد المسار إلى برنامج Lua النصي بدلاً من الإخراج
شكل. على سبيل المثال:

باندوك -t data/sample.lua

يتطلب إنشاء كاتب مخصص كتابة دالة lua لكل عنصر ممكن في ملف
وثيقة باندوك. للحصول على مثال موثق يمكنك تعديله وفقًا لمتطلباتك
الاحتياجات، القيام به

pandoc --print-default-data-file Sample.lua

مؤلفون

© 2006-2015 جون ماكفارلين (jgm@berkeley.edu). تم إصداره بموجب GPL، الإصدار 2 أو
أكبر. هذا البرنامج لا يحمل أي ضمان من أي نوع. (انظر حقوق الطبع والنشر الكاملة
إشعارات حقوق النشر والضمان.)

ومن بين المساهمين آرون وولين، وألبرت كروينكل، وألكسندر كوندراتسكي، وألكسندر
سولفريان، ألكسندر فيرشيلوف، ألفريد فيشلبرجر، أندرياس لوف، أندرو دانينغ،
أنطوان لاتر، أراتا ميزوكي، أرلو أوكيف، أرتيوم كازاك، بن جماري، بيني
تشيرنيافسكي باسكين، بيورن بوكوالتر، برادلي كون، برنت يورجي، بريان أوسوليفان، بي.
سكوت ميشيل، كاليب مكدانيل، كالفين بيك، كريستوفر أكيلمان، كريستوفر ساويكي،
كلير ماكري، كلينت آدامز، كونال إليوت، كريغ إس. بوسما، دانييل بيرجي، دانييل تي.
ستال، ديفيد لازار، ديفيد روثليسبيرجر، دينيس لاكسالدي، دوغلاس كالفرت، دوغلاس إف.
كالفيرت، إريك كاو، إريك سيدل، فلوريان إيتل، فرانسوا جاناز، فريريك بارال، فيودور
شيريميتيف، غابور بالي، جافين بيتي، جريج ماسلوف، جريجوري باتاي، جريج راندليت،
جويرن، جويرن برانوين، هانز بيتر ديفل، هنري دي فالينس، إيليا في بورتنوف، infinity0x،
خايمي ماركينيز فيرانديز، جيمس أسبنيس، جيمي إف أولسون، جان لاريس، جيسون رونالو، جيف
أرنولد، جيف رونينجن، جينس بيترسن، جيريمي بوبيو، جيسي روزنتال، جي لويس موير، جو
هيلينبراند، جون ماكفارلين، جوناس سميديجارد، جوناثان دوجيرتي، جوزيف سفينينجسون،
خوسيه لويس دوران، جوليان كريتيل، جاستن بوجنر، كيلسي هايتاور، كونستانتين زودوف،
لارس دومينيك براون، لوك بلانت، مارك سزيبينيك، مارك رايت، ماسايوشي تاكاهاشي، ماتيج
كولار، ماتياس شينر، ماثيو بيكرينغ، ماتياس سي إم تروفايس، ماورو بيج، ماكس
بولينغبروك، ماكس ريدال أندرسن، ميرين فيرستراتن، مايكل سنويمان، مايكل طومسون،
مين آر كيه، ناثان جاس، نيل مايهيو، نيك بارت، نيكولاس كايزر، نيكولاي ياكيموف، نكالفي، باولو
تانيموتو، بول ريفيير، بيتر وانج، فيليب أومبريدان، فيليب ألداي، بونيث تشاجانتي،
قروب، رالف ستيفان، ريكاي أوكتاش، رودجا تراب، ريان جلسكوت، سكوت موريسون، سيرجي
تروفيموفيتش، سيرجي أستانين، شهباز يوسفي، شون أتفيلد، shreevatsa.public، سيمون
هينجل، سوميت صحروات، تاكاهاشم، ثسوتون، تيم لين، تيموثي همفريز، تود سيفليت،
توم ليز، أولي كولر، فاتسلاف زيمان، فيكتور كرونفال، فنسنت، ويكي وايد، وكزافييه أوليف.

يمكن تنزيل كود مصدر Pandoc وجميع الوثائق منhttp://pandoc.org>.

استخدم pandoc عبر الإنترنت باستخدام خدمات onworks.net