Skip to main content

How this site is organized

There are 2 parts to our site:

  1. The Home Page
  2. All the other stuff (Guides, etc)

Home Page

The index.html and app.css files at the root of our git repository are displayed in your browser when you browse to https://fahrenheitrobotics.org

You can change these files by simply opening them in an editor (such as VS Code). See this page for more details on how to edit the site.

It is also possible to add more html pages as needed and either link to them from index.html, or create subfolders that will appear as paths in our url.

However, everytime you want to create a new html page, you will need to copy the existing index.html. Let's say for example that we were to create two more html files, one named sponsors.html that would display all of our sponsors, and a second named calendar.html to show our team calendar.

That could work fine. But, then imagine we want to update the links displayed across the top of our website. We would need to edit all 3 html files (index.html, sponsors.html, and calendar.html) to add a new link. You can see how this will become tedious!

So, we're using a project call Docusaurs to help us manage the other parts of the site.

Guides

The Guides section of our site is built using Docusaurs which is a content management system and a static site generator.

A content management system is a fancy term to describe software that helps you write and manage blog posts, guides, tutorials, images, and other "content".

A static site generator is software that is capable of taking files such as markdown and compile them into html, css, and javascript which can then be served to browsers.

So, all the files found inside the site directory are part of Docusaurs.

We will be able to use Docusaurus to easily publish blog posts and guides.