Potente Libreria Open-Source per l'Elaborazione di Documenti Word per Go

Iniziare con wordZero

Il modo consigliato per installare wordZero nel tuo progetto è utilizzare GitHub. Per favore usa il comando seguente per un'installazione senza problemi.

go get github.com/zerx-lab/wordZero

Crea e salva documenti Word tramite API Go

Una delle capacità fondamentali di wordZero è la sua abilità di creare documenti Word da zero. Gli sviluppatori possono inizializzare un nuovo documento, aggiungere contenuti e salvarlo come file DOCX in poche righe di codice. Questa funzionalità è estremamente utile per sistemi di reportistica automatizzata, servizi di generazione di documenti e applicazioni che devono esportare i dati degli utenti in formato Microsoft Word. Poiché la libreria gestisce internamente il packaging OOXML, gli sviluppatori possono concentrarsi sulla creazione del contenuto anziché occuparsi di strutture documentali complesse.

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) 
	}
  }
 

Motore di template avanzato con ereditarietà

Il motore di template di WordZero trasforma il modo in cui generi documenti dinamici. Diversamente dalla semplice sostituzione di stringhe, supporta l'ereditarietà basata su blocchi, il rendering condizionale, i cicli e i segnaposto per le immagini. Ciò significa che puoi creare template di base (intestazioni, piè di pagina, linee guida del brand) ed estenderli per casi d'uso specifici come report di vendita o fatture. È molto utile per eliminare la duplicazione del codice e separare il contenuto dalla presentazione. I team di marketing possono aggiornare i template senza l'intervento degli sviluppatori.

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")
}
 

Gestione dinamica di immagini native e scalatura automatica

Integrare risorse come grafici, branding organizzativo o fotografie richiede una gestione rigorosa del layout per evitare di rovinare le interruzioni di testo. La libreria open source wordZero offre semplici wrapper nativi che accettano input di immagini direttamente da percorsi di sistema fisici o da array di byte in memoria ([]byte). La libreria rileva automaticamente i rapporti d'aspetto, consentendo funzioni come l'adattamento automatico delle immagini ai margini o restrizioni esplicite di pixel.

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)
	}
}

Conversioni dirette da Markdown a Word tramite libreria Ruby?

Nelle pipeline di pubblicazione decentralizzate, Markdown è spesso la scelta preferita per scrivere contenuti, mentre Word è necessario per la distribuzione aziendale. wordZero risponde a questa esigenza con un modulo di conversione duale dedicato e integrato. Analizza intestazioni standard, parametri in linea (grassetto, corsivo, tag di codice), elenchi e collegamenti direttamente dai blocchi di sorgente Markdown di base, traducendoli in modo pulito in alberi di documenti OOXML professionali.

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)
	}
}