Skip to content

Commit 284fb6a

Browse files
SunrisepeakSunrisepeak
committed
base init
1 parent ee87758 commit 284fb6a

17 files changed

Lines changed: 2638 additions & 675 deletions

File tree

‎.github/workflows/deploy.yml‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
# 构建 VitePress 站点并将其部署到 GitHub Pages 的示例工作流程
2+
#
3+
name: Deploy VitePress site to Pages
4+
5+
on:
6+
# 在针对 `main` 分支的推送上运行。如果你
7+
# 使用 `master` 分支作为默认分支，请将其更改为 `master`
8+
push:
9+
branches: [main]
10+
paths:
11+
- 'docs/**'
12+
13+
# 允许你从 Actions 选项卡手动运行此工作流程
14+
workflow_dispatch:
15+
16+
# 设置 GITHUB_TOKEN 的权限，以允许部署到 GitHub Pages
17+
permissions:
18+
contents: read
19+
pages: write
20+
id-token: write
21+
22+
# 只允许同时进行一次部署，跳过正在运行和最新队列之间的运行队列
23+
# 但是，不要取消正在进行的运行，因为我们希望允许这些生产部署完成
24+
concurrency:
25+
group: pages
26+
cancel-in-progress: false
27+
28+
jobs:
29+
# 构建工作
30+
build:
31+
runs-on: ubuntu-latest
32+
steps:
33+
- name: Checkout
34+
uses: actions/checkout@v4
35+
with:
36+
fetch-depth: 0 # 如果未启用 lastUpdated，则不需要
37+
- uses: pnpm/action-setup@v3 # 如果使用 pnpm，请取消此区域注释
38+
with:
39+
version: 9
40+
# - uses: oven-sh/setup-bun@v1 # 如果使用 Bun，请取消注释
41+
- name: Setup Node
42+
uses: actions/setup-node@v4
43+
with:
44+
node-version: 22
45+
cache: pnpm # npm # 或 pnpm / yarn
46+
- name: Setup Pages
47+
uses: actions/configure-pages@v4
48+
- name: Install dependencies
49+
run: pnpm install # npm ci # 或 pnpm install / yarn install / bun install
50+
- name: Build with VitePress
51+
run: pnpm docs:build # npm run docs:build # 或 pnpm docs:build / yarn docs:build / bun run docs:build
52+
- name: Upload artifact
53+
uses: actions/upload-pages-artifact@v3
54+
with:
55+
path: docs/.vitepress/dist
56+
57+
# 部署工作
58+
deploy:
59+
environment:
60+
name: github-pages
61+
url: ${{ steps.deployment.outputs.page_url }}
62+
needs: build
63+
runs-on: ubuntu-latest
64+
name: Deploy
65+
steps:
66+
- name: Deploy to GitHub Pages
67+
id: deployment
68+
uses: actions/deploy-pages@v4

‎.gitignore‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
.xlings
2+
node_modules
3+
docs/.vitepress/dist
4+
docs/.vitepress/cache

‎LICENSE‎

Lines changed: 676 additions & 674 deletions
Large diffs are not rendered by default.

‎README.md‎

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,31 @@
11
# MOGA
2-
Make Opensource Great Again
2+
3+
Make Opensource Great Again | 让开源再次伟大
4+
5+
| [主页](https://d2learn.github.io/MOGA) - [论坛](https://forum.d2learn.org) |
6+
| --- |
7+
| [![Deploy VitePress site to Pages](https://github.com/d2learn/MOGA/actions/workflows/deploy.yml/badge.svg)](https://github.com/d2learn/MOGA/actions/workflows/deploy.yml) |
8+
9+
---
10+
11+
## 核心问题和目标
12+
13+
> 从能量守恒的角度考虑, 如果一个开源项目 **创造的价值 > 维护成本** 即结果为正向价值, 那么就具备可持续发展的基础
14+
15+
- **问题:** 一些证明(或初步证明)有价值的开源项目, 依然因为各种原因最后逐渐消亡
16+
- **目标:** 探索个人/组织/社区, 如何 **可持续的开发/运营** 一个开源项目并产生社会价值
17+
18+
## 价值导向
19+
20+
- 愿景: 让有价值的开源项目能持续的发展并产生社会价值
21+
- 使命: 探索如何可持续的开发/运营一个开源项目, 为项目维护者提供可复制/参考的工程、治理、资金与社区运营方法论与工具集
22+
- 价值观: 开源共创、真诚热爱、开放包容
23+
24+
## 当下开源遇到的问题
25+
26+
- 项目维护者生存和获得感问题
27+
- 文档与可用性：文档滞后或残缺, 上手门坎高
28+
- 推广和影响力: 如何和目标用户建立联系, 获得关注和反馈形成良性循环
29+
- 贡献者培养：新人门槛高、贡献路径不明、交流分散、维护者培养机制缺失
30+
- 社区和生态：如何以项目建立社区和生态, 以及相关的运营和治理等问题
31+
- 开源项目商业化路径建立困难, 难以支撑项目持续发展

‎config.xlings‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
xname = "MOGA"
2+
3+
xim = {
4+
pnpm = "",
5+
xppcmds = {
6+
"pnpm install",
7+
}
8+
}
9+
10+
d2x = {
11+
commands = {
12+
install = "xlings install",
13+
run = "pnpm run docs:dev",
14+
build = "pnpm run docs:build",
15+
}
16+
}

‎docs/.vitepress/config.mts‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
import { defineConfig } from 'vitepress'
2+
3+
// https://vitepress.dev/reference/site-config
4+
export default defineConfig({
5+
title: "MOGA",
6+
description: "Make Opensource Great Again",
7+
themeConfig: {
8+
// https://vitepress.dev/reference/default-theme-config
9+
nav: [
10+
{ text: '主页', link: '/' },
11+
{ text: '文档', link: '/documents/quick-start/intro.md' },
12+
{ text: '案例', link: '/documents/cases/dstruct.md' },
13+
{ text: '历史记录', link: '/history/intro.md' },
14+
{
15+
text: '社区',
16+
items: [
17+
{ text: '核心团队', link: '/documents/community/core-team.md' },
18+
]
19+
},
20+
],
21+
22+
sidebar: {
23+
'/documents/' : [
24+
{
25+
text: '快速开始',
26+
items: [
27+
{ text: '基本介绍', link: '/documents/quick-start/intro.md' },
28+
{ text: '价值导向', link: '/documents/quick-start/mvv.md' },
29+
{ text: '开源的问题', link: '/documents/quick-start/issues.md' },
30+
]
31+
},
32+
{
33+
text: '社区',
34+
items: [
35+
{ text: '核心团队', link: '/documents/community/core-team.md' },
36+
]
37+
}
38+
],
39+
'/history/' : [
40+
{ text: '历史线', link: '/history/intro.md' },
41+
{
42+
text: '2025-09',
43+
items: [
44+
{ text: '2025-09-28', link: '/history/2025-09/2025-09-28.md' },
45+
]
46+
},
47+
{
48+
text: '2025-10',
49+
items: [
50+
{ text: '2025-10-01', link: '/history/2025-10/2025-10-01.md' },
51+
]
52+
},
53+
]
54+
},
55+
56+
socialLinks: [
57+
{ icon: 'github', link: 'https://github.com/d2learn/MOGA' }
58+
]
59+
}
60+
})

‎docs/documents/cases/dstruct.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
# https://vitepress.dev/reference/default-theme-home-page
3+
layout: home
4+
5+
hero:
6+
name: "DStruct"
7+
text: "数据结构库"
8+
tagline: 无依赖的数据结构库
9+
actions:
10+
- theme: brand
11+
text: 快速开始
12+
link:
13+
- theme: alt
14+
text: 论坛交流
15+
link:
16+
- theme: alt
17+
text: github
18+
link:
19+
---

‎docs/documents/community/core-team.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# 核心团队

‎docs/documents/quick-start/intro.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# MOGA
2+
3+
Make Opensource Great Again | 让开源再次伟大
4+
5+
## 核心问题和目标
6+
7+
> 从能量守恒的角度考虑, 如果一个开源项目 **创造的价值 > 维护成本** 即结果为正向价值, 那么就具备可持续发展的基础
8+
9+
- **问题:** 一些证明(或初步证明)有价值的开源项目, 依然因为各种原因最后逐渐消亡
10+
- **目标:** 探索个人/组织/社区, 如何 **可持续的开发/运营** 一个开源项目并产生社会价值

‎docs/documents/quick-start/issues.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# 当下开源遇到的问题
2+
3+
- 项目维护者生存和获得感问题
4+
- 文档与可用性：文档滞后或残缺, 上手门坎高
5+
- 推广和影响力: 如何和目标用户建立联系, 获得关注和反馈形成良性循环
6+
- 贡献者培养：新人门槛高、贡献路径不明、交流分散、维护者培养机制缺失
7+
- 社区和生态：如何以项目建立社区和生态, 以及相关的运营和治理等问题
8+
- 开源项目商业化路径建立困难, 难以支撑项目持续发展

0 commit comments

Comments
 (0)