From 4db74575da249c401db9ab30a3a4f4c07a96acfb Mon Sep 17 00:00:00 2001 From: kenmanheimer Date: Tue, 8 Nov 2011 14:08:35 -0800 Subject: Explain relative naming policies necessary to allow varying the package name without breaking operation. --- docs/tutorials/wiki/NOTE-relocatable.txt | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 docs/tutorials/wiki/NOTE-relocatable.txt (limited to 'docs/tutorials/wiki/NOTE-relocatable.txt') diff --git a/docs/tutorials/wiki/NOTE-relocatable.txt b/docs/tutorials/wiki/NOTE-relocatable.txt new file mode 100644 index 000000000..7e42cf573 --- /dev/null +++ b/docs/tutorials/wiki/NOTE-relocatable.txt @@ -0,0 +1,13 @@ +We specifically use relative package references where possible so this demo +works even if the user names their package (in the 'bin/paster create -t +pyramid_zodb ...' step) something other than 'tutorial'. + +Specifically: + +- use relative imports +- use plain relative URLs for resources (like stylesheets and images) in + page templates. + +Direct uses of the package name, like in __init__.py 'config.scan()' +statements, are already adjusted by the paster/pcreate, so we don't have to +worry about them. -- cgit v1.2.3