一下如何向Material系统中添加新的内容吧!!

优采云 发布时间: 2021-08-16 20:24

  一下如何向Material系统中添加新的内容吧!!

  本文小编将带您从零开始搭建自己的wiki系统。开源的wiki系统有很多,比如:

  编辑选择使用MkDocs是因为它非常易于部署和使用,特别适合作为个人wiki知识管理系统。简单来说,MkDocs 将 Markdown 文件转换为静态 HTML网站,然后可以直接在本地访问,或者托管在服务器或 GitHub 上。

  实战开始1.install MkDocs1.1 Ubuntu系统

  sudo apt-get install mkdocs

  1.2 Windows 系统 MkDocs 目前支持 Python2.7、3.4、3.6、3.7 版本

  pip install --upgrade pip

  pip install mkdocs

  1.3 确认安装是否正确

  mkdocs --version

  2.创建维基

  mkdocs new my-wiki

cd my-wiki

  创建成功后如下图:

  

  3.预览维基

  mkdocs serve

  如果以上步骤执行成功,您会看到如下界面:

  

  到此,wiki系统就搭建好了,下面我们来学习如何在wiki系统中添加新的内容吧!

  4.添加新内容4.1 添加新文本内容

  This is a new page.

# 一级标题

## 二级标题

### 三级标题

  nav:

- Home: index.md

- First: first.md

  

  4.2 插入图片

  在docs文件夹下创建一个images文件夹,把图片放在这个文件夹中,然后在markdown文件中引用:

  ![mkdocs](images/mkdocs.png)

  

  5.更改主题

  mkdocs 有多种主题可供选择,以满足不同用户的喜好。在这里我们向大家推荐 Material 主题。

  5.1 安装 Material 主题

  pip install mkdocs-material

  5.2 配置wiki使用Material主题

  打开配置文件mkdocs.yml,写入如下内容:

  theme:

name: 'material'

  6.将您的 wiki 站点托管到 GitHub

  cd my-wiki

git init

git add remote https://github.com/user_name/repository_name

git add .

git commit -m "first commit"

git push origin master

  mkdocs gh-deploy

  现在您的 wiki 站点(HTML 文件)位于 gh-pages 分支中,而您的 wiki 站点(markdown 文件)位于 master 分支中。

  该命令执行了两个操作:

  将Mardown文件转成静态HTML网页文件,将所有静态HTML网页文件推送到远程仓库的gh-pages分支

  GitHub 会自动管理 gh-pages 分支的静态网页,相当于一个静态的网站服务器。

  https://user_name.github.io/repository_name

  扫描二维码关注“Edge Smart Lab”了解更多精彩资讯!

  

0 个评论

要回复文章请先登录注册


官方客服QQ群

微信人工客服

QQ人工客服


线