1. 製品
  2.   ワードプロセッシング
  3.   GO
  4.   WordZero
 
  

Go向けの強力なオープンソースワードプロセッシングライブラリ

テンプレート、テーブル、スタイル、ヘッダー、フッター、DOCX生成を備えた、Word文書自動化のためのオープンソースGolangライブラリ。

WordZeroとは何ですか？

wordZero は、プログラムで Microsoft Word DOCX ドキュメントの作成、読み取り、編集、管理を行うために設計されたオープンソースの Golang ライブラリです。クリーンな API を提供し、開発者が Go アプリケーションから直接、プロフェッショナルなレポート、請求書、契約書、ドキュメント、その他のビジネス文書を生成できます。このライブラリは Office Open XML (OOXML) 標準を基盤とし、テキストの書式設定、段落スタイル、表の作成、画像挿入、ヘッダー・フッター、リスト、テンプレート、目次生成など、幅広い文書操作機能を提供します。アーキテクチャはパフォーマンス、柔軟性、使いやすさに重点を置いており、小規模プロジェクトからエンタープライズレベルの文書自動化システムまで幅広く適しています。

モダンなアプリケーションでは、文書の自動生成が頻繁に求められます。レポートシステム、顧客文書ポータル、HR管理プラットフォーム、請求書ジェネレータなどを構築する場合、Word 文書を手作業で作成するのは時間がかかり、エラーが発生しやすいです。wordZero は、開発者がコードから直接完全にフォーマットされた DOCX ファイルを生成できるようにすることで、この課題を解決します。このライブラリは、構造化された文書作成、再利用可能なテンプレート、高度な書式設定、動的コンテンツ生成をサポートします。これにより手作業の負担が減り、一貫性が向上し、組織は文書中心のワークフローを効率的に自動化できます。また、スタイル、表、ヘッダー、フッター、文書メタデータのサポートにより、手動で作成された Word ファイルに非常に近い、プロフェッショナルな文書を作成することが可能です。

Previous Next

wordZeroの開始方法

プロジェクトに wordZero をインストールする推奨方法は GitHub を使用することです。スムーズなインストールのために、以下のコマンドをご利用ください。

GitHub で wordZero をインストール

go get github.com/zerx-lab/wordZero

Go APIを使用してWord文書を作成・保存する

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への直接変換？

分散型の出版パイプラインでは、コンテンツ執筆に 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)
	}
}
 日本