Skip to content

Tripoli Ghost Theme — Changelog

Theme version: 1.0.7 — 22 January 2024 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.7: Release on 22 Jan 2024

  • Performance improvements
  • Accessibility improvements
  • Moving fonts locally instead of Google Fonts
  • General design improvements

New Files

partials/preload.hbs

Changed Files

author.hbs
gulpfile.js
package.json

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

partials/loop.hbs
partials/share.hbs
partials/teaser.hbs
partials/topper.hbs
partials/card-author.hbs
partials/card-editors-pick.hbs
partials/card.hbs
partials/structure/head.hbs
partials/structure/header.hbs

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

/assets/

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

VERSION - 1.0.6: Release on 03 Nov 2023

  • Added Table Of Contents (docs)
  • Added Mastodon and Discord social links (docs)
  • Added homepage post card for access label (docs)
  • Added post excerpt to post cards (docs)
  • Feature image webp format to improve loading performance
  • Added pt-br.json translation file. Thanks, Diego
  • Accessibility fix for the color mode button
  • Change Twitter icon to 𝕏
  • Fixes for Germain translation. Thanks Pit Gottschalk
  • Fixed visible author posts in the authors page
  • General design & typography and editor cards improvemenets
  • Support for the new Ghost show_title_and_feature_image feature

New Files

partials/icons/discord.hbs
partials/icons/mastodon.hbs
partials/table-of-contents.hbs
partials/visibility-label.hbs

Changed Files

gulpfile.js
package.json

page.hbs
post.hbs
author.hbs

partials/latest.hbs
partials/related.hbs
partials/share.hbs
partials/social-icons.hbs
partials/structure/head.hbs
partials/structure/header.hbs
partials/dark-mode-js.hbs
partials/editors-picks.hbs
partials/card-author.hbs
partials/card-editors-pick.hbs
partials/card.hbs
partials/tag-section.hbs
partials/teaser.hbs
partials/topper.hbs

partials/css/dist/style-rtl.hbs
partials/css/dist/style.hbs
partials/dark-mode-js.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.

.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.5: Release on 04 April 2023

  1. Fixed the Callout Card style background
  2. Improve the Header Card spacing
  3. Fixed the archive page title
  4. Fixed the Toggle Card icon on Safari. Thanks, Evans.
  5. Adjusted the width of galleries and wide images.
  6. Fixed a translation issue with the dark mode switch button. Thanks, Thomas.
  7. Corrected the translations for “See All” and “Editors’ Picks”.
  8. Fixed the date order for related posts.
  9. Added a Right-to-Left layout theme setting (docs).
  10. Added a theme setting to format post dates. (docs).
  11. Added a link to the Tripoli theme documentation in the Ghost admin, so you can access it anytime. (Settings > Design) Tripoli Ghost theme docuemtation link
  12. Added responsive support for Loom videos
  13. Updated GitHub action version
  14. General design improvements

Changed Files

gulpfile.js
package.json

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

partials/css/dist/style-rtl.hbs
partials/css/dist/style.hbs
partials/dark-mode-js.hbs
partials/related.hbs
partials/structure/head.hbs
partials/structure/header.hbs
partials/tag-section.hbs
partials/timestamp.hbs
partials/upgrade.hbs
custom-archive.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. If you want the exact files:

assets/sass/components/_card-callout-editor.scss
assets/sass/components/_card-general-editor.scss
assets/sass/components/_card-header-editor.scss
assets/sass/components/_card-toggle-editor.scss
assets/sass/components/_card.scss
assets/sass/components/_color-mode.scss
assets/sass/components/_teaser.scss
assets/sass/components/_topper.scss
assets/sass/elements/__all.scss
assets/sass/elements/_fieldset.scss
assets/sass/elements/_input.scss
assets/sass/elements/_fieldset.scss

VERSION - 1.0.4: Release on 23 Nov 2022

  1. Fixed Pinterest embed style.
  2. Fixed the navigation divider style in Safari.
  3. Fixed editors picks posts order.
  4. Fixed content images link by disabling lightbox if the image is linked.
  5. New Archive page to show all posts ordered by month. (docs).
  6. New admin setting to show how many editors picks posts to show. (docs).
  7. New WhatsApp and Pinterest sharing icons.
  8. New admin settings to add your Pinterest profile link with other social site footer icons. (docs).
  9. New admin setting to show how many posts to show in the homepage top Latest column. (docs).
  10. Added See all button to the homepage tags section.
  11. New admin setting to set how many posts to show for every tag section on homepage. (docs).
  12. Ability to hide all the theme membership interface elements from the admin. This includes the header Log in and Subscribe links. (docs).

Thanks, Dane, Steven, Eugene, Justyna, and Samuel, for your feedback and suggestions!

Changed Files

bower.json
gulpfile.js
package.json
assets/css/style-min-rtl.css
assets/css/style-min.css
assets/js/app.js
assets/js/app.min.js

partials/css/dist/style-rtl.hbs
partials/css/dist/style.hbs
partials/editors-picks.hbs
partials/hero.hbs
partials/social-icons.hbs
partials/structure/header.hbs
partials/tag-section.hbs
partials/share.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.

New Files

custom-archive.hbs

/partials/icons/

(The `/partials/icons/` folder)

VERSION - 1.0.3: Release on 2 Sept 2022

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

Have any questions? Contact Ahmad