RLAssembly (Reading List Assembly) is a Ruby script to read a Markdown file of categorized links and convert it to JSON. RLAssembly was conceived to be used alongside my GitHub Pages/Jekyll site to produce a reading list of links to articles and websites. It is not currently (06/19/15) constructed as a Jekyll plugin.

RLAssembly.rb

=begin

RLAssembly

Author: eric-cc-su

RLAssembly (Reading List Assembly) is a command-line Ruby script to read an HTML or Markdown file of categorized links and convert it to JSON. (Because I'm lazy and automation is cool)
RLAssembly was conceived to be used alongside my GitHub Pages/Jekyll site to objectify a reading list of links to articles and websites. It is not currently (06/23/15) constructed as a Jekyll plugin.

View the README for instructions and formatting
This code is licensed under the MIT License (end of file) and under copyright by Eric Su
=end
require 'json'
require 'optparse'

filename = ""
masterhash = Hash.new
jhash = Hash.new
category = ""

def retrieve(format, line, jhash)
	category = ""
	if format == "md"
		jhash["title"] = line[1..line.index(']')-1]
		jhash["url"] = line[line.index('(')+1..line.index(')')-1]
		if line.include?(')-')  # Check if category was defined inline
			category = line[line.index(')-')+2..-1]
		end
	elsif format == "html"		
		link = line.match(/<a.+>.+(?=<\/a>)/)[0]
		jhash["title"] = link.match(/(?<=(>)).+/)[0]
		jhash["url"] = link.match(/(?<=href=["']).+(?=["']>)/)[0]
	end
	return jhash, category
end

options = {"filepath":""}
parser = OptionParser.new do |opts|
	opts.banner = "Usage: RLAssembly.rb [FILEPATH] [options]"
	opts.separator("")
	opts.separator("\tFILEPATH\t\t The path of the file to extract JSON from")
	opts.separator("")
	if ARGV.length == 0
		raise ArgumentError, "No FILEPATH defined"
	else
		filename = ARGV[0]
	end

	opts.on("-h", "--help", "Show this message") do
		puts(opts)
		exit
	end
end
parser.parse!(ARGV)

begin
	File.open(filename, 'r') do |file|
		file.each_line do |line|
			jhash = Hash.new
			if line.include?("#")
				category = line[line.rindex("#")+1..-1].strip
			elsif ( line.match(/<h\d+/) and line.match(/(class=[\s\S]+rlcat)/) )
				category = line.match(/(?<=>).+(?=<\/h\d+)/)[0]
			elsif line.strip[0] == '[' or line.include?("<li><a")  # Line contains link
				jhash, tempcat = retrieve(filename[filename.rindex(".")+1..-1].downcase, line, jhash)
				if tempcat != ""
					category = tempcat
				end
			end	

			if jhash != {}
				begin
					masterhash[category.capitalize] << jhash
				rescue  # masterhash is empty
					masterhash[category.capitalize] = [jhash]
				end
			end
		end
	end

	File.open(File.dirname(filename)+'/reading-list.json','w') do |file|
		file.write(JSON.pretty_generate(masterhash))
	end
rescue
	raise IOError, "Reading list file does not exist or is incorrectly formatted"
end

=begin
The MIT License (MIT)

Copyright (c) 2015 Eric Su

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
=end

RLAssembly_README.md

RLAssembly README

Author: eric-cc-su

RLAssembly (Reading List Assembly) is a command-line Ruby script to read an HTML or Markdown file of categorized links and convert it to JSON. (Because I'm lazy and automation is cool)

RLAssembly was conceived to be used alongside my GitHub Pages/Jekyll site to objectify a reading list of links to articles and websites. It is not currently (06/23/15) constructed as a Jekyll plugin.

---

#Using RLAssembly

In a terminal, cd to the RLAssembly directory and execute the script with the following command:

ruby RLAssembly.rb *FILEPATH*

##Arguments

FILEPATH - REQUIRED - The path of the file to be analyzed for JSON extraction. This can be an absolute or a relative path.

#Files

• Input File: */*.md OR */*.html
• Output File: */reading-list.json

The output file reading-list.json will be written in the same directory as the input file.

#Formatting

###HTML

<h3>Non-Category Header</h3>

<h2 class="rlcat">Category Header</h2>
<p>text that will not be analyzed...</p>

<ul>
    <li><a href="http://www.URL1.com/">URL1</a></li>
    <li><a href="https://URL2.com">URL2</a></li>
</ul>

• Categories must be an <h#> element with the class rlcat otherwise it will be ignored (avoids creating unwanted categories)
• links must be list items in the format: <li><a ...>*TITLE*</a></li>
  • link tag <a> must immediately follow <li>
  • the *TITLE* of the link must be followed by the closing tags </a></li>. Therefore *TITLE* cannot be enclosed by any other tags
• You may use any classes and tag parameters in your HTML as long as the above points are still satisfied

###Markdown Markdown file format:

#Category  

[URL Title](https://www.url.com)
[URL2 Title](https://www.url2.com)-category2

##Category2

...
...

Any header within the Markdown file will be converted into a category.

ALTERNATIVELY

Markdown single line format: [URL Title]("https://www.url.com")-category

• there should be no whitespace between the URL parentheses and the hyphen
• whitespace between the hyphen and the character will be stripped
• a hyphenated category will override the header category
• Categories will be automatically capitalized when converted to JSON
• Any leading whitespace will be stripped from the category name

###JSON JSON output format:

{
	"Category": [
		{
		"title": "URL Title",
		"url": "https://www.url.com",
		},
		{...},
		{...}
	],
	"Category2": [
		{
			"title": "URL2 Title",
			"url": "https://www.url2.com",
		},
		{...},
		{...}
	]
}

This code is licensed under the MIT License and under copyright by Eric Su