3分钟

任务 3 本地部署Wiki

任务目的

在腾讯云CVM模拟本地部署Wiki项目。主要内容包括部署Wiki项目、验证访问效果,继续介绍MkDocs的使用(更改主题)、二次验证访问效果。

任务步骤

1.部署Wiki项目并验证访问效果

  • 回到my-Wiki父级目录(~/my-Wiki)下,然后输入如下命令启动MkDocs服务。
sudo mkdocs serve -a 0.0.0.0:80
  • 启动成功效果如下图所示。
启动MkDocs
  • 复制先前记录的【公网IP地址】(可以在 云服务控制台-实例-主IP地址 中找到),输入到浏览器中访问。本地部署成功后首页效果如下图所示。
部署效果
  • 点击状态栏【Hello】进入之前编写的第二页面,效果如下图所示。
hello页面效果

2.更改Wiki页面显示主题并验证访问效果

  • 回到终端页面,首先使用Ctrl+C关停MkDocs服务。仍然在此目录下使用Vim编辑器,输入vim mkdocs.yml进入编辑mkdocs.yml配置文件,然后将内容替换为如下内容。(其中site_name指代的是页面标题,pages指代的是状态栏名称以及对应的文件名称,theme指代的是当前采用的主题)
site_name: 静态Wiki页面
pages:
    - 首页: index.md
    - Vim编辑器: hello.md
theme: readthedocs
  • mkdocs.yml文件更改内容后,效果如下图所示:
配置内容
  • 再次输入命令sudo mkdocs serve -a 0.0.0.0:80启动MkDocs服务,然后刷新上一步中访问的网站,验证页面变化。如下图所示,当看到页面主题发生变化,且页面标题由My Docs变为静态Wiki页面,且状态栏名称变为自定义名称,则表明修改配置文件成功。
更改主题效果