Skip to content

UCL/accord

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

94 Commits
 
 
 
 
 
 

Repository files navigation

ACCoRD – A Community for Contract Regulation for Data

ACCoRD public repository for the GitHub pages.

⚠️ Please do not include any private or sensitive data here – this is a public-facing repository.

ACCoRD aims to address barriers in data access and contracting that delay or block research using the UK's federated Digital Research Infrastructure (DRI). Data contracts are often complex, bespoke, and inconsistent, causing delays of up to 9 months and making data sharing costly and inefficient.

For ACCoRD project management, a private repository, please go to: accord_project_management


Team


Local Setup

Previewing the GitHub Pages site with Jekyll

It's often useful to test the GitHub Pages site locally before pushing changes. This lets you check that pages render correctly, links work, and styles look as expected without having to commit and wait for GitHub Pages to rebuild.

Prerequisites

You need Ruby, Bundler, and Jekyll installed. See the GitHub guide on testing a Jekyll site locally for full details.

Ruby version: Jekyll requires Ruby 3.1 or higher. We recommend managing Ruby versions with rbenv or asdf rather than using your system Ruby. You can check your version with:

ruby -v

macOS users: do not use the system Ruby (/usr/bin/ruby) — you will hit permission errors. Install Ruby via rbenv or Homebrew first.

Windows users: native Jekyll support on Windows is unreliable. We recommend using WSL2 and following the Linux instructions within it.


Steps

  1. Change into the docs directory (where the site lives):
cd docs
  1. Install dependencies (only needed the first time, or after Gemfile changes):
bundle install
  1. Serve the site locally:
bundle exec jekyll serve
  1. Open your browser at:
http://127.0.0.1:4000/accord/

Note: the site is served at /accord/ (not just /) because of the baseurl setting in _config.yml. Going to http://127.0.0.1:4000 will show a 404 — this is expected.


Troubleshooting

  • Changes not appearing? Jekyll live-reloads content changes automatically, but changes to _config.yml or page front matter require a full restart (Ctrl+C, then bundle exec jekyll serve again).
  • Port already in use? Run bundle exec jekyll serve --port 4001 to use a different port.
  • Gem errors? Try bundle update to refresh dependencies, then serve again.

About

ACCoRD public repository for the GitHub pages

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors