Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/MatrixAges/picpic

A awesome image host service driven by github pages and github actions.
https://github.com/MatrixAges/picpic

bed gh-pages images picgo picpic picture

Last synced: about 1 month ago
JSON representation

A awesome image host service driven by github pages and github actions.

Awesome Lists containing this project

README

        

picpic logo

#

picpic

_

An awesome image host service driven by github pages and github actions.

_


attitude_img
version_img
size_img
style_img
License

## Doc

[EN](https://github.com/MatrixAges/picpic#readme) | [中文文档](https://github.com/MatrixAges/picpic/blob/master/readme_cn.md)

## Installation

Install via npm:

```bash
$ npm i @matrixage/picpic
```

## Usage

To use picpic, by below steps:

- mkdir a folder & cd it
- `npm init` & press enter through
- `npm i @matrixage/picpic`
- `"init": "picpic init"` into package.json `scripts`
- `npm run init`
- drop you images to `assets` folder
- `git commit` & `git push` to you github

then active your gh-pages.

if your acccout do not active github actions, you should active github actions and git push again to trigger delopy process.

if your github repo first branch is master,please change the branch in .github/workflows/ci.yml (main => master)

## Features

- click image to preview detail
- preview images in folder mode
- mobile is avaible

also, more you can explore:

- list mode
- search
- navigator
- minim file system

if you have more demands, and if you think your demands reasonal, you can talk to me.

## Config

```json
{
// supported images type
"types": ["svg", "png", "jpg", "jpeg", "gif", "webp"],

// enable imagemin,compress : false, disable imagemin,compress
// support compress jpg、png and gif
"compress": {
// image quality 0.1 - 1
"quality": 0.8,
// if true, webp,jpg、png will be compress by imagemin-webp
"webp": false
},

// file folder load depth
"depth": 12
}
```

## Accessibility

Picpic supports the all modern browsers,and you can preview picpic images in chrome or firefox.

## License

Picpic is licensed under the MIT license. (http://opensource.org/licenses/MIT)