BBCode'dan HTML'ye

BBCode'dan HTML'ye, forum editörleri dışında kullanılmak üzere BBCode parçalarını ham HTML'ye dönüştüren ücretsiz bir araçtır.

BBCode dönüştürme ne işe yarar?

BBCode dönüştürme, forumlarda kullanılan işaretlemeyi tarayıcıların, içerik yönetim sistemlerinin ve web şablonlarının yorumlayabileceği HTML'ye çevirir. BBCode, HTML öğeleri yerine [b], [i] ve [url] gibi köşeli parantezli etiketler kullanır.

Bu işlem, forum gönderilerini başka bir platforma taşırken, üçüncü taraf bir API'nin döndürdüğü içerikte hata ayıklarken veya eski bir bilgi tabanını BBCode değil HTML kabul eden bir platforma hazırlarken işe yarar. Ayrıca içe aktarılan metnin, yayına alınmadan önce çevresindeki uygulama kodundan ayrı olarak kontrol edilmesine yardımcı olabilir.

BBCode, resmî olarak standartlaştırılmış tek bir dil değildir. Forum yazılımları ve eklentiler kendi etiketlerini, niteliklerini ve iç içe yerleştirme kurallarını tanımlayabilir. Bu nedenle yaygın biçimlendirmelerde çalışan bir dönüşümün, kaynakta spoiler kutuları, ek dosya referansları veya özel medya etiketleri gibi platforma özgü yapılar bulunduğunda uyarlanması gerekebilir.

BBCode'u HTML'ye nasıl dönüştürürüm?

Kaynak işaretlemeyi BBCode alanına yaz veya yapıştır, ardından dönüştürülen kodu HTML alanında incele. Öğelerin ve bağlantıların amaçlanan içerikle eşleştiğini doğrulamadan bu HTML'yi hedefe kopyalama.

1. Açılış ve kapanış etiketleri dâhil olmak üzere BBCode parçasının tamamını kopyala.
2. Köşeli parantezleri değiştirmeden BBCode alanına yerleştir.
3. Ham sonucu HTML alanında incele.
4. Bağlantıları, görselleri, listeleri ve iç içe biçimlendirmeyi özgün gönderiyle karşılaştır.
5. Güvenilmeyen çıktıyı herkese açık bir sayfada görüntülemeden önce güvenli hâle getir.

Dönüştürme işlemi sunucuda çalışır. Girdiğin içerik HTTPS üzerinden sunucuya gönderilir ve saklanmaz.

Döndürülen HTML'yi nasıl okumalıyım?

Sonucu görsel bir önizleme olarak değil, kaynak kod olarak oku. Döndürülen HTML, kaynak BBCode'da belirtilen yapıyı ve biçimlendirmeyi temsil eden öğeler içermelidir.

Basit bir kavramsal örnek:

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

HTML çıktısı: "Release note" metnini içeren kalın veya güçlü vurgu belirten bir HTML öğesi.

Yaygın bir başka kullanım:

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

HTML çıktısı: hedefi https://example.org/docs, görünen metni ise "Read the docs" olan bir bağlantı öğesi.

BBCode lehçeleri standartlaştırılmadığı için kullanılan öğelerin tam adları dönüştürücüye göre değişebilir. Örneğin kalın metin, ek bir önem anlamı taşımadan dikkat çeken bir b öğesiyle veya yüksek önem belirten bir strong öğesiyle temsil edilebilir. Belirli bir eşleme kullanıldığını varsaymak yerine HTML alanındaki gerçek değeri kontrol et.

Bu araç bir dönüştürücüdür, HTML doğrulayıcısının veya güvenlik amaçlı HTML temizleyicisinin yerini tutmaz. Dönüşmeden kalan beklenmedik BBCode ifadeleri, eksik içerik veya hatalı biçimde iç içe geçmiş öğeler, kaynakta bozuk ya da desteklenmeyen söz dizimi bulunduğuna işaret eder. Yaygın kaynak sorunları arasında kapatılmamış etiketler, yanlış sıradaki kapanış etiketleri, hatalı nitelikler ve genel bir HTML karşılığı bulunmayan foruma özgü etiketler yer alır.

Sorunlu girdiler ve lehçe farklılıkları

Boşluklar, noktalama işaretleri, sayılar, aksanlı harfler ve Latin alfabesi dışındaki yazılar, etiket söz diziminin veya niteliklerin içinde yer almadıkları sürece normal metindir. Ayrı bir işaretlemeye dönüşmek yerine içeriğin parçası olarak kalmalıdırlar. URL'ler daha fazla dikkat gerektirir. URL'nin parçası olan boşluk gibi karakterlerin yüzde kodlamasıyla yazılması gerekebilir. Çevresindeki HTML niteliği söz diziminde özel anlam taşıyan ve işareti ile tırnak işareti gibi karakterlerin ise HTML kaçış dizileriyle belirtilmesi gerekebilir.

• Hatalı iç içe yerleştirme: [b][i]Text[/b][/i] etiketleri yanlış sırada kapatır. Doğru yerleştirilmiş işaretlemede önce içteki etiket kapatılır.
• Eksik kapanış etiketleri: Son etiket atlandığında [quote]Text ifadesinin eşleşen bir kapanış etiketi olmaz.
• Özel etiketler: [spoiler], [video] ve ek dosya etiketleri farklı forum yazılımlarında farklı anlamlara gelebilir.
• Mevcut HTML: BBCode'a karıştırılmış HTML, ayrıştırıcıya bağlı olarak kaçış dizileriyle yazılabilir, korunabilir veya metin olarak değerlendirilebilir. Her yerde geçerli tek bir kurala güvenmek yerine sonucu dikkatle incele.
• Çok uzun girdi: Büyük taşıma işlemlerini gruplar hâlinde gerçekleştirmek genellikle daha kolaydır. Böylece başarısız kayıtlar belirlenip düzeltilebilir.

Boş girdide dönüştürülecek bir biçimlendirme yapısı yoktur. Kaynak, BBCode etiketi içermeyen düz metinden oluşuyorsa dönüştürme pek fayda sağlamayabilir. Yine de sonraki HTML işleme aşamasında <, > ve & gibi karakterlerin kaçış dizileriyle yazılması gerekebilir.

Hangi durumlarda dönüştürmeye gerek yoktur?

İçeriği yalnızca özgün BBCode lehçesini zaten anlayan bir sistem okuyacaksa dönüştürmeye gerek yoktur. Biçimi değiştirmek sürece ek bir dönüşüm aşaması ekler ve foruma özgü davranışların kaybolmasına yol açabilir.

Bir sistem BBCode'u daha sonra aynı forum motoruyla görüntülemek üzere değiştirmeden saklıyorsa dönüşüm yine gereksizdir. Benzer şekilde, oluşturulan HTML'yi yalnızca bir sistem okuyacaksa kodu güzelleştirmek veya elle yeniden düzenlemek pek fayda sağlamaz. Ancak sürüm kontrolü incelemeleri ya da hata ayıklama için biçimlendirme gerekiyorsa bunu yapmak yararlı olabilir.

Toplu taşıma işlemlerinde, aynı lehçe kurallarını her kayda uygulayabildiği ve hataları kaydedebildiği için betikle çalışan bir ayrıştırıcı daha uygun olabilir. İç içe geçmiş işaretlemelerde yalnızca düzenli ifadeleri kullanmak risklidir. İç içe yerleştirmeyi, nitelikleri ve bozuk girdileri anlayan bir ayrıştırıcı kullan, ardından ortaya çıkan HTML'yi ayrıca doğrula ve güvenli hâle getir. Dönüştürülen içerikte gömülü JSON yapılandırması varsa JSON doğrulayıcı & güzelleştirici bu veriyi incelemeye yardımcı olabilir, ancak çevresindeki HTML'yi doğrulamaz.

Sık sorulan sorular

Dönüştürülen BBCode'u doğrudan yayımlamak güvenli mi?

Hayır. Güvenilmeyen forum gönderilerinden üretilen HTML, görüntülenmeden önce izin verilenler listesine göre çalışan bir HTML temizleyicisinden geçirilmelidir. Bu özellikle bağlantılar, görseller, gömülü medya ve önceden HTML benzeri metinler içerebilecek kaynaklar için önemlidir.

Satır sonları HTML paragraflarına dönüşür mü?

Satır sonlarının nasıl işlendiği, BBCode ayrıştırıcısına ve kaynak platformun kurallarına bağlıdır. Bazı sistemler boş satırları paragraf olarak değerlendirirken bazıları satır sonu öğeleri ekler veya düz metindeki boşlukları korur. Büyük bir içerik koleksiyonunu taşımadan önce çok satırlı bir örneği özgün forumdaki görünümüyle karşılaştır.

BBCode Unicode karakterleri destekler mi?

BBCode; aksanlı karakterler, emoji ve Latin alfabesi dışındaki yazılar dâhil olmak üzere Unicode metin içerebilir. Bunun nedeni, bu karakterlerin etiket söz dizimi değil içerik olmasıdır. Hedef sayfa da uygun bir karakter kodlaması, normalde UTF-8, kullanmalıdır. Aksi takdirde metin dönüştürüldükten sonra hatalı görüntülenebilir.

CSV veya veritabanı dışa aktarımındaki BBCode'u dönüştürebilir miyim?

Dışa aktarma dosyasının tamamı yerine alan değerlerini dönüştür. CSV tırnakları, ayırıcılar ve veritabanı kaçış dizileri kapsayıcı biçime aittir ve bir işaretleme dönüştürücüsünden geçirildiklerinde bozulabilir. Değiştirilmemiş bir yedek tut ve dönüşümü her satıra uygulamadan önce küçük bir grup üzerinde dene.

HTML'yi içe aktarmadan önce neleri kontrol etmeliyim?

İç içe biçimlendirme, bir bağlantı, bir liste, bir görsel referansı ve kaynak forumda kullanılan özel etiketleri içeren bir örneği kontrol et. Hedefin bu HTML öğelerini ve niteliklerini kabul ettiğini doğrula, ardından tam içe aktarma işleminden önce hedef platformun zorunlu güvenli hâle getirme veya doğrulama adımını çalıştır.