schrottkatze/karton
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases 2 Packages Wiki Activity

Merge pull request #104 from alex3305/cleanup-readme

Browse source 
Clean up README
This commit is contained in:
Dániel Szabó 2022-11-14 21:28:21 +02:00 committed by GitHub
commit 6564499c98
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 21 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
README.MD
View file

@ -13,15 +13,19 @@ MicroBin is a super tiny, feature rich, configurable, self-contained and self-ho
Install from Cargo: Install from Cargo:
`cargo install microbin` ```bash
cargo install microbin
```
And run with your custom configuration: And run with your custom configuration:
`microbin --port 8080 --public-path https://myserver.net --highlightsyntax --editable` ```bash
microbin --port 8080 --public-path https://myserver.net --highlightsyntax --editable
```
Or get the Docker image from [Dockerhub: danielszabo99/microbin](https://hub.docker.com/r/danielszabo99/microbin) Or get the Docker Image from [Dockerhub: danielszabo99/microbin](https://hub.docker.com/r/danielszabo99/microbin).
On our website [microbin.eu](microbin.eu) you will find the following: On our website [microbin.eu](https://microbin.eu) you will find the following:
- [Screenshots](https://microbin.eu/screenshots/) - [Screenshots](https://microbin.eu/screenshots/)
- [Quickstart Guide](https://microbin.eu/quickstart/) - [Quickstart Guide](https://microbin.eu/quickstart/)
@ -29,31 +33,34 @@ On our website [microbin.eu](microbin.eu) you will find the following:
- [Donations and Sponsorhip](https://microbin.eu/donate/) - [Donations and Sponsorhip](https://microbin.eu/donate/)
- [Community](https://microbin.eu/community/) - [Community](https://microbin.eu/community/)
### Features ## Features
- Is very small - Is very small
- Entirely self-contained executable, MicroBin is a single file! - Entirely self-contained executable, MicroBin is a single file!
- Animal names instead of random numbers for pasta identifiers (64 animals) - Animal names instead of random numbers for pasta identifiers (64 animals)
- File uploads (eg. server.com/file/pig-dog-cat) - File uploads (eg. `server.com/file/pig-dog-cat`)
- Raw text serving (eg. server.com/raw/pig-dog-cat) - Raw text serving (eg. `server.com/raw/pig-dog-cat`)
- URL shortening and redirection - URL shortening and redirection
- QR code support - QR code support
- Very simple database (JSON + files) for portability, easy backups and integration - Very simple database (JSON + files) for portability, easy backups and integration
- Listing and manually removing pastas (/pastalist) - Listing and manually removing pastas (`/pastalist`)
- Private and public, editable and final, automatically and never expiring pastas - Private and public, editable and final, automatically and never expiring pastas
- Syntax highlighting - Syntax highlighting
- Automatic dark mode and custom styling support with very little CSS and only vanilla JS (see [water.css](https://github.com/kognise/water.css)) - Automatic dark mode and custom styling support with very little CSS and only vanilla JS (see [`water.css`](https://github.com/kognise/water.css))
- Most of the above can be toggled on and off! - Most of the above can be toggled on and off!
### What is a "pasta" anyway? ## What is a "pasta" anyway?
In MicroBin, a pasta can be:
In microbin, a pasta can be:
- A text that you want to paste from one machine to another, eg. some code, - A text that you want to paste from one machine to another, eg. some code,
- A file that you want to share, eg. a video that is too large for Discord, a zip with a code project in it or an image, - A file that you want to share, eg. a video that is too large for Discord, a zip with a code project in it or an image,
- A URL redirect. - A URL redirect.
### When is MicroBin useful? ## When is MicroBin useful?
You can use MicroBin:
You can use MicroBin
- As a URL shortener/redirect service, - As a URL shortener/redirect service,
- To send long texts to other people, - To send long texts to other people,
- To send large files to other people, - To send large files to other people,
@ -64,8 +71,6 @@ You can use MicroBin
...and many other things, why not get creative? ...and many other things, why not get creative?
### License MicroBin and MicroBin.eu are available under the [BSD 3-Clause License](LICENSE).
MicroBin and MicroBin.eu are available under the BSD 3-Clause License.
© Dániel Szabó 2022 © Dániel Szabó 2022