Braun Documentation
![Braun Documentation](/content/images/size/w1920/2024/05/Cover-Braun-1.jpg)
Introduction
Since this is a Ghost theme documentation, you are assumed to have a basic knowledge of the Ghost app.
If you're starting with Ghost, it is best to see the guides in the official Ghost Help Center – check this out, and you'll have all the available information.
Getting Started
Welcome
Braun theme concept is built for flexibility and easy customization. It leverages existing Ghost features of tags & pages to help you customize your own Ghost site from the Ghost admin interface.
Looks like you're just getting started. Don't worry, we're here to help you build an amazing website.
To kick things off, here are some helpful guides: 0. Import placeholder content (internal tags, hero, blog)
- Crafting a compelling hero section - Make a lasting first impression with a stunning hero section.
- Launching your Blog page - Share your thoughts, experiences, and expertise with a dedicated blog.
- Showcasing your success stories - Highlight your achievements and inspire others with captivating case studies.
- Curating valuable resources - Provide your visitors with a collection of useful resources.
Install Theme
Upload Zip File
To begin, unzip the downloaded package by double-clicking it on a Mac or by right-clicking and selecting "Extract All" on Windows.
Inside the new Braun folder, you will find the Kyoto.zip theme file and an online documentation file.
Step-by-Step to Upload the Theme to Your Website
- Log in to your Ghost website admin (example.com/ghost).
- Click the settings icon ( ⚙️ ) at the bottom of the left-hand side.
- Go to Design & branding > Customize > Change Theme.
- Click Upload theme and select the Braun.zip theme file.
- Once uploaded, click Activate now to activate the theme.
Upload Routes.yaml
The routes.yaml
is required if you want to show the following pages:
- Works
- Blog
- Diary
- Serie or Timeline
- Books
If you don’t want any page above, you can skip this step.
Step-by-Step to Upload the File:
- Unzip the Braun.zip theme file.
- In your Ghost admin, click the settings icon ( ⚙️ ) at the bottom of the left-hand side.
- Go to Labs and click Open.
- Click the Upload routes YAML button.
- Select and upload the
routes.yaml
file inside the theme folder. - Done
Import Internal Tags (Optional, Nice to Do)
This step is to import all the available tags we will use to create content on the homepage.
After importing tags, you can select them from Ghost admin without worrying about typo mistakes that can cause the theme to not work as expected.
- In your Ghost admin, go to Settings > Advanced > Import/Export.
- Under Export, click Export content. This ensures you have a full backup of your current data. Once done, proceed to the next step.
- Under Import, click Universal import.
- Select and upload the
internal-tags.json
file from the unzipped theme folder. - Now, navigate to the Tags page within your admin panel to view all available tags under Internal tags.
- That's all for the theme installation!
Now let’s move on to creating your homepage.
Build Your Homepage
Homepage Sections
After uploading the theme and uploading the routes.yaml file, the homepage is still empty.
To get started, let’s add the two essential parts of your website: Hero section and blog section.
Let’s watch this short video to learn how to build your homepage.
[TK video]
The homepage is built around tags and pages, so you can update them from the Ghost admin UI with no coding required.
- Homepage content includes different sections, such as hero, blog, static text, testimonials…
- Each section is a page with represented internal tags you can create from Ghost admin. This gives you full flexibility to edit and customize your content.
- The sections' order is displayed in chronological order (oldest first). You can adjust the order by simply changing the "Publish date" in the Page settings.
Here are the available sections of the homepage with their represented tags.
- Hero section
#section-hero
- Blog
#section-blog
- Logos
#section-logos
- Side projects
#section-side-projects
- Case studies
#section-case-studies
- Resource
#section-resource
- Testimonials
#section-testimonials
- Static text
#section-static-text
- Static banner
#section-static-banner
- Work experiences
#section-experiences
- Books
#section-books
Hero Section
The hero section is permanently set to the top section of the homepage.
TK main hero image
Step-by-Step to Add Hero Section
- In Ghost admin, create a new page.
- Add your featured photo, title, and content.
- Open page settings, add
#section-hero
to Tags input. - Publish and open the homepage to check.
The final page content should look like the following:
![](https://themex.studio/content/images/2024/05/9b248dd0348eae0d4c7d957045431513-1.jpg)
Hero Section Styles
Braun supports different styles for hero sections. You can choose your favorite one at Ghost admin > Settings > Design & branding > Homepage > Hero layout.
![](https://themex.studio/content/images/2024/05/5e54188f6e16e2d17650b70b933c12dc.jpg)
![](https://themex.studio/content/images/2024/05/6a0486c16c2c805dfd0afaea8c550dee.jpg)
![](https://themex.studio/content/images/2024/05/37e87680cbcfc5828df281d934637622.jpg)
![](https://themex.studio/content/images/2024/05/f52f017bd6623018d27713e839abd3ff.jpg)
![](https://themex.studio/content/images/2024/05/6cabae7ddba4f9580ebbbcbf176f5552.jpg)
![](https://themex.studio/content/images/2024/05/db17b98f5542a845e95cf32a70407957.jpg)
Adding Background to Hero Section
Make your hero section stand out more with a background color.
You can add it from Ghost admin. The theme is using the accent color from the tag #section-hero
for this.
![](https://themex.studio/content/images/2024/05/abf4ebe111629e6940baa565f3321d94.jpg)
Step-by-Step to Add Background Color to Hero Section
- In Ghost admin, go to Tags.
- Under Internal tag, click
#section-hero
to go to that tag detail. - Select a color from Color input.
- Save and done.
Blog Section
The blog section will contain the latest posts that you published and a shortcut link to go to the /blog page.
![](https://themex.studio/content/images/2024/05/CleanShot-2024-05-25-at-14.23.38.jpg)
Step-by-Step to Add the Blog Section
- In Ghost admin, create a new page.
- Give it a title, any name. This title will be the title shown on the homepage and the blog page.
- From the Page settings, ensure that the Page URL setting is
blog
. - Add
#section-blog
to Tags input. - Publish and open the homepage to check.
The final page content should look like the following:
![](https://themex.studio/content/images/2024/05/e3cc6ec480d4a4e13d1fa39816c52510.jpg)
Different Post Styles
Braun supports different post styles and different featured image aspect ratios.
Card
Expanded
Right thumbnail
Text-only
Minimal
You can set your favorite style at Ghost admin > Settings > Design & branding > Homepage > Blog article layout and Blog image orientation for the post image ratio (Landscape, Square, Portrait).
The post style will be applied across the site, including the homepage, blog, and related post under the post detail page.
![](https://themex.studio/content/images/2024/05/f56ba7b6409c9ae4ad6fbef6f34437c5.jpg)
To create the Blog page, head to create a blog page.
Logos Section
Sometimes you want to show some kind of social proof, and a logo board can help achieve that.
![](https://themex.studio/content/images/2024/05/2fdd46b6b6b3071f9d1ac353aab12b3b.jpg)
Step-by-Step to Add Logo Board
- In the Ghost admin page, go to Pages > click on New page.
- Enter the title of the page. This title will be the section title on the homepage.
- Upload all logos you want to show on the homepage. Note: Don’t add any break lines above, between, or after the Images. It will create some odd alignment.
- In the Page Setting sidebar, add a tag named:
#section-logos
. - Publish and check your homepage.
The final page content should look like the following:
![](https://themex.studio/content/images/2024/05/bc3c3defae860bb9dc131e3ffb3186a4.jpg)
#no-title
tag.Side Projects Section
You can add a side project section (or a section to show any link).
![](https://themex.studio/content/images/2024/05/6435662d57f235e88d2fdae8a4070528.jpg)
Step-by-Step to Add Side Project Section on Homepage
- In Ghost admin, create a new page.
- Give it a title, any name. This title will be the title shown on the homepage and the blog page.
- Add
#section-side-projects
to Tags input. - Publish.
The final page content should look like the following:
![](https://themex.studio/content/images/2024/05/fa15f7aef6fc2e159274c4ee7b8f8da6.jpg)
Now the side project section is visible on the homepage. Next, to add content for that section
Step-by-Step to Add Side Project Content
- In the Ghost admin page, go to Pages > click on New page.
- Enter information for this project. Page title as the title, Excerpt as the project description, X description as project subtitle. Featured photo is optional.
- Tag the page as
#content-personal-project
. - (Optional) If you want to lead visitors to an external site, add the URL at Metadata > Canonical URL. By default, the link will lead to the Page detail.
- Publish.
- Repeat the same steps to create different content blocks for the side projects section.
![](https://themex.studio/content/images/2024/05/8e2dcb2192704b564802152fa581eb47.jpg)
The final page content should look like the following:
![](https://themex.studio/content/images/2024/05/bcab0596a4d7c58ca71cc11ff2c1bacc.jpg)
#no-link
to the Tags input.Case Studies Section
You can add a case study section to showcase your important projects or achievements. The case studies section is the most prominent section of the homepage.
![](https://themex.studio/content/images/2024/05/f37ccb0f983656762b24452e9d1847ab.jpg)
Step-by-Step to Add Case Studies Section on Homepage
- In Ghost admin, create a new page.
- Give it a title, any name. This title will be the title shown on the homepage and the blog page.
- On the Page settings, ensure that the Page URL setting is
works
(This is for the purpose of creating a separate page for works. If you don’t need a separate page, you can use any URL). - Add
#section-case-studies
to Tags input. - Publish.
The final page content should look like the following:
![](https://themex.studio/content/images/2024/05/db111117b9a600391591a8a04579fa4d.jpg)
Now the case study section is visible on the homepage. Next, to add content for that section.
Add Case Studies
Step-by-Step to Add a Case Study
- In the Ghost admin page, go to Pages > click on New page.
- Enter information for this project. Page title as the title, Excerpt as the project description, X description as project subtitle, and featured image.
- Tag the page as
#content-case-study
. - (Optional) If you want to lead visitors to an external site, add the URL at Metadata > Canonical URL. By default, the link will lead to the Page detail.
- Publish.
- Repeat the same steps to create different content blocks for the case studies section.
![](https://themex.studio/content/images/2024/05/67b24211977517e73eb7bad14d6b7909.jpg)
The final page content should look like the following:
![](https://themex.studio/content/images/2024/05/35eea691d6ae66d3a1a3431c29c65fb7.jpg)
#no-link
to the Tags input.Change Case Study Layout
For the case study card, the theme provides two options:
- Grid: two cards side by side.
- Full row: one card in a row.
- Go to Ghost admin > Settings > Design & branding > Homepage > Hero layout.
- At Case study card style, select your choice.
- Save.
![](https://themex.studio/content/images/2024/05/2c2fe8a44ce70da901ca702c10e63fe6.jpg)
Resources Sections
When you have some resources you want to show, such as helpful tools, newsletters, or bookmark links, resource sections are ideal for that. You can add as many resource sections as you want. Each section follows the same creation flow.
![](https://themex.studio/content/images/2024/05/151fea1d495c7b0e798e4a4bf7154fd5.jpg)
First, let’s start by adding some resource content to the Ghost CMS.
Step-by-Step to Add Resource Content
- In the Ghost admin page, go to Pages > click on New page.
- Enter the information for this resource:
- Page title as the title
- Excerpt as the project description
- X description as the project subtitle
- Featured photo (optional)
- Tag the page with any name you like, but it’s recommended to use internal tags that start with
#
(e.g.,#podcast
,#bookmark
). We will use the tag name later. - (Optional) If you want to direct visitors to an external site, add the URL at Metadata > Canonical URL. By default, the link will lead to the Page detail.
- Publish.
- Repeat these steps to create different content blocks for the side projects section.
![](https://themex.studio/content/images/2024/05/37fe07f7ecc4e0391f65bd0d0bb3cc08.jpg)
Resource card anatomy
Step-by-Step to Add Resource Section on Homepage
- In Ghost admin, create a new Page.
- Give it a title; this title will be shown on the homepage and the blog page.
- In Page settings, add
#section-resource
to the Tags input. - In Template dropdown, choose Page Resource
- Click on X Card and add the tag slug of the resource content you created in the previous step in the X description input. In this example, we’re using
tools
. - Publish and preview it on your homepage.
The final page content should look like this:
![](https://themex.studio/content/images/2024/05/6893818c99d6d4958b5754b9cfe141f1.jpg)
[!note] To find the exact tag slug, go to Tags in the Ghost admin home, click on the tag name, then copy the text in the Slug field.
![](https://themex.studio/content/images/2024/05/c78917594c1d38ec7211ac66fb7112df.jpg)
Repeat these two steps to create different resource sections on the homepage. You can have as many resource sections as you want.
Some notes:
- If you want to hide the link section, add
#no-link
to the Tags input. - To create separate pages for each resource, refer to [TK resource page link].
Testimonials Section
To add a testimonials section, create a new page, give it a title, then add an internal tag #section-testimonials
in the page settings.
![](https://themex.studio/content/images/2024/05/2e9e98440c59c3701c84cf7a03f4baca.jpg)
Step-by-Step to Add Testimonial Section
- In the Ghost admin page, go to Pages > click on New page.
- Enter the title of the page. This title will be the section title on the Homepage.
- In the page content, add a new Product card. You can find this card by clicking on the + icon on the left side of the editor or by typing
/product
in the editor, then select the Product option. - On the product card, fill in the details:
- Title is the testimonial main text.
- Description shows a person's name and job title.
- Image as a profile picture.
- Stars as a rating.
- Add more Product cards to add more testimonials.
- In the Page Setting sidebar, add a tag named
#section-testimonials
. - Publish and check your homepage.
The final page content should look like this:
![](https://themex.studio/content/images/2024/05/b687b822384ad42a55303ffa0031dafe.jpg)
Static Text Section
The static text section is useful for adding custom text on the homepage, such as your services, working principles, or values.
To add a static text section, create a new page, give it a title, then add an internal tag #section-static-text
in the page settings.
![](https://themex.studio/content/images/2024/05/79fd80f3b48094814d97001abe7a4c0e.jpg)
Step-by-Step to Add Static Text Section
- In the Ghost admin page, go to Pages > click on New page.
- Enter the title of the page. This title will be the section title on the Homepage.
- In the page content, add a new Product card. You can find this card by clicking on the + icon on the left side of the editor or by typing
/product
in the editor, then select the Product option. - On the product card, fill in the title, description, image, and link (optional).
- Add more Product cards to add more static text cards.
- In the Page Setting sidebar, add a tag named
#section-static-text
. - Publish and check your homepage.
#no-title
tag.The final page content should look like this:
![](https://themex.studio/content/images/2024/05/d451f2c7001bd3d82a4959746dd844a6.jpg)
If you want to create separate sections using Static text, create a new page and repeat the same steps above.
Static Banner Section
If you prefer to show static images instead of text, you can use the static banner section.
You can repeat the same steps as creating the static text section but use the internal tag #section-static-banner
.
![](https://themex.studio/content/images/2024/05/CleanShot-2024-05-25-at-14.18.32.jpg)
Step-by-Step to Add Static Banner Section
- In the Ghost admin page, go to Pages > click on New page.
- Enter the title of the page. This title will be the section title on the Homepage.
- In the page content, add a new Product card. You can find this card by clicking on the + icon on the left side of the editor or by typing
/product
in the editor, then select the Product option. - On the product card, upload the image and link (if any). Title and description are optional.
- Add more Product cards to add more banners.
- In the Page Setting sidebar, add a tag named
#section-static-banner
. - Publish and check your homepage.
#no-title
tag.The final page content should look like this:
![](https://themex.studio/content/images/2024/05/30c758881f18398c5d88899ad218fea1.jpg)
Work Experiences Section
This section is to showcase your work history.
Step-by-Step to Add Work Experiences Section
- In Ghost admin, create a new Page.
- Give it a title; this title will be shown on the homepage and the blog page.
- Add
#section-experiences
to the Tags input. - Publish.
The final page content should look like this:
![](https://themex.studio/content/images/2024/05/662b9f8167661711a113332a408ecdd9.jpg)
Now the Work experiences section is visible on the homepage. Next, add content for that section.
Step-by-Step to Add Work Experience Content
- In the Ghost admin page, go to Pages > click on New page.
- Enter the information for this project. Refer to the screenshot below.
- Tag the page as
#content-experience
. - Click Publish.
![](https://themex.studio/content/images/2024/05/976f8219a76028e0dc0318aa9b9abf9d.jpg)
![](https://themex.studio/content/images/2024/05/2cff70d8cca2539c22587058475397e3.jpg)
Other Customizations
Section Colors
You can add custom background colors for each section on the homepage by adding an Accent color for the respective internal tags.
![](https://themex.studio/content/images/2024/05/5f9aab62a9d15e469402d2ae43b827eb.jpg)
Hide Section Title
If you want to hide the section title, add #no-title
to the Tags input.
Hide Section Link
If you want to hide the link section, add #no-link
to the Tags input.
Other pages
Blog page
A blog page displays all your posts in Ghost.
routes.yaml
file.If you've already [created a blog section on the homepage](TK Link), you can skip this step to create a blog page.
Step-by-Step to create the blog page:
- In the Ghost admin page, go to Pages > click on New page.
- Add a title (e.g., 'Blog').
- Add a description or feature image for this page (optional).
- Click the icon in the top right corner to open the Page settings.
- Ensure the Page URL is
blog
. - Click Publish.
Now you have a blog page with the URL yourblog.com/blog
.
Blog category header
By default, the blog category header shows the top 5 tags sorted by the number of posts for each tag. You can also define which tags you want to display in the header.
Step-by-Step to add custom items on the category header
- From Ghost admin, go to Settings > Design & Branding > Homepage.
- In Blog category navigation, enter the slugs for each tag, separated by commas without any whitespace (e.g.,
design,code,mindset
). - Click Save.
The final page content should look like this:
![](https://themex.studio/content/images/2024/05/4ef2264f5f6d8631f4689096ee0ceaab.jpg)
Add featured items to the category header
You can create a separate page to showcase all featured posts and add it to the category header.
routes.yaml
file.Step-by-Step to add a featured page to the category header:
- In the Ghost admin page, go to Pages > click on New page.
- Add a title (e.g., 'Featured Posts').
- Add a description or feature image for this page (optional).
- Click the icon in the top right corner to open the Page settings.
- Ensure the Page URL is
featured-posts
. - Click Publish.
Post styles
The theme supports different styles for the post feed. Please check [TK Different post styles for blog section].
Work or Case Study page
This page serves as your portfolio, showcasing your work experiences, side projects, testimonials, and case studies.
routes.yaml
file.If you've already created a [case studies section](TK Link), you can skip this step to create the work page.
Step-by-Step to create the work page:
- In the Ghost admin page, go to Pages > click on New page.
- Add a title (e.g., 'Works').
- Add a description for this page (optional).
- Click the icon in the top right corner to open the Page settings.
- Ensure the Page URL is
works
. - Click Publish.
Now you have a work page with the URL yourblog.com/works
.
All the block content of this page is the same as the options on the homepage. Refer to the homepage customization to adjust content for this page.
Books page
A page to showcase the books you're currently reading and your library.
routes.yaml
file.Step-by-Step to create the books page:
- In the Ghost admin page, go to Pages > click on New page.
- Add a title (e.g., 'Books').
- Add a description and featured image for this page (optional).
- Click the icon in the top right corner to open the Page settings.
- Ensure the Page URL is
books
. - Click Publish.
Now you have a books page with the URL yourblog.com/books
.
Add content for the books page:
- Create a new post and write your content.
- Tag it as
books
. - Click Publish.
Book card anatomy:
![](https://themex.studio/content/images/2024/05/e4dc9f1d9f674bea78c677f972f3512e.jpg)
Add current reading section:
- Open the post for the book you're reading.
- In the post settings, add the tag
#book-reading
. - Click Update.
Series page
This custom page is designed for a linear reading experience, suitable for showcasing milestones or a long series.
Create a timeline page with the series template
You can use this template to create multiple pages. Update the routes.yaml
file to configure the URL and tag data.
routes.yaml
file.Step-by-Step to create the timeline page:
- In the Ghost admin page, go to Pages > click on New page.
- Add a title (e.g., 'Timeline').
- Add a description and featured image for this page (optional).
- Click the icon in the top right corner to open the Page settings.
- Ensure the Page URL is
timeline
. - Click Publish.
Add content for the timeline page:
- Create a new post and write your content.
- Tag it as
#timeline
. - Click Publish.
This will display all the posts tagged as #timeline
and sort them by creation time, from latest to oldest.
Series default vs. Series full
The theme provides two series options: Default and Full. The default template shows the entire post content, while the Series Full template only displays the title, excerpt, and featured photos. Choose the one that best suits your needs.
Update routes.yaml
file
Hide "On this page" or Table of Contents section
If you don't want the Table of Contents on this page, you can hide it by tagging the page as #u-hide-overview
.
Step-by-Step:
- In the Ghost admin page, go to Pages and find the timeline page you want to hide the Table of Contents on.
- In the page settings, add the tag
#u-hide-overview
. - Click Update.
![](https://themex.studio/content/images/2024/05/8fdad70a26c8a22b74a402ce61f7aad0.jpg)
Posts
The theme provides different post templates:
- Default
- Narrow featured image
- Full featured image
- No featured image
To choose which template to use when you publish a post:
- In the post editor page, click the icon in the top right corner to open the Post settings.
- Find the Template selector and choose the style you want for your post.
Post page options
The theme supports other customizations:
- Hide/Show author
- Hide/Show social sharing buttons
- Hide/Show subscription box in the post page
Customize visual for case study page
You might want to create a special visual for some pages, like the hero header of your case study page. You can do this with Kyoto and Ghost.
![](https://themex.studio/content/images/2024/05/ed9e9ccc50e58e5ebba8bf0b05f395a4.jpg)
Step-by-Step to create the special header for pages:
- In the Ghost admin page, go to Pages > click on New page.
- Add your page's content: title, content, excerpt, featured image, etc.
- At the top of the content area, add a Header card by clicking the plus icon or typing
/
and choosing Header from the list. - Add a custom title and upload a photo.
- If you want to show the full photo (without cropping on different screen sizes), hover over the photo area and click the collapse arrow icon. You can also choose a custom background color for this section.
- In Page settings, turn off
Show title and feature image
. - Click Publish.
Here's a quick guide:
Contact page
To provide a way for your readers to contact you, create a contact page using Formspree.
Step-by-Step:
- Create a new page and give it a title (e.g., 'Contact').
- Add a feature photo (optional) and choose a layout from the Template option.
- Choose any template; a special template named "Page" is available under the template option. You can choose any other template as well.
- Add your content and the contact form code using Formspree. See the code example below.
- Click Publish.
- To add the page to the navigation, refer to the Navigation section.
<form id="fs-from" name="simple-contact-form" accept-charset="utf-8" action="https://formspree.io/f/{your_form_id}" method="post">
<fieldset id="fs-from-inputs">
<label for="full-name">Your name</label>
<input type="text" name="name" id="full-name" placeholder="e.g. John" required>
<label for="email-address">Email address</label>
<input type="email" name="_replyto" id="email-address" placeholder="[email protected]" required>
<label for="message">Message</label>
<textarea rows="9" name="message" id="message" placeholder="Your message…" required></textarea>
<input type="hidden" name="_subject"
id="email-subject" value="Contact Form Submission">
</fieldset>
<input type="submit" class="button button-primary" value="Send">
</form>
Dark page
Besides supporting a light/dark theme for the entire website, this theme allows setting specific pages to dark mode.
For instance, if your default theme is light, but you want certain pages (e.g., Gallery page) to be dark, you can achieve this.
Step-by-Step:
- In the Ghost admin, go to any page or post you want to set to dark mode.
- Open the Page/Post settings panel.
- In the Tags input, add the tag
#dark
. - Click Update.
Custom settings
Colors
The theme supports changing the Accent color and offers 8 different color combinations.
Set Accent Color
The Accent color is the primary color used throughout your publication theme in buttons, social sharing hovers, etc. You can change the theme Accent color from the Ghost admin.
Change the Accent color from the admin Settings > Design & Branding > Customize > Brand > Accent color.
Preset Color Combinations
The theme provides 8 different color combinations. Choose the one that fits your style:
- Default
- Onyx
- Rust
- Fossil
- Mint
- Ember
- Ice
- Maelstrom
Step-by-Step to choose your preferred color combination:
- Change the Accent color from the admin Settings > Design & Branding > Customize > Site Wide.
- Click on Color combinations and select your color combination.
- Preview and Save.
Light and Dark Mode
The theme will change the color palette based on your preferred color combination. You can choose your theme as light or dark. The theme doesn't support light/dark theme switching to keep it simple and usable.
Typography
Depending on the selected option, this setting will change the heading and body text fonts.
Default Font-Pairing
Vancouver has two variants of font-pairing:
- Modern sans-serif (Default): The theme uses system fonts which adapt based on the OS.
- Elegant serif: The theme uses
Cardo
as the default font for an elegant style.
Step-by-Step to customize:
- Go to Settings > Design & Branding > Customize > Site Wide.
- Choose a font for titles/headings by clicking on Title font.
- Choose a font for the body by clicking on Body font.
- Click Save.
Change to Any Fonts
You can change any font from the Ghost admin interface using Code Injection and Google Fonts. For example, if you want to use "Inter" and "EB Garamond" fonts from Google Fonts, your code in Code Injection will be:
<link href="https://fonts.googleapis.com/css2?family=EB+Garamond:wght@500&family=Inter:wght@400;700&display=swap" rel="stylesheet">
<style>
:root {
--font-base: 'Inter', sans-serif;
--font-serif: 'EB Garamond', serif;
}
</style>
You can also use your custom local font by including it in your theme with a code editor. This technique is more advanced but allows you to add 'your own' fonts.
Header
Step-by-Step to add an item to header navigation:
- Go to Settings > Navigation > Primary Navigation.
- Type the page's name in the label field as you'd like it to appear on your menu.
- Click on the item's URL. The blog URL will already be auto-populated.
- When satisfied with your page configurations, click the Save button.
Group Header
To group footer items into different groups, add #
before group header names.
![](https://themex.studio/content/images/2024/05/100b79d0ef0f62181342402c9b61eeb6.jpg)
Footer
The theme don’t use footer component.
Table of content
![](https://themex.studio/content/images/2024/05/2d804f4a5f30304b7c30cc97a041b1e2.png)
You can add a table of contents (TOC) to any post. Add this HTML code to your post.
<aside class="toc-container">
<div class="toc-sidebar">
<h4>On this page</h4>
<div class="toc"></div>
</div>
</aside>
Step-by-Step
- Create a new post and write your post
- Insert the code above. You might want to change the TOC's header text. Maybe you call it
Table of Contents.
- Publish and review it
Right under the title, add an HTML card
![](https://themex.studio/content/images/2024/05/f98ef12cc463d7ce503ee02dfd6a9ba4.png)
Note: If you don’t want a title (e.g., On this page), remove it from the HTML code you see above.
Posts per page
By default, the homepage, author's, and tag's page display a maximum of 20 posts per page, but you can change this number.
Step-by-Step
- You'll need to open the theme's
package.json
file in your code editor and find the following:
"config": {
...
"posts_per_page": 20
...
}
- Change the value of the
20
to the expected value. - Save your
package.json
file in root folder.
Google Analytics
To integrate Google Analytics, I recommend using the Google Analytics integration by Ghost.
Syntax Highlighting
You can add a fenced code block by placing triple backticks ```
before and after the code block. For example:
pre {
background-color: #f4f4f4;
max-width: 100%;
overflow: auto;
}
This will produce the following gray look:
To highlight a code block, add a language alias like css
or js
to the code block. For example, the CSS code in the previous example will wrap between "
css and
``` ` as follows:
pre {
background-color: #f4f4f4;
max-width: 100%;
overflow: auto;
}
This will produce the following colored look:
![](https://themex.studio/content/images/2024/05/0665429dfca721517b100fb569642772.png)
To add inline code, wrap the text between two backticks "
."
Prism
The theme ships with [Prism.js]](https://prismjs.com/), a lightweight, robust, and elegant syntax highlighter.
The [initial Prism package]](https://prismjs.com/download.html#themes=prism&languages=markup+css+clike+javascript) includes some languages, like Markup, CSS, C-like, and JavaScript.
You can add support for more languages by adding the Prism autoloader
script, which will automatically load the languages you need. Add the following script to the website admin **Code Injection (Site Footer)**to do this.
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.28.0/plugins/autoloader/prism-autoloader.min.js" integrity="sha512-fTl/qcO1VgvKtOMApX2PdZzkziyr2stM65GYPLGuYMnuMm1z2JLJG6XVU7C/mR+E7xBUqCivykuhlzfqxXBXbg==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
Click Save.
Responsive tables
The responsive table will display a horizontal scroll bar if the screen is too small to display the full content. The following description applies to the table added using the markdown card.
By default, the table adapts to the window width. If you have a table that is too wide, it will display a horizontal scroll bar when needed.
Step-by-Step
- To add a responsive table, use the Markdown card.
- Add the markdown to create a table. To generate a table, you can use the tool [Markdown Tables Generator]](https://www.tablesgenerator.com/markdown_tables). Below is an example
| # | Heading | Heading | Heading | Heading | Heading |
|:--|:--------|:--------|:--------|:--------|:--------|
| 1 | Cell | Cell | Cell | Cell | Cell |
| 2 | Cell | Cell | Cell | Cell | Cell |
| 3 | Cell | Cell | Cell | Cell | Cell |
Subscription form
Subscription is placed at the bottom of the post page and on the homepage next to the Latest post area.
Change subscription form text
You can change the subscription box's title from the Ghost Admin.
Two subscription boxes use the same copy. When you change the text, it will change in both places.
Step-to-Step
- Go to Settings > Designs & branding > Homepage in Ghost Admin
- Change the copy in Email signup text input.
- Finally, click Save.
Inline subscription box
You can add an inline subscription box in any place in your post with this code.
Step-to-Step
- Create any post as usual
- At the line you want to add the form, click + icon or type
/
, and select the HTML option - Paste the code below. (Note: the form comes with a spinner animation, so it's a bit complicated.)
- Preview and publish the post
<form class="form-wrapper cover-form inline-form" data-members-form="">
<input class="auth-email" type="email" data-members-email="" placeholder="Enter your email" required="true" autocomplete="false">
<button class="button button-primary" type="submit" aria-label="Subscribe">
<span class="default">Subscribe</span>
<span class="loader"><svg class="icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 40 40">
<path opacity="0.3" fill="currentColor" d="M20.201,5.169c-8.254,0-14.946,6.692-14.946,14.946c0,8.255,6.692,14.946,14.946,14.946 s14.946-6.691,14.946-14.946C35.146,11.861,28.455,5.169,20.201,5.169z M20.201,31.749c-6.425,0-11.634-5.208-11.634-11.634 c0-6.425,5.209-11.634,11.634-11.634c6.425,0,11.633,5.209,11.633,11.634C31.834,26.541,26.626,31.749,20.201,31.749z"></path>
<path fill="currentColor" d="M26.013,10.047l1.654-2.866c-2.198-1.272-4.743-2.012-7.466-2.012h0v3.312h0 C22.32,8.481,24.301,9.057,26.013,10.047z">
<animateTransform attributeType="xml" attributeName="transform" type="rotate" from="0 20 20" to="360 20 20" dur="0.5s" repeatCount="indefinite"></animateTransform>
</path>
</svg></span>
<span class="success">Email sent. Check your inbox!</span>
</button>
</form>
Comment / Member discussion
The theme comes with Ghost Native Comments integration. You can turn the comments on from your Ghost admin Settings > Membership > Access > Edit > Commenting.
Languages
The theme is fully translatable by enabling a publication language in the settings of the Ghost Admin. Before that, you must prepare your language file.
![](https://themex.studio/content/images/2024/05/7bd170a34c2f2eff6fd2c24851917170.png)
Step-by-Step
- Inside the
../locales/
folder, add target language files for each translatable language used on your site. For example,fr.json
is for French, andpl.json
is for Polish. [A valid language]](https://www.w3schools.com/tags/ref_language_codes.asp) code must be used. - Translate the sentences used in the theme inside your new language files, for example, in
en.json
:
{
"Subscribe": "Subscribe",
"Sign in ": "Sign in",
"Account": "Account",
...
}
- And edited to translate into Spanish for
fr.json
:
{
"Subscribe": "S'abonner",
"Sign in ": "Se connecter",
"Account": "Compte",
...
}
- Upload a theme with a new language file.
- Go to the General settings in the Ghost Admin.
- At the top of the page, you'll see the Publication info section
- Enter the correct language code into your Publication language settings menu.
- Finally, click Save to activate.
[!info] Reactivate the translation file If you edited the active language, you must restart Ghost to make the changes effective. Alternatively, enter another language code and click Save to activate, then switch back to your code.
Advanced setting
Editing a theme's code
You will encounter information about editing theme files in many places in this documentation.
To edit files, you will need to unzip the theme archive – at this point, you will have access to the necessary files indicated in the theme documentation.
Edit HTML
Step-by-Step
- To edit your theme files, download a copy of the theme. For this purpose, go to the Design settings in the Ghost Admin and click Change theme in the bottom left corner.
- Use the Advanced dropdown menu in the upper right corner to download your theme, then unzip the theme locally.
- Once the theme is unzipped, the files can be edited using a code editor – make the changes indicated in the theme documentation.
You can edit files using applications (code editor) such as Sublime Text, Visual Studio Code or Brackets. Using native text editors like TextEdit on macOS may add formatting that may cause the theme to work incorrectly.
- After changing the theme code, re-zip the theme directory to upload it back to Ghost.
To create a zip archive on a macOS, right-click on the theme folder to view the context menu. Then, click the Compress option. On Windows, right-click on the theme folder, select Send to, and then select Compressed (zipped) folder.
- To upload a theme, go to the Design settings in the Ghost Admin and click Change theme in the bottom left corner.
- Click the Upload theme button in the upper right corner.
- Once uploaded, click Activate to activate the theme on your site.
Edit CSS
If you need to change the CSS right in the theme file, check this guide: How to apply CSS changes in your Ghost theme
If you're only looking to make minor updates to a theme, code injection may be enough.
Code Injection
Another choice for customization is to use the Ghost Code Injection settings in Ghost admin.
For a CSS example, you can use the code in the Site Header section to change the logo color and font size.
<style>
.c-logo__link {
color: #4550E5;
font-size: 32px;
}
</style>
Check out How to use Code Injection Ghost guide for more information.
Theme deploy with GitHub actions
The theme comes integrated with the Deploy Ghost Theme Github action. The purpose of the GitHub action is to take the theme from the GitHub repo and send it to your website.
![](https://themex.studio/content/images/2024/05/99aa4ce7e2ea3c57aa7f8819498fd4b6.png)
Follow this guide to add GitHub actions Streamline the deployment of your Ghost theme using GitHub Action.
Loading custom font
I assume you have the font files and the initial @font-face
CSS code for loading the font. Something similar to the following code.
@font-face {
font-family: 'Atyp';
src: local('Atyp Text Regular'), local('Atyp-Text-Regular'),
url('AtypText-Regular.woff2') format('woff2'),
url('AtypText-Regular.woff') format('woff'),
url('AtypText-Regular.ttf') format('truetype');
font-weight: 400;
font-style: normal;
}
Step-to-Step
- Create a new folder in the theme under
/assets
and name itfonts
, for example, then copy your font files there. - Once you finish, zip the theme files, and upload the final zip file to your Ghost website.
- In Ghost admin Code Injection, add your
@font-face
code with the new font files path wrapped in the<style>
element.
<style>
@font-face {
font-family: 'Atyp';
src: local('/assets/fonts/Atyp Text Regular'), local('Atyp-Text-Regular'),
url('/assets/fonts/AtypText-Regular.woff2') format('woff2'),
url('/assets/fonts/AtypText-Regular.woff') format('woff'),
url('/assets/fonts/AtypText-Regular.ttf') format('truetype');
font-weight: 400;
font-style: normal;
}
</style>
This should load the fonts. Then, you can use the font and do your styling for the body.
Become a subscriber receive the latest updates in your inbox.