Skip to content

rafed/BlogRa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BlogRa

The Ultimate Tech Blogging Theme

thumbnail

Demo

You can see live demo of this theme for my blog at rafed.github.io/devra.

Features

Site features

  • Google search bar
  • Google Analytics (v4)
  • Share bar below articles for sharing across social media
  • Social links place holder for linking with different social media
  • Comments with Disqus
  • Customizable navbar
  • Mobile responsive- works great across desktops, tablets and mobiles
  • SEO friendly (Opengraph, Twitter cards)
  • Admin panel to see site summary (number of posts, tags, sections)

Blogging features

  • Attractive landing page with article/tag links everywhere
  • Add featured images to posts
  • Making sections for related articles (for example tutorials on a topic)
  • Add code snippets
  • Add math equations
  • Add diagrams with mermaid
  • Add tags to articles and list articles by tags

Installation & Update

You will need to download Hugo extended versions to build your site with this theme. Search and download it from the releases page.

$ # create directory for the blog
$ mkdir site & cd site
$ 
$ git submodule add https://github.com/rafed/BlogRa.git themes/BlogRa
$ echo "theme = 'BlogRa'" >> config.toml

To get updated theme run

$ git submodule update --remote --merge

If you want to know more information, see Hugo doc.

config.toml example

baseURL = "https://example.com/"
canonifyURLs=true
pluralizeListTitles = false
summaryLength   = 25

theme           = "BlogRa"
languageCode    = "en-us"
title           = "BlogRa Theme"

disqusShortname = ""

[params]
    description     = "The Ultimate Tech Blogging Theme"
    contactEmail    = "your-email@domain.com"
    footer          = ""
    googleSearch    = "google-cse-key"
    googleAnalytics = "G-A1B2C3D4E5" # v4
    adsense         = "adsense-key"
    math            = false   # best to enable this in the front matter of a page
    mermaid         = false   # best to enable this in the front matter of a page

    # Social Media Params
    facebook   = "https://www.facebook.com/DevHacker-2351204168278028"
    twitter    = "https://x.com/rafedyasir"
    youtube    = "https://www.youtube.com/channel/UC6uDg4IlPbLh2xNKrqnBczw"
    instagram  = "https://www.instagram.com/rafedyasir/"
    github     = "https://github.com/rafed"
    pinterest  = ""
    linkedin   = "https://www.linkedin.com/in/rafed-m-yasir/"


# Configure the site menu here
[menu]
    [[menu.main]]
        name = "Home"
        url = "/"
        weight = 1

    [[menu.main]]
        identifier = "blog"
        name = "Blog"
        weight = 2
            [[menu.main]]
                parent = "blog"
                name = "Posts"
                url = "/posts/"
                weight = 1
            [[menu.main]]
                parent = "blog"
                name = "Sections"
                url = "/sections/"
                weight = 2
            [[menu.main]]
                parent = "blog"
                name = "divider"
                weight = 3
            [[menu.main]]
                parent = "blog"
                name = "Tags"
                url = "/tags/"
                weight = 4
    [[menu.main]]
        name = "About"
        url = "/about/"
        weight = 3
    [[menu.main]]
        name = "Contact"
        url = "/contact/"
        weight = 4

# Don't touch this
[markup.goldmark.renderer]
    unsafe = true

Frontmatter example

---
title: {{ replace .Name "-" " " | title }}
date: {{ now.Format "2006-01-2" }}
tags: [tag1, tag2]
image: "blog-pic.png"
description: "A smalll optional description"
math: true              # to enable showing equations (katex)
mermaid: true           # to add diagrams using mermaid
---

Contributing

If you find problems in the theme submit an issue. Also, contributions/pull requests are welcome.

LICENSE

GPL.