Skip to content

DLCNCC/dlcncc

Repository files navigation

数智未来 DLCN.CC

项目概述

数智未来 DLCN.CC 是一个基于 VuePress 构建的数字素养与技能提升学习社区,致力于为用户提供高质量的数字素养教育资源和实践指南。

核心功能

  • 📚 丰富的学习资源:涵盖数字素养、AI应用、编程技能等多个领域
  • 🎨 现代化设计:基于 vuepress-theme-hope 构建,视觉效果美观,用户体验流畅
  • 💬 互动评论系统:集成 Giscus 评论功能,支持用户交流与反馈
  • 🔔 智能通知系统:支持站点通知推送,及时告知用户重要更新
  • 📅 动态页脚信息:显示网站更新时间和页面加载时间
  • 📱 响应式设计:完美适配桌面端和移动端
  • 🔒 安全可靠:配置了 SSL 证书,确保数据传输安全
  • 📊 页面元数据:显示最后更新时间、贡献者等信息

技术栈

技术 版本 用途
VuePress 2.0.0-rc.26 静态站点生成器
vuepress-theme-hope 2.0.0-rc.99 主题框架
Vue 3.5.25 前端框架
Vite 7.1.12 构建工具
TypeScript - 类型系统
Sass 1.97.1 CSS预处理器
Giscus - 评论系统

环境配置

系统要求

  • Node.js >= 18.0.0
  • npm >= 9.0.0 或 pnpm >= 7.0.0
  • Git >= 2.0.0

依赖安装

# 使用 npm
npm install

# 使用 pnpm
pnpm install

安装与启动

开发模式

# 使用 npm
npm run docs:dev

# 使用 pnpm
pnpm docs:dev

开发服务器启动后,访问 http://localhost:8080 查看效果

构建生产版本

# 使用 npm
npm run docs:build

# 使用 pnpm
pnpm docs:build

构建产物将生成在 dist 目录

清理缓存并启动开发模式

# 使用 npm
npm run docs:clean-dev

# 使用 pnpm
pnpm docs:clean-dev

基本使用

项目结构

├── src/                      # 文档源文件
│   ├── .vuepress/             # VuePress 配置目录
│   │   ├── components/        # 自定义组件
│   │   ├── config.ts          # 站点配置
│   │   ├── navbar.js          # 导航栏配置
│   │   ├── sidebar.js         # 侧边栏配置
│   │   └── theme.ts           # 主题配置
│   ├── guide/                 # 指南文档
│   ├── articles/              # 文章内容
│   └── README.md              # 首页内容
├── package.json               # 项目配置
└── README.md                  # 项目说明文档

添加新页面

  1. src 目录下创建新的 .md 文件
  2. 在文件顶部添加 frontmatter 配置
  3. 编写 Markdown 内容
  4. sidebar.js 中添加导航链接

配置主题

编辑 src/.vuepress/theme.ts 文件,可配置:

  • 主题颜色
  • 导航栏和侧边栏
  • 评论系统
  • 通知系统
  • 页脚信息

配置站点

编辑 src/.vuepress/config.ts 文件,可配置:

  • 站点标题和描述
  • 语言设置
  • 基础路径
  • 插件配置

项目目录结构

├── src/                      # 文档源目录
│   ├── .vuepress/             # VuePress 配置
│   │   ├── components/        # 自定义 Vue 组件
│   │   ├── config.ts          # 站点配置文件
│   │   ├── navbar.js          # 导航栏配置
│   │   ├── sidebar.js         # 侧边栏配置
│   │   └── theme.ts           # 主题配置
│   ├── guide/                 # 使用指南
│   ├── articles/              # 文章内容
│   ├── demo/                  # 示例页面
│   └── README.md              # 首页
├── .gitignore                 # Git 忽略文件
├── package.json               # 项目依赖配置
└── README.md                  # 项目说明文档

贡献指南

我们欢迎社区贡献,包括但不限于:

贡献方式

  1. 提交 Issue:报告 bug 或提出新功能建议
  2. 提交 PR:修复 bug 或实现新功能
  3. 改进文档:完善文档内容,提高可读性
  4. 分享反馈:提供使用体验和改进建议

提交 PR 流程

  1. Fork 仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开 Pull Request

代码规范

  • 遵循项目现有的代码风格
  • 确保代码通过类型检查
  • 添加必要的注释

许可证

本项目采用 MIT 许可证,详情请见 LICENSE 文件。

联系方式

备案信息

  • ICP 备案:鲁ICP备16010262号-14
  • 公安网备案:鲁公网安备37132102371643号

致谢

感谢所有为项目做出贡献的开发者和用户!


数智未来 DLCN.CC - 数字素养与技能提升学习社区

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published