Skip to content

Latest commit

 

History

History
156 lines (118 loc) · 9.49 KB

README.md

File metadata and controls

156 lines (118 loc) · 9.49 KB


Tertarik jadi contributor? Jangan ragu untuk membuat issue / pull request!
Tertarik jadi collaborator / maintainer pada AdBlockID? Jangan ragu untuk beritahu Saya 😃

AdblockID adalah filter tambahan untuk melengkapi EasyList dan AdGuard Base Filter yang dirancang secara khusus untuk memblokir iklan (terutama iklan yang bermuatan konten dewasa) pada website di Indonesia.

Manfaat Yang Anda Dapatkan

  1. Faster, More Enjoyable Browsing^: Blokir iklan yang mengganggu pengalaman browsing Anda. Ucapkan selamat tinggal pada iklan video, banner gerak, PopAds dan banyak lagi. Memblokir gangguan ini berarti membuka halaman akan lebih cepat.
  2. Anti-AdBlocker Detection^
  3. Overlay-Blocker^: Lupakan obtrusive overlay (pop up) yang mengganggu.
  4. Anti-Safelink^^: Lupakan URL safelink ketika hendak download file kesayangan Anda.
  5. Clean: no extra abracadabra!

Catatan
^ Tersedia pada AdBlockID dan diperluas pada AdBlockID+.
^^ Hanya tersedia pada AdBlockID+.

Cara Menggunakan

Tutorial spesifik cara memasang AdBlockID:

Berkontribusi

Terima kasih banyak untuk Anda yang ingin berkontribusi. Saya sangat menghargai komitmen Anda. Menggunakan filter AdBlockID di Ad Blocker favorit Anda sudah merupakan dukungan besar, tetapi ada cara terbaik lainnya untuk berkontribusi:

  • Beri AdBlockID bintang/star di GitHub. Karena jika Anda menggunakan dan menyukainya, Anda setidaknya bisa menjadi stargazer!
  • Membuat issue. Bantu Kami mengetahui jika ada iklan yang masih mengganggu Anda di luar sana.
  • Bantu Kami menjawab dan memecahkan masalah pada issue yang masih terbuka. Jawaban Anda sangat membantu.
  • Buat pull requests di GitHub untuk memberikan perbaikan dan peningkatan. Otomatis terdaftar sebagai kontributor!
  • Beritahu orang terdekat Anda, agar makin banyak yang bisa merasakan manfaat dari AdBlockID.
  • Mari kita kopdar jika Anda sedang berada di sekitar Jakarta!

Development

Persiapan

Untuk menyatukan semua file ke dalam sebuah file adblockid.txt, Anda membutuhkan:

Setelah semua sudah terinstall di komputer Anda, lalu jalankan perintah ini:

$ pip install -e tools/python-abp

atau

$ pip install -t tools tools/python-abp

Panduan untuk menulis filter

Panduan ini dirancang untuk membantu Anda menulis dan mengelola filter.

Development Tools

File Deskripsi
build.sh Menggabungkan filter list ke dalam file adblockid.txt. Hasilnya ada di folder output.
validatehost.sh Periksa apakah host sedang up / down berdasarkan header yang dikembalikan dari curl.

Sebagian besar filter pada AdBlockID ditulis dengan Visual Studio Code dan berbagai tools pendukung telah diintegrasikan ke dalam Visual Studio Code melalui Tasks.

Visual Studio Code Tasks

Anda dapat mengakses Visual Studio Code Tasks dengan menekan Ctrl+Shift+P, lalu tekan Tasks: Run Task.

  • Build: Render filter list fragments ke dalam file adblockid.txt. Hasilnya ada di folder output.
  • FOP: Mengurutkan, menggabungkan dan memformat ulang beberapa filter jika memungkinkan.

Format Pesan Commit

Spesifikasi untuk menambahkan makna yang dapat dibaca manusia dan mesin untuk membuat pesan. Untuk contoh penggunaannya, Anda dapat melihat history commit.

Type Deskripsi
A Semua jenis iklan, termasuk banner, pop-up, ad server, dll.
AA Anti-Adblock.
M Maintain filter.
P Problem. Tandai dengan P untuk perbaikan masalah yang ditimbulkan oleh AdBlockID atau masalah yang disebabkan oleh filter utama (easylist, AdGuard base filter & uBlock filters) yang ingin dibenerin dengan AdBlockID.
<type>+ Contoh: A+: <commit message>. Pengeditan hanya pada AdBlockID Plus. Jika dilakukan pada keduanya, maka tidak perlu.
docs Edit file dokumentasi pada folder docs, termasuk readme.md dan dokumentasi pada file fragment AdBlockID (folder src) .
chore(<scope>) Semua pengeditan pada folder (/tools, /.vscode, /.github) dan file (.editorconfig, .gitignore, build.sh & validatehost.sh).

Struktur Direktori

Semua file fragment AdBlockID ada di dalam folder src, seperti bagan di bawah ini:

/src
 ├─ /addons
 │   ├─ adult-block.adbl
 │   ├─ adult-hide.adbl
 │   ├─ annoyances.adbl
 │   ├─ news.adbl
 │   ├─ scriptlet-ublock.adbl
 │   └─ shortlink.adbl
 ├─ /plus
 │   ├─ p_comic.adbl
 │   ├─ p_movie.adbl
 │   └─ p_safelink.adbl
 ├─ /template
 │   └─ ...
 ├─ adservers.adbl
 ├─ anti-adblock.adbl
 ├─ general_block.adbl
 ├─ general_hide.adbl
 ├─ specific_block.adbl
 ├─ specific_hide.adbl
 ├─ thirdparty.adbl
 └─ whitelist.adbl
  • adservers.adbl: Domain penyedia layanan iklan pihak ketiga.
  • anti-adblock.adbl: Filter khusus menangani web yang mendeteksi dan melarang Anda menggunakan Ad Blocker.
  • general_block.adbl: Filter umum untuk blockir content pada halaman web.
  • general_hide.adbl: Filter umum untuk menyembunyikan content pada halaman web.
  • specific_block.adbl: Secara spesifik hanya memblokir content pada domain yang disebutkan.
  • specific_hide.adbl: Secara spesifik hanya menyembunyikan content pada domain yang disebutkan.
  • thirdparty.adbl: Domain yang fungsi utamanya bukan sebagai server, namun dalam beberapa kasus dijadikan tempat untuk host iklan.
  • whitelist.adbl: Dalam kasus tertentu, Kita perlu memasukkan web ke dalam whitelist. Contoh: Fungsi utama dari web tersebut tidak jalan karena kesalahan blokir.
  • /addons/adult-block.adbl: Filter umum untuk blockir iklan berkonten dewasa.
  • /addons/adult-hide.adbl: Filter umum untuk menyembunyikan iklan berkonten dewasa.
  • /addons/annoyances.adbl: Filter untuk menghilangkan element web yang cukup mengganggu. Contoh: notifikasi cookie.
  • /addons/news.adbl: Filter untuk menangani iklan pada situs berita.
  • /addons/scriptlet-ublock.adbl: Filter umum untuk uBlock Resources.
  • /addons/shortlink.adbl: Filter untuk menangani iklan pada situs safelink / shortlink.
  • /plus: Folder untuk AdBlockID Plus.