TYPOGRAPHICAL CONVENTIONS

Literals, filenames and function arguments are presented using the following style:

argument1

Warnings, which represent limitations and need-to-know information related to a topic or concept are presented in the following style:

latex-warning.png

This is a warning.

Notes, which represent additional information related to a topic or concept are presented in the following style:

latex-note.png

This is a note.

We present Python method names using the following style:

pyramid.config.Configurator.add_view()

We present Python class names, module names, attributes and global variables using the following style:

pyramid.config.Configurator.registry

References to glossary terms are presented using the following style:

Pylons

v

URLs are presented using the following style:

Pylons

References to sections and chapters are presented using the following style:

Traversal

Code and configuration file blocks are presented in the following style:

1

2

def foo(abc): pass

Example blocks representing UNIX shell commands are prefixed with a $ character, e.g.:

$ ../bin/nosetests

Example blocks representing Windows cmd.exe commands are prefixed with a drive letter and/or a directory name, e.g.:

c:\examples> ..\Scripts\nosetests

Sometimes, when it’s unknown which directory is current, Windows cmd.exe example block commands are prefixed only with a > character, e.g.:

> ..\Scripts\nosetests

When a command that should be typed on one line is too long to fit on a page, the backslash \ is used to indicate that the following printed line should actually be part of the command:

c:\bigfntut\tutorial> ..\Scripts\nosetests --cover-package=tutorial \ --cover-erase --with-coverage

A sidebar, which presents a concept tangentially related to content discussed on a page, is rendered like so:

This is a sidebar

Sidebar information.

vi