hugo-oblate-theme — Hugo Blog Template

SHA-256: cd175352627687a2e88574f9c062dd908ecd865990ec7ed9c1a3f35de45573d4

2026-10-02T17:16:34.850Z

[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)

# Oblate Theme

Oblate theme for hugo is a minimalistic theme for bloggers based on the theme of the same-named Oblate from [Tania Rascia](//github.com/taniarascia). Noteworthy features of this Hugo theme are the support for RSS feeds, syntax highlighting for source code.

![Screenshot](/images/screenshot.png)

## Installation

Inside the folder of your Hugo site, run:

```bash
$ cd themes
$ git clone https://github.com/zapatran/hugo-oblate-theme
```

or also you can add it as a submodule

```bash
$ git submodule add https://github.com/zapatran/hugo-oblate-theme themes/hugo-oblate-theme
```

For more information, please read Hugo's official [setup guide](//gohugo.io/overview/installing/).

### The config file

Take a look inside the [`exampleSite`](//github.com/zapatran/hugo-oblate-theme/tree/master/exampleSite) folder of this theme. You'll find a file called [`config.toml`](//github.com/zapatran/hugo-oblate-theme/blob/dev/exampleSite/config.toml).

To use it, copy the [`config.toml`](//github.com/zapatran/hugo-oblate-theme/blob/dev/exampleSite/config.toml) file to the root folder of your Hugo site. Feel free to change the strings as you like to customize your website.

Make sure to update the `themesDir` property in the config file to point to your site's theme folder, otherwise an error will be thrown indicating the themes folder is unable to be found.

## About page

Use the about page to introduce yourself to your visitors. You can customize the content as you like in the [`about.md`](https://github.com/zapatran/hugo-oblate-theme/tree/master/exampleSite/content).

## Pages

You can create others pages using

```bash
$ hugo new --kind page <new-page>.md
```

## Posts

In order to generate new entry

```bash
$ hugo new  post/<new-entry>.md
```

## Projects

You can add your own projects creating a file `projects.json` with the following structure:

```json
[
  {
    "name": "name of your project",
    "emoji": "🖍",
    "description": "Description of your project",
    "project": "https://zapatran.dev",
    "source": "https://github.com/zapatran/hugo-oblate-theme"
  }
]
```

## Shortcodes

There are threes kind of shortcodes `alerts` y `filename headers` and `mermaid`

### Alerts

types of alerts `alert`, `info`, `note`, `details`, `success` in order to place an alert you need to 

```go
{{< blockquote <type> />}}
this is my alert
{{< /blockquote }}
```
example
{{< blockquote alert />}}
remember not no commit node_modules
{{< /blockquote }}

### Filenames headers

Now you can add filename headers in a block code

{{< filename "main.js" />}}
```javascript
console.log('Welcome to the party pal!')
```

### Mermaid

check the [official documentation](https://mermaidjs.github.io)

```go
{{<mermaid>}}
sequenceDiagram
    participant Alice
    participant Bob
    Alice->>John: Hello John, how are you?
    loop Healthcheck
        John->John: Fight against hypochondria
    end
    Note right of John: Rational thoughts <br/>prevail...
    John-->Alice: Great!
    John->Bob: How about you?
    Bob-->John: Jolly good!
{{< /mermaid >}}
```

## Disqus

This theme features a comment system powered by Disqus too. Just add your Disqus-shortname to the [`config.toml`](//github.com/zapatran/hugo-oblate-theme/blob/dev/exampleSite/config.toml) and let readers respond to your blog posts.

## Emojicon

This theme also add support to [emojicon](https://emojicom.io). Just add your key to [`config.toml`](//github.com/zapatran/hugo-oblate-theme/blob/dev/exampleSite/config.toml) and get feedback from your visitors 😃.

## Social link icons

You can add a social link panel in the navbar by adding entries to the `social` block in the [`config.toml`](//github.com/zapatran/hugo-oblate-theme/blob/dev/exampleSite/config.toml). the theme is using the icon fonts [Font awesome](https://fortawesome.github.io/Font-Awesome/)

## Almost done

To see your site in action, run Hugo's built-in local server.

    $ hugo server

Now enter [`localhost:1313`](http://localhost:1313) in the address bar of your browser.

## Contributing

Found a bug or got an idea for a new feature? Feel free to use the [issue tracker](https://github.com/zapatran/hugo-oblate-theme/issues) to let me know. Or directly make a [pull request](https://github.com/zapatran/hugo-oblate-theme/pulls).

Please create a separate branch for your pull request.

## License

This theme is released under the MIT license. For more information read the [license](https://github.com/zapatran/hugo-oblate-theme/blob/master/LICENSE).

## Acknowledgements

Thanks to

- [Tania Rascia](//github.com/taniarascia) for creating the original theme