扫二维码与项目经理沟通
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流
这篇文章主要介绍“如何测试HelloGitHub”，在日常操作中，相信很多人在如何测试HelloGitHub问题上存在疑惑，小编查阅了各式资料，整理出简单好用的操作方法，希望对大家解答”如何测试HelloGitHub”的疑惑有所帮助！接下来，请跟着小编一起来学习吧！
创新互联公司-专业网站定制、快速模板网站建设、高性价比五河网站开发、企业建站全套包干低至880元,成熟完善的模板库,直接使用。一站式五河网站制作公司更省心,省钱,快速模板网站建设找我们，业务覆盖五河地区。费用合理售后完善，十多年实体公司更值得信赖。
HelloGitHub：“嘿嘿，先别着急，我们先在本地平台运行，测试测试功能，了解这个项目的基本使用，再一步步往前走。”
仅需 6 步你就可以从零运行起来这个项目！
1、我们本地的实验环境是：
Windows 10 64 位操作系统
Python 3.7，pip 21.0.1
2、我们需要将开源项目克隆到本地，使用如下命令：
git clone https://github.com/zmister2016/MrDoc
3、为 MrDoc 安装好所需的第三方库：进入 Mrdoc/ 目录，运行如下命令：
4、初始化数据库，该项目默认使用 sqlite 数据库。在命令行下执行：
5、创建管理员账户，来管理整个 MrDoc 应用。注意用户名和电子邮箱地址在整个 MrDoc 应用中是唯一的。
6、本地上线测试：在测试环境中，可以使用 Django 自带的服务器运行 MrDoc。
小白搓搓手，期待：“我也在本地测试成功了，是不是可以探索一番里面的彩蛋呢？”
HelloGitHub：“好嘞，项目主打的关键字就是：个人团队协作和文档管理，让我现在来给你展现一下五脏俱全的 MrDoc。”
HelloGitHub：“当我们访问网站的时候，以游客身份进行的。假如我们需要注册一个普通用户的帐号，则需要填写相应的表单信息，注册完毕后会自动跳转到已登录界面。”
小白：“补充：其实如果游客想点击 新建 → 新建文档，也是需要登录操作的哟。”
HelloGitHub：“当我们登录以后，可以在 新建 → 新建文集 中创建一个文集。”
小白：“我发现了，可以点击首页的文集，进入到文集的浏览阅读页面，还可以用 添加 新建一个文档。在进入文档编辑器页面，我们可以 点击文档树 选择当前文档对应的上级或者 取消上级，以及通过输入 文档排序值，来给不同文档排序。”
HelloGitHub：“嗯呐，现在我们就不用担心教程学习类的文章不连续啦，因为他们都有层次顺序的分布在我们的文集中。不过因为目前 MrDoc 最多支持 3 级的文档，可别让自己的文档树太大鸭。”
HelloGitHub：“非常重要的一点是团队的共享和协作。我们普通用户可以对自己的文集进行管理，点击 个人中心 → 我的文集 → 文集管理 → 文集成员 处的 协作管理 小图标，可以添加协作人。而且在 文集管理 → 操作 → 文集设置 小图标可以修改 基础信息、权限配置 和 管理控制。当权限设置为公开时，则当以游客身份访问网页的时候能够看到该文集；当权限设置为私密，则只有自己能看到。当然也可以给固定的人看，这也就能实现了小团队的共享。”
HelloGitHub：“现在我们把目光投向 MrDoc 的文档编辑和修改模块，它支持以 Markdown 和富文本两种方式进行文档编写，给我们提供了 3 种编辑器使用。它能支持插入数学公式、流程图、序列图、脑图、Echarts 图形图表和时间线，能够添加音视频链接和图片附件等，能够创建文档模板，总之是概括不完了，图也上不完了，需要在使用过程中慢慢的熟练。”
小白：“我现在也看得懂了，在 个人中心 → 我的文档 → 文档管理 中可以统一管理创建的所有文档，还可以看到 历史版本管理 信息呢，方便了用户进行对比，也方便了团队协作的管理。”
HelloGitHub：“大 boss 的权限必然是很高的，一切都收之眼底，包括用户的文集、文档、文档模块，还可以进行用户管理和站点设置。”
小白：“那我就做自己的主宰好了。”
HelloGitHub：“已经了解了一些功能了，但是只在本地跑会不会太拉垮了，是不是得考虑将这个项目部署到我们的云服务器上，让自己的小团队实现高大上的知识协作管理呀。”
小白：“可以和组里的小伙伴多了一个摸鱼工具，想想就很开心~”
HelloGitHub：“先部署好吧，谁知道过程中会出现一堆坑呢。为了比较顺利的进行，我们这次的方法就选用官方提供的比较完整的教程：使用 Nginx + uWSGI 部署 MrDoc。”
1、我们云主机的环境是：
Ubuntu 18.04.4 LTS
Python 3.6.9，pip 21.0.1
在 ~ 目录下进行，即用 pwd 命令查看为：/home/purple，小伙伴们改成自己对应的目录
2、安装 uWSGI 和 Nginx：
sudo apt-get install uwsgi sudo apt install uwsgi-plugin-python3 sudo apt-get install nginx
3、将 MrDoc 的源码拉取至本地（用之前的命令），但是为了不对服务器上现存的环境造成影响，我们这次需要用到虚拟环境：
4、进入 MrDoc 文件夹，重复简单测试的 3、4、5 步骤，分别实现依赖库的安装、初始化数据库以及创建管理员账号（略）。
5、我们在 ~ 目录下新建一个名为 mrdoc_deploy 的文件夹，命令如下所示，用于存放部署的相关文件。
mkdir /home/purple/mrdoc_deploy
(1) uWSGI 配置文件：
在 mrdoc_deploy 目录下新建一个名为 uwsgi_params 的文件，用 vim uwsgi_params 命令进行写入：
uwsgi_param QUERY_STRING $query_string; uwsgi_param REQUEST_METHOD $request_method; uwsgi_param CONTENT_TYPE $content_type; uwsgi_param CONTENT_LENGTH $content_length; uwsgi_param REQUEST_URI $request_uri; uwsgi_param PATH_INFO $document_uri; uwsgi_param DOCUMENT_ROOT $document_root; uwsgi_param SERVER_PROTOCOL $server_protocol; uwsgi_param REQUEST_SCHEME $scheme; uwsgi_param HTTPS $https if_not_empty; uwsgi_param REMOTE_ADDR $remote_addr; uwsgi_param REMOTE_PORT $remote_port; uwsgi_param SERVER_PORT $server_port; uwsgi_param SERVER_NAME $server_name;
在 mrdoc_deploy 目录下新建一个名为 mrdoc_uwsgi.ini 的文件，同理用 vim mrdoc_uwsgi.ini 写入：
[uwsgi] # Django-related settings socket = :8008 # the base directory (full path) chdir = /home/purple/MrDoc virtualenv = /home/purple/mrdoc_env # Django s wsgi file module = MrDoc.wsgi:application wsgi-file = MrDoc/wsgi.py # process-related settings # master master = true # maximum number of worker processes processes = 1 threads = 2 # ... with appropriate permissions - may be needed # chmod-socket = 664 # clear environment on exit plugins = python3 vacuum = true python-autoreload = 1 # buffer size buffer-size = 65536
注：如果后续运行服务的时候出现如下问题，则需要调整 mrdoc_uwsgi.ini 下的 buffer-size 参数。
spawned uWSGI master process (pid: 21172) spawned uWSGI worker 1 (pid: 21173, cores: 2) invalid request block size: 21573 (max 4096)...skip invalid request block size: 21573 (max 4096)...skip
(2) Nginx 配置文件
在 mrdoc_deploy 目录下新建一个名为 mrdoc_nginx.conf 的文件，使用命令 vim mrdoc_nginx.conf 写入如下内容：
server {
listen 80;
server_name 此处填入域名;
charset UTF-8;
access_log /var/log/nginx/mrdoc_access.log;
error_log /var/log/nginx/mrdoc_error.log;
client_max_body_size 75M;
location / {
include /home/purple/mrdoc_deploy/uwsgi_params;
uwsgi_pass 127.0.0.1:8008;
uwsgi_read_timeout 60;
}
location /static {
expires 30d;
autoindex on;
add_header Cache-Control private;
alias /home/purple/MrDoc/static;
}
location /media {
alias /home/purple/MrDoc/media;
}
}注意在 server_name 参数中，需要填入自己的域名。此处我填的是云主机的公网 IP 地址，之后访问网站则需要输入该 IP 地址。
(3) 为了能让 MrDoc 应用按我们的要求运行，使用 systemctl 工具来管理服务。
在 mrdoc_deploy 目录下新建一个名为 mrdoc.service 的文件，用命令 vim mrdoc.service 将如下内容写入文件：
[Unit] Description = MrdocApp After = syslog.target [Install] WantedBy = multi-user.target [Service] WorkingDirectory = /home/purple/MrDoc ExecStart = /usr/bin/uwsgi --ini /home/purple/mrdoc_deploy/mrdoc_uwsgi.ini User = purple Restart = always StandardError = syslog~
6、添加进程管理
sudo systemctl enable /home/zmister/mrdoc_deploy/mrdoc.service
7、创建 Nginx 站点软链接
sudo ln -s /home/zmister/mrdoc_deploy/mrdoc_nginx.conf /etc/nginx/sites-enabled/mrdoc_nginx.conf
8、启动 MrDoc 服务
sudo systemctl start mrdoc.service
注意：当试图启动的时候，出现如下报错。原因是：在配置 mrdoc.service 的时候 ExecStart 参数如果按照官方文档写的是 uwsgi，但实际上应该写成绝对路径（可以查看一下自己的路径），我的是 /usr/bin/uwsgi。
(mrdoc_env) purple@VM-Purplezi-Ubuntu ~ % sudo systemctl start mrdoc.service Failed to start mrdoc.service: Unit mrdoc.service is not loaded properly: Exec format error. See system logs and 'systemctl status mrdoc.service' for details.
到此，关于“如何测试HelloGitHub”的学习就结束了，希望能够解决大家的疑惑。理论与实践的搭配能更好的帮助大家学习，快去试试吧！若想继续学习更多相关知识，请继续关注创新互联网站，小编会继续努力为大家带来更多实用的文章！
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流
微信二维码
移动版官网