From 2bd96af5c00eb8575ac29c28531d3156ec76e9fe Mon Sep 17 00:00:00 2001
From: Jed Fox <git@twopointzero.us>
Date: Sat, 28 Oct 2017 11:27:42 -0400
Subject: [PATCH] Add the Jekyll docs

---
 assets/stylesheets/application.css.scss |   1 +
 assets/stylesheets/pages/_jekyll.scss   |  35 +++++++++++++++
 lib/docs/filters/jekyll/clean_html.rb   |  55 ++++++++++++++++++++++++
 lib/docs/filters/jekyll/entries.rb      |  29 +++++++++++++
 lib/docs/scrapers/jekyll.rb             |  34 +++++++++++++++
 public/icons/docs/jekyll/16.png         | Bin 0 -> 357 bytes
 public/icons/docs/jekyll/16@2x.png      | Bin 0 -> 809 bytes
 public/icons/docs/jekyll/SOURCE         |   1 +
 8 files changed, 155 insertions(+)
 create mode 100644 assets/stylesheets/pages/_jekyll.scss
 create mode 100644 lib/docs/filters/jekyll/clean_html.rb
 create mode 100644 lib/docs/filters/jekyll/entries.rb
 create mode 100644 lib/docs/scrapers/jekyll.rb
 create mode 100644 public/icons/docs/jekyll/16.png
 create mode 100644 public/icons/docs/jekyll/16@2x.png
 create mode 100644 public/icons/docs/jekyll/SOURCE

diff --git a/assets/stylesheets/application.css.scss b/assets/stylesheets/application.css.scss
index e4314a0f..26e0b885 100644
--- a/assets/stylesheets/application.css.scss
+++ b/assets/stylesheets/application.css.scss
@@ -55,6 +55,7 @@
         'pages/github',
         'pages/go',
         'pages/haskell',
+        'pages/jekyll',
         'pages/jquery',
         'pages/julia',
         'pages/knockout',
diff --git a/assets/stylesheets/pages/_jekyll.scss b/assets/stylesheets/pages/_jekyll.scss
new file mode 100644
index 00000000..2a30051f
--- /dev/null
+++ b/assets/stylesheets/pages/_jekyll.scss
@@ -0,0 +1,35 @@
+._jekyll {
+  h2, h3 { @extend %block-heading; }
+
+  .note {
+    @extend %note;
+
+    h5 {
+      margin-top: 0.25em;
+    }
+
+    position: relative;
+    &::after {
+      content: attr(data-type);
+      opacity: 0.5;
+      text-transform: uppercase;
+      position: absolute;
+      top: 0.25em;
+      right: 0.5em;
+      font-size: 0.8em;
+      pointer-events: none;
+    }
+
+    // Other note types currently unstyled:
+    // plain
+    // tip
+    // feature
+    &.note-info { @extend %note-blue; }
+    &.note-warning { @extend %note-red; }
+    &.note-unreleased { @extend %note-orange; }
+  }
+
+  pre {
+    font-size: inherit;
+  }
+}
diff --git a/lib/docs/filters/jekyll/clean_html.rb b/lib/docs/filters/jekyll/clean_html.rb
new file mode 100644
index 00000000..d27d0ea4
--- /dev/null
+++ b/lib/docs/filters/jekyll/clean_html.rb
@@ -0,0 +1,55 @@
+module Docs
+  class Jekyll
+    class CleanHtmlFilter < Filter
+      def call
+        css('.improve, .section-nav').each(&:remove)
+
+        css('div.highlighter-rouge').each do |node|
+          pre = node.at_css('pre')
+
+          # copy over the highlighting metadata
+          match = /language-(\w+)/.match(node['class'])
+          # HACK: Prism shell highlighting highlights `|`,
+          # which makes the tree on this page look terrible
+          if match && !(slug == /structure/ && match[1] == 'sh')
+            lang = match[1]
+            if lang == 'sh'
+              lang = 'bash'
+            elsif lang == 'liquid'
+              lang = 'django' # Close enough.
+            end
+            pre['class'] = nil
+            pre['data-language'] = lang
+          end
+
+          # Remove the server-rendered syntax highlighting
+          code = pre.at_css('code')
+          code.content = code.text
+
+          # Remove the div.highlighter-rouge and div.highlight wrapping the <pre>
+          node.add_next_sibling pre
+          node.remove
+        end
+
+        css('code').each do |node|
+          node['class'] = ''
+        end
+
+        css('.note').each do |node|
+          node_type = /note ?(\w+)?/.match(node['class'])[1] || 'tip'
+
+          # <div class="note">...<br>...</div> -> <div class="note">...</div>
+          (node > 'br').each(&:remove)
+          # <div class="note">...<p>...<br><br>...</p>...</div> ->
+          # <div class="note">...<p>...<br>...</p>...</div>
+          node.css('br + br').each(&:remove)
+
+          node['class'] = "note note-#{node_type}"
+          node['data-type'] = node_type
+        end
+
+        doc
+      end
+    end
+  end
+end
diff --git a/lib/docs/filters/jekyll/entries.rb b/lib/docs/filters/jekyll/entries.rb
new file mode 100644
index 00000000..cf6b34b2
--- /dev/null
+++ b/lib/docs/filters/jekyll/entries.rb
@@ -0,0 +1,29 @@
+module Docs
+  class Jekyll
+    class EntriesFilter < Docs::EntriesFilter
+
+      def get_name
+        at_css('h1').content
+      end
+
+      def get_type
+        if /continuous-integration/.match(slug)
+          'Deployment'
+        else
+          nav_link = doc.document # document
+            .at_css('aside li.current') # item in navbar
+
+          if nav_link
+            nav_link
+              .parent # <ul> in navbar
+              .previous_element # header before <ul>
+              .content # category
+          else
+            'Miscellaneous'
+          end
+        end
+      end
+
+    end
+  end
+end
diff --git a/lib/docs/scrapers/jekyll.rb b/lib/docs/scrapers/jekyll.rb
new file mode 100644
index 00000000..988e77bd
--- /dev/null
+++ b/lib/docs/scrapers/jekyll.rb
@@ -0,0 +1,34 @@
+module Docs
+  class Jekyll < UrlScraper
+    self.type = 'jekyll'
+    self.release = '3.6.2'
+    self.base_url = 'https://jekyllrb.com/docs/'
+    self.root_path = 'home/'
+    self.links = {
+      home: 'https://jekyllrb.com/',
+      code: 'https://github.com/jekyll/jekyll'
+    }
+
+    html_filters.push 'jekyll/clean_html', 'jekyll/entries'
+
+    options[:trailing_slash] = true
+    options[:container] = 'article'
+    options[:skip] = [
+      '',
+      '/'
+    ]
+    options[:skip_patterns] = [
+      /conduct/,
+      /history/,
+      /maintaining/,
+      /contributing/
+    ]
+    options[:attribution] = <<-HTML
+      &copy; 2008&ndash;2017 Tom Preston-Werner and Jekyll contributors<br />
+      Licensed under
+        <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">
+          the MIT license
+        </a>
+    HTML
+  end
+end
diff --git a/public/icons/docs/jekyll/16.png b/public/icons/docs/jekyll/16.png
new file mode 100644
index 0000000000000000000000000000000000000000..aeb20c40aac35c0f9231dad3af159ffc04d1b60e
GIT binary patch
literal 357
zcmV-r0h<1aP)<h;3K|Lk000e1NJLTq000mG000mO1^@s6AM^iV0003jNkl<ZILoDz
z%}N4c6o#LfY8r=TW;Hg2EwUEPqHI!$L=d7?_hQ%MrDQ*gz(oVv4}`iB+=Ma+enyZI
zGhIO1_|e&(!^3;dd0(Ya$jAJn)TDt;*CmtLS=e7q0#qvJOvISnagI*AO|REm9-wI&
z#bOcLwy<rBt7=tl1>ZkG*L6}UgGQsla5#_yluBh(RmCt;+|=uGM|9F@cC%UZC}Qv!
z(Cv2Qj(F<(eAa51FK^smUZ5z-@(NT{<uLkUB?vGIdG3Nh&IjIshxOiPWA@Ff>mbBf
z4v^n=pxehvyWEb#h4SYDOw(lVL!b=>vvP@Mt0`yYBhMplK4C@hpsx|fe@Erl7e+#0
z?R%`BZE^kFN(_@SFO81lFrChrOhh7Jt`EX6TsqD_rl41{!e>3x00000NkvXXu0mjf
DRkEVU

literal 0
HcmV?d00001

diff --git a/public/icons/docs/jekyll/16@2x.png b/public/icons/docs/jekyll/16@2x.png
new file mode 100644
index 0000000000000000000000000000000000000000..1bf8b58f03aa7fd0d1550d9033551d377b18b62b
GIT binary patch
literal 809
zcmV+^1J?YBP)<h;3K|Lk000e1NJLTq001BW001Be1^@s6b9#F80008;Nkl<ZSi|j?
z&ubKC7{@;|^S(2at-J2JiIj=0K~PL!mBzR~l9FgIAx0Z}_u#)!igyos5JUvQLZP1Z
z=q1@|&{hu>v?gVv$wmrI7KvbFleiPc*_{~=K}E2bS)Jt42j1Ju`+VN-`+a$yN9pM~
z5U`1%vdOXO0OC^*NNw9jUtd4<x=Uq#j&gYh&+|4;fmAZZ-p)=YCmv$2+I&B9oS`Gb
zsH(a#0G8EGYdX!3Kb_+6q3@WVn`3)h8)wd*B?yA(pCFen5Rb=cG#d2x4{&67m_#DZ
zwX0X7SHQB`>FDUd^E{-K2q}?LGFvWl<;t%piV`hAE?+>?G<@GjN`aIDU6+iGj;<^D
zCjn@h;NZb5zVD-H8bYkyzR~cwefw7QzaW#zkVqun%Kv8F`QvvS$B7;wU+6_uRe~Tu
zig)rCi(~7Szv*9)Os44U?0VmP%PTC@YLrS-sA|Lj*<21OC9dmY7&>Bh7V&VB;ubSh
z@}>du`Cb}}&vAaciI^!9dpv{o%VlnyKNo#1*u8rXN#`Yt7cXGUJx3@i=8muU%d1nZ
zRztmiQzp#k3#{I{j<8>0C<-QE9zVudu^2jeXn>ZM7P{I}xKI8iSX?3A-io0K?168&
zckj>W`+@EQJ@C&I{=zakAeL>+LXPpjC-HqhdVpMaH}&ZfI|j4FVkUac!Te!_v9Zyn
z<PQa4S?zrJY6anX*!Romj*FR0QQn@WQmI7W5#{m)>eCar<)?_HRSXo&qeB$O$D6+W
zx)sng!8f~h;!e+^RP8nAqu>t>hAKQwE0D=#&?`@<Ei4fOV#zI-U+?11(+ZB`M6W<D
zo5g)J0WWG8ih^9SF-MMtE<8;G>`Z)tH~$PhU`>9*<XNVRQfX>q=7N`K2vuO9teJ0U
zkmB9Dp$pFk{bgC!>5pxCQC(u-#7T6w&epzO7LE>b>F3L#`v3n5WxcauI^D{?{rg$9
nZ5}+h|5=iU0{DM8jVfLPD`NW9t^n>C00000NkvXXu0mjfVpxkO

literal 0
HcmV?d00001

diff --git a/public/icons/docs/jekyll/SOURCE b/public/icons/docs/jekyll/SOURCE
new file mode 100644
index 00000000..18496fca
--- /dev/null
+++ b/public/icons/docs/jekyll/SOURCE
@@ -0,0 +1 @@
+https://avatars3.githubusercontent.com/u/3083652