Writing articles and pages

    The core of a blog is writing content. You can have access to a content writing interface by logging into the Admin panel and either :

    • Clicking on the New button on the topbar
    • Going into the Content admin panen and clicking on New content.

    Here, you'll be able to write your content using markdown, and adding some interesting stuff. Then when you click on publish, your article will be published and available. Tada ! By default, Koblog uses EasyMDE as its content editor; you can use choose alternatives in the plugin section. How to change the editor.

    You can add emojis to your post via the emoji picker next to the Images button.

    Article fields

    Koblog have a lot of fields you can edit, here are what they're for :

    • Category : The main classification of an article. You can add categories inside the Category admin panel
    • Tags : Another way of classifying articles. A same article can have several tags
    • Content kind : They're the type of content the page is for. An article ? Litterature ? It allow themes to show them differently
    • Description : A short description of an article. It'll be used in metadata and inside the opengraph tags of the articles.
    • Source Link : Show your source ! Usefull when you want to link to the origin of something you're writing about.
    • Cover image : The thumbnail of your article ! You can add them in the same way that you can add images
    • Content Warning : If your theme support it, it'll hide the article in the main feed, and show a warning before it.
    • Author comment : If your theme support it, show an additionnal content for your article. Usefull to say some meta stuff, or for art blogs.
    • Date : The date of the article. Default to the current date. Put in the future to schedule a post.
    • Type : If your post is an article, a static or a sticky page.
    • Position : The position of your article, if it's a static page or that your site doesn't sort your articles chronologically
    • Parent : If your post have a parent. Usefull to create folders.
    • Template : If you want to use a specific template. Usefull mostly in some themes.
    • External cover image : If you want to use a CDN or some server dedicated for images.
    • Author : Who is writing the article.
    • Friendly URL : URL associated with the content.
    • Robots : Some settings for robots to avoid indexing or caching a page.

    Adding images

    You can upload an image, and then insert it into the content of the page.

    1. Click on the Images button.
    2. Click on the Browser button.
    3. Select the image from your computer.
    4. After the image is uploaded, click on the Insert button to add the image to your page content.

    Using the global media manager

    Sometimes you need images on several articles. For that, you can use the Media system, which are global to every articles

    1. Click on the Media tab in the sidebar.
    2. Click on "New media"
    3. Add a title, an alt text to your new media
    4. Click on the Browser button.
    5. Select the image from your computer.
    6. Go on the article where you want to upload your image
    7. Do as usual on the previous tutorial, but on the "Global" tab inside the Images popover.

    Schedule the post

    You can prepare a page and schedule it to be published on your website at future different date and time. The users can't access the page until the publish date and you can modify the publish date by editing the page.

    To schedule a post for publication:

    1. Create a new page, click on New content on the left sidebar.
    2. Click on the Options button.
    3. Click on the Advanced tab.
    4. Choose the date and time you want the page to be published.
    5. Complete the page, such as title, and content.
    6. Click the Publish button.
    7. You can see your scheduled content in Content > Scheduled

    Add a read more link

    You can split the content of the page into two parts. The first part will be visible on the homepage with a Read more button. For that, you can add the tag <!-- pagebreak -->. This feature is handled by theme you have installed, and not all Koblog themes will support it.

    This is the first part of the content of the page.

<!-- pagebreak -->

This is the second part of the page.