7分钟
任务 2 本地创建Wiki
任务目的
在腾讯云CVM上创建Wiki项目,以供后续在本地部署以及腾讯云COS上部署。任务步骤包括MkDocs的安装,使用MkDocs创建Wiki项目、编写Wiki页面内容。
任务步骤
1.安装MkDocs
- 仍在之前的在线终端页面,输入如下命令安装MkDocs并查看MkDocs版本以确认安装成功。
- 安装MkDocs。
sudo apt-get install mkdocs -y- 查看MkDocs版本。
mkdocs --version- 安装成功效果图。
2.创建Wiki项目
- 在
/home目录下(登录终端后所处的目录位置即为/home目录,也被标识为~),输入如下命令MkDocs创建一个my-Wiki项目。(当前位置:~)
mkdocs new my-Wiki3.自定义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- 编写完成后的效果图如下所示。
- 继续添加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`将保存并退出该文件。- 编写完成后的效果图如下所示。
- 保存并退出后使用
ls -l命令查看到当前目录下多了一个hello.md文件,则表明编写Wiki第二页面完成。
学员评价