Мощная открытая библиотека обработки 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)
	}
}