heksagonnet/piko

Piko is a minimalistic and fast theme powered by Hugo for building a blog or portfolio.

Piko | Demo | Lighthouse report (100%)

---

"Piko is a minimalistic and fast theme powered by Hugo for building a blog or portfolio."

---

Features

• Powered by Hugo Static Site Generator
• Styled by Pico CSS
• SASS/SCSS
• Icons by FeatherIcons
• Google analytics
• Math typesetting KaTex
• Minified CSS and JS
• Predefined Netlify settings
• Pre-configured Forestry CMS
• Easy contact form using FormSubmit.io or Fabform.io
• Search by Fuse.js
• Cookie Notice, GDPR Compliant
• Reading time calculation for posts
• Multiple author and single author available
• Google page speed optimized (100%)
• Open graph meta tag
• Twitter card meta tag

---

Quick Deploy

1. Have a free/paid version:

• Github Account
• Netlify Account

2. Then click:

And click next for all.

---

Local Development

If you wish to develop in your local environment, make sure you have installed:

• Hugo
• Git

Then open command prompt in your development folder.

# Clone the repository
$ git clone https://github.com/heksagonnet/piko.git

# cd in the project directory
$ cd piko/exampleSite/

# Start local dev server
$ hugo server --themesDir ../..

---

Forestry.io CMS Setup

1. Visit Forestry.io and login with Github

2. Click 'Add Site'

3. Choose Hugo and click Next

4. Choose Github and click Next

5. Choose the repo that you have kept the Piko theme, type 'exampleSite' in Config Path and click 'Check For Config'. When it says 'Config file Found!', click Next.

6. Click all 'Mark as done'.

7. Replace the BASEURL in Configure to your domain name or custom domain name set in Netlify as above.

8. Edit your website to your heart's content!

---

Hire me

Besides developing stunning and blazing fast website templates, I also provide web design services. My speciality is in creating high-quality static websites based on Hugo.

If you are interested to know more, do not hesitate to contact me here.

piko's Issues

Installing using RStudio, R and blogdown not working

Hi,

wonderful template. Is there a trick to install the website using RStudio, R and blogdown (See here https://bookdown.org/yihui/blogdown/a-quick-example.html)? After installing the website, it is neither loading nor properly rendered.

At least on my system

RStudio 2022.12.0 Build 353
R version 4.2.2
blogdown_1.16

problem with blog frontmatter rendering

On the example site I get this weird rendering of the metadata from the front matter of the blog posts:

Do you know what is going on here?

Google Analytics Deprecated

The current version include in this has been deprecated by Google. What would it take to update to their latest analytic system?

Issue with Image imbedding within blog post

Hey there!

I seem to be having an issue embedding an image within a blog post. It appears that there is not an example on the demo site.

Can you please provide one in the demo? Or explain how it should work? As currently, I've used the methods that have worked before, and it doesn't appear to.

![]("/static/uploads/<filename>")

How to customize and deploy locally

Since your instructions differ significantly from the Hugo quick start guide, I am having problems customizing and deploying the site on my local server.

What works on the exampleSite is not reproducible on my own site.

Netlify blocks all new non-Pro accounts from signing up or logging in because of validation issues. So I am unable to try out the "quick way" either.

Here's what I did:

hugo new site wencai.io
Congratulations! Your new Hugo site was created in /home/sati/wencai/wencai.io.

cd wencai.io
git init
git submodule add https://github.com/heksagonnet/piko.git themes/piko

What next?

I see these files and folders in your exampleSite.

config.yml  content  netlify.toml  resources  static

which has some files and folders that are congruous to what I have on my project root:

archetypes  assets  content  data  hugo.toml  i18n  layouts  static  themes

When I replaced hugo.toml with config.yml, I get this:

This is as far as I can get, after hours of trial and error. Not sure what I need to do next. Copying content, resources etc. over from exampleSite to the root, replacing the original directories is a messy disaster.

Ideally, the documentation on README.md should guide us step by step to a stage equivalent to the Netlify deployment, where we are able to customize the site for our own needs.