Skip to content

Latest commit

 

History

History
80 lines (62 loc) · 3.35 KB

README_CN.md

File metadata and controls

80 lines (62 loc) · 3.35 KB

一个简单易用的文档生成器. 预览。 快速的将众多 Markdown 文件生成结构化的网站,并一键部署至 github。

目录

特点

  • 敏捷。只有一个脚本(gzip 后约 3k),没有任何框架。
  • 简单。只需要运行一个命令。
  • 懒加载,首屏加载更快。
  • 适应移动设备。
  • 更多的主题

快速上手

  1. 安装:npm i -g simpler-paper
  2. 初始化:paper init ,帮助你创建一个配置文件。
  3. 添加文档:
    • 不要忘了在文档文件夹中添加你的 Markdown 文件。
    • 创建 assets 文件夹来存储图片。
    • 多层目录的菜单结构是按文档的目录层次决定的,无需配置。
    • 改变文件顺序,如使某个文件夹或 xxx.md 排列在更前面,只需要为文件或文件夹的名称增加数字前缀即可, 这些数字代表着权重,类似于 CSS z-index:100000_install.md (我知道你经常这样干🙄🙄)。
  4. 构建:paper build 。运行 paper server 进行本地预览。
  5. 部署:paper deploy 。确保当前操作目录为 Git 仓库。 完成部署后设置 为 GitHub pages 。

配置文件说明

配置文件是 paper init 过程中指定文档文件夹下的 paper.config.json

运行 paper init 命令可以快速创建配置文件。

// paper.config.json
{
  // 文档别名, 单个文档对应的别名, 不创建默认使用文件名 默认值: null
  "alias": {
    "quickstart": "Getting Started",
    ...
  },

  // 文档标题, 默认值: "simpler paper"
  "title": "",

  // 在文档右侧生成迷你目录地图, 默认值: true
  "minimap": true,

  // 返回至顶部的按钮, 默认值: true
  "backToTop": true,

  // 文档的路径, 默认值: "/"
  "docPath": "/",

  // 加载指示器, 默认值: true
  "indicator": true
}

LICENSE

MIT