{"id":23122655,"url":"https://github.com/folio-org/folio-org.github.io","last_synced_at":"2025-04-04T04:20:46.958Z","repository":{"id":37676325,"uuid":"61284565","full_name":"folio-org/folio-org.github.io","owner":"folio-org","description":"Website for FOLIO open source development dev.folio.org","archived":false,"fork":false,"pushed_at":"2024-10-30T02:14:28.000Z","size":9391,"stargazers_count":13,"open_issues_count":0,"forks_count":13,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-10-30T02:52:01.695Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://dev.folio.org","language":"SCSS","has_issues":false,"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/folio-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2016-06-16T10:37:14.000Z","updated_at":"2024-10-30T02:14:32.000Z","dependencies_parsed_at":"2024-04-30T01:36:22.256Z","dependency_job_id":"3f2d7d02-e05a-4900-8121-c0ea87962eff","html_url":"https://github.com/folio-org/folio-org.github.io","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folio-org%2Ffolio-org.github.io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folio-org%2Ffolio-org.github.io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folio-org%2Ffolio-org.github.io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/folio-org%2Ffolio-org.github.io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/folio-org","download_url":"https://codeload.github.com/folio-org/folio-org.github.io/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247118780,"owners_count":20886628,"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":[],"created_at":"2024-12-17T07:29:20.834Z","updated_at":"2025-04-04T04:20:46.951Z","avatar_url":"https://github.com/folio-org.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"This is the source for \"FOLIO Developers\" at [dev.folio.org](https://dev.folio.org/)\n\nTo contribute changes, please refer to FAQs regarding [Developer documentation](https://dev.folio.org/faqs/#developer-documentation).\n\n## Software requirements\n\nLocal development requires\n[Ruby](https://www.ruby-lang.org/) and [Bundler](https://bundler.io/).\nThe 'bundle install' step will install the relevant local\n[Jekyll](https://jekyllrb.com/).\n\nFor Ruby, using [rbenv](https://github.com/rbenv/rbenv) and its 'ruby-build'\nplugin ensures a smooth process. In this directory, set the ruby version\nwith: `rbenv local 3.2.7`\n\nThen do:\n\n```\nbundle config set --local path 'vendor/bundle'\nbundle install\n```\n\nOccasionally a site maintainer will have updated dependencies,\nand there will be changes to the `Gemfile.lock` file.\nDo `bundle install` again.\n\n## Docker\n\nInstead of installing the requirements you may run\n```\ndocker-compose up\n```\nto use the [Jekyll Docker image](https://github.com/envygeeks/jekyll-docker).\n\nOur Gemfile defines the version of Jekyll that we use.\n\n## Local development\n\nTo view and edit documents on your local machine, run the local Jekyll server:\n\n```\nbundle exec jekyll serve --port 5000\n```\n\nThen visit `localhost:5000` with the browser, and proceed to the page of interest.\n\nEdit the relevant Markdown source document, and save it.\nThe server will automatically re-generate that particular page.\nNow refresh the web browser to view its changes.\n\nWhen finally ready with your set of changes, commit and push the branch to GitHub.\nSee [deployment](#deployment) notes below.\n\n## Link checker\n\nTo verify internal and external links, do:\n\n```\nrake proof\n```\n\nor\n\n```\nbin/htmlproofer.sh\n```\n\nThis will re-generate the whole site, then report any broken links.\n\nNote that verification of GitHub links is disabled.\n\n## Work area - management of dev site\n\nSee [notes](work/README.md) about the operation and management.\n\n## Deployment\n\nThe master branch is automatically deployed as [dev.folio.org](https://dev.folio.org/)\n\nIf needed then other branches can be built by running the GitHub Jekyll Workflow against the new branch.\nThis will build but not deploy.\n\n## Additional information\n\nRefer to FAQs regarding [Developer documentation](https://dev.folio.org/faqs/#developer-documentation) and [Raising Jira tickets](https://dev.folio.org/faqs/how-to-contribute-devdoc/#raising-jira-tickets).\n\nThe FOLIO [Slack](https://dev.folio.org/guidelines/which-forum/#slack) channel #dev-website\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffolio-org%2Ffolio-org.github.io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffolio-org%2Ffolio-org.github.io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffolio-org%2Ffolio-org.github.io/lists"}