Contributor

Project Setup

If you want to preview the changes locally, you will need to setup the project locally. Adding or editing a new member doesn't require setting up the project locally, simply modify markdown files in content/1.members directory.

You will need to install nodejs and run the project with a package manager. Nodejs comes with npm, you can use it. But I recommend bun as it's much faster.

bun install     # install dependenciesbun dev         # start dev serverbun generate    # generate static files

npm installnpm run devnpm run generate

yarn installyarn devyarn generate

pnpm installpnpm devpnpm generate

Add A New Member

Go to content/1.members directory, based on the member's role, add a new markdown file in the corresponding directory. For example, if you want to add a new faculty member, you should add a new markdown file in content/1.members/faculty directory. The markdown file should have the following format:

---name: Huakun Shendescription: Master Studentavatar: https://github.com/HuakunShen.pngwebsite: https://huakunshen.comemail: huakun.shen@huakunshen.com---Anything about yourself.

Only name field is necessary, other fields are all optional.

Avatar

It can be a remote image, or a local image. If it's a local image, you should put it in public/avatar directory, and use the relative path as the value of avatar field. For example, if you put the image in public/avatar/shen.png, then the value of avatar field should be /avatar/shen.png.

Content

You can add more details about yourself in the markdown file if you want. Standard markdown syntax is fully supported.

This site is built with @nuxt/content and docus theme, which gives you more flexibility to customize the content and styling. In markdown, you can write html and css. TailwindCSS is supported to make styling easier.

For example <span class="bg-red-300">Hello World</span> gives you Hello World.

Read https://docus.dev/api/components for built-in components you can use. Read author's example at content/1.members/3.grad-student/Huakun-Shen.md.

::terminal---content:- npm install- npm run dev- npm run generate---::

Editing Your Content

Simple content modification can be done fully in browser without a dev environment. In the documentation page, there is a "Edit this page" button at the bottom of the page. Click it to edit the markdown file of the current page.

Pull Request

Fork this repo, make changes, and submit a pull request. The maintainer will merge your changes if everything looks good.