d49651638bc2d3e98cafc50243bafb9113ffd2d9e32f9d6e6a5a0edf37dd8754a3f794077e091ca4bafb5e8b54d7e7877892d22fa31a95730d89f59ea11151 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155
  1. [english](https://github.com/svg/svgo/blob/master/README.md) | **русский**
  2. - - -
  3. <img src="https://svg.github.io/svgo-logo.svg" width="200" height="200" alt="logo"/>
  4. ## SVGO [![NPM version](https://badge.fury.io/js/svgo.svg)](https://npmjs.org/package/svgo) [![Dependency Status](https://gemnasium.com/svg/svgo.svg)](https://gemnasium.com/svg/svgo) [![Build Status](https://secure.travis-ci.org/svg/svgo.svg)](https://travis-ci.org/svg/svgo) [![Coverage Status](https://img.shields.io/coveralls/svg/svgo.svg)](https://coveralls.io/r/svg/svgo?branch=master)
  5. **SVG** **O**ptimizer – это инструмент для оптимизации векторной графики в формате SVG, написанный на Node.js.
  6. ![](https://mc.yandex.ru/watch/18431326)
  7. ## Зачем?
  8. SVG-файлы, особенно – экспортированные из различных редакторов, содержат много избыточной и бесполезной информации, комментариев, скрытых элементов, неоптимальные или стандартные значения и другой мусор, удаление которого безопасно и не влияет на конечный результат отрисовки.
  9. ## Возможности
  10. SVGO имеет расширяемую архитектуру, в которой почти каждая оптимизация является отдельным расширением.
  11. Сегодня у нас есть:
  12. | Plugin | Description |
  13. | ------ | ----------- |
  14. | [cleanupAttrs](https://github.com/svg/svgo/blob/master/plugins/cleanupAttrs.js) | удаление переносов строк и лишних пробелов |
  15. | [removeDoctype](https://github.com/svg/svgo/blob/master/plugins/removeDoctype.js) | удаление doctype |
  16. | [removeXMLProcInst](https://github.com/svg/svgo/blob/master/plugins/removeXMLProcInst.js) | удаление XML-инструкций |
  17. | [removeComments](https://github.com/svg/svgo/blob/master/plugins/removeComments.js) | удаление комментариев |
  18. | [removeMetadata](https://github.com/svg/svgo/blob/master/plugins/removeMetadata.js) | удаление `<metadata>` |
  19. | [removeTitle](https://github.com/svg/svgo/blob/master/plugins/removeTitle.js) | удаление `<title>` (выключено по умолчанию) |
  20. | [removeDesc](https://github.com/svg/svgo/blob/master/plugins/removeDesc.js) | удаление `<desc>` (по умолчанию только незначимых) |
  21. | [removeUselessDefs](https://github.com/svg/svgo/blob/master/plugins/removeUselessDefs.js) | удаление элементов в `<defs>` без `id` |
  22. | [removeXMLNS](https://github.com/svg/svgo/blob/master/plugins/removeXMLNS.js) | удаление атрибута xmlns (для заинлайненных svg, выключено по умолчанию) |
  23. | [removeEditorsNSData](https://github.com/svg/svgo/blob/master/plugins/removeEditorsNSData.js) | удаление пространств имён различных редакторов, их элементов и атрибутов |
  24. | [removeEmptyAttrs](https://github.com/svg/svgo/blob/master/plugins/removeEmptyAttrs.js) | удаление пустых атрибутов |
  25. | [removeHiddenElems](https://github.com/svg/svgo/blob/master/plugins/removeHiddenElems.js) | удаление скрытых элементов |
  26. | [removeEmptyText](https://github.com/svg/svgo/blob/master/plugins/removeEmptyText.js) | удаление пустых текстовых элементов |
  27. | [removeEmptyContainers](https://github.com/svg/svgo/blob/master/plugins/removeEmptyContainers.js) | удаление пустых элементов-контейнеров |
  28. | [removeViewBox](https://github.com/svg/svgo/blob/master/plugins/removeViewBox.js) | удаление атрибута `viewBox`, когда это возможно |
  29. | [cleanupEnableBackground](https://github.com/svg/svgo/blob/master/plugins/cleanupEnableBackground.js) | удаление или оптимизация атрибута `enable-background`, когда это возможно |
  30. | [minifyStyles](https://github.com/svg/svgo/blob/master/plugins/minifyStyles.js) | уменьшает содержимое элементов `<style>` с помощью [CSSO](https://github.com/css/csso). |
  31. | [convertStyleToAttrs](https://github.com/svg/svgo/blob/master/plugins/convertStyleToAttrs.js) | конвертирование стилей в атрибуте `style` в отдельные svg-атрибуты |
  32. | [convertColors](https://github.com/svg/svgo/blob/master/plugins/convertColors.js) | конвертирование цветовых значений: из `rgb()` в `#rrggbb`, из `#rrggbb` в `#rgb` |
  33. | [convertPathData](https://github.com/svg/svgo/blob/master/plugins/convertPathData.js) | конвертирование данных Path в относительные или абсолютные координаты, смотря что |короче; конвертирование одних типов сегментов в другие; удаление ненужных разделителей; умное округление и тому подобное
  34. | [convertTransform](https://github.com/svg/svgo/blob/master/plugins/convertTransform.js) | схлопывание нескольких трансформаций в одну, конвертирование матриц в короткие алиасы |и многое другое
  35. | [removeUnknownsAndDefaults](https://github.com/svg/svgo/blob/master/plugins/removeUnknownsAndDefaults.js) | удаление неизвестных элементов, контента и атрибутов |
  36. | [removeNonInheritableGroupAttrs](https://github.com/svg/svgo/blob/master/plugins/removeNonInheritableGroupAttrs.js) | удаление ненаследуемых "презентационных" атрибутов групп |
  37. | [removeUselessStrokeAndFill](https://github.com/svg/svgo/blob/master/plugins/removeUselessStrokeAndFill.js) | удаление неиспользуемых атрибутов stroke-* и fill-* |
  38. | [removeUnusedNS](https://github.com/svg/svgo/blob/master/plugins/removeUnusedNS.js) | удаление деклараций неиспользуемых пространств имён |
  39. | [cleanupIDs](https://github.com/svg/svgo/blob/master/plugins/cleanupIDs.js) | удаление неиспользуемых и сокращение используемых ID |
  40. | [cleanupNumericValues](https://github.com/svg/svgo/blob/master/plugins/cleanupNumericValues.js) | округление дробных чисел до заданной точности, удаление `px` как единицы |измерения по-умолчанию
  41. | [cleanupListOfValues](https://github.com/svg/svgo/blob/master/plugins/cleanupListOfValues.js) | округление числовых значений в атрибутах со списком чисел, таких как `viewBox` |или `enableBackground`
  42. | [moveElemsAttrsToGroup](https://github.com/svg/svgo/blob/master/plugins/moveElemsAttrsToGroup.js) | перемещение совпадающих атрибутов у всех элементов внутри группы `<g>` |
  43. | [moveGroupAttrsToElems](https://github.com/svg/svgo/blob/master/plugins/moveGroupAttrsToElems.js) | перемещение некоторых атрибутов группы на элементы внутри |
  44. | [collapseGroups](https://github.com/svg/svgo/blob/master/plugins/collapseGroups.js) | схлопывание бесполезных групп `<g>` |
  45. | [removeRasterImage](https://github.com/svg/svgo/blob/master/plugins/removeRasterImages.js) | удаление растровых изображений (выключено по умолчанию) |
  46. | [mergePaths](https://github.com/svg/svgo/blob/master/plugins/mergePaths.js) | склеивание нескольких Path в одну кривую |
  47. | [convertShapeToPath](https://github.com/svg/svgo/blob/master/plugins/convertShapeToPath.js) | конвертирование простых форм в Path |
  48. | [sortAttrs](https://github.com/svg/svgo/blob/master/plugins/sortAttrs.js) | сортировка атрибутов элементов для удобочитаемости (выключено по умолчанию) |
  49. | [transformsWithOnePath](https://github.com/svg/svgo/blob/master/plugins/transformsWithOnePath.js) | применение трансформаций, обрезка по реальной ширине, вертикальное |выравнивание по центру и изменение размеров SVG с одним Path внутри
  50. | [removeDimensions](https://github.com/svg/svgo/blob/master/plugins/removeDimensions.js) | удаляет атрибуты width/height при наличии viewBox (выключено по умолчанию) |
  51. | [removeAttrs](https://github.com/svg/svgo/blob/master/plugins/removeAttrs.js) | удаляет атрибуты по указанному паттерну (выключено по умолчанию) |
  52. | [removeElementsByAttr](https://github.com/svg/svgo/blob/master/plugins/removeElementsByAttr.js) | удаляет элементы по указанным ID или классам (выключено по умолчанию) |
  53. | [addClassesToSVGElement](https://github.com/svg/svgo/blob/master/plugins/addClassesToSVGElement.js) | добавляет имена классов корневому элементу `<svg>` (выключено по умолчанию) |
  54. | [addAttributesToSVGElement](https://github.com/svg/svgo/blob/master/plugins/addAttributesToSVGElement.js) | добавляет атрибуты корневому элементу `<svg>` (выключено |по умолчанию)
  55. | [removeStyleElement](https://github.com/svg/svgo/blob/master/plugins/removeStyleElement.js) | удаляет элементы `<style>` (выключено по умолчанию) |
  56. Хотите узнать, как это работает и как написать свой плагин? [Конечно же, да!](https://github.com/svg/svgo/blob/master/docs/how-it-works/ru.md).
  57. ## Как использовать
  58. ```sh
  59. $ [sudo] npm install -g svgo
  60. ```
  61. ```
  62. Выполнение:
  63. svgo [OPTIONS] [ARGS]
  64. Параметры:
  65. -h, --help : Помощь
  66. -v, --version : Версия программы
  67. -i INPUT, --input=INPUT : Входной файл, "-" для STDIN
  68. -s STRING, --string=STRING : Входная строка SVG
  69. -f FOLDER, --folder=FOLDER : Входная папка, оптимизирует и перезаписывает все файлы *.svg
  70. -o OUTPUT, --output=OUTPUT : Выходной файл или папка (совпадает с входным по умолчанию), "-" для STDOUT
  71. -p PRECISION, --precision=PRECISION : Число цифр после запятой, переопределяет параметры плагинов
  72. --config=CONFIG : Файл конфигурации (или строка JSON) для расширения и замены настроек
  73. --disable=DISABLE : Выключение плагина по имени
  74. --enable=ENABLE : Включение плагина по имени
  75. --datauri=DATAURI : Результат в виде строки Data URI (base64, URI encoded или unencoded)
  76. --multipass : Оптимизация в несколько проходов
  77. --pretty : Удобочитаемое форматирование SVG
  78. --indent=INDENT : Размер отступа для удобочитаемого форматирования
  79. -q, --quiet : Подавляет вывод информации, выводятся только сообщения об ошибках
  80. --show-plugins : Доступные плагины
  81. Аргументы:
  82. INPUT : Аналогично --input
  83. OUTPUT : Аналогично --output
  84. ```
  85. * с файлами:
  86. $ svgo test.svg
  87. или:
  88. $ svgo test.svg test.min.svg
  89. * со STDIN / STDOUT:
  90. $ cat test.svg | svgo -i - -o - > test.min.svg
  91. * с папками
  92. $ svgo -f ../path/to/folder/with/svg/files
  93. или:
  94. $ svgo -f ../path/to/folder/with/svg/files -o ../path/to/folder/with/svg/output
  95. * со строками:
  96. $ svgo -s '<svg version="1.1">test</svg>' -o test.min.svg
  97. или даже с Data URI base64:
  98. $ svgo -s 'data:image/svg+xml;base64,…' -o test.min.svg
  99. * с SVGZ:
  100. из `.svgz` в `.svg`:
  101. $ gunzip -c test.svgz | svgo -i - -o test.min.svg
  102. из `.svg` в `.svgz`:
  103. $ svgo test.svg -o - | gzip -cfq9 > test.svgz
  104. * с помощью GUI – [svgo-gui](https://github.com/svg/svgo-gui)
  105. * в виде веб-приложения - [SVGOMG](https://jakearchibald.github.io/svgomg/)
  106. * как модуль Node.js – [examples](https://github.com/svg/svgo/tree/master/examples)
  107. * как таск для Grunt – [grunt-svgmin](https://github.com/sindresorhus/grunt-svgmin)
  108. * как таск для Gulp – [gulp-svgmin](https://github.com/ben-eb/gulp-svgmin)
  109. * как таск для Mimosa – [mimosa-minify-svg](https://github.com/dbashford/mimosa-minify-svg)
  110. * как действие папки в OSX – [svgo-osx-folder-action](https://github.com/svg/svgo-osx-folder-action)
  111. * через загрузчик в webpack – [image-webpack-loader](https://github.com/tcoopman/image-webpack-loader)
  112. * с помощью бота в Telegram – [svgo_bot](https://github.com/maksugr/svgo_bot)
  113. * как плагин PostCSS - [postcss-svgo](https://github.com/ben-eb/postcss-svgo)
  114. ## Лицензия и копирайты
  115. Данное программное обеспечение выпускается под [лицензией MIT](https://github.com/svg/svgo/blob/master/LICENSE).
  116. Логотип – [Егор Большаков](http://xizzzy.ru/).