nöqtə.

noqte.ai · İlk saytın üçün bələdçi

İdeyanı sayta.
Saytını hamıya.

GitHub-da resursu tap. İşləyən saytını qur. Pulsuz hostinqə yerləşdir və linkini paylaş. İlk dəfə başlayanlar üçün bütün yol burada.

Bu nümunə üçün hostinq və pages.dev ünvanı — 0 AZN.

nöqtə · işləyən nümunə

Şəhəri dəyiş. Temperatur və qrafik yenilənsin. Ayrı səhifədə aç

Noti
Hava saytı sadəcə bir nümunədir.

Sən portfolio, film kataloqu, tədbir səhifəsi və ya məhsul vitrini qura bilərsən. Bu bələdçidə əvvəlcə bir işləyən nümunəni sona çatdıracağıq.

Başlanğıc

Sənə nə lazımdır?

Kompüter, internet, brauzer və sadə mətn redaktoru. Windows-da Notepad, macOS-da TextEdit-in plain text rejimi və ya Visual Studio Code uyğundur.

Sonda nə əldə edəcəksən?
  • Bakı və Gəncə arasında keçid edən hava saytı.
  • Temperatur, külək və saatlıq qrafik.
  • Telefondan da açılan ictimai pages.dev linki.
  • Saytı dəyişmək üçün sənin kompüterində qalan mənbə faylları.

Hazır nümunəni endirib dəyişmək üçün proqramlaşdırma bilmək şərt deyil. Kodun məntiqini də aşağıda izah edirik. Sıfırdan yazmaq istəyirsənsə, GitHub-dakı dərsi paralel keçə bilərsən.

Kompüterdə davam etmək daha rahatdır. Telefonla təlimatı oxuya və hazır nəticəni yoxlaya bilərsən. Cloudflare hesabı yayımlama mərhələsində lazım olacaq.

Resursları seç

GitHub-da nəyi açırıq?

Repository — layihənin fayllarının və izahının saxlandığı qovluqdur. Səhifəni aşağı sürüşdürəndə gördüyün README layihənin təlimatıdır. Star isə istifadəçinin layihəni yadda saxlamasıdır.

Dərs

Project Based Learning

JavaScript bölməsində “Build a Simple Weather App With Vanilla JavaScript” keçidini tap.

Məlumat

Public APIs

README daxilində “Open-Meteo” axtar. Hava məlumatını verən xidmətə keç.

Hostinq

Free for Dev

Pulsuz xidmətləri müqayisə etmək üçün kataloq. Bu nümunədə Cloudflare Pages istifadə edirik.

  1. Resursun linkini aç, README-yə en.
  2. Windows-da Ctrl + F, Mac-da ⌘ + F ilə lazım olan adı axtar.
  3. Tapdığın sətrin keçidini aç və dərsin və ya xidmətin öz səhifəsinə keç.

JavaScript brauzerdə işləyir və bu hava saytı üçün seçilib. Kataloqda Python, Java və başqa dillər də var. Python ilə server tətbiqi hazırlasan, onun yerləşdirilməsi bu statik saytın yolundan fərqli olacaq.

İlk faylların

Hazır saytı kompüterinə endir

Sayt paketini endir (.zip)
  1. Endirilən ilk-sayt.zip faylını tap.
  2. Windows-da sağ klik et və Extract All / Hamısını çıxart seç. Mac-da ZIP faylını iki dəfə aç.
  3. Çıxarılmış qovluğu ilk-saytim adlandır.
  4. Qovluğun içində aşağıdakı faylların olduğunu yoxla.
ilk-saytim/
  index.html     — səhifə, dizayn və JavaScript
  snapshot.js    — internet kəsilərsə arxiv məlumatı
  telimat.html   — paketlə gələn qısa təlimat

index.html üzərinə iki dəfə klik et. Brauzerdə hava saytı açılmalıdır. ZIP-in içindən işləmək əvəzinə əvvəlcə bütün faylları çıxart.

İlk dəyişikliyin

Sayt artıq sənin layihəndir

  1. index.html faylını mətn redaktorunda aç. Notepad üçün sağ klik edib Open with seç.
  2. nöqtə · Hava mətnini axtar və Mənim hava saytım ilə əvəz et.
  3. <title>Hava · noqte.ai</title> sətrində brauzer başlığını istədiyin ada dəyiş.
  4. Yadda saxla — Ctrl + S və ya ⌘ + S.
  5. Brauzerdə səhifəni yenilə. Yeni başlığı görməlisən.

Windows-da faylın adının index.html.txt olmadığını yoxla. Explorer-də View → Show → File name extensions seç. Notepad-də Save As istifadə edirsənsə, fayl növünü All files, kodlaşdırmanı UTF-8 seç.

HTML — səhifənin quruluşuCSS — rənglər və görünüşJavaScript — düymələrin işi

Rəngi dəyişmək üçün <style> hissəsindəki rəng kodlarını dəyişə bilərsən. Hər dəfə bir dəyişiklik et, yadda saxla və brauzerdə yoxla.

Düymədən məlumatadək

Hava məlumatı sayta necə gəlir?

API bir xidmətə sorğu göndərib məlumat almaq yoludur. Biz şəhərin koordinatlarını göndəririk, Open-Meteo temperaturu, küləyi və saatlıq rəqəmləri qaytarır.

Bakı üçün real API cavabını aç

Brauzerdə görünən mətn JSON adlanır. current hissəsində temperature_2m temperatur, wind_speed_10m külək sürətidir. Rəqəmlər zamanla yenilənir.

Sorğunun hissələri

latitude=40.41          // Bakının enliyi
longitude=49.87         // Bakının uzunluğu
current=temperature_2m,wind_speed_10m
hourly=temperature_2m   // qrafik üçün saatlıq sıra
timezone=Asia/Baku      // yerli saat
forecast_days=1         // bir günlük məlumat

Kodda həmin əlaqə

const response = await fetch(url);
const data = await response.json();
temp.textContent = data.current.temperature_2m + '°';

fetch sorğunu göndərir. response.json() cavabı oxuyur. Son sətir rəqəmi kartın temperatur xanasına yazır. hourly.temperature_2m siyahısı isə qrafikin nöqtələrini verir.

Bakıdan Gəncəyə keçid

const cities = {
  baku: ['Bakı', 40.41, 49.87],
  ganja: ['Gəncə', 40.68, 46.36]
};

Hər düymənin data-city açarı var. Düyməyə basanda show() həmin açarın koordinatlarını götürüb yeni sorğu göndərir. Nəticədə həm şəhər adı, həm temperatur, həm də qrafik dəyişir.

Hazır paketdə API sorğusu alınmasa, tarixli arxiv məlumatı görünür. “Arxiv” yazısını gördükdə həmin rəqəmlər cari proqnoz sayılmır. İnterneti yoxla və səhifəni yenilə.

Open-Meteo-nun açarsız pulsuz API-si qeyri-kommersiya istifadə üçündür. İstifadə limitlərini və kommersiya şərtlərini layihəni böyütməzdən əvvəl yoxla. Mənbə keçidini saytda saxla. İstifadə şərtləri · API sənədləri

Yayımlamadan əvvəl

Saytı öz kompüterində yoxla

  • index.html brauzerdə açılır və başlıq düzgün görünür.
  • Bakı, sonra Gəncə düyməsinə basanda şəhər və qrafik dəyişir. Temperatur eyni ola bilər — şəhər adı dəyişməlidir.
  • Pəncərəni daralt. Mətn və düymələr ekrandan kənara çıxmamalıdır.
  • Mənbə keçidi işləyir. “Arxiv” varsa, interneti və API cavabını yoxla.

VS Code istifadə edirsənsə, Live Server əlavəsi ilə Open with Live Server seçə bilərsən. Bu hazır nümunəni birbaşa HTML faylından da açmaq mümkündür.

İnternetə çıx

Pulsuz hostinqə yerləşdir

Hostinq saytın fayllarını internetdə saxlayır. Cloudflare Pages bu statik nümunəni pages.dev ünvanında açmağa imkan verir. Öz domenini almaq bu yol üçün lazım deyil.

  1. Cloudflare panelini aç. Hesab yarat və e-poçt təsdiqini tamamla, yaxud mövcud hesabına daxil ol.
  2. Sol menyuda Workers & Pages bölməsini tap. Paneldən asılı olaraq bu bölmə Compute daxilində ola bilər.
  3. Create application seç. Pages və ya Get started keçidi ilə Pages yaratmağa keç.
  4. Drag and drop your files / Upload assets seç. Bu, Direct Upload yoludur.
  5. Layihə adı yaz, məsələn menim-hava-saytim. Ad tutulubsa, başqa unikal ad seç.
  6. index.html və snapshot.js olan qovluğu yükləmə sahəsinə sürüklə. index.html saytın kökündə qalmalıdır.
  7. Deploy site düyməsinə bas. Yükləmə tamamlanana qədər gözlə.
  8. Paneldə verilən faktiki https://…pages.dev ünvanını aç. Bu artıq sənin paylaşım linkindir.
Düzgün qovluq quruluşu
Yüklənən qovluq
├── index.html
└── snapshot.js

index.html-dən əvvəl əlavə iç-içə qovluq yaratma. Hazır paketdəki telimat.html faylını da saxlamaq olar.

Panel adları dəyişə bilər. Rəsmi təlimatda Drag and drop hissəsini izləyə bilərsən. Direct Upload layihəsi sonradan Git inteqrasiyasına çevrilmir, bunun üçün yeni layihə yaradılır. Cloudflare Direct Upload təlimatı

Sənin saytın artıq internetdədir

Linkini başqa cihazda aç

  1. Saytın ünvanını brauzerin ünvan sətrindən kopyala. Cloudflare idarəetmə panelinin linkini kopyalama.
  2. Telefonda və ya gizli brauzer pəncərəsində həmin linki aç. Giriş tələb etmədən işləməlidir.
  3. Bakı və Gəncə düymələrini yenidən yoxla.
  4. Linki dostuna göndər və ondan öz cihazında açmasını istə.

Sonra saytı necə yeniləyəcəksən?

Kompüterindəki faylları dəyiş və yenidən yoxla. Cloudflare-də həmin Pages layihəsini aç, Create deployment seç, yenilənmiş qovluğu yüklə və production mühitinə yayımla. Əsas layihə ünvanın eyni qalır.

Növbəti layihən nə olsun?

Portfolio

İşlərini, bacarıqlarını və əlaqə keçidlərini bir səhifədə topla.

Film kataloqu

Janr filtri, axtarış və sevimli filmlər siyahısı yarat.

Məhsul vitrini

Şəkil, rəng seçimi və səbət əlavə et. Real ödəniş və sifarişlər üçün uyğun xidmət qoşulur.

Yolun açıq qalsın

Nəsə alınmadı?

Sayt əvəzinə kod və ya boş səhifə görünür

Faylın adını yoxla — index.html olmalıdır. UTF-8 ilə yadda saxla. Tam kodu silmədiyinə əmin ol. Lazım gəlsə, hazır paketi yenidən endirib təmiz nümunədən başla.

Şəhər dəyişmir və ya “Arxiv” yazılır

snapshot.js index.html ilə eyni qovluqda olmalıdır. İnterneti, API keçidini və brauzer konsolundakı xətanı yoxla. Redaktədən sonra səhifəni Ctrl + F5 ilə yenilə. API cavabı alınmırsa, bir az sonra yenidən yoxla.

Pages linki 404 göstərir

Yüklədiyin qovluğun kökündə index.html olduğunu yoxla. Paneldə deployment-in uğurlu bitdiyinə bax. Faylları düzgün qovluqla yenidən yüklə və panelin verdiyi faktiki ünvanı aç.

Sayt işləyir, amma köhnə versiya görünür

Production deployment yaratdığını yoxla. Brauzeri Ctrl + F5 ilə yenilə, sonra gizli pəncərədə aç. Preview və production linklərini qarışdırma.

Pulsuz nədir, nəyə pul lazım ola bilər?

Bu nümunədə statik sayt, Cloudflare Pages-in pulsuz planı və pages.dev ünvanı istifadə olunur. Öz domenin ayrıca ödənişli ola bilər. API limitləri, kommersiya istifadəsi, ödəniş qəbulu və əlavə server xidmətlərinin ayrıca şərtləri var.

Başqa dil seçsəm eyni yolu istifadə edə bilərəm?

HTML, CSS və brauzer JavaScript faylları bu yolla birbaşa işləyir. React kimi layihələr əvvəlcə build edilməlidir. Python server kodu üçün uyğun Python hostinqi seçilir. İlk nəticə üçün bu statik nümunədən başla.

Noti

İlk saytın mükəmməl olmaq məcburiyyətində deyil. Bir dəyişiklik et, yoxla və linkini paylaş.