Skip to content

Petra Ghost Theme Changelog

Theme version: 1.0.3 Documentation

⚑ Back Up Your Current Theme First ⚑

Please backup your current theme before updating to a new version.

  • Log in to your Ghost admin
  • Go to Settings > Design > Change theme > Advanced
  • Download your active theme

Theme Updating

If you have not made any changes to your current theme files, download the latest version of the theme and upload it to your website. You do not need to worry about updating the files in the following steps.

To update the theme, first, download the new version from the theme update email. If you have lost the email or the download link, click here for more details.

To update your current theme, copy and replace the Changed Files below from the new theme version to your theme.

In case of any listed Deleted Files, safely remove the files from your theme.

If there are any New Files listed, copy the files to your theme with the same file path.

Copying a file from the new version to your theme will overwrite your file.

Only redo your customizations if that file receives an update.

If you made CSS customizations in Code Injection, there is no need to worry about these unless I mention any CSS changes.

Once you have finished, zip your theme files and upload the final zip file to your Ghost website.

Watch the following short video for a quick tutorial.

I recommend updating your theme to the latest version to avoid future compatibility issues with Ghost and API depreciation. This will also make it easier to update to future theme versions.

If you missed updating a version, such as your current theme being 1.0.0 and the latest version being 1.0.2, you do not need the intermediate 1.0.1 version to update. Instead, use the newest version (1.0.2) as a base for the 1.0.1 changelog. This is because the most recent version has the latest updated files. So, go through the 1.0.1 changelog and apply the file changes from 1.0.2.

Troubleshooting

If you encounter any issues while updating the theme, make sure to double-check the following:

  • Deactivate and then activate the theme again.
  • Upload the new/fresh theme version to see if the problem is from your theme or the latest version
  • Restart Ghost
  • Make sure you upload the routes.yaml file if received an update in the new theme version
  • Ensure that you have updated all the files mentioned in the changelog below.

Version: 1.0.3

  • Added Tags page (Demo — Docs)
  • Fixed callout cards background
  • Fixed toogle card button on Safari
  • Added webp format support
  • Update GitHub action for deployment
  • General design & typography and editor cards improvemenets
  • Support for the new Ghost show_title_and_feature_image feature

Changed files

package.json

page.hbs
custom-tags.hbs

partials/card-post.hbs
partials/card-tag.hbs
partials/home/intro.hbs
partials/structure/head.hbs
partials/typography.hbs
partials/upgrade.hbs

partials/css/dist/style-rtl.hbs
partials/css/dist/style.hbs

assets/js/app.min.js

/assets/sass/

(Copy all the `/sass/` folder and override your current theme one.

.github/workflows/deploy-theme.yml (.github is a hidden folder
by default on Mac systems https://www.avast.com/c-mac-show-hidden-files)
No worries about this if you are not using GitHub Actions.

VERSION - 1.0.2

Please make sure you have the latest version of Ghost before upgrading. This is required for the comments and search to work.

  1. Added Ghost Native Comments (docs).
  2. Added Ghost Native Search (docs).
  3. Dropdown menu support (docs).
  4. Ability to hide all the theme membership interface elements from the admin (docs)
  5. General design and typography fixes/improvements

Changed files

package.json
partials/card-post.hbs
partials/css/dist/style-rtl.hbs
partials/css/dist/style.hbs
partials/home/intro.hbs
partials/navigation.hbs
partials/newsletter-section.hbs
partials/page-header.hbs
partials/structure/header.hbs
post.hbs

/locales/

(Copy all the `/locales/` folder and override your current theme one.)

/assets/sass/

(Copy all the `/sass/` folder and override your current theme one.

/partials/comments/

(Copy all the `/partials/comments/` folder inside your /partials/ folder.)

New files

partials/drop-down-js.hbs

VERSION - 1.0.1

New

  1. Ghost 5.0 support
  2. Added reading time to posts

Improvements

  1. Updated Ghost Deploy Action version

Fixes

  1. Twitter embeded card alignment in small screens

Changed Files

package.json

partials/card-post.hbs
partials/page-header.hbs
partials/upgrade.hbs

partials/css/dist/style-rtl.hbs
partials/css/dist/style.hbs

.github/workflows/deploy-theme.yml

/locales/

(Copy all the `/locales/` folder and override your current theme one.)

The .github/workflows/deploy-theme.yml file is for the GitHub Deploy Action. It is part of the theme, but since the folder starts with a dot ( .github ) it might be hidden on your computer. No worries if you are not using GitHub for theme deployment.)

VERSION - 1.0.0

Initial Release

Have any questions? Contact Ahmad