へびにっき » CakePHP翻訳

Super Awesome Advanced CakePHP Tips 訳と註5

tkykmw — Sat, 07 Nov 2009 14:55:29 +0000

コアから学ぶCakeのコツ

原題: Cake Tricks from The Core
日本語訳トップページ

この章は本当に日本語に訳しにくいです。$options という”英単語”をどう解釈するか、そしてカタカナ語をどこまで許容するかがとても悩ましく、ごまかしも増えてしまいました。内容は別に難しくはないのですが。

Cake Tricks from The Core 註

Cake Tricks from The Core: ここの訳は完全にごまかし。直訳して「コアから、Cakeのコツ」ではあまりにも意味が分からないので作文せざるを得なかった。すいません。原題に「学ぶ」なんて語は無いしそんなニュアンスも無い。ここの from は日本語だと多分「〜発」というのに近い。「コア発のCakeテクニック」みたいなのが良いかも知れない。
Cake Style $options Parameter: このタイトルはそのまま訳すのは不可能。すなわち $options は英語の「option」であると同時に、プログラミング上のテクニック（この節で説明する、$optionsパラメータを使った方法）を指す一種の固有名詞。さらにこの場合の英語の「option」は、自由選択とか自由入力とかいった意味なのだが、日本語プログラミング用語としては片仮名で「オプション」としか言い様がない。オプション引数、つまり関数呼び出し時に値を与えても与えなくても良い、「オプションの」引数を扱うための $options パラメータを使ったCake流のやり方、ということ。; 以下いちいち註では書かないが、この節の中の $options という表記の部分には、いずれも同じ問題がある。そのせいで日本語としては非常に煩雑になってしまった。
We’ve all seen functions that …: この章も他の章と同じく、冒頭の文はちょっとだけ格好をつけた感じの文になっている。訳文も雰囲気重視で作っておいた。
a keyed array: 「連想配列」と言ってしまいたくなるのだが、連想配列は普通 associative array の訳語だから、ここで使うのは躊躇われる。それにそもそもPHPには「連想配列」と「普通の配列」という区別は無い。同じ一つのデータ構造を使い方によって呼び分けているだけである。次節で分かる通り、著者はそのPHPの特殊事情について自覚的かつ誠実なので、ここでも敢えて keyed という、配列の「使い方」を示す言い回しをしているのだと思われる。「（文字列の）キーを付けられた配列」。
out of whack: 「狂った」とか「めちゃくちゃな」といった意味の決まり文句らしい。
This approach: 片仮名で「アプローチ」でも大体意味は通じると思うが、「このアプローチではデフォルトのオプションとマージします」では、英語を日本語に訳しているんだか単に片仮名に書き直しているんだか分からない。approach は元々「近付く」という語なので、ここでは「オプション引数を実現する」という目標に対する近付き方、段取りということ。
The end $options: ここでの $options はコード内の変数名（25行目、代入式の左辺）をも指している。
easier to read, shorter to code: 語呂の良い文なので、日本語もちょっと工夫した。この code は「コードを書く」という動詞だから、まあ「書く」で通じるだろう。
Handling Data Arrays with a Single Record or an Array of Records: 文法的には “a Single Record” or “an Array of Records” 全体に with がかかる形式で、with は漠然と「〜を持って」「〜を備えて」といった意味だと思われる。
since $data is …: いきなり $data という変数名が出てくるが、この節では関数を作ることを想定しているので、これはその関数がとる引数の名前。最後の段落でも出てくる。
telling them apart: tell 〜 apart で「見分ける」。
to do this: 形式的にはこの to do this は「to look at the keys」に対応するのだと思うが、実質的にはその次の文の内容「If they are all numeric」も含むと考えて良いだろう。

Super Awesome Advanced CakePHP Tips 訳と註4

tkykmw — Sat, 31 Oct 2009 13:03:33 +0000

jQuery

原題: jQuery
日本語訳トップページ

今回は jQuery についての章です。私も以前 CakePHP のための jQuery ヘルパーを探したことがありますが、結局作者と同じく、直接 jQuery を使う方が楽だという結論に至りました。

翻訳とは関係ないのですが、最後のJavaScriptのコード例は下記のようにすべきではないかと思います。

$("#scoresUpdate").click(function() {
  $.ajax({
    url: this.href,
    success: function(html) {
      $("#divId").html(html);
    }
  });
});

jQuery 註

solid: 「手堅い」とか「実績のある」といったイメージだろうか。
The JavascriptHelper used: この文以降、形式的には過去形と現在形が入り交じっている。正直なところ、何を意図しているのかよく分からない。少なくとも仮定法を使った文はないと思うのだが、特に would が過去なのか現在なのか、区別し切れない。; とりあえず JavascriptHelper について語っているこの文と次の文については、著者の意識としてはヘルパーを使う方法は古いやり方だから、過去形になっているのもまあ理解できる。ということで訳文でも過去形にした。
This would fire an alert with …: この段落以後の would は単なる弱い推量？
Notice that this is PHP code that: 「PHPのコード」であることに力点があるので、訳文には括弧を追加した。
This is pure JavaScript code and can be …: この and は「したがって」「だから」といった意味。
you’re not just stuck using a DOM ID: stuck は stick の過去分詞形。なんとなく意味は伝わってくるのだが正確な訳はよく分からない。訳文はごまかし。辞書には be stuck with doing … で「〜することを押し付けられる」といった訳が載っている。同じような意味か。
a special link that, when clicked, sends off an XMLHttpRequest, rather then redirecting the browser.: この文は理解できなかった。お手上げ。(1) rather then は rather than の typo なのか (2) もしそうだとしたら、rather の前のカンマは何を意図しているのか (3) 仮にカンマを無視するとしたら後半は sends off redirecting the browser という文を想定することになるが、それで意味が通るか (4) もし then が than の typo でないとしたら、一体どういう文になるのか。; 訳文では次のような文を「訳」した： a special link that, when clicked, sends off an XMLHttpRequest rather than redirects the browser.
made: 「行う」「する」といった意味の make
you would …: この段落の you は明確に読者を意識しているわけではなく、なんとなく「一般の人」を主語においているだけだろう。

Super Awesome Advanced CakePHP Tips 訳と註3

tkykmw — Wed, 28 Oct 2009 15:34:45 +0000

呆れるほど簡単なURLスラッグの作り方

原題: Stupid Easy URL Slugs
日本語訳トップページ

……
Super Awesome Advanced CakePHP Tipsの翻訳3回目です。まさにアイデアの勝利、といった内容ですね。

Stupid Easy URL Slugs 註

Stupid Easy: 直訳は「愚かで簡単な」。たぶん決まり文句だろうと思ってGoogleで検索したところ、「非常に簡単な・初歩的な・容易な」という意味で用いられているようだ。それら用例を見る限りでは、必ずしも（字面から想像されるような）否定的な意味とは限らないらしい。ということで、日本語に置き換えるなら「バカでも分かる」がぴったりだと思うのだが、翻訳でそこまでキツイ語を使う勇気はなかったので、もう少しマイルドに「呆れるほど簡単な」としておいた。
Slugs: Wikipedia-en Slug(typesetting)によれば元々は活字組みでスペースを空けるために用いられる部品？のことらしい。現代のDTPソフトウェアでも補助情報を印刷するための領域（最終的には裁断され捨てられる）の名前として使われているとのこと。ちなみにInDesign CS4の日本語版マニュアルでは「印刷可能領域」という見出しで説明されている。; それが、どういう経緯があったのかは知らないが、最近ではURLの中に埋め込むページ見出しの呼称として使われるようになった。日本語では適当な訳語もないし、WordPress等のブログツールで使われてそれなりに広まっているので、片仮名の「スラッグ」で良いだろう。
I’ve seen this idea floated on a bunch of different blogs.: この章に限ったことではないのだが、章の冒頭の文章はけっこう格好つけた感じの文が多くて、そのまま日本語に訳して意味が通るようにするのは難しい。なので訳文はある程度雰囲気重視で作っておいた。; ここでの float は「提案する」という意味で、this idea は当然「URLスラッグを（CakePHPで）作る」という「考え」だろう。スラッグの作り方について、いろいろなブログでいろいろな提案がされているのを見てきたよ、ということ。
Many offer more complicated methods …: この文もちょっと凝っている。「複雑な方法」か「単純にするためのビヘイビア/ヘルパー」だから、どちらも本質的には複雑だ、という含意がある。
you’re using a standard action for your view: この view がよく分からない。「viewアクション」のことなのか、それとも「項目の表示」という意味なのか、あるいは両方を同一視しているのか。訳文では迷った末に view のまま放っておいた。すいません。一応前者のつもりということで。
It is safe to create URLs: 定冠詞なしの URLs だから、ここは一般論。日本語では何か接続詞が欲しくなるところ。
With this method: 後に続くのが this method なので、この With は「（道具を）使って」という意味かと思えるのだが、それだと意味が通らない。ここは「〜について、〜に関して」という意味だろう。
Consistency And SEO Improvements: ~~「一貫性とSEO」を改善するのか、それとも「一貫性」および「SEOの改善」を話題にしているのか。どちらとも取れるような訳文にしておいた。~~ Improvements が複数形だから、「一貫性とSEO」を改善するのだろう。初歩的な見落としをしてしまった。
and: ここと次の文の and は「しかし、にも関わらず」といった意味だろう。
cakephp_sucks_and_so_does_your_site: 「CakePHPはクソだしお前のサイトもクソだ」。もし日本語で入力したとしても表示されるはずなので、訳してもよかったかも知れない。
happily: 日本語で言う「おめでたい」というやつか。
It’s easy enough: 特に訳文には反映していないが、この enough は「十分簡単なので（ご安心ください）」というニュアンスが込められているかもしれない。

Super Awesome Advanced CakePHP Tips 訳と註2

tkykmw — Mon, 26 Oct 2009 14:55:40 +0000

誰が作成・修正したのか、自動的に追跡する

原題: Automatically Tracking Created/Modified By
日本語訳トップページ

……
Super Awesome Advanced CakePHP Tipsの翻訳2回目です。内容的には前回の続きになっています。

Automatically Tracking Created/Modified By註

Created/Modified By: この章に出てくる created/modified by は、そのままでは日本語に訳すことができない。ある程度説明的に訳すしかない。
establish: 細かいことだが現在形。つまり著者はこの本が先頭から読まれるものだとは必ずしも想定していないということになる。
the previous section: 翻訳上は全く問題無いのだが、この the previous section が具体的に何を指しているのかはちょっと興味深い。というのも、この本の中で見出しが付けられた内容のまとまりを何と呼ぶべきかに関わるからだ。; もしこの section が『Getting the Logged In User from Anywhere』全体を指すのであれば（文脈からはそれが最も自然だろう）、この本の中で最も大きなまとまりは「section = 節」と呼ばれていることになる。しかし個人的には、節では少し小さく感じる。「章 = chapter」と呼んだ方が相応しいような気がする。そして実は作者もブログの中で「Chapter」という呼び方をしている。Check out Chapter 2: “How to Learn CakePHP”. だがもし『Getting the Logged In User from Anywhere』や『Automatically Tracking Created/Modified By』を章と呼ぶのであれば、ここの the previous section は何を指すのだろうか？前の章の最後の節である『Full Source』だろうか？意味の上ではあり得なくもないが、ちょっと変に感じる。
Now we can apply this to setting the created by …: この文はうまく訳せなかった。わずかな単語にいろいろな意味が圧縮されているので、日本語だと説明的になりすぎて文にならない。created by and modified by fields で「誰が作成・更新したのか記録するためのフィールド」、setting は他の用例から考えれば「（フィールドに）値を設定する」という意味。for various database records は構造の異なる様々なレコード（テーブル）に対して、という意図だろう。
Model beforeValidate Callback: この段落全体は著者の勝手な仮定によるお遊びで、それゆえ仮定法が用いられている。「こんな文を書くくらいなら素直に beforeValidate コールバックの例を書けば良いじゃないか！」と読者に思わせるための、ツッコミ待ちの文章。
make this into a behavior: もちろん「これをビヘイビアの中に入れる」と直訳しても意味は通じるが、「ビヘイビア化する」という日本語がぴったりだろう。
Then: この Then は「すぐに」の意味だろうか。
feel mildly foolish: feel foolish で「きまりが悪い」「ばつが悪い」といった意味。
justified in believing …: be justified in doing … で「…は正当である」「…するのももっともである」といった意味になるのだが、主語と動詞が欠けている。文脈からすれば主語は多分 you だろう。
So I won’t insult your intelligence …: 最後のこの文は仮定法ではない。「あくまで仮定」という装いで散々書いておきながら、最後に「私はそういうことはしないよ」と言っている。読者からのツッコミ待ち。
We’re making a bit of a leap here, in believing that …: 非常に訳しにくいので訳文はごまかした。すいません。leap はここでは多分「論理の」飛躍という意味で、段落冒頭の The logic と対応している。「『idが設定されていれば更新だ』と考えるのは論理が飛躍している」ということで文脈にも合う。さらに進行形なので、「今論じているこのロジックの中で、論理の飛躍を犯しつつある」といった感じか。また前置詞 in は時間または状況の中という意味にとって、「このロジックの中の、具体的には…と考えているところで、論理の飛躍を犯しつつある」という風に解釈するのが最も自然だろうか。
If you wanted to be diligent: 仮定法。その前の文の outside possibility と対応しており、著者はidの偽装が問題となる可能性は非常に低いと見ている。そもそも「誰が作ったか」を自動追跡することが必要になるアプリケーションというのは、かなり限られたユーザだけが使うログイン制のシステムだから、だろうか？
less: この less は excluding と同じ意味で、「〜を除いて」。

Super Awesome Advanced CakePHP Tips 訳と註1

tkykmw — Sun, 25 Oct 2009 09:55:14 +0000

任意の場所からログイン中のユーザを取得する

原題: Getting the Logged In User from Anywhere
日本語訳トップページ

……
Matt Curry氏が無償公開されている電子書籍『Super Awesome Advanced CakePHP Tips』の翻訳を始めました。既にbobchin氏が全体を翻訳完了されている（と公開直前に知った）のですが、私自身の勉強も兼ねて、なぜそう訳したのかという註釈を含めて拙訳を公開していきます。原文を読まれる際にお役立てください。また間違いや疑問などありましたら教えていただけると嬉しいです。

第一弾は16ページからの『Getting the Logged In User from Anywhere』です。私が興味を持った順に訳していきます。とても時間がかかるので、翻訳完了時期は今のところ未定です。

Getting the Logged In User from Anywhere註

クリックすると該当行をハイライトして表示します。

from Anywhere: 日本語で「どこからでも」と言うと譲歩の意味が強過ぎるので、ちょっと堅苦しい表現だが「任意の場所から」とした。
This is a problem that comes up often.: This はタイトル「Getting the Logged In User from Anywhere」の内容を指し、それが「よく生じる問題である」、ということで「よく問題となる」といったところか。
modified user: 素直に読めば「修正されたユーザ」としか読めないのだが、それでは意味が通らない。文脈からすればこれは次章「Automatically Tracking Created/Modified By」の内容を示していることは明らかなので、modified user ひとまとまりで「修正を行ったユーザ」と理解するのが正しいのだろう。Web検索でも同様の用例が見つかる。
beforeFilter: モデルには beforeFilter コールバックは存在しない（次章の内容からすれば実装上正しいのは beforeValidate）。なぜここで beforeFilter と言ったのか。(1)コントローラの beforeFilter を指す。(2)単なる間違い。(3)主処理の前に実行されるコールバックを抽象的に beforeFilter と呼んでいる。多分(3)？
It would be great if you could …: 前の文は単なる仮定だが、この文は仮定法。つまり handle 以下は現実には不可能だと認識している。「なぜ不可能なのか」に相当する内容は書いていないが、前段落までビューとコントローラからセッションにアクセスする方法について述べているのだから、ここではモデルからセッションにアクセスする方法が”無い”ことを仮定法によって暗示していると見なせる。
You can always cheat …: always が悩ましい。本当に「いつでも」という意味だと理解すると、ビューでもコントローラでも使えばいいじゃないか、という話になって次の文とのつながりが苦しくなる。「必要ならいつでも」くらいに訳すべきか。さらに次の文の註参照。
Plus, now we are using three …: この文は翻訳では何か言葉を補わないとうまく繋がらない。まず文頭の Plus が何に対して「加えて」いるのかが問題になる。always の註に書いた通り、前の文に対する付加だとすると意味が通じない。これは冒頭の problem に対する付加と見なすべきだろう。; つまり作者の問題意識は2つある。一つ目は Model からセッションに直接アクセスする方法がないこと。二つ目はアクセスする方法がバラバラであること。よってこの2つを同時に解決する方法を提示するのがこの章全体の主題となっている。章の冒頭のこの節ではまず前者について述べ始めたのだが、最後になって後者を付け加えた。あるいは書いている途中で自分の2つ目の問題意識に気付いたのかも知れない。
but for the User::get syntax to work it has to …: but は単なる接続詞。for は不定詞 to work の主語を示す。語順を変えると「but it has to go in the model for the User::get syntax to work.」
Deal with it.: 「うまく対処してくれ」→「なんとか我慢してくれ」くらいの意味になるようだ。参考。直訳だとちょっと様にならないので意訳を採用。
instance: これ以後 instance という語が頻繁に使われるのだが、その意味は日本語オブジェクト指向用語の「インスタンス」とは厳密には一致しない（必ずしも何らかのクラスに属するオブジェクトではない）。しかしWikipediaを参照する限り英語オブジェクト指向用語の「instance」も日本語の「インスタンス」とほとんど変わらない意味だから、やはりこの文章における用例とは一致しない。多分、instance が元々持っている「具体事例」というような意味と、オブジェクト指向用語 instance が持つ語感とを混ぜ合わせたような意味で用いられているのだと思う。
Before you can access … you need to …: 「…するためには…しなければならない」「…して初めて…することができる」
get the instance and pull out a specific piece of information from the user array.: この and を単純な並列にとると意味が通じない（User::get は $path パラメータが必須で、「インスタンス」を取得するためのものではない）。やはり the instance と the user array は同じ物を指していると考え、「インスタンスを取得して、そして一部を取り出す」というように前後関係を表していると見るべきだろう。
inspired: 敢えてカタカナで「インスパイア」の方が雰囲気が出ると思う。パクリじゃない、インスパイアだ！
the syntax isn’t as appealing.: 後ろに「as that of User::get()」が省略されている。
Why not just use the same setup for …: 意味は鮮明だが訳しにくい。「Why not A …, but B …」なぜBを除きAしないのか（すれば良いではないか）。思いっきり分かりやすく言うと、 User::get() を Configure に対する Wrapper にすれば良いじゃないか、ということ。
Again, certainly an option.: うまく訳せなかった。短い文は難しい。 an option は「User::get() を Configure に対する Wrapper にする」という（読者からの想定）提案を指し、Again はその前の「Configure クラスをそのまま使う」という案に対するもの。だと思うのだが、自信がない。
withing: within の typo だろう。