7分钟

任务 2 本地创建Wiki

任务目的

在腾讯云CVM上创建Wiki项目,以供后续在本地部署以及腾讯云COS上部署。任务步骤包括MkDocs的安装,使用MkDocs创建Wiki项目、编写Wiki页面内容。

任务步骤

1.安装MkDocs

  • 仍在之前的在线终端页面,输入如下命令安装MkDocs并查看MkDocs版本以确认安装成功。
  • 安装MkDocs。
sudo apt-get install mkdocs -y
  • 查看MkDocs版本。
mkdocs --version
  • 安装成功效果图。
MkDocs

2.创建Wiki项目

  • /home目录下(登录终端后所处的目录位置即为/home目录,也被标识为~),输入如下命令MkDocs创建一个my-Wiki项目。(当前位置:~
mkdocs new my-Wiki

3.自定义Wiki页面

  • 首先进入my-Wiki项目的docs目录中,可以看到里面有一个index.md文件,这个是项目的默认首页。命令如下所示:
  • 进入my-Wiki项目中的docs目录。
cd my-Wiki/docs/
  • 查看当前目录中的文件。(当前位置:~/my-Wiki/docs
ls -l
  • 使用Vim编辑器在index.md中编写自定义首页内容。
  • 首先输入如下命令进入编写index.md文件。
vim ./index.md
  • Vim编辑器基本使用步骤:Vim默认进入为命令模式,按下i键将Vim从命令模式切换到输入模式,然后输入如下所有内容。按下ESC返回命令模式,最后按下:进入定线命令模式以在最底一行输入命令,最后按下w+q然后按下Enter保存编辑后文件并退出。
  • (备注:由于演示所需,只在index.md中添加如下文字用于验证页面变化,当然你也可以自己将index.md文件中的内容替换为具有markdwon格式的内容,后续第二页面也是如此。)
## my-Wiki

* 基于腾讯云COS搭建静态Wiki
  • 编写完成后的效果图如下所示。
编写index内容
  • 继续添加Wiki页面的第二页面中的内容(添加多个页面的操作也与此步骤类似):仍然使用Vim编辑器,输入如下命令。(备注:你可以自定义文件名而不是必须使用hello。使用如下命令,如果当前目录不存在hello.md文件,在编辑并保存该文件后将会创建hello.md文件并保存更改内容;如果已经存在hello.md文件则会打开该文件,比如上一步中的修改index.md文件。)
vim hello.md
  • 使用Vim在hello.md中编写如下内容(与编写index.md操作一致)。
# Vim编辑器

一句话介绍:Vim是一款文本编辑器。

## 基本介绍

三种模式:命令模式(Command mode)、输入模式(Insert mode)、底线命令模式(Last line mode)

## 基本使用

### 打开文件

`vim fileName.txt` 编辑fileName.txt文件。(如果文件不存在,保存更改后将会创建该文件)

### 编辑内容

在命令模式下按下`i`键切换到输入模式,以输入字符。

### 保存文件

* 在输入模式下按下`ESC`键切换到命令模式。
* 在命令模式下按下`:`键切换到底线命令模式。
* 在底线命令模式下,按下`w`+`q`然后按下`Enter`将保存并退出该文件。
  • 编写完成后的效果图如下所示。
编写hello内容
  • 保存并退出后使用ls -l命令查看到当前目录下多了一个hello.md文件,则表明编写Wiki第二页面完成。
hello.md