Rewrite the Comanche section in the documentation
@
Der Pepe (Hubzilla) ⁂ Could you please rewrite the Comanche section? I see following two problems: (1) template names are not mentioned explicitly, we have delusive headers "Standard template" and "Full template" instead. We should get rid of these delusive headers and put the template names instead. Pay attention to keep these names unchanged in the translations of the documentation. (2) This chapter is not divided well into its parts. We should divide them well into subchapters. Here's my suggestion, where I implemented the subchapters as h3 headers. From "Navbar" on, it can remain unchanged. Attached is a text file with the raw bbcode.
Page templates
There are currently five layout templates, unless your website offers additional layouts. The template names are
default,
full,
choklet,
redable and
zen. To select a template for your custom layout, use the ‘template’ tag in the first line of your layout, i.e.
[template]full[/template]. The default template is used if no other template is specified.
default
The default template defines a ‘nav’ area at the top, ‘aside’ as a sidebar with a fixed width, ‘content’ for the main content area and ‘footer’ for a page footer.
full
The full template corresponds to the default template except that there is no ‘aside’ area.
choklet
The Choklet template offers six different flavours of layout styles. I.e., to select the template ‘choklet’ with the flavour ‘three’, use
[template=three]choklet[/template].
- (default flavour) - a two-column layout similar to the default template, but more flexible
-
bannertwo - a two-column layout with a banner area, compatible with the default template on small displays -
three - three-column layout (adds a ‘right_aside’ area to the standard template) -
edgestwo - two-column layout with fixed margins -
edgesthree - three-column layout with fixed margins -
full - three-column layout with fixed margins and the addition of a ‘header’ area below the navigation bar
redable
A template for reading longer texts in full screen mode (i.e. without a navigation bar). Three columns: aside, content and right_aside. For maximum readability, it is advisable to use only the middle content column.
zen
Gives you the freedom to do everything yourself. It is just a blank page with a content area.
Regions
Use ‘region’ tags in your custom layout to decide what content should be placed in which regions. Three ‘macros’ have been defined for your use.
$htmlhead places the site head content into your layout.
$nav places the site navigation bar content into your layout.
$content places the content which is defined in the page created under /webpages//
By default,
$navis inserted into the ‘nav’ page area and
$contentinto the ‘content’ area. You only need to use these macros if you want to change the order of the elements or move them to other areas.
Themes
To select a theme for your page, use the ‘theme’ tag.
[theme]suckerberg[/theme]This selects the theme ‘suckerberg’. By default, the theme preferred by your channel is used.
[theme=passion]suckerberg[/theme]This selects the theme named ‘suckerberg’ and chooses the ‘passion’ scheme (theme variant). Alternatively, it is also possible to use compressed theme notation.
[theme]suckerberg:passion[/theme]The compressed notation is not part of Comanche itself, but it is recognised by the Hubzilla platform as a theme specifier.
Fill your custom page template with content
Navbar
...
Like Us
Support Hubzilla
