Home

Awesome

方糖小剧场·阅读器

⚠️ 已经更新为V2,内置了头像和小说元信息,不再兼容之前的格式,V1版本见这里


什么是🎈小剧场

小剧场(H2 Book)是我们定义的一种对话体、类剧本式的开放图书格式。它采用对话和场景来展现故事、描述事实,又非常接近于我们平时使用的聊天软件,所以读起来更为轻松。

📷 截图

📖 在线阅读

🖋 如何编写和阅读小剧场

  1. 使用小剧场编辑器编写,比如方糖小剧场的编辑器
  2. 可以随时保存文件为 .h2doc 供以后编辑修改
  3. 一章写完以后,可导出章节为 .h2book 文件,用于分发
  4. 读者拿到 .h2book ,通过阅读器阅读。

本项目,即是 Web版本的阅读器网站,你可以把 .h2book 上传上来,获得一个阅读二维码,用手机扫码即可阅读。

Demo网站


以下为进阶内容,供程序员参考。

小剧场文件格式

小剧场文件有两种格式,分别是:

两者均为 json 纯文本。

.h2doc

包含以下属性

.h2book

包含以下属性

阅读器的架设

你可以自行架设阅读器,并修改其代码进行开发和定制。

👨🏻‍💻 开发

git clone https://github.com/easychen/h2reader-host
cd h2reader-host
yarn install
yarn start

部署

yarn build

然后将 build 目录下的内容放到服务器目录。目录需要支持 rewrite。

注意本项目只附带了 apache 的 rewrite 文件,其他服务器需自己添加。

Nginx 参考:

https://stackoverflow.com/questions/36304302/how-can-i-configure-react-router-to-with-nginx-cherrypy-and-my-current-reactjs-a

location / {
    root /var/www;
    index index.html;

    try_files $uri $uri/ /index.html;
}

☁️ 上传图书

分为静态上传和动态上传两种方式。

静态上传

.h2book 文件放到服务器 web 目录下的 books 之下,即可通过 url ( http://domain/bookname ) 进行访问。

你可以修改 books/index.jsonbooks 数组来调整默认列表。

动态上传

支持通过 PHP 上传 .h2book 文件,这样就不用每次手工上传了。 注意默认是任何人都以上传,如果想控制权限,可以自己加一个 http basic 认证在 api.php 前边。

然后设置 books/index.json 文件

{
    "books":
    [
        {"name":"方糖小剧场使用说明","bookurl":"1"},
        {"name":"FreeSource Vol1","bookurl":"2"},
        {"name":"程序员和说学逗唱","bookurl":"3"}
    ],
    "upload_url":"/api.php", <--- 不想开放上传的时候,写成空就行;也可以写其他网站的url。
    "site_url":"http://domain"  <--- 当前阅读器网站的url,用来拼接二维码的地址。最后不要加斜杠。
}

访问首页即可在右上方看到上传按钮。

License

MIT