Puissante bibliothèque de traitement de texte open source pour Go

Premiers pas avec wordZero

La façon recommandée d’installer wordZero dans votre projet est d’utiliser GitHub. Veuillez utiliser la commande suivante pour une installation fluide.

go get github.com/zerx-lab/wordZero

Créer et enregistrer des documents Word via l'API Go

Une des capacités principales de wordZero est sa capacité à créer des documents Word à partir de zéro. Les développeurs peuvent initialiser un nouveau document, ajouter du contenu et l'enregistrer en tant que fichier DOCX en quelques lignes de code. Cette fonctionnalité est extrêmement utile pour les systèmes de génération de rapports automatisés, les services de génération de documents et les applications qui doivent exporter les données des utilisateurs au format Microsoft Word. Comme la bibliothèque gère l'empaquetage OOXML en interne, les développeurs peuvent se concentrer sur la création de contenu plutôt que sur la gestion de structures de documents complexes.

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

Moteur de modèles avancé avec héritage

Le moteur de modèles de WordZero transforme la façon dont vous générez des documents dynamiques. Contrairement au simple remplacement de chaînes, il prend en charge l'héritage basé sur des blocs, le rendu conditionnel, les boucles et les espaces réservés d'images. Cela signifie que vous pouvez créer des modèles de base (en-têtes, pieds de page, directives de marque) et les étendre pour des cas d'utilisation spécifiques tels que les rapports de ventes ou les factures. Il est très utile pour éliminer la duplication de code et séparer le contenu de la présentation. Les équipes marketing peuvent mettre à jour les modèles sans intervention des développeurs.

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

Gestion dynamique d'images natives et mise à l'échelle automatique

L'intégration d'éléments tels que des graphiques, l'image de marque de l'organisation ou des photographies nécessite une gestion stricte de la mise en page afin d'éviter de ruiner les retours à la ligne du texte. La bibliothèque open source wordZero propose des wrappers natifs simples qui acceptent les entrées d'images directement à partir de chemins système physiques ou de tableaux d'octets en mémoire ([]byte). La bibliothèque détecte automatiquement les rapports d'aspect, permettant des fonctions comme l'ajustement automatique des images aux marges ou des contraintes de pixels explicites.

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

Conversions directes de Markdown vers Word via une bibliothèque Ruby?

Dans les pipelines de publication décentralisées, le Markdown est souvent le choix privilégié pour rédiger du contenu, tandis que Word est requis pour la distribution d'entreprise. wordZero répond à ce besoin avec un module de conversion double dédié et intégré. Il analyse les titres standard, les paramètres en ligne (gras, italique, balises de code), les listes et les liens directement à partir de blocs source Markdown basiques, les traduisant proprement en arbres de documents OOXML professionnels.

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