filesite
/
machete
1
1
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

add links to index titles

master
filesite 3 years ago
parent
9301361d34
commit
8db038d7ac
5 changed files with 363 additions and 300 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 4
      plugins/Parsedown.php
  2. 5
      themes/manual/views/site/index.php
  3. 322
      www/content/Manual.md
  4. 331
      www/content/README.md
  5. 1
      www/css/manual.css

4
plugins/Parsedown.php
Unescape View File

@ -526,6 +526,10 @@ class Parsedown @@ -526,6 +526,10 @@ class Parsedown
'name' => 'h' . min(6, $level),
'text' => $text,
'handler' => 'line',
//h1 - h6标题增加id属性，便于用锚点链接到标题
'attributes' => array(
'id' => urlencode($text),
),
),
);

5
themes/manual/views/site/index.php
Unescape View File

@ -2,7 +2,10 @@ @@ -2,7 +2,10 @@
<?php
if (!empty($viewData['titles'])) {
foreach($viewData['titles'] as $title) {
echo "<{$title['heading']}>{$title['name']}</{$title['heading']}>";
$link = urlencode($title['name']);
echo <<<eof
<{$title['heading']}><a href="#{$link}">{$title['name']}</a></{$title['heading']}>
eof;
}
}
?>

322
www/content/Manual.md
Unescape View File

@ -0,0 +1,322 @@ @@ -0,0 +1,322 @@
# 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/?id={id}',
'snapshot' => '/content/倚天屠龙记封面图.jpg',
'files' => [...], //文件列表
'directories' => [...] //目录列表
]
```
### 文件
```
[
'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网址对照表：
| 后缀 | path网址 |
| ---- | ---- |
| .md | /view/?id={id} |
| .url | /link/?id={id} |
| .m3u8 | /m3u8/?id={id}&{防盗链参数}&ver={更新时间戳} |
| .jpg | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .png | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .gif | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .ico | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .mp4 | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .ts | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
.txt，.md和.url 3 种特殊文件类型：
* .txt文件是其它所有文件的描述文件，不会出现在文件列表里；
* .md会读取文件内容并存储在content字段里；
* .url读取文件内容并存储在shortcut字段里；
### URL快捷方式
```
[
'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。
## 字段说明
字段名采用小写英文字符串，除了下面列出来的还可以自定义。
描述文件和被描述的文件命名规则：
```
被描述文件名_{字段名}.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 |
特殊描述文件都是可选的，如果有则优先使用里面的内容。
说明：
其中snapshot.txt里的内容为跟当前txt文件**同目录的图片文件名**，
如下面示例中snapshot.txt的内容为：
```
金庸小说封面图_new.png
```
示例：
```
|_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- 综艺
.
.
.
```
## 皮肤设计
### 皮肤设计规范
### 皮肤共享提交

331
www/content/README.md
Unescape View File

@ -1,322 +1,55 @@ @@ -1,322 +1,55 @@
# filesite.io - 无数据库、基于文件和目录的网址导航、图书、图片、视频网站PHP开源系统
# filesite.io使用手册
## 简介
## 目录和文件说明
项目名称：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 |
filesite使用非常简单，一旦部署好之后，以后只需将本地最新内容上传覆盖即可。
1. 下载filesite源码，并参考文档部署到你的服务器上；
2. 修改配置文件config/app.php，简单设置后上传到服务器完成部署；
3. 将本地内容目录及文件上传到网站目录：content/
4. 打开网址浏览最新内容；
文件类型及其可用范围说明：
有了filesite，你可以保留现有的本地内容创作习惯，并非常容易地把它们制作成一个网站分享给他人。
| 后缀 | 类型 | 读取内容 | 内容可用范围 | 网址可用范围 | 防盗链 |
| ---- | ---- | ---- | ---- | ---- | ---- |
| .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/?id={id}',
'snapshot' => '/content/倚天屠龙记封面图.jpg',
'files' => [...], //文件列表
'directories' => [...] //目录列表
]
```
## 使用手册
### 文件
见[filesite.io使用手册](./Manual.md)
```
[
'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网址对照表：
| 后缀 | path网址 |
| ---- | ---- |
| .md | /view/?id={id} |
| .url | /link/?id={id} |
| .m3u8 | /m3u8/?id={id}&{防盗链参数}&ver={更新时间戳} |
| .jpg | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .png | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .gif | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .ico | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .mp4 | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
| .ts | /{相对路径}/{filename}.{extension}?{防盗链参数}&ver={更新时间戳} |
.txt，.md和.url 3 种特殊文件类型：
* .txt文件是其它所有文件的描述文件，不会出现在文件列表里；
* .md会读取文件内容并存储在content字段里；
* .url读取文件内容并存储在shortcut字段里；
### URL快捷方式
```
[
'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。
## 字段说明
字段名采用小写英文字符串，除了下面列出来的还可以自定义。
描述文件和被描述的文件命名规则：
```
被描述文件名_{字段名}.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 |
特殊描述文件都是可选的，如果有则优先使用里面的内容。
说明：
其中snapshot.txt里的内容为跟当前txt文件**同目录的图片文件名**，
如下面示例中snapshot.txt的内容为：
```
金庸小说封面图_new.png
```
示例：
```
|_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- 综艺
.
.
.
```
## 皮肤设计
### 皮肤设计规范
### 皮肤共享提交
待续
## 赞助捐赠
待续

1
www/css/manual.css
Unescape View File

@ -7,6 +7,7 @@ @@ -7,6 +7,7 @@
.indexes h1{display:none}
.indexes h2{margin-top:1em}
.indexes h3{text-indent:1em}
.indexes a{background-color:transparent;color:#0969da;text-decoration: none}
@media (max-width: 640px) {
.indexes{position:static;width:auto}
.indexes h1{display:block;padding-bottom:0.3em;text-align:center;font-size:2em;border-bottom:1px solid hsla(210,18%,87%,1)}

Write Preview
Loading…
Cancel
Save