Go için Güçlü Açık Kaynaklı Kelime İşleme Kütüphanesi

wordZero ile Başlarken

wordZero'ı projenize kurmanın önerilen yolu GitHub kullanmaktır. Sorunsuz bir kurulum için lütfen aşağıdaki komutu kullanın.

go get github.com/zerx-lab/wordZero

Go API aracılığıyla Word Belgeleri Oluşturun ve Kaydedin

wordZero'un temel yeteneklerinden biri, sıfırdan Word belgeleri oluşturma yeteneğidir. Geliştiriciler yeni bir belge başlatabilir, içerik ekleyebilir ve birkaç satır kodla bunu DOCX dosyası olarak kaydedebilir. Bu özellik, otomatik raporlama sistemleri, belge oluşturma hizmetleri ve kullanıcı verilerini Microsoft Word formatına aktarması gereken uygulamalar için son derece faydalıdır. Kütüphane OOXML paketlemesini dahili olarak yönettiği için, geliştiriciler karmaşık belge yapılarıyla uğraşmak yerine içerik oluşturma üzerine odaklanabilir.

package main

import  ( 
	"github.com/ZeroHawkeye/wordZero/pkg/document" 
)

func main() { 
	doc := document.New() 
	
	doc.AddParagraph("Welcome to wordZero!") 
	
	err := doc.Save("sample.docx")
	 if err != nil {
	 panic(err) 
	}
  }
 

Kalıtımlı Gelişmiş Şablon Motoru

WordZero'un şablon motoru, dinamik belgeler oluşturma şeklinizi dönüştürür. Temel metin değiştirme yerine, blok tabanlı kalıtım, koşullu renderleme, döngüler ve resim yer tutucularını destekler. Bu, temel şablonlar (başlıklar, altbilgiler, marka yönergeleri) oluşturabileceğiniz ve bunları satış raporları veya faturalar gibi belirli kullanım durumları için genişletebileceğiniz anlamına gelir. Kod tekrarını ortadan kaldırması ve içeriği sunumdan ayırması çok faydalıdır. Pazarlama ekipleri, geliştirici müdahalesi olmadan şablonları güncelleyebilir.

package main

import (
    "log"
    "github.com/zerx-lab/wordZero/pkg/document"
)

func main() {
    engine := document.NewTemplateEngine()
    
    // Base template with reusable blocks
    baseTemplate := `{{companyName}} Report
{{#block "summary"}}Default summary{{/block}}
{{#block "content"}}Default content{{/block}}`
    
    engine.LoadTemplate("base", baseTemplate)
    
    // Child template overriding specific blocks
    salesTemplate := `{{extends "base"}}
{{#block "summary"}}
Sales: {{revenue}} USD | Growth: {{growth}}%
{{/block}}`
    
    engine.LoadTemplate("sales", salesTemplate)
    
    data := document.NewTemplateData()
    data.SetVariable("companyName", "Acme Corp")
    data.SetVariable("revenue", "125000")
    data.SetVariable("growth", "15")
    
    doc, _ := engine.RenderTemplateToDocument("sales", data)
    doc.Save("quarterly_report.docx")
}
 

Dinamik Yerel Görüntü Yönetimi ve Otomatik Ölçeklendirme

Grafikler, kurumsal kimlik öğeleri veya fotoğraflar gibi varlıkların entegrasyonu, metin kaydırmalarını bozmamak için sıkı bir düzen yönetimi gerektirir. Açık kaynaklı wordZero kütüphanesi, görüntü girişlerini doğrudan fiziksel sistem yollarından veya bellek içi bayt dizilerinden ([]byte) kabul eden basit yerel sarmalayıcılar sunar. Kütüphane, en boy oranlarını otomatik olarak algılar ve görüntüleri kenarlara otomatik sığdırma veya belirli piksel kısıtlamaları gibi işlevleri etkinleştirir.

package main

import (
	"log"
	"github.com/zerx-lab/wordZero/pkg/document"
)

func main() {
	doc := document.New()
	doc.AddParagraph("Visual Asset Documentation Summary")

	// Insert an image path from your local deployment setup
	image, err := doc.AddImageFromFile("company_logo.png")
	if err != nil {
		log.Fatalf("Unable to discover or parse local asset: %v", err)
	}

	// Constrain the target image properties while auto-fitting column margins safely
	image.SetWidth(350)
	image.FitToPageWidth()

	if err := doc.Save("image_report.docx"); err != nil {
		log.Fatalf("Error saving file payload: %v", err)
	}
}

Ruby Kütüphanesi ile Markdown'tan Word'e Doğrudan Dönüşümler?

Dağıtık yayınlama hatlarında, içerik yazmak için genellikle Markdown tercih edilirken, kurumsal dağıtım için Word gereklidir. wordZero bu ihtiyaca, özel, yerleşik çift dönüşüm modülüyle yanıt verir. Standart başlıkları, satır içi parametreleri (kalın, italik, kod etiketleri), listeleri ve bağlantıları doğrudan temel Markdown kaynak bloklarından ayrıştırarak, bunları profesyonel OOXML belge ağaçlarına temiz bir şekilde dönüştürür.

package main

import (
	"log"
	"github.com/zerx-lab/wordZero/pkg/markdown"
)

func main() {
	// Initialize a standard options Markdown converter block
	converter := markdown.NewConverter(markdown.DefaultOptions())

	// Define raw text variables highlighting structured Markdown elements
	markdownContent := `
# Project Documentation
Welcome to automated generation.
## Features Included
- **High-Performance Compilation** via native Go routines.
- Clean nested element styling hooks.`

	// Process raw strings directly into a formatted .docx file
	err := converter.ConvertStringToFile(markdownContent, "markdown_transformed.docx")
	if err != nil {
		log.Fatalf("Markdown parsing pipeline encounter error: %v", err)
	}
}