読む価値のある出版物にはすべてスタイルガイドがある。これは、コンテンツ作成のプロセスを導き、正確さと一貫性を保証する一連のルールである。多くの人が気づいていないのは、スタイルガイドは通常、階層的に適用されるということだ。TidBITS の場合、単語のスペル、句読点、大文字の使い方について疑問が生じたら、まず社内のスタイルガイドを参照する。これまでスタイルルールを定める必要性を感じたことがなければ、次に Apple スタイルガイドを参照する。Apple が、少なくとも私たちが納得する答えを提供してくれない疑問については、次に The Chicago Manual of Style を参照する。どちらのスタイルガイドからも指針が得られない場合、あるいは彼らの提案に同意できない場合は、私たちは独自にそのトピックを調査し、ルールを策定して、それを TidBITS スタイルガイドに追加する。(この文書を公開しないのは、TidBITS と Take Control が何十年にもわたって有機的に進化してきたことを考えると、出版用に整理するのはあまりにも大変な作業になるからだ。)
社内スタイルガイドはあくまで社内向けのガイダンスであり、組織外の人がスタイルガイドの指示に従う必要はないことを覚えておくことが重要です。例えば、Appleは商標登録された製品名を冠詞に含めないことが一般的です。そのため、「iPhoneは最も一般的なメール標準をサポートしています」といった企業風の文章が生まれます。私たち一般の人なら、堅苦しくないように文章の冒頭に「The」を付けます。
こんなことを言うのは、Appleが最近公開スタイルガイドを更新したからです。これは年に1、2回しか行われません。しかも、AppleがスタイルガイドをWebで公開していることを知ったのはつい最近です。それまでは、Apple BooksからダウンロードしてBooksアプリで読める電子書籍版しか知りませんでした。
コンテンツはすべて揃っていたにもかかわらず、ブックアプリのページベースのブラウジング、検索の遅さ、そして隠れて探すようなインターフェースは、参考書の操作において特にストレスフルな体験となっています。目次を見るといった簡単な操作でさえ、タイトルバーにマウスオーバーして隠れているコントロールを表示し、目次ボタンをクリックする必要があります。
AppleスタイルガイドのWeb版は電子書籍版よりも明らかに使いやすく、記事への内部リンクがあれば、外部リンクも貼ることができます。例えば、先ほど「Apple BooksからダウンロードしてBooksアプリで読む」と書きましたが、本当にそうでしょうか？
iBooks（Appleの電子書籍アプリといえば今でもこの名前を思い浮かべる）の項目を見ると、「Apple Books」を使うことを推奨しているのが分かります。確かにその通りですが、「Apple BooksからダウンロードしてApple Booksで読む」という書き方は違和感があります。幸い、Apple Booksの項目には「Books」や「Booksアプリ」を使っても問題ないと明記されています。私のドライブに入っているアプリは「Apple Books」ではなく「Books」なので、いずれにせよそうするでしょうが、Appleが私の直感を裏付けてくれたのは嬉しいです。
AppleがWeb上のスタイルガイドのどの項目にも簡単にリンクできるようにしてくれたら助かります。Safariでそれを実現するには、Controlキーを押しながら項目をクリックし、「要素を検証」を選択してWebインスペクタから関連する要素IDをコピーし、subクエリパラメータを使って親レターのURLに手動で組み込むしか方法が思いつきません。
ここではホーム画面にリンクしています:
- 文字HのURL:
https://help.apple.com/applestyleguide/#/apsg9dac5903 - ホーム画面の要素ID:
apd3e3bb1ae1c194 - ホーム画面への完全なURL:
https://help.apple.com/applestyleguide/#/apsg9dac5903?sub=apd3e3bb1ae1c194
検索結果がサイドバーなどに表示され続けるようにしてほしいです。何か助けが必要な時は、検索してから結果を一つ一つ確認したいことがよくあります。Apple Booksは検索結果を保持するので、そういった検索方法には電子書籍版の方が適しています。ただし、毎回タイトルバーにマウスオーバーしてコントロールを表示し、検索アイコンをクリックする必要があります。
スタイルガイドの変更点
電子書籍スタイルガイドの以前のバージョンでは気づかなかったもう一つの点は、おそらく開いた直後に検索を実行していたからでしょうが、Appleが冒頭に「ガイドの変更点」セクションを設けていることです。これは素晴らしい機能で、Appleが新しいテクノロジーをどのように捉えているか、あるいは世界情勢にどう対応しているかを知る手がかりになります。
例えば、2020年7月のアップデートでは、Appleが民族や文化的アイデンティティについて言及する際に「Black」を大文字で表記し、「blacklist/whitelist」や「master/slave」といった表現の代わりに「blacklist/whitelist」や「master/slave」といった表現を推奨していることがわかりました。Appleがこのような人種差別的な表現を推奨しなくなったのは喜ばしいことです。
TidBITS にもっと関係があるのは、私たちが苦労した他のいくつかの変更点です。
- アクションシートと共有シート: Mac では、ポップアップアラートを、それが OK ボタンの付いた独立したウインドウであれ、ウインドウに付随したシートであれ、ダイアログと呼ぶ。でも iOS と iPadOS では、何かをタップしてさまざまな選択肢のポップオーバーが現れたら、それを何と呼ぶだろうか? 実は、ユーザー向け資料の中では、Apple はアクションシート (アクションのリストを提供する) や共有先を含む共有シートと呼ぶことを望んでいないようだ。ただし、共有シートの内容を編集している時は共有シートと呼ぶのは問題ない。私たちはおそらく可能な限り「アクションシート」や「共有シート」という用語は避けるようにするだろうが、TidBITS は比較的技術的な出版物なので、これらの用語を全く避けるつもりはない。
- デバイスと製品:これも、私たちがいつも遭遇する難しい問題です。iPhone と iPad の両方で機能するものに言及したり、手順を説明したりするにはどうすればよいでしょうか。iPadOS 13 より前は、「iOS デバイス」とだけ言うことができました。昨年、私たちは最初の言及で iOS と iPadOS の両方に適用されるものを明確にし、それ以降の言及では iOS のみに短縮することを選択しました。更新されたデバイス、iOS デバイス、iPadOS デバイス、製品のエントリで、Apple は現在 (厳密には、2019 年 12 月の更新で)、iPadOS を使用するデバイスを指すのに「iOS デバイス」を使用しないように言っています。ただし、「iOS または iPadOS デバイスをバックアップする方法を学ぶ」と言うことは許容され、さらに良いのは「iPhone、iPad、および iPod touch をバックアップする方法を学ぶ」と言うことです。率直に言って、私はこの解決策に満足していません。なぜなら、2 つ (iOS と iPadOS) または 3 つ (iPhone、iPad、および iPod touch) の項目をリストすると、本文で数回使用すると不自然になるからです。今後も検討を続け、ケースバイケースで対処していきます。
- リカバリモード： Macの起動時にCommandキーとRキーを押し続けると、何が起動するのでしょうか？Appleのサポート記事「macOS Recoveryについて」に基づき、これまでは「macOS Recovery」という用語を使ってきました。しかし、スタイルガイドに新たに追加されたリカバリモードの項目によると、「リカバリモードで起動する」という表現に置き換えるべきだという意見が出ています（ただし、Appleは起動ではなくスタートアップを推奨しています）。「macOS Recovery」という項目は存在しませんが、より具体的でAppleのサポートドキュメントにも合致するため、当面はこの用語を使用することにします。
- モード:これは厄介な問題です。このリビジョンではリカバリモードとセーフモードが新しく追加されましたが、どちらのエントリでも大文字と小文字が示されています。ただし、2019年2月のリビジョンではダークモードが追加され、明示的に大文字で表記され、同等のライトモードがないことが注記されています。この矛盾が気になるのはあなただけではありません。私たちも同じような問題に悩まされています。機内モード、スリープモード、ターゲットディスクモードなどのモードはどうでしょうか? Appleによると、すべて小文字です。ダークモードは、低電力モードと同様に最初の文字が大文字です。ただし、大文字と小文字が混在する省電力モードや、Appleが小文字と大文字の両方で使用しているターゲットディスプレイモードがありますが、スタイルガイドには含まれていません。ああ! 大文字で表記されているモードは、マーケティング上の機能なのでしょうか?
- internetとweb :時には、自分の主張を貫くしかないこともあります。2019 年 12 月の改訂で、Apple は「Internet」を小文字にすることを好む暴徒たちに同調し、「World Wide Web」の小文字の短縮形にそれを追加しました。Apple が何をしたいかは自由ですが、私たちは強く反対しており、「Internet」(その力への敬意もあって) と「Web」はどちらも大文字のままにします。これは、Apple の管理団体である World Wide Web Consortium (W3C) が、スタイル ガイドで「Web」を大文字で表記しているためです。ただし、W3C が許可しており、「FTP site」と「Gopher site」との一貫性を維持する理由があまりないため、「website」を 1 つの単語として使い始めるかもしれません。私たちは長い間、「webmaster」や「webcast」など、他の Web 関連の単語を小文字にしてきましたが、「Web page」については、Apple が結合しているにもかかわらず、W3C に従います。
こうした決定に至るまでの、細部にまでこだわった思考過程を少しでも楽しんでいただけたなら、Appleスタイルガイドをぜひ一読してみてください。文章の明瞭さと一貫性を重視するAppleの著者や編集者の思考を垣間見ることができる、有益な情報源です。