60 lines
1.7 KiB
Markdown
60 lines
1.7 KiB
Markdown
|
# `slcl-upload`, upload directories to a `slcl` instance
|
||
|
|
||
|
This repository provides [a convenience tool](slcl-upload) that allows to
|
||
|
upload directories recursively to a
|
||
|
[`slcl`](https://gitea.privatedns.org/xavi/slcl) instance.
|
||
|
|
||
|
## Usage
|
||
|
|
||
|
Given the following example tree structure and a `slcl` instance running on
|
||
|
`https://example.slcl`:
|
||
|
|
||
|
```
|
||
|
$ tree example/
|
||
|
example/
|
||
|
├── another-dir
|
||
|
│ └── important-stuff.txt
|
||
|
├── file.jpg
|
||
|
└── video.mp4
|
||
|
```
|
||
|
|
||
|
`example/` can be uploaded using:
|
||
|
|
||
|
```sh
|
||
|
upload-slcl example / https://example.slcl
|
||
|
```
|
||
|
|
||
|
## Why this tool?
|
||
|
|
||
|
By design, `slcl` uses no JavaScript for its user interface. Unfortunately,
|
||
|
this means there is no way to upload directories, other than requiring users
|
||
|
to create directories manually and then uploading each directory's files
|
||
|
using the HTML form in `slcl`.
|
||
|
|
||
|
## Requisites
|
||
|
|
||
|
- A POSIX.1-2008 environment.
|
||
|
- `bash` (requires use of `local` extension).
|
||
|
- `curl`.
|
||
|
- `perl` and its `URI` module.
|
||
|
|
||
|
## License
|
||
|
|
||
|
```
|
||
|
slcl-upload, a tool to upload directories to a slcl instance.
|
||
|
Copyright (C) 2023 Xavier Del Campo Romero
|
||
|
|
||
|
This program is free software: you can redistribute it and/or modify
|
||
|
it under the terms of the GNU General Public License as published by
|
||
|
the Free Software Foundation, either version 3 of the License, or
|
||
|
(at your option) any later version.
|
||
|
|
||
|
This program is distributed in the hope that it will be useful,
|
||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
|
GNU General Public License for more details.
|
||
|
|
||
|
You should have received a copy of the GNU General Public License
|
||
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||
|
```
|