Blogging

Blogging is right at the core of Innota.

Blogs in Innota have these basic building blocks:

  • Posts
  • Post index pages
  • Tag index pages

Creating Posts

Simply start by logging in the admin console and click on Add post. Or if you're already logged in, you can just go to your site and click Add post in the Innota toolbar at the bottom of the page.

All blog posts in Innota have some common elements. Here's a list of the elements:

  • Title (required)
  • Subtitle
  • Header image
  • Content
  • Date
  • Template
  • Url (required)
  • Tags
  • Draft

Only title and url (or the filename) are required. Here's a more detailed explanation of the elements.

Title

This is the post title. While this is a required element, you don't actually have to use the title anywhere if you don't want to. For instance, if you want to create a blog for very short status updates, you could create a theme that never displays the title, only the content.

The title is available in templates as page.title.

Subtitle

This is a simple subtitle that's shown next to the main title in some themes. Subtitle can be accessed in templates as page.subtitle.

Header Image

Header image should be the main image of your blog post. This is the one to use if you want to set an image that sets the mood for your post. Or if you're creating a photo blog where you post one image per post using header image for the image is probably the best optin.

You can get the header image filename in templates using page.image. Notice that this only gives you the relative filename. If you want the full url to the image, you have to use image function like this.

{{ image(page.image) }}

This will create the absolute url to the image.

Content

This is the main content of your post written in Markdown.

Date

This is the publish date for your post. You can access the date in templates as page.date.

Notice

If you set the date in the future, Innota will not automatically publish your post at that time. You have to login and publish yourself.

Template

This is the template for this post. You can have different templates for different kinds of posts.

For instance, you might have a default template for regular blog posts and another template for posts about new products your company is making. Using different templates is possible to make the different types of posts look totally different.

Url (or filename)

This is the url of the post. Notice that the url field does not include your site name or the date, it's just the filename part of the url. When you type in a title for your post, the url is automatically filled with a default filename.

You can access the filename in templates as page.filename. To create the full url to a post, use the url function like this:

{{ url(page.filename) }}

This will cerate the absolute url to your post. If you're creating links to other pages inside your markdown content, it's easier to use the markdown syntax to create links.

Tags

Tags are a way to categorise your blog posts. You can ad as many as you like and separate the tags with a comma. You can get the tags in templates using page.tags.

Draft

You can mark a post as draft. Drafts are never published but they are visible when you're previewing your site.

Listing All Posts

Innota doesn't automatically create a list of your blog posts. You need to create a page for that.

To create an index page for your blog, just add a new page and select Post list as the page type. This will create an index of all of your blog posts. All the default attributes are available as for any type of page.

If you want your blog to show up at http://yoursite.innota.me/blog this is the place to change that. Just type in blog as the page url.

You need a special template for an index page to display correctly and paginate your posts correctly. Your theme probably already has a template for post lists, select that as the page template.

Refer to the template section of the documentation for more info about creating a template for post lists.

Listing All Tags

You need to create a page to list all posts tagged with a certain tag. Create a new page, and set the page type to Tag list.

This will create a paginated page of all the posts tagged with a certain tag. You should use a special template to list all the post, but you might be able to use the same template as you did to list all posts.

Refer to the template section of the documentation for more info about creating a template for post lists.


Updated at 2018/11/21