27.01.2015 Views

Best Practices of Plone Development

Best Practices of Plone Development

Best Practices of Plone Development

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

CONTENTS<br />

CONTENTS<br />

Contents<br />

1 <strong>Best</strong> <strong>Practices</strong> for <strong>Plone</strong> <strong>Development</strong> 3<br />

1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4<br />

1.1.1 Handouts and Examples . . . . . . . . . . . . . . . . . . . . . . . 4<br />

1.1.2 Why Do We Need This . . . . . . . . . . . . . . . . . . . . . . . 4<br />

1.1.3 Safety . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4<br />

1.1.4 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4<br />

1.1.5 Re-Usability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5<br />

1.1.6 Streamlined <strong>Development</strong> . . . . . . . . . . . . . . . . . . . . . . 5<br />

1.2 Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6<br />

1.2.1 Concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6<br />

1.2.2 Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6<br />

1.2.3 Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7<br />

1.2.4 Framework: config.py . . . . . . . . . . . . . . . . . . . . . . . . 7<br />

1.2.5 Framework: content/ . . . . . . . . . . . . . . . . . . . . . . . . . 7<br />

1.2.6 Framework: skins/ . . . . . . . . . . . . . . . . . . . . . . . . . . 8<br />

1.2.7 Framework: Extensions . . . . . . . . . . . . . . . . . . . . . . . 8<br />

1.2.8 Framework: doc/ . . . . . . . . . . . . . . . . . . . . . . . . . . . 8<br />

1.2.9 Framework: VERSION.txt . . . . . . . . . . . . . . . . . . . . . . 8<br />

1.2.10 Framework: __init__.py . . . . . . . . . . . . . . . . . . . . . . . 9<br />

1.2.11 Site Product Overview . . . . . . . . . . . . . . . . . . . . . . . . 9<br />

1.2.12 ArchGenXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9<br />

1.2.13 UML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10<br />

1.2.14 Converting UML . . . . . . . . . . . . . . . . . . . . . . . . . . . 10<br />

1.2.15 ArchGenXML Tips . . . . . . . . . . . . . . . . . . . . . . . . . . 10<br />

1.2.16 Skeletor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11<br />

1.3 Filesystem Skins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12<br />

1.3.1 Through the Web Editing . . . . . . . . . . . . . . . . . . . . . . 12<br />

1.3.2 More Web Editing Problems . . . . . . . . . . . . . . . . . . . . . 12<br />

1.3.3 File-System Stored Skins . . . . . . . . . . . . . . . . . . . . . . . 13<br />

1.3.4 Filenames Matter . . . . . . . . . . . . . . . . . . . . . . . . . . . 14<br />

2

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!