qzwlinux / docs.hpc.sjtu.edu.cn

SJTU HPC 用户文档站点

Home Page:https://docs.hpc.sjtu.edu.cn/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Pi超算集群用户文档

本仓库维护Pi超算集群用户文档。本文档使用markdown书写,并会被mkdocs转译为html/css/js。本站使用的主题是mkdocs-material的分支版本theme

搭建环境

mkdocs是一个python包,用于本文档网页渲染。在开始之前请确保本地已经有python环境。如果您的电脑暂时没有可用的python环境,那么我们建议您使用anaconda创建一个。

使用以下指令安装指定的python包:

pip3 install -r requirements.txt

检查mkdocs是否安装完成:

Windows用户

where mkdocs

Linux和Mac用户

which mkdocs

启动服务器和更新文档

更新文档需要管理员权限

本仓库包含makefile,如果您的工作环境可以使用make指令,那么

本地启动服务器

make server

对于make不可用的情况

本地启动服务器

mkdocs serve

重新编译文档

make build

更新文档

# 将更新推送到仓库master分支自动部署

About

SJTU HPC 用户文档站点

https://docs.hpc.sjtu.edu.cn/

License:Other


Languages

Language:HTML 89.1%Language:Python 6.6%Language:JavaScript 1.5%Language:CSS 1.3%Language:Shell 1.1%Language:Makefile 0.5%