All pages are written in markdown for easy editing, and Jekyll uses Liquid for the data-driven pages. The publication list, news items, and group members are stored as
.yml data sheets (plain text) in the
_data folder, so that one can update the website easily. The pages are in the
_pages folder. Updating and maintaining is easy using Github (not wordpress-easy, but there are other advantages (see e.g. this, or this). Jekyll takes all the markdown and data files, and creates beautiful
html files in the
Create and open a github account, go to AllanLab’s repository, and click ‘fork’. This is now your copy of the website, and you can change and adapt it as you want. You don’t have to link to us or mention us (but of course we appreciate it). Then change the name of the repository to “your_username” and the name of the branch to “gh-pages”. Your website is now automatically published under your_username.github.io/your_username/. Except that it probably still looks like our website.
To modify the webpage, you can either do everything on on github.com (go to a file, click “edit”, then “commit”, “push”), or install Jekyll on your computer and play with your local copy that you sync with the branch on github.com. The former is much easier in the beginning, but a bit less convenient once you start rewriting everythint. To get it to work on your computer (and to learn a bit more about Jekyll), here and here are tutorials on how to use it and how set it up locally. Also, consider using the Github desktop app, I found it helpful.
Now let’s make this your website.
First, go to the
team.yml files in the
_data folder and insert your own data into the data fields. Watch out: Jekyll is quite strict about extra or missing spaces etc. Adhere to the format. In the beginning, test each change: commit, push, and check the published website.
For publications, you can add a “1” in the highlight field, then it will be featured prominently. You can add important news items (red, “news1”), and less important news items (blue, “news2”).
For the news items, just keep adding them. The first 10 will be displayed on the ‘home’ page.
Next, change the content of all files in the
_pages folder. To change the title in the homepage, go to
homelay.html in the
Lastly, change the footer and perhaps header appropriately (in
You might also want to change the style or theme. I imported style files (in sass) from Bootstrap/Bootwatch, you can replace them with your own (in the
_sass directory). For small changes, just work on the override stuff in the
main.sass file in the
CSS folder. Or change some variables in the
_variables.sass file, like the background color etc.
As said, Jekyll takes all the markdown and data files, and creates beautiful
html files in the
_site folder. In the end, either upload these files to your server, or buy yourself a domain and check the instructions on github on how to host it there.
You can use this template as you please. You don’t have to link to us or mention us (but of course we appreciate it). We also welcome it if you send us an email with a link to your website, perhaps we’ll publish a list here at some point.
Code released under the MIT License.