Getting Started tr

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

docxi ile başlarken: Ruby ile ilk Word belgeniz

Bu rehber sizi boş bir klasörden biçimlendirilmiş bir .docx dosyasına kadar götürür. Temel Ruby bilgisine sahip olduğunuz varsayılır. Rails veya Microsoft Word gerekmez.

1. Gem'i kurun

gem install docxi

Gemfile kullanan bir projedeyseniz bunun yerine gem "docxi", "~> 0.1" satırını ekleyip bundle install komutunu çalıştırın. Ayrıntılar Kurulum sayfasındadır.

2. Bir belge oluşturun

Şunu hello.rb adıyla kaydedin:

require "docxi"

word = Docxi::Document.new
document = word.document

document.p(align: "center") do |p|
  p.text "Hello, Word", size: 24, bold: true
end

File.binwrite("hello.docx", word.render.string)

ruby hello.rb komutunu (Bundler projesinde bundle exec ruby hello.rb) çalıştırın ve hello.docx dosyasını açın.

3. Her satır ne yapar

• Docxi::Document.new, varsayılan sayfa kenar boşluklarıyla boş bir belge oluşturur.
• word.document, belgenin gövdesidir. Eklediğiniz her şey bunun üzerinden geçer.
• document.p bir paragraf ekler. p için verilen seçenekler, örneğin align:, hem paragrafa hem de içindeki metne uygulanır.
• p.text bir metin parçası (run) ekler. size: punto cinsindendir.
• word.render, .docx paketini oluşturur ve bir StringIO döndürür. Bunun .string değeri dosyanın baytlarını içerir.

4. Bir liste ve bir tablo ekleyin

require "docxi"

word = Docxi::Document.new
document = word.document

document.p { |p| p.text "Quarterly summary", size: 16, bold: true }

document.p do |p|
  p.text "Revenue grew ", space: true
  p.text "12%", bold: true, color: "007A33"
  p.text " compared with last quarter.", space: true
end

document.p(ul: true) { |p| p.text "New customers: 48" }
document.p(ul: true) { |p| p.text "Customers lost: 3" }

document.table(columns_width: [200, 100]) do |table|
  table.tr(fill: "D9D9D9", bold: true) do |tr|
    tr.tc { |tc| tc.text "Region" }
    tr.tc { |tc| tc.text "Sales" }
  end
  table.tr do |tr|
    tr.tc { |tc| tc.text "North" }
    tr.tc { |tc| tc.text "$41,000", align: "right" }
  end
end

File.binwrite("summary.docx", word.render.string)

Dikkat edilecek iki nokta var:

• space: true, bir metin parçasının başındaki veya sonundaki boşluğu korur. Bu seçenek olmadan Word boşluğu siler ve kelimeler birbirine yapışır.
• tr üzerindeki seçenekler o satırdaki her hücreye uygulanır; bu yüzden başlık satırının tamamı gölgelendirilir ve kalın olur.

5. Sırada ne var

• Kullanım örnekleri: raporlar, faturalar ve mektuplar için eksiksiz tarifler
• Özellikler: paragraflar, metin, tablolar, görseller, üstbilgi ve altbilgiler için tüm seçenekler
• Entegrasyonlar: belgeyi bir Rails controller'ından göndermek
• En iyi uygulamalar: yaygın sürprizleri baştan önlemek

---

← Wiki ana sayfası · README