alexandrevicenzi / soho Goto Github PK

View Code? Open in Web Editor NEW

This project forked from spf13/hyde

63.0 6.0 54.0 1.38 MB

Minimalist Hugo theme based on Hyde

Home Page: https://themes.gohugo.io/soho/

License: MIT License

HTML 48.57% CSS 45.39% Dockerfile 0.19% JavaScript 5.84%

hugo hugo-theme hugo-blog-theme responsive seo-friendly seo

soho's Introduction

Soho

Soho is a minimalist two-column hugo theme based on Hyde inspired by the success of Flex.

Features

Mobile First
Responsive
Semantic
SEO best practices
- Open Graph
- Schema.org (Microdata and JSON-LD)
- Twitter Card
Pagination
Customizable
Support all Hugo Internals

Integrations

Installation

To install Soho as your default theme, first install this repository in the themes/ directory:

$ cd themes/
$ git submodule add https://github.com/alexandrevicenzi/soho.git

Second, specify soho as your default theme in the config.toml file. Just add the line

theme = "soho"

at the top of the file.

Configuration

baseURL = "https://example.com"
title = "Soho"
languageCode = "en"
enableInlineShortcodes = true

summarylength = 10
enableEmoji = true

[params]
author = "Author Name"
description = "My Blog"

## Set one of:
# gravatar = "[email protected]"
profilePicture = "images/profile.png"

copyright = "Author Name"
license = "CC BY-SA 4.0"
licenseURL = "https://creativecommons.org/licenses/by-sa/4.0"

## Set custom theme color.
# themeColor = "#fc2803"

## Set custom CSS and/or JS to override site defaults.
customCss = ["css/blog.css"]
customJs = ["js/blog.js"]

  ## Set as many as you want.
  [[params.socialIcons]]
  icon = "fa-linkedin"
  title = "Linkedin"
  url = "#"

  [[params.socialIcons]]
  icon = "fa-github"
  title = "GitHub"
  url = "#"

  [[params.socialIcons]]
  icon = "fa-twitter"
  title = "Twitter"
  url = "#"

[menu]

  [[menu.main]]
  name = "Posts"
  weight = 100
  identifier = "posts"
  url = "/posts/"

  [[menu.main]]
  name = "About"
  identifier = "about"
  weight = 300
  url = "/about/"

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

[markup]

  [markup.highlight]
  codeFences = true
  guessSyntax = false
  hl_Lines = ""
  lineNoStart = 1
  lineNos = false
  lineNumbersInTable = true
  noClasses = true # if false, you need to provide you own custom CSS
  style = "monokai"
  tabWidth = 4

License

MIT

soho's People

Contributors

Stargazers

Watchers

soho's Issues

Where can I read on how to use the SEO features to my Hugo blog posts?

This theme offers OpenGraph and other SEO features, but how do I use them? Do I add information to the front matter?

Can you tag a new version?

To get the corrected module path in go.mod published.

Avatars cannot be displayed

config.toml configuration profilePicture = "images/profile.png"
I added profile.png in /usr/local/lib/blog/themes/soho/images
Local preview cannot display avatar

Can't Add highlight.js to chunk codes

When I read about how adding highlight.js to HUGO themes, I need add this code inside a file called header.html or header.includes.html. in folder .layouts/partials.

<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.6.0/styles/default.min.css">
<script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.6.0/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>

But unfortunaly, that theme doesn't have header.html in that folder. But I don't know where I could add.

I'm new to all this and I would love to got some instructions of how integrate highligh.js to the Soho theme. For now, I prefer follow your instructions to choose another theme.

Just to you know my situation:
I'm using Blogdown package in R to generate a .md with chunks of codes. This package have a good integration with HUGO and allows me to execute code from different lang in the same .md.

`if not hugo.IsServer` causes error

Just cloned the theme, tried starting the server, got the following

ERROR 2024/02/20 15:35:28 render of "taxonomy" failed: "/var/www/hugoDev/themes/soho/layouts/_default/baseof.html:77:14": execute of template failed: template: _default/taxonomy.html:77:14: executing "_default/taxonomy.html" at <hugo>: can't evaluate field IsServer in type interface {}
ERROR 2024/02/20 15:35:28 render of "taxonomy" failed: "/var/www/hugoDev/themes/soho/layouts/_default/baseof.html:77:14": execute of template failed: template: _default/taxonomy.html:77:14: executing "_default/taxonomy.html" at <hugo>: can't evaluate field IsServer in type interface {}
Error: Error building site: failed to render pages: render of "home" failed: "/var/www/hugoDev/themes/soho/layouts/_default/baseof.html:77:14": execute of template failed: template: index.html:77:14: executing "index.html" at <hugo>: can't evaluate field IsServer in type interface {}

Had to remove the following from layouts/_default/baseof.html

    {{ if not hugo.IsServer }}
      {{ template "_internal/google_analytics.html" . }}
    {{ end }}

[DEPRECATING] google_news

When I run hugo serve, I receive this warning:

WARN 2022/07/23 11:03:40 The google_news internal template will be removed in a future release. Please remove calls to this template. See https://github.com/gohugoio/hugo/issues/9172 for additional information.

[FEATURE] Translations

Is there a way to translate the theme and customize the way the date is shown?

Host on GitLab

That’s it! You can now follow the CI agent building your page at https://gitlab.com///pipelines.
An error occurred：
Running with gitlab-runner 13.1.0-rc1 (b9d289ed) on docker-auto-scale fa6cab46 Preparing the "docker+machine" executor 00:15 Using Docker executor with image monachus/hugo ... Pulling docker image monachus/hugo ... Using docker image sha256:c016030df1af27eb35a1a98639e523abfa8a55d83ac7170c4062b1c01ff10fb6 for monachus/hugo ... Preparing environment 00:04 Running on runner-fa6cab46-project-19506480-concurrent-0 via runner-fa6cab46-srm-1592808650-50dbcc5e... Getting source from Git repository 00:07 $ eval "$CI_PRE_CLONE_SCRIPT" Fetching changes with git depth set to 50... Initialized empty Git repository in /builds/saillin199/saillin199.gitlab.io/.git/ Created fresh repository. Checking out 19ab32f6 as master... Updating/initializing submodules recursively... fatal: No url found for submodule path 'themes/soho' in .gitmodules ERROR: Job failed: exit code 1
Thank you