Imported Upstream version 2.10+ds
[debian/jabref.git] / src / help / ja / XMPHelp.html
index c78545a9c8ddad5a2a1d38985123f898dfaa0e85..daa07eee005bd361723623fdf96bb9f18dd2f198 100644 (file)
-<html xmlns="http://www.w3.org/1999/xhtml">\r
-<head>\r
-<link rel="stylesheet" type="text/css" href="jabref_help.css"/>\r
-</head>\r
-\r
-<body>\r
-\r
-    <h1>XMP metadata support in JabRef</h1>\r
-\r
-    <p>XMP is a standard created by Adobe Systems for storing\r
-    metadata (data about data) in files. An well known example for\r
-    metadata are MP3 tags, which can be used to describe artist,\r
-    album and song name of a MP3 file. Adding metadata to MP3 helps\r
-    other people to identify the songs correctly independent of\r
-    file-name and can provide means for software (MP3 players for\r
-    instance) to sort and group songs.</p>\r
-\r
-    <p>With XMP-support the JabRef team tries to bring the\r
-    advantages of metadata to the world of reference managers. You\r
-    can now choose to "Write XMP" metadata in the General Tab of\r
-    JabRef, which will put all the Bibtex information into the PDF.\r
-    If you then email this PDF to a collegue she can just drag the\r
-    file into JabRef and all information that you entered will be\r
-    available to her.</p>\r
-\r
-    <h2>Usage</h2>\r
-\r
-    <p>To use the XMP-feature in JabRef you can do the\r
-    following:</p>\r
-\r
-    <ul>\r
-        <li>To <b>import a single annotated PDF-file</b> that\r
-        contains XMP you can select "File -&gt; Import into...\r
-        -&gt; XMP-annotated PDF" or drag the file into the main\r
-        view.</li>\r
-\r
-        <li>To <b>write the bibliographic information to the\r
-        associated PDF</b> do the following: Double click the entry\r
-        in the main view, go to the "General" tab and click on\r
-        "Write XMP".</li>\r
-\r
-        <li>If you want <b>to annotate all the PDFs in a given\r
-        database</b> you can select "Tools -&gt; Write XMP for\r
-        database"</li>\r
-\r
-        <li>To verify if it worked you can open the PDF in Adobe\r
-        Acrobat and select "File -&gt; Document Properties -&gt;\r
-        Additional Metadata -&gt; Advanced". In the tree to the\r
-        right you should see an entry called\r
-        "http://purl.org/net/bibteXMP". This works only with Adobe\r
-        Acrobat, not with Adobe Reader.</li>\r
-\r
-        <li>If you don't have Adobe Acrobat, you can use\r
-        <i>pdfinfo</i> instead in order to see the XMP metadata.\r
-        <i>pdfinfo</i> is part of Xpdf\r
-        (<code>www.foolabs.com/xpdf</code>) and Poppler\r
-        (<code>http://poppler.freedesktop.org</code>).</li>\r
-\r
-        <li style="list-style: none">\r
-            <div style="margin-left: 2em">\r
-                <h2>BibteXmp Fileformat</h2>\r
-\r
-                <p>XMP uses a subset of the Resource Description\r
-                Framework (RDF) to store data. For JabRef a new\r
-                metadata format is used which maps very closely to\r
-                BibTeX. Basically all fields and values are turned\r
-                into nodes of an XML document. Only authors and\r
-                editors are stored as rdf:Seq-structures, so users\r
-                of the data can skip the splitting on 'and's. All\r
-                strings and crossrefs will be resolved in the\r
-                data.</p>\r
-\r
-                <p>The following easy minimal schema is used:</p>\r
-\r
-                <ul>\r
-                    <li>The BibTeX-key is stored as\r
-                    <code>bibtexkey</code>.</li>\r
-\r
-                    <li>The type of the BibTeX-entry is stored as\r
-                    <code>entrytype</code>.</li>\r
-\r
-                    <li><code>author</code> and <code>editor</code>\r
-                    are encoding as <code>rdf:Seq</code>s where the\r
-                    individual authors are represented as\r
-                    <code>rdf:li</code>s.</li>\r
-\r
-                    <li>All other fields are saved using their\r
-                    field-name as is.</li>\r
-                </ul><br />\r
-                <br />\r
-\r
-\r
-                <p>The following is an example of the mapping</p>\r
-                <pre>\r
-@INPROCEEDINGS{CroAnnHow05,\r
-  author = {Crowston, K. and Annabi, H. and Howison, J. and Masango, C.},\r
-  title = {Effective work practices for floss development: A model and propositions},\r
-  booktitle = {Hawaii International Conference On System Sciences (HICSS)},\r
-  year = {2005},\r
-  owner = {oezbek},\r
-  timestamp = {2006.05.29},\r
-  url = {http://james.howison.name/publications.html}\r
-}\r
-</pre>will be transformed into\r
-                <pre>\r
-&lt;rdf:Description xmlns:bibtex="http://jabref.sourceforge.net/bibteXMP/"\r
-    bibtex:bibtexkey="CroAnnHow05"\r
-    bibtex:year="2005"\r
-    bibtex:title="Effective work practices for floss development: A model and propositions"\r
-    bibtex:owner="oezbek"\r
-    bibtex:url="http://james.howison.name/publications.html"\r
-    bibtex:booktitle="Hawaii International Conference On System Sciences (HICSS)"\r
-    bibtex:timestamp="2006.05.29"&gt;\r
-        &lt;bibtex:author&gt;\r
-            &lt;rdf:Seq&gt;\r
-                &lt;rdf:li&gt;K. Crowston&lt;/rdf:li&gt;\r
-                &lt;rdf:li&gt;H. Annabi&lt;/rdf:li&gt;\r
-                &lt;rdf:li&gt;J. Howison&lt;/rdf:li&gt;\r
-                &lt;rdf:li&gt;C. Masango&lt;/rdf:li&gt;\r
-            &lt;/rdf:Seq&gt;\r
-        &lt;/bibtex:author&gt;\r
-    &lt;bibtex:entrytype&gt;Inproceedings&lt;/bibtex:entrytype&gt;\r
-&lt;/rdf:Description&gt;\r
-</pre>\r
-\r
-                <p>Beware of the following caveats if you trying to\r
-                parse bibteXMP:</p>\r
-\r
-                <ul>\r
-                    <li>In RDF attribute-value pairs can also be\r
-                    expressed as nodes and vice versa.</li>\r
-                </ul><br />\r
-                <br />\r
-\r
-\r
-                <h2>Related Links:</h2>\r
-\r
-                <p>Some links about XMP and annotating PDFs:</p>\r
-\r
-                <ul>\r
-                    <li>\r
-                    <a href="http://freelancepropaganda.com/themp/">\r
-                    James Howison's blog "Themp---Managing Academic\r
-                    Papers like MP3s"</a></li>\r
-\r
-                    <li>\r
-                    <a href="http://www.xml.com/pub/a/2004/09/22/xmp.html">\r
-                    XML.com article about XMP</a></li>\r
-\r
-                                       <li><a href="http://pdfbox.apache.org">PDFBox libraries</a> for PDF\r
-                                   file and metadata handling. They are distributed under the Apache License.</li>\r
-\r
-                    <li>\r
-                    <a href="http://arstechnica.com/civis/viewtopic.php?f=19&amp;t=408429">\r
-                    Good thread on ArsTechnica discussing the\r
-                    management of PDFs.</a></li>\r
-\r
-                    <li>\r
-                    <a href="http://www.adobe.com/content/dam/Adobe/en/devnet/xmp/pdfs/XMPSpecificationPart1.pdf">\r
-                    Adobe XMP Specification</a></li>\r
-                </ul><br />\r
-                <br />\r
-\r
-            </div>\r
-        </li>\r
-    </ul>\r
-</body>\r
-</html>\r
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<link rel="stylesheet" type="text/css" href="jabref_help.css"/>
+</head>
+
+<body>
+
+    <h1>JabRefにおけるXMPメタデータ サポート</h1>
+
+    <p>XMPは、ファイル中にメタデータ(データに関するデータ)を収録するために、Adobe Systemsによって作られた標準です。メタデータのよく知られた例としてはMP3タグがありますが、これはMP3ファイルのアーティストやアルバム、歌の名前を記述するのに用いられます。MP3にメタデータを書き加えると、他の人が、ファイル名とは独立に正しく楽曲を特定する助けとなる他、(MP3プレイヤーのような)ソフトウェアが、楽曲を整序したりグループ化したりするための手段を提供することになります。</p>
+
+    <p>XMPサポートによって、JabRef開発チームは、メタデータの利点を書誌情報管理の世界に持ち込もうとしました。JabRefタブ中の「XMPメタデータとして書き込む」ボタンを押すと、BibTeX情報をリンクされたPDFに書き込みます。このPDFを同僚に電子メールで送って、同僚がそのファイルをJabRefにドラッグすれば、あなたが入力した情報すべてが、この同僚にも利用可能になります。</p>
+
+    <h2>使用法</h2>
+
+    <p>JabRefでXMP機能を使うには、以下のようにしてください。</p>
+
+    <ul>
+        <li>XMPを含んでいる<b>注釈付きPDFファイルを読み込む</b>には、「ファイル→...に読み込む→XMP注釈付きPDF」を選択するか、そのファイルを基本ビューにドラッグしてください。</li>
+
+        <li><b>関連したPDFに書誌情報を書き込む</b>には、基本ビューで項目をダブルクリックし、タブ中の「XMPメタデータとして書き込む」ボタンを押してください。</li>
+
+        <li><b>データベース中のすべてのPDFに注釈を付ける</b>場合には、「ツール→XMPメタデータをPDFに書き出す」を選択してください。</li>
+
+        <li>うまく行ったかどうかを確認するには、PDFをAdobe Acrobatで開き、「ファイル→文書プロパティ→追加のMetadata→詳細」を選択してください。右側のツリーに「http://purl.org/net/bibteXMP」という項目があります。これは、Adobe Acrobatで動作しますが、Adobe Readerでは動作しません。</li>
+
+        <li>Adobe Acrobatがなければ、XMPメタデータを見るのに代わりに<i>pdfinfo</i>を使うことができます。<i>pdfinfo</i>は、Xpdf (<code>www.foolabs.com/xpdf</code>)とPoppler (<code>http://poppler.freedesktop.org</code>)の一部です。</li>
+
+        <li style="list-style: none">
+            <div style="margin-left: 2em">
+                <h2>BibteXmpファイル形式</h2>
+
+                <p>XMPは、データを保管するのにResource Description Framework (RDF)のサブセットを使用します。JabRefでは、BibTeXに非常に近い形にマップする新しいメタデータ形式を使用しています。基本的にすべてのフィールドと値は、XML文書のノードに変換されます。authorsとeditorsのみがrdf:Seq構造として保管されるので、データのユーザーは「and」の分割作業をスキップすることができます。すべての文字列と相互参照は、データ中で解決されます。</p>
+
+                <p>以下の簡単な最小限のスキーマを使用します。</p>
+
+                <ul>
+                    <li>BibTeX鍵は<code>bibtexkey</code>として保管されます。</li>
+
+                    <li>BibTeX鍵の型は<code>entrytype</code>として保管されます。</li>
+
+                    <li><code>author</code>と<code>editor</code>は、<code>rdf:Seq</code>としてエンコードされ、各著者は<code>rdf:li</code>として表されます。</li>
+
+                    <li>他のフィールドは、すべてフィールド名そのものを使用して保存されます。</li>
+                </ul><br />
+                <br />
+
+
+                <p>下記はマッピングの例です。</p>
+                <pre>
+@INPROCEEDINGS{CroAnnHow05,
+  author = {Crowston, K. and Annabi, H. and Howison, J. and Masango, C.},
+  title = {Effective work practices for floss development: A model and propositions},
+  booktitle = {Hawaii International Conference On System Sciences (HICSS)},
+  year = {2005},
+  owner = {oezbek},
+  timestamp = {2006.05.29},
+  url = {http://james.howison.name/publications.html}
+}
+</pre>これは以下のように変換されます。
+                <pre>
+&lt;rdf:Description xmlns:bibtex="http://jabref.sourceforge.net/bibteXMP/"
+    bibtex:bibtexkey="CroAnnHow05"
+    bibtex:year="2005"
+    bibtex:title="Effective work practices for floss development: A model and propositions"
+    bibtex:owner="oezbek"
+    bibtex:url="http://james.howison.name/publications.html"
+    bibtex:booktitle="Hawaii International Conference On System Sciences (HICSS)"
+    bibtex:timestamp="2006.05.29"&gt;
+        &lt;bibtex:author&gt;
+            &lt;rdf:Seq&gt;
+                &lt;rdf:li&gt;K. Crowston&lt;/rdf:li&gt;
+                &lt;rdf:li&gt;H. Annabi&lt;/rdf:li&gt;
+                &lt;rdf:li&gt;J. Howison&lt;/rdf:li&gt;
+                &lt;rdf:li&gt;C. Masango&lt;/rdf:li&gt;
+            &lt;/rdf:Seq&gt;
+        &lt;/bibtex:author&gt;
+    &lt;bibtex:entrytype&gt;Inproceedings&lt;/bibtex:entrytype&gt;
+&lt;/rdf:Description&gt;
+</pre>
+
+                <p>bibtexXMPを解析しようとする場合には、以下の点に注意してください。</p>
+
+                <ul>
+                    <li>RDFでは、属性-値の組はノードとして表すこともでき、その逆もできます。</li>
+                </ul><br />
+                <br />
+
+
+                <h2>関連リンク:</h2>
+
+                <p>XMPと注釈付きPDFに関するリンク:</p>
+
+                <ul>
+                    <li>
+                    <a href="http://freelancepropaganda.com/themp/">
+                    James Howisonのブログ「Themp---MP3のように学術論文を管理する」</a></li>
+
+                    <li>
+                    <a href="http://www.xml.com/pub/a/2004/09/22/xmp.html">
+                    XMPに関するXML.comの記事</a></li>
+
+                                       <li>Apache Software Foundationの<a href="http://pdfbox.apache.org/">PDFBox</a>は、PDFとメタデータ ストリームにアクセスするのに使われるJavaライブラリです。</li>
+
+                    <li>
+                    <a href="http://arstechnica.com/civis/viewtopic.php?f=19&amp;t=408429">
+                    PDF管理を論じているArsTechnica上の良いスレッド</a></li>
+
+                    <li>
+                    <a href="http://www.adobe.com/content/dam/Adobe/en/devnet/xmp/pdfs/XMPSpecificationPart1.pdf">
+                    Adobe XMPの仕様</a></li>
+                </ul><br />
+                <br />
+
+            </div>
+        </li>
+    </ul>
+</body>
+</html>