CoVprehension

😷 Informative website about the corona virus 🦠

#jekyll #coronavirus #covid-19 #explanation #comprehension #popularizing-science

Want a Jekyll website built?

Hire a Jekyll developer

Demo Download

Informative website about the corona virus.

License · GitHub issues · GitHub contributors
· Discord

This repository holds the Jekyll sources of the CoVprehension website!

CoVprehension is a collective of researchers trying to explain the current epidemic of COVID-19 simply yet with scientific tools.

You can publicly see tracking data here : https://covprehension.goatcounter.com/

How to contribute to the project

I'm a writer / translator

Please go to the _i18n/ sub-folder where everything's is explained ;)

> Click me <

I'm a dev

I want to work on this website

Read the contributing guidelines 👩‍💻

I want to work on a NetLogo simulation

Go on this other repository covprehension/proto

Technical part

Structure of the repository

View contents

$ tree
.
├── assets/
│   ├── lang/
│   |   ├── <translation files for JS simulations>
│   │   └── simu-XX.js -> ../../_i18n/fr/simu-XX.js
│   ├── vendor/ <default resources>
│   └── <custom JS/CSS files>
|
├── _i18n/ <== Folder where website is translated
│   ├── <anyLanguageCode>/
│   │   ├── pages/
│   │   │   ├── about.html
│   │   │   ├── resources.md
│   │   │   └── simulator.md
│   │   ├── _posts/
│   │   │   ├── YYYY-MM-DD-qXX.md
│   │   │   └── <All your questions>
│   │   └── simu-<anyLanguageCode>.js
│   └── <anyLanguageCode>.yml
|
├── img/
│   ├── about/
│   ├── post/
│   └── <website images>
│
├── _includes/
│   └── <Global part of website : Header/Footer/etc>
│
├── _layouts/
│   └── <HTML pages template>
│
├── posts/
│   └── <IGNORE ME, I'm a trap 🙊>
│
├── _pages/
│   └── <Defined layout for translated pages>
│
├── simulations/
│   ├── js/
│   │   └── <JS simulation in sub-dir>
│   └── <Web NetLogo export simulations>
│
├── _config.yml
│
└── <others uninteresting stuff...>

<plenty> directories, <too many> files

Local installation & Setup

First of all, make sure ruby is intalled on your computer.

Clone the repo git clone https://github.com/covprehension/CoVprehension.git
Move in the folder cd CoVprehension
Install plugins: bundle install
Replace the symlink JS translation files by the real ones rm -f assets/lang/*.js && cp _i18n/*/simu-*.js assets/lang/
Build your site: bundle exec jekyll serve
Connect to your running instance http://127.0.0.1:4000/CoVprehension/

Global configuration of the website

All the global configuration of the site can be found in the file _config.yml which is structured as follow :

View contents

General settings
- title Global title
- email Global mail
- description
- url
- baseurl root position of the website in the url variable
  - Don't change me
- include Jekyll collection list
Social Profiles (all optionals)
- twitter_username
- github_username
- facebook_username
- linkedin_username
- rss_link
- google_analytics
Build settings
- markdown MarkDown compiler
- paginate
- paginate_path how to generate pagination url
- plugins list of ruby plugins used in the website
Multi language website => See https://github.com/kurtsson/jekyll-multiple-languages-plugin/#4-configuration
- languages list of enabled languages
- exclude_from_localizations