OSDN Git Service

translated by kitsune.info
authorkimitake <kimitake@1ca29b6e-896d-4ea0-84a5-967f57386b96>
Tue, 15 Mar 2005 07:34:24 +0000 (07:34 +0000)
committerkimitake <kimitake@1ca29b6e-896d-4ea0-84a5-967f57386b96>
Tue, 15 Mar 2005 07:34:24 +0000 (07:34 +0000)
git-svn-id: https://svn.sourceforge.jp/svnroot/nucleus-jp/nucleus-jp/trunk@39 1ca29b6e-896d-4ea0-84a5-967f57386b96

utf8/nucleus/documentation/devdocs/xmlrpc.html

index 7f6231e..89048b7 100755 (executable)
@@ -1,40 +1,42 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
 <html xmlns="http://www.w3.org/1999/xhtml">\r
 <head>\r
-       <title>Nucleus - XML-RPC Interface</title>\r
+       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r
+       <title>Nucleus - XML-RPC インターフェイス</title>\r
        <link rel="stylesheet" type="text/css" href="styles/manual.css" />\r
 </head>\r
 <body>\r
 \r
 <div class="heading">\r
-XML-RPC Interface\r
+XML-RPC インターフェイス\r
 </div>\r
 \r
-<h1>Introduction</h1>\r
+<h1>はじめに</h1>\r
 \r
 <p>\r
-<a href="index.html">Back to the developer docs index</a>\r
+<a href="index.html">開発者マニュアルに戻る</a>\r
 </p>\r
 \r
 <p>\r
-This document contains information on the XML-RPC interface that Nucleus provides, and the <a href="#errorcodes">error messages</a> it spits out. Please note that the specification of this interface might still undergo changes in the future.\r
+このドキュメントはNucleusが提供するXML-RPCインターフェイスと、生成される<a href="#errorcodes">エラーメッセージ</a>についての解説です。この仕様は将来変更される可能性があることに注意して下さい。\r
 </p>\r
 \r
 <div class="note">\r
-The URL for the Nucleus XML-RPC interface is:\r
+NucleusにおけるXML-RPCインターフェイスのURLは以下のようになります:\r
 <br />\r
 <b>http://www.yourserver.com/yourpath/nucleus/xmlrpc/server.php</b>\r
+\r
 </div>\r
 \r
 <a name="bloggerApi" id="bloggerApi"></a>\r
-<h1>The Blogger API (XML-RPC)</h1>\r
+<h1>Blogger API (XML-RPC)</h1>\r
 \r
 <p>\r
-Nucleus implements the <a href="http://plant.blogger.com/api/">Blogger API</a>. This allows for tools and services that can communicate with Blogger, to be able to also communicate with Nucleus. Because the way Nucleus works, some interpretations of parameters are slightly different, see the notes below for more info. The structure of method calls and responses are, of course, exactly the same as the methods at Blogger.\r
+Nucleusは<a href="http://plant.blogger.com/api/">Blogger API</a>に対応しています。これはBloggerと通信するツールやサービスに対して、Nucleusとも通信できるようにするものです。Nucleusの仕様により、いくつかのパラメータに若干の違いがあります。これについては後述の説明を参照して下さい。呼び出しや応答のメソッドは、もちろん、Bloggerのものと同じ構造になっています。\r
 </p>\r
 \r
 <p>\r
-Here's the list of available methods. Click them to get more information (links go to either the Blogger API or the <a href="http://groups.yahoo.com/group/bloggerDev">Blogger API Mailinglist</a>).\r
+ここに挙げたリストは利用できるメソッドの一覧です。クリックするとさらに詳しい情報を得ることができます(それぞれのリンク先はBlogger APIの仕様書やその<a href="http://groups.yahoo.com/group/bloggerDev">メーリングリスト</a>です)。\r
 </p>\r
 \r
 <ul>\r
@@ -43,6 +45,7 @@ Here's the list of available methods. Click them to get more information (links
        <li><b><a href="http://groups.yahoo.com/group/bloggerDev/message/296">blogger.getPost</a></b></li>\r
        <li><b><a href="http://groups.yahoo.com/group/bloggerDev/message/147">blogger.deletePost</a></b></li>\r
        <li><b><a href="http://plant.blogger.com/api/xmlrpc_getUsersBlogs.html">blogger.getUsersBlogs</a></b></li>\r
+\r
        <li><b><a href="http://groups.yahoo.com/group/bloggerDev/message/225">blogger.getRecentPosts</a></b></li>\r
        <li><b><a href="http://groups.yahoo.com/group/bloggerDev/message/315">blogger.getUserInfo</a></b></li>\r
        <li><b><a href="http://plant.blogger.com/api/xmlrpc_getTemplate.html">blogger.getTemplate</a></b></li>\r
@@ -51,29 +54,34 @@ Here's the list of available methods. Click them to get more information (links
 \r
 \r
 <p>\r
-Since Nucleus is structured somewhat differently inside, there are some differences in the way parameters are handled. An overview:\r
+Nucleusは内部的に異なる実装を用いているため、パラメータの扱いに若干の違いがあります。概説すると:\r
+\r
 </p>\r
 \r
 <ul>\r
-       <li>Appkeys are ignored.</li>\r
-       <li>Next to the body of a post, a Nucleus-item also has a title and a category. Blogger only has the body (known as 'contents'). To be able to use the extra parts, you can use <tt>&lt;title&gt;</tt> and <tt>&lt;category&gt;</tt> in the contents you send to Nucleus. These tags are only added in the getRecentPosts call</li>\r
-       <li>What is known under Blogger as 'templates', is known under Nucleus as 'skins'. There can be more than one skin on the system, and each skin can be used by different blogs. The blogger.setTemplate and blogger.getTemplate methods will affect the default skin for the chosen blog, as selected in the Nucleus blog settings. The 'main' and 'archiveIndex' template types refer to the nucleus skinparts 'index' and 'archivelist'</li>\r
-       <li>The <tt>publish</tt> parameter is used to determine wether a new post is to be added as a draft or not. When using <tt>blogger.editPost</tt>, the <tt>publish</tt> parameter is ignored unless it turns a draft into a published item</li>\r
-       <li>When using the <tt>getUserInfo</tt> call, the 'lastname' in the result will be empty and 'firstname' will contain the full name. This is because Nucleus does not make a difference between first name and last name</li>\r
-       <li>The <tt>getRecentPostst</tt>-method returns <tt>authorName</tt> and <tt>title</tt> as extra parameters. Blogger has been returning these also (although undocumented)</li>\r
+       <li>Appkeyは無視されます。</li>\r
+       <li>Nucleusの場合は本文のあとにタイトルとカテゴリが続きます。Bloggerでは 'コンテンツ' と呼ばれるは本文だけが存在します。これらの追加されたパーツを利用可能にするため、<tt>&lt;title&gt;</tt>や<tt>&lt;category&gt;</tt>をNucleusに送るコンテンツに含めることができます。これらのタグは getRecentPosts の呼び出しでのみ追加されます。</li>\r
+       <li>Bloggerで 'templates' と呼ばれているものに相当するのが、Nucleusの 'スキン' です。ひとつのシステムに複数のスキンを設定でき、それぞれのスキンをblogごとに使い分けることができます。メソッド blogger.setTemplate と blogger.getTemplate は、Nucleusのblog設定で選択されているblogのデフォルトスキンに影響します。'main' と 'archiveIndex' の二種類のテンプレートは、Nucleusの 'メインの目次ページ' と '月別アーカイブ一覧ページ' に相当します。(<em>訳注: Blogger の仕様がわからないので、この項不確か</em>)</li>\r
+\r
+       <li>項目 <tt>publish</tt> は、追加した項目がデフォルトでドラフトになるか公開になるかを決める箇所です。<tt>blogger.editPost</tt> を使う場合は、<tt>publish</tt> がドラフトと公開のどちらになっていても無視されます。</li>\r
+       <li><tt>getUserInfo</tt> を呼び出した場合、返値のうち 'lastname' は空になり、'firstname' にフルネームが入ります。これはNucleusが姓と名を分けない仕様になっていることに由来します。</li>\r
+\r
+       <li>メソッド <tt>getRecentPostst</tt> は <tt>authorName</tt> と <tt>title</tt> を追加パラメータとして返します。Bloggerもまたこれらの値を返します(この仕様は文書化されていないようですが)。</li>\r
 </ul>\r
 \r
 <a name="metaWeblogApi" id="metaWeblogApi"></a>\r
 <h1><a name="metaweblog"></a>metaWeblog API</h1>\r
 \r
 <p>\r
-Since v1.1, Nucleus also supports the <a href="http://www.xmlrpc.com/metaWeblogApi">metaWeblog API</a>, which is an extention to the Blogger API. \r
+Nucleus v1.1以降、<a href="http://www.xmlrpc.com/metaWeblogApi">metaWeblog API</a>もサポートされました。これはBlogger APIの拡張版です。 \r
 </p>\r
 \r
-<p>In Nucleus v2.5, support was added for the <code>newMediaObject</code> and <code>getRecentPosts</code> methods as well (they weren't in the original metaWeblog specification)</p>\r
+<p>\r
+Nucleus v2.5では <code>newMediaObject</code> と <code>getRecentPosts</code> の二つのメソッドにも対応しました(これらは最初のmetaWeblog仕様には存在しませんでした)。\r
+</p>\r
 \r
 <p>\r
-A list of available methods is listed below (see the <a href="http://www.xmlrpc.com/metaWeblogApi">specification</a> for more info):\r
+利用可能なメソッド一覧は以下の通りです(<a href="http://www.xmlrpc.com/metaWeblogApi">specification</a>に詳しい情報があります):\r
 </p>\r
 \r
 <ul>\r
@@ -83,96 +91,120 @@ A list of available methods is listed below (see the <a href="http://www.xmlrpc.
        <li>metaWeblog.getCategories</li>       \r
        <li>metaWeblog.newMediaObject (v2.5)</li>\r
        <li>metaWeblog.getRecentPosts (v2.5)</li>       \r
+\r
 </ul>\r
 \r
 <a name="mtApi" id="mtApi"></a>\r
 <h1>Movable Type API</h1>\r
 \r
-<p>Since v2.5, Nucleus supports the methods from the <a href="http://www.movabletype.org/docs/mtmanual_programmatic.html">Movable Type API</a>.</p>\r
+<p>v2.5から、Nucleusは<a href="http://www.movabletype.org/docs/mtmanual_programmatic.html">Movable Type API</a>からのメソッドをサポートするようになりました。</p>\r
 \r
-<p>The list of available methods is listed below:</p>\r
+<p>利用できるメソッドの一覧を以下に示します:</p>\r
 \r
 <ul>\r
        <li>mt.supportedMethods</li>\r
+\r
        <li>mt.supportedTextFilters</li>\r
        <li>mt.publishPost</li>\r
        <li>mt.getCategoryList</li>\r
        <li>mt.getPostCategories</li>\r
        <li>mt.setPostCategories</li>\r
        <li>mt.getRecentPostTitles</li>\r
+\r
        <li>mt.getTrackbackPings</li>\r
 </ul>\r
 \r
-<p>Some notes:</p>\r
+<p>いくつかのノート:</p>\r
 \r
 <ul>\r
-       <li>Nucleus only supports one category for each item. This means that all categories except the 'primary' category for an item will be ignored.</li>\r
-       <li>Trackback is not implemented in the Nucleus core (it's avalailable as a plugin instead). Because of this, <code>mt.getTrackbackPings</code> will return an empty array by default.</li>\r
-       <li>Nucleus doesn't have text filters, so <code>mt.getSupportedTextFilters</code> returns an empty array.</li>\r
+       <li>Nucleusはアイテムひとつにつき一つだけカテゴリを設定することができます。これは 'primary' 以外のカテゴリ設定項目はすべて無視されることを意味します。</li>\r
+       <li>トラックバックはNucleusのコアではサポート対象外です(プラグインの導入によって利用することができるようになります)。このため、<code>mt.getTrackbackPings</code> のデフォルトの返値は空です。</li>\r
+\r
+       <li>Nucleusはテキストフィルタを実装していません。このため、<code>mt.getSupportedTextFilters</code> は空の値を返します。</li>\r
 </ul>\r
 \r
-<h1><a name="errorcodes"></a>Error Codes</h1>\r
+<h1><a name="errorcodes"></a>エラーコード</h1>\r
 \r
 <p>\r
-Below is an overview of the types of errors you can get back from the methods:\r
+以下に示すのは、それぞれのメソッドから得られるエラーの種類です:\r
 </p>\r
 \r
 <table>\r
        <tr>\r
-               <th>Error Code</th>\r
-               <th>Error Message</th>\r
+\r
+               <th>エラーコード</th>\r
+               <th>エラーメッセージ</th>\r
        </tr>\r
        <tr>\r
                <td>801</td>\r
-               <td>Login Error (probably bad username/password combination)</td>\r
+               <td>Login Error <br />\r
+               ログインエラー(ユーザ名とパスワードの組み合わせが正しくないと推測されます)</td>\r
        </tr>\r
+\r
        <tr>\r
                <td>802</td>\r
-               <td>No Such Blog</td>\r
+               <td>No Such Blog<br />\r
+               指定されたBlogは存在しません</td>\r
        </tr>\r
        <tr>\r
                <td>803</td>\r
-               <td>Not a Team Member</td>\r
+               <td>Not a Team Member<br />\r
+               チームに登録されていません</td>\r
+\r
        </tr>\r
        <tr>\r
                <td>804</td>\r
-               <td>Cannot add Empty Items</td>\r
+               <td>Cannot add Empty Items<br />\r
+               空のアイテムは投稿できません</td>\r
        </tr>\r
        <tr>\r
                <td>805</td>\r
-               <td>Amount parameter must be in range 1..20 (<i>getRecentItems</i>)</td>\r
+\r
+               <td>Amount parameter must be in range 1..20<br />\r
+               パラメータの値は 1..20 の範囲でなければなりません(<i>getRecentItems</i></td>\r
        </tr>\r
        <tr>\r
                <td>806</td>\r
-               <td>No Such Item</td>\r
+               <td>No Such Item<br />\r
+               指定されたアイテムは存在しません</td>\r
        </tr>\r
+\r
        <tr>\r
                <td>807</td>\r
-               <td>Not Allowed to Alter Item</td>\r
+               <td>Not Allowed to Alter Item<br />\r
+               アイテム追加の権限がありません</td>\r
        </tr>\r
        <tr>\r
                <td>808</td>\r
-               <td>Invalid media type</td>\r
+               <td>Invalid media type<br />\r
+               メディアタイプが不正です</td>\r
+\r
        </tr>   \r
        <tr>\r
                <td>809</td>\r
-               <td>File is too large (max. upload filesize)</td>\r
+               <td>File is too large<br />\r
+               ファイルが大きすぎます(最大のアップロードファイルサイズ)</td>\r
        </tr>           \r
        <tr>\r
                <td>810</td>\r
-               <td>Other error on newMediaObject (message will contain more info about what happened)</td>\r
+               <td>Other error on newMediaObject<br />\r
+               newMediaObject で予期せぬエラーが発生しました(何が起きたのかもう少し情報が含まれるでしょう)</td>\r
+\r
        </tr>\r
        <tr>\r
-               <td><i>other codes &lt; 100</i></td>\r
-               <td>Errors encountered by the Useful Inc. XML-RPC implementation</td>\r
+               <td><i>その他のコード &lt; 100</i></td>\r
+               <td>Errors encountered by the Useful Inc. XML-RPC implementation<br />\r
+               Usefil Inc. XML-RPC の実行でエラーが発生しました</td>\r
        </tr>\r
        <tr>\r
-               <td><i>other codes &gt; 100</i></td>\r
-               <td>Errors encountered by the XML parser</td>\r
+               <td><i>その他のコード &gt; 100</i></td>\r
+\r
+               <td>Errors encountered by the XML parser<br />\r
+               XML パーサでエラーが発生しました</td>\r
        </tr>\r
 \r
 \r
 </table>\r
 \r
 </body>\r
-</html>
\ No newline at end of file
+</html>\r