تولید و تجزیه فایل‌های .docx از طریق کتابخانه رایگان Go

کتابخانه پردازش Word با Go منبع باز برای خواندن و نوشتن برنامه‌نویسی Microsoft Word. فایل‌های رسانه‌ای، تصاویر، متن، سرصفحه‌ها/پاورقی‌ها و جداول را به فایل‌های DOCX وارد کنید.

کتابخانه Go-Docx چیست؟

در دنیای توسعه Golang، کار با اسناد Microsoft Word (.docx) به‌صورت تاریخی یک چالش بوده است. بسیاری از کتابخانه‌های موجود یا به عملکرد «فقط نوشتن» محدود هستند یا دارای برچسب قیمت تجاری سنگینی می‌باشند. Go-Docx (توسط fumiama نگهداری می‌شود) این شکاف را پر می‌کند به‌عنوان یکی از کارآمدترین کتابخانه‌های منبع باز که برای خواندن و نوشتن فایل‌های ECMA-376 Office Open XML طراحی شده‌اند. این کتابخانه مفید است زیرا یک API سطح بالا ارائه می‌دهد که ساختارهای پیچیده XML زیرین فایل‌های Word را انتزاع می‌کند.

چیزی که Go-Docx را متمایز می‌کند مجموعه ویژگی‌های جامع آن است: قالب‌بندی متن (رنگ، اندازه، تراز)، درج تصویر، دستکاری جدول، اشکال، بوم‌ها و گروه‌ها. چه در حال تولید فاکتورها، تجزیه رزومه‌ها یا خودکارسازی تولید گزارش باشید، این کتابخانه ساختارهای پیچیده Office Open XML (ECMA-376) را بدون بار اضافی فراخوانی برنامه‌های خارجی مدیریت می‌کند. این یک fork هدایت‌شده توسط جامعه است که به‌طور قابل‌توجهی از پیشینان خود تکامل یافته است. بر خلاف گزینه‌های تجاری مانند UniOffice (که برای دسترسی به تمام ویژگی‌ها نیاز به پرداخت دارد)، Go-Docx به‌صورت کامل تحت مجوز AGPL-3.0 رایگان است.

Previous Next

آغاز کار با Go-Docx

راه پیشنهادی برای افزودن Go-Docx به پروژه شما استفاده از GitHub است. لطفاً از فرمان زیر برای نصب روان استفاده کنید.

نصب Go-Docx از طریق GitHub

go get -d github.com/fumiama/go-docx@latest 

تولید پیشرفته سند با Go

Go-Docx به شما امکان می‌دهد اسناد پیچیده را از صفر با استفاده از یک رویکرد ساختاری ایجاد کنید. این کتابخانه راه‌اندازی محیط سند را مدیریت می‌کند، شامل تم‌ها و سبک‌های پیش‌فرض، و اطمینان می‌دهد که فایل‌های تولیدی شما کاملاً با Microsoft Word و سایر پردازشگرهای مدرن سازگار هستند. در اینجا یک مثال ساده نشان می‌دهد چگونه می‌توانید یک فایل Word Docx را داخل برنامه‌های Go تولید کنید.

چگونه فایل‌های Word Docx را با کتابخانه Go تولید کنیم؟

package main
import (
	"os"
	"github.com/fumiama/go-docx"
)

func main() {
	// Initialize a new document with a default theme
	w := docx.New().WithDefaultTheme()
	
	// Add a paragraph and basic text
	para := w.AddParagraph()
	para.AddText("Hello, this is a generated document!")

	// Save to local file
	f, _ := os.Create("simple.docx")
	w.WriteTo(f)
	f.Close()
}

تحلیل جامع سند از طریق API Go

بر خلاف بسیاری از رقبا، کتابخانه منبع باز Go-Docx در خواندن فایل‌های موجود برتری دارد. می‌تواند یک فایل .docx را تجزیه کند و از طریق آیتم‌های بدنه مانند پاراگراف‌ها و جداول تکرار کند. این ویژگی آن را گزینه‌ای ایده‌آل برای استخراج داده یا وظایف بررسی اسناد می‌کند که نیاز به تحلیل محتوا به‌صورت برنامه‌نویسی دارید. مثال زیر نشان می‌دهد چگونه توسعه‌دهندگان نرم‌افزار می‌توانند اسناد Word را داخل برنامه‌های خود در Go تجزیه کنند.

چگونه اسناد Word Docx را با کتابخانه Go تجزیه کنیم؟

package main
import (
	"fmt"
	"os"
	"github.com/fumiama/go-docx"
)

func main() {
	readFile, _ := os.Open("existing.docx")
	info, _ := readFile.Stat()
	
	// Parse the file using its reader and size
	doc, _ := docx.Parse(readFile, info.Size())
	
	for _, item := range doc.Document.Body.Items {
		if p, ok := item.(*docx.Paragraph); ok {
			fmt.Println("Paragraph found:", p)
		}
	}
}

ساخت جدول دینامیک در فایل‌های Docx با Go

Open source Go-Docx library has included support for the creation and manipulation of tables, including nested tables—a feature often missing in simpler libraries. You can define rows, cells, and specific border styles, making it highly effective for generating financial reports, invoices, or data-heavy technical documentation. Here is a very useful code example that shows how to create a table inside Word documents via Go commands.

چگونه یک جدول ساده داخل فایل Word با کتابخانه Go ایجاد کنیم؟

func createTable(w *docx.Docx) {
	table := w.AddTable(2, 2) // Create a 2x2 table
	row := table.Rows[0]
	cell := row.Cells[0]
	
	p := cell.AddParagraph()
	p.AddText("Cell Content")
	
	// You can also adjust table properties here
}

پشتیبانی از استایل و قالب‌بندی متن غنی

کنترل دقیق بر تایپوگرافی یکی از قوت‌های اصلی این کتابخانه منبع باز Go است. می‌توانید رنگ متن، اندازه فونت، تراز را تغییر دهید و حتی از طریق Go-Docx لینک‌های فراگیر یا توقف‌های تب اضافه کنید. این امکان به توسعه‌دهندگان اجازه می‌دهد اسناد حرفه‌ای و برندی تولید کنند که با نیازهای طراحی خاص سازگار باشند بدون مداخله دستی.

چگونه استایل و قالب‌بندی متن را به اسناد Word با کتابخانه Go اعمال کنیم؟

func styleText(w *docx.Docx) {
	para := w.AddParagraph()
	// Chain styling methods for concise code
	para.AddText("Important Header").Size("32").Color("FF0000")
	para.AddText("Subtext").Italic().Bold()
	
	// Add a link
	para.AddLink("Visit Website", "https://example.com")
}
 فارسی