aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTeddy Wing2023-04-25 02:50:58 +0200
committerTeddy Wing2023-04-25 02:50:58 +0200
commit86860b88a6f7478c2296072ae5c6179b53a80dc8 (patch)
treec454d1bad43c72f1c958edcf7e387f67a6f7356d
parent5cbbbe48969ea1d33adcb27ca63360b267ad7639 (diff)
downloadxfdf-86860b88a6f7478c2296072ae5c6179b53a80dc8.tar.bz2
Add README
Include a brief description and an example of code and XML output.
-rw-r--r--README.md78
1 files changed, 78 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..595b293
--- /dev/null
+++ b/README.md
@@ -0,0 +1,78 @@
+xfdf
+====
+
+A library to generate XFDF XML to fill in interactive PDF form fields.
+
+
+## Example
+This code:
+
+``` common-lisp
+;;; xfdf-example.lisp
+
+(ql:quickload "xfdf")
+
+(format t "~A"
+ (with-output-to-string (xfdf-stream)
+ (xfdf:write-xfdf
+ xfdf-stream
+ '(("topmostSubform[0]"
+ . (("Page1[0]"
+ . (("c1_01[1]" . "2")
+ ("f1_02[0]" . "Homer J.")
+ ("f1_03[0]" . "Simpson")
+ ("f1_05[0]" . "Marjorie J.")
+ ("f1_06[0]" . "Simpson")
+ ("Address[0]"
+ . (("f1_08[0]" . "742 Evergreen Terrace")
+ ("f1_10[0]" . "Springfield")))))
+ ("Page2[0]"
+ . (("f2_33[0]" . "Nuclear safety inspector")))))))))
+```
+
+produces the following XML:
+
+``` xml
+<?xml version="1.0" encoding="UTF-8"?>
+<xfdf xmlns="http://ns.adobe.com/xfdf/" xml:space="preserve">
+ <fields>
+ <field name="topmostSubform[0]">
+ <field name="Page1[0]">
+ <field name="c1_01[1]">
+ <value>2</value>
+ </field>
+ <field name="f1_02[0]">
+ <value>Homer J.</value>
+ </field>
+ <field name="f1_03[0]">
+ <value>Simpson</value>
+ </field>
+ <field name="f1_05[0]">
+ <value>Marjorie J.</value>
+ </field>
+ <field name="f1_06[0]">
+ <value>Simpson</value>
+ </field>
+ <field name="Address[0]">
+ <field name="f1_08[0]">
+ <value>742 Evergreen Terrace</value>
+ </field>
+ <field name="f1_10[0]">
+ <value>Springfield</value>
+ </field>
+ </field>
+ </field>
+ <field name="Page2[0]">
+ <field name="f2_33[0]">
+ <value>Nuclear safety inspector</value>
+ </field>
+ </field>
+ </field>
+ </fields>
+</xfdf>
+```
+
+
+## Resources
+
+[XFDF reference]