mirror of https://github.com/suk-ws/ph-Bookshelf.git synced 2024-12-05 09:26:52 +08:00

一个简单简洁(?)的文档书架实现。

Go to file

Eyre_S c565bfd240 added site icon support, add css mixins		2024-01-15 20:26:56 +08:00
assets	added site icon support, add css mixins	2024-01-15 20:26:56 +08:00
src	added site icon support, add css mixins	2024-01-15 20:26:56 +08:00
template	add support for prism plugins customize import	2023-03-28 11:32:42 +08:00
.gitattributes	更新 readme	2021-11-23 17:41:16 +08:00
.gitignore	added site icon support, add css mixins	2024-01-15 20:26:56 +08:00
.htaccess	use $_SERVER['REQUEST_URI'] but not rewrite param as path	2024-01-15 13:42:31 +08:00
composer.json	fix resource in "/" and mime-type problem	2023-05-19 23:09:25 +08:00
composer.lock	fix resource in "/" and mime-type problem	2023-05-19 23:09:25 +08:00
config.php	refix file safety problem by php open_basedir	2023-05-19 18:05:07 +08:00
constant.php	added site icon support, add css mixins	2024-01-15 20:26:56 +08:00
index.php	added site icon support, add css mixins	2024-01-15 20:26:56 +08:00
LICENSE	更新 LICENSE 为 MIT	2021-11-21 18:46:31 +08:00
README.md	use $_SERVER['REQUEST_URI'] but not rewrite param as path	2024-01-15 13:42:31 +08:00

ph-Bookshelf

一个可以在单一站点上放一大堆文档的文档托管项目——我们把它称之为书架。

因为 web 相关的东西 Sukazyo 最熟悉的就是 php 了所以就用 php 写的。但是写出来的代码还是十分离谱的不易读的：各种调用交错在一起，前后端也交错在一起

而且也并不好用，不好用到几乎没办法写教程...那种...至少现在如此。

有时间的话会补充的（en

安装

下载/clone此仓库的内容，然后拖进 php 站点根目录即可。

支援 .htaccess 的 Webserver
- 如果使用 Apache:
  - 启用模块 rewrite
    - 为网站根目录设置 AllowOverride All
- 使用其它 Webserver，可以自行查询如何将 .htaccess 规则转换为你所使用的网站配置并写进你的网站配置当中
PHP 版本 8.1 以上
- PHP 模块 xml (也可能叫做 dom)
- PHP 模块 mbstring
- PHP 模块 fileinfo
- composer 工具以安装项目依赖 (也可以将 compose 工具直接安装在网站根目录)
- 在 php.ini 中设置 display_errors 以及 display_startup_errors 为 Off (或者关闭 E_WARNING 及以下 log) (这是由于最开始写代码极不上心导致很多地方都会有可能报出 warn，输出在屏幕上会导致很糟糕的使用体验)
- 在网站的 php.ini 或者其它任何地方 php 配置 open_basedir 为只有 ph-bookshelf 本身的目录，以避免路径攻击。

可以根据 [#web-server 环境要求] 就像普通 php 网站那样自行安装。

如果想要更详细的安装教程，可以尝试阅读（还在更新中的）ph-bookshelf Wiki

MIT License.