Skip to content

Add guide for creating personal website on GitHub Pages#17

Merged
Sazwanismail merged 1 commit intomainfrom
Sazwanismail-patch-5
Mar 10, 2026
Merged

Add guide for creating personal website on GitHub Pages#17
Sazwanismail merged 1 commit intomainfrom
Sazwanismail-patch-5

Conversation

@Sazwanismail
Copy link
Owner

@Sazwanismail Sazwanismail commented Mar 10, 2026 •
edited by codeant-ai bot
Loading

User description

Uploading Screenshot_20251114-204638.png…
Added a comprehensive guide for building a personal website on GitHub Pages, including steps for repository creation, index file setup, content writing, and customization options. # Panduan Lengkap Membina Laman Web Peribadi di GitHub Pages dengan Pematuhan Lesen Kerajaan Malaysia

📋 Pengenalan

Panduan ini menggabungkan dua aspek penting: (1) cara teknikal membina laman web peribadi menggunakan GitHub Pages secara percuma, dan (2) garis panduan pematuhan terhadap keperluan undang-undang dan lesen kerajaan Malaysia terutamanya berkaitan Akta Keselamatan Dalam Talian 2025 (Akta 866).

GitHub Pages adalah perkhidmatan hosting percuma yang membolehkan anda menerbitkan laman web statik terus dari repositori GitHub . Ia sesuai untuk laman peribadi, portfolio profesional, dokumentasi projek, atau blog ringkas .

🏛️ Bahagian 1: Memahami Keperluan Lesen Kerajaan Malaysia

1.1 Akta Keselamatan Dalam Talian 2025 (Akta 866)

Mulai 1 Januari 2026, Akta Keselamatan Dalam Talian 2025 (Akta 866) telah berkuat kuasa sepenuhnya di Malaysia . Akta ini mengawal selia penyebaran kandungan dalam talian yang berbahaya termasuk :

  • Bahan penderaan seksual kanak-kanak
  • Penipuan kewangan
  • Gangguan
  • Hasutan keganasan atau keganasan
  • Kandungan berbahaya yang lain

1.2 Tanggungjawab Pemilik Laman Web

Sebagai pemilik laman web peribadi, anda perlu mematuhi Dasar e-Penyertaan Kerajaan Malaysia yang menetapkan :

Perkara Larangan
Kandungan Pernyataan berunsur kaum, agama, politik

1.3 Lesen dan Pendaftaran yang Mungkin Diperlukan

Bergantung pada jenis laman web yang anda bina, anda mungkin perlu:

  1. Mendaftar lesen perniagaan jika laman digunakan untuk tujuan komersial
  2. Mematuhi Akta 866 dengan memastikan kandungan tidak melanggar peraturan
  3. Memastikan pematuhan hak cipta untuk semua kandungan yang diterbitkan

💻 Bahagian 2: Panduan Teknikal Membina Laman Web di GitHub Pages

2.1 Apa Itu GitHub Pages?

GitHub Pages adalah perkhidmatan hosting statik yang membolehkan anda :

  • Hosting percuma – tanpa kos bulanan
  • Domain kustom – boleh gunakan domain sendiri
  • Kawalan versi – menggunakan Git untuk menjejak perubahan
  • SSL/TLS percuma – HTTPS diaktifkan secara automatik
  • Penggunaan berterusan – push perubahan, laman dikemas kini automatik

Had penggunaan GitHub Pages :

  • Saiz maksimum laman: 1 GB
  • Tamat masa penggunaan: 10 minit
  • Had lebar jalur: 100 GB sebulan (lembut)
  • Had binaan: 10 sejam (lembut)
  • Tidak menyokong kod pelayan (server-side) atau pangkalan data

2.2 Prasyarat

Sebelum memulakan, pastikan anda mempunyai:

  1. Akaun GitHub (daftar percuma di github.com)
  2. Fail HTML asas untuk laman web anda
  3. (Pilihan) Git dipasang pada komputer tempatan

2.3 Langkah 1: Cipta Repositori Khas

  1. Log masuk ke akaun GitHub anda
  2. Klik butang "New repository" (ikon + di penjuru kanan atas)
  3. Nama repositori MESTI mengikut format: namapengguna.github.io Contoh: untuk username sazwan96, repositori mesti dinamakan sazwan96.github.io
  4. Pilih Public (awam) – repositori private tidak boleh menggunakan GitHub Pages pada tahap percuma
  5. Tandakan "Add a README file" (pilihan tetapi disyorkan)
  6. Klik "Create repository"

2.4 Langkah 2: Sediakan Fail Index

Fail index.html adalah halaman utama laman web anda.

Kaedah A: Melalui Antara Muka Web GitHub

  1. Dalam repositori baru, klik "Add file" > "Create new file"
  2. Namakan fail index.html
  3. Tampal kod HTML asas berikut:
<!DOCTYPE html>
<html lang="ms">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Nama Anda - Laman Peribadi</title>
    <style>
        body { font-family: Arial, sans-serif; margin: 0; padding: 20px; background: #f4f4f4; }
        .container { max-width: 800px; margin: auto; background: white; padding: 30px; border-radius: 10px; }
        h1 { color: #333; }
        .footer { margin-top: 30px; font-size: 0.9em; color: #666; text-align: center; }
    </style>
</head>
<body>
    <div class="container">
        <h1>Nama Anda</h1>
        <p><strong>Profesion / Jawatan</strong></p>
        <p>Selamat datang ke laman web peribadi saya.</p>
        <p>Email: emel.anda@contoh.com</p>
        <p>GitHub: @username</p>
        <div class="footer">
            <p>© 2026 Nama Anda. Hak Cipta Terpelihara.</p>
            <p><small>Laman ini mematuhi Akta Keselamatan Dalam Talian 2025 (Akta 866).</small></p>
        </div>
    </div>
</body>
</html>
  1. Di bahagian bawah, masukkan mesej commit seperti "Create index.html"
  2. Klik "Commit new file"

Kaedah B: Menggunakan Git Tempatan

git clone https://github.com/username/username.github.io.git
cd username.github.io
# Buat atau salin fail index.html ke folder ini
git add .
git commit -m "Initial commit"
git push origin main

2.5 Langkah 3: Aktifkan GitHub Pages

  1. Pergi ke tab "Settings" repositori anda
  2. Di bar sisi kiri, klik "Pages"
  3. Di bawah "Source", pilih "Deploy from a branch"
  4. Pilih branch "main" dan folder "/ (root)"
  5. Klik "Save"

GitHub akan menerbitkan laman web anda dan memberikan URL: https://username.github.io

Proses ini mungkin mengambil masa 1-2 minit .

2.6 Langkah 4: Tambah Halaman dan Kandungan Lain

Struktur Fail yang Disyorkan

username.github.io/
├── index.html          # Halaman utama
├── about.html          # Halaman tentang
├── portfolio.html      # Halaman portfolio
├── contact.html        # Halaman hubungan
├── css/
│   └── style.css       # Fail CSS
├── js/
│   └── main.js         # Fail JavaScript
└── images/
    └── profile.jpg     # Imej

Pautan Antara Halaman

Gunakan pautan HTML biasa untuk menghubungkan halaman:

<a href="about.html">Tentang Saya</a>
<a href="portfolio.html">Portfolio</a>
<a href="contact.html">Hubungi</a>

2.7 Langkah 5: Gunakan Tema atau Framework

Untuk reka bentuk yang lebih menarik, anda boleh gunakan rangka kerja CSS seperti:

Bootstrap

Tambah pautan Bootstrap dalam bahagian <head>:

<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">

Pico.css – Framework ringan

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">

2.8 Langkah 6: Gunakan Jekyll untuk Blog (Pilihan)

Jekyll adalah penjana laman statik yang disokong secara native oleh GitHub Pages . Ia membolehkan anda:

  • Menulis kandungan dalam format Markdown
  • Menggunakan templat untuk reka bentuk konsisten
  • Membina blog dengan mudah

Mulakan dengan Jekyll

  1. Tambah fail _config.yml di root repositori:
theme: minima
title: Laman Peribadi Saya
description: Portfolio dan blog peribadi
  1. Cipta folder _posts dan letak fail Markdown dengan format: YYYY-MM-DD-tajuk-post.md

2.9 Langkah 7: Gunakan Domain Sendiri (Pilihan)

Jika anda mempunyai domain sendiri (contoh: namasaya.com), anda boleh mengarahkannya ke GitHub Pages :

  1. Di GitHub: Settings → Pages → Custom domain → masukkan domain anda
  2. Di laman pendaftar domain, tambah rekod DNS:
    • Untuk domain akar: A records pointing ke IP GitHub Pages: 185.199.108.153 185.199.109.153 185.199.110.153 185.199.111.153
    • Untuk subdomain: CNAME record pointing ke username.github.io

GitHub Pages akan menyediakan sijil SSL secara automatik .

⚖️ Bahagian 3: Panduan Pematuhan Undang-Undang untuk Laman Web

3.1 Mematuhi Akta Keselamatan Dalam Talian 2025 (Akta 866)

Akta 866 yang berkuat kuasa mulai 1 Januari 2026 menetapkan beberapa keperluan penting :

Keperluan Tindakan yang Perlu Diambil
Kandungan selamat Pastikan semua kandungan tidak mengandungi bahan berbahaya

3.2 Menambah Notis Pematuhan

Tambahkan notis pematuhan di footer laman web anda:

<div class="footer">
    <p>© 2026 Nama Anda. Hak Cipta Terpelihara.</p>
    <p><small>Laman ini mematuhi Akta Keselamatan Dalam Talian 2025 (Akta 866) dan Dasar e-Penyertaan Kerajaan Malaysia.</small></p>
    <p><small>Sebarang pertanyaan aduan: emel.anda@contoh.com</small></p>
</div>

3.3 Dasar Privasi dan Terma Penggunaan

Sediakan halaman Dasar Privasi dan Terma Penggunaan yang mematuhi keperluan Malaysia:

Contoh halaman privacy.html:

<!DOCTYPE html>
<html>
<head>
    <title>Dasar Privasi</title>
</head>
<body>
    <h1>Dasar Privasi</h1>
    <p>Laman web ini menghormati privasi pengguna dan mematuhi Akta 866.</p>
    <h2>Pengumpulan Maklumat</h2>
    <p>Kami tidak mengumpul maklumat peribadi tanpa kebenaran.</p>
    <h2>Hubungi</h2>
    <p>Untuk sebarang pertanyaan, sila emel: emel.anda@contoh.com</p>
</body>
</html>

3.4 Kandungan yang Dilarang

Pastikan laman web anda TIDAK mengandungi :

  1. Unsur sensitif: Pernyataan berunsur kaum, agama, politik
  2. Serangan peribadi: Menghina atau membuat serangan peribadi
  3. Pelanggaran hak cipta: Menggunakan kandungan tanpa kebenaran
  4. Kandungan berbahaya: Pautan ke laman lucah, virus, skim cepat kaya

3.5 Lesen Perniagaan untuk Laman Komersial

Jika laman web anda digunakan untuk tujuan komersial (menjual produk/perkhidmatan), anda mungkin perlu:

  1. Mendaftar perniagaan dengan SSM (Suruhanjaya Syarikat Malaysia)
  2. Mendapatkan lesen perniagaan tempatan jika berkenaan
  3. Mematuhi peraturan e-dagang Malaysia

🛡️ Bahagian 4: Keselamatan dan Pengesahan Digital

4.1 Sijil SSL/HTTPS

GitHub Pages menyediakan HTTPS secara automatik untuk domain github.io dan untuk domain kustom yang dikonfigurasi dengan betul . Ini memastikan:

  • Data pengguna disulitkan
  • Laman web lebih dipercayai
  • Mematuhi keperluan keselamatan siber

4.2 Pengesahan Identiti Digital

Untuk laman web peribadi, anda boleh menambah pengesahan identiti digital seperti cap jari kriptografi:

<div class="verification">
    <h3>Pengesahan Identiti Digital</h3>
    <p><strong>SHA-256:</strong> 32D8A53CC4C299E60424CD0DE96D3B06575D51...</p>
    <p><strong>Laman Web:</strong> https://username.github.io</p>
</div>

4.3 Backup dan Kesinambungan

Amalan terbaik untuk keselamatan jangka panjang :

  1. Backup berkala: Clone repositori ke komputer tempatan
  2. Gunakan branch: Pastikan branch main sentiasa stabil
  3. Uji tempatan: Gunakan python -m http.server untuk uji laman sebelum push
  4. Dokumentasi: Simpan rekod perubahan dengan mesej commit yang jelas

✅ Bahagian 5: Senarai Semak Pelancaran Laman Web

Gunakan senarai semak ini untuk memastikan laman web anda siap dilancarkan :

Langkah Tugas Status
1 ✅ Akaun GitHub telah dibuat ☐
2 ✅ Repositori username.github.io telah dicipta ☐
4 ✅ GitHub Pages telah diaktifkan di Settings ☐

🔍 Bahagian 6: Penyelesaian Masalah Biasa

Masalah Punca Penyelesaian
Laman tidak muncul selepas 10 minit Nama repositori salah Pastikan repositori dinamakan tepat username.github.io

📚 Sumber Tambahan

  1. Dokumentasi Rasmi GitHub Pages: docs.github.com/en/pages
  2. Akta Keselamatan Dalam Talian 2025 (Akta 866): Rujuk laman rasmi MCMC
  3. Panduan Hak Cipta Malaysia: MyIPO
  4. Tema GitHub Pages: pages.github.com/themes
  5. Belajar HTML & CSS: W3Schools

🎉 Kesimpulan

Membina laman web peribadi di GitHub Pages adalah percuma, mudah, dan cepat. Dengan mengikuti panduan ini, anda boleh:

  1. Mewujudkan kehadiran dalam talian profesional dalam masa kurang 30 minit
  2. Menjimatkan kos hosting sehingga RM0 setahun
  3. Mematuhi undang-undang Malaysia termasuk Akta Keselamatan Dalam Talian 2025
  4. Mengawal sepenuhnya kandungan dan reka bentuk laman web anda

Ingat bahawa laman web peribadi adalah cerminan diri profesional anda. Pastikan kandungan sentiasa dikemas kini, mematuhi undang-undang, dan memberikan nilai kepada pengunjung.

Selamat membina laman web anda! 🚀

Panduan ini dikemaskini pada 11 Mac 2026, mengambil kira Akta Keselamatan Dalam Talian 2025 (Akta 866) yang berkuat kuasa 1 Januari 2026.

CodeAnt-AI Description

Add a complete Malay-language guide for creating a personal website on GitHub Pages

What Changed

  • Added a new, step-by-step guide that walks users through creating a username.github.io repository and publishing an index.html so a personal site is live.
  • Included ready-to-use HTML examples (plain and Bootstrap), a full sample personal profile page, and instructions for editing via the GitHub web UI or local Git.
  • Added clear instructions for using a custom domain (DNS records and SSL), enabling Jekyll for blogs, and a troubleshooting section for common publishing issues.
  • Bundled useful links and resources so users can follow official docs and learn HTML/CSS quickly.

Impact

✅ Shorter site launch time for new GitHub Pages users
✅ Clearer custom-domain DNS setup for personal sites
✅ Fewer publishing and 404 mistakes thanks to troubleshooting guidance

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

@Sazwanismail
Add guide for creating personal website on GitHub Pages
e39cf37 
Added a comprehensive guide for building a personal website on GitHub Pages, including steps for repository creation, index file setup, content writing, and customization options.
# Panduan Lengkap Membina Laman Web Peribadi di GitHub Pages dengan Pematuhan Lesen Kerajaan Malaysia

## 📋 Pengenalan

Panduan ini menggabungkan dua aspek penting: (1) cara teknikal membina laman web peribadi menggunakan GitHub Pages secara percuma, dan (2) garis panduan pematuhan terhadap keperluan undang-undang dan lesen kerajaan Malaysia terutamanya berkaitan Akta Keselamatan Dalam Talian 2025 (Akta 866).

GitHub Pages adalah perkhidmatan hosting percuma yang membolehkan anda menerbitkan laman web statik terus dari repositori GitHub . Ia sesuai untuk laman peribadi, portfolio profesional, dokumentasi projek, atau blog ringkas .

---

## 🏛️ **Bahagian 1: Memahami Keperluan Lesen Kerajaan Malaysia**

### 1.1 Akta Keselamatan Dalam Talian 2025 (Akta 866)

Mulai **1 Januari 2026**, Akta Keselamatan Dalam Talian 2025 (Akta 866) telah berkuat kuasa sepenuhnya di Malaysia . Akta ini mengawal selia penyebaran kandungan dalam talian yang berbahaya termasuk :

- Bahan penderaan seksual kanak-kanak
- Penipuan kewangan
- Gangguan
- Hasutan keganasan atau keganasan
- Kandungan berbahaya yang lain

### 1.2 Tanggungjawab Pemilik Laman Web

Sebagai pemilik laman web peribadi, anda perlu mematuhi **Dasar e-Penyertaan** Kerajaan Malaysia yang menetapkan :

| Perkara | Larangan |
|---------|----------|
| **Kandungan** | Pernyataan berunsur kaum, agama, politik |
| **Serangan peribadi** | Menghina, serangan peribadi |
| **Hak cipta** | Melanggar 'COPYRIGHT LAW', 'TRADEMARK', 'PATENT' |
| **Keselamatan** | Memuat naik fail yang mengandungi virus komputer |
| **Spam** | Menjalankan skim cepat kaya, rantai surat, junk e-mail |

### 1.3 Lesen dan Pendaftaran yang Mungkin Diperlukan

Bergantung pada jenis laman web yang anda bina, anda mungkin perlu:

1. **Mendaftar lesen perniagaan** jika laman digunakan untuk tujuan komersial
2. **Mematuhi Akta 866** dengan memastikan kandungan tidak melanggar peraturan 
3. **Memastikan pematuhan hak cipta** untuk semua kandungan yang diterbitkan 

---

## 💻 **Bahagian 2: Panduan Teknikal Membina Laman Web di GitHub Pages**

### 2.1 Apa Itu GitHub Pages?

GitHub Pages adalah perkhidmatan hosting statik yang membolehkan anda :
- **Hosting percuma** – tanpa kos bulanan
- **Domain kustom** – boleh gunakan domain sendiri
- **Kawalan versi** – menggunakan Git untuk menjejak perubahan
- **SSL/TLS percuma** – HTTPS diaktifkan secara automatik
- **Penggunaan berterusan** – push perubahan, laman dikemas kini automatik

**Had penggunaan GitHub Pages** :
- Saiz maksimum laman: 1 GB
- Tamat masa penggunaan: 10 minit
- Had lebar jalur: 100 GB sebulan (lembut)
- Had binaan: 10 sejam (lembut)
- **Tidak menyokong** kod pelayan (server-side) atau pangkalan data 

### 2.2 Prasyarat

Sebelum memulakan, pastikan anda mempunyai:
1. Akaun GitHub (daftar percuma di [github.com](https://github.com)) 
2. Fail HTML asas untuk laman web anda
3. (Pilihan) Git dipasang pada komputer tempatan 

### 2.3 Langkah 1: Cipta Repositori Khas

1. Log masuk ke akaun GitHub anda
2. Klik butang **"New repository"** (ikon + di penjuru kanan atas)
3. **Nama repositori** MESTI mengikut format: `namapengguna.github.io`  
   *Contoh: untuk username `sazwan96`, repositori mesti dinamakan `sazwan96.github.io`* 
4. Pilih **Public** (awam) – repositori private tidak boleh menggunakan GitHub Pages pada tahap percuma 
5. Tandakan **"Add a README file"** (pilihan tetapi disyorkan)
6. Klik **"Create repository"**

### 2.4 Langkah 2: Sediakan Fail Index

Fail `index.html` adalah halaman utama laman web anda.

#### **Kaedah A: Melalui Antara Muka Web GitHub** 

1. Dalam repositori baru, klik **"Add file"** > **"Create new file"**
2. Namakan fail `index.html`
3. Tampal kod HTML asas berikut:

```html
<!DOCTYPE html>
<html lang="ms">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Nama Anda - Laman Peribadi</title>
    <style>
        body { font-family: Arial, sans-serif; margin: 0; padding: 20px; background: #f4f4f4; }
        .container { max-width: 800px; margin: auto; background: white; padding: 30px; border-radius: 10px; }
        h1 { color: #333; }
        .footer { margin-top: 30px; font-size: 0.9em; color: #666; text-align: center; }
    </style>
</head>
<body>
    <div class="container">
        <h1>Nama Anda</h1>
        <p><strong>Profesion / Jawatan</strong></p>
        <p>Selamat datang ke laman web peribadi saya.</p>
        <p>Email: emel.anda@contoh.com</p>
        <p>GitHub: @username</p>
        <div class="footer">
            <p>© 2026 Nama Anda. Hak Cipta Terpelihara.</p>
            <p><small>Laman ini mematuhi Akta Keselamatan Dalam Talian 2025 (Akta 866).</small></p>
        </div>
    </div>
</body>
</html>
```

4. Di bahagian bawah, masukkan mesej commit seperti "Create index.html"
5. Klik **"Commit new file"**

#### **Kaedah B: Menggunakan Git Tempatan** 

```bash
git clone https://github.com/username/username.github.io.git
cd username.github.io
# Buat atau salin fail index.html ke folder ini
git add .
git commit -m "Initial commit"
git push origin main
```

### 2.5 Langkah 3: Aktifkan GitHub Pages

1. Pergi ke tab **"Settings"** repositori anda 
2. Di bar sisi kiri, klik **"Pages"**
3. Di bawah **"Source"**, pilih **"Deploy from a branch"** 
4. Pilih branch **"main"** dan folder **"/ (root)"**
5. Klik **"Save"**

GitHub akan menerbitkan laman web anda dan memberikan URL:  
`https://username.github.io` 

Proses ini mungkin mengambil masa 1-2 minit .

### 2.6 Langkah 4: Tambah Halaman dan Kandungan Lain

#### **Struktur Fail yang Disyorkan** 

```
username.github.io/
├── index.html          # Halaman utama
├── about.html          # Halaman tentang
├── portfolio.html      # Halaman portfolio
├── contact.html        # Halaman hubungan
├── css/
│   └── style.css       # Fail CSS
├── js/
│   └── main.js         # Fail JavaScript
└── images/
    └── profile.jpg     # Imej
```

#### **Pautan Antara Halaman**

Gunakan pautan HTML biasa untuk menghubungkan halaman:

```html
<a href="about.html">Tentang Saya</a>
<a href="portfolio.html">Portfolio</a>
<a href="contact.html">Hubungi</a>
```

### 2.7 Langkah 5: Gunakan Tema atau Framework

Untuk reka bentuk yang lebih menarik, anda boleh gunakan rangka kerja CSS seperti:

#### **Bootstrap** 

Tambah pautan Bootstrap dalam bahagian `<head>`:

```html
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
```

#### **Pico.css** – Framework ringan 

```html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">
```

### 2.8 Langkah 6: Gunakan Jekyll untuk Blog (Pilihan)

Jekyll adalah penjana laman statik yang disokong secara native oleh GitHub Pages . Ia membolehkan anda:

- Menulis kandungan dalam format Markdown
- Menggunakan templat untuk reka bentuk konsisten
- Membina blog dengan mudah

#### **Mulakan dengan Jekyll** 

1. Tambah fail `_config.yml` di root repositori:

```yaml
theme: minima
title: Laman Peribadi Saya
description: Portfolio dan blog peribadi
```

2. Cipta folder `_posts` dan letak fail Markdown dengan format:  
   `YYYY-MM-DD-tajuk-post.md`

### 2.9 Langkah 7: Gunakan Domain Sendiri (Pilihan)

Jika anda mempunyai domain sendiri (contoh: `namasaya.com`), anda boleh mengarahkannya ke GitHub Pages :

1. **Di GitHub**: Settings → Pages → Custom domain → masukkan domain anda
2. **Di laman pendaftar domain**, tambah rekod DNS:
   - Untuk domain akar: **A records** pointing ke IP GitHub Pages:
     ```
     185.199.108.153
     185.199.109.153
     185.199.110.153
     185.199.111.153
     ```
   - Untuk subdomain: **CNAME record** pointing ke `username.github.io`

GitHub Pages akan menyediakan sijil SSL secara automatik .

---

## ⚖️ **Bahagian 3: Panduan Pematuhan Undang-Undang untuk Laman Web**

### 3.1 Mematuhi Akta Keselamatan Dalam Talian 2025 (Akta 866)

Akta 866 yang berkuat kuasa mulai 1 Januari 2026 menetapkan beberapa keperluan penting :

| Keperluan | Tindakan yang Perlu Diambil |
|-----------|------------------------------|
| **Kandungan selamat** | Pastikan semua kandungan tidak mengandungi bahan berbahaya |
| **Mekanisme aduan** | Sediakan halaman hubungan untuk aduan pengguna |
| **Pematuhan hak cipta** | Gunakan hanya kandungan yang anda miliki atau mempunyai lesen |
| **Keselamatan siber** | Lindungi laman daripada ancaman keselamatan |

### 3.2 Menambah Notis Pematuhan

Tambahkan notis pematuhan di footer laman web anda:

```html
<div class="footer">
    <p>© 2026 Nama Anda. Hak Cipta Terpelihara.</p>
    <p><small>Laman ini mematuhi Akta Keselamatan Dalam Talian 2025 (Akta 866) dan Dasar e-Penyertaan Kerajaan Malaysia.</small></p>
    <p><small>Sebarang pertanyaan aduan: emel.anda@contoh.com</small></p>
</div>
```

### 3.3 Dasar Privasi dan Terma Penggunaan

Sediakan halaman Dasar Privasi dan Terma Penggunaan yang mematuhi keperluan Malaysia:

#### **Contoh halaman privacy.html**:

```html
<!DOCTYPE html>
<html>
<head>
    <title>Dasar Privasi</title>
</head>
<body>
    <h1>Dasar Privasi</h1>
    <p>Laman web ini menghormati privasi pengguna dan mematuhi Akta 866.</p>
    <h2>Pengumpulan Maklumat</h2>
    <p>Kami tidak mengumpul maklumat peribadi tanpa kebenaran.</p>
    <h2>Hubungi</h2>
    <p>Untuk sebarang pertanyaan, sila emel: emel.anda@contoh.com</p>
</body>
</html>
```

### 3.4 Kandungan yang Dilarang

Pastikan laman web anda TIDAK mengandungi :

1. **Unsur sensitif**: Pernyataan berunsur kaum, agama, politik
2. **Serangan peribadi**: Menghina atau membuat serangan peribadi
3. **Pelanggaran hak cipta**: Menggunakan kandungan tanpa kebenaran
4. **Kandungan berbahaya**: Pautan ke laman lucah, virus, skim cepat kaya

### 3.5 Lesen Perniagaan untuk Laman Komersial

Jika laman web anda digunakan untuk tujuan komersial (menjual produk/perkhidmatan), anda mungkin perlu:

1. Mendaftar perniagaan dengan SSM (Suruhanjaya Syarikat Malaysia)
2. Mendapatkan lesen perniagaan tempatan jika berkenaan
3. Mematuhi peraturan e-dagang Malaysia

---

## 🛡️ **Bahagian 4: Keselamatan dan Pengesahan Digital**

### 4.1 Sijil SSL/HTTPS

GitHub Pages menyediakan HTTPS secara automatik untuk domain `github.io` dan untuk domain kustom yang dikonfigurasi dengan betul . Ini memastikan:

- Data pengguna disulitkan
- Laman web lebih dipercayai
- Mematuhi keperluan keselamatan siber

### 4.2 Pengesahan Identiti Digital

Untuk laman web peribadi, anda boleh menambah pengesahan identiti digital seperti cap jari kriptografi:

```html
<div class="verification">
    <h3>Pengesahan Identiti Digital</h3>
    <p><strong>SHA-256:</strong> 32D8A53CC4C299E60424CD0DE96D3B06575D51...</p>
    <p><strong>Laman Web:</strong> https://username.github.io</p>
</div>
```

### 4.3 Backup dan Kesinambungan

Amalan terbaik untuk keselamatan jangka panjang :

1. **Backup berkala**: Clone repositori ke komputer tempatan
2. **Gunakan branch**: Pastikan branch `main` sentiasa stabil
3. **Uji tempatan**: Gunakan `python -m http.server` untuk uji laman sebelum push
4. **Dokumentasi**: Simpan rekod perubahan dengan mesej commit yang jelas

---

## ✅ **Bahagian 5: Senarai Semak Pelancaran Laman Web**

Gunakan senarai semak ini untuk memastikan laman web anda siap dilancarkan :

| Langkah | Tugas | Status |
|---------|-------|--------|
| 1 | ✅ Akaun GitHub telah dibuat | ☐ |
| 2 | ✅ Repositori `username.github.io` telah dicipta | ☐ |
| 3 | ✅ Fail `index.html` telah ditambah | ☐ |
| 4 | ✅ GitHub Pages telah diaktifkan di Settings | ☐ |
| 5 | ✅ Laman web boleh diakses di `https://username.github.io` | ☐ |
| 6 | ✅ Kandungan mematuhi Akta 866 dan undang-undang Malaysia | ☐ |
| 7 | ✅ Notis hak cipta dan pematuhan ditambah | ☐ |
| 8 | ✅ Halaman Dasar Privasi disediakan (jika perlu) | ☐ |
| 9 | ✅ HTTPS berfungsi (semak ikon kunci di penyemak imbas) | ☐ |
| 10 | ✅ Ujian lintas pelayar telah dilakukan | ☐ |

---

## 🔍 **Bahagian 6: Penyelesaian Masalah Biasa**

| Masalah | Punca | Penyelesaian |
|---------|-------|--------------|
| **Laman tidak muncul selepas 10 minit** | Nama repositori salah | Pastikan repositori dinamakan tepat `username.github.io`  |
| **Ralat 404** | Fail tiada di root | Pastikan `index.html` berada di folder root  |
| **CSS tidak berfungsi** | Laluan fail salah | Gunakan laluan relatif, contoh: `href="css/style.css"`  |
| **URL sensitif huruf besar/kecil** | GitHub Pages case-sensitive | Pastikan huruf besar/kecil dalam URL tepat  |
| **Domain kustom tidak aktif** | DNS belum merebak | Tunggu 24-48 jam untuk DNS tersebar  |
| **Kandungan tidak dikemas kini** | Cache penyemak imbas | Refresh dengan Ctrl+F5 atau clear cache |

---

## 📚 **Sumber Tambahan**

1. **Dokumentasi Rasmi GitHub Pages**: [docs.github.com/en/pages](https://docs.github.com/en/pages)
2. **Akta Keselamatan Dalam Talian 2025 (Akta 866)**: Rujuk laman rasmi [MCMC](https://www.mcmc.gov.my)
3. **Panduan Hak Cipta Malaysia**: [MyIPO](http://www.myipo.gov.my)
4. **Tema GitHub Pages**: [pages.github.com/themes](https://pages.github.com/themes/)
5. **Belajar HTML & CSS**: [W3Schools](https://www.w3schools.com)

---

## 🎉 **Kesimpulan**

Membina laman web peribadi di GitHub Pages adalah percuma, mudah, dan cepat. Dengan mengikuti panduan ini, anda boleh:

1. **Mewujudkan kehadiran dalam talian** profesional dalam masa kurang 30 minit
2. **Menjimatkan kos** hosting sehingga RM0 setahun
3. **Mematuhi undang-undang** Malaysia termasuk Akta Keselamatan Dalam Talian 2025
4. **Mengawal sepenuhnya** kandungan dan reka bentuk laman web anda

Ingat bahawa laman web peribadi adalah cerminan diri profesional anda. Pastikan kandungan sentiasa dikemas kini, mematuhi undang-undang, dan memberikan nilai kepada pengunjung.

**Selamat membina laman web anda!** 🚀

---

*Panduan ini dikemaskini pada 11 Mac 2026, mengambil kira Akta Keselamatan Dalam Talian 2025 (Akta 866) yang berkuat kuasa 1 Januari 2026.*
@Sazwanismail Sazwanismail self-assigned this Mar 10, 2026
@Sazwanismail Sazwanismail added documentation Improvements or additions to documentation duplicate This issue or pull request already exists labels Mar 10, 2026
@Sazwanismail Sazwanismail added help wanted Extra attention is needed question Further information is requested Media Sosial media Windows hunter Projects personal Black setting Laman sendiri gemma Kecerdasan buatan Strategic Kecekapan semulajadi size:M This PR changes 30-99 lines, ignoring generated files size:XL This PR changes 500-999 lines, ignoring generated files labels Mar 10, 2026
@codeant-ai
Copy link

codeant-ai bot commented Mar 10, 2026

CodeAnt AI is reviewing your PR.

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@Sazwanismail Sazwanismail merged commit 0ce6523 into main Mar 10, 2026
1 check passed
@codeant-ai codeant-ai bot removed size:M This PR changes 30-99 lines, ignoring generated files size:XL This PR changes 500-999 lines, ignoring generated files labels Mar 10, 2026
@codeant-ai
Copy link

codeant-ai bot commented Mar 10, 2026

Sequence Diagram

This PR adds a written guide explaining how a user creates a personal repository, adds an index page, and has GitHub Pages automatically publish a static personal website that can be viewed in a browser.

sequenceDiagram
    participant User
    participant GitHubWeb
    participant GitHubPages
    participant Browser

    User->>GitHubWeb: Create personal site repository
    User->>GitHubWeb: Add index page with HTML content
    GitHubWeb->>GitHubPages: Trigger site build and publish
    GitHubPages-->>GitHubWeb: Site available for personal address
    User->>Browser: Open personal site address
    Browser->>GitHubPages: Request site content
    GitHubPages-->>Browser: Return static personal page
Loading

Generated by CodeAnt AI

@codeant-ai codeant-ai bot added the size:L This PR changes 100-499 lines, ignoring generated files label Mar 10, 2026
@codeant-ai
Copy link

codeant-ai bot commented Mar 10, 2026

Nitpicks 🔍

🔒 No security issues identified
⚡ Recommended areas for review

  • Possible Sensitive Hash Exposure
    A SHA-256 fingerprint (truncated) is displayed under "Pengesahan Identiti Digital". Verify that this is safe to publish (not derived from private keys, passwords, or other sensitive artifacts). If it's a fingerprint of a public artifact it's fine; otherwise remove or redact.

  • Personal Data Exposure
    The guide embeds a personal email address (and GitHub handle) in public documentation which may be intentionally public but should be confirmed. Consider whether this personal contact info is appropriate to publish in this repository or should be obfuscated/redirected to a contact form to reduce spam and unintended exposure.

  • Accidental/Irrelevant Content
    The file contains an unrelated developer note and a Python snippet about changing a print statement. This appears accidental for a user guide and should be removed or relocated to an appropriate code/example file to avoid confusion.

  • Duplicate / Redundant Content
    The repository contains repeated sections of the same guide (the guide appears to restart). This duplication increases maintenance burden and may confuse readers. Consolidate to a single, canonical copy.

codeant-ai[bot]
codeant-ai bot reviewed Mar 10, 2026
View reviewed changes
@codeant-ai
Copy link

codeant-ai bot commented Mar 10, 2026

CodeAnt AI finished reviewing your PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@codeant-ai codeant-ai[bot] codeant-ai[bot] left review comments

Assignees

@Sazwanismail Sazwanismail

Labels

Black setting Laman sendiri documentation Improvements or additions to documentation duplicate This issue or pull request already exists gemma Kecerdasan buatan help wanted Extra attention is needed Media Sosial media question Further information is requested size:L This PR changes 100-499 lines, ignoring generated files Strategic Kecekapan semulajadi Windows hunter Projects personal

Projects

@Sazwanismail's untitled project support
Status: Done

Milestone

https://sazwan96https://github.com/Sa...

Development

Successfully merging this pull request may close these issues.

1 participant

@Sazwanismail