Skip to content

Latest commit

 

History

History
88 lines (57 loc) · 1.78 KB

DEVELOPMENT.md

File metadata and controls

88 lines (57 loc) · 1.78 KB

DXOS Ghost Theme

A multi-column Ghost theme based on the default Ruby theme.

Blog: https://blog.dxos.org

Instructions

  1. Install the ghost cli.
pnpm -g i ghost-cli
  1. Install ghost locally.
mkdir ghost
cd ghost
ghost install local
  1. Clone the theme.
cd content/themes
git clone [email protected]:dxos/ghost-theme.git

Add a symlink from the Ghost installation to the theme directory.

cd ghost
cd content/themes
ln -s ../../ghost-theme
  1. Start Ghost and activate the theme.
ghost restart

Open settings.

Click "Change theme" (bottom right) and select "Installed" and "@dxos/ghost-theme".

Development

NOTE: You must have Node 18.19.0 installed.

From the theme directory run the dev server:

yarn
yarn dev

Restart ghost for major changes via ghost restart.

Configuring Prism

The theme uses a modified version of Prism for syntax highlighting. It uses generated and customized code from here.

Prism style are imported in the assets/css/screen.css file:

@import "prism.css";

The Prims script is imported from default.hbs.

<script src="{{asset "js/prism.js"}}"></script>

Build and Deploy

Run the following command then upload the theme from ./dist.

yarn zip

Configure the theme via settings: https://dxos.ghost.io/ghost/#/settings/design/edit

Upload the theme file: dist/dxos-ruby-dark.zip.