Mwongozo wa Kutumia Maktaba ya Rasilimali Huria ya Whale Girl: Kuvinjari Nyenzo, Kuhakiki Kwenye Kompyuta na Kushiriki Kuijenga

Utangulizi wa mradi

Maktaba ya Rasilimali Huria ya Whale Girl ni tovuti isiyo rasmi ya rasilimali inayodumishwa kwa hiari na jamii. Inakusanya pamoja picha za marejeo za mhusika Whale Girl, vidokezo vya uundaji, miradi ya jamii, zana, nyenzo za marejeo, kazi za ubunifu wa mashabiki na picha za vichekesho. Lengo lake ni kupunguza kizingiti cha kutafuta na kushiriki rasilimali, ili waumbaji waweze kufanya ubunifu unaotokana na kazi zilizopo kwa urahisi zaidi.

Mradi huu hauwakilishi msimamo rasmi wa kampuni ya DeepSeek au DeepSeek. Whale Girl ni taswira iliyoundwa kwa pamoja na jamii na inayoendelea kubadilika. Maktaba ya rasilimali hutoa marejeo pekee, na haiweki tabia moja ya lazima au sanifu ya mhusika.

Ikiwa ungependa tu kuvinjari rasilimali, tembelea moja kwa moja tovuti ya mtandaoni ya Maktaba ya Rasilimali Huria ya Whale Girl. Ili kuelewa usuli wa mradi, unaweza kusoma Maswali Yanayoulizwa Mara kwa Mara kuhusu mradi.

Maudhui na vipengele vikuu

• Marejeo ya uundaji wa mhusika: Inajumuisha michoro ya muundo wa mhusika pamoja na vidokezo vya uundaji vinavyoweza kunakiliwa na kutumiwa moja kwa moja.
• Orodha ya rasilimali zinazohusiana: Inakusanya miradi ya jamii ya Whale Girl, zana za uundaji na nyenzo za marejeo.
• Jumba la kazi za jamii: Linaonyesha kazi za ubunifu wa mashabiki na picha za vichekesho.
• Uchangiaji rahisi: Hata wasio watengenezaji programu wanaweza kuwasilisha kazi, kupendekeza rasilimali au kuripoti matatizo kupitia fomu za GitHub.
• Muundo wa tovuti tuli: Faili za chanzo za tovuti zimekusanywa katika site/, na zinaweza kuhakikiwa kwenye kompyuta kwa kutumia huduma rahisi ya Python HTTP.
• Uwekaji wa kiotomatiki: Baada ya kusukuma mabadiliko kwenye tawi la main, GitHub Actions itaweka kiotomatiki site/ kwenye GitHub Pages.

Jinsi ya kuitumia mtandaoni

Hatua ya 1: Ingia kwenye tovuti ya rasilimali

Fungua tovuti ya mtandaoni na uvinjari rasilimali pamoja na jumba la kazi za jamii kwenye ukurasa wa mwanzo. Ikiwa unatazama au kunakili maudhui yaliyopo pekee, huhitaji kusakinisha programu yoyote.

Hatua ya 2: Tafuta marejeo ya uundaji

Tazama michoro ya muundo wa mhusika na vidokezo vya uundaji kulingana na mahitaji yako ya uundaji. Michoro inafaa kwa kuchunguza vipengele vya mhusika, huku vidokezo vinaweza kunakiliwa moja kwa moja na kurekebishwa kulingana na malengo yako ya uundaji. Kwa kuwa mradi hauweki tabia moja ya lazima ya mhusika, nyenzo hizi zinapaswa kuchukuliwa kama marejeo ya jamii, si kanuni za lazima.

Hatua ya 3: Thibitisha leseni ya nyenzo

Kabla ya kunukuu au kuchapisha tena picha, hakikisha umeangalia maelezo ya mwandishi na masharti ya matumizi ya nyenzo hiyo. Kuwekwa kwa rasilimali kwenye tovuti hakumaanishi kuwa tovuti inamiliki hakimiliki, wala hakumaanishi mtumiaji amepewa kiotomatiki ruhusa ya kuitumia tena.

Kusakinisha na kuhakiki kwenye kompyuta

Mradi huu ni tovuti tuli na hauhitaji usakinishaji changamano wa vitegemezi au zana za kujenga. README inaeleza wazi kuwa mazingira ya kompyuta yanahitaji Python 3.

1. Pata faili za hazina

Unaweza kupakua kifurushi cha hazina kutoka GitHub, au kutumia Git kuiga mradi:

git clone https://github.com/TreapGoGo/deepseek-whale-girl.git
cd deepseek-whale-girl

2. Anzisha seva ya ndani

Tekeleza amri ifuatayo katika saraka kuu ya hazina:

python -m http.server 4173 --directory site

Amri hii hutumia seva ya HTTP iliyojengwa ndani ya Python, huweka site/ kuwa saraka ya tovuti, na kusikiliza kwenye mlango wa 4173 wa kompyuta ya ndani.

3. Fungua ukurasa wa hakikisho

Baada ya seva kuanza, tembelea anwani ifuatayo kwenye kivinjari:

http://localhost:4173

Baada ya kurekebisha faili za HTML, CSS au JavaScript, onyesha upya kivinjari ili kuona matokeo. Ukimaliza kuhakiki, bonyeza Ctrl+C kwenye terminali inayoendesha seva ili kuisimamisha.

Maelezo ya muundo wa hazina

.
├── .github/
│   ├── ISSUE_TEMPLATE/
│   └── workflows/pages.yml
├── characters/
└── site/
    ├── assets/
    ├── index.html
    ├── project.html
    ├── contribute.html
    ├── styles.css
    └── script.js

• .github/ISSUE_TEMPLATE/: Huhifadhi fomu za kazi za jamii, mapendekezo ya rasilimali na mrejesho.
• .github/workflows/pages.yml: Hufafanua mchakato wa uwekaji wa kiotomatiki kwenye GitHub Pages.
• characters/: Huhifadhi kumbukumbu za asili za michoro ya muundo wa mhusika na nyenzo za chapa.
• site/assets/: Huhifadhi picha za tovuti na nyenzo za jumba la kazi za jamii.
• site/index.html: Ukurasa wa mwanzo wa tovuti na jumba la rasilimali.
• site/project.html: Ukurasa wa maswali yanayoulizwa mara kwa mara kuhusu mradi.
• site/contribute.html: Ukurasa unaoeleza njia za kuchangia.
• site/styles.css: Mitindo ya ukurasa.
• site/script.js: Mantiki ya mwingiliano wa ukurasa.

Mfano wa marekebisho ya msingi

Kurekebisha maudhui ya ukurasa

Ikiwa unataka kurekebisha maandishi ya ukurasa wa mwanzo au uonyeshaji wa rasilimali, anza kwenye site/index.html. Maswali yanayoulizwa mara kwa mara na maelezo ya uchangiaji yako katika site/project.html na site/contribute.html mtawalia.

1. Hariri faili ya HTML inayolengwa.
2. Ikiwa unahitaji kurekebisha mwonekano, badilisha site/styles.css.
3. Ikiwa unahitaji kurekebisha mwingiliano uliopo, kagua na ubadilishe site/script.js.
4. Anzisha seva ya ndani kwa kutumia amri ya Python.
5. Onyesha upya kivinjari na uhakikishe kuwa mpangilio, maudhui na viungo vinafanya kazi ipasavyo.

Kushughulikia nyenzo za picha

Picha zinazotumiwa na ukurasa pamoja na nyenzo za jumba la kazi za jamii ziko katika site/assets/. Kumbukumbu za asili za michoro ya muundo wa mhusika na nyenzo za chapa ziko katika characters/. Unapobadilisha marejeo ya picha, thibitisha pia njia ya faili, taarifa ya chanzo na maelezo ya ruhusa.

Kuchangia bila kuhitaji programu

Mradi umeandaa fomu za GitHub Issue kwa aina mbalimbali za michango. Kuchagua njia inayolingana na maudhui husaidia watunzaji kushughulikia maombi kwa haraka zaidi:

• Shiriki kazi ya jamii: Wasilisha kazi za ubunifu wa mashabiki zinazohusiana na Whale Girl.
• Pendekeza rasilimali zinazohusiana: Pendekeza miradi, zana au nyenzo za marejeo.
• Toa mrejesho, sahihisha au ongeza taarifa: Ripoti makosa, toa mapendekezo, au wasiliana na watunzaji kuhusu maudhui yanayoweza kukiuka hakimiliki.

Unapowasilisha, inashauriwa kueleza kwa uwazi jina la kazi au rasilimali, chanzo, mwandishi na taarifa ya ruhusa. Hii huwasaidia watunzaji kuthibitisha maelezo na kupunguza hatari ya watumiaji wa baadaye kuelewa vibaya mipaka ya leseni.

Kuboresha tovuti kupitia Pull Request

Wachangiaji wanaofahamu uundaji wa tovuti wanaweza kurekebisha tovuti moja kwa moja na kuwasilisha Pull Request. Mchakato unaopendekezwa ni huu:

1. Fanya marekebisho ya kurasa, mitindo au hati zilizo chini ya site/ kwenye tawi huru.
2. Endesha seva ya ndani ya HTTP ili kuhakiki matokeo ya marekebisho.
3. Kagua mwonekano wa ukurasa kwenye kompyuta za mezani na vivinjari vinavyotumiwa sana.
4. Thibitisha kila kiungo kipya au kilichorekebishwa.
5. Katika Pull Request, eleza lengo la marekebisho, eneo lililoathiriwa na matokeo ya ukaguzi.

Uwekaji na mbinu za hali ya juu

Kuelewa eneo la uwekaji wa kiotomatiki

Saraka ya uwekaji wa mradi ni site/. Baada ya mabadiliko kusukumwa kwenye tawi la main, GitHub Actions itaanzisha kiotomatiki uwekaji wa GitHub Pages. Unaweza pia kufungua ukurasa wa Actions wa hazina na kuanzisha uwekaji mwenyewe.

Ikiwa faili za kumbukumbu za asili ziko katika characters/, lakini hazijanakiliwa au kurejelewa katika site/, usidhani kuwa zitaonekana kiotomatiki kwenye tovuti iliyowekwa. Kabla ya kufanya marekebisho, tofautisha saraka ya nyenzo asili na saraka halisi ya tovuti.

Fanya ukaguzi mdogo kabla ya kuwasilisha

• Thibitisha kuwa ukurasa wa mwanzo wa ndani unaweza kufunguliwa kupitia http://localhost:4173.
• Kagua viungo kati ya ukurasa wa mwanzo, FAQ na ukurasa wa uchangiaji.
• Thibitisha kuwa njia na majina ya faili za picha mpya zinalingana.
• Thibitisha kuwa mwingiliano wa tovuti haujavunjwa na marekebisho ya JavaScript.
• Kagua chanzo cha nyenzo, jina la mwandishi na taarifa ya leseni.
• Tumia maelezo yaliyo wazi ya commit kueleza sababu ya marekebisho.

Tofautisha leseni mbalimbali

Msimbo wa chanzo wa tovuti katika hazina hii unatumia MIT License. Maandishi ya asili ya tovuti na vidokezo vya uundaji vinashirikiwa chini ya CC BY-SA 4.0.

Michoro ya muundo wa mhusika, michango ya jamii na nyenzo za miradi ya nje hazijumuishwi katika leseni ya msimbo iliyo hapo juu. Kila kimoja hufuata masharti ya ruhusa yaliyotolewa na mwandishi au chanzo husika. Ikiwa faili ina maelezo ya leseni yake binafsi, maelezo hayo ndiyo yanayotumika.

Usidhani kuwa picha inaweza kunakiliwa, kurekebishwa au kutumiwa kwa miradi mingine kwa uhuru kwa sababu tu inaonekana kwenye hazina au tovuti. Thibitisha ruhusa husika kabla ya kuitumia.

Muhtasari

Maktaba ya Rasilimali Huria ya Whale Girl ni njia kuu ya kupata marejeo ya mhusika na vidokezo vya uundaji, pamoja na jukwaa la kushiriki kazi, zana na nyenzo za jamii. Watumiaji wa kawaida wanaweza kuvinjari moja kwa moja mtandaoni na kuchangia kupitia fomu; watengenezaji wanahitaji tu kuandaa Python 3 ili kuhakiki na kurekebisha tovuti tuli kwenye kompyuta zao. Haijalishi unashiriki kwa njia gani, heshimu tabia ya mradi wa ubunifu wa pamoja wa jamii na thibitisha kwa makini hakimiliki na leseni ya kila nyenzo.