Kramdown tez, sof Ruby Markdown-superset konvertori

Inline atributlar roʻyxati

Bu elementlar atributlarni boshqa elementga biriktirish uchun ishlatiladi.

Inline atributlar roʻyxatini bloklash

Bu sintaksis xususiyati asl Markdown sintaksisining bir qismi emas. Fikr va sintaksis Maruku paketidan keladi.


Ushbu blok darajasidagi element atributlarni boshqa blok darajasidagi elementga biriktirish uchun ishlatiladi. Blok ichidagi atributlar ro'yxati (IAL bloki) ALD bilan bir xil tuzilishga ega, bundan tashqari ikkita nuqta/mos yozuvlar nomi/ko'p nuqta qismi ikki nuqta bilan almashtiriladi. IAL bloki (yoki ikki yoki undan ortiq blok IAL) atributlar biriktirilishi kerak bo'lgan blok darajasidagi elementdan oldin yoki keyin to'g'ridan-to'g'ri qo'yilishi kerak. Agar IAL bloki to'g'ridan-to'g'ri blok darajasidagi elementdan keyin va undan oldin bo'lsa, u oldingi elementga qo'llaniladi. Boshqa barcha holatlarda, masalan, IAL bloki bo'sh chiziqlar bilan o'ralganida, IAL bloki e'tiborga olinmaydi.


IAL kalit-qiymat juftliklari havola qilingan ALDlarda teng nomdagi kalit-qiymat juftliklaridan ustun turadi.

IAL bloklari uchun ba'zi misollar:

A simple paragraph with an ID attribute. {: #para-one}

> A blockquote with a title {:title="The blockquote title"} {: #myid}

{:.ruby}
Some code here

Inline atributlar roʻyxatini kengaytiring

Bu sintaksis xususiyati asl Markdown sintaksisining bir qismi emas. Fikr va sintaksis Maruku paketidan keladi.

https://kramdown.gettalong.org/syntax.html 28/30
07.05.2023, 19:53 Sintaksis | Kramdown
Bu span-darajali elementlar uchun blok satr atributlari ro'yxatining versiyasidir . U IAL bloki bilan bir xil tuzilishga ega, bundan tashqari, oldingi va keyingi bo'shliqlarga ruxsat berilmaydi. IAL oralig'i (yoki ikki yoki undan ortiq oraliq IAL) to'g'ridan-to'g'ri qo'llanilishi kerak bo'lgan oraliq darajasidagi elementdan keyin qo'yilishi kerak, ular orasida qo'shimcha belgilarga ruxsat berilmaydi, aks holda u e'tiborga olinmaydi va faqat chiqishdan olib tashlanadi.

Bu erda span IAL uchun ba'zi misollar:

This *is*{:.underline} some `code`{:#id}{:.class}.
A [link](test.html){:rel='something'} and some **tools**{:.tools}.

IAL maxsus oraliqda {::}atributlar mavjud emas, lekin ogohlantirish ham yaratmaydi. U ajratilmasa, noto'g'ri tahlil qilinadigan ketma-ket elementlarni ajratish uchun ishlatilishi mumkin. Bu erda foydalanish holati:

This *is italic*{::}*marked*{:.special} text

Kengaytmalar

Bu sintaksis xususiyati asl Markdown sintaksisining bir qismi emas.

Kengaytmalar qo'shimcha funktsiyalarni ta'minlaydi, lekin u uchun bir xil sintaksisdan foydalanadi. Ular blok va span-darajali elementlar sifatida mavjud.


Kengaytma sintaksisi ALD sintaksisiga juda o'xshaydi . Bu erda kengaytmalarni qanday belgilashga oid ba'zi misollar va keyin sintaksis ta'rifi:

{::comment}
This text is completely ignored by kramdown - a comment in the text. {:/comment}

Do you see {::comment}this text{:/comment}? {::comment}some other comment{:/}

{::options key="val" /}

Kengaytma korpusli yoki korpussiz belgilanishi mumkin. Shuning uchun kengaytmalar uchun boshlang'ich va tugatish yorlig'i mavjud. Boshlanish tegi quyidagi tuzilishga ega:


chap qavs,
keyin ikkita nuqta va kengaytma nomi,
ixtiyoriy ravishda keyin boʻsh joy va atribut taʼriflari (ruxsat berilgan belgilar teskari chiziqli yopilish qavslari yoki tashqariga chiqilmagan yopilish qavslaridan tashqari har qanday belgi – ALD bilan bir xil),
keyin qiyshiq chiziq va o'ng qavs (agar kengaytmaning tanasi bo'lmasa) yoki faqat o'ng qavs (agar kengaytma tanasi bo'lsa) qo'yiladi.


To'xtash yorlig'i quyidagi tuzilishga ega:

chap qavs,
keyin ikki nuqta va qiyshiq chiziq, ixtiyoriy ravishda keyin kengaytma nomi, keyin o'ng qavs.


To'xtash yorlig'i faqat kengaytmaning tanasi bo'lsa kerak!

Yuqoridagi sintaksis span-darajali kengaytmalar uchun bo'lgani kabi ishlatilishi mumkin. Blok darajasidagi kengaytmalar uchun boshlang'ich va tugatish qatorlari quyidagicha aniqlanadi:

https://kramdown.gettalong.org/syntax.html 29/30
07.05.2023, 19:53 Sintaksis | Kramdown
Boshlang'ich satr kengaytma boshlang'ich tegidan iborat bo'lib, ixtiyoriy ravishda oldin uchta bo'sh joy va undan keyin qator oxirigacha ixtiyoriy bo'shliqlar qo'yiladi.
Tugash qatori kengaytma toʻxtash yorligʻidan iborat boʻlib, ixtiyoriy ravishda oldin uchta boʻshliq va undan keyin qator oxirigacha ixtiyoriy boʻshliqlar qoʻyiladi.


Agar kengaytmaning boshlang'ich yorlig'i uchun yakuniy teg topilmasa, boshlang'ich yorlig'i tanasi yo'q deb hisoblanadi. Agar noto'g'ri kengaytmani to'xtatish yorlig'i topilsa, u e'tiborga olinmaydi. Agar kengaytma nomi noto'g'ri ko'rsatilgan bo'lsa, kengaytma (va oxir-oqibat belgilangan tana) e'tiborga olinmaydi.


Kramdown bilan quyidagi kengaytmalardan foydalanish mumkin:

comment

Asosiy matnni chiqishda ko'rinmaydigan izoh sifatida ko'ring.

nomarkdown

Tanani kramdown bilan qayta ishlamang, balki uni bo'lgani kabi chiqaring. Atribut typeqaysi konvertorlar tanani chiqarishi kerakligini belgilaydi: agar atribut yo'q bo'lsa, barcha konvertorlar uni chiqarishi kerak. Aks holda, atribut qiymati konvertor nomlarining bo'sh joydan ajratilgan ro'yxati bo'lishi kerak va bu konvertorlar tanani chiqarishi kerak.

options

Tanasiz foydalanish kerak, chunki tana e'tiborga olinmaydi. Kramdown protsessorining global parametrlarini o'rnatish uchun ishlatiladi (masalan, avtomatik sarlavha identifikatorini yaratishni o'chirish uchun). E'tibor bering, tahlil qiluvchi tomonidan ishlatiladigan variantlar darhol samarali bo'ladi, qolgan barcha variantlar esa bunday emas! Bu, masalan, konvertor opsiyalarini faqat kramdown hujjatining ba'zi bir qismi uchun o'rnatish mumkin emasligini anglatadi.
Mualliflik huquqi © 2009-2019 Tomas Leitner | Yuridik ogohlantirish | Maxfiylik siyosati Webgen tomonidan yaratilgan

https://kramdown.gettalong.org/syntax.html 30/30