Table of contents

    Getting Started

    Arkai is a multipurpose, modern and minimal ghost blogging theme specially designed for Magazine, Blog for personal. It is a totally new design, extreme features and supported all the features of Ghost 3.x. This theme is built with SASS, Handlebars, and a lot of options. This is a fully responsive, hand coded and fully translation ready theme.

    If you are a programmer, do you write blog or teach programming to people. You can choose this theme. Arkai comes with code highlighting features.

    Support

    If you have any questions that are beyond the scope of this help file, please feel free to send your questions to our support email: electronthemes@gmail.com. Our support team will reply you within 6 hours.

    Template Information

    Theme Setup

    Arkai theme setup is very easy. If you have already installed a server for Ghost you can easily setup Arkai theme. If you don’t have server suported with Ghost, you can set up reading Ghost Install. When you have the server, follow the instructions for setting up the theme.

    Upload the theme

    You can upload the theme file from ghost dashboard. to do this

    • Log in into your Ghost admin panel.
    • Go to settings (design section) and upload “arkai.zip“
    • Click Activate.

    Uploading the theme via (FTP)

    Follow the instructions

    • Login to your FTP account.
    • Unzip the arkai.zip file and copy arkai folder to your /ghost_installation/content/themes
    • Restart your installation if necessary. You can ask for help from your hosting provider if you don’t know how to do this step.
    • Login to your ghost admin panel.
    • Go to settings (general) and select theme “Arkai“
    • Click Save.

    General Setup

    Publication Info

    To change publication info, go to Dashboard > General > Publication Info. Here you can change the followings:

    • Title
    • Description
    • Site Timezone
    • Publication Language

    Logo

    We have used SVG Logo for the theme . You can change SVG Logo from Dashboard > General > Publication Identity

    Favicon Icon

    Ghost shows his ghost logo in your site by default. You can change Favicon Icon or Publication Icon from Dashboard > General > Publication Identity

    Publication Cover

    This is for showing site bookmark image. If you upload a cover image, it will in your site bookmark

    Site Meta Settings

    This is for Meta data. It will help to get on search using search engine. You can add also Twitter and Facebook card image, content here.

    You can add/edit the content from Dashboard > General > Site Meta Settings

    Social Accounts

    Social account section is for showing Facebook, Twitter links of your site. Go to Dashboard > Settings > Social Accounts

    Primary Navigation

    Ghost only support two types of Navigation. Primary and Secondary Navigation Menu. On header, primary navigation is showing and On Footer secondary navigation is showing. Go to Dashboard > Design > Navigation

    Secondary Navigation

    You can change menu item on secondary Design > Secondary Navigation

    Create a Post

    Ghost has a beautiful dashboard design. You can easily create a post. Go to Dashboard > Posts > New Post

    • Post Title
    • Post Contents
    • Feature image
    • Tags
    • Authors

    Create a page

    As like as post, you can create a new page from Dashboard > Pages > New Page. You can add:

    • Title
    • Contents
    • Tags
    • Authors
    • Feature Image
    • Excerpt
    • more…

    Featured Post

    Ghost has awesome featured posts option to show some of your chosen posts as featured for the visitors. To add a post as featured, go to Post > Settings and scroll down. Select the checkbox Feature this post

    Create Tag

    To create a new tag, go to Dashboard > Tags > New Tag

    Create Author

    You can create multiple author in your site from dashboard. Go to Dashboard > Stuff > Invite people

    Click on Invite people and you will get a new popup. You have to add Email Address and select the staff Role. Lastly click on Send Invitation now button. An email notification will be sent to create an account on the specific Role.

    Code Injection

    Code injection is a great feature on Ghost. You can easily write styles and scripts for your site without editing the theme file. You can add various plugins code here like Google analytics

    Here you will two text field for code injections. 1. Site Header and 2. Site Footer

    Site Header

    If you write scripts on site header, it will show in <head> tag of header. It will load first in your site

    Site Footer

    If you write scripts on site footer, it will show at the closing of <body> tag. It will load last in your site

    Integrations and Custom Integrations

    Integrations are another cool feature of Ghost. You can connect a lot of thirdparty plugins or API using integrations. To check the integrations, go to Dashboard > Integrations. You will get some inbuilt integrations and custom integrations options

    Custom integrations

    To create custom integrations, click on + Add custom integration at the bottom of the page and you will get a popup and add a name of the integration and Create. I have create here Search and Github Deploy integration

    Labs

    Labs is another very important and beta tester parts of Ghost. Here your will get some core features as follows: Go to Dashboard > Labs

    1. Membership
    2. Import Content
    3. Export your content
    4. Delete All Content
    5. Night shift
    6. Redirects
    7. Routes

    Members

    If you want to get subscriptions and paid customers, you can use Members option in this panel. When you click on this you will get in details

    Migration Options

    You will get some options here like Import content, export content and delete content options

    Routes

    Routes is another important part. When you want to use different path link or custom files for pages and different homepage, you can use routes.yaml file to do that. Here is default .yaml for ghost.

    routes:

collections:
  /:
    permalink: /{slug}/
    template: index

taxonomies:
  tag: /tag/{slug}/
  author: /author/{slug}/

    Headers

    For header, we have used {{> header}} partials in folder partials/ header.hbs. In this file you can change the followings:

    Header

    1. Primary Navigation
    2. Social Icons
    3. Dark Light Icon
    4. Search
    5. Dark/Light
    6. Logo
    Logo

    To change the logo markup or text, find this structure on file. We have used 2 logos for Dark and Light mode. Light mode logo is a default logo. You can change the logo:

    <a href="{{@site.url}}">
    {{#if @site.logo}}
        <span class="logo-img"><img src="{{@site.logo}}" alt="{{@site.title}}"></span>
    {{else}}
        <h3>{{@site.title}}</h3>
    {{/if}}
</a>
    Primary Navigation

    For Primary navigation, go to Dashboard > Design > Primary Navigation

    Search

    For activating search option, see this

    Dark Light Feature

    Arkai supports dark light mode. By default, it is on Light mode. If you activate dark mode as default, use data-theme="dark" in HTML tag. Edit the file default.hbs in theme-file/default.hbs at line number 2

    <html lang="{{@site.lang}}" data-theme="dark">
    Signin and Signup

    You can change Members Menu from partials > navigation.hbs partials. You can easily change signin and signup links from navigation.hbs file at line number 17

    Footer

    We used very minimal footer in our theme. You will get all footer code partials > footer.hbs file. Here are the following parts:

    1. About Text
    2. Links
    3. Tag Cloud
    4. Connect
    About Text

    In footer, it shows About Text. You can change about text from partials > footer.hbs 

    <p>{{t "Arkai is a modern & minimal ghost blogging templates. We design and develop based on our customers demand. You can use this theme for your personal blog, portfolio site and other purposes."}}</p>
    Footer Social Profiles

    Change footer social profile links at footer.hbs and you can add more links aftre copying this. Change # with your links.

    <li>
    <a href="#">
        {{> icons/social-icons/instagram}}
    </a>
</li>

    If you want to add new social icons, go to partials > icons > social-icons folder. I have used svg icons from Feathericons. Download icons from here and add it in the folder. Change the icon’s extension .svg to .hbs

    facebook.svg --> facebook.hbs
    Tag Cloud

    We have showed 10 tags in the footer. If you want to change limit, you change limit="15" at line number 18.

    {{#get "tags" limit="15" include="count.posts" order="count.posts desc" filter="visibility:internal"}}
    Footer Links

    Useful Link comes from secondary menu. You can change secondary menu link from Dashboard > Design > Secondary Menu

    Copyright text

    You can change at footer.hbs file line number 41

    <p>{{t "All copyright reserved by Electronthemes. Published with "}}<a href="https://ghost.org/">{{t "Ghost"}}</a></p>

    Homepage

    In homepage, you will get some sections.

    1. Featured Posts
    2. Latest Posts

    Featured posts

    This section comes from featured post. If you add a post as featured, the post will add automatically in the featured slider. You can check how to add featured post

    Latest Posts

    Latest posts comes from latest articles. You can control the color of card with internal tags. If you use internal tag #blue, it will generate a class tag-hash-blue. You will get 11 color tags.

    • blue
    • purple
    • pink
    • carrot
    • nevy
    • violet
    • lightgray
    • rosepink
    • space
    • azure
    • grape

    You will find these colors with preview here

    If you don’t want to use feature image, you can use color tag to show nice post card.

    Custom Templates

    Custom template is a default setting on Ghost. It can be page template and post template. We have created some custom page and post template for the theme. The page template are as follows:

    Page Template

    • Membership
    • Account
    • Contact
    • Authors
    • Tags
    • Blog
    • Blogwithsidebar
    • Portfolio
    • Signin
    • Signup
    Selecting page template
    1. Create a new page
    2. Click on Settings to the right side and scroll down
    3. Select page template i.e. “Membership”
    Page url

    When you create page, please keep page slug like this.

    Page titlePage URl
    Membership/membership/
    Account/account/
    Signin/signin/
    Signup/signup/

    For other custom pages, you can add Authors, Tags, Contact, Portfolio, Blog, Blogwithsidebar page.

    Sidebar

    We have showed some elements on Post sidebar

    1. About Us
    2. Featured Posts
    3. Tag Clouds

    1. About us

    You will find it in the file partials > sidebar.hbs If you want to remove from sidebar, go to sidebar.hbs in the partials folder and remove line 1

     {{> sidebar-about}}

    2. Featured posts

    These posts are featured posts as like as featured slider. We have showed 3 limited posts in featured posts of sidebar. If you want to change, go to partials > sidebar-featured-posts.hbs and change limit

    {{#get "posts" filter="featured:true" limit="3" include="tags"}}

    2. Categories

    Here we have shown 10 tags based on the count of posts. If you want to change the in the file, you will get the file partials > sidebar-categories.hbs. If you want to change the limit, you can to it: limit="10". If you want to remove category from sidebar, remove this {{> sidebar-featured-post}} from sidebar.hbs file

    {{#get "tags" limit="10" filter="visibility:public" include="count.posts" order="count.posts desc"}}

    Membership and Subscriptions

    This is an awesome features of Ghost. If you want to make money with publications, you can use Membership features of Ghost. To enable members, go to Dashboard > Labs > Members

    Portal Settings

    In portal seetings, you can enable Subscribe button at the bottom right of the site.

    • Show signup and signin form in popup
    • Showing pricing plans
    • Changing ancient colors
    • Changing icons and text

    Stripe connection

    Connect your stripe account to get the payment from your subscribers

    Subscription Pricing

    Add or change your subscription pricing from here

    Post Access

    When you enable members, you can manage your posts who will see your default posts.

    Email Newsletter

    You can customize your newsletter template from here

    You can also change your support email and email newsletter setting with mailgun using this

    Pricing Tables

    Here we have used 3 pricing plans.

    1. Free/Basic Plan
    2. Monthly Plan
    3. Yearly Plan

    Change the text inside <li>{{t "..."}}</li>

    Free/Basic Plan: For changing basic plan {{> members/pricing-tables/plan-free}} partials is used. You will find partials > members > pricing-tables > plan-free.hbs

    <ul>
    <li>{{t "Free articles to read"}}</li>
    <li>{{t "Free updates"}}</li>
    <li>{{t "Weekly notifications"}}</li>
    <li>{{t "No discount"}}</li>
    <li>{{t "Weekly Support"}}</li>
</ul>

    Monthly Plan: For monthly plan {{> members/pricing-tables/plan-monthly}} partials is used. You will find partials > members > pricing-tables > plan-monthly.hbs

    <ul>
    <li>{{t "Full access to articles"}}</li>
    <li>{{t "Daily updates"}}</li>
    <li>{{t "Support independent publishing"}}</li>
    <li>{{t "Secure Payments"}}</li>
    <li>{{t "No advertisement"}}</li>
</ul>

    Yearly Plan: For yearly plan {{> members/pricing-table/plan-yearly}} partials is used. You will find partials > members > pricing-tables > plan-yearly.hbs

    <ul>
    <li>{{t "Full access to articles"}}</li>
    <li>{{t "Daily updates"}}</li>
    <li>{{t "Support independent publishing"}}</li>
    <li>{{t "Secure Payments"}}</li>
    <li>{{t "No advertisement"}}</li>
    <li>{{t "One step way to pay"}}</li>
</ul>

    Account Informations

    Free Subscriber information

    You can change the account information text on header page also. To change the information, go to free-subscriber-information.hbs file and you can change the information.

    Paid subscriber information

    You can change the account information text on header page also. To change the information, go to partials > members > subscriber-information.hbs

    Third Party Plugins

    We have created real time search options and Formspree for contact form.

    Search Options

    We have used Fuse.io for creating real time search. When you will type, you will get instant results. When you install the theme file, you have configure and add content api key on condeinjection

    1. Create a custom integrations
    2. Copy Content Api Key from your created custom integration
    3. Go to Code Injection > Site Header as follows
    <script>
    var contentApiKey = "your content api key"
</script>

    Contact form

    In contact form, we have used Formspree for getting form data. Change your email in <form> tag in partials > contact-form.hbs file at line number 6.

    <form class="row" action="https://formspree.io/youremail@domain.com"  method="POST">

    To change contact information, go to custom-contact.hbs file. You change all of the information.

    Google Map Embedded Code

    You can add your google map embedded code at line number 8 in the file custom-contact.hbs. You can create your own location map from this url

    After getting your location, you can click on Get HTML Code. You will get HTML and replace the code in your file.

    Disqus Comment box

    We have used discus comments for this theme. We have used our own discuss account. You can change easily with your Disqus shortname. Follow the process to create your disqus account and get a short-name.

    1. You can create your Disqus code in the next url: http://disqus.com/admin/create/
    2. Add a short-name for Website Name
    3. Your unique “Disqus URL” is your shortname copy that name and click finish registration.
    • Go to the directory where is your template.
    • Go to /content/themes/arkai/partials/disqus and open the next file: comment-box.hbs and git to line number 13 for disqus_shortname = “arkai”;
    • Change with your shortname, in this case ‘example-shortname’;
    • Save the file and upload to your ghost installation.
    • Optional, you can verify if all is correct clicking Verify on disqus steps (where we get our shortname).

    Github Deployment

    Arkai theme in ready for deploy on github easily. You can read the articles on Github deployment

    Development and Customization

    In this theme, we have used SCSS to develop and style fast. You can easily do it using Prepros. To edit SCSS code, follow the instruction:

    1. Unzip arkai.zip (this is the template only file) and remember where is the folder location.
    2. Install a SASS compiler, we recommend you to use Prepos 6, you can download it here.
    3. Click on “Browse” to add project on the middle side.

    Changing Primary and Secondary colors

    You can change easily primary, secondary, text color and other colors from _variable.scss file. Open assets/scss/_variables.scss file and change the color that you want, example:

    :root {
    --color-primary: #002b41;
    --color-text: #3f6172;
}

    Credits

    Fonts and Icon Fonts

    Images

    Plugins and libraries

    Changelog

    VERSION – 3.1.0: Release on 13 Jan 2021
    [+] Dark Version added

CHANGED FILES
 [+] _variables.scss
 [+] All SCSS files
 [+] package.json
 [+] default.hbs
 [+] index.hbs
 [+] post.hbs
 [+] page.hbs
 [+] subscribe.hbs
 [+] account.hbs
 [+] author.hbs
 [+] error.hbs
 [+] error-404.hbs
 [+] custom-authors.hbs
 [+] custom-tags.hbs
 [+] signin.hbs
 [+] signup.hbs
 [+] tag.hbs
 [+] partials/footer.hbs
 [+] partials/logo.hbs
 [+] partials/author-card.hbs
 [+] assets/img/logo/logo-white.png
 [+] assets/img/logo/logo.png
 [+] scripts.js
 [+] locales/en.json

ADDED NEW FILES
 [+] partials/icons/moon.hbs
 [+] partials/icons/sun.hbs
 [+] partials/members/free-subscriber-information.hbs
 [+] partials/members/subscriber-information.hbs
 [+] partials/members/notification.hbs
 [+] partials/members/visibility-content.hbs
 [+] partials/members/pricing-tables/plan-free.hbs
 [+] partials/members/pricing-tables/plan-monthly.hbs
 [+] partials/members/pricing-tables/plan-yearly.hbs
 [+] partials/sidebar/popular-author.hbs
 [+] partials/sidebar/popular-posts.hbs
 [+] partials/sidebar/popular-tags.hbs
 [+] partials/sidebar/popular-subscribe.hbs
 [+] partials/sidebar/share-post.hbs
 [+] partials/disqus-comment.hbs
 [+] _dark-version.scss
    VERSION – 1.0.0: Release on 13 April 2019
    [+] Initial Release