کتابخانه رایگان Go برای ایجاد اسناد EPUB
کتابخانه منبع باز Go برای ایجاد فایلهای EPUB. شامل پشتیبانی از افزودن CSS، تصاویر و فونتها است.
Go-EPUB یک کتابخانه منبع باز بسیار مفید برای زبان Go است که به توسعهدهندگان نرمافزار امکان میدهد به راحتی فایلهای EPUB را در برنامه Go خود ایجاد کنند. این کتابخانه بهخوبی مستند شده است و تمام پیامهای خطا بهصورت خود توضیحی هستند. این کتابخانه شامل توابع بسیار مفیدی برای کار با فایلهای رسانهای میباشد، از جمله دریافت رسانه از یک URL، دریافت رسانه از فایل محلی یا دریافت رسانه از یک طرح رمزگذاری شده RFC 2397.
کتابخانه Go-EPUB بسیار ساده برای استفاده است و چندین ویژگی مهم برای کار با اسناد EPUB را شامل میشود، از جمله ایجاد فایلهای EPUB 3.0 معتبر، افزودن تصویر به فایلهای EPUB، پشتیبانی از CSS سفارشی، افزودن ویدیو داخل فایل EPUB، افزودن قلمها و استفاده از افزودن فهرست مطالب EPUB 2.0 برای حداکثر سازگاری.
کتابخانه Go-EPUB ابزار EPUBCheck را پشتیبانی میکند که به کاربران امکان بررسی یک EPUB برای خطاهای اعتبارسنجی را میدهد. اگر EPUBCheck بهصورت محلی نصب شده باشد، همراه با تستهای Go اجرا خواهد شد. برای استفاده از EPUBCheck مطمئن شوید که جاوا بر روی سیستم شما نصب شده باشد. اگر کاربران تمایلی به نصب EPUBCheck بهصورت محلی ندارند، میتوانند بهصورت دستی اسناد EPUB را اعتبارسنجی کنند.
شروع کار با Go-EPUB
برای نصب کتابخانه Go-EPUB بر روی سیستم خود، لطفاً دستور زیر را اجرا کنید.
نصب PDF از طریق GitHub
go get https://github.com/iditectweb/pdf.gitهمچنین میتوانید آن را بهصورت دستی نصب کنید؛ فایلهای آخرین نسخه را مستقیماً از مخزن GitHub دانلود کنید.
تولید فایل EPUB با استفاده از Go API
کتابخانه منبع باز Go-EPUB عملکرد کامل برای ایجاد اسناد EPUB را داخل برنامه Go خود تنها با چند خط دستور Go فراهم کرده است. این کتابخانه چندین ویژگی مهم مرتبط با ایجاد اسناد را ارائه میدهد، از جمله تنظیم نویسنده، افزودن بخش جدید به سند، درج تصاویر درون سند، اعمال قالببندی و استایل متن، افزودن فونتهای دلخواه و موارد دیگر.
ایجاد فایل EPUB جدید با استفاده از کتابخانه Go
// Create a new EPUB
e := epub.NewEpub("My title")
// Set the author
e.SetAuthor("Hingle McCringleberry")
// Add a section
section1Body := `بخش 1
این یک پاراگراف است.
`
e.AddSection(section1Body, "Section 1", "", "")
// Write the EPUB
err = e.Write("My EPUB.epub")
if err != nil {
// handle error
}
افزودن تصویر به فایلهای EPUB از طریق Go API
کتابخانه منبع باز Go-EPUB به برنامهنویسان امکان میدهد تا تصاویر را به اسناد EPUB خود در برنامههای Go اضافه کنند. این کتابخانه شامل روشهای متعددی برای درج تصاویر در یک فایل EPUB است، مانند استفاده از URL یا مسیر کامل به یک فایل تصویر محلی یا از طریق URL دادهای تعبیهشده. در هر دو حالت، فایل تصویر دریافت و در سند EPUB ذخیره میشود. نام فایل داخلی هنگام ذخیرهسازی تصویر در EPUB استفاده میشود و باید در میان تمام فایلهای تصویر یکتا باشد.
نحوه افزودن تصویر به فایل EPUB با استفاده از API Go
e := epub.NewEpub("My title")
// Add an image from a local file
img1Path, err := e.AddImage("testdata/gophercolor16x16.png", "go-gopher.png")
if err != nil {
log.Fatal(err)
}
// Add an image from a URL. The filename is optional
img2Path, err := e.AddImage("https://golang.org/doc/gopher/gophercolor16x16.png", "")
if err != nil {
log.Fatal(err)
}
fmt.Println(img1Path)
fmt.Println(img2Path)
افزودن CSS و فونتها به فایلهای EPUB از طریق Go API
کتابخانه Go-EPUB به توسعهدهندگان نرمافزار امکان میدهد تا CSS سفارشی و فونتهای دلخواه خود را در اسناد EPUB اضافه کنند. همانند تصاویر، این کتابخانه اجازه میدهد تا برای درج CSS یا فونت در یک فایل EPUB از URL، مسیر به یک فایل محلی یا URL دادهای تعبیهشده استفاده شود. لطفاً به یاد داشته باشید که نام فایل داخلی هنگام ذخیرهسازی فایل فونت در EPUB استفاده میشود.
افزودن CSS به اسناد EPUB با استفاده از API Go
// Add CSS
css1Path, err := e.AddCSS("testdata/cover.css", "epub.css")
if err != nil {
log.Fatal(err)
}
// The filename is optional
css2Path, err := e.AddCSS("testdata/cover.css", "")
if err != nil {
log.Fatal(err)
}
// Use the CSS in a section
sectionBody := ` بخش 1
این یک پاراگراف است.
`
e.AddSection(sectionBody, "Section 1", "", css1Path)
fmt.Println(css1Path)
fmt.Println(css2Path)