{"id":21016607,"url":"https://github.com/gsa/openacr-website","last_synced_at":"2025-05-15T05:33:10.549Z","repository":{"id":40575363,"uuid":"383588080","full_name":"GSA/openacr-website","owner":"GSA","description":"Beta site for OpenACR (previously Open Product Accessibility Template or OPAT) -  https://github.com/GSA/openacr","archived":false,"fork":false,"pushed_at":"2023-06-01T09:57:10.000Z","size":9220,"stargazers_count":3,"open_issues_count":6,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-06-11T19:27:19.948Z","etag":null,"topics":["accessibility","acr","documentation","government","section508","vpat"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GSA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-06T20:15:44.000Z","updated_at":"2022-02-01T17:05:44.000Z","dependencies_parsed_at":"2023-02-17T03:45:59.496Z","dependency_job_id":null,"html_url":"https://github.com/GSA/openacr-website","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"cloud-gov/pages-uswds-jekyll","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSA%2Fopenacr-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSA%2Fopenacr-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSA%2Fopenacr-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSA%2Fopenacr-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GSA","download_url":"https://codeload.github.com/GSA/openacr-website/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225332353,"owners_count":17457710,"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":["accessibility","acr","documentation","government","section508","vpat"],"created_at":"2024-11-19T10:14:53.081Z","updated_at":"2024-11-19T10:14:53.850Z","avatar_url":"https://github.com/GSA.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n  Federalist recommends you use Continuous Integration to automatically test\n  and validate any new changes to your site. CircleCI is free for open source\n  projcets. You should replace this badge with your own.\n\n  https://circleci.com/\n--\u003e\n\n# OpenACR Website\n\nThis is the website for the [OpenACR](https://github.com/GSA/openacr) (previously known as Open Product Accessibility Template or OPAT). OpenACR is an machine-readable Accessibility Conformance Report (ACR). The goal of this site is to host a description fo the format and instructions on how to use it. \n\nA [preview of the site](https://federalist-6d3494a6-5b03-42fa-82f2-57f3bbb203af.app.cloud.gov/site/gsa/openacr-website/) is now available.\n\nThe site is built with Jekyll using the U.S. Web Design System (USWDS) framework. It is hosted on Federalist, but using this GitHub repository you can install it locally. We have included more information from the default [Federalist implementation of the USWDS](https://github.com/18F/federalist-uswds-jekyll) to help get folks started. \n\n## Federalist + U.S. Web Design System + Jekyll\n\nThis [Jekyll theme](https://jekyllrb.com/docs/themes/) is developed using the [U.S. Web Design System v 2.0](https://v2.designsystem.digital.gov) and is focused on providing developers a starter kit and reference implementation for Federalist websites.\n\nThis code uses the [Jekyll](https://jekyllrb.com) site engine and built with Ruby. If you prefer to use Javascript, check out [federalist-uswds-gatsby](https://github.com/18F/federalist-uswds-gatsby), which uses [Gatsby](https://gatsbyjs.org) site engine.\n\nThis project strives to be compliant with requirements set by [21st Century IDEA Act](https://www.meritalk.com/articles/senate-passes-idea-act/). The standards require that a website or digital service:\n\n- is accessible to individuals with disabilities;\n- has a consistent appearance;\n- does not duplicate any legacy websites (the legislation also requires agencies to ensure that legacy websites are regularly reviewed, removed, and consolidated);\n- has a search function;\n- uses an industry standard secure connection;\n- “is designed around user needs with data-driven analysis influencing management and development decisions, using qualitative and quantitative data to determine user goals, needs, and behaviors, and continually test the website, web-based form, web-based application, or digital service to ensure that user needs are addressed;”\n- allows for user customization; and\n- is mobile-friendly.\n\n### How to edit\n- Non-developers should focus on editing markdown content in the `_posts` and `_pages` folder\n\n- We try to keep configuration options to a minimum so you can easily change functionality. You should review `_config.yml` to see the options that are available to you. There are a few values on top that you **need** to change. They refer to the agency name and contact information. The rest of `_config.yml` has a range of more advanced options.\n\n- The contents inside `assets/` folder store your Javascript, SCSS/CSS, images, and other media assets are managed by  [jekyll-assets](https://github.com/envygeeks/jekyll-assets).  Assets are combined, compressed, and automatically available in your theme\n\n- If you look at `package.json` you will see that the `npm run federalist` command that will run when running on the Federalist platform.\n\n- Do not edit files in the `_site/` folder. These files are auto-generated, and any change you make in the folder will be overwritten.\n\n- To edit the look and feel of the site, you need to edit files in `_includes/` folder, which render key components, like the menu, side navigation, and logos.\n\n- `index.html` may not require much editing, depending on how you customize `hero.html` and `highlights.html`.\n\n- `_layouts/` may require the least amount of editing of all the files since they are primarily responsible for printing the content.\n\n- `blog/index.html` can be edited, but be careful. It will impact the pagination system for the posts. If you do edit the file, be prepared to edit `_config.yml`.  For example, you may need go change configurations for [jekyll-paginate-v2](https://github.com/sverrirs/jekyll-paginate-v2)\n\n- `search/index.html` is used by search.gov.\n\n### Getting Started\n\n#### With `npx` (requires node)\n    $ npx degit https://github.com/GSA/openacr-website#main \u003cdestination-folder\u003e\n    $ cd \u003cdestination-folder\u003e\n\n#### Push to your Github repository\n- [Create a new Github repository](https://help.github.com/en/github/getting-started-with-github/create-a-repo).\n- Follow the instructions form Github or\n```\n    $ git init\n    $ git symbolic-ref HEAD refs/heads/main\n    $ git add . \u0026\u0026 git commit -m 'Initial commit'\n    $ git remote add origin git@github.com:\u003cyour-org\u003e/\u003cyour-repo\u003e.git\n    (Make sure to replace `\u003cyour-org\u003e` and `\u003cyour-repo\u003e` above with the correct values)\n    $ git push -u origin main\n```\n\n### Installation for development\n    $ git clone https://github.com/GSA/openacr-website.git\n    $ cd openacr-website\n\n### Running the application\n\n#### With locally installed `node` and `ruby`\n    $ npm install\n    $ bundle install\n    $ npm start \n    OR\n    $ bundle exec jekyll serve\n\nTo build but not serve the site, run `npm run build` or `bundle exec jekyll build`.\n\n#### With Docker\n    $ docker-compose run node npm install\n    $ docker-compose build\n    $ docker-compose up\n\nTo build but not serve the site, run:\n```\ndocker-compose run ruby bundle exec jekyll build\n```\n.\n\nNote that when built by Federalist, `npm run federalist` is used instead of\n`npm run build`.\n\nOpen your web browser to [localhost:4000](http://localhost:4000/) to view your\nsite.\n\n### Testing\n\n#### With locally installed `node` and `ruby`\n    $ npm test\n    OR\n    $ bundle exec htmlproofer _site; npx a11y '_site/**/*.html'\n\n#### With Docker\n    $ docker-compose run ruby bundle exec htmlproofer _site; npx a11y '_site/**/*.html'\n\n## Technologies you should be familiarize yourself with\n\n- [Jekyll](https://jekyllrb.com/docs/) - The primary site engine that builds your code and content.\n- [Front Matter](https://jekyllrb.com/docs/frontmatter) - The top of each page/post includes keywords within `--` tags. This is meta data that helps Jekyll build the site, but you can also use it to pass custom variables.\n- [U.S. Web Design System v 2.0](https://v2.designsystem.digital.gov) \n\n\n## Contributing\n\nSee [CONTRIBUTING](CONTRIBUTING.md) for additional information.\n\n## Public domain\n\nThis project is in the worldwide [public domain](LICENSE.md). As stated in [CONTRIBUTING](CONTRIBUTING.md):\n\n\u003e This project is in the public domain within the United States, and copyright\n\u003e and related rights in the work worldwide are waived through the [CC0 1.0\n\u003e Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).\n\u003e\n\u003e All contributions to this project will be released under the CC0 dedication.\n\u003e By submitting a pull request, you are agreeing to comply with this waiver of\n\u003e copyright interest.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsa%2Fopenacr-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgsa%2Fopenacr-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsa%2Fopenacr-website/lists"}