To build the website locally, you'll create a conda environment and install the website's bundle within that. Once you have conda installed, and this repo cloned, the commands to run (from within the root directory of this repo) are:
conda env create --file environment.yml
conda activate ofe-website
bundle installFrom there you can launch a local web server with
bundle exec jekyll serveor, if you want to have the website automatically update as you make changes:
bundle exec jekyll serve --watchContents:
- Adding news items
- Adding new team members
- Adding new packages to our projects page
- Tracking upstream changes
News items are stored in the _posts/ directory. Each item is a file. That
file must be named in the format YYYY-MM-DD-TITLE where YYYY-MM-DD gives
the year month and day for the post. With this, it is possible to backdate posts.
The file will is Markdown format with YAML frontmatter. The YAML frontmatter should include the following:
layout: post: News items should use thepostlayout.title: The title of the post.categories: space-separated list of categories. Categories we encourage are names of specific software packages (e.g.,gufe,openfe,lomap) and types of news item (e.g.,releases,presentations,hirings).
Each team member has a file that is just a markdown file with YAML frontmatter. Only the frontmatter is filled in. The frontmatter includes the following fields:
name: Full name as you want it on the websiteposition: Title at OpenFreeEnergyimage_path: URL or path to an image. We frequently use our GitHub avatars (in which case this should be the whole https URI). If using a file, place it in theassets/images/team/directory. In that case, note that theimage_pathshould have a preceding slash (i.e.,/assets/images/team/image.jpg)github: You GitHub usernamescholar[optional]: A link to your Google Scholar profile. Should include everything that comes afterhttps://scholar.google.com/in your profile's URL. Leave this blank if you don't want to include your Google Scholar link.blurb: A brief paragraph describing yourself.
You can copy _team/_defaults.md to get a template. You can see the rendered
versions at https://openfree.energy/team/.
The details for these are in files in _projects/. Make a copy of
_defaults.md. Note that these are markdown files with YAML frontmatter
(although all you do is fill in the YAML). Fill in each of the fields. role
can be one of flagship, developers, maintainers. Within each role,
projects are listed alphabetically by filename.
It turns out this theme is poorly designed for customization. So I'm keeping in here our overrides along with the diff of the original, which will hopefully make future maintenance updates a little easier.
When creating a diff, it should always be
diff installed_file our_file > _file.diff
This way, we can check whether updated versions of the theme made changes to the files that we have changed -- if that diff is exactly the saved diff, then no changes have been made upstream.
You can find the location of the installed file with:
bundle info --path jekyll-theme-hydra
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent