Namro Documentation

Getting Started

Thank you for purchasing this theme. Feedback and suggestions are always welcomed. If you have any questions that are beyond the scope of this help file, please feel free to email via our user page contact form here. If you're happy with the theme please take a moment to rate on the ThemeForest website.

Theme Installation

NOTE: This assumes you have Ghost installed. For help installing Ghost check out https://docs.ghost.org/install/local

Upload through admin

Login into admin section of your ghost blog
Click on Design under settings in the left hand column and scroll to the very bottom
Click upload a theme
Click on the area shown and locate the zip file for namro theme
Once it is uploaded, click on either Activate to activate the theme immediately.

Upload manually

Unzip the mainfile .zip
Upload the namro folder into Ghost theme directory ghost/content/themes/
Restart your Ghost blog
In a web browser, navigate to your ghost website's settings:http://your_url.com/ghost/settings/design/
Scroll down to the bottom to see a full list of all your themes
Click on Active next to the theme you want to activate and it will be activated!

Theme Customization

Add your custom styles to assets/css/custom.css to make future theme updates easy without overwriting your own code.

Theme Translation

Namro translation file is only available in english only, to add new language duplicate this file namro/locales/en.json and rename with your own language/lacale tag (e.g.: es for Spanish, fr for French, zh for Chinese, ja for Japanese). Please ensure you are using ISO 639-1 Language Codes.

Edit the renamed translation file with any plain text editor. Usually they manage the international UTF-8 encoding well.

An example with optional features (see the related section below) such as placeholders for flexibility, is the complete default English file en.json for Namro.


{
    ...

    "with the email address": "with the email address",
    "By <a href='{href}'>{name}</a>": "By <a href='{href}'>{name}</a>",

    ...
}

As you can see, it's usually just plain English on the left, and put the language you choose on the right. Any code is optional and not required.

Enable Blog language

Simply verify that the .json translation file for your active theme is in place, and then activate the language:

Ghost's Settings > General > Publication language

Just enter the language/locale tag of the files and click on the Save settings button.

Search

For the search to work, please make sure to create a new Content API Key. The theme uses ghostHunter. Search is done for the post title and the content.

Create New Content API

In order for the Search to work, we need to generate a new Content API Key using the following steps.

From Ghost admin, click Settings > Integrations from the sidebar menu
then click + add custom integration
Give the new integration a name, for example, Search and click Create.
Now, a new Key is created, copy the Content API Key to the clipboard.
Next, click Code injection from the sidebar menu and add the following code to the Site Header box after replacing the API_KEY value with your new Content API Key.
```
<script>var ghosthunter_key = 'API_KEY';</script>
```

Members / Subscription

Subscribers can be enabled via a checkbox on the Labs page Settings > Labs > Members (BETA), in your Ghost admin panel:

Login into admin section of your ghost blog
Click Settings > Labs > Members (BETA)
Check the box for Enable Members, under the Enable Beta Features.

Once enabled, different parts of the theme will appear:

Login In and Sign Up buttons in the header.
Footer subscription form.
Call to action section in Post page to encourage visitors to subscribe if the post is set to Members only.

In order for the blog to fully supports member sign up flows and subscriptions, within the theme folder is a routes.yaml file. Upload this single file using Routes on the Labs page.

To edit plans features, you can edit the partials/signup-plans.hbs file. For more information about Members, connecting Stripe and setting the package price, I highly recommend checking the official Ghost documentation

FAQ

How to enable disqus comment?
To enable commenting, you need to have a >Disqus account, it's free. Once you have created an account find the shortname and copy it, enter it into code injection on your ghost dashboard with this script code
```
<script>disqus_shortname = 'YOUR_DISQUS_SHORTNAME';</script>
```
Change YOUR_DISQUS_SHORTNAME to your disqus shortname.

Support

We are providing the best possible support only for the features which we have created and for the issues related to this theme. Custom modifications or third party module implementations are not included.

Support for this item includes:

Responding to questions or problems regarding the item and its features
Fixing bugs and reported issues
Providing updates to ensure compatibility with new software versions

Item support does not include:

Customization and installation services
Support for third party software and plug-ins

Feel free to Contact Author.