Ինչպես սկսել GitBook-ով. Ինչպես ավելացնել բովանդակության բլոկներ

Սկսեք բովանդակություն ավելացնել ձեր GitBook փաստաթղթերին՝ օգտագործելով աղյուսակներ, պատկերներ և այլն:

GitBook-ը հարթակ է, որը թույլ է տալիս ձեզ և ձեր թիմին ստեղծել և համագործակցել փաստաթղթերի կայքերում: GitBook-ը դա անում է՝ օգտագործելով տարբերակների վերահսկման հասկացությունները, ինչպիսիք են ճյուղավորումը և միաձուլումը:

Քանի որ թիմի շատ անդամներ կարող են աշխատել մեկ փաստաթղթերի կայքում, GitBook-ը թույլ է տալիս ստեղծել և կառավարել առանձին նախագծեր: Կարող եք նաև դիտել ձեր ընթացիկ նախագծի և հիմնական փաստաթղթերի պատճենի միջև եղած տարբերությունները:

Ձեր վիքի էջերին ավելացնելու համար հասանելի են մի քանի տեսակի արգելափակումներ: Սա ներառում է վերնագրեր, պարբերություններ, պատկերներ, հուշումներ, աղյուսակներ, կոդերի բլոկներ, ֆայլերի հավելվածներ և այլն:

Ինչպես ավելացնել բովանդակության բլոկներ GitBook-ում

Դուք կարող եք դիտել էջին ավելացնելու համար հասանելի բովանդակության բլոկների ցանկը: Դուք կարող եք դա անել՝ սեղմելով էջի ցանկացած կետ և սեղմելով հայտնվող գումարած խորհրդանիշի վրա: Կարող եք նաև ուղղակիորեն որոնել կոնկրետ բովանդակության բլոկ:

Դուք կարող եք բովանդակություն ավելացնել Markdown-ի միջոցով: Եթե նախկինում չեք օգտագործել Markdown-ը, կարող եք ավելին իմանալ այն մասին, թե ինչպես սկսել Markdown-ով: Կարող եք նաև ավելին կարդալ այն մասին, թե ինչու է Markdown-ն այդքան հայտնի:

Ինչպես ավելացնել պարբերություններ, ցուցակներ, մեջբերումներ կամ կոդի բլոկներ

Ցուցակներ, պարբերություններ, մեջբերումներ, կոդերի բլոկներ կամ այլ պարզ բովանդակության բլոկներ ավելացնելու համար բացեք բացվող ցանկը և ընտրեք առկա տեսակներից:

1. Փաստաթղթերի ձեր կայքի էջի վրա սեղմեք գումարած կոճակը այն վայրում, որտեղ ցանկանում եք ավելացնել ձեր բովանդակությունը:

   

2. Բացվող ցանկից կարող եք ոլորել ցանկի միջով՝ բովանդակության տարբեր տարբերակները դիտելու համար:

   

3. Այստեղից ընտրեք ցանկացած պարզ բովանդակության տեսակ, օրինակ՝ պարբերություն, կոդի բլոկ, վերնագիր կամ մեջբերում: GitBook-ը ավտոմատ կերպով կփոխի բովանդակությունը՝ ձեր ընտրած ձևաչափին համապատասխանելու համար:

   

Ինչպես ավելացնել պատկերներ կամ ֆայլի հավելվածներ

Պատկերներ ավելացնելու համար օգտագործեք բացվող ցանկը՝ ընտրելով Պատկերներ բովանդակության արգելափակման տարբերակը: Ֆայլեր ավելացնելու համար ընտրեք Տեղադրեք ֆայլեր տարբերակը: Այնուհետև կարող եք օգտագործել աջակողմյան վահանակը՝ ձեր վերբեռնված պատկերներն ու ֆայլերը կառավարելու համար:

1. Բացեք էջ ձեր փաստաթղթերի կայքում: Կտտացրեք գումարած կոճակին՝ հասանելի բովանդակության բլոկների համար բացվող ցանկը բացելու համար:

2. Ընտրեք Տեղադրել պատկերներ:

   

3. Աջակողմյան վահանակում, որը երևում է, կան երեք ներդիր: Ֆայլեր ներդիրը թույլ է տալիս վերբեռնել ձեր սեփական պատկերի ֆայլը: URL ներդիրը թույլ է տալիս առցանց հղում կատարել պատկերին: Կարող եք նաև բացել Unsplash ներդիրը: Այստեղ դուք կարող եք ընտրել գոյություն ունեցող լուսանկարներ, որոնք վերագրում չեն պահանջում:

   

4. Պատկեր ավելացնելուց հետո սեղմեք երեք կետկոճակը, որը գտնվում է պատկերի վերևի ձախ անկյունում: Սա կբացի բացվող պատուհան, որտեղ կարող եք հավասարեցնել պատկերը կամ ջնջել այն: Կարող եք նաև նկարին մակագրություն տալ։

   

5. Ֆայլեր տեղադրելու համար դրեք ձեր կուրսորը ձեր փաստաթղթերի կայքի ցանկացած էջի վրա: Սեղմեք գումարած կոճակը՝ բովանդակության բլոկի տեսակների բացվող ցանկը բացելու համար: Այս անգամ սեղմեք ներդիր ֆայլերտարբերակի վրա:

   

6. Նմանատիպ աջակողմյան վահանակ կհայտնվի, որը թույլ է տալիս վերբեռնել ցանկացած ֆայլի հավելված՝ պատկերի փոխարեն: Սեղմեք Փնտրել ֆայլերը՝ ձեր համակարգչում տեղային պահվող ֆայլը ընտրելու համար:

   

7. Ֆայլը կհայտնվի ցանկում: Սեղմեք ֆայլի վրա, և GitBook-ը ձեր բացված էջում կստեղծի բովանդակության բլոկ՝ ֆայլի հավելվածով: Սեղմելով այս բովանդակության բլոկի վրա, կներբեռնվի ֆայլի հավելվածը:

   

Ինչպես ավելացնել հուշումներ

Կարող եք նաև հուշումներ ավելացնել ձեր էջին: Դուք կարող եք փոխել ակնարկների պատկերակը՝ կարմիրը վտանգի համար, նարնջագույնը՝ նախազգուշացման, կապույտը՝ տեղեկատվության և կանաչը՝ հաջողության համար:

1. Հուշում ավելացնելու համար սեղմեք գումարած կոճակը՝ հասանելի բովանդակության բլոկների համար բացվող ցանկը բացելու համար:

2. Ընտրեք Հուշում:

   

3. Սա հուշում կավելացնի ձեր էջին: Լռելյայնորեն, հուշման տեսակը «տեղեկատվություն» է և պարունակում է կապույտ պատկերակ:

   

4. Դուք կարող եք փոխել հուշման տեսակը՝ սեղմելով պատկերակի վրա: Սա կանցնի չորս տարբեր ակնարկների տեսակների միջոցով:

   

Ինչպես ավելացնել աղյուսակներ

Դուք կարող եք աղյուսակներ ավելացնել՝ բացվող ցանկից ընտրելով աղյուսակ տարբերակը: Էջում ունենալով աղյուսակը, կարող եք ավելացնել նոր տողեր կամ սյունակներ: Կարող եք նաև փոփոխել սյունակների անուններն ու տվյալների տեսակները և փոխել տվյալները աղյուսակի ներսում:

1. Սեղմեք գումարած կոճակը՝ հասանելի բովանդակության բլոկների համար բացվող ցանկը բացելու համար:

2. Ընտրեք Աղյուսակ:

   

3. Սեղմեք աղյուսակի սյունակի վերնագրի վրա: Սա կբացի նոր փոքր ընտրացանկ, որտեղ կարող եք փոխել ընտրված սյունակի անունը: Այս ընտրացանկը նաև թույլ է տալիս ջնջել կամ թաքցնել ընտրված սյունակը: Սյունակի տվյալների որոշակի տեսակների համար կարող եք նաև հավասարեցնել բովանդակությունը սյունակի ներսում:

   

4. Լռելյայնորեն, սյունակների համար ընտրված տվյալների տեսակը «Տեքստ» է: Տվյալների տեսակը փոխելու համար սեղմեք T նշանով կոճակը: Դուք կարող եք այն փոխել թվի, վանդակի, բացվող ցանկի, ֆայլի հավելվածի, վարկանիշի կամ ավելիի:

   

5. Սեղմեք վեց կետ պատկերակը սեղանի վերևի ձախ անկյունի մոտ: Այստեղ դուք կարող եք տեղադրել նոր սյունակներ և տողեր կամ ջնջել ամբողջ աղյուսակը: Կարող եք նաև թաքցնել կամ ցուցադրել որոշակի սյունակներ, կամ փոխել աղյուսակի այլ հատկություններ:

   

Ինչպես ավելացնել էջի հղման բլոկներ

Էջի հղման բլոկները հղումներ են, որոնք զբաղեցնում են էջի ամբողջ տողը: Երբ դուք ավելացնում եք հղումը, դուք պետք է կապեք այն էջին, որը կբացվի, երբ ինչ-որ մեկը սեղմի դրա վրա:

1. Կտտացրեք գումարած կոճակին՝ հասանելի բովանդակության բլոկների համար բացվող ցանկը բացելու համար:

2. Սեղմեք Էջի հղումը:

   

3. Նոր բացվող ցանկից ընտրեք այն էջը, որին կապում եք:

   

4. Ձեր էջի հղումը կհայտնվի էջի բլոկի ներսում:

   

Օգտագործելով GitBook-ը փաստաթղթերի համար

GitBook-ը փաստաթղթավորման գործիք է, որն օգտագործում է տարբերակների վերահսկման հասկացություններ, ինչպիսիք են ճյուղավորումը և միաձուլումը: Սա թույլ է տալիս թիմի մեկից ավելի անդամներ միաժամանակ աշխատել փաստաթղթերի վրա: Այն նաև օգնում է կառավարել ցանկացած կոնֆլիկտ, որը տեղի է ունենում:

Էջին կարող եք ավելացնել բոլոր տեսակի բովանդակության բլոկներ: Ձեր բովանդակությունը վերափոխելու համար կարող եք օգտագործել վերնագրեր, պարբերություններ, ծածկագրերի բլոկներ կամ կետային կետեր: Դուք կարող եք փոխել հուշումների տեսակը, հաղորդագրությունը և ակնարկների տեսակը, ինչպես նաև հարմարեցնել աղյուսակի սյունակները:

Ֆայլեր ներդիրը թույլ է տալիս կառավարել պատկերները և ֆայլերի հավելվածները, որոնք վերբեռնում եք կայք: Էջի հղումները թույլ են տալիս ստեղծել մեծ հղումներ, որոնք օգտվողները կարող են հեշտությամբ նկատել:

Եթե դուք փաստաթղթեր եք ստեղծում Go լեզվի հետ կապված, կարող եք օգտագործել Godoc-ը: Godoc-ը թույլ է տալիս ավտոմատ կերպով փաստաթղթավորել ձեր Go կոդը: