{"id":18610173,"url":"https://github.com/creativecommons/cc-resource-archive","last_synced_at":"2025-08-20T12:31:48.231Z","repository":{"id":13064166,"uuid":"15744672","full_name":"creativecommons/cc-resource-archive","owner":"creativecommons","description":"Collection of resources on Creative Commons (CC) tools and other open topics","archived":false,"fork":false,"pushed_at":"2024-04-23T07:54:46.000Z","size":5130,"stargazers_count":54,"open_issues_count":50,"forks_count":119,"subscribers_count":20,"default_branch":"main","last_synced_at":"2024-05-01T09:40:46.171Z","etag":null,"topics":["creative-commons","jekyll"],"latest_commit_sha":null,"homepage":"https://resources.creativecommons.org/","language":"Dockerfile","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/creativecommons.png","metadata":{"funding":{"github":["creativecommons"],"custom":["https://creativecommons.org/donate"]},"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2014-01-08T18:49:45.000Z","updated_at":"2024-05-29T21:54:48.188Z","dependencies_parsed_at":"2024-02-26T23:26:51.755Z","dependency_job_id":"416030ef-f7e8-4917-b2c2-06ac3c1c5320","html_url":"https://github.com/creativecommons/cc-resource-archive","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/creativecommons%2Fcc-resource-archive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativecommons%2Fcc-resource-archive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativecommons%2Fcc-resource-archive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativecommons%2Fcc-resource-archive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/creativecommons","download_url":"https://codeload.github.com/creativecommons/cc-resource-archive/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230423563,"owners_count":18223435,"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":["creative-commons","jekyll"],"created_at":"2024-11-07T03:08:47.619Z","updated_at":"2024-12-19T11:12:32.993Z","avatar_url":"https://github.com/creativecommons.png","language":"Dockerfile","funding_links":["https://github.com/sponsors/creativecommons","https://creativecommons.org/donate"],"categories":[],"sub_categories":[],"readme":"# cc-resource-archive\n\nCollection of resources on Creative Commons (CC) tools and other open topics\n\n\n## Overview\n\nWelcome to the CC Resources Archive. The idea of this project is to have a\nsimple, easy-to-update area for keeping track of all of the useful resources\nthat people make about Creative Commons licenses and open content topics in\ngeneral. The live site is at\n[resources.creativecommons.org](https://resources.creativecommons.org/).\n\n\n## Code of conduct\n\n[`CODE_OF_CONDUCT.md`][org-coc]:\n\u003e The Creative Commons team is committed to fostering a welcoming community.\n\u003e This project and all other Creative Commons open source projects are governed\n\u003e by our [Code of Conduct][code_of_conduct]. Please report unacceptable\n\u003e behavior to [conduct@creativecommons.org](mailto:conduct@creativecommons.org)\n\u003e per our [reporting guidelines][reporting_guide].\n\n[org-coc]: https://github.com/creativecommons/.github/blob/main/CODE_OF_CONDUCT.md\n[code_of_conduct]: https://opensource.creativecommons.org/community/code-of-conduct/\n[reporting_guide]: https://opensource.creativecommons.org/community/code-of-conduct/enforcement/\n\n\n## Contributing\n\nSee [`CONTRIBUTING.md`][org-contrib].\n\n[org-contrib]: https://github.com/creativecommons/.github/blob/main/CONTRIBUTING.md\n\n\n## How it works\n\nThe website is built using [Jekyll](http://jekyllrb.com/docs/home/), a simple\ntemplating system that's built into GitHub. All of the site pages are in the\n`docs/` directory. This readme file and the resource template are in the main\nbranch.\n\nYou don't need to install Jekyll on your machine in order to submit a resource\nto the archive, but the benefit of installing is that you'll be able to see\nexactly what your submission will look like on the live site and correct any\nbugs.\n\nTo submit a resource, make a copy of\n**[`resourcetemplate.md`](https://github.com/creativecommons/cc-resource-archive/blob/main/resourcetemplate.md)**\nand change the values for each field accordingly. The space below the front\nmatter is freeform, for providing additional information or links. The resource\ntemplate also includes explanations of each of the fields.\n\nYou can create a resource page in html, markdown, or textile, using the\nextensions `.html`, `.md`, or `.textile`. For consistency and understandability\nuse entire title as the filename and permalink, i.e.:\n\n**Title: Creative Commons Kiwi**\npermalink: /creative-commons-kiwi/\nFile: creative-commons-kiwi.textile\n\n**Title: Six licenses for sharing your work**\npermalink: /six-licenses-for-sharing-your-work/\nFile: six-licenses-for-sharing-your-work.html\n\n\n### Category URLs\n\nYou can format the `resources.creativecommons.org/all?` URL to show any\ncategory or combination of categories you want. For example, videos available\nin English about licenses:\n\nhttp://resources.creativecommons.org/all/?\u0026topic=licenses\u0026medium=video\u0026language=en\n\nYou can use any category that's listed in one or more resources pages, not just\nthe ones available in the menu on \"all.\" For example, resources about music:\n\nhttp://resources.creativecommons.org/all/?\u0026topic=music\n\nIt will also be trivial to create an RSS feed for any category or combination\nof categories - for example, to create a feed of all resources available in\nSpanish for embedding in an affiliate site. If you need one, submit an issue\nthrough GitHub.\n\n\n### The index page\n\nThe index page pulls up to 16 featured items. Each featured page has a\n\"featured\" variable. The number is the order in which they should appear.\n\n\n### Menu categories\n\nThe list of topics, media, and languages on the homepage is dictated by the\nthree respective `.yml` files in the `_data/` folder. For each category, we\nprovide a capitalized name and a lowercase string with no punctuation. For\nexample:\n\n- name: Licenses\n  string: licenses\n\n- name: Public Domain\n  string: publicdomain\n\n- name: Open Educational Resources\n  string: oer\n\nThe reason for setting it up this way is that the \"string\" value is what's used\nin the URLs and CSS classes. It's also what you use in the resource page itself\nto identify the category. So these should be relatively short, but still\nsensical.\n\n\n## Local Development\n\nLocal development can be previewed by installing Jekyll or by using Docker. We\nthink the latter experience is easier to setup with more consistent behavior.\n\nFor information on learning and installing the prerequisite technologies for this project, please see [Foundational technologies — Creative Commons Open Source][found-tech].\n\n[found-tech]: https://opensource.creativecommons.org/contributing-code/foundational-tech/\n\n\n### Docker Compose setup\n\n1. [Install Docker Engine](https://docs.docker.com/engine/install/)\n2. In your terminal, change the directory to where you have cloned this repository\n   (or a fork of it)\n3. **Run the container:**\n   ```shell\n   docker compose up\n   ```\n   - This should result in the container being built if it's the first time\n   - The docker container may be slow :hourglass_flowing_sand::persevere: When\n     it is ready you should see:\n     ```\n     jekyll-cc-resource-archive  |     Server address: http://0.0.0.0:4000\n     jekyll-cc-resource-archive  |   Server running... press ctrl-c to stop.\n     ```\n   - Once running successfully, you can access the site in your browser at\n     [localhost:4000](http://localhost:4000/)\n6. **Stop the container:** To stop the app from running, simply open another\n   instance of the terminal and type\n   ```shell\n   docker compose down\n   ```\n   or you can simply revisit the existing terminal which is running the\n   container and type `CTRL + C`\n\n\n### Formatting with Prettier\n\n- Format specific HTML file using prettier:\n    ```shell\n    docker compose run --rm node prettier --write docs/index.html\n    ```\n- Format all HTML using prettier:\n    ```shell\n    find docs -name '*.html' -exec docker compose run --rm node prettier --write {} +\n    ```\n- [Prettier · Opinionated Code Formatter](https://prettier.io/)\n\n\n## License\n\n\n### Code\n\n[`LICENSE`](LICENSE): the code within this repository is licensed under the\nExpat/[MIT][mit] license.\n\n[mit]: http://www.opensource.org/licenses/MIT \"The MIT License | Open Source Initiative\"\n\n\n### Content/Text\n\n[![CC BY 4.0 license button][cc-by-png]][cc-by]\n\nAll the content within this repository is licensed under a [Creative Commons\nAttribution 4.0 International License][cc-by] unless otherwise specified.\n\n[cc-by-png]: https://licensebuttons.net/l/by/4.0/88x31.png#floatleft \"CC BY 4.0 license button\"\n[cc-by]: https://creativecommons.org/licenses/by/4.0/ \"Creative Commons Attribution 4.0 International License\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreativecommons%2Fcc-resource-archive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcreativecommons%2Fcc-resource-archive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreativecommons%2Fcc-resource-archive/lists"}