Eternity
Demo
Website: eternity.bora.sh
demo.mp4
Used by
-
cankalay.com
A photographer website. -
jwst.rocks
Basic website contains WEBB images.
Note: Feel free to add your site here.
Features
-
Configurable features.
-
Multiple images support.
-
Clean, fresh, minimalist.
-
Integrated lazy load.
-
Automaticly creates resized thumbnails.
-
Shows exif if it exists.
Installation
-
Install Hugo.
-
Create a new site.
hugo new site yoursite
cd yoursite
-
Submodule the theme.
git submodule add --depth=1 https://github.com/boratanrikulu/eternity.git themes/eternity
-
Check example/eternity.bora.sh for example contents and set your config.yaml.
Note: You may just copy example site for testing;cp -r ./themes/eternity/example/eternity.bora.sh/* .
-
Start the server.
hugo serve --port 1313
-
Go to localhost:1313.
Upgrade
To get last updates, just git pull.
cd themes/eternity && git pull && cd -
Usage of Posts
Eternity is configurable and you can change feature behaviours by setting variables.
Here's a basic post structure. You can basically use tags
to set which pages will have this post. We suggest to use work
for homepage and archive
for all posts. (Note: you can change their names too).
If you want to create a new page, just add it as a new tag.
---
images:
- /images/my-image-1.jpg
title: Here's my first post!!
tags:
- work
---
You can set date
value for your posts. It will be used in Post page and for posts sorting. If you want, you can use weight
value for sorting. (Note: if you won't set a date
, we check exif
value of the image to use in post.)
---
weight: 9
images:
- /images/my-image-1.jpg
title: Here's my first post!!
tags:
- work
- first
date: 2022-07-24
---
You can use multiple images by adding them to images
array. Default view is row
. But if you want to set them as column
, you can use multipleColumn
value. Both local images and remote images are supported. If you use remote image, it will be downloaded.
---
weight: 9
images:
- /images/my-image-1.jpg
- /images/my-image-2.jpg
multipleColumn: true
title: Here's my first post!!
tags:
- work
- first
date: 2022-07-24
---
When you use multiple images, first image will be used as thumbnail in posts page. If you want to use different image, you can use mainImage
variable.
---
weight: 9
images:
- /images/my-image-1.jpg
- /images/my-image-2.jpg
mainImage: /images/different-image.jpg
multipleColumn: true
title: Here's my first post!!
tags:
- work
- first
date: 2022-07-24
---
If you want to hide exif value for a post, you can use hideExif
variable. Also there's available hidetitle
and hideDate
variables. We used that variables in about page to be able to create a single page with using same layout.
---
weight: 9
images:
- /images/my-image-1.jpg
- /images/my-image-2.jpg
multipleColumn: true
title: Here's my first post!!
tags:
- work
- first
date: 2022-07-24
hideExif: true
---
You can use title
, subtitle
, url
variables for the post.
---
images:
- /images/about.png
title: About!!
subtitle: Here's who am I.
url: me
hideTitle: true
hideExif: true
hideDate: true
---
Markdown is fully supported.
---
weight: 9
images:
- /images/my-image-1.jpg
- /images/my-image-2.jpg
multipleColumn: true
title: Here's my first post!!
tags:
- work
- first
date: 2022-07-24
---
# Markdown
You can use **Markdown** format to write **your story**.
## Subtitle
Lorem ipsum dolor sit amet consectetur adipisicing elit. Magni dolorem, laborum impedit doloremque ducimus repellat sapiente aut qui quae provident, cum vitae atque eius earum labore. Quae quod rem aliquid!
Some list
1. A b c
2. A b c
3. A b c
For landing page (_index.md), you can use desc
array to set your description, under the enter button.
---
desc:
- Eternity is a minimalist Hugo theme
- designed for portfolio sites with a fresh feel.
---
Usage of Config.yaml
Example config is here: config.yaml
You can use title
, subtitle
and image
variables for your website. Same variables are available for post pages.
title: Eternity
params:
subtitle: Eternity is a minimalist Hugo theme designed for portfolio sites with a fresh feel.
image: '/images/about.png`
You can use googleAnalytics
variable to set Analytics.
googleAnalytics: ''
You can use copyright
and author
variables to set Copyright notice.
params:
copyright: ''
author: ''
You can set hidden for Source notice. But, please do not do this.
params:
dontShowSource: false
You can change columns count for desktop and mobile separately. Default value will be used if value is not defined for page type.
params:
portfolio:
columns:
desktop:
nature: 4
archive: 6
people: 2
default: 3
mobile:
default: 2
archive: 3
people: 1
You can use socials
array to set your social accounts. icon
is font-awesome icon code. You can use landing
variable to make icon invisible only for landing page but visible inside website.
params:
socials:
- icon: 'far fa-envelope fa-lg'
url: 'mailto:eternity@bora.sh'
landing: true
- icon: 'fab fa-github fa-lg'
url: 'https://github.com/boratanrikulu/eternity'
landing: true
- icon: 'fab fa-instagram fa-lg'
url: 'https://instagram.bora.sh/eternity'
- icon: 'fab fa-linkedin-in fa-lg'
url: 'https://linkedin.bora.sh/in/eternity'
You can change homepage
link.
params:
homepage: "/work"
You can use menu.main
array to set your navbar links.
menu:
main:
- name: work
url: /work/
weight: 1
- name: people
url: /tags/people/
weight: 2
- name: nature
url: /tags/nature/
weight: 3
- name: archive
url: /tags/archive/
weight: 4
- name: about
url: /about/
weight: 5
Editing default statics
Hugo allows to edit statics when you use a theme. We suggest to replace this statics /static/logo.png, /static/background.jpeg, /static/CNAME, /static/favicon.ico. You can also change used colors, /static/css/colors.css. You just need to create static folder inside your project and put the statics. Do not edit theme directlym, otherwise it may break your upgrade in future.
Contact
If you need to contact us for any reason; create an issue or send a mail to eternity@bora.sh.