Documentation

bemoko Sites

A bemoko site encapsulated all the resources, plugins & configuration that are used to deliver this site. You can use bemoko to deliver multiple sites and you'll learn how to extend and reuse existing sites using the site inheritance model and also learn how to organise sites into sub-sites to deliver variations on your site.

As you start off, you can treat it as such and drop web pages into the ui/root directory of the site. As you learn about other elements of bemoko site, you'll learn how to layer this with rich functionality that allows you to rapidly deliver multi-channel web sites.

Where to Create Your Sites

You can create a site by creating a directory in a one of the site directories. By default the bemoko directory in the bemoko home directory is a site directory where you can place sites, e.g.

Windows

C:/Users/(your-user-name)/bemoko/sites

Linux, Mac OS or Unix

~/bemoko/sites

For example you could create a site at

(bemoko-home-directory)/sites/mysite

and then access this site at

http://mysite.com/live/mysite

Your site can contain the following resources:

mysite

Inheritance, Addons and Subsites

bemoko provides extensive features so that can re-use and don't repeat yourself. If you ever find your self copying and pasting content, then stop and think whether it is actually necessary. There is probably a better way, so read on ...

All sites can inherit from one or more parent sites. This means that all behaviour - i.e. site configuration, such as plugins, UI configuration, resources (HTML, CSS, JS, etc), is taken from these parent sites.

For example

<site parent="default.skin">
   ...
</site>

indicates that the site should inherit all the behaviour from the default.skin site.

Sub-sites

A site can contain other sub-sites (which can in turn contain other sub-sites). A sub-site inherits from the site that it is contained in.

Perhaps you want to deliver a minor variation on a site, for example a seasonal skin. By creating a sub-site you can simply define the minor variations over and above the parent site without interfering with your existing (and working) site.

You can create a sub-site, by creating a directory at the top level of your site and putting site resources in that site, just as you would with any normal site. For example if you have a site called mysite with a sub-directory called subsite then the subsite can be accessed as follows:

http://mysite.com/mysite/subsite/i

Addons

A site can include addons which allow to bundle up web site functionality and reuse across many sites. An addon is simply a site included or referenced in such a way that it can be reused.

If you create a piece of a site, for example a questionaire form, that you'd like to use in many sites, then think about creating this behaviour in an addon.

More