This folder contains the source used to generate a static site using Nikola.
Installation and documentation at https://getnikola.com/
Configuration file for the site is conf.py
.
To build the site::
nikola build
To see it::
nikola serve -b
To check all available commands::
nikola help
There are three branches: master
, run
and gh-pages
.
master
includes only commits made by people and not automatically.run
runs on Travis and updates the posts and everythinggh-pages
is the built version of the page, also done automatically.
We could keep master
and run
in the same branch but this makes it easier to
search the commits that we care about.
-
Update
gsoc_times.yml
fromrun
intomaster
git restore --source run gsoc_times.yml
This brings the latest updates to
gsoc_times.yml
. -
Add properties on
gsoc.yml
and ongsoc_times.yml
for new students. For names we are using their github handles.gsocYYYY: gh_student_a: rss_feed: " rss_fed: "rss-url" # TODO (add blog with gsoc tag) project: 'suborg' # TODO (add project as named on ..)
Then, once completed that file you can run this snippet to fill
gsoc_times.yml
year=$(date +"%Y") lastyear=$(( ${year} - 1)) sed -n "/^gsoc${year}/,/gsoc${lastyear}/p" gsoc.yml | grep "^ [[:alpha:]].*:$" | sed 's/^[ ]*//' | sed "s/$/ ${year}-05-01 00:00:00/g" >> gsoc_times.yml LC_COLLATE=C sort -o gsoc_times.yml gsoc_times.yml # So it sorts as python does, first upper case, then lower
-
Create a PR and ask students to PR to that filling it in. As in: 2018
-
copy the new config file into the
run
branch, for example with:git rebase --onto run <x> <z>
where
<x>
is the commit before than<y>
which is the one we want to copy (up to included) torun
. Then push it and all should work.