Clean up README
* microbin.eu reference was not working * Consistent MicroBin spelling * Link to LICENSE * Clean up whitespace * Insert codeblocks * Set heading 2 instead of heading 3 (as h1 was already used by the title, next in line would be h2) * Set monospace for some references
This commit is contained in:
parent
76cfc906ef
commit
53326b0435
1 changed files with 23 additions and 17 deletions
40
README.MD
40
README.MD
|
@ -11,15 +11,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/)
|
||||||
|
@ -27,31 +31,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,
|
||||||
|
@ -62,9 +69,8 @@ You can use MicroBin
|
||||||
|
|
||||||
...and many other things, why not get creative?
|
...and many other things, why not get creative?
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
### 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
|
|
||||||
|
|
Loading…
Reference in a new issue