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