From 2b804317d0470d1417996bd1b0a40a4d115b3721 Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Thu, 2 Jul 2009 08:04:29 +0000 Subject: Mention resources. --- docs/tutorials/cmf/index.rst | 11 ++--------- docs/tutorials/cmf/missing.rst | 22 ++++++++++++++++++++++ docs/tutorials/cmf/skins.rst | 20 ++++++++++++++------ 3 files changed, 38 insertions(+), 15 deletions(-) create mode 100644 docs/tutorials/cmf/missing.rst (limited to 'docs/tutorials/cmf') diff --git a/docs/tutorials/cmf/index.rst b/docs/tutorials/cmf/index.rst index 9b1168be9..77d2ce02c 100644 --- a/docs/tutorials/cmf/index.rst +++ b/docs/tutorials/cmf/index.rst @@ -25,15 +25,6 @@ because CMF happens to provide other helpful services, such as types, skins, and workflow; this tutorial is for those sorts of developers and projects. -XXX Missing: - - templates.rst - forms.rst - membership.rst - discussions.rst - syndication.rst - dublincore.rst - .. toctree:: :maxdepth: 2 @@ -42,5 +33,7 @@ XXX Missing: skins.rst actions.rst workflow.rst + missing.rst + diff --git a/docs/tutorials/cmf/missing.rst b/docs/tutorials/cmf/missing.rst new file mode 100644 index 000000000..e4faa30f7 --- /dev/null +++ b/docs/tutorials/cmf/missing.rst @@ -0,0 +1,22 @@ +Missing Comparisons +=================== + +We currently don't have any comparative BFG-vs-CMF information about +the following concepts within this tutorial: + +- Templates + +- Forms + +- Membership + +- Discussions + +- Syndication + +- Dublincore + +Please ask on the `repoze-dev maillist +`_ or on the `#repoze IRC +channel `_ about these topics. + diff --git a/docs/tutorials/cmf/skins.rst b/docs/tutorials/cmf/skins.rst index ab9bb5cb1..549fb4621 100644 --- a/docs/tutorials/cmf/skins.rst +++ b/docs/tutorials/cmf/skins.rst @@ -11,12 +11,20 @@ layers" grouped in a particular order forms a "skin". "Add-on" CMF products often provide skin layers that are activated within a particular skin to provide the site with additional features. -:mod:`repoze.bfg` itself has no such concept, and no package provides -a direct replacement, but bfg :term:`view` code combined with +To override static resources using a "search path" much like a set of +skin layers, :mod:`repoze.bfg` provides the concept of +:term:`resource` overrides. See :ref:`overriding_resources_section` +for more information about resource overrides. + +While there is no analogue to a skin layer search path for locating +Python code (as opposed to resources), :term:`view` code combined with differing :term:`request type` attributes can provide a good deal of -the same sort of behavior. The `repoze.bfg.skins -`_ package is an attempt to allow -directories on disk to represent collections of templates, each of -which can be thought of as a minimal skin. +the same sort of behavior. See +:ref:`using_an_event_to_vary_the_request_type` for more information. + +Relatedly, the `repoze.bfg.skins +`_ package is an attempt to +allow directories on disk to represent collections of views simply by +adding templates to the directory. -- cgit v1.2.3