Skip to content

4. Designing a theme

Jump to bottom
Mark Downie edited this page Feb 10, 2020 · 24 revisions

DasBlog Core uses a templating system based on the Razor Engine to define the layouts of each theme. Each unique theme is contained in a folder in the Themes folder, to select a given Theme update Theme element in the Site Admin page.

To create a new theme create a new folder with the following elements:

  • _Layout.cshtml - Top level template for all views in the theme
  • _BlogItem.cshtml - Layout of an individual blog post
  • _BlogPage.cshtml - Layout of the blog home page (allows multiple posts to be listed)
  • custom.css (optional) - Used to apply additional transformation to override the default site CSS.

alt text

The number of posts you can view on the home page is defined by the Front Page Entry Count in admin/settings.

Modifying the look of the home page

Optionally if you want a differing design aesthetic for the home page you might also consider enabling the Show item Summary in aggregated views in admin/settings. This enables the following layout on the home page:

  • _Layout.cshtml - Top level template for all views in the theme
  • _BlogItemSummary.cshtml - Layout of an individual summary blog post
  • _BlogPageSummary.cshtml - Layout of the blog home page in the Summary format

alt text

Note: All supporting Views (outside the Themes folder) assume the use of bootstrap, this may not work for everyone. If you need to override any other Views (e.g. category, archive) they can be copied into your Themes folder and modified as necessary. DasBlog Core will always check your Themes folder first for Views to use.

Additional questions?

If you have additional questions or concerns please submit an issue.

Clone this wiki locally