html2rss 0.4.1 → 0.5.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 +4 -4
- data/.rubocop.yml +3 -0
- data/CHANGELOG.md +10 -1
- data/Gemfile.lock +3 -1
- data/README.md +35 -2
- data/html2rss.gemspec +1 -0
- data/lib/html2rss/attribute_post_processors/sanitize_html.rb +1 -3
- data/lib/html2rss/config.rb +4 -0
- data/lib/html2rss/item.rb +7 -4
- data/lib/html2rss/utils.rb +8 -0
- data/lib/html2rss/version.rb +1 -1
- metadata +15 -35
- data/docs/Html2rss.html +0 -353
- data/docs/Html2rss/AttributePostProcessors.html +0 -203
- data/docs/Html2rss/AttributePostProcessors/HtmlToMarkdown.html +0 -325
- data/docs/Html2rss/AttributePostProcessors/ParseTime.html +0 -326
- data/docs/Html2rss/AttributePostProcessors/ParseUri.html +0 -314
- data/docs/Html2rss/AttributePostProcessors/SanitizeHtml.html +0 -367
- data/docs/Html2rss/AttributePostProcessors/Substring.html +0 -321
- data/docs/Html2rss/AttributePostProcessors/Template.html +0 -336
- data/docs/Html2rss/Config.html +0 -847
- data/docs/Html2rss/FeedBuilder.html +0 -295
- data/docs/Html2rss/Item.html +0 -660
- data/docs/Html2rss/ItemExtractors.html +0 -297
- data/docs/Html2rss/ItemExtractors/Attribute.html +0 -317
- data/docs/Html2rss/ItemExtractors/CurrentTime.html +0 -297
- data/docs/Html2rss/ItemExtractors/Href.html +0 -319
- data/docs/Html2rss/ItemExtractors/Html.html +0 -314
- data/docs/Html2rss/ItemExtractors/Static.html +0 -301
- data/docs/Html2rss/ItemExtractors/Text.html +0 -312
- data/docs/Html2rss/Utils.html +0 -200
- data/docs/Html2rss/Utils/IndifferentAccessHash.html +0 -142
- data/docs/_index.html +0 -307
- data/docs/class_list.html +0 -51
- data/docs/css/common.css +0 -1
- data/docs/css/full_list.css +0 -58
- data/docs/css/style.css +0 -496
- data/docs/file.README.html +0 -135
- data/docs/file_list.html +0 -56
- data/docs/frames.html +0 -17
- data/docs/index.html +0 -135
- data/docs/js/app.js +0 -303
- data/docs/js/full_list.js +0 -216
- data/docs/js/jquery.js +0 -4
- data/docs/method_list.html +0 -467
- data/docs/top-level-namespace.html +0 -110
data/docs/file.README.html
DELETED
@@ -1,135 +0,0 @@
|
|
1
|
-
<!DOCTYPE html>
|
2
|
-
<html>
|
3
|
-
<head>
|
4
|
-
<meta charset="UTF-8">
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
6
|
-
<title>
|
7
|
-
File: README
|
8
|
-
|
9
|
-
— Documentation by YARD 0.9.20
|
10
|
-
|
11
|
-
</title>
|
12
|
-
|
13
|
-
<link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
|
14
|
-
|
15
|
-
<link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
|
16
|
-
|
17
|
-
<script type="text/javascript" charset="utf-8">
|
18
|
-
pathId = "README";
|
19
|
-
relpath = '';
|
20
|
-
</script>
|
21
|
-
|
22
|
-
|
23
|
-
<script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
|
24
|
-
|
25
|
-
<script type="text/javascript" charset="utf-8" src="js/app.js"></script>
|
26
|
-
|
27
|
-
|
28
|
-
</head>
|
29
|
-
<body>
|
30
|
-
<div class="nav_wrap">
|
31
|
-
<iframe id="nav" src="file_list.html?1"></iframe>
|
32
|
-
<div id="resizer"></div>
|
33
|
-
</div>
|
34
|
-
|
35
|
-
<div id="main" tabindex="-1">
|
36
|
-
<div id="header">
|
37
|
-
<div id="menu">
|
38
|
-
|
39
|
-
<a href="_index.html">Index</a> »
|
40
|
-
<span class="title">File: README</span>
|
41
|
-
|
42
|
-
</div>
|
43
|
-
|
44
|
-
<div id="search">
|
45
|
-
|
46
|
-
<a class="full_list_link" id="class_list_link"
|
47
|
-
href="class_list.html">
|
48
|
-
|
49
|
-
<svg width="24" height="24">
|
50
|
-
<rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
|
51
|
-
<rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
|
52
|
-
<rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
|
53
|
-
</svg>
|
54
|
-
</a>
|
55
|
-
|
56
|
-
</div>
|
57
|
-
<div class="clear"></div>
|
58
|
-
</div>
|
59
|
-
|
60
|
-
<div id="content"><div id='filecontents'>
|
61
|
-
<p><img src="https://github.com/gildesmarais/html2rss/raw/master/support/logo.png"></p>
|
62
|
-
|
63
|
-
<h1 id="label-html2rss+rdoc-image-3Ahttps-3A-2F-2Ftravis-ci.org-2Fgildesmarais-2Fhtml2rss.svg-3Fbranch-3Dmaster+rdoc-image-3Ahttps-3A-2F-2Fbadge.fury.io-2Frb-2Fhtml2rss.svg">html2rss <a href="https://travis-ci.org/gildesmarais/html2rss"><img src="https://travis-ci.org/gildesmarais/html2rss.svg?branch=master"></a> <a href="https://badge.fury.io/rb/html2rss"><img src="https://badge.fury.io/rb/html2rss.svg"></a></h1>
|
64
|
-
|
65
|
-
<p>Request HTML from an URL and transform it to a Ruby RSS 2.0 object.</p>
|
66
|
-
|
67
|
-
<p><strong>Are you searching for a ready to use “website to RSS” solution?</strong> <a href="https://github.com/gildesmarais/html2rss-web">Check out html2rss-web!</a></p>
|
68
|
-
|
69
|
-
<p>Each website needs a <em>feed config</em> which contains the URL to scrape and CSS selectors to extract the required information (like title, URL, …). This gem provides <a href="https://github.com/gildesmarais/html2rss/blob/master/lib/html2rss/item_extractors">extractors</a> (e.g. extract the information from an HTML attribute) and chainable <a href="https://github.com/gildesmarais/html2rss/tree/master/lib/html2rss/attribute_post_processors">post processors</a> to make information retrieval even easier.</p>
|
70
|
-
|
71
|
-
<h2 id="label-Installation">Installation</h2>
|
72
|
-
|
73
|
-
<p>Add this line to your application's Gemfile: <code>gem 'html2rss'</code><br> Then execute: <code>bundle</code></p>
|
74
|
-
|
75
|
-
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_rss'>rss</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Html2rss.html" title="Html2rss (module)">Html2rss</a></span></span><span class='period'>.</span><span class='id identifier rubyid_feed'><span class='object_link'><a href="Html2rss.html#feed-class_method" title="Html2rss.feed (method)">feed</a></span></span><span class='lparen'>(</span>
|
76
|
-
<span class='label'>channel:</span> <span class='lbrace'>{</span> <span class='label'>title:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>StackOverflow: Hot Network Questions</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='label'>url:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>https://stackoverflow.com/questions</span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span><span class='comma'>,</span>
|
77
|
-
<span class='label'>selectors:</span> <span class='lbrace'>{</span>
|
78
|
-
<span class='label'>items:</span> <span class='lbrace'>{</span> <span class='label'>selector:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>#hot-network-questions > ul > li</span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span><span class='comma'>,</span>
|
79
|
-
<span class='label'>title:</span> <span class='lbrace'>{</span> <span class='label'>selector:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>a</span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span><span class='comma'>,</span>
|
80
|
-
<span class='label'>link:</span> <span class='lbrace'>{</span> <span class='label'>selector:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>a</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='label'>extractor:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>href</span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span>
|
81
|
-
<span class='rbrace'>}</span>
|
82
|
-
<span class='rparen'>)</span>
|
83
|
-
|
84
|
-
<span class='id identifier rubyid_puts'>puts</span> <span class='id identifier rubyid_rss'>rss</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span>
|
85
|
-
</code></pre>
|
86
|
-
|
87
|
-
<h2 id="label-Usage+with+a+YAML+config+file">Usage with a YAML config file</h2>
|
88
|
-
|
89
|
-
<p>Create a YAML config file. Find an example at <a href="https://github.com/gildesmarais/html2rss/blob/master/spec/config.test.yml">rspec/config.test.yml</a>.</p>
|
90
|
-
|
91
|
-
<p><code>Html2rss.feed_from_yaml_config(File.join(['spec', 'config.test.yml']), 'nuxt-releases')</code> returns</p>
|
92
|
-
|
93
|
-
<p>an <code>RSS:Rss</code> object.</p>
|
94
|
-
|
95
|
-
<p><strong>Too complicated?</strong> See <a href="https://github.com/gildesmarais/html2rss-configs">html2rss-configs</a> for ready-made feed configs!</p>
|
96
|
-
|
97
|
-
<h2 id="label-Development">Development</h2>
|
98
|
-
|
99
|
-
<p>After checking out the repo, run <code>bin/setup</code> to install dependencies. Then, run <code>rake spec</code> to run the tests. You can also run <code>bin/console</code> for an interactive prompt that will allow you to experiment.</p>
|
100
|
-
|
101
|
-
<h2 id="label-Contributing">Contributing</h2>
|
102
|
-
|
103
|
-
<p>Bug reports and pull requests are welcome on GitHub at <a href="https://github.com/gildesmarais/html2rss">github.com/gildesmarais/html2rss</a>.</p>
|
104
|
-
|
105
|
-
<h2 id="label-Releasing+a+new+version">Releasing a new version</h2>
|
106
|
-
<ol><li>
|
107
|
-
<p><code>git pull</code></p>
|
108
|
-
</li><li>
|
109
|
-
<p>increase version in <code>lib/version.rb</code></p>
|
110
|
-
</li><li>
|
111
|
-
<p><code>bundle</code></p>
|
112
|
-
</li><li>
|
113
|
-
<p>commit the changes</p>
|
114
|
-
</li><li>
|
115
|
-
<p><code>git tag v....</code></p>
|
116
|
-
</li><li>
|
117
|
-
<p><code>git push; git push --tags</code></p>
|
118
|
-
</li><li>
|
119
|
-
<p>update the changelog, commit and push</p>
|
120
|
-
</li></ol>
|
121
|
-
|
122
|
-
<h3 id="label-Changelog+generation">Changelog generation</h3>
|
123
|
-
|
124
|
-
<p>The <code>CHANGELOG.md</code> can be generated automatically with <a href="https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/standard-changelog">standard-changelog</a>.</p>
|
125
|
-
</div></div>
|
126
|
-
|
127
|
-
<div id="footer">
|
128
|
-
Generated on Wed Sep 18 12:52:16 2019 by
|
129
|
-
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
130
|
-
0.9.20 (ruby-2.6.3).
|
131
|
-
</div>
|
132
|
-
|
133
|
-
</div>
|
134
|
-
</body>
|
135
|
-
</html>
|
data/docs/file_list.html
DELETED
@@ -1,56 +0,0 @@
|
|
1
|
-
<!DOCTYPE html>
|
2
|
-
<html>
|
3
|
-
<head>
|
4
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
5
|
-
<meta charset="utf-8" />
|
6
|
-
|
7
|
-
<link rel="stylesheet" href="css/full_list.css" type="text/css" media="screen" charset="utf-8" />
|
8
|
-
|
9
|
-
<link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
<script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
|
14
|
-
|
15
|
-
<script type="text/javascript" charset="utf-8" src="js/full_list.js"></script>
|
16
|
-
|
17
|
-
|
18
|
-
<title>File List</title>
|
19
|
-
<base id="base_target" target="_parent" />
|
20
|
-
</head>
|
21
|
-
<body>
|
22
|
-
<div id="content">
|
23
|
-
<div class="fixed_header">
|
24
|
-
<h1 id="full_list_header">File List</h1>
|
25
|
-
<div id="full_list_nav">
|
26
|
-
|
27
|
-
<span><a target="_self" href="class_list.html">
|
28
|
-
Classes
|
29
|
-
</a></span>
|
30
|
-
|
31
|
-
<span><a target="_self" href="method_list.html">
|
32
|
-
Methods
|
33
|
-
</a></span>
|
34
|
-
|
35
|
-
<span><a target="_self" href="file_list.html">
|
36
|
-
Files
|
37
|
-
</a></span>
|
38
|
-
|
39
|
-
</div>
|
40
|
-
|
41
|
-
<div id="search">Search: <input type="text" /></div>
|
42
|
-
</div>
|
43
|
-
|
44
|
-
<ul id="full_list" class="file">
|
45
|
-
|
46
|
-
|
47
|
-
<li id="object_README" class="odd">
|
48
|
-
<div class="item"><span class="object_link"><a href="index.html" title="README">README</a></span></div>
|
49
|
-
</li>
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
</ul>
|
54
|
-
</div>
|
55
|
-
</body>
|
56
|
-
</html>
|
data/docs/frames.html
DELETED
@@ -1,17 +0,0 @@
|
|
1
|
-
<!DOCTYPE html>
|
2
|
-
<html>
|
3
|
-
<head>
|
4
|
-
<meta charset="utf-8">
|
5
|
-
<title>Documentation by YARD 0.9.20</title>
|
6
|
-
</head>
|
7
|
-
<script type="text/javascript" charset="utf-8">
|
8
|
-
var match = unescape(window.location.hash).match(/^#!(.+)/);
|
9
|
-
var name = match ? match[1] : 'index.html';
|
10
|
-
name = name.replace(/^(\w+):\/\//, '').replace(/^\/\//, '');
|
11
|
-
window.top.location = name;
|
12
|
-
</script>
|
13
|
-
<noscript>
|
14
|
-
<h1>Oops!</h1>
|
15
|
-
<h2>YARD requires JavaScript!</h2>
|
16
|
-
</noscript>
|
17
|
-
</html>
|
data/docs/index.html
DELETED
@@ -1,135 +0,0 @@
|
|
1
|
-
<!DOCTYPE html>
|
2
|
-
<html>
|
3
|
-
<head>
|
4
|
-
<meta charset="UTF-8">
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
6
|
-
<title>
|
7
|
-
File: README
|
8
|
-
|
9
|
-
— Documentation by YARD 0.9.20
|
10
|
-
|
11
|
-
</title>
|
12
|
-
|
13
|
-
<link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
|
14
|
-
|
15
|
-
<link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
|
16
|
-
|
17
|
-
<script type="text/javascript" charset="utf-8">
|
18
|
-
pathId = "README";
|
19
|
-
relpath = '';
|
20
|
-
</script>
|
21
|
-
|
22
|
-
|
23
|
-
<script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
|
24
|
-
|
25
|
-
<script type="text/javascript" charset="utf-8" src="js/app.js"></script>
|
26
|
-
|
27
|
-
|
28
|
-
</head>
|
29
|
-
<body>
|
30
|
-
<div class="nav_wrap">
|
31
|
-
<iframe id="nav" src="class_list.html?1"></iframe>
|
32
|
-
<div id="resizer"></div>
|
33
|
-
</div>
|
34
|
-
|
35
|
-
<div id="main" tabindex="-1">
|
36
|
-
<div id="header">
|
37
|
-
<div id="menu">
|
38
|
-
|
39
|
-
<a href="_index.html">Index</a> »
|
40
|
-
<span class="title">File: README</span>
|
41
|
-
|
42
|
-
</div>
|
43
|
-
|
44
|
-
<div id="search">
|
45
|
-
|
46
|
-
<a class="full_list_link" id="class_list_link"
|
47
|
-
href="class_list.html">
|
48
|
-
|
49
|
-
<svg width="24" height="24">
|
50
|
-
<rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
|
51
|
-
<rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
|
52
|
-
<rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
|
53
|
-
</svg>
|
54
|
-
</a>
|
55
|
-
|
56
|
-
</div>
|
57
|
-
<div class="clear"></div>
|
58
|
-
</div>
|
59
|
-
|
60
|
-
<div id="content"><div id='filecontents'>
|
61
|
-
<p><img src="https://github.com/gildesmarais/html2rss/raw/master/support/logo.png"></p>
|
62
|
-
|
63
|
-
<h1 id="label-html2rss+rdoc-image-3Ahttps-3A-2F-2Ftravis-ci.org-2Fgildesmarais-2Fhtml2rss.svg-3Fbranch-3Dmaster+rdoc-image-3Ahttps-3A-2F-2Fbadge.fury.io-2Frb-2Fhtml2rss.svg">html2rss <a href="https://travis-ci.org/gildesmarais/html2rss"><img src="https://travis-ci.org/gildesmarais/html2rss.svg?branch=master"></a> <a href="https://badge.fury.io/rb/html2rss"><img src="https://badge.fury.io/rb/html2rss.svg"></a></h1>
|
64
|
-
|
65
|
-
<p>Request HTML from an URL and transform it to a Ruby RSS 2.0 object.</p>
|
66
|
-
|
67
|
-
<p><strong>Are you searching for a ready to use “website to RSS” solution?</strong> <a href="https://github.com/gildesmarais/html2rss-web">Check out html2rss-web!</a></p>
|
68
|
-
|
69
|
-
<p>Each website needs a <em>feed config</em> which contains the URL to scrape and CSS selectors to extract the required information (like title, URL, …). This gem provides <a href="https://github.com/gildesmarais/html2rss/blob/master/lib/html2rss/item_extractors">extractors</a> (e.g. extract the information from an HTML attribute) and chainable <a href="https://github.com/gildesmarais/html2rss/tree/master/lib/html2rss/attribute_post_processors">post processors</a> to make information retrieval even easier.</p>
|
70
|
-
|
71
|
-
<h2 id="label-Installation">Installation</h2>
|
72
|
-
|
73
|
-
<p>Add this line to your application's Gemfile: <code>gem 'html2rss'</code><br> Then execute: <code>bundle</code></p>
|
74
|
-
|
75
|
-
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_rss'>rss</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Html2rss.html" title="Html2rss (module)">Html2rss</a></span></span><span class='period'>.</span><span class='id identifier rubyid_feed'><span class='object_link'><a href="Html2rss.html#feed-class_method" title="Html2rss.feed (method)">feed</a></span></span><span class='lparen'>(</span>
|
76
|
-
<span class='label'>channel:</span> <span class='lbrace'>{</span> <span class='label'>title:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>StackOverflow: Hot Network Questions</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='label'>url:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>https://stackoverflow.com/questions</span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span><span class='comma'>,</span>
|
77
|
-
<span class='label'>selectors:</span> <span class='lbrace'>{</span>
|
78
|
-
<span class='label'>items:</span> <span class='lbrace'>{</span> <span class='label'>selector:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>#hot-network-questions > ul > li</span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span><span class='comma'>,</span>
|
79
|
-
<span class='label'>title:</span> <span class='lbrace'>{</span> <span class='label'>selector:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>a</span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span><span class='comma'>,</span>
|
80
|
-
<span class='label'>link:</span> <span class='lbrace'>{</span> <span class='label'>selector:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>a</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='label'>extractor:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>href</span><span class='tstring_end'>'</span></span> <span class='rbrace'>}</span>
|
81
|
-
<span class='rbrace'>}</span>
|
82
|
-
<span class='rparen'>)</span>
|
83
|
-
|
84
|
-
<span class='id identifier rubyid_puts'>puts</span> <span class='id identifier rubyid_rss'>rss</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span>
|
85
|
-
</code></pre>
|
86
|
-
|
87
|
-
<h2 id="label-Usage+with+a+YAML+config+file">Usage with a YAML config file</h2>
|
88
|
-
|
89
|
-
<p>Create a YAML config file. Find an example at <a href="https://github.com/gildesmarais/html2rss/blob/master/spec/config.test.yml">rspec/config.test.yml</a>.</p>
|
90
|
-
|
91
|
-
<p><code>Html2rss.feed_from_yaml_config(File.join(['spec', 'config.test.yml']), 'nuxt-releases')</code> returns</p>
|
92
|
-
|
93
|
-
<p>an <code>RSS:Rss</code> object.</p>
|
94
|
-
|
95
|
-
<p><strong>Too complicated?</strong> See <a href="https://github.com/gildesmarais/html2rss-configs">html2rss-configs</a> for ready-made feed configs!</p>
|
96
|
-
|
97
|
-
<h2 id="label-Development">Development</h2>
|
98
|
-
|
99
|
-
<p>After checking out the repo, run <code>bin/setup</code> to install dependencies. Then, run <code>rake spec</code> to run the tests. You can also run <code>bin/console</code> for an interactive prompt that will allow you to experiment.</p>
|
100
|
-
|
101
|
-
<h2 id="label-Contributing">Contributing</h2>
|
102
|
-
|
103
|
-
<p>Bug reports and pull requests are welcome on GitHub at <a href="https://github.com/gildesmarais/html2rss">github.com/gildesmarais/html2rss</a>.</p>
|
104
|
-
|
105
|
-
<h2 id="label-Releasing+a+new+version">Releasing a new version</h2>
|
106
|
-
<ol><li>
|
107
|
-
<p><code>git pull</code></p>
|
108
|
-
</li><li>
|
109
|
-
<p>increase version in <code>lib/version.rb</code></p>
|
110
|
-
</li><li>
|
111
|
-
<p><code>bundle</code></p>
|
112
|
-
</li><li>
|
113
|
-
<p>commit the changes</p>
|
114
|
-
</li><li>
|
115
|
-
<p><code>git tag v....</code></p>
|
116
|
-
</li><li>
|
117
|
-
<p><code>git push; git push --tags</code></p>
|
118
|
-
</li><li>
|
119
|
-
<p>update the changelog, commit and push</p>
|
120
|
-
</li></ol>
|
121
|
-
|
122
|
-
<h3 id="label-Changelog+generation">Changelog generation</h3>
|
123
|
-
|
124
|
-
<p>The <code>CHANGELOG.md</code> can be generated automatically with <a href="https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/standard-changelog">standard-changelog</a>.</p>
|
125
|
-
</div></div>
|
126
|
-
|
127
|
-
<div id="footer">
|
128
|
-
Generated on Wed Sep 18 12:52:16 2019 by
|
129
|
-
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
130
|
-
0.9.20 (ruby-2.6.3).
|
131
|
-
</div>
|
132
|
-
|
133
|
-
</div>
|
134
|
-
</body>
|
135
|
-
</html>
|
data/docs/js/app.js
DELETED
@@ -1,303 +0,0 @@
|
|
1
|
-
(function() {
|
2
|
-
|
3
|
-
var localStorage = {}, sessionStorage = {};
|
4
|
-
try { localStorage = window.localStorage; } catch (e) { }
|
5
|
-
try { sessionStorage = window.sessionStorage; } catch (e) { }
|
6
|
-
|
7
|
-
function createSourceLinks() {
|
8
|
-
$('.method_details_list .source_code').
|
9
|
-
before("<span class='showSource'>[<a href='#' class='toggleSource'>View source</a>]</span>");
|
10
|
-
$('.toggleSource').toggle(function() {
|
11
|
-
$(this).parent().nextAll('.source_code').slideDown(100);
|
12
|
-
$(this).text("Hide source");
|
13
|
-
},
|
14
|
-
function() {
|
15
|
-
$(this).parent().nextAll('.source_code').slideUp(100);
|
16
|
-
$(this).text("View source");
|
17
|
-
});
|
18
|
-
}
|
19
|
-
|
20
|
-
function createDefineLinks() {
|
21
|
-
var tHeight = 0;
|
22
|
-
$('.defines').after(" <a href='#' class='toggleDefines'>more...</a>");
|
23
|
-
$('.toggleDefines').toggle(function() {
|
24
|
-
tHeight = $(this).parent().prev().height();
|
25
|
-
$(this).prev().css('display', 'inline');
|
26
|
-
$(this).parent().prev().height($(this).parent().height());
|
27
|
-
$(this).text("(less)");
|
28
|
-
},
|
29
|
-
function() {
|
30
|
-
$(this).prev().hide();
|
31
|
-
$(this).parent().prev().height(tHeight);
|
32
|
-
$(this).text("more...");
|
33
|
-
});
|
34
|
-
}
|
35
|
-
|
36
|
-
function createFullTreeLinks() {
|
37
|
-
var tHeight = 0;
|
38
|
-
$('.inheritanceTree').toggle(function() {
|
39
|
-
tHeight = $(this).parent().prev().height();
|
40
|
-
$(this).parent().toggleClass('showAll');
|
41
|
-
$(this).text("(hide)");
|
42
|
-
$(this).parent().prev().height($(this).parent().height());
|
43
|
-
},
|
44
|
-
function() {
|
45
|
-
$(this).parent().toggleClass('showAll');
|
46
|
-
$(this).parent().prev().height(tHeight);
|
47
|
-
$(this).text("show all");
|
48
|
-
});
|
49
|
-
}
|
50
|
-
|
51
|
-
function searchFrameButtons() {
|
52
|
-
$('.full_list_link').click(function() {
|
53
|
-
toggleSearchFrame(this, $(this).attr('href'));
|
54
|
-
return false;
|
55
|
-
});
|
56
|
-
window.addEventListener('message', function(e) {
|
57
|
-
if (e.data === 'navEscape') {
|
58
|
-
$('#nav').slideUp(100);
|
59
|
-
$('#search a').removeClass('active inactive');
|
60
|
-
$(window).focus();
|
61
|
-
}
|
62
|
-
});
|
63
|
-
|
64
|
-
$(window).resize(function() {
|
65
|
-
if ($('#search:visible').length === 0) {
|
66
|
-
$('#nav').removeAttr('style');
|
67
|
-
$('#search a').removeClass('active inactive');
|
68
|
-
$(window).focus();
|
69
|
-
}
|
70
|
-
});
|
71
|
-
}
|
72
|
-
|
73
|
-
function toggleSearchFrame(id, link) {
|
74
|
-
var frame = $('#nav');
|
75
|
-
$('#search a').removeClass('active').addClass('inactive');
|
76
|
-
if (frame.attr('src') === link && frame.css('display') !== "none") {
|
77
|
-
frame.slideUp(100);
|
78
|
-
$('#search a').removeClass('active inactive');
|
79
|
-
}
|
80
|
-
else {
|
81
|
-
$(id).addClass('active').removeClass('inactive');
|
82
|
-
if (frame.attr('src') !== link) frame.attr('src', link);
|
83
|
-
frame.slideDown(100);
|
84
|
-
}
|
85
|
-
}
|
86
|
-
|
87
|
-
function linkSummaries() {
|
88
|
-
$('.summary_signature').click(function() {
|
89
|
-
document.location = $(this).find('a').attr('href');
|
90
|
-
});
|
91
|
-
}
|
92
|
-
|
93
|
-
function summaryToggle() {
|
94
|
-
$('.summary_toggle').click(function(e) {
|
95
|
-
e.preventDefault();
|
96
|
-
localStorage.summaryCollapsed = $(this).text();
|
97
|
-
$('.summary_toggle').each(function() {
|
98
|
-
$(this).text($(this).text() == "collapse" ? "expand" : "collapse");
|
99
|
-
var next = $(this).parent().parent().nextAll('ul.summary').first();
|
100
|
-
if (next.hasClass('compact')) {
|
101
|
-
next.toggle();
|
102
|
-
next.nextAll('ul.summary').first().toggle();
|
103
|
-
}
|
104
|
-
else if (next.hasClass('summary')) {
|
105
|
-
var list = $('<ul class="summary compact" />');
|
106
|
-
list.html(next.html());
|
107
|
-
list.find('.summary_desc, .note').remove();
|
108
|
-
list.find('a').each(function() {
|
109
|
-
$(this).html($(this).find('strong').html());
|
110
|
-
$(this).parent().html($(this)[0].outerHTML);
|
111
|
-
});
|
112
|
-
next.before(list);
|
113
|
-
next.toggle();
|
114
|
-
}
|
115
|
-
});
|
116
|
-
return false;
|
117
|
-
});
|
118
|
-
if (localStorage.summaryCollapsed == "collapse") {
|
119
|
-
$('.summary_toggle').first().click();
|
120
|
-
} else { localStorage.summaryCollapsed = "expand"; }
|
121
|
-
}
|
122
|
-
|
123
|
-
function constantSummaryToggle() {
|
124
|
-
$('.constants_summary_toggle').click(function(e) {
|
125
|
-
e.preventDefault();
|
126
|
-
localStorage.summaryCollapsed = $(this).text();
|
127
|
-
$('.constants_summary_toggle').each(function() {
|
128
|
-
$(this).text($(this).text() == "collapse" ? "expand" : "collapse");
|
129
|
-
var next = $(this).parent().parent().nextAll('dl.constants').first();
|
130
|
-
if (next.hasClass('compact')) {
|
131
|
-
next.toggle();
|
132
|
-
next.nextAll('dl.constants').first().toggle();
|
133
|
-
}
|
134
|
-
else if (next.hasClass('constants')) {
|
135
|
-
var list = $('<dl class="constants compact" />');
|
136
|
-
list.html(next.html());
|
137
|
-
list.find('dt').each(function() {
|
138
|
-
$(this).addClass('summary_signature');
|
139
|
-
$(this).text( $(this).text().split('=')[0]);
|
140
|
-
if ($(this).has(".deprecated").length) {
|
141
|
-
$(this).addClass('deprecated');
|
142
|
-
};
|
143
|
-
});
|
144
|
-
// Add the value of the constant as "Tooltip" to the summary object
|
145
|
-
list.find('pre.code').each(function() {
|
146
|
-
console.log($(this).parent());
|
147
|
-
var dt_element = $(this).parent().prev();
|
148
|
-
var tooltip = $(this).text();
|
149
|
-
if (dt_element.hasClass("deprecated")) {
|
150
|
-
tooltip = 'Deprecated. ' + tooltip;
|
151
|
-
};
|
152
|
-
dt_element.attr('title', tooltip);
|
153
|
-
});
|
154
|
-
list.find('.docstring, .tags, dd').remove();
|
155
|
-
next.before(list);
|
156
|
-
next.toggle();
|
157
|
-
}
|
158
|
-
});
|
159
|
-
return false;
|
160
|
-
});
|
161
|
-
if (localStorage.summaryCollapsed == "collapse") {
|
162
|
-
$('.constants_summary_toggle').first().click();
|
163
|
-
} else { localStorage.summaryCollapsed = "expand"; }
|
164
|
-
}
|
165
|
-
|
166
|
-
function generateTOC() {
|
167
|
-
if ($('#filecontents').length === 0) return;
|
168
|
-
var _toc = $('<ol class="top"></ol>');
|
169
|
-
var show = false;
|
170
|
-
var toc = _toc;
|
171
|
-
var counter = 0;
|
172
|
-
var tags = ['h2', 'h3', 'h4', 'h5', 'h6'];
|
173
|
-
var i;
|
174
|
-
if ($('#filecontents h1').length > 1) tags.unshift('h1');
|
175
|
-
for (i = 0; i < tags.length; i++) { tags[i] = '#filecontents ' + tags[i]; }
|
176
|
-
var lastTag = parseInt(tags[0][1], 10);
|
177
|
-
$(tags.join(', ')).each(function() {
|
178
|
-
if ($(this).parents('.method_details .docstring').length != 0) return;
|
179
|
-
if (this.id == "filecontents") return;
|
180
|
-
show = true;
|
181
|
-
var thisTag = parseInt(this.tagName[1], 10);
|
182
|
-
if (this.id.length === 0) {
|
183
|
-
var proposedId = $(this).attr('toc-id');
|
184
|
-
if (typeof(proposedId) != "undefined") this.id = proposedId;
|
185
|
-
else {
|
186
|
-
var proposedId = $(this).text().replace(/[^a-z0-9-]/ig, '_');
|
187
|
-
if ($('#' + proposedId).length > 0) { proposedId += counter; counter++; }
|
188
|
-
this.id = proposedId;
|
189
|
-
}
|
190
|
-
}
|
191
|
-
if (thisTag > lastTag) {
|
192
|
-
for (i = 0; i < thisTag - lastTag; i++) {
|
193
|
-
var tmp = $('<ol/>'); toc.append(tmp); toc = tmp;
|
194
|
-
}
|
195
|
-
}
|
196
|
-
if (thisTag < lastTag) {
|
197
|
-
for (i = 0; i < lastTag - thisTag; i++) toc = toc.parent();
|
198
|
-
}
|
199
|
-
var title = $(this).attr('toc-title');
|
200
|
-
if (typeof(title) == "undefined") title = $(this).text();
|
201
|
-
toc.append('<li><a href="#' + this.id + '">' + title + '</a></li>');
|
202
|
-
lastTag = thisTag;
|
203
|
-
});
|
204
|
-
if (!show) return;
|
205
|
-
html = '<div id="toc"><p class="title hide_toc"><a href="#"><strong>Table of Contents</strong></a></p></div>';
|
206
|
-
$('#content').prepend(html);
|
207
|
-
$('#toc').append(_toc);
|
208
|
-
$('#toc .hide_toc').toggle(function() {
|
209
|
-
$('#toc .top').slideUp('fast');
|
210
|
-
$('#toc').toggleClass('hidden');
|
211
|
-
$('#toc .title small').toggle();
|
212
|
-
}, function() {
|
213
|
-
$('#toc .top').slideDown('fast');
|
214
|
-
$('#toc').toggleClass('hidden');
|
215
|
-
$('#toc .title small').toggle();
|
216
|
-
});
|
217
|
-
}
|
218
|
-
|
219
|
-
function navResizeFn(e) {
|
220
|
-
if (e.which !== 1) {
|
221
|
-
navResizeFnStop();
|
222
|
-
return;
|
223
|
-
}
|
224
|
-
|
225
|
-
sessionStorage.navWidth = e.pageX.toString();
|
226
|
-
$('.nav_wrap').css('width', e.pageX);
|
227
|
-
$('.nav_wrap').css('-ms-flex', 'inherit');
|
228
|
-
}
|
229
|
-
|
230
|
-
function navResizeFnStop() {
|
231
|
-
$(window).unbind('mousemove', navResizeFn);
|
232
|
-
window.removeEventListener('message', navMessageFn, false);
|
233
|
-
}
|
234
|
-
|
235
|
-
function navMessageFn(e) {
|
236
|
-
if (e.data.action === 'mousemove') navResizeFn(e.data.event);
|
237
|
-
if (e.data.action === 'mouseup') navResizeFnStop();
|
238
|
-
}
|
239
|
-
|
240
|
-
function navResizer() {
|
241
|
-
$('#resizer').mousedown(function(e) {
|
242
|
-
e.preventDefault();
|
243
|
-
$(window).mousemove(navResizeFn);
|
244
|
-
window.addEventListener('message', navMessageFn, false);
|
245
|
-
});
|
246
|
-
$(window).mouseup(navResizeFnStop);
|
247
|
-
|
248
|
-
if (sessionStorage.navWidth) {
|
249
|
-
navResizeFn({which: 1, pageX: parseInt(sessionStorage.navWidth, 10)});
|
250
|
-
}
|
251
|
-
}
|
252
|
-
|
253
|
-
function navExpander() {
|
254
|
-
var done = false, timer = setTimeout(postMessage, 500);
|
255
|
-
function postMessage() {
|
256
|
-
if (done) return;
|
257
|
-
clearTimeout(timer);
|
258
|
-
var opts = { action: 'expand', path: pathId };
|
259
|
-
document.getElementById('nav').contentWindow.postMessage(opts, '*');
|
260
|
-
done = true;
|
261
|
-
}
|
262
|
-
|
263
|
-
window.addEventListener('message', function(event) {
|
264
|
-
if (event.data === 'navReady') postMessage();
|
265
|
-
return false;
|
266
|
-
}, false);
|
267
|
-
}
|
268
|
-
|
269
|
-
function mainFocus() {
|
270
|
-
var hash = window.location.hash;
|
271
|
-
if (hash !== '' && $(hash)[0]) {
|
272
|
-
$(hash)[0].scrollIntoView();
|
273
|
-
}
|
274
|
-
|
275
|
-
setTimeout(function() { $('#main').focus(); }, 10);
|
276
|
-
}
|
277
|
-
|
278
|
-
function navigationChange() {
|
279
|
-
// This works around the broken anchor navigation with the YARD template.
|
280
|
-
window.onpopstate = function() {
|
281
|
-
var hash = window.location.hash;
|
282
|
-
if (hash !== '' && $(hash)[0]) {
|
283
|
-
$(hash)[0].scrollIntoView();
|
284
|
-
}
|
285
|
-
};
|
286
|
-
}
|
287
|
-
|
288
|
-
$(document).ready(function() {
|
289
|
-
navResizer();
|
290
|
-
navExpander();
|
291
|
-
createSourceLinks();
|
292
|
-
createDefineLinks();
|
293
|
-
createFullTreeLinks();
|
294
|
-
searchFrameButtons();
|
295
|
-
linkSummaries();
|
296
|
-
summaryToggle();
|
297
|
-
constantSummaryToggle();
|
298
|
-
generateTOC();
|
299
|
-
mainFocus();
|
300
|
-
navigationChange();
|
301
|
-
});
|
302
|
-
|
303
|
-
})();
|