Вступ

Aspose.PDF FOSS для Go тепер експортує PDF-документи у HTML, відкриває шари необов’язкового контенту у дереві сторінок і надає фасад для створення тегованих PDF (доступних) документів. Ці доповнення розширюють типи Document, Page і Form можливостями управління документами, які виходять за межі базових процесів відкриття/збереження: перетворення PDF у самодостатню сторінку HTML, перемикання видимості шарового контенту, розмітка логічної структури для відповідності PDF/UA, та обмін даними полів AcroForm у форматі JSON.

Бібліотека є Go-модулем, github.com/aspose-pdf-foss/aspose-pdf-foss-for-go, випущена під ліцензією MIT без нативних залежностей C або C++.

go get github.com/aspose-pdf-foss/aspose-pdf-foss-for-go

У цьому дописі розглядаються нові режими експорту HTML, обробка необов’язкового контенту (шари), створення тегованого контенту та експорт/імпорт форм JSON — все це базується на поточному інтерфейсі API.

Ключові особливості

Експорт PDF у HTML

Document.SaveHTML і Document.WriteHTML перетворюють завантажений PDF у HTML, керуючись HTMLSaveOptions.Mode (HTMLModeText для видимого, виділюваного текстового шару над растровим фоном без гліфів; HTMLModeNative для вбудованого SVG-векторного шару; HTMLModeFlow для перепливного HTML). Інтерактивні поля AcroForm можна перетворити у справжні елементи керування формою HTML за допомогою InteractiveForms: true.

doc, _ := pdf.Open("input.pdf")

// Faithful mode (default): full page raster + transparent selectable text layer.
doc.SaveHTML("out.html")

// Visible-text mode: real styled HTML text over a glyph-less background raster.
doc.SaveHTML("out.html", pdf.HTMLSaveOptions{Mode: pdf.HTMLModeText})

// Native mode: page graphics as one inline SVG layer.
doc.SaveHTML("out.html", pdf.HTMLSaveOptions{Mode: pdf.HTMLModeNative})

// Flow mode: reflowable HTML, paragraphs and headings in reading order.
doc.SaveHTML("article.html", pdf.HTMLSaveOptions{Mode: pdf.HTMLModeFlow})

// Interactive forms become fillable HTML controls.
doc.SaveHTML("form.html", pdf.HTMLSaveOptions{Mode: pdf.HTMLModeText, InteractiveForms: true})

Опційні шари вмісту

Document.AddLayer створює нову групу опціонального вмісту (OCG) і повертає *Layer; Document.Layers перераховує всі шари, вже присутні в документі. Сторінка позначає вміст як приналежний до шару за допомогою Page.BeginLayer / Page.EndLayer. Layer.SetVisible(false) приховує вміст шару за замовчуванням.

doc := pdf.NewDocumentFromFormat(pdf.PageFormatA4)
layer := doc.AddLayer("Watermark")

page, _ := doc.Page(1)
page.BeginLayer(layer)
page.AddText("DRAFT", pdf.TextStyle{Font: pdf.FontHelveticaBold, Size: 48},
    pdf.Rectangle{LLX: 150, LLY: 400, URX: 450, URY: 460})
page.EndLayer()

layer.SetVisible(false) // hide the watermark by default
doc.Save("layered.pdf")

Тегований PDF та доступність

Document.TaggedContent повертає фасад *TaggedContent, який володіє логічним деревом структури документа. TaggedContent.SetTitle / SetLanguage встановлюють метадані рівня каталогу, які вимагає PDF/UA, а Page.TagContent обгортає виклик малювання у позначений вміст, додаючи вузол *StructElement.

doc := pdf.NewDocumentFromFormat(pdf.PageFormatA4)
tc := doc.TaggedContent()
tc.SetTitle("Quarterly Report")
tc.SetLanguage("en-US")
page, _ := doc.Page(1)

page.TagContent(tc.Root(), pdf.StructH1, func() error {
    return page.AddText("Quarterly Report", pdf.TextStyle{Font: pdf.FontHelveticaBold, Size: 24},
        pdf.Rectangle{LLX: 50, LLY: 760, URX: 545, URY: 800})
})
fig, _ := page.TagContent(tc.Root(), pdf.StructFigure, func() error {
    return page.AddImage("chart.png", pdf.Rectangle{LLX: 50, LLY: 540, URX: 300, URY: 680})
})
fig.SetAlt("Bar chart of Q3 sales by region") // required for figures

doc.Save("accessible.pdf") // doc.ValidatePDFUA() is now Conformant

Експорт даних форми як JSON

Form.ExportJSON серіалізує тип і значення кожного поля AcroForm у JSON; Form.ImportJSON застосовує JSON навантаження назад до форми і повертає кількість оновлених полів. JSONExportOptions.Indent красиво виводить результат.

doc, _ := pdf.Open("filled.pdf")
data, _ := doc.Form().ExportJSON(pdf.JSONExportOptions{Indent: true})

// Fill a template from a JSON payload; discard the applied-field count.
template, _ := pdf.Open("template.pdf")
_, _ = template.Form().ImportJSON(data)

Швидкий старт

go get github.com/aspose-pdf-foss/aspose-pdf-foss-for-go
package main

import (
	"fmt"

	pdf "github.com/aspose-pdf-foss/aspose-pdf-foss-for-go"
)

func main() {
	doc, err := pdf.Open("input.pdf")
	if err != nil {
		panic(err)
	}

	err = doc.SaveHTML("out.html", pdf.HTMLSaveOptions{Mode: pdf.HTMLModeText})
	if err != nil {
		panic(err)
	}
	fmt.Println("HTML export complete")
}

Підтримувані формати

ФорматРозширенняЧитатиЗапис
PDFpdfТак-
HTMLhtml-Так
JSONjson-Так

Відкритий код та ліцензування

Aspose.PDF FOSS для Go випущено під ліцензією MIT: немає обмежень використання, немає плат за виконання та немає вимог реєстрації для комерційного або особистого використання. Вихідний код розміщено за адресою github.com/aspose-pdf-foss/aspose-pdf-foss-for-go.

Початок роботи

Пов’язані ресурси