Theme Info

Name: Auden
Description: a Membership & Magazine Ghost Theme
Released: 2020-04-03
Creator: Biron Themes

Requirements

Ghost version: 3.0 or higher
Ghost Content API: v3

Install Theme

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Go to Settings > Design from the admin menu
  • Under the Themes section click Upload a theme
  • Click inside the upload box to select a Auden.zip, or drag-and-drop the Auden.zip into the upload box
  • If you want to activate the theme immediately click Activate Now or Close if you want to do it later

Publication Settings

Some basic settings for your publication:

Language

To set the publication language follow the steps below.

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Go to General from the admin menu
  • Under Publication Language, click Expand and set the language/locale to be used on the site. The default is set to English (en).

Publication Language

  • Click Save settings

Language Code Reference


Icon

To Upload a new icon follow these steps:

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Click General under the settings menu.
  • Under Publication icon, click Upload Image and select your icon
  • Finally click Save settings

To Upload a new logo follow these steps:

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Click General under the settings menu.
  • Under Publication logo, click Upload Image and select your logo
  • Finally click Save settings

Cover

To Upload a new cover image follow these steps:

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Click General under the settings menu.
  • Under Publication cover, click Upload Image and select your cover image
  • Finally click Save settings

To add menu items to your publication, follow the steps below.

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Click Design from the admin menu
  • Under Navigation, enter a label for the menu item in the label field
  • In the URL field, enter the destination for the menu item to link

Ghost Blog Navigation

  • Click Save

As of Ghost v3 there is also a secondary navigation and it can be found in the same path as the normal navigation, under the Secondary Navigation.


Members

Auden completely supports the Ghost Members feature. To activate the feature follow the steps below.

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Click Settings > Labs.
  • Toggle the Enable members switch, under the MEMBERS(BETA) section.

Members Beta

Within the members the following settings are available:

  • Connect to stripe - where you have to configure the connection to your stripe account to be able to accept/process payments.
  • Subscription pricing - you can define the monthly and yearly price for full access to your publication.
  • Allow free member signup - Toggle switch to allow or not free membership signup.
  • Default post access - Define the default post access. Can be: Public, Members only, Paid-members only
  • Email settings - In order to send emails for member signup/signin, you have to provide the Mailgun configuration.

Besides this configuration, you also have to upload the routes.yaml file (you can find it in the root folder of the theme).

To access the overview of members click Members from the admin menu.


Routes

Routing is the system which maps URL patterns to data and templates within Ghost. Routing for members is not added by default, so an upload is needed. Basic configuration with member features enabled:

routes:
  /signup/: members/signup
  /signin/: members/signin
  /account/: members/account

collections:
  /:
    permalink: /{slug}/
    type: index

taxonomies:
  tag: /tag/{slug}/
  author: /author/{slug}/

Integrations

You can access Integrations in the admin section. Integrations can be used to connect built-in or custom functions to Ghost. How to create a custom integration:

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Click Settings > Integrations.
  • Under Custom Integrations, click Add custom integration
  • Provide a name for it
  • Add description
  • Content API Key is generated, which will be needed by the custom function to access Ghost data.

Customization

Different customizations available for the theme. Check out the blog post to see how you can do basic customization from the Ghost Admin.

Content API

As mentioned in the Requirements section, this theme uses the Content API v3, so in order to take advantage of all the theme features make sure the Content API v3 is used, this is set in the theme by default.

You can check this in the theme's package.json file:

{
  "name": "...",
  "description": "...",
  "demo": "...",
  "version": "...",
  "engines": {
    "ghost": ">=3.0.0",
    "ghost-api": "v3"
  },
  ...

Posts Per Page

From Ghost 1.0 the "Posts per page" settings was moved from the Ghost Admin to the theme. You can set it in the package.json of the theme:

"config": {
  "posts_per_page": 10
}

For Auden the default value is 10, you can change it to any suitable value.


Auden uses the Ghost Search Plugin.

In order for the search to work you need to edit the theme-config.hbs file (in the partials folder):

<script>
  ...
  // Basic Config
  const config = {
    ...

    /* Replace it with your domain: ghost_host: 'https://yoursite.domain' */
    ghost_host: 'http://localhost:3368', 

    /* Settings > Integrations > New Custom Integration. Copy Content API Key. Replace ghost_key below. */
    ghost_key: '55a4116f266aa7f13f51a90d72', 

    ...
  }
</script>

You will have to replace the ghost_host and ghost_key values.

ghost_host should be the domain of your blog (ex. 'https://example.com').

ghost_key has to be generated by creating a custom integration in the admin panel.

  • Create a new custom integration and name it Ghost Search
  • Copy the generated Content API key
  • Add this key in theme-config.hbs in the ghost_key section.

Other possible options to add Search to Ghost CMS Themes.


Google Fonts

Auden comes with Google Fonts integrated, using the following fonts:

  • Poppins
  • Open Sans
  • Playfair display

In order to change the fonts you have to change the default.hbs file.

<link rel="preload" href="https://fonts.googleapis.com/css2?family=Poppins:ital,wght@0,400;0,600;0,700;0,800;1,400;1,600;1,700;1,800&display=swap" as="font" onload="this.onload=null;this.rel='stylesheet'">
<link rel="preload" href="https://fonts.googleapis.com/css2?family=Open+Sans:ital,wght@0,400;0,600;1,400;1,600&display=swap" as="font" onload="this.onload=null;this.rel='stylesheet'">
<link rel="preload" href="https://fonts.googleapis.com/css2?family=Playfair+Display:ital@0;1&display=swap" as="font" onload="this.onload=null;this.rel='stylesheet'">

{{!-- No Js --}}
<noscript>
  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Poppins:ital,wght@0,400;0,600;0,700;0,800;1,400;1,600;1,700;1,800&display=swap">
  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Open+Sans:ital,wght@0,400;0,600;1,400;1,600&display=swap">
  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Playfair+Display:ital@0;1&display=swap">
</noscript>   

Go to Google Fonts and choose the font and styles you would like. Then click Embed and copy the link provided and replace the current one in default.hbs.

Then open settings.css file located in assets/css/settings folder. Replace the font setting with your new font:

--font-family-serif: 'Playfair Display', Times, Georgia, serif;
--font-family-sans-serif: 'Poppins', Tahoma, Arial, sans-serif;
--font-family-secondary: 'Open Sans', Tahoma, Arial, sans-serif;

Build the assets (check theme development) and everything sould be ready.

Ceck out this tutorial for a more detailed guide about Google Fonts with Ghost.


Post Templates

Auden comes with 3 different post templates:

  • post.hbs default (with sidebar)
  • custom-no-sidebar.hbs with no sidebar
  • custom-with-table-of-contents with table of contents

When a new post is created, automatically the default post template is assigned. You can change it by going to Post Settings, and under the Template section select the template you would like for the post.

Static Pages

Besides having posts, you can also create pages. For this:

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Go to Manage > Pages.
  • Click New page.
  • Add the page name (which will be the slug/url for the page as well).
  • Add content for the page.
  • Click Publish.

Custom Pages

Auden comes with several custom pages by default:

  • Contact Page
  • Tags Page
  • Authors Page
  • Membership
  • Archive

To add the page to the navigation, please check the Navigation section above.

Contact Page

To create the Contact page, do as follows:

  • Create a new page and call it Contact.
  • Make sure the Page URL is contact.
  • Click Publish.

There is a contact form included, which requires one change, adding the email your email address. Open page-contact.hbs in the root folder of the theme and replace youremail@domain.com with the email address the emails should be delivered to.

  <div class="contact-form m-b-lg">
    <form action="//formspree.io/youremail@domain.com" id="contact-form" class="contact-form clearfix" method="post">
Tags Page

To create the Tags page, do as follows:

  • Create a new page and call it Tags.
  • Make sure the Page URL is tags.
  • Click Publish.
Authors Page

To create the Authors page, do as follows:

  • Create a new page and call it Authors.
  • Make sure the Page URL is authors.
  • Click Publish.
Membership Page

To create the Membership page, do as follows:

  • Create a new page and call it Membership.
  • Make sure the Page URL is membership.
  • Click Publish.
Archive Page

To create the Archive page (this will list all posts), do as follows:

  • Create a new page and call it Archive.
  • Make sure the Page URL is archive.
  • Click Publish.

Translation

Auden supports Ghost i18n and it comes with translations for the following languages:

  • en for English
  • de for German
  • fr for French
  • es for Spanish
  • it for Italian
  • pr for Portuguese

To change the publication language to one of the available languages check out this guide.

Editing the translations

The translation files are stored in the locales folder within the theme folder.

|-- locales
|   |-- de.json
| |__en.json
| |__es.json
| |__fr.json

Open up the file for the language you want to edit. Example en.json:

{
  "load_more_posts": "Load more posts",
  "load_comments": "Load comments",
  "send": "Send",
  ...
}

Each line consist of a key-value pair.

"key": "value"

The key is on the left side and it should not be changed (it's the same in all the files) and right value which you can adapt if necessary.

If you have suggestions to improve the translations or adding a new language, drop us a line.

Adding a new language

To add a new language you have to create a new translation file with the language code of the desired language.

For example if you want to create new translation for Hungarian language you have to create hu.json within the locales folder.

And add the translations for each key value.

For more details check the Official Ghost Documentation.


The social media links are stored in a partial file partials/social-media.hbs.

Ghost supports Facebook and Twitter social accounts, to change them do the following

  • Log in to your publication admin section at yourblog.com/ghost/signin
  • Go to General from the admin menu
  • Click Expand under Social Accounts, and enter the URLs for your Facebook and Twitter.
  • Click Save settings

To edit the other social links follow the steps below. Open up the social-media.hbs file and change the href value to your profile's URL for that specific social platform.

  ...
  {{!-- Instagram --}}
  <a class="social-links__item instagram"
     href="https://instagram.com" target="_blank" title="Instagram" aria-label="Instagram">
    {{>icon name="instagram"}}
  </a>
  ...
</div>

For example to change the Instagram link, you have to change the existing href value:

href="https://instagram.com"

Add your instagram account link, example:

href="https://instagram.com/bironthemes"

Comments

Auden comes with Cove and Disqus.

The 3 post post layouts the theme comes with:

  • post.hbs
  • custom-no-sidebar.hbs
  • custom-with-table-of-contents.hbs

all include the cove_comments.hbs file, you can replace that by disqus_comments.hbs or you can create a new include and add the commenting system you would like to use.

Cove

Cove is a commenting platform built on top of Ghost’s Memberships feature.

For the comments to work, you have to create an account at cove.chat and change the cove_comments.hbs file in the partials folder:

 <script>
  const Cove = {
    publication: "your_cove_chat_publication_id",
    contentId: "{{id}}",
    memberId: "{{@member.uuid}}",
    memberEmail: "{{@member.email}}"
  }
</script>

Replace the value for the publication with the one from your Cove account.

Disqus

Auden comes with Disqus comments as well.

Make sure you have registered your website with Disqus and you know your disqus_shortname.

Open theme-config.hbs file located in partials folder. Change the biron-demo value to match your Disqus account shortname.

<script>
  ...
  // Basic Config
  const config = {
    ...
    /* Replace 'biron-demo' with your disqus account shortname */
    disqus_shortname: 'biron-demo'  
  }
</script>

That's all, Disqus comments should work now.

If you don't want disqus comments to show delete the disqus_comments.hbs file located in the partials folder. And delete the following section from post.hbs, custom-no-sidebar.hbs, custom-with-table-of-contents.hbs files located in the root folder of the theme:

{{!-- Include Comments --}}
{{> disqus_comments}}

Google Analytics

To add Google Analytics to Ghost follow this tutorial from our blog.


Progressive Web App

Progressive Web Apps allow your website to be installed by anyone, anywhere, on any device with a single codebase.

To customize the appearance you have to change the following files.

  • default.hbs
  • manifest.webmanifest

In the default.hbs this is the relevant section for PWA.

{{!-- PWA --}}
<link rel="manifest" href="{{asset "manifest.webmanifest"}}">
<meta name="theme-color" content="#e50b4f">
<link rel="apple-touch-icon" href="/assets/icon-192x192.png">

Change the theme-color content for your primary color and replace the icon-192x192.png with your own icon (it must be 192x192 pixels).

Next open the manifest.webmanifest file:

{
  "name":"Auden Ghost Theme",
  "short_name":"Auden",
  "description":"Auden - a Magazine & Membership Ghost Theme",
  "lang":"en",
  "start_url":"/",
  "background_color":"#ffffff",
  "display":"standalone",
  "theme_color":"#e50b4f",
  "icons":[
     {
        "src":"/assets/icon-48x48.png",
        "sizes":"48x48",
        "type":"image/png"
     },
     {
      "src": "/assets/icon-192x192.png",
      "type": "image/png",
      "sizes": "192x192"
    },
    {
      "src": "/assets/icon-512x512.png",
      "type": "image/png",
      "sizes": "512x512"
    }
  ]
}

Replace all the relevant information like name, short_name and description. Also replace all the icons with your own.

That's it, the rest is taken care of.

Visit our blog post for more information about Progressive Web App for Ghost Themes.


Theme Development

Auden is developer friendly, if you need to make advanced customization you will take advantage of the Gulp tasks that are set up for compiling Javascript and PostCSS.

All the assets are combined and minified for better speed and performance. In order to customize the theme make sure you have Node.js and npm installed.

Tutorial on How to Install Ghost.

Run the following commands in the Auden theme directory:

npm install

This will install all the dependencies for the theme

Then run:

gulp

This will compile PostCSS and javascript and will watch for changes. So when you edit .hbs, .css or .js file the change will trigger the gulp watch task and this will compile the assets with your changes.

If you want to compile css or javascript separately, you can run:

gulp css

For compiling CSS files.

Or:

gulp js

For compiling javascript files.

You also have the option to use Code Injection to do customizations. For example if you want to change the brand color of the theme, add the following code in the Blog Header section.

body {
    --color-brand-1: pink;
}

Credits

Auden uses the following packages/plguins:

Images are not included in the download files!


Support

Don't hesitate to contact us if you have suggestions or need help.

Contact

Change Log

v1.8.4 - 25 Jul 2020
Changes
[*] updated dependencies

Changed files:
[*] assets/css/components/_sections.css
[*] assets/css/elements/_body.css
[*] assets/dist/app.min.css (generated file)
[*] assets/dist/app.min.css.map (generated file)
[*] assets/dist/app.min.js (generated file)
[*] assets/dist/app.min.js.map (generated file)
[*] package.json
v1.8.3 - 02 Jul 2020
[*] fix footer alignment
[*] add filled icon option
[*] fix table of content sticky bug
v1.8.0 - 28 Jun 2020
[*] fix author profile view on mobile
[*] fix full width post image causing small horizontal scroll
[*] fix sidebar story height (when there is no image)
[*] fix sidebar ads for members (not displayed anymore)
[+] added some utility css classes (assets/css/utilities)
v1.7.1 - 22 Jun 2020
[*] fixed small bug which appears only on index.hbs top-tags section when tags have no images
v1.7.0 - 21 Jun 2020
[+] Google fonts to default.hbs for easier customizing
[+] Google fonts preloading for better performance
v1.6.1 - 22 May 2020
[*] improved the function which loads more posts
v1.6.0 - 11 May 2020
[+] added cove comments (comment system for Ghost Members)
[*] optimized the service worker for PWA
v1.5.0 - 08 May 2020
[*] Improved image handling in the theme
v1.4.0 - 04 May 2020
[+] add Progressive Web App Support
[*] performance optimization
[*] updated dependencies
v1.3.0 - 27 Apr 2020
[+] added Archive page
[*] improved dark/light theme handling
v1.2.0 - 19 Apr 2020
[*] fixed post-card dates
[+] added post counter translation support
[*] fixed block quote styling
v1.1.0 - 15 Apr 2020
[+] added sticky property to table of contents on mobile
[+] added a scroll top button 
[+] added more customization options in the theme-config.hbs file
v1.0.0 - 04 Apr 2020
[+] Initial release