Skip to content

Commit e162e11

Browse files
authored
add UrlTree and update od_app (#190)
* add new pulgins * fix baidu docs * add New OneDrive_App Docs * fix od_app * fix * add UrlTree and update od_app * 补充驱动启用签名说明 * update od_app docs
1 parent 1faa9cd commit e162e11

File tree

9 files changed

+613
-2
lines changed

9 files changed

+613
-2
lines changed
8.46 KB
Loading

docs/guide/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ A file list program that supports multiple storage, and supports web browsing an
5858
- [x] [Seafile](https://www.seafile.com/)
5959
- [x] Cloudreve
6060
- [x] [Trainbit](https://trainbit.com/)
61+
- [x] [UrlTree](../guide/drivers/urltree.md)
6162

6263

6364
### Discussion

docs/guide/drivers/UrlTree.md

Lines changed: 276 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,276 @@
1+
---
2+
# This is the icon of the page
3+
icon: state
4+
# This control sidebar order
5+
order: 33
6+
# A page can have multiple categories
7+
category:
8+
- Guide
9+
# A page can have multiple tags
10+
tag:
11+
- Storage
12+
- Guide
13+
# this page is sticky in article list
14+
sticky: true
15+
# this page will appear in starred articles
16+
star: true
17+
---
18+
# UrlTree
19+
20+
:::tip
21+
**`UrlTree`** What is it? It is used to mount a single file link. For details, you can check **→→→[Original Requirements Description](https://github.com/alist-org/alist/issues/3268)←←←**
22+
:::
23+
24+
25+
26+
## usage
27+
28+
Let me briefly explain the specific usage. It is recommended to look at the different usages below. The more advanced the gameplay
29+
30+
Don't look at the writing, it looks difficult and long-winded, but in fact, you can understand it in seconds if you operate it yourself.
31+
32+
:::tabs#UrlTree
33+
@tab 1
34+
35+
<Badge text="1" type="info" vertical="middle" />The simplest usage, just write the link directly
36+
37+
##### input
38+
39+
```
40+
http://pic.rmb.bdstatic.com/bjh/aff9c9c8817d943d6857a73188958d45.jpeg
41+
https://raw.githubusercontent.com/alist-org/alist/main/README_cn.md
42+
```
43+
44+
##### output
45+
46+
```
47+
│ aff9c9c8817d943d6857a73188958d45.jpeg
48+
│ README_cn.md
49+
```
50+
51+
52+
53+
@tab 2
54+
55+
<Badge text="2" type="info" vertical="middle" />While there are files, you can also create folders ^the first code example^, or you can create multiple folders ^the second code example^
56+
57+
##### input
58+
59+
```
60+
http://pic.rmb.bdstatic.com/bjh/aff9c9c8817d943d6857a73188958d45.jpeg
61+
folder:
62+
http://pic.rmb.bdstatic.com/bjh/aff9c9c8817d943d6857a73188958d45.jpeg
63+
https://raw.githubusercontent.com/alist-org/alist/main/README_cn.md
64+
```
65+
66+
```
67+
http://pic.rmb.bdstatic.com/bjh/aff9c9c8817d943d6857a73188958d45.jpeg
68+
folder:
69+
http://pic.rmb.bdstatic.com/bjh/aff9c9c8817d943d6857a73188958d45.jpeg
70+
https://raw.githubusercontent.com/alist-org/alist/main/README_cn.md
71+
http://pic.rmb.bdstatic.com/bjh/a66923e9bfefd03c2998ee998d3b55e7.jpeg
72+
folde2r:
73+
http://pic.rmb.bdstatic.com/bjh/e919290bf3b8396817d369cedf33b8cd.jpeg
74+
https://raw.githubusercontent.com/alist-org/alist/main/CONTRIBUTING.md
75+
```
76+
77+
##### output
78+
79+
```
80+
│ aff9c9c8817d943d6857a73188958d45.jpeg
81+
└─folder
82+
aff9c9c8817d943d6857a73188958d45.jpeg
83+
README_cn.md
84+
```
85+
86+
```
87+
│ aff9c9c8817d943d6857a73188958d45.jpeg
88+
├─folder
89+
│ aff9c9c8817d943d6857a73188958d45.jpeg
90+
│ README_cn.md
91+
92+
├─ a66923e9bfefd03c2998ee998d3b55e7.jpeg
93+
94+
└─folder2
95+
CONTRIBUTING.md
96+
e919290bf3b8396817d369cedf33b8cd.jpeg
97+
```
98+
99+
There must be two blank spaces at the beginning~
100+
101+
102+
103+
@tab 3
104+
105+
<Badge text="3" type="info" vertical="middle" />You can rename the file resource, in fact, the downloaded one is still the original one, and you can fill in the file size
106+
107+
Format: `new name.suffix:file size:link`
108+
109+
```
110+
new namejpeg:1024:http://pic.rmb.bdstatic.com/bjh/aff9c9c8817d943d6857a73188958d45.jpeg
111+
new name2.md:2048:https://raw.githubusercontent.com/alist-org/alist/main/README_cn.md
112+
```
113+
114+
The size of the file is not written, and it can also be renamed
115+
116+
```
117+
new name.jpeg:1024:http://pic.rmb.bdstatic.com/bjh/aff9c9c8817d943d6857a73188958d45.jpeg
118+
new name2.md:2048:https://raw.githubusercontent.com/alist-org/alist/main/README_cn.md
119+
```
120+
121+
122+
123+
@tab 4
124+
125+
<Badge text="4" type="info" vertical="middle" />Matryoshka doll usage of multiple levels of directories
126+
127+
- The first-level directory folder does not need spaces, but the files in the first-level directory need to be empty with two spaces.
128+
129+
```
130+
folder:
131+
http://pic.rmb.bdstatic.com/bjh/aff9c9c8817d943d6857a73188958d45.jpeg
132+
https://raw.githubusercontent.com/alist-org/alist/main/README_cn.md
133+
```
134+
135+
- If you have written the first layer and want to put another one in the first folder, then put a layer under this folder, the writing method is as follows, very simple
136+
- The directory is empty with two spaces, and the file is four if you add two spaces. If you continue to want to go down one level and continue to add 2 spaces
137+
138+
```
139+
folder11:
140+
http://pic.rmb.bdstatic.com/bjh/111.jpeg
141+
folder111:
142+
http://pic.rmb.bdstatic.com/bjh/111.jpeg
143+
folder1111:
144+
http://pic.rmb.bdstatic.com/bjh/111.jpeg
145+
folder222:
146+
http://pic.rmb.bdstatic.com/bjh/222.jpeg
147+
folder2222:
148+
http://pic.rmb.bdstatic.com/bjh/222.jpeg
149+
folder22:
150+
http://pic.rmb.bdstatic.com/bjh/222.jpeg
151+
folder222:
152+
http://pic.rmb.bdstatic.com/bjh/222.jpeg
153+
folder2222:
154+
http://pic.rmb.bdstatic.com/bjh/2223.jpeg
155+
folder33:
156+
http://pic.rmb.bdstatic.com/bjh/333.jpeg
157+
folder333:
158+
http://pic.rmb.bdstatic.com/bjh/333.jpeg
159+
folder3333:
160+
http://pic.rmb.bdstatic.com/bjh/333.jpeg
161+
```
162+
163+
164+
165+
- It is not recommended to write like **`2.jpeg, 5.jpeg`**, it is recommended to go to that layer of folders to add links according to the format, not like the following error example to write
166+
167+
##### incorrect usage
168+
169+
```
170+
folder22:
171+
http://pic.rmb.bdstatic.com/bjh/222.jpeg
172+
folder222:
173+
http://pic.rmb.bdstatic.com/bjh/222.jpeg
174+
folder2222:
175+
http://pic.rmb.bdstatic.com/bjh/2222.jpeg
176+
folder22222:
177+
http://pic.rmb.bdstatic.com/bjh/2222.jpeg
178+
folder222222:
179+
http://pic.rmb.bdstatic.com/bjh/2222.jpeg
180+
http://pic.rmb.bdstatic.com/bjh/2.jpeg
181+
http://pic.rmb.bdstatic.com/bjh/5.jpeg
182+
```
183+
184+
##### correct usage
185+
186+
When files like **`2.jpeg, 5.jpeg`** are added, they are added to the corresponding directory, which correspond to the two folders `folder222 and folder22222` respectively
187+
188+
```
189+
folder22:
190+
http://pic.rmb.bdstatic.com/bjh/222.jpeg
191+
folder222:
192+
http://pic.rmb.bdstatic.com/bjh/222.jpeg
193+
http://pic.rmb.bdstatic.com/bjh/2.jpeg
194+
folder2222:
195+
http://pic.rmb.bdstatic.com/bjh/2222.jpeg
196+
folder22222:
197+
http://pic.rmb.bdstatic.com/bjh/2222.jpeg
198+
http://pic.rmb.bdstatic.com/bjh/5.jpeg
199+
folder222222:
200+
http://pic.rmb.bdstatic.com/bjh/2222.jpeg
201+
```
202+
203+
@tab 5
204+
205+
<Badge text="5" type="info" vertical="middle" />All integrated example usages include conventional, classified, rename, and marked file size
206+
207+
```
208+
https://jsd.nn.ci/gh/alist-org/alist/README.md
209+
document
210+
Readme.md:https://pic.rmb.bdstatic.com/bjh/说明.md
211+
Doc:
212+
document.doc:https://pic.rmb.bdstatic.com/bjh/测试文档.doc
213+
pdf:
214+
pdf2.pdf:https://pic.rmb.bdstatic.com/bjh/测试.pdf
215+
Excel:
216+
Excel3.xlsx:https://pic.rmb.bdstatic.com/bjh/测试表格.xlsx
217+
video:
218+
https://pic.rmb.bdstatic.com/bjh/222.jpeg
219+
TV drama:
220+
https://pic.rmb.bdstatic.com/bjh/222.pm4
221+
Movie:
222+
https://pic.rmb.bdstatic.com/bjh/222.flv
223+
music
224+
https://pic.rmb.bdstatic.com/bjh/222.jpeg
225+
classical
226+
https://pic.rmb.bdstatic.com/bjh/222.mp3
227+
Light music:
228+
https://pic.rmb.bdstatic.com/bjh/222.flac
229+
https://pic.rmb.bdstatic.com/bjh/222.wav
230+
software
231+
https://pic.rmb.bdstatic.com/bjh/222.jpeg
232+
crack:
233+
xxexe.exe:252525:https://pic.rmb.bdstatic.com/bjh/222.exe
234+
xxinstall.zip:259555:https://pic.rmb.bdstatic.com/bjh/222.zip
235+
IPA:
236+
GPT.ipa:https://pic.rmb.bdstatic.com/bjh/222.ipa
237+
APK:
238+
Ps.apk:https://pic.rmb.bdstatic.com/bjh/222.apk
239+
```
240+
241+
242+
243+
244+
245+
:::
246+
247+
## Tips
248+
249+
1. If you click download and find that there is no jump to download but preview, it is because it is determined according to your original link. For example, your original link is download and it will jump to download
250+
2. If you have the same file in a folder, it will be merged and only one will be displayed. By default, the preview is used to view and download your upper (front) or top file.
251+
- Tips: Do not create two files/folders with the same name in the same directory at the same time~ Just like you create two files/folders with the same name in the resource manager, you will be reminded not to repeat
252+
3. If you write two folders with the same name in the same directory when you add them, they will be merged into one folder, but the files in the lower (lower) folder will not be displayed after the merge, but you can view them through the browser Address bar access (refer to the previous tip)
253+
4. By default, the sorting is based on what you fill in from top to bottom, which is the same as `alist-alias`
254+
255+
256+
257+
### The default download method used
258+
259+
```mermaid
260+
---
261+
title: Which download method is used by default?
262+
---
263+
flowchart TB
264+
style a1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
265+
style a2 fill:#ff7575,stroke:#333,stroke-width:4px
266+
subgraph ide1 [ ]
267+
a1
268+
end
269+
a1[302]:::someclass====|default|a2[user equipment]
270+
classDef someclass fill:#f96
271+
c1[local proxy]-.alternative.->a2[user equipment]
272+
b1[Download proxy URL]-.alternative.->a2[user equipment]
273+
click a1 "../drivers/common.html#webdav-policy"
274+
click b1 "../drivers/common.html#webdav-policy"
275+
click c1 "../drivers/common.html#webdav-policy"
276+
```

docs/guide/drivers/common.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,16 @@ When there are multiple accounts, it is used for sorting, The smaller the more f
3030

3131
Anything you want to fill in, which is just for reminding you what this storage is
3232

33+
## Enable signing
34+
35+
Sign and encrypt files (no password required), only valid for this driver, if other signatures are not enabled and `signature all` and `meta-information encryption` are not set, others will not be signed
36+
37+
Usage scenario: I don't want to enable all signatures, and I don't want to set metadata encryption. I just want to sign and encrypt a certain driver to prevent it from being scanned.
38+
39+
Scope of influence: `Settings-->Global-->Signature All` > `Metainformation Directory Encryption` > `Single Driver Signature`
40+
3341
### Cache Expiration
42+
3443
Cache time of directory structure.
3544

3645
### Web proxy

docs/guide/drivers/onedrive_app.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Please read carefully the following **`serial numbers , are added in sequence`**
6161

6262
@tab 2
6363

64-
Let's get a client secret key, just get it as shown in the figure below, remember<Badge text="secret ID" type="info" vertical="middle" />save in time, it will only appear once
64+
Let's get a client secret key, just get it as shown in the figure below, remember<Badge text="secret key" type="info" vertical="middle" />save in time, it will only appear once
6565

6666
![onedriveapp](/img/drivers/onedrive_app/onedrive_app3.png)
6767

@@ -85,6 +85,7 @@ matters needing attention
8585
- How to check whether the authorization is successful. If it is not authorized, the page will prompt `The application has not been found to have the authorization of the administrator's permission`. After the authorization is successful, refresh the page and you will see three API permissions, as shown in the figure below
8686
- The above is what it looks like when it is not authorized, and the following is what it looks like after authorization (just refresh the page after authorization)
8787

88+
8889
![onedriveapp](/img/drivers/onedrive_app/onedrive_app7.png)
8990

9091
@tab 5
@@ -99,6 +100,14 @@ https://login.microsoftonline.com/{tenant ID or common}/adminConsent?client_id={
99100

100101
![onedriveapp](/img/drivers/onedrive_app/onedrive_app6.png)
101102

103+
If you log in according to the spelled link and find that you are redirected to a blank page, such as the sample code and picture below, the authorization is successful, don’t worry
104+
105+
```
106+
https://entra.microsoft.com/TokenAuthorize?admin_consent=True&tenant={Tenant ID}#
107+
```
108+
109+
![onedriveapp](/img/drivers/onedrive_app/od_app_ok.png)
110+
102111
:::
103112

104113

@@ -111,6 +120,10 @@ Fill in the values obtained in the above process one by one. If you don’t know
111120

112121

113122

123+
<BiliBili bvid="BV1Ro4y1s725" ratio="16:9" low-quality no-danmaku />
124+
125+
126+
114127
## View all users of the organization
115128

116129
If you don't know how many users there are in your OneDrive organization, you can go to the link below to log in to the `admin` account to view
@@ -121,6 +134,12 @@ If you don't know how many users there are in your OneDrive organization, you ca
121134

122135

123136

137+
## Error message
138+
139+
- Tips:**Either scp or roles claim need to be present in the token** Error
140+
141+
because you didn't do it in step `4` <Badge text="grant xxx administrator consent" type="info" vertical="middle" /> caused by,Pay attention to the tips below the fourth step
142+
124143
### The default download method used
125144

126145
```mermaid

docs/zh/guide/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ category:
5656
- [x] [Seafile](https://www.seafile.com/)
5757
- [x] Cloudreve
5858
- [x] [Trainbit](https://trainbit.com/)
59+
- [x] [UrlTree](../guide/drivers/urltree.md)
5960

6061
## Discussion
6162

0 commit comments

Comments
 (0)