Welcome to the Elysian theme documentation! This documentation is designed to provide you with all the necessary information to help you get started with the Elysian theme for your Ghost-powered website. Before diving into the documentation, it is important to have a basic understanding of Ghost and its concepts. If you are new to Ghost, we recommend referring to the official Ghost documentation to familiarize yourself with the platform.
‍
Customization and Code Modifications:

Elysian theme offers extensive customization options to personalize your website's appearance and functionality. Please exercise caution when making custom code changes, as incorrect modifications can potentially break your website's functionality or layout. It is recommended to create backups and test changes in a development environment before applying them to your live site.

Support Limitations:

Please be aware that our support for Elysian theme is primarily focused on theme-specific issues and providing guidance on theme features and settings. We do not provide support for issues arising from custom code modifications or third-party integrations. If you encounter any issues or have questions related to Elysian theme's built-in features and settings, please refer to the documentation or reach out to our support team for assistance. However, for custom code modifications and advanced customization requests, we recommend consulting with a web developer or referring to appropriate coding resources.

By being mindful of these considerations, you can fully leverage the power and flexibility of Elysian theme while ensuring a smooth and successful customization experience.

Upon purchasing the Elysian theme, you will receive a .zip file containing the theme files. Follow the steps below to upload and activate the theme:
‍

1. Log in to your Ghost Admin dashboard, navigate to Design & branding and click on "Customize".
2. In the Design Settings page, click on the "Change theme" button located in the bottom right corner.
3. Click on the "Upload theme" button in the top right corner.
4. Select the Elysian theme .zip file (elysian.zip) either by clicking the "Select file" button or by dragging and dropping the file into the designated area.
5. Once the theme is uploaded, click on the "Activate" button to activate the Elysian theme.

That's it! The Elysian theme is now successfully installed and ready to be customized according to your preferences. Enjoy exploring the theme's features and unleash the full potential of your Ghost-powered website.

To edit the theme files in the Elysian theme, follow these steps:
‍

1. Start by opening the Elysian .zip file and extracting all the files within.
2. Choose the specific file you want to modify and open it using a code editor of your choice, such as Sublime Text, Visual Studio Code, Atom, or any other preferred editor.
3. Make the necessary changes to the file according to your requirements, and remember to save the updated file.
4. Once you have finished editing and saving the file, re-zip all the modified files to create a new .zip archive.
5. Finally, upload the newly created .zip file to your Ghost Admin by following the instructions provided in the "Upload" section.

Please note that when editing theme files, it's important to have a good understanding of HTML, CSS, and Ghost theming concepts. Additionally, always make backups of the original theme files before making any changes, so you can revert back if needed.

The primary navigation is used for links that appear in the navigation bar or menu of your website. To add a link to the primary navigation, follow these steps:
‍

1. Go to the Ghost Admin Panel and navigate to the Navigation Settings.
2. In the Primary navigation section, enter the name of the link in the Label field, and specify its URL in the corresponding field on the right. You can add or remove more links, and rearrange them by dragging them to change their position.

The Elysian theme also supports second-level or inner links within the primary navigation. To create these sub-links, follow these guidelines:
‍

1. Start by adding a Label text that will serve as a grouping for certain links. For example, if you want the label to be named "About," enter the text: "-About".
2. Next, add the links that will be grouped under that label. Use the following format: "-labelname--linkname". For instance, if you want to add a link named "Home" to the "About" group, you would write it as "-About--Home".

In the example images below, you can see how the links are grouped using labels. In this case, the label for the links group is named "Features" (-Features), and it contains sub-links such as Tags (-Features--Tags), Authors (-Features--Authors), and Subscribe (-Features--Subscribe). This allows you to organize your navigation menu and create hierarchical links within the primary navigation.
‍

The secondary navigation is used for links that appear in the footer of your website. To add a link to the secondary navigation, follow these steps:
‍

1. Go to the Ghost Admin Panel and navigate to the Navigation Settings.
2. In the Secondary navigation section, enter the name of the link in the Label field, and specify its URL in the corresponding field on the right. You can add or remove more links, and rearrange them by dragging them to change their position.

The Elysian theme also supports second-level or inner links within the secondary navigation. To create these sub-links, follow these guidelines:
‍

1. Start by adding a Label text that will serve as a grouping for certain links. For example, if you want the label to be named "About," enter the text: "-About".
2. Next, add the links that will be grouped under that label. Use the following format: "-labelname--linkname". For instance, if you want to add a link named "Home" to the "About" group, you would write it as "-About--Home".

In the example images below, you can see how the links are grouped using labels. In this case, the label for the links group is named "Account" (-Account), and it contains sub-links such as Sign in (-Account--Sign in), Sign up (-Account--Sign up), and Subscribe (-Account--Subscribe). This allows you to organize your navigation menu and create hierarchical links within the secondary navigation.
‍

The Elysian theme includes a custom-made page for displaying all of the authors on your website. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the Authors page.
4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page. You can also add a feature image.
5. IMPORTANT: In the page settings, make sure to set the Page URL field to "authors". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
6. Refer to the image below for an example of how the Authors page should be set up.
7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Authors page accessible to your website visitors.
   ‍

The Elysian theme includes a custom-made page for displaying the contact page with a form on your website. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the Contact page.
4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page.
5. IMPORTANT: In the page settings, make sure to set the Page URL field to "contact". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
6. Refer to the image below for an example of how the Contact page should be set up.
7. IMPORTANT: Configure the Formspree service and add the Formspree hash id to the page settings. For additional information refer to "Formspree hash id Section".
8. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Contact page accessible to your website visitors.
   ‍

The Elysian theme includes a custom-made page for displaying the FAQ page with toggle cards. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the FAQ page.
4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page.
5. IMPORTANT: In the page settings, make sure to set the Page URL field to "faq". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
6. Refer to the image below for an example of how the FAQ page should be set up.
7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the FAQ page accessible to your website visitors.
   ‍

The Elysian theme includes a custom-made page for displaying the tags on your website. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the Tags page.
4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page. You can also add a feature image.
5. IMPORTANT: In the page settings, make sure to set the Page URL field to "tags". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
6. Refer to the image below for an example of how the Tags page should be set up.
7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Tags page accessible to your website visitors.
   ‍

The Elysian theme includes a custom-made page for displaying all posts filtered by tags on your website. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the Archive page.
4. IMPORTANT: In the page settings, make sure to set the Page URL field to "archive". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
5. Refer to the image below for an example of how the Archive page should be set up.
6. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Archive page accessible to your website visitors.
   ‍

The Elysian theme includes a custom-made Sign in page. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the Sign in page.
4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page.
5. IMPORTANT: In the page settings, make sure to set the Page URL field to "signin". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
6. Refer to the image below for an example of how the Sign in page should be set up.
7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Sign in page accessible to your website visitors.
   ‍

The Elysian theme includes a custom-made Sign up page. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the Sign up page.
4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page.
5. IMPORTANT: In the page settings, make sure to set the Page URL field to "signup". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
6. Refer to the image below for an example of how the Sign up page should be set up.
7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Sign up page accessible to your website visitors.
   ‍

The Elysian theme includes a custom-made Subscribe page. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the Subscribe page.
4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page.
5. IMPORTANT: In the page settings, make sure to set the Page URL field to "subscribe". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
6. Refer to the image below for an example of how the Subscribe page should be set up.
7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Subscribe page accessible to your website visitors.
   ‍

The Elysian theme includes a custom-made Account page. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the Account page.
4. IMPORTANT: In the page settings, make sure to set the Page URL field to "account ". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
5. Refer to the image below for an example of how the Account page should be set up.
6. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Account page accessible to your website visitors.
   ‍

The Elysian theme includes a custom-made page for displaying the membership tiers (yearly and monthly) on your website. To add this page, follow these steps:
‍

1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
2. Click on the "New page" button in the top right corner.
3. In the page editor, enter a title for your page. This will be displayed as the heading on the Membership page.
4. IMPORTANT: In the page settings, make sure to set the Page URL field to "membership". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
5. Refer to the image below for an example of how the Membership page should be set up.
6. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Membership page accessible to your website visitors.
   ‍

To customize the theme's background color, simply follow these steps:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Select the desired background color on the Background color setting.
4. Click the Save button located in the top-right corner to apply the changes.

To customize the theme's text color, simply follow these steps:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Select the desired text color on the Text color setting.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme provides the flexibility to choose between 11 primary fonts (Inter, Montserrat, Roboto, Roboto Mono, Open Sans, Lato, Poppins, Raleway, Noto Sans, Merriweather, Playfair Display). To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Select the desired font on the Primary font dropdown.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme provides the flexibility to choose between 11 secondary fonts (Inter, Montserrat, Roboto, Roboto Mono, Open Sans, Lato, Poppins, Raleway, Noto Sans, Merriweather, Playfair Display). Secondary font is used for slider numbers and membership prices. To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Select the desired font on the Secondary font dropdown.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme provides the flexibility to choose between custom account pages or default Ghost Portal popups for Sign in, Sign up, Subscribe and Account. To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Check/uncheck the toggle button for Use custom account pages.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme allows you to use beautiful page transition animations. To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Check/uncheck the toggle button for Use page load animations.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme allows you to choose between 3 types of navigation bars (Animated, Sticky or Normal). To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Select the desired font on the Navigation bar type dropdown.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme allows you to scale your logo. To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Select the desired scale factor on the Logo scale dropdown.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme allows you to scale page headings. To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Select the desired scale factor on the Heading one scale dropdown.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme allows you to use custom styled scrollbar. To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Check/uncheck the toggle button for Use custom scrollbar.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme provides the flexibility to choose between 3 types of cursors (Custom and Normal, Custom or Normal). To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Select the desired cursor on the Cursor dropdown.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme provides the flexibility to choose between 4 types of smooth scrolling effects (Intense, Moderate, Slight or None). To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Select the desired scrolling effect on the Smooth scroll dropdown.
4. Click the Save button located in the top-right corner to apply the changes.

To add your Instagram, LinkedIn and Pinterest URLs and display it as a social media icon in the footer section of your website, you can make the following changes:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Please enter your Instagram, LinkedIn, and Pinterest URLs in the designated Social URLs field. To ensure they work correctly, format them as follows: Use the social network's name as one word (e.g., 'instagram,' 'linkedin,' 'pinterest'), followed by a colon (':'), and then your social link. Separate multiple social networks with commas. For example: instagram: https://www.instagram.com, linkedin: https://www.linkedin.com, pinterest: https://www.pinterest.com.
4. Click the Save button located in the top-right corner to apply the changes.

To ensure that the contact form on your Contact page functions correctly and delivers messages to your desired email address, you need to customize the settings by providing additional information. The contact form in Elysian theme utilizes the Formspree service. Follow the steps below to customize the contact form settings:
‍

1. Create an account on Formspree and create a project.
2. Access the Design settings page in your Ghost admin dashboard.
3. Open the Site-wide dropdown under the Site design section.
4. Enter your Formspree hash ID in the designated field, ensuring that you only include the last 6 characters of the hash (e.g., mqkovbaw).
5. Click the Save button located in the top-right corner to apply the changes.

By entering your Formspree hash ID, the contact form will be properly configured to send form submissions to your Formspree account. The Formspree link will be formatted as follows: https://formspree.io/f/<hashid>, where <hashid> represents your unique hash ID.

The Elysian theme offers 3 options for the post header layout: Wide, Narrow and Vertical. You can easily switch between these layouts by following these steps:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Post dropdown under the Site design section.
3. Select the desired header on the Post header type dropdown.
4. Click the Save button located in the top-right corner to apply the changes.

The "Default" layout provides a full-width for the post header, while the "Narrow" layout offers a narrower header design. Select the option that best suits your desired aesthetic and styling for your posts.

Feel free to experiment with all layouts to find the one that complements your content presentation the most.

The Elysian theme allows you to use reading progress bar on post pages. To modify this setting, follow the steps below:
‍

1. Access the Design settings page in your Ghost admin dashboard.
2. Open the Site-wide dropdown under the Site design section.
3. Check/uncheck the toggle button for Use reading progress bar.
4. Click the Save button located in the top-right corner to apply the changes.

The Elysian theme offers a visually appealing featured posts section. You can easily showcase your selected blog posts by marking them as "Featured". Here's how to utilize this section:
‍

1. Open the desired blog post you want to feature.
2. Click on the Post Settings icon (top right corner).
3. Look for the "Feature this post" checkbox and make sure to check it.
4. Repeat the process to populate the featured stories section.

By highlighting specific blog posts as featured, you can draw attention to your most important or captivating content. Take advantage of this dynamic section to engage your audience and showcase your best work.

The Elysian theme provides 5 footer social icons for Facebook, Twitter, LinkedIn, Pinterest and Instagram. To enable these social icons and link them to your respective accounts, follow these steps:
‍
Set up Facebook and Twitter socials:
‍

1. Go to your Ghost admin dashboard and navigate to General Settings.
2. Find the "Social accounts" section.
3. Enter the URLs of your Facebook and Twitter profiles.

Set up Linkedin, Instagram and Pinterest socials:
‍

1. Refer to "Social URLs Section"

By providing the necessary information for each social account, the Elysian theme will display the corresponding social icons in the footer section of your website. This allows visitors to easily connect with you on various social media platforms.

The Elysian theme supports translation, allowing you to translate all static text on your website into different languages. By default, the theme is in English, but you can add your own translations. To do so, follow these steps:
‍

1. Download and unzip/extract the theme files.
2. Locate the "locales" folder and open it.
3. Inside the "locales" folder, you'll find a file named "en.json". Duplicate this file and rename the duplicate to the language you want to translate to. Ensure that you name it using a valid language code. For example, "es.json" for Spanish and "pl.json" for Polish.
4. Open the translated file using a text editor.
5. The file will have a structure like this:
   ‍
   {
        "Back": "Back",
        "Newer Posts": "Newer Posts",
        "Older Posts": "Older Posts"
   }
   
   To change the translation, modify the text on the right-hand side while keeping the left-hand side unchanged. For example, to translate into Spanish (es.json):
   
   {
        "Back": "Volver",
        "Newer Posts": "Artículos Siguientes",
        "Older Posts": "Artículos Anteriores"
   }
6. Translate all the text strings accordingly and save the file.
7. Re-zip all the theme files and upload the updated theme to your Ghost admin panel. Publish the theme.
8. Navigate to General Settings in the admin panel and locate the "Publication language" section. Change the locale name to the language you've translated the theme into. For example, "en" for English, "es" for Spanish, etc.
9. Click on the Save button at the top right corner to apply the changes.

To modify the static text in the Elysian theme, follow these steps:
‍

1. Download and unzip/extract the theme files.
2. Locate the "locales" folder and open it.
3. Inside the "locales" folder, you'll find a file named "en.json". Open this file in a text editor.
4. The file will have a structure like this:
   ‍
   {
        "Back": "Back",
        "Newer Posts": "Newer Posts",
        "Older Posts": "Older Posts"
   }
   
   To change the text, edit the right side of each key-value pair while keeping the left side unchanged. For example:
   
   {
        "Back": "Previous",
        "Newer Posts": "New Stories",
        "Older Posts": "Old Stories"
   }
5. Modify all the desired text strings and save the file.
6. Re-zip all the theme files and upload the updated theme back to your Ghost admin panel. Publish the theme.

By following these steps, you can customize the static text in the Elysian theme to better suit your preferences and provide a personalized experience for your website visitors.

To change the number of posts displayed per pagination page in the Elysian theme, follow these steps:
‍

1. Download and unzip/extract the theme files.
2. Locate the "package.json" file and open it in a text editor.
3. In the "package.json" file, locate the following section of code:
   ‍
   "posts_per_page": 9
   
   Change the number 9 to your desired value. For example, if you want to display 6 posts per page change it to 6:
   
   "posts_per_page": 6
   ‍
   
4. Once you have made the desired changes, save the "package.json" file.
5. Rezip all the modified theme files and upload the updated zip file to your Ghost admin panel.
6. Publish the updated theme to apply the changes to the number of posts per pagination page.

Please be cautious while modifying the theme files and ensure you have a backup in case any issues arise during the process. If you are unsure about making code modifications, it's best to seek assistance from a professional or developer who can help you with the desired changes while ensuring the integrity and stability of your website.