Jekyll-powered GitHub Pages for wikipathways-database repo contents
Visit site at: https://www.wikipathways.org/
The issue tracker here should only be used by the dev team for website-specific bugs and features. All user issues should go to wikipathways-help for triage.
Pathway content can be added as .md files to the _pathways directory. The top portion of the .md file is the Jekyll Front Matter, which defines metadata used to generate the site, organize content and generate search metadata optimized for search engines.
In order to rebuild the site locally, e.g. for testing, you'll need to:
- clone the repo
- install Ruby, Jekyll and Bundler (guide)
- Try to match these versions where possible in order to get the same behavior locally as via GitHub. Pay attention to Jekyll and Ruby versions in particular.
- run
bundle install - run
bundle exec jekyll serve<-- run this each time you want to restart the local server - goto http://127.0.0.1:4000
We rely on GiHut Pages to build and deploy the Jekyll site. This means that the versions of Jekyll and related dependencies are automatically updated by GitHub. Developers just need to keep their local setups up-to-date with whatever GitHub is running so that our local testing accurately reflects the live site.
- Update local Jekyll dependencies:
bundle update github-pages