nunocoracao/blowfish

Personal Website & Blog Theme for Hugo

Hi there 👋

• 🐳 Principal Product Manager @ Docker
• 🐡 Creator and maintainer of Blowfish @ Blowfish page
• 🚀 Personal blog - n9o.xyz
• 📚 mentoring @ mentorcruise

blowfish's Issues

Table of Contents on Mobile should be a dropdown

Is your feature request related to a problem? Please describe.
Table of Contents on mobile take up a huge amount of space and ruin the UX of the page. This is especially true with large TOC.

Describe the solution you'd like
Table of content's should be a dropdown on mobile

Describe alternatives you've considered
n/a

Additional context
n/a

Fix see more link in recent articles

Fix see more link in recent articles

"\:secret\:" is substituted inside markdown code section

Describe the bug

I'm using the following yaml code block in my post, but the :secret: is replaced by some icon:

Resource:
- "arn:aws:secretsmanager:*:*:secret:*"

Rendered output by the Hugo + Blowfish:

Expected behavior

Whatever is written inside markdown code pattern ("```") should never be replaced.

Fix article shortcode link

Describe the bug

Fix article shortcode link

[issue build] fatal: could not read from remote repository.

Hi there,
couple of days ago, I use this wonderful theme installed using hugo module, and it works fine. I finished my website and had it deployed on GitHub Pages. Today when I try to update some content and run the command hugo server to see the changes, but it reports an error:

hugo: downloading modules …
go: github.com/nunocoracao/[email protected]: reading github.com/nunocoracao/blowfish/go.mod at revision v1.1.1: git ls-remote -q origin in /var/folders/cd/8tp492z54j9g131qntqk4d780000gn/T/hugo_cache/modules/filecache/modules/pkg/mod/cache/vcs/416a66ef4f2f18f5dcdf86a4ba8bc9347aadb37895929ff96e119b02dcd2588d: exit status 128:
        fatal: 'origin' does not appear to be a git repository
        fatal: could not read from remote repository

        Please make sure you have the correct access rights and the repository exists
hugo: collected modules in 3305 ms
Error: failed to download modules: failed to execute 'go [mod download]': failed to execute binary "go" with args [mod download]: go: github.com/nunocoracao/[email protected]: reading github.com/nunocoracao/blowfish/go.mod at revision v1.1.1: git ls-remote -q origin in /var/folders/cd/8tp492z54j9g131qntqk4d780000gn/T/hugo_cache/modules/filecache/modules/pkg/mod/cache/vcs/416a66ef4f2f18f5dcdf86a4ba8bc9347aadb37895929ff96e119b02dcd2588d: exit status 128:
        fatal: 'origin' does not appear to be a git repository
        fatal: could not read from remote repository

        Please make sure you have the correct access rights and the repository exists。
 *errors.errorString

It confused me cause hugo server works fine two days ago and I follow every step of installing using hugo in the docs. I wonder what's wrong.

Update mermaid version

Improve like buttons within articles

Is your feature request related to a problem? Please describe.
Improve like buttons within articles

Describe the solution you'd like
Have a beautiful button for likes

showTaxonomies does not work properly in list view

Dynamic number of recent items

Create a variable to control the number of recent items that appears on the homepage vs a static value of 5 that is currently available

Support icons on header menu

Is your feature request related to a problem? Please describe.
Support icons on header menu

Describe the solution you'd like
Enhance existing menu definition to allow an icon parameter

Add a new landing page design

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

Describe the solution you'd like
A clear and concise description of what you want to happen.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

Create Shordcode to import articles OR list of articles

Is your feature request related to a problem? Please describe.
Create Shordcode to import articles OR list of articles

Describe the solution you'd like
A way to include MD article links and lists

Why Tags doesn't work?

In my articles tags doesn't show up, why? In other themes, its works...

Copy button not working properly on code blocks

Describe the bug
Copy button not working properly on code blocks

Review color themes

.Path when the page is backed by a file is deprecated and will be removed in a future release.

Hi, I saw there was another issue referencing this: #22
It looks like the hugo version was upgraded, but the warning still remains.

I found a fix here that works: HugoBlox/hugo-blox-builder#2592

I'll open a PR with this fix in a bit, I just have to edit two files.
HugoBlox/hugo-blox-builder#2592 (comment)

Display thumbnail on article page

The thumbnail support is really nice, but as I migrate from an existing site, I'd love for this image to be automatically displayed within the header for the article itself.

At the moment it only seems to displayed on article lists.

Correct documentation - profile is the default view

Impossible to overwrite image

Describe the bug
It is impossible to set a custom image in config/_default/languages.en.toml.
Error message:

Error: failed to unmarshl config for path "/home/chris/sremuc/config/_default/languages.en.toml": "_
stream.toml:1:1": unmarshal failed: toml: key image is already defined

To Reproduce

languages.en.toml file:

languageCode = "en"
languageName = "English"
displayName = "EN"
isoCode = "en"
weight = 1
rtl = false
title = "SRE MUC"
description = "SRE Meetup Munich"
dateFormat = "2 January 2006"
[author]
  name = "SRE Meetup Munich"
  image = "img/blowfish_logo.png"
  headline = "'bassd scho' is not a strategy"
  image = 'bassd_scho_circle.png'
  bio = ""
  links = [
    { link = "https://www.meetup.com/de-DE/sremuc/" },
    { github = "https://github.com/dastergon/sremuc" },
    { linkedin = "https://www.linkedin.com/company/site-reliability-engineering-meetup-munich/" },
  ]

Steps to reproduce the behavior:

1. Import blowfish theme as submodule
2. Create assets/img directory: mkdir -p assets/img
3. place image into directory assets/img
4. link to it in the toml file

Expected behavior
It should be possible to overwrite

Hugo & Blowfish versions

• Hugo v0.104.3
• Blowfish imported as submodule: d8eee1c5ed9e5befa482e8caf0f2fe3525473ac3 ../../themes/blowfish (v2.0.1)

Like buttons look off

Describe the bug
Like buttons look off

✨Integrate against subscription systems

Is your feature request related to a problem? Please describe.
Integrate against subscription systems

Describe the solution you'd like
A way to setup a notification system for readers to get updates when a new blog posts is released

Describe alternatives you've considered
3rd party solutions

Additional context
n/a

Unable to install blowfish using mod

Go version,

❯ go version
go version go1.19.1 darwin/arm64

Hugo version,

❯ hugo version
hugo v0.102.3+extended darwin/arm64 BuildDate=unknown

When I added blowfish as module and then run hugo server I am getting error,

❯ hugo server
go: no module dependencies to download
go: added github.com/nunocoracao/blowfish v0.0.0-20220913200201-c81a160d88fc
hugo: collected modules in 1275 ms
WARN 2022/09/14 21:25:33 Module "github.com/nunocoracao/blowfish" is not compatible with this Hugo version; run "hugo mod graph" for more information.
Start building sites …
hugo v0.102.3+extended darwin/arm64 BuildDate=unknown

Error - WARN 2022/09/14 21:25:33 Module "github.com/nunocoracao/blowfish" is not compatible with this Hugo version; run "hugo mod graph" for more information.
and nothing is added to themes folder.

Example of blowfish theme project

What I want to ask is, after downloading the theme, the theme contains many document tutorials, and I want to delete them all, that is, the articles of docs and samples. After all, building a real website means that these document tutorials are useless. However, I found that deleting the articles of docs and samples would cause errors. So, what I want to ask is, can't the document tutorials in this be deleted? If it can be deleted, which document articles should be kept？

Adjustable textwidth

Hello,

Thanks for creating the awesome theme.

I have a feature request. Like discussed in the Discussion #10 , I think it would be great to provide a setting to change the width of the text area. Not really sure about the proper name of this, I'm using latex nomenclature textwidth, but maybe it should be called content width, element width?

The narrow textwidth like the profile style layout is good for listing and reading on the phone, but the wide textwidth similar to the project style layout is good for reading serious article and on desktop computer.

Thanks!

Regards,
Xi

Like button is taking way too much space

Is your feature request related to a problem? Please describe.
Like button is taking way too much space, especially to remove a like

Describe the solution you'd like
Change the remove like button UI

Describe alternatives you've considered
Not using the like mechanism

Additional context
n/a

Article view

Hello, thank you for making a beautiful theme. About the home page article view. After reading the document, it seems that it needs to be displayed and used with firebase project. But here in China, Google can't use it. Excuse me, is there any way to display the article view? Thank you.

Improve responsiveness for article pages

Is your feature request related to a problem? Please describe.
Improve responsiveness for article pages

Describe the solution you'd like
Make use of the real-state available

Describe alternatives you've considered
n/a

Additional context
n/a

External links should open in a new Tab by default

Is your feature request related to a problem? Please describe.
External links should open in a new Tab by default

Describe the solution you'd like
Use the normal makdown link structure and have links open in an external website without using HTML

Describe alternatives you've considered
I've been using a tags in my blog to achieve this result

Additional context
n/a

add likes

Feature request: language switcher

I would love to use your theme but I'm missing a language switcher.

Thanks, good work!

Review github actions

Add more homepage layouts

Is your feature request related to a problem? Please describe.
Currently users might be looking for more versatile homepage layouts only two available and it might be hard to some users to extend and create their custom ones

Describe the solution you'd like
Add more homepage layouts for different use-cases

Describe alternatives you've considered
n/a

Additional context
n/a

Implement series support

Is your feature request related to a problem? Please describe.
Implement series support

Describe the solution you'd like
A way to reference several articles as part of a series, and provide the right order (and numbering) for them

Describe alternatives you've considered
n/a

Additional context
n/a

upgrade hugo version

Taxonomy badges broken in mobile

Describe the bug
Taxonomy badges in mobile don't wrap to a new line in a correct way.

To Reproduce
Steps to reproduce the behavior:

1. Configure taxonomy badges
2. Add an article with 10 badges
3. Open on mobile screen

Expected behavior
Badges should wrap in a better way

Support for Multi-Author

Is your feature request related to a problem? Please describe.
Add support for multi-author blogs

Describe the solution you'd like
Add support across the theme for multi-authors without introducing breaking changes

Describe alternatives you've considered
n/a

Additional context
n/a

[Feature Request] Add "Read More" button to "Recent"

I understand we can set "showRecent = true " to add Recent Post in homepage. I think it's good to see a button that lead user to view all the post.

Regards.

Add more icons

Is your feature request related to a problem? Please describe.
Add more icons

Describe the solution you'd like
Add more icons

Describe alternatives you've considered
n/a

Additional context
n/a

Upgrade to new Hugo Version 0.104.1

Hi, when running Hugo version 0.104.0, I get a warning

WARN 2022/09/25 15:47:03 Module "blowfish" is not compatible with this Hugo version; run "hugo mod graph" for more information.
Start building sites … 
hugo v0.104.0-c744dbd6edeeb27288c9dd67e0eb92951f911397+extended linux/amd64 BuildDate=2022-09-23T14:32:56Z VendorInfo=snap:0.104.0
WARN 2022/09/25 15:47:03 .Path when the page is backed by a file is deprecated and will be removed in a future release. We plan to use Path for a canonical source path and you probably want to check the source is a file. To get the current behaviour, you can use a construct similar to the one below:

  {{ $path := "" }}
  {{ with .File }}
        {{ $path = .Path }}
  {{ else }}
        {{ $path = .Path }}
  {{ end }}


Re-run Hugo with the flag --panicOnWarning to get a better error message.

The server does launch, and I don't notice any immediate issues, but it may be something to watch if you weren't already aware

Support for gradients in color themes

Is your feature request related to a problem? Please describe.
Support for gradients in color themes

Describe the solution you'd like
Allow users to define gradients as colors for themes

Describe alternatives you've considered
n/a

Additional context
n/a

Bug - article margin in recent articles

Describe the bug
Margins are borken

To Reproduce
Configure recent articles

Expected behavior
Margin behave as in any other list

Grayscale icons

Hello,

Wonderful job on blowfish template.
I would like to add discourse icon logo. However it is not present : https://nunocoracao.github.io/blowfish/samples/icons/

I added a discourse logo svg in the folder assets/icons from https://icones8.fr/icon/g8KUbJF_s09W/discourse. However it is not depicted in grayscale but in black compared to other icons:

Is there a configuration to perform?

Regards

issue build

Hello,

I have an issue to build with the blowfish theme:

For instance, I did:

1. I download the exampleSite on this repos. In the config.toml there is the theme= "blowfish", so I install the theme using git.

2. Then I tried to build the site (hugo), however I have a issue:

3. The public/index.html render is wrong:

The goversion is go version go1.19 linux/amd64 and I installed Hugo with the snap package.

I do not know what to do.

regards

Improve UI options for hero image

Is your feature request related to a problem? Please describe.
Improve UI options for hero image

Describe the solution you'd like
Multiple options to the way a hero image is displayed inside an article

Describe alternatives you've considered
custom overlays

Additional context
n/a

Background hero images improvements

Background hero images don't look good with long titles on mobile

Turn hero image into partial

Is your feature request related to a problem? Please describe.
Some users would like different visuals for the hero image solution

Describe the solution you'd like
Turn hero image into partial

Describe alternatives you've considered
n/a

Additional context
n/a

Dependencies Update

Is your feature request related to a problem? Please describe.
Blowfish dependencies require updating

Describe the solution you'd like
Update dependencies to the latest supported versions and update code as needed for everything to work seamlessly

Describe alternatives you've considered
n/a

Additional context
n/a

Add details to docs on [i18n] Authors bio - link to Hugo docs

Firstly, amazing thanks and congrats for making Blowfish so amazing! I'm loving it. ❤️

Is your feature request related to a problem? Please describe.
Hello there!
Blowfish's documentation is stunning, it's one of the best documentations I ever seen.
But I think it's whether lacking some informations, whether Blowfish lacks a little feature implementation.

On the Multi-Authors documentation page, there is no mention about the i18n for authors profiles.
https://nunocoracao.github.io/blowfish/docs/multi-author/#create-the-authors-taxonomy

(See the starting by Lastly, you can add more detail to each author page so that it displays a little bio, links, or whatever information fits your use-case. paragraph. 😉)

Describe the solution you'd like
I would like to have the same i18n behaviour and standards as usual (_index.fr.md, _index.en.md, maybe?).
⚠️ EDIT: Unless there is already a way to do it with Hugo's built-in standards.

Warm regards!

Add featured images to RSS feeds

Is your feature request related to a problem? Please describe.
Add featured images to RSS feeds

Describe the solution you'd like
Add featured images to RSS feeds automatically using the featured.* mechanism

Describe alternatives you've considered
n/a

Additional context
n/a

taxonomies.toml - configs and docs improvements

Describe the bug
Since the commit dffaab8, I have trouble with the hugo server command, using Blowfish

hugo server --ignoreCache

Start building sites …
hugo v0.104.3-58b824581360148f2d91f5cc83f69bd22c1aa331+extended linux/amd64 BuildDate=2022-10-04T14:25:23Z VendorInfo=snap:0.104.3
ERROR 2022/10/16 18:32:57 render of "term" failed: "/tmp/hugo_cache/modules/filecache/modules/pkg/mod/github.com/nunocoracao/[email protected]/layouts/_default/term.html:16:14": execute of template failed: template: _default/term.html:16:14: executing "main" at <.Paginate>: error calling Paginate: cannot convert type page.PagesGroup to Pages
ERROR 2022/10/16 18:32:57 render of "term" failed: "/tmp/hugo_cache/modules/filecache/modules/pkg/mod/github.com/nunocoracao/[email protected]/layouts/_default/term.html:16:14": execute of template failed: template: _default/term.html:16:14: executing "main" at <.Paginate>: error calling Paginate: cannot convert type page.PagesGroup to Pages
ERROR 2022/10/16 18:32:57 render of "term" failed: "/tmp/hugo_cache/modules/filecache/modules/pkg/mod/github.com/nunocoracao/[email protected]/layouts/_default/term.html:16:14": execute of template failed: template: _default/term.html:16:14: executing "main" at <.Paginate>: error calling Paginate: cannot convert type page.PagesGroup to Pages
Error: Error building site: failed to render pages: render of "term" failed: "/tmp/hugo_cache/modules/filecache/modules/pkg/mod/github.com/nunocoracao/[email protected]/layouts/_default/term.html:16:14": execute of template failed: template: _default/term.html:16:14: executing "main" at <.Paginate>: error calling Paginate: cannot convert type page.PagesGroup to Pages
Built in 56 ms

To Reproduce
I dunno, sorry.
I will try to git checkout and see if it is really related to the mentioned commit.
I can provide you a sample of my Hugo Blog (not pushed on GitHub yet), if you want to review it.

Desktop (please complete the following information):

• OS: Manjaro

Hugo & Blowfish versions

• Blowfish: 2.0.0
• Hugo: hugo v0.104.3-58b824581360148f2d91f5cc83f69bd22c1aa331+extended linux/amd64 BuildDate=2022-10-04T14:25:23Z VendorInfo=snap:0.104.3
• Golang: go version go1.19.2 linux/amd64