Download Apple Style Guide

Transcript
••
Relative path: If there’s no leading slash, the path is a relative path—that is, relative to some
location other than the root folder.
Make sure the file is in Library/Application Support.
••
Home folder: In user materials, use your to indicate that the item being described is in the
user’s home folder. Use plain English (no slashes) to describe folders that are just one or two
levels deep.
Your files are saved in your Documents folder.
Your fonts are located in the Fonts folder in your Library folder.
If the folders go more than two levels deep, you can use slashes to avoid awkward
construction and wordiness. (Don’t use a leading slash, because that would indicate that the
starting point is at the top level of the startup disk, not the user’s home folder.)
Copy the file to Library/Application Support/Address Book/ in your
home folder.
For more technical audiences, you can use a tilde (~) to specify a path within the user’s
home folder.
The files are saved in ~/Documents.
Copy the file to ~/Library/Application Support/Address Book.
You can also use an absolute path with the word username in italics.
Each user’s files are saved in /Users/username/Documents.
••
Terminating slash: A terminating slash indicates that the final element of the path is a folder
rather than a file. You can choose whether or not to use a terminating slash, but be consistent
within a document.
You can find the files you’ve downloaded in ~/Library/Mail Downloads/.
See also code font; home folder, home directory.
PB (n., adj.) Abbreviation for petabyte. PB equals 10005 bytes in the context of file size or disk
storage capacity or 10245 bytes in the context of computer memory. See abbreviations and
acronyms for guidelines about spelling out abbreviations.
••
Noun: In the noun form, use a space between the numeral and the abbreviation. The
preposition of is necessary before the unit that the value quantifies.
1.6 PB of memory
1 PB of data
••
Adjective: Don’t hyphenate the adjective form.
1.6 PB RAM module
4 PB multiserver system
Chapter 2    Style and usage
117