Found a mistake? Please contact me.

  • Some big changes for this site: teams and plug-ins

    On 06 May 2020 Manton announced Micro.blog for teams: multi-user blogs, so your whole team can write posts on a shared blog.

    And now, Custom.micro.blog, has been upgraded. So, here's an open invite to anyone who feels they can contribute, to contact me at miraz@firstbite.co.nz .

    Also, on 07 July 2020 Manton announced plug-ins for Micro.blog:

    a plug-ins system for Micro.blog that formalizes a lot of the power of Micro.blog themes, but wrapped in a package that is easier to develop and install. Instead of creating a custom theme for your blog and editing the templates yourself, you might be able to find a plug-in that will add the feature. Unlike custom themes, there can also be multiple plug-ins installed for a single blog.

    Since plug-ins are directly relevant to customising a blog I'm hoping to make this site a resource centre for plug-ins and plug-in developers.

    I'm also always looking for more folks to contribute tutorials, how-tos or just links to helpful resources.

    Let's pool our knowledge and make a fabulous resource for anyone wanting to tinker with their Micro.Blog.

    I also need to thank Manton for his generosity in making this site free! 😀

  • Link: Plug-ins for Micro.Blog

    BIG news today — Plug-ins for Micro.Blog:

    Instead of creating a custom theme for your blog and editing the templates yourself, you might be able to find a plug-in that will add the feature. Unlike custom themes, there can also be multiple plug-ins installed for a single blog.

  • Link: Redesigned theme editor for Micro.blog

    Redesigned theme editor for Micro.blog
    MAY 19, 2020

    I’ve redesigned the theme text editor in Micro.blog, adding a preview pane and other improvements. It now features a split view with the template on the left and your web site on the right.

    Source: Manton Reece - Redesigned theme editor for Micro.blog.

  • Link: Custom 404 page

    Some themes include a custom “404 not found” page when a visitor to your blog tries to request a page that is no longer on the web, or if they mistype a URL. You can override this page in 2 different ways:

    • The easiest way is to create a new Micro.blog page under Posts → Pages. For the title, type “404” and save the page. Micro.blog will notice that special title and automatically set up the page filename to be /404.html. You can later edit the title or text content to anything you want.
    • If you need more control, use a custom Micro.blog theme to add a new template in layouts/404.html. This can use any Hugo includes to show headers, footers, or handle other logic.

    When neither of these pages are found, Micro.blog will return a basic “Not Found” page.

    Source: Custom 404 page - Micro.blog Help.

  • Link: Help page for Teams includes theme tips

    I’ve added a help page for teams in Micro.blog. Includes details on the Hugo parameters for adding author names to custom themes.

    Source: Manton Reece.

    Extract from the help page for teams:

    The Marfa design has a place in the footer of each post that shows the author of that post. Other custom themes may need modifications if you want to include author information.

    The Marfa design has a place in the footer of each post that shows the author of that post. Other custom themes may need modifications if you want to include author information. …

    If the blog is not a team blog, these parameters will be blank. You can check whether the author is available, and then fall back on the blog’s default author …

  • List posts chronological within a day

    From Jason Becker json on Slack (07 April 2020):

    … here’s a template snippet from my layouts/index.html that will allow your posts to be listed in reverse chronological order by day, but within a day be in chronological order. Which I quite like.

    {{ $posts := where site.RegularPages “Type” “post” }}
    {{ $grouped := $posts.GroupByDate “2006-01-02” }}
    {{ $paginated := (.Paginate ($grouped)) }}
    ​
    {{ range $paginated.PageGroups }}
    {{ $thedate := (time .Key) }}
    <h1> {{ $thedate.Format “January 02” }}</h1>
      {{ range .Pages.Reverse }}
        {{ if eq .Type “post” }}
          {{ .Render “summary”}}
        {{- end }}
      {{ end }}
    {{ end }}
    

  • Link: Excluding posts from the timeline

    We can leverage categories to build this feature of picking which posts should appear in the timeline.

    Source: Manton Reece - Excluding posts from the timeline.

List of Tutorials.

⌘ This site and tutorials before July 2020 were created by Miraz Jordan. ⌘