Documentation

Delas

Enamul Haque

Enamul Haque

— 19 min read
Delas

Getting Started

Delas is a minimal ghost blogging theme. It is built for bloggers, journalists, freelancers, editors, authors, writers, developers. Delas is fully responsive, light-weight, superfast ghost theme and 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 you within 6 hours.

Theme Setup

Delas theme setup is very easy. If you have already installed a server for Ghost you can easily setup Delas 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  settings > design > Change Theme > upload theme and then upload your theme
  • Click Activate.

Uploading the theme via (FTP)

Follow the instructions

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

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

General Setup

Publication Info

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

  • Title
  • Description
  • Site Timezone
  • Publication Language

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

Upload logo for light mode Settings > Design > Site Wide > Dark mode logo

Favicon Icon or 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


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 langauge:

  1. Go to Settings > General > Publication Language and click on Expand
  2. Change the default language en with your language code
  3. 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 > Settings > General > Site Meta Settings

Social Accounts

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

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,

  1. Login to Admin panel
  2. Go to Dashboard > Settings > Integrations.
  3. Click on + Add custom integration button and add a name for creating integration
  4. 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.

  1. Import Content
  2. Export your content
  3. Delete All Content
  4. Redirects
  5. 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}/

Dark and Light Mode

We have used the dark version by default. When you will install the theme file on your ghost server, you will get your website as a dark version.

If you want to use the Light version for default, you can change it from your custom settings. You will find the settings Settings > Design > Site Design > Site-WIde > Select Color Scheme

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

  1. Site Title / Logo image
  2. Secondary navigation
  3. Social Connect
  4. Copyright text

Social Connects

We have shown some social profiles in the footer. If you want to change links or icons, go to footer.hbs file and line number 25 and change the link.

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

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

Copyright text

You can change footer copyright text from Dashboard > Settings Icon > Design > Site-Wide > Site Footer

Homepage

On the homepage, you will get some sections.

  1. Featured Slider
  2. Top Authors
  3. Popular posts
  4. All Posts
  5. Subscribe
  6. Tag List Slider

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. See this section how to add featured post

Featured slider post limit is 5. If you want to increase or decrease post limit, go to partials/featured-slider.hbs and edit limit="5".

{{#get "posts" limit="5" filter="featured:true" include="tags,authors"}}

Add minimum 2 posts as featured posts to get the slide view as the demo

If you want to display off /on Featured Slider Post from the homepage, please go to Settings > Design > Homepage > Show featured Post

Best Authors

These authors come from the author lists who posted the most. I have shown here only 5 authors. If you want to change the limit, go to Partials > top-authors.hbs and change the limit at line number 1

{{#get 'authors' limit='5' include='count.posts' order="count.posts desc"}}

If you want to display off /on Top Post From Best Authors from the homepage, please go to Settings > Design > Homepage > Show best authors

Popular posts come from an internal tag #popular. If you add `#popular tag in any posts, the post will be automatically added in this section.

We have shown 10 limited posts here, If you want to change the limit, edit this number limit="10". If you want to change the internal tag name, change the tag filter="tag:hash-popular"

{{#get "posts" limit="10" filter="tag:hash-popular" visibility="all" include="tags,authors" as |popular|}}

if you add internal tag like #popular, use hash-popular. Otherwise if you use public tag like: popular, use popular without hash-

Pagination Type

If you want you can change the pagination type ( Button Mode default ) just select one. You will find the settings: :

Settings > Design > Homepage > Select pagination

Subscribe

If you want to change subscribe section text, you can do it from subscribe-section.hbs of partials folder.

If you want to remove it from the homepage, remove this code

{{!-- suscribe --}}
{{> "subscribe-section"}}

Post Layout

If you want you can change the Post Layout ( default to Post With Sidebar ) just select one. You will find the settings:

Settings > Design > Post > Default Post Layout

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
  • Authors
  • Signin
  • Signup
  • Portfolio

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

Post Template

  1. Post with Sidebar

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

We have showed some elements on Post sidebar

  1. Popular Author
  2. Featured posts
  3. Popular Tags
  4. Subscribe

You will find it in the file partials > sidebar > popular-author. If you want to remove from sidebar, go to sidebar.hbs in the partials folder and remove this {{> sidebar/popular-author}}

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" limit="3" filter="featured:true" include="authors,tags"}}

We have showed 10 popular tags based on posts counting number. If you want to change, go to partials > sidebar > popular-tags.hbs and change limit.

{{#get "tags" limit="10" include="count.posts" order="count.posts desc"}}

4. Subscribe

We have showed subscribe option in the sidebar. To change the content, go to partials > sidebar > sidebar-subscribe.hbs

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

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

Create Tiers and show on membership page

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

Create Account Page

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

Search Options

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

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 easily. When you install the theme file, you have configure and add content api key on code injection

  1. Create a custom integrations
  2. 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.

Final Result

Contact form

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

  1. You need to create Formspree account
  2. Collect form endpoint
  3. Add this to Settings > Design > Site Wide > Contact form action code

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

Comments

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

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

If you want to use other comment feature like Cove or Disqus. You can use. This theme supports both comment box. You will find both comment box in the partials folder in the theme file.

Cove Comment

Cove is popular comment system for ghost. You can easily manage comments for members and paid members posts. It is a premium comment sytem. We have a setup for cove comments. You easily change with your comments.

  • Create account in Cove.chat and Login
  • Click on +Create a New Account and add a name
  • Copy the publication ID and paste it in Settings > Design > Site Design > Post
  • Publication ID. Copy this ID and paste to Cove publication field.
  • Replace publication id with your account code

Disqus Comment

We have used discus comments for this theme. We have used our own disqus 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.
  4. Go to Settings > Design > Site Design > Post and Select Disqus from Select comment select option.
  5. Go to Settings > Design > Site Design > Post > Disqus shortname;
  6. Change with your shortname, in this case ‘example-shortname’;
  7. Save.

Disable Comments from site
If you want to disable comments from your posts, select Disable from Settings > Design > Site Design > Post > Select Comment. If will disable comments from your site

Github Deployment

Delas 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 must have installed Nodejs and SASS on your computer.

  • Open theme file in your editor like VSCode or Sublime Text
  • Open 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:

  1. Unzip delas.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 main color from Ghost Settings: Settings > Design > Brand > Accent color

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: #1e272e;
   --color-secondary: #c2c2c2;
   --color-text: #d4d3d3;
   --color-text-two: #d4d3d3;
}

Credits

Fonts and Icon Fonts

Images

Plugins and libraries

Changelog

VERSION – 4.8.0: Release on 21 September 2023

* ADDED: Header card improvements feature
* FIXED: Small bug fixes and performance improvements

[+] CHANGED FILES
    assets/css/style.css
    page.hbs
    package.json

VERSION – 4.7.2: Release on 17 April 2023

* FIXED: Post article content issues
* FIXED: Signin and Signup page issues
* FIXED: Lightbox issues

[+] CHANGED FILES
    assets/css/style.css
    assets/js/scripts.js
    assets/scss/_responsive.scss
    assets/scss/_header.scss
    assets/scss/_author.scss
    assets/scss/_blog-single.scss
    assets/scss/_latest-posts.scss
    assets/scss/_sidebar.scss
    assets/scss/_dark-light.scss
    assets/scss/_tag.scss
    assets/scss/_variables.scss
    assets/scss/_membership.scss
    assets/scss/_featured-slider.scss
    assets/scss/_footer.scss
    assets/scss/_fonts.scss
    assets/scss/_styleguide.scss
    partials/post-card-full.hbs
    partials/post-card.hbs
    custom-account.hbs
    custom-authors.hbs
    custom-membership.hbs
    custom-signin.hbs
    custom-signup.hbs
    page.hbs
 	partials/featured-slider.hbs
 	partials/post-default.hbs
 	partials/post-with-sidebar.hbs
 	partials/related-posts.hbs
 	partials/share-post.hbs
 	partials/social-share.hbs
 	partials/tag-slider.hbs
 	partials/navigation.hbs
 	partials/footer.hbs
 	partials/sidebar/popular-post.hbs
 	partials/members/pricing-tables/plan-paid.hbs
 	.github/workflows/deploy-theme.yml
 	package.json

VERSION – 4.7.1: Release on 8 April 2023

* Small css issues fixed
* Gallery issues fixed
* Hero slider height issues updated

[+] CHANGED FILES
    assets/css/style.css
    assets/scss/_responsive.scss
    assets/scss/_header.scss
    assets/scss/_featured-slider.scss
    assets/scss/_blog-single.scss
    assets/scss/_latest-posts.scss
    assets/scss/_sidebar.scss
    assets/scss/_dark-light.scss
    assets/scss/_bookmark.scss
    assets/scss/_variables.scss
    assets/scss/_author.scss
    custom-account.hbs
    custom-membership.hbs
    partials/members/pricing-tables/plan-monthly.hbs
    partials/members/pricing-tables/plan-paid.hbs

VERSION – 4.7.0: Release on 28 December 2022

* FIXED: Mobile menu style
* Small css issues fixed

[+] CHANGED FILES
    assets/css/style.css          
    assets/scss/_blog-single.scss 
    assets/scss/_footer.scss     
    assets/scss/_responsive.scss 
    assets/scss/_styleguide.scss 
    assets/js/plugins.js         
    assets/js/scripts.js         
    partials/post-default.hbs     
    partials/post-with-sidebar.hbs
    partials/related-posts.hbs
    custom-authors.hbs           
    partials/related-posts.hbs   
    package.json

VERSION – 4.6.1: Release on 15 November 2022

* ADDED: Table of content support
* Small css issues fixed

[+] CHANGED FILES
    assets/css/style.css
    partials/featured-slider.hbs
    partials/post-default.hbs
    partials/post-with-sidebar.hbs
    default.hbs
    package.json

VERSION – 4.5.0: Release on 24 October 2022

* ADDED: Multiple fonts support
* Small css issues fixed

[+] CHANGED FILES
    assets/css/style.css
    default.hbs
    package.json
    partials/subscribe-section.hbs
    assets/js/scripts.js
    partials/top-authors.hbs
    partials/post-default.hbs

[+] ADDED FILE
    partials/google-fonts.hbs

VERSION – 4.5.0: Release on 20 August 2022

* Small css issues fixed
* Native Search option added
* Native Comment option added
* Footer Image issues fixed
* REMOVED: Related posts option removed
* REMOVED: Related posts show/hide option removed
* REMOVED: Author option removed
* Add Native-search option
* Added native-comments option

[+] CHANGED FILES
    assets/css/style.css
    assets/js/scripts.js
    assets/js/scripts.js
    assets/scss/_variables.scss
    assets/scss/_header.scss
    assets/scss/_footer.scss
    assets/scss/_blog-single.scss
    assets/scss/_reset.scss
    assets/scss/_component.scss
    assets/js/scripts.js
    assets/js/plugins.js
    partials/header.hbs
    partials/footer.hbs
    partials/navigation.hbs
    partials/post-with-sidebar.hbs
    partials/sidebar.hbs
    partials/related-posts.hbs
    partials/post-default.hbs
    partials/navigation.hbs
    partials/header.hbs
    partials/comments/disqus-comment.hbs
    partials/comments/cove-comments.hbs
    package.json
    default.hbs
    custom-contact.hbs
    locales/en.json


[+] ADDED FILE
    partials/comments/native-comments.hbs

VERSION – 4.4.0: Release on 17 July 2022

------------  VERSION - 4.4.0: Release on 17 July 2022  ------------
* Small css issues fixed
* Small bug fixes and performance improvements

[+] CHANGED FILES
    assets/css/style.css
    assets/js/scripts.js
    assets/js/plugins.js
    assets/scss/_header.scss
    assets/scss/_blog-single.scss
    assets/scss/_component.scss
    assets/scss/_dark-light.scss
    assets/scss/_featured-slider.scss
    assets/scss/_footer.scss
    assets/scss/_membership.scss
    assets/scss/_reset.scss
    assets/scss/_responsive.scss
    assets/scss/_styleguide.scss
    assets/scss/_top-authors.scss
    assets/scss/_variables.scss
    assets/scss/_contact.scss
    assets/scss/_gallery.scss
    assets/scss/_bookmark.scss
    default.hbs
    package.json
    locales/en.json
    tag.hbs
    author.hbs
    page.hbs
    custom-account.hbs
    custom-contact.hbs
    custom-signin.hbs
    custom-signup.hbs
    error-404.hbs
    error.hbs
    partials/related-posts.hbs
    partials/post-loop.hbs
    partials/navigation.hbs
    partials/footer.hbs
    custom-membership.hbs
    custom-signin.hbs
    custom-signup.hbs
    partials/featured-slider.hbs
    partials/icons/loader.hbs
    partials/post-default.hbs
    partials/members/visibility-content.hbs

VERSION – 4.3.0: Release on 18 June 2022

------------  VERSION - 4.3.0: Release on 18 Jun 2022  ------------
* Added Support for Ghost 5.0
* Removed all deprecated code
* Small css issues fixed
* Updated English translation file

[+] CHANGED FILES
    assets/css/style.css
    assets/js/scripts.js
    assets/scss/_component.scss
    assets/scss/_header.scss
    assets/scss/_blog-single.scss
    assets/scss/_component.scss
    assets/scss/_membership.scss
    default.hbs
    index.hbs
    package.json
    tag.hbs
    author.hbs
    custom-account.hbs
    partials/header.hbs
    partials/pagination.hbs
    partials/post-loop.hbs
    custom-membership.hbs
    partials/members/notification.hbs
    partials/members/pricing-tables/plan-free.hbs
    partials/members/pricing-tables/plan-monthly.hbs
    partials/members/pricing-tables/plan-yearly.hbs

VERSION – 4.1.0: Release on 05 Jun 2021

------------  VERSION - 4.1.0: Release on 05 Jun 2021  ------------
. Compatible with ghost version 4.0
. Added support for public preview posts for members only posts
. Support for new price plan helper
. Updated deprecated functions
. Small bug fixes and performance improvements

CHANGED FILES
[+] _variables.scss
[+] _dark-light.scss
[+] _portfolio.scss
[+] _membership.scss
[+] _blog-single.scss
[+] _sidebar.scss
[+] _fonts.scss
[+] style.css
[+] plugins.js
[+] scripts.js
[+] default.hbs
[+] custom-portfolio.hbs
[+] custom-post-with-sidebar.hbs
[+] custom-signin.hbs
[+] custom-signup.hbs
[+] partials/members/pricing-tables/plan-free.hbs
[+] partials/members/pricing-tables/plan-monthly.hbs
[+] partials/members/pricing-tables/plan-yearly.hbs
[+] partials/members/subscriber-information.hbs
[+] partials/sidebar/sidebar-subscribe.hbs
[+] partials/subscribe-section.hbs
[+] package.json

ADDED NEW FILES
[+] partials/icons/loader.hbs
[+] partials/sidebar/popular-author.hbs

DELETED FILES
[-] _components.scss
[-] Muli Font

VERSION – 3.2.0: Release on 19 Dec 2020

CHANGED FILES
     [+] partials/top-authors.hbs
     [+] partials/sidebar/featured-posts.hbs
     [+] _variable.scss
     [+] package.json
     [+] scripts.js
     [+] plugins.js
     [+] locales/en.json

 NEWLY ADDED
      [+] Fuse.js search
      [+] Mulish fonts

 DELETED FILES
     [-] Ghost Finder JS
     [-] Muli Font

VERSION – 3.1.0: Release on 17 Aug 2020

[+] 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

Read more