行http://pipes.yahoo.com/http://pipes.yahoo.com/-以下、pipes.yahoo.comの英文解説の全訳である。+以下、pipes.yahoo.comの英文解説の全訳である(2008年5月8日現在の内容に基づく)。行==Pipesエディターの使い方====Pipesエディターの使い方==++Pipesエディターは、JavaScriptオーサリングツールであり、直感的・視覚的なインターフェースでパイプを作成・編集できる。エディターは以下の3つの区画から構成されている。++*'''Library(ライブラリー)'''区画(左側)は、利用可能なモジュールと保存されたパイプを一覧している++*'''Canvas(カンバス)'''区画(中央)は、パイプを組み立てるためのメインの作業エリアである++*'''Debugger(デバッガー)'''区画(下部のサイズ変更な部分)は、あなたのパイプの様々な段階でのパイプ出力を点検できるところである+パイプを構築・編集するには、Library区画からCanvasへモジュールを移動させ、それをマウスでつなぎ合わせる。Pipesモジュール一覧]]でそれぞれの解説つきで読むことができる)。モジュールは機能別にグループ分けされている。Inputs(ユーザー入力)'''は、動作時にあなたのパイプのユーザーが記入する入力フィールドである++*'''Operators(オペレーター)'''は、foreach、ソート(並べ替え)、カウント、フィルターなどの基本機能である++*'''URL'''には、URLを構築・操作するためのモジュールが含まれる++*'''String(文字列)'''は、文字列を扱うためのモジュールが含まれる++*'''Date(日付)'''は、日付を操作するためのモジュールが含まれる+ライブラリーには、他のユーザーの作ったパイプの中のお気に入りや、あなたが保存したパイプのリストも含まれる。これらのサブパイプは、ちょうどモジュールを使うときと同じように、新しいパイプの中のブロックを構築するために使うことができる。して、多数の制作物を通して再利用できる有用・複雑な構成要素を構築することができる。++あなたのパイプにモジュールやサブパイプを追加するには、それをカンバス上にドラッグするか、モジュール名の右端の「+」をクリックして、カンバス上の編集位置に置く。++===Canvas(カンバス)===+カンバスは、パイプを組み立てて試すためのメインの作業エリアである。モジュールをドラッグして、見やすいように好きなように配置したり、Layout(レイアウト)ボタンをクリックしてすべてをエディター任せで自動配置させることもできる。++どのモジュールでも、タイトルバーをダブルクリックすると、そのパラメーターがすべて隠れる。一度ダブルクリックする(または隅の最大化ボタンをクリックする)と、そのモジュールは最大サイズに戻る。構成要素の多いパイプを扱うときには、これは有用である。++パイプを働かせるためには、モジュールをつなぎ合わせる必要がある。これは、どのモジュールでも、出力端子をクリックし、そのデータを配信したいモジュールの入力端子をクリックすることによってできる。エディターでは、どの接続が認められるかを示すために、使える端子をオレンジ色に光らせる。どのモジュールでも、端子の上にマウスを動かせば、その端子がどのような種類のデータを出力・入力するかを見ることができる。++モジュール間の接続を切断するためには、接続の終端となっているどちらかの端子をクリックする(小さいはさみのアイコンが表われるだろう)。++多くのモジュールは、設定可能なパラメーターと入力フィールドを持っている。これは、普通のフォーム・フィールドのように記入することもできるし、他のモジュールからの適切な形式の入力接続で埋めることもできる。動作中にパイプにユーザーが各自入力できるようにするには、ユーザーインプットモジュールを使う。++サブパイプは、保存されたパイプリストからカンバスにドラッグされたパイプである。サブパイプは、通常のモジュールと同様にふるまうが、「open(オープン)」リンクが追加されている。このリンクをクリックすると、エディターに新しいタブが開いて、その場でサブパイプを編集できる。メインのパイプとサブパイプを編集しているときに、タグを切り替えるには、ツールバーのタイトルタブをクリックする。++===Debugger(デバッガー)===+デバッガー区画は、今選択されているモジュール(オレンジ色で表示)の段階で出力されるパイプの内容を表示する。パイプの最終出力を見るには、そのoutput(出力)モジュールを選択する。ときどき「Refresh(更新)」をクリックして、デバッガーが表示しているパイプからのデータを最新のものにするひつようがあるかもしれない。++デバッガーを使えば、パイプが期待通りのふるまいをしているかどうか確認するために、パイプの各部分を点検できる。デバッガーは、フィードにおけるそれぞれのアイテムのタイトルを表示する。それぞれのアイテム・タイトルの左側の小さな三角形をクリックすれば、そのコンテンツの詳細を調べることができる。++===パイプの保存・実行===+パイプを編集し終わったら、カンバス区画の右上端にあるボタンを使って保存しておこう。パイプに名前を付けるプロンプトウィンドウが表示される。パイプを公開するかどうか選択できる。Publishing(公開)すれば、パイプは誰にでも見えるようになり、みんなが各自で使うためのコピーをクローンすることができるようになる。Pipe...(パイプを実行する)」リンクが表われる。Pipes")に戻って、それをリストから選んでも実行できる。Pipesバッジは、あなたのブログ、ウェブサイト、SNS上にPipesで生成されたコンテンツを置くためのものである。Pipesバッジ]]++==トラブルシューティング==++===他のモジュールにつなげないモジュールがあるのはなぜ?===++モジュールの端子は、特定のデータ形式を発したり、活用したりするようになっている。モジュールをつなぎ合わせるためには、これらの形式に互換性がなければならない。Fetch(取り出し)モジュールは、入力がURLでなければならない。テキスト入力モジュールをそこにつなぐことはできない(これは文字列を与えるからである)。エディターでは、互換性のないモジュールをつなぎ合わせることはできなくなっている。ForEach繰り返しと互換性があるわけではない。フィード内のすべての項目に対して働くモジュールもある(Babelfishモジュールなど)。繰り返しの中にはめ込まれると不正な解釈になるものもある(ユーザー入力モジュールなど)。エディターは、ForEachコンテナーの中に互換性のないモジュールが置けないようになっている。++===パイプが壊れている。したらいい?===++熟練した配管工のように、腕をまくり上げ、流し台の下に潜り込むことをおすすめする。この場合、Pipesエディターに戻って、何がまずいのかを確かめるのだ。++第一歩として、求めているデータがアクティブになっているかどうかを確かめよう。言い換えれば、あなたのパイプの最初の入力がフィードであるならば、そのフィードが内容を返していることを確認するのである。ブラウザーかRSSリーダーにフィードURLをコピーペーストして、何が表示されるか見てみよう。++あなたのパイプのフィードがアクティブであることが確認できたならば、デバッガーを使ってどこに間違いがあるのかを探ることができる。パイプのてっぺんから始めて、問題が発見されるまですべての段階に沿って出力を調べよう。++可能ならば、つなぐモジュールをできるだけ少なくすることによって、パイプを簡素化しよう。基本的なパイプから始めて、次第にくみ上げていき、それぞれの段階がうまく行っているかどうか確認しよう。フィードバック]システムを使おう。我々は聞き、返答し、あなたのパイプが流れてほしいと思っている。最終的に何かまずいところがあれば、我々はそれをすぐに伝える。++===使っているパイプが突然違った挙動を示すことがあるのはなぜ?===++パイプが変化したか、パイプに流れるデータが変わったかである。誰か別の人のパイプを使っているのなら、その制作者は告知なしにパイプを変更・停止・削除できることを忘れないでほしい。何かをするためにほかの誰かの公開したパイプに頼っているのであれば、そのパイプをクローンして、予期せぬ変更があった場合でも自分の版を使えるようにするというのは、よい考えだ。++パイプは動的なものなので、パイプの中を流れる内容が変わるとその振る舞いも変化する。上流のフィードが、以前使っていたのと同じ種類のデータを配信しているかどうか確かめよう。++===Pipesが私のRSSフィードをあまりにも頻繁にダウンロードしている!===++Pipesは、訪れたフィードすべてのキャッシュを持っており、あまりにも頻繁に同じサイトからフィードをダウンロードしないで済むようにしている。Pipesを助けるために、あなたのフィードのLast-Modified、ETag、Expiresフィールドが適切に設定されているか確かめてほしい。Pipesはこれらの標準的HTTPヘッダーのいずれも尊重する。パイプの中であなたのフィード内容を使われないようにするには、3つの方法がある。Pipes"をブロックするように設定する。ApacheでPipesをブロックするには、httpd.confのバーチャルホストブロックにこれを加える。env=noPipes+</Limit>+</pre>++*作られたフィードに以下のメタタグを加える。/>+</pre>+:Pipesは、このタグを含むいかなるフィードの内容も無視するが、それでもあなたのサーバーからフィードを取得しなければならないと考えるだろう(タグを見るためには、フィードを読まなければならないからである)。++*ブロックしたいフィードURLリストをpipes-optout@yahoo-inc.comにメールで送る。あなたがこれらのフィードの持ち主であることを確認できるように、連絡先情報を付記すること。あなたのフィードをブロックするには数日かかる。++Pipesはウェブクローラーではない(このサービスは、パイプの作者かユーザーがリクエストしたときだけURLを検索する)。そのため、Pipesはロボット排除プロトコルには従わず、あなたのrobots.txtファイルをチェックすることもない。++PipesはOperaでは動作しないことがわかっている。Safariには少し問題がある。IE6は現在問題がある。++===Pipesの私のアカウントにサインイン、サインアウトする方法は?===++Pipesは無料のYahoo!サービスである。ID(※yahoo.comのもの。yahoo.co.jpのIDは使えない)が必要である。