Git Product home page Git Product logo

hugo-geo's Introduction

logo

A responsive blog theme I've developed for use on my personal website. Suitable for desktop and mobile. Designed for tutorial and post sections.

screenshot

#Example Site Demo

I also use it on my personal website

Dependencies

  • Hugo v0.14 or better
  • LESS if you wish to compile the custom CSS

Features

  • Use highlight = true in the front matter to include highlight js javascript and css files.
  • In the front matter, use index = true on the first post in a tutorial series to make that content the "index" page for the rest of the series
  • Include custom scripts and css on individual pages in front matter like so:
scripts = [
"//cdnjs.cloudflare.com/ajax/libs/highlight.js/8.8.0/languages/go.min.js",
]

css = [
"//cdn.leafletjs.com/leaflet/v0.7.7/leaflet.css"
]

Site Config

These are my config.toml settings:

BaseURL = "https://base-url-here/"
relativeURLs = false
languageCode = "en-us"
title = "SiteTitle.Com"
disqusShortname = "*****"
paginate = 5

[taxonomies]
	tag = "tags"
	tutorial = "tutorials"

[params]
	# Render the rotating globe in the sidebar
	showglobe = true

	# Include favicon
	favicon = "favicon.ico"
 	
	# Google Analytics
	analytics = "SHORT-CODE-HERE"

	# Email (optional)
	email = "[email protected]"
	
	# Header Title for the main page
	header = "What I'm Thinking"
	
	# Sidebar profile picture
	profilepic = "img/smugmug.jpg"
	
	# Title/subtitle for the sidebar
	title = "ALEX URQUHART"
	subtitle = "GEOMATICS PROFESSIONAL"
	
	# Social buttons for sidebar
	# Each of these are optional
	[[params.socialbuttons]]
	faicon = "github"
	url = "https://github.com/alexurquhart"
	[[params.socialbuttons]]
	faicon = "twitter"
	url = "https://twitter.com/alexanderurq"
	[[params.socialbuttons]]
	faicon = "linkedin"
	url = "https://linkedin.com"
	[[params.socialbuttons]]
	faicon = "google-plus"
	url = "https://plus.google.com/+YourID"

	# Nav links below the profile picture
	[[params.navlinks]]
	name = "About"
	url = "about/"
	
	[[params.navlinks]]
	name = "Blog"
	url = "posts/"
	
	[[params.navlinks]]
	name = "Tutorials"
	url = "tutorial/"

My TODO List (currently working on v2.0)

  • Clean up and simplify the CSS
  • Make Disqus comments optional on a per-page basis
  • Previous/next post buttons on each page
  • Improve list pages
  • Add a sidebar on large screens with links to related posts
  • Add next/previous links at the end of posts/tutorials
  • Add breadcrumbs to top of page

Credits

World graphic in logo by Sarfraz Shoukat from Flaticon is licensed under CC BY 3.0. Made with Logo Maker

hugo-geo's People

Contributors

alexurquhart avatar bep avatar bozaro avatar digitallumberjack avatar martinpitt avatar vazh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

hugo-geo's Issues

Some Questions!

Hello,

I have tried to get up and running with this theme, and I have hit problem, most likely due to my lack of experience with hugo.

When you hit the default landing page of my site, I can't figure out how to place some content there - similar to your website I'd like it show recent blog posts by default. At the moment it shows this:

image

I have to click on the "Blog" link to then navigate to posts!

My second problem is that when I navigate to a post, it doesn't seem to display any tags..

Here is my yaml front matter:

---
title: Unit Testing Dynamics CRM Plugins
date: 2014-12-14T17:50:00
comments: true
categories: 
    - "Dynamics CRM"
published: true
tags:
    - "Unit Testing"
---

And here is what I see in the browser (no tags showing)

image

Not quite sure where I might be going wrong!

Customizable social icons

Hi, thank you very much for the theme :)

Many people also use gitlab for developing open source project, so my first need was to add the gitlab icon in the sidebar. But my second though was to provide a way to customize every icon on the sidebar.

So it would be great to set the url + font awesome icon to use in a list of elements in the toml config.

Add i18n

Create a strings.json or something and allow translating the site to other languages.

images - size?

I have started to add some images to my post, but I notice that they aren't resized to fit the page.. i.e they look like this:

image

Can this be something that is addressed by the theme i.e so images have some default size?

Rss links / social media buttons

Just a couple of suggestion, how about adding the ability to share post to various social media - i.e Facebook, Twitter, Linked In etc etc.

Also the ability to display as RSS icon for people that want to subscribe to an RSS feed.

Markdown anchor links don't work properly

Anchor links shouldn't open in a new tab.
Should be able to press browser back/forward to navigate around previously clicked anchor links.

[Test](#sometest)
# sometest

Client-side high CPU usage due to globe script

When we have the globe script running and have the tab open in Chrome, it pegs one of our client CPU cores to max. I never paid attention to this if it happened before, but definitely noticed it now.

404 page not found

Hi there,

thx for the nice template. It's actually my first attempt to use Hugo but I have a problem with the theme (?).

I used another theme and my website was working but after I saw your theme and I simply changed it to yours. From that moment I'm only getting in my site an error:

404 page not found

On browser, on devtools no errors. Hugo in the terminal seems to render everything correctly and here is my config file:

baseurl = "my-url"
relativeURLs = false
languageCode = "en-us"
title = "My Name"
disqusShortname = "username"
paginate = 5
theme = "hugo-geo"

[taxonomies]
    tag = "tags"

[params]
    # Render the rotating globe in the sidebar
    showglobe = true

    # Google Analytics
    analytics = ""

    # Social buttons for sidebar
    github = "https://github.com/"
    twitter = "https://twitter.com/"
    linkedin = "https://linkedin.com/"

    # Sidebar profile picture
    profilepic = "mypic.jpg"

    # Title/subtitle for the sidebar
    title = "My Name"
    subtitle = "Frontend Developer"

    # Nav links below the profile picture
    [[params.navlinks]]
    name = "About"
    url = "about/"

    [[params.navlinks]]
    name = "Blog"
    url = "posts/"

Any ideas?

Add Index header into config

current it's hardcoded into What I'm Thinking
because this is the main page header i think its much easier for it to be configured from config.toml

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.