NOTE:

This is not the original MVCS website. It is built using astro, so if you would like to contribute, make sure to reference the documentation below:

Astro docs

• Understand how astro components work in pages
• Understand how astro layouts work with slots

The Metea Valley CSC Website

The website where our club posts all sorts of important recources such as meeting plans and general club information for the world to see.

Contributing

We are always happy for someone to share their ideas for how the website, but we just require 2 things

1. Keep it school appropriate
2. Anything new that is added must pass the build tests before changes can be pushed to cloudflare (WIP)

If you are unfamiliar with version control I suggest you check out how to make a pull request and learn the basics of git. Nequa also has a pretty good guide on their repo.

Setup

GOOGLE IS YOUR FRIEND. If you ever have a question about something, someone online has probally answered it. Look farther than just the first search result.

Make sure that you have npm, git, and Node.js installed, otherwise, you won't be able to run the website or commit changes.

The setup for this project may be changing a lot, so it might be good to check this every so often until we get Cloudflare integration working.

Download the dependencies by running:

npm install

Then to start the express server on port 4321 type of respective commands into the terminal:

Linux

npm run dev

Windows/MacOS

not sure yet but check the astro docs

Now go to http://localhost:4321/ in your favorite web brower to view the website!

Project Structure

── public # this is where non-code is stored
   ├── fonts # want more fonts? put the ttf files here
   ├── images # any and all images go here
   ├── style # add your css files here, the file paths when imported should be "/public/style/your-style.css"
── src                 
   ├── assets           # just some svgs
   ├── components       # want to edit things like the navbar, footer, head and header? check out the components located here
   ├── layouts          # standard formats for pages (astro layouts) are here
   └── pages            # EJS/HTML
       └── markdown     # Site wide resources (ex navbar/footer)

Adding new resources

Calendar

In the root directory there should be a file called dates.json where you can add any new events.

An example for how this should look is:

{
    "date": "2024-09-12",
    "name": "Activity Fair",
    "timeStart": 0,         // Ignore this since its a whole day thing
    "timeEnd": 0            // Also the calendar doesn't support times (yet)
}

Weekly slides

TODO

Leaderboards

TODO