docs/manual.md

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格式的文件会在网页展示它的内容， 其它格式的文件则以相对网址形式展示，不读取文件内容。

数据结构

目录

[
    'id' => '根据完整路径生成的唯一编号',
    'directory' => '倚天屠龙记',
    'realpath' => '/www/webroot/content/倚天屠龙记/',
    'path' => '/list/?dir=倚天屠龙记',
    'snapshot' => '/content/倚天屠龙记封面图.jpg',
    'files' => [...],         //文件列表
    'directories' => [...]    //目录列表
]

文件

[
    'id' => '根据完整路径生成的唯一编号',
    '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- 综艺
    .
    .
    .

皮肤设计

皮肤设计规范

皮肤共享提交