Kramdown tez, sof Ruby Markdown-superset konvertori


Download 258.14 Kb.
bet6/11
Sana14.05.2023
Hajmi258.14 Kb.
#1461903
1   2   3   4   5   6   7   8   9   10   11
Bog'liq
Sintaksis Kramdown (1)

Jadvallar

Bu sintaksis xususiyati asl Markdown sintaksisining bir qismi emas. Sintaksis PHP Markdown Extra paketidagi sintaksisga asoslangan .

https://kramdown.gettalong.org/syntax.html 13/30
07.05.2023, 19:53 Sintaksis | Kramdown
Ba'zan oddiy jadval ma'lumotlarini to'liq HTML jadvalidan foydalanish juda ko'p bo'lgan kramdown hujjatiga qo'shishni xohlaydi. kramdown buni ASCII jadvallari uchun oddiy sintaksis bilan qo'llab-quvvatlaydi.


Jadvallar bosh chiziqli belgilar bilan yoki ularsiz yaratilishi mumkin: Agar jadvalning birinchi qatori satr boshida chiziq belgisini o'z ichiga olsa (ixtiyoriy ravishda uchta bo'shliqqa qadar bo'sh joy bo'lsa), u holda barcha bosh trubka belgilari (ya'ni, faqat bo'lgan quvur belgilari) Oldinda bo'sh joy) barcha jadval satrlarida e'tiborga olinmaydi. Aks holda, ular e'tiborga olinmaydi va jadval chizig'ini jadval hujayralariga bo'lishda hisobga olinadi.


Jadvalda ishlatilishi mumkin bo'lgan to'rt xil chiziq turi mavjud:

Jadval qatorlari jadval mazmunini belgilaydi.

Jadval qatori - bu hech bo'lmaganda bitta chiziq belgisini o'z ichiga olgan va jadval qatorining boshqa turi sifatida aniqlanmagan har qanday satr! Jadval qatori quvur belgilari bo'yicha alohida jadval kataklariga bo'linadi. Ixtiyoriy orqadagi quvur belgisi e'tiborga olinmaydi. Esda tutingki, to'g'ridan-to'g'ri chiziq belgilaridan qochish kerak, agar ular kod oralig'ida yoki HTML elementlarida bo'lsa!


Sarlavha satrlari, altbilgi satrlari va oddiy satrlarning barchasi ushbu jadval qatorlari yordamida amalga oshiriladi. Jadval kataklarida faqat bitta satr matn bo'lishi mumkin, ko'p qatorli matn qo'llab-quvvatlanmaydi. Jadval kataklarining matni oraliq darajasidagi elementlar sifatida tahlil qilinadi.

Bu erda bir nechta misol jadval qatorlari:

| First cell|Second cell|Third cell | First | Second | Third |

First | Second | | Fourth |

Ajratuvchi chiziqlar stol tanasini bir nechta tana qismlariga bo'lish uchun ishlatiladi.

Ajratuvchi chiziq - bu faqat trubalar, chiziqlar, plyuslar, ikki nuqta va bo'shliqlar/yorliqlarni o'z ichiga olgan va kamida bitta chiziq va bitta chiziq belgisini o'z ichiga olgan har qanday chiziq. Quvur va ortiqcha belgilar ustunlarni vizual ravishda ajratish uchun ishlatilishi mumkin, ammo bu kerak emas. Bir-biridan keyin bir nechta ajratuvchi qatorlar bir ajratuvchi qator sifatida ko'rib chiqiladi.


Mana bir nechta ajratuvchi chiziqlar misoli:

|----+----| +----|----+ |---------| |-
| :-----: | -|-


Hech bo'lmaganda bitta jadval qatoridan keyingi birinchi ajratuvchi qatorga maxsus ishlov beriladi, ya'ni sarlavha ajratuvchi qator sifatida . Sarlavha satrlarini oddiy jadval satrlaridan ajratish va/yoki ustunlarni tekislash uchun ishlatiladi. Sarlavhani ajratuvchi satr ustidagi barcha jadval satrlari sarlavha qatorlari hisoblanadi.

Sarlavhani ajratuvchi qator ustunlarni tekislash taʼriflarini oʻz ichiga olishi uchun maxsus formatlangan boʻlishi mumkin: Hizalama taʼrifi ixtiyoriy boʻsh joy/yorliqdan keyin ixtiyoriy ikki nuqta, bir yoki bir nechta tire, ixtiyoriy ikki nuqta va boshqa ixtiyoriy boʻshliq/tabdan iborat. Hizalanish taʼrifining ikki nuqtalari ustunning hizalanishini oʻrnatish uchun ishlatiladi: agar ikki nuqta boʻlmasa, ustun standart tekislashdan foydalanadi, agar faqat tirelardan oldin ikki nuqta boʻlsa, ustun chapga tekislanadi, agar oldin ikki nuqta boʻlsa va tirelardan keyin ustun markazga tekislanadi va tirelardan keyin faqat ikki nuqta bo'lsa, ustun o'ngga tekislanadi. Har bir tekislash ta'rifi bitta ustun uchun tekislashni, birinchi ustun uchun birinchi tekislash ta'rifini, ikkinchi ustun uchun ikkinchi tekislash ta'rifini va hokazolarni o'rnatadi.

https://kramdown.gettalong.org/syntax.html 14/30
07.05.2023, 19:53 Sintaksis | Kramdown
Mana, hizalama ta'riflari bilan sarlavha ajratuvchi qatorlar misoli:

|---+---+---|
+ :-: |:------| ---:| | :-: :- -: -
:-: | :-

Altbilgi satrlarini oddiy jadval qatorlaridan ajratish uchun pastki qismni ajratuvchi chiziq ishlatiladi. Altbilgini ajratuvchi chiziq ostidagi barcha jadval satrlari pastki satrlar deb hisoblanadi.


Altbilgini ajratish chizig'i oddiy ajratuvchi chiziqqa o'xshaydi, bundan tashqari chiziqlar teng belgilar bilan almashtiriladi. Altbilgilarni ajratish chizig'i jadvalda faqat bir marta paydo bo'lishi mumkin. Agar bitta jadvalda bir nechta pastki qismni ajratuvchi qatorlar ishlatilsa, faqat oxirgisi pastki qismni ajratuvchi qator sifatida ko'rib chiqiladi, qolganlari oddiy ajratuvchi chiziqlar sifatida ko'rib chiqiladi. Altbilgi ajratish chizig'idan keyin ishlatiladigan oddiy ajratuvchi chiziqlar e'tiborga olinmaydi.


Mana bir necha misol kolontiter ajratuvchi qatorlar:

|====+====| +====|====+ |=========| |=

Barcha holatlarda orqadagi bo'shliqlar yoki yorliqlar e'tiborga olinmaydi. Jadvalni yaratish va texnik xizmat ko'rsatishni soddalashtirish uchun sarlavha, altbilgi va oddiy ajratuvchi satrlarda jadval qatorlari kabi ustunlar soni bir xil bo'lishi shart emas; hatto |-va |=haqiqiy ajratuvchilardir.


Yuqoridagi komponentlarni hisobga olgan holda, jadval tomonidan belgilanadi

ixtiyoriy ajratuvchi chiziq,
ixtiyoriy ravishda keyin nol, bir yoki bir nechta jadval qatorlaridan keyin sarlavha ajratuvchi qator, ixtiyoriy ravishda ajratuvchi qatorlar bilan kesishgan bir yoki bir nechta jadval qatorlari,
ixtiyoriy ravishda pastki qismni ajratuvchi qator va nol, bir yoki bir nechta jadval qatorlari va ixtiyoriy keyingi ajratuvchi chiziq.


Shuningdek, e'tibor bering

jadvalning birinchi qatorida birinchi bo'sh joy bo'lmagan belgidan oldin uchta bo'sh joydan ko'p bo'sh joy bo'lmasligi kerak;
jadvalning har bir satrida hech bo'lmaganda bitta trubka belgisi bo'lishi kerak, shunda kramdown uni jadvalga tegishli chiziq sifatida tan oladi va
Jadvallar blok chegaralarida boshlanishi va tugashi kerak !


Jadval sintaksisi PHP Markdown Extra da qo'llaniladiganidan quyidagicha farq qiladi:

Kramdown jadvallarida jadval sarlavhasi bo'lishi shart emas. Kramdown jadvallari ajratuvchi chiziqlar yordamida tuzilishi mumkin. kramdown jadvallari jadvalning altbilgisini o'z ichiga olishi mumkin.
Kramdown jadvallarini blok darajasidagi boshqa elementlardan ajratish kerak.


Jadval sarlavhasi qatori, ikkita jadval tanasi va jadval altbilgisi qatori bo'lgan kramdown jadvaliga misol:

|-----------------+------------+-----------------+----------------| | Default aligned |Left aligned| Center aligned | Right aligned | |-----------------|:-----------|:---------------:|---------------:| | First body part |Second cell | Third cell | fourth cell | | Second line |foo | **strong** | baz | | Third line |quux | baz | bar | |-----------------+------------+-----------------+----------------| | Second body | | | | | 2 line | | | | |=================+============+=================+================|

https://kramdown.gettalong.org/syntax.html 15/30
07.05.2023, 19:53 Sintaksis | Kramdown
| Footer row | | | | |-----------------+------------+-----------------+----------------|

Yuqoridagi misol jadvalini ASCII jadval muharriri yordamisiz yaratish ancha vaqt talab etadi. Biroq, jadval sintaksisi moslashuvchan va yuqoridagi jadvalni quyidagicha yozish mumkin:

|---
| Default aligned | Left aligned | Center aligned | Right aligned |-|:-|:-:|-:
| First body part | Second cell | Third cell | fourth cell | Second line |foo | **strong** | baz
| Third line |quux | baz | bar |---
| Second body | 2 line
|===
| Footer row


Download 258.14 Kb.

Do'stlaringiz bilan baham:
1   2   3   4   5   6   7   8   9   10   11




Ma'lumotlar bazasi mualliflik huquqi bilan himoyalangan ©fayllar.org 2024
ma'muriyatiga murojaat qiling