mirror of
https://github.com/iconify/collections-json.git
synced 2024-11-08 06:15:22 +00:00
Update readme in version 1 for archive
This commit is contained in:
parent
5208805f6b
commit
fb7c04c7f4
62
readme.md
62
readme.md
@ -1,19 +1,26 @@
|
||||
# Iconify icons collection in JSON format
|
||||
|
||||
This is collection of SVG icons created by various authors, released under various free licenses. Some collections require attribution when used for commercial purposes. See [collections.md](./collections.md) for list of collections and their licenses.
|
||||
This is collection of SVG icons created by various authors, released under various open source licenses. Some collections require attribution when used for commercial purposes. See [collections.md](./collections.md) for list of collections and their licenses.
|
||||
|
||||
All SVG icons have been cleaned up. Content has been optimized, colors for monotone icons have been replaced with currentColor, ready to be inserted in HTML. Tools used for creating this collection are available on [Iconify GitHub repository](https://github.com/iconify), more specifically [@iconify/tools](https://github.com/iconify/tools). You can use it to create your own JSON packages from custom icon sets.
|
||||
|
||||
This library is intended to be used in packages that build components, such as [Iconify Tools](https://github.com/iconify/tools) and [Iconify React](https://github.com/iconify/iconify-react).
|
||||
This library is intended to be used in packages that generate icons. See [Iconify icon sets documentation](https://docs.iconify.design/icons/all.html).
|
||||
|
||||
Repository is updated 3 times a week by fully automated script, so it always contains latest icons from various sources.
|
||||
## Archive
|
||||
|
||||
This branch is archived version 1, which is no longer maintained.
|
||||
|
||||
See `master` branch for updated version.
|
||||
|
||||
Difference from updated version is:
|
||||
|
||||
- In new version `collections.json` uses slightly different format, see [IconifyInfo type documentation](https://docs.iconify.design/types/iconify-json-metadata.html).
|
||||
- In new version Node.js functions are asynchronous.
|
||||
|
||||
## How to get this repository
|
||||
|
||||
Instructions below are for Node.js and PHP projects.
|
||||
|
||||
|
||||
#### Node.js
|
||||
|
||||
Run this command to add icons to your project:
|
||||
@ -27,13 +34,12 @@ Icons will be available in node_modules/@iconify/json
|
||||
To resolve filename for any json file, use this:
|
||||
|
||||
```js
|
||||
const icons = require('@iconify/json');
|
||||
const icons = require("@iconify/json");
|
||||
|
||||
// returns location of fa.json
|
||||
let fa = icons.locate('fa');
|
||||
// returns location of mdi.json
|
||||
let fa = icons.locate("mdi");
|
||||
```
|
||||
|
||||
|
||||
#### PHP
|
||||
|
||||
Install and initialize Composer project. See documentation at [https://getcomposer.org](https://getcomposer.org)
|
||||
@ -61,10 +67,9 @@ To resolve filename for any json file, use this:
|
||||
|
||||
```php
|
||||
// returns location of fa.json
|
||||
$fa = \Iconify\IconsJSON\Finder::locate('fa');
|
||||
$fa = \Iconify\IconsJSON\Finder::locate('mdi');
|
||||
```
|
||||
|
||||
|
||||
## Format
|
||||
|
||||
Icons used by Iconify are in directory json, in Iconify JSON format.
|
||||
@ -73,7 +78,6 @@ Why JSON instead of SVG? To load images in bulk.
|
||||
|
||||
If you need individual SVG images, you can generate them using Iconify JSON Tools. See instructions for [PHP version](https://github.com/iconify/json-tools.php) or [Node.js version](https://github.com/iconify/json-tools.js).
|
||||
|
||||
|
||||
Format of json file is very simple:
|
||||
|
||||
```js
|
||||
@ -98,37 +102,40 @@ Format of json file is very simple:
|
||||
"icons" object contains list of all icons.
|
||||
|
||||
Each icon has following properties:
|
||||
* body - icon body
|
||||
* width - width in pixels
|
||||
* height - height in pixels
|
||||
* rotate - rotation. Default = 0. Values: 0 = 0deg, 1 = 90deg, 2 = 180deg, 3 = 270deg
|
||||
* hFlip - horizontal flip. Boolean value, default = false
|
||||
* vFlip - vertical flip. Boolean value, default = false
|
||||
* hidden - If set to true, icon is hidden. That means icon was removed from collection for some reason, but it is kept in JSON file to prevent applications that rely on old icon from breaking
|
||||
|
||||
- body - icon body
|
||||
- width - width in pixels
|
||||
- height - height in pixels
|
||||
- rotate - rotation. Default = 0. Values: 0 = 0deg, 1 = 90deg, 2 = 180deg, 3 = 270deg
|
||||
- hFlip - horizontal flip. Boolean value, default = false
|
||||
- vFlip - vertical flip. Boolean value, default = false
|
||||
- hidden - If set to true, icon is hidden. That means icon was removed from collection for some reason, but it is kept in JSON file to prevent applications that rely on old icon from breaking
|
||||
|
||||
Width or height might be missing. If icon does not have width or height, use default width or height from root object.
|
||||
rotate, hFlip and vFlip are all optional.
|
||||
|
||||
Optional "aliases" object contains list of aliases for icons. Format is similar to "icons" object, with additional property "parent" that points to parent icon. Any other properties overwrite properties of parent icon.
|
||||
|
||||
For more information see developer documentation on [https://iconify.design/docs/json-icon-format/](https://iconify.design/docs/json-icon-format/)
|
||||
|
||||
For more information see developer documentation on [IconifyJSON documentation](https://docs.iconify.design/types/iconify-json.html)
|
||||
|
||||
## Extracting individual SVG icons
|
||||
|
||||
See JSON tools readme for instructions for [PHP](https://github.com/iconify/json-tools.php) or [Node.js](https://github.com/iconify/json-tools.js).
|
||||
|
||||
```js
|
||||
const fs = require('fs');
|
||||
const {SVG, Collection} = require('@iconify/json-tools');
|
||||
const fs = require("fs");
|
||||
const { SVG, Collection } = require("@iconify/json-tools");
|
||||
|
||||
let collection = new Collection();
|
||||
collection.loadIconifyCollection('mdi');
|
||||
collection.listIcons(true).forEach(icon => {
|
||||
collection.loadIconifyCollection("mdi");
|
||||
collection.listIcons(true).forEach((icon) => {
|
||||
let svg = new SVG(collection.getIconData(icon));
|
||||
fs.writeFileSync('mdi-' + icon + '.svg', svg.getSVG({
|
||||
height: 'auto'
|
||||
}));
|
||||
fs.writeFileSync(
|
||||
"mdi-" + icon + ".svg",
|
||||
svg.getSVG({
|
||||
height: "auto",
|
||||
})
|
||||
);
|
||||
});
|
||||
```
|
||||
|
||||
@ -146,7 +153,6 @@ foreach ($collection->listIcons(true) as $icon) {
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
## License
|
||||
|
||||
This is collection of works by various authors, not original collection.
|
||||
|
Loading…
Reference in New Issue
Block a user