Background knowledge

High-level primer of the tech used in the template (optional reading)

Last updated 2 years ago

Background knowledge

High-level primer of the tech used in the template (optional reading)

Here are some very basic explanations of terminology and technologies used in this template to help you interpret the rest of the documentation.

A repository (or repo for short) is a place to store code and other content for a project.
is a way of tracking and making changes to code and other content in repos, typically using a .
is an online place to store, view, track, share, and collaborate on code and other content in repos based around Git. You can make simple changes to your code on the GitHub website itself, but for other changes you'll need to use directly. that explains the basics of how Git and GitHub are typically used together to effectively develop projects.
(or gh-pages for short) is a service built-in to GitHub that can host a website for you, for free. No need to buy monthly hosting from GoDaddy! Put the source code for your website in a repo, turn on GitHub Pages, and the site will go live. Any changes you make to the code will update on the site automatically.
(or gh-actions for short) is a feature of GitHub that can (among other things) automatically run scripts and other actions when changes are made to a repo. Setting up GitHub Actions is only needed for certain specific tasks that aren't handled automatically by Jekyll or other parts of the template.
is a format for writing large structured sets/lists of data. The template uses this format as an easy way to input papers and resources for your site.
is how you write the main content of a web page. It tells the browser what to show, like paragraphs of text, tables of numbers, images with captions, etc.
is a easier way to write certain . But browsers can't display markdown directly; it has to be converted to HTML first.
is a tool that can automatically generate large HTML sites from much simpler markdown, and with less grunt work and code duplication, allowing you to just focus on the content. It does all this fancy work in a "pre-process" step. When you make a change, Jekyll compiles everything together into the final product which can then be viewed or uploaded. Jekyll is the main tool that makes this template possible.
is a built-in to Jekyll that allows you to insert repetitive chunks of content automatically and define logic for how your site is built by Jekyll. For example, you could provide Jekyll with a simple list of items, then use Liquid to sort them and put each one in their own formatted table row.
(a superset of ) is how you get a web page to look the way you want. You can set , and apply them to certain elements (tables, images, etc.) in the HTML with . You only need to know this if you want to significantly change the way the template looks.
is a general-purpose programming language. You only need to know this if you want to modify the behavior of the .
(or js for short) is a programming language to make web pages more interactive. HTML is static/unchanging, but JavaScript allows the page to change dynamically as the user is viewing it. For example, JavaScript can be used to hide/show certain paragraphs in the HTML based on what the user types into a search box. You only need to know this if you want to modify the behavior of the template's interactive features.
is a general-purpose programming language. You don't need to know Ruby to use this template, but you'll encounter a few in the template, because Jekyll is written in Ruby.

Remember: A website ultimately consists of only three things: HTML, CSS, and JavaScript (and any asset files like images/videos/etc). These are the only things a browser can understand and execute, and they are what gets uploaded to publish your site. Any other technology is just an intermediate step to get to a final, "compiled" website consisting of just these three things.

PreviousCustom components

Last updated 2 years ago

Here are some very basic explanations of terminology and technologies used in this template to help you interpret the rest of the documentation.

A repository (or repo for short) is a place to store code and other content for a project.
is a way of tracking and making changes to code and other content in repos, typically using a .
is an online place to store, view, track, share, and collaborate on code and other content in repos based around Git. You can make simple changes to your code on the GitHub website itself, but for other changes you'll need to use directly. that explains the basics of how Git and GitHub are typically used together to effectively develop projects.
(or gh-pages for short) is a service built-in to GitHub that can host a website for you, for free. No need to buy monthly hosting from GoDaddy! Put the source code for your website in a repo, turn on GitHub Pages, and the site will go live. Any changes you make to the code will update on the site automatically.
(or gh-actions for short) is a feature of GitHub that can (among other things) automatically run scripts and other actions when changes are made to a repo. Setting up GitHub Actions is only needed for certain specific tasks that aren't handled automatically by Jekyll or other parts of the template.
is a format for writing large structured sets/lists of data. The template uses this format as an easy way to input papers and resources for your site.
is how you write the main content of a web page. It tells the browser what to show, like paragraphs of text, tables of numbers, images with captions, etc.
is a easier way to write certain . But browsers can't display markdown directly; it has to be converted to HTML first.
is a tool that can automatically generate large HTML sites from much simpler markdown, and with less grunt work and code duplication, allowing you to just focus on the content. It does all this fancy work in a "pre-process" step. When you make a change, Jekyll compiles everything together into the final product which can then be viewed or uploaded. Jekyll is the main tool that makes this template possible.
is a built-in to Jekyll that allows you to insert repetitive chunks of content automatically and define logic for how your site is built by Jekyll. For example, you could provide Jekyll with a simple list of items, then use Liquid to sort them and put each one in their own formatted table row.
(a superset of ) is how you get a web page to look the way you want. You can set , and apply them to certain elements (tables, images, etc.) in the HTML with . You only need to know this if you want to significantly change the way the template looks.
is a general-purpose programming language. You only need to know this if you want to modify the behavior of the .
(or js for short) is a programming language to make web pages more interactive. HTML is static/unchanging, but JavaScript allows the page to change dynamically as the user is viewing it. For example, JavaScript can be used to hide/show certain paragraphs in the HTML based on what the user types into a search box. You only need to know this if you want to modify the behavior of the template's interactive features.
is a general-purpose programming language. You don't need to know Ruby to use this template, but you'll encounter a few in the template, because Jekyll is written in Ruby.