Oynatıcı Bileşenleri¶

Gerekli Yapılandırma

Markdown dosyalarınızda oynatıcı bileşenlerini kullanmak için, belgenizin başına aşağıdaki YAML ön maddesini mutlaka eklemelisiniz:

---
extra_javascript:
  - assets/javascripts/asciinema-player.js
  - assets/javascripts/youtube-player.js
---

Bu yapılandırma olmadan oynatıcılar düzgün render edilmez.

Asciinema Player¶

Basit Embed¶

Not: Oynatıcı, cast dosyası mevcut olduğunda terminal kaydını yükleyecektir.

Başlıklı Tam Konteyner¶

Phantom Kurulum Süreci

Kurulum Demosu

Mevcut Seçenekler¶

Seçenek	Açıklama	Değerler
`data-cols`	Terminal sütunları	Varsayılan: 100
`data-rows`	Terminal satırları	Varsayılan: 30
`data-autoplay`	Yüklemede otomatik oynat	`true` / `false`
`data-loop`	Döngü oynatım	`true` / `false`
`data-speed`	Oynatım hızı	`0.5` - `3.0`
`data-theme`	Renk teması	`solarized-dark`, `solarized-light`, `monokai`, vb.
`data-font-size`	Yazı tipi boyutu	`small`, `medium`, `large`

YouTube Oynatıcı¶

Basit Embed¶

Not: VIDEO_ID_HERE yerine gerçek YouTube video ID'nizi yazın.

Başlıklı Tam Kapsayıcı¶

Phantom E2E Eğitimi

Başlangıç Kılavuzu

Mevcut Seçenekler¶

Seçenek	Açıklama	Değerler
`data-video-id`	YouTube video ID'si	Gerekli
`data-autoplay`	Videoyu otomatik oynat	`true` / `false`
`data-controls`	Oynatıcı kontrollerini göster	`true` / `false`
`data-loop`	Videoyu döngüye al	`true` / `false`
`data-mute`	Varsayılan olarak sessize al	`true` / `false`
`data-rel`	İlgili videoları göster	`true` / `false`
`data-modestbranding`	Minimal YouTube markalaması	`true` / `false`

Oynatıcılar için Yükleme Durumları¶

Oynatıcılar yüklenirken bir spinner görüntülenir:

CSS Animasyonu: Spinner CSS animasyonları kullanarak otomatik olarak döner. Boyut ve rengi CSS değişkenleri aracılığıyla özelleştirebilirsiniz.

En İyi Uygulamalar¶

Dosya Boyutu: Hızlı yükleme için Asciinema kayıtlarını 1MB altında tutun
Boş Zaman: Kayıtlardaki uzun duraklamaları atlamak için data-speed kullanın
Temalar: Dokümantasyon stilinizle uyumlu temalar seçin
Yedekler: Erişilebilirlik için metin alternatifleri sağlayın
Barındırma: Daha iyi performans için .cast dosyalarını yerel olarak barındırın

Terminal Oturumlarını Kaydetme¶

Kendi Asciinema kayıtlarınızı oluşturmak için:

# asciinema kur
pip install asciinema

# Kayıt başlat
asciinema rec demo.cast

# Belirli ayarlarla kayıt et
asciinema rec -i 2 -t "Demo Başlığı" demo.cast

# Yerel olarak oynat
asciinema play demo.cast

YouTube Entegrasyon İpuçları¶

Gizlilik: İlgisiz videoları göstermemek için data-rel="false" kullanın
Markalama: Daha temiz görünüm için data-modestbranding="true" kullanın
Otomatik Oynatım: Daha iyi kullanıcı deneyimi için otomatik oynatımdan kaçının
Sessize Alma: Otomatik oynatım gerekliyse sessize almayı düşünün
Tepkisel (Responsive): Oynatıcılar otomatik olarak kapsayıcı genişliğine ölçeklenir