{"id":27004406,"url":"https://github.com/tacc/core-cms-resources","last_synced_at":"2025-04-04T06:16:41.593Z","repository":{"id":37793370,"uuid":"290877403","full_name":"TACC/Core-CMS-Resources","owner":"TACC","description":"Files specific to each website built via TACC/Core-CMS.","archived":false,"fork":false,"pushed_at":"2025-03-07T03:51:27.000Z","size":2757,"stargazers_count":3,"open_issues_count":10,"forks_count":0,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-03-07T04:28:39.215Z","etag":null,"topics":["assets","django-cms","templates"],"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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-27T20:41:35.000Z","updated_at":"2025-03-07T03:51:29.000Z","dependencies_parsed_at":"2023-12-21T21:30:25.835Z","dependency_job_id":"614fb3ab-0bb3-404f-bb20-cb270dd81650","html_url":"https://github.com/TACC/Core-CMS-Resources","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2FCore-CMS-Resources","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2FCore-CMS-Resources/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2FCore-CMS-Resources/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TACC%2FCore-CMS-Resources/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TACC","download_url":"https://codeload.github.com/TACC/Core-CMS-Resources/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247128739,"owners_count":20888235,"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":["assets","django-cms","templates"],"created_at":"2025-04-04T06:16:41.120Z","updated_at":"2025-04-04T06:16:41.586Z","avatar_url":"https://github.com/TACC.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Core-CMS-Resources\n\nProject-specific code built into the [Core CMS] project\n\n\u003e **Note**\n\u003e Do not clone this repo to work on a CMS project. Work on it directly within [Core CMS] as a [Git submodule][Git Submodules].\n\n\u003e **Warning**\n\u003e This repository is deprecated. To work on these projects further, please [migrate them to Core CMS Custom](#port-project).[^1]\n\n[^1]: Deploying websites that are still in Core-CMS-Resources **and** have [old custom templates will trigger a major problem](https://github.com/TACC/Core-CMS-Resources/pull/176#issuecomment-1603194690). The prefered solution is [migration](#port-project). If you must deploy without migration, then [upgrade the website for Core-CMS v3.12](./docs/upgrade-project.md#for-core-cms-v312).\n\n## Table of Contents\n\n- [Related Repositories](#related-repositories)\n- [Project Websites](#project-websites)\n- [Project Architecture](#project-architecture)\n- [Prerequisites](#prerequisites)\n- [Start Project](#start-project)\n- [Update Project](#update-project)\n- [Run Multiple Projects](#run-multiple-projects)\n- [Debug Project](#debug-project)\n- [Build \u0026 Deploy Project](#build--deploy-project)\n- [Port Project](#port-project)\n\n## Related Repositories\n\n- [Core CMS], the base CMS code for TACC WMA CMS Websites\n- [Core CMS Custom], the custom CMS code (new solution) for TACC WMA CMS Websites\n\n## Project Websites\n\n| Abbr. | URL | Version[^2] | Notes |\n| - | - | - | - |\n| 3dem | https://3dem.org/ | **v4**.4.2 |\n| brainmap | https://portal.brainmap.org/ | **v4**.4.2 |\n| frontera | https://frontera-portal.tacc.utexas.edu/ | **v4**.4.2 |\n| protx | https://ccprotx.org/ | **v4**.2.0 |\n| sciviscolor | https://sciviscolor.org/ | **v4**.8.0 |\n| texascale | https://texascale.org/ | **v4**.1.0 |\n| utrc | https://utrc.tacc.utexas.edu/ | **v4**.4.1 |\n\n_Last updated: 2024-02-29_\n\n[^2]: The production version of https://github.com/TACC/Core-CMS that each requires.\n\n## Project Architecture\n\nWithin a `/custom_project_dir` can be:\n\n| directory | contents |\n| - | - |\n| `static` | static assets, organized as Django CMS expects |\n| `templates` | templates and saved snippets |\n| `settings_custom.py`[^3] | project-specific values for [Core CMS] settings |\n\n[^3]: The `cms.settings_custom.py` is committed in [Core Portal Deployments]. A `settings_custom.py` in [Core CMS] is `.gitignore`'d.\n\n## Prerequisites\n\n- [Git Submodules]\n- [Core CMS]\n\nA CMS project is run within [Core CMS]. Also, [Git Submodules] must be pre-installed on the system on which you will run the CMS project.\n\n\u003e **Note**\n\u003e The [Core CMS] has its own prerequisites.\n\n## Start Project\n\nSet up a new local CMS instance.\n\n0. Set up [Core CMS] to run a local [Core CMS Resources]:\n\n    1. If not already done:\n        1. Clone [Core CMS] repository.\n        2. [Set up Core CMS](https://github.com/TACC/Core-CMS#readme) completely.\n    2. Be in your [Core CMS] clone:\n\n        ```sh\n        cd Core-CMS\n        ```\n\n    3. Register and populate `/taccsite-custom`.\n\n        ```sh\n        git submodule init\n        # This registers this repository at `/taccsite_custom`.\n        git submodule update\n        # This populates from this repository into `/taccsite_custom`.\n        ```\n\n    4. Create `/taccsite_cms/settings_custom.py`[^3] and populate it with respective `cms.settings_custom.py` from [Core Portal Deployments] e.g. [`/lccf/camino/cms.settings_custom.py`](https://github.com/TACC/Core-Portal-Deployments/blob/d8e31d9/lccf/camino/cms.settings_custom.py).\n\n1. Enter the CMS Docker Container:\n\n    ```sh\n    docker exec -it core_cms /bin/bash\n    # This opens a command prompt within the container\n    ```\n\n2. Update the Django Application:\n\n    (Run these commands within the container.)\n\n    ```sh\n    python manage.py migrate\n    python manage.py createsuperuser\n    # To use default \"Username\" and skip \"Email address\", press Enter at both prompts.\n    # At \"Password\" prompts, you may use an easy-to-remember password.\n    python manage.py collectstatic --no-input\n\n    ```\n\n3. Open Django CMS:\n    1. Open http://localhost:8000/.\n    2. Verify anything specific to the custom project is present e.g.\n        - logo\n        - custom applications\n        - custom global colors\n        - custom styles (may require specific markup)\n\n\u003e **Note**\n\u003e A local machine CMS will be empty. It will **not** have content from staging nor production. To have that, follow and adapt instructions to [copy a database](https://tacc-main.atlassian.net/wiki/x/GwBJAg).\n\n\u003e **Note**\n\u003e A local machine CMS does **not** include **nor** integrate with an instance of [Core Portal]. To attempt to do that, follow [How to Use a Custom Docker Compose File](https://github.com/TACC/Core-CMS/wiki/How-to-Use-a-Custom-Docker-Compose-File) and [Locally Develop CMS Portal Docs](https://github.com/TACC/Core-CMS/wiki/Locally-Develop-CMS---Portal---Docs). **Help welcome.**\n\n## Update Project\n\nFollow [Core CMS: Update Project](https://github.com/TACC/Core-CMS/blob/main/README.md#update-project) instructions.\n\n## Develop Project\n\nFollow \"via [Core CMS Resources]\" section of [Core CMS: Develop Custom Project](https://github.com/TACC/Core-CMS/blob/main/docs/develop-custom-project.md#via-core-cms-resources).\n\n## Debug Project\n\nRead [Debug Project](./docs/debug-project.md) for miscellaneous tips.\n\n## Build \u0026 Deploy Project\n\nFollow \"Core-CMS-Resources\" section of [How To Build \u0026 Deploy][Build \u0026 Deploy Project].\n\n## Run Multiple Projects\n\nRead [Run Multiple Projects](./docs/run-multiple-projects.md).\n\n## Port Project\n\nTo port a project to [Core CMS Custom], read [Port Project].\n\n\u003c!-- Link Aliases --\u003e\n\n[Core CMS]: https://github.com/TACC/Core-CMS\n[Core Portal]: https://github.com/TACC/Core-Portal\n[Core CMS Custom]: https://github.com/TACC/Core-CMS-Custom\n[Core CMS Resources]: https://github.com/TACC/Core-CMS-Resources\n[Core Portal Deployments]: https://github.com/TACC/Core-Portal-Deployments\n\n[Git Submodules]: https://git-scm.com/book/en/v2/Git-Tools-Submodules\n\n[Build \u0026 Deploy Project]: https://tacc-main.atlassian.net/l/cp/3U2WHbVB\n[Port Project]: https://github.com/TACC/Core-CMS-Custom/blob/main/docs/port-project.md\n[Upgrade Project]: https://github.com/TACC/Core-CMS/blob/main/docs/upgrade-project.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacc%2Fcore-cms-resources","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftacc%2Fcore-cms-resources","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacc%2Fcore-cms-resources/lists"}