1. 제품
  2.   워드 프로세싱
  3.   GO
  4.   WordZero
 
  

Go용 강력한 오픈 소스 워드 프로세싱 라이브러리

템플릿, 표, 스타일, 헤더, 푸터 및 DOCX 생성 기능을 갖춘 워드 문서 자동화를 위한 오픈 소스 Golang 라이브러리

WordZero란 무엇인가요?

wordZero는 프로그래밍 방식으로 Microsoft Word DOCX 문서를 생성, 읽기, 편집 및 관리하도록 설계된 오픈소스 Golang 라이브러리입니다. 이 라이브러리는 깔끔한 API를 제공하여 개발자가 Go 애플리케이션에서 직접 전문 보고서, 청구서, 계약서, 문서 및 기타 비즈니스 문서를 생성할 수 있게 합니다. 이 라이브러리는 Office Open XML(OOXML) 표준을 기반으로 하며 텍스트 서식 지정, 단락 스타일링, 표 생성, 이미지 삽입, 머리글 및 바닥글, 목록, 템플릿, 목차 생성 등 광범위한 문서 조작 기능을 제공합니다. 아키텍처는 성능, 유연성 및 사용 편의성에 중점을 두어 작은 프로젝트부터 엔터프라이즈 수준의 문서 자동화 시스템까지 모두에 적합합니다.

현대 애플리케이션은 자동 문서 생성을 자주 필요로 합니다. 보고 시스템, 고객 문서 포털, 인사 관리 플랫폼, 혹은 청구서 생성기 등을 구축하든, 워드 문서를 수동으로 만드는 것은 시간 소모가 크고 오류가 발생하기 쉽습니다. wordZero는 개발자가 코드에서 직접 완전하게 포맷된 DOCX 파일을 생성할 수 있게 함으로써 이 문제를 해결합니다. 이 라이브러리는 구조화된 문서 생성, 재사용 가능한 템플릿, 고급 포맷팅 및 동적 콘텐츠 생성을 지원합니다. 이를 통해 수동 작업을 줄이고 일관성을 향상시키며 조직이 문서 중심 워크플로우를 효율적으로 자동화할 수 있습니다. 또한 스타일, 표, 머리글, 바닥글 및 문서 메타데이터 지원을 통해 수동으로 작성된 워드 파일과 거의 동일한 전문적인 문서를 만들 수 있습니다.

Previous Next

wordZero 시작하기

프로젝트에 wordZero를 설치하는 권장 방법은 GitHub을 이용하는 것입니다. 원활한 설치를 위해 다음 명령을 사용하십시오.

GitHub을 통해 wordZero 설치

go get github.com/zerx-lab/wordZero

Go API를 통해 워드 문서 만들기 및 저장하기

wordZero의 핵심 기능 중 하나는 처음부터 Word 문서를 생성하는 능력입니다. 개발자는 몇 줄의 코드만으로 새 문서를 초기화하고, 내용을 추가하며, DOCX 파일로 저장할 수 있습니다. 이 기능은 자동 보고 시스템, 문서 생성 서비스, 그리고 사용자 데이터를 Microsoft Word 형식으로 내보내야 하는 애플리케이션에 매우 유용합니다. 라이브러리가 OOXML 패키징을 내부적으로 처리하기 때문에, 개발자는 복잡한 문서 구조를 다루는 대신 콘텐츠 생성에 집중할 수 있습니다.

Go 라이브러리를 사용하여 프로그래밍 방식으로 DOCX 파일을 만드는 방법은?

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의 템플릿 엔진은 동적 문서를 생성하는 방식을 혁신합니다. 기본 문자열 교체와 달리 블록 기반 상속, 조건부 렌더링, 반복문 및 이미지 자리표시자를 지원합니다. 이를 통해 기본 템플릿(헤더, 푸터, 브랜드 가이드라인)을 만들고 이를 판매 보고서나 인보이스와 같은 특정 사용 사례에 맞게 확장할 수 있습니다. 코드 중복을 제거하고 콘텐츠와 프레젠테이션을 분리하는 데 매우 유용합니다. 마케팅 팀은 개발자 개입 없이 템플릿을 업데이트할 수 있습니다.

Go 애플리케이션 내 템플릿을 사용하여 동적 문서를 생성하는 방법은?

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)에서 직접 이미지 입력을 받아들이는 간단한 네이티브 래퍼를 제공합니다. 이 라이브러리는 자동으로 종횡비를 감지하여 이미지 자동 맞춤을 여백에 맞추거나 명시적인 픽셀 제한을 적용하는 기능을 가능하게 합니다.

Go 라이브러리를 사용하여 Word 문서 내 이미지를 관리하는 방법은?

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

Ruby 라이브러리를 통한 마크다운-워드 직접 변환?

분산된 퍼블리싱 파이프라인에서는 콘텐츠 작성을 위해 Markdown이 선호되는 경우가 많으며, 기업 배포를 위해서는 Word가 필요합니다. wordZero는 전용 내장 듀얼 변환 모듈로 이 요구를 충족합니다. 표준 헤딩, 인라인 파라미터(굵게, 기울임, 코드 태그), 리스트 및 링크를 기본 Markdown 소스 블록에서 직접 파싱하여 전문 OOXML 문서 트리로 깔끔하게 변환합니다.

Go 라이브러리를 사용한 Markdown에서 Word로 변환하는 방법은?

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)
	}
}
 한국인