{"id":18517741,"url":"https://github.com/projectblacklight/arclight","last_synced_at":"2025-04-13T05:08:22.425Z","repository":{"id":38815311,"uuid":"87578306","full_name":"projectblacklight/arclight","owner":"projectblacklight","description":"A Rails engine supporting discovery of archival material","archived":false,"fork":false,"pushed_at":"2025-03-26T00:35:46.000Z","size":2476,"stargazers_count":41,"open_issues_count":155,"forks_count":28,"subscribers_count":31,"default_branch":"main","last_synced_at":"2025-04-13T05:08:15.165Z","etag":null,"topics":["archival-description","archival-materials","blacklight","discovery","ead","gem","ruby","solr"],"latest_commit_sha":null,"homepage":"https://samvera.atlassian.net/wiki/spaces/samvera/pages/405211890/ArcLight","language":"Ruby","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/projectblacklight.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","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":"2017-04-07T19:05:25.000Z","updated_at":"2025-03-26T00:35:49.000Z","dependencies_parsed_at":"2024-05-10T18:37:54.379Z","dependency_job_id":"25a89a5b-3bd8-4d4a-9841-58373b3049d2","html_url":"https://github.com/projectblacklight/arclight","commit_stats":{"total_commits":1179,"total_committers":35,"mean_commits":33.68571428571428,"dds":0.8193384223918575,"last_synced_commit":"a8dc92f7b0c852bdef7f5ab838c97aec6c75c1bc"},"previous_names":["sul-dlss/arclight"],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectblacklight%2Farclight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectblacklight%2Farclight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectblacklight%2Farclight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectblacklight%2Farclight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/projectblacklight","download_url":"https://codeload.github.com/projectblacklight/arclight/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248665747,"owners_count":21142123,"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":["archival-description","archival-materials","blacklight","discovery","ead","gem","ruby","solr"],"created_at":"2024-11-06T17:08:20.731Z","updated_at":"2025-04-13T05:08:22.401Z","avatar_url":"https://github.com/projectblacklight.png","language":"Ruby","readme":"[![Gem Version](https://badge.fury.io/rb/arclight.svg)](https://badge.fury.io/rb/arclight)\n[![npm version](https://badge.fury.io/js/arclight.svg)](https://badge.fury.io/js/arclight)\n![Build Status](https://github.com/projectblacklight/arclight/workflows/CI/badge.svg)\n[![All Contributors](https://img.shields.io/badge/all_contributors-17-orange.svg?style=flat-square)](CONTRIBUTORS.md)\n[![Code Climate Test Coverage](https://codeclimate.com/github/projectblacklight/arclight/badges/coverage.svg)](https://codeclimate.com/github/projectblacklight/arclight/coverage)\n\n# ArcLight\n\nA Rails engine supporting discovery of archival materials, based on [Blacklight](https://projectblacklight.org/)\n\n\n## Requirements\n\n* [Ruby](https://www.ruby-lang.org/en/) 3.0.3 or later\n* [Rails](http://rubyonrails.org) 7.1 or later\n* Solr 8.1 or later\n\n## Installation\n\n[Installing ArcLight](https://github.com/projectblacklight/arclight/wiki/Creating,-installing,-and-running-your-ArcLight-application) is straightforward in a Rails environment.\n\nBasically, add this line to your application's `Gemfile`:\n\n```ruby\ngem 'arclight'\n```\n\nAnd then execute:\n\n```sh\n$ bundle\n```\n\nOr install it yourself as:\n\n```sh\n$ gem install arclight\n```\n\nFor further details, see our [Installing ArcLight](https://github.com/projectblacklight/arclight/wiki/Creating,-installing,-and-running-your-ArcLight-application) documentation.\n\n## Usage\n\nArclight is a Ruby gem designed to work with archival data. It can be installed on a server or virtual server. Once running, finding aids in the form of archival collection data can be imported into Arclight through an indexing process. Institutional and repositories data can also be added to Arclight (Currently this requires a developer. Configuration pages will be added for this in future versions). Additional finding aids can be added at any time.\n\nAfter data indexing, Arclight can to be used to search, browse, and display the repositories (sets of collections), collections, and components within collections. Globally available search allows filtering on several types of terms (Keyword, Name, Place, etc.). Once a search is begun, it can be further narrowed using facets on the left side of the search page. Selecting a search result goes directly to that results show or display page. Also global available are buttons for Repositories and Collections which can be used an any time.\n\nBrowsing allows you to view the Overview or Contents (when it exists) of a collection. The Overview tab displays top level metadata about the collection. The Contents tab displays an outline view of a next level of the collection. You can expand each level by selecting (clicking). Selecting a component in the Contents views goes to a component page which shows the metadata for it.\n\nSome pages include an inline view tab to the right of an item which will expand the Contents further.\n\nSee the [ArcLight demo](https://arclight-demo.projectblacklight.org/) and [ArcLight MVP Wiki](https://github.com/projectblacklight/arclight/wiki) for usage.\n\nSee [Arclight Major Features](https://github.com/projectblacklight/arclight/wiki/Arclight-Major-Features) for a list of features.\n\n### Traject indexing of EAD content\n[Traject](https://github.com/traject/traject) is a high performance way of transforming documents for indexing into Solr and how ArcLight does indexing. An EAD2 can be indexed by doing the following:\n\n```sh\nbundle exec traject -u http://127.0.0.1:8983/solr/blacklight-core -i xml -c lib/arclight/traject/ead2_config.rb spec/fixtures/ead/sample/large-components-list.xml\n```\n\nOr\n\n```sh\nbundle exec rake arclight:seed\n```\n\n## Resources\n\n* General\n  * [ArcLight demo site](https://arclight-demo.projectblacklight.org/)\n  * [ArcLight Github wiki](https://github.com/projectblacklight/arclight/wiki): developer/implementor documentation\n  * [Blacklight wiki](https://github.com/projectblacklight/blacklight/wiki)\n  * Use the [ArcLight Google Group](http://groups.google.com/d/forum/arclight-community) to contact us with questions\n* ArcLight MVP:\n  * [MVP sprint demo videos](https://www.youtube.com/playlist?list=PLMdUaIJ0G8QgbuDCUVvFhTSTO96N37lRA)\n\n## Contributors\n\nSee the [CONTRIBUTORS](CONTRIBUTORS.md) file.\n\n## Development\n\n### Branches\n\n* The `main` branch is for new development for the upcoming 2.0.0 release.\n* The `1.x` series is on the [release-1.x](https://github.com/projectblacklight/arclight/tree/release-1.x) branch\n\n### Start Solr\n\nArcLight requires Solr to be running.  For development you can start this using `solr_wrapper` or you may choose to use Docker. Start Solr using Docker by doing `docker compose up`.\n\n### Run the test suite\n\nEnsure Solr and Rails are _not_ running (ports 8983 and 3000 respectively), then:\n\n```sh\n$ bundle exec rake\n```\nIf you find that the tests are failing when you run them on a Linux computer, you might need to install Google Chrome so the Selenium testing framework can run properly.\n\n### Run a development server\n\n```sh\n$ bundle exec rake arclight:server\n```\n\nThen visit http://localhost:3000. It will also start a Solr instance on port 8983.\n\n### Run a console\n\nYou can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\n### Releasing\n\n#### To release a new gem:\n\n1. Update the version number in `lib/arclight/version.rb`\n2. Run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, build the gem file (e.g., `gem build arclight.gemspec`) and push the `.gem` file to [rubygems.org](https://rubygems.org) (e.g., `gem push arclight-x.y.z.gem`).\n\n#### To release the frontend sources:\n\nWhen any of the javascript components or SASS sources in the gem are changed, this package should be published to NPM with the following steps:\n1. [Install npm](https://www.npmjs.com/get-npm)\n2. Bump the version number in `package.json`\n3. run `npm run build \u0026\u0026 npm publish` to push the javascript package to https://npmjs.org/package/arclight\n\n## Contributing\n\n[Bug reports](https://github.com/projectblacklight/arclight/issues) and [pull requests](https://github.com/projectblacklight/arclight/pulls) are welcome on ArcLight -- see [CONTRIBUTING.md](https://github.com/projectblacklight/arclight/blob/main/CONTRIBUTING.md) for details.\n## License\n\nThe gem is available as open source under the terms of the [Apache 2 License](https://opensource.org/licenses/Apache-2.0).\n\nArcLight also uses embedded SVG icons from the [FontAwesome](https://fontawesome.com) project. These icons are unmodified and licensed [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). All of these icons have the license and attribution embedded in them.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectblacklight%2Farclight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprojectblacklight%2Farclight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectblacklight%2Farclight/lists"}