Kramdown tez, sof Ruby Markdown-superset konvertori
Download 258.14 Kb.
|
Sintaksis Kramdown (1)
- Bu sahifa navigatsiya:
- Blok chegaralari
- Strukturaviy elementlar
- Bosh chiziqlar
|
E'tibor bering , kramdown hujjatini yozish uchun dangasa sintaksisdan foydalanish tavsiya etilmaydi . Kramdown sintaksisi qatorlarni o'rash muammosi tufayli taklif qiladigan moslashuvchanlik o'qishga to'sqinlik qiladi va shuning uchun ishlatilmasligi kerak.
Tablardan foydalanish kramdown tab to'xtash joylari to'rtga ko'paytirilishini nazarda tutadi. Bu, ayniqsa, ro'yxatlarda chekinish uchun yorliqlardan foydalanganda juda muhimdir. Bundan tashqari, yorliqlar faqat satr boshida matnni cheklashda ishlatilishi mumkin va ular oldidan bo'sh joylar qo'yilmasligi kerak. Aks holda natijalar kutilmagan bo'lishi mumkin. Avtomatik va qo'lda qochish Chiqish formatiga qarab, ko'pincha maxsus davolash kerak bo'lgan belgilar mavjud. <Misol uchun, kramdown hujjatini HTML ga o'tkazishda , >va belgilarga e'tibor berish kerak &. Ushbu maxsus belgilar bilan ishlashni osonlashtirish uchun ular chiqish formatiga qarab avtomatik va to'g'ri chiqariladi. Bu, masalan, siz faqat <, >va &kramdown hujjatida foydalanishingiz mumkin va ularning HTML ob'ekt hamkasblaridan qachon foydalanish haqida o'ylamasligingizni anglatadi. Biroq, agar siz belgilardan birini ishlatadigan HTML ob'ektlari yoki HTML teglaridan foydalansangiz , natija to'g'ri bo'ladi! https://kramdown.gettalong.org/syntax.html 3/30 07.05.2023, 19:53 Sintaksis | Kramdown Kramdown matnni belgilash uchun ham ba'zi belgilardan foydalanganligi sababli, ular normal ma'noga ega bo'lishi uchun bu maxsus belgilardan qochishning yo'li bo'lishi kerak. Buni teskari chiziqdan qochish yordamida amalga oshirish mumkin. Misol uchun, siz quyidagi kabi so'zma-so'z orqa belgidan foydalanishingiz mumkin: This \`is not a code\` span! Quyida qochish mumkin bo'lgan barcha belgilar (belgilar ketma-ketligi) ro'yxati keltirilgan: \ . * _ + -= ` ()[]{}<> # ! << >> : | " ' $ backslash period asterisk underscore plus minus equal sign back tick left and right parens/brackets/braces/angle brackets hash bang left guillemet right guillemet colon pipe double quote single quote dollar sign Blok chegaralari Ba'zi blok darajasidagi elementlar hujjatlarda ko'rsatilganidek, blok chegaralari deb ataladigan joyda boshlanishi va/yoki tugashi kerak. Blok chegaralari o'ynaydigan ikkita holat mavjud: Agar blok darajasidagi element blok chegarasida boshlanishi kerak bo'lsa, uning oldidan bo'sh chiziq , EOB belgisi , blok IAL yoki birinchi element bo'lishi kerak. Agar blok darajasidagi element blok chegarasida tugashi kerak bo'lsa, undan keyin bo'sh chiziq , EOB belgisi , blok IAL yoki oxirgi element bo'lishi kerak. Strukturaviy elementlar Barcha strukturaviy elementlar blok darajasidagi elementlardir va ular tarkibni tuzish uchun ishlatiladi. Ular ba'zi matnni, masalan, oddiy paragraf, iqtibos yoki ro'yxat elementi sifatida belgilashlari mumkin. Bo'sh chiziqlar Bo'shliqlar va yorliqlar kabi bo'sh joy belgilarini o'z ichiga olgan har qanday satr kramdown tomonidan bo'sh qator hisoblanadi. Bir yoki bir nechta ketma-ket bo'sh satrlar bitta bo'sh satr sifatida ko'rib chiqiladi. Bo'sh chiziqlar blok darajasidagi elementlarni bir-biridan ajratish uchun ishlatiladi va bu holda ular semantik ma'noga ega emas. Biroq, bo'sh satrlar semantik ma'noga ega bo'lgan ba'zi holatlar mavjud: Sarlavhalarda foydalanilganda - sarlavhalar bo'limiga qarang Kod bloklarida foydalanilganda - kod bloklari bo'limiga qarang Roʻyxatlarda foydalanilganda – roʻyxatlar boʻlimiga qarang Matematik bloklarda foydalanilganda - matematik bloklar bo'limiga qarang Blok chegaralarida boshlanishi/tugashi kerak bo'lgan elementlar uchun foydalanilganda Paragraflar https://kramdown.gettalong.org/syntax.html 4/30 07.05.2023, 19:53 Sintaksis | Kramdown Paragraflar eng ko'p ishlatiladigan blok darajasidagi elementlardir. Matnning bir yoki bir nechta ketma-ket qatorlari bitta paragraf sifatida talqin qilinadi. Paragrafning birinchi qatori uchta bo'shliqqa qadar chekinishi mumkin, boshqa satrlarda esa har qanday chekinish bo'lishi mumkin, chunki paragraflar qatorni o'rashni qo'llab-quvvatlaydi . Chiziqlarni o'rash bo'limida ko'rsatilgan qoidalarga qo'shimcha ravishda, ta'riflar ro'yxati qatoriga duch kelganda, paragraf tugaydi. Bir yoki bir nechta bo'sh qatorlardan foydalanib, ikkita ketma-ket paragrafni bir-biridan ajratishingiz mumkin. E'tibor bering, manbadagi satr uzilishi chiqishdagi qator uzilishini anglatmaydi ( dangasa sintaksis tufayli )!. Agar siz aniq chiziqli tanaffusga (ya'ni Quyida sizga paragraflar qanday ko'rinishiga misol keltirilgan: This⋅para⋅line⋅starts⋅at⋅the⋅first⋅column.⋅However, ⋅⋅⋅⋅⋅⋅the⋅following⋅lines⋅can⋅be⋅indented⋅any⋅number⋅of⋅spaces/tabs. ⋅⋅⋅The⋅para⋅continues⋅here. ⋅⋅This⋅is⋅another⋅paragraph,⋅not⋅connected⋅to⋅the⋅above⋅one.⋅But⋅⋅ with⋅a⋅hard⋅line⋅break.⋅\\ And⋅another⋅one. Download 258.14 Kb. Do'stlaringiz bilan baham: 
|