Source code for my blog at https://quantonganh.com

My passion for sharing knowledge led me to create my blog from the ground up. Writing about my experiences and discoveries in the world of programming became my integral part of my learning process. This journey has not only deepened my understanding of programming but also enabled me to contribute to the broader community by offering insights, solutions and inspiration. Remember, knowledge is a torch; the more you share it, the brighter it shines for others to follow.

Blog

This service serves as the backbone in a microservices architecture, collaborating with various components:

• Content repository: https://github.com/quantonganh/blog-posts
• Email newsletter: https://github.com/quantonganh/mailbus
• Comment system: https://github.com/quantonganh/talkie

API Design

• POST /webhook: handle incoming webhook events. It decodes the header, performs git pull, and triggers the content reload.
• GET /{year}/{month}/{day}/{postTitle}: get blog posts by year, month, day or specific one.
• GET /categories/{name}: get blog posts by specific category.
• GET /tags: list all tags and the number of blog posts for each tag.
• GET /tags/{name}: get blog posts by specific tag.
• GET /search?q={keywords}: search blog posts by keywords
• GET /archives: archived posts

Data Structure

type Post struct {
    ID          int
    URI         string
    Title       string
    Date        publishDate
    Description string
    Images      []string
    Content     template.HTML
    Summary     template.HTML
    Truncated   bool
    Categories  []string
    Tags        []string
    HasPrev     bool
    HasNext     bool
}

High-level Design

graph TD
    u((User)) --> lb(Load Balancer)
    lb --> b(blog)
    b -->|GET /search| s(search)
    s -->|Read| bp[(blog-posts)]
    b -->|POST /subscriptions| mb(mailbus)
    mb -->|Write| db1[(Database)]
    b -->|POST /comments| tk(talkie)
    tk -->|Write| db2[(Database)]

Sequence Diagram

sequenceDiagram
    Owner ->> blog-posts: Add new Markdown files
    blog-posts ->> blog: POST /webhook
    blog ->> blog-posts: Fetch updated content
    blog ->> blog: Parse and render content
    blog ->> blog: Update search index

• Install:

$ go get -v github.com/quantonganh/blog/cmd/blog

• Create a root directory for your blog:

$ mkdir -p some/dir

• Copy the HTML templates, assets:

$ cp -r /path/to/blog/http/html/templates some/dir/
$ cp -r /path/to/blog/http/assets some/dir/

• Create a config.yaml file in some/dir:

templates:
  dir: templates

• Create your first blog post test.md in some/dir/posts:

---
title: Test
date: Thu Sep 19 21:48:39 +07 2019
description: Just a test
tags:
  - test
---
Test.

• Run:

$ cd some/dir
$ /path/to/gopath/bin/blog

Then open a browser and access your blog at http://localhost.