wdiazux / cusca

A ghost theme

CUSCA

A responsive theme for Ghost 3.x.

What that mean CUSCA?

Is the abbreviation for Cuscatlán, it was the name of El Salvador before the conquest and means "the land of precious things" in Nahuatl.

---

Introduction

Cusca was development using Foundation as base, the style is generated with Sass and the javascript is generated with Typescript and other cool stuff that comes from different libraries:

• Shuffle
• LightGallery.js
• FontAwesome
• Prism.js
• Color Thief
• Particles.js
• Ghost Search

All the help to contribute to the development or improvement of the theme is welcomed.

Installation

Inside the Ghost themes folder (content/themes) you have to clone the repository or download the last version:

⚓ Last release

git clone https://github.com/wdiazux/cusca.git

Setup

Disqus

Inside the post.hbs file you need to replace [your-disqus-name] with your Disqus name:

(function() { // DON'T EDIT BELOW THIS LINE
    var d = document, s = d.createElement('script');
    s.async = true;
    s.src = 'https://[your-disqus-name].disqus.com/embed.js';
    s.setAttribute('data-timestamp', +new Date());
    (d.head || d.body).appendChild(s);
})();

Do the same for partials/loop.hbs:

<script id="dsq-count-scr" src="//[your-disqus-name].disqus.com/count.js" async></script>

Search

The new release of the Ghost API v3, require extra steps that are NECESSARY for the search functionality:

• Go in your Ghost's dashboard -> Integrations -> Add custom integration
• Set a name: Themes Search
• Get the Content API Key and replace the demo key with this one
• Do the same with the API URL

The file to modify with this credentials is src/scripts/app.ts and at the end of the document is the Search section, and the parameter you need to change are the URL and Key from the GhostSearch class.

const ghostSearch = new GhostSearch({
    url: 'http://localhost:2368',
    key: '4f1476d8df3a9cd277b2273b6e',
});

You will need to rebuild the theme to make it work after modifying the parameters. In the end of this page you will find the commands that you need to do it.

Social Icons

Inside the partials/footer.hbs file replace [your-user] with your user names for each social network:

<li>
    <a href="https://www.youtube.com/[your-user]" target="_blank" rel="noopener" title="Youtube"><i class="fab fa-youtube"></i></a>
</li>
<li>
    <a href="https://www.facebook.com/[your-user]" target="_blank" rel="noopener" title="Facebook"><i class="fab fa-facebook-f"></i></a>
</li>
<li>
    <a href="https://twitter.com/[your-user]" target="_blank" rel="noopener" title="Twitter"><i class="fab fa-twitter"></i></a>
</li>
<li>
    <a href="https://www.instagram.com/[your-user]" target="_blank" rel="noopener" title="Instagram"><i class="fab fa-instagram"></i></a>
</li>
<li>
    <a href="https://github.com/[your-user]" target="_blank" rel="noopener" title="Github"><i class="fab fa-github-alt"></i></a>
</li>
<li>
    <a href="https://www.linkedin.com/in/[your-user]" target="_blank" rel="noopener" title="LinkedIn"><i class="fab fa-linkedin-in"></i></a>
</li>

Google Analytics

Inside the partials/google_analytics.hbs file replace [your-ga-id] with your google analytics id:

window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
ga('create', '[your-ga-id]', 'auto');
ga('send', 'pageview');

Modify the theme

You need to run a ghost instance in the port 2368 it is the default ghost port, the theme was development using Webpack, so first you need to install it and their dependencies with this command:

npm install

You also can use yarn instead of npm:

yarn install

Then you have four commands provided by the Webpack configuration file:

• npm run dev to compile files in development.
• npm run start for live development.
• npm run build to build a production environment.
• npm run test to test the theme with gscan.

If you are using yarn:

• yarn dev to compile files in development.
• yarn start for live development.
• yarn build to build a production environment.
• yarn test to test the theme with gscan.

If you are looking to modify the style or something in the scripts, the source files are in the src directory assets is the destination directory and it shouldn't be modified. This version use Typescript for javascript and SASS to generate CSS.

Copyright & License

• Copyright (c) 2017-2020 William Diaz - Released under the MIT license. This version is using the MIT license and the libraries are also MIT or compatibles with it.

cusca's Issues

Add facebook to the social icons

As the title says. Would be nice to have the connection to Facebook for me. Really love your theme, btw.

No Public API on Ghost 2.11.0

From 2.11.0 release there is no option of Enabling Public API in Labs Section.
https://forum.ghost.org/t/public-api-gone-in-ghost-version-2-11-0/5114

Will this theme still work with current latest version 2.28.x ?

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Rate-Limited

These updates are currently rate-limited. Click on a checkbox below to force their creation now.

• Update dependency @tryghost/content-api to v1.4.15
• Update dependency @types/prismjs to v1.16.8
• Update dependency autoprefixer to v9.8.8
• Update dependency browser-sync to v2.26.14
• Update dependency cssnano to v4.1.11
• Update dependency optimize-css-assets-webpack-plugin to v5.0.8
• Update dependency postcss to v7.0.39
• Update dependency postcss-preset-env to v6.7.1
• Update dependency what-input to v5.2.12
• Update dependency @tryghost/content-api to v1.11.15
• Update dependency @types/prismjs to v1.26.0
• Update dependency babel-loader to v8.3.0
• Update dependency browser-sync to v2.29.3
• Update dependency browser-sync-webpack-plugin to v2.3.0
• Update dependency colorthief to v2.4.0
• Update dependency core-js to v3.31.1
• Update dependency eslint-plugin-prettier to v3.4.1
• Update dependency foundation-sites to v6.7.5
• Update dependency fuzzysort to v1.9.0
• Update dependency gscan to v3.6.1
• Update dependency lg-zoom.js to v1.3.0
• Update dependency lightgallery.js to v1.4.0
• Update dependency promise-polyfill to v8.3.0
• Update dependency shufflejs to v5.4.1
• Update dependency style-loader to v1.3.0
• Update actions/cache action to v3
• Update actions/checkout action to v3
• Update actions/setup-node action to v3
• Update dependency @fortawesome/fontawesome-free to v6
• Update dependency autoprefixer to v10
• Update dependency babel-loader to v9
• Update dependency clean-webpack-plugin to v4
• Update dependency copy-webpack-plugin to v11
• Update dependency css-loader to v6
• Update dependency cssnano to v6
• Update dependency eslint to v8
• Update dependency eslint-config-airbnb to v19
• Update dependency eslint-config-prettier to v8
• Update dependency eslint-plugin-prettier to v4
• Update dependency fuzzysort to v2
• Update dependency gscan to v4
• Update dependency mini-css-extract-plugin to v2
• Update dependency optimize-css-assets-webpack-plugin to v6
• Update dependency postcss to v8
• Update dependency postcss-flexbugs-fixes to v5
• Update dependency postcss-loader to v7
• Update dependency postcss-preset-env to v9
• Update dependency prettier to v3
• Update dependency sass-loader to v13
• Update dependency shufflejs to v6
• Update dependency style-loader to v3
• Update dependency terser-webpack-plugin to v5
• Update dependency typeface-montserrat to v1
• Update dependency typescript to v5
• Update dependency webpack to v5
• Update dependency webpack-cli to v5
• 🔐 Create all rate-limited PRs at once 🔐

Edited/Blocked

These updates have been manually edited so Renovate will no longer make changes. To discard all commits and start over, click on a checkbox.

• Update dependency prismjs to v1.27.0 [SECURITY]
• Update dependency node-sass to v7 [SECURITY]
• Update dependency css-loader to v3.6.0
• Update dependency eslint to v7.32.0
• Update dependency eslint-config-airbnb to v18.2.1
• Update dependency eslint-config-prettier to v6.15.0
• Update dependency file-loader to v6.2.0
• Update dependency mini-css-extract-plugin to v0.12.0
• Update dependency terser-webpack-plugin to v3.1.0
• Update dependency typescript to v3.9.10
• Update dependency webpack to v4.46.0
• Update typescript-eslint monorepo to v2.34.0 (minor) (@typescript-eslint/eslint-plugin, @typescript-eslint/parser)
• Update dependency webpack-merge to v5
• Update dependency worker-loader to v3

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update babel monorepo (minor) (@babel/cli, @babel/core, @babel/plugin-transform-runtime, @babel/preset-env, @babel/preset-typescript, @babel/runtime)
• Update dependency @fortawesome/fontawesome-free to v5.15.4
• Update dependency @types/webpack-env to v1.18.1
• Update dependency eslint-plugin-import to v2.27.5
• Update dependency jquery to v3.7.0 (jquery, @types/jquery)
• Update dependency prettier to v2.8.8
• Update typescript-eslint monorepo to v5 (major) (@typescript-eslint/eslint-plugin, @typescript-eslint/parser)
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

github-actions

.github/workflows/test.yml

• actions/checkout v1
• actions/cache v1
• actions/setup-node v1

npm

package.json

• @babel/runtime 7.9.6
• @fortawesome/fontawesome-free 5.13.1
• @tryghost/content-api 1.4.11
• @types/jquery 3.3.38
• @types/prismjs 1.16.2
• colorthief 2.3.2
• core-js 3.6.5
• foundation-sites 6.6.3
• fuzzysort 1.1.4
• jquery 3.5.1
• lg-zoom.js 1.2.0
• lightgallery.js 1.2.0
• particles.js 2.0.0
• prismjs 1.20.0
• roboto-fontface 0.10.0
• shufflejs 5.2.3
• tern 0.24.3
• typeface-montserrat 0.0.75
• what-input 5.2.10
• @babel/cli 7.8.4
• @babel/core 7.9.6
• @babel/plugin-transform-runtime 7.9.6
• @babel/preset-env 7.9.6
• @babel/preset-typescript 7.9.0
• @types/webpack-env 1.15.3
• @typescript-eslint/eslint-plugin 2.31.0
• @typescript-eslint/parser 2.31.0
• autoprefixer 9.8.6
• awesome-typescript-loader 5.2.1
• babel-loader 8.1.0
• browser-sync 2.26.13
• browser-sync-webpack-plugin 2.2.2
• clean-webpack-plugin 3.0.0
• copy-webpack-plugin 5.1.2
• css-loader 3.5.3
• cssnano 4.1.10
• eslint 7.0.0
• eslint-config-airbnb 18.1.0
• eslint-config-jquery 3.0.0
• eslint-config-prettier 6.11.0
• eslint-loader 4.0.2
• eslint-plugin-import 2.20.2
• eslint-plugin-prettier 3.1.4
• file-loader 6.0.0
• gscan 3.5.7
• mini-css-extract-plugin 0.9.0
• node-sass 4.14.1
• optimize-css-assets-webpack-plugin 5.0.4
• postcss 7.0.36
• postcss-flexbugs-fixes 4.2.1
• postcss-loader 3.0.0
• postcss-preset-env 6.7.0
• precss 4.0.0
• prettier 2.0.5
• promise-polyfill 8.1.3
• sass-loader 8.0.2
• style-loader 1.2.1
• terser-webpack-plugin 3.0.8
• typescript 3.8.3
• webpack 4.43.0
• webpack-cli 3.3.12
• webpack-merge 4.2.2
• worker-loader 2.0.0

---

• Check this box to trigger a request for Renovate to run again on this repository

"Featured" posts not appearing in side bar

I have enabled the public API and can see my tags. I cannot see Featured posts even though I have marked some posts as Featured.

I believe this is because sidebar.hbs contains the following code
<ul id="featured-posts" class="no-bullet"></ul>

According to https://themes.ghost.org/docs/recent-featured-sidebar, the code inside <ul></ul> should be as follows:

`{{#get "posts" filter="featured:true" limit="3" as |featured|}}

Featured posts

{{#foreach featured}}
1. {{title}}
{{/foreach}}

{{else}}

No featured posts...

{{/get}}`

Update font size for sidebars and other elements

Where is social icons are located?

I checked the demo and installed it on my blog, but I couldn't find where the theme display social icons on my blog.

Apply new handlebars tags

Review the new Ghost documentation

Featured posts and tags on homepage

Hi
i have created 5 tags in my tag section and have also clicked the check box "feature this post ".
but neither the post is shown in featured post nor the tags are shown in tags column on the home page.
Or am i doing anything wrong, please help. Thank you

Action Required: Fix Renovate Configuration

There is an error with this repository's Renovate configuration that needs to be fixed. As a precaution, Renovate will stop PRs until it is resolved.

Location: renovate.json
Error type: The renovate configuration file contains some invalid settings
Message: Invalid configuration option: node

Update endpoints from Ghost API if there are new ones