Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/laurentrdc/hakyll-images
Hakyll utilities to work with images
https://github.com/laurentrdc/hakyll-images
hakyll image-processing images web
Last synced: 14 days ago
JSON representation
Hakyll utilities to work with images
- Host: GitHub
- URL: https://github.com/laurentrdc/hakyll-images
- Owner: LaurentRDC
- License: bsd-3-clause
- Created: 2018-12-16T16:36:43.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-10T17:58:06.000Z (7 months ago)
- Last Synced: 2024-10-25T04:27:43.453Z (22 days ago)
- Topics: hakyll, image-processing, images, web
- Language: Haskell
- Homepage:
- Size: 3.93 MB
- Stars: 18
- Watchers: 5
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# hakyll-images
[](http://hackage.haskell.org/package/hakyll-images)
## A Haskell package containing utilities to deal with images in the context of Hakyll
[Hakyll](https://hackage.haskell.org/package/hakyll) is a static website compiler library. As one of the benefits of static websites is their small size, this repository aims at providing utilities to work with images in the context of Hakyll. Example usage includes:
* Re-encoding Jpeg images at a lower quality to make them much smaller;
* Re-sizing images to fit within a certain shape;
## Usage
`hakyll-images` is meant to be integrated within a Hakyll program. Here are some examples within a Hakyll program:
```haskell
import Hakyll
import Hakyll.Images ( loadImage
, compressJpgCompiler
, resizeImageCompiler
, scaleImageCompiler
)
(...)
hakyll $ do
-- Compress all source Jpegs to a Jpeg quality of 50 (maximum of 100)
match "images/**.jpg" $ do
route idRoute
compile $ loadImage
>>= compressJpgCompiler 50
-- Resize all profile pictures to 64x48
-- Aspect ratio might be mangled
match "profiles/**.jpg" $ do
route idRoute
compile $ loadImage
>>= resizeImageCompiler 64 48
>>= compressJpgCompiler 50
-- Scale images to fit within a 600x400 box
-- Aspect ratio will be preserved
match "images/**.png" $ do
route idRoute
compile $ loadImage
>>= scaleImageCompiler 600 400
(...)
```
Take a look at the [documentation](hackage.haskell.org/package/hakyll-images) for more usage examples.
If you would like a feature added, consider creating [an issue on Github](https://github.com/LaurentRDC/hakyll-images/issues/)
## Installation
### From Hackage
`hakyll-images` is available on [Hackage](https://hackage.haskell.org). Using the [`cabal-install`](https://www.haskell.org/cabal/) tool:
```bash
cabal update
cabal install hakyll-images
```
### From source
Building from source can be done using [`stack`](https://docs.haskellstack.org/en/stable/README/) or [`cabal`](https://www.haskell.org/cabal/):
```bash
git clone github.com/LaurentRDC/hakyll-images.git
cd hakyll-images
stack install # Alternatively, `cabal install`
```
## Documentation
The documentation for the latest release is available on the [Hackage page](http://hackage.haskell.org/package/hakyll-images/).
## Support Issues / Feature requests
All support requests (e.g. installation issues, unclear documentation, bugs, etc.) should of [filed on Github as an issue](https://github.com/LaurentRDC/hakyll-images/issues/)
## License
This package is made available under the BSD 3-clause license. For more details, see the [LICENSE.md](https://github.com/LaurentRDC/hakyll-images/blob/master/LICENSE.md)