/pfocr-database

Jekyll setup and database for the Pathway Figure OCR project

Primary LanguageHTMLCreative Commons Zero v1.0 UniversalCC0-1.0

pfocr-database

Jekyll Site and database for the Pathway Figure OCR project

Visit site at: https://pfocr.wikipathways.org/

Content

Pathway figure content can be added as .md files to the _figures 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.

Updates

The site is too big to be build by GH Pages, so it is built locally and _site is pushed to the gh-pages branch. The _site dir is otherwise ignored by the main branch.

Development

In order to rebuild the site locally you'll need to:

  1. clone the repo
  2. 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.
  • E.g., MacOS: brew install ruby@2.7 and echo 'export PATH="/opt/homebrew/opt/ruby@2.7/bin:$PATH"' >> ~/.zshrc and gem install jekyll -v 3.9.3
  1. run bundle install
  2. run bundle exec jekyll serve <-- run this each time you want to restart the local server
  3. goto http://127.0.0.1:4000
  4. run bundle exec jekyll build <-- run this to generate _site files without localhost URLs