octicons_v2 0.0.0.pre.2e689fb → 0.0.0.pre.02f9d7a

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9492dee40769bfa2a1a5c7356f46c0abfc8931a561b08f1351f57eae2af66703
4
- data.tar.gz: 44afe87e8bfbf742769f929c7163adfdb0ede8d64f71df897faedc7277f60a83
3
+ metadata.gz: a1aee7edd4eb9c2b6061fee731298abb940bb05dfd5ee1c0f291da2a1177f68f
4
+ data.tar.gz: ba6dd42e0154246c3d8b59e67532140ac265b44a07aa3aad35c59da0bae1da16
5
5
  SHA512:
6
- metadata.gz: 5c3b68daa997ce2f62d73288092941b58f46135c1bd9d7d3f405ccaf5881c92ee467943f302b102c90eb125d3d8a3649add0b980cdcdcc94aa0efc38095e52d7
7
- data.tar.gz: fbfd4a41e8345ab1edfbe0e5c8463ab873d3a4b0e942022dc5ef27d40d6e4bface1206c8be4b515c4efffa08503578e6c0ec1bb5b9efec932e60cff0554d2365
6
+ metadata.gz: f8e611d19c64419e4b1399dc9214d79a316206e77307fde5c2f86e11e6f05482a07ecf9e7d9dfe123eb3ff9cb2eb44c620976a6370d956dd7351977ca3bce01f
7
+ data.tar.gz: 7a6650c7d35896b034ec65abd16c471812075dc209f27ec11e94510459606f0acfbf6094c3120e6ece7cecee07833bf2fc3d0ecdf526c734ed5f3933114aeb7c
data/README.md CHANGED
@@ -1,5 +1,119 @@
1
- # octicons
1
+ # Octicons gem
2
2
 
3
3
  [![Gem version](https://img.shields.io/gem/v/octicons.svg)](https://rubygems.org/gems/octicons)
4
+ [![Build Status](https://travis-ci.org/primer/octicons.svg?branch=master)](https://travis-ci.org/primer/octicons)
4
5
 
5
- See https://primer.style/octicons/packages/ruby
6
+ > Octicons gem to distribute octicons svg
7
+
8
+ ## Install
9
+
10
+ Add this to your `Gemfile`
11
+
12
+ ```rb
13
+ gem 'octicons'
14
+ ```
15
+
16
+ Then `bundle install`.
17
+
18
+ ## Usage
19
+
20
+ ```rb
21
+ require 'octicons'
22
+ icon = Octicons::Octicon.new("x")
23
+ icon.to_svg
24
+ # <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>
25
+ ```
26
+
27
+ ## Documentation
28
+
29
+ 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
30
+
31
+ #### `symbol` _(required)_
32
+
33
+ This is the name of the octicon you want to use. For example `alert`. [Full list of icons][octicons-docs]
34
+
35
+ #### Options
36
+
37
+ * `: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.
38
+ * `: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.
39
+
40
+ If both `:width, :height` are passed into the options hash, then the icon will be sized exactly at those dimensions.
41
+
42
+ #### Attributes
43
+
44
+ Once initialized, you can read a few properties from the icon.
45
+
46
+ ##### `symbol`
47
+
48
+ Returns the string of the symbol name
49
+
50
+ ```rb
51
+ icon = Octicons::Octicon.new("x")
52
+ icon.symbol
53
+ # "x"
54
+ ```
55
+
56
+ ##### `path`
57
+
58
+ Path returns the string representation of the path of the icon.
59
+
60
+ ```rb
61
+ icon = Octicons::Octicon.new("x")
62
+ icon.path
63
+ # <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>
64
+ ```
65
+
66
+ ##### `options`
67
+
68
+ This is a hash of all the `options` that will be added to the output tag.
69
+
70
+ ```rb
71
+ icon = Octicons::Octicon.new("x")
72
+ icon.options
73
+ # {:class=>"octicon octicon-x", :viewBox=>"0 0 12 16", :version=>"1.1", :width=>12, :height=>16, :"aria-hidden"=>"true"}
74
+ ```
75
+
76
+ ##### `width`
77
+
78
+ 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_
79
+
80
+ ##### `height`
81
+
82
+ 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_
83
+
84
+ ##### `keywords`
85
+
86
+ 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.
87
+
88
+ ```rb
89
+ icon = Octicons::Octicon.new("x")
90
+ icon.keywords
91
+ # ["remove", "close", "delete"]
92
+ ```
93
+
94
+ #### Methods
95
+
96
+ ##### `to_svg`
97
+
98
+ Returns a string of the svg tag
99
+
100
+ ```rb
101
+ icon = Octicons::Octicon.new("x")
102
+ icon.to_svg
103
+ # <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>
104
+ ```
105
+
106
+ ## Documentation
107
+
108
+ For a full list of options available, see the [octicons_gem documentation](../octicons_gem/#documentation)
109
+
110
+ ## License
111
+
112
+ (c) GitHub, Inc.
113
+
114
+ When using the GitHub logos, be sure to follow the [GitHub logo guidelines](https://github.com/logos).
115
+
116
+ [MIT](./LICENSE)
117
+
118
+ [octicons]: https://github.com/primer/octicons
119
+ [octicons-docs]: https://octicons.github.com/