Փաստաթղթավորման և օգնության մոդուլ

Որոշ մոդուլների իրականում անհրաժեշտ չէ, որ դուք ինչ-որ բան անեք, և նրանք պարզապես անում են այն, ինչ անում են ֆոնում։ Սակայն այս մոդուլները, հավանաբար, չունեն հարմարեցվող պարամետրեր կամ ծառայում են միայն որպես կախվածություններ մյուս մոդուլների համար։

Ամենամեծ հետաքրքրություն ներկայացնող մոդուլը սովորաբար այն է, որի համար դուք կարող եք կարգավորել թույլտվություններ և պարամետրեր։ Որոշ նախագծեր հեշտ են օգտագործման համար, այսինքն՝ դրանց օգտագործումը «ինտուիտիվ» է, և ձեզ համար համեմատաբար պարզ կլինի, թե ինչ կարող եք կարգավորել և ինչ պետք է անել, որպեսզի հասնեք ուզած արդյունքին։

Եթե ցանկանում եք իմանալ բոլոր մանրամասները, որոնք անհրաժեշտ են նոր տեղադրված մոդուլի խելացի օգտագործման համար, ապա ես կարող եմ մտածել մի քանի բանի մասին, որոնք կարող են ձեզ պետք գալ, կամ վայրերի մասին, որտեղ կարելի է որոնել տեղեկատվություն։

Հաջորդ առաջարկությունները դասավորված են օգտագործման հեշտության կարգով։

Ցավոք մեզ նման սկսնակ վերջնական օգտատերերի համար Drupal-ը մշտապես զարգացող համակարգ է, և չնայած մեզ հաջողվել է ազատ օգտվել ծրագրավորողների բոլոր այդ մեծ աշխատանքից, նրանց ժամանակը սահմանափակ է, և կարելի է վստահորեն ասել, որ լավագույն ծրագրավորողները սովորաբար չեն դառնում լավագույն փաստաթղթավորման հեղինակները սկսնակների համար, ինչպիսին մենք ենք, հակառակ դեպքում հիմա այստեղ ձեզ և ինձ չէր լինի։

Խորհուրդ կտայի ձեր փորձառությունները և դժվարությունները, որոնք ունեցել եք Drupal-ի օգտագործման ուսման ընթացքում, փաստագրել և հրապարակել՝ օգնելու հազարավոր մարդկանց, որոնք մոտ ապագայում ձեր տեղում կլինեն։

Ես դա ընդունում եմ որպես վերջնական խնդիր՝ ստեղծելու այս փաստաթղթավորումը, չնայած (կամ հենց դրա պատճառով) թվացյալ անսահման տհաճությունների, հիասթափությունների և նյարդայնացումների՝ նոր փաստաթղթավորման բաժնի օգտագործման Drupal-ում, և մի փոքր ավելի քիչ՝ Drupal-ի ուսման ու օգտագործման խնդիրների վերացման համար, որոնք հնարավոր կլիներ հաղթահարել, եթե այլ սկսնակներ, ինչպես դուք և ես, նախկինում ստեղծած լինեինք բավարար ուղեցույցներ սկսնակների համար, բայց հատկապես ուրախ եմ, որ դուք, իմ ընկեր, շահույթ կունենաք դրանից։

Դուք, ինչպես և ես, պարտադիր չէ իմանաք «զարգացման» կամ ծրագրավորման մասին, որպեսզի կիսվեք այն գիտելիքներով, որոնք ձեռք եք բերել ու սովորել։

Փորձարկման և սխալման մեթոդով

Դուք կարող եք պարզապես անցնել ու սկսել օգտագործել մոդուլը կամ սկսել խաղալ դրա կարգավորումների հետ։

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

Երբևէ հասնելիս մի պահի, երբ մոդուլը պահանջում է ենթադրություններ ձեր կողմից, իսկ ձեզ հուզում է փորձել ցանկացած հասանելի տարբերակ, մի անհանգստացեք, որովհետև ձեր կայքի պահուստավորումը միշտ կօգնի վերադառնալ կայքի նախկին տարբերակին։ Քչերը հիշում են պահուստավորումը, ճիշտ չէ՞։

Ինքնաբերաբար, քանի որ ձեզ համար հնարավոր չէ ակնհայտ լինի, որ մոդուլը կամ նրա կոնկրետ տարբերակը կազդի ձեր կայքի բոլոր հատվածների վրա, դրա պատճառով խորհուրդ եմ տալիս փորձել միայն մեկ մոդուլը մեկ անգամ և անցնել ձեր կայքի յուրաքանչյուր անկյուն ու փորձարկել բոլոր հնարավոր ձևերով՝ նոր էջեր ստեղծել և փորձարկել տարբեր կարգավորումներ, նախքան անցնել հաջորդ contrib մոդուլի ավելացմանը։

Հակառակ դեպքում, եթե միանգամից մի քանի նոր մոդուլներ միացնեք և հետո բախվեք խնդիրների կամ տարօրինակ իրավիճակների, դուք չեք իմանա, թե որ նոր մոդուլն է պատճառը ձեր խնդիրներին։

Նախագծի էջի պարունակությունը

Մոդուլի նախագծի յուրաքանչյուր էջ հանդիսանում է դրա գլխավոր էջը drupal.org-ում։ Նախագծի էջը սովորաբար առաջինն եմ այցելում, երբ մտածում եմ՝ արժե՞ փորձել մոդուլը, կամ երբ բախվում եմ խնդիրների կամ հարցեր ունեմ նոր միացված մոդուլի վերաբերյալ։

Եթե ուշադիր կարդաք նախագծի էջը ամբողջությամբ, կարող եք համեմատաբար վստահ լինել, որ ունեք բոլոր կարևոր տեղեկությունները։ Օրինակ՝ երբ որոշում եք, արդյոք փորձել մոդուլը, եթե մոդուլի աշխատանքին անհրաժեշտ են այլ մոդուլներ, դրանք նշված կլինեն նախագծի էջում։

Նախագծի էջում կարող են լինել նաև այլ օգտակար հղումներ, որոնք հետաքրքիր կլինեն մոդուլի հետ կապված տարբեր հարցերի համար։

Նախագծի էջի պարունակությունը կարող է ուղղված լինել նոր Drupal օգտագործողներին կամ ավելի առաջադեմ օգտատերերի/զարգացուցիչների։

«Կարդալ փաստաթղթավորում» հղումը նախագծի էջում (եթե կա)

աջ կողմի սյունակում (որը կիջնի էջի տակ շարժական սարքերում կամ նեղ պատուհաններում) միշտ կգտնեք «Ռեսուրսներ» վերնագիր, որի տակ կարող եք գտնել կամ չգտնել «Կարդալ փաստաթղթավորում» հղումը։

Բայց ոչ բոլոր նախագծերի էջերում կա «Կարդալ փաստաթղթավորում» հղում, և այդ դեպքում հույս ունեմ, որ գտնելու եք օգտակար փաստաթղթավորման հղումներ նախագծի հիմնական պարունակության մեջ։

Երբ «Կարդալ փաստաթղթավորում» հղումը գոյություն ունի, այն կլինի այն, ինչ ծրագրավորողները համարում են առավել համապատասխան ռեսուրս, որով կարող եք սկսել լրացուցիչ տեղեկատվություն որոնելը։

Նախագծի էջի պարունակությունը սահմանվում և վերահսկվում է այդ նախագծի սկզբնական ստեղծողի կողմից և, հնարավոր է, նաև մի քանի այլ անձանց կողմից, ում նա տվել է համապատասխան իրավունքներ։

drupal.org-ի մյուս անդամները, ովքեր չունեն նախագծի էջի խմբագրելու իրավունք, սակայն հաճախ ստեղծում են drupal.org-ում այլ էջեր՝ լավ տեղեկություններով այն մոդուլի մասին, որը ցանկանում եք իմանալ։ Ցավոք, այդ էջերի հղումները հազվադեպ են նշվում նախագծի էջում։

Այդ անհղումները գտնելու մասին կխոսենք ներքևում՝ drupal.org-ում Google որոնման բաժնում ⤵

«README.txt» ֆայլը մոդուլում

«README.txt» ֆայլը պատմականորեն եղել է պաշտոնական վայր, որտեղ փաստագրվում է բոլոր կարևոր և անհրաժեշտ տեղեկությունները մոդուլի (կամ թեմայի) համար, ներառյալ մոդուլի (կամ թեմայի) նորացման վերաբերյալ ամեն ինչ։

README.txt ֆայլը գտնվում է contrib մոդուլի (կամ թեմայի) վերին մակարդակի թղթապանակում, եթե այն գոյություն ունի։

README.txt ֆայլը դիտելու համար առանց որևէ բան ներբեռնելու, անցեք հետևյալ հղումով՝

http://cgit.drupalcode.org/project/PROJECT_MACHINE_NAME.git/blob/HEAD:/README.txt

Փոխարինեք PROJECT_MACHINE_NAME բառը վերևի URL-ում կոնկրետ նախագծի կարճ «նախագծի մեքենայի անունով»։

«Մեքենայի անունը» գտնվում է ձեր բրաուզերի հասցեի գոտում, երբ գտնվում եք որևէ drupal.org նախագծի էջում, օրինակ, «PROJECT_MACHINE_NAME»-ը այս URL-ի օրինակում՝ նման URL յուրաքանչյուր նախագծի համար՝

https://www.drupal.org/project/PROJECT_MACHINE_NAME

Եթե README.txt ֆայլ չկա, ապա հավանաբար դա մոդուլ է, որը չունի հարմարեցվող պարամետրեր և պարզապես աշխատում է ֆոնում՝ անհրաժեշտ լինելու մյուս contrib մոդուլների համար։

Եթե README.txt ֆայլ չկա կամ պարզապես ցանկանում եք դիտել մնացած փաստաթղթավորումը նախագծի համար, օգտագործեք հետևյալ URL-ը (փոխարինեք «PROJECT_MACHINE_NAME»)

http://cgit.drupalcode.org/PROJECT_MACHINE_NAME/tree/?id=HEAD

Այս «drupalcode.org» էջի վերևի աջ անկյունում կարող է անհրաժեշտ լինել «անցնել» այն Drupal հիմնական տարբերակին, որը ցանկանում եք ուսումնասիրել։

Google որոնում drupal.org կայքում սահմանափակմամբ

Եթե ցանկանում եք, որ որոնումը սահմանափակվի drupal.org կայքում, ահա թե ինչ եմ ես անում։ Ես բավական հաճախ եմ այս մեթոդը օգտագործում drupal.org-ում կամ ցանկացած այլ ընտրված տիրույթում որոնման համար։

Գնացեք google.com ⎘ և գրեք՝

site:drupal.org

Ուշադրություն դարձրեք, որ կետակետի (":") և տիրույթի անվան միջև բացատ չկա։ Եվ մի օգտագործեք «www.» տիրույթի անունի սկզբում։

Ավելացրեք «բացատ» տիրույթի անվան վերջում և մուտքագրեք ձեր որոնած հիմնական բառերը, օրինակ՝ այս քննարկման համար՝ մոդուլի անունը։

Իրականում ես օգտակար եմ գտել նաև փորձել սահմանափակել Google որոնումը հատուկ «Drupal 8»-ի համար (այդպիսով խուսափելով D6, D7 ...-ի արդյունքներից)՝ ավելացնելով «Drupal 8» Google-ի որոնման տեքստային դաշտում։ Դիտարկելով մեջբերումների նշաններով, Google վերադարձնում է որոնման արդյունքներ, որոնք պարունակում են հենց այդ նախադասությունը երկու կամ ավելի բառերով («հիմնականում»։)

Եթե ցանկանում եք տեսնել կոնկրետ մոդուլի վերաբերյալ տեղեկատվությունը ամբողջ աշխարհում՝ ներառյալ drupal.org-ում և նրա սահմաններից դուրս էջերը, բաց թողեք site:drupal.org-ը։

Google որոնման էջում մեկ էջում 100 արդյունք ստանալու համար՝ ոչ թե 10, երբ գտնվեք Google որոնման ցանկացած արդյունքների էջում, սեղմեք վերին աջ անկյունում գտնվող «վաճառասարք» պատկերակին և բացվող մենյուում ընտրեք «Որոնման կարգավորումներ»։ Հաջորդ էջում՝ «Google ակնթարթային կանխատեսումներ» բաժնում, կարգավորեք «Երբեք ցույց չտալ ակնթարթային արդյունքները»։ Դրանից հետո «Արդյունքներ մեկ էջում» բաժնում սահեցրեք սլայդերը ամբողջությամբ աջ։ Ձեր որոնումները կշռվեն հավելյալ մի քանի հազարերորդ վայրկյանով։

Խստասրտորեն կարող եք մտածել օգտագործել drupal.org-ի որոնման համակարգը, որը գտնվում է drupal.org բոլոր էջերի վերևում։ Ես փորձել եմ դա մի քանի անգամ, և խորհուրդ կտայի ձեզ ինքներդ փորձել, եթե սիրում եք անիմաստ վարժություններ։

«Օգնություն» կոճակներ/հղումներ ձեր կայքի «Ընդլայնել» էջում (եթե կան)

Ձեր կայքի «Ընդլայնել» էջում, մոդուլի անունից աջ, կարող եք տեսնել նրա նկարագրության առաջին տողը, եթե ձեր բրաուզերի պատուհանը բավականին լայն է։

Եթե սեղմեք նկարագրության այս առաջին տողը, այն կբացվի և ցույց կտա մնացած նկարագրությունը, ինչպես նաև բաց կանի «Օգնություն», «Թույլտվություններ» և «Կարգավորել» կոճակները/հղումները այդ մոդուլի համար, երբ այդ հնարավորությունները հասանելի են։

Եթե անմիջապես չեք տեսնում մոդուլի նկարագրության առաջին տողը նրա անվան աջ կողմում և ցանկանում եք տեսնել, հետևեք մոդուլի կարգավորման էջի ցուցումներին։

Ցավոք, մոդուլի օգնության էջ մուտք գործելու համար կայքում, դուք պետք է ոչ միայն ներկրեք մոդուլը ձեր կայք, այլ նաև «Օգնություն» կոճակը/հղումը երևա միայն այն դեպքում, երբ մոդուլը միացված է։ Ցավոք, ոչ բոլոր contrib կամ core մոդուլներին տրված է «Օգնություն» կոճակ/հղում, և չեք իմանա դրա առկայությունը, եթե չմիացնեք մոդուլը։

Սրանք պատճառներ են, որ ես երբեք չեմ վստահել և չեմ օգտագործել «Օգնություն» կոճակները, թեև հիմա տեսնում եմ, որ դրանք հաճախ տանում են օգտակար տեղեկատվություն պարունակող էջերի։