うpれっと マニュアル

これは何？

ファイルをサーバにアップロードするものです。これは OSX に組み込まれている URL 転送コマンドラインツール curl のアップロード機能を簡単に利用できるようにするものです。

設定さえ済ませば、アップロードしたいファイルをうpれっとにドラッグ＆ドロップするだけで、適切な場所にアップロードされます。

必要な環境

MacOS X 10.6（Snow Leopard）の日本語環境で動作確認しています。 10.5 以下では検証できてませんが 10.5 ならたぶん動作すると思います。10.4 以下はわかりません。

機能と特徴

具体的な動作

アップロードでは転送元のフォルダ階層（ファイルパス）がそのまま転送先の URL のパスに反映します。階層の基準点はうpれっと自身が存在するフォルダになります。

例えばうpれっとをホームディレクトリの サイト フォルダに設置し、アップロード先の URL を

      ftp://some.domain.com/xyz

に設定した場合、 サイト フォルダのファイル file1.html は 

      ftp://some.domain.com/xyz/file1.html

に転送され、 サイト フォルダの folder1 フォルダのファイル file2.jpg は

      ftp://some.domain.com/xyz/folder1/file2.jpg

に転送されるといった具合になります。つまり、うpれっとが存在するフォルダ下のファイル（サブフォルダのファイルも含む）のみがアップロードの対象になります。

転送先 URL にファイルが存在する場合は上書きされます。ファイル名に日本語等が混じっていても問答無用でアップロードします（サーバ上では変な名前になるかもしれません）。 サイト フォルダの外のファイルはアップロードの対象にはならず、無視されます。

アップロードの際には、うpれっとと同じディレクトリに うpれっと.log という名前のログファイルが作成され（※）、転送が始まる直前にコンソール （Console.app）で表示され、リアルタイムで更新されます。 （※同名のファイルが存在しても上書きされます。うpれっとを別名に変更した場合などは、<その名前>.log になります。）

設定

設定は次の３段階で行います。

アップロード先（サーバ URL）とアカウントの設定

アップロード先の URL とアカウント（ログイン名とパスワード）はキーチェーンアクセスで設定します。キーチェーンアクセスはアプリケーションフォルダのユーティリティフォルダ内にあります。

下の図の様なダイアログが出てくるので、アップロード先 URL, アカウント名, パスワードを入力し、「追加」ボタンを押します。

（アカウント名とパスワードが不要な場合はアカウント名として * 一文字のみを入力します（例えば curl オプションに --netrc を与える場合）。パスワードのみが不要な場合はパスワード欄に * 一文字のみを入力します。）

図に示されている様に入力した場合、 some.domain.com という名前の項目が新たに作成されるはずです。ダブルクリックして編集することもできます。下の図のようになります：

図の水色の部分が項目名です。うpれっとはこの名前（および、項目が所属するキーチェーンファイルのパス）を検索キーとして、キーチェーンからアップロード先の情報を取得します。したがって、同じ名前のインターネットパスワード項目が複数あると意図した項目と別の項目から転送先の情報を取得してしまう事があります。この名前を後で変更した場合、次に述べるうpれっとの設定もやり直す必要が生じます。

（FTP URL 入力時の注意） 下の２つは意味が異なります：

      ftp://some.domain.com （ユーザのホームディレクトリ）
      ftp://some.domain.com/ （ルートディレクトリ）

上段の形式の URL は FTP サーバの利用者のアカウントのホームディレクトリを表します。サブディレクトリ（ホームからの相対パス）は ftp://some.domain.com/xyz の様に記述します。通常はこちらの形式で指定することになるでしょう。 下段の形式の URL は FTP サーバのルートディレクトリを表し、サブディレクトリ（絶対パス）は ftp://some.domain.com//xyz の様にスラッシュを余分に入れて記述します。

うpれっととインターネットパスワード項目（アップロード先）を結びつける

どのアップロード先、すなわち、どのインターネットパスワード項目を利用するかを、うpれっとに教えてあげる必要があります。

アップロードオプション設定

一般的にはここまでの設定で十分な事が多いですが、必要に応じて詳細な設定を与えることも可能です。SSL（FTPS, HTTPS）を利用する場合もオプション設定が必要になります。例えば FTP 転送は PASV モードがデフォルト（ルータなどで家庭内 LAN を構築している場合はこちらが適切でしょう）ですが、サーバの都合などの理由で PORT モードにしたい場合もあるでしょう。あるいはより詳細なログを出力させることも可能です。

うpれっとを単独で起動して表示されるリストダイアログで「アップロードオプション設定ファイルを Finder に表示」を選択します。開かれるウインドウ内に _curlrc.txt というファイルが見つかるはずです。これがオプションの設定ファイルです。これをユニコードを扱えるテキストエディタで開いて編集します（注意：文字コードは UTF-8 , 改行コードは LF です。これらは変えないように）。設定の仕方やそれぞれのオプションの意味はファイル内に書いてあります。

参照：curl マニュアルページ （和訳） （英語）

フォルダの丸ごとアップロード

フォルダをドラッグ＆ドロップして中の文書を一括してアップロードすることもできます。 ただし、一度にアップロードできるフォルダは一つまでです。 また、アップロードの対象となるファイルはフォルダ内の文書ファイル（ファインダの情報ウインドウやリスト表示の種類カラムで 〜Document または 〜書類 と表示されているもの）に限られます。

デフォルトでは確認ダイアログが表示され、再帰的にサブフォルダの内容もアップロードするかどうかや確認ダイアログの省略も指定できます（単独で起動して「フォルダのアップロード…」を選択して下さい）。 いずれにせよ、うpれっと が存在するフォルダの外のフォルダは対象外になります。

ログの設定

デフォルトでは、アップロード実行中にログウインドウが開いて、進捗状況などを表示しますが、これをオフにすることもできます（ログファイル自体には記録されます）。また、ログは実行ごとに新たに上書きするようになっていますが、既存のログを残して追記するようにすることも可能です。これらの設定もうpれっとを単独で起動して変更できます（「ログファイルの自動表示…」「ログ出力…」）。

Tips ＆ トラブルシューティング

アップロード先が複数ある場合
複数のサイトに同時にアップロードすることはできませんが、複製されたうpれっとの設定は複製元と独立に変更できます。
設定が反映されません。
アクセス権の問題かもしれません。うpれっとの情報ウインドウを開いて書き込みが許可されているどうか確認して下さい。（設定はうpれっと自身に記録される仕様なので。）
オプション設定ファイルが テキストエディット で開きません
設定ファイルの文字コードは UTF-8 です。テキストエディット はドラッグ＆ドロップで文字コードを自動判別してくれません。ファイルダイアログで文字コードを指定して開く必要があります。ユニコード対応テキストエディタを薦めます。
パスワードの入力ダイアログが表示されます
キーチェーンがロックされている場合、キーチェーンのパスワードを入力する必要があります（FTP サイト等のパスワードではなく）。これが煩わしい場合はキーチェーンのロックを解除して下さい（キーチェーンアクセスの編集メニューから設定を変更できます）。
アクセスの確認ダイアログが表示されます
ダイアログで「常に許可」を選択すると現れなくなります。これを元に戻したい場合は、キーチェーンアクセスの該当するインターネットパスワ−ド項目のアクセス制御設定で security コマンドを削除します。
アップロードできません。
同じキーチェーンに同名の項目が２つあると URL が正しく取得できないことがあります。
キーチェーン項目の名前を異なるものに変えて下さい。
「編集」と「OK」の２つのボタンがあるよくわからないダイアログが表示されます。
作者が予期していないエラーが生じています。ごめんなさい。

技術的詳細

うpれっとはアプレット（ Apple Script で書かれたアプリケーション）です。 スクリプトエディタで開いてソースコードを覗いたり、編集してカスタマイズすることもできます。

実行時に利用されているリソースは：

実際の転送処理は汎用の URL 転送コマンドラインツール curl が用いられています。転送の際に実行されるコマンドは次のようになっています：

curl -q --globoff -u <ユーザ名:パスワード> --config <設定ファイル> -T <file1> <URL1> -T <file2> <URL2> ...

履歴

著作権と利用許諾

名称：うpれっと（英名 Upplet）

Copyright © 2005-2011, 広瀬行夫（HIROSE, Yukio）

クリエイティブ・コモンズ・ライセンス このソフトウエアは、クリエイティブ・コモンズ・ライセンスの下でライセンスされています。