    Docs
    ·
    Showcase
    ·
    Contributing
    ·
    PayPal
    ·
    Twitter

    Hello :sunglasses:

    I created this theme for Ghost with inspiration from Medium.

    It is available for free so you can use on your site.

[![Simply free theme for ghost](https://user-images.githubusercontent.com/10253167/162076408-0356f347-6d0b-47ad-a640-e8ee7a2494af.jpg)](https://godofredo.ninja/ghost-theme/simply/)

## Featured

- Simply Settings
  - [Social Media](https://godofredo.ninja/ghost-theme/simply/settings/#socialmedia)
  - [Search](https://godofredo.ninja/ghost-theme/simply/settings/#search)
  - [Logo Light / Dark Mode](https://godofredo.ninja/ghost-theme/simply/settings/#logolightdarkmode)
- Site wide
  - [Header](https://godofredo.ninja/ghost-theme/simply/layouts/#header)
    - Defautl
    - DropDown Menu
  - [Footer](https://godofredo.ninja/ghost-theme/simply/layouts/#footer)
    - Default
    - Dark
    - No Secondary Navigation
  - [Color Scheme](https://godofredo.ninja/ghost-theme/simply/settings/#colorscheme)
    - Auto (default)
    - Dark Mode
    - Light Mode
  - [Pagination](https://godofredo.ninja/ghost-theme/simply/settings/#pagination)
    - Infinite Scroll (default)
    - Pagination Number
  - [Membership](https://godofredo.ninja/ghost-theme/simply/members/)
    - [Disable Membership](https://godofredo.ninja/ghost-theme/simply/members/#disablemembership)
- [Homepage](https://godofredo.ninja/ghost-theme/simply/settings/#homepage)
  - [Publication cover](https://godofredo.ninja/ghost-theme/simply/settings/#homepage)
    - None
    - Featured -> Latest Featured Article
    - Featured Slider -> 3 Latest Articles
    - Cover (default)
      - Publication cover title
      - Publication cover description
      - Publication cover color
      - Publication cover img
- Post
  - [Post Font](https://godofredo.ninja/ghost-theme/simply/settings/#postfont)
    - font-serif (default)
    - font-sans
  - [Newsletter](https://godofredo.ninja/ghost-theme/simply/settings/#newsletter)
    - Show / Hide
    - Newsletter Text
  - Comments
    - [Ghost Native Comments](https://ghost.org/help/commenting/)
    - [Disqus Comments](https://godofredo.ninja/ghost-theme/simply/settings/#disquscomments)
    - [Facebook Comments](https://godofredo.ninja/ghost-theme/simply/settings/#facebookcomments)
    - [Hyvor Talk Comments](https://godofredo.ninja/ghost-theme/simply/settings/#hyvortalk)
- [Publication Language](./languages.md)
  - `en` — English default language
  - `es` — Español
  - `de` — German by [dkbast](https://github.com/dkbast)
  - `tr` — Turkish by [Mertcan GÖKGÖZ](https://github.com/MertcanGokgoz), [@tolgaaaltas](https://github.com/tolgaaaltas)
  - `fr-CA` — Canadian French by [Pascal Andy](https://github.com/pascalandy)
  - `ru` — Russian by [Partizan007](https://github.com/partizan007)
  - `vi` — Vietnamese by [ping](https://github.com/everping)
  - `fr` — French by [ping](https://github.com/StanGirard)
  - `it` — Italian by [Marco Sanson](https://github.com/marcosanson)
  - `id` — Indonesian by [Adryan Eka Vandra](https://github.com/adryanev)
  - `pt-BR` — Brazilian by [Daniel Pereira](https://github.com/danieldeev), [Alexandre "Lekler"](https://github.com/lekler)
  - `uz` — Uzbek by [Shukrullo Turgunov](https://github.com/vodiylik)
  - `pl` — Polish by [Anarion](https://github.com/anarion80)
  - `nl` — Dutch by [exbu](https://github.com/exbu)
- Home Page
  - [Default](https://godofredo.ninja/ghost-theme/simply/home-page/#default)
  - [Featured](https://godofredo.ninja/ghost-theme/simply/home-page/#featured)
  - [Medium](https://godofredo.ninja/ghost-theme/simply/home-page/#medium)
  - [Sidebar](https://godofredo.ninja/ghost-theme/simply/home-page/#sidebar)
  - [Grid](https://godofredo.ninja/ghost-theme/simply/home-page/#grid)
  - [Personal](https://godofredo.ninja/ghost-theme/simply/home-page/#personal)
  - [Archive](https://godofredo.ninja/ghost-theme/simply/home-page/#archivepage)
  - [Featured with Slider](https://godofredo.ninja/ghost-theme/simply/home-page/#featuredwithslider)
  - [Medium with Sidebar](https://godofredo.ninja/ghost-theme/simply/home-page/#mediumwithsidebar)
  - [Photographer](https://godofredo.ninja/ghost-theme/simply/home-page/#photographer)
- Post Format
  - [Post Default](https://godofredo.ninja/ghost-theme/simply/post-format/#postdefault)
  - [Post Full](https://godofredo.ninja/ghost-theme/simply/post-format/#postfull)
  - [Post Wide](https://godofredo.ninja/ghost-theme/simply/post-format/#postwide)
  - [Post Header Image](https://godofredo.ninja/ghost-theme/simply/post-format/#postheaderimage)
  - [Post Image](https://godofredo.ninja/ghost-theme/simply/post-format/#post-image)
  - [Post Image Right](https://godofredo.ninja/ghost-theme/simply/post-format/#postimageright)
  - [Post Sidebar](https://godofredo.ninja/ghost-theme/simply/post-format/#post-sidebar)
  - [Post not Image](https://godofredo.ninja/ghost-theme/simply/post-format/#postnotimage)
  - [Post Toc](https://godofredo.ninja/ghost-theme/simply/post-format/#posttoc)
- Page Format
  - Page Default
  - Page Toc
- Page
  - [Contact](https://godofredo.ninja/ghost-theme/simply/contact-page/)
  - [Podcast](https://godofredo.ninja/ghost-theme/simply/podcast-page/)
  - [Portfolio](https://godofredo.ninja/ghost-theme/simply/portfolio-page/)
  - 404
- Archive
  - [Authors Page](https://godofredo.ninja/ghost-theme/simply/authors-and-tags-page/#authorspage)
  - [Tags Page](https://godofredo.ninja/ghost-theme/simply/authors-and-tags-page/#tagspage)
- [Kusi Doc](https://godofredo.ninja/ghost-theme/simply/kusi-doc/) for the documentation of your project
- [AMP](https://github.com/godofredoninja/Hodor-AMP-Ghost) Template
- Post and Page
  - [Prism supported all syntax](https://prismjs.com/index.html#supported-languages)
  - Medium style image zoom
  - Video Responsive
    - Video
    - YouTube
    - Vimeo
    - kickstarter
    - Dailymotion
- Post Content
  - Related Articles
  - Social share buttons support for posts
  - Previous and next Post
- Sidebar
  - 3 featured articles on the home page
  - 3 lates articles
  - Tag Cloud
- Lazy Loading for images
- Tracking [Google Tag Manager](https://godofredo.ninja/ghost-theme/simply/tracking-google-tag-manager/)

## Automate theme deployment via Ghost API

- Visit ghost admin page > settings > integrations
- At the bottom of that page, click the button to `Add custom integration`
- Name the new custom integration any thing you like - say - `automated-updates` and save.
- Copy the Admin API key
- Create a file named `.env` in the theme folder
- Paste the Admin API key in the `.env` file as shown below.
- Do not git commit push the `.env` file.
- I have already made sure to .gitignore the `.env` file to make sure you don't accidentally spill your secret Admin API key.
- Also, in the same `.env` file, replace the API URL - which the URL where your site is currently located
```
GHOST_API_URL=https://domain.TLD
GHOST_ADMIN_API_KEY=provideyouradminapikeyfromtheghostdashboard
THEME_NAME=simply
API_VERSION="v5.0"
```
- run the following conmmand to deploy your theme updates to your ghost installation
```
yarn deploy
```
or if you prefer npm over yarn
```
npm run deploy
```
- You will see that the updates you made in the theme locally are now deployed and activated in your ghost setup.

"Now you can iteratively edit, deploy, and test your theme without leaving your command line :)"

You can also incorporate this deploy step in your CICD pipeline if you use any.

## Contributing

Im always looking for contributors of all skill levels! If you're looking to ease your way into the project, try out a [good first issue](https://github.com/godofredoninja/simply/labels/%F0%9F%8C%B1%20good%20first%20issue).

I greatly appreciate any help in maintaining to keep the documentation up to date. My English is not so good and I am trying to make the documentation more understandable.

If you are interested in collaborating with Simply, take a look at the [Contributing Guide](https://github.com/godofredoninja/simply/blob/master/CONTRIBUTING.md).

### Code Contributors

This project exists thanks to all the people who contribute. [[Contribute](https://github.com/godofredoninja/simply/blob/master/CONTRIBUTING.md)].

[![Simply Contributors](https://opencollective.com/simply/contributors.svg?width=890&button=false)](https://github.com/godofredoninja/simply/graphs/contributors)

### Financial Contributors

First I want to say thank you with all my heart and a million more Thank you. The [donation](https://www.paypal.me/godofredoninja) you have made has motivated me to continue working with the improvement and updating the theme.

Become a financial contributor and help us sustain our community. [[Contribute](https://opencollective.com/simply/contribute)]

- [Open Collective](https://opencollective.com/simply/contribute)
- [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y7UB5Q8GVN3HN&source=url)
- Bitcoin: **3QF5D9QyV9YQdPJVu2HLN8fkdWVbmezd5J**
- Ethereum: **0x503bAA618d29774f03c7053218999Ad567a9fc71**

[![Individuals Financial](https://user-images.githubusercontent.com/10253167/103444000-877b1b80-4c32-11eb-8377-7bedd46dbdf8.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y7UB5Q8GVN3HN&source=url)

- [CMS Critic](http://www.cmscritic.com/) :star: :star: :star: :star:
- [A Boundless World](https://www.aboundlessworld.com/) :star: :star:
- [Dana Ross](https://vaalin.com/)
- [Kip Ivan](https://github.com/Ingles-con-Kip)
- [Wenjer India](http://qilinlab.com)
- Etienne Triaud :star: :star:
- Greg Rapp
- Yannick Kordel
- Bruno Brito Semedo
- Ivan Rodriguez Segura
- Rodrigo Franken Dutra
- Diego Alcantara Zweifel
- Andrew Wagner

[![Individuals Financial](https://opencollective.com/simply/individuals.svg?width=890)](https://opencollective.com/simply)

## Sponsored

- [Digital Ocean](https://m.do.co/c/710a27a3b3de) using my [referral link]((https://m.do.co/c/710a27a3b3de)) and you will get free a **$100 in credit valid for 60 days**

[![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%201.svg)](https://www.digitalocean.com/?refcode=710a27a3b3de&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge)

## Credits

- [Hodor AMP](https://github.com/godofredoninja/Hodor-AMP-Ghost)
- [Tailwind CSS](https://github.com/tailwindlabs/tailwindcss)
- [Ionicons](https://github.com/ionic-team/ionicons)
- [IcoMoon](https://icomoon.io/)
- [Lazysizes](https://github.com/aFarkas/lazysizes)
- [Medium Zoom](https://github.com/francoischalifour/medium-zoom)
- [Prismjs](https://github.com/PrismJS/prism/)
- [Inter Font Family](https://github.com/rsms/inter/)
- [PT Serif Font Family](https://fonts.google.com/specimen/PT+Serif)
- [Safari Light - Mockup](https://www.uplabs.com/posts/safari-light-version)
- [Tiny Slider](https://github.com/ganlanyuan/tiny-slider)

## Copyright & License

Copyright (c) 2017-2022 GodoFredo - Released under the [GPLv3 license](LICENSE)

Nostr site theme package: micro-simply v.0.4.0

simply theme for ghost by @GodoFredoNinja, modified for microblogging by brugeman


developers swearing on github commit messages


Founder of Lyn Alden Investment Strategy. Fundamental investing with a global macro overlay. Finance/Engineering blended background.


# Attila

A content focused responsive theme for [Ghost](https://github.com/tryghost/ghost/). See a demo at: [attila.peteramende.de](https://attila.peteramende.de/)

## ♥ Support

You can [buy me a drink](https://paypal.me/zutrinken) if you enjoy using Attila. Cheers 🍻

## 📷 Screenshot

<img src="https://raw.githubusercontent.com/zutrinken/attila/master/src/screenshot.png" />

## ⭐ Features

* Theme options
* Responsive layout
* Light and Dark Mode
* Search support
* Post reading progress
* Code highlight including line numbers
* Comments and Disqus (Theme option)
* Ghost accent color

## 🌍 Localization

🟩 Up to date  🟧 Missing strings

| Code | Flag | Language | Status | Translator |
| :--: | :--: | :------: | :----: | :--------: |
| `en` | 🇬🇧 | English | 🟩 | |
| `de` | 🇩🇪 | German | 🟩 | |
| `es` | 🇪🇸 | Spanish | 🟩 | [r1p](https://github.com/r1p) |
| `fr` | 🇫🇷 | French | 🟩 | [robink](https://github.com/robink), [alsyia](https://github.com/alsyia) |
| `it` | 🇮🇹 | Italian | 🟩 | [fmaida](https://github.com/fmaida), [undrivendev](https://github.com/undrivendev) |
| `no` | 🇳🇴 | Norwegian | 🟧 | [arthurnoerve](https://github.com/arthurnoerve), [oisann](https://github.com/oisann), [Givemeurcookies](https://github.com/givemeurcookies) |
| `zh` | 🇨🇳 | Chinese | 🟩 | [hao-lee](https://github.com/hao-lee), [izumiko](https://github.com/izumiko), [emperorjoker](https://github.com/emperorjoker) |
| `zh_tw` | 🇨🇳 | Chinese Traditional | 🟩 | [Petingo](https://github.com/Petingo)
| `id` | 🇮🇩 | Indonesian | 🟧 | [simplyeazy](https://github.com/simplyeazy) |
| `ro` | 🇷🇴 | Romanian | 🟧 | [cdorin93](https://github.com/cdorin93) |
| `ru` | 🇷🇺 | Russian | 🟩 | [schamberg97](https://github.com/schamberg97), [atjanov](https://github.com/atjanov) |
| `tr` | 🇹🇷 | Turkish | 🟩 | [cgrgrbz](https://github.com/cgrgrbz), [electricalgorithm](https://github.com/electricalgorithm) |
| `sv` | 🇸🇪 | Swedish | 🟩 | [martenj77](https://github.com/martenj77), [LarssonOliver](https://github.com/LarssonOliver) |
| `cs` | 🇨🇿 | Czech | 🟩 | [lunakv](https://github.com/lunakv), [rdolezel](https://github.com/rdolezel) |
| `pt` | 🇵🇹 | Portuguese | 🟧 | [matheusvanzan](https://github.com/matheusvanzan) |
| `vi` | 🇻🇳 | Vietnamese | 🟩 | [JustHmmmm](https://github.com/justhmmmm), [mastoduy](https://github.com/mastoduy) |
| `el` | 🇬🇷 | Greek | 🟧 | [thiodordelis](https://github.com/thiodordelis) |
| `dk` | 🇩🇰 | Danish | 🟩 | [jmayntzhusen](https://github.com/jmayntzhusen), [tmlmt](https://github.com/tmlmt) |
| `ar` | | Arabic | 🟧 | [pop-eax](https://github.com/pop-eax) |
| `ca` | | Catalan | 🟧 | [arthurnoerve](https://github.com/arthurnoerve) |
| `lt` | 🇱🇹 | Lithuanian | 🟧 | [arthurnoerve](https://github.com/arthurnoerve) |
| `nl` | 🇳🇱 | Dutch | 🟧 | [gkdp](https://github.com/gkdp) |
| `pl` | 🇵🇱 | Polish | 🟩 | [filipolszewski](https://github.com/filipolszewski), [MrBoombastic](https://github.com/mrboombastic) |
| `eo` | | Esperanto | 🟧 | [ebanDev](https://github.com/ebanDev) |
| `ga` | | Galego | 🟩 | [r1p](https://github.com/r1p) |
| `uk` | 🇺🇦 | Ukrainian | 🟩 | [Rakanskiy](https://github.com/rakanskiy), [krupenik](https://github.com/krupenik), [vadimkin](https://github.com/vadimkin) |
| `ja` | 🇯🇵 | Japanese | 🟩 | [emperorjoker](https://github.com/emperorjoker) |
| `fa` | | Farsi | 🟩 | [ItsAminZamani](https://github.com/ItsAminZamani) |
| `fi` | 🇫🇮 | Finnish | 🟩 | [murtoM](https://github.com/murtoM) |
| `th` | 🇹🇭 | Thai | 🟩 | [GmBeHappy](https://github.com/GmBeHappy) |
| `hu` | 🇭🇺 | Hungarian | 🟩 | [ferivoq](https://github.com/ferivoq) |
| `ge` | 🇬🇪 | Georgian | 🟩 | [kiknaio](https://github.com/kiknaio) |

## 🔠 Setup custom google fonts

1. Go to [fonts.google.com](https://fonts.google.com/) and choose a font.
2. Choose __Embed__ and copy the `<link>` code.
3. Go to __Code injection__.
4. Add this to __Blog Header__:
````html
<link href="https://fonts.googleapis.com/css2?family=Mukta&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/css2?family=Crimson+Text&display=swap" rel="stylesheet">
<style>
  :root {
    --font-primary: 'Mukta', sans-serif;
    --font-secondary: 'Crimson Text', serif;
  }
</style>
````

## ⚙ Development

Install [Grunt](https://gruntjs.com/getting-started/):
````bash
npm install -g grunt-cli
````
Install Grunt dependencies:
````bash
npm install
````
Build Grunt project:
````bash
grunt build
````
The compress Grunt task packages the theme files into `dist/<theme-name>.zip`, which you can then upload to your site.
````bash
grunt compress
````
## ⚖ Copyright & License

Copyright (C) 2015-2024 Peter Amende - Released under the [MIT License](https://github.com/zutrinken/attila/blob/master/LICENSE).


Nostr site theme package: attila v.3.7.1


Emergency doctor , Introvert bitcoiner , Smartphone photographer, Short storyteller, Minimalist, Calisthenic 🇹🇭⚡ 🌱Nostr since 800845🌱


📸 Photographer from Germany. I share some of my photos from past photoshoots. Some of them will be 🔞 NSFW as I often shoot sensual, lingerie and nude subjects | My other stuff here:  nostr:npub1klr0dy2ul2dx9llk58czvpx73rprcmrvd5dc7ck8esg8f8es06qs427gxc


# Dope

A unique tag-based [Ghost](https://github.com/TryGhost/Ghost) theme to arrange your publications into collections. Keep organized and let your readers explore your publications with beautifully designed tag columns.

**Demo: https://dope.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Dope/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/dope.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).


Vegan Holistic Nutritionist & only High Vibe Foods
Energy Light Worker & Channeler
On a Raw Vegan Journey


# The Fizzy Theme

[![demo](https://img.shields.io/badge/Demo-online-yellow.svg)](https://fizzy.cc/)
[![Ghost version](https://img.shields.io/badge/Ghost->=3.x-brightgreen.svg)](https://github.com/TryGhost/Ghost)
[![Release](https://img.shields.io/github/release/huangyuzhang/Fizzy-Theme.svg)](https://github.com/huangyuzhang/Fizzy-Theme/)
[![GitHub forks](https://img.shields.io/github/forks/huangyuzhang/Fizzy-Theme.svg)](https://github.com/huangyuzhang/Fizzy-Theme/network)
[![GitHub stars](https://img.shields.io/github/stars/huangyuzhang/Fizzy-Theme.svg?style=social&label=Star)](https://github.com/huangyuzhang/Fizzy-Theme/stargazers)

A tasty blogging theme for Ghost :ghost:

Thanks to everyone who starred this project. Please read the documentation to exploit all the features of this theme.

[中文文档](./README-zh.md)

![](https://user-images.githubusercontent.com/40261916/60045241-3e045480-96bc-11e9-9382-03789cd8a637.jpg)

## 🔧 Installation
- [Stable Version](https://github.com/huangyuzhang/Fizzy-Theme/releases/latest/)
- [Development Version](https://github.com/huangyuzhang/Fizzy-Theme/tags/)

Download the `.zip` file and upload it at your Ghost Admin > Setting > Design.

## 🎥 Demo

My blog [Fizzy.cc](https://fizzy.cc) is currently using this theme.

Use this [issue](https://github.com/huangyuzhang/Fizzy-Theme/issues/20) to add your site with Fizzy Theme.

## 🍹 Features and Usage

### Logo
If only **site icon** is uploaded, the Logo area will display the **icon** and followed by the **Site name** then a dot colored as the **main color**, e.g.:

If **site logo** is uploaded, then the Logo area will only display the **site logo**.

> Note: Since the top navbar is colored with white background, it would be better to use a dark/colorful logo.

### :earth_africa: i18n
You can change the theme's language in Ghost Admin -> General -> "Publication Language".

|  Code   |       Language       | Status |                    Translator                     |
| :-----: | :------------------: | :----: | :-----------------------------------------------: |
|  `de`   |        German        |   ✅   |   [Marek Schmidt](https://github.com/MSDev201)    |
|  `en`   |       English        |   ✅   |                                                   |
|  `fr`   |        French        |   ✅   |        [Lourys](https://github.com/Lourys)        |
|  `it`   |       Italian        |   ✅   |        [Pyrox](https://github.com/Pyr0x1)         |
| `pt_BR` | Brazilian Portuguese |   ✅   | [matheusvanzan](https://github.com/matheusvanzan) |
|  `ta`   |        Tamil         |   ✅   |   [MC Naveen](https://github.com/the-mcnaveen)    |
|  `th`   |         Thai         |   ✅   |         [atbee](https://github.com/atbee)         |
|  `tr`   |       Turkish        |   ✅   |         [talut](https://github.com/talut)         |
| `zh_CN` | Chinese (Simplified) |   ✅   |                                                   |

Please help to translate Fizzy into the languages you know. To do so, first fork this repo. Then you need to copy the `en.json` file under `locales` folder and rename it to your language code, e.g. `es.json`, `zh_TW.json`. Then modify the translations within it. After testing, please create a "Pull Request" to `dev` branch of this repo (not `master`).

### Assets Localization
You could customize the following files to define the CDN of assets to speed up access in specific regions:
- `./default.hbs`
- `./partials/post/post_footer.hbs`
- `./partials/post/post_toc.hbs`

### Internal tags
Internal tags start with `#`, after creating it will displayed as internal tag automatically. Internal tags will not be displayed in front-end. So far the Fizzy Theme support the following internal tags:
- **Carousel**: Use internal tag `#carousel`(slug:`hash-carousel`) to add posts into carousel in homepage (see [Showcase](#showcase)).
- **No Index**: Use internal tag `#noindex`(slug:`hash-noindex`) to exclude posts from listing in home page.
> limitation: hiding posts with `#noindex` tag, but the number of posts displayed for that page will change as well.

### Showcase
The showcase section is built to highlight posts. It is available only on the homepage. Insert the following code into Ghost Admin -> Code injection -> `Site Header` to enable the showcase:

```javascript
<script>
  var show_showcase = true; //default: false
</script>
```

The left slider carousel part detects the internal tag `#carousel`. The right part will display 2 featured posts.

![showcase](https://user-images.githubusercontent.com/40261916/60126667-65bfef00-9786-11e9-94e8-eaa4c2a4559f.jpg)

### Author Page
You can customize the author page by editing your **profile** in Ghost Admin, such as **name**, **avatar**, **background image**, **social account links**, **location** and **bio**. Author page ([demo](https://fizzy.cc/author/simon/))

### Tag Page
You can customize the tag page by editing **tags** in Ghost Admin, such as **image**, **description**. Tag Page ([demo](https://fizzy.cc/tag/blogging/))

### Custom Templates
Open the gear icon ⚙ while editing a post or page, scroll to the bottom and change `Template` option.
- **Tag Archive**: used for listing all tags/topics in one page. ([demo](https://fizzy.cc/tag/))
- **Post Archive**: used for listing all posts in one page. ([demo](https://fizzy.cc/archive/))
- **Full Width**: full width post. ([demo](https://fizzy.cc/fizzy-theme/))
- **Post With TOC**: TOC-enabled post, details in [#TOC](#toc). ([demo](https://fizzy.cc/fizzy-theme/))
- **Featured Posts Archive**: post list for featured posts, page title and content will be shown on the top section. ([demo](https://fizzy.cc/featured/))

### Collection
To enable collection, edit the `routes.yaml` as below. Then modify the `home.hbs` to customize your homepage. Full doc: [Ghost Docs - Collections](https://docs.ghost.org/api/handlebars-themes/routing/collections/)

```yaml
routes:
  /: home # template for homepage `home.hbs`

collections:
  /movie/: # a collection called movie
    permalink: /movie/{slug}/
    template: movie # template `movie.hbs`
    filter: tag:movie # fetch data from a tag:movie
    data: tag.movie # have access to all data & meta data from tag
  /music/: # a collection called music
    permalink: /music/{slug}/
    template: music # template `music.hbs`
    filter: primary_tag:music # fetch data from primary tag: music
    data: tag.music # have access to all data & meta data from tag
```

> **Notice**: known issues of Ghost collection, e.g.: [Ghost #10082](https://github.com/TryGhost/Ghost/issues/10082).

### Custom CSS Variables
Download the theme `.zip` file, unzip it then edit the variables in `assets/css/custom.css` to customize your theme coloring. After that, zip everything back into a `.zip` file and upload it onto your Ghost admin.

### Custom Footer Text
By default, your **site description** (Ghost Admin -> General) will be displayed in the footer text. If you need to change it, define a variable `footer_text` in the `Site Header` as below:

```javascript
<script>
  var footer_text = "REPLACE WITH YOUR FOOTER TEXT HERE";
</script>
```
> You can include HTML in the `footer_text`, but be careful to use single quotation marks inside it. For example:
> `var footer_text = "REPLACE <span style='color:red;font-weigh'>WITH</span> YOUR FOOTER TEXT HERE <i class='iconfont icon-heart'></i>";`

### :speech_balloon: Comment System
Due to Ghost itself doesn't have a comment system, we need to use third party solutions for this. Some options are: [DISQUS][disqus], [Gitalk][gitalk], [Valine][valine] and [Vssue][vssue]. By default, Fizzy has Gitalk and DISQUS integrated. Skip the following if you do not need the comment system.

**By default, the comment system is disabled.** To enable it, first insert the following code into `Post Header` for a single post or `Site Header` for the whole site at Ghost Admin -> Code injection to configure accordingly, then choose one of the comment systems below and follow the instruction.

```javascript
<script>
  var show_comment = true; //default: false
</script>
```

#### Gitalk (Recommended)
Gitalk is a Github issue based comment system. Automatically support `en`, `zh_CN`, `zh_TW`, `es` by detecting the language of user's navigator.
1. Register a new **GitHub Application**
2. Create a new **Github Repository** for your website
3. Insert the following code into Ghost Admin -> Code injection: `Site Footer`, and modify the configuration with your **Github App** & **Repository** from previous steps.

```javascript
<script>
  const gitalk = new Gitalk({
    clientID: 'GitHub Application Client ID',
    clientSecret: 'GitHub Application Client Secret',
    repo: 'GitHub repo',
    owner: 'GitHub repo owner',
    admin: ['GitHub repo owner and collaborators, only these guys can initialize github issues'],
    id: location.pathname,      // Ensure uniqueness and length less than 50
    distractionFreeMode: false  // Facebook-like distraction free mode
  });
  gitalk.render('gitalk-container');
</script>
```
> more usage guide and options please check [here](https://github.com/gitalk/gitalk#usage).

#### DISQUS
Insert the following code into Ghost Admin -> Code injection: `Site Header`, and modify the link with yours.
```javascript
<script>
    var disqus_link = 'https://YOURLINK.disqus.com/embed.js'; // change it with your DISQUS js link
</script>
```
If you want to change the comment system, you need to modify the code in `partial/post/post_comment.hbs`.

###  Code Highlight
Prism.js is used for syntax highlighting, the default languages and plugins used by Fizzy theme are:
  - **Languages**: Markup (e.g. HTML), CSS, C-like, JavasScript, Bash, Nginx, Ruby, Git, JSON, Markdown, SQL, Python, R
  - **Plugins**: line-numbers, toolbar, show-language.

To customize this yourself, open [customize Prismjs][custom-prism] and choose the languages you need. Then download the js and css files to overwrite the `prism.js` and `prism.css` files in `assets` folder.

#### Line-numbers
![image](https://user-images.githubusercontent.com/40261916/60731259-0e1c4300-9f3f-11e9-93c8-a83fe5a878e8.png)
The line numbers are hidden by default. To enable it, insert the following code into `Post Header` for a single post or `Site Header` for the whole site:
```js
<script>
  var line_numbers = true; //default: false
</script>
```

### TOC
There are two ways to control the TOC of a post:
1. insert the following code into `Post Header` for a single post or `Site Header` for the whole site;
    ```javascript
    <script>
        var show_toc = true; // enable TOC (default: false)
    </script>
    ```
2. Use custom post template `Post With Toc` to enable TOC.
> **Priority**: `template` > `Post Header` > `Site Header`

> **Notice**: h2 and h3 headings on the page will be displayed by default. If you want to add other headings (e.g. h1 or h4), please edit `selectors` of the file `partials/post/post_toc.hbs`. However, you should not use h1 except for the post title.

### Instant Search
The search function uses Ghost Content API. To enable it (added to top menu), first add a custom integration in Ghost Admin. Then copy the **Content API Key** and **API URL**.
Go to the Code injection, add the following code to the `Site Header`:
```javascript
<script>
  var show_search = true; // default:false
  var search_key = 'PASTE THE CODE YOU COPIED AS Content API Key';
  var search_url = 'PASTE THE CODE YOU COPIED AS API URL'; // it is usually your site url
</script>
```

### LaTeX support
Use `$`(inline) or `$$` to cover commands to render for LaTeX commands. ([examples](https://fizzy.cc/latex/))

### Link Page
Create a link page is nothing different than create a normal page. With the **Bookmark Card** feature since Ghost v2.30, you can easily add links to any page by type `/bookmark` in Ghost editor. ([demo](https://fizzy.cc/links/))

### Components
- **Navigation**: You can modify `partials/navigation.hbs` to customize your dropdown menu, or delete the section if not needed.
- **Badge**: include `class="badge <color>"` to use badge (HTML only).([demo](https://fizzy.cc/fizzy-theme/#badge))
  - Supported colors: uncolored, red, yellow, green, blue, purple
![image](https://user-images.githubusercontent.com/40261916/64512333-bcb27a80-d318-11e9-8b60-1f18468e3a30.png)
    > Note: to use uncolored badge, set as `class="badge"`.
- **Posts per page**: change the number of `"posts_per_page": 8` in `package.json`
- **table**: to unwrap cells, uncomment the `/* white-space: nowrap; */` in `assets/css/main.css` around **line 703**.

### Credit
If you want to disable the top right "Get Fizzy Theme" button, insert the following code into your `Site Header` from `Code Injection`:

```javascript
<script>
  var fizzy_credit = false; // default:true
</script>
```
> Please do not remove the footer text "Using The Fizzy Theme" and the link. Thank you for your support!

## 📝 Changelog

See [CHANGELOG.md](./CHANGELOG.md)

## 🍻 Contributors

See [Contributors][contributors]

## 🔋 Dependencies

- [Bulma][bulma] - CSS Framework
- [Prismjs][prismjs] - A lightweight syntax highlighter
- [JQuery][jquery] - A well-known JavaScript library (for tocify only now)
- [jQuery.tocify.js][tocify] - Table of Content generator (also JQuery-UI)
- [KaTeX][katex] - A faster LaTeX equation rendering library (since v0.3.0)
- [Gitalk][gitalk] - A Github issued based comment system (since v0.3.0)
- [ghost-search][ghost-search] - An instant search library using Ghost Content API (since v1.0.0)
- [iconfont][iconfont] - A free icon solution (since v1.2.3)

## 📍 Roadmap
To know the future planning of this project, please visit our [Roadmap][roadmap].

## 🐛 Bug Report & :dart: Features Request
If you find a bug, thinking about something to be improved or even want new features, please feel free to post an issue.

Alternatively you could contribute to this project.

## 💡 Contributing

1. Fork it (maybe star this too?)
2. Create your feature branch (`git checkout -b feature-fooBar`)
3. Commit your changes (`git commit -m 'Add something'`)
4. Push to the branch to origin (`git push origin feature-fooBar`)
5. Create a new Pull Request to `dev` branch here
6. Wait for code review and modify if necessary

## 🔏 License

This project is licensed under the MIT License.

[bulma]: https://bulma.io/
[prismjs]: https://prismjs.com/
[jquery]: https://jquery.com/
[tocify]: http://gregfranko.com/jquery.tocify.js/
[mathjax]: https://www.mathjax.org/
[katex]: https://katex.org/
[disqus]: https://disqus.com/
[gitalk]: https://github.com/gitalk/gitalk
[valine]: https://github.com/xCss/Valine
[vssue]: https://github.com/meteorlxy/vssue
[custom-prism]: https://prismjs.com/download.html#themes=prism-tomorrow&languages=markup+css+clike+javascript+bash+ruby+git+json+markdown+nginx+sql+python+r&plugins=line-numbers+toolbar+show-language
[ghost-search]: https://github.com/HauntedThemes/ghost-search
[iconfont]:https://www.iconfont.cn
[contributors]: https://github.com/huangyuzhang/Fizzy-Theme/graphs/contributors
[roadmap]: https://github.com/huangyuzhang/Fizzy-Theme/projects/3


freelance illustrator & designer – up to NoGood ⚡ running NoGood Radio 🎧 currently available for new projects ✏


Nostr site theme package: simply v.0.4.0

simply theme for ghost by @GodoFredoNinja


Ally 🐈⬛
The Minx Mix 🇹🇹🇭🇺
PT 🔞 Model 😇😈🍜🎥📸 4⚡
FT 🦄👩🍳 🧹
Hobby 📸  🌅🌲🌸🌊 (All nature photos are taken by me unless stated otherwise.)

     Meditation 🧘 Energy 💜 Alignment 💫
            🌕🌖🌗🌘🌑🌒🌓🌔🌕

#Damus 👸🏻💜
#Photography
#Flowerstr
#Nature
#Bitcoin


Bitcoin learner & educator

Devoted to promoting censorship resistant protocols.

About: https://nostree.me/tony


Painter

Thanks to support my art ⤵:
https://getalby.com/p/isolabellart

#Creatr profile ⤵:
https://creatr.nostr.wine/subscribe/npub17nd4yu9anyd3004pumgrtazaacujjxwzj36thtqsxskjy0r5urgqf6950x


Product designer - Snort, Nostr Nests, zap.stream, Habla,  tunestr, zapstr,  nostrdesign.org, nostrapps.com, badges.page, zap.cooking.


Daily InkblotArt notes where you can earn sats for your imagination!


Top Trending daily Finances & Bitcoin Only Newsletter. Used by 100,000+ Bitcoin Maxis and OG's to stay on top💎 BTW, we used to buy pizza with BTC back in 2011


Interactive freedom tech live show -- hosted by ODELL -- Search CITADEL DISPATCH in your favorite podcast app.


# Bulletin

Bulletin is a minimal newsletter theme for [Ghost](https://github.com/TryGhost/Ghost). The theme divides your homepage into two sections. The left-hand section is optimized for capturing new email subscribers with a punchy background color. The right-hand section shows an excerpt from the latest issue you’ve published.

**Demo: https://bulletin.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Bulletin/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/bulletin.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).

Nostr site theme package: bulletin v.1.0.0


Violence is the last refuge of the incompetent.

Node runner, self-hosting addict, cook.

Simplex : https://lnk.sovbit.com/enkismplx


Christian Bitcoiner and developer of the coracle.social nostr client.
Learn more at https://coracle.tools


# Edition

The newsletter theme for [Ghost](https://github.com/TryGhost/Ghost). A beautiful way to share stories with your growing audience.

**Demo: https://edition.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Edition/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Edition styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/edition.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).

A clean, minimal newsletter theme for the Ghost publishing platform


Nostr site theme package: edition v.1.0.0


# Paway free theme for [Ghost](https://github.com/tryghost/ghost/)

[![Ghost version](https://img.shields.io/badge/Ghost-5.x-brightgreen.svg)](https://github.com/TryGhost/Ghost)
[![Donate](https://img.shields.io/badge/donate-paypal-blue.svg)](https://www.paypal.me/godofredoninja)

> For fancy people, Photographers and Travel Lovers

Paway theme is for photo blog writers and for those who like to share their stories in a simple and elegant way. The theme has a clean and modern design, using all the browser screen space.
It is suitable for any kind of blog: personal, fashion, food, travel, photography.

[![donate](./donate.gif)](https://www.paypal.me/godofredoninja)

[![Paway free theme for ghost](./assets/images/screenshot-desktop.jpg)](https://www.behance.net/gallery/89704867/Paway-For-fancy-people-Photographers-and-Travel-Lover)

## Demo

See the screenshot on [behance](https://www.behance.net/gallery/89704867/Paway-For-fancy-people-Photographers-and-Travel-Lover)

## Featured

- Support for different [languages](http://themes.ghost.org/docs/i18n#section-how-to-add-any-language) (en - es)
- [AMP](https://github.com/godofredoninja/Hodor-AMP-Ghost) Template
- Responsive Layout
- Tag Page
- Site Navigation
- Related Articles (3 articles)
- Links to Social Media
- Page 404
- Native Comments
- Native Search
- Buttons to share the article (Facebook - Twitter - Reddit - Linkedin)
- YouTube, Vimeo, kickstarter, dailymotion => Responsive
- Lazy load Image for better performance
- [Theme Translation](#theme-translation)
- [AMP](#amp)

## Theme Translation

> Paway supports

- `en` — English default language
- `es` — Spanish

if you want to have in another language you just have to copy `locales>en.json` and rename the file then translate to your favorite language:

Just enter the [language/locale tag](https://www.w3schools.com/tags/ref_language_codes.asp) of the files to use (e.g.: `fr.json` for French, `zh.json` for Chinese, `ja.json` for Japanese)

## AMP

— *Paway has a nice page for **AMP***

- Navigation
- links to followers in social media
- Tags
- Related Articles (6 articles)
- Buttons to share the article (Facebook - Twitter - Whatsapp)

To customize the AMP page [read here](https://github.com/godofredoninja/Hodor-AMP-Ghost)

### Credits

- [Hodor AMP](https://github.com/godofredoninja/Hodor-AMP-Ghost)
- [Normalize](https://necolas.github.io/normalize.css/)
- [Lazysizes](https://github.com/aFarkas/lazysizes)
- [lightgallery.js](https://github.com/sachinchoolur/lightgallery.js/)
- [Fonts](https://fonts.google.com/?query=lor&selection.family=Lora|Playfair+Display)
- [Safari Light - Mockup](https://www.uplabs.com/posts/safari-light-version)

## Copyright & License

Copyright (c) 2019 GodoFredo - Released under the [GPLv3 license](LICENSE)


# Digest

A minimal newsletter theme for [Ghost](https://github.com/TryGhost/Ghost). This theme keeps your homepage dynamic and fresh by always displaying the latest issue you’ve published. From there, your audience can either navigate to the previous issue or see the archive of all the issues.

**Demo: https://digest.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Digest/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/digest.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).


Nostr site theme package: digest v.1.0.0


# Massively

This is Massively, a text-heavy, article-oriented design built around a huge background
image and scroll effects powered by Scrollex. Originally created by [@ajlkn](https://twitter.com/ajlkn) for [HTML5 UP](https://html5up.net) and later ported to [Ghost](https://ghost.org)

**Demo: https://massively.ghost.io**

![image](https://user-images.githubusercontent.com/120485/49293031-7276b000-f4e1-11e8-8b71-43dc53c67f00.png)

# First time using a Ghost theme?

Ghost uses a simple templating language called [Handlebars](http://handlebarsjs.com/) for its themes.

We've documented our default theme pretty heavily so that it should be fairly easy to work out what's going on just by reading the code and the comments. Once you feel comfortable with how everything works, we also have full [theme API documentation](https://themes.ghost.org) which explains every possible Handlebars helper and template.

**The main files are:**

- `default.hbs` - The main template file
- `index.hbs` - Used for the home page
- `post.hbs` - Used for individual posts
- `page.hbs` - Used for individual pages
- `tag.hbs` - Used for tag archives
- `author.hbs` - Used for author archives

One neat trick is that you can also create custom one-off templates just by adding the slug of a page to a template file. For example:

- `page-about.hbs` - Custom template for the `/about/` page
- `tag-news.hbs` - Custom template for `/tag/news/` archive
- `author-ali.hbs` - Custom template for `/author/ali/` archive

# Development

This implementation tries to stay as true as possible to the original template without making too many modifications. The original code is unmodified, preserving the ability to update it later.

There are two main changes compared to the original template files:

- The original template contained separate `/assets` and `/images` directories. Ghost Themes require that all assets be nested under a top-level `/assets` directory, so these are moved to `/assets/main` and `/assets/images`, respectively.
- In order to make minor modifications and add some new custom styles, one additional SaSS file is added under `/assets/main/sass/layout/ghost.sass` and included at the bottom of the `main.sass` file.

To work on styles in this theme, you'll need to run a local development environment to build/watch for changes. Once cloned and installed with npm/yarn, the following `gulp` build tasks are available:

```bash
# Build files locally and watch for changes
gulp

# Build production zip locally and save to /dist
gulp zip

# Run compatibility test against latest version of Ghost
yarn test
```

Original template files and design by [@ajlkn](https://twitter.com/ajlkn)

# Copyright & License

Copyright (c) 2013-2022 [HTML5 UP](https://htmlup.net) & [Ghost Foundation](https://ghost.org) - This theme is licensed under both the [MIT and Creative Commons Attribution 3.0](LICENSE). Please note that the terms of the Creative Commons license require that you maintain the footer attribution to freely use this theme.

Nostr site theme package: massively v.1.1.0

This is Massively, a text-heavy, article-oriented theme for Ghost.


# Solo

Solo is a minimal theme for [Ghost](https://github.com/TryGhost/Ghost) focused on showcasing the work of an individual writer or creator. This theme is highly customizable, with a few simple settings that allow you to quickly apply your own personal style to your site.

**Demo: https://solo.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Solo/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Edition styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/solo.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

## Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).


# Edge

A visually aesthetic [Ghost](https://github.com/TryGhost/Ghost) theme designed for creative professionals. Showcase your works with minimal style and presentation.

**Demo: https://edge.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Edge/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/edge.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).


# Journal

A minimal, typography-heavy newsletter theme for [Ghost](https://github.com/TryGhost/Ghost).

**Demo: https://journal.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Journal/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Edition styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/journal.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).


Nostr site theme package: journal v.1.0.0


# Ruby

A multi-column [Ghost](https://github.com/TryGhost/Ghost) theme with a unique card layout. Make your publication more organized with cards and widgets.

**Demo: https://ruby.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Ruby/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/ruby.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).


Nostr site theme package: episode v.1.0.0


# Wave

Wave is a [Ghost](https://github.com/TryGhost/Ghost) theme dedicated to podcasters. Share your voice and words with your audience.

**Demo: https://wave.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Wave/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Edition styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/wave.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

## Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).


# Dawn

A highly functional [Ghost](https://github.com/TryGhost/Ghost) theme that adapts to the reader's preferences. Let them read, search, subscribe, navigate, and more with ease.

**Demo: https://dawn.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Dawn/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/dawn.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).


# London

A custom, image-centric theme for [Ghost](https://github.com/TryGhost/Ghost). Made for publishers and portfolios with plenty of graphics to show off to the world.

**Demo: https://london.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/London/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Edition styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/london.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).

Nostr site theme package: london v.1.0.0

A minimum, image-centric theme for Ghost.


# Alto

A clean, minimalist [Ghost](https://github.com/TryGhost/Ghost) theme featuring a light and dark mode. Launch your online publications with flair.

**Demo: https://alto.ghost.io**

# Instructions

1. [Download this theme](https://github.com/TryGhost/Alto/archive/main.zip)
2. Log into Ghost, and go to the `Design` settings area to upload the zip file

# Development

Styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
yarn dev
```

Now you can edit `/assets/css/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/alto.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Contribution

This repo is synced automatically with [TryGhost/Themes](https://github.com/TryGhost/Themes) monorepo. If you're looking to contribute or raise an issue, head over to the main repository [TryGhost/Themes](https://github.com/TryGhost/Themes) where our official themes are developed.

# Copyright & License

Copyright (c) 2013-2023 Ghost Foundation - Released under the [MIT license](LICENSE).


    Docs
    ·
    Showcase
    ·
    Contributing
    ·
    PayPal
    ·
    Twitter

    Hello :sunglasses:

    I created this theme for Ghost with inspiration from Medium.

    It is available for free so you can use on your site.

[![Simply free theme for ghost](https://user-images.githubusercontent.com/10253167/162076408-0356f347-6d0b-47ad-a640-e8ee7a2494af.jpg)](https://godofredo.ninja/ghost-theme/simply/)

## Featured

- Simply Settings
  - [Social Media](https://godofredo.ninja/ghost-theme/simply/settings/#socialmedia)
  - [Search](https://godofredo.ninja/ghost-theme/simply/settings/#search)
  - [Logo Light / Dark Mode](https://godofredo.ninja/ghost-theme/simply/settings/#logolightdarkmode)
- Site wide
  - [Header](https://godofredo.ninja/ghost-theme/simply/layouts/#header)
    - Defautl
    - DropDown Menu
  - [Footer](https://godofredo.ninja/ghost-theme/simply/layouts/#footer)
    - Default
    - Dark
    - No Secondary Navigation
  - [Color Scheme](https://godofredo.ninja/ghost-theme/simply/settings/#colorscheme)
    - Auto (default)
    - Dark Mode
    - Light Mode
  - [Pagination](https://godofredo.ninja/ghost-theme/simply/settings/#pagination)
    - Infinite Scroll (default)
    - Pagination Number
  - [Membership](https://godofredo.ninja/ghost-theme/simply/members/)
    - [Disable Membership](https://godofredo.ninja/ghost-theme/simply/members/#disablemembership)
- [Homepage](https://godofredo.ninja/ghost-theme/simply/settings/#homepage)
  - [Publication cover](https://godofredo.ninja/ghost-theme/simply/settings/#homepage)
    - None
    - Featured -> Latest Featured Article
    - Featured Slider -> 3 Latest Articles
    - Cover (default)
      - Publication cover title
      - Publication cover description
      - Publication cover color
      - Publication cover img
- Post
  - [Post Font](https://godofredo.ninja/ghost-theme/simply/settings/#postfont)
    - font-serif (default)
    - font-sans
  - [Newsletter](https://godofredo.ninja/ghost-theme/simply/settings/#newsletter)
    - Show / Hide
    - Newsletter Text
  - Comments
    - [Ghost Native Comments](https://ghost.org/help/commenting/)
    - [Disqus Comments](https://godofredo.ninja/ghost-theme/simply/settings/#disquscomments)
    - [Facebook Comments](https://godofredo.ninja/ghost-theme/simply/settings/#facebookcomments)
    - [Hyvor Talk Comments](https://godofredo.ninja/ghost-theme/simply/settings/#hyvortalk)
- [Publication Language](./languages.md)
  - `en` — English default language
  - `es` — Español
  - `de` — German by [dkbast](https://github.com/dkbast)
  - `tr` — Turkish by [Mertcan GÖKGÖZ](https://github.com/MertcanGokgoz), [@tolgaaaltas](https://github.com/tolgaaaltas)
  - `fr-CA` — Canadian French by [Pascal Andy](https://github.com/pascalandy)
  - `ru` — Russian by [Partizan007](https://github.com/partizan007)
  - `vi` — Vietnamese by [ping](https://github.com/everping)
  - `fr` — French by [ping](https://github.com/StanGirard)
  - `it` — Italian by [Marco Sanson](https://github.com/marcosanson)
  - `id` — Indonesian by [Adryan Eka Vandra](https://github.com/adryanev)
  - `pt-BR` — Brazilian by [Daniel Pereira](https://github.com/danieldeev), [Alexandre "Lekler"](https://github.com/lekler)
  - `uz` — Uzbek by [Shukrullo Turgunov](https://github.com/vodiylik)
  - `pl` — Polish by [Anarion](https://github.com/anarion80)
  - `nl` — Dutch by [exbu](https://github.com/exbu)
- Home Page
  - [Default](https://godofredo.ninja/ghost-theme/simply/home-page/#default)
  - [Featured](https://godofredo.ninja/ghost-theme/simply/home-page/#featured)
  - [Medium](https://godofredo.ninja/ghost-theme/simply/home-page/#medium)
  - [Sidebar](https://godofredo.ninja/ghost-theme/simply/home-page/#sidebar)
  - [Grid](https://godofredo.ninja/ghost-theme/simply/home-page/#grid)
  - [Personal](https://godofredo.ninja/ghost-theme/simply/home-page/#personal)
  - [Archive](https://godofredo.ninja/ghost-theme/simply/home-page/#archivepage)
  - [Featured with Slider](https://godofredo.ninja/ghost-theme/simply/home-page/#featuredwithslider)
  - [Medium with Sidebar](https://godofredo.ninja/ghost-theme/simply/home-page/#mediumwithsidebar)
  - [Photographer](https://godofredo.ninja/ghost-theme/simply/home-page/#photographer)
- Post Format
  - [Post Default](https://godofredo.ninja/ghost-theme/simply/post-format/#postdefault)
  - [Post Full](https://godofredo.ninja/ghost-theme/simply/post-format/#postfull)
  - [Post Wide](https://godofredo.ninja/ghost-theme/simply/post-format/#postwide)
  - [Post Header Image](https://godofredo.ninja/ghost-theme/simply/post-format/#postheaderimage)
  - [Post Image](https://godofredo.ninja/ghost-theme/simply/post-format/#post-image)
  - [Post Image Right](https://godofredo.ninja/ghost-theme/simply/post-format/#postimageright)
  - [Post Sidebar](https://godofredo.ninja/ghost-theme/simply/post-format/#post-sidebar)
  - [Post not Image](https://godofredo.ninja/ghost-theme/simply/post-format/#postnotimage)
  - [Post Toc](https://godofredo.ninja/ghost-theme/simply/post-format/#posttoc)
- Page Format
  - Page Default
  - Page Toc
- Page
  - [Contact](https://godofredo.ninja/ghost-theme/simply/contact-page/)
  - [Podcast](https://godofredo.ninja/ghost-theme/simply/podcast-page/)
  - [Portfolio](https://godofredo.ninja/ghost-theme/simply/portfolio-page/)
  - 404
- Archive
  - [Authors Page](https://godofredo.ninja/ghost-theme/simply/authors-and-tags-page/#authorspage)
  - [Tags Page](https://godofredo.ninja/ghost-theme/simply/authors-and-tags-page/#tagspage)
- [Kusi Doc](https://godofredo.ninja/ghost-theme/simply/kusi-doc/) for the documentation of your project
- [AMP](https://github.com/godofredoninja/Hodor-AMP-Ghost) Template
- Post and Page
  - [Prism supported all syntax](https://prismjs.com/index.html#supported-languages)
  - Medium style image zoom
  - Video Responsive
    - Video
    - YouTube
    - Vimeo
    - kickstarter
    - Dailymotion
- Post Content
  - Related Articles
  - Social share buttons support for posts
  - Previous and next Post
- Sidebar
  - 3 featured articles on the home page
  - 3 lates articles
  - Tag Cloud
- Lazy Loading for images
- Tracking [Google Tag Manager](https://godofredo.ninja/ghost-theme/simply/tracking-google-tag-manager/)

## Automate theme deployment via Ghost API

- Visit ghost admin page > settings > integrations
- At the bottom of that page, click the button to `Add custom integration`
- Name the new custom integration any thing you like - say - `automated-updates` and save.
- Copy the Admin API key
- Create a file named `.env` in the theme folder
- Paste the Admin API key in the `.env` file as shown below.
- Do not git commit push the `.env` file.
- I have already made sure to .gitignore the `.env` file to make sure you don't accidentally spill your secret Admin API key.
- Also, in the same `.env` file, replace the API URL - which the URL where your site is currently located
```
GHOST_API_URL=https://domain.TLD
GHOST_ADMIN_API_KEY=provideyouradminapikeyfromtheghostdashboard
THEME_NAME=simply
API_VERSION="v5.0"
```
- run the following conmmand to deploy your theme updates to your ghost installation
```
yarn deploy
```
or if you prefer npm over yarn
```
npm run deploy
```
- You will see that the updates you made in the theme locally are now deployed and activated in your ghost setup.

"Now you can iteratively edit, deploy, and test your theme without leaving your command line :)"

You can also incorporate this deploy step in your CICD pipeline if you use any.

## Contributing

Im always looking for contributors of all skill levels! If you're looking to ease your way into the project, try out a [good first issue](https://github.com/godofredoninja/simply/labels/%F0%9F%8C%B1%20good%20first%20issue).

I greatly appreciate any help in maintaining to keep the documentation up to date. My English is not so good and I am trying to make the documentation more understandable.

If you are interested in collaborating with Simply, take a look at the [Contributing Guide](https://github.com/godofredoninja/simply/blob/master/CONTRIBUTING.md).

### Code Contributors

This project exists thanks to all the people who contribute. [[Contribute](https://github.com/godofredoninja/simply/blob/master/CONTRIBUTING.md)].

[![Simply Contributors](https://opencollective.com/simply/contributors.svg?width=890&button=false)](https://github.com/godofredoninja/simply/graphs/contributors)

### Financial Contributors

First I want to say thank you with all my heart and a million more Thank you. The [donation](https://www.paypal.me/godofredoninja) you have made has motivated me to continue working with the improvement and updating the theme.

Become a financial contributor and help us sustain our community. [[Contribute](https://opencollective.com/simply/contribute)]

- [Open Collective](https://opencollective.com/simply/contribute)
- [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y7UB5Q8GVN3HN&source=url)
- Bitcoin: **3QF5D9QyV9YQdPJVu2HLN8fkdWVbmezd5J**
- Ethereum: **0x503bAA618d29774f03c7053218999Ad567a9fc71**

[![Individuals Financial](https://user-images.githubusercontent.com/10253167/103444000-877b1b80-4c32-11eb-8377-7bedd46dbdf8.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y7UB5Q8GVN3HN&source=url)

- [CMS Critic](http://www.cmscritic.com/) :star: :star: :star: :star:
- [A Boundless World](https://www.aboundlessworld.com/) :star: :star:
- [Dana Ross](https://vaalin.com/)
- [Kip Ivan](https://github.com/Ingles-con-Kip)
- [Wenjer India](http://qilinlab.com)
- Etienne Triaud :star: :star:
- Greg Rapp
- Yannick Kordel
- Bruno Brito Semedo
- Ivan Rodriguez Segura
- Rodrigo Franken Dutra
- Diego Alcantara Zweifel
- Andrew Wagner

[![Individuals Financial](https://opencollective.com/simply/individuals.svg?width=890)](https://opencollective.com/simply)

## Sponsored

- [Digital Ocean](https://m.do.co/c/710a27a3b3de) using my [referral link]((https://m.do.co/c/710a27a3b3de)) and you will get free a **$100 in credit valid for 60 days**

[![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%201.svg)](https://www.digitalocean.com/?refcode=710a27a3b3de&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge)

## Credits

- [Hodor AMP](https://github.com/godofredoninja/Hodor-AMP-Ghost)
- [Tailwind CSS](https://github.com/tailwindlabs/tailwindcss)
- [Ionicons](https://github.com/ionic-team/ionicons)
- [IcoMoon](https://icomoon.io/)
- [Lazysizes](https://github.com/aFarkas/lazysizes)
- [Medium Zoom](https://github.com/francoischalifour/medium-zoom)
- [Prismjs](https://github.com/PrismJS/prism/)
- [Inter Font Family](https://github.com/rsms/inter/)
- [PT Serif Font Family](https://fonts.google.com/specimen/PT+Serif)
- [Safari Light - Mockup](https://www.uplabs.com/posts/safari-light-version)
- [Tiny Slider](https://github.com/ganlanyuan/tiny-slider)

## Copyright & License

Copyright (c) 2017-2022 GodoFredo - Released under the [GPLv3 license](LICENSE)

simply theme for ghost by @GodoFredoNinja


Insights on security, privacy, technology, & money · Casa Co-founder & Chief Security Officer · https://bitcoin.page


Singer. Songwriter. Pop/Rock Artist. Disrupting music one zap at a time. Zap along on @wavlake @fountain.fm @Trufans.fm @tunestr.io ⚡IS 💛 #nostrmusic
MGMT: @phantompowermusic.io


# Biron - Ghost Theme

Biron is a Free Ghost Theme based on [Bulma](https://bulma.io/)
By [Biron Themes](https://bironthemes.com)

Ghost 3.0 ready but the Membership feature is not yet integrated.

[Details](https://bironthemes.com/themes/biron-ghost/)

[Demo](https://biron.bironthemes.com)

[Documentation](https://bironthemes.com/docs/biron-ghost/)

![Screenshot](https://github.com/bironthemes/biron-ghost-theme/raw/master/demo.jpg)

### More [Ghost Themes](https://bironthemes.com)


# Liebling

Liebling is a beautiful and clean Ghost theme that is easy and comfortable to use. **It's free** and you can use it for any kind of content you might have. Now with dark mode 🌓!

If you find this theme useful, please consider to make a donation to support its development! 🙏🏼

## Ghost 5

This theme has been optimized for Ghost 5, if you are looking for a Ghost 4 compatible version please refer to [this link](https://github.com/eddiesigner/liebling/releases/tag/v1.5.2).

## Preview

You can see a live demo here: [https://liebling.eduardogomez.io](https://liebling.eduardogomez.io)

![](https://res.cloudinary.com/edev/image/upload/v1583792928/liebling/liebling-promo-desktop.jpg)

![](https://res.cloudinary.com/edev/image/upload/v1570370297/liebling/liebling-promo-mobile.jpg)

## Download

To get the latest version please head over the [releases page](https://github.com/eddiesigner/liebling/releases) and download the file `liebling.zip` of the latest release.

## Documentation

To know how to enable the search, comments, newsletter and more, please head to the [Wiki](https://github.com/eddiesigner/liebling/wiki).

## Features

### General features

* Clean and beautiful design
* Lightning fast
* Lightweight and high performance
* Fully responsive, looks great on any device
* Compatible with modern browsers

### Ghost features

* Subscription form
* Multiple authors
* Logo support
* Secondary menu
* Accent color
* Featured posts and pages
* Post, Page, Tag, Authors, pages
* Koenig editor
* Bookmark card
* Gallery card
* Button card
* NFT card
* Callouts
* Toggles
* Quotes
* Products
* Audio
* Video
* File uploads
* Headers
* Blog title and description
* Cover image for Home, Post, Page, Tag, Author pages
* Author avatar, bio, location, website and social links
* Facebook and Twitter social links
* Reading time
* Next and Previous post navigation
* Primary tag in posts

### Liebling unique features

* Dark mode
* Search
* Custom settings
* Custom Subscribe page
* Custom authors page
* Custom error page
* Medium style image zoom
* Comments with Disqus
* Share post on Facebook and Twitter
* Slider for featured posts
* Support for normal, wide and full images in posts
* Reading progress indicator
* RTL language support

## Localization

* English
* Spanish
* German by [D3473R](https://github.com/D3473R)
* Informal german by [D3473R](https://github.com/D3473R)
* Bulgarian by [clappingmonkey](https://github.com/clappingmonkey)
* Vietnamese by [hiensarahly](https://github.com/hiensarahly)
* Italian by [vignini](https://github.com/vignini)
* French by [v1nc3nt-fr](https://github.com/v1nc3nt-fr)
* Informal french by [v1nc3nt-fr](https://github.com/v1nc3nt-fr)
* Portuguese by [ivomota](https://github.com/ivomota)
* Arabic by [allamiro](https://github.com/allamiro)
* Polish by [otlet](https://github.com/otlet)
* Brazilian portuguese by [pedrinholula](https://github.com/pedrinholula)
* Russian by [stereohorse](https://github.com/stereohorse)
* Kyrgyz by [januchaos](https://github.com/januchaos)
* Hebrew by [cohen604](https://github.com/cohen604)
* Turkish by [mskoroglu](https://github.com/mskoroglu)
* Romanian by [dsecareanu](https://github.com/dsecareanu)
* Chinese Simplified by [IvyB](https://github.com/IvyB)
* Indonesian by [iqbalbinsb](https://github.com/iqbalbinsb), [khannedy](https://github.com/khannedy)
* Lithuanian by [pintom](https://github.com/pintom)
* Dutch by [Qballjos](https://github.com/Qballjos)
* Traditional Chinese by [weixiang](https://github.com/weixiang)
* Persian (Farsi) by [Aminoiz](https://github.com/Aminoiz)
* Ukrainian by [partizan007](https://github.com/partizan007)
* Kazakh by [arshyn-t](https://github.com/arshyn-t)
* Korean by [chocosobo](https://github.com/chocosobo)
* Japanese by [ViaSnake](https://github.com/ViaSnake)
* Czech by [Fjuro](https://github.com/Fjuro)
* Swedish by [momeenme](https://github.com/momeenme)
* Slovak by [jjuris](https://github.com/jjuris)
* Thai by [Parinya T.](https://github.com/pickyzz)

## Tests performed

* W3C Markup Validation: [Correct validation](https://validator.w3.org/nu/?doc=https%3A%2F%2Fliebling.eduardogomez.io%2F)
* Ghost GScan: [100/100 points](https://gscan.ghost.org/)
* GTmetrix PageSpeed Score: **A (97%)**
* PageSpeed Insights: **94/100** (mobile) **99/100** (desktop)
* Pingdom Performance Grade: **A 91**

## Theme development

Thanks to [D3473R](https://github.com/D3473R) 💪🏼 for creating a development environment with Docker. From now on you can work on this theme without installing a Ghost instance on your local machine. With two commands you have an instant development setup and you can build the theme for production.

Please take a look to this page to see how it works: https://github.com/eddiesigner/liebling/wiki/Theme-development-with-Docker

## Help and Support

If you have any questions or troubles with this product, please feel free to open an issue [here](https://github.com/eddiesigner/liebling/issues).

## Contributing

Contributions are very welcome. First, please read the [Pull Request Guidelines](https://github.com/eddiesigner/liebling/wiki/Pull-Request-Guidelines) on the wiki.

## Related

* [Glow](https://eddiesigner.gumroad.com/l/glow) - Beautiful, clean, minimalist and powerful Ghost theme perfect for writers which offers a pleasant reading experience.

* [Bold](https://eddiesigner.gumroad.com/l/ltqtms) - Bold is a Ghost theme designed to be minimal and customizable, allowing individuals to create a sleek and modern online presence.

* [Galerie](https://eddiesigner.gumroad.com/l/KgroF) - Modern and versatile theme that stands out for its sleek design, it's incredibly fast, it offers a great user experience and it has many options to customise it.

* [Firma](https://gum.co/ZXLha) - Ghost theme that can be used by startups to large companies to publish any kind of articles related to their business. It stands out for its clean design and is able to adapt to any company's identity.

* [Weiss Pro](https://gum.co/pzvDn) - Modern and beautiful Ghost theme ready to make your content shine.

## License

Copyright (c) 2019-present Eduardo Gómez. Released under the [MIT license](https://github.com/eddiesigner/liebling/blob/master/LICENSE).

## Credits

All the photos I used in this theme were taken from [Unsplash](https://unsplash.com)


# aEsto - Minimalist Blog & Magazine theme for Ghost

Aesto is a Ghost theme with clean & content focused design. The theme is fully responsive so it fits at any screen sizes. Aesto supports Ghost membership feature so that you can turn your audience in to business. This theme is suitable for personal & professional blog or for your multi author magazine.

[Demo](https://aesto.inoryum.com) - [Download](https://github.com/Inoryum-Ltd/aesto/releases) - [Documentation](https://inoryum.com/docs/aesto)

### Aesto Demo is Hosted by [Spookey.io](https://spookey.io) Managed Ghost Publication Specially for NoCode Lovers

***

#### Inoryum Themes rebranding as [Visioun](https://visioun.com)

[Visioun](https://visioun.com) a TaaS(Themes as a Service) for your ghost publication. See [Pricing](https://visioun.com/pricing). With [Visioun](https://visioun.com) subscription you will get access to all the premium ghost themes, Plus a new theme each month.

***

# Theme features

*   Clean & responsive design
*   Lightweight
*   Enhanced performance
*   Responsive images
*   Lazy Loading for images
*   SVG icons are used
*   Well structured & commented codes
*   Easy to customize
*   Instant Search
*   Disqus comments integrated
*   Custom Template for Tags & Authors pages
*   Social share support for posts
*   Responsive videos
*   Developer friendly

# Ghost core features

*   Membership support
    - Signin page
    - Signup page
    - Account page
    - Pricing page
    - Notifications
    - Call to action for subscription in members, paid-members only post.
    - Post visibility depending on access
*   Translation ready
    - English, Spanish, Italian & Turkish included.
*   Publication title & description
*   Publication icon & Logo
*   Custom excerpt support
*   Primary & secondary Navigation
    - Primary navigation on header
    - Secondary navigation on footer
*   Subscriber form
*   Feature Icon for Featured post
*   Social links & icons
*   Tag archive
*   Tag Accent Color in tag show page & custom tag list page
*   Author archive
*   Read time
*   Multiple author support for post
*   Koenig Editor
    - Gallery and Bookmark and all other inbuilt card in Koenig editor
*   Responsive YouTube, Vimeo, SoundCloud, Spotify, twitter, Instagram and all other embed
*   Previous and next post link in single post view

# Documentation

For Documentation Checkout the Link [Here](https://inoryum.com/docs/aesto)

# Credits

*   Images by [Unsplash](https://unsplash.com/)
*   [jQuery](https://jquery.com/)
*   Search Engine by [SearchinGhostEasy](https://github.com/gmfmi/searchinghost-easy)
*   [FitVids](http://fitvidsjs.com/)
*   Built on top of [Ghost Starter Theme](https://github.com/TryGhost/Starter)
*   Demo Hosted By [spookey.io](https://spookey.io)

# Development

Styles are compiled using Gulp/PostCSS to polyfill future CSS spec. You'll need [Node](https://nodejs.org/), [Yarn](https://yarnpkg.com/) and [Gulp](https://gulpjs.com) installed globally. After that, from the theme's root directory:

```bash
# Install
yarn

# Run build & watch for changes
$ yarn dev
```

Now you can edit `/assets/scss/` files, which will be compiled to `/assets/built/` automatically.

The `zip` Gulp task packages the theme files into `dist/<theme-name>.zip`, which you can then upload to your site.

```bash
yarn zip
```

# Copyright & License

Copyright (c) 2020 Inoryum Ltd - Released under the [MIT license](LICENSE).

Minimalist blog & magazine theme for ghost


Fully featured theme with clean presentation.


# Moegi

[中文文档](README_zh.md)

[![Ghost Version](https://img.shields.io/badge/Ghost-3.x-green.svg)](https://github.com/TryGhost/Ghost)
[![Ghost Version](https://img.shields.io/badge/Ghost-4.x-green.svg)](https://github.com/TryGhost/Ghost)
[![Build & Push & Deploy](https://github.com/moegi-design/ghost-theme-Moegi/workflows/Build%20&%20Push%20&%20Deploy/badge.svg)](https://github.com/moegi-design/ghost-theme-Moegi/actions)
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/moegi-design/ghost-theme-Moegi)](https://github.com/moegi-design/ghost-theme-Moegi/releases)

![Moegi Theme](screenshot.png)

## Download

### Stable Build

The version with major updates. Go to [Releases](https://github.com/moegi-design/ghost-theme-Moegi/releases) to download stable version.

### Nightly Build

Every commit in this branch will be built and tested automatically by Github Actions. Go to [dist branch](https://github.com/moegi-design/ghost-theme-Moegi/tree/dist) or directly [download the newest zip](https://github.com/moegi-design/ghost-theme-Moegi/archive/dist.zip).

## Development

Moegi theme is compiled with [Vite](https://github.com/vitejs/vite) + [Tailwind CSS](https://github.com/tailwindlabs/tailwindcss). You'll need Node installed globally.

```shell
# Install dependencies
yarn install

# Run development server & watch for changes
yarn dev
```

This will create an HMR server. If you have a Ghost server running locally, modifying the template file will automatically update the page.

```shell
# Create dist file
yarn build
```


# The Fizzy Theme

[![demo](https://img.shields.io/badge/Demo-online-yellow.svg)](https://fizzy.cc/)
[![Ghost version](https://img.shields.io/badge/Ghost->=3.x-brightgreen.svg)](https://github.com/TryGhost/Ghost)
[![Release](https://img.shields.io/github/release/huangyuzhang/Fizzy-Theme.svg)](https://github.com/huangyuzhang/Fizzy-Theme/)
[![GitHub forks](https://img.shields.io/github/forks/huangyuzhang/Fizzy-Theme.svg)](https://github.com/huangyuzhang/Fizzy-Theme/network)
[![GitHub stars](https://img.shields.io/github/stars/huangyuzhang/Fizzy-Theme.svg?style=social&label=Star)](https://github.com/huangyuzhang/Fizzy-Theme/stargazers)

A tasty blogging theme for Ghost :ghost:

Thanks to everyone who starred this project. Please read the documentation to exploit all the features of this theme.

[中文文档](./README-zh.md)

![](https://user-images.githubusercontent.com/40261916/60045241-3e045480-96bc-11e9-9382-03789cd8a637.jpg)

## 🔧 Installation
- [Stable Version](https://github.com/huangyuzhang/Fizzy-Theme/releases/latest/)
- [Development Version](https://github.com/huangyuzhang/Fizzy-Theme/tags/)

Download the `.zip` file and upload it at your Ghost Admin > Setting > Design.

## 🎥 Demo

My blog [Fizzy.cc](https://fizzy.cc) is currently using this theme.

Use this [issue](https://github.com/huangyuzhang/Fizzy-Theme/issues/20) to add your site with Fizzy Theme.

## 🍹 Features and Usage

### Logo
If only **site icon** is uploaded, the Logo area will display the **icon** and followed by the **Site name** then a dot colored as the **main color**, e.g.:

If **site logo** is uploaded, then the Logo area will only display the **site logo**.

> Note: Since the top navbar is colored with white background, it would be better to use a dark/colorful logo.

### :earth_africa: i18n
You can change the theme's language in Ghost Admin -> General -> "Publication Language".

|  Code   |       Language       | Status |                    Translator                     |
| :-----: | :------------------: | :----: | :-----------------------------------------------: |
|  `de`   |        German        |   ✅   |   [Marek Schmidt](https://github.com/MSDev201)    |
|  `en`   |       English        |   ✅   |                                                   |
|  `fr`   |        French        |   ✅   |        [Lourys](https://github.com/Lourys)        |
|  `it`   |       Italian        |   ✅   |        [Pyrox](https://github.com/Pyr0x1)         |
| `pt_BR` | Brazilian Portuguese |   ✅   | [matheusvanzan](https://github.com/matheusvanzan) |
|  `ta`   |        Tamil         |   ✅   |   [MC Naveen](https://github.com/the-mcnaveen)    |
|  `th`   |         Thai         |   ✅   |         [atbee](https://github.com/atbee)         |
|  `tr`   |       Turkish        |   ✅   |         [talut](https://github.com/talut)         |
| `zh_CN` | Chinese (Simplified) |   ✅   |                                                   |

Please help to translate Fizzy into the languages you know. To do so, first fork this repo. Then you need to copy the `en.json` file under `locales` folder and rename it to your language code, e.g. `es.json`, `zh_TW.json`. Then modify the translations within it. After testing, please create a "Pull Request" to `dev` branch of this repo (not `master`).

### Assets Localization
You could customize the following files to define the CDN of assets to speed up access in specific regions:
- `./default.hbs`
- `./partials/post/post_footer.hbs`
- `./partials/post/post_toc.hbs`

### Internal tags
Internal tags start with `#`, after creating it will displayed as internal tag automatically. Internal tags will not be displayed in front-end. So far the Fizzy Theme support the following internal tags:
- **Carousel**: Use internal tag `#carousel`(slug:`hash-carousel`) to add posts into carousel in homepage (see [Showcase](#showcase)).
- **No Index**: Use internal tag `#noindex`(slug:`hash-noindex`) to exclude posts from listing in home page.
> limitation: hiding posts with `#noindex` tag, but the number of posts displayed for that page will change as well.

### Showcase
The showcase section is built to highlight posts. It is available only on the homepage. Insert the following code into Ghost Admin -> Code injection -> `Site Header` to enable the showcase:

```javascript
<script>
  var show_showcase = true; //default: false
</script>
```

The left slider carousel part detects the internal tag `#carousel`. The right part will display 2 featured posts.

![showcase](https://user-images.githubusercontent.com/40261916/60126667-65bfef00-9786-11e9-94e8-eaa4c2a4559f.jpg)

### Author Page
You can customize the author page by editing your **profile** in Ghost Admin, such as **name**, **avatar**, **background image**, **social account links**, **location** and **bio**. Author page ([demo](https://fizzy.cc/author/simon/))

### Tag Page
You can customize the tag page by editing **tags** in Ghost Admin, such as **image**, **description**. Tag Page ([demo](https://fizzy.cc/tag/blogging/))

### Custom Templates
Open the gear icon ⚙ while editing a post or page, scroll to the bottom and change `Template` option.
- **Tag Archive**: used for listing all tags/topics in one page. ([demo](https://fizzy.cc/tag/))
- **Post Archive**: used for listing all posts in one page. ([demo](https://fizzy.cc/archive/))
- **Full Width**: full width post. ([demo](https://fizzy.cc/fizzy-theme/))
- **Post With TOC**: TOC-enabled post, details in [#TOC](#toc). ([demo](https://fizzy.cc/fizzy-theme/))
- **Featured Posts Archive**: post list for featured posts, page title and content will be shown on the top section. ([demo](https://fizzy.cc/featured/))

### Collection
To enable collection, edit the `routes.yaml` as below. Then modify the `home.hbs` to customize your homepage. Full doc: [Ghost Docs - Collections](https://docs.ghost.org/api/handlebars-themes/routing/collections/)

```yaml
routes:
  /: home # template for homepage `home.hbs`

collections:
  /movie/: # a collection called movie
    permalink: /movie/{slug}/
    template: movie # template `movie.hbs`
    filter: tag:movie # fetch data from a tag:movie
    data: tag.movie # have access to all data & meta data from tag
  /music/: # a collection called music
    permalink: /music/{slug}/
    template: music # template `music.hbs`
    filter: primary_tag:music # fetch data from primary tag: music
    data: tag.music # have access to all data & meta data from tag
```

> **Notice**: known issues of Ghost collection, e.g.: [Ghost #10082](https://github.com/TryGhost/Ghost/issues/10082).

### Custom CSS Variables
Download the theme `.zip` file, unzip it then edit the variables in `assets/css/custom.css` to customize your theme coloring. After that, zip everything back into a `.zip` file and upload it onto your Ghost admin.

### Custom Footer Text
By default, your **site description** (Ghost Admin -> General) will be displayed in the footer text. If you need to change it, define a variable `footer_text` in the `Site Header` as below:

```javascript
<script>
  var footer_text = "REPLACE WITH YOUR FOOTER TEXT HERE";
</script>
```
> You can include HTML in the `footer_text`, but be careful to use single quotation marks inside it. For example:
> `var footer_text = "REPLACE <span style='color:red;font-weigh'>WITH</span> YOUR FOOTER TEXT HERE <i class='iconfont icon-heart'></i>";`

### :speech_balloon: Comment System
Due to Ghost itself doesn't have a comment system, we need to use third party solutions for this. Some options are: [DISQUS][disqus], [Gitalk][gitalk], [Valine][valine] and [Vssue][vssue]. By default, Fizzy has Gitalk and DISQUS integrated. Skip the following if you do not need the comment system.

**By default, the comment system is disabled.** To enable it, first insert the following code into `Post Header` for a single post or `Site Header` for the whole site at Ghost Admin -> Code injection to configure accordingly, then choose one of the comment systems below and follow the instruction.

```javascript
<script>
  var show_comment = true; //default: false
</script>
```

#### Gitalk (Recommended)
Gitalk is a Github issue based comment system. Automatically support `en`, `zh_CN`, `zh_TW`, `es` by detecting the language of user's navigator.
1. Register a new **GitHub Application**
2. Create a new **Github Repository** for your website
3. Insert the following code into Ghost Admin -> Code injection: `Site Footer`, and modify the configuration with your **Github App** & **Repository** from previous steps.

```javascript
<script>
  const gitalk = new Gitalk({
    clientID: 'GitHub Application Client ID',
    clientSecret: 'GitHub Application Client Secret',
    repo: 'GitHub repo',
    owner: 'GitHub repo owner',
    admin: ['GitHub repo owner and collaborators, only these guys can initialize github issues'],
    id: location.pathname,      // Ensure uniqueness and length less than 50
    distractionFreeMode: false  // Facebook-like distraction free mode
  });
  gitalk.render('gitalk-container');
</script>
```
> more usage guide and options please check [here](https://github.com/gitalk/gitalk#usage).

#### DISQUS
Insert the following code into Ghost Admin -> Code injection: `Site Header`, and modify the link with yours.
```javascript
<script>
    var disqus_link = 'https://YOURLINK.disqus.com/embed.js'; // change it with your DISQUS js link
</script>
```
If you want to change the comment system, you need to modify the code in `partial/post/post_comment.hbs`.

###  Code Highlight
Prism.js is used for syntax highlighting, the default languages and plugins used by Fizzy theme are:
  - **Languages**: Markup (e.g. HTML), CSS, C-like, JavasScript, Bash, Nginx, Ruby, Git, JSON, Markdown, SQL, Python, R
  - **Plugins**: line-numbers, toolbar, show-language.

To customize this yourself, open [customize Prismjs][custom-prism] and choose the languages you need. Then download the js and css files to overwrite the `prism.js` and `prism.css` files in `assets` folder.

#### Line-numbers
![image](https://user-images.githubusercontent.com/40261916/60731259-0e1c4300-9f3f-11e9-93c8-a83fe5a878e8.png)
The line numbers are hidden by default. To enable it, insert the following code into `Post Header` for a single post or `Site Header` for the whole site:
```js
<script>
  var line_numbers = true; //default: false
</script>
```

### TOC
There are two ways to control the TOC of a post:
1. insert the following code into `Post Header` for a single post or `Site Header` for the whole site;
    ```javascript
    <script>
        var show_toc = true; // enable TOC (default: false)
    </script>
    ```
2. Use custom post template `Post With Toc` to enable TOC.
> **Priority**: `template` > `Post Header` > `Site Header`

> **Notice**: h2 and h3 headings on the page will be displayed by default. If you want to add other headings (e.g. h1 or h4), please edit `selectors` of the file `partials/post/post_toc.hbs`. However, you should not use h1 except for the post title.

### Instant Search
The search function uses Ghost Content API. To enable it (added to top menu), first add a custom integration in Ghost Admin. Then copy the **Content API Key** and **API URL**.
Go to the Code injection, add the following code to the `Site Header`:
```javascript
<script>
  var show_search = true; // default:false
  var search_key = 'PASTE THE CODE YOU COPIED AS Content API Key';
  var search_url = 'PASTE THE CODE YOU COPIED AS API URL'; // it is usually your site url
</script>
```

### LaTeX support
Use `$`(inline) or `$$` to cover commands to render for LaTeX commands. ([examples](https://fizzy.cc/latex/))

### Link Page
Create a link page is nothing different than create a normal page. With the **Bookmark Card** feature since Ghost v2.30, you can easily add links to any page by type `/bookmark` in Ghost editor. ([demo](https://fizzy.cc/links/))

### Components
- **Navigation**: You can modify `partials/navigation.hbs` to customize your dropdown menu, or delete the section if not needed.
- **Badge**: include `class="badge <color>"` to use badge (HTML only).([demo](https://fizzy.cc/fizzy-theme/#badge))
  - Supported colors: uncolored, red, yellow, green, blue, purple
![image](https://user-images.githubusercontent.com/40261916/64512333-bcb27a80-d318-11e9-8b60-1f18468e3a30.png)
    > Note: to use uncolored badge, set as `class="badge"`.
- **Posts per page**: change the number of `"posts_per_page": 8` in `package.json`
- **table**: to unwrap cells, uncomment the `/* white-space: nowrap; */` in `assets/css/main.css` around **line 703**.

### Credit
If you want to disable the top right "Get Fizzy Theme" button, insert the following code into your `Site Header` from `Code Injection`:

```javascript
<script>
  var fizzy_credit = false; // default:true
</script>
```
> Please do not remove the footer text "Using The Fizzy Theme" and the link. Thank you for your support!

## 📝 Changelog

See [CHANGELOG.md](./CHANGELOG.md)

## 🍻 Contributors

See [Contributors][contributors]

## 🔋 Dependencies

- [Bulma][bulma] - CSS Framework
- [Prismjs][prismjs] - A lightweight syntax highlighter
- [JQuery][jquery] - A well-known JavaScript library (for tocify only now)
- [jQuery.tocify.js][tocify] - Table of Content generator (also JQuery-UI)
- [KaTeX][katex] - A faster LaTeX equation rendering library (since v0.3.0)
- [Gitalk][gitalk] - A Github issued based comment system (since v0.3.0)
- [ghost-search][ghost-search] - An instant search library using Ghost Content API (since v1.0.0)
- [iconfont][iconfont] - A free icon solution (since v1.2.3)

## 📍 Roadmap
To know the future planning of this project, please visit our [Roadmap][roadmap].

## 🐛 Bug Report & :dart: Features Request
If you find a bug, thinking about something to be improved or even want new features, please feel free to post an issue.

Alternatively you could contribute to this project.

## 💡 Contributing

1. Fork it (maybe star this too?)
2. Create your feature branch (`git checkout -b feature-fooBar`)
3. Commit your changes (`git commit -m 'Add something'`)
4. Push to the branch to origin (`git push origin feature-fooBar`)
5. Create a new Pull Request to `dev` branch here
6. Wait for code review and modify if necessary

## 🔏 License

This project is licensed under the MIT License.

[bulma]: https://bulma.io/
[prismjs]: https://prismjs.com/
[jquery]: https://jquery.com/
[tocify]: http://gregfranko.com/jquery.tocify.js/
[mathjax]: https://www.mathjax.org/
[katex]: https://katex.org/
[disqus]: https://disqus.com/
[gitalk]: https://github.com/gitalk/gitalk
[valine]: https://github.com/xCss/Valine
[vssue]: https://github.com/meteorlxy/vssue
[custom-prism]: https://prismjs.com/download.html#themes=prism-tomorrow&languages=markup+css+clike+javascript+bash+ruby+git+json+markdown+nginx+sql+python+r&plugins=line-numbers+toolbar+show-language
[ghost-search]: https://github.com/HauntedThemes/ghost-search
[iconfont]:https://www.iconfont.cn
[contributors]: https://github.com/huangyuzhang/Fizzy-Theme/graphs/contributors
[roadmap]: https://github.com/huangyuzhang/Fizzy-Theme/projects/3