diff options
Diffstat (limited to 'Master/texmf-dist/source/latex')
| -rw-r--r-- | Master/texmf-dist/source/latex/hyperxmp/einstein-xmp.tex | 349 | ||||
| -rw-r--r-- | Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx | 1698 |
2 files changed, 1399 insertions, 648 deletions
diff --git a/Master/texmf-dist/source/latex/hyperxmp/einstein-xmp.tex b/Master/texmf-dist/source/latex/hyperxmp/einstein-xmp.tex index 793996a4ff6..d12291b4fc6 100644 --- a/Master/texmf-dist/source/latex/hyperxmp/einstein-xmp.tex +++ b/Master/texmf-dist/source/latex/hyperxmp/einstein-xmp.tex @@ -8,208 +8,153 @@ \begin{alltt} <?xpacket begin="\string\357\string\273\string\277" id="W5M0MpCehiHzreSzNTczkc9d"?> - <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="3.1-702"> - <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> - <rdf:Description rdf:about="" - xmlns:pdf="http://ns.adobe.com/pdf/1.3/"> - <pdf:Keywords> - \metavalue{energy quanta, Hertz effect, quantum physics} - </pdf:Keywords> - <pdf:Producer>\metavalue{pdfTeX-1.40.10}</pdf:Producer> - </rdf:Description> - <rdf:Description rdf:about="" - xmlns:xmpRights="http://ns.adobe.com/xap/1.0/rights/"> - <xmpRights:Marked>\metavalue{True}</xmpRights:Marked> - <xmpRights:WebStatement> - \metavalue{http://creativecommons.org/licenses/by-nc-nd/3.0/} - </xmpRights:WebStatement> - </rdf:Description> - <rdf:Description rdf:about="" - xmlns:dc="http://purl.org/dc/elements/1.1/"> - <dc:format>\metavalue{application/pdf}</dc:format> - <dc:title> - <rdf:Alt> - <rdf:li xml:lang="en"> - \metavalue{On a heuristic viewpoint concerning the production and - transformation of light} - </rdf:li> - <rdf:li xml:lang="x-default"> - \metavalue{On a heuristic viewpoint concerning the production and - transformation of light} - </rdf:li> - <rdf:li xml:lang="de"> - \metavalue{\"Uber einen die Erzeugung und Verwandlung des Lichtes - betreffenden heuristischen Gesichtspunkt} - </rdf:li> - </rdf:Alt> - </dc:title> - <dc:description> - <rdf:Alt> - <rdf:li xml:lang="en">\metavalue{photoelectric effect}</rdf:li> - <rdf:li xml:lang="x-default">\metavalue{photoelectric effect}</rdf:li> - </rdf:Alt> - </dc:description> - <dc:rights> - <rdf:Alt> - <rdf:li xml:lang="en"> - \metavalue{Copyright (C) 1905, Albert Einstein} - </rdf:li> - <rdf:li xml:lang="x-default"> - \metavalue{Copyright (C) 1905, Albert Einstein} - </rdf:li> - </rdf:Alt> - </dc:rights> - <dc:creator> - <rdf:Seq> - <rdf:li>\metavalue{Albert Einstein}</rdf:li> - </rdf:Seq> - </dc:creator> - <dc:subject> - <rdf:Bag> - <rdf:li>\metavalue{energy quanta}</rdf:li> - <rdf:li>\metavalue{Hertz effect}</rdf:li> - <rdf:li>\metavalue{quantum physics}</rdf:li> - </rdf:Bag> - </dc:subject> - <dc:date> - <rdf:Seq> - <rdf:li>\metavalue{1905-03-17}</rdf:li> - </rdf:Seq> - </dc:date> - <dc:language> - <rdf:Bag> - <rdf:li>\metavalue{en}</rdf:li> - </rdf:Bag> - </dc:language> - <dc:type> - <rdf:Bag> - <rdf:li>\metavalue{Text}</rdf:li> - </rdf:Bag> - </dc:type> - <dc:source>\metavalue{einstein.tex}</dc:source> - </rdf:Description> - <rdf:Description rdf:about="" - xmlns:photoshop="http://ns.adobe.com/photoshop/1.0/"> - <photoshop:AuthorsPosition> - \metavalue{Technical Assistant, Level III} - </photoshop:AuthorsPosition> - <photoshop:CaptionWriter>\metavalue{Scott Pakin}</photoshop:CaptionWriter> - </rdf:Description> - <rdf:Description rdf:about="" - xmlns:pdfaExtension="http://www.aiim.org/pdfa/ns/extension/" - xmlns:pdfaSchema="http://www.aiim.org/pdfa/ns/schema#" - xmlns:pdfaProperty="http://www.aiim.org/pdfa/ns/property#" - xmlns:pdfaType="http://www.aiim.org/pdfa/ns/type#" - xmlns:pdfaField="http://www.aiim.org/pdfa/ns/field#"> - <pdfaExtension:schemas> - <rdf:Bag> - <rdf:li rdf:parseType="Resource"> - <pdfaSchema:schema>IPTC Core Schema</pdfaSchema:schema> - <pdfaSchema:namespaceURI>http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/</pdfaSchema:namespaceURI> - <pdfaSchema:prefix>Iptc4xmpCore</pdfaSchema:prefix> - <pdfaSchema:property> - <rdf:Seq> - <rdf:li rdf:parseType="Resource"> - <pdfaProperty:name>CreatorContactInfo</pdfaProperty:name> - <pdfaProperty:valueType>contactinfo</pdfaProperty:valueType> - <pdfaProperty:category>external</pdfaProperty:category> - <pdfaProperty:description>contact information for the document's creator</pdfaProperty:description> - </rdf:li> - </rdf:Seq> - </pdfaSchema:property> - <pdfaSchema:valueType> - <rdf:Seq> - <rdf:li rdf:parseType="Resource"> - <pdfaType:type>contactinfo</pdfaType:type> - <pdfaType:namespaceURI>http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/</pdfaType:namespaceURI> - <pdfaType:prefix>Iptc4xmpCore</pdfaType:prefix> - <pdfaType:description>contact information</pdfaType:description> - <pdfaType:field> - <rdf:Seq> - <rdf:li rdf:parseType="Resource"> - <pdfaField:name>CiAdrExtadr</pdfaField:name> - <pdfaField:valueType>Text</pdfaField:valueType> - <pdfaField:description>contact address</pdfaField:description> - </rdf:li> - <rdf:li rdf:parseType="Resource"> - <pdfaField:name>CiAdrCity</pdfaField:name> - <pdfaField:valueType>Text</pdfaField:valueType> - <pdfaField:description>contact city</pdfaField:description> - </rdf:li> - <rdf:li rdf:parseType="Resource"> - <pdfaField:name>CiAdrRegion</pdfaField:name> - <pdfaField:valueType>Text</pdfaField:valueType> - <pdfaField:description>contact region</pdfaField:description> - </rdf:li> - <rdf:li rdf:parseType="Resource"> - <pdfaField:name>CiAdrPcode</pdfaField:name> - <pdfaField:valueType>Text</pdfaField:valueType> - <pdfaField:description>contact postal code</pdfaField:description> - </rdf:li> - <rdf:li rdf:parseType="Resource"> - <pdfaField:name>CiAdrCtry</pdfaField:name> - <pdfaField:valueType>Text</pdfaField:valueType> - <pdfaField:description>contact country</pdfaField:description> - </rdf:li> - <rdf:li rdf:parseType="Resource"> - <pdfaField:name>CiTelWork</pdfaField:name> - <pdfaField:valueType>Text</pdfaField:valueType> - <pdfaField:description>contact telephone number</pdfaField:description> - </rdf:li> - <rdf:li rdf:parseType="Resource"> - <pdfaField:name>CiEmailWork</pdfaField:name> - <pdfaField:valueType>Text</pdfaField:valueType> - <pdfaField:description>contact email address</pdfaField:description> - </rdf:li> - <rdf:li rdf:parseType="Resource"> - <pdfaField:name>CiUrlWork</pdfaField:name> - <pdfaField:valueType>Text</pdfaField:valueType> - <pdfaField:description>contact url</pdfaField:description> - </rdf:li> - </rdf:Seq> - </pdfaType:field> - </rdf:li> - </rdf:Seq> - </pdfaSchema:valueType> - </rdf:li> - </rdf:Bag> - </pdfaExtension:schemas> - </rdf:Description> - <rdf:Description rdf:about="" - xmlns:Iptc4xmpCore="http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/"> - <Iptc4xmpCore:CreatorContactInfo rdf:parseType="Resource"> - <Iptc4xmpCore:CiAdrExtadr>\metavalue{Kramgasse 49}</Iptc4xmpCore:CiAdrExtadr> - <Iptc4xmpCore:CiAdrCity>\metavalue{Bern}</Iptc4xmpCore:CiAdrCity> - <Iptc4xmpCore:CiAdrPcode>\metavalue{3011}</Iptc4xmpCore:CiAdrPcode> - <Iptc4xmpCore:CiAdrCtry>\metavalue{Switzerland}</Iptc4xmpCore:CiAdrCtry> - <Iptc4xmpCore:CiTelWork>\metavalue{031 312 00 91}</Iptc4xmpCore:CiTelWork> - <Iptc4xmpCore:CiEmailWork>\metavalue{aeinstein@ipi.ch}</Iptc4xmpCore:CiEmailWork> - <Iptc4xmpCore:CiUrlWork> - \metavalue{http://einstein.biz/, - https://www.facebook.com/AlbertEinstein} - </Iptc4xmpCore:CiUrlWork> - </Iptc4xmpCore:CreatorContactInfo> - </rdf:Description> - <rdf:Description rdf:about="" - xmlns:xmp="http://ns.adobe.com/xap/1.0/"> - <xmp:CreateDate>\metavalue{\todayISO}</xmp:CreateDate> - <xmp:ModifyDate>\metavalue{\todayISO}</xmp:ModifyDate> - <xmp:MetadataDate>\metavalue{\todayISO}</xmp:MetadataDate> - <xmp:CreatorTool>\metavalue{LaTeX with hyperref package}</xmp:CreatorTool> - <xmp:BaseURL> - \metavalue{http://mirror.ctan.org/macros/latex/contrib/hyperxmp/} - </xmp:BaseURL> - </rdf:Description> - <rdf:Description rdf:about="" - xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/"> - <xmpMM:DocumentID> - \metavalue{uuid:6d1ac9ec-4ff2-515a-954b-648eeb4853b0} - </xmpMM:DocumentID> - <xmpMM:InstanceID> - \metavalue{uuid:059b675f-2bb6-4262-80a3-9b6c9b6759b6} - </xmpMM:InstanceID> - </rdf:Description> - </rdf:RDF> + <x:xmpmeta xmlns:x="adobe:ns:meta/"> + <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> + <rdf:Description rdf:about="" + xmlns:pdf="http://ns.adobe.com/pdf/1.3/" + xmlns:xmpRights="http://ns.adobe.com/xap/1.0/rights/" + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:photoshop="http://ns.adobe.com/photoshop/1.0/" + xmlns:xmp="http://ns.adobe.com/xap/1.0/" + xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/" + xmlns:stEvt="http://ns.adobe.com/xap/1.0/sType/ResourceEvent#" + xmlns:pdfaid="http://www.aiim.org/pdfa/ns/id/" + xmlns:prism="http://prismstandard.org/namespaces/basic/3.0/" + xmlns:Iptc4xmpCore="http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/" + xmlns:pdfaExtension="http://www.aiim.org/pdfa/ns/extension/" + xmlns:pdfaSchema="http://www.aiim.org/pdfa/ns/schema#" + xmlns:pdfaProperty="http://www.aiim.org/pdfa/ns/property#" + xmlns:pdfaType="http://www.aiim.org/pdfa/ns/type#" + xmlns:pdfaField="http://www.aiim.org/pdfa/ns/field#"> + <pdfaExtension:schemas> + <rdf:Bag> +\end{alltt} +\begin{center} + $\vdots$\par + \emph{[over 100 lines of boilerplate definitions not shown]}\par + $\vdots$\par +\end{center} +\begin{alltt} + </rdf:Bag> + </pdfaExtension:schemas> + <pdf:Keywords> + \metavalue{energy quanta, Hertz effect, quantum physics} + </pdf:Keywords> + <pdf:Producer>\metavalue{pdfTeX-1.40.19}</pdf:Producer> + <pdf:PDFVersion>\metavalue{1.5}</pdf:PDFVersion> + <xmpRights:Marked>\metavalue{True}</xmpRights:Marked> + <xmpRights:WebStatement> + \metavalue{http://creativecommons.org/licenses/by-nc-nd/3.0/} + </xmpRights:WebStatement> + <dc:format>\metavalue{application/pdf}</dc:format> + <dc:title> + <rdf:Alt> + <rdf:li xml:lang="en"> + \metavalue{On a heuristic viewpoint concerning the production + and transformation of light} + </rdf:li> + <rdf:li xml:lang="x-default"> + \metavalue{On a heuristic viewpoint concerning the production + and transformation of light} + </rdf:li> + <rdf:li xml:lang="de"> + \metavalue{\"Uber einen die Erzeugung und Verwandlung des Lichtes + betreffenden heuristischen Gesichtspunkt} + </rdf:li> + </rdf:Alt> + </dc:title> + <dc:description> + <rdf:Alt> + <rdf:li xml:lang="en">\metavalue{photoelectric effect}</rdf:li> + <rdf:li xml:lang="x-default">\metavalue{photoelectric effect}</rdf:li> + </rdf:Alt> + </dc:description> + <dc:rights> + <rdf:Alt> + <rdf:li xml:lang="en"> + \metavalue{Copyright (C) 1905, Albert Einstein} + </rdf:li> + <rdf:li xml:lang="x-default"> + \metavalue{Copyright (C) 1905, Albert Einstein} + </rdf:li> + </rdf:Alt> + </dc:rights> + <dc:creator> + <rdf:Seq> + <rdf:li>\metavalue{Albert Einstein}</rdf:li> + </rdf:Seq> + </dc:creator> + <dc:subject> + <rdf:Bag> + <rdf:li>\metavalue{energy quanta}</rdf:li> + <rdf:li>\metavalue{Hertz effect}</rdf:li> + <rdf:li>\metavalue{quantum physics}</rdf:li> + </rdf:Bag> + </dc:subject> + <dc:date> + <rdf:Seq> + <rdf:li>\metavalue{1905-03-17}</rdf:li> + </rdf:Seq> + </dc:date> + <dc:language> + <rdf:Bag> + <rdf:li>\metavalue{en}</rdf:li> + </rdf:Bag> + </dc:language> + <dc:type> + <rdf:Bag> + <rdf:li>\metavalue{Text}</rdf:li> + </rdf:Bag> + </dc:type> + <dc:source>\metavalue{einstein.tex}</dc:source> + <photoshop:AuthorsPosition> + \metavalue{Technical Assistant, Level III} + </photoshop:AuthorsPosition> + <photoshop:CaptionWriter>\metavalue{Scott Pakin}</photoshop:CaptionWriter> + <xmp:CreateDate>\metavalue{2019-03-16T23:07:38-06:00}</xmp:CreateDate> + <xmp:ModifyDate>\metavalue{2019-03-16T23:07:38-06:00}</xmp:ModifyDate> + <xmp:MetadataDate>\metavalue{2019-03-16T23:07:38-06:00}</xmp:MetadataDate> + <xmp:CreatorTool>\metavalue{LaTeX with hyperref package}</xmp:CreatorTool> + <xmpMM:DocumentID> + \metavalue{uuid:6d1ac9ec-4ff2-515a-954b-648eeb4853b0} + </xmpMM:DocumentID> + <xmpMM:InstanceID> + \metavalue{uuid:3e4c4182-b182-46c9-995f-754c41d13390} + </xmpMM:InstanceID> + <xmpMM:VersionID>\metavalue{2.998e8}</xmpMM:VersionID> + <Iptc4xmpCore:CreatorContactInfo rdf:parseType="Resource"> + <Iptc4xmpCore:CiAdrExtadr>\metavalue{Kramgasse 49}</Iptc4xmpCore:CiAdrExtadr> + <Iptc4xmpCore:CiAdrCity>\metavalue{Bern}</Iptc4xmpCore:CiAdrCity> + <Iptc4xmpCore:CiAdrPcode>\metavalue{3011}</Iptc4xmpCore:CiAdrPcode> + <Iptc4xmpCore:CiAdrCtry>\metavalue{Switzerland}</Iptc4xmpCore:CiAdrCtry> + <Iptc4xmpCore:CiTelWork>\metavalue{031 312 00 91}</Iptc4xmpCore:CiTelWork> + <Iptc4xmpCore:CiEmailWork>\metavalue{aeinstein@ipi.ch}</Iptc4xmpCore:CiEmailWork> + <Iptc4xmpCore:CiUrlWork> + \metavalue{http://einstein.biz/,} + \metavalue{https://www.facebook.com/AlbertEinstein} + </Iptc4xmpCore:CiUrlWork> + </Iptc4xmpCore:CreatorContactInfo> + <prism:complianceProfile>\metavalue{three}</prism:complianceProfile> + <prism:subtitle xml:lang="en-US"> + \metavalue{Putting that bum Maxwell in his place} + </prism:subtitle> + <prism:publicationName xml:lang="de"> + \metavalue{Annalen der Physik} + </prism:publicationName> + <prism:aggregationType>\metavalue{journal}</prism:aggregationType> + <prism:volume>\metavalue{322}</prism:volume> + <prism:number>\metavalue{6}</prism:number> + <prism:pageRange>\metavalue{132-148}</prism:pageRange> + <prism:issn>\metavalue{0003-3804}</prism:issn> + <prism:eIssn>\metavalue{1521-3889}</prism:eIssn> + <prism:doi>\metavalue{10.1002/andp.19053220607}</prism:doi> + <prism:url> + \metavalue{http://www.physik.uni-augsburg.de/annalen/history/einstein-papers/190517132-148.pdf} + </prism:url> + <prism:byteCount>\metavalue{56884}</prism:byteCount> + <prism:pageCount>\metavalue{17}</prism:pageCount> + </rdf:Description> + </rdf:RDF> </x:xmpmeta> <?xpacket end="w"?> \end{alltt} diff --git a/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx b/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx index dd4cd3b9d4c..c52380e5734 100644 --- a/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx +++ b/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx @@ -22,7 +22,7 @@ %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01] %<package>\ProvidesPackage{hyperxmp} %<*package> - [2019/02/25 v3.5a Store hyperref metadata in XMP format] + [2019/03/31 v4.0 Store hyperref metadata in XMP format] %</package> % %<*driver> @@ -38,7 +38,7 @@ \usepackage{needspace} \usepackage{varioref} \usepackage{alltt} -\usepackage{needspace} +\usepackage{multicol} \usepackage[utf8]{inputenc} \usepackage{hyperxmp} \usepackage[unicode,bookmarksopen,bookmarksopenlevel=2,bookmarksnumbered]{hyperref} @@ -47,9 +47,13 @@ \RecordChanges % Specify this document's metadata. +\GetFileInfo{hyperxmp.dtx} \title{The \pkgname{hyperxmp} package\thanks{This document corresponds to \pkgname{hyperxmp}~\fileversion, dated \filedate.}} \author{Scott Pakin \\ \texttt{scott+hyxmp@pakin.org}} +\makeatletter +\edef\versionnumber{\expandafter\@gobble\fileversion} % Drop the "v" in the file version. +\makeatother \hypersetup{% pdfauthor={Scott Pakin}, pdftitle={The hyperxmp package}, @@ -60,8 +64,10 @@ pdfcaptionwriter={Scott Pakin}, pdfcontactemail={scott+hyxmp@pakin.org}, pdfcontacturl={http://www.pakin.org/\xmptilde scott/}, + pdfversionid={\versionnumber}, pdflang={en-US}, - baseurl={http://mirror.ctan.org/macros/latex/contrib/hyperxmp/hyperxmp.pdf} + pdfurl={http://mirror.ctan.org/macros/latex/contrib/hyperxmp/hyperxmp.pdf}, + baseurl={http://mirror.ctan.org/macros/latex/contrib/hyperxmp/} } \begin{document} @@ -82,7 +88,7 @@ %</driver> % \fi % -% \CheckSum{1845} +% \CheckSum{2082} % % \CharacterTable % {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z @@ -130,8 +136,10 @@ % \protect\pkgname{hyperxmp} code} % \changes{v3.4}{2017/11/04}{Use \protect\pkgname{ifmtarg} to test for % empty arguments, including non-empty but all spaces} +% \changes{v4.0}{2019/03/14}{Include all metadata within a single +% \protect\xmpterm{rdf:Description} block} % -% \GetFileInfo{hyperxmp.dtx} +% ^^A \GetFileInfo{hyperxmp.dtx} % % \DoNotIndex{,\,\ ,\!,\",\#,\(,\),\*,\<,\>,\@cons,\@empty} % \DoNotIndex{\@ifpackageloaded,\@ifundefined,\@nil,\@tempcnta,\@tempcntb} @@ -152,7 +160,7 @@ % \ifx\xmptermopt\@empty % \mbox{\textsf{#2}}^^A % \else -% \mbox{\textsf{#2}}\slash\mbox{\textsf{#1}}^^A +% \mbox{\textsf{#2}}.\mbox{\textsf{#1}}^^A % \SortIndex{#1}{\textsf{#1}}^^A % \fi % \SortIndex{#2}{\textsf{#2}}^^A @@ -165,6 +173,12 @@ % \SortIndex{#1}{\textsf{#1} (option)}^^A % \index{options=\textsf{#1}}^^A % } +% ^^A \moptname is the same as \optname but also typesets the +% ^^A option name in the margin. +% \DeclareRobustCommand{\moptname}[1]{^^A +% \optname{#1}^^A +% \marginpar{\raggedleft\strut\mbox{\textsf{#1}}}^^A +% } % \DeclareRobustCommand{\acrostyle}[1]{\textsc{\MakeLowercase{#1}}} % \DeclareRobustCommand{\acro}[1]{^^A % \mbox{\acrostyle{#1}}^^A @@ -172,7 +186,7 @@ % } % \newcounter{note} % \newcommand{\usagenote}[1]{^^A -% \addtocounter{note}{1}^^A +% \refstepcounter{note}^^A % \paragraph{Note~\thenote: #1}% % } % @@ -305,37 +319,53 @@ % \pkgname{hyperxmp} knows how to embed all of the following types of % metadata within a document: % +% \label{page:begin-metadata-list} % \begin{itemize} \raggedright -% \item authors (\xmpterm{dc:creator}) -% \item base \acro{URL} (\xmpterm{xmp:BaseURL}) -% \item contact address +% \item address of primary author % (\xmpterm[CiAdrExtadr]{Iptc4xmpCore:CreatorContactInfo}, % \xmpterm[CiAdrCity]{Iptc4xmpCore:CreatorContactInfo}, % \xmpterm[CiAdrRegion]{Iptc4xmpCore:CreatorContactInfo}, % \xmpterm[CiAdrPcode]{Iptc4xmpCore:CreatorContactInfo}, and % \xmpterm[CiAdrCtry]{Iptc4xmpCore:CreatorContactInfo}) -% \item contact email address(es) (\xmpterm[CiEmailWork]{Iptc4xmpCore:CreatorContactInfo}) -% \item contact telephone number(s) (\xmpterm[CiTelWork]{Iptc4xmpCore:CreatorContactInfo}) -% \item contact \acro{URL}(s) (\xmpterm[CiUrlWork]{Iptc4xmpCore:CreatorContactInfo}) +% \item author(s) (\xmpterm{dc:creator}) +% \item base \acro{URL} for relative references (\xmpterm{xmp:BaseURL}) +% \item book edition (\xmpterm{prism:bookEdition}) % \item copyright (\xmpterm{dc:rights} and \xmpterm{xmpRights:Marked}) % \item date (\xmpterm{dc:date}, \xmpterm{xmp:CreateDate}, % \xmpterm{xmp:ModifyDate}, and \xmpterm{xmp:MetadataDate}) -% \item document identifier (\xmpterm{xmpMM:DocumentID}) -% \item document instance identifier (\xmpterm{xmpMM:InstanceID}) -% \item document type (\xmpterm{dc:type}) +% \item \acro{DOI} (\xmpterm{prism:doi}) +% \item email address(es) of primary author (\xmpterm[CiEmailWork]{Iptc4xmpCore:CreatorContactInfo}) % \item file format (\xmpterm{dc:format}) +% \item file name of main \LaTeX\ source file (\xmpterm{dc:source}) +% \item file size in bytes (\xmpterm{prism:byteCount}) +% \item \acro{ISBN} (\xmpterm{prism:isbn}) +% \item \acro{ISSN}---both print (\xmpterm{prism:issn}) and electronic (\xmpterm{prism:eIssn}) +% \item issue number of parent publication (\xmpterm{prism:number}) % \item keywords (\xmpterm{pdf:Keywords} and \xmpterm{dc:subject}) -% \item language (\xmpterm{dc:language}) -% \item \LaTeX\ file name (\xmpterm{dc:source}) +% \item language used (\xmpterm{dc:language}) % \item license \acro{URL} (\xmpterm{xmpRights:WebStatement}) % \item metadata writer (\xmpterm{photoshop:CaptionWriter}) +% \item page count (\xmpterm{prism:pageCount}) +% \item page range(s) (\xmpterm{prism:pageRange}) % \item \acro{PDF} version (\xmpterm{pdf:PDFVersion}) % \item \acro{PDF}-generating tool (\xmpterm{pdf:Producer} and \xmpterm{xmp:CreatorTool}) % \item \acro{PDF/A} compliance level and version (\xmpterm{pdfaid:part} and \xmpterm{pdfaid:conformance}) -% \item primary author's position/title (\xmpterm{photoshop:AuthorsPosition}) +% \item position/title of primary author (\xmpterm{photoshop:AuthorsPosition}) +% \item publication name of parent publication (\xmpterm{prism:publicationName}) % \item summary (\xmpterm{dc:description}) +% \item subtitle (\xmpterm{prism:subtitle}) +% \item telephone number(s) of primary author (\xmpterm[CiTelWork]{Iptc4xmpCore:CreatorContactInfo}) % \item title (\xmpterm{dc:title}) +% \item type of document (\xmpterm{dc:type}) +% \item type of parent publication (\xmpterm{prism:aggregationType}) +% \item \acro{URL} of the document (\xmpterm{prism:url}) +% \item \acro{URL}(s) of the primary author (\xmpterm[CiUrlWork]{Iptc4xmpCore:CreatorContactInfo}) +% \item \acro{UUID} for the document (\xmpterm{xmpMM:DocumentID}) +% \item \acro{UUID} for the document instance (\xmpterm{xmpMM:InstanceID}) +% \item version identifier for the document (\xmpterm{xmpMM:VersionID}) +% \item volume number of parent publication (\xmpterm{prism:volume}) % \end{itemize} +% \label{page:end-metadata-list} % % \noindent % More types of metadata may be added in a future release. @@ -371,7 +401,9 @@ % |\hypersetup{|\dots|}|). \pkgname{hyperxmp} will construct its % \acro{XMP} data using the following \pkgname{hyperref} options: % -% \begin{itemize} +% \begin{multicols}{3} +% \raggedcolumns +% \begin{itemize} % \item \optname{baseurl} % \item \optname{pdfauthor} % \item \optname{pdfcreationdate} @@ -381,17 +413,22 @@ % \item \optname{pdfproducer} % \item \optname{pdfsubject} % \item \optname{pdftitle} -% \end{itemize} +% \end{itemize} +% \end{multicols} % % \noindent % \mbox{}\label{page:begin-new-options} % \pkgname{hyperxmp} instructs \pkgname{hyperref} also to accept the % following options, which have meaning only to \pkgname{hyperxmp}: % -% \begin{itemize} +% \begin{multicols}{3} +% \raggedcolumns +% \begin{itemize} % \item \optname{pdfaconformance} % \item \optname{pdfapart} % \item \optname{pdfauthortitle} +% \item \optname{pdfbookedition} +% \item \optname{pdfbytes} % \item \optname{pdfcaptionwriter} % \item \optname{pdfcontactaddress} % \item \optname{pdfcontactcity} @@ -404,43 +441,167 @@ % \item \optname{pdfcopyright} % \item \optname{pdfdate} % \item \optname{pdfdocumentid} +% \item \optname{pdfdoi} +% \item \optname{pdfeissn} % \item \optname{pdfinstanceid} +% \item \optname{pdfisbn} +% \item \optname{pdfissn} +% \item \optname{pdfissuenum} % \item \optname{pdflicenseurl} % \item \optname{pdfmetadate} % \item \optname{pdfmetalang} +% \item \optname{pdfpagecount} +% \item \optname{pdfpagerange} +% \item \optname{pdfpublication} +% \item \optname{pdfpubtype} % \item \optname{pdfsource} +% \item \optname{pdfsubtitle} % \item \optname{pdftype} -% \end{itemize} +% \item \optname{pdfurl} +% \item \optname{pdfversionid} +% \item \optname{pdfvolumenum} +% \end{itemize} +% \end{multicols} % \label{page:end-new-options} % -% The two most obscure---but alphabetically first---of the above, -% \optname{pdfaconformance} and \optname{pdfapart}, are used in -% conjunction with \pkgname{hyperref}'s \optname{pdfa} option to claim a -% particular \acro{PDF/A} standard by which the document abides. They -% default to \optname{pdfapart}=|1| and \optname{pdfaconformance}=|B|, -% indicating the \acro{PDF/A}-\textsc{1b} standard. These can be -% changed (with caution) to assert that the document abides by a -% different standard (e.g.,~\acro{PDF/A}-\textsc{2u}). -% -% \optname{pdfauthortitle} indicates the primary author's position or -% title. \optname{pdfcaptionwriter} specifies the name of the person +% +% \subsection{Option descriptions} +% +% The document title is specified as normal for \pkgname{hyperref} with +% \moptname{pdftitle}, but see Note~\ref{note:multilingual} on +% page~\pageref{note:multilingual} for instructions on how to specify a +% title in multiple languages. \pkgname{hyperxmp} introduces a +% complementary \moptname{pdfsubtitle} option: +% +% \begin{verbatim} +% pdftitle={Frankenstein}, +% pdfsubtitle={The Modern Prometheus}, +% \end{verbatim} +% +% Unfortunately, the subtitle can appear in only one language. It +% assumed to be the same language as the document language +% (\optname{pdflang}) but can be overridden by preceding the text with a +% bracketed \acro{ISO} \mbox{639-1} two-letter language code and an +% optional \acro{ISO} \mbox{3166-1} two-letter region code. See the +% example below for \optname{pdfpublication}. +% +% \Needspace{6\baselineskip} +% \moptname{pdfauthortitle} indicates the primary author's position or +% title. \moptname{pdfcaptionwriter} specifies the name of the person % who added the metadata to the document. The next eight items describe % how to contact the person or institution responsible for the document -% (the ``contact''). \optname{pdfcontactaddress} is the contact's +% (the ``contact''). \moptname{pdfcontactaddress} is the contact's % street address and can include the institution name if the contact is -% an institution; \optname{pdfcontactcity} is the contact's city. -% \optname{pdfcontactcountry} is the contact's country; -% \optname{pdfcontactemail} is the contact's email address (or multiple, -% comma-separated email addresses); \optname{pdfcontactphone} is the -% contact's telephone number (or multiple, comma-separated telephone -% numbers); \optname{pdfcontactpostcode} is the contact's postal code; -% \optname{pdfcontactregion} is the contact's state or province; and -% \optname{pdfcontacturl} is the contact's \acro{URL} (or multiple, -% comma-separated \acro{URL}s). +% an institution; \moptname{pdfcontactcity} is the contact's city; +% \moptname{pdfcontactcountry} is the contact's country; +% \moptname{pdfcontactemail} is the contact's email address (or +% multiple, comma-separated email addresses); \moptname{pdfcontactphone} +% is the contact's telephone number (or multiple, comma-separated +% telephone numbers); \moptname{pdfcontactpostcode} is the contact's +% postal code; \moptname{pdfcontactregion} is the contact's state or +% province; and \moptname{pdfcontacturl} is the contact's \acro{URL} (or +% multiple, comma-separated \acro{URL}s). +% +% \Needspace{2\baselineskip} +% \moptname{pdfcopyright} defines the copyright text, and +% \moptname{pdflicenseurl} identifies a \acro{URL} that points to the +% document's license agreement. +% +% \moptname{pdfmetalang} indicates the natural language in which certain +% metadata---specifically, the document's title, subject, and copyright +% statement---are written. The language should be specified using an +% \acro{IETF} language tag~\cite{IANA2011:lang-tags}, for example, +% ``|en|'' for English, ``|en-US|'' for specifically United States +% English, ``|de|'' for German, and so forth. If \optname{pdfmetalang} +% is not specified, \pkgname{hyperxmp} assumes the metadata language is +% the same as the document language (\pkgname{hyperref}'s +% \moptname{pdflang} option). If neither \optname{pdfmetalang} nor +% \optname{pdflang} is specified, \pkgname{hyperxmp} uses only +% ``|x-default|'' as the metadata language. Note that ``|x-default|'' +% metadata are always included in addition to the specified metadata +% language, as the user reading the document may not have specified a +% language preference. +% +% \acro{XMP} can include a universally unique identifier (\acro{UUID}) +% for each document and for each instance of a given document. By +% default, \pkgname{hyperxmp} assigns a version~4 (i.e.,~pseudorandom) +% \acro{UUID}~\cite{Leach2005:uuid} for each of these. However, a +% document can alternatively specify a particular document identifier +% using \moptname{pdfdocumentid} and (not normally recommended) a +% particular instance identifier using \moptname{pdfinstanceid}. These +% should be of the form +% \texttt{uuid:}\textit{xxxxxxxx}\texttt{-}\textit{xxxx}\texttt{-}\textit{xxxx}\texttt{-}\textit{xxxx}\texttt{-}\textit{xxxxxxxxxxxx}, +% where ``\textit{x}'' is a lowercase hexadecimal number. For example, +% \texttt{uuid:53ab7f19-a48c-5177-8bb2-403ad907f632} is a valid argument +% to \optname{pdfdocumentid} (or \optname{pdfinstanceid}). See Leach, +% Mealling, and Salz's \acro{UUID} specification document for details on +% how to produce the various forms of +% \acro{UUID}s~\cite{Leach2005:uuid}. A more freeform mechanism than +% \optname{pdfinstanceid} for versioning documents is available via +% \moptname{pdfversionid}. The version specified by +% \optname{pdfversionid} can be incremented as~|1|, |2|, |3|,~\dots; +% identified with a hierarchical numbering scheme (e.g.,~this document +% is versioned \texttt{\versionnumber} to match the package version); or +% labeled using any other approach. One possibility is to use a +% revision number or commit hash from the version-control software +% maintaining the document. For example, the |\gitVer| macro from the +% \pkgname{gitver} package is an expandable (see +% Note~\ref{note:expandable} on page~\pageref{note:expandable}) version +% of the current \href{https://git-scm.com/}{Git} hash that can suitably +% be passed to \optname{pdfversionid}. +% +% Already-published documents can be identified in a number of ways. +% \moptname{pdfisbn} specifies the \acro{ISBN}. \moptname{pdfissn} +% refers to the \acro{ISSN} of the \emph{print} version of the document +% while \moptname{pdfeissn} refers to the \acro{ISSN} of the +% \emph{electronic} version of the document. \moptname{pdfdoi} +% specifies the \acro{DOI} and should include only the \acro{DOI} name +% without any \acro{URL} prefix. For example, specify +% |pdfdoi={10.1145/3149526.3149532}|, \emph{not} +% |pdfdoi={https://doi.org/10.1145/3149526.3149532}|. +% \moptname{pdfurl} points to the complete \acro{URL} for the document. +% In contrast, \moptname{baseurl} points one level up and is used to +% resolve relative \acro{URL}s. +% +% Already-published documents can further be identified by the +% publication in which they appear. \moptname{pdfpublication} specifies +% the title of the journal, magazine, or other parent document. The +% title language is assumed to be the same as the document language +% (\optname{pdflang}) but can be overridden by preceding the text with a +% bracketed \acro{ISO} \mbox{639-1} two-letter language code and an +% optional \acro{ISO} \mbox{3166-1} two-letter region code. For +% example, |pdfpublication={[fr]Charlie Hedbo}| indicates a +% French-language title. Were the language or pronunciation differences +% significant, |fr-FR| would indicate specifically the French spoken in +% France, as opposed to that spoken in, say, Canada (|fr-CA|) or Belgium +% (|fr-BE|). +% +% \moptname{pdfpubtype} indicates the type of publication in which the +% document was published. This should be one of the \acro{PRISM} +% aggregation types~\cite{PRISM2012:cont-voc} such as |book|, |journal|, +% |magazine|, |manual|, |report|, or |whitepaper|. For publications in +% journals, magazines, and similar periodicals, a document can specify +% the volume number with \moptname{pdfvolumenum} and the issue number +% within the volume with \moptname{pdfissuenum}. +% \moptname{pdfpagerange} indicates the page numbers at which the +% document appears within the publication. The intention is that this +% be a comma-separated list of dash-separated ranges, as in +% |pdfpagerange={1,4-5}|. See Note~\ref{note:page-counting} on +% page~\pageref{note:page-counting} for advice on how to assign +% \optname{pdfpagerange} semi-automatically. For books, +% \moptname{pdfbookedition} names the edition of the book. This is +% specified as text, not a number. As with \optname{pdfpublication} +% (above), \optname{pdfbookedition} accepts a bracketed language code, +% as in |pdfbookedition={[en]Second| |edition}|. +% +% The number of pages in the published, print version of the document +% can be expressed with \moptname{pdfnumpages}. +% Note~\ref{note:page-counting} on page~\pageref{note:page-counting} +% explains how to automatically assign a value to \optname{pdfnumpages}. % % \acro{XMP} metadata can include a number of dates (in fact, % timestamps, as they include both date and time components). -% \optname{pdfdate} specifies the document date. It is analogous to the +% \moptname{pdfdate} specifies the document date. It is analogous to the % \LaTeX\ |\date| command, and, like |\date|, defaults to the date the % document was built. It must be specified in either \acro{XMP} % format~\cite{Adobe2012:XMP} or \acro{PDF} format~\cite{Adobe2008:PDF}. @@ -453,16 +614,16 @@ % midnight U.S. Mountain Daylight Time (UTC-6) on the 23rd day of % September in the year~2014 should be written as % \texttt{2014-09-23T14:15:09-06:00}. This can be truncated (with loss -% of information) to \texttt{2014-09-23T14:15:09} or -% \texttt{2014-09-23T14:15} or \texttt{2014-09-23} or \texttt{2014-09} +% of information) to \texttt{2014-09-23T14:15:09}, +% \texttt{2014-09-23T14:15}, \texttt{2014-09-23}, \texttt{2014-09}, % or \texttt{2014} but no other subsets. \acro{PDF} dates are written % in the form |D:|\textsc{yyyymmdd}hhmmss|+|\textsc{tt}|'|tt|'|. The % same date in the preceding example would be written as % \texttt{D:20140923141509-06'00'} in \acro{PDF} format. % % The document's creation date, modification date, and metadata date are -% normally set automatically, but \optname{pdfcreationdate}, -% \optname{pdfmoddate}, and \optname{pdfmetadate} can be used to +% normally set automatically, but \moptname{pdfcreationdate}, +% \moptname{pdfmoddate}, and \moptname{pdfmetadate} can be used to % override the defaults. Like \optname{pdfdate}, \optname{pdfmetadate} % can be specified in either \acro{XMP} or \acro{PDF} format. However, % because \pkgname{hyperref} defines \optname{pdfcreationdate} and @@ -472,119 +633,123 @@ % would need to specify any of \optname{pdfcreationdate}, % \optname{pdfmoddate}, or \optname{pdfmetadate}. % -% \optname{pdfcopyright} defines the copyright text, and -% \optname{pdflicenseurl} identifies a \acro{URL} that points to the -% document's license agreement. -% -% \acro{XMP} can include a universally unique identifier (\acro{UUID}) -% for each document and for each instance of a given document. By -% default, \pkgname{hyperxmp} assigns a version~4 (i.e.,~pseudorandom) -% \acro{UUID}~\cite{Leach2005:uuid} for each of these. However, a -% document can alternatively specify a particular document identifier -% using \optname{pdfdocumentid} and (not normally recommended) a -% particular instance identifier using \optname{pdfinstanceid}. These -% should be of the form -% \texttt{uuid:}\textit{xxxxxxxx}\texttt{-}\textit{xxxx}\texttt{-}\textit{xxxx}\texttt{-}\textit{xxxx}\texttt{-}\textit{xxxxxxxxxxxx}, -% where ``\textit{x}'' is a lowercase hexadecimal number. For example, -% \texttt{uuid:53ab7f19-a48c-5177-8bb2-403ad907f632} is a valid argument -% to \optname{pdfdocumentid} (or \optname{pdfinstanceid}). See Leach, -% Mealling, and Salz's \acro{UUID} specification document for details on -% how to produce the various forms of -% \acro{UUID}s~\cite{Leach2005:uuid}. -% -% \optname{pdfmetalang} indicates the natural language in which certain -% metadata---specifically, the document's title, subject, and copyright -% statement---are written. The language should be specified using an -% \acro{IETF} language tag~\cite{IANA2011:lang-tags}, for example, -% ``|en|'' for English, ``|en-US|'' for specifically United States -% English, ``|de|'' for German, and so forth. If \optname{pdfmetalang} -% is not specified, \pkgname{hyperxmp} assumes the metadata language is -% the same as the document language (\pkgname{hyperref}'s -% \optname{pdflang} option). If neither \optname{pdfmetalang} nor -% \optname{pdflang} is specified, \pkgname{hyperxmp} uses only -% ``|x-default|'' as the metadata language. Note that ``|x-default|'' -% metadata are always included in addition to the specified metadata -% language, as the user reading the document may not have specified a -% language preference. +% \moptname{pdftype} describes the type of document being produced. +% This refers to ``the nature or genre of the +% resource''~\cite{Adobe2012:XMP} such as |poem|, |novel| or |working| +% |paper|, as opposed to the file format (always |application/pdf| when +% generated by \pkgname{hyperxmp}). Although \optname{pdftype} can be +% assigned an arbitrary piece of text, the \acro{XMP} specification +% recommends selecting types from a ``controlled vocabulary'' such as +% the \acro{DCMI} Type Vocabulary~\cite{DCMI2012:meta-terms}. The +% \acro{DCMI} Type Vocabulary currently consists of only |Collection|, +% |Dataset|, |Event|, |Image|, |InteractiveResource|, |MovingImage|, +% |PhysicalObject|, |Service|, |Software|, |Sound|, |StillImage|, and +% |Text|. \optname{pdftype} defaults to |Text|, which refers to +% ``books, letters, dissertations, poems, newspapers, articles, archives +% of mailing lists,''~\cite{DCMI2012:meta-terms} and other forms of +% text---all things \LaTeX\ is commonly used to typeset. % -% A rarely needed option, \optname{pdfsource}, overrides the name of the -% \LaTeX\ source file. It defaults to ``|\jobname.tex|'' but can be +% The \moptname{pdfbytes} option expresses the document's file size in +% bytes. The intention is for this to be used to display an estimate of +% download time to a user or to serve as a quick check on whether a file +% was transmitted correctly between systems. This feature is easiest to +% use in conjunction with \pdfTeX's |\pdffilesize| primitive: +% ``|pdfbytes={\pdffilesize{\jobname.pdf}}|''. Note that this requires +% a second run of |pdftex| because it queries the size of the \acro{PDF} +% file from the \emph{previous} run. +% +% A rarely needed option, \moptname{pdfsource}, overrides the name of +% the \LaTeX\ source file. It defaults to |\jobname.tex| but can be % replaced by any other string. If \optname{pdfsource} is given an % empty argument, no document source will be specified at all. % -% \optname{pdftype} describes the type of document being produced. This -% refers to ``the nature or genre of the resource''~\cite{Adobe2012:XMP} -% such as ``|poem|'', ``|novel|'' or ``|working paper|'', as opposed to -% the file format (always ``|application/pdf|'' when generated by -% \pkgname{hyperxmp}). Although \optname{pdftype} can be assigned an -% arbitrary piece of text, the \acro{XMP} specification recommends -% selecting types from a ``controlled vocabulary'' such as the DCMI Type -% Vocabulary~\cite{DCMI2012:meta-terms}. The DCMI Type Vocabulary -% currently consists of only ``|Collection|'', ``|Dataset|'', -% ``|Event|'', ``|Image|'', ``|InteractiveResource|'', -% ``|MovingImage|'', ``|PhysicalObject|'', ``|Service|'', -% ``|Software|'', ``|Sound|'', ``|StillImage|'', and ``|Text|''. -% \optname{pdftype} defaults to ``|Text|'', which refers to ``books, -% letters, dissertations, poems, newspapers, articles, archives of -% mailing lists,''~\cite{DCMI2012:meta-terms} and other forms of -% text---all things \LaTeX\ is commonly used to typeset. +% Two other rarely needed options, \moptname{pdfaconformance} and +% \moptname{pdfapart}, are used in conjunction with \pkgname{hyperref}'s +% \optname{pdfa} option to claim a particular \acro{PDF/A} standard by +% which the document abides. They default to \optname{pdfapart}=|1| and +% \optname{pdfaconformance}=|B|, indicating the \acro{PDF/A}-\textsc{1b} +% standard. These can be changed (with caution) to assert that the +% document abides by a different standard +% (e.g.,~\acro{PDF/A}-\textsc{2u}). +% +% \bigskip % % It is usually more convenient to provide values for those options using % \pkgname{hyperref}'s |\hypersetup| command than on the |\usepackage| % command line. See % \href{http://mirrors.ctan.org/macros/latex/contrib/hyperref/hyperref.pdf}{the -% \pkgname{hyperref} manual} for more information. The following is a -% sample \LaTeX\ document that provides values for most of the metadata -% options that \pkgname{hyperxmp} recognizes: +% \pkgname{hyperref} manual} for more information. +% +% +% \subsection{A complete example} +% +% The following is a sample \LaTeX\ document that provides values for +% most of the metadata options that \pkgname{hyperxmp} recognizes: % % \Needspace{4\baselineskip} % \refstepcounter{pagelabel} % \label{page:begin-sample-doc} % \begin{verbatim} -% \documentclass{article} -% \usepackage{hyperxmp} -% \usepackage[unicode]{hyperref} -% \title{% -% On a heuristic viewpoint concerning the production and -% transformation of light} -% \author{Albert Einstein} -% \date{March 17, 1905} -% \hypersetup{% -% pdftitle={% -% On a heuristic viewpoint concerning the production and -% transformation of light}, -% pdfauthor={Albert Einstein}, -% pdfauthortitle={Technical Assistant, Level III}, -% pdfdate={1905-03-17}, -% pdfcopyright={Copyright (C) 1905, Albert Einstein}, -% pdfsubject={photoelectric effect}, -% pdfkeywords={energy quanta, Hertz effect, quantum physics}, -% pdflicenseurl={http://creativecommons.org/licenses/by-nc-nd/3.0/}, -% pdfcaptionwriter={Scott Pakin}, -% pdfcontactaddress={Kramgasse 49}, -% pdfcontactcity={Bern}, -% pdfcontactpostcode={3011}, -% pdfcontactcountry={Switzerland}, -% pdfcontactphone={031 312 00 91}, -% pdfcontactemail={aeinstein@ipi.ch}, -% pdfcontacturl={% -% http://einstein.biz/, -% https://www.facebook.com/AlbertEinstein -% }, -% pdfdocumentid={uuid:6d1ac9ec-4ff2-515a-954b-648eeb4853b0}, -% pdflang={en}, -% pdfmetalang={en}, -% baseurl={http://mirror.ctan.org/macros/latex/contrib/hyperxmp/} -% } -% \XMPLangAlt{de}{pdftitle={Über einen die Erzeugung und Verwandlung -% des Lichtes betreffenden heuristischen Gesichtspunkt}} -% \begin{document} -% \maketitle -% A profound formal difference exists between the theoretical -% concepts that physicists have formed about gases and other -% ponderable bodies, and Maxwell's theory of electromagnetic -% processes in so-called empty space\dots -% \end{document} +% \documentclass{article} +% \usepackage[utf8]{inputenc} +% \usepackage{hyperxmp} +% \usepackage[unicode]{hyperref} +% +% \title{% +% On a heuristic viewpoint concerning the production and +% transformation of light} +% \author{Albert Einstein} +% \date{March 17, 1905} +% +% \hypersetup{% +% pdftitle={% +% On a heuristic viewpoint concerning the production and +% transformation of light}, +% pdfsubtitle={[en-US]Putting that bum Maxwell in his place}, +% pdfauthor={Albert Einstein}, +% pdfauthortitle={\xmpquote{Technical Assistant\xmpcomma\ Level III}}, +% pdfdate={1905-03-17}, +% pdfcopyright={Copyright (C) 1905, Albert Einstein}, +% pdfsubject={photoelectric effect}, +% pdfkeywords={energy quanta, Hertz effect, quantum physics}, +% pdflicenseurl={http://creativecommons.org/licenses/by-nc-nd/3.0/}, +% pdfcaptionwriter={Scott Pakin}, +% pdfcontactaddress={Kramgasse 49}, +% pdfcontactcity={Bern}, +% pdfcontactpostcode={3011}, +% pdfcontactcountry={Switzerland}, +% pdfcontactphone={031 312 00 91}, +% pdfcontactemail={aeinstein@ipi.ch}, +% pdfcontacturl={% +% http://einstein.biz/, +% https://www.facebook.com/AlbertEinstein +% }, +% pdfdocumentid={uuid:6d1ac9ec-4ff2-515a-954b-648eeb4853b0}, +% pdfversionid={2.998e8}, +% pdfpublication={[de]Annalen der Physik}, +% pdfpubtype={journal}, +% pdfvolumenum={322}, +% pdfissuenum={6}, +% pdfpagerange={132-148}, +% pdfnumpages={17}, +% pdfissn={0003-3804}, +% pdfeissn={1521-3889}, +% pdflang={en}, +% pdfmetalang={en}, +% pdfurl={http://www.physik.uni-augsburg.de/annalen/history/einstein-papers/1905_17_132-148.pdf}, +% pdfdoi={10.1002/andp.19053220607}, +% pdfbytes={\pdffilesize{\jobname.pdf}} % Requires pdflatex +% } +% \XMPLangAlt{de}{pdftitle={Über einen die Erzeugung und Verwandlung des +% Lichtes betreffenden heuristischen Gesichtspunkt}} +% +% \begin{document} +% \maketitle +% A profound formal difference exists between the theoretical +% concepts that physicists have formed about gases and other +% ponderable bodies, and Maxwell's theory of electromagnetic +% processes in so-called empty space\dots +% \end{document} % \end{verbatim} % \refstepcounter{pagelabel} % \label{page:end-sample-doc} @@ -635,51 +800,68 @@ % \label{fig:xmp-metadata-2} % \end{figure} % -% \usagenote{Acrobat \pdfterm{Author} bug} -% \label{page:author-bug} -% A bug in Adobe Acrobat---at least in versions~10.0.1 and -% earlier---causes that \acro{PDF} reader to confuse the \acro{XMP} and -% non-\acro{XMP} author lists when displaying the document's metadata. -% Specifically, the first author is displayed as the concatenated list -% of authors from the non-\acro{XMP} data (\pdfterm{Author}) while the -% remaining authors are displayed from the \acro{XMP} data -% (\xmpterm{dc:creator}). For example, suppose that a document's authors -% are Jack Napier, Edward Nigma, and Harvey Dent. When displaying the -% document properties, Adobe Acrobat replaces ``Jack Napier'' with a -% single author named ``Jack Napier, Edward Nigma, Harvey Dent'' and -% leaves ``Edward Nigma'' and ``Harvey Dent'' as the second and third -% authors, respectively. -% -% \DescribeMacro{\XMPTruncateList} -% The \pkgname{hyperxmp} package provides a workaround for this bug in -% the form of the |\XMPTruncateList| macro. |\XMPTruncateList| takes -% the name of a list (a \pkgname{hyperref} option name) and replaces the -% list with the value of its first element. Currently, the only -% meaningful usage is to put % +% \subsection{Usage notes} +% +% \usagenote{Conflicting metadata in PDF/A documents} +% A \acro{PDF} file includes an \pdfterm{Info} dictionary containing +% \pdfterm{Author}, \pdfterm{Title}, \pdfterm{Subject}, and +% \pdfterm{Keywords} keys. The \pkgname{hyperref} package's +% \optname{pdfauthor}, \optname{pdftitle}, \optname{pdfsubject}, and +% \optname{pdfkeywords} options assign values to those keys. The +% \pkgname{hyperxmp} package additionally uses those options to assign +% values to various \acro{XMP} metadata: \xmpterm{dc:creator}, +% \xmpterm{dc:title}, \xmpterm{dc:description}, and +% \xmpterm{pdf:Keywords}. The \acro{PDF/A} specification indicates that +% values that appear in both the \acro{PDF} \pdfterm{Info} dictionary +% and \acro{XMP} packet must match. The problem is that in \acro{XMP}, +% the author and keywords can be proper lists, as in +% +% \Needspace{7\baselineskip} % \begin{verbatim} -% \XMPTruncateList{pdfauthor} +% <dc:creator> +% <rdf:Seq> +% <rdf:li>Curly Howard</rdf:li> +% <rdf:li>Larry Fine</rdf:li> +% <rdf:li>Moe Howard</rdf:li> +% </rdf:Seq> +% </dc:creator> % \end{verbatim} % % \noindent -% in your document's preamble. This will cause Adobe Acrobat to -% properly display all of the authors but at the cost of other -% \acro{PDF} readers likely displaying only the first author. +% while in \acro{PDF}, the author and keywords are specified as flat +% strings. Alas, there is no definition of how a list should be +% collapsed to a flat string: ``\texttt{Curly Howard, Larry Fine, Moe +% Howard}'' or ``\texttt{Curly Howard; Larry Fine; Moe Howard}'' or +% something else. I have not yet found a form of flat string that +% passes all \acro{PDF/A} validators. Furthermore, when Adobe +% Acrobat---at least Adobe Acrobat DC (2019) and earlier +% versions---converts a \acro{PDF} file to \acro{PDF/A} format, it does +% so by discarding all but the first author, which is an unsatisfying +% solution. +% +% Starting with version~4.0, \pkgname{hyperxmp}'s solution is to +% suppress writing metadata to the \acro{PDF} \pdfterm{Info} dictionary +% and write it only to the \acro{XMP} packet. This appears to pacify +% \acro{PDF/A} validators yet retains the author and keyword lists in +% their non-truncated form. If desired, the \pdfterm{Info} dictionary +% can be retained by passing the \optname{keeppdfinfo} option to +% \cs{hypersetup}. % % \usagenote{Acrobat multiline-field bug} % The \acro{IPTC} Photo Metadata schema states that ``the [contact] % address is a multiline field''~\cite{IPTC2010:photo-meta}. % \pkgname{hyperxmp} converts commas in \optname{pdfcontactaddress}'s % argument to line breaks in the generated \acro{XML}\@. Unfortunately, -% A bug in Adobe Acrobat---at least in versions~10.0.1 and -% earlier---causes that \acro{PDF} reader to discard line breaks in the -% contact address. Interestingly, Adobe Illustrator CS5 correctly -% displays the contact address. -% \DescribeMacro{\xmplinesep} -% If you find Adobe Acrobat's behavior bothersome, you can redefine the -% |\xmplinesep| macro as a string to use as an address-line separator. -% For example, the following replaces all commas appearing in -% \optname{pdfcontactaddress}'s argument with semicolons: +% A bug in Adobe Acrobat---at least in Adobe Acrobat DC (2019) and +% earlier versions---causes that \acro{PDF} reader to discard line +% breaks in the contact address. Interestingly, Adobe Illustrator CS5 +% correctly displays the contact address. If you find Adobe Acrobat's +% behavior bothersome, you can redefine the +% \DescribeMacro{\xmplinesep}|\xmplinesep| macro as a string to use as +% an address-line separator. For example, the following replaces all +% commas appearing in \optname{pdfcontactaddress}'s argument with +% semicolons: % % \begin{verbatim} % \renewcommand*{\xmlinesep}{;} @@ -800,6 +982,7 @@ % a modicum of \acro{XMP} metadata with no additional effort. % % \usagenote{Multilingual metadata} +% \label{note:multilingual} % The \optname{pdfmetalang} option specifies the language in which the % document's metadata is written. It defaults to the value of % \optname{pdflang}, which specifies the document language. @@ -836,6 +1019,7 @@ % \end{verbatim} % % \usagenote{Expandable arguments} +% \label{note:expandable} % All arguments passed to \pkgname{hyperxmp} options must be expandable, % in \tex\ terminology. This implies that any macros that are used in % arguments are limited to a relatively small set of operations (such as @@ -870,12 +1054,77 @@ % package in the output file to ensure that any macros used in arguments % to \pkgname{hyperxmp} options produced the expected output. % +% \usagenote{Automatic page counting} +% \label{note:page-counting} +% Although \optname{pdfnumpages} and \optname{pdfpagerange} are intended +% to refer to pages in the final, published version of a document, it +% would be convenient for them to be generated automatically when +% producing a standalone \acro{PDF} file that is not intended to be +% incorporated into a book, journal, or other publication (or if it is +% known that the pages will not be renumbered for publication). One +% approach is to use the \pkgname{totpages} package to keep track of the +% number of pages. +% +% \begin{verbatim} +% \hypersetup{% +% pdfnumpages={\ref*{TotPages}} +% } +% \end{verbatim} +% +% \pkgname{totpages} can likewise help generate \optname{pdfpagerange}. +% For documents numbered from~1 to~$n$, a simple +% +% \begin{verbatim} +% \hypersetup{% +% pdfpagerange={1-\ref*{TotPages}} +% } +% \end{verbatim} +% +% \noindent +% should suffice. A bit more effort is needed for documents that change +% numbering schemes, such as using lowercase Roman numerals for the +% front matter and Arabic numerals for the main matter and back matter. +% One approach is to use \cs{label} to mark the first and last page of +% each numbering scheme and specify \optname{pdfpagerange} as in the +% following: +% +% \Needspace{6\baselineskip} +% \begin{verbatim} +% \hypersetup{% +% pdfpagerange={% +% \pageref*{page:begin-front}-\pageref*{page:end-front},% +% 1-\pageref*{TotPages}% +% } +% } +% \end{verbatim} +% +% I don't know how unnumbered pages (e.g.,~blank pages and the title +% page) are supposed to be handled. I suppose blank pages can be +% omitted from \optname{pdfpagerange}, and title page can be either +% omitted or listed as |title|, for example. +% +% It appears that at least with version~2.00 of \pkgname{totpages}, the +% |TotPages| label is not defined until after the |\begin{document}|. +% Consequently, using |TotPages| within a \cs{hypersetup} invocation in +% the document's preamble will produce ``|??|'' as the page count in the +% \acro{XMP} packet. The solution is either to assign +% \optname{pdfnumpages} and \optname{pdfpagerange} after the +% |\begin{document}| or to ask \LaTeX\ to do that on your behalf: +% +% \begin{verbatim} +% \AtBeginDocument{% +% \hypersetup{% +% pdfnumpages={\ref*{TotPages}}, +% pdfpagerange={1-\ref*{TotPages}} +% }% +% } +% \end{verbatim} +% % % \StopEventually{^^A -% \section{Future Work} -% \label{sec:future-work} +% \section{Help Wanted} % -% \paragraph{Help wanted} +% \paragraph{Comma handling} % Ideally, \texttt{\string\xmpquote} should automatically replace all % commas with \texttt{\string\xmpcomma}. Unfortunately, my \tex\ skills % are insufficient to pull that off. If you know a way to make @@ -886,7 +1135,7 @@ % % \appendix % -% \section{Sample XMP packet} +% \section{Sample XMP Packet} % \label{sec:sample-packet} % % The following is an example of a complete \acro{XMP} packet as may be @@ -901,32 +1150,32 @@ % \begin{thebibliography}{1} % \bibitem{Adobe2010:pdfmark} % Adobe Systems, Inc., San Jose, California. -% \newblock {\em {A}dobe {A}crobat~{X} {SDK} Help, pdfmark Reference}. +% \newblock \emph{{A}dobe {A}crobat~{X} {SDK} Help, pdfmark Reference}. % \newblock Available from % \url{http://www.adobe.com/devnet/acrobat/documentation.html}. % % \bibitem{Adobe1996:postscript} % {Adobe Systems, Inc.} -% \newblock {\em {P}ost{S}cript Language Reference Manual}. +% \newblock \emph{{P}ost{S}cript Language Reference Manual}. % \newblock Addison-Wesley, 2nd edition, January 1996, ISBN: \mbox{0-201-18127-4}. % % \bibitem{Adobe2008:PDF} % Adobe Systems, Inc., San Jose, California. -% \newblock {\em Document Management---Portable Document Format---Part 1: +% \newblock \emph{Document Management---Portable Document Format---Part 1: % PDF~1.7}, July 2008. % \newblock ISO \mbox{32000-1} standard document. Available from % \url{http://wwwimages.adobe.com/www.adobe.com/content/dam/Adobe/en/devnet/pdf/pdfs/PDF32000_2008.pdf}. % % \bibitem{Adobe2012:XMP} % Adobe Systems, Inc., San Jose, California. -% \newblock {\em {XMP} Specification Part~1: Data model, Serialization, and Core +% \newblock \emph{{XMP} Specification Part~1: Data model, Serialization, and Core % Properties}, April 2012. % \newblock Available from % \url{http://wwwimages.adobe.com/www.adobe.com/content/dam/Adobe/en/devnet/xmp/pdfs/cc-201306/XMPSpecificationPart1.pdf}. % % \bibitem{DCMI2012:meta-terms} % DCMI Usage Board -% \newblock {\em DCMI Metadata Terms}, June~14, 2012. +% \newblock \emph{DCMI Metadata Terms}, June~14, 2012. % \newblock Available from \url{http://dublincore.org/documents/dcmi-terms/}. % % \bibitem{Downes1994:ATB15} @@ -937,9 +1186,23 @@ % \newblock Archived by Google at % \url{http://groups.google.com/group/comp.text.tex/msg/7da7643b9e8f3b48}. % +% \bibitem{PRISM2012:basic-meta} +% International Digital Enterprise Alliance, Inc. +% \newblock \emph{Publishing Requirements for Industry Standard Metadata, +% Version~3.0: {PRISM} Basic Metadata Specification}, October~12, 2012. +% \newblock Available from +% \url{http://www.prismstandard.org/specifications/3.0/PRISM_Basic_Metadata_3.0.htm}. +% +% \bibitem{PRISM2012:cont-voc} +% International Digital Enterprise Alliance, Inc. +% \newblock \emph{Publishing Requirements for Industry Standard Metadata, +% Version~3.0: {PRISM} Controlled Vocabularies Specification}, October~4, 2012. +% \newblock Available from +% \url{http://www.prismstandard.org/specifications/3.0/PRISM_CV_Spec_3.0.pdf}. +% % \bibitem{IPTC2010:photo-meta} % International Press Telecommunications Council. -% \newblock {\em {IPTC} Photo Metadata: Core 1.1/Extension 1.1}, July 2010. +% \newblock \emph{{IPTC} Photo Metadata: Core 1.1/Extension 1.1}, July 2010. % \newblock Revision~1. Available from % \url{http://www.iptc.org/std/photometadata/specification/IPTC-PhotoMetadata-201007_1.pdf}. % @@ -959,14 +1222,14 @@ % % \bibitem{PDFA2008:xmp-props} % PDF/A Competence Center, Berlin, Germany. -% \newblock {\em {T}ech{N}ote~0008: Predefined {XMP} Properties in {PDF/A-1}}, +% \newblock \emph{{T}ech{N}ote~0008: Predefined {XMP} Properties in {PDF/A-1}}, % March~20, 2008. % \newblock Available from % \url{http://www.pdfa.org/wp-content/uploads/2011/08/tn0008_predefined_xmp_properties_in_pdfa-1_2008-03-20.pdf}. % % \bibitem{PDFA2008:ext-schemas} % PDF/A Competence Center, Berlin, Germany. -% \newblock {\em {T}ech{N}ote~0009: {XMP} Extension Schemas in {PDF/A-1}}, +% \newblock \emph{{T}ech{N}ote~0009: {XMP} Extension Schemas in {PDF/A-1}}, % March~20, 2008. % \newblock Available from % \url{http://www.pdfa.org/wp-content/uploads/2011/08/tn0009_xmp_extension_schemas_in_pdfa-1_2008-03-20.pdf}. @@ -1100,7 +1363,7 @@ % \begin{macro}{\@pdfdatetime} % Prepare to store the document's date and (optionally) time. Whether % specified by the author in \acro{XMP} format or \acro{PDF} format -% (cf.~Section~\ref{sec:date-manip}) we always store |\@pdfdatetime| as +% (see Section~\ref{sec:date-manip}) we always store |\@pdfdatetime| as % an \acro{XMP}-format string. % \begin{macrocode} \def\@pdfdatetime{} @@ -1125,7 +1388,7 @@ % \begin{macro}{\@pdfmetadatetime} % Prepare to store the document's metadata date and (optionally) time. % Whether specified by the author in \acro{XMP} format or \acro{PDF} -% format (cf.~Section~\ref{sec:date-manip}) we always store +% format (see Section~\ref{sec:date-manip}) we always store % |\@pdfmetadatetime| as an \acro{XMP}-format string. % \begin{macrocode} \def\@pdfmetadatetime{} @@ -1246,6 +1509,139 @@ % \end{macrocode} % \end{macro} % +% \begin{macro}{\@pdfversionid} +% Prepare to store a \acro{UUID} that represents the current version of +% the document. +% \begin{macrocode} +\def\@pdfversionid{} +\define@key{Hyp}{pdfversionid}{\hyxmp@pdfstringdef\@pdfversionid{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfpublication} +% Prepare to store the name of the publication in which the +% document was published. +% \begin{macrocode} +\def\@pdfpublication{} +\define@key{Hyp}{pdfpublication}{\hyxmp@pdfstringdef\@pdfpublication{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfpubtype} +% Prepare to store the type of the publication in which the +% document was published. +% \begin{macrocode} +\def\@pdfpubtype{} +\define@key{Hyp}{pdfpubtype}{\hyxmp@pdfstringdef\@pdfpubtype{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfbytes} +% Prepare to store the size of the file in bytes. +% \begin{macrocode} +\def\@pdfbytes{} +\define@key{Hyp}{pdfbytes}{\hyxmp@pdfstringdef\@pdfbytes{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfnumpages} +% Prepare to store the number of pages in the file. +% \begin{macrocode} +\def\@pdfnumpages{} +\define@key{Hyp}{pdfnumpages}{\hyxmp@pdfstringdef\@pdfnumpages{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfissn} +% Prepare to store the \acro{ISSN} of the publication in which the +% document was published. +% \begin{macrocode} +\def\@pdfissn{} +\define@key{Hyp}{pdfissn}{\hyxmp@pdfstringdef\@pdfissn{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfeissn} +% Prepare to store the \acro{ISSN} of the electronic version of the +% publication in which the document was published. +% \begin{macrocode} +\def\@pdfeissn{} +\define@key{Hyp}{pdfeissn}{\hyxmp@pdfstringdef\@pdfeissn{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfisbn} +% Prepare to store the \acro{ISBN} of the publication in which the +% document was published. +% \begin{macrocode} +\def\@pdfisbn{} +\define@key{Hyp}{pdfisbn}{\hyxmp@pdfstringdef\@pdfisbn{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfbookedition} +% Prepare to store the edition of the book in which the document +% was published. +% \begin{macrocode} +\def\@pdfbookedition{} +\define@key{Hyp}{pdfbookedition}{\hyxmp@pdfstringdef\@pdfbookedition{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfvolumenum} +% Prepare to store the volume identifier of the publication in which the +% document was published. +% \begin{macrocode} +\def\@pdfvolumenum{} +\define@key{Hyp}{pdfvolumenum}{\hyxmp@pdfstringdef\@pdfvolumenum{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfissuenum} +% Prepare to store the identifier of the issue within a volume of the +% publication in which the document was published. +% \begin{macrocode} +\def\@pdfissuenum{} +\define@key{Hyp}{pdfissuenum}{\hyxmp@pdfstringdef\@pdfissuenum{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfpagerange} +% Prepare to store the document's range of pages within the publication +% in which the document was published. +% \begin{macrocode} +\def\@pdfpagerange{} +\define@key{Hyp}{pdfpagerange}{\hyxmp@pdfstringdef\@pdfpagerange{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfdoi} +% Prepare to store a \acro{DOI} that represents the current instance of +% the document. +% \begin{macrocode} +\def\@pdfdoi{} +\define@key{Hyp}{pdfdoi}{\hyxmp@pdfstringdef\@pdfdoi{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfurl} +% Prepare to store a \acro{URL} that represents where the document +% can be found. Note that we do not prepend \optname{baseurl} to +% the value provided. +% \begin{macrocode} +\def\@pdfurl{} +\define@key{Hyp}{pdfurl}{\hyxmp@pdfstringdef\@pdfurl{#1}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@pdfsubtitle} +% Prepare to store the document's subtitle. +% \begin{macrocode} +\def\@pdfsubtitle{} +\define@key{Hyp}{pdfsubtitle}{\hyxmp@pdfstringdef\@pdfsubtitle{#1}} +% \end{macrocode} +% \end{macro} +% % The following eight macros---|\@pdfcontactaddress|, % |\@pdfcontactcity|, |\@pdfcontactregion|, |\@pdfcontactpostcode|, % |\@pdfcontactcountry|, |\@pdfcontactphone|, |\@pdfcontactemail|, and @@ -1342,6 +1738,25 @@ % \end{macrocode} % \end{macro} % +% \begin{macro}{\hyxmp@suppress@pdf@metadata} +% Suppress \pkgname{hyperref} from writing \pdfterm{Author}, +% \pdfterm{Title}, \pdfterm{Subject}, and other \acro{PDF} metadata into +% the \pdfterm{Info} dictionary. This prevents conflicts between the +% \acro{PDF} metadata and the \acro{XMP} metadata, which cause +% \acro{PDF/A} validation to fail. The \acro{PDF} metadata can be +% restored by passing the \optname{keeppdfinfo} option to +% |\hypersetup|. +% \changes{v4.0}{2019/03/31}{Added this macro} +% \begin{macrocode} +\def\hyxmp@suppress@pdf@metadata{% + \global\let\PDF@FinishDoc=\@empty +} +\define@key{Hyp}{keeppdfinfo}[true]{% + \gdef\hyxmp@suppress@pdf@metadata{}% +} +% \end{macrocode} +% \end{macro} +% % \changes{v2.1}{2012/09/16}{Enabled \protect\pkgname{hyperxmp} and % \protect\pkgname{hyperref} to be loaded in either order. This addresses % a bug report by Yury Donskoy} @@ -1536,6 +1951,8 @@ \@baseurl \@pdfauthor \@pdfauthortitle + \@pdfbookedition + \@pdfbytes \@pdfcaptionwriter \@pdfcontactaddress \@pdfcontactcity @@ -1548,14 +1965,27 @@ \@pdfcopyright \@pdfcreationdate \@pdfdatetime + \@pdfdoi + \@pdfeissn + \@pdfisbn + \@pdfissn + \@pdfissuenum \@pdfkeywords \@pdflang \@pdflicenseurl \@pdfmetadatetime \@pdfmoddate + \@pdfnumpages + \@pdfpagerange + \@pdfpublication + \@pdfpubtype \@pdfsubject + \@pdfsubtitle \@pdftitle \@pdftype + \@pdfurl + \@pdfversionid + \@pdfvolumenum }% \ifx\hyxmp@concated@metadata\@empty \PackageWarningNoLine{hyperxmp}{% @@ -1653,6 +2083,7 @@ provide metadata values to hyperxmp}% % and thereby \pkgname{hyperxmp}. % \begin{macrocode} \hyxmp@at@end{% + \hyxmp@suppress@pdf@metadata \hyxmp@find@metadata \hyxmp@embed@packet }% @@ -1795,17 +2226,22 @@ disabled}% % \changes{v2.3b}{2013/07/18}{Made all definitions local to avoid % spurious \texttt{Too many unprocessed floats} errors when running % with \string\pkgname{memoir}} +% \changes{v4.0}{2019/03/31}{Deprecated this macro} % \begin{macro}{\hyxmp@temp@str} % \begin{macro}{\hyxmp@temp@list} % \begin{macro}{\@elt} -% As a workaround for Adobe Acrobat's inability to display author lists -% correctly (cf.~``Acrobat \pdfterm{Author} bug'' on -% page~\pageref{page:author-bug}) we introduce a hack that replaces a +% As a workaround for the inability of older Adobe Acrobat versions to +% display author lists correctly we introduce a hack that replaces a % list with its first element. One can then write % ``|\XMPTruncateList{pdfauthor}|'' and have Adobe Acrobat display the -% author list correctly. It's sad that this is necessary, though. +% author list correctly. % \begin{macrocode} \newcommand{\XMPTruncateList}[1]{{% + \PackageWarning{hyperxmp}{% + \noexpand\XMPTruncateList has been deprecated since\MessageBreak + hyperxmp 4.0 and may be removed in future\MessageBreak + versions of the package. \noexpand\XMPTruncateList\MessageBreak + was found}% \edef\hyxmp@temp@str{\csname hyxmp@#1\endcsname}% \hyxmp@commas@to@list{\hyxmp@temp@list}{\hyxmp@temp@str}% \def\@elt##1{% @@ -2310,7 +2746,7 @@ disabled}% \newcommand*{\hyxmp@xmlify}[1]{% \gdef\hyxmp@xmlified{}% % \end{macrocode} -% Escaped PDF string~$\rightarrow$ \term{PDFDocEncoding}/\term{Unicode} +% Escaped \acro{PDF} string~$\rightarrow$ \term{PDFDocEncoding}/\term{Unicode} % \begin{macrocode} \EdefUnescapeString\hyxmp@text{#1}% \ifhyxmp@unicodetex @@ -3090,10 +3526,6 @@ _______________________________________________________________^^J% % even when empty. Florian Breitwieser noted that this is necessary % for \protect\acro{PDF/A}-1b compliance} % \begin{macrocode} - \hyxmp@add@to@xml{% -______<rdf:Description rdf:about=""^^J% -___________xmlns:pdf="http://ns.adobe.com/pdf/1.3/">^^J% - }% \hyxmp@add@simple@var{pdf:Keywords}{@pdfkeywords}% \hyxmp@add@simple@var{pdf:Producer}{@pdfproducer}% \@ifundefined{pdfvariable}{% @@ -3114,15 +3546,20 @@ ___________xmlns:pdf="http://ns.adobe.com/pdf/1.3/">^^J% % \begin{macrocode} \hyxmp@add@simple{pdf:PDFVersion}{1.\the\pdfvariable minorversion}% }% - \hyxmp@add@to@xml{% -______</rdf:Description>^^J% - }% } % \end{macrocode} % \end{macro} % +% \begin{macro}{\hyxmp@extra@indent} +% This macro is used internally to increase the amount of indentation +% when writing certain \acro{XML} data. It is normally defined as empty +% but can temporarily be redefined to a sequence of |\space| characters. +% \begin{macrocode} +\newcommand*{\hyxmp@extra@indent}{} +% \end{macrocode} +% \end{macro} +% % \begin{macro}{\hyxmp@add@simple} -% \begin{macro}{\hyxmp@string} % Given an \acro{XMP} tag~(|#1|) and a string~(|#2|), if the string is % nonempty, add a begin tag, the string, and an end tag to the packet. % The ``|simple|'' in the macro name indicates that the string is output @@ -3130,18 +3567,15 @@ ______</rdf:Description>^^J% % \changes{v2.0}{2012/08/25}{Added this macro} % \begin{macrocode} \newcommand*{\hyxmp@add@simple}[2]{% - \edef\hyxmp@string{#2}% - \ifx\hyxmp@string\@empty - \else - \hyxmp@xmlify{\hyxmp@string}% + \@ifnotmtargexp{#2}{% + \hyxmp@xmlify{#2}% \hyxmp@add@to@xml{% -_________<#1>\hyxmp@xmlified</#1>^^J% + \hyxmp@extra@indent______<#1>\hyxmp@xmlified</#1>^^J% }% - \fi + }% } % \end{macrocode} % \end{macro} -% \end{macro} % % \begin{macro}{\hyxmp@add@simple@var} % Given an \acro{XMP} tag~(|#1|) and a variable name~(|#2|), if the @@ -3158,13 +3592,64 @@ _________<#1>\hyxmp@xmlified</#1>^^J% \else \hyxmp@xmlify{\csname#2\endcsname}% \hyxmp@add@to@xml{% -_________<#1>\hyxmp@xmlified</#1>^^J% + \hyxmp@extra@indent______<#1>\hyxmp@xmlified</#1>^^J% }% \fi } % \end{macrocode} % \end{macro} % +% \begin{macro}{\hyxmp@add@simple@lang} +% Given an \acro{XMP} tag~(|#1|) and a string~(|#2|), if the string is +% nonempty, add a begin tag, the string, and an end tag to the packet. +% The ``|simple|'' in the macro name indicates that the string is output +% without variations for different languages. However, if the string +% begins with a language code in square brackets, specify that as the +% (sole) language for the tag. +% \changes{v4.0}{2019/03/12}{Added this macro} +% \begin{macrocode} +\newcommand*{\hyxmp@add@simple@lang}[2]{% + \@ifnotmtarg{#2}{% + \hyxmp@xmlify{#2}% + \expandafter\hyxmp@add@simple@lang@i\hyxmp@xmlified\relax{#1}% + }% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hyxmp@add@simple@lang@i} +% This is a helper macro for |\hyxmp@add@simple@lang|. It takes an +% optional language code (in brackets), text up to |\relax|, and a tag, +% and typesets the text within the \acro{XML} tag. +% \begin{macrocode} +\newcommand*{\hyxmp@add@simple@lang@i}{% + \@ifnextchar[\hyxmp@add@simple@lang@ii{\hyxmp@add@simple@lang@ii[]}% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hyxmp@add@simple@lang@ii} +% This is another helper macro for |\hyxmp@add@simple@lang|. It takes +% an mandatory language code (in brackets; can be empty), text up to +% |\relax|, and a tag, and typesets the text within the \acro{XML} tag. +% \begin{macrocode} +\def\hyxmp@add@simple@lang@ii[#1]#2\relax#3{% + \@ifnotmtarg{#2}{% + \hyxmp@xmlify{#2}% + \@ifmtarg{#1}{% + \hyxmp@add@to@xml{% +______<#3>\hyxmp@xmlified</#3>^^J% + }% + }{% + \hyxmp@add@to@xml{% +______<#3 xml:lang="#1">\hyxmp@xmlified</#3>^^J% + }% + }% + }% +} +% \end{macrocode} +% \end{macro} +% % % \subsubsection{The Dublin Core schema} % \label{sec:dublin-core} @@ -3201,18 +3686,18 @@ _________<#1>\hyxmp@xmlified</#1>^^J% % \begin{macrocode} \let\hyxmp@value=\hyxmp@xmlified \hyxmp@add@to@xml{% -_________<dc:#2>^^J% -____________<rdf:Alt>^^J% +______<dc:#2>^^J% +________<rdf:Alt>^^J% }% \ifx\@pdfmetalang\hyxmp@x@default \else \hyxmp@xmlify{\@pdfmetalang}% \hyxmp@add@to@xml{% -_______________<rdf:li xml:lang="\hyxmp@xmlified">\hyxmp@value</rdf:li>^^J% +__________<rdf:li xml:lang="\hyxmp@xmlified">\hyxmp@value</rdf:li>^^J% }% \fi \hyxmp@add@to@xml{% -_______________<rdf:li xml:lang="\hyxmp@x@default">\hyxmp@value</rdf:li>^^J% +__________<rdf:li xml:lang="\hyxmp@x@default">\hyxmp@value</rdf:li>^^J% }% % \end{macrocode} % Include variants of the text expressed in other languages, as specified by @@ -3221,7 +3706,7 @@ _______________<rdf:li xml:lang="\hyxmp@x@default">\hyxmp@value</rdf:li>^^J% \def\do##1##2{ \hyxmp@xmlify{##2}% \hyxmp@add@to@xml{% -_______________<rdf:li xml:lang="##1">\hyxmp@xmlified</rdf:li>^^J% +__________<rdf:li xml:lang="##1">\hyxmp@xmlified</rdf:li>^^J% }% }% \csname hyxmp@alt@#2\endcsname @@ -3229,8 +3714,8 @@ _______________<rdf:li xml:lang="##1">\hyxmp@xmlified</rdf:li>^^J% % Complete this \acro{XMP} element. % \begin{macrocode} \hyxmp@add@to@xml{% -____________</rdf:Alt>^^J% -_________</dc:#2>^^J% +________</rdf:Alt>^^J% +______</dc:#2>^^J% }% \fi }% @@ -3260,8 +3745,8 @@ _________</dc:#2>^^J% % \begin{macrocode} \if@tempswa \hyxmp@add@to@xml{% -_________<dc:#2>^^J% -____________<rdf:#3>^^J% +______<dc:#2>^^J% +________<rdf:#3>^^J% }% \bgroup % \end{macrocode} @@ -3274,14 +3759,14 @@ ____________<rdf:#3>^^J% \hyxmp@commas@to@list\hyxmp@list{\hyxmp@xmlified}% \def\@elt##1{% \hyxmp@add@to@xml{% -_______________<rdf:li>##1</rdf:li>^^J% +__________<rdf:li>##1</rdf:li>^^J% }% }% \hyxmp@list \egroup \hyxmp@add@to@xml{% -____________</rdf:#3>^^J% -_________</dc:#2>^^J% +________</rdf:#3>^^J% +______</dc:#2>^^J% }% \fi } @@ -3310,11 +3795,7 @@ _________</dc:#2>^^J% % \acro{XMP} specifications, a detail identified by Florian Breitwieser} % \begin{macrocode} \newcommand*{\hyxmp@dc@schema}{% - \hyxmp@add@to@xml{% -______<rdf:Description rdf:about=""^^J% -____________xmlns:dc="http://purl.org/dc/elements/1.1/">^^J% -_________<dc:format>application/pdf</dc:format>^^J% - }% + \hyxmp@add@simple{dc:format}{application/pdf}% \hyxmp@rdf@dc[\ifHy@pdfa]{title}{\@pdftitle}% \hyxmp@rdf@dc[\ifHy@pdfa]{description}{\@pdfsubject}% \hyxmp@rdf@dc{rights}{\@pdfcopyright}% @@ -3327,9 +3808,6 @@ _________<dc:format>application/pdf</dc:format>^^J% \else \hyxmp@add@simple{dc:source}{\@pdfsource}% \fi - \hyxmp@add@to@xml{% -______</rdf:Description>^^J% - }% } % \end{macrocode} % \end{macro} @@ -3374,32 +3852,11 @@ ______</rdf:Description>^^J% % \begin{macrocode} \ifx\hyxmp@rights\@empty \else -% \end{macrocode} -% Header -% \begin{macrocode} - \hyxmp@add@to@xml{% -______<rdf:Description rdf:about=""^^J% -___________xmlns:xmpRights="http://ns.adobe.com/xap/1.0/rights/">^^J% - }% -% \end{macrocode} -% Copyright indication -% \begin{macrocode} \ifx\@pdfcopyright\@empty \else - \hyxmp@add@to@xml{% -_________<xmpRights:Marked>True</xmpRights:Marked>^^J% - }% + \hyxmp@add@simple{xmpRights:Marked}{True}% \fi -% \end{macrocode} -% License \acro{URL} -% \begin{macrocode} \hyxmp@add@simple{xmpRights:WebStatement}{\@pdflicenseurl}% -% \end{macrocode} -% Trailer -% \begin{macrocode} - \hyxmp@add@to@xml{% -______</rdf:Description>^^J% - }% \fi } % \end{macrocode} @@ -3411,32 +3868,30 @@ ______</rdf:Description>^^J% % \label{sec:xmp-media} % % \begin{macro}{\hyxmp@mm@schema} -% Add properties defined by the \acro{XMP} Media Management schema to the -% |\hyxmp@xml| macro. According to the \acro{XMP} specification, the -% \xmpterm{xmpMM:DocumentID} property is supposed to uniquely identify a -% document, and the \xmpterm{xmpMM:InstanceID} property is supposed to -% change with each save operation~\cite{Adobe2012:XMP}. As seen in -% Section~\ref{sec:uuid-gen}, we do what we can to honor this intention -% from within a \tex-based workflow. +% Add properties defined by the \acro{XMP} Media Management schema to +% the |\hyxmp@xml| macro. According to the \acro{XMP} specification, +% the \xmpterm{xmpMM:DocumentID} property is supposed to uniquely +% identify a document, and the \xmpterm{xmpMM:InstanceID} property is +% supposed to change with each save operation~\cite{Adobe2012:XMP}. As +% seen in Section~\ref{sec:uuid-gen}, we do what we can to honor this +% intention from within a \tex-based workflow. We additionally support +% the \xmpterm{xmpMM:VersionID} property, whose value is supplied by +% the author using \optname{pdfversionid}. % \changes{v1.4}{2011/05/29}{Renamed the \texttt{xapMM} namespace % prefix to \texttt{xmpMM}} % \changes{v3.5}{2018/11/27}{Generate \protect\cs{hyxmp@DocumentID} and % \protect\cs{hyxmp@InstanceID} only if the document does not already % define these using the \protect\optname{pdfdocumentid} and % \protect\optname{pdfinstanceid} options} +% \changes{v4.0}{2019/03/09}{Include \protect\xmpterm{xmpMM:VersionID} in +% the \protect\acro{XMP} packet} % \begin{macrocode} \gdef\hyxmp@mm@schema{% \@ifmtargexp{\hyxmp@DocumentID}{\hyxmp@def@DocumentID}{}% \@ifmtargexp{\hyxmp@InstanceID}{\hyxmp@def@InstanceID}{}% - \hyxmp@add@to@xml{% -______<rdf:Description rdf:about=""^^J% -____________xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/">^^J% - }% \hyxmp@add@simple{xmpMM:DocumentID}{\hyxmp@DocumentID}% \hyxmp@add@simple{xmpMM:InstanceID}{\hyxmp@InstanceID}% - \hyxmp@add@to@xml{% -______</rdf:Description>^^J% - }% + \hyxmp@add@simple{xmpMM:VersionID}{\@pdfversionid}% } % \end{macrocode} % \end{macro} @@ -3449,8 +3904,8 @@ ______</rdf:Description>^^J% % \begin{macro}{\hyxmp@createdate} % Define |\hyxmp@createdate| as the document's creation date but in % \acro{XMP} date format, not \acro{PDF} date format. We use -% |\hyxmp@createdate| for the \xmpterm{CreateDate}, -% \xmpterm{ModifyDate}, and \xmpterm{MetadataDate} fields. +% |\hyxmp@createdate| for the \xmpterm{xmp:CreateDate}, +% \xmpterm{xmp:ModifyDate}, and \xmpterm{xmp:MetadataDate} fields. % \begin{macrocode} \newcommand*{\hyxmp@define@createdate}{% \@ifundefined{pdffeedback}{% @@ -3484,8 +3939,8 @@ ______</rdf:Description>^^J% % \optname{baseurl}. % \changes{v2.0}{2012/08/26}{Added this macro} % \changes{v3.0}{2016/07/04}{Made the \protect\acro{XMP} -% \protect\xmpterm{CreateDate}, \protect\xmpterm{ModifyDate}, and -% \protect\xmpterm{MetadataDate} match the \protect\acro{PDF} +% \protect\xmpterm{xmp:CreateDate}, \protect\xmpterm{xmp:ModifyDate}, +% and \protect\xmpterm{xmp:MetadataDate} match the \protect\acro{PDF} % \protect\pdfterm{CreationDate}} % \changes{v3.2}{2017/01/22}{Honor \string\pkgname{hyperref}'s % \string\optname{pdfcreationdate} and \string\optname{pdfmoddate} @@ -3494,10 +3949,6 @@ ______</rdf:Description>^^J% % \protect\pkgname{hyperxmp} code} % \begin{macrocode} \newcommand*{\hyxmp@xmp@basic@schema}{% - \hyxmp@add@to@xml{% -______<rdf:Description rdf:about=""^^J% -____________xmlns:xmp="http://ns.adobe.com/xap/1.0/">^^J% - }% \hyxmp@define@createdate % \end{macrocode} % For the document's creation date, use the user-specified @@ -3544,9 +3995,6 @@ ____________xmlns:xmp="http://ns.adobe.com/xap/1.0/">^^J% % \begin{macrocode} \hyxmp@add@simple{xmp:CreatorTool}{\@pdfcreator}% \hyxmp@add@simple{xmp:BaseURL}{\@baseurl}% - \hyxmp@add@to@xml{% -______</rdf:Description>^^J% - }% } % \end{macrocode} % \end{macro} @@ -3566,27 +4014,38 @@ ______</rdf:Description>^^J% % \begin{macrocode} \gdef\hyxmp@photoshop@schema{% \edef\hyxmp@photoshop@data{\@pdfauthortitle\@pdfcaptionwriter}% - \ifx\hyxmp@photoshop@data\@empty - \else - \hyxmp@add@to@xml{% -______<rdf:Description rdf:about=""^^J% -____________xmlns:photoshop="http://ns.adobe.com/photoshop/1.0/">^^J% - }% - \fi \hyxmp@add@simple{photoshop:AuthorsPosition}{\@pdfauthortitle}% \hyxmp@add@simple{photoshop:CaptionWriter}{\@pdfcaptionwriter}% - \ifx\hyxmp@photoshop@data\@empty - \else - \hyxmp@add@to@xml{% -______</rdf:Description>^^J% - }% - \fi } % \end{macrocode} % \end{macro} % \end{macro} % % +% \subsubsection{The PDF/A Identification schema} +% \label{sec:pdfa-id} +% +% \begin{macro}{\hyxmp@pdfa@id@schema} +% Add properties defined by the \acro{PDF/A} Identification +% schema~\cite{PDFA2008:xmp-props} to the |\hyxmp@xml| macro. These +% properties identify a document as conforming to a particular +% \acro{PDF/A} standard. We default to \acro{PDF/A}-1b if any \acro{PDF/A} +% compliance is detected but let the author override the ``1'' with +% \optname{pdfapart} and the ``B'' with \optname{pdfaconformance}. +% \changes{v2.4}{2013/12/21}{Added this macro} +% \changes{v2.9}{2016/04/12}{Let the author specify the \protect\acro{PDF/A} +% part and conformance IDs, as requested by Leonid Sinev} +% \begin{macrocode} +\newcommand*{\hyxmp@pdfa@id@schema}{% + \ifHy@pdfa + \hyxmp@add@simple{pdfaid:part}{\@pdfapart}% + \hyxmp@add@simple{pdfaid:conformance}{\@pdfaconformance}% + \fi +} +% \end{macrocode} +% \end{macro} +% +% % \subsubsection{The IPTC Photo Metadata schema} % \label{sec:photo-meta} % @@ -3615,7 +4074,7 @@ ______</rdf:Description>^^J% \@ifnotmtargexp{#2}{% \bgroup \hyxmp@add@to@xml{% -_________<#1>% + \hyxmp@extra@indent______<#1>% }% % \end{macrocode} % \begin{macro}{\@elt@first} @@ -3652,50 +4111,50 @@ _________<#1>% % \end{macro} % \end{macro} % -% \begin{macro}{\hyxmp@photometa@schema} +% \begin{macro}{\hyxmp@iptc@schema} +% Add properties defined by the \acro{IPTC} Photo Metadata +% schema~\cite{IPTC2010:photo-meta} to the |\hyxmp@xml| macro. We +% currently support only the \xmpterm{Iptc4xmpCore:CreatorContactInfo} +% property, although this is a structure containing multiple fields. % \changes{v2.2}{2012/12/07}{Added this macro} % \changes{v2.9}{2016/04/23}{Use \textsf{Iptc4xmpCore} instead of % \textsf{Iptc4ContInfo} as the contact-information metadata prefix. % Leonid Sinev reports that Acrobat's \acro{PDF/A} validator seems to % prefer \textsf{Iptc4xmpCore}} -% \begin{macro}{\hyxmp@photometa@data} -% Add properties defined by the \acro{IPTC} Photo Metadata -% schema~\cite{IPTC2010:photo-meta} to the |\hyxmp@xml| macro. We -% currently support only the contact-information details structure, -% viz.\ the \xmpterm[CiAdrExtadr]{Iptc4xmpCore:CreatorContactInfo}, -% \xmpterm[CiAdrCity]{Iptc4xmpCore:CreatorContactInfo}, -% \xmpterm[CiAdrRegion]{Iptc4xmpCore:CreatorContactInfo}, -% \xmpterm[CiAdrPcode]{Iptc4xmpCore:CreatorContactInfo}, -% \xmpterm[CiAdrCtry]{Iptc4xmpCore:CreatorContactInfo}, -% \xmpterm[CiTelWork]{Iptc4xmpCore:CreatorContactInfo}, -% \xmpterm[CiEmailWork]{Iptc4xmpCore:CreatorContactInfo}, and -% \xmpterm[CiUrlWork]{Iptc4xmpCore:CreatorContactInfo} properties. -% \begin{macrocode} -\gdef\hyxmp@photometa@schema{% - \edef\hyxmp@photometa@data{% - \@pdfcontactaddress - \@pdfcontactcity - \@pdfcontactregion - \@pdfcontactpostcode - \@pdfcontactcountry - \@pdfcontactphone - \@pdfcontactemail - \@pdfcontacturl - }% - \ifx\hyxmp@photometa@data\@empty +% \changes{v4.0}{2019/03/09}{Moved the definition of +% \protect\cs{hyxmp@iptc@data} from here into +% \protect\cs{hyxmp@check@iptc@data}} +% \changes{v4.0}{2019/03/16}{Renamed this macro to +% \protect\cs{hyxmp@iptc@schema} from +% \protect\cs{hyxmp@photometa@schema}} +% \changes{v4.0}{2019/03/16}{Rewrote this macro entirely to correct +% the use of fields within a structure} +% \begin{macrocode} +\gdef\hyxmp@iptc@schema{% +% \end{macrocode} +% Because we currently support only +% \xmpterm{Iptc4xmpCore:CreatorContactInfo} it suffices to check if we +% have any relevant data. If so, we instantiate a +% \xmpterm{Iptc4xmpCore:ContactInfo} structure with all available +% fields. +% \begin{macrocode} + \ifx\hyxmp@iptc@data\@empty \else - \hyxmp@iptc@extensions \hyxmp@add@to@xml{% -______<rdf:Description rdf:about=""^^J% -___________xmlns:Iptc4xmpCore="http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/">^^J% -_______<Iptc4xmpCore:CreatorContactInfo rdf:parseType="Resource">^^J% +______<Iptc4xmpCore:CreatorContactInfo rdf:parseType="Resource">^^J% }% - \fi - \hyxmp@list@to@lines{Iptc4xmpCore:CiAdrExtadr}{\@pdfcontactaddress}% - \hyxmp@add@simple{Iptc4xmpCore:CiAdrCity}{\@pdfcontactcity}% - \hyxmp@add@simple{Iptc4xmpCore:CiAdrRegion}{\@pdfcontactregion}% - \hyxmp@add@simple{Iptc4xmpCore:CiAdrPcode}{\@pdfcontactpostcode}% - \hyxmp@add@simple{Iptc4xmpCore:CiAdrCtry}{\@pdfcontactcountry}% +% \end{macrocode} +% We locally redefine |\hyxmp@extra@indent| to increase the indentation +% of the assignments to \xmpterm{Iptc4xmpCore:CreatorContactInfo}'s +% fields. +% \begin{macrocode} + \bgroup + \edef\hyxmp@extra@indent{\hyxmp@extra@indent\space\space}% + \hyxmp@list@to@lines{Iptc4xmpCore:CiAdrExtadr}{\@pdfcontactaddress}% + \hyxmp@add@simple{Iptc4xmpCore:CiAdrCity}{\@pdfcontactcity}% + \hyxmp@add@simple{Iptc4xmpCore:CiAdrRegion}{\@pdfcontactregion}% + \hyxmp@add@simple{Iptc4xmpCore:CiAdrPcode}{\@pdfcontactpostcode}% + \hyxmp@add@simple{Iptc4xmpCore:CiAdrCtry}{\@pdfcontactcountry}% % \end{macrocode} % \begin{macro}{\xmplinesep} % The \acro{IPTC} standard states that sets of telephone numbers, email @@ -3708,23 +4167,259 @@ _______<Iptc4xmpCore:CreatorContactInfo rdf:parseType="Resource">^^J% % |\hyxmp@list@to@lines| to insert the data. Unlike % |\hyxmp@add@simple|, this approach trims all spaces surrounding commas. % \begin{macrocode} - \bgroup - \def\xmplinesep{,}% - \hyxmp@list@to@lines{Iptc4xmpCore:CiTelWork}{\@pdfcontactphone}% - \hyxmp@list@to@lines{Iptc4xmpCore:CiEmailWork}{\@pdfcontactemail}% - \hyxmp@list@to@lines{Iptc4xmpCore:CiUrlWork}{\@pdfcontacturl}% - \egroup - \ifx\hyxmp@photometa@data\@empty - \else + \def\xmplinesep{,}% + \hyxmp@list@to@lines{Iptc4xmpCore:CiTelWork}{\@pdfcontactphone}% + \hyxmp@list@to@lines{Iptc4xmpCore:CiEmailWork}{\@pdfcontactemail}% + \hyxmp@list@to@lines{Iptc4xmpCore:CiUrlWork}{\@pdfcontacturl}% + \egroup \hyxmp@add@to@xml{% -_______</Iptc4xmpCore:CreatorContactInfo>^^J% -______</rdf:Description>^^J% +______</Iptc4xmpCore:CreatorContactInfo>^^J% }% \fi } % \end{macrocode} % \end{macro} % \end{macro} +% +% \subsubsection{The PRISM Basic Metadata schema} +% \label{sec:prism-meta} +% +% \begin{macro}{\hyxmp@prism@schema} +% \changes{v4.0}{2019/03/10}{Added this macro} +% Add properties defined by the \acro{PRISM} Basic Metadata +% schema~\cite{PRISM2012:basic-meta}. +% \begin{macrocode} +\newcommand*{\hyxmp@prism@schema}{% + \ifx\hyxmp@prism@data\@empty + \else + \hyxmp@add@simple{prism:complianceProfile}{three}% + \fi + \hyxmp@add@simple@lang{prism:subtitle}{\@pdfsubtitle}% + \hyxmp@add@simple@lang{prism:publicationName}{\@pdfpublication}% + \hyxmp@add@simple{prism:aggregationType}{\@pdfpubtype}% + \hyxmp@add@simple@lang{prism:bookEdition}{\@pdfbookedition}% + \hyxmp@add@simple{prism:volume}{\@pdfvolumenum}% + \hyxmp@add@simple{prism:number}{\@pdfissuenum}% + \hyxmp@add@simple{prism:pageRange}{\@pdfpagerange}% + \hyxmp@add@simple{prism:isbn}{\@pdfisbn}% + \hyxmp@add@simple{prism:issn}{\@pdfissn}% + \hyxmp@add@simple{prism:eIssn}{\@pdfeissn}% + \hyxmp@add@simple{prism:doi}{\@pdfdoi}% + \hyxmp@add@simple{prism:url}{\@pdfurl}% + \hyxmp@add@simple{prism:byteCount}{\@pdfbytes}% + \hyxmp@add@simple{prism:pageCount}{\@pdfnumpages}% +} +% \end{macrocode} +% \end{macro} +% +% \subsubsection{XMP extension schemata} +% \label{sec:extension-schemata} +% +% Not all of the schemata supported by \pkgname{hyperxmp} are predefined +% by \acro{XMP}. \acro{PDF/A} conversion would normally fail for +% documents that employ ``custom'' schemata. However, this problem can +% be circumvented by declaring non-standard schemata in the \acro{XMP} +% packet itself, following a technique described in a PDF Association +% technical note~\cite{PDFA2008:ext-schemas}. In this section, we +% declare only those schemata we actually use. +% +% \begin{macro}{\hyxmp@check@iptc@data} +% Define |\hyxmp@iptc@data| as the concatenation of all \acro{IPTC} +% photo metadata supplied by the document. +% \begin{macrocode} +\newcommand*{\hyxmp@check@iptc@data}{% +% \end{macrocode} +% \begin{macro}{\hyxmp@iptc@data} +% \begin{macrocode} + \edef\hyxmp@iptc@data{% + \@pdfcontactaddress + \@pdfcontactcity + \@pdfcontactregion + \@pdfcontactpostcode + \@pdfcontactcountry + \@pdfcontactphone + \@pdfcontactemail + \@pdfcontacturl + }% +}% +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\hyxmp@check@prism@data} +% Define |\hyxmp@prism@data| as the concatenation of all \acro{PRISM} +% metadata supplied by the document. +% \begin{macrocode} +\newcommand*{\hyxmp@check@prism@data}{% +% \end{macrocode} +% \begin{macro}{\hyxmp@prism@data} +% \begin{macrocode} + \edef\hyxmp@prism@data{% + \@pdfbookedition + \@pdfbytes + \@pdfdoi + \@pdfeissn + \@pdfisbn + \@pdfissn + \@pdfissuenum + \@pdfnumpages + \@pdfpagerange + \@pdfpublication + \@pdfpubtype + \@pdfsubtitle + \@pdfurl + \@pdfvolumenum + }% +}% +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\hyxmp@begin@extension@decls} +% Begin a block of \acro{XML} tags that indicates we're declaring one or +% more extension schemata. +% \begin{macrocode} +\newcommand*{\hyxmp@begin@extension@decls}{% + \hyxmp@add@to@xml{% +______<pdfaExtension:schemas>^^J% +________<rdf:Bag>^^J% + }% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hyxmp@end@extension@decls} +% End the block of \acro{XML} tags begun by |\hyxmp@begin@extension@decls|. +% \begin{macrocode} +\newcommand*{\hyxmp@end@extension@decls}{% + \hyxmp@add@to@xml{% +________</rdf:Bag>^^J% +______</pdfaExtension:schemas>^^J% + }% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hyxmp@begin@ext@decl} +% Begin the declaration of a single extension schema. +% |\hyxmp@begin@ext@decl| accepts the schema's name, prefix, and +% namespace URI. +% \changes{v4.0}{2019/03/15}{Added this macro} +% \begin{macrocode} +\newcommand*{\hyxmp@begin@ext@decl}[3]{% + \hyxmp@add@to@xml{% +__________<rdf:li rdf:parseType="Resource">^^J% +____________<pdfaSchema:schema>#1</pdfaSchema:schema>^^J% +____________<pdfaSchema:prefix>#2</pdfaSchema:prefix>^^J% +____________<pdfaSchema:namespaceURI>#3</pdfaSchema:namespaceURI>^^J% +____________<pdfaSchema:property>^^J% +______________<rdf:Seq>^^J% + }% +}% +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hyxmp@end@ext@decl} +% End the declaration of a single extension schema. +% \changes{v4.0}{2019/03/15}{Added this macro} +% \begin{macrocode} +\newcommand*{\hyxmp@end@ext@decl}{% + \hyxmp@add@to@xml{% +______________</rdf:Seq>^^J% +____________</pdfaSchema:property>^^J% +__________</rdf:li>^^J% + }% +}% +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hyxmp@declare@property} +% Declare a single extension-schema property. |\hyxmp@declare@property| +% takes as input an optional type (defaults to \xmpterm{Text}) and a +% mandatory name, category, and description. +% \changes{v4.0}{2019/03/15}{Added this macro} +% \begin{macrocode} +\newcommand{\hyxmp@declare@property}[4][Text]{% + \hyxmp@add@to@xml{% +________________<rdf:li rdf:parseType="Resource">^^J% +__________________<pdfaProperty:name>#2</pdfaProperty:name>^^J% +__________________<pdfaProperty:valueType>#1</pdfaProperty:valueType>^^J% +__________________<pdfaProperty:category>#3</pdfaProperty:category>^^J% +__________________<pdfaProperty:description>#4</pdfaProperty:description>^^J% +________________</rdf:li>^^J% + }% +}% +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hyxmp@declare@field} +% Declare a single field in a custom datatype required by an extension +% schema. |\hyxmp@declare@field| takes as input an optional type +% (defaults to \xmpterm{Text}) and a mandatory name and description. +% \changes{v4.0}{2019/03/16}{Replaced +% \protect\cs{hyxmp@declare@resource} with this macro} +% \begin{macrocode} +\newcommand{\hyxmp@declare@field}[3][Text]{% + \hyxmp@add@to@xml{% +______________________<rdf:li rdf:parseType="Resource">^^J% +________________________<pdfaField:name>#2</pdfaField:name>^^J% +________________________<pdfaField:valueType>#1</pdfaField:valueType>^^J% +________________________<pdfaField:description>#3</pdfaField:description>^^J% +______________________</rdf:li>^^J% + }% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hyxmp@mm@extensions} +% Declare the \acro{XMP} Media Management schema. +% \changes{v4.0}{2019/03/15}{Added this macro} +% \begin{macrocode} +\newcommand*{\hyxmp@mm@extensions}{% + \hyxmp@begin@ext@decl + {XMP Media Management Schema}% + {xmpMM}% + {http://ns.adobe.com/xap/1.0/mm/}% + \hyxmp@declare@property + [URI] + {DocumentID}% + {internal}% + {UUID based identifier for all versions and renditions of a document}% + \hyxmp@declare@property + [URI] + {InstanceID}% + {internal}% + {UUID based identifier for specific incarnation of a document}% + \hyxmp@declare@property + {VersionID}% + {internal}% + {Document version identifier}% + \hyxmp@end@ext@decl +}% +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hyxmp@pdfa@id@extensions} +% Declare the \acro{PDF/A} Identification schema~\cite{PDFA2008:xmp-props}. +% \changes{v4.0}{2019/03/15}{Added this macro} +% \begin{macrocode} +\newcommand*{\hyxmp@pdfa@id@extensions}{% + \hyxmp@begin@ext@decl + {PDF/A Identification Schema}% + {pdfaid}% + {http://www.aiim.org/pdfa/ns/id/}% + \hyxmp@declare@property + [Integer]% + {part}% + {internal}% + {Part of PDF/A standard}% + \hyxmp@declare@property + {conformance}% + {internal}% + {Conformance level of PDF/A standard}% + \hyxmp@end@ext@decl +}% +% \end{macrocode} % \end{macro} % % \begin{macro}{\hyxmp@iptc@extensions} @@ -3734,124 +4429,204 @@ ______</rdf:Description>^^J% % \xmpterm{Iptc4xmpCore:CreatorContactInfo} fields a unique % \xmpterm{pdfaType:prefix} to better support conversion of the % document to \acro{PDF/A}} +% \changes{v4.0}{2019/03/09}{Moved the header code from here into +% \protect\cs{hyxmp@begin@extension@decls} and the trailer code +% from here into \protect\cs{hyxmp@end@extension@decls}} +% \changes{v4.0}{2019/03/16}{Rewrote to more closely honor the +% \acro{XMP} specification} % Because \acro{IPTC} metadata are not recognized by the \acro{PDF/A} % standard, \acro{PDF/A} conversion would normally fail for documents -% that utilize |\pdfcontactaddress|, |\pdfcontactcity|, etc. However, -% there exists a technique, described in a PDF Association technical -% note~\cite{PDFA2008:ext-schemas}, for describing nonstandard -% \acro{XMP} metadata within the \acro{XMP} packet itself. We use that -% technique here to describe all of the metadata that -% |\hyxmp@photometa@schema| can produce. Doing so enables the document -% to be converted to \acro{PDF/A} format. +% that utilize \acro{IPTC} metadata. Declaring the \acro{IPTC} +% metadata we support enables the document to be converted to +% \acro{PDF/A} format. % \begin{macrocode} \newcommand*{\hyxmp@iptc@extensions}{% + \hyxmp@begin@ext@decl + {IPTC Core Schema}% + {Iptc4xmpCore}% + {http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/}% + \hyxmp@declare@property + [ContactInfo] + {CreatorContactInfo} + {external} + {Document creator's contact information} +% \end{macrocode} +% We can't call |\hyxmp@end@ext@decl| because we need first need to +% define the \xmpterm{Iptc4xmpCore:ContactInfo} structure. +% \begin{macrocode} \hyxmp@add@to@xml{% -______<rdf:Description rdf:about=""^^J% -__________xmlns:pdfaExtension="http://www.aiim.org/pdfa/ns/extension/"^^J% -__________xmlns:pdfaSchema="http://www.aiim.org/pdfa/ns/schema\hyxmp@hash"^^J% -__________xmlns:pdfaProperty="http://www.aiim.org/pdfa/ns/property\hyxmp@hash"^^J% -__________xmlns:pdfaType="http://www.aiim.org/pdfa/ns/type\hyxmp@hash"^^J% -__________xmlns:pdfaField="http://www.aiim.org/pdfa/ns/field\hyxmp@hash">^^J% -________<pdfaExtension:schemas>^^J% -__________<rdf:Bag>^^J% -____________<rdf:li rdf:parseType="Resource">^^J% -______________<pdfaSchema:schema>IPTC Core Schema</pdfaSchema:schema>^^J% -______________<pdfaSchema:namespaceURI>http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/</pdfaSchema:namespaceURI>^^J% -______________<pdfaSchema:prefix>Iptc4xmpCore</pdfaSchema:prefix>^^J% -______________<pdfaSchema:property>^^J% -________________<rdf:Seq>^^J% -__________________<rdf:li rdf:parseType="Resource">^^J% -____________________<pdfaProperty:name>CreatorContactInfo</pdfaProperty:name>^^J% -____________________<pdfaProperty:valueType>contactinfo</pdfaProperty:valueType>^^J% -____________________<pdfaProperty:category>external</pdfaProperty:category>^^J% -____________________<pdfaProperty:description>contact information for the document's creator</pdfaProperty:description>^^J% -__________________</rdf:li>^^J% -________________</rdf:Seq>^^J% -______________</pdfaSchema:property>^^J% -______________<pdfaSchema:valueType>^^J% -________________<rdf:Seq>^^J% -__________________<rdf:li rdf:parseType="Resource">^^J% -____________________<pdfaType:type>contactinfo</pdfaType:type>^^J% -____________________<pdfaType:namespaceURI>http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/</pdfaType:namespaceURI>^^J% -____________________<pdfaType:prefix>Iptc4xmpCore</pdfaType:prefix>^^J% -____________________<pdfaType:description>contact information</pdfaType:description>^^J% -____________________<pdfaType:field>^^J% -______________________<rdf:Seq>^^J% +______________</rdf:Seq>^^J% +____________</pdfaSchema:property>^^J% +____________<pdfaSchema:valueType>^^J% +______________<rdf:Seq>^^J% +________________<rdf:li rdf:parseType="Resource">^^J% +__________________<pdfaType:type>ContactInfo</pdfaType:type>^^J% +__________________<pdfaType:namespaceURI>http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/</pdfaType:namespaceURI>^^J% +__________________<pdfaType:prefix>Iptc4xmpCore</pdfaType:prefix>^^J% +__________________<pdfaType:description>% + Basic set of information to get in contact with a person% + </pdfaType:description>^^J% +__________________<pdfaType:field>^^J% +____________________<rdf:Seq>^^J% }% -% \end{macrocode} -% \begin{macrocode} - \hyxmp@text@resource{CiAdrExtadr}{contact address}% - \hyxmp@text@resource{CiAdrCity}{contact city}% - \hyxmp@text@resource{CiAdrRegion}{contact region}% - \hyxmp@text@resource{CiAdrPcode}{contact postal code}% - \hyxmp@text@resource{CiAdrCtry}{contact country}% - \hyxmp@text@resource{CiTelWork}{contact telephone number}% - \hyxmp@text@resource{CiEmailWork}{contact email address}% - \hyxmp@text@resource{CiUrlWork}{contact url}% -% \end{macrocode} -% \begin{macrocode} + \hyxmp@declare@field + {CiAdrCity}% + {Contact information city}% + \hyxmp@declare@field + {CiAdrCtry}% + {Contact information country}% + \hyxmp@declare@field + {CiAdrExtadr}% + {Contact information address}% + \hyxmp@declare@field + {CiAdrPcode}% + {Contact information local postal code}% + \hyxmp@declare@field + {CiAdrRegion}% + {Contact information regional information such as state or province}% + \hyxmp@declare@field + {CiEmailWork}% + {Contact information email address(es)}% + \hyxmp@declare@field + {CiTelWork}% + {Contact information telephone number(s)}% + \hyxmp@declare@field + {CiUrlWork}% + {Contact information Web URL(s)}% \hyxmp@add@to@xml{% -______________________</rdf:Seq>^^J% -____________________</pdfaType:field>^^J% -__________________</rdf:li>^^J% -________________</rdf:Seq>^^J% -______________</pdfaSchema:valueType>^^J% -____________</rdf:li>^^J% -__________</rdf:Bag>^^J% -________</pdfaExtension:schemas>^^J% -______</rdf:Description>^^J% +____________________</rdf:Seq>^^J% +__________________</pdfaType:field>^^J% +________________</rdf:li>^^J% +______________</rdf:Seq>^^J% +____________</pdfaSchema:valueType>^^J% +__________</rdf:li>^^J% }% } % \end{macrocode} % \end{macro} % -% \begin{macro}{\hyxmp@text@resource} -% \changes{v2.2}{2012/12/13}{Added this macro} -% Output a single \xmpterm{Text} resource given its name and description. -% \begin{macrocode} -\newcommand*{\hyxmp@text@resource}[2]{% - \hyxmp@add@to@xml{% -________________________<rdf:li rdf:parseType="Resource">^^J% -__________________________<pdfaField:name>#1</pdfaField:name>^^J% -__________________________<pdfaField:valueType>Text</pdfaField:valueType>^^J% -__________________________<pdfaField:description>#2</pdfaField:description>^^J% -________________________</rdf:li>^^J% - } -} +% \begin{macro}{\hyxmp@prism@extensions} +% \changes{v4.0}{2019/03/15}{Added this macro} +% Because \acro{PRISM} metadata are not recognized by the \acro{PDF/A} +% standard, \acro{PDF/A} conversion would normally fail for documents +% that utilize \acro{PRISM} metadata. Declaring the \acro{PRISM} +% metadata we support enables the document to be converted to +% \acro{PDF/A} format. +% \begin{macrocode} +\newcommand*{\hyxmp@prism@extensions}{% + \hyxmp@begin@ext@decl + {PRISM Basic Metadata}% + {prism}% + {http://prismstandard.org/namespaces/basic/2.1/}% + \hyxmp@declare@property + {complianceProfile}% + {internal}% + {PRISM specification compliance profile to which this document adheres}% + \hyxmp@declare@property + {publicationName}% + {external}% + {Publication name}% + \hyxmp@declare@property + {aggregationType}% + {external}% + {Publication type}% + \hyxmp@declare@property + {bookEdition}% + {external}% + {Edition of the book in which the document was published}% + \hyxmp@declare@property + {volume}% + {external}% + {Publication volume number}% + \hyxmp@declare@property + {number}% + {external}% + {Publication issue number within a volume}% + \hyxmp@declare@property + {pageRange}% + {external}% + {Page range for the document within the print version of its publication}% + \hyxmp@declare@property + {issn}% + {external}% + {ISSN for the printed publication in which the document was published}% + \hyxmp@declare@property + {eIssn}% + {external}% + {ISSN for the electronic publication in which the document was published}% + \hyxmp@declare@property + {isbn}% + {external}% + {ISBN for the publication in which the document was published}% + \hyxmp@declare@property + {doi}% + {external}% + {Digital Object Identifier for the document}% + \hyxmp@declare@property + [URL] + {url}% + {external}% + {URL at which the document can be found}% + \hyxmp@declare@property + [Integer] + {byteCount}% + {internal}% + {Approximate file size in octets}% + \hyxmp@declare@property + [Integer] + {pageCount}% + {internal}% + {Number of pages in the print version of the document}% + \hyxmp@declare@property + {subtitle}% + {external}% + {Document's subtitle}% + \hyxmp@end@ext@decl +}% % \end{macrocode} % \end{macro} % -% \subsubsection{The PDF/A Identification schema} -% \label{sec:pdfa-id} -% -% \begin{macro}{\hyxmp@pdfa@id@schema} -% Add properties defined by the \acro{PDF/A} Identification -% schema~\cite{PDFA2008:xmp-props} to the |\hyxmp@xml| macro. These -% properties identify a document as conforming to a particular -% \acro{PDF/A} standard. We default to \acro{PDF/A}-1b if any \acro{PDF/A} -% compliance is detected but let the author override the ``1'' with -% \optname{pdfapart} and the ``B'' with \optname{pdfaconformance}. -% \changes{v2.4}{2013/12/21}{Added this macro} -% \changes{v2.9}{2016/04/12}{Let the author specify the \protect\acro{PDF/A} -% part and conformance IDs, as requested by Leonid Sinev} +% \begin{macro}{\hyxmp@declare@extensions} +% Declare all \acro{XMP} extension schemata. We'll always have at least +% one, the \acro{XMP} Media Management extensions, because we +% automatically generate \xmpterm{xmpMM:DocumentID} and +% \xmpterm{xmpMM:InstanceID} +% values. +% \begin{macrocode} +\newcommand*{\hyxmp@declare@extensions}{% + \hyxmp@begin@extension@decls +% \end{macrocode} +% Declare the \acro{XMP} Media Management extensions (always present). +% \begin{macrocode} + \hyxmp@mm@extensions +% \end{macrocode} +% Declare the \acro{PDF/A} Identification extensions, but only when +% generating a \acro{PDF/A} document. % \begin{macrocode} -\newcommand*{\hyxmp@pdfa@id@schema}{% \ifHy@pdfa - \hyxmp@add@to@xml{% -______<rdf:Description rdf:about=""^^J% -____________xmlns:pdfaid="http://www.aiim.org/pdfa/ns/id/">^^J% - }% - \hyxmp@add@simple{pdfaid:part}{\@pdfapart}% - \hyxmp@add@simple{pdfaid:conformance}{\@pdfaconformance}% - \hyxmp@add@to@xml{% -______</rdf:Description>^^J% - }% + \hyxmp@mm@extensions + \fi +% \end{macrocode} +% Conditionally declare \acro{IPTC} photo metadata extensions. +% \begin{macrocode} + \ifx\hyxmp@iptc@data\@empty + \else + \hyxmp@iptc@extensions \fi +% \end{macrocode} +% Conditionally declare \acro{PRISM} basic metadata extensions. +% \begin{macrocode} + \ifx\hyxmp@prism@data\@empty + \else + \hyxmp@prism@extensions + \fi +% \end{macrocode} +% \begin{macrocode} + \hyxmp@end@extension@decls } % \end{macrocode} % \end{macro} % -% % \subsubsection{Combining schemata into an XMP packet} % \label{sec:combining-schemata} % @@ -3891,20 +4666,51 @@ ______</rdf:Description>^^J% \gdef\hyxmp@xml{}% \hyxmp@add@to@xml{<?xpacket begin="\hyxmp@bom" % id="W5M0MpCehiHzreSzNTczkc9d"?>^^J% -<x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="3.1-702">^^J% -___<rdf:RDF +<x:xmpmeta xmlns:x="adobe:ns:meta/">^^J% +__<rdf:RDF % xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns\hyxmp@hash">^^J% +____<rdf:Description rdf:about=""^^J% +% \end{macrocode} +% Specify every namespace we can potentially use, even the ones we end +% up not actually using. +% \begin{macrocode} +_____________________xmlns:pdf="http://ns.adobe.com/pdf/1.3/"^^J% +_____________________xmlns:xmpRights="http://ns.adobe.com/xap/1.0/rights/"^^J% +_____________________xmlns:dc="http://purl.org/dc/elements/1.1/"^^J% +_____________________xmlns:photoshop="http://ns.adobe.com/photoshop/1.0/"^^J% +_____________________xmlns:xmp="http://ns.adobe.com/xap/1.0/"^^J% +_____________________xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/"^^J% +_____________________xmlns:stEvt="http://ns.adobe.com/xap/1.0/sType/ResourceEvent\hyxmp@hash"^^J% +_____________________xmlns:pdfaid="http://www.aiim.org/pdfa/ns/id/"^^J% +_____________________xmlns:prism="http://prismstandard.org/namespaces/basic/2.1/"^^J% +_____________________xmlns:Iptc4xmpCore="http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/"^^J% +_____________________xmlns:pdfaExtension="http://www.aiim.org/pdfa/ns/extension/"^^J% +_____________________xmlns:pdfaSchema="http://www.aiim.org/pdfa/ns/schema\hyxmp@hash"^^J% +_____________________xmlns:pdfaProperty="http://www.aiim.org/pdfa/ns/property\hyxmp@hash"^^J% +_____________________xmlns:pdfaType="http://www.aiim.org/pdfa/ns/type\hyxmp@hash"^^J% +_____________________xmlns:pdfaField="http://www.aiim.org/pdfa/ns/field\hyxmp@hash">^^J% }% +% \end{macrocode} +% Declare non-standard schemata. +% \begin{macrocode} + \hyxmp@check@iptc@data + \hyxmp@check@prism@data + \hyxmp@declare@extensions +% \end{macrocode} +% Insert all the metadata we know how to insert. +% \begin{macrocode} \hyxmp@pdf@schema \hyxmp@xmpRights@schema \hyxmp@dc@schema \hyxmp@photoshop@schema - \hyxmp@photometa@schema \hyxmp@xmp@basic@schema \hyxmp@pdfa@id@schema \hyxmp@mm@schema + \hyxmp@iptc@schema + \hyxmp@prism@schema \hyxmp@add@to@xml{% -___</rdf:RDF>^^J% +____</rdf:Description>^^J% +__</rdf:RDF>^^J% </x:xmpmeta>^^J% \hyxmp@padding <?xpacket end="w"?>^^J% @@ -3975,8 +4781,8 @@ ___</rdf:RDF>^^J% % uncompress \emph{every} \acro{PDF} stream. The solution, provided by % Hans Hagen on the |luatex| mailing list (thread: % \href{http://tug.org/pipermail/luatex/2016-July/006077.html}{``Leaving -% a single PDF object uncompressed''}, 6\,\textsc{Jul}\,2016), is to -% provide the |uncompressed| flag to |\pdfobj|. Our definition of +% a single \acro{PDF} object uncompressed''}, 6\,\textsc{Jul}\,2016), +% is to provide the |uncompressed| flag to |\pdfobj|. Our definition of % |\hyxmp@embed@packet@pdftex| uses the \pkgname{ifluatex} package to % distinguish the \pdfTeX\ case from the pre-0.85 \LuaTeX\ case. % |