Back to Changelogs

Beirut Changelog

Theme version: 1.0.2 — 24 May 2022 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 made no changes to your current theme files, download the latest theme version and upload it to your website—no need to worry about updating the files in the following steps.

First, download the new theme version from the theme update email. If you 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 any New Files are listed, copy the files to your theme with the same file path.

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

Redo your customizations only if that file receives an update.

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

Once 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 always recommend updating your theme to the latest theme version to avoid future Ghost compatibility and API depreciation issues. Also, it will be easier to update to future theme updates, too.

If you missed updating a version, for example, your current theme is 1.0.0, and the latest one is 1.0.2, does it mean you need the middle 1.0.1 version to update your current version? No. Instead, use the newest version (1.0.2) as a base for the 1.0.1 changelog. 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

In case you encounter any issue while updating the theme, do/double-check the following:

  • Deactivate and activate the theme again
  • Upload the new/fresh theme version to see if the problem is from your theme or the new version
  • Restart Ghost
  • Make sure you uploaded the routes.yaml file if it is updated in the new theme version
  • Make sure you updated all the mentioned files in the changelog below

VERSION - 1.0.2: Release on 24 May 2022

New

  1. Ghost 5.0 support

Improvements

  1. Updated Ghost Deploy Action version

Fixes

  1. Twitter embeded card alignment in small screens

Changed Files

package.json

partials/card-work.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.1: Release on 03 Feb 2022

Fixes

  1. Content link underline not showing properly in small screens
  2. Paragraph spacing for content paragraphs

Improvements

  1. Footer subscribe form alert styles
  2. Content quotation mark styles

Thanks Dave!


Changed Files

gulpfile.js
package.json

custom-about.hbs                              

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

VERSION - 1.0.0: Release on 21 Jan 2022

Initial Release

Support

Have any questions? I’m here to help.

Contact Ahmad
Ahmad Ajmi