aitii-tekisuto

aitii-tekisuto

AD 域控与数据通信网络的统一技术文档平台,覆盖架构设计、部署实施、安全加固与日常运维,帮助你快速搭建与维护稳定可靠的企业网络环境。

Stars: 321

Visit
 screenshot

aitii-tekisuto is a unified technical documentation platform for AD domain control and data communication networks, covering architecture design, deployment, security hardening, and daily operation and maintenance. It helps you quickly build and maintain a stable and reliable enterprise network environment. The project uses MkDocs Material to provide a modern documentation site experience, integrating article content encryption functionality and smooth page transition animations for sensitive documents' security protection and optimized user browsing experience.

README:

《AD域控与数据通信网络》

AD 域控与数据通信网络的统一技术文档平台,覆盖架构设计、部署实施、安全加固与日常运维,帮助你快速搭建与维护稳定可靠的企业网络环境。

项目简介

本项目使用 MkDocs Material 构建,提供现代化的文档站点体验。项目集成了文章内容加密功能和流畅的页面过渡动画,为敏感文档提供安全保护,同时优化了用户的浏览体验。

核心特性

文章内容加密

  • AES-CBC 256 位加密:采用行业标准加密算法,确保内容安全
  • 构建时加密:内容在构建时加密,密码不会出现在源代码中
  • 客户端解密:支持浏览器端实时解密,无需服务器端处理
  • 自动密码保存:密码自动保存到 localStorage,24 小时有效
  • 简单易用:只需在 Markdown front-matter 中添加 password 字段即可

页面过渡动画

  • 流畅淡入效果:页面加载时内容平滑淡入,减少视觉突兀
  • 页面切换优化:点击链接或刷新时,旧内容先淡出,新内容再淡入
  • 内容高度稳定:针对内容较短的页面,设置最小高度,避免布局跳动
  • 列表项依次显示:列表项依次淡入,提升视觉体验
  • 性能优化:使用 CSS transition 和 will-change 优化动画性能

一键启动

注意:在 PowerShell 7+ 中也可以使用 && 连接符:

python -m pip install -r requirements.txt && python -m mkdocs serve
python -m pip install -r requirements.txt; if ($?) { python -m mkdocs serve }

或者分步执行:

python -m pip install -r requirements.txt
python -m mkdocs serve

启动成功后,在浏览器中访问:http://127.0.0.1:8000

使用文章加密功能

基本用法

在 Markdown 文件的 front-matter 中添加 password 字段,整个页面内容会自动加密:

---

password: your-password
password-hint: desc

---

这里是要加密的内容。

可以包含:
- **Markdown 格式**
- 代码块
- 列表
- 等等...

```python
def example():
    print("加密的代码")
```

特性说明

  • 安全性:AES-CBC 256 位加密,每次加密使用随机 IV
  • 用户体验:自动保存密码(24小时有效),支持回车键确认
  • 兼容性:支持 MkDocs Material 主题和即时导航
  • 暗色模式:完美适配暗色主题

详细文档

更多关于加密功能的使用说明,请查看 ENCRYPT_README.md

文档结构

├── docs/                    # 文档源文件目录
│   ├── ad/                 # AD 域控相关文档
│   ├── datacom/            # 数据通信相关文档
│   ├── security/           # 信息安全相关文档
│   └── demo/               # 演示文档
├── material/               # Material 主题自定义文件
│   └── overrides/
│       ├── assets/         # 自定义资源(CSS、JS)
│       └── hooks/          # MkDocs hooks(加密处理)
├── tools/                  # 工具脚本
│   └── encrypt.py          # 加密工具
├── mkdocs.yml             # MkDocs 配置文件
└── requirements.txt       # Python 依赖

开发说明

修改文档

直接编辑 docs/ 目录下的 Markdown 文件即可,MkDocs 会自动检测变化并重新加载。

修改主题

如果需要修改 Material 主题的样式或功能:

  1. 安装 Node.js(需要 Node >= 18)
  2. 安装前端依赖:
    npm install
  3. 启动主题开发模式(监听文件变化):
    npm run start

自定义样式和脚本

  • 页面过渡动画material/overrides/assets/stylesheets/page-transitions.css
  • 加密功能样式material/overrides/assets/stylesheets/encrypt.css
  • 加密解密脚本material/overrides/assets/javascripts/encrypt.js
  • 页面过渡脚本material/overrides/assets/javascripts/page-transitions.js

部署

项目已配置 GitHub Actions 自动部署到 GitHub Pages。每次推送到 main 分支时会自动构建并部署。

  • 部署配置位于:.github/workflows/deploy.yml
  • 工具:cryptography - Python 加密库

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for aitii-tekisuto

Similar Open Source Tools

For similar tasks

For similar jobs