Tagovaný PDF soubor používá tagy k definování logické struktury obsahu v dokumentu. Tento typ PDF zlepšuje zážitek ze čtení pomocí asistenčních technologií a programů pro čtení z obrazovky. V předchozím příspěvku jste viděli, jak programově vytvářet soubory PDF v aplikacích Java. V tomto článku se dozvíte, jak vytvářet tagované soubory PDF programově v Javě.
- Java API pro vytváření tagovaných souborů PDF
- Vytvořte tagovaný soubor PDF
- Vytvořte tagovaný PDF s vnořenými prvky
- Stylování struktury textu v tagovaném PDF
- Znázornění prvků struktury v tagovaném PDF
Java API pro vytváření tagovaných souborů PDF
K vytvoření tagovaných souborů PDF použijeme Aspose.PDF for Java. Je to jedno z populárních API pro generování a manipulaci s PDF. Pomocí rozhraní API můžete bez problémů vytvářet, zpracovávat a převádět soubory PDF s jednoduchými i složitými rozvrženími. Rozhraní API si můžete stáhnout nebo jej nainstalovat pomocí následujících konfigurací Maven.
úložiště:
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://repository.aspose.com/repo/</url>
</repository>
Závislost:
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-pdf</artifactId>
<version>22.4</version>
</dependency>
Vytvořte tagovaný soubor PDF v Javě
Pro vytvoření prvků struktury v tagovaném PDF poskytuje Aspose.PDF pro Java rozhraní ITaggedContent. Pojďme se tedy podívat, jak toto rozhraní použít k vytvoření tagovaného souboru PDF v Javě.
- Vytvořte nový PDF pomocí třídy Document.
- Získejte odkaz na TaggedContent dokumentu do objektu ITaggedContent.
- Nastavte název, záhlaví a jazyk a přidejte prvky do PDF pomocí objektu ITaggedContent.
- Vytvořte nový ParagraphElement pomocí metody ITaggedContent.createParagraphElement() a nastavte jeho text.
- Přidejte odstavec do dokumentu pomocí metody ITaggedContent.getRootElement().appendChild().
- Nakonec uložte soubor PDF pomocí metody Document.save(String).
Následující ukázka kódu ukazuje, jak vytvořit tagovaný PDF v Javě.
// Vytvořte nový dokument
Document document = new Document();
// Získejte obsah pro práci s tagovaným PDF
ITaggedContent taggedContent = document.getTaggedContent();
StructureElement rootElement = taggedContent.getRootElement();
// Nastavte název a jazyk dokumentu
taggedContent.setTitle("Tagged Pdf Document");
taggedContent.setLanguage("en-US");
// Přidat záhlaví
HeaderElement mainHeader = taggedContent.createHeaderElement();
mainHeader.setText("Main Header");
// Přidat odstavec
ParagraphElement paragraphElement = taggedContent.createParagraphElement();
paragraphElement.setText("Lorem ipsum dolor sit amet, consectetur adipiscing elit. " +
"Aenean nec lectus ac sem faucibus imperdiet. Sed ut erat ac magna ullamcorper hendrerit. " +
"Cras pellentesque libero semper, gravida magna sed, luctus leo. Fusce lectus odio, laoreet" +
"nec ullamcorper ut, molestie eu elit. Interdum et malesuada fames ac ante ipsum primis in faucibus." +
"Aliquam lacinia sit amet elit ac consectetur. Donec cursus condimentum ligula, vitae volutpat" +
"sem tristique eget. Nulla in consectetur massa. Vestibulum vitae lobortis ante. Nulla ullamcorper" +
"pellentesque justo rhoncus accumsan. Mauris ornare eu odio non lacinia. Aliquam massa leo, rhoncus" +
"ac iaculis eget, tempus et magna. Sed non consectetur elit. Sed vulputate, quam sed lacinia luctus," +
"ipsum nibh fringilla purus, vitae posuere risus odio id massa. Cras sed venenatis lacus.");
rootElement.appendChild(mainHeader);
rootElement.appendChild(paragraphElement);
// Uložit označené PDF
document.save("tagged-pdf.pdf");
Následuje výstup výše uvedené ukázky kódu.
Vytvořte tagovaný PDF s vnořenými prvky v Javě
V předchozím příkladu jsme vytvořili jednoduchý tagovaný PDF, který obsahuje odstavec. Pojďme se nyní podívat na to, jak přidat vnořené prvky do tagovaného PDF. Následují kroky k provedení této operace.
- Vytvořte nový PDF nebo načtěte existující pomocí třídy Document.
- Získejte odkaz na TaggedContent dokumentu do objektu ITaggedContent.
- Nastavte název, záhlaví a jazyk a přidejte prvky do PDF pomocí objektu ITaggedContent.
- Vytvořte nový ParagraphElement pomocí metody ITaggedContent.createParagraphElement() a nastavte jeho text.
- K přidání vnořených prvků použijte třídu SpanElement.
- Přidejte vnořený prvek do odstavce pomocí metody ParagraphElement.appendChild().
- Přidejte odstavec do dokumentu pomocí metody ITaggedContent.getRootElement().appendChild().
- Nakonec uložte soubor PDF pomocí metody Document.save(String).
Následující ukázka kódu ukazuje, jak přidat vnořené prvky do tagovaného PDF v Javě.
// Vytvořte nový dokument
Document document = new Document();
// Získejte obsah pro práci s tagovaným PDF
ITaggedContent taggedContent = document.getTaggedContent();
StructureElement rootElement = taggedContent.getRootElement();
// Nastavte název a jazyk dokumentu
taggedContent.setTitle("Tagged Pdf Document");
taggedContent.setLanguage("en-US");
// Přidat záhlaví
HeaderElement mainHeader = taggedContent.createHeaderElement();
mainHeader.setText("Main Header");
// Vytvořit odstavec
ParagraphElement paragraphWithQuotes = taggedContent.createParagraphElement();
paragraphWithQuotes.getStructureTextState().setFont(FontRepository.findFont("Calibri"));
paragraphWithQuotes.getStructureTextState().setMarginInfo(new MarginInfo(10, 5, 10, 5));
// Přidat prvek rozpětí
SpanElement spanElement1 = taggedContent.createSpanElement();
spanElement1.setText("Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean nec lectus ac sem faucibus imperdiet. Sed ut erat ac magna ullamcorper hendrerit. Cras pellentesque libero semper, gravida magna sed, luctus leo. Fusce lectus odio, laoreet nec ullamcorper ut, molestie eu elit. Interdum et malesuada fames ac ante ipsum primis in faucibus. Aliquam lacinia sit amet elit ac consectetur. Donec cursus condimentum ligula, vitae volutpat sem tristique eget. Nulla in consectetur massa. Vestibulum vitae lobortis ante. Nulla ullamcorper pellentesque justo rhoncus accumsan. Mauris ornare eu odio non lacinia. Aliquam massa leo, rhoncus ac iaculis eget, tempus et magna. Sed non consectetur elit. ");
QuoteElement quoteElement = taggedContent.createQuoteElement();
quoteElement.setText("Sed vulputate, quam sed lacinia luctus, ipsum nibh fringilla purus, vitae posuere risus odio id massa.");
quoteElement.getStructureTextState().setFontStyle(FontStyles.Bold | FontStyles.Italic);
SpanElement spanElement2 = taggedContent.createSpanElement();
spanElement2.setText(" Sed non consectetur elit.");
// Připojit k odstavci
paragraphWithQuotes.appendChild(spanElement1);
paragraphWithQuotes.appendChild(quoteElement);
paragraphWithQuotes.appendChild(spanElement2);
rootElement.appendChild(mainHeader);
rootElement.appendChild(paragraphWithQuotes);
// Uložit označené PDF
document.save("tagged-pdf.pdf");
Následující snímek obrazovky ukazuje tagovaný PDF s vnořenými prvky.
Stylování struktury textu v tagovaném PDF
Můžete také použít styl na text v tagovaném PDF nastavením stylu písma, rodiny, velikosti atd. K tomu vám Aspose.PDF pro Java umožňuje nastavit písmo, velikost písma, styl písma a barvu popředí pomocí StructureTextState třída. Následující ukázka kódu ukazuje, jak použít styl textu v tagovaném PDF v Javě.
// Vytvořte nový dokument
Document document = new Document();
// Získejte obsah pro práci s tagovaným PDF
ITaggedContent taggedContent = document.getTaggedContent();
StructureElement rootElement = taggedContent.getRootElement();
// Nastavte název a jazyk dokumentu
taggedContent.setTitle("Tagged Pdf Document");
taggedContent.setLanguage("en-US");
// Přidat záhlaví
HeaderElement mainHeader = taggedContent.createHeaderElement();
mainHeader.setText("Main Header");
// Vytvořit odstavec
ParagraphElement paragraphWithQuotes = taggedContent.createParagraphElement();
taggedContent.getRootElement().appendChild(paragraphWithQuotes);
// Nastavte styling
paragraphWithQuotes.getStructureTextState().setFontSize(18F);
paragraphWithQuotes.getStructureTextState().setForegroundColor(Color.getRed());
paragraphWithQuotes.getStructureTextState().setFontStyle(FontStyles.Italic);
// Přidej text
paragraphWithQuotes.setText("Red italic text.");
// Uložit označené PDF
document.save("tagged-pdf.pdf");
Ilustrování prvků struktury v tagovaném PDF v Javě
Pro ilustraci prvků struktury poskytuje Aspose.PDF pro Javu třídu IllustrationElement. Následující ukázka kódu ukazuje, jak použít tuto třídu k ilustraci prvků struktury v tagovaném PDF.
// Vytvořte nový dokument
Document document = new Document();
// Získejte obsah pro práci s tagovaným PDF
ITaggedContent taggedContent = document.getTaggedContent();
StructureElement rootElement = taggedContent.getRootElement();
// Nastavte název a jazyk dokumentu
taggedContent.setTitle("Tagged Pdf Document");
taggedContent.setLanguage("en-US");
// Vytvořte prvek ilustrace
IllustrationElement figure1 = taggedContent.createFigureElement();
taggedContent.getRootElement().appendChild(figure1);
figure1.setAlternativeText( "Figure One");
figure1.setTitle("Image 1");
figure1.setTag("Fig1");
figure1.setImage("aspose_pdf.png");
// Uložit označené PDF
document.save("tagged-pdf.pdf");
Získejte bezplatnou licenci
Můžete získat bezplatnou dočasnou licenci, abyste mohli používat Aspose.PDF pro Javu bez omezení hodnocení.
Závěr
V tomto článku jste se naučili, jak vytvářet tagované soubory PDF v Javě. Dále jste viděli, jak vytvářet vnořené prvky, aplikovat styly na text a ilustrovat prvky struktury v tagovaném PDF programově. Kromě toho můžete prozkoumat více o Java PDF API pomocí dokumentace. V případě jakýchkoli dotazů nebo dotazů nás můžete kontaktovat prostřednictvím našeho fóra.