Documentation

White

Enamul Haque

Dec 4, 2024 — 12 min read

Getting Started

White is minimal and Lightweight Ghost theme. It is highly focused on bloggers, readers, writers, authors, etc. White is a super fast and mobile responsive theme that will encourage the visitor to read your blog. Built with HTML, CSS, js, scss and ready for premium subscription 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: support@electronthemes.com . Our support team will reply to you as soon as possible.

Theme Setup

White theme setup is very easy. If you have already installed a server for Ghost you can easily setup White 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

Download theme file from ElectronThemes Dashboard
Log in into your Ghost admin panel.
Go to Dashboard > Settings Icon > Design > Change Theme > Upload theme > Upload
Click Activate.

Uploading the theme via (FTP)

Follow the instructions

Login to your FTP account.
Unzip the white.zip file and copy White 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 “White“
Click Save.

Here I have used Cyberduck to upload file on server and I used subdomain. That is why I used White Folder

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

You can change Logo from Dashboard > Settings Icon > Design > Brand > Publication Logo

Publication Icon

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

Publication Cover

This is for showing site bookmark image. If you upload a cover image, it will in your site bookmark. To upload publication cover image, go to Dashboard > Settings Icon > Design > Brand > Publication cover

Language

You can use the publication in your native language. To change the language of your publication site, your theme must have support for translation. To change language:

Go to Settings > General > Publication Language and click on Expand
Change the default language en with your language code
You can find all the language code here: HTML Language Code Reference

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 account section is for showing Facebook, Twitter links of your site. Go to Dashboard > Settings > Social Accounts

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 > Settings > 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 > Settings > 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.

Fonts

Now you can choose your fonts from the fons list. follow the below instruction:

go to Settings > Design > Site-wide after select the font click the save button from top-right cornner.

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 fields for code injections. 1. Site Header and 2. Site Footer

Site Header is for load the scripts or style in the header
Site Footer will load the scripts or style in the footer

Go Dashboard > Settings > Code Injection

Integrations

Integrations are another cool feature of Ghost. You can connect a lot of third-party plugins or API using integrations. To check the integrations,

Login to Admin panel
Go to Dashboard > Settings > Integrations.
Click on + Add custom integration button and add a name for creating integration
You can use Content API Key or Admin API Key or API URL

Labs

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

Import Content
Export your content
Delete All Content
Redirects
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 are another important part. When you want to use different path links or custom files for pages and different homepages, you can use routes.yaml file to do that. Here are the default .yaml for ghosts.

routes:
collections:
 /:
   permalink: /{slug}/
   template: index
taxonomies:
 tag: /tag/{slug}/
 author: /author/{slug}/

Homepage

On the homepage, you will get some sections.

Hero section
Featured Posts
Daily Update News

Hero Section

Normally you get a background color in your hero section.

You can use a video background instead of background color . follow the below instruction:

go to Settings > Design > Homepage

Input your video code inside the box and save it. you will get output like this :

Featured Posts

We have shown a slider on the homepage will the featured posts. If you set a post as featured, it will be added automatically in the slider.

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

Copyright text

You can change at footer.hbs file line number 6

<div class="col-md-10 mx-auto footer-text-wrapper">
  <p>                     {{t "Copyright"}}   {{ date format="YYYY" }} , {{ @site.title }} - {{ @site.description }}. All Right Reserved.</p>
</div>

Change the text inside {{t ""}}

Custom Templates

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

Page Template

Membership
Account
Contact
Authors
Tags
Signin
Signup

Selecting page template

Create a new page
Click on Settings on the right side and scroll down
Select page template i.e. “Membership”

Page url

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

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

For other custom pages, you can add Authors, Tags, and Contact pages.

Post Template

Post Full Width
Post Left Sidebar

We have used 1 post page style in this theme. You can choose as following:

Membership and Subscriptions

The membership page is helping your customer to understand the plan and compare the differences between your offers. Here are the step-by-step instructions:

Create Membership page

Create a new page and open the page settings panel from the right side of the page
Select the page template: Membership at the bottom dropdown
Publish the page

Create Tiers and show them on the membership page

Go to Settings > Membership in your Ghost Admin
Go to MEMBERSHIP TIERS at the bottom
Connect your Stripe Account if you don’t have Stripe connected
Expand the Premium position and click on +Add tier to add a new tier name, description, list of benefits, and price for monthly and yearly.
Add tier to activate
Now, go to portal settings, you can control enable and disable tiers appearing on the membership page.

Create Account Page

Create a new page and open the page settings panel from the right side of the page
Select the page template: Account at the bottom dropdown
Publish the page

Search Options

From Ghost 5.7, they released a Ghost Native Search. We implemented this feature on this

If you install this theme in your ghost dashboard, Ghost Native Search will be activated automatically.

We have created third-party real-time search options for the theme file also. You can activate the search easier. When you install the theme file, you have configured and add the content API key on the code injection

Create a custom integrations
Copy Content API Key from your created custom integration

After collecting the Content API Key we go to : Settings > Design > Site-Wide and insert to below search content API box.

Contact form

In the contact form, we have used Formspree for getting form data.

You need to create a Formspree account
Collect form endpoint
Add this to Settings > Design > Site Wide > Contact form endpoint URL

To change contact information, go to custom-contact.hbs file. You change all the information. Line Number; 55 to 81

<h4>{{t "Contact Us"}}</h4>
   <p>{{t "Our Support is open 24/7 call us anytime :-)"}}</p>
</div>
<div class="row">
<div class="col-md-4">
<div class="single-info">
<div class="info-icon">
    <i class="fa fa-volume-control-phone"></i>
</div>
    <p>{{t "+ (123) 7859 5624"}}</p>
</div>
</div>
<div class="col-md-4">
<div class="single-info">
<div class="info-icon">
   <i class="fa fa-envelope-open-o"></i>
</div>
<p>{{t "Youremail@gmail.com"}}</p>
</div>
</div>
<div class="col-md-4">
<div class="single-info">
<div class="info-icon">
   <i class="fa fa-paper-plane-o"></i>
</div>
    <p>{{t "11/7 Saint Archas, Sydney"}}</p>
</div>

Comments

Ghost Native Comment

Ghost has a native comment system. Only members of your website can comment on your post. To activate native comment:

Go to the Settings > Membership > Commenting in the Ghost Admin.
Change the Commenting level to All members or Paid-members only.
Click on the Save button

GitHub Deployment

The white theme in ready for deployment on GitHub easily. You can read the articles on the Github deployment

Development and Customization

In this theme, we have used SCSS to develop and style fast. You must have installed Nodejs and SASS on your computer.

Open a theme file in your editors like VSCode or Sublime Text
Open the terminal in the theme folder
Run command npm run sass

Alternatively, You can easily do it using Prepros. To edit SCSS code, follow the instruction:

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

Credits

LIBRARIES/TOOLS

Bootstrap
jquery
Owl Carousel

FONTS

Lemon/Milk
Libre Baskerville
Noto Sans

IMAGES

All images those are included in the live preview are taken from unsplash.com

Changelog:

VERSION – 4.3.2: Released on 31 May 2023

* Removed all deprecated code
* Small css issues fixed

[+] CHANGED FILES
    assets/scss/theme.scss
    partials/hero.hbs
    package.json

VERSION – 4.3.1: Released on 16 May 2023

* Multi font custom option added
* Homepage video background added
* Ghost native-comments added
* Removed all deprecated code
* Small css issues fixed

[+] CHANGED FILES
    assets/scss/theme.scss
    assets/js/scripts.js
    partials/hero.hbs
    partials/navigation.hbs
    partials/related-posts.hbs
    partials/post-navigation.hbs
    partials/post-card.hbs
    partials/headerSingle.hbs
    partials/headerHome.hbs
    partials/footer.hbs
    partials/loop.hbs
    partials/members/membership-navigation.hbs
    partials/icons/search.hbs
    partials/icons/chevron.hbs
    partials/icons/link.hbs
    partials/members/pricing-tables/pricing-free.hbs
    partials/members/pricing-tables/pricing-table.hbs
    partials/members/subscriber-information.hbs
    custom-contact.hbs
    custom-archive.hbs
    post.hbs
    index.hbs
    default.hbs
    page.hbs
    package.json

[+] NEWLY ADDED
    assets/scss/_prism.scss
    assets/scss/_kg-card.scss
    partials/google-fonts.hbs
    partials/comments/native-comments.hbs
    custom-post-with-table-of-content.hbs
    partials/logo.hbs

[-] DELETED FILES
    partials/comments/cove-comment.hbs
    partials/comments/disqus-comment.hbs

VERSION – 4.3.0: Released on 18 June 2022

* Added Support for Ghost 5.0
* Removed all deprecated code
* Small css issues fixed
* Updated English translation file

[+] CHANGED FILES
    assets/scss/_membership.scss
    assets/scss/_header.scss
    assets/css/theme.css
    partials/members/pricing-tables/pricing-free.hbs
    partials/members/pricing-tables/plan-table.hbs
    partials/social-share.hbs
    custom-membership.hbs
    custom-account.hbs
    partials/footer-scripts.hbs
    default.hbs
    package.json
    locales/en.json

Version 3.0.0
---------------------------------------
[+] NEWLY ADDED
    Subscription and Membership
    Dark and Light Version
    Updated styles
    Updated SCSS
    svg logo

[-] DELETED FILES
    routes.yaml

Version 2.1.0
---------------------------------------
Upated with ghost new version 2.23.2
Bug fixed and performance upgrated

----------------------------------------
Language support added
compatible with new ghost version
post card and author page design upgraded
prev and next post navigator changed

Version 2.0.0
---------------------------------------
Upated with ghost new version 2.13.1
Bug fixed and performance upgrated

----------------------------------------
Whole design updated
3 author list page style added
404 page updated
Contact page design updated
Search problem fixed with the new version
Documentation updated
Online Documentation added