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.