{"id":27004483,"url":"https://github.com/tacc/core-cms-custom","last_synced_at":"2026-04-09T19:09:40.578Z","repository":{"id":50525301,"uuid":"519323673","full_name":"TACC/Core-CMS-Custom","owner":"TACC","description":"Customized Core CMS code and builds","archived":false,"fork":false,"pushed_at":"2025-07-29T00:41:14.000Z","size":19024,"stargazers_count":5,"open_issues_count":4,"forks_count":0,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-07-29T02:36:17.314Z","etag":null,"topics":["django-cms","tacc"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TACC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-07-29T19:09:00.000Z","updated_at":"2025-07-29T00:41:18.000Z","dependencies_parsed_at":"2023-09-24T20:22:14.983Z","dependency_job_id":"ce152f75-55ef-4931-b6ae-a8569caf1d66","html_url":"https://github.com/TACC/Core-CMS-Custom","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/TACC/Core-CMS-Custom","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2FCore-CMS-Custom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2FCore-CMS-Custom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2FCore-CMS-Custom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2FCore-CMS-Custom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TACC","download_url":"https://codeload.github.com/TACC/Core-CMS-Custom/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2FCore-CMS-Custom/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268181113,"owners_count":24209160,"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","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["django-cms","tacc"],"created_at":"2025-04-04T06:16:57.375Z","updated_at":"2026-04-09T19:09:40.560Z","avatar_url":"https://github.com/TACC.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Core-CMS-Custom\n\nCustom assets for [Core CMS] projects\n\n\u003e [!TIP]\n\u003e To customize a [Core CMS] project beyond assets, [create a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template#creating-a-repository-from-a-template) via [Core CMS Template].\n\n\u003e [!CAUTION]\n\u003e - If you change a file path, update [Core Portal Deployments], because it reads this `main` branch.\n\u003e - If you do **not** have access to [Core Portal Deployments], then maybe do **not** change a file path.\n\n## Table of Contents\n\n- [Related Repositories](#related-repositories)\n- [Project Architecture](#project-architecture)\n- [Create Project](#create-project)\n- [Asset Management](#asset-management)\n- [Build Project](#build-project)\n- [Deploy Project](#deploy-project)\n- [Port Project](#port-project)\n- [Upgrade Project](#upgrade-project)\n\n## Related Repositories\n\n- [Camino], a Docker container-based deployment scheme\n- [Core CMS], the base CMS code for TACC WMA CMS Websites\n- [Core CMS Template], a template for creating new TACC WMA CMS projects\n- [Core Portal], the base Portal code for TACC WMA CMS Websites\n- [Core Styles], the shared UI pattern code for TACC WMA CMS Websites\n- [Core CMS Resources], the old solution for extensions of the [Core CMS] project\n- [Core Portal Deployments], private repository that facilitates deployments of [Core Portal] images via [Camino] and Jenkins\n\n## Project Architecture\n\nWithin a `/customproject`**`_assets`** can be:\n\n| directory | contents | notes |\n| - | - | - |\n| `favicon.svg` | current favicon | `.svg` preferred |\n| `favicon` | other favicons |\n| `logo.svg` | current logo | `.svg` preferred |\n| `logo` | other logos |\n| `css` | custom styles |\n| `js` | custom scripts |\n| [`snippets`](https://github.com/django-cms/djangocms-snippet) | reusable markup | [manually saved](#save-snippets) |\n\n## Create Project\n\n1. Duplicate \u0026 Rename the [example_assets](./example_assets) directory.\n2. Add your assets into that directory.\n3. Get paths to those assets [via a CDN](https://www.jsdelivr.com/?docs=gh).\n4. Find the project in [Core Portal Deployments].\n5. Set those paths in its CMS settings file ([example](https://github.com/TACC/Core-Portal-Deployments/blob/2391315/digitalrocks/camino/cms.settings_custom.py)).\n\n## Asset Management\n\n- [Change Logo](#change-logo)\n- [Custom Styles](#custom-styles)\n- [Save Snippets](#save-snippets)\n\n### Change Logo\n\nChanges **only** header on **both** CMS pages **and** Portal interface.\n\n1. **Upload** logo to folder ([example](https://github.com/TACC/Core-CMS-Custom/blob/4bff8af/digitalrocks_assets/NSF-DigitalRocks-Logo-White.svg \"https://github.com/TACC/Core-CMS-Custom/blob/4bff8af/digitalrocks_assets/NSF-DigitalRocks-Logo-White.svg\")).\n\n2. In [Core Portal Deployments],\\\n    **set** path to that logo [via CDN](https://www.jsdelivr.com/?docs=gh \"https://www.jsdelivr.com/?docs=gh\") ([example](https://github.com/TACC/Core-Portal-Deployments/blob/2391315/digitalrocks/camino/cms.settings_custom.py#L11 \"https://github.com/TACC/Core-Portal-Deployments/blob/2391315/digitalrocks/camino/cms.settings_custom.py#L11\")).\n\n3. **[Deploy](#deploy-project)** the change.\n\n### Custom Styles\n\nThese will load on **every page**.\n\n1. **Upload** CSS to folder. Examples:\n\n    - [one short stylesheet](https://github.com/TACC/Core-CMS-Custom/blob/e70089f/ctrn_assets/site.cms.css \"https://github.com/TACC/Core-CMS-Custom/blob/e70089f/ctrn_assets/site.cms.css\")\n    - [one long stylesheet](https://github.com/TACC/Core-CMS-Custom/blob/e70089f/ecep_assets/css/site.css \"https://github.com/TACC/Core-CMS-Custom/blob/e70089f/ecep_assets/css/site.css\")\n    - [multiple stylesheets](https://github.com/TACC/Core-CMS-Custom/tree/4bff8af/digitalrocks_assets/css \"https://github.com/TACC/Core-CMS-Custom/tree/4bff8af/digitalrocks_assets/css\")\n\n2. In [Core Portal Deployments],\\\n    **set** path(s) to stylesheet(s) [via CDN](https://www.jsdelivr.com/?docs=gh \"https://www.jsdelivr.com/?docs=gh\"). Examples:\n\n    - [one stylesheet](https://github.com/TACC/Core-Portal-Deployments/blob/2391315/ecep/camino/cms.settings_custom.py#L53-L56 \"https://github.com/TACC/Core-Portal-Deployments/blob/2391315/ecep/camino/cms.settings_custom.py#L53-L56\")\n\n    - [multiple stylesheets](https://github.com/TACC/Core-Portal-Deployments/blob/2391315/digitalrocks/camino/cms.settings_custom.py#L30-L39 \"https://github.com/TACC/Core-Portal-Deployments/blob/2391315/digitalrocks/camino/cms.settings_custom.py#L30-L39\")\n\n3. **[Deploy](#deploy-project)** the change.\n\n### Save Snippets\n\n\u003e [!IMPORTANT]\n\u003e Snippets are **not** loaded by the CMS from here **nor** a CDN. They are maintained independently in the CMS admin interface. This folder just lets us version control them.\n\n1. **Upload** snippet(s) to folder ([example](https://github.com/TACC/Core-CMS-Custom/tree/main/ecep_assets/html/snippets \"https://github.com/TACC/Core-CMS-Custom/tree/main/ecep_assets/html/snippets\")).\n\n2. In the CMS admin interface:\\\n    **document** the latest commit of each snippet ([examples](https://ecepalliance.org/admin/djangocms_snippet/snippet/ \"https://ecepalliance.org/admin/djangocms_snippet/snippet/\")) e.g.\n\n    - **Name:** `Page: Members: JS (last commit: 2bcadc0)`\n    - **Name:** `Page: Members: CSS (TACC/Core-CMS-Custom#321)`\n\n## Build Project\n\nFollow [Core CMS: Build \u0026 Deploy Project](https://github.com/TACC/Core-CMS#build--deploy-project).\n\n## Deploy Project\n\nFollow \"Deploy\" section of [How To Build \u0026 Deploy][Deploy Project].\n\n## Port Project\n\nTo port a project from [Core CMS Resources], read [Port Project].\n\n## Upgrade Project\n\nTo upgrade the [Core CMS] of an existing project:\n\n- Update its CMS image tag in [Core Portal Deployments] ([example](https://github.com/TACC/Core-Portal-Deployments/blob/23913151/digitalrocks/camino/prod.env#L24)).\n\n\n\u003c!-- Link Aliases --\u003e\n\n[Camino]: https://github.com/TACC/Camino\n[Core CMS]: https://github.com/TACC/Core-CMS\n[Core CMS Template]: https://github.com/TACC/Core-CMS-Template\n[Core Portal]: https://github.com/TACC/Core-Portal\n[Core Styles]: https://github.com/TACC/tup-ui/tree/main/libs/core-styles\n[Core CMS Resources]: https://github.com/TACC/Core-CMS-Resources\n[Core Portal Deployments]: https://github.com/TACC/Core-Portal-Deployments\n\n[Deploy Project]: https://tacc-main.atlassian.net/wiki/x/YAVv#3.-Deploy\n[Port Project]: ./docs/port-project.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacc%2Fcore-cms-custom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftacc%2Fcore-cms-custom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacc%2Fcore-cms-custom/lists"}