Minimal Ghost Theme

Active Pure Nim score 65/100 · last commit 2026-07-23 · 2 stars · tests present · no docs generated

Summary

Latest Version Unknown
License Unknown
CI Status Failing
Stars 2
Forks 0
Open Issues 0
Last Commit 2026-07-23
Downloads 0
Last Indexed 2026-07-31 04:41

Installation

nimble install Minimal Ghost Theme
choosenim install Minimal Ghost Theme
git clone https://gitlab.com/matdevdug/minimal-ghost-theme

OS Compatibility

Platform Linux macOS Windows FreeBSD OpenBSD NetBSD Android iOS WASM Embedded
Minimal Ghost Theme ✓ ✓ ✓ - - - - - - -

Source

Repository https://gitlab.com/matdevdug/minimal-ghost-theme
Homepage https://gitlab.com/matdevdug/minimal-ghost-theme
Registry Source gitlab

README

Minimal Ghost Theme

A minimal Ghost theme with a focus on simplicity and readability. Feel free to open issues or pull requests if you have any suggestions or improvements. Actively maintained.

Customization Guide

This theme is highly customizable through CSS variables. You can modify these variables by adding custom CSS in your Ghost admin panel (Settings → Code injection → Site Header) or by editing the assets/css/screen.css file directly.

Colors

:root {
    --color-bg: #fff;          /* Background color */
    --color-text: #222;        /* Main text color */
    --color-link: #2b6cb0;     /* Link color */
    --color-secondary: #666;    /* Secondary text color */
    --border-subtle: #e2e8f0;  /* Border color */
}

Typography

:root {
    --font-sans: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", "Helvetica Neue", Arial, sans-serif;
    --font-serif: "Charter", "Georgia", "Times New Roman", serif;
    --font-mono: "JetBrains Mono", "SF Mono", "Fira Code", Consolas, monospace;
}

To change fonts, replace the font names in the respective variables. For example, to use a custom font:

:root {
    --font-serif: "Your Custom Font", Georgia, serif;
}

Layout

:root {
    --content-width: 650px;    /* Maximum width of content */
}

Code Blocks

:root {
    --code-bg: #f7fafc;        /* Inline code background */
    --code-block-bg: #f8fafc;  /* Code block background */
    --code-text: #1a202c;      /* Code text color */
    --code-border: #edf2f7;    /* Code block border */
}

Dark Mode Support

The theme automatically supports dark mode based on system preferences. You can customize dark mode colors:

@media (prefers-color-scheme: dark) {
    :root {
        --color-bg: #1a202c;
        --color-text: #e2e8f0;
        --color-link: #63b3ed;
        --color-secondary: #a0aec0;
        --border-subtle: #2d3748;
    }
}

Common Customizations

  1. Change the accent color:
:root {
    --color-link: #your-color-here;
}
  1. Adjust content width:
:root {
    --content-width: 800px; /* Wider content area */
}
  1. Use custom fonts:
:root {
    --font-sans: "Your Sans Font", system-ui, sans-serif;
    --font-serif: "Your Serif Font", Georgia, serif;
}
  1. Modify code block appearance:
:root {
    --code-block-bg: #f3f4f6;
    --code-border: #e5e7eb;
}

Adding Custom CSS

To add custom CSS without modifying the theme files:

  1. Go to your Ghost admin panel
  2. Navigate to Settings → Code injection
  3. Add your custom CSS in the Site Header section:
<style>
    :root {
        /* Your custom variables here */
    }

    /* Your custom styles here */
</style>

Mastodon Author Attribution

This theme supports Mastodon 4.3+ author tags, which display a "More from [Author]" section when your posts are shared on the Fediverse.

1. Update the Meta Tag

To set your Mastodon handle, open default.hbs and look for the following line in the <head> section:

<meta name="fediverse:creator" content="@yourusername@yourinstance.tld" />

Replace @yourusername@yourinstance.tld with your own Mastodon handle (e.g., @matdevdug@c.im).

2. Verify your Domain on Mastodon

After updating the theme, you must authorize your domain on your Mastodon instance:

  1. Log in to your Mastodon account.
  2. Go to Preferences > Public Profile > Verification.
  3. Look for the Author Attribution section.
  4. Add your site's domain (e.g., yourblog.com) to the list of allowed domains.
  5. Save changes.

Note: If you've recently shared a post, your instance might have it cached. New posts or hard-refreshed previews will show the author attribution.

Adding a Blogroll

This theme supports a custom, interactive Blogroll page that renders a beautiful categorized list of blogs you follow, alongside a button to download the collection as an OPML file for RSS reader support.

1. Create the Page in Ghost Admin

  1. Go to your Ghost admin panel.
  2. Navigate to Pages and click New Page.
  3. Set the Title to Blogroll (or anything you prefer).
  4. Click the gear icon in the top right to open Page Settings, and ensure the Page URL slug is exactly blogroll.
  5. Write an optional introduction in the editor and click Publish.

Ghost will automatically detect the page-blogroll.hbs template and load your custom blogroll.

2. Configure Your Blogs

To add, edit, or remove blogs in your blogroll, edit the assets/blogroll.json file in the theme directory:

[
  {
    "name": "Simon Willison",
    "htmlUrl": "https://simonwillison.net/",
    "xmlUrl": "https://simonwillison.net/atom/entries/",
    "category": "Tech & Development",
    "description": "Simon's weblog covers Python, LLMs, databases, and web development with insightful TIL posts."
  }
]

Fields: - name: The name of the blog. - htmlUrl: The website link. - xmlUrl (optional): The RSS/Atom feed URL (required for OPML export). - category: Grouping for the blog (e.g., "Tech & Development", "Design", "Personal"). - description (optional): A short description of why you recommend this blog.

Features

  • Responsive design
  • Dark mode support
  • Clean typography
  • Syntax highlighting
  • RSS feed support
  • Mastodon sharing
  • Optimized images
  • Fast loading
  • SEO friendly

Support

If you need help customizing the theme or encounter any issues, please open an issue on the repository.

License

MIT License - feel free to use this theme for any purpose, commercial or non-commercial.