📘
Lab Website Template docs
  • Introduction
    • Overview
    • Is this right for me?
    • Gallery
    • Support
  • Getting Started
    • Set up your site
    • Set up your URL
    • Tidy up your repo
    • Change your site
    • Preview your site
  • Basics
    • Repo structure
    • Configure your site
    • Edit pages
    • Write basic content
    • Use your logo
    • Customize your theme
    • Team members
    • Blog posts
    • Citations
    • Components
      • Section
      • Figure
      • Button
      • Icon
      • Feature
      • List
      • Citation
      • Card
      • Portrait
      • Post Excerpt
      • Alert
      • Tags
      • Float
      • Grid
      • Cols
      • Search
      • Site Search
  • Advanced
    • Update your template
    • Embeds
    • Math, diagrams, videos, etc.
    • Analytics
    • Data and collections
    • Jekyll plugins
    • Custom components
    • Background knowledge
Powered by GitBook
On this page
  1. Basics

Configure your site

The basic settings and configuration for your site reside in the _config.yaml file.

Example:

### basic settings

# site properties and page defaults
title: Lab Website Template
subtitle: A template by the Greene Lab
description: An easy-to-use, flexible website template for labs, with automatic citations, GitHub tag imports, pre-built components, and more.
logo-text: false
header: images/background.jpg
footer: images/background.jpg
header-dark: false
footer-dark: false
proofer: false

# site social media and other links
links:
  email: jane.smith@your-lab.com
  orcid: 0000-0001-8713-9213
  google-scholar: ETJoidYAAAAJ
  github: your-lab
  twitter: YourLabHandle
  instagram: YourLabHandle
  youtube: YourLabChannel

### Jekyll settings to ignore
...
Parameter
Description
Default

title

Tip: If your lab name is long, use an abbreviated version here, then display the full name at the top of your homepage.

subtitle

Appears in the header next to your site title, smaller and more subtle. Useful for slogans or affiliations.

description

show-title / show-subtitle

Whether to show your site title/subtitle next to your logo in the header. Set to false if your logo image already contains text that you don't want to be displayed twice. This does not remove your site title from the tab name, metadata, or anything else.

true

header / footer

Solid color background

header-dark / footer-dark

true

links

Social media links for your lab to show in the footer of every page, without any prefixes like @, www., etc. See /_data/types.yaml for what types of links are built-in or to add your own.

proofer

It is disabled by default because it can add quite a bit of time to updating/building your remote or local previews.

false

Headers/footers/sections have a solid color that overlays any background image to always maintain readability of text.

PreviousRepo structureNextEdit pages

Last updated 1 year ago

Title of your site. Appears in the tab title, in the header, and in . Use a short version of your lab's name if you have one so it can fit nicely in these spots. Aim for less than 20 characters.

Default description that will show under search engine results. Can be overridden on .

Default background image for the header/footer. Can be overridden on .

Default header/footer dark/light mode. Can be overridden on .

Whether to use to check your site for broken links, images, and more.

If broken items are found, a warning is shown in your or your . It is not a critical error that will prevent your site from building, because it is not perfect: there can be false positives/negatives.

page metadata
individual pages
individual pages
individual pages
html-proofer
Actions workflow logs
console