Publishing turns your project into a theme file, uploads it to your connected Ghost site and makes it the active theme. Publish again after each change you want on the site.
Publishing changes only the theme. Your posts, pages, navigation and the theme settings you set in Ghost Admin stay as they are. To check the design before it goes live, use the preview in Fantasma, as Preview your theme shows.
Before you start
Your account has Pro. On the Free plan, Publish opens an offer to upgrade instead. See Free and Pro plans.
The project is connected to your Ghost site, as Connect your Ghost site shows. Until it is, the button at the top of the right sidebar reads Download.
Publish the theme
Important. Publishing replaces the active theme on your live site at once, in a few seconds. There is no draft step in Ghost.
Open your project in Fantasma.
At the top of the editor's right sidebar, click Publish. A menu opens with your site's address, when you last published, and the version this publish gets, such as v2.0.0-3.
Click Publish at the bottom of the menu. The button reads Publishing while Fantasma saves the project, builds the theme and uploads it.
When it works, "Theme published to Ghost" appears.
Fantasma keeps a copy of each published version in the project's history, named "Published" with the date. To see it, click the sliders icon in the icon rail, Project settings, then History. Restoring a version changes the project only. Publish again to put it on your site. See Restore an earlier version.
The theme's name and version in Ghost
Ghost lists the theme as fantasma- followed by the project's theme name. The theme name ridgeway-dispatch shows in Ghost as fantasma-ridgeway-dispatch. Fantasma makes the theme name from the project's name when you create the project, and renaming the project later does not change it. Each publish replaces the theme with that name in Ghost. A theme you had active before stays in Ghost's theme list, so you can switch back to it in Ghost Admin.
To change the theme name, open Project settings, click General and edit Theme name. If another of your projects has the same theme name, the line under the field says "Another project uses this name. Publishing one replaces the other."
The version is the version of Fantasma that built the theme and a build number, such as 2.0.0-3. The build number goes up only when the theme changed since your last publish or download. In the Publish menu, the version shows in plain text when your site has your latest design, and in color when it does not. Point at it to see why, either "The theme has new changes. Publish again to update Ghost." or "Fantasma was updated. Publish again to update Ghost."
What happens to routes.yaml
Ghost reads your site's addresses, such as a collection at /projects/, from a separate file, routes.yaml. Until Ghost has the new file, a new or moved address, such as a new collection, shows an error page on your live site. What happens to the file depends on the key you connected with, which Project settings › Ghost names under Access. Connect your Ghost site compares the two keys.
With a Staff access token, Fantasma uploads the new routes.yaml right after the theme when your routes changed.
With an Admin API key, Ghost does not let Fantasma upload it. When your routes changed, the Publish menu shows Download routes.yaml. Download it and upload it in Ghost, as Upload routes.yaml shows.
If the theme went up but the routes file did not, "Theme published, but routes.yaml wasn't uploaded" appears and a dialog offers the file to upload yourself.
Download instead of publishing
To get the theme file while connected, click the arrow beside the Publish button at the bottom of the menu, and select Download theme. Download your theme and upload it in Ghost explains the file.
When publishing does not finish
After 10 publishes in 5 minutes, or 30 in an hour, Fantasma asks you to wait. Try again after a few minutes.
"Theme uploaded, activation unconfirmed" means Ghost has the new theme, but Fantasma could not confirm that it became the active one. In Ghost Admin, open Settings, then Design & branding, and click Change theme to see which theme is active. If it is not yours, such as fantasma-ridgeway-dispatch, activate it.
Publishing turns your project into a theme file, uploads it to your connected Ghost site and makes it the active theme. Publish again after each change you want on the site.
Publishing changes only the theme. Your posts, pages, navigation and the theme settings you set in Ghost Admin stay as they are. To check the design before it goes live, use the preview in Fantasma, as Preview your theme shows.
Before you start
Publish the theme
Important. Publishing replaces the active theme on your live site at once, in a few seconds. There is no draft step in Ghost.
v2.0.0-3.When it works, "Theme published to Ghost" appears.
Fantasma keeps a copy of each published version in the project's history, named "Published" with the date. To see it, click the sliders icon in the icon rail, Project settings, then History. Restoring a version changes the project only. Publish again to put it on your site. See Restore an earlier version.
The theme's name and version in Ghost
Ghost lists the theme as
fantasma-followed by the project's theme name. The theme nameridgeway-dispatchshows in Ghost asfantasma-ridgeway-dispatch. Fantasma makes the theme name from the project's name when you create the project, and renaming the project later does not change it. Each publish replaces the theme with that name in Ghost. A theme you had active before stays in Ghost's theme list, so you can switch back to it in Ghost Admin.To change the theme name, open Project settings, click General and edit Theme name. If another of your projects has the same theme name, the line under the field says "Another project uses this name. Publishing one replaces the other."
The version is the version of Fantasma that built the theme and a build number, such as
2.0.0-3. The build number goes up only when the theme changed since your last publish or download. In the Publish menu, the version shows in plain text when your site has your latest design, and in color when it does not. Point at it to see why, either "The theme has new changes. Publish again to update Ghost." or "Fantasma was updated. Publish again to update Ghost."What happens to routes.yaml
Ghost reads your site's addresses, such as a collection at
/projects/, from a separate file,routes.yaml. Until Ghost has the new file, a new or moved address, such as a new collection, shows an error page on your live site. What happens to the file depends on the key you connected with, which Project settings › Ghost names under Access. Connect your Ghost site compares the two keys.routes.yamlright after the theme when your routes changed.If the theme went up but the routes file did not, "Theme published, but routes.yaml wasn't uploaded" appears and a dialog offers the file to upload yourself.
Download instead of publishing
To get the theme file while connected, click the arrow beside the Publish button at the bottom of the menu, and select Download theme. Download your theme and upload it in Ghost explains the file.
When publishing does not finish
After 10 publishes in 5 minutes, or 30 in an hour, Fantasma asks you to wait. Try again after a few minutes.
"Theme uploaded, activation unconfirmed" means Ghost has the new theme, but Fantasma could not confirm that it became the active one. In Ghost Admin, open Settings, then Design & branding, and click Change theme to see which theme is active. If it is not yours, such as
fantasma-ridgeway-dispatch, activate it."Publish failed" comes with the reason under it. Publishing to Ghost failed explains each one.