This theme is a mix between hello-friend-ng and the original hello-friend. Considering both have features I like and lack others, I've decided to roll up my sleeves and tweak it a bit. The biggest change is most likely FontAwesome bundling or loading your own kits if you want.

You can see it in action here: https://blog.coolapso.sh

• Features
• How to start
• How to configure
• More
  • Built in shortcodes
    • image
  • Code highlighting
  • Favicon
  • Audio Support
• Social Icons
• Hide Title and Language on single pages
• Known issues
• How to edit the theme
• Changelog
• Sponsoring
• Licence

• Theming: dark/light mode, depending on your system preferences or the users choice
• Great reading experience thanks to Inter font, made by Rasmus Andersson
• Nice code highlighting thanks to PrismJS
• An easy way to modify the theme with Hugo tooling
• Fully responsive
• Audio support for posts (thanks to @talbotp)
• Support for Commento

• fontawesome
  • Choose which fonts you want to load
  • Load your own fontawesome kit
• Support for social icons
  • Social Icons can be either in the footer or in the main content area just like the original
  • Support for sharing buttons (Depends on FontAwesome)
• Support for latest posts on front page
• Support for submenus
• Builtin (enable/disable) multilanguage menu
  • Shows Language flags
  • Menu will show alternative languages instead of current language
  • When only 2 languages available no sub-menu will be displayed, it will switch between them instead
• Optional overlay that darkens a bit the Background
• Option to choose between read more in text instead of a button
• Page title can be different than site title
• Option to hide page title in single pages
• Option to hide language selection in Single pages

You can download the theme manually by going to https://github.com/oleksii-khalikov/hugo-theme-hello-gfalcon.git and pasting it to themes/hello-gfalcon in your root directory.

You can also clone it directly to your Hugo folder:

$ git clone https://github.com/oleksii-khalikov/hugo-theme-hello-gfalcon.git themes/hello-gfalcon

If you don't want to make any radical changes, it's the best option, because you can get new updates when they are available. To do so, include it as a git submodule:

$ git submodule add https://github.com/oleksii-khalikov/hugo-theme-hello-gfalcon.git themes/hello-gfalcon
$ git submodule add -b master-coolapso https://github.com/oleksii-khalikov/hugo-theme-hello-gfalcon.git themes/hello-4s3ti

The theme doesn't require any advanced configuration. Just copy the following config file. To see all possible configurations, check the docs.

Note: There are more options to configure. Take a look into the config.toml and config.yaml in exampleSite directory.

baseurl      = "localhost"
title        = "My Blog"
languageCode = "en-us"
theme        = "hello-gfalcon"
paginate     = 10

[params]
  dateform        = "Jan 2, 2006"
  dateformShort   = "Jan 2"
  dateformNum     = "2006-01-02"
  dateformNumTime = "2006-01-02 15:04"

  # Subtitle for home
  homeSubtitle = "A simple and beautiful blog"

  # Set disableReadOtherPosts to true in order to hide the links to other posts.
  disableReadOtherPosts = false

  # Enable sharing buttons, if you like
  enableSharingButtons = true

  # Metadata mostly used in document's head
  description = "My new homepage or blog"
  keywords = "homepage, blog"
  images = [""]

[taxonomies]
    category = "blog"
    tag      = "tags"
    series   = "series"

[languages]
  [languages.en]
    title = "Hello Friend NG"
    subtitle = "A simple theme for Hugo"
    keywords = ""
    copyright = '<a href="https://creativecommons.org/licenses/by-nc/4.0/" target="_blank" rel="noopener">CC BY-NC 4.0</a>'
    readOtherPosts = "Read other posts"

    [languages.en.params.logo]
      logoText = "hello friend ng"
      logoHomeLink = "/"
    # or
    #
    # path = "/img/your-example-logo.svg"
    # alt = "Your example logo alt text"

  # And you can even create generic menu
  [[menu.main]]
    identifier = "blog"
    name       = "Blog"
    url        = "/posts"

Of course you are able to use all default shortcodes from hugo (https://gohugo.io/content-management/shortcodes/).

Properties:

• src (required)
• alt (optional)
• position (optional, default: left, options: [left, center, right])
• style

Example:

{{< image src="/img/hello.png" alt="Hello Friend" position="center" style="border-radius: 8px;" >}}

By default the theme is using PrismJS to color your code syntax. All you need to do is to wrap you code like this:

``` html
  // your code here
```

Check the docs.

You wrote an article and recorded it? Or do you have a special music that you would like to put on a certain article? Then you can do this now without further ado.

In your article add to your front matters part:

audio: path/to/file.mp3

Font awesome can be configured and you can load all fonts or only the fonts you wish.

To load all fonts:

fontAwesome:
    all: true

to load only specific fonts:

  fontAwesome: 
    brands: true
    solid: true
    regular: true

fontawesome kits

• Go to FontAwesome
• Create an account
• Go to kits, create new kit
• Add the Kit Link to your config

fontAwesome:
    kitURL: "https://kit.fontawesome.com/yourkitid.js"

A large variety of social icons are available and can be configured like this:

[[params.social]]
  name = "<site>"
  url = "<profile_URL>"

If the icon is not available or you wish to use another icon, you can also override the icon by specifying the Icon value.

[[params.social]]
  name = "<site>"
  url = "<profile_URL>"
  icon = "<Icon>"

+++
Title = "Ferramentas"
hideTitle = true
hidelanguage = true
+++

Just edit it. You don't need any node stuff. ;)

If you like this fork and think it is worth your support, you can always ...

However, please consider doing it to the guys that did most of the hard work, I only moved some bits of code here and there

djodjeatlialp	panr

The theme is released under the MIT License. Check the original theme license for additional licensing information.