|
1 | 1 | # 个人学术项目分享网站 |
2 | 2 |
|
3 | | -一个现代化的个人学术作品集网站,用于展示项目经历、学术论文、工作经历和学习记录。 |
| 3 | +一个现代化的个人网站,用于展示项目经历、学术论文、工作经历和学习记录。 |
4 | 4 |
|
5 | 5 | ## ✨ 特性 |
6 | 6 |
|
|
12 | 12 | - 📊 **媒体支持** - 支持图片、视频展示,兼容多种平台 |
13 | 13 | - 🚀 **快速部署** - 纯前端项目,易于部署到各种平台 |
14 | 14 |
|
15 | | -## 🚀 快速开始 |
16 | | - |
17 | | -### 本地开发 |
18 | | - |
19 | | -1. **克隆项目** |
20 | | -```bash |
21 | | -git clone https://github.com/yourusername/academic-portfolio.git |
22 | | -cd academic-portfolio |
23 | | -``` |
24 | | - |
25 | | -2. **安装依赖** |
26 | | -```bash |
27 | | -npm install |
28 | | -# 或使用 anpm(推荐,速度更快) |
29 | | -anpm install |
30 | | -``` |
31 | | - |
32 | | -3. **启动开发服务器** |
33 | | -```bash |
34 | | -npm run dev |
35 | | -``` |
36 | | - |
37 | | -4. **访问网站** |
38 | | -打开浏览器访问 `http://localhost:3001` |
39 | | - |
40 | | -### 生产构建 |
41 | | - |
42 | | -```bash |
43 | | -npm run build |
44 | | -``` |
45 | | - |
46 | | -构建文件将输出到 `dist` 目录。 |
47 | | - |
48 | | -## 📦 部署指南 |
49 | | - |
50 | | -### GitHub Pages 部署 |
51 | | - |
52 | | -1. **推送代码到 GitHub** |
53 | | -```bash |
54 | | -git add . |
55 | | -git commit -m "Initial commit" |
56 | | -git push origin main |
57 | | -``` |
58 | | - |
59 | | -2. **启用 GitHub Pages** |
60 | | - - 进入仓库设置 (Settings) |
61 | | - - 找到 Pages 选项 |
62 | | - - Source 选择 "GitHub Actions" |
63 | | - - 创建 `.github/workflows/deploy.yml` 文件: |
64 | | - |
65 | | -```yaml |
66 | | -name: Deploy to GitHub Pages |
67 | | - |
68 | | -on: |
69 | | - push: |
70 | | - branches: [ main ] |
71 | | - pull_request: |
72 | | - branches: [ main ] |
73 | | - |
74 | | -jobs: |
75 | | - build-and-deploy: |
76 | | - runs-on: ubuntu-latest |
77 | | - |
78 | | - steps: |
79 | | - - name: Checkout |
80 | | - uses: actions/checkout@v3 |
81 | | - |
82 | | - - name: Setup Node.js |
83 | | - uses: actions/setup-node@v3 |
84 | | - with: |
85 | | - node-version: '18' |
86 | | - |
87 | | - - name: Install dependencies |
88 | | - run: npm install |
89 | | - |
90 | | - - name: Build |
91 | | - run: npm run build |
92 | | - |
93 | | - - name: Deploy to GitHub Pages |
94 | | - uses: peaceiris/actions-gh-pages@v3 |
95 | | - with: |
96 | | - github_token: ${{ secrets.GITHUB_TOKEN }} |
97 | | - publish_dir: ./dist |
98 | | -``` |
99 | | -
|
100 | | -### Vercel 部署 |
101 | | -
|
102 | | -1. **连接 GitHub 仓库** |
103 | | - - 访问 [Vercel](https://vercel.com) |
104 | | - - 导入你的 GitHub 仓库 |
105 | | -
|
106 | | -2. **配置构建设置** |
107 | | - - Build Command: `npm run build` |
108 | | - - Output Directory: `dist` |
109 | | - - Install Command: `npm install` |
110 | | - |
111 | | -### Netlify 部署 |
112 | | - |
113 | | -1. **连接 GitHub 仓库** |
114 | | - - 访问 [Netlify](https://netlify.com) |
115 | | - - 选择 "New site from Git" |
116 | | - |
117 | | -2. **配置构建设置** |
118 | | - - Build command: `npm run build` |
119 | | - - Publish directory: `dist` |
120 | 15 |
|
121 | 16 | ## 🔧 配置说明 |
122 | 17 |
|
123 | | -### 管理员访问 |
124 | | - |
125 | | -- **默认密码**: `ranpin.github` |
126 | | -- **修改密码**: 编辑 `src/components/Header.jsx` 中的 `correctPassword` 变量 |
127 | | -- **登录方式**: 点击右上角的盾牌图标输入密码 |
128 | | - |
129 | 18 | ### 内容管理 |
130 | 19 |
|
131 | 20 | 管理面板支持以下功能: |
|
181 | 70 | - **图标**: Font Awesome |
182 | 71 | - **字体**: Google Fonts (Inter + Noto Serif SC) |
183 | 72 |
|
184 | | -## 📝 使用说明 |
185 | | -
|
186 | | -### 首次使用 |
187 | | -
|
188 | | -1. 访问网站后,点击右上角盾牌图标 |
189 | | -2. 输入管理员密码 (默认: `ranpin.github`) |
190 | | -3. 进入管理面板,更新个人资料 |
191 | | -4. 添加你的项目、论文、工作经历等内容 |
192 | | -
|
193 | | -### 内容编辑 |
194 | | -
|
195 | | -- **快捷键**: `Ctrl/Cmd + Shift + A` 快速打开管理面板 |
196 | | -- **自动保存**: 所有更改自动保存到浏览器本地存储 |
197 | | -- **数据备份**: 支持导出所有数据为 JSON 文件 |
198 | | -- **批量导入**: 支持从 JSON 文件批量导入数据 |
199 | | -
|
200 | | -### 安全建议 |
201 | | -
|
202 | | -1. **修改默认密码**: 部署前请修改管理员密码 |
203 | | -2. **定期备份**: 定期导出数据进行备份 |
204 | | -3. **访问控制**: 生产环境建议使用更强的身份验证 |
205 | 73 |
|
206 | 74 | ## 🤝 贡献 |
207 | 75 |
|
|
0 commit comments