From 2f5ea0892234257ff5e8fbe7020bad98e6bfbe12 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 23 Feb 2024 22:02:49 +0000 Subject: tagpdf (23feb24) git-svn-id: svn://tug.org/texlive/trunk@70094 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/tagpdf/README.md | 4 +- Master/texmf-dist/doc/latex/tagpdf/ex-AF-file.pdf | 24 +-- .../doc/latex/tagpdf/ex-alt-actualtext.pdf | Bin 34295 -> 34295 bytes .../texmf-dist/doc/latex/tagpdf/ex-attribute.pdf | 14 +- .../doc/latex/tagpdf/ex-formula-problem.pdf | 14 +- Master/texmf-dist/doc/latex/tagpdf/ex-list.pdf | 14 +- .../tagpdf/ex-mc-manual-para-split-obsolete.pdf | 14 +- .../texmf-dist/doc/latex/tagpdf/ex-softhyphen.pdf | 14 +- .../doc/latex/tagpdf/ex-spaceglyph-listings.pdf | 14 +- .../doc/latex/tagpdf/ex-structure-obsolete.pdf | 14 +- .../doc/latex/tagpdf/ex-tagpdf-template.pdf | 50 ++--- Master/texmf-dist/doc/latex/tagpdf/tagpdf-code.pdf | Bin 1667114 -> 1617309 bytes Master/texmf-dist/doc/latex/tagpdf/tagpdf.bib | 48 ++++- Master/texmf-dist/doc/latex/tagpdf/tagpdf.pdf | Bin 1103114 -> 1156337 bytes Master/texmf-dist/doc/latex/tagpdf/tagpdf.tex | 234 +++++++++++++-------- .../doc/latex/tagpdf/tagpdfsetup-keys.tex | 70 ++++++ 16 files changed, 339 insertions(+), 189 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/tagpdf/tagpdfsetup-keys.tex (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/tagpdf/README.md b/Master/texmf-dist/doc/latex/tagpdf/README.md index 0635cfcf851..63cec98476f 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/README.md +++ b/Master/texmf-dist/doc/latex/tagpdf/README.md @@ -1,6 +1,6 @@ #tagpdf — A package to create tagged pdf -Packageversion: 0.98v -Packagedate: 2024/02/04 +Packageversion: 0.98w +Packagedate: 2024/02/22 Author: Ulrike Fischer, LaTeX Project Team ## License diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-AF-file.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-AF-file.pdf index 337e15047b3..10e04d0ab6e 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/ex-AF-file.pdf +++ b/Master/texmf-dist/doc/latex/tagpdf/ex-AF-file.pdf @@ -1,11 +1,11 @@ %PDF-2.0 %ÌÕÁÔÅØÐÄÆ 22 0 obj -<< /Subtype /application#2Fx-tex/Type /EmbeddedFile /Params<> /Length 151 >> +<< /Subtype /application#2Fx-tex/Type /EmbeddedFile /Params<> /Length 151 >> stream %% LaTeX2e file `example-input-file.tex' %% generated by the `filecontents' environment -%% from source `ex-AF-file' on 2024/02/04. +%% from source `ex-AF-file' on 2024/02/22. %% Additional info! @@ -15,7 +15,7 @@ endobj << /Type /Filespec /AFRelationship /Unspecified /F /UF /EF<> >> endobj 25 0 obj -<< /Subtype /text#2Fplain/Type /EmbeddedFile /Params<> /Length 19 >> +<< /Subtype /text#2Fplain/Type /EmbeddedFile /Params<> /Length 19 >> stream Bär with teh shirt endstream @@ -24,7 +24,7 @@ endobj << /Type /Filespec /AFRelationship /Supplement /F /UF /EF<> >> endobj 28 0 obj -<< /Subtype /text#2Fplain/Type /EmbeddedFile /Params<> /Length 4 >> +<< /Subtype /text#2Fplain/Type /EmbeddedFile /Params<> /Length 4 >> stream Duck endstream @@ -242,17 +242,17 @@ stream - 2024-02-04T16:24:54+01:00 + 2024-02-22T23:22:47+01:00 application/pdf ex-AF-file.tex LaTeX - 2024-02-04T16:24:54+01:00 - 2024-02-04T16:24:54+01:00 - 2024-02-04T16:24:54+01:00 + 2024-02-22T23:22:47+01:00 + 2024-02-22T23:22:47+01:00 + 2024-02-22T23:22:47+01:00 uuid:38d5a844-2217-4081-87cc-b2129dc357a6 - uuid:46bb877d-d422-42b6-852c-1e35e1836535 + uuid:922cc914-e255-45d0-8c41-0a693aaec20c three 1 @@ -347,7 +347,7 @@ endobj << /Type /Namespace /NS (https://www.latex-project.org/ns/book/2022) /RoleMapNS 18 0 R >> endobj 19 0 obj -<< /Type /Namespace /NS (data:,86B8CC4-5278-3FD8-2A39-38BA676A5FDD) >> +<< /Type /Namespace /NS (data:,822344F4-764-B054-F214-EFA7E5F05397) >> endobj 8 0 obj [ 9 0 R 11 0 R 13 0 R 15 0 R 17 0 R 19 0 R ] @@ -449,7 +449,7 @@ endobj << /Type /Catalog /Pages 36 0 R /MarkInfo 37 0 R/Lang (de-DE)/Metadata 31 0 R/StructTreeRoot 5 0 R >> endobj 46 0 obj -<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240204162454+01'00')/ModDate (D:20240204162454+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> +<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240222232247+01'00')/ModDate (D:20240222232247+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> endobj xref 0 47 @@ -501,7 +501,7 @@ xref 0000020698 00000 n 0000020816 00000 n trailer -<< /Size 47 /Root 45 0 R /Info 46 0 R /ID [ <10D35F6F0AFD0725784B9221741EEDF1> <10D35F6F0AFD0725784B9221741EEDF1> ] >> +<< /Size 47 /Root 45 0 R /Info 46 0 R /ID [ <9D6A0157460D27414440104FDAADEEF0> <9D6A0157460D27414440104FDAADEEF0> ] >> startxref 21039 %%EOF diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-alt-actualtext.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-alt-actualtext.pdf index 3688c60cbd3..823bf350584 100644 Binary files a/Master/texmf-dist/doc/latex/tagpdf/ex-alt-actualtext.pdf and b/Master/texmf-dist/doc/latex/tagpdf/ex-alt-actualtext.pdf differ diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-attribute.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-attribute.pdf index b70311cc2ea..7e5c8058319 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/ex-attribute.pdf +++ b/Master/texmf-dist/doc/latex/tagpdf/ex-attribute.pdf @@ -216,17 +216,17 @@ stream - 2024-02-04T16:25:54+01:00 + 2024-02-22T23:23:43+01:00 application/pdf ex-attribute.tex LaTeX - 2024-02-04T16:25:54+01:00 - 2024-02-04T16:25:54+01:00 - 2024-02-04T16:25:54+01:00 + 2024-02-22T23:23:43+01:00 + 2024-02-22T23:23:43+01:00 + 2024-02-22T23:23:43+01:00 uuid:7a9cf910-1c19-429a-8f24-339c62d8a57f - uuid:56507ade-9637-4af9-8b4e-db0a75fca225 + uuid:065f0cda-84f8-4a6e-8389-031fc1a6106d three 1 @@ -449,7 +449,7 @@ endobj << /Type /Catalog /Pages 26 0 R /MarkInfo 27 0 R/Lang (de_DE)/Metadata 21 0 R/StructTreeRoot 5 0 R >> endobj 38 0 obj -<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/Title (Title)/CreationDate (D:20240204162554+01'00')/ModDate (D:20240204162554+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> +<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/Title (Title)/CreationDate (D:20240222232343+01'00')/ModDate (D:20240222232343+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> endobj xref 0 39 @@ -493,7 +493,7 @@ xref 0000017720 00000 n 0000017838 00000 n trailer -<< /Size 39 /Root 37 0 R /Info 38 0 R /ID [ <5C6A3964C54F6EE4C18E93DFDB746F1D> <5C6A3964C54F6EE4C18E93DFDB746F1D> ] >> +<< /Size 39 /Root 37 0 R /Info 38 0 R /ID [ <1A03E1D431E20C44F3C40BCA13F7CA44> <1A03E1D431E20C44F3C40BCA13F7CA44> ] >> startxref 18075 %%EOF diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-formula-problem.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-formula-problem.pdf index f8cd961bef4..abecb1df8ec 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/ex-formula-problem.pdf +++ b/Master/texmf-dist/doc/latex/tagpdf/ex-formula-problem.pdf @@ -239,17 +239,17 @@ stream - 2024-02-04T16:26:24+01:00 + 2024-02-22T23:24:12+01:00 application/pdf ex-formula-problem.tex LaTeX - 2024-02-04T16:26:24+01:00 - 2024-02-04T16:26:24+01:00 - 2024-02-04T16:26:24+01:00 + 2024-02-22T23:24:12+01:00 + 2024-02-22T23:24:12+01:00 + 2024-02-22T23:24:12+01:00 uuid:8eb2ce1d-b2ec-440a-8bc2-73733eb3eeb0 - uuid:b93eb6f7-df10-41e5-8954-2e1480c6450e + uuid:96efc9b7-a599-4aad-8efa-a4a6f3bb1a83 three 2 @@ -425,7 +425,7 @@ endobj << /Type /Catalog /Pages 16 0 R /MarkInfo 23 0 R/Lang (de-DE)/Metadata 19 0 R/StructTreeRoot 5 0 R >> endobj 33 0 obj -<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240204162624+01'00')/ModDate (D:20240204162624+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> +<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240222232412+01'00')/ModDate (D:20240222232412+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> endobj xref 0 34 @@ -464,7 +464,7 @@ xref 0000018886 00000 n 0000019004 00000 n trailer -<< /Size 34 /Root 32 0 R /Info 33 0 R /ID [ ] >> +<< /Size 34 /Root 32 0 R /Info 33 0 R /ID [ <8B9D540F4DC33CE1434F842EF4863C9C> <8B9D540F4DC33CE1434F842EF4863C9C> ] >> startxref 19227 %%EOF diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-list.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-list.pdf index 1d1e99d3d49..ea24cdcef6c 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/ex-list.pdf +++ b/Master/texmf-dist/doc/latex/tagpdf/ex-list.pdf @@ -210,17 +210,17 @@ stream - 2024-02-04T16:26:54+01:00 + 2024-02-22T23:24:42+01:00 application/pdf ex-list.tex LaTeX - 2024-02-04T16:26:54+01:00 - 2024-02-04T16:26:54+01:00 - 2024-02-04T16:26:54+01:00 + 2024-02-22T23:24:42+01:00 + 2024-02-22T23:24:42+01:00 + 2024-02-22T23:24:42+01:00 uuid:4c749825-1de7-414c-879f-29e4d0bef66e - uuid:953ef2d0-e619-4cff-8823-dd0e50200ab4 + uuid:2fc1dbf9-e70e-4fc2-8fbe-fff091ce17c3 three 1 @@ -653,7 +653,7 @@ endobj << /Type /Catalog /Pages 54 0 R /MarkInfo 55 0 R/Lang (en-US)/Metadata 48 0 R/StructTreeRoot 5 0 R >> endobj 72 0 obj -<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240204162654+01'00')/ModDate (D:20240204162654+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> +<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240222232442+01'00')/ModDate (D:20240222232442+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> endobj xref 0 73 @@ -731,7 +731,7 @@ xref 0000029592 00000 n 0000029710 00000 n trailer -<< /Size 73 /Root 71 0 R /Info 72 0 R /ID [ <919034DA36C84F01F9BD978C4647D563> <919034DA36C84F01F9BD978C4647D563> ] >> +<< /Size 73 /Root 71 0 R /Info 72 0 R /ID [ ] >> startxref 29933 %%EOF diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-mc-manual-para-split-obsolete.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-mc-manual-para-split-obsolete.pdf index 6e6b51cce87..cb9740d0222 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/ex-mc-manual-para-split-obsolete.pdf +++ b/Master/texmf-dist/doc/latex/tagpdf/ex-mc-manual-para-split-obsolete.pdf @@ -243,17 +243,17 @@ stream - 2024-02-04T16:27:21+01:00 + 2024-02-22T23:25:08+01:00 application/pdf ex-mc-manual-para-split-obsolete.tex LaTeX - 2024-02-04T16:27:21+01:00 - 2024-02-04T16:27:21+01:00 - 2024-02-04T16:27:21+01:00 + 2024-02-22T23:25:08+01:00 + 2024-02-22T23:25:08+01:00 + 2024-02-22T23:25:08+01:00 uuid:c33d64b4-96ec-4e48-8f27-0b3edc831547 - uuid:f55806bc-d889-4918-8fed-972dca883fe4 + uuid:2fed5a6c-01de-4c90-8a51-19fd520415a3 three 2 @@ -413,7 +413,7 @@ endobj << /Type /Catalog /Pages 14 0 R /Lang (en-US)/Metadata 15 0 R >> endobj 25 0 obj -<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240204162721+01'00')/ModDate (D:20240204162721+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> +<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240222232508+01'00')/ModDate (D:20240222232508+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> endobj xref 0 26 @@ -444,7 +444,7 @@ xref 0000023897 00000 n 0000023978 00000 n trailer -<< /Size 26 /Root 24 0 R /Info 25 0 R /ID [ <7D716B199BC4F3135271DDE3C3416149> <7D716B199BC4F3135271DDE3C3416149> ] >> +<< /Size 26 /Root 24 0 R /Info 25 0 R /ID [ <0C901AF132BA870423F64B7A9333C038> <0C901AF132BA870423F64B7A9333C038> ] >> startxref 24201 %%EOF diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-softhyphen.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-softhyphen.pdf index 2c2939934d2..45d200a8d59 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/ex-softhyphen.pdf +++ b/Master/texmf-dist/doc/latex/tagpdf/ex-softhyphen.pdf @@ -210,17 +210,17 @@ stream - 2024-02-04T16:27:46+01:00 + 2024-02-22T23:25:33+01:00 application/pdf ex-softhyphen.tex LaTeX - 2024-02-04T16:27:46+01:00 - 2024-02-04T16:27:46+01:00 - 2024-02-04T16:27:46+01:00 + 2024-02-22T23:25:33+01:00 + 2024-02-22T23:25:33+01:00 + 2024-02-22T23:25:33+01:00 uuid:aa82e685-4098-469d-861c-3c45dfc700c7 - uuid:2a630ad7-ee3c-44e5-8ab2-730213a2c266 + uuid:220ecb1a-1ca6-4b81-8426-907f7c14c789 three 1 @@ -393,7 +393,7 @@ endobj << /Type /Catalog /Pages 19 0 R /MarkInfo 20 0 R/Lang (en-US)/Metadata 14 0 R/StructTreeRoot 5 0 R >> endobj 30 0 obj -<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240204162746+01'00')/ModDate (D:20240204162746+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> +<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240222232533+01'00')/ModDate (D:20240222232533+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> endobj xref 0 31 @@ -429,7 +429,7 @@ xref 0000018116 00000 n 0000018234 00000 n trailer -<< /Size 31 /Root 29 0 R /Info 30 0 R /ID [ ] >> +<< /Size 31 /Root 29 0 R /Info 30 0 R /ID [ <09007091BD82F7217F0AE2883B15CE9E> <09007091BD82F7217F0AE2883B15CE9E> ] >> startxref 18457 %%EOF diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-spaceglyph-listings.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-spaceglyph-listings.pdf index aa5f7113ce3..6066138ec28 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/ex-spaceglyph-listings.pdf +++ b/Master/texmf-dist/doc/latex/tagpdf/ex-spaceglyph-listings.pdf @@ -210,17 +210,17 @@ stream - 2024-02-04T16:28:10+01:00 + 2024-02-22T23:25:56+01:00 application/pdf ex-spaceglyph-listings.tex LaTeX - 2024-02-04T16:28:10+01:00 - 2024-02-04T16:28:10+01:00 - 2024-02-04T16:28:10+01:00 + 2024-02-22T23:25:56+01:00 + 2024-02-22T23:25:56+01:00 + 2024-02-22T23:25:56+01:00 uuid:acdc2435-bf29-4e54-8d09-1c9b6dc32038 - uuid:69467ac3-e2d3-481a-84aa-be8b39fc3381 + uuid:8de9f9de-17f8-4963-8fc9-32008bdcce27 three 1 @@ -354,7 +354,7 @@ endobj << /Type /Catalog /Pages 15 0 R /MarkInfo 16 0 R/Lang (en-US)/Metadata 10 0 R/StructTreeRoot 5 0 R >> endobj 26 0 obj -<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240204162810+01'00')/ModDate (D:20240204162810+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> +<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240222232556+01'00')/ModDate (D:20240222232556+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> endobj xref 0 27 @@ -386,7 +386,7 @@ xref 0000015484 00000 n 0000015602 00000 n trailer -<< /Size 27 /Root 25 0 R /Info 26 0 R /ID [ ] >> +<< /Size 27 /Root 25 0 R /Info 26 0 R /ID [ ] >> startxref 15825 %%EOF diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-structure-obsolete.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-structure-obsolete.pdf index 7ed1e6242f6..5a4b2b37f15 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/ex-structure-obsolete.pdf +++ b/Master/texmf-dist/doc/latex/tagpdf/ex-structure-obsolete.pdf @@ -210,17 +210,17 @@ stream - 2024-02-04T16:28:36+01:00 + 2024-02-22T23:26:20+01:00 application/pdf ex-structure-obsolete.tex LaTeX - 2024-02-04T16:28:36+01:00 - 2024-02-04T16:28:36+01:00 - 2024-02-04T16:28:36+01:00 + 2024-02-22T23:26:20+01:00 + 2024-02-22T23:26:20+01:00 + 2024-02-22T23:26:20+01:00 uuid:bf5e4a2b-cfa9-4fc5-878c-8f9d2ee95445 - uuid:a23ea6f7-ae97-45e7-82e8-052481d4b120 + uuid:3eeee032-14a3-4af9-8f50-e80ac4a9a8e4 three 1 @@ -526,7 +526,7 @@ endobj << /Type /Catalog /Pages 26 0 R /MarkInfo 27 0 R/Lang (en-US)/Metadata 20 0 R/StructTreeRoot 5 0 R >> endobj 43 0 obj -<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240204162836+01'00')/ModDate (D:20240204162836+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> +<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240222232620+01'00')/ModDate (D:20240222232620+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> endobj xref 0 44 @@ -575,7 +575,7 @@ xref 0000023426 00000 n 0000023544 00000 n trailer -<< /Size 44 /Root 42 0 R /Info 43 0 R /ID [ ] >> +<< /Size 44 /Root 42 0 R /Info 43 0 R /ID [ <8C6DD20E978698F0DE752E546A93C3E9> <8C6DD20E978698F0DE752E546A93C3E9> ] >> startxref 23767 %%EOF diff --git a/Master/texmf-dist/doc/latex/tagpdf/ex-tagpdf-template.pdf b/Master/texmf-dist/doc/latex/tagpdf/ex-tagpdf-template.pdf index f06bd1838d5..1bbc8c530da 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/ex-tagpdf-template.pdf +++ b/Master/texmf-dist/doc/latex/tagpdf/ex-tagpdf-template.pdf @@ -210,17 +210,17 @@ stream - 2024-02-04T16:29:02+01:00 + 2024-02-22T23:26:46+01:00 application/pdf ex-tagpdf-template.tex LaTeX - 2024-02-04T16:29:02+01:00 - 2024-02-04T16:29:02+01:00 - 2024-02-04T16:29:02+01:00 + 2024-02-22T23:26:46+01:00 + 2024-02-22T23:26:46+01:00 + 2024-02-22T23:26:46+01:00 uuid:f320abfc-f6ab-4d12-8719-d176f4d947cf - uuid:09e3ba2b-d440-481c-84c5-ec325f7e692b + uuid:0724bd50-3cc7-47a7-8c40-a7b4df91a045 three 1 @@ -306,7 +306,7 @@ endobj << /Type /Namespace /NS (https://www.latex-project.org/ns/book/2022) /RoleMapNS 18 0 R >> endobj 19 0 obj -<< /Type /Namespace /NS (data:,742A6FB5-B116-EDEB-CE34-2B5E2DFF57D0) >> +<< /Type /Namespace /NS (data:,D23E8AA3-3C3B-E3B-C789-DBEFB598C460) >> endobj 8 0 obj [ 9 0 R 11 0 R 13 0 R 15 0 R 17 0 R 19 0 R ] @@ -398,7 +398,7 @@ endobj << /Type /Catalog /Pages 31 0 R /MarkInfo 32 0 R/Lang (en-US)/Metadata 26 0 R/StructTreeRoot 5 0 R >> endobj 42 0 obj -<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240204162902+01'00')/ModDate (D:20240204162902+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> +<< /Producer (luahbtex-1.17.0)/Creator (LaTeX)/CreationDate (D:20240222232646+01'00')/ModDate (D:20240222232646+01'00') /Trapped /False /PTEX.FullBanner (This is LuaHBTeX, Version 1.17.0 (TeX Live 2023)) >> endobj xref 0 43 @@ -407,10 +407,10 @@ xref 0000000003 00000 f 0000000004 00000 f 0000000010 00000 f -0000014807 00000 n +0000014806 00000 n 0000012015 00000 n 0000012225 00000 n -0000014242 00000 n +0000014241 00000 n 0000012867 00000 n 0000000012 00000 f 0000012935 00000 n @@ -423,30 +423,30 @@ xref 0000013875 00000 n 0000014153 00000 n 0000000000 00000 f -0000014303 00000 n -0000014400 00000 n -0000014487 00000 n -0000014574 00000 n -0000014673 00000 n +0000014302 00000 n +0000014399 00000 n +0000014486 00000 n +0000014573 00000 n +0000014672 00000 n 0000000020 00000 n 0000011869 00000 n 0000011734 00000 n 0000011500 00000 n -0000017428 00000 n -0000017782 00000 n +0000017427 00000 n +0000017781 00000 n 0000011979 00000 n 0000012056 00000 n 0000012188 00000 n 0000012804 00000 n -0000014944 00000 n -0000016385 00000 n -0000015031 00000 n -0000016606 00000 n -0000017582 00000 n -0000017844 00000 n -0000017962 00000 n +0000014943 00000 n +0000016384 00000 n +0000015030 00000 n +0000016605 00000 n +0000017581 00000 n +0000017843 00000 n +0000017961 00000 n trailer -<< /Size 43 /Root 41 0 R /Info 42 0 R /ID [ <308775A820C8CCFDD397720B69A96080> <308775A820C8CCFDD397720B69A96080> ] >> +<< /Size 43 /Root 41 0 R /Info 42 0 R /ID [ <7984D150CB27BF39829D2CAE888D8E38> <7984D150CB27BF39829D2CAE888D8E38> ] >> startxref -18185 +18184 %%EOF diff --git a/Master/texmf-dist/doc/latex/tagpdf/tagpdf-code.pdf b/Master/texmf-dist/doc/latex/tagpdf/tagpdf-code.pdf index 8cb02cff589..b639df8b253 100644 Binary files a/Master/texmf-dist/doc/latex/tagpdf/tagpdf-code.pdf and b/Master/texmf-dist/doc/latex/tagpdf/tagpdf-code.pdf differ diff --git a/Master/texmf-dist/doc/latex/tagpdf/tagpdf.bib b/Master/texmf-dist/doc/latex/tagpdf/tagpdf.bib index c4a48b605ba..2f2cc7c293c 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/tagpdf.bib +++ b/Master/texmf-dist/doc/latex/tagpdf/tagpdf.bib @@ -1,8 +1,9 @@ @online{pdfreference, title= {PDF Reference, sixth edition}, author={{Adobe Systems Incorporated}}, -url = {https://www.adobe.com/content/dam/acom/en/devnet/pdf/pdfs/PDF32000_2008.pdf}, -year = {2006} +url = {https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/pdfreference1.7old.pdf}, +year = {2006}, +urldate={2024-02-17}, } @book{pdfspec-iso32000-1, @@ -10,8 +11,8 @@ year = {2006} title={Document management -- Portable document format -- Part 1: PDF 1.7}, date={2008-07-01}, edition={1}, - url={https://www.adobe.com/content/dam/acom/en/devnet/pdf/pdfs/PDF32000_2008.pdf}, - urldate={2021-04-18}, + url={https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf}, + urldate={2024-02-17}, } @@ -34,22 +35,28 @@ year = {2006} url={https://www.iso.org/obp/ui/#iso:std:iso:32000:-2:ed-2:v1:en}, urldate={2021-04-18}, } -@online{pac3, -title = {PDF Accessibility Checker (PAC 3)}, -author= {{Zugang für alle -- Schweizerische Stiftung zur behindertengerechten Technologienutzung}}, -url = {http://www.access-for-all.ch/ch/pdf-werkstatt/pdf-accessibility-checker-pac.html}, -urldate ={2018-07-05}} +@online{pac2024, +title = {PDF Accessibility Checker (PAC 2024)}, +url = {https://pac.pdf-accessibility.org/}, +urldate ={2024-02-17}} @online{verapdf, title = {veraPDF}, author={{veraPDF consortium}}, -url = {http://verapdf.org/} +url = {https://verapdf.org/} } @online{ngpdf, title = {Next-Generation PDF}, author={{Dual Lab}}, -url = {http://ngpdf.com/} +url = {https://ngpdf.com} +} + +@online{mathexamples, +title = {MathML Associated Files Examples}, +author={\LaTeX\ Project}, +url = {https://github.com/latex3/tagging-project/discussions/56}, +urldate={2024-02-19} } @online{tugaccess, @@ -57,3 +64,22 @@ title={PDF accessibility and PDF standards}, author= {{TeX User Group}}, url= {https://tug.org/twg/accessibility/} } + +@inproceedings{todasoifferdeims2024, +author={Roman Toda and Jing Mu and Youqiang Wu and Neil Soiffer}, +title = {PDF Document Object Model Support for Math}, +year={2024}, +booktitle = {The 5th International Workshop on Digitization and E-Inclusion in Mathematics and Science 2024}, +publisher = {The DEIMS2024 Organizing Committee}, +url={https://workshop.sciaccess.net/deims2024/DEIMS2024_Proceedings.zip} +} + +@inproceedings{mittelbachfischerdeims2024, +author={Frank Mittelbach und Ulrike Fischer}, +title = {Enhancing LATEX to Automatically Produce Tagged and +Accessible PDF}, +year={2024}, +booktitle = {The 5th International Workshop on Digitization and E-Inclusion in Mathematics and Science 2024}, +publisher = {The DEIMS2024 Organizing Committee}, +url={https://workshop.sciaccess.net/deims2024/DEIMS2024_Proceedings.zip} +} diff --git a/Master/texmf-dist/doc/latex/tagpdf/tagpdf.pdf b/Master/texmf-dist/doc/latex/tagpdf/tagpdf.pdf index bbd66f6ce57..86868f1382b 100644 Binary files a/Master/texmf-dist/doc/latex/tagpdf/tagpdf.pdf and b/Master/texmf-dist/doc/latex/tagpdf/tagpdf.pdf differ diff --git a/Master/texmf-dist/doc/latex/tagpdf/tagpdf.tex b/Master/texmf-dist/doc/latex/tagpdf/tagpdf.tex index 054d511baa6..c08c8406d9f 100644 --- a/Master/texmf-dist/doc/latex/tagpdf/tagpdf.tex +++ b/Master/texmf-dist/doc/latex/tagpdf/tagpdf.tex @@ -10,14 +10,14 @@ \DocumentMetadata { % comment the following line to compile an untagged documentation: - testphase=phase-III, + testphase={phase-III,title,table}, pdfversion=2.0,lang=en-UK,pdfstandard=a-4,pdfstandard=ua-2 %uncompress } \DebugBlocksOff \makeatletter -\def\UlrikeFischer@package@version{0.98v} -\def\UlrikeFischer@package@date{2024-02-04} +\def\UlrikeFischer@package@version{0.98w} +\def\UlrikeFischer@package@date{2024-02-22} \makeatother \documentclass[bibliography=totoc,a4paper]{article} @@ -36,7 +36,8 @@ \usepackage[noparboxrestore]{marginnote} \reversemarginpar - +\usepackage{booktabs} +\setlength\belowcaptionskip{10pt} \usepackage{tcolorbox} \usepackage{tikz} @@ -282,9 +283,11 @@ One must check how good the accessibility is \emph{practically}. Syntax validation and formal standard validation can be done for example with -preflight of the (non-free) Adobe Acrobat. It can also be done also with the -free \PDF{} Accessibility Checker (PAC~2021) \parencite{pac3}. There is also -the validator veraPDF \parencite{verapdf}. A rather new and quite useful tool +preflight of the (non-free) Adobe Acrobat. It can also be done +(only for PDF 1.7 and older) also with the +free \PDF{} Accessibility Checker (PAC~2024) \parencite{pac2024}. There is also +the validator veraPDF \parencite{verapdf} which can also handle PDF 2.0 files. +A quite useful tool is \enquote{Next Generation PDF} \parencite{ngpdf}, a browser application which converts a tagged PDF to html, allows to inspect its structure and also to edit the structure. For PDF~2.0 files there is also a checker based on the @@ -337,7 +340,7 @@ improvements and new features in the \LaTeX\ kernel, the latex-lab bundle and the \PDF\ management code and is now much better. Only a few structures---mostly some from currently unsupported packages--- still need manual tagging. But sadly the output of the validators don't quite reflect -the improvements. The documentation uses now \PDF~2.0 and PAC~3 can't handle +the improvements. The documentation uses now \PDF~2.0 and PAC~2024 can't handle this, it claims that the file is damaged. The Adobe validator has a bug and doesn't like the (valid) use of the \texttt{Lbl} tag for the section numbers (see figure~\ref{fig:adobe}). @@ -396,7 +399,7 @@ some text When loading \pkg{tagpdf} through the \texttt{testphase} keys, it is automatically activated. To deactivate it while still retaining all the other new code from the latex-lab testphase files, -use in the preamble |\tagpdfsetup{activate-all=false}|. You can additionally also deactivate the +use in the preamble |\tagpdfsetup{activate/all=false}|. You can additionally also deactivate the paratagging and the interword space code. To suppress the loading of the package altogether you can try @@ -461,74 +464,70 @@ This command setups the general behavior of the package. The command should be normally used only in the preamble (for a few keys it could also make sense to change them in the document). -The key-val list understands the following keys: +The key-val list understands at least the following keys. More keys are defined in some of the latex-lab module, see table~\ref{tab:setupkey} for an overview which also includes older, now deprecated names. + +\begin{table} +\caption{Overview over keys for \cs{tagpdfsetup}}\label{tab:setupkey} +\input{tagpdfsetup-keys} +\end{table} \begin{description} -\item[\PrintKeyName{activate-all}] Boolean, initially false. Activates +\item[\PrintKeyName{activate/all}] Boolean, initially false. Activates everything, that's normally the sensible thing to do. -\item [\PrintKeyName{activate}] Like |activate-all|, +\item [\PrintKeyName{activate}] Like |activate/all|, \emph{additionally} is opens at begin document a structure with |\tagstructbegin| and closes it at end document. The key accepts as value a tag name which is used as the tag of the structure. The default value is |Document|. -\item[\PrintKeyName{activate-mc}] Boolean, initially false. Activates +\item[\PrintKeyName{activate/mc}] Boolean, initially false. Activates the code related to marked content. -\item[\PrintKeyName{activate-struct}] Boolean, initially +\item[\PrintKeyName{activate/struct}] Boolean, initially false. Activates the code related to structures. Should be used only - if \PrintKeyName{activate-mc} has been used too. + if \PrintKeyName{activate/mc} has been used too. -\item[\PrintKeyName{no-struct-dest}] Starting with version 0.93 +\item[\PrintKeyName{activate/struct-dest}] Boolean, initially true. + Starting with version 0.93 \pkg{tagpdf} will create automatically structure destinations (see - section~\ref{sec:struct-dest} if \pkg{hyperref} is used, if the - engine supports it and if the pdf version is 2.0. With this key this + section~\ref{sec:struct-dest} if \pkg{hyperref} is used and if the + engine supports it. With this key this can be suppressed. -\item[\PrintKeyName{activate-tree}] Boolean, initially +\item[\PrintKeyName{activate/tree}] Boolean, initially false. Activates the code related to trees. Should be used only if the two other keys has been used too. -\item[\PrintKeyName{add-new-tag}] Allows to define new tag names, see - section \ref{sec:new-tag} for a description. - -\item[\PrintKeyName{interwordspace}] Choice key, possible values are - \PrintKeyName{true}/""\PrintKeyName{on} and - \PrintKeyName{false}/\PrintKeyName{off}. The key +\item[\PrintKeyName{activate/spaces}] Boolean. The key activates/deactivates the insertion of space glyphs, see section~\ref{sec:spacechars}. In the luamode it only works if at - least \PrintKeyName{activate-mc} has been used. + least \PrintKeyName{activate/mc} has been used. + The old name of the key |interwordspace| is still supported but deprecated. -\item[\PrintKeyName{log}] Choice key, possible values - \PrintKeyName{none}, \PrintKeyName{v}, \PrintKeyName{vv}, - \PrintKeyName{vvv}, \PrintKeyName{all}. Setups the log level. - Changing the value affects currently mostly the luamode: - \enquote{higher} values gives more messages in the log. The current - levels and messages have been setup in a quite ad-hoc manner and - will need improvement. -\item[\PrintKeyName{newattribute}] This key takes two arguments and +\item[\PrintKeyName{role/new-tag}] Allows to define new tag names, see + section \ref{sec:new-tag} for a description. + +\item[\PrintKeyName{role/new-attribute}] This key takes two arguments and declares an attribute. See \ref{sec:attributes}. + +\item[\PrintKeyName{role/map-tags}] This key allows to remap the structure +tags. Currently it supports only two values: |false| (the default) and |pdf| which +maps all tags to their standard PDF role, e.g. |itemize| will be mapped to |L|. -\item[\PrintKeyName{show-spaces}] Boolean.\sidenote{luamode} That's a - debug option, it helps in lua mode to see where space glyph will be - inserted if \PrintKeyName{interwordspace} is activated. -\item[\PrintKeyName{paratagging}] Boolean. This activate/deactivates +\item[\PrintKeyName{para/tagging}] Boolean. This activate/deactivates the automatic tagging of paragraphs, see \ref{sec:paratagging} for more background. It uses the \texttt{para/begin} and - \texttt{para/end} hooks of the newest \LaTeX{} version (2021-05-01). + \texttt{para/end} hooks. With more tagging support conditions will be added, that means the code is bound to change! Paragraphs can appear in many unexpected places and the code can easily break, so there is also an option to see where such paragraphs are: -\item[\PrintKeyName{paratagging-show}] Boolean. This - activate/deactivates small red and green numbers in the places where - the paratagging hook code is used. -\item[\PrintKeyName{paratag}] String. This key changes the second tag +\item[\PrintKeyName{para/tag}] String. This key changes the second tag used by the paratagging code. The default tag is \texttt{text}, a \LaTeX{} specific tag that is role mapped to \texttt{P}. A useful local setting here can be \texttt{NonStruct}, which creates a @@ -536,7 +535,14 @@ The key-val list understands the following keys: recommended to use the newer \cs{tagtool} command described below instead of \cs{tagpdfsetup}. -\item[\PrintKeyName{tabsorder}] Choice key, possible values are +\item[\PrintKeyName{para/maintag}] String. This key changes the first tag + used by the paratagging code. The default tag is \texttt{text-unit}, a + \LaTeX{} specific tag that is role mapped to \texttt{Part}. + For local changes it is + recommended to use the newer \cs{tagtool} command described below + instead of \cs{tagpdfsetup}. + +\item[\PrintKeyName{page/tabsorder}] Choice key, possible values are \PrintKeyName{row}, \PrintKeyName{column}, \PrintKeyName{structure}, \PrintKeyName{none}. This decides if a \verb+/Tabs+ value is written to the dictionary of the page objects. Not really needed for @@ -544,7 +550,7 @@ The key-val list understands the following keys: accessibility checks. So I added it. Currently the tabsorder is the same for all pages. Perhaps this should be changed \ldots. -\item[\PrintKeyName{tagunmarked}] Boolean,\sidenote{luamode} initially +\item[\PrintKeyName{activate/tagunmarked}] Boolean,\sidenote{luamode} initially true. When this boolean is true, the lua code will try to mark everything that has not been marked yet as an artifact. The benefit is that one doesn't have to mark up every deco rule oneself. The @@ -553,10 +559,36 @@ The key-val list understands the following keys: annotations etc. See also section~\ref{sec:lazy} for a discussion about automatic tagging. -\item[\PrintKeyName{uncompress}] Sets both the \PDF{} compresslevel +\item[\PrintKeyName{debug/uncompress}] Sets both the \PDF{} compresslevel and the \PDF{} objcompresslevel to 0 and so allows to inspect the - \PDF{}. + \PDF{}. No really useful anymore as this can also + be set in \cs{DocumentMetadata}. +\item[\PrintKeyName{debug}] This keys knows a number of sub-keys to + set various debug options. + \begin{description} + \item[\PrintKeyName{debug/show}] This takes a comma list of keywords: + + \texttt{spaces}/\texttt{spacesOff}: \sidenote{luamode} + That helps in lua mode to see where space glyph will be + inserted if \PrintKeyName{activate/spaces} is activated. + This can also be activated with the now deprecated key |show-spaces| + + \texttt{para}/\texttt{paraOff}: This (locally) + activates/deactivates small red and green numbers in the places where + the paratagging hook code is used. + + + \item[\PrintKeyName{debug/log}] Choice key, possible values + \PrintKeyName{none}, \PrintKeyName{v}, \PrintKeyName{vv}, + \PrintKeyName{vvv}, \PrintKeyName{all}. Setups the log level. + Changing the value affects currently mostly the luamode: + \enquote{higher} values gives more messages in the log. The current + levels and messages have been setup in a quite ad-hoc manner and + will need improvement. + + + \end{description} \end{description} @@ -576,18 +608,18 @@ should be used as the implementation will change to improve the speed. Currently the following arguments are supported \begin{description} -\item[\PrintKeyName{para}] Boolean. It will replace the +\item[\PrintKeyName{para/tagging}] Boolean. It will replace the \cs{tagpdfparaOn} and \cs{tagpdfparaOff} command. -\item[\PrintKeyName{unittag}] String. It allows to change the outer +\item[\PrintKeyName{para/maintag}] String. It allows to change the outer tag used in the following automatically tagged paragraphs. The setting is local. -\item[\PrintKeyName{paratag}] String. It allows to change the inner +\item[\PrintKeyName{para/tag}] String. It allows to change the inner tag used in the following automatically tagged paragraphs. The setting is local. -\item[\PrintKeyName{para-flattened}] Boolean. If set it will suppress +\item[\PrintKeyName{para/flattened}] Boolean. If set it will suppress the outer structure in the automatic paratagging. This should be applied to the start and end hook in the same way! The setting is local. @@ -992,7 +1024,7 @@ The key-val list understands the following keys: The\sidenote{lua mode only} lua mode will mark up everything unmarked as \texttt{artifact=notype}. You can suppress this behavior by setting the - tagpdfsetup key \texttt{tagunmarked} to false. See section + tagpdfsetup key \texttt{activate/tagunmarked} to false. See section \ref{ssec:setup}. \item[\PrintKeyName{stash}] Normally marked content will be stored in the @@ -1382,9 +1414,30 @@ commands are used: \subsubsection{Math} +Math is still a problem but some progress has been made. +To tag math you have to surround it with a \texttt{Formula} structure. But the content of such a structure is handled by readers as a black box so additional data is needed for accessibility. + +There are a number of theoretical options here: +\begin{enumerate} +\item One can add an alternative text (\texttt{/Alt}) or an \texttt{/ActualText} +to the structure element either some text manually provided by the author or (with +the math module in the latex-lab bundle) the \LaTeX-source). +\item One can add an alternative text (\texttt{/Alt} or \texttt{/ActualText}) +to the MC-chunks. +\item One can build inside the \texttt{Formula} structure element a tree with MathML structure elements --- with PDF 2.0 this not require to declare new tags as the MathML name space is built-in. +\item One can in PDF 2.0 attach a MathML file and/or the \LaTeX-source as associated file to the \texttt{Formula} structure (or to one or more MC-chunks). +\end{enumerate} +The question is how these work in reality. + +Option 1 and 2 give not too bad results +with a screen reader, but can +require manual work and if you are unlucky the reader drops +important part of the math (like punctuation symbols). +Exploring the equation is not possible. -Math is a problem. I have seen an example where \emph{every single +Option 3 creates many structure elements. +E.g. I have seen an example where \emph{every single symbol} has been marked up with tags from MathML along with an \texttt{/ActualText} entry and an entry with alternate text which describes how to read the symbol. The \PDF{} then looked like this @@ -1403,19 +1456,20 @@ If this is really the way to go one would need some script to add the mark-up as doing it manually is too much work and would make the source unreadable -- at least with pdflatex and the generic mode. In lua mode is it possible to hook into the \texttt{mlist\_to\_hlist} -callback and add marker automatically. Some first implementation is -done by Marcel Krüger in the luamml project. - -But I'm not sure that this is the best way to do math. It looks rather +callback and add marker automatically. Some first implementation in this direction +has been done by Marcel Krüger in the luamml project. But up-to-now it was not possible +to test the usability of this approach: With the exception of the html derivation +with ngpdf no PDF-viewer/screen reader combination +seems to make use of such structures. +I'm not sure anyway that this is the best way to do math. It looks rather odd that a document should have to tell a screen reader in such detail -how to read an equation. It would be much more efficient, sensible and -flexible if a complete representation of the equation in mathML could -be stored in the \PDF{} and the task how to read this aloud delegated -to the screen reader. As \PDF{}~2.0 introduced associated files it is -probable that this will be the way to go but more investigations are -needed here. +how to read an equation. -See also section~\ref{sec:alt} for some more remarks and tests. +The last option 4 has been implemented in the math module in the \texttt{latex-lab} +bundle. Here happily a proof of +concept was possible: With development versions of foxit and the NVDA reader +it was possible to access an attached MathML and get speech output from it \cite{todasoifferdeims2024,mittelbachfischerdeims2024}. See also \cite{mathexamples} for some +examples and section~\ref{sec:alt} for some more remarks and tests. \subsubsection{Split paragraphs}\label{sec:splitpara} @@ -1448,7 +1502,7 @@ Pellentesque scelerisque sit amet, lacus.\tagmcend \end{taglstlisting} -Starting with version 0.92 there is code which tries to resolve this +Starting with version 0.92 there is code which resolves this problem. Basically it works like this: every mc-command issues a mark command (actually two slightly different). When the page is built in the output routine this mark commands are inspected and from them @@ -1461,14 +1515,13 @@ TUG~2021 \enquote{Taming the beast — Advances in paragraph tagging Please note \begin{itemize} -\item The code requires a \pkg{pdfmanagement-testphase} version v0.95i or newer. - \item Typically you will need more compilations than previously, don't rely on the rerun messages, but if something looks wrong rerun. \item The code relies on that related |\tagmcbegin| and |\tagmcend| are in the same boxing level. If one is in a box (which hides the - marks) and the other in the main galley, things will go wrong. + marks) and the other in the main galley, things will go wrong (\texttt{longtable} + is for example problematic). \end{itemize} \subsubsection{Automatic tagging of paragraphs}\label{sec:paratagging} @@ -1570,8 +1623,8 @@ of your own you must declare them. E.g. this declares two new types \begin{taglstlisting} \tagpdfsetup{ - add-new-tag = TAB/P, - add-new-tag = FIG/P, + role/new-tag = TAB/P, + role/new-tag = FIG/P, } \end{taglstlisting} @@ -1616,8 +1669,8 @@ nesting defines the level of a sectioning heading. The flat version is more \LaTeX-like and it is rather straightforward to patch \verb+\chapter+, \verb+\section+ and so on to insert the appropriates \texttt{H\ldots} start and end markers. The xml-like tree is more difficult -to automate. If such a tree is wanted I would recommend to use -- like the -context format -- explicit commands to start and end a sectioning unit. +to automate. It has been implemented in the sec module in latex-lab, but can break +if sectioning commands are hidden inside boxes. @@ -1861,7 +1914,7 @@ classes to a structure. To use such attributes you must at first declare it in \verb+\tagpdfsetup+ -with the key \texttt{newattribute}. This key takes two argument, a name and +with the key \texttt{role/new-attribute}. This key takes two argument, a name and the content of the attribute. The name should be a sensible key name, it is converted to a pdf name with \verb+\pdf_name_from_unicode_e:n+, so slashes and spaces are allow. The content should be a dictionary without the @@ -1871,9 +1924,9 @@ bracket. \begin{taglstlisting} \tagpdfsetup { - newattribute = + role/new-attribute = {TH-col}{/O /Table /Scope /Column}, - newattribute = + role/new-attribute = {TH-row}{/O /Table /Scope /Row}, } \end{taglstlisting} @@ -2112,10 +2165,10 @@ types or are \enquote{role mapped} to such a standard type. Such a role mapping is a simple key-value in the RoleMap dictionary. So instead of |H1| the type |section| could be used. The role mapping -can then be declared with the |add-new-tag| key: +can then be declared with the |role/new-tag| key: \begin{taglstlisting} - \tagpdfsetup{add-new-tag = section/H1} + \tagpdfsetup{role/new-tag = section/H1} \end{taglstlisting} In PDF 2.0 the situation is a bit more complicated. At first PDF~2.0 @@ -2185,7 +2238,7 @@ and the following are new:\\ \end{enumerate} To allow to this more complicated setup the syntax of the -\texttt{add-new-tag} key has been extended. It now takes as argument +\texttt{role/new-tag} key has been extended. It now takes as argument a key-value list with the following keys. A normal document shouldn't need the extended syntax, the simple syntax |section/H1| should in most cases do the right thing. @@ -2220,8 +2273,8 @@ most cases do the right thing. this preserves the old syntax. So this two calls are equivalent: \begin{taglstlisting} - \tagpdfsetup{add-new-tag = section/H1} - \tagpdfsetup{add-new-tag = {tag=section,role=H1}} + \tagpdfsetup{role/new-tag = section/H1} + \tagpdfsetup{role/new-tag = {tag=section,role=H1}} \end{taglstlisting} \end{description} @@ -2253,7 +2306,8 @@ dictionary as a fallback for such processors. In PDF 2.0 mathml tags have their own name space and can be freely used. In PDF 1.7. they can only be used if they are rolemapped to a standard type. By default they are not added to the |/RoleMap| dictionary, but this can be -forced with |\tagpdfsetup{mathml-tags}|. Please note that this adds mathml at the end of the document and overwrites tag with the same name without warning. +forced with |\tagpdfsetup{role/mathml-tags}|. Please note that this adds mathml +at the end of the document and overwrites tags with the same name without warning. \section{Checking parent-child rules}\label{sec:parent-child} @@ -2331,7 +2385,7 @@ or reflowing the text to decide if a space is meant as a word boundary or e.g. as a kerning. Accessible document should use real space glyphs (U+0032) from a font in such places. -With the key \PrintKeyName{interwordspace} you can activate such space +With the key \PrintKeyName{activate/spaces} you can activate such space glyphs. With pdftex this will simply call the primitive @@ -2344,16 +2398,16 @@ function it can't be fine tuned or adapted. You can only turn it on and off and insert manually such a space glyph with \verb+\pdffakespace+. -With luatex (in luamode) |interwordspace| is implemented with a +With luatex (in luamode) |activate/spaces| is implemented with a lua-function which is inserted in two callbacks and marks up the places where it seems sensible to inter a space glyph. Later in the process the space glyphs are injected -- the code will take the glyph from the current font if this has a space glyph or switch to the default latin modern font. The current code works reasonable well in -normal text. |interwordspace| can be used without actually tagging a +normal text. |activate/spaces| can be used without actually tagging a document. -The key \PrintKeyName{show-spaces} will show lines at the places where +The key-value \PrintKeyName{debug/show=spaces} will show lines at the places where in lua mode spaces are inserted and so can help you to find problematic places. For listings -- which have a quite specific handling of spaces -- you can find a suggestion in the example @@ -2532,7 +2586,7 @@ To tag boxes that can be both (without tagging commands or with balanced tagging commands) the following strategy can be used: \begin{itemize} -\item when storing the box put around it a structure as need by the +\item when storing the box put around it a structure as needed by the tagged variant: \begin{verbatim} \tag_mc_end_push: % interrupt an open mc @@ -2727,7 +2781,7 @@ KOMA. On the other side it means that quite often one can omit the commands starting with |\uftag| will stay valid for some time but then be deprecated. -\item \textbf{Breaking change!} The argument of \texttt{newattribute} +\item \textbf{Breaking change!} The argument of \texttt{role/new-attribute} (old key name: \texttt{newattribute}) option should no longer add the dictionary bracket \verb+<<..>>+, they are added by the code. @@ -2823,10 +2877,10 @@ command. places, it also ate spaces in places where this wasn't expected. From now on both commands behave exactly like the expl3 versions. \item The lua-code to add real space glyphs has been separated from the - tagging code. This means that |interwordspace| now works also if + tagging code. This means that |activate/spaces| now works also if tagging is not active. \item The key |activate| has been added, it open the first structure, see - below. + above. \end{itemize} \subsection{Changes in version 0.92} @@ -2969,7 +3023,7 @@ cases building the structure should now need only two or three compilations. The new code requires a current pdfmanagement-testphase and is then used automatically if the new engines are detected. - +\subsection{} \printbibliography[heading=bibintoc] diff --git a/Master/texmf-dist/doc/latex/tagpdf/tagpdfsetup-keys.tex b/Master/texmf-dist/doc/latex/tagpdf/tagpdfsetup-keys.tex new file mode 100644 index 00000000000..22d4c9a8d5e --- /dev/null +++ b/Master/texmf-dist/doc/latex/tagpdf/tagpdfsetup-keys.tex @@ -0,0 +1,70 @@ +%% Overview over tagpdfsetup keys +%% The keys are split in a number of key pathes. +\tagpdfsetup{table/header-rows=1} +\begin{tabular}{lllll} +\toprule +new key name & old key name & value &type & defined in \\\midrule + ??? & root-AF & string &code &tagpdf-struct\\[4pt]\midrule +%% activate key path +%% activate` is used for keys that enable +%% general, typically document wide tagging options +%% related to the PDF processing. + +activate & activate & boolean &meta & tagpdf \\ +activate/all & activate-all & boolean &meta & tagpdf\\ +activate/mc & activate-mc & boolean &bool & tagpdf\\ +activate/spaces & interwordspace & boolean &code & tagpdf-space\\ +activate/struct & activate-struct & boolean &bool & tagpdf\\ +activate/struct-dest & no-struct-dest&boolean &bool & tagpdf\\ +activate/tagunmarked& tagunmarked & boolean &bool & tagpdf\\ +activate/tree & activate-tree & boolean &bool & tagpdf\\[4pt]\midrule +% temporary until tagging-sockets are in the kernel: +% activate/socket & --- & boolean & bool & tagpdf\\ +%% role key path. For everything related to tag and attribute names +%% adds mathml to the global rolemap, should perhaps be default +role/mathml-tags & mathml-tags & boolean &bool & tagpdf-roles\\ +role/new-tag & add-new-tag & string &code & tagpdf-roles\\ +role/new-attribute&newattribute & string &code & tagpdf-struct\\ +% values: latex, pdf, default is latex, with pdf only PDF-tags are used +role/map-tags & --- & choice & code & tagpdf-roles\\[4pt]\midrule +%% debug key path +%% for logging and showing +debug/show &various &choice &code & various \\ +debug/show=para & paratagging-show& --- &code & tagpdf-user\\ +debug/show=paraOff& & --- &code & tagpdf-user\\ +debug/show=spaces & show-spaces & --- &code & tagpdf-spaces\\ +debug/show=spacesOff& --- & --- &code & tagpdf-spaces\\ +debug/log & log & choice &code & tagpdf \\ +debug/uncompress & uncompress & --- &code & tagpdf\\[4pt]\midrule +%% viewer key path. +%% viewer keys influence some display options in a pdf viewer. +%% There is an overlap with similar "non-tagging" options. +% TODO viewer/display-title +%% show mathml-files in attachment pane (old mathml-panel) +viewer/pane/mathml & --- & boolean &bool &latex-lab-math (dev)\\ +viewer/pane/mathsource& --- &boolean &bool &latex-lab-math (dev)\\[4pt]\midrule +%%% Document element keys +%% page key path +page/tabsorder &tabsorder & choice & code & tagpdf\\ +page/exclude-header-footer & exclude-header-footer &choice & code &tagpdf-user\\[4pt]\midrule +%% para key path +para/tagging ¶tagging &boolean &bool &tagpdf-user\\ +para/tag ¶tag &string &code &tagpdf-user\\ +para/maintag &--- &string &code &tagpdf-user\\ +para/flattened &--- &boolean &bool &tagpdf-user\\[4pt]\midrule +%% math key path +% use the /Alt key, currently clashes with mathml-AF in foxit, +% so false if mathml handling is activated +math/alt/use &--- &boolean &bool &latex-lab-math\\ +math/mathml/write-dummy & --- &--- &code &latex-lab-math\\ +% mathml source files: +math/mathml/sources &--- & clist &clist &latex-lab-math\\ +math/mathml/AF &--- &boolean &bool &latex-lab-math\\ +math/tex/AF & --- &boolean &bool &latex-lab-math\\[4pt]\midrule +% TODO math/alt/type = source|manual| (later) +%% table key path +% true/false/layout +table/tagging & table-tagging &choice &code &latex-lab-table\\ +table/header-rows & table-header-rows& clist &clist &latex-lab-table\\ +\bottomrule +\end{tabular} -- cgit v1.2.3