Skip to content

Contributing 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'ye katkıda bulunma

Hata bildirimleri, düzeltmeler, belgeler ve çeviriler memnuniyetle karşılanır. Bu sayfa, bir sorunun nasıl bildirileceğini ve bir pull request'in nelere ihtiyaç duyduğunu açıklar. Çalışma kopyası hazırlamak için Geliştirme ortamı sayfasına bakın.

Hata bildirme

github.com/hammad417/docxi/issues adresinde şunları içeren bir issue açın:

  • sorunu yeniden üreten kısa bir Ruby betiği
  • Ruby, docxi, nokogiri ve rubyzip sürümleri (kullanıyorsanız Rails sürümü de)
  • ne beklediğiniz ve ne elde ettiğiniz. Bozuk belgeler için onları hangi programda açtığınızı belirtin

Güvenlik sorunlarını bunun yerine gizli olarak bildirin. Güvenlik sayfasına bakın.

Pull request'ler

  1. Depoyu fork edin ve bir dal oluşturun.
  2. Değişikliği yapın ve çevresindeki kodun stiline uyun.
  3. Testleri ekleyin veya güncelleyin ve bundle exec rake test komutunu çalıştırın.
  4. Üretilen XML bilerek değişiyorsa bundle exec rake golden komutunu çalıştırın ve değişikliği pull request'te açıklayın. Golden dosyalar, mevcut kullanıcıların dayandığı çıktıyı korur.
  5. Davranış değişiyorsa CHANGELOG.md dosyasını ve belgeleri güncelleyin.
  6. Pull request'i açın. CI, testleri Ruby 2.5 ile 4.0 ve Rails 5.2 ile 8.1 arasında çalıştırır ve LibreOffice'in örnek belgeleri açabildiğini kontrol eder.

0.2.0 için planlanan düzeltmeler gibi mevcut belgeleri değiştiren değişiklikler, golden dosya farkının kolayca incelenebilmesi için ayrı bir pull request'te yer almalıdır.

Belgeler ve çeviriler

  • İngilizce README, docs/i18n/ içindeki 15 çevirinin kaynağıdır. Onu değiştirirken depodaki docs/i18n/TRANSLATION_GUIDE.md dosyasını izleyin.
  • Bu wiki, deponun wiki/ klasöründe yazılır ve oradan yayımlanır. Nasıl yapıldığını wiki/README.md açıklar.

İlgili sayfalar


← Wiki ana sayfası · README

Clone this wiki locally