BBCode ke HTML

BBCode ke HTML adalah alat gratis untuk mengubah cuplikan BBCode menjadi HTML mentah yang dapat digunakan di luar editor forum.

Masalah apa yang diselesaikan oleh konversi BBCode?

Konversi BBCode mengubah markup bergaya forum menjadi HTML yang dapat dipahami oleh browser, sistem manajemen konten, dan templat web. BBCode menggunakan tag dalam kurung siku seperti [b], [i], dan [url], bukan elemen HTML.

Konversi ini berguna saat memindahkan postingan dari forum, men-debug konten yang dikembalikan oleh API pihak ketiga, atau menyiapkan basis pengetahuan lama untuk platform yang menerima HTML tetapi tidak mendukung BBCode. Proses ini juga dapat membantu sebelum penerapan, ketika teks hasil impor perlu diperiksa secara terpisah dari kode aplikasi di sekitarnya.

BBCode bukan bahasa yang memiliki satu standar resmi. Perangkat lunak forum dan plug-in dapat menentukan tag, atribut, serta aturan penyarangannya sendiri. Karena itu, konversi yang berfungsi untuk pemformatan umum mungkin perlu disesuaikan jika sumber berisi konstruksi khusus platform, seperti kotak spoiler, referensi lampiran, atau tag media khusus.

Bagaimana cara mengubah BBCode menjadi HTML?

Masukkan atau tempel markup sumber ke kolom BBCode, lalu lihat kode hasil konversi di kolom HTML. Salin HTML tersebut ke tujuan hanya setelah memastikan elemen dan tautannya sesuai dengan konten yang diinginkan.

1. Salin cuplikan BBCode secara lengkap, termasuk tag pembuka dan penutup.
2. Masukkan ke kolom BBCode tanpa mengganti kurung siku.
3. Periksa hasil mentah di kolom HTML.
4. Bandingkan tautan, gambar, daftar, dan pemformatan bersarang dengan postingan asli.
5. Sanitasi hasil yang tidak tepercaya sebelum merendernya di halaman publik.

Konversi dijalankan di server. Input dikirim ke server melalui HTTPS dan tidak disimpan.

Bagaimana cara membaca HTML yang dihasilkan?

Baca hasilnya sebagai kode sumber, bukan sebagai pratinjau visual. HTML yang dikembalikan seharusnya berisi elemen yang mewakili struktur dan pemformatan dalam BBCode sumber.

Berikut contoh konseptual sederhana:

Input BBCode: [b]Release note[/b]

Output HTML: elemen HTML tebal atau strong yang berisi teks "Release note".

Pola umum lainnya adalah:

Input BBCode: [url=https://example.org/docs]Read the docs[/url]

Output HTML: elemen anchor dengan tujuan https://example.org/docs dan teks yang terlihat "Read the docs".

Nama elemen yang tepat dapat berbeda antara satu konverter dan lainnya karena dialek BBCode tidak distandardisasi. Misalnya, teks tebal dapat diwakili oleh elemen b, yang menarik perhatian tanpa menyampaikan tingkat kepentingan tambahan, atau elemen strong, yang menunjukkan penekanan penting. Periksa nilai sebenarnya di kolom HTML dan jangan mengasumsikan pemetaan tertentu.

Alat ini merupakan konverter, bukan pengganti validator HTML atau alat sanitasi keamanan. BBCode yang tetap muncul sebagai teks literal, konten yang hilang, atau elemen dengan penyarangan janggal dapat menandakan bahwa sumber berisi sintaks yang salah atau tidak didukung. Masalah umum pada sumber meliputi tag yang tidak ditutup, tag penutup dengan urutan keliru, atribut yang salah, serta tag khusus forum yang tidak memiliki padanan HTML umum.

Input yang rumit dan perbedaan dialek

Spasi, tanda baca, angka, huruf beraksen, dan tulisan non-Latin merupakan teks biasa, kecuali jika muncul di dalam sintaks tag atau atribut. Semua itu seharusnya tetap menjadi konten, bukan berubah menjadi markup terpisah. URL perlu ditangani dengan lebih hati-hati. Karakter yang menjadi bagian dari URL, seperti spasi, mungkin perlu dikodekan dengan percent-encoding, sedangkan karakter yang memiliki arti khusus dalam sintaks atribut HTML di sekitarnya, seperti ampersand dan tanda kutip, mungkin perlu di-escape dalam HTML.

• Penyarangan salah: [b][i]Text[/b][/i] menutup tag dalam urutan yang keliru. Markup dengan penyarangan yang benar menutup tag terdalam terlebih dahulu.
• Tag penutup hilang: [quote]Text tidak memiliki pasangan penutup jika tag terakhir tidak dicantumkan.
• Tag khusus: [spoiler], [video], dan tag lampiran dapat memiliki arti berbeda pada setiap perangkat lunak forum.
• HTML yang sudah ada: HTML yang dicampurkan ke dalam BBCode dapat di-escape, dipertahankan, atau diperlakukan sebagai teks, tergantung parsernya. Periksa dengan cermat dan jangan mengandalkan satu aturan yang dianggap berlaku untuk semuanya.
• Input sangat panjang: migrasi besar biasanya lebih mudah diproses secara bertahap agar data yang gagal dapat ditemukan dan diperbaiki.

Input kosong tidak memiliki struktur pemformatan yang dapat dikonversi. Jika sumber hanya berupa teks biasa tanpa tag BBCode, konversi mungkin tidak banyak memberi manfaat. Namun, pemrosesan HTML berikutnya mungkin tetap perlu meng-escape karakter seperti <, >, dan &.

Kapan BBCode tidak perlu dikonversi?

Konversi tidak diperlukan jika konten hanya akan dibaca oleh sistem yang sudah memahami dialek BBCode aslinya. Mengubah format menambahkan tahap transformasi lain dan dapat menghilangkan perilaku khusus forum.

Konversi juga tidak diperlukan jika sistem menyimpan BBCode tanpa perubahan untuk dirender kemudian oleh mesin forum yang sama. Demikian pula, merapikan atau mengatur ulang HTML hasil konversi secara manual tidak banyak bermanfaat jika hanya akan dibaca oleh sistem, kecuali pemformatan tersebut diperlukan untuk peninjauan dalam kontrol versi atau proses debugging.

Untuk migrasi massal, parser berbasis skrip mungkin lebih sesuai karena dapat menerapkan aturan dialek yang sama pada setiap data dan mencatat kegagalan. Mengandalkan ekspresi reguler saja berisiko untuk markup bersarang. Gunakan parser yang memahami penyarangan, atribut, dan input yang salah, lalu validasi dan sanitasi HTML hasilnya secara terpisah. Jika konten hasil konversi memuat konfigurasi JSON tersemat, Validator & pemercantik JSON dapat membantu memeriksa data tersebut, tetapi tidak memvalidasi HTML di sekitarnya.

Pertanyaan umum

Apakah BBCode yang sudah dikonversi aman untuk langsung dipublikasikan?

Tidak. HTML yang dihasilkan dari postingan forum yang tidak tepercaya harus diproses dengan alat sanitasi HTML berbasis daftar izin sebelum dirender. Langkah ini sangat penting untuk tautan, gambar, media tersemat, dan sumber apa pun yang mungkin sudah berisi teks menyerupai HTML.

Apakah pergantian baris akan diubah menjadi paragraf HTML?

Penanganan pergantian baris bergantung pada parser BBCode dan aturan platform sumber. Beberapa sistem memperlakukan baris kosong sebagai paragraf, sedangkan sistem lain menyisipkan elemen pergantian baris atau mempertahankan spasi kosong biasa. Bandingkan sampel multibaris dengan tampilan aslinya di forum sebelum memigrasikan kumpulan konten dalam jumlah besar.

Apakah BBCode mendukung karakter Unicode?

BBCode dapat memuat teks Unicode, termasuk karakter beraksen, emoji, dan aksara non-Latin, karena karakter tersebut merupakan konten, bukan sintaks tag. Halaman tujuan juga harus menggunakan pengodean karakter yang sesuai, biasanya UTF-8. Jika tidak, teks mungkin ditampilkan secara keliru setelah dikonversi.

Bisakah BBCode dalam ekspor CSV atau basis data dikonversi?

Konversikan nilai setiap kolom, bukan seluruh berkas ekspor. Tanda kutip CSV, pemisah, dan urutan escape basis data merupakan bagian dari format wadah dan dapat rusak jika diproses oleh konverter markup. Simpan cadangan tanpa perubahan dan uji pada sejumlah kecil data sebelum menerapkan konversi ke setiap baris.

Apa yang perlu diperiksa sebelum mengimpor HTML?

Periksa sampel yang berisi pemformatan bersarang, tautan, daftar, referensi gambar, dan tag khusus yang digunakan oleh forum sumber. Pastikan tujuan menerima elemen dan atribut HTML tersebut, lalu jalankan langkah sanitasi atau validasi yang diwajibkan sebelum melakukan impor penuh.