Jekyll content for scala-phase.org, the web site of the Philly Area Scala Enthusiasts (PHASE).
The main content is in index.html. BUT: Do not edit the section
between <!-- @start talks@ --> and <!-- @end talks@ -->. That section
is updated by the build process.
The talks are specified in talks.yml. The talks element is a list
of objects with the following fields:
title(required): The talk titlespeaker(required): The speakerdate(required): The date of the talk, inyyyy-mm-ddformat.meeting_link(optional): The URL of the talk's meeting page.video(optional): URL of the video, if there is one.slides(optional): Contains two sub-fields:link: URL of the presentation, if available.comment(optional): One-line comment about slides (e.g., "PDF", "HTML", etc.)
code(optional): URL of code (e.g., GitHub repo) associated with the talk, if available.
Once you've updated talks.yml, you must rebuild.
Don't edit the assets/css/main.css that was unpacked with the
Pixelarity theme. Instead, override styles by
editing the css/custom.css file.
NOTE: If you'd rather not install all this stuff in your local environment,
you can just install Docker, and then use
this Docker image,
which contains everything you need. Just install the aliases.sh file
in that directory, and replace rake with drake in the instructions below.
To build, you need ruby (2.6) and bundle. Run bundle install,
to get the rest of the required gems. Then, run:
rake build
to build the site with Jekyll. You cannot just run jekyll build, because
the Rakefile contains some preprocessing tasks that must run before jekyll
is invoked.
After building, check in any changed files (such as the index.html file).
Before publishing, verify that everything looks good. Run
rake serve
to build the site and run jekyll in server mode. Then, connect your browser
to http://localhost:4000 and give the site the once-over.
The site is hosted on GitHub Pages. To publish, just push your changes to the GitHub repo (or issue a PR from your fork, and one of the maintainers will do it.)