anchors 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.gitignore +9 -0
- data/.rspec +2 -0
- data/.travis.yml +4 -0
- data/Gemfile +4 -0
- data/README.md +51 -0
- data/Rakefile +6 -0
- data/anchors.gemspec +27 -0
- data/bin/console +14 -0
- data/bin/setup +8 -0
- data/lib/anchors.rb +46 -0
- data/lib/anchors/version.rb +3 -0
- metadata +138 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA1:
|
3
|
+
metadata.gz: 163b1b68541c2d11b9189be4a3acf89bc60529d1
|
4
|
+
data.tar.gz: ccf418e7425255accf64119986a923b670236bbd
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: 55a35235e831d45f673385e2b880caccd648029e953e0aba1e4e2e07a9f338e69f3edc431f57a1d3144cba48e3e2c25ef3370893db25429b50035315fa88e88e
|
7
|
+
data.tar.gz: 1e83423313f7de591ae85086bffc583233a808c3ecc17119d78c8e7a93488a420ec7a65e32c3341f0df49ea8dbbfd2811379d4c52475e3dd602f962d825917be
|
data/.gitignore
ADDED
data/.rspec
ADDED
data/.travis.yml
ADDED
data/Gemfile
ADDED
data/README.md
ADDED
@@ -0,0 +1,51 @@
|
|
1
|
+
# ⚓ Anchors ⚓
|
2
|
+
|
3
|
+
This gem will add anchors to all of your websites h1-h6 headers. Its useful for static website generators, like Middleman.
|
4
|
+
|
5
|
+
## Installation
|
6
|
+
|
7
|
+
Add this line to your application's Gemfile:
|
8
|
+
|
9
|
+
```ruby
|
10
|
+
gem 'anchors'
|
11
|
+
```
|
12
|
+
|
13
|
+
And then execute:
|
14
|
+
|
15
|
+
$ bundle
|
16
|
+
|
17
|
+
Or install it yourself as:
|
18
|
+
|
19
|
+
$ gem install anchors
|
20
|
+
|
21
|
+
## Usage
|
22
|
+
|
23
|
+
Just use the middleware from your rack config.ru file or Middleman config.rb file as follows:
|
24
|
+
|
25
|
+
```ruby
|
26
|
+
require "anchors"
|
27
|
+
use Anchors::Middleware
|
28
|
+
```
|
29
|
+
|
30
|
+
and the `body` will automatically have anchors applied to all of the h1-h6 tags.
|
31
|
+
|
32
|
+
If you don't want to apply anchors to all of your requests, just pass a CSS selector into the middleware:
|
33
|
+
|
34
|
+
```ruby
|
35
|
+
require "anchors"
|
36
|
+
use Anchors::Middleware,
|
37
|
+
css: "section.anchorize", # CSS headers are applied to. Defaults to 'body'
|
38
|
+
seperator: "-", # Change the seperator in the header. Defaults to _
|
39
|
+
link: false # Don't convert the headers into links to their own anchors. Defaults to true.
|
40
|
+
```
|
41
|
+
|
42
|
+
## Development
|
43
|
+
|
44
|
+
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
|
45
|
+
|
46
|
+
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
47
|
+
|
48
|
+
## Contributing
|
49
|
+
|
50
|
+
Bug reports and pull requests are welcome on GitHub at https://github.com/bradgessler/anchors.
|
51
|
+
|
data/Rakefile
ADDED
data/anchors.gemspec
ADDED
@@ -0,0 +1,27 @@
|
|
1
|
+
# coding: utf-8
|
2
|
+
lib = File.expand_path('../lib', __FILE__)
|
3
|
+
$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
|
4
|
+
require 'anchors/version'
|
5
|
+
|
6
|
+
Gem::Specification.new do |spec|
|
7
|
+
spec.name = "anchors"
|
8
|
+
spec.version = Anchors::VERSION
|
9
|
+
spec.authors = ["Brad Gessler"]
|
10
|
+
spec.email = ["bradgessler@gmail.com"]
|
11
|
+
|
12
|
+
spec.summary = %q{Add anchors to your h1-h6 tags in Middleman or Rack}
|
13
|
+
spec.homepage = "https://github.com/bradgessler/anchors"
|
14
|
+
|
15
|
+
spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
|
16
|
+
spec.bindir = "exe"
|
17
|
+
spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
|
18
|
+
spec.require_paths = ["lib"]
|
19
|
+
|
20
|
+
spec.add_development_dependency "bundler", "~> 1.11"
|
21
|
+
spec.add_development_dependency "rake", "~> 10.0"
|
22
|
+
spec.add_development_dependency "rspec", "~> 3.0"
|
23
|
+
spec.add_development_dependency "rack"
|
24
|
+
spec.add_development_dependency "rack-test"
|
25
|
+
|
26
|
+
spec.add_dependency "rack-plastic", "~> 0.1.0"
|
27
|
+
end
|
data/bin/console
ADDED
@@ -0,0 +1,14 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
|
3
|
+
require "bundler/setup"
|
4
|
+
require "anchors"
|
5
|
+
|
6
|
+
# You can add fixtures and/or initialization code here to make experimenting
|
7
|
+
# with your gem easier. You can also use a different console, if you like.
|
8
|
+
|
9
|
+
# (If you use this, don't forget to add pry to your Gemfile!)
|
10
|
+
# require "pry"
|
11
|
+
# Pry.start
|
12
|
+
|
13
|
+
require "irb"
|
14
|
+
IRB.start
|
data/bin/setup
ADDED
data/lib/anchors.rb
ADDED
@@ -0,0 +1,46 @@
|
|
1
|
+
require "anchors/version"
|
2
|
+
require "rack-plastic"
|
3
|
+
|
4
|
+
module Anchors
|
5
|
+
class Middleware < Rack::Plastic
|
6
|
+
CSS_SELECTOR = "body"
|
7
|
+
SEPERATOR = "_"
|
8
|
+
LINK = true
|
9
|
+
|
10
|
+
def change_nokogiri_doc(doc)
|
11
|
+
# Throw this CSS class into the HTML page where you
|
12
|
+
# want to have linkable anchor headers.
|
13
|
+
doc.css(css).each do |node|
|
14
|
+
node.css("h1,h2,h3,h4,h5,h6").each do |h|
|
15
|
+
id = dom_id(h)
|
16
|
+
h["id"] = id
|
17
|
+
if link?
|
18
|
+
a = Nokogiri::XML::Node.new "a", doc
|
19
|
+
a["href"] = "##{h["id"]}"
|
20
|
+
a.add_child h.clone
|
21
|
+
h.swap a
|
22
|
+
end
|
23
|
+
end
|
24
|
+
end
|
25
|
+
doc
|
26
|
+
end
|
27
|
+
|
28
|
+
private
|
29
|
+
# Super lame, but awesome way to get CSS options CSS selector.
|
30
|
+
def css
|
31
|
+
options[:css] || CSS_SELECTOR
|
32
|
+
end
|
33
|
+
|
34
|
+
def seperator
|
35
|
+
options[:seperator] || SEPERATOR
|
36
|
+
end
|
37
|
+
|
38
|
+
def link?
|
39
|
+
options[:link] || LINK
|
40
|
+
end
|
41
|
+
|
42
|
+
def dom_id(el)
|
43
|
+
el.content.downcase.gsub(/[^\d\w\s_]/, '').gsub(' ', '_')
|
44
|
+
end
|
45
|
+
end
|
46
|
+
end
|
metadata
ADDED
@@ -0,0 +1,138 @@
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
|
+
name: anchors
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 0.1.0
|
5
|
+
platform: ruby
|
6
|
+
authors:
|
7
|
+
- Brad Gessler
|
8
|
+
autorequire:
|
9
|
+
bindir: exe
|
10
|
+
cert_chain: []
|
11
|
+
date: 2016-02-19 00:00:00.000000000 Z
|
12
|
+
dependencies:
|
13
|
+
- !ruby/object:Gem::Dependency
|
14
|
+
name: bundler
|
15
|
+
requirement: !ruby/object:Gem::Requirement
|
16
|
+
requirements:
|
17
|
+
- - "~>"
|
18
|
+
- !ruby/object:Gem::Version
|
19
|
+
version: '1.11'
|
20
|
+
type: :development
|
21
|
+
prerelease: false
|
22
|
+
version_requirements: !ruby/object:Gem::Requirement
|
23
|
+
requirements:
|
24
|
+
- - "~>"
|
25
|
+
- !ruby/object:Gem::Version
|
26
|
+
version: '1.11'
|
27
|
+
- !ruby/object:Gem::Dependency
|
28
|
+
name: rake
|
29
|
+
requirement: !ruby/object:Gem::Requirement
|
30
|
+
requirements:
|
31
|
+
- - "~>"
|
32
|
+
- !ruby/object:Gem::Version
|
33
|
+
version: '10.0'
|
34
|
+
type: :development
|
35
|
+
prerelease: false
|
36
|
+
version_requirements: !ruby/object:Gem::Requirement
|
37
|
+
requirements:
|
38
|
+
- - "~>"
|
39
|
+
- !ruby/object:Gem::Version
|
40
|
+
version: '10.0'
|
41
|
+
- !ruby/object:Gem::Dependency
|
42
|
+
name: rspec
|
43
|
+
requirement: !ruby/object:Gem::Requirement
|
44
|
+
requirements:
|
45
|
+
- - "~>"
|
46
|
+
- !ruby/object:Gem::Version
|
47
|
+
version: '3.0'
|
48
|
+
type: :development
|
49
|
+
prerelease: false
|
50
|
+
version_requirements: !ruby/object:Gem::Requirement
|
51
|
+
requirements:
|
52
|
+
- - "~>"
|
53
|
+
- !ruby/object:Gem::Version
|
54
|
+
version: '3.0'
|
55
|
+
- !ruby/object:Gem::Dependency
|
56
|
+
name: rack
|
57
|
+
requirement: !ruby/object:Gem::Requirement
|
58
|
+
requirements:
|
59
|
+
- - ">="
|
60
|
+
- !ruby/object:Gem::Version
|
61
|
+
version: '0'
|
62
|
+
type: :development
|
63
|
+
prerelease: false
|
64
|
+
version_requirements: !ruby/object:Gem::Requirement
|
65
|
+
requirements:
|
66
|
+
- - ">="
|
67
|
+
- !ruby/object:Gem::Version
|
68
|
+
version: '0'
|
69
|
+
- !ruby/object:Gem::Dependency
|
70
|
+
name: rack-test
|
71
|
+
requirement: !ruby/object:Gem::Requirement
|
72
|
+
requirements:
|
73
|
+
- - ">="
|
74
|
+
- !ruby/object:Gem::Version
|
75
|
+
version: '0'
|
76
|
+
type: :development
|
77
|
+
prerelease: false
|
78
|
+
version_requirements: !ruby/object:Gem::Requirement
|
79
|
+
requirements:
|
80
|
+
- - ">="
|
81
|
+
- !ruby/object:Gem::Version
|
82
|
+
version: '0'
|
83
|
+
- !ruby/object:Gem::Dependency
|
84
|
+
name: rack-plastic
|
85
|
+
requirement: !ruby/object:Gem::Requirement
|
86
|
+
requirements:
|
87
|
+
- - "~>"
|
88
|
+
- !ruby/object:Gem::Version
|
89
|
+
version: 0.1.0
|
90
|
+
type: :runtime
|
91
|
+
prerelease: false
|
92
|
+
version_requirements: !ruby/object:Gem::Requirement
|
93
|
+
requirements:
|
94
|
+
- - "~>"
|
95
|
+
- !ruby/object:Gem::Version
|
96
|
+
version: 0.1.0
|
97
|
+
description:
|
98
|
+
email:
|
99
|
+
- bradgessler@gmail.com
|
100
|
+
executables: []
|
101
|
+
extensions: []
|
102
|
+
extra_rdoc_files: []
|
103
|
+
files:
|
104
|
+
- ".gitignore"
|
105
|
+
- ".rspec"
|
106
|
+
- ".travis.yml"
|
107
|
+
- Gemfile
|
108
|
+
- README.md
|
109
|
+
- Rakefile
|
110
|
+
- anchors.gemspec
|
111
|
+
- bin/console
|
112
|
+
- bin/setup
|
113
|
+
- lib/anchors.rb
|
114
|
+
- lib/anchors/version.rb
|
115
|
+
homepage: https://github.com/bradgessler/anchors
|
116
|
+
licenses: []
|
117
|
+
metadata: {}
|
118
|
+
post_install_message:
|
119
|
+
rdoc_options: []
|
120
|
+
require_paths:
|
121
|
+
- lib
|
122
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
123
|
+
requirements:
|
124
|
+
- - ">="
|
125
|
+
- !ruby/object:Gem::Version
|
126
|
+
version: '0'
|
127
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
128
|
+
requirements:
|
129
|
+
- - ">="
|
130
|
+
- !ruby/object:Gem::Version
|
131
|
+
version: '0'
|
132
|
+
requirements: []
|
133
|
+
rubyforge_project:
|
134
|
+
rubygems_version: 2.5.1
|
135
|
+
signing_key:
|
136
|
+
specification_version: 4
|
137
|
+
summary: Add anchors to your h1-h6 tags in Middleman or Rack
|
138
|
+
test_files: []
|