Prepare documentation for release
This commit is contained in:
parent
f8de1c8e44
commit
95f8827b41
5 changed files with 37 additions and 29 deletions
|
|
@ -1,8 +1,6 @@
|
||||||
language: rust
|
language: rust
|
||||||
rust:
|
rust:
|
||||||
|
- 1.6.0
|
||||||
- stable
|
- stable
|
||||||
- beta
|
- beta
|
||||||
- nightly
|
- nightly
|
||||||
matrix:
|
|
||||||
allow_failures:
|
|
||||||
- rust: nightly
|
|
||||||
|
|
|
||||||
|
|
@ -1,8 +0,0 @@
|
||||||
v 0.0.1 (unreleased)
|
|
||||||
- Initial alpha release
|
|
||||||
- Reduce color type
|
|
||||||
- Recompress with zlib
|
|
||||||
- Multithreading
|
|
||||||
- Strip headers
|
|
||||||
- Backup file before writing
|
|
||||||
- Write to stdout
|
|
||||||
8
CHANGELOG.md
Normal file
8
CHANGELOG.md
Normal file
|
|
@ -0,0 +1,8 @@
|
||||||
|
v 0.1.0
|
||||||
|
- Initial beta release
|
||||||
|
- Reduce color type and bit depth
|
||||||
|
- Recompress with zlib
|
||||||
|
- Multithreading
|
||||||
|
- Strip headers option
|
||||||
|
- Backup file before writing option
|
||||||
|
- Write to stdout option
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
[package]
|
[package]
|
||||||
name = "oxipng"
|
name = "oxipng"
|
||||||
version = "0.0.1"
|
version = "0.1.0"
|
||||||
authors = ["Joshua Holmer <jholmer.in@gmail.com>"]
|
authors = ["Joshua Holmer <jholmer.in@gmail.com>"]
|
||||||
|
|
||||||
[dependencies]
|
[dependencies]
|
||||||
|
|
|
||||||
44
README.md
44
README.md
|
|
@ -1,34 +1,34 @@
|
||||||
# OxiPng
|
# OxiPng
|
||||||
|
|
||||||
[](https://travis-ci.org/shssoichiro/oxipng)
|
[](https://travis-ci.org/shssoichiro/oxipng)
|
||||||
|
[](https://coveralls.io/github/shssoichiro/oxipng?branch=master)
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
OxiPng is a PNG compression optimizer. **Note:** This package is not yet complete. DO NOT use on any files without backing them up first.
|
OxiPng is a lossless PNG compression optimizer.
|
||||||
|
|
||||||
In the typical use case, OxiPng recompresses PNG image files
|
**Note:** This package should be considered a beta. Although there are many tests in place,
|
||||||
losslessly and performs PNG integrity checks and corrections.
|
there is still a chance of data loss or corruption. You should backup your files before
|
||||||
Future implementation of other features is planned.
|
using this tool, unless you are very brave.
|
||||||
|
|
||||||
## History
|
If you encounter an issue, please report it via the GitHub issues tab. Include as many details
|
||||||
|
as possible.
|
||||||
|
|
||||||
OxiPng began as a completely rewrite of the OptiPNG project,
|
## Installing
|
||||||
which is assumed to be dead as no commit has been made to it since 2013.
|
|
||||||
The name has been changed to avoid confusion and potential legal issues.
|
|
||||||
|
|
||||||
The core goal of rewriting OptiPNG was to implement multithreading,
|
OxiPng can be installed from Cargo, via the following command:
|
||||||
which would be very difficult to do within the existing C codebase of OptiPNG.
|
```
|
||||||
This also served as an opportunity to choose a more modern, safer language (Rust).
|
cargo install oxipng
|
||||||
|
```
|
||||||
|
|
||||||
## Building
|
Alternatively, OxiPng can be built from source using the latest stable or nightly Rust:
|
||||||
|
|
||||||
Building OxiPng can be done using the latest stable or nightly Rust with Cargo installed, as follows:
|
|
||||||
```
|
```
|
||||||
git clone https://github.com/shssoichiro/oxipng.git
|
git clone https://github.com/shssoichiro/oxipng.git
|
||||||
cd oxipng
|
cd oxipng
|
||||||
cargo build --release
|
cargo build --release
|
||||||
cp target/release/oxipng /usr/local/bin
|
cp target/release/oxipng /usr/local/bin
|
||||||
```
|
```
|
||||||
|
|
||||||
Please note that zlib is a required build dependency. OxiPng should work with any 1.x version of zlib,
|
Please note that zlib is a required build dependency. OxiPng should work with any 1.x version of zlib,
|
||||||
but you are advised to use the latest version (currently 1.2.8) for security and bug fixes.
|
but you are advised to use the latest version (currently 1.2.8) for security and bug fixes.
|
||||||
|
|
||||||
|
|
@ -52,19 +52,29 @@ to give any extra compression gains and is not recommended.
|
||||||
PNG interlacing on any images that are processed. `-i 0` will remove interlacing from all
|
PNG interlacing on any images that are processed. `-i 0` will remove interlacing from all
|
||||||
processed images. Not specifying either will keep the same interlacing state as the
|
processed images. Not specifying either will keep the same interlacing state as the
|
||||||
input image. Note: Interlacing can add 25-50% to the size of an optimized image. Only use
|
input image. Note: Interlacing can add 25-50% to the size of an optimized image. Only use
|
||||||
it if you have a good reason.
|
it if you have a good reason. (*Not Yet Implemented*)
|
||||||
* Strip: Used to remove metadata info from processed images. Used via `--strip` or `-s`.
|
* Strip: Used to remove metadata info from processed images. Used via `--strip` or `-s`.
|
||||||
Can save a few kilobytes if you don't need the metadata.
|
Can save a few kilobytes if you don't need the metadata.
|
||||||
|
|
||||||
More advanced options can be found by running `oxipng -h`.
|
More advanced options can be found by running `oxipng -h`.
|
||||||
|
|
||||||
|
## History
|
||||||
|
|
||||||
|
OxiPng began as a completely rewrite of the OptiPNG project,
|
||||||
|
which is assumed to be dead as no commit has been made to it since 2013.
|
||||||
|
The name has been changed to avoid confusion and potential legal issues.
|
||||||
|
|
||||||
|
The core goal of rewriting OptiPNG was to implement multithreading,
|
||||||
|
which would be very difficult to do within the existing C codebase of OptiPNG.
|
||||||
|
This also served as an opportunity to choose a more modern, safer language (Rust).
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
Any contributions are welcome and will be accepted via pull request on GitHub. Bug reports can be
|
Any contributions are welcome and will be accepted via pull request on GitHub. Bug reports can be
|
||||||
filed via GitHub issues. If you have the capability to submit a fix with the bug report, it is
|
filed via GitHub issues. If you have the capability to submit a fix with the bug report, it is
|
||||||
preferred that you do so via pull request, however you do not need to be a Rust programmer to
|
preferred that you do so via pull request, however you do not need to be a Rust programmer to
|
||||||
submit a bug report. Other contributions (such as improving documentation or translations)
|
contribute. Other contributions (such as improving documentation or translations) are also
|
||||||
are also welcome via GitHub.
|
welcome via GitHub.
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue