A Jekyll site that documents the ELIXIR-UK brand, voice and communications strategy – and doubles as an LLM system prompt for on-brand drafting.
- Brand – visual identity: logos, colour, typography, imagery, templates
- Style guide – how we write: voice, conventions, do-and-don't, writing for webstories and social, LLM system prompt
- Communications strategy – OASIS framework: objectives, audiences, strategy, implementation, evaluation, crisis comms
The whole site is markdown. Find the page in pages/, edit the .md file, push to main. The GitHub Actions workflow builds and deploys to GitHub Pages on every push.
- Drop the file in the right
assets/subfolder via a pull request. - Register it in
_data/tool_and_resource_list.ymlwith:id,name,url,description,type,section: [list]. A resource can belong to more than one section. - To show the resource at the bottom of a specific page, add the resource's
idto that page'sresources: [...]frontmatter list. - The resource will also appear automatically on the Templates page under every section in its
section:list – no separate edit needed.
The style guide is authored as plain markdown so it can be consumed two ways:
- Humans read the rendered site at the published URL.
- An LLM consumes the markdown directly – point it at
pages/style-guide/llm-system-prompt.md(or the published version) to get on-brand drafts.
One source, two readers. Update the voice / conventions / examples pages directly; never maintain a separate "prompt document" that drifts from the public guidelines.
This site uses the ELIXIR Toolkit Theme (v6.0.0), shared with RDMkit, WorkflowHub, RO-crate and 20+ other ELIXIR projects. Loaded via remote_theme: in _config.yml.
For local setup, forking and deployment, callouts, sidebars, navigation tiles and other theme features, see the ETT documentation.
Open a pull request or an issue. Small fixes (typos, clarifications) can be merged directly.