Content files
The content files contain the information to be displayed on the web pages. A content file corresponds to a web page, however, the creation of the page requires some other components, at least a document and a layout file.
The content files can be markdown or HTML files. The markdown files are simple
text files that use easy to remember markups to generate HTML formatted content
from the text file. For details see Markdown syntax. According to that the
content files can have .md and .html extensions. The content files take
place in a /contents
directory. The location of the directory can be set in
the configuration.
The root directory of the contents do not contain content files!
The subdirectories of the root content directory define the languages the engine
support. If there are more language
directories, the navigation bar displays a
dropdown menu to select the current language. The default language can be set in
the configuration. The language
directories can also have subdirectories,
that can appear as dropdown menus in the navigation bar.
/contents
/language-A
content-1.md
content-2.md
/subdir-a
content-3.md
...
/language-B
content-4.md
content-5.md
/subdir-b
content-6.md
...
Usually some additional information is also required to compose a web page. These information called metadata have to be placed at the beginning of the content files. The format and the properties of metadata are detailed on the Content metadata page.
Tokens
The content files can contain other components. For details see the Components
page. The places of the components are marked with the name of the component
surrounded by double braces and optional spaces ({{ name }}
) - these are
called tokens. The following table lists the types of the tokens:
Markup | Token type | For more information click |
---|---|---|
{{ name }} | segment, document or layout | Segment files, Document files, Layout files |
{{ =name }} | static segment | Segment files |
{{ #name }} | control | Controls |
{{ .name }} | context data | Actions |