Mid ka mid ah howlaha ugu muhiimsan marka la abuurayo softiweerku waa dukumiinti, nasiib daro inteenna ka mid ah oo horumarinaya shaqadan mararka qaar waxay umuuqataa mid caajis ah, laakiin cidna uma qarsoona cidna in dukumiintiyada wanaagsan ay noqon karaan barta guusha qalab kasta, tan iyo caawimaadda la siinayo dadka isticmaala si ay u fahmaan hawlgalka saxda ah ee dalabka ama macluumaadka la siinayo horumariyeyaasha kale si loo sii wanaajiyo.
Waxaa jira codsiyo aad ufiican oo noo ogolaanaya inaan ku diiwaan galino mashaariicdeena qaab fudud, qaar waxay u muuqdaan inay bixiyaan wax kabadan waxa aan runti dooneyno kuwa kalena waxay ubaahanyihiin rakibid adag, qalab si loo diiwaangeliyo mashaariicda taas oo fulineysa isla markaana ay fududahay in la isticmaalo oo la rakibo waa Docusaurus.
Waa maxay Docusaurus?
Docusaurus waa mashruuc loogu talagalay dhis, fulin, iyo joogtaynta aaladaha furan ee dukumiintiyada websaydhka, waxay u oggolaaneysaa isticmaalka luqadda Markdown Si loo qoro dukumiintiyada mar dambe loo daabici doono shabakad html ah, si la mid ah, qalabku wuxuu noo ogolaanayaa inaan kordhino oo aan qaabeyno qaabeynta boggayaga dukumiintiyada iyadoo la adeegsanayo React.
Guud ahaan, qalabkan furan ee furan ee ay soo saareen kooxda barnaamijyada Facebook wuxuu noo ogolaanayaa inaan si fudud u abuurno degello qurux badan oo iftiin leh oo aan si sax ah ugu soo bandhigi karno dukumiintiyada mashruuc kasta.
Qalabku wuxuu ku qalabeysan yahay qaab-dhismeedka saxda ah ee dukumiintiyada, mashiin raadin horumarsan, suurtagalnimada diiwaangelinta iyo dib-u-qaabeynta boggayaga dukumiintiyada waqtiga dhabta ah, is-dhexgalka tarjumaadaha iyo astaamo kale oo badan oo kaa caawin doona inaad ka walwasho wax ka yar diiwaangelinta ama halkii aad samayn lahayd habka dukumiintiga oo sahlan oo dhameystir wacan.
Isticmaalka fudud ee Docusaurus waxaa lagu arki karaa hibada soo socota ee ay u qaybiyeen horumarayaasheeda
Sidee loo rakibaa Docusaurus?
Ujeedada ugu weyn ee Docusaurus waa inay noqotaa aaladda ugu dambeysa ee lagu diiwaangelinayo codsiyada furan ee furan ee lagu martigeliyey github, sidaas darteed runtii way fududahay in la rakibo oo lagu socodsiiyo websaydhka dukumiintigaaga bartaan.
Si aad u bilowdo inaad ku raaxeysato Docusaurus ee Github, kaliya raac talaabooyinka ay tilmaameen kooxda horumarinta iyo in aan hoos ku soo qaadanno:
- Tag asalka galkaaga keydka GitHub halkaas oo aad ka abuuri doonto dukumiintiyada oo aad ku socon doonto amarrada soo socda:
yarn global add docusaurus-init
ornpm install --global docusaurus-init
docusaurus-init
Natiijada ugu dambeysa waxay noqon doontaa abuuritaanka feyl iyo qaab-dhismeedka galka sida hoos ku qoran:
Cayayaan xiisa leh oo la isku dayo!