个人wiki搭建资料整理
个人wiki搭建
一、大型企业级wiki:
Confluence:
Confluence是一个专业的企业知识管理与协同软件,也可以用于构建企业wiki。使用简单,但它强大的编辑和站点管理特征能够帮助团队成员之间共享信息、文档协作、集体讨论,信息推送。
MediaWiki:
MediaWiki全球最著名的开源wiki程序,运行于PHP+MySQL环境。MediaWiki从2002年2月25日被作为维基百科全书的系统软件,并有大量其他应用实例。
二、小型个人级wiki
Wikitten:
Wikitten是一款开源Wiki知识管理系统,使用PHP开发,支持Markdown语法,无需数据库,自动生成树形目录,适合用来做个人Wiki知识库。
Amwiki:
amWiki 是一款由 JS 开发、依赖 Atom 或 Nodejs-Npm 的 Markdown 轻量级前端化开源文库系统。 amWiki 致力于让大家可以更简单、更便捷的建设个人和团队文库系统!
三
搭建自己的wiki知识管理系统(https://zhuanlan.zhihu.com/p/61492480)
本文小编将带大家从零开始搭建一个属于你自己的wiki系统。 开源的wiki系统有很多,比如:
- 大名鼎鼎的MediaWiki
- 小巧易用的DokuWiki
- 国内开源的minDoc
- Gitbook
- Docsify
- Hexo
- MkDocs
小编选择使用的是MkDocs,因为它部署和使用都非常的简便,特别适合作为个人wiki知识管理系统。简单的说MkDocs就是将Markdown文件转换成静态的HTML网站,然后既可以在本地直接访问,也可以托管到服务器或者GitHub。
实战开始
1.安装MkDocs
1.1 Ubuntu系统
sudo apt-get install mkdocs
1.2 Windows系统
MkDocs目前支持Python2.7,3.4,3.6,3.7版本
- 安装Python(请参考Python官网教程)
- 安装pip
pip install --upgrade pip
- 安装MkDocs
pip install mkdocs
1.3 确认是否安装正确
mkdocs --version
2.创建一个Wiki
mkdocs new my-wiki
cd my-wiki
成功创建后,就如下图所示:
- docs文件夹下存放的就是自己写的Markdown文章,系统默认会生成一个index.md文件
- mkdocs.yml是wiki网站的配置文件(主题、目录、语言等)
3.预览wiki
- 首先启动mkdocs服务
mkdocs serve
- 然后打开浏览器输入127.0.0.1:8000访问wiki
如果以上步骤都执行成功,你将看到如下界面:
至此,一个wiki系统已经搭建完成,下面我们来学习一下如何向wiki系统中添加新的内容吧!
4.添加新内容
4.1 添加新的文字内容
- 首先在docs文件夹下面创建test.md文件,并使用你喜欢的markdown编辑器写入内容,如下所示:
This is a new page.# 一级标题## 二级标题### 三级标题
- 编辑mkdocs.yml文件,写入以下内容:
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
- 创建一个新仓库。 比如: https://github.com/user_name/repository_name
- 初始化你的本地仓库(wiki), 添加远程仓库,提交本地修改并推送到远程仓库
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
- 部署你的wiki站点
mkdocs gh-deploy
现在你的wiki站点(HTML文件)在gh-pages分支,你的wiki站点(markdown文件)在master分支。
该命令执行了两个动作:
- 将Mardown文件转为静态HTML网页文件
- 将所有的静态HTML网页文件都推送到远程仓库的gh-pages分支
GitHub会自动管理gh-pages分支的静态网页,就相当于一个静态网站服务器。
- 通过以下网址访问你的wiki
https://user_name.github.io/repository_name
个人wiki搭建资料整理相关推荐
- Go语言学习资料整理
整理网上找到的Golang语言学习资料 基础 基础教程 书籍在线版 Go 指南-A Tour of Go Go语言圣经(中文版) Effective Go中文版 Go Web编程 build-web- ...
- H.264的一些资料整理
本文转载自 http://blog.csdn.net/ljzcom/article/details/7258978, 如有需要,请移步查看. Technorati 标签: H.264 资料整理 --- ...
- 计算机视觉笔记及资料整理(含图像分割、目标检测)
前言 1.简单聊聊: 在我脑海中我能通过这些年听到的技术名词来感受到技术的更新及趋势,这种技术发展有时候我觉得连关注的脚步都赶不上.简单回顾看看,从我能听到的技术名词来感受,最开始耳闻比较多「云计算」 ...
- 计算机视觉笔记及资料整理(含图像分割、目标检测小方向学习)
前言 1.简单聊聊: 在我脑海中我能通过这些年听到的技术名词来感受到技术的更新及趋势,这种技术发展有时候我觉得连关注的脚步都赶不上.简单回顾看看,从我能听到的技术名词来感受,最开始耳闻比较多「云计算」 ...
- 锂离子电池热失控预警资料整理(二)
此前 个人搜集了一些锂电池热失控预警相关期刊.文献,并整理了一些个人认为重要的逻辑.知识点,希望通过此分享让有需要的人了解一些内容,如有问题欢迎同我探讨~ 锂离子电池热失控预警资料整理(二) 五.新能 ...
- 五一干货资料整理,在学习上的劳动才是最好的劳动! (包括:ML、DL、RL、Paper、NLP、CV、KG等)...
来自 Datawhale [导读] 本文由知名开源平台,AI技术平台以及领域专家:Datawhale,ApacheCN,AI有道和黄海广博士联合整理贡献,内容涵盖AI入门基础知识.数据分析\挖掘.机器 ...
- 【2022年Spring全家桶】学习路线图和资料整理
前言 对于Java工程师来说,几乎没有没听过大名鼎鼎的Spring框架的,Spring框架早已成为了Java后端开发事实上的行业标准,可以说,是Spring成就了Java,Spring也成为Java程 ...
- 华为思科华三锐捷各种数通资料整理
华为思科华三锐捷各种数通资料整理 文章目录 华为思科华三锐捷各种数通资料整理 前言 一.Routing&Switching 二.SDN 三.winserver 2008视频资料 四.JCOS和 ...
- 程序员优秀学习资料整理(不断更新中)
如果你发现自己陷入各种新技术.工具包围中,而纠结于该选择哪些学习,读读这篇文章,技术的执念. 综合资源 资源链接汇集 awesome - 各种主流语言的优秀项目汇集 :+1: lists - 资源集合 ...
- 一图看懂 aiohttp 模块:基于 asyncio 的异步HTTP网络库, 资料整理+笔记(大全)
本文由 大侠(AhcaoZhu)原创,转载请声明. 链接: https://blog.csdn.net/Ahcao2008 一图看懂 aiohttp 模块:基于 asyncio 的异步HTTP网络库, ...
最新文章
- zip与zip(*)
- 傅里叶变换在图像处理中的作用
- 状态机思路在嵌入式开发中的应用详解
- python更新到哪个版本了_将Python自带版本(2.6.6)升级到2.7.9
- easyui php分页,easyui datagrid分页 4、easyUI-七种布局(layout)
- IDEA找到所有的断点
- c语言课程设计类层次图,C语言课程设计————写下流程图! 谢谢
- pycharm设置python环境_pycharm怎么配置python环境
- python爬取同花顺_python 同花顺
- Anaconda完全卸载教程(Windows10系统)
- GiB与GB 存储单位
- Android小图标
- 在土豆传的第一篇视频
- Lte/5G中的RSRP、RSRQ、SINR、MCS介绍
- 用CSS画小猪佩奇,你就是下一个社会人!
- Cpu、核、Java Runtime.getRuntime().availableProcessors()
- mysql留存数据表_用mysql统计留存率
- 基于Glodstein枝切法相位解包裹算法
- 分数的计算机应用教案,2015级大学计算机应用基础教学大纲
- VPP学习(一)VPP简介
热门文章
- SOA联姻IMS对3G无线网络是福是祸?
- win7显示隐藏文件夹的方法
- IDEA展示隐藏文件夹
- cordova build时出错Minimum supported Gradle version is 5.4.1. Current version is 4.10.3
- 《从0开始学大数据》的启示
- 英魂之刃服务器8.8维护,英魂之刃8大联动!每一个都是良心之作!玩家:公开打脸同行?...
- ​深度:50+中老年健身运动需求升级,老年健身房能否成为下一个线下消费入口?
- be idle sometimes to_英语美文_双语美文:趁着年轻做自己想做的事_沪江英语
- qiankun加载react子应用报错[import-html-entry] error occurs while executing normal script
- threejs炫酷金属样式龙卷风js特效