Back to Changelogs

Tripoli Changelog

Theme version: 1.0.3 — 02 September 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.3: Release on 2 Sept 2022

Please make sure you have the latest version of Ghost before upgrading.

  1. Added Ghost Native Comments (docs).
  2. Added Ghost Native Search (docs).
  3. Added reading time to the article page.
  4. Order Tags and Authors on custom pages by name to match the admin order.
  5. Fixed navigation divider not showing on Safari / iPhone. Thanks, Samuel & Dane!
  6. Fixed the Latest section image width. Thanks, Allan!
  7. Fixed header bottom border color in dark mode. Thanks, Allan!
  8. Change the content divider style from star to line.

New Files

partials/reading-time.hbs
partials/icon-search.hbs
partials/comments/ghost.hbs

Changed Files

post.hbs
default.hbs
gulpfile.js
package.json
custom-authors.hbs
custom-tags.hbs
partials/structure/header.hbs
partials/topper.hbs

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

assets/js/app.js
assets/js/app.min.js

/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.
Too many files changed here, so it’s easier to do this instead of
doing it one by one.)

Deleted Files

partials/search/search-setup.hbs
partials/search/search-form.hbs

VERSION - 1.0.2: Release on 24 June 2022

New

Improvements

  • Improve quotes and typeography style. The quotes styl is now similar to the editor one. Demo. Thanks Eugene!
  • Make it easy if you want to remove the footer Ghost and Tripoli links with CSS instead of editing the theme file. Docs
  • Added the redirects.yaml file for RSS redirect.

Since Tripoli uses /latest/ URL for recent posts, you can access the RSS feed at site.com/latest/rss/ instead of site.com/rss/. This update redirects site.com/rss/ – in case anyone used it before to subscribe to your website – to site.com/latest/rss/.

Go to your Ghost admin Settings > Labs > Redirects and upload the redirects.yaml file.

New Files

redirects.yaml
custom-tags.hbs
partials/card-tag.hbs

Changed Files

package.json
package-lock.json
partials/structure/footer.hbs

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

VERSION - 1.0.1: Release on 17 May 2022

New

  • Newsletters page with Labels. DemoDocs
  • Typography Drop Caps. Docs

Improvements

  • General design improvements including footer, social and share links, color mode switch icon, search
  • Updated Ghost Deploy Action version
  • Removed Node Sass and upgraded to Gulp 4

Fixes

  • Instagram and Twitter embed styles

New Files

custom-newsletters.hbs
partials/home-tags-sections.hbs
partials/newsletters-labels.hbs

Changed Files

home.hbs
package.json
partials/card-author.hbs
partials/card.hbs
partials/css/dist/style-rtl.hbs
partials/css/dist/style.hbs
partials/newsletter-form.hbs
partials/related.hbs
partials/social-icons.hbs
partials/teaser.hbs
partials/timestamp.hbs
.github/workflows/deploy-theme.yml
assets/js/app.min.js

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: Release on 30 April 2022

Initial Release

Support

Have any questions? I’m here to help.

Contact Ahmad
Ahmad Ajmi