Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add README.md text to help others host index meta-databases #18

Merged
merged 7 commits into from
Dec 21, 2020
Merged
26 changes: 26 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,3 +35,29 @@ The repository is organized this way:

Presently, only the `v1` version of the formats exist.
Hence, to update the list of providers, file a pull-request against the repository to edit `/src/links/v1/providers.json`.

## Fork this repository to set up an index meta-database for your own databases

- Click on the Fork button in GitHub and follow the instructions.

- Edit `/src/info/v1/info.json` with your information:

- Make sure to update the URL in `available_api_versions` to point at your hosting location.

- Copy the file `src/index-metadbs/exmpl/v1/links.json` to `/src/info/v1/links.json` and edit this template to supply information about your own databases.

- Edit `README.md` to say who you are and what databases you provide.

- Remove the directory 'src/static-index-metadbs'

- Configure your hosting provider to use your forked repository.
The repository presently contains configuration files for Netlify, which you can set up as follows:

- Deploy using the Netlify *Continuous Deployment: GitHub App* option, and give it access to your forked repository with the following settings:

- Build commmand: `jekyll build`
- Publish directory: `_site/`
CasperWA marked this conversation as resolved.
Show resolved Hide resolved

- You are also recommended to configure a subdomain in *Domain settings* at Netlify, or setup your own custom domain.

- If you are a provider of OPTIMADE databases and you have set up the index meta-database to point at them, please post a pull-request against [https://github.com/Materials-Consortia/providers](https://github.com/Materials-Consortia/providers) to add the URL for your index meta-database to the central OPTIMADE providers list.