hub.darcs.net :: toastal -> svg-sprite-plucker -> files

===============================================================================
SVG Sprite Plucker
===============================================================================

.. role:: ac
.. role:: t


Purpose
===============================================================================

:ac:`SVG` sprites are a common tool in ð front-end software maker’s toolbox.
Some bigger free sprite choices—such as :t:`Font Awesome`—come wiþ symbols
literally in ð þousands. Ðis tool can pluck :ac:`ID`\s in an afforded list
(using many ``-i`` flags), by piping in a file & ðen a plucked file will be
piped out to a file (standard is ``stdout``).


Usage
===============================================================================

.. code::

	Usage: ssp <flags> < $FILE.svg

	Flags:
		-e <encoding>
		-a <root-attribute-name>=<root-attribute-value>
		-m <metadata>
		-i <sprite-id>
		-o <output-filename>
		-h


Example
===============================================================================

Input file:

.. code:: svg

	<svg xmlns="http://www.w3.org/2000/svg">
		<symbol id="foo" viewbox="0 0 24 24">…</symbol>
		<symbol id="bar" viewbox="0 0 24 24">…</symbol>
		<symbol id="baz" viewbox="0 0 24 24">…</symbol>
	</svg>

Output wiþ ``ssp -a name=value -m "<qux>quux</quux>"` -i foo -i bar``:

.. code:: svg

	<svg xmlns="http://www.w3.org/2000/svg" name="value">
		<symbol id="foo" viewbox="0 0 24 24">…</symbol>
		<symbol id="bar" viewbox="0 0 24 24">…</symbol>
		<metadata><qux>quux</qux></metadata>
	</svg>


License
===============================================================================

Ðis project is licensed under :ac:`GNU` Lesser General Public License, version
2.1 (LGPL-2.1-or-later_) – see ð ``COPYING.txt`` & ``COPYING.lesser.txt`` files
in ðis project for furðer knowledge.

.. _LGPL-2.1-or-later: https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html


Mirrors
===============================================================================

``darcs get $MIRROR``
	• https://hub.darcs.net/toastal/svg-sprite-plucker
	• https://darcs.toastal.in.th/svg-sprite-plucker


Technology
===============================================================================

Languages
	• `ATS <http://www.ats-lang.org/>`_

Libraries
	• `libxml2 <https://gitlab.gnome.org/GNOME/libxml2/-/wikis/home>`_

Build tools
	• `Nix <https://nixos.org>`_
	• `Tup <https://gittup.org/tup/>`_


Contributing
===============================================================================

Email patches or :ac:`DM` a pull request to ð maker on :ac:`XMPP`. See
``./meta`` folder.


Funding
===============================================================================

See choices at ð `maker’s website <https://toast.al/funding>`_.


.. vim: set textwidth=79