齐鲁师范学院网络安全社团(QLNU-Sec-Team)官网

运行在: https://www.qlnu-sec.cn

About

本项目使用 Astro 作为 Web 框架进行编写

基本框架由 shenghuo2 进行编写实现

于 2024.8.5 基本完成实现

维护提示

若需维护 index/award 页的内容

直接修改 src/pages/index.md / src/pages/award.md 即可

---

如需增加member页的成员

请修改src/assets/memberList.json

按照以下格式编写

{
    "index": {
        "level": "number",
        "member": [
            "name"
        ],
        "link": {
            "name": "https://link"
        }
    }
}

---

如需增加friends页的成员

请在src/assets/friends.json

按照以下格式新增

{
    "name": "", //名称
    "description": "", //描述
    "avatar": "", //要求https图片链接
    "link" : "" //网站链接
}

---

本项目使用了ViewTransition特性，所以请使用Astro ^4.12.2

使用nodejs v20

项目结构

.
├── public
│   ├── scripts
│   │   └── menu.js
│   ├── favicon.svg
│   ├── icon.png
│   ├── QLNU.png
│   └── wx.svg
├── src
│   ├── assets
│   │   ├── friends.json
│   │   └── memberList.json
│   ├── pages
│   │   ├── components
│   │   │   ├── footer.astro
│   │   │   ├── Navbar.astro
│   │   │   └── NavItem.astro
│   │   ├── layouts
│   │   │   ├── BaseLayout.astro
│   │   │   └── BaseMarkdownLayout.astro
│   │   ├── index.md
│   │   ├── award.md
│   │   ├── friends.astro
│   │   └── member.astro
│   │   
│   ├── styles
│   │   └── global.css
│   └── env.d.ts
├── astro.config.mjs
├── CNAME
├── LICENSE
├── package.json
├── package-lock.json
├── README.md
└── tsconfig.json

public

此文件夹下为网站根目录可直接使用的文件

主要是存放非代码、未处理的资源

这个文件夹中的文件将会被原封不动地复制到构建文件夹中

favicon.svg 未使用，为Astro的icon

src

assets

memberList.json 为 member.astro所引用的成员列表JSON

结构请参考 维护提示

friends.json 为 friends.astro所引用的友链列表JSON

结构请参考 维护提示

pages

Astro将渲染在本文件夹下的文件为页面

pages/components

基本组件，Astro使用模块化设计

可以是 Astro 组件 或是像 React 或 Vue 这样的 UI 框架组件

Navbar由NavItem组成

Footer为页脚

pages/layouts

框架模板，两个模板几乎相同，可以再进行合并重构

BaseLayout为原模板，后改为member.astro独用

BaseMarkdownLayout为index.md和award.md的渲染模板

styles

本文件夹下存放的global.css暂未实装

scripts

本文件夹下存放的menu.js为Navbar组件的脚本

根目录

package.json

nodejs 项目清单

名称和版本 (name 和 version): 定义项目的名称和版本号。

描述 (description): 项目简要描述。

脚本 (scripts): 定义一组可以通过 npm run <script> 运行的命令，如启动项目、运行测试等。

依赖项 (dependencies): 列出项目运行时所需的包和版本。

astro.config.mjs

包括了 Astro 项目的配置。你可以在这里指定要使用的集成、构建选项、服务器选项以及其他内容

其他

Contributors

shenghuo2	CGjue	Yalois	fishfond	Q1ngchuan	f1ngy3
huan

Bots

github-actions[bot]

VCS

本项目使用Git进行版本管理。您可以在repository查看可用版本。

License

AGPL3.0