Credits: This project is based on the repository provided by the University of Washington. The website of the original creators can be accessed here.
License: This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.
- The website is based on Ruby and Jekyll. Where the content is just text files edited using Markdown language.
- The publications list is generated from the BibTeX file located in
bin/papers.bib
, using jekyll-scholar. - Personnel list. Organize your professors, students, staff, and alumni are modified from
_data/people.yml
. - Combined news stream and blog posts.
- Easily extensible navigation bar.
- Responsive (mobile-ready) design based on Bootstrap.
- Install Ruby v2.6.9 in your computer according to your operating system. For Windows use RubyInstaller
- Then, install Jekyll and bundler through:
gem install jekyll bundler
- Clone the fork to your own machine:
git clone https://github.com/dsv-data-science/dsv-data-science.github.io.git
- Access in the terminal to the folder
cd dsv-data-science.github.io
- Install the rest of the gems using:
bundle install
- Check that you use the
source
branch of the repo while development purposes.master
is used for deployment of the static website and avoid CI/CD in GitHub (which does not support compilation of.bib
).
- Keep adding content. See below for instructions for each of the various sections. Create
_posts
,_projects
, or research areas under_research
- To start your local server to check how it would look like when deployed to the server.
bundle exec jekyll serve
- The terminal will show an IP where the website is hosted. Usually
127.0.0.1:4000
- Finally, the website with the files to be pushed are in the folder
_src
.
Note: Remember to git pull
before start editing and git push
whenever your changes are done.
After testing your local server, any contributor can update the website dsv-data-science.github.io
by running the bash command ./bin/deploy
.
To deploy the website in the DSV server datascience.dsv.su.se
please contact Panos (to request access to the server) or Luis Quintero (he will update the website with changes).
Connection to the server:
HOST: mimas[dot]dsv[d]su[d]se
ssh <HOST>
PATH: /www/datascience
Three ways:
- Git
- If the repository is already cloned, just update changes by:
git fetch
git reset --hard origin/master
- If the repository is already cloned, just update changes by:
- To pull the repository Only the first time: (notice the
.
at the end to avoid creating a new root directory)git clone --single-branch --branch master https://github.com/dsv-data-science/dsv-data-science.github.io.git .
- Modify the projects and research templates with a table of contents on the right side of the page.
Write your information with MarkDown language, images can be added to /img/areas/
and referenced as:
![general]({{ site.base }}/img/areas/file.png){:width="50%"}
While writing your page, you can also use emojis š„½, and text with inline
Your text here... Leave one blank line for LaTeX formulas
$$ \sum_{i=1}^{N}{i} = i \in \mathbb{R}^+ $$
Continue writing here leaving one blank line...
The list of publications is in bib/papers.bib
. These are compiled and grouped per year. If you want to make your publication clickable, add the web URL using the key url = {},
, and to make the paper visible in the page of a specific research area use the key keyword={}
, as follows:
keyword | Area |
---|---|
temporal | Searching and mining temporal data |
healthcare | Learning from ECH |
explainable | Interpretable and Explainable models |
federated | Federated Learning |
vehicles | Integrated Vechicle Management |
nlp | Natural Language Processing |
reinforcement | Reinforcement Learning |
immersive | Behavioral modeling and VR |
Each co-author that is part of the group (edit in _data/people.yml
) will have a link that point to their website (if specified).
For both long-form blog posts and short news updates, we use Jekyll's blogging system. To post a new item of either type, you create a file in the _posts
directory using the naming convention YYYY-MM-DD-title-for-url.md
. The date part of the filename always matters; the title part is currently only used for full blog posts (but is still required for news updates).
The file must begin with YAML front matter. For news updates, use this:
---
layout: post
shortnews: true
---
For full blog posts, use this format:
---
layout: post
title: "Some Great Title Here"
---
And concoct a page title for your post. The body of the post goes after the ---
in either case.
You can also customize the icon that is displayed on the news feed. By default it's newspaper-o
. We use icons from the FontAwesome icon set.
To create a project, just create a markdown file in the _projects
folder. Here are the things you can put in the YAML frontmatter:
title:
The project title.notitle:
Set this totrue
if you don't want a title displayed on the project card. Optional.description:
The text shown in the project card. It supports markdown.people:
The people working on the project. This is a list of keys from the_data/people.yml
file.layout: project
This sets the layout of the actual project page. It should be set toproject
.image:
The URL of an image for the project. This is shown on both the project page and the project card. Optional.last-updated:
Date in the format ofYYYY-MM-DD
. The project cards are sorted by this, most recent first.status: inactive
Set this toinactive
if don't want the project to appear on the front page. Just ignore it otherwise.link:
Set this to an external URL if this project has a page somewhere else on the web. If you don't have alink:
, then the content of this markdown file (below the YAML frontmatter) will be this project's page.no-link: true
Set this if you just don't want a project page for your project.
People are listed in a YAML file in _data/people.yml
. You can list the name, link, bio, and role of each person. Roles (e.g., "Faculty", "Staff", and "Students") are defined in _config.yml
.