PDF XMP: move field editing code to external script, document

src/sampleconf/recoll.conf

@@ -750,6 +750,27 @@ snippetMaxPosWalk = 1000000
 # not one attachment is ever found.</descr></var>
 #pdfattach = 0
 
+# <var name="pdfextrameta" type="string">
+#
+# <brief>Extract text from selected XMP metadata tags.</brief><descr>This
+# is a space-separated list of qualified XMP tag names. Each element can also
+# include a translation to a Recoll field name, separated by a '|'
+# character. If the second element is absent, the tag name is used as the
+# Recoll field names. You will also need to add specifications to the
+# 'fields' file to direct processing of the extracted data.</descr></var>
+#pdfextrameta =  bibtex:location|location bibtex:booktitle bibtex:pages
+
+# <var name="pdfextrametafix" type="fn">
+#
+# <brief>Define name of XMP field editing script.</brief><descr>This
+# defines the name of a script to be loaded for editing XMP field
+# values. The script should define a 'MetaFixer' class with a metafix()
+# method which will be called with the qualified tag name and value of each
+# selected field, for editing or erasing. A new instance is created for
+# each document, so that the object can keep state for, e.g. eliminating
+# duplicate values.</descr></var>
+#pdfextrametafix =  /path/to/fixerscript.py
+
 
 # <grouptitle id="SPECLOCATIONS">Parameters set for specific
 # locations</grouptitle>