Sanitize

Berdasarkan parser Nokogiri HTML untuk Ruby, membersihkan adalah sistem berbasis whitelist untuk menghapus HTML dari sebuah blok teks.
The "putih" teknik akan memungkinkan para pengembang untuk setup daftar tag HTML yang membersihkan akan digunakan sebagai referensi untuk apa yang dianggap "diterima" HTML.
Setiap tag HTML lainnya tidak ada dalam daftar akan dihapus dari teks diurai.
Sanitasi dapat bekerja dengan standar-compliant atau dengan HTML cacat.
Perpustakaan dapat mendeteksi dan menyaring tag HTML, atribut dan protokol.
Teks dibersihkan akan selalu dikeluarkan sebagai HTML atau XHTML yang valid.
Untuk membantu pengembang memulai proyek-proyek mereka, membersihkan dilengkapi dengan beberapa konfigurasi siap pakai disertakan. Memeriksa file README untuk lebih jelasnya

Apa yang baru dalam rilis ini:.

• Ditambahkan dua pengaturan CSS konfigurasi baru,: at_rules_with_properties dan:. at_rules_with_styles
• Ditambahkan dukungan penuh untuk aturan CSS @ Page di config santai, termasuk dukungan untuk semua aturan kotak halaman-marjin.
• Ditambahkan CSS berikut di-aturan untuk konfigurasi santai.
• Ditambahkan sejumlah properti CSS untuk konfigurasi santai. Lihat daftar lengkap di sini.
• perbaikan kinerja Kecil
.
• Upgrade Crass untuk 1.0.2 untuk mengambil memperbaiki yang mempengaruhi parsing aturan CSS @ Page.

Apa yang baru di versi 3.1.2:

• Fixed: #document dan #fragment gagal pada beku string, dan tidak sengaja bisa memodifikasi string dicairkan jika mereka menggunakan pengkodean selain UTF-8 atau jika mereka mengandung karakter yang tidak diperbolehkan dalam HTML.

Apa yang baru di versi 3.0.2:

• Diperbarui Nokogumbo ke 1.1.12, karena 1.1. 11 diam-diam dikembalikan perubahan kami mencoba untuk mengambil dalam rilis terakhir.

Apa yang baru di versi 3.0.0:

• Ditambahkan canggih CSS sanitasi dukungan menggunakan Crass, yang sepenuhnya kompatibel dengan CSS Syntax Modul Level 3 parsing spec. Isi daftar putih & # x3c; gaya & # x3e; elemen dan gaya atribut dalam HTML akan dibersihkan sebagai CSS, atau Anda dapat menggunakan membersihkan :: CSS kelas untuk secara manual membersihkan stylesheet CSS atau properti.
• Ditambahkan: pengaturan allow_doctype. Ketika benar, baik-membentuk definisi DOCTYPE akan diizinkan dalam dokumen. Ketika palsu (default), definisi DOCTYPE akan dihapus dari dokumen. Definisi DOCTYPE tidak pernah diperbolehkan dalam fragmen, terlepas dari pengaturan ini.
• Ditambahkan unsur-unsur berikut untuk konfigurasi santai, selain berbagai atribut:. Artikel, samping, tubuh, data, div, footer, kepala, header, html, utama, nav, section, span, gaya, judul
• : whitespace_elements config sekarang Hash, dan memungkinkan Anda untuk menentukan teks yang harus dimasukkan sebelum dan sesudah elemen ini ketika mereka dihapus. Gaya lama nilai config berbasis Array masih didukung untuk kompatibilitas mundur.
• Tidak Layak karakter Unicode sekarang dihapus dari HTML sebelum itu diurai.
• Tetap:
• kurung Non-tag input seperti & quot; 1 & # x3e; 2 dan 2 & # x3c; 1 & quot; sekarang diurai dan melarikan diri dengan benar sesuai dengan spesifikasi HTML5, menjadi & quot; 1 & gt; 2 dan 2 & lt; 1 & quot;.
• Saudara ditambahkan setelah node saat ini selama traversal sekarang juga dilalui. Dalam versi sebelumnya mereka hanya dilewati.
• Nokogiri telah memukul dan diperintahkan untuk berhenti menambahkan baris baru setelah unsur-unsur tertentu, karena jika orang ingin baris di sana mereka akan telah menempatkan mereka di sana, sialan.

Apa yang baru di versi 2.0.6:

• Versi 2.0.5 secara tidak sengaja disertakan beberapa pekerjaan-di perubahan -progress yang seharusnya tidak membuat jalan mereka ke dalam cabang master.

Apa yang baru di versi 1.2.1:

• Ditambahkan: remove_contents pengaturan konfigurasi. Jika diatur ke benar, membersihkan akan menghapus isi semua elemen non-masuk daftar putih di samping unsur-unsur itu sendiri. Jika diatur ke Array nama elemen, membersihkan akan menghapus isi hanya unsur-unsur (ketika disaring), dan meninggalkan isi elemen disaring lainnya. [Terima kasih kepada Rafael Souza untuk opsi Array]
• Ditambahkan: output_encoding config pengaturan untuk memungkinkan pengkodean karakter untuk output HTML yang akan ditentukan. Standarnya adalah 'utf-8'
.
• hash lingkungan disahkan menjadi transformator sekarang termasuk: barang node_name berisi nama huruf kecil dari node HTML saat ini (misalnya & quot; div & quot;)
.
• Kembali apa-apa selain Hash atau nihil dari trafo sekarang akan menaikkan bermakna membersihkan :: Kesalahan pengecualian daripada NameError tidak diinginkan.

Persyaratan :

• Ruby 1.9.2 atau lebih tinggi
• Nokogiri 1.4.4 atau lebih tinggi