Imported Upstream version 2.9.1+ds
[debian/jabref.git] / src / help / ja / XMPHelp.html
1 <html xmlns="http://www.w3.org/1999/xhtml">\r
2 <head>\r
3 <link rel="stylesheet" type="text/css" href="jabref_help.css"/>\r
4 </head>\r
5 \r
6 <body>\r
7 \r
8     <h1>XMP metadata support in JabRef</h1>\r
9 \r
10     <p>XMP is a standard created by Adobe Systems for storing\r
11     metadata (data about data) in files. An well known example for\r
12     metadata are MP3 tags, which can be used to describe artist,\r
13     album and song name of a MP3 file. Adding metadata to MP3 helps\r
14     other people to identify the songs correctly independent of\r
15     file-name and can provide means for software (MP3 players for\r
16     instance) to sort and group songs.</p>\r
17 \r
18     <p>With XMP-support the JabRef team tries to bring the\r
19     advantages of metadata to the world of reference managers. You\r
20     can now choose to "Write XMP" metadata in the General Tab of\r
21     JabRef, which will put all the Bibtex information into the PDF.\r
22     If you then email this PDF to a collegue she can just drag the\r
23     file into JabRef and all information that you entered will be\r
24     available to her.</p>\r
25 \r
26     <h2>Usage</h2>\r
27 \r
28     <p>To use the XMP-feature in JabRef you can do the\r
29     following:</p>\r
30 \r
31     <ul>\r
32         <li>To <b>import a single annotated PDF-file</b> that\r
33         contains XMP you can select "File -&gt; Import into...\r
34         -&gt; XMP-annotated PDF" or drag the file into the main\r
35         view.</li>\r
36 \r
37         <li>To <b>write the bibliographic information to the\r
38         associated PDF</b> do the following: Double click the entry\r
39         in the main view, go to the "General" tab and click on\r
40         "Write XMP".</li>\r
41 \r
42         <li>If you want <b>to annotate all the PDFs in a given\r
43         database</b> you can select "Tools -&gt; Write XMP for\r
44         database"</li>\r
45 \r
46         <li>To verify if it worked you can open the PDF in Adobe\r
47         Acrobat and select "File -&gt; Document Properties -&gt;\r
48         Additional Metadata -&gt; Advanced". In the tree to the\r
49         right you should see an entry called\r
50         "http://purl.org/net/bibteXMP". This works only with Adobe\r
51         Acrobat, not with Adobe Reader.</li>\r
52 \r
53         <li>If you don't have Adobe Acrobat, you can use\r
54         <i>pdfinfo</i> instead in order to see the XMP metadata.\r
55         <i>pdfinfo</i> is part of Xpdf\r
56         (<code>www.foolabs.com/xpdf</code>) and Poppler\r
57         (<code>http://poppler.freedesktop.org</code>).</li>\r
58 \r
59         <li style="list-style: none">\r
60             <div style="margin-left: 2em">\r
61                 <h2>BibteXmp Fileformat</h2>\r
62 \r
63                 <p>XMP uses a subset of the Resource Description\r
64                 Framework (RDF) to store data. For JabRef a new\r
65                 metadata format is used which maps very closely to\r
66                 BibTeX. Basically all fields and values are turned\r
67                 into nodes of an XML document. Only authors and\r
68                 editors are stored as rdf:Seq-structures, so users\r
69                 of the data can skip the splitting on 'and's. All\r
70                 strings and crossrefs will be resolved in the\r
71                 data.</p>\r
72 \r
73                 <p>The following easy minimal schema is used:</p>\r
74 \r
75                 <ul>\r
76                     <li>The BibTeX-key is stored as\r
77                     <code>bibtexkey</code>.</li>\r
78 \r
79                     <li>The type of the BibTeX-entry is stored as\r
80                     <code>entrytype</code>.</li>\r
81 \r
82                     <li><code>author</code> and <code>editor</code>\r
83                     are encoding as <code>rdf:Seq</code>s where the\r
84                     individual authors are represented as\r
85                     <code>rdf:li</code>s.</li>\r
86 \r
87                     <li>All other fields are saved using their\r
88                     field-name as is.</li>\r
89                 </ul><br />\r
90                 <br />\r
91 \r
92 \r
93                 <p>The following is an example of the mapping</p>\r
94                 <pre>\r
95 @INPROCEEDINGS{CroAnnHow05,\r
96   author = {Crowston, K. and Annabi, H. and Howison, J. and Masango, C.},\r
97   title = {Effective work practices for floss development: A model and propositions},\r
98   booktitle = {Hawaii International Conference On System Sciences (HICSS)},\r
99   year = {2005},\r
100   owner = {oezbek},\r
101   timestamp = {2006.05.29},\r
102   url = {http://james.howison.name/publications.html}\r
103 }\r
104 </pre>will be transformed into\r
105                 <pre>\r
106 &lt;rdf:Description xmlns:bibtex="http://jabref.sourceforge.net/bibteXMP/"\r
107     bibtex:bibtexkey="CroAnnHow05"\r
108     bibtex:year="2005"\r
109     bibtex:title="Effective work practices for floss development: A model and propositions"\r
110     bibtex:owner="oezbek"\r
111     bibtex:url="http://james.howison.name/publications.html"\r
112     bibtex:booktitle="Hawaii International Conference On System Sciences (HICSS)"\r
113     bibtex:timestamp="2006.05.29"&gt;\r
114         &lt;bibtex:author&gt;\r
115             &lt;rdf:Seq&gt;\r
116                 &lt;rdf:li&gt;K. Crowston&lt;/rdf:li&gt;\r
117                 &lt;rdf:li&gt;H. Annabi&lt;/rdf:li&gt;\r
118                 &lt;rdf:li&gt;J. Howison&lt;/rdf:li&gt;\r
119                 &lt;rdf:li&gt;C. Masango&lt;/rdf:li&gt;\r
120             &lt;/rdf:Seq&gt;\r
121         &lt;/bibtex:author&gt;\r
122     &lt;bibtex:entrytype&gt;Inproceedings&lt;/bibtex:entrytype&gt;\r
123 &lt;/rdf:Description&gt;\r
124 </pre>\r
125 \r
126                 <p>Beware of the following caveats if you trying to\r
127                 parse bibteXMP:</p>\r
128 \r
129                 <ul>\r
130                     <li>In RDF attribute-value pairs can also be\r
131                     expressed as nodes and vice versa.</li>\r
132                 </ul><br />\r
133                 <br />\r
134 \r
135 \r
136                 <h2>Related Links:</h2>\r
137 \r
138                 <p>Some links about XMP and annotating PDFs:</p>\r
139 \r
140                 <ul>\r
141                     <li>\r
142                     <a href="http://freelancepropaganda.com/themp/">\r
143                     James Howison's blog "Themp---Managing Academic\r
144                     Papers like MP3s"</a></li>\r
145 \r
146                     <li>\r
147                     <a href="http://www.xml.com/pub/a/2004/09/22/xmp.html">\r
148                     XML.com article about XMP</a></li>\r
149 \r
150                                         <li><a href="http://pdfbox.apache.org">PDFBox libraries</a> for PDF\r
151                                     file and metadata handling. They are distributed under the Apache License.</li>\r
152 \r
153                     <li>\r
154                     <a href="http://arstechnica.com/civis/viewtopic.php?f=19&amp;t=408429">\r
155                     Good thread on ArsTechnica discussing the\r
156                     management of PDFs.</a></li>\r
157 \r
158                     <li>\r
159                     <a href="http://www.adobe.com/content/dam/Adobe/en/devnet/xmp/pdfs/XMPSpecificationPart1.pdf">\r
160                     Adobe XMP Specification</a></li>\r
161                 </ul><br />\r
162                 <br />\r
163 \r
164             </div>\r
165         </li>\r
166     </ul>\r
167 </body>\r
168 </html>\r