Theme Information
- Name: Akio – Creative Portfolio Theme for Jekyll.
- Akio is a creative personal portfolio Jekyll theme. This theme has a modern design and high-speed performance. The highlights of this theme include support Github Pages, light and dark mode, and also sections such as work, blog, clients, and testimonials. Perfectly suitable for any developer, designer, freelancer, software engineer, or some other who needs a professional way to showcase their work.
- Current Version: 1.2
- Released: 30/01/2023
- Creator: Artem Sheludko
Table of Contents
- Configurations
- Installing Ruby & Jekyll
- Deployment
- Posts
- Pages
- Works
- Gallery
- Navigation
- Disqus Comments
- Google Analytics
- Update favicon
- Credits
- Support
Configurations
Akio theme comes with different customizations the _data/settings.yml
and config.yml
files:
Installing Ruby & Jekyll
If this is your first time using Jekyll, please follow the Jekyll docs and make sure your local environment (including Ruby) is setup correctly.
Deployment
To run the theme locally, navigate to the theme directory and run bundle install
to install the dependencies, then run bundle exec jekyll serve
to start the Jekyll server.
I would recommend checking the Deployment Methods page on Jekyll website.
Posts
To create a new post, you can create a new markdown file inside the _posts
directory by following the recommended file structure.
You can set the title
, description
, image
, image_caption
, and the post tags
.
Add post images to /images/ directory.
Full width image
To have wide images in posts or pages simply add #wide
word with the hashtag at the end of image path like in the example below:
![River]({{site.baseurl}}/images/15-1.jpg#wide)
For tags, try to not add space between two words, for example, Ruby on Rails
, could be something like (ruby-on-rails
, Ruby_on_Rails
, or Ruby-on-Rails
).
Pages
To create a new page, just create a new markdown file inside the _pages
directory.
The following is the about.md
file that you can find as an example included in the theme with the configurations you can set.
Things you can change are: title
, description
, image
, and image_caption
.
Works
To create a new work, just create a new markdown file inside the _works
directory.
The following is the 2022-01-05-mental-health.md
file that you can find as an example included in the theme with the configurations you can set.
Things you can change are: title
, description
, category
, role
, image
, and image_caption
.
Gallery
Use HTML
markup to use gallery on pages. For example:
Don't forget to provide the correct path for your images.
Navigation
This allows you to set the links inside your menu. Add each one as a list item with a title
and url
. Make sure you leave a trailing /
at the end of links to category pages (e.g. /blog/
or /work/
).
Disqus Comments
Akio Theme comes with Disqus comments enabled.
Open settings.yml
file, and change the anvod-studio-test
value on line 195 with your Disqus account shortname.
That’s all you need to setup Disqus from the theme side. If you get any issue regarding that comments are unable to load. First, make sure you have registered your website with Disqus (Step 1).
And also check Disqus troubleshooting guide if you still have issues.
Google Analytics
To integrate Google Analytics, open settings.yml
, and add your Google Analytics identifier.
Update favicon
You can find the current favicon (favicon.ico) inside the theme root directory, just replace it with your new favicon.
Credits
I have used the following scripts, fonts or other files as listed.
- Google Fonts (Rubik).
- Vanilla Lazyload
- Ionicons
- Lightense Images
- Reframe.js
- Preview Images form unsplash.com, pexels.com, freepik.com
Support
If you have any questions that are not answered here, please feel free to contact me by mail.
Contact Artem