markdown documents site reader
一个非常简单的markdown文档站点阅读器小工具，自动拉取目录数据并生成目录侧边栏，自动根据文档生成TOC。 只需几步就可以将一个 github 上的 markdown 文档仓库渲染成一个文档站点
- 纯静态渲染，只要有一个可以放静态文件的服务器, 配置好相关信息。访问
index.html即可(可以直接使用代码托管平台的pages服务) - 原生支持渲染 gitbook 导出的 markdown 站点
- 可直接渲染github(或者其他任意git代码托管平台)上的任意一个 markdown 文档仓库，无需拉取仓库代码
- 简单的目录搜索功能支持(会将目录的 链接文字和链接href 作为匹配目标)
- 样式使用基于bootstrap 3 的 bootswatch(可以直接在页面底部切换各种主题)
- 自动缓存内容到本地(localSorage)，加快二次打开速度
- 使用highlight添加代码高亮支持
将此仓库代码拉取到你的服务器上使用，速度会比直接使用 github pages更好
项目仓库
- github https://github.com/inhere/md-site-reader.git
- git@osc https://git.oschina.net/inhere/md-site-reader.git
使用以及配置
你可以通过 config.js 来覆盖默认配置, 然后访问 index.html 即可
示例
示例文档 https://inhere.github.io/md-site-reader/
示例渲染的是 @astaxie 的github项目 《Go web 编程》
- 示例访问的就是当前仓库的
index.html - 示例配置请看文件
config.js
// page title = baseTile + content title
config.baseTitle = 'Go Web 编程'
config.siteName = '《Go Web 编程》'
config.siteDes = 'Go Web 编程的描述信息'
config.siteKey = 'go-web-dev'
config.logoUrl = '/md-site-reader/'
config.docProject = 'astaxie/build-web-application-with-golang'
// // e.g https://raw.githubusercontent.com/{astaxie/build-web-application-with-golang}/master/{beanfactory.md}
config.dataUrl = 'https://raw.githubusercontent.com/astaxie/build-web-application-with-golang/master/zh/'
config.docUrl = 'https://github.com/astaxie/build-web-application-with-golang'
// // e.g https://github.com/astaxie/build-web-application-with-golang/edit/master/http.md
config.editUrl = 'https://github.com/astaxie/build-web-application-with-golang/edit/master'
config.project = 'inhere/md-site-reader'
config.projectUrl = 'https://github.com/inhere/md-site-reader'
config.issueUrl = 'https://github.com/astaxie/build-web-application-with-golang/issues'
config.authorPage = 'https://github.com/astaxie'
config.authorName = 'astaxie'
config.theme = 'paper'
config.codeTheme = 'github'
config.catelogPage = 'SUMMARY.md'
config.defaultPage = 'README.md'
config.makeTOC = true
config.emptyData = 'No content to display!'- 效果预览：
更多书籍文档
请看站点 https://git-books.github.io/
github 仓库： https://github.com/git-books/git-books.github.io
收集了一些github上的书籍文档。
全部配置项
// file: assets/js/config.defalut.js
{
// use for cache prefix
siteKey: 'swoft',
siteName: 'Swoft',
siteDes: 'the description text',
// page title = baseTile + content title
baseTitle: 'Swoft Doc',
// basePath: ,
logoUrl: '/',
docProject: '',
// e.g https://raw.githubusercontent.com/{swoft-cloud/swoft-doc}/master/{beanfactory.md}
dataUrl: '',
docUrl: '',
// e.g https://github.com/swoft-cloud/swoft-doc/blob/master/http.md
editUrl: '',
project: '',
projectUrl: '',
issueUrl: '',
authorPage: '',
authorName: '',
emptyData: 'No content to display!',
catelogPage: 'SUMMARY.md',
defaultPage: 'README.md',
// assets/lib/bootswatch/{theme:paper}/bootstrap.min.css
theme: 'paper',
// assets/lib/highlight/styles/{codeTheme:github}.css
codeTheme: 'github',
makeTOC: true,
/* £ $ & β ξ ψ ℘ § */
anchorIcon: '℘',
tableClass: 'table table-bordered table-striped'
}License
MIT