Výkonná open-source knihovna pro zpracování Wordu pro Go

Začínáme s wordZero

Doporučený způsob instalace wordZero do vašeho projektu je pomocí GitHubu. Použijte prosím následující příkaz pro hladkou instalaci.

go get github.com/zerx-lab/wordZero

Vytvářejte a ukládejte Word dokumenty pomocí Go API

Jednou ze základních schopností wordZero je schopnost vytvářet dokumenty Word od nuly. Vývojáři mohou inicializovat nový dokument, přidat obsah a uložit jej jako soubor DOCX během několika řádků kódu. Tato funkce je mimořádně užitečná pro automatizované systémy reportování, služby generování dokumentů a aplikace, které potřebují exportovat uživatelská data do formátu Microsoft Word. Protože knihovna interně zpracovává balíčkování OOXML, mohou se vývojáři soustředit na tvorbu obsahu místo toho, aby se zabývali složitými strukturami dokumentů.

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

Pokročilý šablonový engine s dědičností

Šablonový engine WordZero mění způsob, jakým generujete dynamické dokumenty. Na rozdíl od základní náhrady řetězců podporuje dědičnost založenou na blocích, podmíněné vykreslování, smyčky a zástupce obrázků. To znamená, že můžete vytvářet základní šablony (hlavičky, patičky, brandové směrnice) a rozšiřovat je pro konkrétní případy použití, jako jsou prodejní zprávy nebo faktury. Je velmi užitečný, protože eliminuje duplicitní kód a odděluje obsah od prezentace. Marketingové týmy mohou aktualizovat šablony bez zásahu vývojářů.

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

Dynamické řízení nativních obrázků a automatické škálování

Integrace aktiv, jako jsou grafy, firemní branding nebo fotografie, vyžaduje přísnou správu rozvržení, aby nedošlo k narušení zalamování textu. Open‑source knihovna wordZero obsahuje jednoduché nativní obaly, které přijímají vstupy obrázků přímo z fyzických systémových cest nebo z paměťových bytových polí ([]byte). Knihovna automaticky detekuje poměry stran, což umožňuje funkce jako automatické přizpůsobení obrázků okrajům nebo explicitní omezení v pixelech.

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

Přímé konverze Markdown na Word pomocí Ruby knihovny?

V decentralizovaných publikovacích pipelinech je Markdown často preferovanou volbou pro psaní obsahu, zatímco Word je vyžadován pro firemní distribuci. wordZero tuto potřebu řeší pomocí dedikovaného, vestavěného modulu dvojité konverze. Analyzuje standardní nadpisy, inline parametry (tučné, kurzíva, značky kódu), seznamy a odkazy přímo ze základních bloků Markdownu a čistě je převádí do profesionálních OOXML stromů dokumentů.

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