Мощна отворена библиотека за обработка на Word за Go

Започване с wordZero

Препоръчителният начин за инсталиране на wordZero във вашия проект е чрез GitHub. Моля, използвайте следната команда за безпроблемна инсталация.

go get github.com/zerx-lab/wordZero

Създаване и запазване на Word документи чрез Go API

Една от основните възможности на wordZero е способността му да създава Word документи от нулата. Разработчиците могат да инициализират нов документ, да добавят съдържание и да го запазят като DOCX файл с няколко реда код. Тази функция е изключително полезна за автоматизирани системи за отчитане, услуги за генериране на документи и приложения, които трябва да експортират потребителски данни в формат Microsoft Word. Тъй като библиотеката обработва OOXML пакетиране вътрешно, разработчиците могат да се фокусират върху създаването на съдържание, вместо да се занимават със сложни структури на документа.

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

Разширен шаблонен двигател с наследяване

Шаблонният двигател на WordZero трансформира начина, по който генерирате динамични документи. За разлика от обикновената замяна на низове, той поддържа наследяване на базирани на блокове, условно рендериране, цикли и заместители за изображения. Това означава, че можете да създавате базови шаблони (заглавки, колонтитули, указания за бранда) и да ги разширявате за конкретни случаи като продажбени отчети или фактури. Той е много полезен, тъй като премахва дублирането на код и разделя съдържанието от представянето. Маркетинговите екипи могат да актуализират шаблоните без намеса на разработчиците.

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

Динамично управление на нативни изображения и автоматично мащабиране

Интегрирането на ресурси като диаграми, фирмено брандиране или фотографии изисква стриктно управление на оформлението, за да се избегне нарушаване на обтичането на текста. Отворената библиотека wordZero предлага прости родни обвивки, които приемат входни изображения директно от физически системни пътища или от масиви от байтове в паметта ([]byte). Библиотеката автоматично открива съотношения на страните, позволявайки функции като автоматично приспособяване на изображенията към маргините или явни пикселни ограничения.

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

Директни конверсии от Markdown към Word чрез Ruby библиотека?

В децентрализираните процеси на публикуване Markdown често е предпочитаният избор за писане на съдържание, докато Word е необходим за корпоративно разпространение. wordZero отговаря на тази нужда с посветен, вграден двоен конверсионен модул. Той анализира стандартните заглавия, вградени параметри (удебеляване, курсив, кодови тагове), списъци и връзки директно от основни Markdown изходни блокове, превеждайки ги чисто в професионални OOXML документни дървета.

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