FileSite.io使用手册

目录和文件说明

命名规则

目录和文件名可以包含中文、英文、数字和下划线、中划线等字符， 符合Windows、Linux、MacOS操作系统文件命名规范即可。

文件类型及其说明

文件类型及其最大文件大小建议：

文件类型及其可用范围说明：

其中：

• .txt纯文本文件为说明性文件，可以用来包含标题、描述、关键词等信息；
• .md纯文本文件为详细内容文件，如：文章内容、视频详细介绍等；
• .url快捷方式文件请遵守URL文件格式规范；

只有.txt，.md和.url格式的文件会在网页展示它的内容， 其它格式的文件则以相对网址形式展示，不读取文件内容。

数据结构

目录

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

文件

[
    'id' => '根据完整路径生成的唯一编号',
    'pid' => '父目录id',              //如果有父目录的话
    'filename' => '第一章',
    'realpath' => '/www/webroot/content/倚天屠龙记/第一章.md',
    'path' => '/view/?id={id}',
    'extension' => 'md',
    'fstat' => [...],       //同php方法fstat: https://www.php.net/manual/en/function.fstat.php
    'content' => '文章内容...',
    'description' => '文章简介...',
    'keywords' => '文章关键词...',
    'snapshot' => '/content/倚天屠龙记/第一章封面图.jpg',
]

不同类型文件的path相对网址不一样，详情对照文件类型与path网址对照表：

.txt，.md和.url 3 种特殊文件类型：

• .txt文件是其它所有文件的描述文件，不会出现在文件列表里；
• .md会读取文件内容并存储在content字段里；
• .url读取文件内容并存储在shortcut字段里；

URL快捷方式

.url文件是windows下的一种网页快捷方式文件。

[
    'id' => '根据完整路径生成的唯一编号',
    'pid' => '父目录id',              //如果有父目录的话
    'filename' => 'filesite.io',
    'realpath' => '/www/webroot/content/网址导航/filesite.io.url',
    'path' => '/link/?id={id}',
    'extension' => 'url',
    'fstat' => [...],       //同php方法fstat: https://www.php.net/manual/en/function.fstat.php
    'shortcut' => [    
        'name' => 'filesite.io',
        'url' => 'https://filesite.io',
    ],
]

URL快捷方式文件是一类特殊的文件，它比一般的文件多了一个字段：shortcut。

.url文件内容示例：

[InternetShortcut]
URL=https://microsoft.com/

字段说明

字段名采用小写英文字符串，除了下面列出来的还可以自定义。

对整个目录数据读取后所有资源跟数据字段对照表：

特殊描述文件名称和字段对照表：

特殊描述文件都是可选的，如果有则优先使用里面的内容，其它需要扩展的字段只需添加{英文小写}.txt后缀的文件即可。

说明： 其中snapshot.txt里的内容为跟当前txt文件同目录的图片文件名， 如下面示例中snapshot.txt的内容为：

金庸小说封面图_new.png

示例：

|_d_ 金庸小说
     |_f_ description.txt
     |_f_ keywords.txt
     |_f_ snapshot.txt
     |_f_ 金庸小说封面图_1.jpg
     |_f_ 金庸小说封面图_new.png
     |_f_ author.txt

描述文件和被描述的文件命名规则：

{被描述文件名_}{字段名}.txt

如果{被描述文件名_}为空，则认为该描述文件是用来说明所在目录的。

示例：

|_d_ 金庸小说
     |_f_ 第一章.md
     |_f_ 第一章_description.txt
     |_f_ 第一章_keywords.txt
     |_f_ 第二章.md
     |_f_ 第二章_price.txt
     |_f_ title.txt

目录结构约定

示例说明

• 用字母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- 其它
     |_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- 综艺
    .
    .
    .

皮肤设计

皮肤设计规范

-- 待完善

皮肤共享提交

-- 待完善