站点准备

在成功安装完docsite之后，进入项目根目录，执行docsite init，生成的目录如下结构：

  1. .
  2. ├── .babelrc
  3. ├── .docsite
  4. ├── .eslintrc
  5. ├── .gitignore
  6. ├── .nojekyll
  7. ├── blog
  8. │   ├── en-us
  9. │   └── zh-cn
  10. ├── docs
  11. │   ├── en-us
  12. │   │   ├── dir
  13. │   │   └── img
  14. │   └── zh-cn
  15. │       ├── dir
  16. │       └── img
  17. ├── docsite.config.yml
  18. ├── gulpfile.js
  19. ├── img
  20. │   ├── dubbo.ico
  21. │   └── system
  22. ├── package-lock.json
  23. ├── package.json
  24. ├── redirect.ejs
  25. ├── site_config
  26. │   ├── blog.js
  27. │   ├── community.jsx
  28. │   ├── docs.js
  29. │   ├── home.jsx
  30. │   └── site.js
  31. ├── src
  32. │   ├── components
  33. │   │   ├── bar
  34. │   │   ├── button
  35. │   │   ├── footer
  36. │   │   ├── header
  37. │   │   ├── language
  38. │   │   ├── pageSlider
  39. │   │   ├── sidemenu
  40. │   │   └── slider
  41. │   ├── markdown.scss
  42. │   ├── pages
  43. │   │   ├── blog
  44. │   │   ├── blogDetail
  45. │   │   ├── community
  46. │   │   ├── documentation
  47. │   │   └── home
  48. │   ├── reset.scss
  49. │   └── variables.scss
  50. ├── template.ejs
  51. ├── utils
  52. │   └── index.js
  53. └── webpack.config.js

现从上至下对主要的文件、文件夹作说明。

.docsite

空文件，用作判断当前项目是否已初始化过。

template.ejs

所有生成的HTML页面的模板，修改对所有页面（除重定向页面）生效。

redirect.ejs

重定向页面模板，可在其中配置重定向逻辑。默认会根据这个模板在项目根目录下生成index.html和404.html（用于某些静态托管站点的自定义404页面的功能）。

blog

存放博客的markdown文档及相关图片资源的目录，分为中、英文两个目录。

docs

存放说明文档的markdown文档及相关图片资源的目录，分为中、英文两个目录。

img

存放非markdown使用的一些站点的图片，其中system中存放一些业务无关的图片。

site_config

存放整个站点的中英文配置数据，其中site.js配置全局的一些数据，包括本地开发启动的服务器端口（默认为8080）、部署到服务器的根目录（需以/开头但不能有尾/，如果只有/，请填写空字符串）、站点默认显示的语言版本、顶部的菜单栏和底部的页脚部分。home.jsx、docs.js、blog.js、community.jsx分别对应首页、文档页、博客列表页、社区页的配置。

docsite.config.yml

放置非markdown文件对应页面的SEO配置信息（1.3.3版本添加）

.nojekyll

用于跳过jekyll的检查

src

存放源码的位置，其中，markdown.scss为markdown文档的样式文件，variable.scss为一些公共scss变量，components为公共组件，pages为对应站点的不同页面，utils中存放一些公共方法。

现在网站的骨架搭建完成，可以进行网站的自定义和内容填充了。