Help:Extension:GWToolset/ja

はじめに
このページを閲覧された理由は、まとまった量のコンテンツをウィキメディアコモンズに公開すること、再利用ができるようにすることを検討中もしくは実施計画を立てているからではないでしょうか. このマニュアルでは、必要な手順を順にご案内します.

手順の概要
このツールセットの使い方について、以下の流れ図に手順と段階をまとめました. マニュアルはこの流れ図に沿って構成します.

利用者名、利用者の権限
ツールセットの利用には以下の手配が必要です.
 * 1) 利用者として登録.
 * 2) ツールセットにアクセスする権利の申請.

利用者名の登録
すでにウィキメディア・コモンズ、ウィキペディアなどウィキメディアの姉妹プロジェクトで利用者登録を済まされた場合は、この手順を飛ばしてください. 新たに利用者になる、あるいはコンテンツ投稿用のアカウントを作成する手順は以下のとおりです.
 * 1) 利用者名を決定する際に守らなければならない点をご参照ください.
 * 2) まずアカウント作成ページを開きます.

利用者ページで自己紹介をお願いします
アカウント作成が済んだらログインしてください. すると表示されたウィキページ最上部に、ご自分の利用者名が赤字で表示されるはずです.

利用者権限の申請
アップロード試験は、ツールから希望どおりの結果が提供されると確信するまで、コモンズベータ・ サーバ上で実行します. そして確信が持てたら Production サーバでツールを使います. これら2つのサーバは別個の環境であるため、両方で利用者アカウントの登録とアクセス権限の申請を求められます. その最良の方法を以下に述べます. # コモンズベータサーバ: ベータで開発者もしくはビューロクラットに連絡を取り、ベータサーバ上の GWToolset 利用者グループの権限を申請します. 連絡先はチャットルーム (commons IRC channel) もしくはGLAM メーリングリストあるいは次のリストから選んでください.
 * 1) ビューロクラット
 * 2) 開発者
 * 3) コモンズ製作用サーバ: ベータサーバ上でサンプルを使ったアップロード試験が成功した段階で、「本物の」コモンズへ移り、コモンズのビューロクラット伝言板に投稿し、GWtoolsetの利用者権限を申請します. 申請者には自己紹介を添えて審査が進みやすくするようお勧めします.

GWToolset 利用者権限はウィキメディアコモンズ製作サーバ上の有効期限が1年間で自動的に終了します. 利用者には期限切れ前に通知があり、実際に継続利用する計画がある場合には、コモンズ･ビューロクラット掲示板にて延長もしくは復活の申請をしてください.



ドメインをホワイトリストに登録
ご利用のメディアファイルのドメインがホワイトリストに未登録の場合は、ぜひウィキメディア・コモンズのドメイン・ホワイトリストに登録申請をお願いします. このホワイトリストとは、ウィキメディア・コモンズがメディアファイル取得前にドメイン名を検証するリストです. そのため、リスト登録していない場合、ご利用のメディアファイルのドメインからメディアファイルをダウンロードできません. 前記の登録申請には、実際に存在するメディアファイルへのリンクを記入してください.

申請には数営業日かかることにご留意ください. 何らかのイベントや研修プログラムを計画している場合は、安全のために1週間前までに登録申請をするようお勧めします. 予定されたイベントの準備において、特定の日付までに登録申請を履行しなければならない場合は、登録申請の題名にその日時を記入してください. それ以前に登録申請を完了させるように努力します. ホワイトリストリクエストについて説明を求めることがありますので、質問には必ず回答してください. 必須ではありませんが、自分が誰であるか、アップロードする内容を含めて、プロセスをスムーズに進めることができます.

コンテンツの選択
コンテンツを選ぶ場合、検討課題がいくつかあります. まず最初に、コンテンツに制限 - ファイル形式、著作権の制限事項、組織の制限条件など - があるかどうか、その作品をコモンズに公開できるとき影響を受けないか確認します. また検討課題によっては、コンテンツを一括アップロードできるか、あるいはいくつかのバッチ (まとまり) に分けたほうがよいか影響が出ます.

さらに別の要素として、コンテンツ共有の戦略があります. コンテンツの公開方法と時期はお決まりですか？ 大量に一括処理しますか？ それともテーマごとに小分けに処理しますか？

コンテンツの種類
コンテンツの種類ごとに、個別のメタデータ・テンプレートを使います. 一括処理の場合、画像ファイルと音声ファイルを混ぜてアップロードすることはできず、画像なら画像だけ、音声は音声だけと、分類ごとに処理します.

ライセンスの種別
単一の一括アップロードのまとまりには、異なるライセンス条件のファイルを混在させることは認められません. アップロード対象として、たとえばライセンス条件が CC BY のものと CC BY-SA のものが混じっているなら、ライセンス条件ごとに分類し、それぞれのまとまりをアップロードします.



使用許諾
1923年以降に作成されたコンテンツには、これらのファイルをウィキメディアコモンズの承認するいずれかのライセンスのもとに提供する許可を与えたという、作成者の通知が必要です. 作成者ごとにOTRS ticket numberが必要なため、複数の作成者によるファイルを単一のまとまりに混在させてアップロードすることはできません.

コンテンツ共有の戦略
この節ではコンテンツ供与の戦略をいくつか説明します. すでにまとまったコンテンツの供与を数件、受けています. いずれも大規模な寄付です. 1件はすべてのコンテンツをまとめ、1回でウィキメディア・コモンズにアップロードされました. しかし寄付の形態はこの方法に限定されません.

One time mass sharing
This is the classic way of sharing content: a large scale upload of the content that can be selected with the available sources.

Advantages:

Theme based
Some GLAMs are currently considering theme based uploads. A theme can be an exhibition. This means that selecting the content that will be uploaded to commons can become a part of the process of preparing an exhibition.

Advantages:
 * Ongoing process of uploads, every new upload gains interest
 * Lessons learned from past upload can be

Advantages

技術的な互換性の分析
ツールセットの開発目標は、GLAM機関が最もコンテンツを整理しやすい一般的な方法として使用するためです. つまりツールセットはほとんどの組織で簡単に使用でき、組織によっては使用前に特別な措置が必要な場合もあります. この節の図を使用すると、組織とツールセットの互換性を判断できます. 以下で説明するとおり、図中に設問があります.

Are the media files online available?
Only files accessible from the internet can be uploaded using GWToolset. If you have a very large amount of images (hundreds of GBs or more), it is possible to arrange the files to be uploaded by mailing a hard disk. The procedures for processing metadata on such files is very different than those for GWToolset. For more information on this option, please see Commons:Help:Server-side_upload.

Can the media files be put online?
If they can be, then you need to do this to use GWToolset

Is the metadata online available?
The metadata does not need to be online. The metadata just needs to be converted to a single XML file in a "flat" format.

Can the metadata be exported?
The metadata needs to be converted to a flat XML format.

Can the metadata be exported to XML?
The metadata needs to be converted to a flat XML format. If you have trouble converting to XML, there are volunteers who can probably help you. Contact the glam mailing list.

Are the mediafiles and metadata both publicly available?
Only the media files need to be publicly available.

Are credentials available to gain access to the mediafiles and metadata?
The media files cannot be behind a password. They must be directly accessible from a URL. The metadata doesn't need to be publicly accessible

Can these credentials be used to access the mediafiles and metadata?
The media files cannot be behind a password. They must be directly accessible from a URL. The metadata doesn't need to be publicly accessible

Is there an API available?
API's can be useful for generating the metadata file, but not required.

Does the API respond in XML?
API's can be useful for generating the metadata file, but not required.

Is the XML in flat format?
There are several standards that are currently used by organisations to organise their metadata, for example OAI-PMH, EDM, MARC and Lido. The GLAMwiki Toolset accepts all forms of metadata as long as the data complies to the following requirements.

フラット形式とは？
個別の主題ごとのメタデータにはXMLファイル内で「フラット」すなわち同等のレベルに配置される必要があります. メタデータがさらに深いレベルつまり入れ子構造の内部にある場合、ツールセットが検出できません.

The use of attributes
Attributes of declarations are also not recognised with one exception: the language attribute. This attribute can be used to recognise the descriptions of objects in different languages.

For example , is recognised as a description in English.
 * This is a description

Will be seen by the Toolset as The PhotoID in this example will not be read. Information in attributes can cause loss of information.
 * www.example.org
 * www.example.org

Multiple descriptions in one metadata field
メタデータには、たとえばなど2回以上言及される記入欄があります. 現在、これらを個別に含める選択肢はありませんが、これらの記入欄のデータは統合や、パイプ記号 ( | ) を利用した分離ができます. 主題によっては「乗り物」、「火炎放射器」と「戦闘車両」("vehicle", "flamethrower" and "combat vehicle") のように複数の説明があります. これらの説明はすべて欄を使用してXMLに含めると、主題に追加されます. メタデータ欄は可能な限り、分離することをお勧めします. この方法なら、コモンズで正しく表示されます.

Can the XML be transformed in flat format?
Do you need help to convert your XML to a 'flat' XML file? Then consider these options:
 * 1) Hire a specialist to write a script to convert your XML file
 * 2) Use XSLT: http://www.w3.org/Style/XSL/
 * 3) Choose a standard that publishes the XML as a 'flat' file, like OAI-PMH and – to a certain extent – the Europeana API
 * 4) Look into Open Refine

メタデータテンプレート
ウィキメディアコモンズでは、テンプレートを使用してメタデータをマッピングします. したがって、コモンズに表示されるメタデータの量は、アップロード用に選択されたメタデータテンプレートに存在する欄に制限されます.

使用できるテンプレートは数種類あります. いくつか例を挙げます. '''注記: この一覧は未完成です. '''
 * Art_Photo (芸術作品_写真): https://commons.wikimedia.org/wiki/Template:Art_Photo
 * Artwork (芸術作品): https://commons.wikimedia.org/wiki/Template:Artwork
 * Book (書籍) https://commons.wikimedia.org/wiki/Template:Book
 * Musical work (音楽作品) https://commons.wikimedia.org/wiki/Template:Musical_work
 * Map (地図) https://commons.wikimedia.org/wiki/Template:Map
 * Photograph (写真) https://commons.wikimedia.org/wiki/Template:Photograph
 * Specimen (標本) https://commons.wikimedia.org/wiki/Template:Specimen

現状では動画用のテンプレートがありません. あるいは利用者が自作したテンプレートの使用も (まだ) 承認されていません.

アップロード対象の作品の種類により、使用するべきテンプレートが決まります. このことから、複数の種類のコンテンツがあり、必要とするテンプレートが異なると、一括でアップロードできないという意味でもあります. 例えば、アップロード対象ファイルが写真と音声の場合、写真は写真だけ (およびそのXMLファイル)、音声は音声だけ (およびそのXMLファイル) のバッチ (まとまり) に分離します. 同じバッチに、写真と音声両方の種類のファイルを入れてアップロードすることはできません.

ライセンステンプレートおよびその他メタデータのサブテンプレート
テンプレートを使用するメタデータ欄もあり、例えばメディアファイルのライセンスのメタデータ欄です. ツールセットが認識したクリエイティブコモンズのライセンスに対応したバナーが表示されます. 独自のテンプレート作成が可能です. これはコンテンツ使用が許諾されて、ファイルに含めるOTRSチケットを受け取った場合に便利です. 詳細はこのライセンステンプレートのOTRSチケットの例をご参照ください. ライセンス欄の文字列からテンプレートを参照しない場合、この情報はプレーンテキスト(平文) として表示されます.

注記: ウィキメディアコモンズのコミュニティでは、ファイル使用許諾を厳密に扱います. 著作権違反あるいはその他のウィキメディアのプラットフォーム上で当該ファイルの使用を認めない規制が疑われる場合、当該コンテンツはおそらく削除されるはずです. そこで、きちんとしたライセンステンプレートは例外なく必須です.

機関テンプレート
機関テンプレートはコモンズにファイルを提供またはアップロードした施設を示すため使います. このテンプレートによって教育機関の名前だけでなく、その機関に関する詳細情報を追加できます. 機関テンプレートの例はこちらのこのアムステルダム博物館のテンプレートです. これには次の有用な情報を含めることができます. このテンプレートは必須ではないものの、アップロードに含めることを強く推奨します.
 * 組織のロゴ
 * 組織の建物の外観写真
 * 所在地 (市、国など)
 * 座標
 * WebサイトのURL

ツールセットは機関テンプレートを認識し、XML ファイルを照会しテンプレートと同名のソースタグがある場合、上記のテンプレートはXMLファイルに含まれます. この事例の場合は以下のとおり. Amsterdam Museum.

ソーステンプレート
https://commons.wikimedia.org/wiki/Category:Source_templates

https://commons.wikimedia.org/wiki/Template:British_Library_image

Categories
Categories are special pages to group related pages and media. It is essential that every file can be found by browsing the category structure. To allow this, each file must be put into a category directly. Each category should itself be in more general categories, forming a hierarchical structure. The category structure is the primary way to organize and find files on the Commons. It is essential that every file can be found by browsing the category structure. With the GLAMwiki Toolset you can add your content to existing or new categories.

Categories can be in multiple languages. Make sure that, next to your own language, you also search for and add English categories to your content.

Check available categories
Please see this quick guide to learn how you can search for existing categories.

Create categories
If you need to make new categories, please read the policy on categories on Commons.

Validating your xml
You can validate your xml file by using the form at http://www.w3schools.com/xml/xml_validator.asp.

Ampersand and less than ( & < > )
Use of "&" within fields in your xml file can cause unpredictable results. These may be interpreted (correctly) as XML encodings of characters, for example "&amp;amp;" will display as "&" on a Commons image page. Floating ampersands in your text like " & " or text that looks like an html encoding but may be abbreviations in English like "&c." for etcetera, are likely to cause the GWT to fail at that record. It is worth searching out and replacing these with "and" or similar, depending on the templates these are going to be used within.

xml relies on to wrap fields. If you are using these in your text you should convert them to "&amp;lt;" and "&amp;gt;" or standard brackets to avoid your xml being misinterpreted.

Please note, that since it is an XML file, not an HTML file, HTML named entity references like using  for &eacute; will not work. You must either use the normal UTF-8 symbol directly, or a numeric entity reference such as, or.

Double-dash ( -- )
The use of double dashes may be unpredictable as these can be interpreted as part of xml comment fields. These are unlikely to be an issue in most cases, but worth changing to single dashes in title fields.

等号、パイプ記号、疑問符、スラッシュ ( = | ? / )
コモンズでは、ファイル名あるいはテンプレート名で禁止もしくは問題の原因となり得る (ならない場合もある) 文字がたくさんあります. たとえば等号「=」をテンプレートで使用するには波カッコ2個で前後を挟み、「 = 」に書き換える必要があります. これらの要注意の記号を参照URLなどに使う場合、もしくはアップロードが予期せず中断してしまったときは、まずサンドボックスでサンプルを実験することをお勧めします.

不適切な文字書式
GWT が xml ファイルを読み込むとき、文字の標準形式はUTF-8 に指定します. ほとんどの文書編集ソフトには文字形式を指定する機能がありますが、メタデータのインポートやエクスポートの際には正しく変換されないことがあり、それが原因でアップロードログに表示されなかったり、文字化けしたりします. 一般的な無料の文書編集ソフトとして、オープンソースの JEdit あるいは Google スプレッドシートは、本来、使用できる xml ファイルを作成するために使われてきました. そこで一括処理を実施する準備として、ご利用のインポート、エクスポートの工程が有効な UTF-8 あるいはさらに単純な ASCII 形式で標準出力できるかどうか、小さなサンプルを作成して実験して確認します.

スクリーンキャスト
拡張機能のしくみは、次のスクリーンキャスト (動画のキャプチャ) を見るとわかりやすいでしょう. 閲覧するには、特別:GWToolsetを開き、ウィザードの指示に従います. 注記: この拡張機能を利用するには、「gwtoolset」グループに利用者登録する必要があります. ウィキメディア・コモンズのビューロクラットに連絡をして、グループ参加を申請してください.

一括アップロードの監視
特定のウィキ内の活動を追跡するには というウィキページが使えます. プロセスによっては固有のイベント追跡を目標に、独自のページを置いており、GWToolset もその一種といえます. GWToolset の「特別:ログ」ページは、それぞれのドメインごとに次のURLに置いてあり、一括アップロードの進捗状況の確認や、問題の把握に使います.

コモンズ製作サーバ https://commons.wikimedia.org/w/index.php?title=Special:Log&type=gwtoolset

コモンズ・ベータ https://commons.wikimedia.beta.wmflabs.org/w/index.php?title=Special:Log&type=gwtoolset