Ինչպե՞ս աշխատել 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-ը կարող է հարմար գործիք լինել ձեր զինանոցում: