د مسار اصلي پاڼې ته د شا تګ
کوډینګ او ویب پرمختیا

د ګیټ‌هب پاڼو (GitHub Pages) له لارې د ویب پروژو خپرول

د پوهې تخنیکي کارکوونکو لخوا جون ۲۰۲۶

د دې لوست په اوږدو کې به تاسو د دغې موضوع په اړه مفصل او عملي لارښود ترلاسه کړئ ترڅو خپل مسلکي مهارتونه لوړ کړئ.

مهم ټکي

  • ګیټ‌هب پاڼې (GitHub Pages) یو وړیا کوربه توب (Hosting) خدمت دی چې له مخزنونو (Repositories) څخه سټاټیک فایلونه (Static Files) تالیف (Compile) کوي.
  • د مخزن په ترتیباتو (Repository Settings) کې د پاڼو (Pages) فعالول د پروژې جوړښتونه په عامه URLs کې خپروي.
  • د معیاري DNS CNAME ترتیباتو په کارولو سره شخصي ډومینونه (Custom Domains) د ګیټ‌هب پاڼو (GitHub Pages) سره نښلول کیدی شي.

سریزه او ارزښت

> 📌 **د لوست خلاصه (Quick Summary):** په دغه درس کې به تاسو د د ګیټ‌هب پاڼو (GitHub Pages) له لارې د ویب پروژو خپرول بنسټیز مفاهیم، د کارولو مسلکي اوزارونه او عملي لارې زده کړئ.

د وېب پرمختیا مهارتونه د ډیجیټل دورې تر ټولو مهم او نړیوال مهارتونه دي. د کار د احصایې ادارو له مخې، د وېب پرمختیا غوښتنه تل په زیاتیدو ده. د د ګیټ‌هب پاڼو (GitHub Pages) له لارې د ویب پروژو خپرول زده کړه یوازې نظریه نه ده؛ دا په مستقیم ډول ټاکي چې ایا هغه ویب پاڼې چې تاسو یې جوړوئ د اعتبار وړ او نړیوال رقابت لرونکې دي که نه.

دا لوست یو جوړښت لرونکی او څو پوړیز چلند تعقیبوي: موږ د اساساتو او جوړښت څخه پیل کوو ترڅو یو پیاوړی ذهني ماډل جوړ کړو، بیا عملي پړاوونو ته ځو چې تاسو یې سمدستي کارولی شئ، او په پای کې د مسلکي کچې تمرینونو سره پای ته رسوو چې اصلي کاري شرایط ښيي.

د ساحې مسلکي کسان په مسلکي مرکو، فریلانس پروژو او ورځني حلونو کې همدا موضوعات د اساس په توګه پیژني. د وخت پانګونه وکړئ ترڅو نه یوازې پر 'څه' بلکې پر 'ولې' هم پوه شئ — ځکه همدا د یو مسلکي او پیل کونکي ترمنځ توپیر دی.

بنسټیز مفاهیم او جوړښت

ګیټ‌هب پاڼې (GitHub Pages) یو ساده سټاټیک ویب کوربه توب (Static Web Hosting) خدمت وړاندې کوي، چې تالیف شوي جوړښتونه مستقیم له فعالو ریموټ مخزنونو (Remote Repositories) څخه راوباسي. کله چې فولډرونه په مخزنونو کې کمېټ (Commit) شي، ګیټ‌هب پاڼې هغه د ویب براوزرونو له لارې وړاندې کوي، او HTML، CSS او JavaScript رینډر (Render) کوي. دا د ځايي کوربه توب (Local Hosting) محدودیتونه له منځه وړي او د پروژې د ژوندي بڼې سمدستي ارزونه (Instant Production Validation) رامنځته کوي.

د بنسټیز جوړښت درک کول

د دې لپاره چې په ریښتیا په د ګیټ‌هب پاڼو (GitHub Pages) له لارې د ویب پروژو خپرول کې مهارت ترلاسه کړئ، دا مرسته کوي پوه شئ چې ولې دا قواعد شتون لري. دا ډیزاین نمونې د لسیزو ګډې انجینري تجربې څخه رامینځته شوي دي.

فکري موډلونه زده کړه ګړندۍ کوي: کله چې تاسو پر جوړښت پوه شئ، تاسو کولی شئ په نویو شرایطو کې د هغې د چلند اټکل وکړئ او ستونزې په اسانۍ سره حل کړئ.

مهمې اصطلاحګانې تعریف شوې

مسلکي چاپیریال ځانګړي او دقیق لغتونه لري. په درسي مسار کې خپل شخصي قاموس جوړولو ته لومړیتوب ورکړئ او د هر اصطلاح تعریف په سمه توګه زده کړئ.

دا مفهوم په مسار کې چېرته ځای لري

هیڅ مفهوم په یوازیتوب کې شتون نلري. په دې لوست کې ټول بحثونه د دې درسي مسار له نورو لوستونو سره تړلي دي. د وړاندې تګ دمخه ډاډ ترلاسه کړئ چې پر هر مهم ټکي په بشپړ ډول پوه شوي یاست.

flowchart TD A["د ګیټ‌هب پاڼو (GitHub Pages) له لارې د ویب پروژو خپرول"] --> B["Browser DOM"] B --> C["CSS Styling"] C --> D["JS Interactivity"] D --> E["Deployment Pages"] end

مسلکي اوزارونه او د پرمختیايي پروګرامونو ډګر

جدید وېب پرمختګ د ایډیټرانو، د بڼو کنټرول شبکو، د براوزر پرمختیايي وسیلو او خپرولو د پایپ لاینونو پر بنسټ ولاړ دی. په دې پوهیدل چې کوم اوزار کله وکاروئ، د مسلکي کسانو نښه ده.

  • Visual Studio Code — د وېب جوړونکو تر ټولو مشهور کوډ ایډیټر. د Prettier او GitLens په څېر ګټورې برخې لري چې کار خورا اسانه کوي.
  • Chrome DevTools — د براوزر دننه جوړه شوې وسیله چې په ژوندۍ بڼه د DOM ایډیټ کولو او د سټایلونو ډیبګ کولو اجازه ورکوي.
  • GitHub / GitHub Pages — د کوډونو خوندي کولو او د وړیا جامد پاڼو د خپرولو تر ټولو لویه نړیواله شبکه.
  • Node.js / npm — د سرور په کچه د جاواسکریپټ چلولو او د نویو کڅوړو د مدیریت تر ټولو مهم پروګرام.

د ځانګړې دندې لپاره د سم اوزار غوره کول پخپله یو مسلکي مهارت دی. د مسلک د پرمختګ سره به تاسو پوه شئ چې کله د چمتو شوي پلیټ فارمونو څخه کار واخلئ او کله خپل جوړ شوي حلونه وکاروئ. دا لوست تاسو سره د دې وسیلو په غوره تنظیم او کارولو کې مرسته کوي.

ګام په ګام د پلي کولو لارښود

نظري پوهه د عملي کار پرته نیمګړې ده. لاندې لارښود د اساساتو مفاهیم په عملي پړاوونو بدلوي. هر ګام په دقت سره تعقیب کړئ.

په ګیټ‌هب (GitHub) کې یو مخزن (Repository) جوړ کړئ، هغه په خپل کمپیوټر کې لینک کړئ، او فایلونه ریموټ مین برانچ (Remote Main Branch) ته پش (Push) کړئ. د مخزن ترتیباتو (Settings) ته لاړ شئ، د Pages مینو خلاصه کړئ، او د مین برانچ څخه د پلي کولو (Deployment) ترتیبات تنظیم کړئ. د خوندي کولو وروسته، ګیټ‌هب ستاسو ویبپاڼه په دې پته وړاندې کوي: `https://.github.io//`.

د غلطیو اصلي ځایونه

د ساحې مسلکي کسان پوهیږي چې ځینې کارونه د نورو په پرتله د غلطیو ډیر چانس لري. مخکې له مخکې پر هغو پوهیدل ستاسو وخت خورا سپموي:

  • د کاري محیط تنظیمول — ستاسو د کمپیوټر او اصلي سرور ترمنځ توپیر د غلطیو یو لوی لامل دی.
  • د پروژې په پیل کې د کار پېچلي کول — لومړی تر ټولو ساده نسخه جوړه کړئ او بیا یې پرمخ بوځئ.
  • د اسنادو یا کمنټونو نه لیکل — د کوډ کولو سره جوخت د هغې په اړه توضیحات لیکل خورا مهم دي.

پلي کول او ارزونه

عملي کار هغه وخت بشپړیږي چې پایلې یې تایید شي. د ځان څخه پوښتنه وکړئ: څنګه پوه شم چې دا په سمه توګه کار کوي؟

غوره او مسلکي کړنې

د غوره لارو چارو پوهیدل د ستونزو او خطراتو مخنیوی کوي. د هغو تر شا پر فلسفه او منطق ځان پوه کړئ.

ډاډ ترلاسه کړئ چې ستاسو د ننوتلو پاڼې فایل په اصلي فولډر (Root Directory) کې په دقیق ډول په `index.html` نوم نومول شوی وي، ځکه چې د کوربه توب سرورونه په ډیفالټ ډول همدا انډیکس پاڼه لټوي. په DNS ډشبورډونو کې د CNAME ترتیب ریکارډونو په کارولو سره شخصي ډومینونه (Custom Domains) تنظیم کړئ.

د مسلکي او باکیفیته کاري ذهنیت جوړول

د غوره لارو چارو د یادولو تر ټولو غوره لار دا ده چې خپل ځان ته یو چک لیست جوړ کړئ او د کار په پای کې د هغې له مخې هر څه وڅارئ.

لکه څنګه چې ستاسو مهارتونه وده کوي، تاسو به وګورئ چې په یوه برخه کې غوره لارې چارې له نورو برخو سره مرسته کوي.

عملي او رښتیني کوډ بېلګې

لاندې کوډ بېلګه په عملي توګه د لوست اساسات ښيي. دا په غور سره وڅارئ او په خپل عملي کار کې ورڅخه ګټه واخلئ.

یو عام لامل دا دی چې کوډ له پوهېدو پرته کاپي شي. د کاپي کولو پر ځای، لومړی د کوډ په هره کرښه په غور سره فکر وکړئ او پر رول یې پوه شئ.

deploy.sh
# Deploying local folder to GitHub remote branch
git remote add origin https://github.com/username/portfolio.git
git branch -M main
git push -u origin main

# Live page URL is served at: https://username.github.io/portfolio/
متقابل کوډ سنډباکس
سرچینه ایډیټر (د سمون لپاره لاندې ولیکئ)
ژوندۍ تماشا پاڼه

عملي تمرینونه او ارزونه

زده کړه د عمل په واسطه پیاوړې کیږي. د دې لپاره چې ډاډ ترلاسه کړئ چې تاسو د دې لوست مفاهیم په سمه توګه درک کړي، لاندې درې عملي تمرینونه ترسره کړئ:

  • په ګیټ‌هب پاڼو (GitHub Pages) کې یوه ساده شخصي پاڼه کوربه (Host) کړئ، د هغې د ژوندۍ نسخې URL تایید کړئ، او په موبایل کې یې سمون او اندازه وګورئ.
  • د پاڼې کوډ په خپل کمپیوټر کې بدل کړئ، بدلونونه کمېټ (Commit) کړئ، ریموټ مین (Remote Main) ته یې پش (Push) کړئ، او پلي شوي نوي بدلونونه وګورئ.
  • خپل د ګیټ‌هب پاڼو (GitHub Pages) مخزن ته د تګ لپاره یو شخصي ډومین نوم (Custom Domain Name) تنظیم کړئ.

ځانګړې ارزونه

خپله پوهه په سمدستي ډول د دې پوښتنې په ځوابولو سره وڅارئ:

د ویبپاڼې د اصلي پاڼې د ښودلو لپاره د ګیټ‌هب پاڼو (GitHub Pages) لخوا کوم معیاري فایل نوم ته اړتیا ده؟


سرچینې او اضافي لوستل

  • د W3C رسمي ټیکنالوژیکي معیارونه او مشخصات (۲۰۲۶).
  • د ګوګل پرمختیايي اسناد: د فعالیت، سئو (SEO)، او امنیت غوره کړنې.
  • د موزیلا پرمختیايي شبکه (MDN Web Docs) — د ویب معیارونو اصلي سرچینه.
  • د پوهې اکاډمۍ درسي بورډ او د ساحې د مسلکي کسانو د بیاکتنې پینل.