This is a clean blogging theme adapted from https://github.com/StartBootstrap/startbootstrap-clean-blog.

Installation

Statiq themes go in a theme folder alongside your input folder. If your site is inside a git repository, you can add the theme as a git submodule:

git submodule add https://github.com/statiqdev/CleanBlog.git theme

Alternatively you can clone the theme directly:

git clone https://github.com/statiqdev/CleanBlog.git theme

Once inside the theme folder, Statiq will automatically recognize the theme. If you want to tweak the theme you can edit files directly in the theme folder or copy them to your input folder and edit them there.

Settings

Global

These can be set in a settings file.

SiteTitle: The title of the site.
Description: A description of the site.
PostSources: A globbing pattern where to find blog posts (defaults to posts/*).

Calculated

The following keys are calculated in settings.yml and can be overridden by providing new values in your settings or front matter or used from your own pages.

PageTitle: The title that's set for the current page and shown in the browser (by default this is "[Site Title] - [Document Title]").
IsPost: Set to true if the current document is a blog post, which can be helpful to control conditional styling or layout content.

Partials

Replace or copy any of these Razor partials in your input folder to override sections of the site:

/_head.cshtml: Additional content for the <head> tag.
/_navigation.cshtml: The navigation at the top of the layout.
/_navbar.cshtml: The navigation bar at the top of the page.
/_header.cshtml: The header section of the page.
/_posts.cshtml: Displays a set of posts stored in the children of a document passed as the partial model data.
/_post.cshtml: Displays an individual post inside a list of posts.
/_post-footer.cshtml: Displays content at the bottom of a post (for example, a comments section).
/_sidebar.cshtml: Additional content for the sidebar on the main index page (ignored if you provide your own index page).
/_footer.cshtml: The footer at the bottom of all pages.
/_scripts.cshtml: Additional scripts or other content at the bottom of the page.

Sections

In addition to globally changing sections of the site using the partials above you can also add the following Razor sections to any given page to override them for that page (which will typically disable the use of the corresponding partial):

Head: Additional content for the <head> tag (this section is additive with the content in the _head.cshtml partial).
Navigation: The navigation at the top of the layout.
Header: The header section of the page.
Footer: The footer section of the page.
Scripts: Additional scripts or other content at the bottom of the page.

Index Page

You can provide your own index.cshtml (or index.md) if you like and that will override the default index page. You'll have to provide your own index page if you don't include any blog posts since the default index page is an archive of posts.

Styles

To add new styles or override existing ones, create an input file at scss/_overrides.scss and add Sass styles there.

Porting From Wyam

This blogging these is roughly compatible with the Wyam CleanBlog theme. Some notes if you're porting:

You will need to create a Statiq Web app at the root of your site (you can keep the input directory).
- Run dotnet new console at the root of your site.
- Run dotnet add package Statiq.Web --version x.y.z (using the latest Statiq Web version).
- Change the generated Program class in Program.cs to:

using System;
using System.Threading.Tasks;
using Statiq.App;
using Statiq.Web;

namespace ...
{
  public class Program
  {
    public static async Task<int> Main(string[] args) =>
      await Bootstrapper
        .Factory
        .CreateWeb(args)
        .RunAsync();
  }
}

Follow the installation instructions above to install the theme into your site.
Create a settings.yml file at the root of your site and copy over settings from your config.wyam file
- Since the new settings file is YAML you don't need to prefix strings or anything, for example Settings[Keys.Host] = "daveaglick.com"; becomes Host: daveaglick.com.
- If you defined a global "Title" setting in config.wyam the new theme should set "SiteTitle" instead (and if not, a "SiteTitle" should be defined).
- If you defined an "Intro" setting, that should be placed in a new _index.yml file in your input directory with a key of "Description".
If you created an input/assets/css/override.css file, move it to input/scss/_overrides.scss (and you can now use Sass inside the CSS overrides file).
Replace any uses of img-response CSS class with img-fluid since this theme uses a newer version of Bootstrap and that CSS class changed.
Rename and fix up any override theme files or partials according to the supported ones documented above.
- For example, the old Wyam CleanBlog supported a _PostFooter.cshtml which should be renamed to _post-footer.cshtml.
- The CSS may not match exactly since the new CleanBlog theme is based on the most recent CleanBlog project so you may need to take a look at the default partial implementations in this theme and adjust your override files accordingly.
You can likely remove any build scripting and bootstrapping code since you can now run dotnet run -- preview to preview the site.
- You can also now setup built-in deployment.

gep13 / CleanBlog