nhkore 0.3.1 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb2c0e6e53995b874a9e53c44b024f993032433d1a87c37e7b7bdea69965902d
-  data.tar.gz: 13d34c53fe9af9efa985c05089b1588eb1e76d6321f9aff18cc5da80598a52d4
+  metadata.gz: 445adf6e8abd4da9fd6dd25e9632d5f477b467f6ce8c3dcecae87e3f61305d98
+  data.tar.gz: ca812639ff1edd8da835f5bbb2cde403c9cb63e17568fb3ec367eec00605ec17
 SHA512:
-  metadata.gz: 643723d42e939a7852eca3b90c3ec4e65085838317eb59c1d8f21f79dd647d2e77e5ea68ab2ff3b5a208608f9bf350121a9918cb318dec6c3047731b73f59294
-  data.tar.gz: 3481fea3a3895a5b85ac3fcd5a77fe9b811f84e9a19b395a1de1d2e9b31fda93c5fb49a8d7d43581e05cb90c6f844f8537c5a97d73937c2b8ee97728ac7c7a1f
+  metadata.gz: 392607205c53aa2a5dfcde244e5fa6137483d216dc27becf06c76798209d2dcf328f17abee2026d795207d4e783a23fd108e615525445f52ca6442560600cd42
+  data.tar.gz: 7a1219623b6645bbc633ba9c94e767dcf86be8852a7228c1d5ddd3936f61b884897f680369d4c9d9db5aba8ab4561048d59aed15cecf7ba05695c1957f31b0ea

data/CHANGELOG.md

@@ -2,7 +2,82 @@
 
 Format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
-## [[Unreleased]](https://github.com/esotericpig/nhkore/compare/v0.3.1...master)
+## [[Unreleased]](https://github.com/esotericpig/nhkore/compare/v0.3.6...master)
+
+## [v0.3.6] - 2020-08-18
+
+### Added
+- `update_showcase` Rake task for development & personal site (GitHub Page)
+    - `$ bundle exec rake update_showcase`
+
+### Changed
+- Updated Gems
+
+### Fixed
+- ArticleScraper for title for specific site
+    - https://www3.nhk.or.jp/news/easy/article/disaster_earthquake_illust.html
+- Ignored `/cgi2.*enqform/` URLs from SearchScraper (Bing)
+- Added more detail to dictionary error in ArticleScraper
+
+## [v0.3.5] - 2020-05-04
+
+### Added
+- Added check for environment var `NO_COLOR`
+    - [https://no-color.org/](https://no-color.org/)
+
+### Fixed
+- Fixed URLs stored in YAML data to always be of type String (not URI)
+    - This initially caused a problem in DictScraper.parse_url() from ArticleScraper, but fixed it for all data
+
+## [v0.3.4] - 2020-04-25
+
+### Added
+- DatetimeParser
+    - Extracted from SiftCmd into its own class
+    - Fixed some minor logic bugs from the old code
+    - Added new feature where 1 range can be empty:
+        - `sift ez -d '...2019'` (from = 1924)
+        - `sift ez -d '2019...'` (to = current year)
+        - `sift ez -d '...'` (still an error)
+- Added `update_core` rake task for dev
+    - Makes pushing a new release much easier
+    - See *Hacking.Releasing* section in *README*
+
+### Fixed
+- SiftCmd `parse_sift_datetime()` for `-d/--datetime` option
+    - Didn't work exactly right (as written in *README*) for some special inputs:
+        - `-d '2019...3'`
+        - `-d '3-3'`
+        - `-d '3'`
+
+## [v0.3.3] - 2020-04-23
+
+### Added
+- Added JSON support to Sifter & SiftCmd.
+- Added use of `attr_bool` Gem for `attr_accessor?` & `attr_reader?`.
+
+## [v0.3.2] - 2020-04-22
+
+### Added
+- lib/nhkore/lib.rb
+    - Requires all files, excluding CLI-related files for speed when using this Gem as a library.
+- Scraper
+    - Added open_file() & reopen().
+- samples/looper.rb
+    - Script example of continuously scraping all articles.
+
+### Changed
+- README
+    - Finished writing the initial version of all sections.
+- ArticleScraper
+    - Changed the `year` param to expect an int, instead of a string.
+- Sifter
+    - In filter_by_datetime(), renamed keyword args `from_filter,to_filter` to simply `from,to`.
+
+### Fixed
+- Reduced load time of app a tiny bit more (see v0.3.1 for details).
+- ArticleScraper
+    - Renamed `mode` param to `strict`. `mode` was overshadowing File.open()'s in Scraper.
 
 ## [v0.3.1] - 2020-04-20
 
@@ -11,10 +86,13 @@ Format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - NewsCmd/SiftCmd
     - Added `--no-sha256` option to not check if article links have already been scraped based on their contents' SHA-256.
 - Util
-    - Changed `dir_str?()` and `filename_str?()` to check any slash. Previously, it only checked the slash for your system. But now on both Windows & Linux, it will check for both `/` & `\`.
+    - Changed `dir_str?()` and `filename_str?()` to check any slash. Previously, it only checked the slash for your system. But now on both Windows & Linux, it will check for both `/` & `\`.
 
 ### Fixed
-- Reduced load time of app from ~1s to ~0.3-5s by moving some requires into methods.
+- Reduced load time of app from about 1s to about 0.3-0.5s.
+    - Moved many `require '...'` statements into methods.
+    - It looks ugly & is not good coding practice, but a necessary evil.
+    - Load time is still pretty slow (but a lot better!).
 - BingScraper
     - Fixed possible RSS infinite loop.
 

data/README.md

@@ -26,6 +26,8 @@ This is similar to a [core word/vocabulary list](https://www.fluentin3months.com
         - [News Command](#news-command-)
 - [Using the Library](#using-the-library-)
 - [Hacking](#hacking-)
+    - [Updating](#updating-)
+    - [Releasing](#releasing-)
 - [License](#license-)
 
 ## For Non-Power Users [^](#contents)
@@ -110,11 +112,12 @@ Example usage:
 
 `$ nhkore -t 300 -m 10 news -D -L -M -d '2011-03-07 06:30' easy -u 'https://www3.nhk.or.jp/news/easy/tsunamikeihou/index.html'`
 
-Now that the data from the article has been scraped, you can generate a CSV/HTML/YAML file of the words ordered by frequency:
+Now that the data from the article has been scraped, you can generate a CSV/HTML/JSON/YAML file of the words ordered by frequency:
 
 ```
 $ nhkore sift easy -e csv
 $ nhkore sift easy -e html
+$ nhkore sift easy -e json
 $ nhkore sift easy -e yml
 ```
 
@@ -154,11 +157,11 @@ After obtaining the scraped data, you can `sift` all of the data (or select data
 | --- | --- |
 | CSV | For uploading to a flashcard website (e.g., Memrise, Anki, Buffl) after changing the data appropriately. |
 | HTML | For comfortable viewing in a web browser or for sharing. |
-| YAML | For developers to automatically add translations or to manipulate the data in some other way programmatically. |
+| YAML/JSON | For developers to automatically add translations or to manipulate the data in some other way programmatically. |
 
 The data is sorted by frequency in descending order (i.e., most frequent words first).
 
-If you wish to sort/arrange the data in some other way, CSV editors (e.g., LibreOffice, WPS Office, Microsoft Office) can do this easily and efficiently, or if you are code-savvy, you can programmatically manipulate the CSV/YAML/HTML file.
+If you wish to sort/arrange the data in some other way, CSV editors (e.g., LibreOffice, WPS Office, Microsoft Office) can do this easily and efficiently, or if you are code-savvy, you can programmatically manipulate the CSV/YAML/JSON/HTML file.
 
 The defaults will sift all of the data into a CSV file, which may not be what you want:
 
@@ -203,7 +206,7 @@ You can save the data to a different format using one of these options:
 
 ```
 -e --ext=<value>    type of file (extension) to save;
-                    valid options: [csv, htm, html, yaml, yml];
+                    valid options: [csv, htm, html, json, yaml, yml];
                     not needed if you specify a file extension with
                     the '--out' option: '--out sift.html'
                     (default: csv)
@@ -293,7 +296,7 @@ links:
 
 If you don't wish to edit this file by hand (or programmatically), that's where the `search` command comes into play.
 
-Currently, it only searches &amp; scrapes `bing.com`, but other search engines and/or methods can easily be added in the future.
+Currently, it only searches & scrapes `bing.com`, but other search engines and/or methods can easily be added in the future.
 
 Example usage:
 
@@ -319,6 +322,49 @@ Complete demo:
 
 #### News Command [^](#contents)
 
+In [The Basics](#the-basics-), you learned how to scrape 1 article using the `-u/--url` option with the `news` command.
+
+After creating a file of links from the [search](#search-command-) command (or manually/programmatically), you can also scrape multiple articles from this file using the `news` command.
+
+The defaults will scrape the 1st unscraped article from the `links` file:
+
+`$ nhkore news easy`
+
+You can scrape the 1st **X** unscraped articles with the `-s/--scrape` option:
+
+```
+# Scrape the 1st 11 unscraped articles.
+$ nhkore news -s 11 easy
+```
+
+You may wish to re-scrape articles that have already been scraped with the `-r/--redo` option:
+
+`$ nhkore news -r -s 11 easy`
+
+If you only wish to scrape specific article links, then you should use the `-k/--like` option, which does a fuzzy search on the URLs. For example, `--like '00123'` will match these links:
+
+- http<span>s://w</span>ww3.nhk.or.jp/news/easy/k1**00123**23711000/k10012323711000.html
+- http<span>s://w</span>ww3.nhk.or.jp/news/easy/k1**00123**21401000/k10012321401000.html
+- http<span>s://w</span>ww3.nhk.or.jp/news/easy/k1**00123**21511000/k10012321511000.html
+- ...
+
+`$ nhkore news -k '00123' -s 11 easy`
+
+Lastly, you can show the dictionary URL and contents for the 1st article if you're getting dictionary-related errors:
+
+```
+# This will exit after showing the 1st article's dictionary.
+$ nhkore news easy --show-dict
+```
+
+For the rest of the options, please see [The Basics](#the-basics-).
+
+Complete demo:
+
+[![asciinema Demo - News](https://asciinema.org/a/322324.png)](https://asciinema.org/a/322324)
+
+When I first scraped all of the articles in [nhkore-core.zip](https://github.com/esotericpig/nhkore/releases/latest), I had to use this [script](samples/looper.rb) because my internet isn't very good.
+
 ## Using the Library [^](#contents)
 
 ### Setup
@@ -336,11 +382,439 @@ In your *Gemfile*:
 ```Ruby
 # Pick one...
 gem 'nhkore', '~> X.X'
-gem 'nhkore', :git => 'https://github.com/esotericpig/psychgus.git', :tag => 'vX.X.X'
+gem 'nhkore', :git => 'https://github.com/esotericpig/nhkore.git', :tag => 'vX.X.X'
+```
+
+### Require
+
+In order to not require all of the CLI-related files, require this file instead:
+
+```Ruby
+require 'nhkore/lib'
+
+#require 'nhkore' # Slower
 ```
 
 ### Scraper
 
+All scraper classes extend this class. You can either extend it or use it by itself. It's a simple wrapper around *open-uri*, *Nokogiri*, etc.
+
+`initialize` automatically opens (connects to) the URL.
+
+```Ruby
+require 'nhkore/scraper'
+
+class MyScraper < NHKore::Scraper
+  def initialize()
+    super('https://www3.nhk.or.jp/news/easy/')
+  end
+end
+
+m = MyScraper.new()
+s = NHKore::Scraper.new('https://www3.nhk.or.jp/news/easy/')
+
+# Read all content into a String.
+mstr = m.read()
+sstr = s.read()
+
+# Get a Nokogiri::HTML object.
+mdoc = m.html_doc()
+sdoc = s.html_doc()
+
+# Get a RSS object.
+s = NHKore::Scraper.new('https://www.bing.com/search?format=rss&q=site%3Anhk.or.jp%2Fnews%2Feasy%2F&count=100')
+
+rss = s.rss_doc()
+```
+
+There are several useful options:
+
+```Ruby
+require 'nhkore/scraper'
+
+s = NHKore::Scraper.new('https://www3.nhk.or.jp/news/easy/',
+  open_timeout: 300, # Open timeout in seconds (default: nil)
+  read_timeout: 300, # Read timeout in seconds (default: nil)
+  
+  # Maximum number of times to retry the URL
+  # - default: 3
+  # - Open/connect will fail a couple of times on a bad/slow internet connection.
+  max_retries: 10,
+  
+  # Maximum number of redirects allowed.
+  # - default: 3
+  # - You can set this to nil or -1, but I recommend using a number
+  #   for safety (infinite-loop attack).
+  max_redirects: 1,
+  
+  # How to check redirect URLs for safety.
+  # - default: :strict
+  # - nil      => do not check
+  # - :lenient => check the scheme only
+  #               (i.e., if https, redirect URL must be https)
+  # - :strict  => check the scheme and domain
+  #               (i.e., if https://bing.com, redirect URL must be https://bing.com)
+  redirect_rule: :lenient,
+  
+  # Set the HTTP header field 'cookie' from the 'set-cookie' response.
+  # - default: false
+  # - Currently uses the 'http-cookie' Gem.
+  # - This is currently a time-consuming operation because it opens the URL twice.
+  # - Necessary for Search Engines or other sites that require cookies
+  #   in order to block bots.
+  eat_cookie: true,
+  
+  # Set HTTP header fields.
+  # - default: nil
+  # - Necessary for Search Engines or other sites that try to block bots.
+  # - Simply pass in a Hash (not nil) to set the default ones.
+  header: {'user-agent' => 'Skynet'}, # Must use strings
+)
+
+# Open the URL yourself. This will be passed in directly to Nokogiri::HTML().
+# - In this way, you can use Faraday, HTTParty, RestClient, httprb/http, or
+#   some other Gem.
+s = NHKore::Scraper.new('https://www3.nhk.or.jp/news/easy/',
+  str_or_io: URI.open('https://www3.nhk.or.jp/news/easy/',redirect: false)
+)
+
+# Open and parse a file instead of a URL (for offline testing or slow internet).
+s = NHKore::Scraper.new('./my_article.html',is_file: true)
+
+doc = s.html_doc()
+```
+
+Here are some other useful methods:
+
+```Ruby
+require 'nhkore/scraper'
+
+s = NHKore::Scraper.new('https://www3.nhk.or.jp/news/easy/')
+
+s.reopen() # Re-open the current URL.
+
+# Get a relative URL.
+url = s.join_url('../../monkey.html')
+puts url # https://www3.nhk.or.jp/monkey.html
+
+# Open a new URL or file.
+s.open(url)
+s.open(url,URI.open(url,redirect: false))
+
+s.open('./my_article.html',is_file: true)
+
+# Open a file manually.
+s.open_file('./my_article.html')
+
+# Fetch the cookie & open a new URL manually.
+s.fetch_cookie(url)
+s.open_url(url)
+```
+
+### SearchScraper & BingScraper
+
+`SearchScraper` is used for scraping Search Engines for NHK News Web (Easy) links. It can also be used for search in general.
+
+By default, it sets the default HTTP header fields and fetches & sets the cookie.
+
+```Ruby
+require 'nhkore/search_scraper'
+
+ss = NHKore::SearchScraper.new('https://www.bing.com/search?q=nhk&count=100')
+
+doc = ss.html_doc()
+
+doc.css('a').each() do |anchor|
+  link = anchor['href']
+  
+  next if ss.ignore_link?(link,cleaned: false)
+  
+  if link.include?('https://www3.nhk')
+    puts link
+  end
+end
+```
+
+`BingScraper` will search `bing.com` for you.
+
+```Ruby
+require 'nhkore/search_link'
+require 'nhkore/search_scraper'
+
+bs     = NHKore::BingScraper.new(:yasashii)
+slinks = NHKore::SearchLinks.new()
+
+next_page = bs.scrape(slinks)
+page_num  = 1
+
+while !next_page.empty?()
+  puts "Page #{page_num += 1}: #{next_page.count}"
+  
+  bs = NHKore::BingScraper.new(:yasashii,url: next_page.url)
+  
+  next_page = bs.scrape(slinks,next_page)
+end
+
+slinks.links.values.each() do |link|
+  puts link.url
+end
+```
+
+### ArticleScraper & DictScraper
+
+`ArticleScraper` scrapes an NHK News Web Easy article. Regular articles aren't currently supported.
+
+```Ruby
+require 'nhkore/article_scraper'
+require 'time'
+
+as = NHKore::ArticleScraper.new(
+  'https://www3.nhk.or.jp/news/easy/k10011862381000/k10011862381000.html',
+  
+  # If false, scrape the article leniently (for older articles which
+  # may not have certain tags, etc.).
+  # - default: true
+  strict: false,
+  
+  # {Dict} to use as the dictionary for words (Easy articles).
+  # - default: :scrape
+  # - nil     => don't scrape/use it (necessary for Regular articles)
+  # - :scrape => auto-scrape it using {DictScraper}
+  # - {Dict}  => your own {Dict}
+  dict: nil,
+  
+  # Date time to use as a fallback if the article doesn't have one
+  # (for older articles).
+  # - default: nil
+  datetime: Time.new(2020,2,2),
+  
+  # Year to use as a fallback if the article doesn't have one
+  # (for older articles).
+  # - default: nil
+  year: 2020,
+)
+
+article = as.scrape()
+
+article.datetime
+article.futsuurl
+article.sha256
+article.title
+article.url
+
+article.words.each() do |key,word|
+  word.defn
+  word.eng
+  word.freq
+  word.kana
+  word.kanji
+  word.key
+end
+
+puts article.to_s(mini: true)
+puts '---'
+puts article
+```
+
+`DictScraper` scrapes an Easy article's dictionary file (JSON).
+
+```Ruby
+require 'nhkore/dict_scraper'
+
+url = 'https://www3.nhk.or.jp/news/easy/k10011862381000/k10011862381000.html'
+ds  = NHKore::DictScraper.new(
+  url,
+  
+  # Change the URL appropriately to the dictionary URL.
+  # - default: true
+  parse_url: true,
+)
+
+puts NHKore::DictScraper.parse_url(url)
+puts
+
+dict = ds.scrape()
+
+dict.entries.each() do |key,entry|
+  entry.id
+  
+  entry.defns.each() do |defn|
+    defn.hyoukis.each() {|hyouki| }
+    defn.text
+    defn.words.each() {|word| }
+  end
+  
+  puts entry.build_hyouki()
+  puts entry.build_defn()
+  puts '---'
+end
+
+puts
+puts dict
+```
+
+### Fileable
+
+Any class that includes the `Fileable` mixin will have the following methods:
+
+- Class.load_file(file,mode: 'rt:BOM|UTF-8',**kargs)
+- save_file(file,mode: 'wt',**kargs)
+
+Any *kargs* will be passed to `File.open()`.
+
+```Ruby
+require 'nhkore/news'
+require 'nhkore/search_link'
+
+yn = NHKore::YasashiiNews.load_file()
+sl = NHKore::SearchLinks.load_file(NHKore::SearchLinks::DEFAULT_YASASHII_FILE)
+
+yn.articles.each() {|key,article| }
+yn.sha256s.each()  {|sha256,url|  }
+
+sl.links.each() do |key,link|
+  link.datetime
+  link.futsuurl
+  link.scraped?
+  link.sha256
+  link.title
+  link.url
+end
+
+#yn.save_file()
+#sl.save_file(NHKore::SearchLinks::DEFAULT_YASASHII_FILE)
+```
+
+### Sifter
+
+`Sifter` will sift & sort the `News` data into a single file. The data is sorted by frequency in descending order (i.e., most frequent words first).
+
+```Ruby
+require 'nhkore/datetime_parser'
+require 'nhkore/news'
+require 'nhkore/sifter'
+require 'time'
+
+news = NHKore::YasashiiNews.load_file()
+
+sifter = NHKore::Sifter.new(news)
+
+sifter.caption = 'Sakura Fields Forever!'
+
+# Filter the data.
+sifter.filter_by_datetime(NHKore::DatetimeParser.parse_range('2019-12-4...7'))
+sifter.filter_by_datetime([Time.new(2019,12,4),Time.new(2019,12,7)])
+sifter.filter_by_datetime(
+  from: Time.new(2019,12,4),to: Time.new(2019,12,7)
+)
+sifter.filter_by_title('桜')
+sifter.filter_by_url('k100')
+
+# Ignore certain columns from the output.
+sifter.ignore(:defn)
+sifter.ignore(:eng)
+
+# An array of the sifted words.
+words = sifter.sift() # Filtered & Sorted array of Word
+rows  = sifter.build_rows(words) # Ignored array of array
+
+# Choose the file format.
+#sifter.put_csv!()
+#sifter.put_html!()
+#sifter.put_json!()
+sifter.put_yaml!()
+
+# Save to a file.
+file = 'sakura.yml'
+
+if !File.exist?(file)
+  sifter.save_file(file)
+end
+```
+
+### Util, UserAgents, & DatetimeParser
+
+These provide a variety of useful methods/constants.
+
+Here are some of the most useful ones:
+
+```Ruby
+require 'nhkore/datetime_parser'
+require 'nhkore/user_agents'
+require 'nhkore/util'
+
+include NHKore
+
+puts '======='
+puts '[ Net ]'
+puts '======='
+# Get a random User Agent for HTTP header field 'User-Agent'.
+# - This is used by default in Scraper/SearchScraper.
+puts "User-Agent:  #{UserAgents.sample()}"
+
+uri = URI('https://www.bing.com/search?q=nhk')
+Util.replace_uri_query!(uri,q: 'banana')
+
+puts "URI query:   #{uri}" # https://www.bing.com/search?q=banana
+# nhk.or.jp
+puts "Domain:      #{Util.domain(URI('https://www.nhk.or.jp/news/easy').host)}"
+# Ben &amp; Jerry&#39;s<br>
+puts "Escape HTML: #{Util.escape_html("Ben & Jerry's\n")}"
+puts
+
+puts '========'
+puts '[ Time ]'
+puts '========'
+puts "JST now:   #{Util.jst_now()}"
+# Drops in JST_OFFSET, does not change hour/min.
+puts "JST time:  #{Util.jst_time(Time.now)}"
+puts "JST year:  #{Util::JST_YEAR}"
+puts "1999 sane? #{Util.sane_year?(1999)}" # true
+puts "1776 sane? #{Util.sane_year?(1776)}" # false
+puts "Guess 5:   #{DatetimeParser.guess_year(5)}"  # 2005
+puts "Guess 99:  #{DatetimeParser.guess_year(99)}" # 1999
+# => [2020-12-01 00:00:00 +0900, 2020-12-31 23:59:59 +0900]
+puts "Parse:     #{DatetimeParser.parse_range('2020-12')}"
+puts
+puts "JST timezone offset:        #{Util::JST_OFFSET}"
+puts "JST timezone offset hour:   #{Util::JST_OFFSET_HOUR}"
+puts "JST timezone offset minute: #{Util::JST_OFFSET_MIN}"
+puts
+
+puts '============'
+puts '[ Japanese ]'
+puts '============'
+
+JPN = ['桜','ぶ','ブ']
+
+def fmt_jpn()
+  fmt = []
+  
+  JPN.each() do |x|
+    x = yield(x)
+    x = x ? "\u2B55" : Util::JPN_SPACE unless x.is_a?(String)
+    fmt << x
+  end
+  
+  return "[ #{fmt.join(' | ')} ]"
+end
+
+puts "          #{fmt_jpn{|x| x}}"
+puts "Hiragana? #{fmt_jpn{|x| Util.hiragana?(x)}}"
+puts "Kana?     #{fmt_jpn{|x| Util.kana?(x)}}"
+puts "Kanji?    #{fmt_jpn{|x| Util.kanji?(x)}}"
+puts "Reduce:   #{Util.reduce_jpn_space("'     '")}"
+puts
+
+puts '========='
+puts '[ Files ]'
+puts '========='
+puts "Dir str?   #{Util.dir_str?('dir/')}"          # true
+puts "Dir str?   #{Util.dir_str?('dir')}"           # false
+puts "File str?  #{Util.filename_str?('file')}"     # true
+puts "File str?  #{Util.filename_str?('dir/file')}" # false
+```
+
 ## Hacking [^](#contents)
 
 ```
@@ -370,13 +844,35 @@ $ bundle exec rake nokogiri_other # macOS, Windows, etc.
 
 `$ bundle exec rake doc`
 
-### Installing Locally (without Network Access)
+### Installing Locally
+
+You can make some changes/fixes to the code and then install your local version:
 
 `$ bundle exec rake install:local`
 
-### Releasing/Publishing
+### Updating [^](#contents)
+
+This will update *core/* for you:
+
+`$ bundle exec rake update_core`
+
+### Releasing [^](#contents)
+
+1. Update *CHANGELOG.md*, *version.rb*, & *Gemfile.lock*
+    - *Raketary*: `$ raketary bump -v`
+    - Run: `$ bundle update`
+2. Run: `$ bundle exec rake update_core`
+3. Run: `$ bundle exec rake clobber pkg_core`
+4. Create a new release & tag
+    - Add `pkg/nhkore-core.zip`
+5. Run: `$ git pull`
+6. Upload GitHub package
+    - *Raketary*: `$ raketary github_pkg`
+7. Run: `$ bundle exec rake release`
+
+Releasing new HTML file for website:
 
-`$ bundle exec rake release`
+1. `$ bundle exec rake update_showcase`
 
 ## License [^](#contents)