Code ve HTML blokları

Amaç: Bir kod örneği sunmak ve bir sayfayı bozabilecek tek bloğu anlamak.
Süre: 3 dakika
Gerekenler: Bir sayfa ve gösterecek bir şey

Adımlar

  1. Add Block seçin, ardından Code seçin.
  2. Title alanını doldurun ve örneğin üzerindeki küçük etiket için Filename / Language Label kullanın — dosya adı, dil adından daha iyi okunur.
  3. Örneği Code alanına yapıştırın ve Syntax Language ayarlayın.
  4. Save New Block seçin.
  5. Hiçbir bloğun ifade edemediği işaretleme için Add Block seçin ve HTML (Trusted) seçin.
  6. İşaretlemenizi Trusted HTML alanına yapıştırın ve Save New Block seçin.
Code block form showing the title, filename label, code sample, and syntax language.
Trusted HTML block form containing an embed snippet.
Public page showing a syntax-highlighted code sample with a filename label.

HTML bloğunu kullanmadan önce bunu okuyun

Bu bloğun adı HTML (Trusted), çünkü CMS o noktada kontrol etmeyi bırakır. Yapıştırdığınız şey neyse render edilen odur.

Bu şu demek: kapatılmamış tek bir etiket bütün sayfanın yerleşimini bozabilir, yapıştırılan izleme kodu her ziyarette çalışır ve denetlemediğiniz bir siteden gelen gömülü içerik daha sonra size sunduğunu değiştirebilir. Bunların hiçbiri site tasarımı değiştiğinde uyum sağlamaz.

Ona uzanmadan önce şunları kontrol edin: bunun için gerçek bir blok var mı (video, ses, indirme, galeri, tablo ve iletişim formu hepsi mevcut)? Gömülü içeriğin sağlayıcısı, bir yıl sonra da işaretlemenizde görmekten rahatsız olmayacağınız biri mi? Bir geliştirici bunun yerine düzgün bir blok tipi eklemeyi tercih eder mi? Üçünün de yanıtı hayırsa kullanın ve parçayı olabildiğince küçük tutun.

Notlar

  • Code, bir okuyucuya kod göstermek içindir. Hiçbir şeyi çalıştırmaz ve dokümantasyondaki her parça için doğru bloktur.
  • Syntax Language yalnızca vurgulamayı etkiler. Boş bırakmak örneği düz metin olarak render eder.
  • Dosya adı etiketi serbest metindir: publish.sh, composer.json veya Terminal, hepsi olur.
  • Uzun örnekler satır kaydırmak yerine yatay kayar; bu yüzden kendinizinkini önemli satırlara indirin.
Sıradaki: Medya kitaplığına dosya yükleyin