New website (work in progress) for the Consortium for the Advancement of Scientific Software (CASS)
This website uses Jekyll and the Minimal Mistakes theme and is hosted on GitHub Pages with a custom domain at https://cass.community.
If you're familiar with Jekyll and the GitHub pull request process, feel free to propose your own changes in the form of a pull request. (Please test your changes with a local Jekyll installation before submitting the pull request.) Otherwise, you're probably best off submitting an issue to the GitHub repository, or reaching out to the point of contact to discuss your needs.
- (Page) Titles should be in title case
- All other headings should be in sentence case
A number of files in the _data/ directory contain key information used throughout the site.
This file contains information about CASS as an organization, include the list of members (with key details), the steering committee members, and the officers. The list of members is keyed to the short_name of the organizations, with the usual capitalization.
This file contains the "areas" used in the software catalog. The list is keyed to the locally-defined short_name for each area (short and all lowercase). The list maps the short_names to a consistent set of human-friendly names, as used in the ECP ST area, as well as terse descriptions.
Multiple short_names may map to the same name. For example "datavis" and "dataviz". This is mostly a convenience for contributors. It does complicate the processing that needs to be done to render the information well.
All occurrences of the same name should be accompanied by the same description text. No guarantees as to which instance will be used.
When rendering the site, use _include/sw-areas-lookup to access the site.data.sw-areas structure systematically. The function takes a specification of the input key, the values to lookup, and the key to output the corresponding values from. Any of the keys in the structure can be used as inputs or outputs (currently short_name, name, and description). Note that because of limitations of Jekyll and Liquid, the result returned is not an array, but a text string which must be converted into an array. The general use case looks like this:
{% capture a %}{% include sw-areas-lookup values=values input="name" output="short_name" sep="|" %}{% endcapture %}
{% assign a = a | strip_newlines | split: "|" %}
If there is no mapping for the given area, it should be rendered as given, in red font to call out that there's a problem.
The _sw collection is presented on the /software/ page, with individual pages in the /sw/ directory. Documentation for contributions to this collection can be found in the _sw/README.md and _sw/PRODUCT_TEMPLATE.md files.
David Bernholdt (@bernhold) is the primary point of contact for the https://cass.community website.