课程资料网站
naucse的Python项目详细描述
NAUCSE
这是一个开放课程资料服务器。
要使用它,您需要一些内容。
通常,包含内容的存储库需要naucse
模块,
并将使用python -m naucse
运行。
我们使用https://github.com/pyvec/naucse.python.cz处的内容生成 naucse.python.cz。
安装
从虚拟环境(或pipenv之类的工具)安装。
要安装最新版本:
(venv)$ python -m pip install naucse
从克隆存储库安装:
(venv)$ python -m pip install -e.
运行
要运行服务,请将(cd
)更改为包含内容的目录,
或者将NAUCSE_ROOT_PATH
设置到该目录。
然后运行:
(venv)$ python -m naucse serve
您可以运行freeze
来生成静态网站,而不是serve
。
其他用法见Elsa,包括
部署到GitHub页面。
外部课程
课程可以从外部存储库呈现。
这是一种安全风险,因此默认情况下会禁用此类课程。
将NAUCSE_TRUSTED_REPOS
设置为以空格分隔的存储库URL全局
允许。url有一个#branch
片段。
在隔离环境中,可以将NAUCSE_TRUSTED_REPOS
设置为*
测试
可以使用tox
:
$ tox
许可证
代码是根据mit许可的条款授权的,请参见LICENSE.MIT文件 全文。通过向这个存储库贡献代码,您就同意拥有它 在同一许可下许可。
内容在相应的matadata中有自己的许可证。 只使用free content licenses。通过向已经获得许可的 文件,您同意在同一许可下使用它。 (也可以将自己添加到元数据中的作者列表中。) 提供新文档时,必须在元数据中指定许可证。