blob: fd2ff815207db52d10f24e8a40827494cb818556 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
# FOSSCET Website
The [FOSSCET website](https://fosscet.codeberg.page) documents all events conducted by the club. We also keep member profiles and op-ed blog posts.
## Quick how-tos
- [Add your member card](#add-your-member-card)
- [Create a new form](#create-a-new-form)
- [Create a new event entry](#create-a-new-form)
- [Create a blog post](#create-a-new-form)
- [Build and test the site locally](#build)
## Add your member card
- Create a file `<yourname>.md` in `src/content/members/`.
Example: If you want your username to be `nik`, create file `src/content/members/nik.md`.
- Fill out the fields that you want in the frontmatter section (between the triple hyphens).
- To upload an avatar, put the image in `./public/images/myavatar.png`, and fill the form like so: `avatar: /public/images/myavatar.png`.
- Add more detailed content after the frontmatter.
### Member card format:
Everything except name and avatar is optional.
```markdown
---
name: <Your name>
pronouns: <Your pronouns>
avatar: <Link to an avatar image>
bio: <A quick, short bio>
website: <Link to your personal website>
github: <Link to your github profile>
codeberg: <Link to your codeberg profile>
linkedin: <Link to your linkedin profile>
instagram: <Link to your instagram profile>
mail: <You email address>
---
Detailed bio text. This is a really good space to introduce yourself.
This can be considerably longer than the `bio` field in the frontmatter.
```
## Create a new form
- Create a file `my-form-id.md` in `src/content/forms/`.
- See the sample in `src/content/forms/test.mdx` for more info.
## Create a new event entry
- Create a file `event-name.md` in `src/content/events/`.
- See the sample in `src/content/events/event_zero.mdx` for more info.
## Create a blog post
- Create a file `post-name.md` in `src/content/blog/`.
- See the sample in `src/content/blog/shortening-of-the-way/index.mdx` for more info.
- Remember to remove `draft: true` in the frontmatter before publishing.
## Build
You need the following installed to get started:
- [Node.js](https://nodejs.org/en) and [pnpm](https://pnpm.io)
OR
- [bun](https://bun.sh)
### Clone and set up the repo
```bash
git clone https://codeberg.org/fosscet/website-src
cd website-src
pnpm i # or bun install
```
### Run the dev server
```bash
pnpm run dev # or bun run dev
```
### Build the site
```bash
pnpm run build # or bun run build
```
|
