/hugo-oblate-theme

Oblate theme for hugo is a minimalistic theme for bloggers based on the theme of the same-named Oblate from Tania Rascia - https://www.taniarascia.com

Primary LanguageSCSSMIT LicenseMIT

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. Noteworthy features of this Hugo theme are the support for RSS feeds, syntax highlighting for source code.

Screenshot

Installation

Inside the folder of your Hugo site, run:

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

or also you can add it as a submodule

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

For more information, please read Hugo's official setup guide.

The config file

Take a look inside the exampleSite folder of this theme. You'll find a file called config.toml.

To use it, copy the 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.

Pages

You can create others pages using

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

Posts

In order to generate new entry

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

Projects

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

[
  {
    "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

{{< 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" />}}

console.log('Welcome to the party pal!')

Mermaid

check the official documentation

{{<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 and let readers respond to your blog posts.

Emojicon

This theme also add support to emojicon. Just add your key to 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. the theme is using the icon fonts Font awesome

Almost done

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

$ hugo server

Now enter 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 to let me know. Or directly make a pull request.

Please create a separate branch for your pull request.

License

This theme is released under the MIT license. For more information read the license.

Acknowledgements

Thanks to