Skip to content

Deployment tr

Hammad Maqbool edited this page Oct 29, 2026 · 1 revision

English · 简体中文 · 繁體中文 · Español · العربية · Français · Português (Brasil) · Deutsch · हिन्दी · 日本語 · 한국어 · Русский · Bahasa Indonesia · Türkçe · Italiano · Tiếng Việt

docxi'yi üretimde çalıştırma ve sürüm yayımlama

docxi bir servis değil, bir kütüphanedir; tek başına dağıtılacak bir şey yoktur. Bu sayfa, docxi kullanan bir uygulamayı yayına alırken nelere dikkat etmeniz gerektiğini ve docxi'nin yeni sürümlerinin nasıl yayımlandığını anlatır.

docxi kullanan bir uygulamayı yayına almak

  • Bağımlılıklar. bundle install, nokogiri ve rubyzip kurar. nokogiri, yaygın Linux, macOS ve Windows platformları için önceden derlenmiş gem'ler sunar. Diğer platformlarda, örneğin bazı minimal kapsayıcı imajlarında, kaynaktan derlenir ve bir C derleyicisi gerekir. nokogiri kurulum rehberine bakın.
  • Ofis yazılımı gerekmez. Sunucular ve kapsayıcılar Microsoft Word veya LibreOffice gerektirmez.
  • Bellek. render, belgenin tamamını bellekte oluşturur ve bir StringIO olarak döndürür. Bellek kullanımı sayfa sayısı ve görsellerin boyutu arttıkça artar.
  • Ağ ve dosyalar. docxi dosya sistemini yalnızca add_media için verdiğiniz görsel yolları için okur, ağı da yalnızca verdiğiniz görsel URL'leri için kullanır. Güvenlik sayfasına bakın.
  • Uzun belgeler. Bunları bir web isteği sırasında değil, bir arka plan işinde oluşturun. Entegrasyonlar sayfasına bakın.

docxi sürümleri nasıl yayımlanır

Bu adımlar projenin bakımını yapanlar içindir. Sürümler, GitHub Actions üzerinden güvenilir yayınlama (trusted publishing) ile RubyGems'e gönderilir; bu yüzden depoda hiçbir API anahtarı saklanmaz.

  1. lib/docxi/version.rb ve CHANGELOG.md dosyalarını güncelleyin ve master dalına birleştirin.
  2. Commit'i başına v eklenmiş sürümle etiketleyin, örneğin v0.1.1, ve etiketi push edin.
  3. .github/workflows/release.yml, gem'i derler ve RubyGems'e gönderir.

Ön sürümler de aynı adımları 0.2.0.rc1 gibi bir sürüm numarasıyla izler. Bundler ön sürümleri yalnızca açıkça istendiğinde kurar. CI (.github/workflows/ci.yml), master dalına yapılan her push'ta ve her pull request'te çalışır.

İlgili sayfalar


← Wiki ana sayfası · README

Clone this wiki locally