Ինչպե՞ս աշխատել GitHub Flavored Markdown-ի հետ Linux-ում:
Markdown-ը հանրաճանաչ թեթև նշագրման լեզու է, որը թույլ է տալիս օգտատերերին գրել՝ օգտագործելով հեշտ ընթերցվող և հեշտ գրվող պարզ տեքստի ձևաչափ, որն այնուհետև կարող է փոխարկվել HTML կամ այլ ձևաչափերի: Ըստ էության, այն պարզեցնում է տեքստի կառուցվածքի և ձևաչափման գործընթացը: GitHub Flavored Markdown-ը (GFM) Markdown-ի տարբերակն է, որն օգտագործվում է GitHub-ի կողմից՝ ներառելով լրացուցիչ հնարավորություններ, որոնք օգնում են մշակողներին փաստաթղթավորել իրենց աշխատանքը:
Այս հոդվածում մենք կխորանանք, թե ինչպես աշխատել GitHub Flavored Markdown-ի հետ Linux համակարգի վրա՝ գործնական օրինակներով և դրանց արդյունքներով:
GitHub Flavored Markdown-ի հիմունքները
Սկսենք GFM-ի հիմունքներից:
Վերնագրեր − Դուք կարող եք ստեղծել վերնագիր՝ օգտագործելով «#» նիշը, որին հաջորդում է բացատ և վերնագրի տեքստը: Օգտագործված «#» նիշերի թիվը համապատասխանում է վերնագրի մակարդակին՝ 1-ից (ամենաբարձր) մինչև 6 (նվազագույն): Օրինակ −
# Header 1
## Header 2
### Header 3
Շեշտադրում − Շեշտադրման համար կարող եք տեքստը դարձնել թավ կամ շեղ: Շարահյուսությունը բավականին պարզ է −
*This text will be italic*
**This text will be bold**
Ցուցակներ − Դուք կարող եք ստեղծել դասավորված և չդասավորված ցուցակներ՝ օգտագործելով թվեր կամ համապատասխանաբար «*» նիշը −
1. First item
2. Second item
* Item
* Another item
Հղումներ - Հղում ստեղծելու համար օգտագործեք քառակուսի փակագծեր հղման տեքստի համար և փակագծեր URL-ի համար.
[GitHub](http://github.com)
Պատկերներ − Պատկեր տեղադրելու համար օգտագործեք բացականչական նշան (!), որին հաջորդում է այլընտրանքային տեքստը քառակուսի փակագծերում և պատկերի URL-ը կամ ուղին փակագծերում.
![GitHub Logo](/images/logo.png)
Կոդ − Կոդը տեղադրելու համար օգտագործեք հետադարձ նշան (`): Ներքին կոդի համար օգտագործեք մեկ հետադարձ նշան, կոդի բլոկների համար օգտագործեք երեք հետադարձ −
`This is inline code`
Սա կոդերի բլոկ է
# GitHub Flavored Markdown (GFM) Extras
While the above examples are common to all Markdown, GFM adds a few useful extras:
1. **Task Lists**: GFM introduces the concept of task lists. These are lists with checkboxes that can be ticked off.
```markdown
- [x] Completed task
- [ ] Incomplete task
Աղյուսակներ - GFM-ը թույլ է տալիս ստեղծել պարզ աղյուսակներ -
| Column 1 | Column 2 |
| -------- | -------- |
| Cell 1 | Cell 2 |
Շարահյուսության ընդգծում − GFM-ի միջոցով դուք կարող եք նշել կոդերի բլոկների լեզուն՝ շարահյուսության ընդգծումը հնարավոր դարձնելու համար: Օրինակ −
```python
def hello_world():
print("Hello, world!")
# Viewing Your Markdown Files
To view your Markdown files on a Linux system, you'll need a Markdown viewer or use an online viewer. For local viewing, you can use applications like "ReText" or "Mark Text". To install ReText, for example, you can use the command:
```bash
sudo apt install retext
Կարող եք նաև օգտագործել grip ծրագիրը՝ ձեր Markdown ֆայլերը վեբ բրաուզերում դիտելու համար: Այն կարող է տեղադրվել pip-ի միջոցով
pip install grip
Այնուհետև ֆայլը դիտելու համար անցեք ֆայլը պարունակող գրացուցակ և գործարկեք −
grip yourfile.md
Grip-ը կարտացոլի Markdown ֆայլը, և դուք կարող եք այն դիտել՝ բացելով ձեր վեբ բրաուզերը localhost:6419-ում:
Ավելին GitHub Flavored Markdown-ի մասին
Թեև մենք արդեն քննարկել ենք GFM-ի կողմից ներկայացված հիմնական հնարավորությունները և մի քանի լրացուցիչ տարրեր, եկեք խորանանք մի քանի ավելի օգտակար հատկությունների մեջ, որոնք փաստաթղթավորումն ու գրելը GitHub-ում հեշտացնում են:
URL-ների ավտոմատ կապում − GFM-ն ավտոմատ կերպով վերաբերվում է URL-ներին որպես հղումների, ինչը սովորական Markdown-ի դեպքում չէ: Այն խնայում է URL-ները []()-ով փաթաթելու ժամանակը հղում ստեղծելու համար:
http://www.github.com/
Strikethrough - GFM-ն ավելացրել է շարահյուսություն տեքստի միջոցով հարվածելու համար, որը հասանելի չէ պարզ Markdown-ում: Դրան կարելի է հասնել՝ տեքստը փաթաթելով կրկնակի տիլդներով ~~:
~~This text will be strikethrough~~
Emoji - GFM-ն աջակցում է էմոջիների համար կարճ կոդերի օգտագործումը :EMOJICODE: GitHub-ը պահպանում է էմոջիների կարճ կոդերի ամբողջական ցանկը, որն աջակցում է այստեղ:
:smile:
Ներդրված ցուցակներ − GFM-ում դուք կարող եք տեղադրել մի ցուցակը մյուսի տակ՝ ներքևված ցուցակը չորս բացատով նահանջելով:
1. Item 1
1. Sub Item 1
2. Sub Item 2
2. Item 2
Խնդիրների հղումներ և ձգման հարցումներ − GFM-ի մեկ այլ առանձնահատկությունն այն է, որ կարող է հղում կատարել խնդիրներին կամ ուղարկել հարցումները ուղղակիորեն օգտագործելով «#» խորհրդանիշը, որին հաջորդում է թողարկման կամ ձգման հայտի համարը:
See #123 for more details.
Օգտատիրոջ հիշատակումներ − GFM-ը թույլ է տալիս ուղղակիորեն նշել օգտվողին, ինչպես շատ սոցիալական հարթակներում, օգտագործելով «@» նշանը, որին հաջորդում է օգտվողի անունը:
Thanks for the contribution, @username!
Անջատել ավտոմատ URL-ի կապակցումը − Եթե ցանկանում եք նշել URL, առանց այն ավտոմատ կերպով վերածվելու հղման, կարող եք օգտագործել backticks −
`http://www.github.com/`
Ավելի շատ Markdown խմբագիրներ
Մենք նշել ենք «ReText» և «Mark Text»-ը որպես ձեր Markdown ֆայլերը դիտելու տարբերակներ: Այլ լավ այլընտրանքներ, որոնք պետք է դիտարկել, ներառում են −
Typora - Սա բազմակողմանի և ոճային Markdown խմբագիր է, որն աջակցում է Markdown-ի կենդանի նախադիտմանը:
-
Atom - Atom-ը տեքստային խմբագիր է, որը մշակվել է GitHub-ի կողմից: Այն աջակցում է Markdown-ին և կարող է ցուցադրել ձեր Markdown ֆայլը բաժանված էկրանով:
Visual Studio Code - VS Code-ն ունի ներկառուցված աջակցություն Markdown-ի համար: Այն ունի կենդանի նախադիտման գործառույթ, և կան նաև բազմաթիվ ընդլայնումներ, որոնք հասանելի են լրացուցիչ ֆունկցիոնալության համար:
Ghostwriter - Սա Markdown-ի առանց շեղումների խմբագիր է, որն ունի մաքուր, պարզ ինտերֆեյս:
GitHub Flavored Markdown-ի առաջադեմ առանձնահատկությունները
GitHub Flavored Markdown-ը չի սահմանափակվում միայն հիմունքներով: Այն ունի մի շարք առաջադեմ գործառույթներ, որոնք կարող են զգալիորեն բարձրացնել ձեր տեքստի որակը: Եկեք անդրադառնանք այս հատկանիշներին.
Արգելափակման մեջբերումներ − Դրանք կարող են օգտագործվել տեքստի զգալի հատվածներն ընդգծելու համար: Դուք կարող եք ստեղծել բլոկի մեջբերում՝ սկսելով տող «>» նիշով:
> This is a blockquote.
Inline HTML - Եթե Markdown-ի շարահյուսությունը այնքան էլ չի կրճատում այն ձեզ համար, GFM-ը թույլ է տալիս չմշակված HTML-ը տեղադրել ձեր փաստաթղթերում:
<strong>This is bold text</strong>
Հորիզոնական գծեր − Դուք կարող եք հորիզոնական գիծ ստեղծել՝ օգտագործելով երեք գծիկ, աստղանիշ կամ ընդգծում:
---
***
___
Փախչող կերպարներից − Markdown-ում որոշ կերպարներ ունեն հատուկ նշանակություն: Եթե ցանկանում եք ցուցադրել այս նիշերը այնպես, ինչպես կան, կարող եք փախչել նրանցից՝ «հետադարձ շեղով» կերպարից առաջ:
\*This text will not be italic\*
Ավտոմատ խարիսխներ − GFM-ն ավտոմատ կերպով ավելացնում է id ատրիբուտներ ձեր վերնագրերին, ինչը ստեղծում է խարիսխի հղումներ: Այս հատկությունը հատկապես հարմար է, երբ դուք ստեղծում եք բովանդակության աղյուսակ կամ երբ դուք պետք է ընթերցողներին ուղղորդեք ձեր փաստաթղթի որոշակի բաժին:
# Table of Contents
1. [Chapter 1](#chapter-1)
2. [Chapter 2](#chapter-2)
Ընդլայնված Markdown գործիքներ Linux-ում
Ահա ևս մի քանի առաջադեմ գործիքներ՝ Markdown-ը Linux-ում կարգավորելու համար
Pandoc - Սա փաստաթղթերի բազմակողմանի փոխարկիչ է: Այն կարող է փաստաթղթեր փոխարկել Markdown, HTML, LaTeX և շատ այլ ձևաչափերով:
sudo apt-get install pandoc
Remark-lint − Եթե ցանկանում եք ապահովել, որ ձեր Markdown ֆայլերը կհամապատասխանեն ոճի ուղեցույցին, կարող եք օգտագործել Remark-lint՝ JavaScript-ով գրված Markdown-ի միացման համար նախատեսված լինտեր:
npm install remark-lint
Marp − Marp-ը Markdown-ի շնորհանդեսների հեղինակ է՝ հեշտ օգտագործման CLI-ով:
npm install --global @marp-team/marp-cli
Եզրակացություն
Այս հոդվածում մենք անդրադարձել ենք Linux-ում GitHub Flavored Markdown-ի օգտագործման հիմունքներին՝ յուրաքանչյուր հատկանիշի օրինակներով և բացատրություններով: GFM-ը մի քանի օգտակար հավելումներ է ավելացնում ստանդարտ Markdown-ին՝ այն դարձնելով հիանալի ընտրություն ծրագրային փաստաթղթերի համար: Անկախ նրանից, թե դուք փաստաթղթավորում եք ձեր կոդը կամ գրում եք բլոգում, Markdown-ը կարող է հարմար գործիք լինել ձեր զինանոցում: