{"id":13558439,"url":"https://github.com/wdiazux/cusca","last_synced_at":"2025-04-03T13:31:16.643Z","repository":{"id":38896834,"uuid":"90950951","full_name":"wdiazux/cusca","owner":"wdiazux","description":"A ghost theme","archived":false,"fork":false,"pushed_at":"2023-07-06T13:01:09.000Z","size":15257,"stargazers_count":43,"open_issues_count":42,"forks_count":12,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-04T09:37:19.592Z","etag":null,"topics":["blog","blogging","foundation6","ghost","ghost-theme","journalism","publishing","sass","theme","typescript","webpack"],"latest_commit_sha":null,"homepage":"https://www.wdiaz.org","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wdiazux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-05-11T07:33:39.000Z","updated_at":"2024-02-10T18:07:51.000Z","dependencies_parsed_at":"2023-02-05T03:01:30.965Z","dependency_job_id":"8a506170-2f16-4732-a12e-5130d9b56830","html_url":"https://github.com/wdiazux/cusca","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdiazux%2Fcusca","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdiazux%2Fcusca/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdiazux%2Fcusca/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdiazux%2Fcusca/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wdiazux","download_url":"https://codeload.github.com/wdiazux/cusca/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247009574,"owners_count":20868569,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog","blogging","foundation6","ghost","ghost-theme","journalism","publishing","sass","theme","typescript","webpack"],"created_at":"2024-08-01T12:04:57.290Z","updated_at":"2025-04-03T13:31:15.462Z","avatar_url":"https://github.com/wdiazux.png","language":"SCSS","funding_links":["https://paypal.me/wdiazux"],"categories":["SCSS","webpack"],"sub_categories":[],"readme":"# CUSCA\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Build Status](https://github.com/wdiazux/cusca/workflows/Test/badge.svg)](https://github.com/wdiazux/cusca/actions?query=workflow%3ATest)\n[![Donate](https://img.shields.io/badge/donate-paypal-blue.svg?style=flat-square)](https://paypal.me/wdiazux)\n\nA responsive theme for [Ghost 3.x](https://ghost.org).\n\n**What that mean CUSCA?**\n\nIs the abbreviation for Cuscatlán, it was the name of El Salvador before the conquest and means \"the land of precious things\" in Nahuatl.\n\n---\n\n## Introduction\n\nCusca was development using [Foundation](http://foundation.zurb.com) as base, the style is generated with\n[Sass](https://sass-lang.com) and the javascript is generated with [Typescript](https://www.typescriptlang.org) and\nother cool stuff that comes from different libraries:\n\n- [Shuffle](https://vestride.github.io/Shuffle/)\n- [LightGallery.js](https://sachinchoolur.github.io/lightgallery.js/)\n- [FontAwesome](http://fontawesome.io)\n- [Prism.js](http://prismjs.com)\n- [Color Thief](https://lokeshdhakar.com/projects/color-thief/)\n- [Particles.js](https://vincentgarreau.com/particles.js/)\n- [Ghost Search](https://github.com/HauntedThemes/ghost-search)\n\nAll the help to contribute to the development or improvement of the theme is welcomed.\n  \n## Installation\n\nInside the Ghost themes folder (content/themes) you have to clone the repository or download the last version:\n\n:anchor: [Last release](https://github.com/wdiazux/cusca/releases/latest)\n\n```bash\ngit clone https://github.com/wdiazux/cusca.git\n```\n\n## Setup\n\n### Disqus\n\nInside the `post.hbs` file you need to replace `[your-disqus-name]` with your Disqus name:\n\n```javascript\n(function() { // DON'T EDIT BELOW THIS LINE\n    var d = document, s = d.createElement('script');\n    s.async = true;\n    s.src = 'https://[your-disqus-name].disqus.com/embed.js';\n    s.setAttribute('data-timestamp', +new Date());\n    (d.head || d.body).appendChild(s);\n})();\n```\n\nDo the same for `partials/loop.hbs`:\n\n```html\n\u003cscript id=\"dsq-count-scr\" src=\"//[your-disqus-name].disqus.com/count.js\" async\u003e\u003c/script\u003e\n```\n\n### Search\n\nThe new release of the Ghost API v3, require extra steps that are **NECESSARY** for the\nsearch functionality:\n\n- Go in your Ghost's dashboard -\u003e Integrations -\u003e Add custom integration\n- Set a name: Themes Search\n- Get the `Content API Key` and replace the demo key with this one\n- Do the same with the `API URL`\n\nThe file to modify with this credentials is `src/scripts/app.ts`\nand at the end of the document is the Search section, and the parameter you\nneed to change are the URL and Key from the GhostSearch class.\n\n```javascript\nconst ghostSearch = new GhostSearch({\n    url: 'http://localhost:2368',\n    key: '4f1476d8df3a9cd277b2273b6e',\n});\n```\n\nYou will need to rebuild the theme to make it work after modifying the parameters. In\nthe end of this page you will find the commands that you need to do it.\n\n### Social Icons\n\nInside the `partials/footer.hbs` file replace `[your-user]` with your user names for each social network:\n\n```html\n\u003cli\u003e\n    \u003ca href=\"https://www.youtube.com/[your-user]\" target=\"_blank\" rel=\"noopener\" title=\"Youtube\"\u003e\u003ci class=\"fab fa-youtube\"\u003e\u003c/i\u003e\u003c/a\u003e\n\u003c/li\u003e\n\u003cli\u003e\n    \u003ca href=\"https://www.facebook.com/[your-user]\" target=\"_blank\" rel=\"noopener\" title=\"Facebook\"\u003e\u003ci class=\"fab fa-facebook-f\"\u003e\u003c/i\u003e\u003c/a\u003e\n\u003c/li\u003e\n\u003cli\u003e\n    \u003ca href=\"https://twitter.com/[your-user]\" target=\"_blank\" rel=\"noopener\" title=\"Twitter\"\u003e\u003ci class=\"fab fa-twitter\"\u003e\u003c/i\u003e\u003c/a\u003e\n\u003c/li\u003e\n\u003cli\u003e\n    \u003ca href=\"https://www.instagram.com/[your-user]\" target=\"_blank\" rel=\"noopener\" title=\"Instagram\"\u003e\u003ci class=\"fab fa-instagram\"\u003e\u003c/i\u003e\u003c/a\u003e\n\u003c/li\u003e\n\u003cli\u003e\n    \u003ca href=\"https://github.com/[your-user]\" target=\"_blank\" rel=\"noopener\" title=\"Github\"\u003e\u003ci class=\"fab fa-github-alt\"\u003e\u003c/i\u003e\u003c/a\u003e\n\u003c/li\u003e\n\u003cli\u003e\n    \u003ca href=\"https://www.linkedin.com/in/[your-user]\" target=\"_blank\" rel=\"noopener\" title=\"LinkedIn\"\u003e\u003ci class=\"fab fa-linkedin-in\"\u003e\u003c/i\u003e\u003c/a\u003e\n\u003c/li\u003e\n```\n\n### Google Analytics\n\nInside the `partials/google_analytics.hbs` file replace `[your-ga-id]` with your google analytics id:\n\n```javascript\nwindow.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;\nga('create', '[your-ga-id]', 'auto');\nga('send', 'pageview');\n```\n\n## Modify the theme\n\nYou need to run a ghost instance in the port 2368 it is the default ghost port,\nthe theme was development using Webpack, so first you need to install it and\ntheir dependencies with this command:\n\n``` bash\nnpm install\n```\n\nYou also can use yarn instead of npm:\n``` bash\nyarn install\n```\n\nThen you have four commands provided by the Webpack configuration file:\n* `npm run dev` to compile files in development.\n* `npm run start` for live development.\n* `npm run build` to build a production environment.\n* `npm run test` to test the theme with gscan.\n\nIf you are using yarn:\n* `yarn dev` to compile files in development.\n* `yarn start` for live development.\n* `yarn build` to build a production environment.\n* `yarn test` to test the theme with gscan.\n\nIf you are looking to modify the style or something in the scripts, the source\nfiles are in the `src` directory `assets` is the destination directory and it\nshouldn't be modified.\nThis version use Typescript for javascript and SASS to generate CSS.\n\n## Copyright \u0026 License\n\n- Copyright (c) 2017-2020 William Diaz - Released under the [MIT license](LICENSE).\nThis version is using the MIT license and the libraries are also MIT or compatibles with it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwdiazux%2Fcusca","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwdiazux%2Fcusca","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwdiazux%2Fcusca/lists"}