這篇文章主要介紹“如何測試HelloGitHub”，在日常操作中，相信很多人在如何測試HelloGitHub問題上存在疑惑，小編查閱了各式資料，整理出簡單好用的操作方法，希望對大家解答”如何測試HelloGitHub”的疑惑有所幫助！接下來，請跟著小編一起來學(xué)習(xí)吧！

創(chuàng)新互聯(lián)公司-專業(yè)網(wǎng)站定制、快速模板網(wǎng)站建設(shè)、高性價(jià)比五河網(wǎng)站開發(fā)、企業(yè)建站全套包干低至880元,成熟完善的模板庫,直接使用。一站式五河網(wǎng)站制作公司更省心,省錢,快速模板網(wǎng)站建設(shè)找我們，業(yè)務(wù)覆蓋五河地區(qū)。費(fèi)用合理售后完善，十多年實(shí)體公司更值得信賴。

一、簡單測試

HelloGitHub：“嘿嘿，先別著急，我們先在本地平臺運(yùn)行，測試測試功能，了解這個(gè)項(xiàng)目的基本使用，再一步步往前走。”

僅需 6 步你就可以從零運(yùn)行起來這個(gè)項(xiàng)目！

1、我們本地的實(shí)驗(yàn)環(huán)境是：

• Windows 10 64 位操作系統(tǒng)

• Python 3.7，pip 21.0.1

2、我們需要將開源項(xiàng)目克隆到本地，使用如下命令：

git clone https://github.com/zmister2016/MrDoc

3、為 MrDoc 安裝好所需的第三方庫：進(jìn)入 Mrdoc/ 目錄，運(yùn)行如下命令：

4、初始化數(shù)據(jù)庫，該項(xiàng)目默認(rèn)使用 sqlite 數(shù)據(jù)庫。在命令行下執(zhí)行：

5、創(chuàng)建管理員賬戶，來管理整個(gè) MrDoc 應(yīng)用。注意用戶名和電子郵箱地址在整個(gè) MrDoc 應(yīng)用中是唯一的。

6、本地上線測試：在測試環(huán)境中，可以使用 Django 自帶的服務(wù)器運(yùn)行 MrDoc。

二、食用說明

小白搓搓手，期待：“我也在本地測試成功了，是不是可以探索一番里面的彩蛋呢？”

HelloGitHub：“好嘞，項(xiàng)目主打的關(guān)鍵字就是：個(gè)人團(tuán)隊(duì)協(xié)作和文檔管理，讓我現(xiàn)在來給你展現(xiàn)一下五臟俱全的 MrDoc。”

2.1 注冊登錄

HelloGitHub：“當(dāng)我們訪問網(wǎng)站的時(shí)候，以游客身份進(jìn)行的。假如我們需要注冊一個(gè)普通用戶的帳號，則需要填寫相應(yīng)的表單信息，注冊完畢后會自動(dòng)跳轉(zhuǎn)到已登錄界面。”

小白：“補(bǔ)充：其實(shí)如果游客想點(diǎn)擊 新建 → 新建文檔，也是需要登錄操作的喲。”

2.2 文集文檔

HelloGitHub：“當(dāng)我們登錄以后，可以在 新建 → 新建文集 中創(chuàng)建一個(gè)文集。”

小白：“我發(fā)現(xiàn)了，可以點(diǎn)擊首頁的文集，進(jìn)入到文集的瀏覽閱讀頁面，還可以用 添加 新建一個(gè)文檔。在進(jìn)入文檔編輯器頁面，我們可以 點(diǎn)擊文檔樹 選擇當(dāng)前文檔對應(yīng)的上級或者 取消上級，以及通過輸入 文檔排序值，來給不同文檔排序?！?/p>

HelloGitHub：“嗯吶，現(xiàn)在我們就不用擔(dān)心教程學(xué)習(xí)類的文章不連續(xù)啦，因?yàn)樗麄兌加袑哟雾樞虻姆植荚谖覀兊奈募?。不過因?yàn)槟壳?MrDoc 最多支持 3 級的文檔，可別讓自己的文檔樹太大鴨?！?/p>

HelloGitHub：“非常重要的一點(diǎn)是團(tuán)隊(duì)的共享和協(xié)作。我們普通用戶可以對自己的文集進(jìn)行管理，點(diǎn)擊 個(gè)人中心 → 我的文集 → 文集管理 → 文集成員 處的 協(xié)作管理 小圖標(biāo)，可以添加協(xié)作人。而且在 文集管理 → 操作 → 文集設(shè)置 小圖標(biāo)可以修改 基礎(chǔ)信息、權(quán)限配置 和 管理控制。當(dāng)權(quán)限設(shè)置為公開時(shí)，則當(dāng)以游客身份訪問網(wǎng)頁的時(shí)候能夠看到該文集；當(dāng)權(quán)限設(shè)置為私密，則只有自己能看到。當(dāng)然也可以給固定的人看，這也就能實(shí)現(xiàn)了小團(tuán)隊(duì)的共享?！?/p>

2.3 文檔編輯

HelloGitHub：“現(xiàn)在我們把目光投向 MrDoc 的文檔編輯和修改模塊，它支持以 Markdown 和富文本兩種方式進(jìn)行文檔編寫，給我們提供了 3 種編輯器使用。它能支持插入數(shù)學(xué)公式、流程圖、序列圖、腦圖、Echarts 圖形圖表和時(shí)間線，能夠添加音視頻鏈接和圖片附件等，能夠創(chuàng)建文檔模板，總之是概括不完了，圖也上不完了，需要在使用過程中慢慢的熟練?！?/p>

小白：“我現(xiàn)在也看得懂了，在 個(gè)人中心 → 我的文檔 → 文檔管理 中可以統(tǒng)一管理創(chuàng)建的所有文檔，還可以看到 歷史版本管理 信息呢，方便了用戶進(jìn)行對比，也方便了團(tuán)隊(duì)協(xié)作的管理?！?/p>

2.4 后臺管理【管理員】

HelloGitHub：“大 boss 的權(quán)限必然是很高的，一切都收之眼底，包括用戶的文集、文檔、文檔模塊，還可以進(jìn)行用戶管理和站點(diǎn)設(shè)置。”

小白：“那我就做自己的主宰好了。”

三、上線部署

HelloGitHub：“已經(jīng)了解了一些功能了，但是只在本地跑會不會太拉垮了，是不是得考慮將這個(gè)項(xiàng)目部署到我們的云服務(wù)器上，讓自己的小團(tuán)隊(duì)實(shí)現(xiàn)高大上的知識協(xié)作管理呀?！?/p>

小白：“可以和組里的小伙伴多了一個(gè)摸魚工具，想想就很開心~”

HelloGitHub：“先部署好吧，誰知道過程中會出現(xiàn)一堆坑呢。為了比較順利的進(jìn)行，我們這次的方法就選用官方提供的比較完整的教程：使用 Nginx + uWSGI 部署 MrDoc?！?/p>

1、我們云主機(jī)的環(huán)境是：

• Ubuntu 18.04.4 LTS

• Python 3.6.9，pip 21.0.1

• 在 ~ 目錄下進(jìn)行，即用 pwd 命令查看為：/home/purple，小伙伴們改成自己對應(yīng)的目錄

2、安裝 uWSGI 和 Nginx：

sudo apt-get install uwsgi
sudo apt install uwsgi-plugin-python3
sudo apt-get install nginx

3、將 MrDoc 的源碼拉取至本地（用之前的命令），但是為了不對服務(wù)器上現(xiàn)存的環(huán)境造成影響，我們這次需要用到虛擬環(huán)境：

4、進(jìn)入 MrDoc 文件夾，重復(fù)簡單測試的 3、4、5 步驟，分別實(shí)現(xiàn)依賴庫的安裝、初始化數(shù)據(jù)庫以及創(chuàng)建管理員賬號（略）。

5、我們在 ~ 目錄下新建一個(gè)名為 mrdoc_deploy 的文件夾，命令如下所示，用于存放部署的相關(guān)文件。

mkdir /home/purple/mrdoc_deploy

(1) uWSGI 配置文件：

在 mrdoc_deploy 目錄下新建一個(gè)名為 uwsgi_params 的文件，用 vim uwsgi_params 命令進(jìn)行寫入：

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 目錄下新建一個(gè)名為 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

注：如果后續(xù)運(yùn)行服務(wù)的時(shí)候出現(xiàn)如下問題，則需要調(diào)整 mrdoc_uwsgi.ini 下的 buffer-size 參數(shù)。

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 目錄下新建一個(gè)名為 mrdoc_nginx.conf 的文件，使用命令 vim mrdoc_nginx.conf 寫入如下內(nèi)容：

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 參數(shù)中，需要填入自己的域名。此處我填的是云主機(jī)的公網(wǎng) IP 地址，之后訪問網(wǎng)站則需要輸入該 IP 地址。

(3) 為了能讓 MrDoc 應(yīng)用按我們的要求運(yùn)行，使用 systemctl 工具來管理服務(wù)。

在 mrdoc_deploy 目錄下新建一個(gè)名為 mrdoc.service 的文件，用命令 vim mrdoc.service 將如下內(nèi)容寫入文件：

[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、添加進(jìn)程管理

sudo systemctl enable /home/zmister/mrdoc_deploy/mrdoc.service

7、創(chuàng)建 Nginx 站點(diǎn)軟鏈接

sudo ln -s /home/zmister/mrdoc_deploy/mrdoc_nginx.conf /etc/nginx/sites-enabled/mrdoc_nginx.conf

8、啟動(dòng) MrDoc 服務(wù)

sudo systemctl start mrdoc.service

注意：當(dāng)試圖啟動(dòng)的時(shí)候，出現(xiàn)如下報(bào)錯(cuò)。原因是：在配置 mrdoc.service 的時(shí)候 ExecStart 參數(shù)如果按照官方文檔寫的是 uwsgi，但實(shí)際上應(yīng)該寫成絕對路徑（可以查看一下自己的路徑），我的是 /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.

到此，關(guān)于“如何測試HelloGitHub”的學(xué)習(xí)就結(jié)束了，希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí)，快去試試吧！若想繼續(xù)學(xué)習(xí)更多相關(guān)知識，請繼續(xù)關(guān)注創(chuàng)新互聯(lián)網(wǎng)站，小編會繼續(xù)努力為大家?guī)砀鄬?shí)用的文章！

分享文章：如何測試HelloGitHub
分享路徑：http://jinyejixie.com/article22/gdpgjc.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供網(wǎng)站建設(shè)、網(wǎng)站內(nèi)鏈、品牌網(wǎng)站制作、云服務(wù)器、定制開發(fā)、域名注冊

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來源： 創(chuàng)新互聯(lián)