octicons_v2 0.0.0.pre.37939a1 → 0.0.0.pre.64504fa

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e522d268d6afdff1b4a8fa3c561861fc910e27caa7a350419105885fa410a34b
-  data.tar.gz: ef1a9d92aa150aa191696b17cd31e844b2e0abcc2287dabaa0d140de89ee0c9e
+  metadata.gz: 23385c80d4c2f97fe9c19e4f6a1a03e7aea10aea6e7ff67fb8da16af0501160e
+  data.tar.gz: bdd69a8f64a6434fb8c7d948fa445ec3f89ca274ff6f3d691baeca594de3b5fb
 SHA512:
-  metadata.gz: 8268b900a55500197d7933580038f4c47a76ad4750c1e8ffad26b9a92290d2940e86d858ca2651f033e255da74362159d879c3f779a85d58407237f00492c3e2
-  data.tar.gz: 24fd0f2dbd1ba309475c97d04204ec947acdf54d3cb16bc85494283bffa9d6739f301c9f1adf19ce0615fe1a6bd9401cd3ef8161bd6520c51d71f5bed6e95ef6
+  metadata.gz: c83924dab838c22732674e038cd295067f5a70ef3bf764a2d263ee23d02d6a20888f9f9a6292ce2de6696843a9cda3303cfa87457f016d4f8eedb9568f8d871c
+  data.tar.gz: d60942bc4754963d4af82fef460f5a79eea4783c6280ce3df2f481e0c82c7339573014a726501af8a20e873d0ffeb22448979fa3d26b1ca92c3aaffcea76364e

data/README.md

@@ -1,5 +1,119 @@
-# octicons 
+# Octicons gem
 
 [![Gem version](https://img.shields.io/gem/v/octicons.svg)](https://rubygems.org/gems/octicons)
+[![Build Status](https://travis-ci.org/primer/octicons.svg?branch=master)](https://travis-ci.org/primer/octicons)
 
-See https://primer.style/octicons/packages/ruby
+> Octicons gem to distribute octicons svg
+
+## Install
+
+Add this to your `Gemfile`
+
+```rb
+gem 'octicons'
+```
+
+Then `bundle install`.
+
+## Usage
+
+```rb
+require 'octicons'
+icon = Octicons::Octicon.new("x")
+icon.to_svg
+# <svg class="octicon octicon-x" viewBox="0 0 16 16" width="16" height="16" version="1.1" "aria-hidden"="true"><path d="M7.48 8l3.75 3.75-1.48 1.48L6 9.48l-3.75 3.75-1.48-1.48L4.52 8 .77 4.25l1.48-1.48L6 6.52l3.75-3.75 1.48 1.48z"></path></svg>
+```
+
+## Documentation
+
+The `Octicon` class takes two arguments. The first is the symbol of the icon, and the second is a hash of arguments representing html attributes
+
+#### `symbol` _(required)_
+
+This is the name of the octicon you want to use. For example `alert`. [Full list of icons][octicons-docs]
+
+#### Options
+
+* `:height` - When setting the height to a number, the icon will scale to that size. For example, passing `32`, will calculate the width based on the icon's natural size.
+* `:width` - When setting the width to a number, the icon will scale to that size. For example, passing `32`, will calculate the width based on the icon's natural size.
+
+If both `:width, :height` are passed into the options hash, then the icon will be sized exactly at those dimensions.
+
+#### Attributes
+
+Once initialized, you can read a few properties from the icon.
+
+##### `symbol`
+
+Returns the string of the symbol name
+
+```rb
+icon = Octicons::Octicon.new("x")
+icon.symbol
+# "x"
+```
+
+##### `path`
+
+Path returns the string representation of the path of the icon.
+
+```rb
+icon = Octicons::Octicon.new("x")
+icon.path
+# <path d="M7.48 8l3.75 3.75-1.48 1.48L6 9.48l-3.75 3.75-1.48-1.48L4.52 8 .77 4.25l1.48-1.48L6 6.52l3.75-3.75 1.48 1.48z"></path>
+```
+
+##### `options`
+
+This is a hash of all the `options` that will be added to the output tag.
+
+```rb
+icon = Octicons::Octicon.new("x")
+icon.options
+# {:class=>"octicon octicon-x", :viewBox=>"0 0 12 16", :version=>"1.1", :width=>12, :height=>16, :"aria-hidden"=>"true"}
+```
+
+##### `width`
+
+Width is the icon's true width. Based on the svg view box width. _Note, this doesn't change if you scale it up with size options, it only is the natural width of the icon_
+
+##### `height`
+
+Height is the icon's true height. Based on the svg view box height. _Note, this doesn't change if you scale it up with size options, it only is the natural height of the icon_
+
+##### `keywords`
+
+Returns an array of keywords for the icon. The data comes from the [data file in lib](../data.json). Consider contributing more aliases for the icons.
+
+```rb
+icon = Octicons::Octicon.new("x")
+icon.keywords
+# ["remove", "close", "delete"]
+```
+
+#### Methods
+
+##### `to_svg`
+
+Returns a string of the svg tag
+
+```rb
+icon = Octicons::Octicon.new("x")
+icon.to_svg
+# <svg class="octicon octicon-x" viewBox="0 0 16 16" width="16" height="16" version="1.1" "aria-hidden"="true"><path d="M7.48 8l3.75 3.75-1.48 1.48L6 9.48l-3.75 3.75-1.48-1.48L4.52 8 .77 4.25l1.48-1.48L6 6.52l3.75-3.75 1.48 1.48z"></path></svg>
+```
+
+## Documentation
+
+For a full list of options available, see the [octicons_gem documentation](../octicons_gem/#documentation)
+
+## License
+
+(c) GitHub, Inc.
+
+When using the GitHub logos, be sure to follow the [GitHub logo guidelines](https://github.com/logos).
+
+[MIT](./LICENSE)  
+
+[octicons]: https://github.com/primer/octicons
+[octicons-docs]: https://octicons.github.com/