www.de-rse.org hosting repository
This repository contains the source files for the de-RSE website. Its official hosting URL is https://www.de-rse.org.
The site is made to be built with Jekyll >= 3.4.1.
You can use RVM to install and use a suitable Ruby version, e.g., rvm use 2.7
.
To build, run bundle install
once (or skip that if you have dependencies already installed and bundler does not work for you) and then bundle exec jekyll build
.
To preview locally, run bundle exec jekyll serve --incremental
and browse to http://localhost:4000.
The --incremental
flag helps speeding up the previews.
To include drafts and future blog posts in the preview add the --drafts
and --future
flags.
To see where exactly something breaks or takes long, add the --verbose
flag.
For all flags use the --help
flag.
To contribute, please fork, change, test locally (see above) and create a pull request against master
.
You can use rake to comfortably create content.
To create content, run one of the following commands from the repository root. Rakefile
has been created by Ellen Gummesson and is hosted at https://github.com/gummesson/jekyll-rake-boilerplate.
rake post["Title"]
creates a new blog post in _posts
.
rake draft["Title"]
creates a new blog post draft in _drafts
rake publish
publishes blog post drafts from _drafts
to _posts
(interactive CLI-based picking of drafts to publish).
rake page["Title"]
creates a new page (in the root folder).
rake page["Title","Path/to/folder"]
creates a new page in the respective folder. E.g., to add a page to the English version of the site, use rake["Title","en"]
.
The repository contains minimal templates for pages and posts, _page.txt
and _post.txt
.
These are used when creating content with rake
and include the minimal YAML headers needed for the content to show properly.
---
title:
layout: default
weight:
---
Pages always have the default
layout. They must also have a (short) title
(in double quotes preferably, so it doesn't mess with the YAML), which will be used for the main menu as item texts. weight
determines the position of the respective menu item in the menu (ascending order).
---
title:
layout: post
author:
menulang: en
---
Blog posts will be displayed ordered by publication date on blog.html
. They always have a post
layout and must have a title
and an author
, both of which will be displayed on the blog index and the post page itself. Publication date is automatically added via rake publish
. Do not start blog posts with headers (#
), as the title will be displayed as header.
menulang
determines the language of the main menu as displayed on the post page (default: en
). The language menu items ("Deutsch", "English") link back to the blog index page in the respective language.
You can also redirect pages to another URL by using the layout: redirect
and defining a page to redirect to using a meta refresh.
---
title:
layout: redirect
redirect_page_to: https://xkcd.com
---
For help on syntax have a look at:
The map is fed by mapdata.js. Adding someone to the map is as simple as adding a new section in this geoJSON file. Coordinates are available from http://geojson.io/ . Right now pictures should be 75px high. Inspiration for a nice testimonial can be found at Stephan Druskat's entry.
The map appeared on Dec 6th 2017 on the website. It's based on leaflet v1.2 and Leaflet.markercluster
Events are included per year from https://github.com/DE-RSE/de-rse.github.io/tree/master/_includes/events. No language specific remarks in favor of maintainability.
Direct sign up domain list from https://de-rse.slack.com/admin/settings#signup_mode. Domains get added as people request invites.
echo "mpi-cbg.de,mpg.de,tu-dresden.de,crt-dresden.de,hu-berlin.de,tib.eu,dlr.de,gfz-potsdam.de,fmp-berlin.de,rfii.de,uni-goettingen.de,gcdh.de,uni-bielefeld.de,uni-bonn.de,dfg.de,awi.de,geomar.de,uni-muenster.de,helmholtz-hzi.de,tu-berlin.de,pik-potsdam.de,leibniz-fli.de,uni-wuerzburg.de,helmholtz.de,uni-konstanz.de,ac.uk,tu-braunschweig.de,sub.uni-goettingen.de,gwdg.de,fu-berlin.de,hzdr.de" | tr "," "\n" | sort | awk '{print "<li>"$1"</li>" ;}'