add doc

filesite_file_based_no_database_favorite_book_image_video_php_website.md

@@ -0,0 +1,352 @@
+# filesite.io - 无数据库、基于文件和目录的网址导航、图书、图片、视频网站PHP开源系统
+
+## 简介
+
+项目名称：filesite.io
+
+项目介绍：
+为进一步降低内容分享者、内容创作者把内容变成网站的门槛，
+以常见的本地磁盘目录+文件的形式作为网站数据来源，
+修改磁盘文件内容上传到服务器就可以生成网页，
+让大家更易于同时维护本地和网站的内容。
+
+目标用户：
+* 网址导航站经营者、收藏夹/网址分享者
+* 小说网站经营者、小说创作者、博客主、作家、自媒体人
+* 图片网站经营者、摄影师、摄影爱好者、驴友
+* 视频网站经营者、播客、摄影师、航拍爱好者、运动爱好者、潜水爱好者
+
+
+
+## 使用流程
+
+filesite使用非常简单，一旦部署好之后，以后只需将本地最新内容上传覆盖即可。
+
+1. 下载filesite源码，并参考文档部署到你的服务器上；
+2. 修改配置文件config/app.php，简单设置后上传到服务器完成部署；
+3. 将本地内容目录及文件上传到网站目录：data/
+4. 打开网址浏览最新内容；
+
+有了filesite，你可以保留现有的本地内容创作习惯，并非常容易地把它们制作成一个网站分享给他人。
+
+
+## 在线体验
+## 源码下载
+## 皮肤下载
+## 使用手册
+## 反馈与建议
+## 赞助捐赠
+
+
+
+---------------------------------------------
+
+# filesite.io使用手册
+
+## 目录和文件说明
+
+### 命名规则
+
+目录和文件名可以包含中文、英文、数字和下划线、中划线等字符，
+符合Windows、Linux、MacOS操作系统文件命名规范即可。
+
+
+### 文件类型及其说明
+
+文件类型及其最大文件大小建议：
+
+| 后缀 | 类型 | 最大建议 |
+| ---- | ---- | ---- |
+| .txt | 纯文本 | 100K |
+| .md  | 纯文本 | 5M |
+| .url | 快捷方式 | 20K |
+| .jpg | 图片 | 500K |
+| .png | 图片 | 500K |
+| .gif | 图片 | 500K |
+| .ico | 图标 | 50K |
+| .mp4 | 视频 | 100M |
+| .ts  | 视频 | 10M |
+| .m3u8 | 视频 | 10M |
+
+
+文件类型及其可用范围说明：
+
+| 后缀 | 类型 | 读取内容 | 内容可用范围 | 网址可用范围 | 防盗链 |
+| ---- | ---- | ---- | ---- |
+| .txt | 纯文本 | 是 | 全局 | 无 | 无 |
+| .md  | 纯文本 | 是 | 详情页 | 无 | 无 |
+| .url | 快捷方式 | 是 | 列表页 | 无 | 无 |
+| .jpg | 图片| 否 | 无 | 全局 | 是 |
+| .png | 图片| 否 | 无 | 全局 | 是 |
+| .gif | 图片| 否 | 无 | 全局 | 是 |
+| .ico | 图标| 否 | 无 | 全局 | 是 |
+| .mp4 | 视频| 否 | 无 | 全局 | 是 |
+| .ts  | 视频| 否 | 无 | 全局 | 是 |
+| .m3u8 | 视频| 否 | 无 | 全局 | 是 |
+
+其中.txt纯文本文件为说明性文件，可以用来包含标题、描述、关键词等信息；
+.md纯文本文件为详细内容文件，如：文章内容、视频详细介绍等；
+.url快捷方式文件请遵守URL文件格式规范；
+
+只有.txt，.md和.url格式的文件会在网页展示它的内容，
+其它格式的文件则以相对网址形式展示，不读取文件内容。
+
+
+
+## 数据结构
+
+### 目录
+
+```
+[    
+    'directory' => '倚天屠龙记',
+    'realpath' => '/www/webroot/content/倚天屠龙记/',
+    'path' => '/list/?dir=倚天屠龙记',
+    'snapshot' => '/content/倚天屠龙记封面图.jpg',
+    'files' => [...]
+]
+```
+
+### 文件
+
+```
+[
+    'filename' => '第一章',
+    'realpath' => '/www/webroot/content/倚天屠龙记/第一章.md',
+    'path' => '/view/?file=第一章',
+    'extension' => 'md',
+    'fstat' => [...],       //同php方法fstat: https://www.php.net/manual/en/function.fstat.php
+    'content' => '文章内容...',
+    'description' => '文章简介...',
+    'keywords' => '文章关键词...',
+    'snapshot' => '/content/倚天屠龙记/第一章封面图.jpg',
+]
+```
+
+不同类型文件的path相对网址不一样，详情对照文件类型与path网址对照表：
+
+| 后缀 | path网址 |
+| ---- | ---- |
+| .md  | /view/?file={filename} |
+| .url | /link/?file={filename} |
+| .m3u8 | /m3u8/?file={filename}&{防盗链参数} |
+| .jpg | /{相对路径}/{filename}.{extension}?{防盗链参数} |
+| .png | /{相对路径}/{filename}.{extension}?{防盗链参数} |
+| .gif | /{相对路径}/{filename}.{extension}?{防盗链参数} |
+| .ico | /{相对路径}/{filename}.{extension}?{防盗链参数} |
+| .mp4 | /{相对路径}/{filename}.{extension}?{防盗链参数} |
+| .ts  | /{相对路径}/{filename}.{extension}?{防盗链参数} |
+
+.txt，.md和.url 3 种特殊文件类型：
+* .txt文件是其它所有文件的描述文件，不会出现在文件列表里；
+* .md会读取文件内容并存储在content字段里；
+* .url读取文件内容并存储在shortcut字段里；
+
+
+### URL快捷方式
+
+```
+[
+    'filename' => 'filesite.io',
+    'realpath' => '/www/webroot/content/网址导航/filesite.io.url',
+    'path' => '/link/?file=filesite.io',
+    'extension' => 'url',
+    'fstat' => [...],       //同php方法fstat: https://www.php.net/manual/en/function.fstat.php
+    'shortcut' => [    
+        'name' => 'filesite.io',
+        'url' => 'https://filesite.io',
+    ],
+]
+```
+
+URL快捷方式文件是一类特殊的文件，它比一般的文件多了一个字段：shortcut。
+
+
+
+## 字段说明
+
+字段名采用小写英文字符串，除了下面列出来的还可以自定义。
+
+描述文件和被描述的文件命名规则：
+```
+被描述文件名_{字段名}.txt
+```
+
+示例：
+```
+|_d_ 金庸小说
+     |_f_ 第一章.md
+     |_f_ 第一章_description.txt
+     |_f_ 第一章_keywords.txt
+     |_f_ 第二章.md
+     |_f_ 第二章_price.txt
+```
+
+
+对整个目录数据读取后所有资源跟数据字段对照表：
+
+| 资源 | 字段 |
+| ---- | ---- |
+| 目录名 | directory |
+| 文件名 | filename |
+| 完整路径 | realpath |
+| 相对网址 | path |
+| 文件后缀 | extension |
+| 资源状态 | fstat |
+| MD文件内容 | content |
+| URL快捷方式 | shortcut |
+
+
+特殊描述文件名称和字段对照表：
+
+| 文件名 | 用途 | 字段 |
+| ---- | ---- | ---- |
+| description.txt | 描述信息 | description |
+| keywords.txt | 关键词信息 | keywords |
+| snapshot.txt | 快照图片 | snapshot |
+
+特殊描述文件都是可选的，如果有则优先使用里面的内容。
+
+示例：
+```
+|_d_ 金庸小说
+     |_f_ description.txt
+     |_f_ keywords.txt
+     |_f_ snapshot.txt
+     |_f_ 金庸小说封面图_1.jpg
+     |_f_ 金庸小说封面图_new.png
+```
+
+
+
+## 目录结构约定
+
+### 示例说明
+
+* 用字母**d**代表目录，字母**f**代表文件
+* 文件或目录名从空格字符后一位开始到行末
+
+
+### 导航目录和文件结构示例
+
+示例：
+```
+-d- 小说
+  |_d_ 金庸小说
+       |_f_ 最爱金庸网站图标.ico
+       |_f_ 最爱金庸.url
+  |_d_ 古龙小说
+       |_f_ 最爱古龙网站图标.ico
+       |_f_ 最爱古龙.url
+-d- 图片
+  |_d_ 图片搜索
+       |_f_ 谷歌图片搜索图标.ico
+       |_f_ 谷歌图片搜索.url
+       |_f_ description.txt
+  |_d_ 必应图片搜索
+       |_f_ bing图标.ico
+       |_f_ bing.url
+       |_f_ title.txt
+```
+
+
+
+### 图书目录和文件结构示例
+
+示例：
+```
+-d- 金庸小说
+  |_f_ 金庸封面.jpg
+  |_d_ 天龙八部
+  |_d_ 射雕英雄传
+       |_f_ 射雕英雄传封面.jpg
+       |_f_ 第一章.md
+       |_f_ 第二章.md
+       |_f_ 第三章.md
+-d- 古龙小说
+  |_f_ 古龙封面.jpg
+  |_d_ 多情剑客无情剑
+  |_d_ 楚留香
+       |_f_ 楚留香封面.jpg
+       |_f_ 第一章.md
+       |_f_ 第二章.md
+       |_f_ 第三章.md
+       .
+       .
+       .
+```
+
+
+### 图片目录和文件结构示例
+
+示例：
+```
+-d- 动物
+  |_d_ 宠物狗
+       |_f_ 吉娃娃01.jpg
+       |_f_ 吉娃娃02.jpg
+       |_f_ 吉娃娃03.jpg
+  |_d_ 兔子
+       |_f_ 大白兔01.jpg
+       |_f_ 大白兔02.jpg
+       |_f_ 大白兔03.jpg
+       .
+       .
+       .
+-d- 植物
+  |_d_ 鲜花
+       |_d_ 玫瑰花
+            |_f_ 玫瑰01.jpg
+            |_f_ 玫瑰02.jpg
+            |_f_ 玫瑰03.jpg
+       |_d_ 菊花
+            |_f_ 菊花01.jpg
+            |_f_ 菊花02.jpg
+            |_f_ 菊花03.jpg
+       .
+       .
+       .
+```
+
+
+
+### 视频目录和文件结构示例
+
+示例：
+```
+-d- 电影
+  |_d_ 科幻片
+       |_d_ 钢铁侠
+            |_f_ 钢铁侠.mp4
+            |_f_ 封面图.jpg
+            |_f_ 简介.md
+            |_f_ title.txt
+            |_f_ description.txt
+            |_f_ keywords.txt
+  |_d_ 战争片
+       |_d_ 拯救大兵瑞恩
+            |_f_ 拯救大兵瑞恩.m3u8
+            |_f_ 封面图.jpg
+            |_f_ 简介.md
+            |_f_ 001.ts
+            |_f_ 002.ts
+            |_f_ 003.ts
+       .
+       .
+       .
+-d- 综艺
+    .
+    .
+    .
+```
+
+
+
+## 皮肤设计
+
+### 皮肤设计规范
+
+
+### 皮肤共享提交
+
+