在做好前面的准备工作后,现在可以着手定义属于你自己的站点了。
在项目根目录下执行docsite start命令,会在浏览器中自动打开页面。
初始化生成的模板工程默认集成了首页、文档页、博客列表页、博客详情页、社区页及中英文国际化功能。可以按照需求自行添加和删除页面。
.md或者.markdown文件放进docs文件夹下的对应语言目录中,支持多级目录site_config文件夹下的docs.js中配置文档的菜单项.md或者.markdown文件放进blog文件夹下的对应语言目录中,支持多级目录存放site_config文件夹下的blog.js中配置博客的列表项注:
markdown文件均支持在文档顶部自定义元数据,顶部的---(至少三个-)之间的数据会被认为是元数据,一个key占用一行。目前支持title、keywords、description三个字段,在生成静态HTML时,分别作为页面标签的标题、页面关键字、页面描述,便于搜索引擎更好地收录站点,从而利于SEO。
---
title: title
keywords: keywords1,keywords2,keywords3
description: some description
---
your markdown content