programming-pages 0.5.8

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 53ea0240bc5e5b3a1caa23ed74819a1a8b37e4639998dfbd221069ef354a9bb9
+  data.tar.gz: b8360256c3ea74187010e43a7c67aba03a1c1c4843c5436e319d239c2a6920b0
+SHA512:
+  metadata.gz: ff88662942961e008018692c2e26ac18a9f7502f6d311ccca3ecbf1e3bdfca5cea3f6fb22481f0b6cecd04edefba59dff34c6b1c383b2955cff87d91cc913302
+  data.tar.gz: 5d73587a5ce8c7edd1809c18bfdbe615a181a6eadaa9a4804575b26d2f6af66684e99c713aec96452a77dc54ddec133e581ea6ac273adfd872f2464bd8a6e87a

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at pixeldroid.com@gmail.com. The project team will review and investigate complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/CONTRIBUTING.md

@@ -0,0 +1,15 @@
+# Contributing to programming-pages
+
+## How to Help
+
+Contributions are welcome in the form of useful [pull requests](https://help.github.com/articles/creating-a-pull-request/) that do one of the following:
+
+1. Correct a typo or provide clearer wording
+1. Add missing information that will make things easier to understand
+1. Identify a bug and the steps to reproduce it
+1. Produce a bug fix or performance improvement
+1. Implement a useful new feature
+
+## Code of Conduct
+
+This project and its participants are governed by the project's [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 pixeldroid
+
+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.

data/README.md

@@ -0,0 +1,157 @@
+# programming-pages
+
+a Jekyll theme for publishing code documentation to GitHub pages
+
+> See **programming pages** used to document itself here: https://pixeldroid.github.io/programming-pages/
+
+[![screenshot][screenshot]][programming-pages-docs]
+
+<br/>
+
+
+[installation](#installation) | [usage](#usage) | [building](#building) | [contributing](#contributing)
+
+
+## installation
+
+### as a remote theme
+
+Specify `pixeldroid/programming-pages` as your remote theme in `_config.yml`:
+
+```yml
+plugins:
+  - jekyll-remote-theme
+
+remote_theme: pixeldroid/programming-pages
+```
+
+### as a gem
+
+Follow the Jekyll directions for [installing a gem-based theme][jekyll-theme]
+
+`Gemfile`:
+
+```ruby
+gem 'programming-pages'
+```
+
+`_config.yml`:
+
+```yml
+theme: programming-pages
+```
+
+### as a local copy of the files
+
+1. Download the latest [release][releases]
+1. Extract it into your project under a folder of your choice (e.g. `docs/`)
+
+
+## usage
+
+> first: <br>
+> 1. [Configure a publishing source for GitHub Pages][ghpages-howto] so GitHub knows where to find your documentation.
+
+1. [Author documentation][author-documentation]
+1. [Push to GitHub][push-to-github]
+1. Visit your documentation site at https://&lt;`username`&gt;.github.io/&lt;`project`&gt;
+1. _repeat_
+
+
+## building
+
+**programming pages** depends on [Jekyll][jekyll], [Semantic UI][semantic], and [jQuery][jquery].
+The dependencies are all captured and coordinated in the source of this project,
+but if you want to update a dependency or change its configuration,
+you'll need to be able to build them from source.
+
+### building the static site locally
+
+> first: <br>
+> 1. [install jekyll][jekyll-install] and the [github-pages gem][ghpages-install]: `bundle install`
+
+```console
+rake docs
+open http://localhost:4000/
+```
+
+### generating the semantic ui files
+
+> first: <br>
+> 1. ensure you can [build semantic ui][semantic-build] (requires nodejs, npm, gulp): `gulp build`
+> 1. check out the [programming-pages branch of the pixeldroid fork][semantic-custom] of semantic ui
+
+```console
+rake semantic['/path/to/programming-pages-semantic']
+```
+
+#### semantic ui modules
+
+The Semantic UI modules required by this project are declared in `build/semantic/semantic.json`.
+
+### generating the jQuery file
+
+> first <br>
+> 1. ensure you can [build jQuery][jquery-build] (requires nodejs, grunt): `grunt default`
+
+```console
+grunt custom:-ajax,-wrap remove_map_comment
+cp /path/to/jquery/dist/jquery.min.js /path/to/programming-pages/_includes/scripts/jquery/jquery-<version>.custom.min.js
+```
+
+Don't forget to update `assets/site.js` with the new filename.
+
+#### jQuery modules
+
+> Smaller custom subsets of the jQuery library can be built by excluding unwanted modules.
+> (see https://github.com/jquery/jquery#modules)
+
+This project excludes the following unused modules to reduce file size:
+
+##### excluded
+- `ajax`
+- `wrap`
+
+##### required
+- `attr`
+- `classes`
+- `core`
+- `css`
+- `data`
+- `deferred` (required for `effects`)
+- `deprecated` (for jQuery Address's use of `bind`)
+- `dimensions`
+- `effects`
+- `events`
+- `filtering`
+- `init`
+- `manipulation`
+- `offsets`
+- `parseHTML`
+- `prop`
+- `ready`
+- `traversing`
+- `val`
+
+## contributing
+
+[Pull requests][pull-requests] for improved documentation, bug fixes and useful features are all welcome. :gift_heart:
+
+
+
+[author-documentation]: https://pixeldroid.github.io/programming-pages/guides/Authoring-Documentation/#/guides/ "Authoring documentation using the programming pages site template"
+[ghpages-howto]: https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/ "How to Configure a publishing source for GitHub Pages"
+[ghpages-install]: https://github.com/github/pages-gem "GitHub Pages Ruby Gem"
+[jekyll]: https://jekyllrb.com/ "Simple, blog-aware, static sites"
+[jekyll-install]: https://jekyllrb.com/docs/installation/ "How to install Jekyll"
+[jekyll-theme]: https://jekyllrb.com/docs/themes/#installing-a-theme "Installing a gem-based theme"
+[jquery]: https://github.com/jquery/jquery#how-to-build-your-own-jquery "jQuery is a fast, small, and feature-rich JavaScript library"
+[jquery-build]: https://github.com/jquery/jquery#how-to-build-your-own-jquery "How to build your own jQuery"
+[programming-pages-docs]: https://pixeldroid.github.io/programming-pages/ "a Jekyll theme for publishing code documentation to GitHub pages"
+[pull-requests]: https://github.com/pixeldroid/programming-pages/pulls "Pull requests for the Programming Pages template project"
+[push-to-github]: https://help.github.com/articles/pushing-to-a-remote/ "Pushing to a remote"
+[releases]: https://github.com/pixeldroid/programming-pages/releases "Packaged releases of the Programming Pages template"
+[screenshot]: screenshot.png "screenshot of a programming pages generated site"
+[semantic]: https://semantic-ui.com/ "Semantic is a UI component framework based around useful principles from natural language"
+[semantic-build]: https://semantic-ui.com/introduction/build-tools.html "Semantic UI build tools"
+[semantic-custom]: https://github.com/pixeldroid/Semantic-UI/tree/programming-pages "programming-pages branch of Semantic UI"

data/_config.yml

@@ -0,0 +1,40 @@
+---
+# default site settings
+# configure these values for your project
+project:
+  name: "{project_name}"
+  owner: "{project_owner}"
+  repo: "{project_repo}"
+  version: "{project_version}"
+
+collections:
+  api:
+    output: true
+    permalink: "/:collection/:path/"
+    title: API
+    tab-order: 1
+  examples:
+    output: true
+    permalink: "/:collection/:path/"
+    title: Examples
+    tab-order: 2
+  guides:
+    output: true
+    permalink: "/:collection/:path/"
+    title: Guides
+    tab-order: 3
+
+module_root: "/api"
+example_root: "/examples"
+guide_root: "/guides"
+
+code_indent: "  "
+highlighter: rouge
+permalink: pretty
+sass:
+  style: compressed
+
+plugins:
+  - jemoji
+  - jekyll-remote-theme
+remote_theme: pixeldroid/programming-pages

data/_data/icons/theme.yml

@@ -0,0 +1,73 @@
+##
+##  SVG icon data file for the programming pages theme
+##
+##  each icon has the following properties:
+##    - viewbox
+##    - path
+##
+##  to embed via the icon macro: {% include icon.liquid id='<id>' %}
+##  to retrieve this data directly via liquid: {% site.data.icons.theme[<id>] %}
+
+
+# Glyphicon Halflings in Bootstrap by Jan Kovařík - http://getbootstrap.com/components/#glyphicons
+# License - https://github.com/twbs/bootstrap/blob/master/LICENSE (MIT)
+#           http://glyphicons.com/license/
+#
+# SVG processing from svg-icon - https://leungwensen.github.io/svg-icon/#bootstrap
+chevron-right:
+  viewbox: '0 0 749 1102'
+  path: 'M749 551l-551 551L0 904l353-353L0 198 198 0z'
+
+
+# Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome
+# License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
+#
+# SVG processing from svg-icon - https://leungwensen.github.io/svg-icon/#awesome
+bars:
+  viewbox: '0 0 1536 1280'
+  path: 'M1536 1088v128q0 26-19 45t-45 19H64q-26 0-45-19t-19-45v-128q0-26 19-45t45-19h1408q26 0 45 19t19 45zm0-512v128q0 26-19 45t-45 19H64q-26 0-45-19T0 704V576q0-26 19-45t45-19h1408q26 0 45 19t19 45zm0-512v128q0 26-19 45t-45 19H64q-26 0-45-19T0 192V64q0-26 19-45T64 0h1408q26 0 45 19t19 45z'
+check-circle:
+  viewbox: '0 0 1536 1536'
+  path: 'M1284 606q0-28-18-46l-91-90q-19-19-45-19t-45 19L677 877 451 651q-19-19-45-19t-45 19l-91 90q-18 18-18 46 0 27 18 45l362 362q19 19 45 19 27 0 46-19l543-543q18-18 18-45zm252 162q0 209-103 385.5T1153.5 1433 768 1536t-385.5-103T103 1153.5 0 768t103-385.5T382.5 103 768 0t385.5 103T1433 382.5 1536 768z'
+exclamation-circle:
+  viewbox: '0 0 1536 1536'
+  path: 'M768 0q209 0 385.5 103T1433 382.5 1536 768t-103 385.5-279.5 279.5T768 1536t-385.5-103T103 1153.5 0 768t103-385.5T382.5 103 768 0zm128 1247v-190q0-14-9-23.5t-22-9.5H673q-13 0-23 10t-10 23v190q0 13 10 23t23 10h192q13 0 22-9.5t9-23.5zm-2-344l18-621q0-12-10-18-10-8-24-8H658q-14 0-24 8-10 6-10 18l17 621q0 10 10 17.5t24 7.5h185q14 0 23.5-7.5T894 903z'
+exclamation-triangle:
+  viewbox: '0 0 1806.666748046875 1664'
+  path: 'M1031.333 1375v-190q0-14-9.5-23.5t-22.5-9.5h-192q-13 0-22.5 9.5t-9.5 23.5v190q0 14 9.5 23.5t22.5 9.5h192q13 0 22.5-9.5t9.5-23.5zm-2-374l18-459q0-12-10-19-13-11-24-11h-220q-11 0-24 11-10 7-10 21l17 457q0 10 10 16.5t24 6.5h185q14 0 23.5-6.5t10.5-16.5zm-14-934l768 1408q35 63-2 126-17 29-46.5 46t-63.5 17h-1536q-34 0-63.5-17t-46.5-46q-37-63-2-126l768-1408q17-31 47-49t65-18 65 18 47 49z'
+file-outline:
+  viewbox: '0 0 1536 1792'
+  path: 'M1468 380q28 28 48 76t20 88v1152q0 40-28 68t-68 28H96q-40 0-68-28t-28-68V96q0-40 28-68T96 0h896q40 0 88 20t76 48zm-444-244v376h376q-10-29-22-41l-313-313q-12-12-41-22zm384 1528V640H992q-40 0-68-28t-28-68V128H128v1536h1280z'
+folder-outline:
+  viewbox: '0 0 1664 1408'
+  path: 'M1536 1184V480q0-40-28-68t-68-28H736q-40 0-68-28t-28-68v-64q0-40-28-68t-68-28H224q-40 0-68 28t-28 68v960q0 40 28 68t68 28h1216q40 0 68-28t28-68zm128-704v704q0 92-66 158t-158 66H224q-92 0-158-66T0 1184V224q0-92 66-158T224 0h320q92 0 158 66t66 158v32h672q92 0 158 66t66 158z'
+home:
+  viewbox: '0 0 1613.3333740234375 1283'
+  path: 'M1382.667 739v480q0 26-19 45t-45 19h-384V899h-256v384h-384q-26 0-45-19t-19-45V739q0-1 .5-3t.5-3l575-474 575 474q1 2 1 6zm223-69l-62 74q-8 9-21 11h-3q-13 0-21-7l-692-577-692 577q-12 8-24 7-13-2-21-11l-62-74q-8-10-7-23.5t11-21.5l719-599q32-26 76-26t76 26l244 204V35q0-14 9-23t23-9h192q14 0 23 9t9 23v408l219 182q10 8 11 21.5t-7 23.5z'
+info-circle:
+  viewbox: '0 0 1536 1536'
+  path: 'M1024 1248v-160q0-14-9-23t-23-9h-96V544q0-14-9-23t-23-9H544q-14 0-23 9t-9 23v160q0 14 9 23t23 9h96v320h-96q-14 0-23 9t-9 23v160q0 14 9 23t23 9h448q14 0 23-9t9-23zM896 352V192q0-14-9-23t-23-9H672q-14 0-23 9t-9 23v160q0 14 9 23t23 9h192q14 0 23-9t9-23zm640 416q0 209-103 385.5T1153.5 1433 768 1536t-385.5-103T103 1153.5 0 768t103-385.5T382.5 103 768 0t385.5 103T1433 382.5 1536 768z'
+interface: # fa: neuter
+  viewbox: '0 0 1152 1792'
+  path: 'M1152 576q0 221-147.5 384.5T640 1148v612q0 14-9 23t-23 9h-64q-14 0-23-9t-9-23v-612q-217-24-364.5-187.5T0 576q0-117 45.5-223.5t123-184 184-123T576 0t223.5 45.5 184 123 123 184T1152 576zm-576 448q185 0 316.5-131.5T1024 576 892.5 259.5 576 128 259.5 259.5 128 576t131.5 316.5T576 1024z'
+magnifier: # fa: search
+  viewbox: '0 0 1664 1664'
+  path: 'M1152 704q0-185-131.5-316.5T704 256 387.5 387.5 256 704t131.5 316.5T704 1152t316.5-131.5T1152 704zm512 832q0 52-38 90t-90 38q-54 0-90-38l-343-342q-179 124-399 124-143 0-273.5-55.5t-225-150-150-225T0 704t55.5-273.5 150-225 225-150T704 0t273.5 55.5 225 150 150 225T1408 704q0 220-124 399l343 343q37 37 37 90z'
+
+
+# Entypo pictograms by Daniel Bruce — www.entypo.com
+# License - http://creativecommons.org/licenses/by-sa/4.0/ (CC BY-SA 4.0)
+#
+# SVG processing from svg-icon - https://leungwensen.github.io/svg-icon/#entypo
+cc-by:
+  viewbox: '0 0 960 960'
+  path: 'M480 304c-44 0-66-22.667-66-68s22-68 66-68c45.333 0 68 22.667 68 68s-22.667 68-68 68m98 26c9.333 0 16.667 2.667 22 8 6.667 6.667 10 14 10 22v196h-56v234H406V556h-56V360c0-8 3.333-15.333 10-22 5.333-5.333 12.667-8 22-8h196M480 0c133.333 0 246.667 46.667 340 140s140 206.667 140 340c0 132-46.667 245-140 339S613.333 960 480 960c-132 0-245-47-339-141S0 612 0 480c0-133.333 47-246.667 141-340S348 0 480 0m0 872c108 0 200.333-38.333 277-115s115-169 115-277c0-109.333-38.333-202-115-278S588 88 480 88s-200.333 38-277 114S88 370.667 88 480c0 108 38.333 200.333 115 277s169 115 277 115'
+cc-cc:
+  viewbox: '0 0 964 962'
+  path: 'M476.667 1.333c132-1.333 245.333 44 340 136s143.333 204 146 336c1.333 133.333-44 247.333-136 342s-204.667 143.333-338 146c-132 1.333-245.667-44.333-341-137s-143.667-205-145-337C0 354 45 240 137.667 145.333s205.667-142.667 339-144m12 858c104-1.333 192.667-39.333 266-114s109.333-164.667 108-270C861.334 370 823 281 747.667 208.333s-165-108.333-269-107c-105.333 1.333-194.333 39.333-267 114s-108.333 164.667-107 270c1.333 105.333 39.333 194.333 114 267s164.667 108.333 270 107m-124-298c26.667 0 46-13.333 58-40l56 30c-13.333 24-30 41.333-50 52-21.333 13.333-44.667 20-70 20-41.333 0-74.667-12.667-100-38-25.333-24-38-58.667-38-104s12.667-80.667 38-106 57.333-38 96-38c57.333 0 98.667 22 124 66l-62 32c-6.667-13.333-14.667-22.667-24-28-9.333-5.333-18.667-8-28-8-40 0-60 27.333-60 82 0 25.333 4.667 44.667 14 58 12 14.667 27.333 22 46 22m266 0c28 0 46.667-13.333 56-40l58 30c-12 21.333-28.667 38.667-50 52-21.333 13.333-44.667 20-70 20-42.667 0-76-12.667-100-38-25.333-24-38-58.667-38-104 0-42.667 12.667-78 38-106 25.333-25.333 58-38 98-38 56 0 96 22 120 66l-60 32c-6.667-13.333-14.667-22.667-24-28-9.333-5.333-18.667-8-28-8-41.333 0-62 27.333-62 82 0 24 5.333 43.333 16 58 10.667 14.667 26 22 46 22'
+flow-line:
+  viewbox: '0 0 240 840'
+  path: 'M168 608c48 22.667 72 60 72 112 0 33.333-11.667 61.667-35 85s-51.667 35-85 35-61.667-11.667-85-35-35-51.667-35-85c0-52 24-89.333 72-112V230C24 207.333 0 170.667 0 120c0-33.333 11.667-61.667 35-85S86.667 0 120 0s61.667 11.667 85 35 35 51.667 35 85c0 50.667-24 87.333-72 110v378M52 120c0 18.667 6.667 34.667 20 48 13.333 13.333 29.333 20 48 20s35-6.667 49-20 21-29.333 21-48c0-20-7-36.667-21-50-14-13.333-30.333-20-49-20s-34.667 6.667-48 20c-13.333 13.333-20 30-20 50m68 668c18.667 0 35-6.667 49-20s21-29.333 21-48c0-20-7-36.667-21-50-14-13.333-30.333-20-49-20s-34.667 6.667-48 20c-13.333 13.333-20 30-20 50 0 18.667 6.667 34.667 20 48 13.333 13.333 29.333 20 48 20'
+flow-tree:
+  viewbox: '0 0 940 940'
+  path: 'M868 708c48 22.667 72 60 72 112 0 33.333-11.667 61.667-35 85s-51.667 35-85 35-61.667-11.667-85-35-35-51.667-35-85c0-52 24-89.333 72-112V594c0-52-25.333-78-76-78H596c-29.333 0-55.333-4-78-12v204c48 22.667 72 60 72 112 0 33.333-11.667 61.667-35 85s-51.667 35-85 35-61.667-11.667-85-35-35-51.667-35-85c0-52 24-89.333 72-112V504c-20 8-45.333 12-76 12H246c-22.667 0-40.333 6.333-53 19-12.667 12.667-20 23.667-22 33-2 9.333-3 18-3 26v114c48 22.667 72 60 72 112 0 33.333-11.667 61.667-35 85s-51.667 35-85 35-61.667-11.667-85-35-35-51.667-35-85c0-52 24-89.333 72-112V594c0-42.667 14.333-82 43-118s72.333-54 131-54h100c50.667 0 76-17.333 76-52V230c-48-22.667-72-59.333-72-110 0-33.333 11.667-61.667 35-85s51.667-35 85-35 61.667 11.667 85 35 35 51.667 35 85c0 50.667-24 87.333-72 110v140c0 34.667 26 52 78 52h100c57.333 0 100.333 18 129 54s43 75.333 43 118v114M190 820c0-20-7-36.667-21-50-14-13.333-30.333-20-49-20s-34.667 6.667-48 20c-13.333 13.333-20 30-20 50 0 18.667 6.667 34.667 20 48 13.333 13.333 29.333 20 48 20s35-6.667 49-20 21-29.333 21-48m212-700c0 18.667 6.667 34.667 20 48 13.333 13.333 29.333 20 48 20s35-6.667 49-20 21-29.333 21-48c0-20-7-36.667-21-50-14-13.333-30.333-20-49-20s-34.667 6.667-48 20c-13.333 13.333-20 30-20 50m138 700c0-20-7-36.667-21-50-14-13.333-30.333-20-49-20s-34.667 6.667-48 20c-13.333 13.333-20 30-20 50 0 18.667 6.667 34.667 20 48 13.333 13.333 29.333 20 48 20s35-6.667 49-20 21-29.333 21-48m280 68c18.667 0 35-6.667 49-20s21-29.333 21-48c0-20-7-36.667-21-50-14-13.333-30.333-20-49-20s-34.667 6.667-48 20c-13.333 13.333-20 30-20 50 0 18.667 6.667 34.667 20 48 13.333 13.333 29.333 20 48 20'

data/_includes/elements/attribution.html

@@ -0,0 +1,28 @@
+<table class="ui unstackable very basic collapsing table">
+<tbody>
+
+<tr>
+  <td>
+  <div class="license">
+    <a class="larger text" rel="license" href="https://creativecommons.org/licenses/by/4.0/" title="Creative Commons Attribution 4.0 International license">
+    {% include icon.liquid id='cc-cc' %}{% include icon.liquid id='cc-by' %}
+    </a>
+  </div>
+
+  <div>
+    <strong>{{ site.project.name }}</strong>
+    {{ "now" | date: "%Y" }} {{ site.project.owner }}
+    <br>
+    <a class="project-repo" href="{{ site.project.repo }}">{{ site.project.repo }}</a>
+  </div>
+  </td>
+</tr>
+
+<tr>
+  <td class="smaller text">
+  <strong>programming pages</strong> template v{{ layout.theme_version }} (<a href="{{ layout.theme_url }}" title="a documentation template for GitHub Pages">{{ layout.theme_url }}</a>)
+  </td>
+</tr>
+
+</tbody>
+</table>

data/_includes/elements/help.html

@@ -0,0 +1,24 @@
+<h1 class="ui dividing header">Keyboard Shortcuts</h1>
+
+<div class="content">
+<table class="ui very basic table"><tbody>
+  <tr>
+    <td class="right aligned"><div class="ui basic label">s</div></td>
+    <td>focus <strong>s</strong>earch bar (<div class="ui very tight label">enter</div> to select, <div class="ui very tight label">▲ / ▼</div> to change selection)</td>
+  </tr>
+  {% for collection in site.collections %}
+  {% unless collection.label == 'posts' %}
+  {% capture label %}{{ collection.label | downcase }}{% endcapture %}
+  {% capture key %}{{ label | split: '' | first }}{% endcapture %}
+  <tr>
+    <td class="right aligned"><div class="ui basic label">g {{ key }}</div></td>
+    <td><strong>g</strong>o to <strong>{{ key }}</strong>{{ label | remove_first: key }}</td>
+  </tr>
+  {% endunless %}
+  {% endfor %}
+  <tr>
+    <td class="right aligned"><div class="ui basic label">h</div></td>
+    <td>toggle this help (<div class="ui very tight label">esc</div> also exits)</td>
+  </tr>
+</tbody></table>
+</div>

data/_includes/elements/indices.html

@@ -0,0 +1,225 @@
+<div class="ui inverted large menu">
+<div class="item" style="padding-top: 1.6em;">
+{% include elements/search.html %}
+</div>
+</div>
+
+<div class="ui fitted inverted divider"></div>
+
+{% assign collection_list = site.collections %}
+
+{% assign ordered = '' | split: '' %}
+{% assign endered = '' | split: '' %}
+{% assign unorder = '' | split: '' %}
+{% for collection in collection_list %}
+  {% unless collection.label == 'posts' or collection.docs.size == 0 %}
+    {% if collection.tab-order %}
+      {% if collection.tab-order < 0 %}{% assign endered = endered | push: collection %}
+      {% else %}{% assign ordered = ordered | push: collection %}
+      {% endif %}
+    {% else %}{% assign unorder = unorder | push: collection %}
+    {% endif %}
+  {% endunless %}
+{% endfor %}
+{% assign ordered = ordered | sort: 'tab-order' %}
+{% assign endered = endered | sort: 'tab-order' | reverse %}
+{% assign collection_list = ordered | concat: unorder | concat: endered %}
+
+<div id="collection-tabs" class="ui inverted stackable pointing secondary menu">
+{% for collection in collection_list %}
+{% capture tab_class %}{% if forloop.first %}active {% endif %}item{% endcapture %}
+  <a class="{{ tab_class }}" data-tab="{{ collection.label | downcase }}">{{ collection.title }}</a>
+{% endfor %}
+</div>
+
+{% for collection in collection_list %}
+{% capture tab_class %}ui {% if forloop.first %}active {% endif %}inverted tab segment{% endcapture %}
+<div class="{{ tab_class }}" data-tab="{{ collection.label | downcase }}">
+<h4 class="ui header">{{ collection.title }}</h4>
+<div class="ui inverted link list">
+{% assign doc_list = collection.docs %}
+{% assign ordered_doc_list = '' | split: '' %}
+
+{%- comment %}
+for guides, we want to support user-defined ordering, but not require it in every guide.
+
+this means we have to create our own file tree, keeping children with parents as we re-sort
+the collection list from its default alphabetical order into user order, and for that,
+we want to perform a depth-first iterative visitation of the page tree.
+
+here's a psuedocode implementation in a javascript-like language; given root:
+
+  curr = root;
+  stack = [];
+  stack.push(root);
+  while (stack.length > 0) {
+    if (curr) {
+      print(curr);
+
+      if (curr.sibling)
+        stack.push(curr.sibling);
+
+      curr = curr.child;
+    }
+    else
+      curr = stack.pop();
+  }
+
+but liquid brings some interesting challenges:
+- no while loops
+- no infinite loops
+- no custom objects or hashes, just ordered arrays
+- no array mutation in place
+- no actual tree structure to start with, just a list of docs
+
+so our strategy is to:
+- start by bucketing the docs into levels, to get a tree-like context
+  - levels correspond to 'generations', but not always parent-child links
+    - parent-child relationships have to be tested by comparing path segments
+  - items in the same level are of the same generation, but not always siblings
+    - sibling relationships have to be tested by comparing path segments
+- use arrays for tree nodes so we can store state (a 2-tuple: level index, item index)
+- push state onto a stack made of an array and the push/pop operations from jekyll
+- use a pseudo-infinite range loop with large bounds and a break clause in place of a while loop
+{% endcomment -%}
+
+{%- comment %} first, calculate max_depth as deepest level index {% endcomment -%}
+{% assign max_depth = 0 %}
+{% for doc in doc_list %}
+  {% assign depth = doc.path | split:'/' | size | minus:2 %} {%- comment %} minus one to convert from length to index, minus two to ignore root collection directory (_guides/) {% endcomment -%}
+  {% if depth > max_depth %}{% assign max_depth = depth %}{% endif %}
+{% endfor %}
+
+{%- comment %} separate docs into levels, and sort by user-defined order value {% endcomment -%}
+{%- comment %} ordering: 0 is first, -1 is last, undefined orders go in the middle alphabetically
+                first ---------> middle ----------------------> last --------->|
+                [0..positive N]..[no order defined, use alpha]..[negative N..-1]
+{% endcomment -%}
+{% assign leveled = '' | split: '' %}
+{% for i in (0..max_depth) %}
+  {% assign new = '' | split: '' %}
+  {% assign ordered = '' | split: '' %}
+  {% assign endered = '' | split: '' %}
+  {% assign unorder = '' | split: '' %}
+  {% for doc in doc_list %}
+    {% assign depth = doc.path | split:'/' | size | minus:2 %}
+    {% if depth == i %}
+      {% if doc.order %}
+        {% if doc.order < 0 %}{% assign endered = endered | push: doc %}
+        {% else %}{% assign ordered = ordered | push: doc %}
+        {% endif %}
+      {% else %}{% assign unorder = unorder | push: doc %}
+      {% endif %}
+    {% endif %}
+  {% endfor %}
+  {% assign ordered = ordered | sort: 'order' %}
+  {% assign endered = endered | sort: 'order' | reverse %}
+  {% assign new = ordered | concat: unorder | concat: endered %}
+  {% assign leveled = leveled | push: new %}
+{% endfor %}
+
+{%- comment %} set root and make current be root {% endcomment -%}
+{%- assign root = '' | split: '' -%}
+{%- assign root = root | push: 0 -%} {%- comment %} level index {% endcomment -%}
+{%- assign root = root | push: 0 -%} {%- comment %} group index {% endcomment -%}
+{%- assign curr = root -%}
+{%- comment %} create a stack and initialize it with the root node {% endcomment -%}
+{%- assign stack = '' | split: '' -%}
+{%- assign stack = stack | push: root -%}
+
+{%- comment %} fake a while loop with a fake infinite loop, being sure to bail when all nodes are processed {% endcomment -%}
+{%- assign enough = doc_list.size | times: 2 -%} {%- comment %} estimate the worst case number of iterations required {% endcomment -%}
+{%- for ever in (0..enough) -%}
+{%- if stack.size == 0 %}{% break %}{% endif -%}
+  {%- comment %} if we have a current node, record it, push next sibling on the stack, and move on to first child {% endcomment -%}
+  {%- if curr -%}
+    {%- comment %} print curr {% endcomment -%}
+    {%- assign l = curr[0] -%}                       {%- comment %} level {% endcomment -%}
+    {%- assign e = curr[1] -%}                       {%- comment %} entry {% endcomment -%}
+    {%- assign d = leveled[l][e] -%}                 {%- comment %} doc {% endcomment -%}
+    {%- assign p = d.path | split: '/' -%}           {%- comment %} path parts {% endcomment -%}
+    {%- assign t = p | last | split: '.' | first -%} {%- comment %} title, minus file extension {% endcomment -%}
+    {%- assign _ = p | pop -%}                       {%- comment %} drop file part {% endcomment -%}
+    {%- assign s = _ | last -%}                      {%- comment %} section (containing folder) {% endcomment -%}
+
+    {%- comment %} record node docs in visitation order {% endcomment -%}
+    {%- assign ordered_doc_list = ordered_doc_list | push: d -%}
+
+    {%- comment %} clear current node now that it's recorded {% endcomment -%}
+    {%- assign curr = nil -%}
+
+    {%- comment %} find and push next sibling in current group (if any) {% endcomment -%}
+    {%- assign e1 = e | plus: 1 -%}
+    {%- assign en = leveled[l].size | minus: 1 -%}
+    {%- for ei in (e1..en) -%} {%- comment %} look forward from current entry's index {% endcomment -%}
+      {%- assign di = leveled[l][ei] -%}
+      {%- assign pi = di.path | split: '/' -%}
+      {%- assign pi = pi | pop -%}
+      {%- assign si = pi | last -%}
+      {%- if si == s %} {%- comment %} siblings share the same section {% endcomment -%}
+        {%- comment %} ..and each higher path component also needs to match so we don't falsely select a separate subtree using the same names {% endcomment -%}
+        {%- assign full_match = true -%}
+        {%- for i in (0..l) -%}{%- unless pi[i] == p[i] -%}{%- assign full_match = false -%}{%- break -%}{%- endunless -%}{%- endfor -%}
+        {%- if full_match -%}
+          {%- assign next_item = '' | split: '' -%}
+          {%- assign next_item = next_item | push: l -%}
+          {%- assign next_item = next_item | push: ei -%}
+          {%- assign stack = stack | push: next_item -%}
+          {%- break -%}
+        {%- endif -%}
+      {%- endif -%}
+    {%- endfor -%}
+
+    {%- comment %} find and set curr to first matching child in next level group (if any) {% endcomment -%}
+    {%- if l < max_depth -%}
+      {%- assign l1 = l | plus: 1 -%}
+      {%- assign ei = 0 -%} {%- comment %} start at beginning of entry group {% endcomment -%}
+      {%- for di in leveled[l1] -%}
+        {%- assign pi = di.path | split:'/' -%}
+        {%- if pi[l1] == t %} {%- comment %} children are found in directories that match their parent's title {% endcomment -%}
+        {%- comment %} ..and each higher path component also needs to match so we don't falsely select a separate subtree using the same names {% endcomment -%}
+          {%- assign full_match = true -%}
+          {%- for i in (0..l) -%}{%- unless pi[i] == p[i] -%}{%- assign full_match = false -%}{%- break -%}{%- endunless -%}{%- endfor -%}
+          {%- if full_match -%}
+            {%- assign curr = '' | split: '' -%}
+            {%- assign curr = curr | push: l1 -%}
+            {%- assign curr = curr | push: ei -%}
+            {%- break -%}
+          {%- endif -%}
+        {%- endif -%}
+        {%- assign ei = ei | plus: 1 -%}
+      {%- endfor -%}
+    {%- endif -%}
+
+  {%- comment %} if no current node, pop from stack and start the loop over {% endcomment -%}
+  {%- else -%}
+    {%- assign curr = stack | last -%}
+    {%- assign stack = stack | pop %}
+  {%- endif -%}
+{%- endfor -%}
+
+{% assign doc_list = ordered_doc_list %}
+
+{% for doc in doc_list %}
+  {% capture link %}{{ doc.title }}{% endcapture %}
+  {% capture url %}{{ doc.url }}#/{{ collection.label | downcase }}/{% endcapture %}
+  {% capture item_class %}{% if doc.title == page.title %}active {% endif %}item{% endcapture %}
+  {% case doc.layout %}
+    {% when 'package' %}
+      {% capture link %}{% include icon.liquid id='folder-outline' %} {% include package_shortener.liquid package=doc.module %}{% endcapture %}
+    {% when 'type' %}
+      {% capture pkg %}{{ doc.module }}.{{ doc.name }}{% endcapture %}
+      {% capture link %}{% include package_shortener.liquid package=pkg %}{% endcapture %}
+    {% when 'page' %}
+      {% assign path_bits = doc.relative_path | split: '.' | first | split: '/' %}
+      {% assign n = path_bits.size | minus: 2 %}
+      {% if n > 3 %}{% assign n = 3 %}{% endif %}
+      {% capture indent %}{% for i in (1..n) %}&ensp;{% endfor %}{% endcapture %}
+      {% capture link %}{{ indent }}{{ doc.title }}{% endcapture %}
+  {% endcase %}
+  <a class="very tight smaller text {{ item_class }}" href="{{ site.baseurl }}{{ url }}">{{ link }}</a>
+{% endfor %}
+
+</div>
+</div>
+{% endfor %}

data/_includes/elements/search.html

@@ -0,0 +1,7 @@
+<div id="site-search" class="ui fluid search">
+  <div class="ui inverted transparent left icon input">
+    {% include icon.liquid id='magnifier' %}
+    <input class="prompt" type="text" placeholder="search...">
+  </div>
+  <div class="results"></div>
+</div>