This project is a website to host resources for this course. It uses VitePress to generate a website from markdown files. As a result, the website is optimized by Vite.
- Install Node which comes with npm (the Node Package Manager).
- Use npm to install YARN.
npm install --global yarn - Install dependencies.
yarn install
To edit the content of the lecture notes, modify the markdown files in docs/lectures.
To update the sidebar navigation for the lecture notes, modify sidebarNotes() in docs/.vitepress/config.js.
Serve the site in the local server using the following command.
yarn docs:devVitePress will start a hot-reloading development server at http://localhost:5173.
To test the production build before pushing, do the following:
-
You may run this command to build the docs:
$ yarn docs:build
The output directory is
docs/.vitepress/dist. -
Once you've built the docs, you can test them locally by running:
$ yarn docs:preview
The
previewcommand will boot up a local static web server that will serve the files from.vitepress/distathttp://localhost:4173. It's an easy way to check if the production build looks fine in your local environment.
The GitHub workflow will automatically deploy the website when the master branch is updated. The website build is in the gh-pages branch.
Visit the deployed site at https://csu-cs.github.io/csci-315/.