{"id":22052698,"url":"https://github.com/digitalnz/supplejack_website","last_synced_at":"2025-05-11T08:39:30.807Z","repository":{"id":3685414,"uuid":"21408136","full_name":"DigitalNZ/supplejack_website","owner":"DigitalNZ","description":"This website demo is part of the standard Supplejack platform that can aggregate data and content from many different sources.","archived":false,"fork":false,"pushed_at":"2023-03-08T19:41:40.000Z","size":7678,"stargazers_count":2,"open_issues_count":17,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-05-11T08:39:27.217Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/DigitalNZ.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}},"created_at":"2014-07-02T01:53:48.000Z","updated_at":"2021-11-03T20:58:00.000Z","dependencies_parsed_at":"2023-07-09T07:16:29.735Z","dependency_job_id":null,"html_url":"https://github.com/DigitalNZ/supplejack_website","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalNZ%2Fsupplejack_website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalNZ%2Fsupplejack_website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalNZ%2Fsupplejack_website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalNZ%2Fsupplejack_website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DigitalNZ","download_url":"https://codeload.github.com/DigitalNZ/supplejack_website/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253540674,"owners_count":21924523,"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-11-30T15:13:59.888Z","updated_at":"2025-05-11T08:39:30.785Z","avatar_url":"https://github.com/DigitalNZ.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"Supplejack Website\n==================\n\nThis website demo is part of the standard Supplejack platform that can aggregate data and content from many different sources.\n\nIt uses the `supplejack_client` gem to connect to the Supplejack API. For more information about Supplejack Client gem, please refer to the [documentation](http://digitalnz.github.io/supplejack/start/supplejack-client.html).\n\n:warning: **It is very important that you have setup an API instance with correct record schema before setting up this project (or any projects that interact with the API). The most important component of the API is record schema. Refer to [API docs](http://digitalnz.github.io/supplejack/api/creating-schemas.html) for instruction.**\n\nInstallation\n------------\n\n- Start API server on port 3001: `rails s -p 3001`\n- Clone the demo website project: `git clone git@github.com:DigitalNZ/supplejack_website`\n- Copy the configuration file: `cp config/application.example.yml config/application.yml`\n- Customize its values, to generate api key, please refer to [API Docs](http://digitalnz.github.io/supplejack/start/supplejack-api.html)\n- Run `bundle install`\n- Run the server `rails s`\n\n**WARNING** This demo website has been configured to work with sample record schema that comes with the supplejack api. It should work fine without any modification. If you want customization, please refer to the **Configuration** section to know how to do.\n\nConfiguration\n-------------\n\nTo interact with the supplejack_api, you need to configure `supplejack_client.rb` file.\n\nOpen `config/initializers/supplejack_client.rb`\n\nYou **must** update these options for customization:\n\n* **facets**: List of available facets from the api that you want to be show in the website. They must be defined in record schema. Refer to [API docs](http://digitalnz.github.io/supplejack/api/creating-schemas.html) to understand how facet is defined.\n* **fields**: List of fields that you want to be requested to the API for every record. They must be defined in record schema. You can also include group in the list.\nPlease refer to [API docs](http://digitalnz.github.io/supplejack/api/creating-schemas.html) to know how to define group.\n* **search_attributes**: List of fields to be sent to search object. These fields must be defined in record schema.\n* **enable_debugging**: Turn on full logging, default to true.\n* **enable_caching**: Enable caching long api request, default to false.\n\nOther commented fields can be left with their default values.\n\nNotes\n-----\n\nYou need to set up thumbnailer server for image processing(`thumbnail_server_url` setting in `config/application.yml` file). Check out [Magickly](https://github.com/afeld/magickly) on how to set up an image manipulation service.\n\nFor the purpose of demo, you can use the existing [Magickly](http://magickly.afeld.me/) instance.\n\nCOPYRIGHT AND LICENSING\n-----------------------\n\n### MAJORITY OF SUPPLEJACK CODE - GNU GENERAL PUBLIC LICENCE, VERSION 3\n\nSupplejack is a tool for aggregating, searching and sharing metadata records. Supplejack Website is a component of Supplejack. Except as indicated below, the Supplejack Website code at https://github.com/DigitalNZ/supplejack_website is Crown copyright (C) 2014, New Zealand Government. Supplejack was created by DigitalNZ at the National Library of NZ and the Department of Internal Affairs. http://digitalnz.org/supplejack\n\nExcept as indicated below, this program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY\nWARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses / http://www.gnu.org/licenses/gpl-3.0.txt\n\n#### MASONRY\nThe JavaScript grid layout library by David DeSandro (see http://masonry.desandro.com/#mit-license) is licensed under the MIT license (see http://desandro.mit-license.org)\n\n#### INFINITE SCROLL\nThe jQuery plugin for infinite scrolling by Paul Irish (see https://github.com/paulirish/infinite-scroll) is licensed under the MIT license (see https://github.com/paulirish/infinite-scroll#license)\n\n#### NORMALIZE.CSS\nThe customizable CSS file, that makes browsers render all elements more consistently, by Nicolas Gallagher and Jonathan Neal (see https://github.com/necolas/normalize.css) is licensed under terms at https://github.com/necolas/normalize.css/blob/master/LICENSE.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalnz%2Fsupplejack_website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalnz%2Fsupplejack_website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalnz%2Fsupplejack_website/lists"}