diff --git a/.buildinfo b/.buildinfo new file mode 100644 index 00000000..c4313f80 --- /dev/null +++ b/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: 2ea8f8c084aeebea80a4955dd7d6f9b7 +tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml deleted file mode 100644 index 9ef42dd5..00000000 --- a/.github/workflows/main.yml +++ /dev/null @@ -1,33 +0,0 @@ ---- -name: CI - -on: - push: - branches: [main] - tags-ignore: - - 'continuous' - pull_request: - branches: [main] - - # Allows you to run this workflow manually from the Actions tab - workflow_dispatch: - -jobs: - build: - if: "!contains(github.event.head_commit.message, 'ci skip')" - # The type of runner that the job will run on - runs-on: ubuntu-latest - env: - G_TOKEN: ${{secrets.GITHUB_TOKEN}} - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} - - steps: - - uses: actions/checkout@v2 - - - name: Build docs - run: sudo -E bash -ex buildDocs.sh - - name: Deploy EPUB (only when building from main branch) - if: ${{ github.ref == 'refs/heads/main' }} - run: | - wget -c https://github.com/probonopd/uploadtool/raw/master/upload.sh - bash ./upload.sh _build/epub/*.epub diff --git a/.gitignore b/.gitignore deleted file mode 100644 index 66c29f36..00000000 --- a/.gitignore +++ /dev/null @@ -1,6 +0,0 @@ -__pycache__ -*.py[c|o] -*.swp -/_build -/doctrees -.venv/ diff --git a/_static/.gitkeep b/.nojekyll similarity index 100% rename from _static/.gitkeep rename to .nojekyll diff --git a/LICENSE b/LICENSE deleted file mode 100644 index f55e5cb0..00000000 --- a/LICENSE +++ /dev/null @@ -1,25 +0,0 @@ -BSD 2-Clause License - -Copyright (c) 2020, hello -All rights reserved. - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are met: - -1. Redistributions of source code must retain the above copyright notice, this - list of conditions and the following disclaimer. - -2. Redistributions in binary form must reproduce the above copyright notice, - this list of conditions and the following disclaimer in the documentation - and/or other materials provided with the distribution. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE -FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER -CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/Makefile b/Makefile deleted file mode 100644 index ce46b206..00000000 --- a/Makefile +++ /dev/null @@ -1,23 +0,0 @@ -# Minimal makefile for Sphinx documentation -# - -# You can set these variables from the command line, and also -# from the environment for the first two. -SPHINXOPTS ?= -SPHINXBUILD ?= sphinx-build -SOURCEDIR = . -BUILDDIR = _build - -# Put it first so that "make" without argument is like "make help". -help: - @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) - -watch: - sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" --ignore "*__jb*__*" - -.PHONY: help Makefile watch - -# Catch-all target: route all unknown targets to Sphinx using the new -# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). -%: Makefile - @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/README.md b/README.md index c8e27bd3..f4537caf 100644 --- a/README.md +++ b/README.md @@ -1,38 +1,5 @@ -# hello Documentation - -This repository builds the [documentation](https://hellosystem.github.io/docs/) for hello. - -It uses Sphinx, recommonmark, and GitHub Actions to produce documentation from the Markdown source files in this repository. - -* https://stackoverflow.com/a/62967771 -* https://recommonmark.readthedocs.io/en/latest/ - -## Local development server - -Use a local development server that regenerates the output whenever the input changes: - -```sh -sudo pkg install -y py37-pip gmake # on FreeBSD, e.g., on helloSystem -pip-3.7 install -r requirements.txt -export GITHUB_REPOSITORY="helloSystem/docs" -export PATH=~/.local/bin/:$PATH -gmake watch -``` - -Now open http://127.0.0.1:8000 in a web browser. It will be regenerated and refreshed whenever one of the input files changes. - -## Local output generation - -One can also generate documentation in various output formats locally: - -```sh -sudo pkg install -y py37-pip gmake # on FreeBSD, e.g., on helloSystem -pip-3.7 install -r requirements.txt -export GITHUB_REPOSITORY="helloSystem/docs" -export PATH=~/.local/bin/:$PATH -gmake html -gmake epub -gmake html -gmake qthelp -qmake # list more output formats -``` +# GitHub Pages Cache + +Nothing to see here. The contents of this branch are essentially a cache that's not intended to be viewed on github.com. + +For more information on how this documentation is built using Sphinx, Read the Docs, and GitHub Actions/Pages, see another branch in this repository. diff --git a/developer/acknowledgements.md b/_sources/developer/acknowledgements.md.txt similarity index 100% rename from developer/acknowledgements.md rename to _sources/developer/acknowledgements.md.txt diff --git a/developer/application-bundles.md b/_sources/developer/application-bundles.md.txt similarity index 100% rename from developer/application-bundles.md rename to _sources/developer/application-bundles.md.txt diff --git a/developer/applications.md b/_sources/developer/applications.md.txt similarity index 100% rename from developer/applications.md rename to _sources/developer/applications.md.txt diff --git a/developer/architecture.md b/_sources/developer/architecture.md.txt similarity index 100% rename from developer/architecture.md rename to _sources/developer/architecture.md.txt diff --git a/developer/base.md b/_sources/developer/base.md.txt similarity index 100% rename from developer/base.md rename to _sources/developer/base.md.txt diff --git a/developer/binary-compatibility.md b/_sources/developer/binary-compatibility.md.txt similarity index 100% rename from developer/binary-compatibility.md rename to _sources/developer/binary-compatibility.md.txt diff --git a/developer/boot.md b/_sources/developer/boot.md.txt similarity index 100% rename from developer/boot.md rename to _sources/developer/boot.md.txt diff --git a/developer/building.md b/_sources/developer/building.md.txt similarity index 100% rename from developer/building.md rename to _sources/developer/building.md.txt diff --git a/developer/contact.md b/_sources/developer/contact.md.txt similarity index 100% rename from developer/contact.md rename to _sources/developer/contact.md.txt diff --git a/developer/contributing.md b/_sources/developer/contributing.md.txt similarity index 100% rename from developer/contributing.md rename to _sources/developer/contributing.md.txt diff --git a/developer/developer-tools.md b/_sources/developer/developer-tools.md.txt similarity index 100% rename from developer/developer-tools.md rename to _sources/developer/developer-tools.md.txt diff --git a/developer/distributions.md b/_sources/developer/distributions.md.txt similarity index 100% rename from developer/distributions.md rename to _sources/developer/distributions.md.txt diff --git a/developer/filer-context-menus.md b/_sources/developer/filer-context-menus.md.txt similarity index 100% rename from developer/filer-context-menus.md rename to _sources/developer/filer-context-menus.md.txt diff --git a/developer/geom_rowr.md b/_sources/developer/geom_rowr.md.txt similarity index 100% rename from developer/geom_rowr.md rename to _sources/developer/geom_rowr.md.txt diff --git a/developer/graphics.md b/_sources/developer/graphics.md.txt similarity index 100% rename from developer/graphics.md rename to _sources/developer/graphics.md.txt diff --git a/developer/linux.md b/_sources/developer/linux.md.txt similarity index 100% rename from developer/linux.md rename to _sources/developer/linux.md.txt diff --git a/developer/localization.md b/_sources/developer/localization.md.txt similarity index 100% rename from developer/localization.md rename to _sources/developer/localization.md.txt diff --git a/developer/man.md b/_sources/developer/man.md.txt similarity index 100% rename from developer/man.md rename to _sources/developer/man.md.txt diff --git a/developer/menu.md b/_sources/developer/menu.md.txt similarity index 99% rename from developer/menu.md rename to _sources/developer/menu.md.txt index 99c31f9a..7705d69c 100644 --- a/developer/menu.md +++ b/_sources/developer/menu.md.txt @@ -287,10 +287,6 @@ Changing this to `"1"` does not make any difference for Cura, though. _To be written._ -### Visual Studio Code, Code OSS (vscode, code-oss) - -Go to File -> Preferences -> Settings and set "Title Bar Style" to "Native" to get a working global menu. - ### Chromium, Chrome Starting with version 0.7.0 of helloSystem, Menu can handle Chrome and (patched) Firefox and Thunderbird, thanks Jesper Schmitz Mouridsen ([__jsm222__](https://github.com/jsm222/)). diff --git a/developer/midi.md b/_sources/developer/midi.md.txt similarity index 100% rename from developer/midi.md rename to _sources/developer/midi.md.txt diff --git a/developer/monkey-patch.md b/_sources/developer/monkey-patch.md.txt similarity index 100% rename from developer/monkey-patch.md rename to _sources/developer/monkey-patch.md.txt diff --git a/developer/ports.md b/_sources/developer/ports.md.txt similarity index 100% rename from developer/ports.md rename to _sources/developer/ports.md.txt diff --git a/developer/rpi.md b/_sources/developer/rpi.md.txt similarity index 100% rename from developer/rpi.md rename to _sources/developer/rpi.md.txt diff --git a/developer/specifications.md b/_sources/developer/specifications.md.txt similarity index 100% rename from developer/specifications.md rename to _sources/developer/specifications.md.txt diff --git a/developer/tracing.md b/_sources/developer/tracing.md.txt similarity index 100% rename from developer/tracing.md rename to _sources/developer/tracing.md.txt diff --git a/developer/ux-guidelines.md b/_sources/developer/ux-guidelines.md.txt similarity index 100% rename from developer/ux-guidelines.md rename to _sources/developer/ux-guidelines.md.txt diff --git a/index.md b/_sources/index.md.txt similarity index 100% rename from index.md rename to _sources/index.md.txt diff --git a/reviewer/guide.md b/_sources/reviewer/guide.md.txt similarity index 100% rename from reviewer/guide.md rename to _sources/reviewer/guide.md.txt diff --git a/user/components.md b/_sources/user/components.md.txt similarity index 100% rename from user/components.md rename to _sources/user/components.md.txt diff --git a/user/components/applications.md b/_sources/user/components/applications.md.txt similarity index 100% rename from user/components/applications.md rename to _sources/user/components/applications.md.txt diff --git a/user/components/applications/falkon.md b/_sources/user/components/applications/falkon.md.txt similarity index 100% rename from user/components/applications/falkon.md rename to _sources/user/components/applications/falkon.md.txt diff --git a/user/components/applications/iridium.md b/_sources/user/components/applications/iridium.md.txt similarity index 100% rename from user/components/applications/iridium.md rename to _sources/user/components/applications/iridium.md.txt diff --git a/user/components/autostart.md b/_sources/user/components/autostart.md.txt similarity index 100% rename from user/components/autostart.md rename to _sources/user/components/autostart.md.txt diff --git a/user/components/filesystems.md b/_sources/user/components/filesystems.md.txt similarity index 100% rename from user/components/filesystems.md rename to _sources/user/components/filesystems.md.txt diff --git a/user/components/preferences.md b/_sources/user/components/preferences.md.txt similarity index 100% rename from user/components/preferences.md rename to _sources/user/components/preferences.md.txt diff --git a/user/components/preferences/boot-environments.md b/_sources/user/components/preferences/boot-environments.md.txt similarity index 100% rename from user/components/preferences/boot-environments.md rename to _sources/user/components/preferences/boot-environments.md.txt diff --git a/user/components/preferences/desktop.md b/_sources/user/components/preferences/desktop.md.txt similarity index 100% rename from user/components/preferences/desktop.md rename to _sources/user/components/preferences/desktop.md.txt diff --git a/user/components/preferences/keyboard.md b/_sources/user/components/preferences/keyboard.md.txt similarity index 100% rename from user/components/preferences/keyboard.md rename to _sources/user/components/preferences/keyboard.md.txt diff --git a/user/components/preferences/sharing.md b/_sources/user/components/preferences/sharing.md.txt similarity index 100% rename from user/components/preferences/sharing.md rename to _sources/user/components/preferences/sharing.md.txt diff --git a/user/components/preferences/shortcuts.md b/_sources/user/components/preferences/shortcuts.md.txt similarity index 100% rename from user/components/preferences/shortcuts.md rename to _sources/user/components/preferences/shortcuts.md.txt diff --git a/user/components/preferences/wireless-networks.md b/_sources/user/components/preferences/wireless-networks.md.txt similarity index 100% rename from user/components/preferences/wireless-networks.md rename to _sources/user/components/preferences/wireless-networks.md.txt diff --git a/user/components/system.md b/_sources/user/components/system.md.txt similarity index 100% rename from user/components/system.md rename to _sources/user/components/system.md.txt diff --git a/user/components/system/dock.md b/_sources/user/components/system/dock.md.txt similarity index 100% rename from user/components/system/dock.md rename to _sources/user/components/system/dock.md.txt diff --git a/user/components/system/filer.md b/_sources/user/components/system/filer.md.txt similarity index 100% rename from user/components/system/filer.md rename to _sources/user/components/system/filer.md.txt diff --git a/user/components/system/launch.md b/_sources/user/components/system/launch.md.txt similarity index 100% rename from user/components/system/launch.md rename to _sources/user/components/system/launch.md.txt diff --git a/user/components/system/menu.md b/_sources/user/components/system/menu.md.txt similarity index 100% rename from user/components/system/menu.md rename to _sources/user/components/system/menu.md.txt diff --git a/user/components/utilities.md b/_sources/user/components/utilities.md.txt similarity index 100% rename from user/components/utilities.md rename to _sources/user/components/utilities.md.txt diff --git a/user/components/utilities/calculator.md b/_sources/user/components/utilities/calculator.md.txt similarity index 100% rename from user/components/utilities/calculator.md rename to _sources/user/components/utilities/calculator.md.txt diff --git a/user/components/utilities/calendar.md b/_sources/user/components/utilities/calendar.md.txt similarity index 100% rename from user/components/utilities/calendar.md rename to _sources/user/components/utilities/calendar.md.txt diff --git a/user/components/utilities/create-live-media.md b/_sources/user/components/utilities/create-live-media.md.txt similarity index 100% rename from user/components/utilities/create-live-media.md rename to _sources/user/components/utilities/create-live-media.md.txt diff --git a/user/components/utilities/hardware-probe.md b/_sources/user/components/utilities/hardware-probe.md.txt similarity index 100% rename from user/components/utilities/hardware-probe.md rename to _sources/user/components/utilities/hardware-probe.md.txt diff --git a/user/components/utilities/install.md b/_sources/user/components/utilities/install.md.txt similarity index 100% rename from user/components/utilities/install.md rename to _sources/user/components/utilities/install.md.txt diff --git a/user/components/utilities/mountarchive.md b/_sources/user/components/utilities/mountarchive.md.txt similarity index 100% rename from user/components/utilities/mountarchive.md rename to _sources/user/components/utilities/mountarchive.md.txt diff --git a/user/components/utilities/remote-assistance.md b/_sources/user/components/utilities/remote-assistance.md.txt similarity index 100% rename from user/components/utilities/remote-assistance.md rename to _sources/user/components/utilities/remote-assistance.md.txt diff --git a/user/components/utilities/sticky-notes.md b/_sources/user/components/utilities/sticky-notes.md.txt similarity index 100% rename from user/components/utilities/sticky-notes.md rename to _sources/user/components/utilities/sticky-notes.md.txt diff --git a/user/components/utilities/update.md b/_sources/user/components/utilities/update.md.txt similarity index 100% rename from user/components/utilities/update.md rename to _sources/user/components/utilities/update.md.txt diff --git a/user/components/windows.md b/_sources/user/components/windows.md.txt similarity index 100% rename from user/components/windows.md rename to _sources/user/components/windows.md.txt diff --git a/user/feedback.md b/_sources/user/feedback.md.txt similarity index 100% rename from user/feedback.md rename to _sources/user/feedback.md.txt diff --git a/user/getting-started.md b/_sources/user/getting-started.md.txt similarity index 100% rename from user/getting-started.md rename to _sources/user/getting-started.md.txt diff --git a/user/troubleshooting.md b/_sources/user/troubleshooting.md.txt similarity index 100% rename from user/troubleshooting.md rename to _sources/user/troubleshooting.md.txt diff --git a/_static/_sphinx_javascript_frameworks_compat.js b/_static/_sphinx_javascript_frameworks_compat.js new file mode 100644 index 00000000..8549469d --- /dev/null +++ b/_static/_sphinx_javascript_frameworks_compat.js @@ -0,0 +1,134 @@ +/* + * _sphinx_javascript_frameworks_compat.js + * ~~~~~~~~~~ + * + * Compatability shim for jQuery and underscores.js. + * + * WILL BE REMOVED IN Sphinx 6.0 + * xref RemovedInSphinx60Warning + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + + +/** + * small helper function to urldecode strings + * + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL + */ +jQuery.urldecode = function(x) { + if (!x) { + return x + } + return decodeURIComponent(x.replace(/\+/g, ' ')); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s === 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node, addItems) { + if (node.nodeType === 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && + !jQuery(node.parentNode).hasClass(className) && + !jQuery(node.parentNode).hasClass("nohighlight")) { + var span; + var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.className = className; + } + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + if (isInSVG) { + var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); + var bbox = node.parentElement.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute('class', className); + addItems.push({ + "parent": node.parentNode, + "target": rect}); + } + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this, addItems); + }); + } + } + var addItems = []; + var result = this.each(function() { + highlight(this, addItems); + }); + for (var i = 0; i < addItems.length; ++i) { + jQuery(addItems[i].parent).before(addItems[i].target); + } + return result; +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} diff --git a/_static/basic.css b/_static/basic.css new file mode 100644 index 00000000..eeb0519a --- /dev/null +++ b/_static/basic.css @@ -0,0 +1,899 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +div.section::after { + display: block; + content: ''; + clear: left; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox form.search { + overflow: hidden; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li p.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 360px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} +a.brackets:before, +span.brackets > a:before{ + content: "["; +} + +a.brackets:after, +span.brackets > a:after { + content: "]"; +} + + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, figure.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, figure.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, figure.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +img.align-default, figure.align-default, .figure.align-default { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-default { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar, +aside.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px; + background-color: #ffe; + width: 40%; + float: right; + clear: right; + overflow-x: auto; +} + +p.sidebar-title { + font-weight: bold; +} +div.admonition, div.topic, blockquote { + clear: left; +} + +/* -- topics ---------------------------------------------------------------- */ +div.topic { + border: 1px solid #ccc; + padding: 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- content of sidebars/topics/admonitions -------------------------------- */ + +div.sidebar > :last-child, +aside.sidebar > :last-child, +div.topic > :last-child, +div.admonition > :last-child { + margin-bottom: 0; +} + +div.sidebar::after, +aside.sidebar::after, +div.topic::after, +div.admonition::after, +blockquote::after { + display: block; + content: ''; + clear: both; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + margin-top: 10px; + margin-bottom: 10px; + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table.align-default { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +th > :first-child, +td > :first-child { + margin-top: 0px; +} + +th > :last-child, +td > :last-child { + margin-bottom: 0px; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure, figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption, figcaption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number, +figcaption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text, +figcaption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- hlist styles ---------------------------------------------------------- */ + +table.hlist { + margin: 1em 0; +} + +table.hlist td { + vertical-align: top; +} + +/* -- object description styles --------------------------------------------- */ + +.sig { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; +} + +.sig-name, code.descname { + background-color: transparent; + font-weight: bold; +} + +.sig-name { + font-size: 1.1em; +} + +code.descname { + font-size: 1.2em; +} + +.sig-prename, code.descclassname { + background-color: transparent; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.sig-param.n { + font-style: italic; +} + +/* C++ specific styling */ + +.sig-inline.c-texpr, +.sig-inline.cpp-texpr { + font-family: unset; +} + +.sig.c .k, .sig.c .kt, +.sig.cpp .k, .sig.cpp .kt { + color: #0033B3; +} + +.sig.c .m, +.sig.cpp .m { + color: #1750EB; +} + +.sig.c .s, .sig.c .sc, +.sig.cpp .s, .sig.cpp .sc { + color: #067D17; +} + + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +:not(li) > ol > li:first-child > :first-child, +:not(li) > ul > li:first-child > :first-child { + margin-top: 0px; +} + +:not(li) > ol > li:last-child > :last-child, +:not(li) > ul > li:last-child > :last-child { + margin-bottom: 0px; +} + +ol.simple ol p, +ol.simple ul p, +ul.simple ol p, +ul.simple ul p { + margin-top: 0; +} + +ol.simple > li:not(:first-child) > p, +ul.simple > li:not(:first-child) > p { + margin-top: 0; +} + +ol.simple p, +ul.simple p { + margin-bottom: 0; +} +dl.footnote > dt, +dl.citation > dt { + float: left; + margin-right: 0.5em; +} + +dl.footnote > dd, +dl.citation > dd { + margin-bottom: 0em; +} + +dl.footnote > dd:after, +dl.citation > dd:after { + content: ""; + clear: both; +} + +dl.field-list { + display: grid; + grid-template-columns: fit-content(30%) auto; +} + +dl.field-list > dt { + font-weight: bold; + word-break: break-word; + padding-left: 0.5em; + padding-right: 5px; +} +dl.field-list > dt:after { + content: ":"; +} + + +dl.field-list > dd { + padding-left: 0.5em; + margin-top: 0em; + margin-left: 0em; + margin-bottom: 0em; +} + +dl { + margin-bottom: 15px; +} + +dd > :first-child { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dl > dd:last-child, +dl > dd:last-child > :last-child { + margin-bottom: 0; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +.classifier:before { + font-style: normal; + margin: 0 0.5em; + content: ":"; + display: inline-block; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +pre, div[class*="highlight-"] { + clear: both; +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; + white-space: nowrap; +} + +div[class*="highlight-"] { + margin: 1em 0; +} + +td.linenos pre { + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + display: block; +} + +table.highlighttable tbody { + display: block; +} + +table.highlighttable tr { + display: flex; +} + +table.highlighttable td { + margin: 0; + padding: 0; +} + +table.highlighttable td.linenos { + padding-right: 0.5em; +} + +table.highlighttable td.code { + flex: 1; + overflow: hidden; +} + +.highlight .hll { + display: block; +} + +div.highlight pre, +table.highlighttable pre { + margin: 0; +} + +div.code-block-caption + div { + margin-top: 0; +} + +div.code-block-caption { + margin-top: 1em; + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +table.highlighttable td.linenos, +span.linenos, +div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + margin: 1em 0; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: absolute; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/_static/css/badge_only.css b/_static/css/badge_only.css new file mode 100644 index 00000000..c718cee4 --- /dev/null +++ b/_static/css/badge_only.css @@ -0,0 +1 @@ +.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-style:normal;font-weight:400;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#FontAwesome) format("svg")}.fa:before{font-family:FontAwesome;font-style:normal;font-weight:400;line-height:1}.fa:before,a .fa{text-decoration:inherit}.fa:before,a .fa,li .fa{display:inline-block}li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before,.icon-book:before{content:"\f02d"}.fa-caret-down:before,.icon-caret-down:before{content:"\f0d7"}.fa-caret-up:before,.icon-caret-up:before{content:"\f0d8"}.fa-caret-left:before,.icon-caret-left:before{content:"\f0d9"}.fa-caret-right:before,.icon-caret-right:before{content:"\f0da"}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60}.rst-versions .rst-current-version:after{clear:both;content:"";display:block}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}} \ No newline at end of file diff --git a/_static/css/fonts/Roboto-Slab-Bold.woff b/_static/css/fonts/Roboto-Slab-Bold.woff new file mode 100644 index 00000000..6cb60000 Binary files /dev/null and b/_static/css/fonts/Roboto-Slab-Bold.woff differ diff --git a/_static/css/fonts/Roboto-Slab-Bold.woff2 b/_static/css/fonts/Roboto-Slab-Bold.woff2 new file mode 100644 index 00000000..7059e231 Binary files /dev/null and b/_static/css/fonts/Roboto-Slab-Bold.woff2 differ diff --git a/_static/css/fonts/Roboto-Slab-Regular.woff b/_static/css/fonts/Roboto-Slab-Regular.woff new file mode 100644 index 00000000..f815f63f Binary files /dev/null and b/_static/css/fonts/Roboto-Slab-Regular.woff differ diff --git a/_static/css/fonts/Roboto-Slab-Regular.woff2 b/_static/css/fonts/Roboto-Slab-Regular.woff2 new file mode 100644 index 00000000..f2c76e5b Binary files /dev/null and b/_static/css/fonts/Roboto-Slab-Regular.woff2 differ diff --git a/_static/css/fonts/fontawesome-webfont.eot b/_static/css/fonts/fontawesome-webfont.eot new file mode 100644 index 00000000..e9f60ca9 Binary files /dev/null and b/_static/css/fonts/fontawesome-webfont.eot differ diff --git a/_static/css/fonts/fontawesome-webfont.svg b/_static/css/fonts/fontawesome-webfont.svg new file mode 100644 index 00000000..855c845e --- /dev/null +++ b/_static/css/fonts/fontawesome-webfont.svg @@ -0,0 +1,2671 @@ + + + + +Created by FontForge 20120731 at Mon Oct 24 17:37:40 2016 + By ,,, +Copyright Dave Gandy 2016. All rights reserved. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/_static/css/fonts/fontawesome-webfont.ttf b/_static/css/fonts/fontawesome-webfont.ttf new file mode 100644 index 00000000..35acda2f Binary files /dev/null and b/_static/css/fonts/fontawesome-webfont.ttf differ diff --git a/_static/css/fonts/fontawesome-webfont.woff b/_static/css/fonts/fontawesome-webfont.woff new file mode 100644 index 00000000..400014a4 Binary files /dev/null and b/_static/css/fonts/fontawesome-webfont.woff differ diff --git a/_static/css/fonts/fontawesome-webfont.woff2 b/_static/css/fonts/fontawesome-webfont.woff2 new file mode 100644 index 00000000..4d13fc60 Binary files /dev/null and b/_static/css/fonts/fontawesome-webfont.woff2 differ diff --git a/_static/css/fonts/lato-bold-italic.woff b/_static/css/fonts/lato-bold-italic.woff new file mode 100644 index 00000000..88ad05b9 Binary files /dev/null and b/_static/css/fonts/lato-bold-italic.woff differ diff --git a/_static/css/fonts/lato-bold-italic.woff2 b/_static/css/fonts/lato-bold-italic.woff2 new file mode 100644 index 00000000..c4e3d804 Binary files /dev/null and b/_static/css/fonts/lato-bold-italic.woff2 differ diff --git a/_static/css/fonts/lato-bold.woff b/_static/css/fonts/lato-bold.woff new file mode 100644 index 00000000..c6dff51f Binary files /dev/null and b/_static/css/fonts/lato-bold.woff differ diff --git a/_static/css/fonts/lato-bold.woff2 b/_static/css/fonts/lato-bold.woff2 new file mode 100644 index 00000000..bb195043 Binary files /dev/null and b/_static/css/fonts/lato-bold.woff2 differ diff --git a/_static/css/fonts/lato-normal-italic.woff b/_static/css/fonts/lato-normal-italic.woff new file mode 100644 index 00000000..76114bc0 Binary files /dev/null and b/_static/css/fonts/lato-normal-italic.woff differ diff --git a/_static/css/fonts/lato-normal-italic.woff2 b/_static/css/fonts/lato-normal-italic.woff2 new file mode 100644 index 00000000..3404f37e Binary files /dev/null and b/_static/css/fonts/lato-normal-italic.woff2 differ diff --git a/_static/css/fonts/lato-normal.woff b/_static/css/fonts/lato-normal.woff new file mode 100644 index 00000000..ae1307ff Binary files /dev/null and b/_static/css/fonts/lato-normal.woff differ diff --git a/_static/css/fonts/lato-normal.woff2 b/_static/css/fonts/lato-normal.woff2 new file mode 100644 index 00000000..3bf98433 Binary files /dev/null and b/_static/css/fonts/lato-normal.woff2 differ diff --git a/_static/css/theme.css b/_static/css/theme.css new file mode 100644 index 00000000..19a446a0 --- /dev/null +++ b/_static/css/theme.css @@ -0,0 +1,4 @@ +html{box-sizing:border-box}*,:after,:before{box-sizing:inherit}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}[hidden],audio:not([controls]){display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;text-decoration:none}ins,mark{color:#000}mark{background:#ff0;font-style:italic;font-weight:700}.rst-content code,.rst-content tt,code,kbd,pre,samp{font-family:monospace,serif;_font-family:courier new,monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:after,q:before{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}dl,ol,ul{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure,form{margin:0}label{cursor:pointer}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type=button],input[type=reset],input[type=submit]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}textarea{resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none!important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{body,html,section{background:none!important}*{box-shadow:none!important;text-shadow:none!important;filter:none!important;-ms-filter:none!important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="#"]:after,a[href^="javascript:"]:after{content:""}blockquote,pre{page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}img{max-width:100%!important}@page{margin:.5cm}.rst-content .toctree-wrapper>p.caption,h2,h3,p{orphans:3;widows:3}.rst-content .toctree-wrapper>p.caption,h2,h3{page-break-after:avoid}}.btn,.fa:before,.icon:before,.rst-content .admonition,.rst-content .admonition-title:before,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .code-block-caption .headerlink:before,.rst-content .danger,.rst-content .eqno .headerlink:before,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-alert,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before,input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week],select,textarea{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}/*! + * Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome + * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License) + */@font-face{font-family:FontAwesome;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713);src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix&v=4.7.0) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#fontawesomeregular) format("svg");font-weight:400;font-style:normal}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14286em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14286em;width:2.14286em;top:.14286em;text-align:center}.fa-li.fa-lg{left:-1.85714em}.fa-border{padding:.2em .25em .15em;border:.08em solid #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa-pull-left.icon,.fa.fa-pull-left,.rst-content .code-block-caption .fa-pull-left.headerlink,.rst-content .eqno .fa-pull-left.headerlink,.rst-content .fa-pull-left.admonition-title,.rst-content code.download span.fa-pull-left:first-child,.rst-content dl dt .fa-pull-left.headerlink,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content p .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.wy-menu-vertical li.current>a button.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-left.toctree-expand,.wy-menu-vertical li button.fa-pull-left.toctree-expand{margin-right:.3em}.fa-pull-right.icon,.fa.fa-pull-right,.rst-content .code-block-caption .fa-pull-right.headerlink,.rst-content .eqno .fa-pull-right.headerlink,.rst-content .fa-pull-right.admonition-title,.rst-content code.download span.fa-pull-right:first-child,.rst-content dl dt .fa-pull-right.headerlink,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content p .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.wy-menu-vertical li.current>a button.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-right.toctree-expand,.wy-menu-vertical li button.fa-pull-right.toctree-expand{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.pull-left.icon,.rst-content .code-block-caption .pull-left.headerlink,.rst-content .eqno .pull-left.headerlink,.rst-content .pull-left.admonition-title,.rst-content code.download span.pull-left:first-child,.rst-content dl dt .pull-left.headerlink,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content p .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.wy-menu-vertical li.current>a button.pull-left.toctree-expand,.wy-menu-vertical li.on a button.pull-left.toctree-expand,.wy-menu-vertical li button.pull-left.toctree-expand{margin-right:.3em}.fa.pull-right,.pull-right.icon,.rst-content .code-block-caption .pull-right.headerlink,.rst-content .eqno .pull-right.headerlink,.rst-content .pull-right.admonition-title,.rst-content code.download span.pull-right:first-child,.rst-content dl dt .pull-right.headerlink,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content p .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.wy-menu-vertical li.current>a button.pull-right.toctree-expand,.wy-menu-vertical li.on a button.pull-right.toctree-expand,.wy-menu-vertical li button.pull-right.toctree-expand{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s linear infinite;animation:fa-spin 2s linear infinite}.fa-pulse{-webkit-animation:fa-spin 1s steps(8) infinite;animation:fa-spin 1s steps(8) infinite}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scaleX(-1);-ms-transform:scaleX(-1);transform:scaleX(-1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scaleY(-1);-ms-transform:scaleY(-1);transform:scaleY(-1)}:root .fa-flip-horizontal,:root .fa-flip-vertical,:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-close:before,.fa-remove:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-cog:before,.fa-gear:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-repeat:before,.fa-rotate-right:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-image:before,.fa-photo:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.rst-content .admonition-title:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-exclamation-triangle:before,.fa-warning:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-cogs:before,.fa-gears:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-floppy-o:before,.fa-save:before{content:""}.fa-square:before{content:""}.fa-bars:before,.fa-navicon:before,.fa-reorder:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.icon-caret-down:before,.wy-dropdown .caret:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-sort:before,.fa-unsorted:before{content:""}.fa-sort-desc:before,.fa-sort-down:before{content:""}.fa-sort-asc:before,.fa-sort-up:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-gavel:before,.fa-legal:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-bolt:before,.fa-flash:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-clipboard:before,.fa-paste:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-chain-broken:before,.fa-unlink:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-caret-square-o-down:before,.fa-toggle-down:before{content:""}.fa-caret-square-o-up:before,.fa-toggle-up:before{content:""}.fa-caret-square-o-right:before,.fa-toggle-right:before{content:""}.fa-eur:before,.fa-euro:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-inr:before,.fa-rupee:before{content:""}.fa-cny:before,.fa-jpy:before,.fa-rmb:before,.fa-yen:before{content:""}.fa-rouble:before,.fa-rub:before,.fa-ruble:before{content:""}.fa-krw:before,.fa-won:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-caret-square-o-left:before,.fa-toggle-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-try:before,.fa-turkish-lira:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li button.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-bank:before,.fa-institution:before,.fa-university:before{content:""}.fa-graduation-cap:before,.fa-mortar-board:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-image-o:before,.fa-file-photo-o:before,.fa-file-picture-o:before{content:""}.fa-file-archive-o:before,.fa-file-zip-o:before{content:""}.fa-file-audio-o:before,.fa-file-sound-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-ring:before,.fa-life-saver:before,.fa-support:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-rebel:before,.fa-resistance:before{content:""}.fa-empire:before,.fa-ge:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-hacker-news:before,.fa-y-combinator-square:before,.fa-yc-square:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-paper-plane:before,.fa-send:before{content:""}.fa-paper-plane-o:before,.fa-send-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-futbol-o:before,.fa-soccer-ball-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-ils:before,.fa-shekel:before,.fa-sheqel:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-bed:before,.fa-hotel:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-y-combinator:before,.fa-yc:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery-full:before,.fa-battery:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-paper-o:before,.fa-hand-stop-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-television:before,.fa-tv:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-american-sign-language-interpreting:before,.fa-asl-interpreting:before{content:""}.fa-deaf:before,.fa-deafness:before,.fa-hard-of-hearing:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-sign-language:before,.fa-signing:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-address-card:before,.fa-vcard:before{content:""}.fa-address-card-o:before,.fa-vcard-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer-full:before,.fa-thermometer:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bath:before,.fa-bathtub:before,.fa-s15:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{font-family:inherit}.fa:before,.icon:before,.rst-content .admonition-title:before,.rst-content .code-block-caption .headerlink:before,.rst-content .eqno .headerlink:before,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before{font-family:FontAwesome;display:inline-block;font-style:normal;font-weight:400;line-height:1;text-decoration:inherit}.rst-content .code-block-caption a .headerlink,.rst-content .eqno a .headerlink,.rst-content a .admonition-title,.rst-content code.download a span:first-child,.rst-content dl dt a .headerlink,.rst-content h1 a .headerlink,.rst-content h2 a .headerlink,.rst-content h3 a .headerlink,.rst-content h4 a .headerlink,.rst-content h5 a .headerlink,.rst-content h6 a .headerlink,.rst-content p.caption a .headerlink,.rst-content p a .headerlink,.rst-content table>caption a .headerlink,.rst-content tt.download a span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li a button.toctree-expand,a .fa,a .icon,a .rst-content .admonition-title,a .rst-content .code-block-caption .headerlink,a .rst-content .eqno .headerlink,a .rst-content code.download span:first-child,a .rst-content dl dt .headerlink,a .rst-content h1 .headerlink,a .rst-content h2 .headerlink,a .rst-content h3 .headerlink,a .rst-content h4 .headerlink,a .rst-content h5 .headerlink,a .rst-content h6 .headerlink,a .rst-content p.caption .headerlink,a .rst-content p .headerlink,a .rst-content table>caption .headerlink,a .rst-content tt.download span:first-child,a .wy-menu-vertical li button.toctree-expand{display:inline-block;text-decoration:inherit}.btn .fa,.btn .icon,.btn .rst-content .admonition-title,.btn .rst-content .code-block-caption .headerlink,.btn .rst-content .eqno .headerlink,.btn .rst-content code.download span:first-child,.btn .rst-content dl dt .headerlink,.btn .rst-content h1 .headerlink,.btn .rst-content h2 .headerlink,.btn .rst-content h3 .headerlink,.btn .rst-content h4 .headerlink,.btn .rst-content h5 .headerlink,.btn .rst-content h6 .headerlink,.btn .rst-content p .headerlink,.btn .rst-content table>caption .headerlink,.btn .rst-content tt.download span:first-child,.btn .wy-menu-vertical li.current>a button.toctree-expand,.btn .wy-menu-vertical li.on a button.toctree-expand,.btn .wy-menu-vertical li button.toctree-expand,.nav .fa,.nav .icon,.nav .rst-content .admonition-title,.nav .rst-content .code-block-caption .headerlink,.nav .rst-content .eqno .headerlink,.nav .rst-content code.download span:first-child,.nav .rst-content dl dt .headerlink,.nav .rst-content h1 .headerlink,.nav .rst-content h2 .headerlink,.nav .rst-content h3 .headerlink,.nav .rst-content h4 .headerlink,.nav .rst-content h5 .headerlink,.nav .rst-content h6 .headerlink,.nav .rst-content p .headerlink,.nav .rst-content table>caption .headerlink,.nav .rst-content tt.download span:first-child,.nav .wy-menu-vertical li.current>a button.toctree-expand,.nav .wy-menu-vertical li.on a button.toctree-expand,.nav .wy-menu-vertical li button.toctree-expand,.rst-content .btn .admonition-title,.rst-content .code-block-caption .btn .headerlink,.rst-content .code-block-caption .nav .headerlink,.rst-content .eqno .btn .headerlink,.rst-content .eqno .nav .headerlink,.rst-content .nav .admonition-title,.rst-content code.download .btn span:first-child,.rst-content code.download .nav span:first-child,.rst-content dl dt .btn .headerlink,.rst-content dl dt .nav .headerlink,.rst-content h1 .btn .headerlink,.rst-content h1 .nav .headerlink,.rst-content h2 .btn .headerlink,.rst-content h2 .nav .headerlink,.rst-content h3 .btn .headerlink,.rst-content h3 .nav .headerlink,.rst-content h4 .btn .headerlink,.rst-content h4 .nav .headerlink,.rst-content h5 .btn .headerlink,.rst-content h5 .nav .headerlink,.rst-content h6 .btn .headerlink,.rst-content h6 .nav .headerlink,.rst-content p .btn .headerlink,.rst-content p .nav .headerlink,.rst-content table>caption .btn .headerlink,.rst-content table>caption .nav .headerlink,.rst-content tt.download .btn span:first-child,.rst-content tt.download .nav span:first-child,.wy-menu-vertical li .btn button.toctree-expand,.wy-menu-vertical li.current>a .btn button.toctree-expand,.wy-menu-vertical li.current>a .nav button.toctree-expand,.wy-menu-vertical li .nav button.toctree-expand,.wy-menu-vertical li.on a .btn button.toctree-expand,.wy-menu-vertical li.on a .nav button.toctree-expand{display:inline}.btn .fa-large.icon,.btn .fa.fa-large,.btn .rst-content .code-block-caption .fa-large.headerlink,.btn .rst-content .eqno .fa-large.headerlink,.btn .rst-content .fa-large.admonition-title,.btn .rst-content code.download span.fa-large:first-child,.btn .rst-content dl dt .fa-large.headerlink,.btn .rst-content h1 .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.btn .rst-content p .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.btn .wy-menu-vertical li button.fa-large.toctree-expand,.nav .fa-large.icon,.nav .fa.fa-large,.nav .rst-content .code-block-caption .fa-large.headerlink,.nav .rst-content .eqno .fa-large.headerlink,.nav .rst-content .fa-large.admonition-title,.nav .rst-content code.download span.fa-large:first-child,.nav .rst-content dl dt .fa-large.headerlink,.nav .rst-content h1 .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.nav .rst-content p .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.nav .wy-menu-vertical li button.fa-large.toctree-expand,.rst-content .btn .fa-large.admonition-title,.rst-content .code-block-caption .btn .fa-large.headerlink,.rst-content .code-block-caption .nav .fa-large.headerlink,.rst-content .eqno .btn .fa-large.headerlink,.rst-content .eqno .nav .fa-large.headerlink,.rst-content .nav .fa-large.admonition-title,.rst-content code.download .btn span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.rst-content dl dt .btn .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.rst-content p .btn .fa-large.headerlink,.rst-content p .nav .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.rst-content tt.download .btn span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.wy-menu-vertical li .btn button.fa-large.toctree-expand,.wy-menu-vertical li .nav button.fa-large.toctree-expand{line-height:.9em}.btn .fa-spin.icon,.btn .fa.fa-spin,.btn .rst-content .code-block-caption .fa-spin.headerlink,.btn .rst-content .eqno .fa-spin.headerlink,.btn .rst-content .fa-spin.admonition-title,.btn .rst-content code.download span.fa-spin:first-child,.btn .rst-content dl dt .fa-spin.headerlink,.btn .rst-content h1 .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.btn .rst-content p .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.btn .wy-menu-vertical li button.fa-spin.toctree-expand,.nav .fa-spin.icon,.nav .fa.fa-spin,.nav .rst-content .code-block-caption .fa-spin.headerlink,.nav .rst-content .eqno .fa-spin.headerlink,.nav .rst-content .fa-spin.admonition-title,.nav .rst-content code.download span.fa-spin:first-child,.nav .rst-content dl dt .fa-spin.headerlink,.nav .rst-content h1 .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.nav .rst-content p .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.nav .wy-menu-vertical li button.fa-spin.toctree-expand,.rst-content .btn .fa-spin.admonition-title,.rst-content .code-block-caption .btn .fa-spin.headerlink,.rst-content .code-block-caption .nav .fa-spin.headerlink,.rst-content .eqno .btn .fa-spin.headerlink,.rst-content .eqno .nav .fa-spin.headerlink,.rst-content .nav .fa-spin.admonition-title,.rst-content code.download .btn span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.rst-content dl dt .btn .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.rst-content p .btn .fa-spin.headerlink,.rst-content p .nav .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.rst-content tt.download .btn span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.wy-menu-vertical li .btn button.fa-spin.toctree-expand,.wy-menu-vertical li .nav button.fa-spin.toctree-expand{display:inline-block}.btn.fa:before,.btn.icon:before,.rst-content .btn.admonition-title:before,.rst-content .code-block-caption .btn.headerlink:before,.rst-content .eqno .btn.headerlink:before,.rst-content code.download span.btn:first-child:before,.rst-content dl dt .btn.headerlink:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content p .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.wy-menu-vertical li button.btn.toctree-expand:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.btn.icon:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content .code-block-caption .btn.headerlink:hover:before,.rst-content .eqno .btn.headerlink:hover:before,.rst-content code.download span.btn:first-child:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content p .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.wy-menu-vertical li button.btn.toctree-expand:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .icon:before,.btn-mini .rst-content .admonition-title:before,.btn-mini .rst-content .code-block-caption .headerlink:before,.btn-mini .rst-content .eqno .headerlink:before,.btn-mini .rst-content code.download span:first-child:before,.btn-mini .rst-content dl dt .headerlink:before,.btn-mini .rst-content h1 .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.btn-mini .rst-content p .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.btn-mini .wy-menu-vertical li button.toctree-expand:before,.rst-content .btn-mini .admonition-title:before,.rst-content .code-block-caption .btn-mini .headerlink:before,.rst-content .eqno .btn-mini .headerlink:before,.rst-content code.download .btn-mini span:first-child:before,.rst-content dl dt .btn-mini .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.rst-content p .btn-mini .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.rst-content tt.download .btn-mini span:first-child:before,.wy-menu-vertical li .btn-mini button.toctree-expand:before{font-size:14px;vertical-align:-15%}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.wy-alert{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.rst-content .admonition-title,.wy-alert-title{font-weight:700;display:block;color:#fff;background:#6ab0de;padding:6px 12px;margin:-12px -12px 12px}.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.admonition,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.wy-alert.wy-alert-danger{background:#fdf3f2}.rst-content .danger .admonition-title,.rst-content .danger .wy-alert-title,.rst-content .error .admonition-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .admonition-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.wy-alert.wy-alert-danger .wy-alert-title{background:#f29f97}.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .warning,.rst-content .wy-alert-warning.admonition,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.note,.rst-content .wy-alert-warning.seealso,.rst-content .wy-alert-warning.tip,.wy-alert.wy-alert-warning{background:#ffedcc}.rst-content .admonition-todo .admonition-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .attention .admonition-title,.rst-content .attention .wy-alert-title,.rst-content .caution .admonition-title,.rst-content .caution .wy-alert-title,.rst-content .warning .admonition-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.admonition .admonition-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.wy-alert.wy-alert-warning .wy-alert-title{background:#f0b37e}.rst-content .note,.rst-content .seealso,.rst-content .wy-alert-info.admonition,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.wy-alert.wy-alert-info{background:#e7f2fa}.rst-content .note .admonition-title,.rst-content .note .wy-alert-title,.rst-content .seealso .admonition-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .admonition-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.wy-alert.wy-alert-info .wy-alert-title{background:#6ab0de}.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.admonition,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.warning,.wy-alert.wy-alert-success{background:#dbfaf4}.rst-content .hint .admonition-title,.rst-content .hint .wy-alert-title,.rst-content .important .admonition-title,.rst-content .important .wy-alert-title,.rst-content .tip .admonition-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .admonition-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.wy-alert.wy-alert-success .wy-alert-title{background:#1abc9c}.rst-content .wy-alert-neutral.admonition,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.wy-alert.wy-alert-neutral{background:#f3f6f6}.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .admonition-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.wy-alert.wy-alert-neutral .wy-alert-title{color:#404040;background:#e1e4e5}.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.wy-alert.wy-alert-neutral a{color:#2980b9}.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .note p:last-child,.rst-content .seealso p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.wy-alert p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27ae60}.wy-tray-container li.wy-tray-item-info{background:#2980b9}.wy-tray-container li.wy-tray-item-warning{background:#e67e22}.wy-tray-container li.wy-tray-item-danger{background:#e74c3c}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width:768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px;color:#fff;border:1px solid rgba(0,0,0,.1);background-color:#27ae60;text-decoration:none;font-weight:400;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 2px -1px hsla(0,0%,100%,.5),inset 0 -2px 0 0 rgba(0,0,0,.1);outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:inset 0 -1px 0 0 rgba(0,0,0,.05),inset 0 2px 0 0 rgba(0,0,0,.1);padding:8px 12px 6px}.btn:visited{color:#fff}.btn-disabled,.btn-disabled:active,.btn-disabled:focus,.btn-disabled:hover,.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980b9!important}.btn-info:hover{background-color:#2e8ece!important}.btn-neutral{background-color:#f3f6f6!important;color:#404040!important}.btn-neutral:hover{background-color:#e5ebeb!important;color:#404040}.btn-neutral:visited{color:#404040!important}.btn-success{background-color:#27ae60!important}.btn-success:hover{background-color:#295!important}.btn-danger{background-color:#e74c3c!important}.btn-danger:hover{background-color:#ea6153!important}.btn-warning{background-color:#e67e22!important}.btn-warning:hover{background-color:#e98b39!important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f!important}.btn-link{background-color:transparent!important;color:#2980b9;box-shadow:none;border-color:transparent!important}.btn-link:active,.btn-link:hover{background-color:transparent!important;color:#409ad5!important;box-shadow:none}.btn-link:visited{color:#9b59b6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:after,.wy-btn-group:before{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:1px solid #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980b9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:1px solid #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type=search]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980b9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned .wy-help-inline,.wy-form-aligned input,.wy-form-aligned label,.wy-form-aligned select,.wy-form-aligned textarea{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{margin:0}fieldset,legend{border:0;padding:0}legend{width:100%;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label,legend{display:block}label{margin:0 0 .3125em;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;max-width:1200px;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:after,.wy-control-group:before{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#e74c3c}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full input[type=color],.wy-control-group .wy-form-full input[type=date],.wy-control-group .wy-form-full input[type=datetime-local],.wy-control-group .wy-form-full input[type=datetime],.wy-control-group .wy-form-full input[type=email],.wy-control-group .wy-form-full input[type=month],.wy-control-group .wy-form-full input[type=number],.wy-control-group .wy-form-full input[type=password],.wy-control-group .wy-form-full input[type=search],.wy-control-group .wy-form-full input[type=tel],.wy-control-group .wy-form-full input[type=text],.wy-control-group .wy-form-full input[type=time],.wy-control-group .wy-form-full input[type=url],.wy-control-group .wy-form-full input[type=week],.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves input[type=color],.wy-control-group .wy-form-halves input[type=date],.wy-control-group .wy-form-halves input[type=datetime-local],.wy-control-group .wy-form-halves input[type=datetime],.wy-control-group .wy-form-halves input[type=email],.wy-control-group .wy-form-halves input[type=month],.wy-control-group .wy-form-halves input[type=number],.wy-control-group .wy-form-halves input[type=password],.wy-control-group .wy-form-halves input[type=search],.wy-control-group .wy-form-halves input[type=tel],.wy-control-group .wy-form-halves input[type=text],.wy-control-group .wy-form-halves input[type=time],.wy-control-group .wy-form-halves input[type=url],.wy-control-group .wy-form-halves input[type=week],.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds input[type=color],.wy-control-group .wy-form-thirds input[type=date],.wy-control-group .wy-form-thirds input[type=datetime-local],.wy-control-group .wy-form-thirds input[type=datetime],.wy-control-group .wy-form-thirds input[type=email],.wy-control-group .wy-form-thirds input[type=month],.wy-control-group .wy-form-thirds input[type=number],.wy-control-group .wy-form-thirds input[type=password],.wy-control-group .wy-form-thirds input[type=search],.wy-control-group .wy-form-thirds input[type=tel],.wy-control-group .wy-form-thirds input[type=text],.wy-control-group .wy-form-thirds input[type=time],.wy-control-group .wy-form-thirds input[type=url],.wy-control-group .wy-form-thirds input[type=week],.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full{float:left;display:block;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.35765%;width:48.82117%}.wy-control-group .wy-form-halves:last-child,.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(odd){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.35765%;width:31.76157%}.wy-control-group .wy-form-thirds:last-child,.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control,.wy-control-no-input{margin:6px 0 0;font-size:90%}.wy-control-no-input{display:inline-block}.wy-control-group.fluid-input input[type=color],.wy-control-group.fluid-input input[type=date],.wy-control-group.fluid-input input[type=datetime-local],.wy-control-group.fluid-input input[type=datetime],.wy-control-group.fluid-input input[type=email],.wy-control-group.fluid-input input[type=month],.wy-control-group.fluid-input input[type=number],.wy-control-group.fluid-input input[type=password],.wy-control-group.fluid-input input[type=search],.wy-control-group.fluid-input input[type=tel],.wy-control-group.fluid-input input[type=text],.wy-control-group.fluid-input input[type=time],.wy-control-group.fluid-input input[type=url],.wy-control-group.fluid-input input[type=week]{width:100%}.wy-form-message-inline{padding-left:.3em;color:#666;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;*overflow:visible}input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type=datetime-local]{padding:.34375em .625em}input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type=checkbox],input[type=radio],input[type=search]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}input[type=color]:focus,input[type=date]:focus,input[type=datetime-local]:focus,input[type=datetime]:focus,input[type=email]:focus,input[type=month]:focus,input[type=number]:focus,input[type=password]:focus,input[type=search]:focus,input[type=tel]:focus,input[type=text]:focus,input[type=time]:focus,input[type=url]:focus,input[type=week]:focus{outline:0;outline:thin dotted\9;border-color:#333}input.no-focus:focus{border-color:#ccc!important}input[type=checkbox]:focus,input[type=file]:focus,input[type=radio]:focus{outline:thin dotted #333;outline:1px auto #129fea}input[type=color][disabled],input[type=date][disabled],input[type=datetime-local][disabled],input[type=datetime][disabled],input[type=email][disabled],input[type=month][disabled],input[type=number][disabled],input[type=password][disabled],input[type=search][disabled],input[type=tel][disabled],input[type=text][disabled],input[type=time][disabled],input[type=url][disabled],input[type=week][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,select:focus:invalid,textarea:focus:invalid{color:#e74c3c;border:1px solid #e74c3c}input:focus:invalid:focus,select:focus:invalid:focus,textarea:focus:invalid:focus{border-color:#e74c3c}input[type=checkbox]:focus:invalid:focus,input[type=file]:focus:invalid:focus,input[type=radio]:focus:invalid:focus{outline-color:#e74c3c}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}input[readonly],select[disabled],select[readonly],textarea[disabled],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type=checkbox][disabled],input[type=radio][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:1px solid #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{left:0;top:0;width:36px;height:12px;background:#ccc}.wy-switch:after,.wy-switch:before{position:absolute;content:"";display:block;border-radius:4px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{width:18px;height:18px;background:#999;left:-3px;top:-3px}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27ae60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#e74c3c}.wy-control-group.wy-control-group-error input[type=color],.wy-control-group.wy-control-group-error input[type=date],.wy-control-group.wy-control-group-error input[type=datetime-local],.wy-control-group.wy-control-group-error input[type=datetime],.wy-control-group.wy-control-group-error input[type=email],.wy-control-group.wy-control-group-error input[type=month],.wy-control-group.wy-control-group-error input[type=number],.wy-control-group.wy-control-group-error input[type=password],.wy-control-group.wy-control-group-error input[type=search],.wy-control-group.wy-control-group-error input[type=tel],.wy-control-group.wy-control-group-error input[type=text],.wy-control-group.wy-control-group-error input[type=time],.wy-control-group.wy-control-group-error input[type=url],.wy-control-group.wy-control-group-error input[type=week],.wy-control-group.wy-control-group-error textarea{border:1px solid #e74c3c}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27ae60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#e74c3c}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#e67e22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980b9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width:480px){.wy-form button[type=submit]{margin:.7em 0 0}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=text],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week],.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0}.wy-form-message,.wy-form-message-inline,.wy-form .wy-help-inline{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width:768px){.tablet-hide{display:none}}@media screen and (max-width:480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.rst-content table.docutils,.rst-content table.field-list,.wy-table{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.rst-content table.docutils caption,.rst-content table.field-list caption,.wy-table caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.rst-content table.docutils td,.rst-content table.docutils th,.rst-content table.field-list td,.rst-content table.field-list th,.wy-table td,.wy-table th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.rst-content table.docutils td:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list td:first-child,.rst-content table.field-list th:first-child,.wy-table td:first-child,.wy-table th:first-child{border-left-width:0}.rst-content table.docutils thead,.rst-content table.field-list thead,.wy-table thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.rst-content table.docutils thead th,.rst-content table.field-list thead th,.wy-table thead th{font-weight:700;border-bottom:2px solid #e1e4e5}.rst-content table.docutils td,.rst-content table.field-list td,.wy-table td{background-color:transparent;vertical-align:middle}.rst-content table.docutils td p,.rst-content table.field-list td p,.wy-table td p{line-height:18px}.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child,.wy-table td p:last-child{margin-bottom:0}.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min,.wy-table .wy-table-cell-min{width:1%;padding-right:0}.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:grey;font-size:90%}.wy-table-tertiary{color:grey;font-size:80%}.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td,.wy-table-backed,.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td{background-color:#f3f6f6}.rst-content table.docutils,.wy-table-bordered-all{border:1px solid #e1e4e5}.rst-content table.docutils td,.wy-table-bordered-all td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.rst-content table.docutils tbody>tr:last-child td,.wy-table-bordered-all tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0!important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980b9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9b59b6}html{height:100%}body,html{overflow-x:hidden}body{font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;font-weight:400;color:#404040;min-height:100%;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#e67e22!important}a.wy-text-warning:hover{color:#eb9950!important}.wy-text-info{color:#2980b9!important}a.wy-text-info:hover{color:#409ad5!important}.wy-text-success{color:#27ae60!important}a.wy-text-success:hover{color:#36d278!important}.wy-text-danger{color:#e74c3c!important}a.wy-text-danger:hover{color:#ed7669!important}.wy-text-neutral{color:#404040!important}a.wy-text-neutral:hover{color:#595959!important}.rst-content .toctree-wrapper>p.caption,h1,h2,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif}p{line-height:24px;font-size:16px;margin:0 0 24px}h1{font-size:175%}.rst-content .toctree-wrapper>p.caption,h2{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}.rst-content code,.rst-content tt,code{white-space:nowrap;max-width:100%;background:#fff;border:1px solid #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#e74c3c;overflow-x:auto}.rst-content tt.code-large,code.code-large{font-size:90%}.rst-content .section ul,.rst-content .toctree-wrapper ul,.rst-content section ul,.wy-plain-list-disc,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.rst-content .section ul li,.rst-content .toctree-wrapper ul li,.rst-content section ul li,.wy-plain-list-disc li,article ul li{list-style:disc;margin-left:24px}.rst-content .section ul li p:last-child,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li p:last-child,.rst-content .toctree-wrapper ul li ul,.rst-content section ul li p:last-child,.rst-content section ul li ul,.wy-plain-list-disc li p:last-child,.wy-plain-list-disc li ul,article ul li p:last-child,article ul li ul{margin-bottom:0}.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,.rst-content section ul li li,.wy-plain-list-disc li li,article ul li li{list-style:circle}.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,.rst-content section ul li li li,.wy-plain-list-disc li li li,article ul li li li{list-style:square}.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,.rst-content section ul li ol li,.wy-plain-list-disc li ol li,article ul li ol li{list-style:decimal}.rst-content .section ol,.rst-content .section ol.arabic,.rst-content .toctree-wrapper ol,.rst-content .toctree-wrapper ol.arabic,.rst-content section ol,.rst-content section ol.arabic,.wy-plain-list-decimal,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.rst-content .section ol.arabic li,.rst-content .section ol li,.rst-content .toctree-wrapper ol.arabic li,.rst-content .toctree-wrapper ol li,.rst-content section ol.arabic li,.rst-content section ol li,.wy-plain-list-decimal li,article ol li{list-style:decimal;margin-left:24px}.rst-content .section ol.arabic li ul,.rst-content .section ol li p:last-child,.rst-content .section ol li ul,.rst-content .toctree-wrapper ol.arabic li ul,.rst-content .toctree-wrapper ol li p:last-child,.rst-content .toctree-wrapper ol li ul,.rst-content section ol.arabic li ul,.rst-content section ol li p:last-child,.rst-content section ol li ul,.wy-plain-list-decimal li p:last-child,.wy-plain-list-decimal li ul,article ol li p:last-child,article ol li ul{margin-bottom:0}.rst-content .section ol.arabic li ul li,.rst-content .section ol li ul li,.rst-content .toctree-wrapper ol.arabic li ul li,.rst-content .toctree-wrapper ol li ul li,.rst-content section ol.arabic li ul li,.rst-content section ol li ul li,.wy-plain-list-decimal li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:after,.wy-breadcrumbs:before{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs>li{display:inline-block;padding-top:5px}.wy-breadcrumbs>li.wy-breadcrumbs-aside{float:right}.rst-content .wy-breadcrumbs>li code,.rst-content .wy-breadcrumbs>li tt,.wy-breadcrumbs>li .rst-content tt,.wy-breadcrumbs>li code{all:inherit;color:inherit}.breadcrumb-item:before{content:"/";color:#bbb;font-size:13px;padding:0 6px 0 3px}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width:480px){.wy-breadcrumbs-extra,.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}html{font-size:16px}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:after,.wy-menu-horiz:before{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz li,.wy-menu-horiz ul{display:inline-block}.wy-menu-horiz li:hover{background:hsla(0,0%,100%,.1)}.wy-menu-horiz li.divide-left{border-left:1px solid #404040}.wy-menu-horiz li.divide-right{border-right:1px solid #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{color:#55a5d9;height:32px;line-height:32px;padding:0 1.618em;margin:12px 0 0;display:block;font-weight:700;text-transform:uppercase;font-size:85%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:1px solid #404040}.wy-menu-vertical li.divide-bottom{border-bottom:1px solid #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:grey;border-right:1px solid #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.rst-content .wy-menu-vertical li tt,.wy-menu-vertical li .rst-content tt,.wy-menu-vertical li code{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li button.toctree-expand{display:block;float:left;margin-left:-1.2em;line-height:18px;color:#4d4d4d;border:none;background:none;padding:0}.wy-menu-vertical li.current>a,.wy-menu-vertical li.on a{color:#404040;font-weight:700;position:relative;background:#fcfcfc;border:none;padding:.4045em 1.618em}.wy-menu-vertical li.current>a:hover,.wy-menu-vertical li.on a:hover{background:#fcfcfc}.wy-menu-vertical li.current>a:hover button.toctree-expand,.wy-menu-vertical li.on a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand{display:block;line-height:18px;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:1px solid #c9c9c9;border-top:1px solid #c9c9c9}.wy-menu-vertical .toctree-l1.current .toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .toctree-l11>ul{display:none}.wy-menu-vertical .toctree-l1.current .current.toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .current.toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .current.toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .current.toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .current.toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .current.toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .current.toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .current.toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .current.toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .current.toctree-l11>ul{display:block}.wy-menu-vertical li.toctree-l3,.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a,.wy-menu-vertical li.toctree-l5 a,.wy-menu-vertical li.toctree-l6 a,.wy-menu-vertical li.toctree-l7 a,.wy-menu-vertical li.toctree-l8 a,.wy-menu-vertical li.toctree-l9 a,.wy-menu-vertical li.toctree-l10 a{color:#404040}.wy-menu-vertical li.toctree-l2 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l3 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l4 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l5 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l6 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l7 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l8 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l9 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l10 a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a,.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a,.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a,.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a,.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a,.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a,.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a,.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{display:block}.wy-menu-vertical li.toctree-l2.current>a{padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{padding:.4045em 1.618em .4045em 4.045em}.wy-menu-vertical li.toctree-l3.current>a{padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{padding:.4045em 1.618em .4045em 5.663em}.wy-menu-vertical li.toctree-l4.current>a{padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a{padding:.4045em 1.618em .4045em 7.281em}.wy-menu-vertical li.toctree-l5.current>a{padding:.4045em 7.281em}.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a{padding:.4045em 1.618em .4045em 8.899em}.wy-menu-vertical li.toctree-l6.current>a{padding:.4045em 8.899em}.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a{padding:.4045em 1.618em .4045em 10.517em}.wy-menu-vertical li.toctree-l7.current>a{padding:.4045em 10.517em}.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a{padding:.4045em 1.618em .4045em 12.135em}.wy-menu-vertical li.toctree-l8.current>a{padding:.4045em 12.135em}.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a{padding:.4045em 1.618em .4045em 13.753em}.wy-menu-vertical li.toctree-l9.current>a{padding:.4045em 13.753em}.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a{padding:.4045em 1.618em .4045em 15.371em}.wy-menu-vertical li.toctree-l10.current>a{padding:.4045em 15.371em}.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{padding:.4045em 1.618em .4045em 16.989em}.wy-menu-vertical li.toctree-l2.current>a,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{background:#c9c9c9}.wy-menu-vertical li.toctree-l2 button.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3.current>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{background:#bdbdbd}.wy-menu-vertical li.toctree-l3 button.toctree-expand{color:#969696}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:400}.wy-menu-vertical a{line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover button.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980b9;cursor:pointer;color:#fff}.wy-menu-vertical a:active button.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980b9;text-align:center;color:#fcfcfc}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-side-nav-search .wy-dropdown>a,.wy-side-nav-search>a{color:#fcfcfc;font-size:100%;font-weight:700;display:inline-block;padding:4px 6px;margin-bottom:.809em;max-width:100%}.wy-side-nav-search .wy-dropdown>a:hover,.wy-side-nav-search>a:hover{background:hsla(0,0%,100%,.1)}.wy-side-nav-search .wy-dropdown>a img.logo,.wy-side-nav-search>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search .wy-dropdown>a.icon img.logo,.wy-side-nav-search>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:400;color:hsla(0,0%,100%,.3)}.wy-nav .wy-menu-vertical header{color:#2980b9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980b9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980b9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:after,.wy-nav-top:before{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:700}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:grey}footer p{margin-bottom:12px}.rst-content footer span.commit tt,footer span.commit .rst-content tt,footer span.commit code{padding:0;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:1em;background:none;border:none;color:grey}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:after,.rst-footer-buttons:before{width:100%;display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:after,.rst-breadcrumbs-buttons:before{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:1px solid #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:1px solid #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:grey;font-size:90%}.genindextable li>ul{margin-left:24px}@media screen and (max-width:768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-menu.wy-menu-vertical,.wy-side-nav-search,.wy-side-scroll{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width:1100px){.wy-nav-content-wrap{background:rgba(0,0,0,.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,.wy-nav-side,footer{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60;*zoom:1}.rst-versions .rst-current-version:after,.rst-versions .rst-current-version:before{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-content .code-block-caption .rst-versions .rst-current-version .headerlink,.rst-content .eqno .rst-versions .rst-current-version .headerlink,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-content p .rst-versions .rst-current-version .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .icon,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-versions .rst-current-version .rst-content .code-block-caption .headerlink,.rst-versions .rst-current-version .rst-content .eqno .headerlink,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-versions .rst-current-version .rst-content p .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-versions .rst-current-version .wy-menu-vertical li button.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version button.toctree-expand{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content .toctree-wrapper>p.caption,.rst-content h1,.rst-content h2,.rst-content h3,.rst-content h4,.rst-content h5,.rst-content h6{margin-bottom:24px}.rst-content img{max-width:100%;height:auto}.rst-content div.figure,.rst-content figure{margin-bottom:24px}.rst-content div.figure .caption-text,.rst-content figure .caption-text{font-style:italic}.rst-content div.figure p:last-child.caption,.rst-content figure p:last-child.caption{margin-bottom:0}.rst-content div.figure.align-center,.rst-content figure.align-center{text-align:center}.rst-content .section>a>img,.rst-content .section>img,.rst-content section>a>img,.rst-content section>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"\f08e";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;display:block;overflow:auto}.rst-content div[class^=highlight],.rst-content pre.literal-block{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px}.rst-content div[class^=highlight] div[class^=highlight],.rst-content pre.literal-block div[class^=highlight]{padding:0;border:none;margin:0}.rst-content div[class^=highlight] td.code{width:100%}.rst-content .linenodiv pre{border-right:1px solid #e6e9ea;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^=highlight] pre{white-space:pre;margin:0;padding:12px;display:block;overflow:auto}.rst-content div[class^=highlight] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content .linenodiv pre,.rst-content div[class^=highlight] pre,.rst-content pre.literal-block{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:12px;line-height:1.4}.rst-content div.highlight .gp,.rst-content div.highlight span.linenos{user-select:none;pointer-events:none}.rst-content div.highlight span.linenos{display:inline-block;padding-left:0;padding-right:12px;margin-right:12px;border-right:1px solid #e6e9ea}.rst-content .code-block-caption{font-style:italic;font-size:85%;line-height:1;padding:1em 0;text-align:center}@media print{.rst-content .codeblock,.rst-content div[class^=highlight],.rst-content div[class^=highlight] pre{white-space:pre-wrap}}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning{clear:both}.rst-content .admonition-todo .last,.rst-content .admonition-todo>:last-child,.rst-content .admonition .last,.rst-content .admonition>:last-child,.rst-content .attention .last,.rst-content .attention>:last-child,.rst-content .caution .last,.rst-content .caution>:last-child,.rst-content .danger .last,.rst-content .danger>:last-child,.rst-content .error .last,.rst-content .error>:last-child,.rst-content .hint .last,.rst-content .hint>:last-child,.rst-content .important .last,.rst-content .important>:last-child,.rst-content .note .last,.rst-content .note>:last-child,.rst-content .seealso .last,.rst-content .seealso>:last-child,.rst-content .tip .last,.rst-content .tip>:last-child,.rst-content .warning .last,.rst-content .warning>:last-child{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent!important;border-color:rgba(0,0,0,.1)!important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha>li,.rst-content .toctree-wrapper ol.loweralpha,.rst-content .toctree-wrapper ol.loweralpha>li,.rst-content section ol.loweralpha,.rst-content section ol.loweralpha>li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha>li,.rst-content .toctree-wrapper ol.upperalpha,.rst-content .toctree-wrapper ol.upperalpha>li,.rst-content section ol.upperalpha,.rst-content section ol.upperalpha>li{list-style:upper-alpha}.rst-content .section ol li>*,.rst-content .section ul li>*,.rst-content .toctree-wrapper ol li>*,.rst-content .toctree-wrapper ul li>*,.rst-content section ol li>*,.rst-content section ul li>*{margin-top:12px;margin-bottom:12px}.rst-content .section ol li>:first-child,.rst-content .section ul li>:first-child,.rst-content .toctree-wrapper ol li>:first-child,.rst-content .toctree-wrapper ul li>:first-child,.rst-content section ol li>:first-child,.rst-content section ul li>:first-child{margin-top:0}.rst-content .section ol li>p,.rst-content .section ol li>p:last-child,.rst-content .section ul li>p,.rst-content .section ul li>p:last-child,.rst-content .toctree-wrapper ol li>p,.rst-content .toctree-wrapper ol li>p:last-child,.rst-content .toctree-wrapper ul li>p,.rst-content .toctree-wrapper ul li>p:last-child,.rst-content section ol li>p,.rst-content section ol li>p:last-child,.rst-content section ul li>p,.rst-content section ul li>p:last-child{margin-bottom:12px}.rst-content .section ol li>p:only-child,.rst-content .section ol li>p:only-child:last-child,.rst-content .section ul li>p:only-child,.rst-content .section ul li>p:only-child:last-child,.rst-content .toctree-wrapper ol li>p:only-child,.rst-content .toctree-wrapper ol li>p:only-child:last-child,.rst-content .toctree-wrapper ul li>p:only-child,.rst-content .toctree-wrapper ul li>p:only-child:last-child,.rst-content section ol li>p:only-child,.rst-content section ol li>p:only-child:last-child,.rst-content section ul li>p:only-child,.rst-content section ul li>p:only-child:last-child{margin-bottom:0}.rst-content .section ol li>ol,.rst-content .section ol li>ul,.rst-content .section ul li>ol,.rst-content .section ul li>ul,.rst-content .toctree-wrapper ol li>ol,.rst-content .toctree-wrapper ol li>ul,.rst-content .toctree-wrapper ul li>ol,.rst-content .toctree-wrapper ul li>ul,.rst-content section ol li>ol,.rst-content section ol li>ul,.rst-content section ul li>ol,.rst-content section ul li>ul{margin-bottom:12px}.rst-content .section ol.simple li>*,.rst-content .section ol.simple li ol,.rst-content .section ol.simple li ul,.rst-content .section ul.simple li>*,.rst-content .section ul.simple li ol,.rst-content .section ul.simple li ul,.rst-content .toctree-wrapper ol.simple li>*,.rst-content .toctree-wrapper ol.simple li ol,.rst-content .toctree-wrapper ol.simple li ul,.rst-content .toctree-wrapper ul.simple li>*,.rst-content .toctree-wrapper ul.simple li ol,.rst-content .toctree-wrapper ul.simple li ul,.rst-content section ol.simple li>*,.rst-content section ol.simple li ol,.rst-content section ol.simple li ul,.rst-content section ul.simple li>*,.rst-content section ul.simple li ol,.rst-content section ul.simple li ul{margin-top:0;margin-bottom:0}.rst-content .line-block{margin-left:0;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0}.rst-content .topic-title{font-weight:700;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0 0 24px 24px}.rst-content .align-left{float:left;margin:0 24px 24px 0}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink{opacity:0;font-size:14px;font-family:FontAwesome;margin-left:.5em}.rst-content .code-block-caption .headerlink:focus,.rst-content .code-block-caption:hover .headerlink,.rst-content .eqno .headerlink:focus,.rst-content .eqno:hover .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink:focus,.rst-content .toctree-wrapper>p.caption:hover .headerlink,.rst-content dl dt .headerlink:focus,.rst-content dl dt:hover .headerlink,.rst-content h1 .headerlink:focus,.rst-content h1:hover .headerlink,.rst-content h2 .headerlink:focus,.rst-content h2:hover .headerlink,.rst-content h3 .headerlink:focus,.rst-content h3:hover .headerlink,.rst-content h4 .headerlink:focus,.rst-content h4:hover .headerlink,.rst-content h5 .headerlink:focus,.rst-content h5:hover .headerlink,.rst-content h6 .headerlink:focus,.rst-content h6:hover .headerlink,.rst-content p.caption .headerlink:focus,.rst-content p.caption:hover .headerlink,.rst-content p .headerlink:focus,.rst-content p:hover .headerlink,.rst-content table>caption .headerlink:focus,.rst-content table>caption:hover .headerlink{opacity:1}.rst-content p a{overflow-wrap:anywhere}.rst-content .wy-table td p,.rst-content .wy-table td ul,.rst-content .wy-table th p,.rst-content .wy-table th ul,.rst-content table.docutils td p,.rst-content table.docutils td ul,.rst-content table.docutils th p,.rst-content table.docutils th ul,.rst-content table.field-list td p,.rst-content table.field-list td ul,.rst-content table.field-list th p,.rst-content table.field-list th ul{font-size:inherit}.rst-content .btn:focus{outline:2px solid}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:1px solid #e1e4e5}.rst-content .sidebar dl,.rst-content .sidebar p,.rst-content .sidebar ul{font-size:90%}.rst-content .sidebar .last,.rst-content .sidebar>:last-child{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif;font-weight:700;background:#e1e4e5;padding:6px 12px;margin:-24px -24px 24px;font-size:100%}.rst-content .highlighted{background:#f1c40f;box-shadow:0 0 0 2px #f1c40f;display:inline;font-weight:700}.rst-content .citation-reference,.rst-content .footnote-reference{vertical-align:baseline;position:relative;top:-.4em;line-height:0;font-size:90%}.rst-content .citation-reference>span.fn-bracket,.rst-content .footnote-reference>span.fn-bracket{display:none}.rst-content .hlist{width:100%}.rst-content dl dt span.classifier:before{content:" : "}.rst-content dl dt span.classifier-delimiter{display:none!important}html.writer-html4 .rst-content table.docutils.citation,html.writer-html4 .rst-content table.docutils.footnote{background:none;border:none}html.writer-html4 .rst-content table.docutils.citation td,html.writer-html4 .rst-content table.docutils.citation tr,html.writer-html4 .rst-content table.docutils.footnote td,html.writer-html4 .rst-content table.docutils.footnote tr{border:none;background-color:transparent!important;white-space:normal}html.writer-html4 .rst-content table.docutils.citation td.label,html.writer-html4 .rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{display:grid;grid-template-columns:auto minmax(80%,95%)}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{display:inline-grid;grid-template-columns:max-content auto}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{display:grid;grid-template-columns:auto auto minmax(.65rem,auto) minmax(40%,95%)}html.writer-html5 .rst-content aside.citation>span.label,html.writer-html5 .rst-content aside.footnote>span.label,html.writer-html5 .rst-content div.citation>span.label{grid-column-start:1;grid-column-end:2}html.writer-html5 .rst-content aside.citation>span.backrefs,html.writer-html5 .rst-content aside.footnote>span.backrefs,html.writer-html5 .rst-content div.citation>span.backrefs{grid-column-start:2;grid-column-end:3;grid-row-start:1;grid-row-end:3}html.writer-html5 .rst-content aside.citation>p,html.writer-html5 .rst-content aside.footnote>p,html.writer-html5 .rst-content div.citation>p{grid-column-start:4;grid-column-end:5}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{margin-bottom:24px}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{padding-left:1rem}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dd,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dd,html.writer-html5 .rst-content dl.footnote>dt{margin-bottom:0}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{font-size:.9rem}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.footnote>dt{margin:0 .5rem .5rem 0;line-height:1.2rem;word-break:break-all;font-weight:400}html.writer-html5 .rst-content dl.citation>dt>span.brackets:before,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:before{content:"["}html.writer-html5 .rst-content dl.citation>dt>span.brackets:after,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:after{content:"]"}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a{word-break:keep-all}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a:not(:first-child):before,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.footnote>dd{margin:0 0 .5rem;line-height:1.2rem}html.writer-html5 .rst-content dl.citation>dd p,html.writer-html5 .rst-content dl.footnote>dd p{font-size:.9rem}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{padding-left:1rem;padding-right:1rem;font-size:.9rem;line-height:1.2rem}html.writer-html5 .rst-content aside.citation p,html.writer-html5 .rst-content aside.footnote p,html.writer-html5 .rst-content div.citation p{font-size:.9rem;line-height:1.2rem;margin-bottom:12px}html.writer-html5 .rst-content aside.citation span.backrefs,html.writer-html5 .rst-content aside.footnote span.backrefs,html.writer-html5 .rst-content div.citation span.backrefs{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content aside.citation span.backrefs>a,html.writer-html5 .rst-content aside.footnote span.backrefs>a,html.writer-html5 .rst-content div.citation span.backrefs>a{word-break:keep-all}html.writer-html5 .rst-content aside.citation span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content aside.footnote span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content div.citation span.backrefs>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content aside.citation span.label,html.writer-html5 .rst-content aside.footnote span.label,html.writer-html5 .rst-content div.citation span.label{line-height:1.2rem}html.writer-html5 .rst-content aside.citation-list,html.writer-html5 .rst-content aside.footnote-list,html.writer-html5 .rst-content div.citation-list{margin-bottom:24px}html.writer-html5 .rst-content dl.option-list kbd{font-size:.9rem}.rst-content table.docutils.footnote,html.writer-html4 .rst-content table.docutils.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content aside.footnote-list aside.footnote,html.writer-html5 .rst-content div.citation-list>div.citation,html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{color:grey}.rst-content table.docutils.footnote code,.rst-content table.docutils.footnote tt,html.writer-html4 .rst-content table.docutils.citation code,html.writer-html4 .rst-content table.docutils.citation tt,html.writer-html5 .rst-content aside.footnote-list aside.footnote code,html.writer-html5 .rst-content aside.footnote-list aside.footnote tt,html.writer-html5 .rst-content aside.footnote code,html.writer-html5 .rst-content aside.footnote tt,html.writer-html5 .rst-content div.citation-list>div.citation code,html.writer-html5 .rst-content div.citation-list>div.citation tt,html.writer-html5 .rst-content dl.citation code,html.writer-html5 .rst-content dl.citation tt,html.writer-html5 .rst-content dl.footnote code,html.writer-html5 .rst-content dl.footnote tt{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}html.writer-html5 .rst-content table.docutils th{border:1px solid #e1e4e5}html.writer-html5 .rst-content table.docutils td>p,html.writer-html5 .rst-content table.docutils th>p{line-height:1rem;margin-bottom:0;font-size:.9rem}.rst-content table.docutils td .last,.rst-content table.docutils td .last>:last-child{margin-bottom:0}.rst-content table.field-list,.rst-content table.field-list td{border:none}.rst-content table.field-list td p{line-height:inherit}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content code,.rst-content tt{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;padding:2px 5px}.rst-content code big,.rst-content code em,.rst-content tt big,.rst-content tt em{font-size:100%!important;line-height:normal}.rst-content code.literal,.rst-content tt.literal{color:#e74c3c;white-space:normal}.rst-content code.xref,.rst-content tt.xref,a .rst-content code,a .rst-content tt{font-weight:700;color:#404040;overflow-wrap:normal}.rst-content kbd,.rst-content pre,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace}.rst-content a code,.rst-content a tt{color:#2980b9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:700;margin-bottom:12px}.rst-content dl ol,.rst-content dl p,.rst-content dl table,.rst-content dl ul{margin-bottom:12px}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}.rst-content dl dd>ol:last-child,.rst-content dl dd>p:last-child,.rst-content dl dd>table:last-child,.rst-content dl dd>ul:last-child{margin-bottom:0}html.writer-html4 .rst-content dl:not(.docutils),html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple){margin-bottom:24px}html.writer-html4 .rst-content dl:not(.docutils)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980b9;border-top:3px solid #6ab0de;padding:6px;position:relative}html.writer-html4 .rst-content dl:not(.docutils)>dt:before,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:before{color:#6ab0de}html.writer-html4 .rst-content dl:not(.docutils)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{margin-bottom:6px;border:none;border-left:3px solid #ccc;background:#f0f0f0;color:#555}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils)>dt:first-child,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:first-child{margin-top:0}html.writer-html4 .rst-content dl:not(.docutils) code.descclassname,html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descclassname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{background-color:transparent;border:none;padding:0;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .optional,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .property,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .property{display:inline-block;padding-right:8px;max-width:100%}html.writer-html4 .rst-content dl:not(.docutils) .k,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .k{font-style:italic}html.writer-html4 .rst-content dl:not(.docutils) .descclassname,html.writer-html4 .rst-content dl:not(.docutils) .descname,html.writer-html4 .rst-content dl:not(.docutils) .sig-name,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .sig-name{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#000}.rst-content .viewcode-back,.rst-content .viewcode-link{display:inline-block;color:#27ae60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:700}.rst-content code.download,.rst-content tt.download{background:inherit;padding:inherit;font-weight:400;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content code.download span:first-child,.rst-content tt.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{margin-right:4px}.rst-content .guilabel,.rst-content .menuselection{font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content .guilabel,.rst-content .menuselection{border:1px solid #7fbbe3;background:#e7f2fa}.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>.kbd,.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>kbd{color:inherit;font-size:80%;background-color:#fff;border:1px solid #a6a6a6;border-radius:4px;box-shadow:0 2px grey;padding:2.4px 6px;margin:auto 0}.rst-content .versionmodified{font-style:italic}@media screen and (max-width:480px){.rst-content .sidebar{width:100%}}span[id*=MathJax-Span]{color:#404040}.math{text-align:center}@font-face{font-family:Lato;src:url(fonts/lato-normal.woff2?bd03a2cc277bbbc338d464e679fe9942) format("woff2"),url(fonts/lato-normal.woff?27bd77b9162d388cb8d4c4217c7c5e2a) format("woff");font-weight:400;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold.woff2?cccb897485813c7c256901dbca54ecf2) format("woff2"),url(fonts/lato-bold.woff?d878b6c29b10beca227e9eef4246111b) format("woff");font-weight:700;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold-italic.woff2?0b6bb6725576b072c5d0b02ecdd1900d) format("woff2"),url(fonts/lato-bold-italic.woff?9c7e4e9eb485b4a121c760e61bc3707c) format("woff");font-weight:700;font-style:italic;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-normal-italic.woff2?4eb103b4d12be57cb1d040ed5e162e9d) format("woff2"),url(fonts/lato-normal-italic.woff?f28f2d6482446544ef1ea1ccc6dd5892) format("woff");font-weight:400;font-style:italic;font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:400;src:url(fonts/Roboto-Slab-Regular.woff2?7abf5b8d04d26a2cafea937019bca958) format("woff2"),url(fonts/Roboto-Slab-Regular.woff?c1be9284088d487c5e3ff0a10a92e58c) format("woff");font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:700;src:url(fonts/Roboto-Slab-Bold.woff2?9984f4a9bda09be08e83f2506954adbe) format("woff2"),url(fonts/Roboto-Slab-Bold.woff?bed5564a116b05148e3b3bea6fb1162a) format("woff");font-display:block} \ No newline at end of file diff --git a/_static/doctools.js b/_static/doctools.js new file mode 100644 index 00000000..527b876c --- /dev/null +++ b/_static/doctools.js @@ -0,0 +1,156 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Base JavaScript utilities for all Sphinx HTML documentation. + * + * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([ + "TEXTAREA", + "INPUT", + "SELECT", + "BUTTON", +]); + +const _ready = (callback) => { + if (document.readyState !== "loading") { + callback(); + } else { + document.addEventListener("DOMContentLoaded", callback); + } +}; + +/** + * Small JavaScript module for the documentation. + */ +const Documentation = { + init: () => { + Documentation.initDomainIndexTable(); + Documentation.initOnKeyListeners(); + }, + + /** + * i18n support + */ + TRANSLATIONS: {}, + PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), + LOCALE: "unknown", + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext: (string) => { + const translated = Documentation.TRANSLATIONS[string]; + switch (typeof translated) { + case "undefined": + return string; // no translation + case "string": + return translated; // translation exists + default: + return translated[0]; // (singular, plural) translation tuple exists + } + }, + + ngettext: (singular, plural, n) => { + const translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated !== "undefined") + return translated[Documentation.PLURAL_EXPR(n)]; + return n === 1 ? singular : plural; + }, + + addTranslations: (catalog) => { + Object.assign(Documentation.TRANSLATIONS, catalog.messages); + Documentation.PLURAL_EXPR = new Function( + "n", + `return (${catalog.plural_expr})` + ); + Documentation.LOCALE = catalog.locale; + }, + + /** + * helper function to focus on search bar + */ + focusSearchBar: () => { + document.querySelectorAll("input[name=q]")[0]?.focus(); + }, + + /** + * Initialise the domain index toggle buttons + */ + initDomainIndexTable: () => { + const toggler = (el) => { + const idNumber = el.id.substr(7); + const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); + if (el.src.substr(-9) === "minus.png") { + el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; + toggledRows.forEach((el) => (el.style.display = "none")); + } else { + el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; + toggledRows.forEach((el) => (el.style.display = "")); + } + }; + + const togglerElements = document.querySelectorAll("img.toggler"); + togglerElements.forEach((el) => + el.addEventListener("click", (event) => toggler(event.currentTarget)) + ); + togglerElements.forEach((el) => (el.style.display = "")); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); + }, + + initOnKeyListeners: () => { + // only install a listener if it is really needed + if ( + !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && + !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + ) + return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.altKey || event.ctrlKey || event.metaKey) return; + + if (!event.shiftKey) { + switch (event.key) { + case "ArrowLeft": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const prevLink = document.querySelector('link[rel="prev"]'); + if (prevLink && prevLink.href) { + window.location.href = prevLink.href; + event.preventDefault(); + } + break; + case "ArrowRight": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const nextLink = document.querySelector('link[rel="next"]'); + if (nextLink && nextLink.href) { + window.location.href = nextLink.href; + event.preventDefault(); + } + break; + } + } + + // some keyboard layouts may need Shift to get / + switch (event.key) { + case "/": + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; + Documentation.focusSearchBar(); + event.preventDefault(); + } + }); + }, +}; + +// quick alias for translations +const _ = Documentation.gettext; + +_ready(Documentation.init); diff --git a/_static/documentation_options.js b/_static/documentation_options.js new file mode 100644 index 00000000..b57ae3b8 --- /dev/null +++ b/_static/documentation_options.js @@ -0,0 +1,14 @@ +var DOCUMENTATION_OPTIONS = { + URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), + VERSION: '', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false, + SHOW_SEARCH_SUMMARY: true, + ENABLE_SEARCH_SHORTCUTS: true, +}; \ No newline at end of file diff --git a/_static/file.png b/_static/file.png new file mode 100644 index 00000000..a858a410 Binary files /dev/null and b/_static/file.png differ diff --git a/_static/jquery-3.6.0.js b/_static/jquery-3.6.0.js new file mode 100644 index 00000000..fc6c299b --- /dev/null +++ b/_static/jquery-3.6.0.js @@ -0,0 +1,10881 @@ +/*! + * jQuery JavaScript Library v3.6.0 + * https://jquery.com/ + * + * Includes Sizzle.js + * https://sizzlejs.com/ + * + * Copyright OpenJS Foundation and other contributors + * Released under the MIT license + * https://jquery.org/license + * + * Date: 2021-03-02T17:08Z + */ +( function( global, factory ) { + + "use strict"; + + if ( typeof module === "object" && typeof module.exports === "object" ) { + + // For CommonJS and CommonJS-like environments where a proper `window` + // is present, execute the factory and get jQuery. + // For environments that do not have a `window` with a `document` + // (such as Node.js), expose a factory as module.exports. + // This accentuates the need for the creation of a real `window`. + // e.g. var jQuery = require("jquery")(window); + // See ticket #14549 for more info. + module.exports = global.document ? + factory( global, true ) : + function( w ) { + if ( !w.document ) { + throw new Error( "jQuery requires a window with a document" ); + } + return factory( w ); + }; + } else { + factory( global ); + } + +// Pass this if window is not defined yet +} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { + +// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 +// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode +// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common +// enough that all such attempts are guarded in a try block. +"use strict"; + +var arr = []; + +var getProto = Object.getPrototypeOf; + +var slice = arr.slice; + +var flat = arr.flat ? function( array ) { + return arr.flat.call( array ); +} : function( array ) { + return arr.concat.apply( [], array ); +}; + + +var push = arr.push; + +var indexOf = arr.indexOf; + +var class2type = {}; + +var toString = class2type.toString; + +var hasOwn = class2type.hasOwnProperty; + +var fnToString = hasOwn.toString; + +var ObjectFunctionString = fnToString.call( Object ); + +var support = {}; + +var isFunction = function isFunction( obj ) { + + // Support: Chrome <=57, Firefox <=52 + // In some browsers, typeof returns "function" for HTML elements + // (i.e., `typeof document.createElement( "object" ) === "function"`). + // We don't want to classify *any* DOM node as a function. + // Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5 + // Plus for old WebKit, typeof returns "function" for HTML collections + // (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756) + return typeof obj === "function" && typeof obj.nodeType !== "number" && + typeof obj.item !== "function"; + }; + + +var isWindow = function isWindow( obj ) { + return obj != null && obj === obj.window; + }; + + +var document = window.document; + + + + var preservedScriptAttributes = { + type: true, + src: true, + nonce: true, + noModule: true + }; + + function DOMEval( code, node, doc ) { + doc = doc || document; + + var i, val, + script = doc.createElement( "script" ); + + script.text = code; + if ( node ) { + for ( i in preservedScriptAttributes ) { + + // Support: Firefox 64+, Edge 18+ + // Some browsers don't support the "nonce" property on scripts. + // On the other hand, just using `getAttribute` is not enough as + // the `nonce` attribute is reset to an empty string whenever it + // becomes browsing-context connected. + // See https://github.com/whatwg/html/issues/2369 + // See https://html.spec.whatwg.org/#nonce-attributes + // The `node.getAttribute` check was added for the sake of + // `jQuery.globalEval` so that it can fake a nonce-containing node + // via an object. + val = node[ i ] || node.getAttribute && node.getAttribute( i ); + if ( val ) { + script.setAttribute( i, val ); + } + } + } + doc.head.appendChild( script ).parentNode.removeChild( script ); + } + + +function toType( obj ) { + if ( obj == null ) { + return obj + ""; + } + + // Support: Android <=2.3 only (functionish RegExp) + return typeof obj === "object" || typeof obj === "function" ? + class2type[ toString.call( obj ) ] || "object" : + typeof obj; +} +/* global Symbol */ +// Defining this global in .eslintrc.json would create a danger of using the global +// unguarded in another place, it seems safer to define global only for this module + + + +var + version = "3.6.0", + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + + // The jQuery object is actually just the init constructor 'enhanced' + // Need init if jQuery is called (just allow error to be thrown if not included) + return new jQuery.fn.init( selector, context ); + }; + +jQuery.fn = jQuery.prototype = { + + // The current version of jQuery being used + jquery: version, + + constructor: jQuery, + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + + // Return all the elements in a clean array + if ( num == null ) { + return slice.call( this ); + } + + // Return just the one element from the set + return num < 0 ? this[ num + this.length ] : this[ num ]; + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + each: function( callback ) { + return jQuery.each( this, callback ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map( this, function( elem, i ) { + return callback.call( elem, i, elem ); + } ) ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + even: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return ( i + 1 ) % 2; + } ) ); + }, + + odd: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return i % 2; + } ) ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); + }, + + end: function() { + return this.prevObject || this.constructor(); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: arr.sort, + splice: arr.splice +}; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[ 0 ] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + + // Skip the boolean and the target + target = arguments[ i ] || {}; + i++; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !isFunction( target ) ) { + target = {}; + } + + // Extend jQuery itself if only one argument is passed + if ( i === length ) { + target = this; + i--; + } + + for ( ; i < length; i++ ) { + + // Only deal with non-null/undefined values + if ( ( options = arguments[ i ] ) != null ) { + + // Extend the base object + for ( name in options ) { + copy = options[ name ]; + + // Prevent Object.prototype pollution + // Prevent never-ending loop + if ( name === "__proto__" || target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject( copy ) || + ( copyIsArray = Array.isArray( copy ) ) ) ) { + src = target[ name ]; + + // Ensure proper type for the source value + if ( copyIsArray && !Array.isArray( src ) ) { + clone = []; + } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { + clone = {}; + } else { + clone = src; + } + copyIsArray = false; + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend( { + + // Unique for each copy of jQuery on the page + expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), + + // Assume jQuery is ready without the ready module + isReady: true, + + error: function( msg ) { + throw new Error( msg ); + }, + + noop: function() {}, + + isPlainObject: function( obj ) { + var proto, Ctor; + + // Detect obvious negatives + // Use toString instead of jQuery.type to catch host objects + if ( !obj || toString.call( obj ) !== "[object Object]" ) { + return false; + } + + proto = getProto( obj ); + + // Objects with no prototype (e.g., `Object.create( null )`) are plain + if ( !proto ) { + return true; + } + + // Objects with prototype are plain iff they were constructed by a global Object function + Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; + return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; + }, + + isEmptyObject: function( obj ) { + var name; + + for ( name in obj ) { + return false; + } + return true; + }, + + // Evaluates a script in a provided context; falls back to the global one + // if not specified. + globalEval: function( code, options, doc ) { + DOMEval( code, { nonce: options && options.nonce }, doc ); + }, + + each: function( obj, callback ) { + var length, i = 0; + + if ( isArrayLike( obj ) ) { + length = obj.length; + for ( ; i < length; i++ ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } else { + for ( i in obj ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } + + return obj; + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArrayLike( Object( arr ) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + return arr == null ? -1 : indexOf.call( arr, elem, i ); + }, + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + merge: function( first, second ) { + var len = +second.length, + j = 0, + i = first.length; + + for ( ; j < len; j++ ) { + first[ i++ ] = second[ j ]; + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, invert ) { + var callbackInverse, + matches = [], + i = 0, + length = elems.length, + callbackExpect = !invert; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + callbackInverse = !callback( elems[ i ], i ); + if ( callbackInverse !== callbackExpect ) { + matches.push( elems[ i ] ); + } + } + + return matches; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var length, value, + i = 0, + ret = []; + + // Go through the array, translating each of the items to their new values + if ( isArrayLike( elems ) ) { + length = elems.length; + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + } + + // Flatten any nested arrays + return flat( ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // jQuery.support is not used in Core but other projects attach their + // properties to it so it needs to exist. + support: support +} ); + +if ( typeof Symbol === "function" ) { + jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; +} + +// Populate the class2type map +jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), + function( _i, name ) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); + } ); + +function isArrayLike( obj ) { + + // Support: real iOS 8.2 only (not reproducible in simulator) + // `in` check used to prevent JIT error (gh-2145) + // hasOwn isn't used here due to false negatives + // regarding Nodelist length in IE + var length = !!obj && "length" in obj && obj.length, + type = toType( obj ); + + if ( isFunction( obj ) || isWindow( obj ) ) { + return false; + } + + return type === "array" || length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj; +} +var Sizzle = +/*! + * Sizzle CSS Selector Engine v2.3.6 + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://js.foundation/ + * + * Date: 2021-02-16 + */ +( function( window ) { +var i, + support, + Expr, + getText, + isXML, + tokenize, + compile, + select, + outermostContext, + sortInput, + hasDuplicate, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + 1 * new Date(), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + nonnativeSelectorCache = createCache(), + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + } + return 0; + }, + + // Instance methods + hasOwn = ( {} ).hasOwnProperty, + arr = [], + pop = arr.pop, + pushNative = arr.push, + push = arr.push, + slice = arr.slice, + + // Use a stripped-down indexOf as it's faster than native + // https://jsperf.com/thor-indexof-vs-for/5 + indexOf = function( list, elem ) { + var i = 0, + len = list.length; + for ( ; i < len; i++ ) { + if ( list[ i ] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + + "ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + + // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram + identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + + "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", + + // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + + + // Operator (capture 2) + "*([*^$|!~]?=)" + whitespace + + + // "Attribute values must be CSS identifiers [capture 5] + // or strings [capture 3 or capture 4]" + "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + + whitespace + "*\\]", + + pseudos = ":(" + identifier + ")(?:\\((" + + + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: + // 1. quoted (capture 3; capture 4 or capture 5) + "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + + + // 2. simple (capture 6) + "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + + + // 3. anything else (capture 2) + ".*" + + ")\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rwhitespace = new RegExp( whitespace + "+", "g" ), + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + + "*" ), + rdescend = new RegExp( whitespace + "|>" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + identifier + ")" ), + "CLASS": new RegExp( "^\\.(" + identifier + ")" ), + "TAG": new RegExp( "^(" + identifier + "|[*])" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + + whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + + whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rhtml = /HTML$/i, + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rsibling = /[+~]/, + + // CSS escapes + // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), + funescape = function( escape, nonHex ) { + var high = "0x" + escape.slice( 1 ) - 0x10000; + + return nonHex ? + + // Strip the backslash prefix from a non-hex escape sequence + nonHex : + + // Replace a hexadecimal escape sequence with the encoded Unicode code point + // Support: IE <=11+ + // For values outside the Basic Multilingual Plane (BMP), manually construct a + // surrogate pair + high < 0 ? + String.fromCharCode( high + 0x10000 ) : + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }, + + // CSS string/identifier serialization + // https://drafts.csswg.org/cssom/#common-serializing-idioms + rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, + fcssescape = function( ch, asCodePoint ) { + if ( asCodePoint ) { + + // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER + if ( ch === "\0" ) { + return "\uFFFD"; + } + + // Control characters and (dependent upon position) numbers get escaped as code points + return ch.slice( 0, -1 ) + "\\" + + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; + } + + // Other potentially-special ASCII characters get backslash-escaped + return "\\" + ch; + }, + + // Used for iframes + // See setDocument() + // Removing the function wrapper causes a "Permission Denied" + // error in IE + unloadHandler = function() { + setDocument(); + }, + + inDisabledFieldset = addCombinator( + function( elem ) { + return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; + }, + { dir: "parentNode", next: "legend" } + ); + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + ( arr = slice.call( preferredDoc.childNodes ) ), + preferredDoc.childNodes + ); + + // Support: Android<4.0 + // Detect silently failing push.apply + // eslint-disable-next-line no-unused-expressions + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + pushNative.apply( target, slice.call( els ) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + + // Can't trust NodeList.length + while ( ( target[ j++ ] = els[ i++ ] ) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var m, i, elem, nid, match, groups, newSelector, + newContext = context && context.ownerDocument, + + // nodeType defaults to 9, since context defaults to document + nodeType = context ? context.nodeType : 9; + + results = results || []; + + // Return early from calls with invalid selector or context + if ( typeof selector !== "string" || !selector || + nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { + + return results; + } + + // Try to shortcut find operations (as opposed to filters) in HTML documents + if ( !seed ) { + setDocument( context ); + context = context || document; + + if ( documentIsHTML ) { + + // If the selector is sufficiently simple, try using a "get*By*" DOM method + // (excepting DocumentFragment context, where the methods don't exist) + if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { + + // ID selector + if ( ( m = match[ 1 ] ) ) { + + // Document context + if ( nodeType === 9 ) { + if ( ( elem = context.getElementById( m ) ) ) { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + + // Element context + } else { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( newContext && ( elem = newContext.getElementById( m ) ) && + contains( context, elem ) && + elem.id === m ) { + + results.push( elem ); + return results; + } + } + + // Type selector + } else if ( match[ 2 ] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Class selector + } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && + context.getElementsByClassName ) { + + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // Take advantage of querySelectorAll + if ( support.qsa && + !nonnativeSelectorCache[ selector + " " ] && + ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && + + // Support: IE 8 only + // Exclude object elements + ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { + + newSelector = selector; + newContext = context; + + // qSA considers elements outside a scoping root when evaluating child or + // descendant combinators, which is not what we want. + // In such cases, we work around the behavior by prefixing every selector in the + // list with an ID selector referencing the scope context. + // The technique has to be used as well when a leading combinator is used + // as such selectors are not recognized by querySelectorAll. + // Thanks to Andrew Dupont for this technique. + if ( nodeType === 1 && + ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { + + // Expand context for sibling selectors + newContext = rsibling.test( selector ) && testContext( context.parentNode ) || + context; + + // We can use :scope instead of the ID hack if the browser + // supports it & if we're not changing the context. + if ( newContext !== context || !support.scope ) { + + // Capture the context ID, setting it first if necessary + if ( ( nid = context.getAttribute( "id" ) ) ) { + nid = nid.replace( rcssescape, fcssescape ); + } else { + context.setAttribute( "id", ( nid = expando ) ); + } + } + + // Prefix every selector in the list + groups = tokenize( selector ); + i = groups.length; + while ( i-- ) { + groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + + toSelector( groups[ i ] ); + } + newSelector = groups.join( "," ); + } + + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch ( qsaError ) { + nonnativeSelectorCache( selector, true ); + } finally { + if ( nid === expando ) { + context.removeAttribute( "id" ); + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {function(string, object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key + " " ) > Expr.cacheLength ) { + + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return ( cache[ key + " " ] = value ); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created element and returns a boolean result + */ +function assert( fn ) { + var el = document.createElement( "fieldset" ); + + try { + return !!fn( el ); + } catch ( e ) { + return false; + } finally { + + // Remove from its parent by default + if ( el.parentNode ) { + el.parentNode.removeChild( el ); + } + + // release memory in IE + el = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split( "|" ), + i = arr.length; + + while ( i-- ) { + Expr.attrHandle[ arr[ i ] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + a.sourceIndex - b.sourceIndex; + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( ( cur = cur.nextSibling ) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return ( name === "input" || name === "button" ) && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for :enabled/:disabled + * @param {Boolean} disabled true for :disabled; false for :enabled + */ +function createDisabledPseudo( disabled ) { + + // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable + return function( elem ) { + + // Only certain elements can match :enabled or :disabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled + if ( "form" in elem ) { + + // Check for inherited disabledness on relevant non-disabled elements: + // * listed form-associated elements in a disabled fieldset + // https://html.spec.whatwg.org/multipage/forms.html#category-listed + // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled + // * option elements in a disabled optgroup + // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled + // All such elements have a "form" property. + if ( elem.parentNode && elem.disabled === false ) { + + // Option elements defer to a parent optgroup if present + if ( "label" in elem ) { + if ( "label" in elem.parentNode ) { + return elem.parentNode.disabled === disabled; + } else { + return elem.disabled === disabled; + } + } + + // Support: IE 6 - 11 + // Use the isDisabled shortcut property to check for disabled fieldset ancestors + return elem.isDisabled === disabled || + + // Where there is no isDisabled, check manually + /* jshint -W018 */ + elem.isDisabled !== !disabled && + inDisabledFieldset( elem ) === disabled; + } + + return elem.disabled === disabled; + + // Try to winnow out elements that can't be disabled before trusting the disabled property. + // Some victims get caught in our net (label, legend, menu, track), but it shouldn't + // even exist on them, let alone have a boolean value. + } else if ( "label" in elem ) { + return elem.disabled === disabled; + } + + // Remaining elements are neither :enabled nor :disabled + return false; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction( function( argument ) { + argument = +argument; + return markFunction( function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ ( j = matchIndexes[ i ] ) ] ) { + seed[ j ] = !( matches[ j ] = seed[ j ] ); + } + } + } ); + } ); +} + +/** + * Checks a node for validity as a Sizzle context + * @param {Element|Object=} context + * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value + */ +function testContext( context ) { + return context && typeof context.getElementsByTagName !== "undefined" && context; +} + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Detects XML nodes + * @param {Element|Object} elem An element or a document + * @returns {Boolean} True iff elem is a non-HTML XML node + */ +isXML = Sizzle.isXML = function( elem ) { + var namespace = elem && elem.namespaceURI, + docElem = elem && ( elem.ownerDocument || elem ).documentElement; + + // Support: IE <=8 + // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes + // https://bugs.jquery.com/ticket/4833 + return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); +}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var hasCompare, subWindow, + doc = node ? node.ownerDocument || node : preferredDoc; + + // Return early if doc is invalid or already selected + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Update global variables + document = doc; + docElem = document.documentElement; + documentIsHTML = !isXML( document ); + + // Support: IE 9 - 11+, Edge 12 - 18+ + // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( preferredDoc != document && + ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { + + // Support: IE 11, Edge + if ( subWindow.addEventListener ) { + subWindow.addEventListener( "unload", unloadHandler, false ); + + // Support: IE 9 - 10 only + } else if ( subWindow.attachEvent ) { + subWindow.attachEvent( "onunload", unloadHandler ); + } + } + + // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, + // Safari 4 - 5 only, Opera <=11.6 - 12.x only + // IE/Edge & older browsers don't support the :scope pseudo-class. + // Support: Safari 6.0 only + // Safari 6.0 supports :scope but it's an alias of :root there. + support.scope = assert( function( el ) { + docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); + return typeof el.querySelectorAll !== "undefined" && + !el.querySelectorAll( ":scope fieldset div" ).length; + } ); + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties + // (excepting IE8 booleans) + support.attributes = assert( function( el ) { + el.className = "i"; + return !el.getAttribute( "className" ); + } ); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert( function( el ) { + el.appendChild( document.createComment( "" ) ); + return !el.getElementsByTagName( "*" ).length; + } ); + + // Support: IE<9 + support.getElementsByClassName = rnative.test( document.getElementsByClassName ); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programmatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert( function( el ) { + docElem.appendChild( el ).id = expando; + return !document.getElementsByName || !document.getElementsByName( expando ).length; + } ); + + // ID filter and find + if ( support.getById ) { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute( "id" ) === attrId; + }; + }; + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var elem = context.getElementById( id ); + return elem ? [ elem ] : []; + } + }; + } else { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== "undefined" && + elem.getAttributeNode( "id" ); + return node && node.value === attrId; + }; + }; + + // Support: IE 6 - 7 only + // getElementById is not reliable as a find shortcut + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var node, i, elems, + elem = context.getElementById( id ); + + if ( elem ) { + + // Verify the id attribute + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + + // Fall back on getElementsByName + elems = context.getElementsByName( id ); + i = 0; + while ( ( elem = elems[ i++ ] ) ) { + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + } + } + + return []; + } + }; + } + + // Tag + Expr.find[ "TAG" ] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( tag ); + + // DocumentFragment nodes don't have gEBTN + } else if ( support.qsa ) { + return context.querySelectorAll( tag ); + } + } : + + function( tag, context ) { + var elem, + tmp = [], + i = 0, + + // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See https://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { + + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert( function( el ) { + + var input; + + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // https://bugs.jquery.com/ticket/12359 + docElem.appendChild( el ).innerHTML = "" + + ""; + + // Support: IE8, Opera 11-12.16 + // Nothing should be selected when empty strings follow ^= or $= or *= + // The test attribute must be unknown in Opera but "safe" for WinRT + // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section + if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !el.querySelectorAll( "[selected]" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ + if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { + rbuggyQSA.push( "~=" ); + } + + // Support: IE 11+, Edge 15 - 18+ + // IE 11/Edge don't find elements on a `[name='']` query in some cases. + // Adding a temporary attribute to the document before the selection works + // around the issue. + // Interestingly, IE 10 & older don't seem to have the issue. + input = document.createElement( "input" ); + input.setAttribute( "name", "" ); + el.appendChild( input ); + if ( !el.querySelectorAll( "[name='']" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + + whitespace + "*(?:''|\"\")" ); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !el.querySelectorAll( ":checked" ).length ) { + rbuggyQSA.push( ":checked" ); + } + + // Support: Safari 8+, iOS 8+ + // https://bugs.webkit.org/show_bug.cgi?id=136851 + // In-page `selector#id sibling-combinator selector` fails + if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { + rbuggyQSA.push( ".#.+[+~]" ); + } + + // Support: Firefox <=3.6 - 5 only + // Old Firefox doesn't throw on a badly-escaped identifier. + el.querySelectorAll( "\\\f" ); + rbuggyQSA.push( "[\\r\\n\\f]" ); + } ); + + assert( function( el ) { + el.innerHTML = "" + + ""; + + // Support: Windows 8 Native Apps + // The type and name attributes are restricted during .innerHTML assignment + var input = document.createElement( "input" ); + input.setAttribute( "type", "hidden" ); + el.appendChild( input ).setAttribute( "name", "D" ); + + // Support: IE8 + // Enforce case-sensitivity of name attribute + if ( el.querySelectorAll( "[name=d]" ).length ) { + rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: IE9-11+ + // IE's :disabled selector does not pick up the children of disabled fieldsets + docElem.appendChild( el ).disabled = true; + if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: Opera 10 - 11 only + // Opera 10-11 does not throw on post-comma invalid pseudos + el.querySelectorAll( "*,:x" ); + rbuggyQSA.push( ",.*:" ); + } ); + } + + if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || + docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector ) ) ) ) { + + assert( function( el ) { + + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( el, "*" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( el, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + } ); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); + + /* Contains + ---------------------------------------------------------------------- */ + hasCompare = rnative.test( docElem.compareDocumentPosition ); + + // Element contains another + // Purposefully self-exclusive + // As in, an element does not contain itself + contains = hasCompare || rnative.test( docElem.contains ) ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + ) ); + } : + function( a, b ) { + if ( b ) { + while ( ( b = b.parentNode ) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = hasCompare ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + // Sort on method existence if only one input has compareDocumentPosition + var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; + if ( compare ) { + return compare; + } + + // Calculate position if both inputs belong to the same document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? + a.compareDocumentPosition( b ) : + + // Otherwise we know they are disconnected + 1; + + // Disconnected nodes + if ( compare & 1 || + ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { + + // Choose the first element that is related to our preferred document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( a == document || a.ownerDocument == preferredDoc && + contains( preferredDoc, a ) ) { + return -1; + } + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( b == document || b.ownerDocument == preferredDoc && + contains( preferredDoc, b ) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } : + function( a, b ) { + + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Parentless nodes are either documents or disconnected + if ( !aup || !bup ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + return a == document ? -1 : + b == document ? 1 : + /* eslint-enable eqeqeq */ + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( ( cur = cur.parentNode ) ) { + ap.unshift( cur ); + } + cur = b; + while ( ( cur = cur.parentNode ) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[ i ] === bp[ i ] ) { + i++; + } + + return i ? + + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[ i ], bp[ i ] ) : + + // Otherwise nodes in our document sort first + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + ap[ i ] == preferredDoc ? -1 : + bp[ i ] == preferredDoc ? 1 : + /* eslint-enable eqeqeq */ + 0; + }; + + return document; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + setDocument( elem ); + + if ( support.matchesSelector && documentIsHTML && + !nonnativeSelectorCache[ expr + " " ] && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch ( e ) { + nonnativeSelectorCache( expr, true ); + } + } + + return Sizzle( expr, document, null, [ elem ] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( context.ownerDocument || context ) != document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( elem.ownerDocument || elem ) != document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val !== undefined ? + val : + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; +}; + +Sizzle.escape = function( sel ) { + return ( sel + "" ).replace( rcssescape, fcssescape ); +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + // Clear input after sorting to release objects + // See https://github.com/jquery/sizzle/pull/225 + sortInput = null; + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + + // If no nodeType, this is expected to be an array + while ( ( node = elem[ i++ ] ) ) { + + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + + // Use textContent for elements + // innerText usage removed for consistency of new lines (jQuery #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[ 1 ] = match[ 1 ].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[ 3 ] = ( match[ 3 ] || match[ 4 ] || + match[ 5 ] || "" ).replace( runescape, funescape ); + + if ( match[ 2 ] === "~=" ) { + match[ 3 ] = " " + match[ 3 ] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[ 1 ] = match[ 1 ].toLowerCase(); + + if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { + + // nth-* requires argument + if ( !match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[ 4 ] = +( match[ 4 ] ? + match[ 5 ] + ( match[ 6 ] || 1 ) : + 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); + match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); + + // other types prohibit arguments + } else if ( match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[ 6 ] && match[ 2 ]; + + if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[ 3 ] ) { + match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + + // Get excess from tokenize (recursively) + ( excess = tokenize( unquoted, true ) ) && + + // advance to the next closing parenthesis + ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { + + // excess is a negative index + match[ 0 ] = match[ 0 ].slice( 0, excess ); + match[ 2 ] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { + return true; + } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + ( pattern = new RegExp( "(^|" + whitespace + + ")" + className + "(" + whitespace + "|$)" ) ) && classCache( + className, function( elem ) { + return pattern.test( + typeof elem.className === "string" && elem.className || + typeof elem.getAttribute !== "undefined" && + elem.getAttribute( "class" ) || + "" + ); + } ); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + /* eslint-disable max-len */ + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + /* eslint-enable max-len */ + + }; + }, + + "CHILD": function( type, what, _argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, _context, xml ) { + var cache, uniqueCache, outerCache, node, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType, + diff = false; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( ( node = node[ dir ] ) ) { + if ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) { + + return false; + } + } + + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + + // Seek `elem` from a previously-cached index + + // ...in a gzip-friendly way + node = parent; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex && cache[ 2 ]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( ( node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + } else { + + // Use previously-cached element index if available + if ( useCache ) { + + // ...in a gzip-friendly way + node = elem; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex; + } + + // xml :nth-child(...) + // or :nth-last-child(...) or :nth(-last)?-of-type(...) + if ( diff === false ) { + + // Use the same loop as above to seek `elem` from the start + while ( ( node = ++nodeIndex && node && node[ dir ] || + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + if ( ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) && + ++diff ) { + + // Cache the index of each encountered element + if ( useCache ) { + outerCache = node[ expando ] || + ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + uniqueCache[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction( function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf( seed, matched[ i ] ); + seed[ idx ] = !( matches[ idx ] = matched[ i ] ); + } + } ) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + + // Potentially complex pseudos + "not": markFunction( function( selector ) { + + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction( function( seed, matches, _context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( ( elem = unmatched[ i ] ) ) { + seed[ i ] = !( matches[ i ] = elem ); + } + } + } ) : + function( elem, _context, xml ) { + input[ 0 ] = elem; + matcher( input, null, xml, results ); + + // Don't keep the element (issue #299) + input[ 0 ] = null; + return !results.pop(); + }; + } ), + + "has": markFunction( function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + } ), + + "contains": markFunction( function( text ) { + text = text.replace( runescape, funescape ); + return function( elem ) { + return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; + }; + } ), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + + // lang value must be a valid identifier + if ( !ridentifier.test( lang || "" ) ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( ( elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); + return false; + }; + } ), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && + ( !document.hasFocus || document.hasFocus() ) && + !!( elem.type || elem.href || ~elem.tabIndex ); + }, + + // Boolean properties + "enabled": createDisabledPseudo( false ), + "disabled": createDisabledPseudo( true ), + + "checked": function( elem ) { + + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return ( nodeName === "input" && !!elem.checked ) || + ( nodeName === "option" && !!elem.selected ); + }, + + "selected": function( elem ) { + + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + // eslint-disable-next-line no-unused-expressions + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), + // but not by others (comment: 8; processing instruction: 7; etc.) + // nodeType < 6 works because attributes (2) do not appear as children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeType < 6 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos[ "empty" ]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + + // Support: IE<8 + // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" + ( ( attr = elem.getAttribute( "type" ) ) == null || + attr.toLowerCase() === "text" ); + }, + + // Position-in-collection + "first": createPositionalPseudo( function() { + return [ 0 ]; + } ), + + "last": createPositionalPseudo( function( _matchIndexes, length ) { + return [ length - 1 ]; + } ), + + "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + } ), + + "even": createPositionalPseudo( function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "odd": createPositionalPseudo( function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? + argument + length : + argument > length ? + length : + argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ) + } +}; + +Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +tokenize = Sizzle.tokenize = function( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || ( match = rcomma.exec( soFar ) ) ) { + if ( match ) { + + // Don't consume trailing commas as valid + soFar = soFar.slice( match[ 0 ].length ) || soFar; + } + groups.push( ( tokens = [] ) ); + } + + matched = false; + + // Combinators + if ( ( match = rcombinators.exec( soFar ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + + // Cast descendant combinators to space + type: match[ 0 ].replace( rtrim, " " ) + } ); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || + ( match = preFilters[ type ]( match ) ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + type: type, + matches: match + } ); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +}; + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[ i ].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + skip = combinator.next, + key = skip || dir, + checkNonElements = base && key === "parentNode", + doneName = done++; + + return combinator.first ? + + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + return false; + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var oldCache, uniqueCache, outerCache, + newCache = [ dirruns, doneName ]; + + // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching + if ( xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || ( elem[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ elem.uniqueID ] || + ( outerCache[ elem.uniqueID ] = {} ); + + if ( skip && skip === elem.nodeName.toLowerCase() ) { + elem = elem[ dir ] || elem; + } else if ( ( oldCache = uniqueCache[ key ] ) && + oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { + + // Assign to newCache so results back-propagate to previous elements + return ( newCache[ 2 ] = oldCache[ 2 ] ); + } else { + + // Reuse newcache so results back-propagate to previous elements + uniqueCache[ key ] = newCache; + + // A match means we're done; a fail means we have to keep checking + if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { + return true; + } + } + } + } + } + return false; + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[ i ]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[ 0 ]; +} + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[ i ], results ); + } + return results; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( ( elem = unmatched[ i ] ) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction( function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( + selector || "*", + context.nodeType ? [ context ] : context, + [] + ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( ( elem = temp[ i ] ) ) { + matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) ) { + + // Restore matcherIn since elem is not yet a final match + temp.push( ( matcherIn[ i ] = elem ) ); + } + } + postFinder( null, ( matcherOut = [] ), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) && + ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { + + seed[ temp ] = !( results[ temp ] = elem ); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + } ); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[ 0 ].type ], + implicitRelative = leadingRelative || Expr.relative[ " " ], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + ( checkContext = context ).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + + // Avoid hanging onto element (issue #299) + checkContext = null; + return ret; + } ]; + + for ( ; i < len; i++ ) { + if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { + matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; + } else { + matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[ j ].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens + .slice( 0, i - 1 ) + .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + var bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, outermost ) { + var elem, j, matcher, + matchedCount = 0, + i = "0", + unmatched = seed && [], + setMatched = [], + contextBackup = outermostContext, + + // We must always have either seed elements or outermost context + elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), + + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), + len = elems.length; + + if ( outermost ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + outermostContext = context == document || context || outermost; + } + + // Add elements passing elementMatchers directly to results + // Support: IE<9, Safari + // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id + for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( !context && elem.ownerDocument != document ) { + setDocument( elem ); + xml = !documentIsHTML; + } + while ( ( matcher = elementMatchers[ j++ ] ) ) { + if ( matcher( elem, context || document, xml ) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + + // They will have gone through all possible matchers + if ( ( elem = !matcher && elem ) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // `i` is now the count of elements visited above, and adding it to `matchedCount` + // makes the latter nonnegative. + matchedCount += i; + + // Apply set filters to unmatched elements + // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` + // equals `i`), unless we didn't visit _any_ elements in the above loop because we have + // no element matchers and no seed. + // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that + // case, which will result in a "00" `matchedCount` that differs from `i` but is also + // numerically zero. + if ( bySet && i !== matchedCount ) { + j = 0; + while ( ( matcher = setMatchers[ j++ ] ) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !( unmatched[ i ] || setMatched[ i ] ) ) { + setMatched[ i ] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + + // Generate a function of recursive functions that can be used to check each element + if ( !match ) { + match = tokenize( selector ); + } + i = match.length; + while ( i-- ) { + cached = matcherFromTokens( match[ i ] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( + selector, + matcherFromGroupMatchers( elementMatchers, setMatchers ) + ); + + // Save selector and tokenization + cached.selector = selector; + } + return cached; +}; + +/** + * A low-level selection function that works with Sizzle's compiled + * selector functions + * @param {String|Function} selector A selector or a pre-compiled + * selector function built with Sizzle.compile + * @param {Element} context + * @param {Array} [results] + * @param {Array} [seed] A set of elements to match against + */ +select = Sizzle.select = function( selector, context, results, seed ) { + var i, tokens, token, type, find, + compiled = typeof selector === "function" && selector, + match = !seed && tokenize( ( selector = compiled.selector || selector ) ); + + results = results || []; + + // Try to minimize operations if there is only one selector in the list and no seed + // (the latter of which guarantees us context) + if ( match.length === 1 ) { + + // Reduce context if the leading compound selector is an ID + tokens = match[ 0 ] = match[ 0 ].slice( 0 ); + if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && + context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { + + context = ( Expr.find[ "ID" ]( token.matches[ 0 ] + .replace( runescape, funescape ), context ) || [] )[ 0 ]; + if ( !context ) { + return results; + + // Precompiled matchers will still verify ancestry, so step up a level + } else if ( compiled ) { + context = context.parentNode; + } + + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[ i ]; + + // Abort if we hit a combinator + if ( Expr.relative[ ( type = token.type ) ] ) { + break; + } + if ( ( find = Expr.find[ type ] ) ) { + + // Search, expanding context for leading sibling combinators + if ( ( seed = find( + token.matches[ 0 ].replace( runescape, funescape ), + rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || + context + ) ) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + + // Compile and execute a filtering function if one is not provided + // Provide `match` to avoid retokenization if we modified the selector above + ( compiled || compile( selector, match ) )( + seed, + context, + !documentIsHTML, + results, + !context || rsibling.test( selector ) && testContext( context.parentNode ) || context + ); + return results; +}; + +// One-time assignments + +// Sort stability +support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; + +// Support: Chrome 14-35+ +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = !!hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert( function( el ) { + + // Should return 1, but returns 4 (following) + return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; +} ); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert( function( el ) { + el.innerHTML = ""; + return el.firstChild.getAttribute( "href" ) === "#"; +} ) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + } ); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert( function( el ) { + el.innerHTML = ""; + el.firstChild.setAttribute( "value", "" ); + return el.firstChild.getAttribute( "value" ) === ""; +} ) ) { + addHandle( "value", function( elem, _name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + } ); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert( function( el ) { + return el.getAttribute( "disabled" ) == null; +} ) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return elem[ name ] === true ? name.toLowerCase() : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; + } + } ); +} + +return Sizzle; + +} )( window ); + + + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; + +// Deprecated +jQuery.expr[ ":" ] = jQuery.expr.pseudos; +jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; +jQuery.escapeSelector = Sizzle.escape; + + + + +var dir = function( elem, dir, until ) { + var matched = [], + truncate = until !== undefined; + + while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { + if ( elem.nodeType === 1 ) { + if ( truncate && jQuery( elem ).is( until ) ) { + break; + } + matched.push( elem ); + } + } + return matched; +}; + + +var siblings = function( n, elem ) { + var matched = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + matched.push( n ); + } + } + + return matched; +}; + + +var rneedsContext = jQuery.expr.match.needsContext; + + + +function nodeName( elem, name ) { + + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + +} +var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); + + + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + return !!qualifier.call( elem, i, elem ) !== not; + } ); + } + + // Single element + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + } ); + } + + // Arraylike of elements (jQuery, arguments, Array) + if ( typeof qualifier !== "string" ) { + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not; + } ); + } + + // Filtered directly for both simple and complex selectors + return jQuery.filter( qualifier, elements, not ); +} + +jQuery.filter = function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + if ( elems.length === 1 && elem.nodeType === 1 ) { + return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; + } + + return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + } ) ); +}; + +jQuery.fn.extend( { + find: function( selector ) { + var i, ret, + len = this.length, + self = this; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter( function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + } ) ); + } + + ret = this.pushStack( [] ); + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + return len > 1 ? jQuery.uniqueSort( ret ) : ret; + }, + filter: function( selector ) { + return this.pushStack( winnow( this, selector || [], false ) ); + }, + not: function( selector ) { + return this.pushStack( winnow( this, selector || [], true ) ); + }, + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + } +} ); + + +// Initialize a jQuery object + + +// A central reference to the root jQuery(document) +var rootjQuery, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + // Shortcut simple #id case for speed + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, + + init = jQuery.fn.init = function( selector, context, root ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Method init() accepts an alternate rootjQuery + // so migrate can support jQuery.sub (gh-2101) + root = root || rootjQuery; + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector[ 0 ] === "<" && + selector[ selector.length - 1 ] === ">" && + selector.length >= 3 ) { + + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && ( match[ 1 ] || !context ) ) { + + // HANDLE: $(html) -> $(array) + if ( match[ 1 ] ) { + context = context instanceof jQuery ? context[ 0 ] : context; + + // Option to run scripts is true for back-compat + // Intentionally let the error be thrown if parseHTML is not present + jQuery.merge( this, jQuery.parseHTML( + match[ 1 ], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + + // Properties of context are called as methods if possible + if ( isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[ 2 ] ); + + if ( elem ) { + + // Inject the element directly into the jQuery object + this[ 0 ] = elem; + this.length = 1; + } + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || root ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this[ 0 ] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( isFunction( selector ) ) { + return root.ready !== undefined ? + root.ready( selector ) : + + // Execute immediately if ready is not present + selector( jQuery ); + } + + return jQuery.makeArray( selector, this ); + }; + +// Give the init function the jQuery prototype for later instantiation +init.prototype = jQuery.fn; + +// Initialize central reference +rootjQuery = jQuery( document ); + + +var rparentsprev = /^(?:parents|prev(?:Until|All))/, + + // Methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend( { + has: function( target ) { + var targets = jQuery( target, this ), + l = targets.length; + + return this.filter( function() { + var i = 0; + for ( ; i < l; i++ ) { + if ( jQuery.contains( this, targets[ i ] ) ) { + return true; + } + } + } ); + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + matched = [], + targets = typeof selectors !== "string" && jQuery( selectors ); + + // Positional selectors never match, since there's no _selection_ context + if ( !rneedsContext.test( selectors ) ) { + for ( ; i < l; i++ ) { + for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { + + // Always skip document fragments + if ( cur.nodeType < 11 && ( targets ? + targets.index( cur ) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector( cur, selectors ) ) ) { + + matched.push( cur ); + break; + } + } + } + } + + return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); + }, + + // Determine the position of an element within the set + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; + } + + // Index in selector + if ( typeof elem === "string" ) { + return indexOf.call( jQuery( elem ), this[ 0 ] ); + } + + // Locate the position of the desired element + return indexOf.call( this, + + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[ 0 ] : elem + ); + }, + + add: function( selector, context ) { + return this.pushStack( + jQuery.uniqueSort( + jQuery.merge( this.get(), jQuery( selector, context ) ) + ) + ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter( selector ) + ); + } +} ); + +function sibling( cur, dir ) { + while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} + return cur; +} + +jQuery.each( { + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, _i, until ) { + return dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, _i, until ) { + return dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, _i, until ) { + return dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return siblings( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return siblings( elem.firstChild ); + }, + contents: function( elem ) { + if ( elem.contentDocument != null && + + // Support: IE 11+ + // elements with no `data` attribute has an object + // `contentDocument` with a `null` prototype. + getProto( elem.contentDocument ) ) { + + return elem.contentDocument; + } + + // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only + // Treat the template element as a regular one in browsers that + // don't support it. + if ( nodeName( elem, "template" ) ) { + elem = elem.content || elem; + } + + return jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var matched = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + matched = jQuery.filter( selector, matched ); + } + + if ( this.length > 1 ) { + + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + jQuery.uniqueSort( matched ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + matched.reverse(); + } + } + + return this.pushStack( matched ); + }; +} ); +var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); + + + +// Convert String-formatted options into Object-formatted ones +function createOptions( options ) { + var object = {}; + jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { + object[ flag ] = true; + } ); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + createOptions( options ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + + // Last fire value for non-forgettable lists + memory, + + // Flag to know if list was already fired + fired, + + // Flag to prevent firing + locked, + + // Actual callback list + list = [], + + // Queue of execution data for repeatable lists + queue = [], + + // Index of currently firing callback (modified by add/remove as needed) + firingIndex = -1, + + // Fire callbacks + fire = function() { + + // Enforce single-firing + locked = locked || options.once; + + // Execute callbacks for all pending executions, + // respecting firingIndex overrides and runtime changes + fired = firing = true; + for ( ; queue.length; firingIndex = -1 ) { + memory = queue.shift(); + while ( ++firingIndex < list.length ) { + + // Run callback and check for early termination + if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && + options.stopOnFalse ) { + + // Jump to end and forget the data so .add doesn't re-fire + firingIndex = list.length; + memory = false; + } + } + } + + // Forget the data if we're done with it + if ( !options.memory ) { + memory = false; + } + + firing = false; + + // Clean up if we're done firing for good + if ( locked ) { + + // Keep an empty list if we have data for future add calls + if ( memory ) { + list = []; + + // Otherwise, this object is spent + } else { + list = ""; + } + } + }, + + // Actual Callbacks object + self = { + + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + + // If we have memory from a past run, we should fire after adding + if ( memory && !firing ) { + firingIndex = list.length - 1; + queue.push( memory ); + } + + ( function add( args ) { + jQuery.each( args, function( _, arg ) { + if ( isFunction( arg ) ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && toType( arg ) !== "string" ) { + + // Inspect recursively + add( arg ); + } + } ); + } )( arguments ); + + if ( memory && !firing ) { + fire(); + } + } + return this; + }, + + // Remove a callback from the list + remove: function() { + jQuery.each( arguments, function( _, arg ) { + var index; + while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + + // Handle firing indexes + if ( index <= firingIndex ) { + firingIndex--; + } + } + } ); + return this; + }, + + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? + jQuery.inArray( fn, list ) > -1 : + list.length > 0; + }, + + // Remove all callbacks from the list + empty: function() { + if ( list ) { + list = []; + } + return this; + }, + + // Disable .fire and .add + // Abort any current/pending executions + // Clear all callbacks and values + disable: function() { + locked = queue = []; + list = memory = ""; + return this; + }, + disabled: function() { + return !list; + }, + + // Disable .fire + // Also disable .add unless we have memory (since it would have no effect) + // Abort any pending executions + lock: function() { + locked = queue = []; + if ( !memory && !firing ) { + list = memory = ""; + } + return this; + }, + locked: function() { + return !!locked; + }, + + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( !locked ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + queue.push( args ); + if ( !firing ) { + fire(); + } + } + return this; + }, + + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + +function Identity( v ) { + return v; +} +function Thrower( ex ) { + throw ex; +} + +function adoptValue( value, resolve, reject, noValue ) { + var method; + + try { + + // Check for promise aspect first to privilege synchronous behavior + if ( value && isFunction( ( method = value.promise ) ) ) { + method.call( value ).done( resolve ).fail( reject ); + + // Other thenables + } else if ( value && isFunction( ( method = value.then ) ) ) { + method.call( value, resolve, reject ); + + // Other non-thenables + } else { + + // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: + // * false: [ value ].slice( 0 ) => resolve( value ) + // * true: [ value ].slice( 1 ) => resolve() + resolve.apply( undefined, [ value ].slice( noValue ) ); + } + + // For Promises/A+, convert exceptions into rejections + // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in + // Deferred#then to conditionally suppress rejection. + } catch ( value ) { + + // Support: Android 4.0 only + // Strict mode functions invoked without .call/.apply get global-object context + reject.apply( undefined, [ value ] ); + } +} + +jQuery.extend( { + + Deferred: function( func ) { + var tuples = [ + + // action, add listener, callbacks, + // ... .then handlers, argument index, [final state] + [ "notify", "progress", jQuery.Callbacks( "memory" ), + jQuery.Callbacks( "memory" ), 2 ], + [ "resolve", "done", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 0, "resolved" ], + [ "reject", "fail", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 1, "rejected" ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + "catch": function( fn ) { + return promise.then( null, fn ); + }, + + // Keep pipe for back-compat + pipe: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + + return jQuery.Deferred( function( newDefer ) { + jQuery.each( tuples, function( _i, tuple ) { + + // Map tuples (progress, done, fail) to arguments (done, fail, progress) + var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; + + // deferred.progress(function() { bind to newDefer or newDefer.notify }) + // deferred.done(function() { bind to newDefer or newDefer.resolve }) + // deferred.fail(function() { bind to newDefer or newDefer.reject }) + deferred[ tuple[ 1 ] ]( function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && isFunction( returned.promise ) ) { + returned.promise() + .progress( newDefer.notify ) + .done( newDefer.resolve ) + .fail( newDefer.reject ); + } else { + newDefer[ tuple[ 0 ] + "With" ]( + this, + fn ? [ returned ] : arguments + ); + } + } ); + } ); + fns = null; + } ).promise(); + }, + then: function( onFulfilled, onRejected, onProgress ) { + var maxDepth = 0; + function resolve( depth, deferred, handler, special ) { + return function() { + var that = this, + args = arguments, + mightThrow = function() { + var returned, then; + + // Support: Promises/A+ section 2.3.3.3.3 + // https://promisesaplus.com/#point-59 + // Ignore double-resolution attempts + if ( depth < maxDepth ) { + return; + } + + returned = handler.apply( that, args ); + + // Support: Promises/A+ section 2.3.1 + // https://promisesaplus.com/#point-48 + if ( returned === deferred.promise() ) { + throw new TypeError( "Thenable self-resolution" ); + } + + // Support: Promises/A+ sections 2.3.3.1, 3.5 + // https://promisesaplus.com/#point-54 + // https://promisesaplus.com/#point-75 + // Retrieve `then` only once + then = returned && + + // Support: Promises/A+ section 2.3.4 + // https://promisesaplus.com/#point-64 + // Only check objects and functions for thenability + ( typeof returned === "object" || + typeof returned === "function" ) && + returned.then; + + // Handle a returned thenable + if ( isFunction( then ) ) { + + // Special processors (notify) just wait for resolution + if ( special ) { + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ) + ); + + // Normal processors (resolve) also hook into progress + } else { + + // ...and disregard older resolution values + maxDepth++; + + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ), + resolve( maxDepth, deferred, Identity, + deferred.notifyWith ) + ); + } + + // Handle all other returned values + } else { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Identity ) { + that = undefined; + args = [ returned ]; + } + + // Process the value(s) + // Default process is resolve + ( special || deferred.resolveWith )( that, args ); + } + }, + + // Only normal processors (resolve) catch and reject exceptions + process = special ? + mightThrow : + function() { + try { + mightThrow(); + } catch ( e ) { + + if ( jQuery.Deferred.exceptionHook ) { + jQuery.Deferred.exceptionHook( e, + process.stackTrace ); + } + + // Support: Promises/A+ section 2.3.3.3.4.1 + // https://promisesaplus.com/#point-61 + // Ignore post-resolution exceptions + if ( depth + 1 >= maxDepth ) { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Thrower ) { + that = undefined; + args = [ e ]; + } + + deferred.rejectWith( that, args ); + } + } + }; + + // Support: Promises/A+ section 2.3.3.3.1 + // https://promisesaplus.com/#point-57 + // Re-resolve promises immediately to dodge false rejection from + // subsequent errors + if ( depth ) { + process(); + } else { + + // Call an optional hook to record the stack, in case of exception + // since it's otherwise lost when execution goes async + if ( jQuery.Deferred.getStackHook ) { + process.stackTrace = jQuery.Deferred.getStackHook(); + } + window.setTimeout( process ); + } + }; + } + + return jQuery.Deferred( function( newDefer ) { + + // progress_handlers.add( ... ) + tuples[ 0 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onProgress ) ? + onProgress : + Identity, + newDefer.notifyWith + ) + ); + + // fulfilled_handlers.add( ... ) + tuples[ 1 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onFulfilled ) ? + onFulfilled : + Identity + ) + ); + + // rejected_handlers.add( ... ) + tuples[ 2 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onRejected ) ? + onRejected : + Thrower + ) + ); + } ).promise(); + }, + + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 5 ]; + + // promise.progress = list.add + // promise.done = list.add + // promise.fail = list.add + promise[ tuple[ 1 ] ] = list.add; + + // Handle state + if ( stateString ) { + list.add( + function() { + + // state = "resolved" (i.e., fulfilled) + // state = "rejected" + state = stateString; + }, + + // rejected_callbacks.disable + // fulfilled_callbacks.disable + tuples[ 3 - i ][ 2 ].disable, + + // rejected_handlers.disable + // fulfilled_handlers.disable + tuples[ 3 - i ][ 3 ].disable, + + // progress_callbacks.lock + tuples[ 0 ][ 2 ].lock, + + // progress_handlers.lock + tuples[ 0 ][ 3 ].lock + ); + } + + // progress_handlers.fire + // fulfilled_handlers.fire + // rejected_handlers.fire + list.add( tuple[ 3 ].fire ); + + // deferred.notify = function() { deferred.notifyWith(...) } + // deferred.resolve = function() { deferred.resolveWith(...) } + // deferred.reject = function() { deferred.rejectWith(...) } + deferred[ tuple[ 0 ] ] = function() { + deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); + return this; + }; + + // deferred.notifyWith = list.fireWith + // deferred.resolveWith = list.fireWith + // deferred.rejectWith = list.fireWith + deferred[ tuple[ 0 ] + "With" ] = list.fireWith; + } ); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( singleValue ) { + var + + // count of uncompleted subordinates + remaining = arguments.length, + + // count of unprocessed arguments + i = remaining, + + // subordinate fulfillment data + resolveContexts = Array( i ), + resolveValues = slice.call( arguments ), + + // the primary Deferred + primary = jQuery.Deferred(), + + // subordinate callback factory + updateFunc = function( i ) { + return function( value ) { + resolveContexts[ i ] = this; + resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; + if ( !( --remaining ) ) { + primary.resolveWith( resolveContexts, resolveValues ); + } + }; + }; + + // Single- and empty arguments are adopted like Promise.resolve + if ( remaining <= 1 ) { + adoptValue( singleValue, primary.done( updateFunc( i ) ).resolve, primary.reject, + !remaining ); + + // Use .then() to unwrap secondary thenables (cf. gh-3000) + if ( primary.state() === "pending" || + isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { + + return primary.then(); + } + } + + // Multiple arguments are aggregated like Promise.all array elements + while ( i-- ) { + adoptValue( resolveValues[ i ], updateFunc( i ), primary.reject ); + } + + return primary.promise(); + } +} ); + + +// These usually indicate a programmer mistake during development, +// warn about them ASAP rather than swallowing them by default. +var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; + +jQuery.Deferred.exceptionHook = function( error, stack ) { + + // Support: IE 8 - 9 only + // Console exists when dev tools are open, which can happen at any time + if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { + window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); + } +}; + + + + +jQuery.readyException = function( error ) { + window.setTimeout( function() { + throw error; + } ); +}; + + + + +// The deferred used on DOM ready +var readyList = jQuery.Deferred(); + +jQuery.fn.ready = function( fn ) { + + readyList + .then( fn ) + + // Wrap jQuery.readyException in a function so that the lookup + // happens at the time of error handling instead of callback + // registration. + .catch( function( error ) { + jQuery.readyException( error ); + } ); + + return this; +}; + +jQuery.extend( { + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + } +} ); + +jQuery.ready.then = readyList.then; + +// The ready event handler and self cleanup method +function completed() { + document.removeEventListener( "DOMContentLoaded", completed ); + window.removeEventListener( "load", completed ); + jQuery.ready(); +} + +// Catch cases where $(document).ready() is called +// after the browser event has already occurred. +// Support: IE <=9 - 10 only +// Older IE sometimes signals "interactive" too soon +if ( document.readyState === "complete" || + ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { + + // Handle it asynchronously to allow scripts the opportunity to delay ready + window.setTimeout( jQuery.ready ); + +} else { + + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed ); +} + + + + +// Multifunctional method to get and set values of a collection +// The value/s can optionally be executed if it's a function +var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + len = elems.length, + bulk = key == null; + + // Sets many values + if ( toType( key ) === "object" ) { + chainable = true; + for ( i in key ) { + access( elems, fn, i, key[ i ], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, _key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < len; i++ ) { + fn( + elems[ i ], key, raw ? + value : + value.call( elems[ i ], i, fn( elems[ i ], key ) ) + ); + } + } + } + + if ( chainable ) { + return elems; + } + + // Gets + if ( bulk ) { + return fn.call( elems ); + } + + return len ? fn( elems[ 0 ], key ) : emptyGet; +}; + + +// Matches dashed string for camelizing +var rmsPrefix = /^-ms-/, + rdashAlpha = /-([a-z])/g; + +// Used by camelCase as callback to replace() +function fcamelCase( _all, letter ) { + return letter.toUpperCase(); +} + +// Convert dashed to camelCase; used by the css and data modules +// Support: IE <=9 - 11, Edge 12 - 15 +// Microsoft forgot to hump their vendor prefix (#9572) +function camelCase( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); +} +var acceptData = function( owner ) { + + // Accepts only: + // - Node + // - Node.ELEMENT_NODE + // - Node.DOCUMENT_NODE + // - Object + // - Any + return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); +}; + + + + +function Data() { + this.expando = jQuery.expando + Data.uid++; +} + +Data.uid = 1; + +Data.prototype = { + + cache: function( owner ) { + + // Check if the owner object already has a cache + var value = owner[ this.expando ]; + + // If not, create one + if ( !value ) { + value = {}; + + // We can accept data for non-element nodes in modern browsers, + // but we should not, see #8335. + // Always return an empty object. + if ( acceptData( owner ) ) { + + // If it is a node unlikely to be stringify-ed or looped over + // use plain assignment + if ( owner.nodeType ) { + owner[ this.expando ] = value; + + // Otherwise secure it in a non-enumerable property + // configurable must be true to allow the property to be + // deleted when data is removed + } else { + Object.defineProperty( owner, this.expando, { + value: value, + configurable: true + } ); + } + } + } + + return value; + }, + set: function( owner, data, value ) { + var prop, + cache = this.cache( owner ); + + // Handle: [ owner, key, value ] args + // Always use camelCase key (gh-2257) + if ( typeof data === "string" ) { + cache[ camelCase( data ) ] = value; + + // Handle: [ owner, { properties } ] args + } else { + + // Copy the properties one-by-one to the cache object + for ( prop in data ) { + cache[ camelCase( prop ) ] = data[ prop ]; + } + } + return cache; + }, + get: function( owner, key ) { + return key === undefined ? + this.cache( owner ) : + + // Always use camelCase key (gh-2257) + owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; + }, + access: function( owner, key, value ) { + + // In cases where either: + // + // 1. No key was specified + // 2. A string key was specified, but no value provided + // + // Take the "read" path and allow the get method to determine + // which value to return, respectively either: + // + // 1. The entire cache object + // 2. The data stored at the key + // + if ( key === undefined || + ( ( key && typeof key === "string" ) && value === undefined ) ) { + + return this.get( owner, key ); + } + + // When the key is not a string, or both a key and value + // are specified, set or extend (existing objects) with either: + // + // 1. An object of properties + // 2. A key and value + // + this.set( owner, key, value ); + + // Since the "set" path can have two possible entry points + // return the expected data based on which path was taken[*] + return value !== undefined ? value : key; + }, + remove: function( owner, key ) { + var i, + cache = owner[ this.expando ]; + + if ( cache === undefined ) { + return; + } + + if ( key !== undefined ) { + + // Support array or space separated string of keys + if ( Array.isArray( key ) ) { + + // If key is an array of keys... + // We always set camelCase keys, so remove that. + key = key.map( camelCase ); + } else { + key = camelCase( key ); + + // If a key with the spaces exists, use it. + // Otherwise, create an array by matching non-whitespace + key = key in cache ? + [ key ] : + ( key.match( rnothtmlwhite ) || [] ); + } + + i = key.length; + + while ( i-- ) { + delete cache[ key[ i ] ]; + } + } + + // Remove the expando if there's no more data + if ( key === undefined || jQuery.isEmptyObject( cache ) ) { + + // Support: Chrome <=35 - 45 + // Webkit & Blink performance suffers when deleting properties + // from DOM nodes, so set to undefined instead + // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) + if ( owner.nodeType ) { + owner[ this.expando ] = undefined; + } else { + delete owner[ this.expando ]; + } + } + }, + hasData: function( owner ) { + var cache = owner[ this.expando ]; + return cache !== undefined && !jQuery.isEmptyObject( cache ); + } +}; +var dataPriv = new Data(); + +var dataUser = new Data(); + + + +// Implementation Summary +// +// 1. Enforce API surface and semantic compatibility with 1.9.x branch +// 2. Improve the module's maintainability by reducing the storage +// paths to a single mechanism. +// 3. Use the same single mechanism to support "private" and "user" data. +// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) +// 5. Avoid exposing implementation details on user objects (eg. expando properties) +// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 + +var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, + rmultiDash = /[A-Z]/g; + +function getData( data ) { + if ( data === "true" ) { + return true; + } + + if ( data === "false" ) { + return false; + } + + if ( data === "null" ) { + return null; + } + + // Only convert to a number if it doesn't change the string + if ( data === +data + "" ) { + return +data; + } + + if ( rbrace.test( data ) ) { + return JSON.parse( data ); + } + + return data; +} + +function dataAttr( elem, key, data ) { + var name; + + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = getData( data ); + } catch ( e ) {} + + // Make sure we set the data so it isn't changed later + dataUser.set( elem, key, data ); + } else { + data = undefined; + } + } + return data; +} + +jQuery.extend( { + hasData: function( elem ) { + return dataUser.hasData( elem ) || dataPriv.hasData( elem ); + }, + + data: function( elem, name, data ) { + return dataUser.access( elem, name, data ); + }, + + removeData: function( elem, name ) { + dataUser.remove( elem, name ); + }, + + // TODO: Now that all calls to _data and _removeData have been replaced + // with direct calls to dataPriv methods, these can be deprecated. + _data: function( elem, name, data ) { + return dataPriv.access( elem, name, data ); + }, + + _removeData: function( elem, name ) { + dataPriv.remove( elem, name ); + } +} ); + +jQuery.fn.extend( { + data: function( key, value ) { + var i, name, data, + elem = this[ 0 ], + attrs = elem && elem.attributes; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = dataUser.get( elem ); + + if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { + i = attrs.length; + while ( i-- ) { + + // Support: IE 11 only + // The attrs elements can be null (#14894) + if ( attrs[ i ] ) { + name = attrs[ i ].name; + if ( name.indexOf( "data-" ) === 0 ) { + name = camelCase( name.slice( 5 ) ); + dataAttr( elem, name, data[ name ] ); + } + } + } + dataPriv.set( elem, "hasDataAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each( function() { + dataUser.set( this, key ); + } ); + } + + return access( this, function( value ) { + var data; + + // The calling jQuery object (element matches) is not empty + // (and therefore has an element appears at this[ 0 ]) and the + // `value` parameter was not undefined. An empty jQuery object + // will result in `undefined` for elem = this[ 0 ] which will + // throw an exception if an attempt to read a data cache is made. + if ( elem && value === undefined ) { + + // Attempt to get data from the cache + // The key will always be camelCased in Data + data = dataUser.get( elem, key ); + if ( data !== undefined ) { + return data; + } + + // Attempt to "discover" the data in + // HTML5 custom data-* attrs + data = dataAttr( elem, key ); + if ( data !== undefined ) { + return data; + } + + // We tried really hard, but the data doesn't exist. + return; + } + + // Set the data... + this.each( function() { + + // We always store the camelCased key + dataUser.set( this, key, value ); + } ); + }, null, value, arguments.length > 1, null, true ); + }, + + removeData: function( key ) { + return this.each( function() { + dataUser.remove( this, key ); + } ); + } +} ); + + +jQuery.extend( { + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = dataPriv.get( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || Array.isArray( data ) ) { + queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // Clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // Not public - generate a queueHooks object, or return the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { + empty: jQuery.Callbacks( "once memory" ).add( function() { + dataPriv.remove( elem, [ type + "queue", key ] ); + } ) + } ); + } +} ); + +jQuery.fn.extend( { + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[ 0 ], type ); + } + + return data === undefined ? + this : + this.each( function() { + var queue = jQuery.queue( this, type, data ); + + // Ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + } ); + }, + dequeue: function( type ) { + return this.each( function() { + jQuery.dequeue( this, type ); + } ); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while ( i-- ) { + tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +} ); +var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; + +var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); + + +var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; + +var documentElement = document.documentElement; + + + + var isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ); + }, + composed = { composed: true }; + + // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only + // Check attachment across shadow DOM boundaries when possible (gh-3504) + // Support: iOS 10.0-10.2 only + // Early iOS 10 versions support `attachShadow` but not `getRootNode`, + // leading to errors. We need to check for `getRootNode`. + if ( documentElement.getRootNode ) { + isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ) || + elem.getRootNode( composed ) === elem.ownerDocument; + }; + } +var isHiddenWithinTree = function( elem, el ) { + + // isHiddenWithinTree might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + + // Inline style trumps all + return elem.style.display === "none" || + elem.style.display === "" && + + // Otherwise, check computed style + // Support: Firefox <=43 - 45 + // Disconnected elements can have computed display: none, so first confirm that elem is + // in the document. + isAttached( elem ) && + + jQuery.css( elem, "display" ) === "none"; + }; + + + +function adjustCSS( elem, prop, valueParts, tween ) { + var adjusted, scale, + maxIterations = 20, + currentValue = tween ? + function() { + return tween.cur(); + } : + function() { + return jQuery.css( elem, prop, "" ); + }, + initial = currentValue(), + unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), + + // Starting value computation is required for potential unit mismatches + initialInUnit = elem.nodeType && + ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && + rcssNum.exec( jQuery.css( elem, prop ) ); + + if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { + + // Support: Firefox <=54 + // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) + initial = initial / 2; + + // Trust units reported by jQuery.css + unit = unit || initialInUnit[ 3 ]; + + // Iteratively approximate from a nonzero starting point + initialInUnit = +initial || 1; + + while ( maxIterations-- ) { + + // Evaluate and update our best guess (doubling guesses that zero out). + // Finish if the scale equals or crosses 1 (making the old*new product non-positive). + jQuery.style( elem, prop, initialInUnit + unit ); + if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { + maxIterations = 0; + } + initialInUnit = initialInUnit / scale; + + } + + initialInUnit = initialInUnit * 2; + jQuery.style( elem, prop, initialInUnit + unit ); + + // Make sure we update the tween properties later on + valueParts = valueParts || []; + } + + if ( valueParts ) { + initialInUnit = +initialInUnit || +initial || 0; + + // Apply relative offset (+=/-=) if specified + adjusted = valueParts[ 1 ] ? + initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : + +valueParts[ 2 ]; + if ( tween ) { + tween.unit = unit; + tween.start = initialInUnit; + tween.end = adjusted; + } + } + return adjusted; +} + + +var defaultDisplayMap = {}; + +function getDefaultDisplay( elem ) { + var temp, + doc = elem.ownerDocument, + nodeName = elem.nodeName, + display = defaultDisplayMap[ nodeName ]; + + if ( display ) { + return display; + } + + temp = doc.body.appendChild( doc.createElement( nodeName ) ); + display = jQuery.css( temp, "display" ); + + temp.parentNode.removeChild( temp ); + + if ( display === "none" ) { + display = "block"; + } + defaultDisplayMap[ nodeName ] = display; + + return display; +} + +function showHide( elements, show ) { + var display, elem, + values = [], + index = 0, + length = elements.length; + + // Determine new display value for elements that need to change + for ( ; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + + display = elem.style.display; + if ( show ) { + + // Since we force visibility upon cascade-hidden elements, an immediate (and slow) + // check is required in this first loop unless we have a nonempty display value (either + // inline or about-to-be-restored) + if ( display === "none" ) { + values[ index ] = dataPriv.get( elem, "display" ) || null; + if ( !values[ index ] ) { + elem.style.display = ""; + } + } + if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { + values[ index ] = getDefaultDisplay( elem ); + } + } else { + if ( display !== "none" ) { + values[ index ] = "none"; + + // Remember what we're overwriting + dataPriv.set( elem, "display", display ); + } + } + } + + // Set the display of the elements in a second loop to avoid constant reflow + for ( index = 0; index < length; index++ ) { + if ( values[ index ] != null ) { + elements[ index ].style.display = values[ index ]; + } + } + + return elements; +} + +jQuery.fn.extend( { + show: function() { + return showHide( this, true ); + }, + hide: function() { + return showHide( this ); + }, + toggle: function( state ) { + if ( typeof state === "boolean" ) { + return state ? this.show() : this.hide(); + } + + return this.each( function() { + if ( isHiddenWithinTree( this ) ) { + jQuery( this ).show(); + } else { + jQuery( this ).hide(); + } + } ); + } +} ); +var rcheckableType = ( /^(?:checkbox|radio)$/i ); + +var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); + +var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); + + + +( function() { + var fragment = document.createDocumentFragment(), + div = fragment.appendChild( document.createElement( "div" ) ), + input = document.createElement( "input" ); + + // Support: Android 4.0 - 4.3 only + // Check state lost if the name is set (#11217) + // Support: Windows Web Apps (WWA) + // `name` and `type` must use .setAttribute for WWA (#14901) + input.setAttribute( "type", "radio" ); + input.setAttribute( "checked", "checked" ); + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + + // Support: Android <=4.1 only + // Older WebKit doesn't clone checked state correctly in fragments + support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE <=11 only + // Make sure textarea (and checkbox) defaultValue is properly cloned + div.innerHTML = ""; + support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; + + // Support: IE <=9 only + // IE <=9 replaces "; + support.option = !!div.lastChild; +} )(); + + +// We have to close these tags to support XHTML (#13200) +var wrapMap = { + + // XHTML parsers do not magically insert elements in the + // same way that tag soup parsers do. So we cannot shorten + // this by omitting or other required elements. + thead: [ 1, "", "
" ], + col: [ 2, "", "
" ], + tr: [ 2, "", "
" ], + td: [ 3, "", "
" ], + + _default: [ 0, "", "" ] +}; + +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +// Support: IE <=9 only +if ( !support.option ) { + wrapMap.optgroup = wrapMap.option = [ 1, "" ]; +} + + +function getAll( context, tag ) { + + // Support: IE <=9 - 11 only + // Use typeof to avoid zero-argument method invocation on host objects (#15151) + var ret; + + if ( typeof context.getElementsByTagName !== "undefined" ) { + ret = context.getElementsByTagName( tag || "*" ); + + } else if ( typeof context.querySelectorAll !== "undefined" ) { + ret = context.querySelectorAll( tag || "*" ); + + } else { + ret = []; + } + + if ( tag === undefined || tag && nodeName( context, tag ) ) { + return jQuery.merge( [ context ], ret ); + } + + return ret; +} + + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + dataPriv.set( + elems[ i ], + "globalEval", + !refElements || dataPriv.get( refElements[ i ], "globalEval" ) + ); + } +} + + +var rhtml = /<|&#?\w+;/; + +function buildFragment( elems, context, scripts, selection, ignored ) { + var elem, tmp, tag, wrap, attached, j, + fragment = context.createDocumentFragment(), + nodes = [], + i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( toType( elem ) === "object" ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); + + // Deserialize a standard representation + tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; + + // Descend through wrappers to the right content + j = wrap[ 0 ]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, tmp.childNodes ); + + // Remember the top-level container + tmp = fragment.firstChild; + + // Ensure the created nodes are orphaned (#12392) + tmp.textContent = ""; + } + } + } + + // Remove wrapper from fragment + fragment.textContent = ""; + + i = 0; + while ( ( elem = nodes[ i++ ] ) ) { + + // Skip elements already in the context collection (trac-4087) + if ( selection && jQuery.inArray( elem, selection ) > -1 ) { + if ( ignored ) { + ignored.push( elem ); + } + continue; + } + + attached = isAttached( elem ); + + // Append to fragment + tmp = getAll( fragment.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( attached ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( ( elem = tmp[ j++ ] ) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + return fragment; +} + + +var rtypenamespace = /^([^.]*)(?:\.(.+)|)/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +// Support: IE <=9 - 11+ +// focus() and blur() are asynchronous, except when they are no-op. +// So expect focus to be synchronous when the element is already active, +// and blur to be synchronous when the element is not already active. +// (focus and blur are always synchronous in other supported browsers, +// this just defines when we can count on it). +function expectSync( elem, type ) { + return ( elem === safeActiveElement() ) === ( type === "focus" ); +} + +// Support: IE <=9 only +// Accessing document.activeElement can throw unexpectedly +// https://bugs.jquery.com/ticket/13393 +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +function on( elem, types, selector, data, fn, one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + on( elem, type, selector, data, types[ type ], one ); + } + return elem; + } + + if ( data == null && fn == null ) { + + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return elem; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return elem.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + } ); +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + + var handleObjIn, eventHandle, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.get( elem ); + + // Only attach events to objects that accept data + if ( !acceptData( elem ) ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Ensure that invalid selectors throw exceptions at attach time + // Evaluate against documentElement in case elem is a non-element node (e.g., document) + if ( selector ) { + jQuery.find.matchesSelector( documentElement, selector ); + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !( events = elemData.events ) ) { + events = elemData.events = Object.create( null ); + } + if ( !( eventHandle = elemData.handle ) ) { + eventHandle = elemData.handle = function( e ) { + + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? + jQuery.event.dispatch.apply( elem, arguments ) : undefined; + }; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend( { + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join( "." ) + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !( handlers = events[ type ] ) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener if the special events handler returns false + if ( !special.setup || + special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var j, origCount, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); + + if ( !elemData || !( events = elemData.events ) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[ 2 ] && + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || + selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || + special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove data and the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + dataPriv.remove( elem, "handle events" ); + } + }, + + dispatch: function( nativeEvent ) { + + var i, j, ret, matched, handleObj, handlerQueue, + args = new Array( arguments.length ), + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( nativeEvent ), + + handlers = ( + dataPriv.get( this, "events" ) || Object.create( null ) + )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[ 0 ] = event; + + for ( i = 1; i < arguments.length; i++ ) { + args[ i ] = arguments[ i ]; + } + + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( ( handleObj = matched.handlers[ j++ ] ) && + !event.isImmediatePropagationStopped() ) { + + // If the event is namespaced, then each handler is only invoked if it is + // specially universal or its namespaces are a superset of the event's. + if ( !event.rnamespace || handleObj.namespace === false || + event.rnamespace.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || + handleObj.handler ).apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( ( event.result = ret ) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var i, handleObj, sel, matchedHandlers, matchedSelectors, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + if ( delegateCount && + + // Support: IE <=9 + // Black-hole SVG instance trees (trac-13180) + cur.nodeType && + + // Support: Firefox <=42 + // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) + // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click + // Support: IE 11 only + // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) + !( event.type === "click" && event.button >= 1 ) ) { + + for ( ; cur !== this; cur = cur.parentNode || this ) { + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { + matchedHandlers = []; + matchedSelectors = {}; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matchedSelectors[ sel ] === undefined ) { + matchedSelectors[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) > -1 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matchedSelectors[ sel ] ) { + matchedHandlers.push( handleObj ); + } + } + if ( matchedHandlers.length ) { + handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); + } + } + } + } + + // Add the remaining (directly-bound) handlers + cur = this; + if ( delegateCount < handlers.length ) { + handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); + } + + return handlerQueue; + }, + + addProp: function( name, hook ) { + Object.defineProperty( jQuery.Event.prototype, name, { + enumerable: true, + configurable: true, + + get: isFunction( hook ) ? + function() { + if ( this.originalEvent ) { + return hook( this.originalEvent ); + } + } : + function() { + if ( this.originalEvent ) { + return this.originalEvent[ name ]; + } + }, + + set: function( value ) { + Object.defineProperty( this, name, { + enumerable: true, + configurable: true, + writable: true, + value: value + } ); + } + } ); + }, + + fix: function( originalEvent ) { + return originalEvent[ jQuery.expando ] ? + originalEvent : + new jQuery.Event( originalEvent ); + }, + + special: { + load: { + + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + click: { + + // Utilize native event to ensure correct state for checkable inputs + setup: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Claim the first handler + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + // dataPriv.set( el, "click", ... ) + leverageNative( el, "click", returnTrue ); + } + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Force setup before triggering a click + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + leverageNative( el, "click" ); + } + + // Return non-false to allow normal event-path propagation + return true; + }, + + // For cross-browser consistency, suppress native .click() on links + // Also prevent it if we're currently inside a leveraged native-event stack + _default: function( event ) { + var target = event.target; + return rcheckableType.test( target.type ) && + target.click && nodeName( target, "input" ) && + dataPriv.get( target, "click" ) || + nodeName( target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Support: Firefox 20+ + // Firefox doesn't alert if the returnValue field is not set. + if ( event.result !== undefined && event.originalEvent ) { + event.originalEvent.returnValue = event.result; + } + } + } + } +}; + +// Ensure the presence of an event listener that handles manually-triggered +// synthetic events by interrupting progress until reinvoked in response to +// *native* events that it fires directly, ensuring that state changes have +// already occurred before other listeners are invoked. +function leverageNative( el, type, expectSync ) { + + // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add + if ( !expectSync ) { + if ( dataPriv.get( el, type ) === undefined ) { + jQuery.event.add( el, type, returnTrue ); + } + return; + } + + // Register the controller as a special universal handler for all event namespaces + dataPriv.set( el, type, false ); + jQuery.event.add( el, type, { + namespace: false, + handler: function( event ) { + var notAsync, result, + saved = dataPriv.get( this, type ); + + if ( ( event.isTrigger & 1 ) && this[ type ] ) { + + // Interrupt processing of the outer synthetic .trigger()ed event + // Saved data should be false in such cases, but might be a leftover capture object + // from an async native handler (gh-4350) + if ( !saved.length ) { + + // Store arguments for use when handling the inner native event + // There will always be at least one argument (an event object), so this array + // will not be confused with a leftover capture object. + saved = slice.call( arguments ); + dataPriv.set( this, type, saved ); + + // Trigger the native event and capture its result + // Support: IE <=9 - 11+ + // focus() and blur() are asynchronous + notAsync = expectSync( this, type ); + this[ type ](); + result = dataPriv.get( this, type ); + if ( saved !== result || notAsync ) { + dataPriv.set( this, type, false ); + } else { + result = {}; + } + if ( saved !== result ) { + + // Cancel the outer synthetic event + event.stopImmediatePropagation(); + event.preventDefault(); + + // Support: Chrome 86+ + // In Chrome, if an element having a focusout handler is blurred by + // clicking outside of it, it invokes the handler synchronously. If + // that handler calls `.remove()` on the element, the data is cleared, + // leaving `result` undefined. We need to guard against this. + return result && result.value; + } + + // If this is an inner synthetic event for an event with a bubbling surrogate + // (focus or blur), assume that the surrogate already propagated from triggering the + // native event and prevent that from happening again here. + // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the + // bubbling surrogate propagates *after* the non-bubbling base), but that seems + // less bad than duplication. + } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { + event.stopPropagation(); + } + + // If this is a native event triggered above, everything is now in order + // Fire an inner synthetic event with the original arguments + } else if ( saved.length ) { + + // ...and capture the result + dataPriv.set( this, type, { + value: jQuery.event.trigger( + + // Support: IE <=9 - 11+ + // Extend with the prototype to reset the above stopImmediatePropagation() + jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), + saved.slice( 1 ), + this + ) + } ); + + // Abort handling of the native event + event.stopImmediatePropagation(); + } + } + } ); +} + +jQuery.removeEvent = function( elem, type, handle ) { + + // This "if" is needed for plain objects + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle ); + } +}; + +jQuery.Event = function( src, props ) { + + // Allow instantiation without the 'new' keyword + if ( !( this instanceof jQuery.Event ) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = src.defaultPrevented || + src.defaultPrevented === undefined && + + // Support: Android <=2.3 only + src.returnValue === false ? + returnTrue : + returnFalse; + + // Create target properties + // Support: Safari <=6 - 7 only + // Target should not be a text node (#504, #13143) + this.target = ( src.target && src.target.nodeType === 3 ) ? + src.target.parentNode : + src.target; + + this.currentTarget = src.currentTarget; + this.relatedTarget = src.relatedTarget; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || Date.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + constructor: jQuery.Event, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + isSimulated: false, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + + if ( e && !this.isSimulated ) { + e.preventDefault(); + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopPropagation(); + } + }, + stopImmediatePropagation: function() { + var e = this.originalEvent; + + this.isImmediatePropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopImmediatePropagation(); + } + + this.stopPropagation(); + } +}; + +// Includes all common event props including KeyEvent and MouseEvent specific props +jQuery.each( { + altKey: true, + bubbles: true, + cancelable: true, + changedTouches: true, + ctrlKey: true, + detail: true, + eventPhase: true, + metaKey: true, + pageX: true, + pageY: true, + shiftKey: true, + view: true, + "char": true, + code: true, + charCode: true, + key: true, + keyCode: true, + button: true, + buttons: true, + clientX: true, + clientY: true, + offsetX: true, + offsetY: true, + pointerId: true, + pointerType: true, + screenX: true, + screenY: true, + targetTouches: true, + toElement: true, + touches: true, + which: true +}, jQuery.event.addProp ); + +jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { + jQuery.event.special[ type ] = { + + // Utilize native event if possible so blur/focus sequence is correct + setup: function() { + + // Claim the first handler + // dataPriv.set( this, "focus", ... ) + // dataPriv.set( this, "blur", ... ) + leverageNative( this, type, expectSync ); + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function() { + + // Force setup before trigger + leverageNative( this, type ); + + // Return non-false to allow normal event-path propagation + return true; + }, + + // Suppress native focus or blur as it's already being fired + // in leverageNative. + _default: function() { + return true; + }, + + delegateType: delegateType + }; +} ); + +// Create mouseenter/leave events using mouseover/out and event-time checks +// so that event delegation works in jQuery. +// Do the same for pointerenter/pointerleave and pointerover/pointerout +// +// Support: Safari 7 only +// Safari sends mouseenter too often; see: +// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 +// for the description of the bug (it existed in older Chrome versions as well). +jQuery.each( { + mouseenter: "mouseover", + mouseleave: "mouseout", + pointerenter: "pointerover", + pointerleave: "pointerout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mouseenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +} ); + +jQuery.fn.extend( { + + on: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn ); + }, + one: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? + handleObj.origType + "." + handleObj.namespace : + handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each( function() { + jQuery.event.remove( this, types, fn, selector ); + } ); + } +} ); + + +var + + // Support: IE <=10 - 11, Edge 12 - 13 only + // In IE/Edge using regex groups here causes severe slowdowns. + // See https://connect.microsoft.com/IE/feedback/details/1736512/ + rnoInnerhtml = /\s*$/g; + +// Prefer a tbody over its parent table for containing new rows +function manipulationTarget( elem, content ) { + if ( nodeName( elem, "table" ) && + nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { + + return jQuery( elem ).children( "tbody" )[ 0 ] || elem; + } + + return elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { + elem.type = elem.type.slice( 5 ); + } else { + elem.removeAttribute( "type" ); + } + + return elem; +} + +function cloneCopyEvent( src, dest ) { + var i, l, type, pdataOld, udataOld, udataCur, events; + + if ( dest.nodeType !== 1 ) { + return; + } + + // 1. Copy private data: events, handlers, etc. + if ( dataPriv.hasData( src ) ) { + pdataOld = dataPriv.get( src ); + events = pdataOld.events; + + if ( events ) { + dataPriv.remove( dest, "handle events" ); + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + } + + // 2. Copy user data + if ( dataUser.hasData( src ) ) { + udataOld = dataUser.access( src ); + udataCur = jQuery.extend( {}, udataOld ); + + dataUser.set( dest, udataCur ); + } +} + +// Fix IE bugs, see support tests +function fixInput( src, dest ) { + var nodeName = dest.nodeName.toLowerCase(); + + // Fails to persist the checked state of a cloned checkbox or radio button. + if ( nodeName === "input" && rcheckableType.test( src.type ) ) { + dest.checked = src.checked; + + // Fails to return the selected option to the default selected state when cloning options + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +function domManip( collection, args, callback, ignored ) { + + // Flatten any nested arrays + args = flat( args ); + + var fragment, first, scripts, hasScripts, node, doc, + i = 0, + l = collection.length, + iNoClone = l - 1, + value = args[ 0 ], + valueIsFunction = isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( valueIsFunction || + ( l > 1 && typeof value === "string" && + !support.checkClone && rchecked.test( value ) ) ) { + return collection.each( function( index ) { + var self = collection.eq( index ); + if ( valueIsFunction ) { + args[ 0 ] = value.call( this, index, self.html() ); + } + domManip( self, args, callback, ignored ); + } ); + } + + if ( l ) { + fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + // Require either new content or an interest in ignored elements to invoke the callback + if ( first || ignored ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item + // instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( collection[ i ], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !dataPriv.access( node, "globalEval" ) && + jQuery.contains( doc, node ) ) { + + if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { + + // Optional AJAX dependency, but won't run scripts if not present + if ( jQuery._evalUrl && !node.noModule ) { + jQuery._evalUrl( node.src, { + nonce: node.nonce || node.getAttribute( "nonce" ) + }, doc ); + } + } else { + DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); + } + } + } + } + } + } + + return collection; +} + +function remove( elem, selector, keepData ) { + var node, + nodes = selector ? jQuery.filter( selector, elem ) : elem, + i = 0; + + for ( ; ( node = nodes[ i ] ) != null; i++ ) { + if ( !keepData && node.nodeType === 1 ) { + jQuery.cleanData( getAll( node ) ); + } + + if ( node.parentNode ) { + if ( keepData && isAttached( node ) ) { + setGlobalEval( getAll( node, "script" ) ); + } + node.parentNode.removeChild( node ); + } + } + + return elem; +} + +jQuery.extend( { + htmlPrefilter: function( html ) { + return html; + }, + + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var i, l, srcElements, destElements, + clone = elem.cloneNode( true ), + inPage = isAttached( elem ); + + // Fix IE cloning issues + if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && + !jQuery.isXMLDoc( elem ) ) { + + // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + fixInput( srcElements[ i ], destElements[ i ] ); + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + cloneCopyEvent( srcElements[ i ], destElements[ i ] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + // Return the cloned set + return clone; + }, + + cleanData: function( elems ) { + var data, elem, type, + special = jQuery.event.special, + i = 0; + + for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { + if ( acceptData( elem ) ) { + if ( ( data = elem[ dataPriv.expando ] ) ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataPriv.expando ] = undefined; + } + if ( elem[ dataUser.expando ] ) { + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataUser.expando ] = undefined; + } + } + } + } +} ); + +jQuery.fn.extend( { + detach: function( selector ) { + return remove( this, selector, true ); + }, + + remove: function( selector ) { + return remove( this, selector ); + }, + + text: function( value ) { + return access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().each( function() { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + this.textContent = value; + } + } ); + }, null, value, arguments.length ); + }, + + append: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + } ); + }, + + prepend: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + } ); + }, + + before: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + } ); + }, + + after: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + } ); + }, + + empty: function() { + var elem, + i = 0; + + for ( ; ( elem = this[ i ] ) != null; i++ ) { + if ( elem.nodeType === 1 ) { + + // Prevent memory leaks + jQuery.cleanData( getAll( elem, false ) ); + + // Remove any remaining nodes + elem.textContent = ""; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map( function() { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + } ); + }, + + html: function( value ) { + return access( this, function( value ) { + var elem = this[ 0 ] || {}, + i = 0, + l = this.length; + + if ( value === undefined && elem.nodeType === 1 ) { + return elem.innerHTML; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { + + value = jQuery.htmlPrefilter( value ); + + try { + for ( ; i < l; i++ ) { + elem = this[ i ] || {}; + + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch ( e ) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var ignored = []; + + // Make the changes, replacing each non-ignored context element with the new content + return domManip( this, arguments, function( elem ) { + var parent = this.parentNode; + + if ( jQuery.inArray( this, ignored ) < 0 ) { + jQuery.cleanData( getAll( this ) ); + if ( parent ) { + parent.replaceChild( elem, this ); + } + } + + // Force callback invocation + }, ignored ); + } +} ); + +jQuery.each( { + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1, + i = 0; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone( true ); + jQuery( insert[ i ] )[ original ]( elems ); + + // Support: Android <=4.0 only, PhantomJS 1 only + // .get() because push.apply(_, arraylike) throws on ancient WebKit + push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +} ); +var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); + +var getStyles = function( elem ) { + + // Support: IE <=11 only, Firefox <=30 (#15098, #14150) + // IE throws on elements created in popups + // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" + var view = elem.ownerDocument.defaultView; + + if ( !view || !view.opener ) { + view = window; + } + + return view.getComputedStyle( elem ); + }; + +var swap = function( elem, options, callback ) { + var ret, name, + old = {}; + + // Remember the old values, and insert the new ones + for ( name in options ) { + old[ name ] = elem.style[ name ]; + elem.style[ name ] = options[ name ]; + } + + ret = callback.call( elem ); + + // Revert the old values + for ( name in options ) { + elem.style[ name ] = old[ name ]; + } + + return ret; +}; + + +var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); + + + +( function() { + + // Executing both pixelPosition & boxSizingReliable tests require only one layout + // so they're executed at the same time to save the second computation. + function computeStyleTests() { + + // This is a singleton, we need to execute it only once + if ( !div ) { + return; + } + + container.style.cssText = "position:absolute;left:-11111px;width:60px;" + + "margin-top:1px;padding:0;border:0"; + div.style.cssText = + "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + + "margin:auto;border:1px;padding:1px;" + + "width:60%;top:1%"; + documentElement.appendChild( container ).appendChild( div ); + + var divStyle = window.getComputedStyle( div ); + pixelPositionVal = divStyle.top !== "1%"; + + // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 + reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; + + // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 + // Some styles come back with percentage values, even though they shouldn't + div.style.right = "60%"; + pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; + + // Support: IE 9 - 11 only + // Detect misreporting of content dimensions for box-sizing:border-box elements + boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; + + // Support: IE 9 only + // Detect overflow:scroll screwiness (gh-3699) + // Support: Chrome <=64 + // Don't get tricked when zoom affects offsetWidth (gh-4029) + div.style.position = "absolute"; + scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; + + documentElement.removeChild( container ); + + // Nullify the div so it wouldn't be stored in the memory and + // it will also be a sign that checks already performed + div = null; + } + + function roundPixelMeasures( measure ) { + return Math.round( parseFloat( measure ) ); + } + + var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, + reliableTrDimensionsVal, reliableMarginLeftVal, + container = document.createElement( "div" ), + div = document.createElement( "div" ); + + // Finish early in limited (non-browser) environments + if ( !div.style ) { + return; + } + + // Support: IE <=9 - 11 only + // Style of cloned element affects source element cloned (#8908) + div.style.backgroundClip = "content-box"; + div.cloneNode( true ).style.backgroundClip = ""; + support.clearCloneStyle = div.style.backgroundClip === "content-box"; + + jQuery.extend( support, { + boxSizingReliable: function() { + computeStyleTests(); + return boxSizingReliableVal; + }, + pixelBoxStyles: function() { + computeStyleTests(); + return pixelBoxStylesVal; + }, + pixelPosition: function() { + computeStyleTests(); + return pixelPositionVal; + }, + reliableMarginLeft: function() { + computeStyleTests(); + return reliableMarginLeftVal; + }, + scrollboxSize: function() { + computeStyleTests(); + return scrollboxSizeVal; + }, + + // Support: IE 9 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Behavior in IE 9 is more subtle than in newer versions & it passes + // some versions of this test; make sure not to make it pass there! + // + // Support: Firefox 70+ + // Only Firefox includes border widths + // in computed dimensions. (gh-4529) + reliableTrDimensions: function() { + var table, tr, trChild, trStyle; + if ( reliableTrDimensionsVal == null ) { + table = document.createElement( "table" ); + tr = document.createElement( "tr" ); + trChild = document.createElement( "div" ); + + table.style.cssText = "position:absolute;left:-11111px;border-collapse:separate"; + tr.style.cssText = "border:1px solid"; + + // Support: Chrome 86+ + // Height set through cssText does not get applied. + // Computed height then comes back as 0. + tr.style.height = "1px"; + trChild.style.height = "9px"; + + // Support: Android 8 Chrome 86+ + // In our bodyBackground.html iframe, + // display for all div elements is set to "inline", + // which causes a problem only in Android 8 Chrome 86. + // Ensuring the div is display: block + // gets around this issue. + trChild.style.display = "block"; + + documentElement + .appendChild( table ) + .appendChild( tr ) + .appendChild( trChild ); + + trStyle = window.getComputedStyle( tr ); + reliableTrDimensionsVal = ( parseInt( trStyle.height, 10 ) + + parseInt( trStyle.borderTopWidth, 10 ) + + parseInt( trStyle.borderBottomWidth, 10 ) ) === tr.offsetHeight; + + documentElement.removeChild( table ); + } + return reliableTrDimensionsVal; + } + } ); +} )(); + + +function curCSS( elem, name, computed ) { + var width, minWidth, maxWidth, ret, + + // Support: Firefox 51+ + // Retrieving style before computed somehow + // fixes an issue with getting wrong values + // on detached elements + style = elem.style; + + computed = computed || getStyles( elem ); + + // getPropertyValue is needed for: + // .css('filter') (IE 9 only, #12537) + // .css('--customProperty) (#3144) + if ( computed ) { + ret = computed.getPropertyValue( name ) || computed[ name ]; + + if ( ret === "" && !isAttached( elem ) ) { + ret = jQuery.style( elem, name ); + } + + // A tribute to the "awesome hack by Dean Edwards" + // Android Browser returns percentage for some values, + // but width seems to be reliably pixels. + // This is against the CSSOM draft spec: + // https://drafts.csswg.org/cssom/#resolved-values + if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { + + // Remember the original values + width = style.width; + minWidth = style.minWidth; + maxWidth = style.maxWidth; + + // Put in the new values to get a computed value out + style.minWidth = style.maxWidth = style.width = ret; + ret = computed.width; + + // Revert the changed values + style.width = width; + style.minWidth = minWidth; + style.maxWidth = maxWidth; + } + } + + return ret !== undefined ? + + // Support: IE <=9 - 11 only + // IE returns zIndex value as an integer. + ret + "" : + ret; +} + + +function addGetHookIf( conditionFn, hookFn ) { + + // Define the hook, we'll check on the first run if it's really needed. + return { + get: function() { + if ( conditionFn() ) { + + // Hook not needed (or it's not possible to use it due + // to missing dependency), remove it. + delete this.get; + return; + } + + // Hook needed; redefine it so that the support test is not executed again. + return ( this.get = hookFn ).apply( this, arguments ); + } + }; +} + + +var cssPrefixes = [ "Webkit", "Moz", "ms" ], + emptyStyle = document.createElement( "div" ).style, + vendorProps = {}; + +// Return a vendor-prefixed property or undefined +function vendorPropName( name ) { + + // Check for vendor prefixed names + var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), + i = cssPrefixes.length; + + while ( i-- ) { + name = cssPrefixes[ i ] + capName; + if ( name in emptyStyle ) { + return name; + } + } +} + +// Return a potentially-mapped jQuery.cssProps or vendor prefixed property +function finalPropName( name ) { + var final = jQuery.cssProps[ name ] || vendorProps[ name ]; + + if ( final ) { + return final; + } + if ( name in emptyStyle ) { + return name; + } + return vendorProps[ name ] = vendorPropName( name ) || name; +} + + +var + + // Swappable if display is none or starts with table + // except "table", "table-cell", or "table-caption" + // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display + rdisplayswap = /^(none|table(?!-c[ea]).+)/, + rcustomProp = /^--/, + cssShow = { position: "absolute", visibility: "hidden", display: "block" }, + cssNormalTransform = { + letterSpacing: "0", + fontWeight: "400" + }; + +function setPositiveNumber( _elem, value, subtract ) { + + // Any relative (+/-) values have already been + // normalized at this point + var matches = rcssNum.exec( value ); + return matches ? + + // Guard against undefined "subtract", e.g., when used as in cssHooks + Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : + value; +} + +function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { + var i = dimension === "width" ? 1 : 0, + extra = 0, + delta = 0; + + // Adjustment may not be necessary + if ( box === ( isBorderBox ? "border" : "content" ) ) { + return 0; + } + + for ( ; i < 4; i += 2 ) { + + // Both box models exclude margin + if ( box === "margin" ) { + delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); + } + + // If we get here with a content-box, we're seeking "padding" or "border" or "margin" + if ( !isBorderBox ) { + + // Add padding + delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + + // For "border" or "margin", add border + if ( box !== "padding" ) { + delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + + // But still keep track of it otherwise + } else { + extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + + // If we get here with a border-box (content + padding + border), we're seeking "content" or + // "padding" or "margin" + } else { + + // For "content", subtract padding + if ( box === "content" ) { + delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + } + + // For "content" or "padding", subtract border + if ( box !== "margin" ) { + delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } + } + + // Account for positive content-box scroll gutter when requested by providing computedVal + if ( !isBorderBox && computedVal >= 0 ) { + + // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border + // Assuming integer scroll gutter, subtract the rest and round down + delta += Math.max( 0, Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + computedVal - + delta - + extra - + 0.5 + + // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter + // Use an explicit zero to avoid NaN (gh-3964) + ) ) || 0; + } + + return delta; +} + +function getWidthOrHeight( elem, dimension, extra ) { + + // Start with computed style + var styles = getStyles( elem ), + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). + // Fake content-box until we know it's needed to know the true value. + boxSizingNeeded = !support.boxSizingReliable() || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + valueIsBorderBox = isBorderBox, + + val = curCSS( elem, dimension, styles ), + offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); + + // Support: Firefox <=54 + // Return a confounding non-pixel value or feign ignorance, as appropriate. + if ( rnumnonpx.test( val ) ) { + if ( !extra ) { + return val; + } + val = "auto"; + } + + + // Support: IE 9 - 11 only + // Use offsetWidth/offsetHeight for when box sizing is unreliable. + // In those cases, the computed value can be trusted to be border-box. + if ( ( !support.boxSizingReliable() && isBorderBox || + + // Support: IE 10 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Interestingly, in some cases IE 9 doesn't suffer from this issue. + !support.reliableTrDimensions() && nodeName( elem, "tr" ) || + + // Fall back to offsetWidth/offsetHeight when value is "auto" + // This happens for inline elements with no explicit setting (gh-3571) + val === "auto" || + + // Support: Android <=4.1 - 4.3 only + // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) + !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && + + // Make sure the element is visible & connected + elem.getClientRects().length ) { + + isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; + + // Where available, offsetWidth/offsetHeight approximate border box dimensions. + // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the + // retrieved value as a content box dimension. + valueIsBorderBox = offsetProp in elem; + if ( valueIsBorderBox ) { + val = elem[ offsetProp ]; + } + } + + // Normalize "" and auto + val = parseFloat( val ) || 0; + + // Adjust for the element's box model + return ( val + + boxModelAdjustment( + elem, + dimension, + extra || ( isBorderBox ? "border" : "content" ), + valueIsBorderBox, + styles, + + // Provide the current computed size to request scroll gutter calculation (gh-3589) + val + ) + ) + "px"; +} + +jQuery.extend( { + + // Add in style property hooks for overriding the default + // behavior of getting and setting a style property + cssHooks: { + opacity: { + get: function( elem, computed ) { + if ( computed ) { + + // We should always get a number back from opacity + var ret = curCSS( elem, "opacity" ); + return ret === "" ? "1" : ret; + } + } + } + }, + + // Don't automatically add "px" to these possibly-unitless properties + cssNumber: { + "animationIterationCount": true, + "columnCount": true, + "fillOpacity": true, + "flexGrow": true, + "flexShrink": true, + "fontWeight": true, + "gridArea": true, + "gridColumn": true, + "gridColumnEnd": true, + "gridColumnStart": true, + "gridRow": true, + "gridRowEnd": true, + "gridRowStart": true, + "lineHeight": true, + "opacity": true, + "order": true, + "orphans": true, + "widows": true, + "zIndex": true, + "zoom": true + }, + + // Add in properties whose names you wish to fix before + // setting or getting the value + cssProps: {}, + + // Get and set the style property on a DOM Node + style: function( elem, name, value, extra ) { + + // Don't set styles on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { + return; + } + + // Make sure that we're working with the right name + var ret, type, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ), + style = elem.style; + + // Make sure that we're working with the right name. We don't + // want to query the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Gets hook for the prefixed version, then unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // Check if we're setting a value + if ( value !== undefined ) { + type = typeof value; + + // Convert "+=" or "-=" to relative numbers (#7345) + if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { + value = adjustCSS( elem, name, ret ); + + // Fixes bug #9237 + type = "number"; + } + + // Make sure that null and NaN values aren't set (#7116) + if ( value == null || value !== value ) { + return; + } + + // If a number was passed in, add the unit (except for certain CSS properties) + // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append + // "px" to a few hardcoded values. + if ( type === "number" && !isCustomProp ) { + value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); + } + + // background-* props affect original clone's values + if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { + style[ name ] = "inherit"; + } + + // If a hook was provided, use that value, otherwise just set the specified value + if ( !hooks || !( "set" in hooks ) || + ( value = hooks.set( elem, value, extra ) ) !== undefined ) { + + if ( isCustomProp ) { + style.setProperty( name, value ); + } else { + style[ name ] = value; + } + } + + } else { + + // If a hook was provided get the non-computed value from there + if ( hooks && "get" in hooks && + ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { + + return ret; + } + + // Otherwise just get the value from the style object + return style[ name ]; + } + }, + + css: function( elem, name, extra, styles ) { + var val, num, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ); + + // Make sure that we're working with the right name. We don't + // want to modify the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Try prefixed name followed by the unprefixed name + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // If a hook was provided get the computed value from there + if ( hooks && "get" in hooks ) { + val = hooks.get( elem, true, extra ); + } + + // Otherwise, if a way to get the computed value exists, use that + if ( val === undefined ) { + val = curCSS( elem, name, styles ); + } + + // Convert "normal" to computed value + if ( val === "normal" && name in cssNormalTransform ) { + val = cssNormalTransform[ name ]; + } + + // Make numeric if forced or a qualifier was provided and val looks numeric + if ( extra === "" || extra ) { + num = parseFloat( val ); + return extra === true || isFinite( num ) ? num || 0 : val; + } + + return val; + } +} ); + +jQuery.each( [ "height", "width" ], function( _i, dimension ) { + jQuery.cssHooks[ dimension ] = { + get: function( elem, computed, extra ) { + if ( computed ) { + + // Certain elements can have dimension info if we invisibly show them + // but it must have a current display style that would benefit + return rdisplayswap.test( jQuery.css( elem, "display" ) ) && + + // Support: Safari 8+ + // Table columns in Safari have non-zero offsetWidth & zero + // getBoundingClientRect().width unless display is changed. + // Support: IE <=11 only + // Running getBoundingClientRect on a disconnected node + // in IE throws an error. + ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? + swap( elem, cssShow, function() { + return getWidthOrHeight( elem, dimension, extra ); + } ) : + getWidthOrHeight( elem, dimension, extra ); + } + }, + + set: function( elem, value, extra ) { + var matches, + styles = getStyles( elem ), + + // Only read styles.position if the test has a chance to fail + // to avoid forcing a reflow. + scrollboxSizeBuggy = !support.scrollboxSize() && + styles.position === "absolute", + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) + boxSizingNeeded = scrollboxSizeBuggy || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + subtract = extra ? + boxModelAdjustment( + elem, + dimension, + extra, + isBorderBox, + styles + ) : + 0; + + // Account for unreliable border-box dimensions by comparing offset* to computed and + // faking a content-box to get border and padding (gh-3699) + if ( isBorderBox && scrollboxSizeBuggy ) { + subtract -= Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + parseFloat( styles[ dimension ] ) - + boxModelAdjustment( elem, dimension, "border", false, styles ) - + 0.5 + ); + } + + // Convert to pixels if value adjustment is needed + if ( subtract && ( matches = rcssNum.exec( value ) ) && + ( matches[ 3 ] || "px" ) !== "px" ) { + + elem.style[ dimension ] = value; + value = jQuery.css( elem, dimension ); + } + + return setPositiveNumber( elem, value, subtract ); + } + }; +} ); + +jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, + function( elem, computed ) { + if ( computed ) { + return ( parseFloat( curCSS( elem, "marginLeft" ) ) || + elem.getBoundingClientRect().left - + swap( elem, { marginLeft: 0 }, function() { + return elem.getBoundingClientRect().left; + } ) + ) + "px"; + } + } +); + +// These hooks are used by animate to expand properties +jQuery.each( { + margin: "", + padding: "", + border: "Width" +}, function( prefix, suffix ) { + jQuery.cssHooks[ prefix + suffix ] = { + expand: function( value ) { + var i = 0, + expanded = {}, + + // Assumes a single number if not a string + parts = typeof value === "string" ? value.split( " " ) : [ value ]; + + for ( ; i < 4; i++ ) { + expanded[ prefix + cssExpand[ i ] + suffix ] = + parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; + } + + return expanded; + } + }; + + if ( prefix !== "margin" ) { + jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; + } +} ); + +jQuery.fn.extend( { + css: function( name, value ) { + return access( this, function( elem, name, value ) { + var styles, len, + map = {}, + i = 0; + + if ( Array.isArray( name ) ) { + styles = getStyles( elem ); + len = name.length; + + for ( ; i < len; i++ ) { + map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); + } + + return map; + } + + return value !== undefined ? + jQuery.style( elem, name, value ) : + jQuery.css( elem, name ); + }, name, value, arguments.length > 1 ); + } +} ); + + +function Tween( elem, options, prop, end, easing ) { + return new Tween.prototype.init( elem, options, prop, end, easing ); +} +jQuery.Tween = Tween; + +Tween.prototype = { + constructor: Tween, + init: function( elem, options, prop, end, easing, unit ) { + this.elem = elem; + this.prop = prop; + this.easing = easing || jQuery.easing._default; + this.options = options; + this.start = this.now = this.cur(); + this.end = end; + this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); + }, + cur: function() { + var hooks = Tween.propHooks[ this.prop ]; + + return hooks && hooks.get ? + hooks.get( this ) : + Tween.propHooks._default.get( this ); + }, + run: function( percent ) { + var eased, + hooks = Tween.propHooks[ this.prop ]; + + if ( this.options.duration ) { + this.pos = eased = jQuery.easing[ this.easing ]( + percent, this.options.duration * percent, 0, 1, this.options.duration + ); + } else { + this.pos = eased = percent; + } + this.now = ( this.end - this.start ) * eased + this.start; + + if ( this.options.step ) { + this.options.step.call( this.elem, this.now, this ); + } + + if ( hooks && hooks.set ) { + hooks.set( this ); + } else { + Tween.propHooks._default.set( this ); + } + return this; + } +}; + +Tween.prototype.init.prototype = Tween.prototype; + +Tween.propHooks = { + _default: { + get: function( tween ) { + var result; + + // Use a property on the element directly when it is not a DOM element, + // or when there is no matching style property that exists. + if ( tween.elem.nodeType !== 1 || + tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { + return tween.elem[ tween.prop ]; + } + + // Passing an empty string as a 3rd parameter to .css will automatically + // attempt a parseFloat and fallback to a string if the parse fails. + // Simple values such as "10px" are parsed to Float; + // complex values such as "rotate(1rad)" are returned as-is. + result = jQuery.css( tween.elem, tween.prop, "" ); + + // Empty strings, null, undefined and "auto" are converted to 0. + return !result || result === "auto" ? 0 : result; + }, + set: function( tween ) { + + // Use step hook for back compat. + // Use cssHook if its there. + // Use .style if available and use plain properties where available. + if ( jQuery.fx.step[ tween.prop ] ) { + jQuery.fx.step[ tween.prop ]( tween ); + } else if ( tween.elem.nodeType === 1 && ( + jQuery.cssHooks[ tween.prop ] || + tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { + jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); + } else { + tween.elem[ tween.prop ] = tween.now; + } + } + } +}; + +// Support: IE <=9 only +// Panic based approach to setting things on disconnected nodes +Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { + set: function( tween ) { + if ( tween.elem.nodeType && tween.elem.parentNode ) { + tween.elem[ tween.prop ] = tween.now; + } + } +}; + +jQuery.easing = { + linear: function( p ) { + return p; + }, + swing: function( p ) { + return 0.5 - Math.cos( p * Math.PI ) / 2; + }, + _default: "swing" +}; + +jQuery.fx = Tween.prototype.init; + +// Back compat <1.8 extension point +jQuery.fx.step = {}; + + + + +var + fxNow, inProgress, + rfxtypes = /^(?:toggle|show|hide)$/, + rrun = /queueHooks$/; + +function schedule() { + if ( inProgress ) { + if ( document.hidden === false && window.requestAnimationFrame ) { + window.requestAnimationFrame( schedule ); + } else { + window.setTimeout( schedule, jQuery.fx.interval ); + } + + jQuery.fx.tick(); + } +} + +// Animations created synchronously will run synchronously +function createFxNow() { + window.setTimeout( function() { + fxNow = undefined; + } ); + return ( fxNow = Date.now() ); +} + +// Generate parameters to create a standard animation +function genFx( type, includeWidth ) { + var which, + i = 0, + attrs = { height: type }; + + // If we include width, step value is 1 to do all cssExpand values, + // otherwise step value is 2 to skip over Left and Right + includeWidth = includeWidth ? 1 : 0; + for ( ; i < 4; i += 2 - includeWidth ) { + which = cssExpand[ i ]; + attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; + } + + if ( includeWidth ) { + attrs.opacity = attrs.width = type; + } + + return attrs; +} + +function createTween( value, prop, animation ) { + var tween, + collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), + index = 0, + length = collection.length; + for ( ; index < length; index++ ) { + if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { + + // We're done with this property + return tween; + } + } +} + +function defaultPrefilter( elem, props, opts ) { + var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, + isBox = "width" in props || "height" in props, + anim = this, + orig = {}, + style = elem.style, + hidden = elem.nodeType && isHiddenWithinTree( elem ), + dataShow = dataPriv.get( elem, "fxshow" ); + + // Queue-skipping animations hijack the fx hooks + if ( !opts.queue ) { + hooks = jQuery._queueHooks( elem, "fx" ); + if ( hooks.unqueued == null ) { + hooks.unqueued = 0; + oldfire = hooks.empty.fire; + hooks.empty.fire = function() { + if ( !hooks.unqueued ) { + oldfire(); + } + }; + } + hooks.unqueued++; + + anim.always( function() { + + // Ensure the complete handler is called before this completes + anim.always( function() { + hooks.unqueued--; + if ( !jQuery.queue( elem, "fx" ).length ) { + hooks.empty.fire(); + } + } ); + } ); + } + + // Detect show/hide animations + for ( prop in props ) { + value = props[ prop ]; + if ( rfxtypes.test( value ) ) { + delete props[ prop ]; + toggle = toggle || value === "toggle"; + if ( value === ( hidden ? "hide" : "show" ) ) { + + // Pretend to be hidden if this is a "show" and + // there is still data from a stopped show/hide + if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { + hidden = true; + + // Ignore all other no-op show/hide data + } else { + continue; + } + } + orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); + } + } + + // Bail out if this is a no-op like .hide().hide() + propTween = !jQuery.isEmptyObject( props ); + if ( !propTween && jQuery.isEmptyObject( orig ) ) { + return; + } + + // Restrict "overflow" and "display" styles during box animations + if ( isBox && elem.nodeType === 1 ) { + + // Support: IE <=9 - 11, Edge 12 - 15 + // Record all 3 overflow attributes because IE does not infer the shorthand + // from identically-valued overflowX and overflowY and Edge just mirrors + // the overflowX value there. + opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; + + // Identify a display type, preferring old show/hide data over the CSS cascade + restoreDisplay = dataShow && dataShow.display; + if ( restoreDisplay == null ) { + restoreDisplay = dataPriv.get( elem, "display" ); + } + display = jQuery.css( elem, "display" ); + if ( display === "none" ) { + if ( restoreDisplay ) { + display = restoreDisplay; + } else { + + // Get nonempty value(s) by temporarily forcing visibility + showHide( [ elem ], true ); + restoreDisplay = elem.style.display || restoreDisplay; + display = jQuery.css( elem, "display" ); + showHide( [ elem ] ); + } + } + + // Animate inline elements as inline-block + if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { + if ( jQuery.css( elem, "float" ) === "none" ) { + + // Restore the original display value at the end of pure show/hide animations + if ( !propTween ) { + anim.done( function() { + style.display = restoreDisplay; + } ); + if ( restoreDisplay == null ) { + display = style.display; + restoreDisplay = display === "none" ? "" : display; + } + } + style.display = "inline-block"; + } + } + } + + if ( opts.overflow ) { + style.overflow = "hidden"; + anim.always( function() { + style.overflow = opts.overflow[ 0 ]; + style.overflowX = opts.overflow[ 1 ]; + style.overflowY = opts.overflow[ 2 ]; + } ); + } + + // Implement show/hide animations + propTween = false; + for ( prop in orig ) { + + // General show/hide setup for this element animation + if ( !propTween ) { + if ( dataShow ) { + if ( "hidden" in dataShow ) { + hidden = dataShow.hidden; + } + } else { + dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); + } + + // Store hidden/visible for toggle so `.stop().toggle()` "reverses" + if ( toggle ) { + dataShow.hidden = !hidden; + } + + // Show elements before animating them + if ( hidden ) { + showHide( [ elem ], true ); + } + + /* eslint-disable no-loop-func */ + + anim.done( function() { + + /* eslint-enable no-loop-func */ + + // The final step of a "hide" animation is actually hiding the element + if ( !hidden ) { + showHide( [ elem ] ); + } + dataPriv.remove( elem, "fxshow" ); + for ( prop in orig ) { + jQuery.style( elem, prop, orig[ prop ] ); + } + } ); + } + + // Per-property setup + propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); + if ( !( prop in dataShow ) ) { + dataShow[ prop ] = propTween.start; + if ( hidden ) { + propTween.end = propTween.start; + propTween.start = 0; + } + } + } +} + +function propFilter( props, specialEasing ) { + var index, name, easing, value, hooks; + + // camelCase, specialEasing and expand cssHook pass + for ( index in props ) { + name = camelCase( index ); + easing = specialEasing[ name ]; + value = props[ index ]; + if ( Array.isArray( value ) ) { + easing = value[ 1 ]; + value = props[ index ] = value[ 0 ]; + } + + if ( index !== name ) { + props[ name ] = value; + delete props[ index ]; + } + + hooks = jQuery.cssHooks[ name ]; + if ( hooks && "expand" in hooks ) { + value = hooks.expand( value ); + delete props[ name ]; + + // Not quite $.extend, this won't overwrite existing keys. + // Reusing 'index' because we have the correct "name" + for ( index in value ) { + if ( !( index in props ) ) { + props[ index ] = value[ index ]; + specialEasing[ index ] = easing; + } + } + } else { + specialEasing[ name ] = easing; + } + } +} + +function Animation( elem, properties, options ) { + var result, + stopped, + index = 0, + length = Animation.prefilters.length, + deferred = jQuery.Deferred().always( function() { + + // Don't match elem in the :animated selector + delete tick.elem; + } ), + tick = function() { + if ( stopped ) { + return false; + } + var currentTime = fxNow || createFxNow(), + remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), + + // Support: Android 2.3 only + // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) + temp = remaining / animation.duration || 0, + percent = 1 - temp, + index = 0, + length = animation.tweens.length; + + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( percent ); + } + + deferred.notifyWith( elem, [ animation, percent, remaining ] ); + + // If there's more to do, yield + if ( percent < 1 && length ) { + return remaining; + } + + // If this was an empty animation, synthesize a final progress notification + if ( !length ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + } + + // Resolve the animation and report its conclusion + deferred.resolveWith( elem, [ animation ] ); + return false; + }, + animation = deferred.promise( { + elem: elem, + props: jQuery.extend( {}, properties ), + opts: jQuery.extend( true, { + specialEasing: {}, + easing: jQuery.easing._default + }, options ), + originalProperties: properties, + originalOptions: options, + startTime: fxNow || createFxNow(), + duration: options.duration, + tweens: [], + createTween: function( prop, end ) { + var tween = jQuery.Tween( elem, animation.opts, prop, end, + animation.opts.specialEasing[ prop ] || animation.opts.easing ); + animation.tweens.push( tween ); + return tween; + }, + stop: function( gotoEnd ) { + var index = 0, + + // If we are going to the end, we want to run all the tweens + // otherwise we skip this part + length = gotoEnd ? animation.tweens.length : 0; + if ( stopped ) { + return this; + } + stopped = true; + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( 1 ); + } + + // Resolve when we played the last frame; otherwise, reject + if ( gotoEnd ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + deferred.resolveWith( elem, [ animation, gotoEnd ] ); + } else { + deferred.rejectWith( elem, [ animation, gotoEnd ] ); + } + return this; + } + } ), + props = animation.props; + + propFilter( props, animation.opts.specialEasing ); + + for ( ; index < length; index++ ) { + result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); + if ( result ) { + if ( isFunction( result.stop ) ) { + jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = + result.stop.bind( result ); + } + return result; + } + } + + jQuery.map( props, createTween, animation ); + + if ( isFunction( animation.opts.start ) ) { + animation.opts.start.call( elem, animation ); + } + + // Attach callbacks from options + animation + .progress( animation.opts.progress ) + .done( animation.opts.done, animation.opts.complete ) + .fail( animation.opts.fail ) + .always( animation.opts.always ); + + jQuery.fx.timer( + jQuery.extend( tick, { + elem: elem, + anim: animation, + queue: animation.opts.queue + } ) + ); + + return animation; +} + +jQuery.Animation = jQuery.extend( Animation, { + + tweeners: { + "*": [ function( prop, value ) { + var tween = this.createTween( prop, value ); + adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); + return tween; + } ] + }, + + tweener: function( props, callback ) { + if ( isFunction( props ) ) { + callback = props; + props = [ "*" ]; + } else { + props = props.match( rnothtmlwhite ); + } + + var prop, + index = 0, + length = props.length; + + for ( ; index < length; index++ ) { + prop = props[ index ]; + Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; + Animation.tweeners[ prop ].unshift( callback ); + } + }, + + prefilters: [ defaultPrefilter ], + + prefilter: function( callback, prepend ) { + if ( prepend ) { + Animation.prefilters.unshift( callback ); + } else { + Animation.prefilters.push( callback ); + } + } +} ); + +jQuery.speed = function( speed, easing, fn ) { + var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { + complete: fn || !fn && easing || + isFunction( speed ) && speed, + duration: speed, + easing: fn && easing || easing && !isFunction( easing ) && easing + }; + + // Go to the end state if fx are off + if ( jQuery.fx.off ) { + opt.duration = 0; + + } else { + if ( typeof opt.duration !== "number" ) { + if ( opt.duration in jQuery.fx.speeds ) { + opt.duration = jQuery.fx.speeds[ opt.duration ]; + + } else { + opt.duration = jQuery.fx.speeds._default; + } + } + } + + // Normalize opt.queue - true/undefined/null -> "fx" + if ( opt.queue == null || opt.queue === true ) { + opt.queue = "fx"; + } + + // Queueing + opt.old = opt.complete; + + opt.complete = function() { + if ( isFunction( opt.old ) ) { + opt.old.call( this ); + } + + if ( opt.queue ) { + jQuery.dequeue( this, opt.queue ); + } + }; + + return opt; +}; + +jQuery.fn.extend( { + fadeTo: function( speed, to, easing, callback ) { + + // Show any hidden elements after setting opacity to 0 + return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() + + // Animate to the value specified + .end().animate( { opacity: to }, speed, easing, callback ); + }, + animate: function( prop, speed, easing, callback ) { + var empty = jQuery.isEmptyObject( prop ), + optall = jQuery.speed( speed, easing, callback ), + doAnimation = function() { + + // Operate on a copy of prop so per-property easing won't be lost + var anim = Animation( this, jQuery.extend( {}, prop ), optall ); + + // Empty animations, or finishing resolves immediately + if ( empty || dataPriv.get( this, "finish" ) ) { + anim.stop( true ); + } + }; + + doAnimation.finish = doAnimation; + + return empty || optall.queue === false ? + this.each( doAnimation ) : + this.queue( optall.queue, doAnimation ); + }, + stop: function( type, clearQueue, gotoEnd ) { + var stopQueue = function( hooks ) { + var stop = hooks.stop; + delete hooks.stop; + stop( gotoEnd ); + }; + + if ( typeof type !== "string" ) { + gotoEnd = clearQueue; + clearQueue = type; + type = undefined; + } + if ( clearQueue ) { + this.queue( type || "fx", [] ); + } + + return this.each( function() { + var dequeue = true, + index = type != null && type + "queueHooks", + timers = jQuery.timers, + data = dataPriv.get( this ); + + if ( index ) { + if ( data[ index ] && data[ index ].stop ) { + stopQueue( data[ index ] ); + } + } else { + for ( index in data ) { + if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { + stopQueue( data[ index ] ); + } + } + } + + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && + ( type == null || timers[ index ].queue === type ) ) { + + timers[ index ].anim.stop( gotoEnd ); + dequeue = false; + timers.splice( index, 1 ); + } + } + + // Start the next in the queue if the last step wasn't forced. + // Timers currently will call their complete callbacks, which + // will dequeue but only if they were gotoEnd. + if ( dequeue || !gotoEnd ) { + jQuery.dequeue( this, type ); + } + } ); + }, + finish: function( type ) { + if ( type !== false ) { + type = type || "fx"; + } + return this.each( function() { + var index, + data = dataPriv.get( this ), + queue = data[ type + "queue" ], + hooks = data[ type + "queueHooks" ], + timers = jQuery.timers, + length = queue ? queue.length : 0; + + // Enable finishing flag on private data + data.finish = true; + + // Empty the queue first + jQuery.queue( this, type, [] ); + + if ( hooks && hooks.stop ) { + hooks.stop.call( this, true ); + } + + // Look for any active animations, and finish them + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && timers[ index ].queue === type ) { + timers[ index ].anim.stop( true ); + timers.splice( index, 1 ); + } + } + + // Look for any animations in the old queue and finish them + for ( index = 0; index < length; index++ ) { + if ( queue[ index ] && queue[ index ].finish ) { + queue[ index ].finish.call( this ); + } + } + + // Turn off finishing flag + delete data.finish; + } ); + } +} ); + +jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { + var cssFn = jQuery.fn[ name ]; + jQuery.fn[ name ] = function( speed, easing, callback ) { + return speed == null || typeof speed === "boolean" ? + cssFn.apply( this, arguments ) : + this.animate( genFx( name, true ), speed, easing, callback ); + }; +} ); + +// Generate shortcuts for custom animations +jQuery.each( { + slideDown: genFx( "show" ), + slideUp: genFx( "hide" ), + slideToggle: genFx( "toggle" ), + fadeIn: { opacity: "show" }, + fadeOut: { opacity: "hide" }, + fadeToggle: { opacity: "toggle" } +}, function( name, props ) { + jQuery.fn[ name ] = function( speed, easing, callback ) { + return this.animate( props, speed, easing, callback ); + }; +} ); + +jQuery.timers = []; +jQuery.fx.tick = function() { + var timer, + i = 0, + timers = jQuery.timers; + + fxNow = Date.now(); + + for ( ; i < timers.length; i++ ) { + timer = timers[ i ]; + + // Run the timer and safely remove it when done (allowing for external removal) + if ( !timer() && timers[ i ] === timer ) { + timers.splice( i--, 1 ); + } + } + + if ( !timers.length ) { + jQuery.fx.stop(); + } + fxNow = undefined; +}; + +jQuery.fx.timer = function( timer ) { + jQuery.timers.push( timer ); + jQuery.fx.start(); +}; + +jQuery.fx.interval = 13; +jQuery.fx.start = function() { + if ( inProgress ) { + return; + } + + inProgress = true; + schedule(); +}; + +jQuery.fx.stop = function() { + inProgress = null; +}; + +jQuery.fx.speeds = { + slow: 600, + fast: 200, + + // Default speed + _default: 400 +}; + + +// Based off of the plugin by Clint Helfers, with permission. +// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ +jQuery.fn.delay = function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = window.setTimeout( next, time ); + hooks.stop = function() { + window.clearTimeout( timeout ); + }; + } ); +}; + + +( function() { + var input = document.createElement( "input" ), + select = document.createElement( "select" ), + opt = select.appendChild( document.createElement( "option" ) ); + + input.type = "checkbox"; + + // Support: Android <=4.3 only + // Default value for a checkbox should be "on" + support.checkOn = input.value !== ""; + + // Support: IE <=11 only + // Must access selectedIndex to make default options select + support.optSelected = opt.selected; + + // Support: IE <=11 only + // An input loses its value after becoming a radio + input = document.createElement( "input" ); + input.value = "t"; + input.type = "radio"; + support.radioValue = input.value === "t"; +} )(); + + +var boolHook, + attrHandle = jQuery.expr.attrHandle; + +jQuery.fn.extend( { + attr: function( name, value ) { + return access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each( function() { + jQuery.removeAttr( this, name ); + } ); + } +} ); + +jQuery.extend( { + attr: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set attributes on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + // Attribute hooks are determined by the lowercase version + // Grab necessary hook if one is defined + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + hooks = jQuery.attrHooks[ name.toLowerCase() ] || + ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); + } + + if ( value !== undefined ) { + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + } + + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + elem.setAttribute( name, value + "" ); + return value; + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + ret = jQuery.find.attr( elem, name ); + + // Non-existent attributes return null, we normalize to undefined + return ret == null ? undefined : ret; + }, + + attrHooks: { + type: { + set: function( elem, value ) { + if ( !support.radioValue && value === "radio" && + nodeName( elem, "input" ) ) { + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + } + }, + + removeAttr: function( elem, value ) { + var name, + i = 0, + + // Attribute names can contain non-HTML whitespace characters + // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 + attrNames = value && value.match( rnothtmlwhite ); + + if ( attrNames && elem.nodeType === 1 ) { + while ( ( name = attrNames[ i++ ] ) ) { + elem.removeAttribute( name ); + } + } + } +} ); + +// Hooks for boolean attributes +boolHook = { + set: function( elem, value, name ) { + if ( value === false ) { + + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + elem.setAttribute( name, name ); + } + return name; + } +}; + +jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { + var getter = attrHandle[ name ] || jQuery.find.attr; + + attrHandle[ name ] = function( elem, name, isXML ) { + var ret, handle, + lowercaseName = name.toLowerCase(); + + if ( !isXML ) { + + // Avoid an infinite loop by temporarily removing this function from the getter + handle = attrHandle[ lowercaseName ]; + attrHandle[ lowercaseName ] = ret; + ret = getter( elem, name, isXML ) != null ? + lowercaseName : + null; + attrHandle[ lowercaseName ] = handle; + } + return ret; + }; +} ); + + + + +var rfocusable = /^(?:input|select|textarea|button)$/i, + rclickable = /^(?:a|area)$/i; + +jQuery.fn.extend( { + prop: function( name, value ) { + return access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + return this.each( function() { + delete this[ jQuery.propFix[ name ] || name ]; + } ); + } +} ); + +jQuery.extend( { + prop: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set properties on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + return ( elem[ name ] = value ); + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + return elem[ name ]; + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + + // Support: IE <=9 - 11 only + // elem.tabIndex doesn't always return the + // correct value when it hasn't been explicitly set + // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + // Use proper attribute retrieval(#12072) + var tabindex = jQuery.find.attr( elem, "tabindex" ); + + if ( tabindex ) { + return parseInt( tabindex, 10 ); + } + + if ( + rfocusable.test( elem.nodeName ) || + rclickable.test( elem.nodeName ) && + elem.href + ) { + return 0; + } + + return -1; + } + } + }, + + propFix: { + "for": "htmlFor", + "class": "className" + } +} ); + +// Support: IE <=11 only +// Accessing the selectedIndex property +// forces the browser to respect setting selected +// on the option +// The getter ensures a default option is selected +// when in an optgroup +// eslint rule "no-unused-expressions" is disabled for this code +// since it considers such accessions noop +if ( !support.optSelected ) { + jQuery.propHooks.selected = { + get: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent && parent.parentNode ) { + parent.parentNode.selectedIndex; + } + return null; + }, + set: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent ) { + parent.selectedIndex; + + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + } + }; +} + +jQuery.each( [ + "tabIndex", + "readOnly", + "maxLength", + "cellSpacing", + "cellPadding", + "rowSpan", + "colSpan", + "useMap", + "frameBorder", + "contentEditable" +], function() { + jQuery.propFix[ this.toLowerCase() ] = this; +} ); + + + + + // Strip and collapse whitespace according to HTML spec + // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace + function stripAndCollapse( value ) { + var tokens = value.match( rnothtmlwhite ) || []; + return tokens.join( " " ); + } + + +function getClass( elem ) { + return elem.getAttribute && elem.getAttribute( "class" ) || ""; +} + +function classesToArray( value ) { + if ( Array.isArray( value ) ) { + return value; + } + if ( typeof value === "string" ) { + return value.match( rnothtmlwhite ) || []; + } + return []; +} + +jQuery.fn.extend( { + addClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + if ( cur.indexOf( " " + clazz + " " ) < 0 ) { + cur += clazz + " "; + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( !arguments.length ) { + return this.attr( "class", "" ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + + // This expression is here for better compressibility (see addClass) + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + + // Remove *all* instances + while ( cur.indexOf( " " + clazz + " " ) > -1 ) { + cur = cur.replace( " " + clazz + " ", " " ); + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value, + isValidValue = type === "string" || Array.isArray( value ); + + if ( typeof stateVal === "boolean" && isValidValue ) { + return stateVal ? this.addClass( value ) : this.removeClass( value ); + } + + if ( isFunction( value ) ) { + return this.each( function( i ) { + jQuery( this ).toggleClass( + value.call( this, i, getClass( this ), stateVal ), + stateVal + ); + } ); + } + + return this.each( function() { + var className, i, self, classNames; + + if ( isValidValue ) { + + // Toggle individual class names + i = 0; + self = jQuery( this ); + classNames = classesToArray( value ); + + while ( ( className = classNames[ i++ ] ) ) { + + // Check each className given, space separated list + if ( self.hasClass( className ) ) { + self.removeClass( className ); + } else { + self.addClass( className ); + } + } + + // Toggle whole class name + } else if ( value === undefined || type === "boolean" ) { + className = getClass( this ); + if ( className ) { + + // Store className if set + dataPriv.set( this, "__className__", className ); + } + + // If the element has a class name or if we're passed `false`, + // then remove the whole classname (if there was one, the above saved it). + // Otherwise bring back whatever was previously saved (if anything), + // falling back to the empty string if nothing was stored. + if ( this.setAttribute ) { + this.setAttribute( "class", + className || value === false ? + "" : + dataPriv.get( this, "__className__" ) || "" + ); + } + } + } ); + }, + + hasClass: function( selector ) { + var className, elem, + i = 0; + + className = " " + selector + " "; + while ( ( elem = this[ i++ ] ) ) { + if ( elem.nodeType === 1 && + ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { + return true; + } + } + + return false; + } +} ); + + + + +var rreturn = /\r/g; + +jQuery.fn.extend( { + val: function( value ) { + var hooks, ret, valueIsFunction, + elem = this[ 0 ]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || + jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && + "get" in hooks && + ( ret = hooks.get( elem, "value" ) ) !== undefined + ) { + return ret; + } + + ret = elem.value; + + // Handle most common string cases + if ( typeof ret === "string" ) { + return ret.replace( rreturn, "" ); + } + + // Handle cases where value is null/undef or number + return ret == null ? "" : ret; + } + + return; + } + + valueIsFunction = isFunction( value ); + + return this.each( function( i ) { + var val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( valueIsFunction ) { + val = value.call( this, i, jQuery( this ).val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + + } else if ( typeof val === "number" ) { + val += ""; + + } else if ( Array.isArray( val ) ) { + val = jQuery.map( val, function( value ) { + return value == null ? "" : value + ""; + } ); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + } ); + } +} ); + +jQuery.extend( { + valHooks: { + option: { + get: function( elem ) { + + var val = jQuery.find.attr( elem, "value" ); + return val != null ? + val : + + // Support: IE <=10 - 11 only + // option.text throws exceptions (#14686, #14858) + // Strip and collapse whitespace + // https://html.spec.whatwg.org/#strip-and-collapse-whitespace + stripAndCollapse( jQuery.text( elem ) ); + } + }, + select: { + get: function( elem ) { + var value, option, i, + options = elem.options, + index = elem.selectedIndex, + one = elem.type === "select-one", + values = one ? null : [], + max = one ? index + 1 : options.length; + + if ( index < 0 ) { + i = max; + + } else { + i = one ? index : 0; + } + + // Loop through all the selected options + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Support: IE <=9 only + // IE8-9 doesn't update selected after form reset (#2551) + if ( ( option.selected || i === index ) && + + // Don't return options that are disabled or in a disabled optgroup + !option.disabled && + ( !option.parentNode.disabled || + !nodeName( option.parentNode, "optgroup" ) ) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + }, + + set: function( elem, value ) { + var optionSet, option, + options = elem.options, + values = jQuery.makeArray( value ), + i = options.length; + + while ( i-- ) { + option = options[ i ]; + + /* eslint-disable no-cond-assign */ + + if ( option.selected = + jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 + ) { + optionSet = true; + } + + /* eslint-enable no-cond-assign */ + } + + // Force browsers to behave consistently when non-matching value is set + if ( !optionSet ) { + elem.selectedIndex = -1; + } + return values; + } + } + } +} ); + +// Radios and checkboxes getter/setter +jQuery.each( [ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + set: function( elem, value ) { + if ( Array.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); + } + } + }; + if ( !support.checkOn ) { + jQuery.valHooks[ this ].get = function( elem ) { + return elem.getAttribute( "value" ) === null ? "on" : elem.value; + }; + } +} ); + + + + +// Return jQuery for attributes-only inclusion + + +support.focusin = "onfocusin" in window; + + +var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + stopPropagationCallback = function( e ) { + e.stopPropagation(); + }; + +jQuery.extend( jQuery.event, { + + trigger: function( event, data, elem, onlyHandlers ) { + + var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, + eventPath = [ elem || document ], + type = hasOwn.call( event, "type" ) ? event.type : event, + namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; + + cur = lastElement = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "." ) > -1 ) { + + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split( "." ); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf( ":" ) < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join( "." ); + event.rnamespace = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === ( elem.ownerDocument || document ) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { + lastElement = cur; + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) )[ event.type ] && + dataPriv.get( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && handle.apply && acceptData( cur ) ) { + event.result = handle.apply( cur, data ); + if ( event.result === false ) { + event.preventDefault(); + } + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( ( !special._default || + special._default.apply( eventPath.pop(), data ) === false ) && + acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name as the event. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + + if ( event.isPropagationStopped() ) { + lastElement.addEventListener( type, stopPropagationCallback ); + } + + elem[ type ](); + + if ( event.isPropagationStopped() ) { + lastElement.removeEventListener( type, stopPropagationCallback ); + } + + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + // Piggyback on a donor event to simulate a different one + // Used only for `focus(in | out)` events + simulate: function( type, elem, event ) { + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true + } + ); + + jQuery.event.trigger( e, null, elem ); + } + +} ); + +jQuery.fn.extend( { + + trigger: function( type, data ) { + return this.each( function() { + jQuery.event.trigger( type, data, this ); + } ); + }, + triggerHandler: function( type, data ) { + var elem = this[ 0 ]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +} ); + + +// Support: Firefox <=44 +// Firefox doesn't have focus(in | out) events +// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 +// +// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 +// focus(in | out) events fire after focus & blur events, +// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order +// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 +if ( !support.focusin ) { + jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler on the document while someone wants focusin/focusout + var handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + + // Handle: regular nodes (via `this.ownerDocument`), window + // (via `this.document`) & document (via `this`). + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ); + + if ( !attaches ) { + doc.addEventListener( orig, handler, true ); + } + dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); + }, + teardown: function() { + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ) - 1; + + if ( !attaches ) { + doc.removeEventListener( orig, handler, true ); + dataPriv.remove( doc, fix ); + + } else { + dataPriv.access( doc, fix, attaches ); + } + } + }; + } ); +} +var location = window.location; + +var nonce = { guid: Date.now() }; + +var rquery = ( /\?/ ); + + + +// Cross-browser xml parsing +jQuery.parseXML = function( data ) { + var xml, parserErrorElem; + if ( !data || typeof data !== "string" ) { + return null; + } + + // Support: IE 9 - 11 only + // IE throws on parseFromString with invalid input. + try { + xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); + } catch ( e ) {} + + parserErrorElem = xml && xml.getElementsByTagName( "parsererror" )[ 0 ]; + if ( !xml || parserErrorElem ) { + jQuery.error( "Invalid XML: " + ( + parserErrorElem ? + jQuery.map( parserErrorElem.childNodes, function( el ) { + return el.textContent; + } ).join( "\n" ) : + data + ) ); + } + return xml; +}; + + +var + rbracket = /\[\]$/, + rCRLF = /\r?\n/g, + rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, + rsubmittable = /^(?:input|select|textarea|keygen)/i; + +function buildParams( prefix, obj, traditional, add ) { + var name; + + if ( Array.isArray( obj ) ) { + + // Serialize array item. + jQuery.each( obj, function( i, v ) { + if ( traditional || rbracket.test( prefix ) ) { + + // Treat each array item as a scalar. + add( prefix, v ); + + } else { + + // Item is non-scalar (array or object), encode its numeric index. + buildParams( + prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", + v, + traditional, + add + ); + } + } ); + + } else if ( !traditional && toType( obj ) === "object" ) { + + // Serialize object item. + for ( name in obj ) { + buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); + } + + } else { + + // Serialize scalar item. + add( prefix, obj ); + } +} + +// Serialize an array of form elements or a set of +// key/values into a query string +jQuery.param = function( a, traditional ) { + var prefix, + s = [], + add = function( key, valueOrFunction ) { + + // If value is a function, invoke it and use its return value + var value = isFunction( valueOrFunction ) ? + valueOrFunction() : + valueOrFunction; + + s[ s.length ] = encodeURIComponent( key ) + "=" + + encodeURIComponent( value == null ? "" : value ); + }; + + if ( a == null ) { + return ""; + } + + // If an array was passed in, assume that it is an array of form elements. + if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { + + // Serialize the form elements + jQuery.each( a, function() { + add( this.name, this.value ); + } ); + + } else { + + // If traditional, encode the "old" way (the way 1.3.2 or older + // did it), otherwise encode params recursively. + for ( prefix in a ) { + buildParams( prefix, a[ prefix ], traditional, add ); + } + } + + // Return the resulting serialization + return s.join( "&" ); +}; + +jQuery.fn.extend( { + serialize: function() { + return jQuery.param( this.serializeArray() ); + }, + serializeArray: function() { + return this.map( function() { + + // Can add propHook for "elements" to filter or add form elements + var elements = jQuery.prop( this, "elements" ); + return elements ? jQuery.makeArray( elements ) : this; + } ).filter( function() { + var type = this.type; + + // Use .is( ":disabled" ) so that fieldset[disabled] works + return this.name && !jQuery( this ).is( ":disabled" ) && + rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && + ( this.checked || !rcheckableType.test( type ) ); + } ).map( function( _i, elem ) { + var val = jQuery( this ).val(); + + if ( val == null ) { + return null; + } + + if ( Array.isArray( val ) ) { + return jQuery.map( val, function( val ) { + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ); + } + + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ).get(); + } +} ); + + +var + r20 = /%20/g, + rhash = /#.*$/, + rantiCache = /([?&])_=[^&]*/, + rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, + + // #7653, #8125, #8152: local protocol detection + rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, + rnoContent = /^(?:GET|HEAD)$/, + rprotocol = /^\/\//, + + /* Prefilters + * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) + * 2) These are called: + * - BEFORE asking for a transport + * - AFTER param serialization (s.data is a string if s.processData is true) + * 3) key is the dataType + * 4) the catchall symbol "*" can be used + * 5) execution will start with transport dataType and THEN continue down to "*" if needed + */ + prefilters = {}, + + /* Transports bindings + * 1) key is the dataType + * 2) the catchall symbol "*" can be used + * 3) selection will start with transport dataType and THEN go to "*" if needed + */ + transports = {}, + + // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression + allTypes = "*/".concat( "*" ), + + // Anchor tag for parsing the document origin + originAnchor = document.createElement( "a" ); + +originAnchor.href = location.href; + +// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport +function addToPrefiltersOrTransports( structure ) { + + // dataTypeExpression is optional and defaults to "*" + return function( dataTypeExpression, func ) { + + if ( typeof dataTypeExpression !== "string" ) { + func = dataTypeExpression; + dataTypeExpression = "*"; + } + + var dataType, + i = 0, + dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; + + if ( isFunction( func ) ) { + + // For each dataType in the dataTypeExpression + while ( ( dataType = dataTypes[ i++ ] ) ) { + + // Prepend if requested + if ( dataType[ 0 ] === "+" ) { + dataType = dataType.slice( 1 ) || "*"; + ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); + + // Otherwise append + } else { + ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); + } + } + } + }; +} + +// Base inspection function for prefilters and transports +function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { + + var inspected = {}, + seekingTransport = ( structure === transports ); + + function inspect( dataType ) { + var selected; + inspected[ dataType ] = true; + jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { + var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); + if ( typeof dataTypeOrTransport === "string" && + !seekingTransport && !inspected[ dataTypeOrTransport ] ) { + + options.dataTypes.unshift( dataTypeOrTransport ); + inspect( dataTypeOrTransport ); + return false; + } else if ( seekingTransport ) { + return !( selected = dataTypeOrTransport ); + } + } ); + return selected; + } + + return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); +} + +// A special extend for ajax options +// that takes "flat" options (not to be deep extended) +// Fixes #9887 +function ajaxExtend( target, src ) { + var key, deep, + flatOptions = jQuery.ajaxSettings.flatOptions || {}; + + for ( key in src ) { + if ( src[ key ] !== undefined ) { + ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; + } + } + if ( deep ) { + jQuery.extend( true, target, deep ); + } + + return target; +} + +/* Handles responses to an ajax request: + * - finds the right dataType (mediates between content-type and expected dataType) + * - returns the corresponding response + */ +function ajaxHandleResponses( s, jqXHR, responses ) { + + var ct, type, finalDataType, firstDataType, + contents = s.contents, + dataTypes = s.dataTypes; + + // Remove auto dataType and get content-type in the process + while ( dataTypes[ 0 ] === "*" ) { + dataTypes.shift(); + if ( ct === undefined ) { + ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); + } + } + + // Check if we're dealing with a known content-type + if ( ct ) { + for ( type in contents ) { + if ( contents[ type ] && contents[ type ].test( ct ) ) { + dataTypes.unshift( type ); + break; + } + } + } + + // Check to see if we have a response for the expected dataType + if ( dataTypes[ 0 ] in responses ) { + finalDataType = dataTypes[ 0 ]; + } else { + + // Try convertible dataTypes + for ( type in responses ) { + if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { + finalDataType = type; + break; + } + if ( !firstDataType ) { + firstDataType = type; + } + } + + // Or just use first one + finalDataType = finalDataType || firstDataType; + } + + // If we found a dataType + // We add the dataType to the list if needed + // and return the corresponding response + if ( finalDataType ) { + if ( finalDataType !== dataTypes[ 0 ] ) { + dataTypes.unshift( finalDataType ); + } + return responses[ finalDataType ]; + } +} + +/* Chain conversions given the request and the original response + * Also sets the responseXXX fields on the jqXHR instance + */ +function ajaxConvert( s, response, jqXHR, isSuccess ) { + var conv2, current, conv, tmp, prev, + converters = {}, + + // Work with a copy of dataTypes in case we need to modify it for conversion + dataTypes = s.dataTypes.slice(); + + // Create converters map with lowercased keys + if ( dataTypes[ 1 ] ) { + for ( conv in s.converters ) { + converters[ conv.toLowerCase() ] = s.converters[ conv ]; + } + } + + current = dataTypes.shift(); + + // Convert to each sequential dataType + while ( current ) { + + if ( s.responseFields[ current ] ) { + jqXHR[ s.responseFields[ current ] ] = response; + } + + // Apply the dataFilter if provided + if ( !prev && isSuccess && s.dataFilter ) { + response = s.dataFilter( response, s.dataType ); + } + + prev = current; + current = dataTypes.shift(); + + if ( current ) { + + // There's only work to do if current dataType is non-auto + if ( current === "*" ) { + + current = prev; + + // Convert response if prev dataType is non-auto and differs from current + } else if ( prev !== "*" && prev !== current ) { + + // Seek a direct converter + conv = converters[ prev + " " + current ] || converters[ "* " + current ]; + + // If none found, seek a pair + if ( !conv ) { + for ( conv2 in converters ) { + + // If conv2 outputs current + tmp = conv2.split( " " ); + if ( tmp[ 1 ] === current ) { + + // If prev can be converted to accepted input + conv = converters[ prev + " " + tmp[ 0 ] ] || + converters[ "* " + tmp[ 0 ] ]; + if ( conv ) { + + // Condense equivalence converters + if ( conv === true ) { + conv = converters[ conv2 ]; + + // Otherwise, insert the intermediate dataType + } else if ( converters[ conv2 ] !== true ) { + current = tmp[ 0 ]; + dataTypes.unshift( tmp[ 1 ] ); + } + break; + } + } + } + } + + // Apply converter (if not an equivalence) + if ( conv !== true ) { + + // Unless errors are allowed to bubble, catch and return them + if ( conv && s.throws ) { + response = conv( response ); + } else { + try { + response = conv( response ); + } catch ( e ) { + return { + state: "parsererror", + error: conv ? e : "No conversion from " + prev + " to " + current + }; + } + } + } + } + } + } + + return { state: "success", data: response }; +} + +jQuery.extend( { + + // Counter for holding the number of active queries + active: 0, + + // Last-Modified header cache for next request + lastModified: {}, + etag: {}, + + ajaxSettings: { + url: location.href, + type: "GET", + isLocal: rlocalProtocol.test( location.protocol ), + global: true, + processData: true, + async: true, + contentType: "application/x-www-form-urlencoded; charset=UTF-8", + + /* + timeout: 0, + data: null, + dataType: null, + username: null, + password: null, + cache: null, + throws: false, + traditional: false, + headers: {}, + */ + + accepts: { + "*": allTypes, + text: "text/plain", + html: "text/html", + xml: "application/xml, text/xml", + json: "application/json, text/javascript" + }, + + contents: { + xml: /\bxml\b/, + html: /\bhtml/, + json: /\bjson\b/ + }, + + responseFields: { + xml: "responseXML", + text: "responseText", + json: "responseJSON" + }, + + // Data converters + // Keys separate source (or catchall "*") and destination types with a single space + converters: { + + // Convert anything to text + "* text": String, + + // Text to html (true = no transformation) + "text html": true, + + // Evaluate text as a json expression + "text json": JSON.parse, + + // Parse text as xml + "text xml": jQuery.parseXML + }, + + // For options that shouldn't be deep extended: + // you can add your own custom options here if + // and when you create one that shouldn't be + // deep extended (see ajaxExtend) + flatOptions: { + url: true, + context: true + } + }, + + // Creates a full fledged settings object into target + // with both ajaxSettings and settings fields. + // If target is omitted, writes into ajaxSettings. + ajaxSetup: function( target, settings ) { + return settings ? + + // Building a settings object + ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : + + // Extending ajaxSettings + ajaxExtend( jQuery.ajaxSettings, target ); + }, + + ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), + ajaxTransport: addToPrefiltersOrTransports( transports ), + + // Main method + ajax: function( url, options ) { + + // If url is an object, simulate pre-1.5 signature + if ( typeof url === "object" ) { + options = url; + url = undefined; + } + + // Force options to be an object + options = options || {}; + + var transport, + + // URL without anti-cache param + cacheURL, + + // Response headers + responseHeadersString, + responseHeaders, + + // timeout handle + timeoutTimer, + + // Url cleanup var + urlAnchor, + + // Request state (becomes false upon send and true upon completion) + completed, + + // To know if global events are to be dispatched + fireGlobals, + + // Loop variable + i, + + // uncached part of the url + uncached, + + // Create the final options object + s = jQuery.ajaxSetup( {}, options ), + + // Callbacks context + callbackContext = s.context || s, + + // Context for global events is callbackContext if it is a DOM node or jQuery collection + globalEventContext = s.context && + ( callbackContext.nodeType || callbackContext.jquery ) ? + jQuery( callbackContext ) : + jQuery.event, + + // Deferreds + deferred = jQuery.Deferred(), + completeDeferred = jQuery.Callbacks( "once memory" ), + + // Status-dependent callbacks + statusCode = s.statusCode || {}, + + // Headers (they are sent all at once) + requestHeaders = {}, + requestHeadersNames = {}, + + // Default abort message + strAbort = "canceled", + + // Fake xhr + jqXHR = { + readyState: 0, + + // Builds headers hashtable if needed + getResponseHeader: function( key ) { + var match; + if ( completed ) { + if ( !responseHeaders ) { + responseHeaders = {}; + while ( ( match = rheaders.exec( responseHeadersString ) ) ) { + responseHeaders[ match[ 1 ].toLowerCase() + " " ] = + ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) + .concat( match[ 2 ] ); + } + } + match = responseHeaders[ key.toLowerCase() + " " ]; + } + return match == null ? null : match.join( ", " ); + }, + + // Raw string + getAllResponseHeaders: function() { + return completed ? responseHeadersString : null; + }, + + // Caches the header + setRequestHeader: function( name, value ) { + if ( completed == null ) { + name = requestHeadersNames[ name.toLowerCase() ] = + requestHeadersNames[ name.toLowerCase() ] || name; + requestHeaders[ name ] = value; + } + return this; + }, + + // Overrides response content-type header + overrideMimeType: function( type ) { + if ( completed == null ) { + s.mimeType = type; + } + return this; + }, + + // Status-dependent callbacks + statusCode: function( map ) { + var code; + if ( map ) { + if ( completed ) { + + // Execute the appropriate callbacks + jqXHR.always( map[ jqXHR.status ] ); + } else { + + // Lazy-add the new callbacks in a way that preserves old ones + for ( code in map ) { + statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; + } + } + } + return this; + }, + + // Cancel the request + abort: function( statusText ) { + var finalText = statusText || strAbort; + if ( transport ) { + transport.abort( finalText ); + } + done( 0, finalText ); + return this; + } + }; + + // Attach deferreds + deferred.promise( jqXHR ); + + // Add protocol if not provided (prefilters might expect it) + // Handle falsy url in the settings object (#10093: consistency with old signature) + // We also use the url parameter if available + s.url = ( ( url || s.url || location.href ) + "" ) + .replace( rprotocol, location.protocol + "//" ); + + // Alias method option to type as per ticket #12004 + s.type = options.method || options.type || s.method || s.type; + + // Extract dataTypes list + s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; + + // A cross-domain request is in order when the origin doesn't match the current origin. + if ( s.crossDomain == null ) { + urlAnchor = document.createElement( "a" ); + + // Support: IE <=8 - 11, Edge 12 - 15 + // IE throws exception on accessing the href property if url is malformed, + // e.g. http://example.com:80x/ + try { + urlAnchor.href = s.url; + + // Support: IE <=8 - 11 only + // Anchor's host property isn't correctly set when s.url is relative + urlAnchor.href = urlAnchor.href; + s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== + urlAnchor.protocol + "//" + urlAnchor.host; + } catch ( e ) { + + // If there is an error parsing the URL, assume it is crossDomain, + // it can be rejected by the transport if it is invalid + s.crossDomain = true; + } + } + + // Convert data if not already a string + if ( s.data && s.processData && typeof s.data !== "string" ) { + s.data = jQuery.param( s.data, s.traditional ); + } + + // Apply prefilters + inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); + + // If request was aborted inside a prefilter, stop there + if ( completed ) { + return jqXHR; + } + + // We can fire global events as of now if asked to + // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) + fireGlobals = jQuery.event && s.global; + + // Watch for a new set of requests + if ( fireGlobals && jQuery.active++ === 0 ) { + jQuery.event.trigger( "ajaxStart" ); + } + + // Uppercase the type + s.type = s.type.toUpperCase(); + + // Determine if request has content + s.hasContent = !rnoContent.test( s.type ); + + // Save the URL in case we're toying with the If-Modified-Since + // and/or If-None-Match header later on + // Remove hash to simplify url manipulation + cacheURL = s.url.replace( rhash, "" ); + + // More options handling for requests with no content + if ( !s.hasContent ) { + + // Remember the hash so we can put it back + uncached = s.url.slice( cacheURL.length ); + + // If data is available and should be processed, append data to url + if ( s.data && ( s.processData || typeof s.data === "string" ) ) { + cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; + + // #9682: remove data so that it's not used in an eventual retry + delete s.data; + } + + // Add or update anti-cache param if needed + if ( s.cache === false ) { + cacheURL = cacheURL.replace( rantiCache, "$1" ); + uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + + uncached; + } + + // Put hash and anti-cache on the URL that will be requested (gh-1732) + s.url = cacheURL + uncached; + + // Change '%20' to '+' if this is encoded form body content (gh-2658) + } else if ( s.data && s.processData && + ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { + s.data = s.data.replace( r20, "+" ); + } + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + if ( jQuery.lastModified[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); + } + if ( jQuery.etag[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); + } + } + + // Set the correct header, if data is being sent + if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { + jqXHR.setRequestHeader( "Content-Type", s.contentType ); + } + + // Set the Accepts header for the server, depending on the dataType + jqXHR.setRequestHeader( + "Accept", + s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? + s.accepts[ s.dataTypes[ 0 ] ] + + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : + s.accepts[ "*" ] + ); + + // Check for headers option + for ( i in s.headers ) { + jqXHR.setRequestHeader( i, s.headers[ i ] ); + } + + // Allow custom headers/mimetypes and early abort + if ( s.beforeSend && + ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { + + // Abort if not done already and return + return jqXHR.abort(); + } + + // Aborting is no longer a cancellation + strAbort = "abort"; + + // Install callbacks on deferreds + completeDeferred.add( s.complete ); + jqXHR.done( s.success ); + jqXHR.fail( s.error ); + + // Get transport + transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); + + // If no transport, we auto-abort + if ( !transport ) { + done( -1, "No Transport" ); + } else { + jqXHR.readyState = 1; + + // Send global event + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); + } + + // If request was aborted inside ajaxSend, stop there + if ( completed ) { + return jqXHR; + } + + // Timeout + if ( s.async && s.timeout > 0 ) { + timeoutTimer = window.setTimeout( function() { + jqXHR.abort( "timeout" ); + }, s.timeout ); + } + + try { + completed = false; + transport.send( requestHeaders, done ); + } catch ( e ) { + + // Rethrow post-completion exceptions + if ( completed ) { + throw e; + } + + // Propagate others as results + done( -1, e ); + } + } + + // Callback for when everything is done + function done( status, nativeStatusText, responses, headers ) { + var isSuccess, success, error, response, modified, + statusText = nativeStatusText; + + // Ignore repeat invocations + if ( completed ) { + return; + } + + completed = true; + + // Clear timeout if it exists + if ( timeoutTimer ) { + window.clearTimeout( timeoutTimer ); + } + + // Dereference transport for early garbage collection + // (no matter how long the jqXHR object will be used) + transport = undefined; + + // Cache response headers + responseHeadersString = headers || ""; + + // Set readyState + jqXHR.readyState = status > 0 ? 4 : 0; + + // Determine if successful + isSuccess = status >= 200 && status < 300 || status === 304; + + // Get response data + if ( responses ) { + response = ajaxHandleResponses( s, jqXHR, responses ); + } + + // Use a noop converter for missing script but not if jsonp + if ( !isSuccess && + jQuery.inArray( "script", s.dataTypes ) > -1 && + jQuery.inArray( "json", s.dataTypes ) < 0 ) { + s.converters[ "text script" ] = function() {}; + } + + // Convert no matter what (that way responseXXX fields are always set) + response = ajaxConvert( s, response, jqXHR, isSuccess ); + + // If successful, handle type chaining + if ( isSuccess ) { + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + modified = jqXHR.getResponseHeader( "Last-Modified" ); + if ( modified ) { + jQuery.lastModified[ cacheURL ] = modified; + } + modified = jqXHR.getResponseHeader( "etag" ); + if ( modified ) { + jQuery.etag[ cacheURL ] = modified; + } + } + + // if no content + if ( status === 204 || s.type === "HEAD" ) { + statusText = "nocontent"; + + // if not modified + } else if ( status === 304 ) { + statusText = "notmodified"; + + // If we have data, let's convert it + } else { + statusText = response.state; + success = response.data; + error = response.error; + isSuccess = !error; + } + } else { + + // Extract error from statusText and normalize for non-aborts + error = statusText; + if ( status || !statusText ) { + statusText = "error"; + if ( status < 0 ) { + status = 0; + } + } + } + + // Set data for the fake xhr object + jqXHR.status = status; + jqXHR.statusText = ( nativeStatusText || statusText ) + ""; + + // Success/Error + if ( isSuccess ) { + deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); + } else { + deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); + } + + // Status-dependent callbacks + jqXHR.statusCode( statusCode ); + statusCode = undefined; + + if ( fireGlobals ) { + globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", + [ jqXHR, s, isSuccess ? success : error ] ); + } + + // Complete + completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); + + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); + + // Handle the global AJAX counter + if ( !( --jQuery.active ) ) { + jQuery.event.trigger( "ajaxStop" ); + } + } + } + + return jqXHR; + }, + + getJSON: function( url, data, callback ) { + return jQuery.get( url, data, callback, "json" ); + }, + + getScript: function( url, callback ) { + return jQuery.get( url, undefined, callback, "script" ); + } +} ); + +jQuery.each( [ "get", "post" ], function( _i, method ) { + jQuery[ method ] = function( url, data, callback, type ) { + + // Shift arguments if data argument was omitted + if ( isFunction( data ) ) { + type = type || callback; + callback = data; + data = undefined; + } + + // The url can be an options object (which then must have .url) + return jQuery.ajax( jQuery.extend( { + url: url, + type: method, + dataType: type, + data: data, + success: callback + }, jQuery.isPlainObject( url ) && url ) ); + }; +} ); + +jQuery.ajaxPrefilter( function( s ) { + var i; + for ( i in s.headers ) { + if ( i.toLowerCase() === "content-type" ) { + s.contentType = s.headers[ i ] || ""; + } + } +} ); + + +jQuery._evalUrl = function( url, options, doc ) { + return jQuery.ajax( { + url: url, + + // Make this explicit, since user can override this through ajaxSetup (#11264) + type: "GET", + dataType: "script", + cache: true, + async: false, + global: false, + + // Only evaluate the response if it is successful (gh-4126) + // dataFilter is not invoked for failure responses, so using it instead + // of the default converter is kludgy but it works. + converters: { + "text script": function() {} + }, + dataFilter: function( response ) { + jQuery.globalEval( response, options, doc ); + } + } ); +}; + + +jQuery.fn.extend( { + wrapAll: function( html ) { + var wrap; + + if ( this[ 0 ] ) { + if ( isFunction( html ) ) { + html = html.call( this[ 0 ] ); + } + + // The elements to wrap the target around + wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); + + if ( this[ 0 ].parentNode ) { + wrap.insertBefore( this[ 0 ] ); + } + + wrap.map( function() { + var elem = this; + + while ( elem.firstElementChild ) { + elem = elem.firstElementChild; + } + + return elem; + } ).append( this ); + } + + return this; + }, + + wrapInner: function( html ) { + if ( isFunction( html ) ) { + return this.each( function( i ) { + jQuery( this ).wrapInner( html.call( this, i ) ); + } ); + } + + return this.each( function() { + var self = jQuery( this ), + contents = self.contents(); + + if ( contents.length ) { + contents.wrapAll( html ); + + } else { + self.append( html ); + } + } ); + }, + + wrap: function( html ) { + var htmlIsFunction = isFunction( html ); + + return this.each( function( i ) { + jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); + } ); + }, + + unwrap: function( selector ) { + this.parent( selector ).not( "body" ).each( function() { + jQuery( this ).replaceWith( this.childNodes ); + } ); + return this; + } +} ); + + +jQuery.expr.pseudos.hidden = function( elem ) { + return !jQuery.expr.pseudos.visible( elem ); +}; +jQuery.expr.pseudos.visible = function( elem ) { + return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); +}; + + + + +jQuery.ajaxSettings.xhr = function() { + try { + return new window.XMLHttpRequest(); + } catch ( e ) {} +}; + +var xhrSuccessStatus = { + + // File protocol always yields status code 0, assume 200 + 0: 200, + + // Support: IE <=9 only + // #1450: sometimes IE returns 1223 when it should be 204 + 1223: 204 + }, + xhrSupported = jQuery.ajaxSettings.xhr(); + +support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); +support.ajax = xhrSupported = !!xhrSupported; + +jQuery.ajaxTransport( function( options ) { + var callback, errorCallback; + + // Cross domain only allowed if supported through XMLHttpRequest + if ( support.cors || xhrSupported && !options.crossDomain ) { + return { + send: function( headers, complete ) { + var i, + xhr = options.xhr(); + + xhr.open( + options.type, + options.url, + options.async, + options.username, + options.password + ); + + // Apply custom fields if provided + if ( options.xhrFields ) { + for ( i in options.xhrFields ) { + xhr[ i ] = options.xhrFields[ i ]; + } + } + + // Override mime type if needed + if ( options.mimeType && xhr.overrideMimeType ) { + xhr.overrideMimeType( options.mimeType ); + } + + // X-Requested-With header + // For cross-domain requests, seeing as conditions for a preflight are + // akin to a jigsaw puzzle, we simply never set it to be sure. + // (it can always be set on a per-request basis or even using ajaxSetup) + // For same-domain requests, won't change header if already provided. + if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { + headers[ "X-Requested-With" ] = "XMLHttpRequest"; + } + + // Set headers + for ( i in headers ) { + xhr.setRequestHeader( i, headers[ i ] ); + } + + // Callback + callback = function( type ) { + return function() { + if ( callback ) { + callback = errorCallback = xhr.onload = + xhr.onerror = xhr.onabort = xhr.ontimeout = + xhr.onreadystatechange = null; + + if ( type === "abort" ) { + xhr.abort(); + } else if ( type === "error" ) { + + // Support: IE <=9 only + // On a manual native abort, IE9 throws + // errors on any property access that is not readyState + if ( typeof xhr.status !== "number" ) { + complete( 0, "error" ); + } else { + complete( + + // File: protocol always yields status 0; see #8605, #14207 + xhr.status, + xhr.statusText + ); + } + } else { + complete( + xhrSuccessStatus[ xhr.status ] || xhr.status, + xhr.statusText, + + // Support: IE <=9 only + // IE9 has no XHR2 but throws on binary (trac-11426) + // For XHR2 non-text, let the caller handle it (gh-2498) + ( xhr.responseType || "text" ) !== "text" || + typeof xhr.responseText !== "string" ? + { binary: xhr.response } : + { text: xhr.responseText }, + xhr.getAllResponseHeaders() + ); + } + } + }; + }; + + // Listen to events + xhr.onload = callback(); + errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); + + // Support: IE 9 only + // Use onreadystatechange to replace onabort + // to handle uncaught aborts + if ( xhr.onabort !== undefined ) { + xhr.onabort = errorCallback; + } else { + xhr.onreadystatechange = function() { + + // Check readyState before timeout as it changes + if ( xhr.readyState === 4 ) { + + // Allow onerror to be called first, + // but that will not handle a native abort + // Also, save errorCallback to a variable + // as xhr.onerror cannot be accessed + window.setTimeout( function() { + if ( callback ) { + errorCallback(); + } + } ); + } + }; + } + + // Create the abort callback + callback = callback( "abort" ); + + try { + + // Do send the request (this may raise an exception) + xhr.send( options.hasContent && options.data || null ); + } catch ( e ) { + + // #14683: Only rethrow if this hasn't been notified as an error yet + if ( callback ) { + throw e; + } + } + }, + + abort: function() { + if ( callback ) { + callback(); + } + } + }; + } +} ); + + + + +// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) +jQuery.ajaxPrefilter( function( s ) { + if ( s.crossDomain ) { + s.contents.script = false; + } +} ); + +// Install script dataType +jQuery.ajaxSetup( { + accepts: { + script: "text/javascript, application/javascript, " + + "application/ecmascript, application/x-ecmascript" + }, + contents: { + script: /\b(?:java|ecma)script\b/ + }, + converters: { + "text script": function( text ) { + jQuery.globalEval( text ); + return text; + } + } +} ); + +// Handle cache's special case and crossDomain +jQuery.ajaxPrefilter( "script", function( s ) { + if ( s.cache === undefined ) { + s.cache = false; + } + if ( s.crossDomain ) { + s.type = "GET"; + } +} ); + +// Bind script tag hack transport +jQuery.ajaxTransport( "script", function( s ) { + + // This transport only deals with cross domain or forced-by-attrs requests + if ( s.crossDomain || s.scriptAttrs ) { + var script, callback; + return { + send: function( _, complete ) { + script = jQuery( " + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Acknowledgements

+

Grateful acknowledgement is made to the following persons and organizations.

+

Mentions roughly in the order of first involvement with the project.

+
+

FreeBSD project

+

https://www.freebsd.org/

+
    +
  • Providing the underlying operating system

  • +
+
+
+

FreeBSD port maintainers

+

As listed on https://www.freshports.org/

+
    +
  • Providing end user applications

  • +
+
+
+

Simon Peter

+

probonopd +@probonopd on twitter

+
    +
  • Founded the project

  • +
  • Acting as the main developer

  • +
+
+
+

Joe Maloney

+

pkgdemon +malco2001 on irc (#FuryBSD)

+
    +
  • Originally wrote the tools to create Live ISOs for FuryBSD

  • +
+
+
+

Cirrus CI

+

https://cirrus-ci.com/

+
    +
  • Providing continuous build infrastructure

  • +
+
+
+

Fedor Korotkov

+

fkorotkov

+
    +
  • Provided helpful support concerning all things Cirrus CI

  • +
+
+
+

FreeBSD Foundation

+

https://www.freebsdfoundation.org/

+
    +
  • Gave permission to use the trademarks in the ‘Install FreeBSD’ utility

  • +
+
+
+

Sławomir Wojciech Wojtczak

+

vermaden +@vermaden on twitter

+
    +
  • Provided helpful feedback and configuration advice

  • +
  • Configuration for tap to click and two-finger scrolling for Synaptics and Elan touchpads

  • +
+
+
+

Reven Martin (CutefishOS)

+

rekols +@revenmartin on twitter, @cutefishos on twitter

+
    +
  • Originally wrote Panda Status Bar, which the hello Menu is based on

  • +
  • Originally wrote Cyber Dock, which the hello Dock is based on

  • +
+
+
+

Ale Rimoldi

+

aoloe +@a_l_e on twitter

+
    +
  • Implemented Action Search (search through menubar)

  • +
+
+
+

Antony jr

+

antony-jr +@antonyjr0 on twitter

+
    +
  • Put Search field for Action Search in menubar

  • +
  • Integrated of ‘System’ menu into menubar

  • +
+
+
+

Keshav Bhatt

+

keshavbhatt +@keshavmail68 on twitter

+
    +
  • Helped making ‘System’ menu submenus clickable

  • +
+
+
+

@FreeBSDHelp on twitter

+
    +
  • Reached out to FreeBSD kernel developers

  • +
+
+
+

TheAssassin

+

TheAssassin

+
    +
  • Improved documentation by providing Sphinx evangelism and ReStructuredText help

  • +
  • Helped with CMake and Qt translations

  • +
+
+
+

Leodanis Pozo Ramos

+

lpozo

+
    +
  • Wrote tutorial and sample code that forms the basis for Calculator.app

  • +
+
+
+

Marcel Kaiser

+

mrclksr

+
    +
  • Wrote initgfx graphics hardware autoconfiguration

  • +
+
+
+

Graham Perrin

+

grahamperrin

+
    +
  • Provided early testing and feedback

  • +
+
+
+

PreyK

+

PreyK

+
    +
  • Made System menu to refresh itself automatically

  • +
  • Fixed Menu and desktop for multi-monitor setups

  • +
+
+
+

Chris Moore

+

moochris

+
    +
  • Improved Filer: Added initial ‘spatial mode’ option (folders open in a new window) and made already-open windows come to the front rather than opening the same window multiple times

  • +
  • Made volumes show up on the desktop

  • +
  • Added menus to the desktop

  • +
+
+
+

Weblate

+

hosted.weblate.org

+
    +
  • Providing infrastructure for crowd-sourced translations

  • +
+
+
+

Chris Rees

+

crees

+
    +
  • Made it possible to use a fixed Intel GPU driver for FreeBSD 12.2 from a private package

  • +
  • Created a package for the Falkon browser that does not pull in many KDE dependencies

  • +
  • Updated required FreeBSD ports and helped writing new ports

  • +
+
+
+

Jordan Gordeev

+
    +
  • Wrote geom_rowr FreeBSD kernel module to combine a read-only with a read-write device

  • +
+
+
+

Jesper Schmitz Mouridsen (jsmdk)

+

jsm222

+
    +
  • Packaging helloDesktop components for FreeBSD Ports (details)

  • +
  • Fix for the Global Menu in Chrome and Firefox

  • +
  • Added patches to Firefox and Thunderbird Ports for global menu support

  • +
+
+
+

Sergey Tyuryukanov

+

s199p.wa1k9k +@S199pWa1k9r on twitter

+
    +
  • Packaging helloDesktop components for FreeBSD Ports on aarch64

  • +
+
+
+

Zoë Knox

+

mszoek +@thatzoek on twitter

+
    +
  • Implemented org.freedesktop.FileManager1 API in Filer

  • +
+
+
+

alphamodh0

+

alphamodh0

+
    +
  • Translated helloSystem to Spanish

  • +
+
+
+

Sebastian Birnbach

+

https://zweibruecken-ip.de/

+
    +
  • Donated a Mac mini (Mid 2010) (Macmini4,1) to the helloSystem Hardware Test Zoo

  • +
+
+
+

Luna Jernberg

+

bittin

+
    +
  • Swedish translator

  • +
+
+
+

Framework Computer Inc

+

FrameworkComputer

+
    +
  • Donated a Framework Mainboard (i5-1135G7) through the Developer Mainboard Program

  • +
+
+
+

Jérôme Ornech

+

Hierosme alias Tuuux

+
    +
  • Rewrote Processes.app (#159)

  • +
  • Wrote Network Utility.app

  • +
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/application-bundles.html b/developer/application-bundles.html new file mode 100644 index 00000000..d1b5a501 --- /dev/null +++ b/developer/application-bundles.html @@ -0,0 +1,243 @@ + + + + + + Application Bundles — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Application Bundles

+

helloSystem uses application bundles to manage native applications. Whenever possible, application bundles are used. XDG-style .desktop files are considered legacy and should be avoided.

+
+

Benefits

+

Applications shipped as application bundles can

+
    +
  • Easily be moved around in the filesystem (relocation)

  • +
  • Easily be copied to e.g., another machine or a network share

  • +
  • Easily be copied on the local machine to get a second instance of the same application (e.g., to make changes to it while keeping the original around)

  • +
  • Easily be deleted by moving to the Trash

  • +
  • Easily be managed without the need for a package manager

  • +
  • Easily be modified (e.g., changing the icon) without any side effects to other parts of the system

  • +
  • Easily be distributed (e.g., in archives like zip files or in disk images) without the need for packaging

  • +
  • Easily be understood by switchers coming from other operating systems with similar application distribution formats

  • +
+
+
+

Application bundle formats

+
+

.app bundles

+

helloSystem supports simplified GNUstep-style .app bundles.

+

Minimal requirements:

+
./Application.app
+./Application.app/Application <-- (link to) the executable to be launched when Application.app is double clicked
+./Application.app/Resources/Application.png <-- the application icon (png format)
+./Application.app/Resources/can-open <-- optional, MIME types the application can open, separated by `;`
+
+
+

In order to realize the full intended functionality, additional metadata may be required (such as localized application name, version, supported file formats, etc.). Possibly the GNUstep metadata format is sufficient for this.

+
+
+

.AppDir bundles

+

helloSystem supports simplified ROX-style .AppDir bundles.

+

Minimal requirements:

+
./Application.AppDir
+./Application.AppDir/AppRun <-- (link to) the executable to be launched when Application.app is double clicked
+./Application.AppDir/.DirIcon <-- the application icon (png format)
+
+
+

In order to realize the full intended functionality, additional metadata may be required (such as localized application name, version, supported file formats, etc.). Possibly the ROX AppDir specification is not sufficient for this and may need to be amended (to be determined).

+
+
+

Wrappers for legacy packages

+

helloSystem supports applications that are not shipped in bundle formats yet. These can be bridged by wrapper bundles, application bundles that merely launch (but do not contain) the payload application (which may be installed in traditional ways).

+

A desktop2app tool ships with helloSystem that automates the creation of such wrappers.

+

Please note that the use of wrapper bundles is discouraged and is only available as a bridge technology for backward compatibility with existing application packages.

+
+
+
+

Building application bundles

+

Here is a real-world example on how to build an application bundle for a Qt application written in C++ using GitHub and Cirrus CI:

+

https://github.com/helloSystem/QHexEdit

+

The application gets compiled and uploaded in a fully automated process.

+

The resulting application bundle is provided for download in zipped form on GitHub Releases.

+

Please see the .cirrus.yml file for details.

+
+

Making an application load privately bundled libraries

+

If an application is supposed to load privately bundled libraries, one must patch it so that it loads privately bundled libraries from a path relative to itself ($ORIGIN) rather than from /usr/local/lib:

+
$ sed -i -e 's|/usr/local/lib|$ORIGIN/../lib|g' usr/local/bin/falkon
+$ ln -s usr/local/lib .
+$ rm usr/local/bin/falkon-e
+
+
+

This works because by coincidence the string /usr/local/lib has the exact same length as $ORIGIN/../lib. If this was not the case, one would need to either specify the rpath at compilation time, or use a tool such as patchelf.

+
+
+

Avoiding absolute paths

+

For an application to be fully relocatable in the filesystem, one must take care that no absolute paths to data files (e.g., those in /usr/share/<APPNAME> get compiled in.

+

In Qt applications, void QStringList QStandardPaths::standardLocations(QStandardPaths::AppDataLocation);. According to the Qt documentation, this resolves to "~/.local/share/<APPNAME>", "/usr/local/share/<APPNAME>", "/usr/share/<APPNAME>" but clearly /usr is not where these things are located in an .app bundle.

+

Instead, use QString QCoreApplication::applicationDirPath() and construct a relative path to ../share/<APPNAME> from there.

+

For an example, see: +https://github.com/KaidanIM/Kaidan/commit/da38011b55a1aa5d17764647ecd699deb4be437f

+
+
+
+

Credits

+

Application directories and application bundles have been used by many desktop-oriented operating systems, including RISC OS, NeXTStep/OPENSTEP, Mac OS X, and various other systems. Classic Macintosh System used single-file applications that kept resources in the Resource Fork.

+
    +
  • https://en.wikipedia.org/wiki/Application_directory

  • +
  • http://rox.sourceforge.net/desktop/AppDirs.html

  • +
  • https://en.wikipedia.org/wiki/Resource_fork

  • +
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/applications.html b/developer/applications.html new file mode 100644 index 00000000..eaa462b3 --- /dev/null +++ b/developer/applications.html @@ -0,0 +1,198 @@ + + + + + + Applications — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Applications

+

Applications specifically written for helloSystem, especially Preferences and Utilities applications, should be

+
    +
  • Simple to use

  • +
  • Easy to hack on

  • +
  • Open Source (2-clause BSD licensed by default, but similar permissive licenses may also be acceptable)

  • +
  • Ideally written in PyQt

  • +
  • Come as simplified .app bundles with no external dependencies apart from what comes with helloSystem by default on the Live ISO

  • +
+

Some of the example applications and utilities are written in Python with PyQt. This is designed to invite (power) users to have a look at the code, start to experiment, and possibly eventually contribute. Especially when used in conjunction with the simplified .app bundle format and with an IDE with autocompletion, this makes for a very accessible development environment with very low barriers to entry. No source code to search and download, no compilers, just open the .app bundle and start hacking away. Tiny example applications like Log.app and Calendar.app are included that anyone should be able to understand in no time.

+

Please see https://github.com/learnpyqt/15-minute-apps for what we mean by “Simple to use” and “Easy to hack on”.

+

For an introduction to Creating GUI applications with Python & Qt5 you may be interested in the book with the same name by Martin Fitzpatrick. There is also a forum at forum.learnpyqt.com.

+

+
+

Using .ui files in PyQt

+

Using Qt Creator, you can also create and edit graphical user interfaces for Python based applications using .ui files. These can be used in PyQt like this:

+
#!/usr/bin/env python3
+# This Python file uses the following encoding: utf-8
+
+
+import sys
+import os
+
+
+from PyQt5.QtWidgets import QApplication, QWidget
+from PyQt5.QtCore import QFile
+from PyQt5.uic import loadUi
+
+
+class Widget(QWidget):
+    def __init__(self):
+        super(Disks, self).__init__()
+        self.load_ui()
+
+    def load_ui(self):
+        path = os.path.join(os.path.dirname(__file__), "form.ui")
+        ui_file = QFile(path)
+        ui_file.open(QFile.ReadOnly)
+        loadUi(ui_file, self)
+        ui_file.close()
+
+
+if __name__ == "__main__":
+    app = QApplication([])
+    widget = Widget()
+    widget.show()
+    sys.exit(app.exec_())
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/architecture.html b/developer/architecture.html new file mode 100644 index 00000000..6c3e2e41 --- /dev/null +++ b/developer/architecture.html @@ -0,0 +1,215 @@ + + + + + + Architecture — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Architecture

+

helloSystem is designed with simplicity in mind. Less, but better. This page describes key elements of the hello desktop. To begin with, everything should be welcoming for Mac users but 10x as simple.

+
+

Frameworks

+

In order of preference:

+
    +
  • PyQt

  • +
  • Qml

  • +
  • Qt

  • +
  • Kf5 components where absolutely needed

  • +
  • Everything else

  • +
  • Gtk

  • +
+

Rationale: Most cross real-world productivity applications are written cross-platform and this often means Qt. Hence, to provide the best possible environment for those applications, we choose Qt for now. Philosophically, we would prefer to use something BSD licensed (or similar), such as FyneDesk, but in its current state it cannot yet provide the same truly native experience for existing Qt applications. (Maybe it helps to think of Qt as the “Carbon of hello”, whereas something else will eventually become the “Cocoa of hello”.)

+
+
+

Desktop components

+

The minimum number of components viable to produce an efficient desktop should be used. Each component should be as simple as possible, and have as few dependencies as possible (besides the ones that are central to the hello Desktop, such as Qt and PyQt). Outside dependencies that are closely tied to other outside components should be avoided. XDG specifications are considered overly complex but insufficient and should be avoided, but may be acceptable as legacy technology for compatibility reasons.

+
+

Filer

+

File manager that can handle (simplified) .app and .AppDir bundles

+
+ +
+

Dock

+

A Dock that shows icons for running and pinned applications. (In the future it should also get an animated icon as a launching indicator for applications that are being launched but are not yet showing a window.)

+
+
+

launch command

+

The launch command is used to launch applications without specifying a path to them.

+

The launch command is expected to determine the preferred instance of an application with the given name. (The launch command is supposed to find the preferred instance, e.g., the one with the highest version, the one last put onto the system, etc.) Eventually the launch command should also gain knowledge of which application to open a file with.

+

Filer is supposed to launch all applications through the launch command. Shell scripts, .desktop files, etc. should be written to use the launch command rather than hardcoding paths to applications, where appropriate.

+

If an application cannot be launched, the launch command shall give a localized, understandable clear-text error message and offer a solution if possible; fall back to the console output of the application that could not be launched. +When beginning to launch an application, the launch command shall notify the Dock via some IPC mechanism (ideally something much simpler than the convoluted D-Bus) about the icon and name of the application about to be launched, so that the Dock can start a launch animation until the application is showing its first window).

+
+
+

IPC mechanism for the desktop

+

A very simple IPC mechanism should be introduced for the desktop components to talk to each other. A lightweight, standard publish/subscribe mechanism should be identified; possibly something like MQTT (which would have the added benefit of allowing for network-wide communication). In the meantime, the use of D-Bus as a legacy technology may be acceptable (even though it is considered obscure, convoluted, and closely linked with various other Red Hat technologies.)

+
+
+

Applications

+

Applications must not need to be installed. Simply downloading them, attaching an external drive containing them, or connecting to a network share containing them must be sufficient. Multiple versions of the same application must be able to co-exist. The launch command is responsible to determine which one to use in cases where the user did not explicitly launch a specific instance by double-clicking it.

+

Custom-written applications should come as Application bundles whenever possible. It is acceptable for pre-existing applications to come with legacy XDG desktop files instead.

+
+
+

Utilities

+

The system should come with some commonly used utilities, such as a Terminal application, a Process Monitor application, etc. These are just regular applications inside a ‘Utilities’ subdirectory. It is acceptable for pre-existing applications, preferably written in Qt.

+
+
+

Preferences

+

The system should come with some commonly used preference panels, such as for configuring the system language, OpenZFS Boot Environments, etc. These are just regular applications inside a ‘Preferences’ subdirectory. These should be super simple, “minimal viable” applications. It is expected that many will need to be written from scratch, but it is acceptable to re-use pre-existing applications, preferably written in Qt.

+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/base.html b/developer/base.html new file mode 100644 index 00000000..8d056f11 --- /dev/null +++ b/developer/base.html @@ -0,0 +1,192 @@ + + + + + + Working with the FreeBSD base system — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Working with the FreeBSD base system

+

In some situations it may be necessary to make changes to existing software that comes in the FreeBSD base system.

+

This section describes how to make such changes using an example.

+
+

Example

+

Suppose you would like to make a small change to the source code of software that comes in the FreeBSD base system.

+

Here is a real-life example on how to do that:

+

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=251025 can be fixed by changing a few lines in

+

https://github.com/freebsd/freebsd-src/blob/main/usr.sbin/efivar/efivar.c

+
+
+

Installing the FreeBSD source code

+

Unfortunately one has to download/update the whole FreeBSD source code, even if one just wants to make a change to one command line tool.

+

From http://ftp.freebsd.org/pub/FreeBSD/releases/amd64/12.2-RELEASE/ (or from whatever FreeBSD version you are using) download src.txz. Then:

+
$ cd /
+$ tar xf ~/Downloads/src.txz
+$ rm ~/Downloads/src.txz
+
+
+
+
+

Building a command line tool without changes

+

Build the command line tool without changes first to ensure it builds and works as expected.

+
$ cd /usr/src/usr.sbin/efivar/
+$ make
+$ /usr/obj/usr/src/amd64.amd64/usr.sbin/efivar/efivar
+
+
+
+
+

Making changes

+

Now make changes to the command line tool.

+
$ cd /usr/src/usr.sbin/efivar/
+$ rm efivar.c
+// From https://reviews.freebsd.org/D29620
+$ wget "https://reviews.freebsd.org/file/data/yytb47lr5cxaijaaupeh/PHID-FILE-gihl33z7feu4dagjxjgz/usr.sbin_efivar_efivar.c" -O efivar.c
+$ make
+$ /usr/obj/usr/src/amd64.amd64/usr.sbin/efivar/efivar
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/binary-compatibility.html b/developer/binary-compatibility.html new file mode 100644 index 00000000..34c5b0a5 --- /dev/null +++ b/developer/binary-compatibility.html @@ -0,0 +1,202 @@ + + + + + + Binary Compatibility — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Binary Compatibility

+

Binary compatibility is an important concept in software engineering. It allows applications compiled on a build system to run on user’s target systems without forcing them to upgrade their entire system all the time. As the FreeBSD wiki page on binary compatibility points out, “a lot of downstream users keep systems for about 10 years and want to be able to keep running their stack on top of FreeBSD without worrying that an upgrade will break things.”

+
+

Note

+

This page is in draft status and needs to be reviewed by experienced FreeBSD developers. Pull requests welcome.

+
+
+

Application compatibility

+

The Application Binary Interface (ABI) defines which applications can run on which systems. The two main factors in determining application compatibility are the FreeBSD version (e.g., 12.x) and the version of packages (e.g., quarterly).

+
    +
  • Applications compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD if the packages of the dependencies on the target system are no older than on the build system. Example: An application compiled on FreeBSD 12.0 is expected to run on FreeBSD 12.1 and 12.2 if the packages of the dependencies on the target system are no older than on the build system

  • +
  • Applications compiled on one major version of FreeBSD are expected to run on subsequent major versions of FreeBSD if compatibility libraries are installed. Example: An application compiled on FreeBSD 3.2 is expected to run on FreeBSD 14 if compatibility libraries are installed. But this is what happens when you try to pkg-static add a package built on FreeBSD 12 on a FreeBSD 13 machine: pkg-static: wrong architecture: FreeBSD:12:amd64 instead of FreeBSD:13:amd64 - apparently pkg-static add does not make use of the compatibility assumption but this can be worked around by exporting, e.g., ABI=freebsd:12:amd64; pkg install does not seem to have this issue.

  • +
+
+

Recommendation for building binary compatible applications

+

Build on the .0 minor version for each still-supported major version of FreeBSD, using release_0, release_1, release_2,… but NOT quarterly, latest packages as those are moving targets which will vanish over time.

+

This should allow the application to run on all still-supported FreeBSD releases.

+
+
+
+

Kernel module compatibility

+

The Kernel Binary Interface (KBI) defines which kernel extensions can run on which systems.

+
+

Note

+

Section to be written. Pull requests welcome.

+
+
    +
  • Normally, kernel extensions compiled on one major version of FreeBSD are expected to run on subsequent minor versions of the same major version of FreeBSD. However, there are notable exceptions such as the i915kms package that contains the Intel GPU driver.

  • +
+

Note: The i915kms package that contains the Intel GPU driver breaks on 12.2-RELEASE.

+
+

Note

+

Explanation to be written. Pull requests welcome.

+
+
+

Recommendation for building binary compatible kernel modules

+

Build on the .0 minor version for each still-supported major version of FreeBSD. Test whether the kernel module runs on all subsequent minr versions and build for those minor versions separately in case it does not. This should allow the kernel module to run on all still-supported FreeBSD releases.

+
+
+
+

References

+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/boot.html b/developer/boot.html new file mode 100644 index 00000000..ad2de239 --- /dev/null +++ b/developer/boot.html @@ -0,0 +1,491 @@ + + + + + + Boot process — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Boot process

+
+

Speeding up the boot process

+

As a desktop-centric system, helloSystem should bring up a graphical desktop as soon as possible, and delay starting up other services such as the network beyond that point. Unfortunately, in the FreeBSD default configuration this is the other way around, and the graphical desktop will only start after the network has been configured, the time has been set using NTP, etc.

+

While it would be possible to change the order of the scripts in /etc/rc.d and /usr/local/etc/rc.d, those changes might get overwritten with subsequent FreeBSD or package updates. Hence, we should never edit startup scripts provided by FreeBSD or packages.

+

Instead, we can disable the services in question so that they don’t get started as part of the normal FreeBSD boot sequence, and start them later in the boot process (after the graphical session has been started) using a custom start script.

+
+

Note

+

The following instructions are DANGEROUS and can potentially lead to a system that cannot boot into a graphical desktop if things go wrong. This is currently only for developers and experienced users who know how to handle such situations. Future versions of helloSystem may come with this already set up.

+
+

To do this, create a Boot Environment that you can roll back to in case things go wrong.

+

In /etc/rc.conf, set

+
defaultroute_carrier_delay="0"
+defaultroute_delay="0"
+background_dhclient="YES"
+
+
+

Then create the following /usr/local/etc/rc.d/late-start script:

+
#!/bin/sh
+
+# PROVIDE: late-start
+# REQUIRE: slim
+
+PATH=$PATH:/usr/sbin
+export PATH
+
+. /etc/rc.subr
+
+name="late"
+start_cmd="${name}_start"
+
+extra_commands="disable_early_services"
+disable_early_services_cmd="${name}_disable_early_services"
+
+# NOTE: devd needs to stay enabled in early boot
+# so that we have a working mouse pointer as soon as Xorg is started
+
+SERVICES="setup-mouse webcamd vboxservice dsbdriverd netif routing defaultroute avahi-daemon clear-tmp cupsd ntpdate smartd sshd"
+
+late_start()
+{
+    service devd restart # For networking; invokes dhcpd
+    for SERVICE in $SERVICES ; do
+        service "$SERVICE" onestart
+    done
+}
+
+late_disable_early_services()
+{
+    for SERVICE in $SERVICES ; do
+        service "$SERVICE" disable
+    done
+}
+
+load_rc_config $name
+run_rc_command "$1"
+
+
+

Disable the services in question with

+
$ sudo chmod +x /usr/local/etc/rc.d/late-start
+$ sudo service late-start disable_early_services
+
+
+

Check which services are still enabled, should now be greatly reduced:

+
$ grep -r 'enable="YES"' /etc/rc.conf*
+/etc/rc.conf:clear_tmp_enable="YES"
+/etc/rc.conf:dbus_enable="YES"
+/etc/rc.conf:initgfx_enable="YES"
+/etc/rc.conf:load_acpi_enable="YES"
+/etc/rc.conf:slim_enable="YES"
+/etc/rc.conf:zfs_enable="YES"
+
+
+

Reboot. The graphical desktop (including a usable mouse pointer) should appear ~10 seconds faster, but the network will start to work only after ~10 seconds.

+
+

Note

+

This starts services like sshd; you need to edit the /usr/local/etc/rc.d/late-start script to only start the services you would like to be started.

+
+
+
+

Debugging the Live system boot process

+

As soon as the screen becomes grey, press “s” to boot in single-user mode. The system will boot to the first stage Live system prompt:

+

livefirstsingleprompt

+

At this point, the Live system has not been made writable yet. +Enter exit to contine. The system will boot to the second stage Live system prompt:

+

livesecondsingleprompt

+

At this point, the system has been made partly writable by the init_script. To see the messages, you can press the ScrLk key on your keyboard and then use the arrow up and arrow down keys on your keyboard. Then press the ScrLk key again.

+

Hit the Enter key on your keyboard.

+

Here you can make changes to files like /usr/local/bin/start-hello.

+

For example, you can

+
$ mv /usr/local/bin/start-hello /usr/local/bin/start-hello.original
+$ ln -sf /usr/local/bin/xterm /usr/local/bin/start-hello
+
+
+

Then enter exit to contine. The system will boot into the graphical desktop.

+

If you have made the above changes, you can run

+
$ sh -x /usr/local/bin/start-hello.original
+
+
+

to watch start-hello.original run in a graphical terminal.

+

image

+

Here you can see what goes wrong, if anything… and then you can create, e.g., a replacement start-hello script that gets loaded with Monkey Patching.

+
+
+

Live system early boot process

+
+

Note

+

This section describes helloSystem boot process up to 0.6.0. Starting with version 0.7.0, helloSystem will use a completely different live system boot process. This page needs to be updated accordingly.

+
+

The ISO contains a compressed Live system filesystem image in uzip format. This filesystem image contains the filesystem used when running the ISO. During the Live system boot process, the image needs to get mounted and needs to get turned into a read-write filesystem so that one can make changes to the running system.

+

FreeBSD does not have a standard way to achieve this, so custom code has to be used. (The ISOs provided by the FreeBSD project do not use a compressed Live system filesystem image, and do not result in a read-write filesystem when being booted.)

+

This is a simplified description of the boot process. There may be additional aspects which still need to be documented.

+
    +
  1. The bootloader gets loaded

  2. +
  3. The bootloader loads the kernel modules that are required for the Live system boot process as specified in overlays/boot/boot/loader.conf. Note that the bootloader apparently is not smart enough to load the dependencies of kernel modules, so one needs to manually specify those as well. For example, zfs.ko up to FreeBSD 12 requires opensolaris.ko and from 13 onward requires cryptodev.ko

  4. +
  5. The bootloader loads the ramdisk image ramdisk.ufs as specified in overlays/boot/boot/loader.conf under mfsroot_name. The contents of the ramdisk image are specified in overlays/ramdisk

  6. +
  7. init.sh from the ramdisk image gets executed as requested by overlays/boot/boot/loader.conf under init_script and specified in overlays/ramdisk/init.sh. It constructs a r/w Live filesystem tree (e.g., by replicating the system image to swap-based memdisk) at /livecd

  8. +
  9. /usr/local/bin/furybsd-init-helper gets executed by init.sh in a chroot of the live filesystem, /livecd. It is defined in overlays/uzip/furybsd-live-settings/files/usr/local/bin/furybsd-init-helper and deals with loading Xorg configuration based on the detected devices on PCI, and with loading virtualization-related drivers

  10. +
  11. The /livecd chroot is exited

  12. +
  13. init.sh from the ramdisk image exits

  14. +
  15. etc/rc from the ramdisk image gets executed as specified in overlays/ramdisk/etc/rc (by what?). It tells the kernel to “reroot” (not “chroot”) into the live filesystem, /livecd using reboot -r

  16. +
  17. From here on, the boot process is the regular FreeBSD boot process with the following particularities:

  18. +
  19. /etc/rc.d/initgfx detects the GPU and loads the appropriate drivers

  20. +
  21. /usr/local/etc/rc.d/localize runs /usr/local/sbin/localize which tries to determine the language of the keyboard, and by proxy, of the system. This currently supports the official Raspberry Pi keyboard and Apple computers which store the keyboard and system language in the prev-lang:kbd EFI variable

  22. +
  23. The slim session manager (login window) is started; when the user is logged in, it starts the script /usr/local/bin/start-hello which starts the desktop session and sets the keyboard and system language based on the information provided by localize in an earlier step

  24. +
+
+

Troubleshooting the Live system early boot process

+
    +
  • Hangs or reboots during replicating the system image to swap-based memdisk. The ISO is damaged. About one out of 10 builds of the ISO have this issue. Simply build a new ISO or wait for the next ISO to be available for download

  • +
  • “Cannot mount tmpfs on /dev/reroot: Operation not supported by device”. Reason unknown. Are needed kernel modules missing?

  • +
+
+
+

Seeing what the system is doing while the graphical boot screen is shown

+

While the graphical boot screen is being displayed you can press Ctrl+T to see what it is doing at that moment in time. By keeping Ctrl+T pressed down you can see what is going on over time. By then pressing ScrLk, you can use PgUp and PgDn to scroll around.

+

The following information will be printed to the screen for the most relevant process based on recency and CPU usage (as decided by proc_compare()):

+
    +
  • load: and the 1 minute load average of the system

  • +
  • cmd: and process name of the most relevant process

  • +
  • Process ID (PID) of that process

  • +
  • State of that process in []. FreeBSD specific wait states are explained in https://wiki.freebsd.org/WaitChannels

  • +
  • Real (r), User (u), and System (s) times (Source)

    +
      +
    • Real is wall clock time - time from start to finish of the call. This is all elapsed time including time slices used by other processes and time the process spends blocked (for example if it is waiting for I/O to complete)

    • +
    • User is the amount of CPU time spent in user-mode code (outside the kernel) within the process. This is only actual CPU time used in executing the process. Other processes and time the process spends blocked do not count towards this figure

    • +
    • Sys is the amount of CPU time spent in the kernel for the process. This means executing CPU time spent in system calls within the kernel, as opposed to library code, which is still running in user-space

    • +
    +
  • +
  • CPU usage in percent

  • +
  • Resident set size (RSS), the amount of memory occupied in RAM by the most relevant process

  • +
+

Example: load: 0.62  cmd: sleep 1739 [nanslp] 2.97r 0.00u 0.00s 0% 2168k

+
+
+

Boot in verbose mode

+

If you would like to observe the details of the boot process, you can start your computer in verbose mode. This allows you to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically.

+

Since helloSystem 0.8.1: To boot in verbose mode, press the v key on your keyboard as soon as the screen becomes grey.

+

Before helloSystem 0.8.1:

+
    +
  1. While the bootloader is running, keep the Backspace key pressed until you see an OK prompt (alternatively, for a short time during boot, it says Hit [Enter] to boot immediately, or any other key for command prompt.. Press the Esc key on your keyboard immediately when you see this)

  2. +
  3. Type unset boot_mute and press the Enter key. This disables the graphical splash screen and results in boot messages being shown

  4. +
  5. Type boot -v and press the Enter key. This results in the system being booted in verbose mode

  6. +
+

The computer should boot into a graphical desktop.

+
+
+

Boot into verbose single-user mode

+

If your computer hangs during booting, you can boot into verbose single-user mode. This allows advanced users, administrators, and developers to inspect the Live system early boot process and to enter commands manually that would otherwise be executed automatically.

+

Since helloSystem 0.8.1: To boot in verbose single-user mode, press the s key on your keyboard as soon as the screen becomes grey.

+

Before helloSystem 0.8.1:

+
    +
  1. While the bootloader is running, keep the Backspace key pressed until you see an OK prompt (alternatively, for a short time during boot, it says Hit [Enter] to boot immediately, or any other key for command prompt.. Press the Esc key on your keyboard immediately when you see this)

  2. +
  3. Type unset boot_mute and press the Enter key. This disables the graphical splash screen and results in boot messages being shown

  4. +
  5. Type boot -v -s and press the Enter key. This results in the system being booted in verbose single-user mode

  6. +
+

The computer should boot into a text console rescue system in which parts of init.sh from the ramdisk image have run.

+
+

Note

+

Single-user mode on the Live system currently is for developers of the Live system only.

+

If you boot the Live system into single-user mode, then you will be dropped into a shell in the ramdisk, and you are expected to manually enter the commands required for the Live system to continue booting which would otherwise be executed by the ramdisk automatically. Specifically, you need to enter everything below the line “Running in single-user mode” in the file overlays/ramdisk/init.sh (or variants thereof). If you just exit the shell without doing this, then the system will be unable to continue booting.

+
+
+
+
+

Graphical desktop start process

+
    +
  1. The system is configured in /etc/rc.conf to start the slim login manager. This also results in Xorg being started

  2. +
  3. slim is configured in /usr/local/etc/slim.conf to start start-hello once the user has logged in, or if autologin has occurred

  4. +
  5. The /usr/local/bin/start-hello shell script starts the various components of the helloSystem desktop

  6. +
+
+

Troubleshooting the graphical desktop start process

+
    +
  • Login manager (slim) says Failed to execute login command. Check the /usr/local/bin/start-hello shell script.

  • +
+
+
+
+

Installed system boot process

+

The boot process is the regular FreeBSD boot process. Please refer to The FreeBSD Booting Process for more information.

+
+
+

Boot Mute

+

Setting boot_mute="YES" in /boot/loader.conf causes FreeBSD to show a boot splash screen instead of kernel messages during early boot. However, as soon as scripts from the ramdisk and init get executed, they tend to write output to the screen and manipulate it with vidcontrol and conscontrol, which results in the boot splash screen to disappear before the graphical desktop environment is started.

+

Since helloSystem targets a broad audience including non-technical users, the following behavior is intended:

+
    +
  • By default, show no textual boot messages

  • +
  • Upon specific request by the user, show boot messages (for debugging, development, and system administration)

  • +
  • Show a graphical splash screen during the entire boot process, all the way until the graphical desktop is started

  • +
+

To achieve this, helloSystem uses a combination of the following techniques:

+
    +
  • Read the boot_mute kernel environment variable and adjust the userland boot process accordingly

  • +
  • Modify /etc/rc to run conscontrol delete ttyv0 and redirect all of its output to /dev/null if boot_mute is set to YES

  • +
  • Modify /etc/rc.shutdown to redirect all of its output to /dev/null if boot_mute is set to YES

  • +
  • Replace the /sbin/vidcontrol command by a dummy that does nothing to prevent error messages related to setting the resolution of the text-mode console from ending the boot splash early

  • +
  • Replace the /etc/ttys file with an empty file to not spawn login shells on the text-mode console

  • +
  • Commenting out the line that ends in /dev/console in /etc/syslog.conf to prevent boot from being visually interrupted by syslog messages

  • +
  • On the Live system, modify all scripts in the ramdisk to redirect all of their output to /dev/null if boot_mute is set to YES

  • +
+
+

Note

+

Please note that if any errors are displayed on the screen during the boot process, the boot splash may still end early. In this case, the reason for the error message needs to be identified, and the message needs to be silenced.

+
+

To see boot messages, set boot_mute="NO" in /boot/loader.conf or at the bootloader prompt.

+
+
+

Modifying bootloader scripts

+

The bootloader executes lua scripts as part of the boot process. This is not documented extensively in the FreeBSD documentation.

+

To work on the lua scripts, it is useful to

+
    +
  • Use VirtualBox

  • +
  • Install helloSystem to a virtual hard disk

  • +
  • In the installed system, edit /boot/loader.conf to contain beastie_disable=NO and increase the timeout

  • +
+

Possibly there is also a way to use a lua interpreter on the booted system to work on and debug the lua scripts, but this is currently unknown. The following does not seem to work:

+
% lua54 ./loader.lua 
+lua54: ./core.lua:447: attempt to index a nil value (global 'loader')
+stack traceback:
+        ./core.lua:447: in field 'isSystem386'
+        ./core.lua:56: in local 'recordDefaults'
+        ./core.lua:525: in main chunk
+        [C]: in function 'require'
+        ./cli.lua:31: in main chunk
+        [C]: in function 'require'
+        ./loader.lua:36: in main chunk
+        [C]: in ?
+
+
+

The /boot directory also contains files referring to 4th, those are all unused, misleading, and can be removed. Besides files with 4th in their name this also includes files ending in .rc.

+
mount -uw /
+cd /boot
+find . -name '*4th*' -exec rm {} \;
+rm *.rc
+
+
+

Removing the misleading files makes it easier to see which code actually gets executed. All the scripting is essentially happening in /boot/lua.

+

One can then edit the scripts in /boot/lua, and boot the virtual machine quickly into single user mode, make edits, and repeat.

+

It seems that /boot/lua/loader.lua is the entry point that is hardcoded into the bootloader.

+

So if we would like to run a “hello world”, we would need to place it at that path.

+

/boot/lua/loader.lua includes other lua files, e.g., local core = require("core").

+

/boot/lua/core.lua contains the following function:

+
function core.isMenuSkipped()
+        return string.lower(loader.getenv("beastie_disable") or "") == "yes"
+end
+
+
+

/boot/lua/loader.lua uses this function to display the boot menu if beastie_disable is not set:

+
if not core.isMenuSkipped() then
+        require("menu").run()
+else
+        -- Load kernel/modules before we go
+        config.loadelf()
+end
+
+
+

Directly above this, there is

+
try_include("local")
+
+
+

which seems to suggest that we can hook in our own code there by creating a new file /boot/lua/local.lua with our custom code:

+

https://github.com/helloSystem/ISO/blob/experimental/overlays/boot/boot/lua/local.lua

+
    +
  • https://man.freebsd.org/cgi/man.cgi?query=core.lua documents the functions in core.lua

  • +
  • https://man.freebsd.org/cgi/man.cgi?query=menu.lua&sektion=8 documents menu.lua, including an example for how to replace the default boot menu with a simple boot menu, and en example for how to add another option to the default FreeBSD welcome menu

  • +
+

This allows us to

+
    +
  • Load the kernel and modules without showing text on screen

  • +
  • Boot in verbose mode if the V key is pressed

  • +
  • Boot in single user mode if the S key is pressed

  • +
  • Show the FreeBSD bootloader menu if backspace is pressed

  • +
  • Adjust colors for verbose and single user boot

  • +
+

The lua environment in the FreeBSD bootloader has some functions starting with loader. that seem to be undocumented, but we can list them by looking at the source code:

+
    +
  • loader.command()

  • +
  • loader.perform()

  • +
  • loader.command_error()

  • +
  • loader.interpret()

  • +
  • loader.parse()

  • +
  • loader.getchar()

  • +
  • loader.ischar()

  • +
  • loader.gets()

  • +
  • loader.time()

  • +
  • loader.delay()

  • +
  • loader.getenv()

  • +
  • loader.setenv()

  • +
  • loader.unsetenv()

  • +
  • loader.printc()

  • +
  • loader.openfile()

  • +
  • loader.closefile()

  • +
  • loader.readfile()

  • +
  • loader.writefile()

  • +
  • loader.term_putimage()

  • +
  • loader.fb_putimage()

  • +
  • loader.fb_setpixel()

  • +
  • loader.fb_line()

  • +
  • loader.fb_bezier()

  • +
  • loader.fb_drawrect()

  • +
  • loader.term_drawrect()

  • +
+

This list was generated on a system on which the FreeBSD source code is installed in /usr/src using the following command:

+
grep -r '^lua_' /usr/src/stand/liblua/*.c | cut -d ":" -f 2 | sed -e 's|lua_|loader.|g' | sed -e 's|loader.State \*L||g' | sed -e 's|^|* \`|g' | sed -e 's|)|)\`|g'
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/building.html b/developer/building.html new file mode 100644 index 00000000..150f2404 --- /dev/null +++ b/developer/building.html @@ -0,0 +1,241 @@ + + + + + + Building the Live ISO — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Building the Live ISO

+

helloSystem get assembled from upstream FreeBSD components, components in the FreeBSD packages system, and custom components from the helloSystem repositories.

+

helloSystem is not a derivative (fork) of FreeBSD (like e.g., GhostBSD), but strives to be “real FreeBSD” as far as possible. Hence, helloSystem does not build all source code, but relies on binaries provided by FreeBSD wherever possible.

+

helloSystem is distributed as an installable Live ISO file. This file gets built by the hello Live ISO builder.

+

Continuous builds of the ISO get produced automatically on a continuous integration (CI) system for each git commit.

+

However, it is also possible to build the ISO locally, which is especially handy for testing and development.

+
+

System requirements for building

+
    +
  • A FreeBSD or helloSystem installed on the computer. The FreeBSD version needs to match the FreeBSD version of the helloSystem ISO being built (e.g., 13.2-RELEASE)

  • +
  • 2 GHz dual core processor

  • +
  • 4 GiB RAM (system memory)

  • +
  • 50 GB of hard-drive space

  • +
  • Either a CD-RW/DVD-RW drive or a USB port for writing the Live media

  • +
  • A fast internet connection

  • +
+
+
+

Building the Live ISO

+
$ sudo pkg install -y pkg git zsync wget bash zip devel/py-xdg librsvg2 ca_root_nss
+$ git clone https://github.com/helloSystem/ISO
+$ cd ISO
+$ sudo ./build.sh hello
+
+
+

The resulting Live ISO will be located at /usr/local/furybsd/iso/.

+
+
+

Writing Live Media to USB drive

+
$ sudo dd if=/usr/local/furybsd/iso/FuryBSD-12.1-XFCE.iso of=/dev/daX bs=4m status=progress
+
+
+

Replace daX with the respective device name.

+
+

Warning

+

This will overwrite the entire contents of the selected device. Take extra caution when determining the device name.

+

This operation cannot be undone.

+
+

For end users, there is the Create Live Media application that can conveniently download and write Live Media with a graphical user interface.

+
+
+

Burning Live Media to DVD

+

You can use the cdrecord command line tool to burn Live Media to DVD.

+
# pkg install cdrtools
+# cdrecord /usr/local/furybsd/iso/<filename>.iso
+
+
+
+
+

Customizing the Live ISO

+

helloSystem is built in a way that makes it trivially easy to apply your own changes to it.

+
+

Different desktop environments

+

Simply replace hello with the name of one of the supported desktop environments, such as

+
    +
  • cinnamon

  • +
  • gnome

  • +
  • kde

  • +
  • openbox

  • +
  • xfce

  • +
+

While the resulting image will be built on the same infrastructure, those will not be helloSystem builds and are not supported by the project. Still, the community may find them useful.

+
+
+

Customizing the set of packages

+

To add or remove packages, edit settings/packages.<name> and rebuild the image. Substitute <name> with hello or one of the desktop environments mentioned above.

+
+
+

Customizing configuration

+

Configuration is applied using transient packages that get generated on-the-fly from the contents of the overlays/ directory.

+
    +
  • Overlays for the boot disk are stored in overlays/boot

  • +
  • Overlays for the initial ramdisk are stored in overlays/ramdisk

  • +
  • Overlays for the main filesystem are stored in overlays/uzip/<overlay>/files/. Note that to be included in a build, the overlay called <overlay> must be listed in settings/overlays.<name>. Substitute <name> with hello or one of the desktop environments mentioned above.

  • +
+

For example, a file that is supposed to appear in /usr/local/bin/app on the main filesystem could be stored in overlays/uzip/hello/files/usr/local/bin/app.

+
+
+

Customizing the build script

+

If a file called settings/script.<name> exists, then it will be executed during the build. Substitute <name> with hello or one of the desktop environments mentioned above. For building helloSystem, settings/script.hello performs actions such as installing applications that are not coming from FreeBSD packages, setting the wallpaper, installing fonts that are not coming from FreeBSD, and so on.

+

All desktop-specific build steps should go into this file.

+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/contact.html b/developer/contact.html new file mode 100644 index 00000000..437b02f3 --- /dev/null +++ b/developer/contact.html @@ -0,0 +1,157 @@ + + + + + + Contact — helloSystem documentation + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Contact

+
+

Discussions

+

The helloSystem Discussions forum is a great place to interact with helloSystem users and developers. If you have questions, feel free to ask in “Q&A”. If you are running helloSystem, we’d be happy to hear from you in the “Show and tell” section.

+
+
+

Chat

+

You can also meet other helloSystem users and developers at #helloSystem:matrix.org from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel #helloSystem on irc.libera.chat. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses.

+

In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers and come by only once in a while.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/contributing.html b/developer/contributing.html new file mode 100644 index 00000000..25496def --- /dev/null +++ b/developer/contributing.html @@ -0,0 +1,180 @@ + + + + + + Contributing — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Contributing

+

If you have found this page, chances are that you are considering to to contribute to this project.

+

Awesome!

+

This is a small, purely volunteer-driven project, so your contributions are highly welcome.

+
+

How to get started?

+
    +
  • Download an experimental live ISO from https://github.com/helloSystem/ISO/releases

  • +
  • Look through the GitHub Issues sections of the projects within https://github.com/helloSystem/

  • +
  • A great way to get started is to comment on some GitHub issues. Also feel free to open new ones. We use GitHub Issues as a means of discussion and keeping track of everything, so don’t hesitate to use them. General topics not related to any particular component go to https://github.com/helloSystem/hello/issues

  • +
  • Especially have a look at issues marked with . Here your contributions would be especially helpful, but of course your contributions to other tickets are more than welcome, too

  • +
  • There is a liberal amount of FIXME and TODO in the source code. Reducing the number of those is always highly welcome

  • +
+
+
+

Our project values

+
    +
  • Please see https://github.com/helloSystem/hello for the general philosophy of the project

  • +
  • Always keep in mind that our philosophy is “simple > complicated”, “less, but better”

  • +
  • We prefer small pull requests that change one thing each, rather than large ones that do many things at once

  • +
  • Please avoid complex code structures that require deep C++ knowledge (e.g., avoid subclassing, pointer arithmetic,… where possible)

  • +
  • We appreciate code with comments that explain why we are doing something

  • +
  • Our policy is to merge PRs liberally but roll back changes that cause breakage quickly. master must always build and not crash

  • +
+
+
+

Areas we especially need help with

+

Here is what we need help with: Issues flagged with help-wanted, and of course other contributions are also welcome.

+

Maybe you’d like to look into one of these: Issues flagged with good-first-issue.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/developer-tools.html b/developer/developer-tools.html new file mode 100644 index 00000000..173871bd --- /dev/null +++ b/developer/developer-tools.html @@ -0,0 +1,155 @@ + + + + + + Developer Tools — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Developer Tools

+

Starting with helloSystem 0.7.0, compilers, headers, .o files and other files for developers are not shipped on the helloSystem Live ISO by default in order to reduce the ISO size. You need to install the Developer Tools from developer.img which is a separate download from the same location you obtained the Live ISO (e.g., for 0.7.0, this is https://github.com/helloSystem/ISO/releases/tag/r0.7.0).

+

The Developer folder in the Applications folder contains useful development tools for use with helloSystem.

+
    +
  • PyCharm CE: A powerful integrated development environment (IDE) for the Python language which is used for many of the utilities and preferences applications in helloSystem

  • +
  • Qt Creator: The integrated development environment (IDE) for Qt-based applications, such as Menu, Dock, and Filer. Includes graphical user interface editors for QtWidgets-based user interfaces (such as Menu and Filer) using .ui files and for Qml-based user interfaces (such as Dock) using .qml files. The user interfaces generated in Qt Creator can be used in Qt application written in C++ or Python

  • +
  • LiteIDE: An integrated development environment (IDE) for the Go language. Go is recommended for long-running processes such as servers and for processes with parallelism

  • +
  • Zeal: A browser for documentation sets, also known as “docsets”. Docsets can be downloaded from within the application and are available for many languages and environments, including Python, Qt, and Go.

  • +
+

To minimize the initial download size of the helloSystem image, the applications in the Developer folder need to be downloaded prior to first use. You will be guided through this automatic process when you launch these applications for the first time. After the applications have been downloaded, you can use them without an active network connection.

+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/distributions.html b/developer/distributions.html new file mode 100644 index 00000000..75c8ee46 --- /dev/null +++ b/developer/distributions.html @@ -0,0 +1,153 @@ + + + + + + Note to distributions — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Note to distributions

+

helloSystem is designed, developed, and tested as an integrated operating system. It is not a desktop environment designed to run on various operating systems or distributions.

+

Focusing on building one coherent operating system greatly simplifies the code, the development and testing process, and ultimately increases quality.

+

Please do not try to include helloSystem in third-party distributions. While you are free to use components from helloSystem for your own projects as far as their respective licenses permit, please be aware that we may not always be interested in contributions that increase portability, especially if they would increase complexity significantly.

+

Please do not call your derivatives “hello” or “helloSystem”. In order to keep support and maintenance burden low, please give clearly distinguishable names to your derivatives.

+

You may want to include the desktop components of helloSystem, the helloDesktop “Desktop Environment” (collection of individual components, really).

+

For example, work is being done to bring the helloDesktop components to FreeBSD: https://wiki.freebsd.org/helloDesktop. But please note that “FreeBSD with helloDesktop” is not the same as helloSystem.

+

Please do not hesitate to contact the team if you have questions regarding this policy.

+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/filer-context-menus.html b/developer/filer-context-menus.html new file mode 100644 index 00000000..36a1f473 --- /dev/null +++ b/developer/filer-context-menus.html @@ -0,0 +1,1093 @@ + + + + + + Extending Filer context menus — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Extending Filer context menus

+

It is possible to extend Filer context menu items by writing files that conform to the DES-EMA (Desktop Entry Specification - Extension for Menus and Actions). Apparently this format was never adopted as a standard, so it is documented here. The information on this page is based on draft 0.15 from November 23, 2010.

+
+

Note

+

Filer inherits its DES-EMA implementation from PCManFM, but may use a different format in the future.

+

It still needs to be verified which portions have actually been implemented in Filer, so currently this page describes functionality which may or may not be implemented in Filer. Corrections are welcome.

+
+

Changes take effect after a restart of Filer. To restart Filer:

+
    +
  1. Press Ctrl+Alt+Esc and click on the Desktop to force-quit it

  2. +
  3. Press Alt+F2 and enter launch Filer --desktop to start it again

  4. +
+
+

Examples

+
+

An example of an action

+

In the following example, we define an “Open terminal here” action, which has three profiles. These profiles are thought to be able to open a suitable terminal in most situations. They are ordered, and so only the first profile whose conditions are met at runtime will be used in the Filer context menu.

+
[Desktop Entry]
+Name=Open terminal here
+Tooltip=Open a new terminal here
+Icon=terminal
+Profiles=on_folder; on_file; on_desktop;
+
+[X-Action-Profile on_folder]
+Name=open a terminal on the current folder or on the selected folder
+MimeTypes=inode/directory;
+# note that this means strictly less than 2, as the equal sign is part of the DES syntax
+SelectionCount=< 2
+Exec=launch QTerminal --workdir %d
+
+[X-Action-Profile on_file]
+Name=open a terminal in the folder which contains selected items
+MimeTypes=all/allfiles;
+Exec=launch QTerminal --workdir $(echo %D | cut -d ' ' -f 1)
+
+[X-Action-Profile on_desktop]
+Name=open a terminal of the desktop
+Schemes=x-nautilus-desktop;
+Exec=launch QTerminal --workdir ~/Desktop
+
+
+

This may be saved, e.g. as ~/.local/share/file-manager/actions/open-terminal.desktop file.

+

Note that this is only an example of how an action may be defined in a .desktop file. It has not been deeply tested, and there is most probably more efficient ways of opening a terminal somewhere…

+
+
+

An example of a menu

+

Suppose we would like to place the menu elements into a submenu. To achieve this, we create a second .desktop file with following content:

+
[Desktop Entry]
+Type=Menu
+Name=Terminal menu
+Tooltip=Terminal submenu
+Icon=terminal-group
+ItemsList=open-terminal;
+
+
+

This may be saved, e.g. as ~/.local/share/file-manager/actions/menu-terminal.desktop file.

+
+
+
+

Desktop file

+
+

Desktop file format

+

This specification relies on the common syntax defined in the Desktop Entry Specification. Here is a summary of some main points:

+
    +
  • Files are UTF-8 encoded.

  • +
  • All keys and values are case sensitive.

  • +
  • The [Desktop Entry] group must be the first group of the file.

  • +
  • Boolean values must be true or false.

  • +
  • Strings, in strings lists, are semicolon-separated; the list itself ends with a semicolon.

  • +
+
+
+

Desktop file identifier

+

In the rest of this specification, when a desktop file needs to be identified, we are using the basename of the file, without the extension, calling this a desktop_file_id.

+
+
+

Desktop files search path

+

.desktop files are searched for in XDG_DATA_DIRS/file-manager/actions directories. All used _desktop_file_id_s should be unique.

+
+
+
+

Managed objects

+
+

Actions and profiles

+

This specification essentially defines how actions are to be described in .desktop files in order to be displayed in the Filer context menu, and available as selectable items to be executed by the user.

+

An action might be defined as a group of several elements:

+
    +
  • the displayable part: label, tooltip, icon

  • +
  • conditions which have to be met in order the item be actually displayed in the context menu; these conditions are checked against the current Filer selection; these might be mimetypes, scheme, etc.

  • +
  • the command to be executed, and its parameters.

  • +
+

As a user might want have the very same action execute a different command depending of the current environment at runtime, we define that an action is built on one to several profiles, where each profile is defined by:

+
    +
  • conditions which have to be met in order the item be actually displayed in the context menu; these conditions are checked against the current Filer selection; these might be mimetypes, scheme, etc.

  • +
  • the command to be executed, and its parameters.

  • +
+
+ +
+

Conditions

+

As we are dealing with three level of objects (menus, actions, profiles), it appears that whether a condition must be defined at one of these levels is rather an arbitrary decision.

+

We so say that conditions may appear in any of these levels:

+
    +
  • When a condition appears in a menu definition, the result of its evaluation recursively applies to all included items. If the condition is not met, then neither the menu nor any of its subitems will be displayed.

  • +
  • When a condition appears in an action definition, the result of its evaluation applies to all its profiles. If the condition is not met, then the action will not be candidate; the profiles will even not be considered.

  • +
+
+
+
+

Action definition

+

An action must be entirely defined in one .desktop file. The action is identified by the desktop_file_id in which it is defined.

+

Only valid actions are displayed in the Filer context menu.

+

To be valid, an action must have a non-empty name, and at least one profile must be found valid at runtime.

+

As stated

+

An action is primarily defined in the [Desktop Entry] group, which has following keys:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Key****Description****Value type****Req ?**
`Type`This define this `.desktop` file as an Action definition. +Defaults to `Action`.stringno
`Name`The label of the action, as it should appear in the context menu. +localestringYES
`Tooltip`The tooltip associated with the item in the context menu. +Defaults to empty.localestringno
`Icon`The name of a themed icon, or the path to an icon. +Defaults to empty.localestringno
`Description`A free description of the action, which may be used in the management UI, in a Web page, and so on. +Defaults to empty.localestringno
`SuggestedShortcut`A shortcut suggested for the action. +Please note that this might be only a suggestion as the shortcut may be already reserved for another use. Implementation should not override an already existing shortcut to define this one. +The format may look like `a` or `F1`. +Defaults to empty.stringno
`Enabled`Whether the item is candidate to be displayed in the context menu. +A user might define many actions or menus, and choose to only enable some of them from time to time. +Defaults to `true`.booleanno
`Hidden`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): `Hidden` should have been called `Deleted`. It means the user deleted (at his level) something that was present (at an upper level, e.g. in the system dirs). It's strictly equivalent to the `.desktop` file not existing at all, as far as that user is concerned. This can also be used to "uninstall" existing files (e.g. due to a renaming) - by letting make install install a file with `Hidden=true` in it. +Defaults to `false`.booleanno
`TargetContext`Whether the item targets the Filer context menu. +This means that the action will be candidate if defined conditions met the current selection. +Defaults to `true`.booleanno
`TargetLocation`Whether the item targets a location menu, if Filer supports this. +This means that the action will be candidate if defined conditions met the current location. +Defaults to `false`.booleanno
`TargetToolbar`Whether the item targets the toolbar, if Filer supports this. +Note that, in order to keep a nice and stable UI, the Filer may reserve toolbar actions to those only targeting the current folder. +Defaults to `false`.booleanno
`ToolbarLabel`The label to be displayed in the toolbar, if it is not the same that those displayed in context menu. +Defaults to `Name` value.localestringno
`Profiles` +

The ordered list of the profiles attached to this action.
+Each element of this strings list may be:

+
    +
  • a _profile_id_, i.e. the id of a profile, as an ASCII string

  • +
  • a command to be executed, if the string is enclosed between square brackets ([…]).

  • +
+

So, Profiles key has a dynamic value: if an element of the string list is enclosed between square brackets ([…]), it is considered as a command, optionally with

+

After reading, and maybe evaluation of dynamic elements, profiles identified by the Profiles value, but not found in this .desktop file, are just ignored.

+

It is up to the implementation to decide whether profiles found in this .desktop file, but not identified in this list, should or not be attached to the action.
+It could be for example an acceptable fallback to append these “orphan” profiles at the end of the list of profiles.

+

Another choice might also be:

+
    +
  • at runtime, only attach to the action profiles which are listed in this Profiles key

  • +
  • while a management UI may load all profiles found in the .desktop file.

  • +
+
strings listYES
+
+
+

Profile definition

+

Profile is identified by its profile_id, as an ASCII string.

+

Each profile defined in the Profiles key, whether statically by its profile_id identifier, or as the result of an evaluated command, must be defined in a [X-Action-Profile _profile_id_] group.

+

When several profiles are defined for an action, only the first valid profile whose conditions are met at runtime is selected to be made available in the context menu.

+

Defining several profiles let so the user have an ordered OR-ed set of conditions, i.e. have one action be available if one set of conditions is met, OR this same action, though most probably with a slightly different command, be available if another set of conditions is met, and so on.

+

In order to be valid, a profile must at least have an executable command.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + +
**Key****Description****Value type****Req ?**
`Name`The name of the profile; this name is not displayed in the context menu, and should just be thought as a convenience for the management UI. It may also be seen as a good place for a description of what the profile exactly does. +Defaults to empty.localestringno
`Exec`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): command to execute, possibly with arguments +stringYES
`Path`The working directory the program should be started in. +Defaults to base directory of the current selection, which happens to be the value of `%d` parameter.stringno
`ExecutionMode`Execution mode of the program. +This may be chosen between following values: +
    +
  • Normal: Starts as a standard graphical user interface

  • +
  • Terminal: Starts the preferred terminal of the graphical environment, and runs the command in it

  • +
  • Embedded: Makes use of a special feature of the file manager which allows a terminal to be ran inside of it; an acceptable fallback is Terminal

  • +
  • DisplayOutput: The ran terminal may be closed at end of the command, but standard streams (stdout, stderr) should be collected and displayed; an acceptable fallback is Terminal

  • +
+

Defaults to Normal.

stringno
`StartupNotify`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): if `true`, it is KNOWN that the application will send a "remove" message when started with the DESKTOP_STARTUP_ID environment variable set. If `false`, it is KNOWN that the application does not work with startup notification at all (does not shown any window, breaks even when using StartupWMClass, etc.). If absent, a reasonable handling is up to implementations (assuming false, using StartupWMClass, etc.). (See the [Startup Notification Protocol Specification](http://www.freedesktop.org/Standards/startup-notification-spec) for more details). +Only relevant when `ExecutionMode=Normal`. +Defaults to `false`.booleanno
`StartupWMClass`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): if specified, it is known that the application will map at least one window with the given string as its WM class or WM name hint (see the [Startup Notification Protocol Specification](http://www.freedesktop.org/Standards/startup-notification-spec) for more details). +Only relevant when `ExecutionMode=Normal`. +Defaults to empty.stringno
`ExecuteAs`The user the command must be ran as. The user may be identified by its numeric UID or by its login. +The implementation should ignore a profile defining a non-existing UID or login as a value for the `ExecuteAs` key. +The implementation might require the presence of a well-configured subsystem (e.g. sudo). +Defaults to empty: the command will be executed as the current user.stringno
+
+ +
+

Conditions

+

As a remainder of that has been said above, each one of the following conditions may appear in a menu, an action or a profile.

+

Conditions are AND-ed, that is all specified conditions which appear in a menu, an action or a profile must be met in order the item be considered as a candidate.

+

When a condition is defined as a string list, elements of the list are considered as OR-ed (but for When an element of the string list is negated, it must be considered as an AND condition.

+

Example:

+
+

The line “MimeTypes = image/*; video/*;” must be read as “condition is met if each file in the current selection has a mimetype of image/* or of video/*”

+

And the line “MimeTypes = image/*; video/*; !image/bmp” must be read as “condition is met if each file in the current selection has a mimetype of image/* or of video/*, but must not have the image/bmp mimetype”.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Key****Description****Value type****Req ?**
`OnlyShowIn`, +`NotShowIn`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): a list of strings identifying the environments that should display/not display a given desktop entry. Only one of these keys, either `OnlyShowIn` or `NotShowIn`, may appear in a group (for possible values see the [Desktop Menu Specification](http://www.freedesktop.org/Standards/menu-spec)). +Defaults to show anywhere.strings listno
`TryExec`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): path to an executable file on disk used to determine if some program is actually installed. If the path is not an absolute path, the file is looked up in the $PATH environment variable. If the file is not found or is not executable, this condition evals to `false`. +Defaults to successful.stringno
`ShowIfRegistered`The well-known name of a DBus service. +The item will be candidate if the named service is registered on session DBus at runtime. +Defaults to successful. + + + + + + + +
_Comment:__This is the equivalent of KDE `X-KDE-ShowIfRunning` key._
+
stringno
`ShowIfTrue`A command which, when executed, should output a string on stdout. +The item will be candidate if the outputted string is equal to `true`. +Example: `[ -r %d/.svn/entries ] && echo \"true\` +Defaults to successful. + + + + + + + +
_Comment:__This is the equivalent of KDE `X-KDE-ShowIfDBusCall` key, extended to any command able to output a string._
+
stringno
`ShowIfRunning`The name of a process. +The item will be candidate if the process name is found in memory at runtime. +Defaults to successful.stringno
`MimeTypes`From [DES](http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html): the MIME type(s) supported by this application. +Each mimetype may be fully specified (e.g. `audio/mpeg;`), or as a group (e.g. `image/*;`). +Mimetypes may be negated (e.g. `audio/*; !audio/mpeg;`). +Some of well-known mimetypes include: +
    +
  • all/all: matches all items

  • +
  • all/allfiles: matches only files

  • +
  • inode/directory: matches only directories

  • +
+

* character is accepted as a wildcard in only two cases:

+
    +
  • when used alone as in *;, i.e. when used as a group wildcard without subgroup,

  • +
  • when used as the subgroup wildcard, after the / character, as in image/*.

  • +
+

Defaults to *;, which happens to be exactly equivalent to all/all or to all/*.

+ + + + + + + + +
_Comment:__This is the equivalent of `ServiceTypes`, `X-KDE-ServiceTypes`, `ExcludeServiceTypes` KDE and `MimeType` freedesktop keys._
+
strings listno
`Basenames`List of basenames the selection should match in order this profile be selected. +`*` character is accepted as a wildcard. +Basenames may be negated (e.g. `*; !*.h;`). +Defaults to `*;`.strings listno
`Matchcase`Whether the above `Basenames` is case sensitive. +Defaults to `true`.booleanno
`SelectionCount`Whether this profile may be selected depending of the count of the selection. +This is a string of the form `{'<'|'='|'>'} number`. +Examples of valid strings are: `=0`, `> 1`, `< 10`. +Defaults to `>0`.stringno
`Schemes`The list of schemes the selection must satisfy in order the item be selected. +Examples of well-known schemes are: +
    +
  • file

  • +
  • sftp

  • +
  • smb

  • +
  • http

  • +
+

Schemes may be negated, e.g. !http;.
+Defaults to *;.

+ + + + + + + +
_Comment:__This is the equivalent of `X-KDE-Protocol` and `X-KDE-Protocols` KDE keys._
+
strings listno
`Folders`A list of paths the current base directory must be in in order the item be selected. +A folder path may be negated (e.g. `/data; !/data/resources/secret;`). +`*` character is accepted as a wildcard, replacing any level(s) of subdirectory (e.g. `/music; /video; !*/secret;`). +Also note that a terminating `/*` is always implied by the definition of this key. +Last, note that different implementations today widely consider that, for a directory point of view, having no selection is roughly the same that selecting the currently opened folder. If this makes a difference for your action, thenstrings listno
`Capabilities`A list of capabilities each item of the selection must satisfy in order the item be candidate. +Capabilities may be negated. +Please note that each element of the specified list must be considered as ANDed, i.e. if we have `Capabilities=Readable;Writable;!Local`, then each element of the selection must be both readable AND writable AND not local. +Capabilities have to be chosen between following predefined ones: +
    +
  • Owner: current user is the owner of the selected items

  • +
  • Readable: selected items are readable by user (probably more useful when negated)

  • +
  • Writable: selected items are writable by user

  • +
  • Executable: selected items are executable by user

  • +
  • Local: selected items are local

  • +
+

Defaults to an empty list (do not care of capabilities).

+ + + + + + + +
_Comment:__This is the equivalent of `X-KDE-Require` KDE key._
+
strings listno
+
+
+

Parameters

+
+

Parameters expansion

+

Whenever parameters are said to be accepted, they will be replaced at run-time.

+

It should be noted by the implementation that items, actions or menus, which were considered valid at load time, may become invalid after parameters expansion, due, for example, to a label becoming empty.

+

Also, this specification doesn’t make any assumption about whether a parameter is relevant in a given situation, or secure, or may be used several times, or so. It instead considers that this sort of check is up to the action creator.

+

The implementation should take care of correctly shell-escape the substituted values, so that it should not be needed for the action creator to use any sort of quotes to handle spaces in filenames.

+
+
+

Multiple execution

+

The action creator may want its command be executed once, giving it the list of selected items as argument.

+

Or the action creator may want its command be repeated for each selected item, giving to each execution a different item as argument.

+

Actually, the command defined in the Exec key will be executed once, or repeated for each selected item, depending of the form of arguments.

+

Though some parameters are not sensible to the count of the selection (e.g. %c, the selection count itself), most have two declensions:

+
    +
  • a “singular” one, e.g. %b, the basename of the selected item

  • +
  • a “plural” one, e.g. %B, a space-separated list of the basenames of selected items

  • +
+

When the selection is empty or contains only one element, and from this topic point of view, these two forms are exactly equivalent.

+

When the selection contains more than one item:

+
    +
  • if the first relevant parameter found in the Exec key is of a singular form, then the implementation should consider that the command is only able to deal with one item at a time, and thus that it has to be ran one time for each selected item;

  • +
  • contrarily, if the first relevant parameter found is of the plural form, then the implementation should consider that the command is able to deal with a list of items, and thus the command should be executed only once;

  • +
  • if all found parameters are “irrelevant”, then the default is to consider that the command should be executed only once.

  • +
+

Example:

+
+

Say the current folder is /data, and the current selection contains the three files pierre, paul and jacques.

+

If the Exec key is echo %b, then the following commands will be run:
+echo pierre
+echo paul
+echo jacques

+

If the Exec key is echo %B, then the following command will be run:
+echo pierre paul jacques

+

If the Exec key is echo %b %B, then the following commands will be run:
+echo pierre pierre paul jacques
+echo paul pierre paul jacques
+echo jacques pierre paul jacques

+

If the Exec key is echo %B %b, then the following commands will be run:
+echo pierre paul jacques pierre
+The basename used is the one of the first item of the selected items list as provided by the Filer. There is only a small chance that it would be those of the first visually selected item, and there is contrarily great chances that it would not be predictable at all.

+

Even if the chosen parameter is the same for all selected items, the behavior is identical.
+If the Exec key is echo %d %B, then the following commands will be run:
+echo /data pierre paul jacques
+echo /data pierre paul jacques
+echo /data pierre paul jacques
+which obviously doesn’t make many sense.

+

As the last three examples show up, action creator should avoid to mix singular and plural forms, unless they know what they are doing, whether it doesn’t make sense or this may lead to unwaited results.

+

Nonetheless, mixing singular and plural forms, though we warn against, is not an error. As a counter example, there may be some situations where a command-line of the form echo %B %d would be useful. In that case, the following command would be run:
+echo pierre paul jacques /data
+It is left as an exercise for the reader to find a use case.

+
+

The word “first” in the following table makes so reference to the case where the singular form parameter is used in a plural form command. We recall one more time that which is the “first” element is not specified, and, most probably, rather unpredictable.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Parameter****Description****Said form**
%b(first) basenamesingular
%Bspace-separated list of basenamesplural
%ccount of selected itemsirrelevant
%d(first) base directorysingular
%Dspace-separated list of base directory of each selected itemsplural
%f(first) file namesingular
%Fspace-separated list of selected file namesplural
%hhostname of the (first) URIirrelevant
%mmimetype of the (first) selected itemsingular
%Mspace-separated list of the mimetypes of the selected itemsplural
%nusername of the (first) URIirrelevant
%ono-op operator which forces a singular form of execution when specified as first parameter, +ignored elsesingular
%Ono-op operator which forces a plural form of execution when specified as first parameter, +ignored elseplural
%pport number of the (first) URIirrelevant
%sscheme of the (first) URIirrelevant
%u(first) URIsingular
%Uspace-separated list of selected URIsplural
%w(first) basename without the extensionsingular
%Wspace-separated list of basenames without their extensionplural
%x(first) extensionsingular
%Xspace-separated list of extensionsplural
%%the "%" characterirrelevant
+
+
+
+

Building the whole hierarchy

+

The processus described here is only a sort of meta-algorithm, whose only goal is to better specify how the menus and actions should be laid out in the final hierarchy.

+

The implementer might take advantage of preparing once the whole hierarchy of the menus and actions:

+
    +
  • to minimize the time spent in the parsing of all files;

  • +
  • to identify and eliminate duplicate _desktop_file_id_s,

  • +
  • to eliminate invalid menus and actions.

  • +
+
    +
  1. as described in desktop_file_ids and invalid .desktop files; implementation so obtains a flat list of menus or actions;

  2. +
  3. recursively build the hierarchy; this merely consists in the build of the hierarchy as a tree of menus and actions, where each desktop_file_id addressed as the subitem of a menu consumes this same id from the flat list

    +
      +
    • if the level-zero order (which is not specified here, but see desktop_file_id addressed in the level zero consumes this same id from the flat list;

    • +
    • else, if might be reasonable to start with an empty tree;

    • +
    +
  4. +
  5. at the end, implementation stays with:

    +
      +
    • the output tree with some menus at the root;

    • +
    • some actions, left in the input flat list because they were not addressed by any menu; these left actions should be added to the level zero of the hierarchy (though in a unspecified order)

    • +
    • some menus, left in the input flat list because their subitems were not found; as these menus happen to be empty, they must be considered as invalid.

    • +
    +
  6. +
+

After this built phase, the resultant tree only contains valid (before runtime parameters expansion) menus and actions.

+

So, menus or actions may appear at the level zero of the whole hierarchy for only two reasons:

+
    +
  1. because they are explicitly addressed by the level-zero configuration, if the implementation defines it; this may concern menus and actions;

  2. +
  3. because these items were not addressed by any menu (but this may only concern actions).

  4. +
+
+
+

The level-zero case

+

Though not strictly an action or a menu definition, the level-zero issue might be easily solved by this specification. The implementation is free to implement it or not.

+

Ordering the elements which have to be displayed at the level-zero of the Filer context menu is just a particular case of a menu definition.

+

An implementation might define a level-zero.directory file, which would contain the ordered list of level zero items identified by their desktop_file_id.

+

The [Desktop Entry] section of this level-zero.directory file would so have only one of the following keys:

+ + + + + + + + + + + + + + + +
**Key****Description****Value type****Req ?**
`ItemsList`Same signification asstrings listno
+

The level-zero.directory file may be searched for in XDG_DATA_DIRS/file-manager/actions. The first one found would be used.

+

Not finding a level-zero.directory file should not prevent actions or menus to be displayed. Instead, they just would be displayed in an unspecified, implementation-dependent, order.

+

The name level-zero.directory is chosen to not risk any collision with regular .desktop files.

+
+ +
+

Contributors

+
    +
  • Jonas Bähr

  • +
  • David Faure

  • +
  • Ted Gould

  • +
  • Hong Jen Yee “PCMan”

  • +
  • Michael Pyne

  • +
  • Liam R. E. Quin

  • +
  • Pierre Wieser

  • +
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/geom_rowr.html b/developer/geom_rowr.html new file mode 100644 index 00000000..a6ddd8af --- /dev/null +++ b/developer/geom_rowr.html @@ -0,0 +1,262 @@ + + + + + + geom_rowr kernel module — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

geom_rowr kernel module

+

The geom_rowr kernel module for FreeBSD makes a read-only device writable by combining it with a read-write device.

+
+

Note

+

This kernel module is currently under development and is being tested for adoption in helloSystem.

+
+
+

Use case

+

When creating a Live ISO, we want to use a read-only filesystem (that can reside on a medium that is physically read-only, such as a DVD) but make it appear to the system as if it was read-write (since some parts of the system may not work on a read-only system).

+
+
+

Theory of operation

+

geom_rowr is a FreeBSD kernel module using the GEOM Modular Disk Transformation Framework. It allows you to take a read-only device (e.g. a DVD) and combine it with a read-write device (e.g., a swap-backed md memory disk) to get a new device that contains the data from the read-only device but is writable.

+

It is designed to work with any filesystem, including ZFS. It is compatible with geom_uzip so the read-only filesystem can be compressed with uzip.

+

The principle of operation is as follows:

+
    +
  • Reading a sector from the combined device reads it from the read-only device. Writing a sector writes it to the read-write device

  • +
  • After a sector is written, future reads of that sector are satisfied from the read-write device as it contains the latest version of the sector’s contents

  • +
+

As a result, immediately after creating the combined device, it appears to contain all the data from the read-only device. This means zero wait time for the user.

+
+
+

Test

+

Execute the following commands as root:

+
// Prepare filesystem image
+# dd if=/dev/zero of=test.img bs=1M count=512
+# mdconfig -a -t vnode -f test.img -u 9
+# newfs /dev/md9
+# mount /dev/md9 /mnt
+// Populate the filesystem
+# cp -R /boot/ /mnt
+# umount /mnt
+# mdconfig -d -u 9
+
+// Load kernel module
+# kldload ./geom_rowr.ko
+// prepare the read-only device md0 
+# mdconfig -a -t vnode -o readonly -f test.img -u 0
+// prepare the read-write device md1
+# mdconfig -a -t swap -s 512M -u 1
+// Make sure the geom(8) tool will find the .so
+# cp geom_rowr.so /lib/geom
+// Create the new device that combines md0 and md1
+# geom rowr create rowr0 md0 md1
+# mount /dev/rowr0 /mnt
+
+// See that the files are already there
+# ls /mnt
+// make changes to the filesystem to see that it is read-write
+# mv /mnt/*.4th /mnt/lua; rm /mnt/pxeboot
+
+
+
+
+

Use in the Live ISO boot process

+

This can be used for a Live ISO like this:

+
    +
  • On the ISO, there is a small ramdisk.ufs that contains the logic to mount the main filesystem using geom_rowr

  • +
  • On the ISO, there is also the main filesystem system.ufs which is a UFS image compressed with geom_uzip

  • +
  • At boot time, the code in the ramdisk creates a r/w swap-backed md device with the same size as the main r/o filesystem image, mounts it together with the main filesystem using geom_rowr, and chroots into the combined r/w filesystem. From there, the boot process continues as usual

  • +
+
+
+

Caveats

+
+

Device size

+
    +
  • The r/o image must have as much free space as you would like to have on the combined device. This can be achieved, e.g., like this: makefs -b 20% -f 20% /usr/local/furybsd/cdroot/data/system.ufs /usr/local/furybsd/uzip which will add an extra 20% of free space to the main filesystem image

  • +
  • The free space is compressed very efficiently when the image is compressed with geom_uzip. This can be achieved, e.g., like this: mkuzip -o /usr/local/furybsd/cdroot/data/system.uzip /usr/local/furybsd/cdroot/data/system.ufs

  • +
  • The uncompressed r/o image and the r/w device need to be the exact same size in bytes. Assuming variable ${x} holds the size of the uncompressed r/o image in bytes, a matching r/w device with the same size in bytes can be created using mdconfig -a -t swap -s ${x}b -u 2 (note the b suffix to the -s option). If this is not done correctly, we get the geom: mediasize mismatch error

  • +
+

You can have an md(4) device be of size 3GB without it consuming 3GB of RAM. +This is valid for vnode-backed md devices, swap-backed md devices and malloc-backed when the reserve option to mdconfig(8) isn’t used.

+

A swap-backed md device consumes close to zero memory when created and grows its memory use the more you write to it.

+
+
+

Reroot

+

Because reroot cannot be made to work with geom_rowr at this time, we need to use chroot.

+

When using chroot, some kernel modules that load firmware (e.g., for Intel WLAN drivers) fail to load the firmware if the places where kernel modules are located - /boot/kernel and /boot/modules - will look differently inside vs. outside the chroot.

+

This can be fixed.

+

Recommended way (to be tested):

+

Provided that ramdisk.ufs does not contain /boot, create a symlink on ramdisk.ufs from /boot to /sysroot/boot. The symlink can be made at image creation time or by a script that runs at runtime. This combined with the default kern.module_path should be enough to create a common view between the kernel and chrooted userland utilities. The places where kernel modules are located - /boot/kernel and /boot/modules - will look the same inside and outside of the chroot.

+

Alternative way (known to work):

+
# mkdir -p /sysroot/sysroot/boot # Needed?
+# mount -t nullfs /sysroot/boot /sysroot/sysroot/boot # Needed?
+
+# echo "==> Set kernel module path for chroot"
+# sysctl kern.module_path=/sysroot/boot/kernel
+
+
+
+
+

ZFS

+

With ZFS there is a problem unrelated to the geom_rowr code. When ZFS performs discovery of devices which are part of a zpool, the read-only device could be found before the combined rowr device which leads to inability to import the pool read-write.

+

(TODO: Insert tested workaround here)

+
+
+
+

License

+
geom_rowr.ko, geom_rowr.so: Copyright (c) 2021, Jordan Gordeev
+
+
+

The author states that once the code reaches a certain level of maturity, it will be published under the license used by the FreeBSD project.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/graphics.html b/developer/graphics.html new file mode 100644 index 00000000..5839aefe --- /dev/null +++ b/developer/graphics.html @@ -0,0 +1,210 @@ + + + + + + Graphics hardware autoconfiguration — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Graphics hardware autoconfiguration

+

helloSystem uses initgfx for the automatic configuration of the graphics hardware in your computer.

+
+

Theory of operation

+

initgfx consists of the following files and directories:

+
/etc/rc.d/initgfx
+/etc/initgfx_device.db
+/etc/initgfx_xorg.cfg
+/usr/local/nvidia/<version>/<contents of the driver tgz>
+/usr/local/etc/X11/xorg.conf.d/<dynamically generated> # defined by path_xorg_cfg_dir
+
+
+

initgfx calculates a config ID which is a MD5 checksum of the output of sysctl dev.vgapci | sort. If the file /var/initgfx_config.id exists, check if +its content matches the config ID. If that is the case, load the modules +set via the rc.conf variable initgfx_kmods, and exit. If the file +/var/initgfx_config.id does not exist, or its content does not match the +config ID, try to auto-detect the accelerated graphics driver. Use xinit +to test if the X server starts, change initgfx_kmods, write a new xorg +config file, and save the new config ID if the test was successful. +Otherwise, as a fallback, write a xorg config file for the VESA or SCFB +driver depending on whether the system was booted via BIOS or EFI.

+

Source

+

If everything goes well, then after running sudo sysctl initgfx start you should have (example: Nvidia):

+
$ cat /usr/local/etc/X11/xorg.conf.d/00-video-initgfx.conf 
+Section "Device"
+    Identifier    "NVIDIA CARD"
+    VendorName    "NVIDIA Corporation"
+    Driver        "nvidia"
+    BusID         "PCI:1:0:0"
+EndSection
+
+
+
+
+

Disabling the graphics driver menu

+

If you want to disable the graphics driver menu, add

+

initgfx_menu="NO" to /etc/rc.conf.

+

By default, initgfx will try autodetection, but you can instead define a default driver to use by setting initgfx_default to scfb or vesa in /etc/rc.conf.

+
+
+

Disabling the automatic graphics driver setup

+

If you want to create your own graphics driver settings, you can disable initgfx by adding

+

initgfx_enable="NO" to /etc/rc.conf.

+

If you would like to temporarily disable the automatic graphics driver setup and use a failsafe non-accelerated driver (VESA or SCFB), then enter set initgfx.detect.disable=1 followed by boot at the bootloader prompt. This can be useful e.g., in cases where the automatically detected graphics driver does not work properly on the Live system.

+
+
+

Troubleshooting

+

If applications that are using OpenGL crash on Nvidia systems, then it may be that the Nvidia driver was correctly loaded but the wrong Xorg configuration has been loaded, not actually using the Nvidia driver. This can happen when initgfx writes the dynamically generated Xorg configuration to path_xorg_cfg_dir (which points to /usr/local/etc/X11/xorg.conf.d/ by default) but other files have been placed by other packages or the user into, e.g., /etc/X11/xorg.conf.d. You can verify which Xorg configuration directory was used by Xorg with cat /var/log/Xorg.0.log | grep Using.config. Seemingly Xorg cannot combine configuration stored in multiple xorg.conf.d directories.

+
+
+

Nvidia drivers

+

Different versions of the Nvidia drivers exist. Unfortunately the latest version does not support all the earlier GPUs, so multiple versions of the Nvidia drivers are shipped with helloSystem to cover both new and older Nvidia GPUs. initgfx should automatically select a version suitable for the hardware in the computer.

+

To check this:

+
$ cat /etc/rc.conf | grep initgfx_kmods
+initgfx_kmods="/usr/local/nvidia/390/boot/modules/nvidia.ko /usr/local/nvidia/390/boot/modules/nvidia-modeset.ko"
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/linux.html b/developer/linux.html new file mode 100644 index 00000000..ab1184b7 --- /dev/null +++ b/developer/linux.html @@ -0,0 +1,253 @@ + + + + + + Building on Linux — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Building on Linux

+

helloSystem is designed for use with helloSystem, which is based on FreeBSD.

+

However, developers may want to verify that the code is reasonably platform independent by building on Linux from time to time.

+
+

Note

+

That the code build does not necessarily mean that it works properly on Linux or that all features are implemented for Linux.

+
+
+

Building in a chroot on a FreeBSD host

+

To verify that the code builds on Linux without needing a different development machine, one can use an Alpine Linux chroot in FreeBSD.

+

Beginning with build 0H165, helloSystem ships with an alpine rc.d script. +When started for the first time, this downloads a minimal root filesystem.

+
$ sudo service linux stop
+$ sudo service debian stop
+$ sudo service alpine onestart
+$ sudo chroot /compat/alpine /bin/sh
+
+
+

In the chroot, build the essential helloSystem components

+
// launch, open, and other essential command line tools that are required
+$ git clone https://github.com/helloSystem/launch
+$ mkdir -p launch/build
+$ cd launch/build
+$ grep ^apk ../README.md | sh
+$ cmake ..
+$ sudo make -j $(nproc) install
+$ cd ../../
+
+// Menu
+$ git clone https://github.com/helloSystem/Menu
+$ mkdir -p Menu/build
+$ cd Menu/build
+$ grep ^apk ../README.md | sh
+$ cmake ..
+$ sudo make -j $(nproc) install
+$ cd ../../
+
+// Filer
+$ git clone https://github.com/helloSystem/Filer
+$ mkdir -p Filer/build
+$ cd Filer/build
+$ grep ^apk ../README.md | sh
+$ cmake ..
+$ sudo make -j $(nproc) install
+$ cd ../../
+
+
+

After you are done,

+
$ sudo service alpine onestop
+
+
+
+

Note

+

If the compiler crashes, make sure that /usr/bin/clang++ is being used rather than /usr/bin/c++. This can be edited in CMakeCache.txt.

+
+
+
+

Running helloDesktop on Linux

+

Run Alpine Linux, e.g., in VirtualBox on helloSystem, or on real hardware.

+
    +
  • Download ISO from https://alpinelinux.org/downloads/, “Standard”

  • +
  • User root, no password is the default

  • +
  • Install to to a hard disk using the setup-alpine command, need to use a classic (“sys mode”) installation

  • +
  • Enable community repo by sed -i -e 's|^#||g' /etc/apk/repositories

  • +
  • Install KDE Plasma using setup-desktop; set up a user

  • +
  • rc-update add sddm and rc-service sddm start

  • +
  • Log into a KDE Plasma session on Alpine Linux.

    +
    +

    Important

    +

    Select X11 session. Wayland doesn’t work smoothly

    +
    +
  • +
  • Optionally, install VirtualBox related guest packages using apk search and apk add

  • +
  • sudo su to become root (there is no sudo configured on Alpine Linux by default)

  • +
  • Build and make install the three core components of helloDesktop (launch, Menu, and Filer) as above

  • +
  • From within the running KDE Plasma session, you can switch to the minimal helloDesktop with

  • +
+
#!/bin/sh
+
+launch Menu &
+sleep 1
+launch Filer &
+killall plasmashell
+
+
+

Menu shoud work including full text search in the filesystem.

+

The result will look somewhat like this:

+

Screenshot

+
+

Note

+

That the code runs does not necessarily mean that it works properly on Linux or that all features are implemented for Linux. Please keep in mind that for the best desktop experience, you should be using helloSystem which helloDesktop has been designed for.

+
+
+
+

Building and running helloDesktop on Raspberry Pi

+

Loosely follow https://wiki.alpinelinux.org/wiki/Classic_install_or_sys_mode_on_Raspberry_Pi (not all commands seem to be working exactly as written anymore), but also create “Linux Swap” partition. Alternatively, in the running Alpine Linux system

+
# fallocate -l 8G /swapfile
+# mkswap /swapfile
+# swapon /swapfile
+
+
+

to have enough RAM or else the compilation will be killed (at least on the 1GB and less RAM models).

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/localization.html b/developer/localization.html new file mode 100644 index 00000000..16d95a36 --- /dev/null +++ b/developer/localization.html @@ -0,0 +1,205 @@ + + + + + + Localization — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Localization

+

helloSystem is localized on Hosted Weblate.

+

Translation status

+
+

Contributing translations

+

helloSystem is translated into many languages by volunteers all over the world.

+

Translation happens on Weblate. Everyone can contribute! Be sure to use the “Automatic suggestions” button which suggests translations from Deepl, Google Translate, Microsoft Translator, and various open source projects. This reduces the work to picking the most appropriate translation in many cases.

+
+
+

Making strings available for translation

+
+

Qt

+

Follow the best practices for internationalization of Qt projects. To be documented.

+
+
+

Python

+

helloSystem uses tstranslator.py to translate applications using Qt .ts files without the need for compilation. To achieve this, import and set up tstranslator as follows:

+
# Translate this application using Qt .ts files without the need for compilation
+import tstranslator
+tstr = tstranslator.TsTranslator(os.path.dirname(__file__) + "/i18n", "")
+def tr(input):
+    return tstr.tr(input)
+
+
+

In the class that defines your MainWindow or Wizard, do the following:

+
class Wizard(QtWidgets.QWizard, object):
+    def __init__(self):
+        (...)
+        # Translate the widgets in the UI objects in the Wizard
+        self.setWindowTitle(tr(self.windowTitle()))
+        for e in self.findChildren(QtCore.QObject, None, QtCore.Qt.FindChildrenRecursively):
+            if hasattr(e, 'text') and hasattr(e, 'setText'):
+                e.setText(tr(e.text()))
+
+
+

To make new strings available for translation, a developer runs in the respective application directory:

+
$ cd Resources/
+$ mkdir -p i18n
+
+// Create/update .ts file for English
+$ pylupdate5 -noobsolete *.{py,ui} -ts i18n/en.ts
+
+// Remove unneeded location tags
+$ xml ed -L -d '//location' i18n/en.ts 
+
+// Remove translations from en, since en is not to be further translated
+$ xml ed -L -d '//translation' i18n/en.ts 
+
+
+

Translators do not need to do this.

+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/man.html b/developer/man.html new file mode 100644 index 00000000..afd6d854 --- /dev/null +++ b/developer/man.html @@ -0,0 +1,193 @@ + + + + + + Writing man pages — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Writing man pages

+

Command line tools should be shipped with man pages.

+
+

Note

+

To make fullest use of all features, man pages should be written in their native markup language, mdoc.

+

However, this has a quite steep learning curve, so the following can be used to get started quickly.

+
+

One way to create man pages from Markdown is by using pandoc +and the template from https://github.com/pragmaticlinuxblog/pandocmanpage.

+

To convert Markdown to man:

+
$ pandoc Desktop/launch.1.md -s -t man -o  Desktop/launch.1
+$ /usr/bin/man ~/Desktop/launch.1
+
+
+

To convert man to txt:

+
$ /usr/bin/man ~/Desktop/launch.1 | col -b > ~/Desktop/launch.txt
+
+
+
+

Order of sections

+

For more information, see man mdoc.

+
    +
  • PROGNAME section

  • +
  • NAME

  • +
  • LIBRARY

  • +
  • SYNOPSIS

  • +
  • DESCRIPTION

  • +
  • CONTEXT

  • +
  • IMPLEMENTATION NOTES

  • +
  • RETURN VALUES

  • +
  • ENVIRONMENT

  • +
  • FILES

  • +
  • EXIT STATUS

  • +
  • EXAMPLES

  • +
  • DIAGNOSTICS

  • +
  • ERRORS

  • +
  • SEE ALSO

  • +
  • STANDARDS

  • +
  • HISTORY

  • +
  • AUTHORS

  • +
  • CAVEATS

  • +
  • BUGS

  • +
  • SECURITY CONSIDERATIONS

  • +
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/menu.html b/developer/menu.html new file mode 100644 index 00000000..c41145b9 --- /dev/null +++ b/developer/menu.html @@ -0,0 +1,611 @@ + + + + + + Global Menu — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ + + + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/midi.html b/developer/midi.html new file mode 100644 index 00000000..05549946 --- /dev/null +++ b/developer/midi.html @@ -0,0 +1,254 @@ + + + + + + MIDI — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

MIDI

+

Over a decade ago, someone wrote on the FreeBSD forum:

+
+

The main problem with anything midi and jack (in fact anything more complex than using simple audio in or audio out) under FreeBSD, is that I haven’t found out how to configure things. A complete writeup (for a non-musician) about how to configure a system which use jack would be nice.

+
+

This page describes how to use USB based hardware MIDI controllers (e.g., keyboards), with helloSystem and FreeBSD.

+
+

Note

+

It is a work in progress. Please consider contributing additions and corrections.

+
+
+

Using /dev/umidi*

+

Whenever a USB based hardware MIDI controller is plugged into the computer, a /dev/umidi* device node is created automatically.

+
+

Testing

+

To test whether input from the MIDI controller arrives, run in a Terminal window:

+
$ midicat -d -q rmidi/0.0 -o /dev/null
+
+
+

As you play some notes on the MIDI controller, you should see MIDI messages appear on the screen. After verifying that this works, exit midicat.

+

Some applications can use /dev/umidi* device nodes directly. Some expect the device node to be at /dev/midi though, so you need to create a symlink there manually.

+
+
+

Example application

+

For example, the fluidsynth command line tool, can use hardware MIDI controllers in this way directly:

+
$ sudo pkg install -y fluidsynth musescore
+$ sudo ln -sf /dev/umidi*.0 /dev/midi
+$ fluidsynth -m oss -a oss SoundFont.sf2
+
+
+

Unfortunately, not all applications on FreeBSD can use /dev/umidi* device nodes directly in this way. Hence there are other methods to access MIDI controllers. which one you need to use depends on what methods the application in question supports.

+
+

Note

+

Applications cannot access /dev/umidi* directly while alsa-seq-server is running.

+
+
+
+
+

Using OSS Raw-MIDI (Open Sound System)

+

Supposedly applications can use “OSS Raw-MIDI (Open Sound System)” to talk to MIDI controllers.

+
+

Testing

+

Please let us know if you know how this works.

+
+
+

Example application

+

The LMMS FreeBSD package offers “OSS Raw-MIDI (Open Sound System)” in the dropdown menu for the MIDI interface; however, it is not clear whether and how this works on FreeBSD. Please let us know if you know how this works.

+
+
+
+

Using alsa-seq-server

+

Some applications can use alsa-seq-server to access MIDI controllers. For some applications, this support needs to be specifically enabled as a configuration option at compile time.

+

In order for applications that use alsa-seq-server to talk to your MIDI controller, run

+
$ sudo pkg install alsa-seq-server alsa-utils
+$ sudo alsa-seq-server -d /dev/umidi*
+
+
+

and then run the application.

+
+

Note

+

alsa-seq-server was recently updated so that one can run it as a service which will automatically make all MIDI devices available without having to run one instance per MIDI device. The change should appear in FreeBSD packages (and thus in helloSystem) starting in Q2/2022.

+
+
+

Testing

+

To test whether input from the MIDI controller arrives, run in a separate Terminal:

+
$ aseqdump -p 0
+Waiting for data. Press Ctrl+C to end.
+Source  Event                  Ch  Data
+
+
+

As you play some notes on the MIDI controller, you should see MIDI messages appear on the screen. After verifying that this works, exit aseqdump.

+
+
+

Example application

+

An example application that can use alsa-seq-server to talk to MIDI controllers “out of the box” (without the need to recompile the application) is yet to be found in the FreeBSD Packages collection. Please let us know if you know one.

+

Recompiling LMMS from FreeBSD Ports with the following change regarding WANT_ALSA in the Makefile allows one to use alsa-seq-server to talk to MIDI controllers:

+
CMAKE_OFF=      WANT_CALF WANT_CAPS WANT_CMT WANT_SWH WANT_STK \
+                WANT_TAP WANT_VST
+CMAKE_ON=       WANT_QT5 WANT_ALSA
+
+
+

Run make clean ; make config ; make to define which of the supported sound systems and MIDI interfaces will be available. LMMS can support the following MIDI interfaces on FreeBSD if it is configured accordingly at compile time: ALSA, OSS, Sndio, JACK. The ALSA one is known to work.

+

To use it, select “ALSA-Sequencer (Advanced Linux Sound Architecture)” from the MIDI interface dropdown menu in the MIDI pane of the LMMS settings, restart ALSA, click on the gear icon e.g., in the TripleOscillator track, and select MIDI -> Input -> 0:0 (name of your USB device).

+

If you see

+
ALSA lib seq_hw.c:466:(snd_seq_hw_open) open /dev/snd/seq failed: No such file or directory
+cannot open sequencer: No such file or directory
+
+
+

when you start LMMS, then most likely sudo alsa-seq-server -d /dev/umidi* is not running (see above).

+

Note that depending on the application, using alsa-seq-server for the MIDI interface does not automatically mean that you have to use ALSA as the sound system (e.g., for the output of the generated sound). For example, if LMMS has been configured at compile time to support SDL (Simple DirectMedia Layer), you could use SDL rather than ALSA for the sound output.

+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/monkey-patch.html b/developer/monkey-patch.html new file mode 100644 index 00000000..75c88aae --- /dev/null +++ b/developer/monkey-patch.html @@ -0,0 +1,234 @@ + + + + + + Monkey Patching — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Monkey Patching

+

Starting with helloSystem 0.7.0 it is possible to monkey patch the running Live ISO as early in the boot process as possible so that developers can make changes to all aspects of an existing Live ISO without having to re-create it and without having to write the ISO to a device each time a change is to be tested.

+

With that, it allows for a very rapid development-test cycle for Live ISOs.

+
+

Note

+

This feature is currently under active development and its usage is still subject to change.

+
+
+

Theory of operation

+

Since an ISO file is read-only by design, the monkey patch feature allows to insert code into the early boot process from another loacation, e.g., from a USB stick.

+

If the user tells the system to perform the monkey patching, the early boot scripts in helloSystem execute code provided by the user (outside of the ISO), then continues the normal boot process.

+
+
+

Creating the monkey patch volume

+

image

+
    +
  • Format a USB stick with the FAT32 (msdosfs) file system

  • +
  • The volume must have the name (“filesystem label”) MONKEYPATCH

  • +
  • There must be a monkeypatch.sh file that will be run by #!/bin/sh

  • +
+
+
+

Booting a Live ISO applying the monkey patch on-the-fly

+
    +
  • Boot the ISO but interrupt the bootloader by pressing the Esc key

  • +
  • At the boot prompt, enter: set monkey_patch=YES

  • +
  • Optionally, use unset BOOT_MUTE so that you can see messages on the screen during boot

  • +
  • Start the system by entering boot

  • +
+

The code inside the file monkeypatch.sh on the volume called MONKEYPATCH will be executed before /sbin/init on the Live ISO is started but after most areas of the ISO have been made writable by /boot/init_script.

+
+
+

Example monkeypatch.sh file

+
#!/bin/sh
+
+# Write a file
+echo "HELLO MONKEY" > /tmp/MONKEY_WAS_HERE
+
+# Patch something on the ISO
+sed -i '' -e 's|\&\& __wait 3|\&\& sync|g' /etc/rc.d/initgfx
+
+# Show a message if the system is booted without `boot_mute`
+echo "HELLO DEVELOPERS"
+
+# Show a message to users in the boot process
+# This should be done only in rare cases since it destroys
+# the helloSystem zero-text boot experience
+echo "HELLO MERE MORTALS" > /dev/console
+
+# Give users a chance to see the message
+sleep 1
+
+# Override a file in the running system from the MONKEYPATCH volume
+HERE="$(dirname "$(readlink -f "${0}")")"
+cp ${HERE}/mount_md /usr/local/sbin/mount_md
+chmod +x /usr/local/sbin/mount_md
+
+
+

A particularly effective way to debug the late boot process (after Xorg has started) is:

+
$ mv /usr/local/bin/start-hello /usr/local/bin/start-hello.real
+$ cat > /usr/local/bin/start-hello << EOF
+#!/bin/sh
+
+xterm -maximized start-hello.real
+# xterm -maximized
+EOF
+$ chmod +x /usr/local/bin/start-hello*
+
+
+

This will allow you to see the commands in start-hello.real as they are executed.

+
+
+

Booting a Live ISO running a different init_script

+

If you would like to test changes to /boot/init_script on the ISO without having to re-create it and without having to write the ISO to a device, you can use the monkey_patch_init_script feature:

+
    +
  • Boot the ISO but interrupt the bootloader by pressing the Esc key

  • +
  • At the boot prompt, enter: set monkey_patch_init_script=YES

  • +
  • Optionally, use unset BOOT_MUTE so that you can see messages on the screen during boot

  • +
  • Start the system by entering boot

  • +
+

The code inside the file init_script on the volume called MONKEYPATCH will be executed instead of /boot/init_script on the ISO.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/ports.html b/developer/ports.html new file mode 100644 index 00000000..6959327b --- /dev/null +++ b/developer/ports.html @@ -0,0 +1,419 @@ + + + + + + Working with FreeBSD Ports — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Working with FreeBSD Ports

+

In some situations it may be necessary to make changes to existing software that comes in FreeBSD packages.

+

This section describes how to make such changes using an example.

+
+

Example

+

Suppose you would like to make a small change to the source code of software that comes as a FreeBSD package. Since packages are built from FreeBSD Ports, you need to modify the corresponding FreeBSD port.

+

Here is a real-life example on how to do that:

+

https://github.com/lxqt/qterminal/issues/474 can be fixed by changing a few lines in

+

https://github.com/lxqt/qtermwidget/blob/059d832086facb19035a07d975ea4fd05d36b1ec/lib/TerminalDisplay.cpp#L3206

+

Here is how to do it using FreeBSD Ports:

+
+
+

Pulling the ports tree

+
$ sudo git clone https://git.freebsd.org/ports.git /usr/ports --depth=1
+
+
+

If you are running an end-of-life FreeBSD version such as 12.1, you also need to

+
$ export ALLOW_UNSUPPORTED_SYSTEM=1
+// Or in csh
+% setenv ALLOW_UNSUPPORTED_SYSTEM YES
+
+
+
+
+

Building the port without changes

+

Build the port without changes first to ensure it builds and works as expected.

+
$ cd /usr/ports/x11-toolkits/qtermwidget/
+
+// Install all build-time dependencies from packages
+$ make build-depends-list | cut -c 12- | xargs pkg install -y
+
+// Build the library
+// NOTE: Applications that have a library that is used by nothing but that application are just
+// annoying because now you have to deal with two entities rather than one
+$ MAKE_JOBS_UNSAFE=yes sudo -E make -j4
+
+// Now, the application itself
+$ cd /usr/ports/x11/qterminal
+
+// Install all build-time dependencies from packages
+$ make build-depends-list | cut -c 12- | xargs pkg install -y
+
+// Build the application
+$ QTermWidget5_DIR=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/cmake/qtermwidget5/  MAKE_JOBS_UNSAFE=yes sudo -E make -j4
+
+// Run the application with the changed library
+$ LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal
+
+
+
+
+

Making changes to the port

+

Now make changes to the port.

+
+

Note

+

In the ports system you cannot just change the source code because it would be overwritten during the build process.

+

You first need to make a copy of the source code, then make the changes in the copy, then create a patch that will get applied automatically at build time.

+
+
// Copy the file to be changed
+$ cd /usr/ports/x11-toolkits/qtermwidget
+$ sudo cp work/qtermwidget-*/lib/TerminalDisplay.cpp work/qtermwidget-*/lib/TerminalDisplay.cpp.orig
+
+// Make the change in the library
+$ sudo nano work/qtermwidget-*/lib/TerminalDisplay.cpp
+        QChar q(QLatin1Char('\''));
+        dropText += q + QString(urlText).replace(q, QLatin1String("'\\''")) + q;
+        dropText += QLatin1Char(' ');
+
+// Make a patch
+$ sudo make makepatch
+
+// Build the library again
+$ sudo make clean # Run this only if the next line does nothing
+$ MAKE_JOBS_UNSAFE=yes sudo -E make -j4
+
+// Run the application with the changed library
+$ LD_LIBRARY_PATH=/usr/ports/x11-toolkits/qtermwidget/work/stage/usr/local/lib/ /usr/ports/x11/qterminal/work/stage/usr/local/bin/qterminal
+
+
+

As a result we have a patch:

+
$ cat files/patch-lib_TerminalDisplay.cpp
+--- lib/TerminalDisplay.cpp.orig        2020-11-03 08:19:26 UTC
++++ lib/TerminalDisplay.cpp
+@@ -3099,7 +3099,9 @@ void TerminalDisplay::dropEvent(QDropEvent* event)
+         // without quoting them (this only affects paths with spaces in)
+         //urlText = KShell::quoteArg(urlText);
+ 
+-        dropText += urlText;
++        QChar q(QLatin1Char('\''));
++        dropText += q + QString(urlText).replace(q, QLatin1String("'\\''")) + q;
++        dropText += QLatin1Char(' ');
+ 
+         if ( i != urls.count()-1 )
+             dropText += QLatin1Char(' ');
+
+
+
+
+

Making packages

+

Optionally, make packages for the ports. Note that make build needs to have run already before this step.

+
// Library
+$ cd /usr/ports/x11-toolkits/qtermwidget/
+$ sudo make package
+$ ls work/pkg
+
+// Application
+$ cd /usr/ports/x11/qterminal
+$ sudo make package
+$ ls work/pkg
+
+
+
+
+

Creating a port from scratch

+

The FreeBSD Porter’s Handbook is the authoritative source on how to write new ports from scratch. This section shows a hands-on example on how to package a set of tools from a GitHub repository.

+
+

Note

+

This section is a work in progress. Corrections are welcome.

+
+

First, prepare the Ports environment:

+
$ sudo su
+# pkg install portlint
+# echo DEVELOPER=yes >> /etc/make.conf
+
+
+

Next, create a directory for the new port:

+
# mkdir /usr/ports/sysutils/fluxengine
+# cd /usr/ports/sysutils/fluxengine
+
+
+

Create Makefile with the following content:

+
# $FreeBSD$
+
+PORTNAME=       fluxengine
+DISTVERSION=    572
+CATEGORIES=     sysutils
+
+MAINTAINER=     probono@puredarwin.org
+COMMENT=        USB floppy disk interface for reading and writing non-PC disk formats
+
+LICENSE=        MIT
+
+LIB_DEPENDS=    libsqlite3.so:databases/sqlite3 \
+                libstdc++.so:lang/gcc9
+
+BUILD_DEPENDS=  ninja:devel/ninja
+
+USES=           gmake
+
+USE_GITHUB=     yes
+GH_ACCOUNT=     davidgiven
+GH_TAGNAME=     61ff48c
+
+do-install:
+        ${INSTALL_PROGRAM} ${WRKSRC}/brother120tool ${STAGEDIR}${PREFIX}/bin/
+        ${INSTALL_PROGRAM} ${WRKSRC}/brother240tool ${STAGEDIR}${PREFIX}/bin/
+        ${INSTALL_PROGRAM} ${WRKSRC}/fluxengine ${STAGEDIR}${PREFIX}/bin/
+
+.include <bsd.port.mk>
+
+
+

Run

+
# make makeplist > pkg-plist
+
+
+

to create that file. Check and edit it by hand, especially the first line.

+

Notes

+
    +
  • See ls /usr/ports/ for possible categories, such as sysutils

  • +
  • See 5.2. Naming for naming and versioning conventions

  • +
  • The lines must be in a defined order. Run portlint to get information on this. When portlint complains about appears out-of-order, the blocks and lines in the Makefile need to be reshuffled to match the order described at https://docs.freebsd.org/en/books/porters-handbook/order/.

  • +
  • Run make stage-qa to find out dependencies. Using something like make stage-qa 2>&1 | grep "you need" | sort | uniq | cut -d " " -f 4 can speed this up

  • +
  • The do-install section is needed in this example because there is no make install in the original software’s Makefile

  • +
+

Create pkg-descr based on the description on the GitHub README.md:

+
The FluxEngine is a very cheap USB floppy disk interface capable of
+reading and writing exotic non-PC floppy disk formats.
+It allows you to use a conventional PC drive to accept Amiga disks,
+CLV Macintosh disks, bizarre 128-sector CP/M disks,
+and other weird and bizarre formats.
+ :
+The hardware consists of a single, commodity part with a floppy drive
+connector soldered onto it. No ordering custom boards,
+no fiddly surface mount assembly, and no fuss:
+nineteen simpler solder joints and you're done.
+
+WWW: http://cowlark.com/fluxengine/
+
+
+

Notes

+ +

Create the checksum file by running

+
# make makesum
+
+
+

Check the Makefile with

+
# portlint
+
+
+

and correct any mistakes it reports, then repeat.

+

Once portlint says looks fine, try to build by running

+
# make
+
+
+

Note that the compilation will fail. This is because in this case the application needs to be built with gmake rather than make.

+

Run tests

+
# make stage
+# make stage-qa
+# make package
+# make install
+# make deinstall
+
+
+

None of these must produce errors. See 3.4. Testing the Port for details.

+

At this point it may be a good idea to have an experienced FreeBSD Ports developer have a look at your new port.

+

Once everything looks good, prepare a .shar file for submitting it to https://bugs.freebsd.org/submit/:

+
# rm -rf work/
+# cd ..
+# tar cf  fluxengine.shar --format shar fluxengine
+
+
+
+
+

Updating existing ports

+

This real-life example shows how to update a port, e.g., x11/qterminal.

+
$ sudo su
+# cd /usr/ports
+# git pull
+# cd x11/qterminal
+
+
+

Change PORTVERSION=    1.1.0 to PORTVERSION=    1.2.0. Turns out that one has to update x11-toolkits/qtermwidget and devel/lxqt-build-tools too for it to compile.

+
# portlint # Fix errors, if any
+# rm pkg-plist
+# make clean
+# make package reinstall
+# make makeplist > pkg-plist
+# nano pkg-plist # Remove first line and check the others
+# make clean
+# make package reinstall
+
+
+

Finally, once everything is tested, create separate patches for each port with

+
# cd /usr/ports
+# git diff -U999999 x11/qterminal > /home/user/Desktop/x11_qterminal.diff
+# git diff -U999999 devel/lxqt-build-tools > /home/user/Desktop/devel_lxqt-build-tools.diff
+# git diff -U999999 x11-toolkits/qtermwidget > /home/user/Desktop/x11-toolkits_qtermwidget.diff
+
+
+

Go to https://reviews.freebsd.org/differential/, click “Create Diff”, can log in using GitHub credentials, subject devel/lxqt-build-tools: Update to 0.12.0, under “Reviewers” add the maintainer.

+

Result:

+
    +
  • https://reviews.freebsd.org/D37378

  • +
  • https://reviews.freebsd.org/D37379

  • +
  • https://reviews.freebsd.org/D37380

  • +
+

If a reviewer requires changes to be made, make the changes and upload (paste) a new diff (like the original diff; not a “diff of the diff”!) by clicking on “Update Diff” on the respective Phabricator page, e.g., https://reviews.freebsd.org/D37378.

+
+
+

Working with Cirrus CI

+

To build packages on Cirrus CI, a .cirrus.yml file similar to https://github.com/b-aaz/xlibre-ports/blob/master/.cirrus.yml can be used.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/rpi.html b/developer/rpi.html new file mode 100644 index 00000000..0fe4e407 --- /dev/null +++ b/developer/rpi.html @@ -0,0 +1,568 @@ + + + + + + Raspberry Pi — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Raspberry Pi

+

+

Although we are currently not providing installation images for Raspberry Pi, we are investigating whether doing so would be feasible and beneficial.

+

The same instructions are roughly applicable to other aarch64 based systems such as rk3399 ones like the PineBook Pro and the pine64 rockpro64_rk3399 as well.

+
+

Note

+

This page is intended for technically advanced users and developers, not for end users. This page is work in progress. Instructions are brief and assume prior knowledge with the subject.

+
+

This page describes how to run the main components of helloSystem (referred to collectively as helloDesktop) on Raspberry Pi 3 and Raspberry Pi 4 devices, starting with the official FreeBSD 13 image that does not even contain Xorg.

+

It describes how to build and set up the main components of helloSystem by hand, so this is a good walkthrough in case you are interested in bringing up the helloDesktop on other systems as well.

+

If there is enough interest, we might eventually provide readymade helloSystem images for Raspberry Pi in the future. This depends on how usable helloSystem will be on the Raspberry Pi (e.g., whether we can get decent graphics performance).

+
+

Prerequisites

+
    +
  • Raspberry Pi 3 Model B or B+, Raspberry Pi 4 Model B, or Raspberry Pi 400

  • +
  • Suitable power supply

  • +
  • Class-1 or faster microSD card with at least 8 GB of memory

  • +
  • HDMI display

  • +
  • Keyboard and mouse (we recommend the official Raspberry Pi keyboard since helloSystem can automatically detect its language)

  • +
  • Ethernet (WLAN is not yet covered on this page)

  • +
+
+
+

Optional hardware

+
    +
  • SATA SSD drive (not NVME)

  • +
+
+
+

Preparing an SD card

+
    +
  • Install the official FreeBSD 13 image (not FreeBSD 14) to a microSD card

  • +
  • Copy this file to the microSD card you are running the Raspberry Pi from. You will need it because you will not have an internet browser at hand

  • +
  • Edit config.txt in the MSDOSBOOT partition to contain the correct resolution for your screen.

  • +
+
hdmi_safe=0
+disable_overscan=1
+display_auto_detect=1
+max_framebuffer_width=3840
+max_framebuffer_height=2160
+max_framebuffers=2
+gpu_mem=512
+
+[pi4]
+dtoverlay=vc4-kms-v3d-pi4
+
+
+
+

Note

+

If, for some reason, the display does not work, simply remove or comment out the max_framebuffer* lines and replace them with the following:

+
framebuffer_width=<display resolution width>
+framebuffer_height=<display resolution height>
+
+
+
+
+ +
+

Booting into the system

+

We will be doing all subsequent steps on the Raspberry Pi system itself since we are assuming you don’t have any other 64-bit ARM (aarch64) machines at hand.

+
    +
  • Insert the microSD card into the Raspberry Pi

  • +
  • Attach keyboard and mouse (we recommend the official Raspberry Pi keyboard since helloSystem can automatically detect its language)

  • +
  • Attach the display (If you don’t see anything, DO NOT power off your machine. Simply switch the HDMI port.)

  • +
  • Attach Ethernet

  • +
  • Power on the Raspberry Pi

  • +
  • After some time, you should land in a login screen

  • +
  • Log in with root, password root

  • +
  • Install some basic software with pkg install -y xorg xterm nano openbox fluxbox git-lite

  • +
+
+

Note

+

fluxbox is not strictly needed and can be removed later on, but it gives us a graphical desktop session while we are working on installing helloDesktop

+
+
+
+

Starting a graphical session

+

Start Xorg with

+
# echo startfluxbox > ~/.xinitrc
+# startx
+
+
+

Doing it like this is the easiest way since the display DISPLAY environment variable and other things will be set automatically.

+
+
+

Compiling and installing helloDesktop core components

+
+

Install prerequisites

+
# pkg install -y cmake pkgconf qt5-qmake qt5-buildtools kf5-kdbusaddons kf5-kwindowsystem libdbusmenu-qt5 qt5-concurrent qt5-quickcontrols2 libfm libqtxdg wget
+
+
+
+
+

launch

+

The launch command is central to helloSystem and is used to launch applications throughout the system.

+
# git clone https://github.com/helloSystem/launch
+# cd launch/
+# mkdir build
+# cd build/
+# cmake ..
+# make -j4
+# ./launch
+# make install
+# cd ../../
+
+
+
+ +
+

Filer

+
# git clone https://github.com/helloSystem/Filer
+# cd Filer/
+# mkdir build
+# cd build/
+# cmake ..
+# make -j4
+# make install
+# ln -s /usr/local/bin/filer-qt /usr/local/bin/Filer # Workaround for the 'launch' command to find it
+# cd ../../
+
+
+
+

Note

+

It seems like Filer refuses to start if D-Bus is missing. We should change it so that it can also work without D-Bus and at prints a clear warning if D-Bus is missing. Currently all you see if D-Bus is missing is the following: ‘** (process:3691): WARNING **: The directory ‘~/Templates’ doesn’t exist, ignoring it’, and then Filer exits.

+
+
+
+

Dock

+
# pkg install -y <...>
+# git clone https://github.com/helloSystem/Dock
+# cd Dock
+# mkdir build
+# cd build
+# cmake ..
+# make -j4
+# make install
+// Currently Dock is installed to /usr/bin/cyber-dock. In the future is should be in /usr/local/bin/.
+# ln -s /usr/bin/cyber-dock /usr/local/bin/Dock # Workaround for the 'launch' command to find it
+# cd ../../
+
+
+
+
+

QtPlugin

+
# git clone https://github.com/helloSystem/QtPlugin
+# cd QtPlugin/
+# mkdir build
+# cd build/
+# cmake ..
+# make -j4
+# make install
+# cp ../stylesheet.qss /usr/local/etc/xdg/
+# cd ../../
+
+
+
+
+

Icons and other assets

+

Install icons and other helloSystem assets that are not packaged as FreeBSD packages (yet). It is easiest to run bash, then export uzip=/, and then run the corresponding sections of script.hello. Here are some examples.

+

For the system icons:

+
# wget -c -q http://archive.ubuntu.com/ubuntu/pool/universe/x/xubuntu-artwork/xubuntu-icon-theme_16.04.2_all.deb
+# tar xf xubuntu-icon-theme_16.04.2_all.deb
+# tar xf data.tar.xz
+# mkdir -p "${uzip}"/usr/local/share/icons/
+# mv ./usr/share/icons/elementary-xfce "${uzip}"/usr/local/share/icons/
+# mv ./usr/share/doc/xubuntu-icon-theme/copyright "${uzip}"/usr/local/share/icons/ elementary-xfce/
+# sed -i -e 's|usr/share|usr/local/share|g' "${uzip}"/usr/local/share/icons/elementary-xfce/copyright
+# rm "${uzip}"/usr/local/share/icons/elementary-xfce/copyright-e
+# wget "https://raw.githubusercontent.com/helloSystem/hello/master/branding/computer-hello.png" -O "${uzip}"/usr/local/share/icons/elementary-xfce/devices/128/computer-hello.png
+
+
+

For the system fonts:

+
# wget -c -q https://github.com/ArtifexSoftware/urw-base35-fonts/archive/20200910.zip
+# unzip -q 20200910.zip
+# mkdir -p "${uzip}/usr/local/share/fonts/TTF/"
+# cp -R urw-base35-fonts-20200910/fonts/*.ttf "${uzip}/usr/local/share/fonts/TTF/"
+# rm -rf urw-base35-fonts-20200910/ 20200910.zip
+
+
+

Proceed similarly for the cursor theme, wallpaper, applications from the helloSystem/Utilities repository, and other assets.

+
+
+

Installing required packages

+

Install every package that is not commented out in packages.hello that are installable.

+
+

Note

+

Not every package will be installable. This probably means that the package in question has not been compiled for the aarch64 architecture on FreeBSD 13 yet.

+
+

You can use this script to automatically install all listed packages:

+
#!/bin/sh
+
+url="https://raw.githubusercontent.com/helloSystem/ISO/experimental/settings/packages.hello"
+curl -fsS $url | egrep -v '^#' | while read line ; do
+  pkg install -y -U $line || echo "[error] $line cannot be installed"
+done
+
+
+

To enable automount, run service devd restart.

+
+
+

Installing overlays

+
# git clone https://github.com/helloSystem/ISO
+# cp -Rfv ISO/overlays/uzip/hello/files/ / 
+# cp -Rfv ISO/overlays/uzip/localize/files/ / 
+# cp -Rfv ISO/overlays/uzip/openbox-theme/files/ /
+# cp -Rfv ISO/overlays/uzip/mountarchive/files/ / 
+
+
+
+

Note

+

If we provided the temporary packages that are used in the helloSystem ISO build process for download, then one could just install those instead of having to do the above.

+
+
+
+
+

Adjusting fstab

+

Edit /etc/fstab to look like this:

+
/dev/mmcsd0s2a  /       ufs     rw      0       0
+
+
+

Otherwise the root device may not be found upon reboot.

+
+

Enabling D-Bus and Avahi

+

Filer does not launch and Zeroconf does not work if /usr/local/bin/dbus-daemon --system is not running. Hence add the following lines to `/etc/rc.conf’ to enable it:

+
dbus_enable="YES"
+avahi_enable="YES" 
+
+
+

and then start it service dbus start.

+
+
+

Editing start-hello

+

Edit the start-hello script to use the launch command instead of hardcoding /Applications/....

+
#################################
+# Details to be inserted here.
+# This script is work in progress.
+#################################
+
+
+
+
+

Starting helloDesktop session

+
# echo start-hello > ~/.xinitrc
+# killall Xorg
+
+
+

Type startx to start an Xorg session; it should now load a helloDesktop session.

+

Sometimes it does not load all the way, in this case it is necessary to start xterm (right-click the desktop) and invoke start-hello from there again. The reason for this is unknown.

+
+
+

Adding a user

+

Added a new user with Applications -> Preferences -> Users

+
# cp /home/user/.openbox* .
+# cp -r /home/user/.config/* .config/
+
+
+
+
+
+

Improving system performance

+
+

Setting up SWAP for greater system memory capabilities

+
+

Note

+

While this will work on an SD card, it will be slow and wear out your drive quickly. Take it from me, SD cards SUCK for quick memory page access. It is highly recommended to use a SATA SSD when using SWAP. This section was adapted from a guide on nixCraft. It goes into more detail and even breifly covers encryption.

+
+
    +
  • Create a SWAP file using

    +
    # dd if=/dev/zero of=/swap bs=1M count=8192
    +
    +
    +
    +

    Note

    +

    This will create a swap file holding up to 8192 MB (8 GB) of memory. To go much further beyond that would recommend some further tweaking. 8 GB should be more than enough. It’s easy enough to convert what you want in GB to MB, but for the sake of convenience, multiply how much memory you want in gigabytes (GB) by 1024. For example, if you wanted 4 GB, you’d do 4*1024=4096.

    +
    +
  • +
  • Run # chmod 0600 /swap to give it the correct permissions.

  • +
  • Edit /etc/fstab and append the following line:

    +
    md42	none	swap	sw,file=/swap	0	0
    +
    +
    +
  • +
  • Run # swapon -aq to immediately enable SWAP

  • +
  • Run $ swapinfo -k to verify that it’s been attached correctly

  • +
+
+
+

Overclocking your system

+

With an SSD, SWAP, and several GPU enhancements enabled, you should immediately notice a speed boost. This will give you a much better development system and may even replace your desktop. However, you can quickly and easily take it a step further by overclocking your system. Please note, overclocking can lead to reduced hardware lifespan and can cause permenant damage. That said, I’ve found that a decent heat sing and a good fan go the trick. This is necessary as not having a somewhat competatant cooling solution will bite you in the ass. If you let it heat too much, it will thermal throttle and kill your performance. Do keep in mind, you need a good power supply to run this thing, especially overclocked. A Raspberry Pi power supply is a little different than a normal phone charger by design. Your new iPhone or MacBook charger probably won’t cut it. I’d recommend getting the official Rasbperry Pi power supply, manufactured by the Rasbperry Pi Foundation or whatever. Ir’s OEM, it’s good. Another great option is the Argon ONE power supply.

+

Overclocking is inherently dangerous as you are pushing the device beyond the intended spec. However, it is a very simple and robust machine that will most likely experience no ussues doing this. The Raspberry Pi is very affordable and modular, making the risk of hardware failure less of an issue. The main board can easily be swapped out and EEPROM flashed and you have your whole system back. There’s a hard limit to how far you can push your Pi, so don’t even worry about overdoing it. No 8 GHz liquid nitrogen overclocks I’m afraid.

+

To overclock you Raspberry Pi 4 to the max, edit /boot/msdos/config.txt and append the following:

+
over_voltage=6
+arm_freq=2147
+gpu_freq=700
+
+
+

2147 MHz is the maximum the device can go. Unlike Raspberry Pi OS, FreeBSD will boot even if you set these values higher. Even though you can set it higher, I can see no difference, even at 3000. You can set the gpu_freq up to “900” before it refuses to boot on FreeBSD. However, I can’t tell if it is actually working or not. Even if you can push it past its limits, you will probaby see diminishing returns. In the event that you actually can overclock it to these badass levels, I’d recommend investing in a monster CPU cooler, maybe even running liquid cooling or higher as 2147 MHz is already pretty warm.

+
+
+
+

Known issues

+
+

Note

+

Any help in improving the situation is appreciated.

+
+

Not sure whether vc4-kms-v3d is usable with FreeBSD.

+

Also see: https://papers.freebsd.org/2019/bsdcan/vadot-adventure_in_drmland/

+
+

Missing login window

+

The slim package is missing, hence we don’t have a login window at the moment.

+
+

Note

+

Web browser performance may be improved and the following issues may not be relevant anymore. This will require more user feedback and testing.

+
+
+
+

Web browser

+

The Falkon browser can be launched, but trying to load more than the most basic web pages such as http://frogfind.com/ leads to an instant crash:

+
# cat /root/.config/falkon/crashlog/Crash-2021-04-17T10:21:20.txt
+Time: Sa. Apr. 17 10:21:20 2021
+Qt version: 5.15.2 (compiled with 5.15.2)
+Falkon version: 3.1.0
+Rendering engine: QtWebEngine
+
+============== BACKTRACE ==============
+#0: 0x213810 <???> at /usr/local/bin/falkon
+#1: 0x499b4994 <_pthread_sigmask+0x524> at /lib/libthr.so.3
+
+
+
+

Note

+

The exact same crash also happens on a RockPro64 with 4GB of RAM.

+
+
+
+

RAM compression

+

On Linux, there is also zram which is enabled by default on Android and Chromium OS. Did anything ever come out of https://wiki.freebsd.org/SummerOfCode2019Projects/VirtualMemoryCompression?

+

macOS also does RAM compression when memory is getting low: https://www.lifewire.com/understanding-compressed-memory-os-x-2260327.

+

Windows also does RAM compression: https://www.tenforums.com/windows-10-news/17993-windows-10-memory-compression.html.

+

The following seems to “work” but can make the Raspberry Pi unacceptably slow:

+
# mdconfig -a -t malloc -o compress -o reserve -s 700m -u 7
+# swapon /dev/md7
+
+
+
+

Note

+

Please let us know if you know how to properly use RAM compression on FreeBSD.

+
+
+

Note

+

Do not use ZFS on memory-constrained machines.

+
+
+
+

Missing icons

+

Set QT_QPA_PLATFORMTHEME env variable before staring Xorg session.

+
setenv QT_QPA_PLATFORMTHEME panda
+
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/specifications.html b/developer/specifications.html new file mode 100644 index 00000000..a252e70f --- /dev/null +++ b/developer/specifications.html @@ -0,0 +1,183 @@ + + + + + + Specifications — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Specifications

+

helloSystem is designed to be friendly and welcoming. The desired user experience informs the specifications embraced for use in helloSystem and applications running on it.

+
+

Specifications embraced for use in helloSystem

+

These specifications cover technologies that are enthusiastically embraced in helloSystem and/or are recommended to be used in applications running on it.

+
    +
  • mDNS: Allows hostnames of devices to be published to the network, so that devices can be accessed using their names rather than using IP numbers.

  • +
  • DNS-SD/Zeroconf: Allows for the discovery of services on the network, such as websites, SSH servers, SFTP shares, etc. If an application can handle certain types of network services, it should discover such services using DNS-SD/Zeroconf. For example, a Terminal application might offer to connect to SSH servers on the network discovered with DNS-SD/Zeroconf.

  • +
  • IPP Everywhere: Allows printers to “just work” without configuring printer drivers.

  • +
  • AppImage: Allows applications to be shipped and used as single files. helloSystem may predominantly use this format for Linux applications in the future.

  • +
  • Markdown: The standard format for all documentation and other written text.

  • +
  • UTF-8: The default encoding for text.

  • +
+

This list is not exhaustive.

+
+
+

Conventions developed for use in helloSystem

+

These conventions cover technologies that are embraced for being used in helloSystem and applications running on it.

+
    +
  • Simplified application bundles: The format helloSystem predominantly uses for native applications. Derived from the GNUstep .app bundle format, but further simplified. Not formally specified yet.

  • +
+

This list is not exhaustive.

+
+
+

Specifications with relevance for helloSystem

+

These specifications cover technologies that may have relevance for helloSystem and are mostly considered for compatibility reasons. Their use within helloSystem may decline over time as more native replacements become available.

+
    +
  • ICCCM/EWMH: Allows windows to be managed on Xorg. This page in the picom wiki gives an overview

  • +
  • D-Bus: Allows processes on the system to interact with each other (inter-process communication, IPC)

  • +
  • XDG Desktop specification: Although helloSystem uses simplified application bundles to provide the desired user experience, some existing applications in FreeBSD ports and packages may come with .desktop files. To maintain compatibility with the vast body of existing applications, helloSystem needs to provide a basic implementation of this specification, although its use should be minimized in helloSystem to allow for the desired user experience. For example, all handling of .desktop files could be left to one command line tool such as desktop2app that would convert .desktop files into the format used natively in helloSystem. Other uses of the XDG Desktop specification may be phased out in the future

  • +
+

This list is not exhaustive.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/tracing.html b/developer/tracing.html new file mode 100644 index 00000000..785269ea --- /dev/null +++ b/developer/tracing.html @@ -0,0 +1,178 @@ + + + + + + Tracing with DTrace/dtruss — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Tracing with DTrace/dtruss

+

The dtruss command line tool can be used to examine what a running process is doing. Other than, e.g., strace on Linux, dtruss can be used to watch already-running processes. This makes it more suitable to watch processes that have been launched by, e.g., the launch command.

+
$ sudo pkg install dtrace-toolkit
+$ sudo kldload dtraceall
+$ launch FeatherPad
+// In another terminal:
+$ ps ax | grep featherpad
+// Then use the PID of the featherpad process for the next command:
+$ sudo dtruss -p 1886 -f
+
+
+
+

Note

+

If you get probe description syscall:::entry does not match any probes, then possibly you loaded kldload dtrace rather than kldload dtraceall.

+
+

The FreeBSD DTrace Tutorial has many one-liner examples for tasks like observing

+
    +
  • File Opens

  • +
  • Syscall Counts By Process

  • +
  • Distribution of read() Bytes

  • +
  • Timing read() Syscall

  • +
  • Measuring CPU Time in read()

  • +
  • Count Process-Level Events

  • +
  • Profile On-CPU Kernel Stacks

  • +
  • Scheduler Tracing

  • +
  • TCP Inbound Connections

  • +
  • Raw Kernel Tracing

  • +
+

There is also a full list of DTrace One-Liners to pick up more DTrace functionality.

+
+

Note

+

In the future a graphical utility might be written to automate common tracing tasks.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/developer/ux-guidelines.html b/developer/ux-guidelines.html new file mode 100644 index 00000000..417b2d3c --- /dev/null +++ b/developer/ux-guidelines.html @@ -0,0 +1,192 @@ + + + + + + User Experience Guidelines — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

User Experience Guidelines

+

Since helloSystem is intended to be friendly and welcoming to switchers from the Mac, it is important to understand the underlying concepts and design considerations that went into the Mac. We are not aiming to create a 1:1 replica, but something that is generally consistent with the underlying general user experience (UX) philosophy, which has been openly documented.

+
+

Macintosh Human Interface Guidelines

+

What are the design principles that make user interfaces “Mac-like”? Apple spelled them out for us publicly 30 years ago in a book, the Macintosh Human Interface Guidelines. Besides describing what makes user interfaces “Mac-like”, the book also explains general concepts like how to perform user testing.

+
+

If you are a designer, a human interface professional, or an engineer, this book contains information you can use to design and create products that fit the Macintosh model. It provides background information that can help you plan and make decisions about your product design. Even if you don’t design and develop products for the Macintosh, reading this book will help you to understand the Macintosh interface.

+
+

Source: Apple Computer, Inc., 1992, Macintosh Human Interface Guidelines, First Printing, November 1992. Addison-Wesley Publishing Company. ISBN 0-201-62216-5

+
+
+

Using the global menu bar

+
+

Walker, N & Smelcer, 1990 (Superiority of the global menu bar)

+

Referred to in the Macintosh Human Interface Guidelines with highest praise:

+
+

A seminal paper on why pull-down menus are superior to any other kind. +Everyone who designs for the screen must read this paper.

+
+

This paper provides empirical evidence on the superiority of global menus.

+
+

Systems that maximize the percentage of menu items with borders will have a decided +advantage over other menu systems.

+

In this experiment the initial movement to the pull-down menus was larger that +average distance required to reach the top of a 19 inch diagonal screen, yet the pull-downs still significantly outperformed the walking menus. Therefore, it may be +more efficient to place menus at the top of the window

+
+

Source: Walker, N & Smelcer, JB 1990, A comparison of selection times from walking and pull-down menus. in JC Chew & J Whiteside (eds), Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI 1990. Association for Computing Machinery, pp. 221-225, 1990 SIGCHI Conference on Human Factors in Computing Systems, CHI 1990, Seattle, United States, 4/1/90. https://dl.acm.org/doi/pdf/10.1145/97243.97277

+
+
+
+

Avoiding hidden menus hamburger icons

+

Menus hidden behind hamburger menus have been proven to hurt user experience. They should not be used. The global menu bar should be used instead.

+
+
+

Avoiding configuration options

+

Configuration options add complexity to software, increase the test matrix, and make software harder to support (e.g., over the phone) because no two systems behave exactly the same way depending on how they were configured. Hence in helloSystem we want to avoid unnecessary user-facing configuration options whenever possible. We take great care to set sensible defaults and make things “just work” as expected (in line with our design objectives) out of the box, without the need for configuration. KDE Plasma is recommended as an alternative for users who wish to configure and customize every aspect of the system.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/genindex.html b/genindex.html new file mode 100644 index 00000000..4ae25570 --- /dev/null +++ b/genindex.html @@ -0,0 +1,144 @@ + + + + + + Index — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/index.html b/index.html new file mode 100644 index 00000000..364f0bae --- /dev/null +++ b/index.html @@ -0,0 +1,154 @@ + + + + + + hello — helloSystem documentation + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ + The helloSystem logo +

+Willkommen • Welcome • Bienvenue • Benvenuto • Bienvenido • ようこそ • Mabuhay • Tervetuloa • Välkommen • Добро пожаловать • Hoş geldiniz • Bonvenon • 歡迎 • Ласкаво просимо • 欢迎

+

hello

+

helloSystem is a desktop system for creators with a focus on simplicity, elegance, and usability. Its design follows the “Less, but better” philosophy. It is intended as a system for “mere mortals”, welcoming to switchers from the Mac. FreeBSD is used as the core operating system. Please refer to https://github.com/helloSystem/hello if you would like to learn more about the ideas and principles behind hello.

+

Screenshot

+
+
+
+
+
+
+
+ + +
+
+
+ +
+ +
+

+
+ + + +
+
+
+
+
+ + + + \ No newline at end of file diff --git a/make.sh b/make.sh deleted file mode 100755 index 66e912d7..00000000 --- a/make.sh +++ /dev/null @@ -1,27 +0,0 @@ -#! /bin/bash - -set -e - -CUR_DIR=$(readlink -f $(dirname "$0")) - -cd "$CUR_DIR" - -VENV="$CUR_DIR"/.venv - -if [ ! -d "$VENV" ] || [ ! -e "$VENV"/bin/activate ]; then - echo $(tput bold)$(tput setaf 2)"Creating new virtual environment in $VENV"$(tput sgr0) - PYTHON=python3 - which python3.6 &>/dev/null && PYTHON=python3.6 - "$PYTHON" -m venv "$VENV" -fi - -source "$VENV"/bin/activate - -# this snippet should allow us to call pip install only if the requirements file has been touched -if [ ! -f "$VENV"/requirements.txt ] || [ $(sha256sum requirements.txt | cut -d' ' -f1) != $(sha256sum "$VENV"/requirements.txt | cut -d' ' -f1) ]; then - echo $(tput bold)$(tput setaf 2)"Requirements updated, reinstalling"$(tput sgr0) - cp requirements.txt "$VENV"/requirements.txt - pip install -U -r "$VENV"/requirements.txt -fi - -make "$@" diff --git a/objects.inv b/objects.inv new file mode 100644 index 00000000..626393da Binary files /dev/null and b/objects.inv differ diff --git a/requirements.txt b/requirements.txt deleted file mode 100644 index 2741eaf0..00000000 --- a/requirements.txt +++ /dev/null @@ -1,10 +0,0 @@ -wheel -sphinx>=5.0.0 -sphinx_rtd_theme>=0.5.2 -sphinx-autobuild -sphinx-last-updated-by-git -myst-parser -sphinxcontrib-qthelp -# docutils needs to be pinned for now so that lists work -# See https://github.com/readthedocs/sphinx_rtd_theme/issues/1115 for more information -docutils==0.16 diff --git a/reviewer/guide.html b/reviewer/guide.html new file mode 100644 index 00000000..fc3b6b4b --- /dev/null +++ b/reviewer/guide.html @@ -0,0 +1,236 @@ + + + + + + Reviewer Guide — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Reviewer Guide

+
+

Introduction

+

helloSystem is an open-source operating system that builds on FreeBSD as a rock solid foundation. Its goal is to provide a friendly, highly usable, and visually appealing system for desktop and notebook computers. The system is designed to be easy to use, efficient, with an emphasis on minimalism and simplicity.

+

Its target audience are switchers from the Mac platform, to which it aims to provide an environment in which they can feel instantly at home.

+

The purpose of this guide is to provide an overview of helloSystem, as well as to offer guidance on how to use the system’s features and capabilities. The guide includes information on system requirements, installation, user interface, features, performance, support options, and more. When reviewing helloSystem, try to look at it from a perspective of long-time Mac users, particularly those who are doing creative work like graphics, design, video editing, or 3D modeling and printing but who would like to do so using open source applications. This guide should provide you with a thorough understanding of the system and its functionality and should give you a starting point for your own exploration.

+
+
+

System Requirements

+

To run helloSystem, you will need a system that meets the following minimum requirements:

+
    +
  • 64-bit x86 processor

  • +
  • 2 GB of RAM

  • +
  • Dedicated storage device with at least 10 GB of available space

  • +
  • Graphics card capable of 1024x768 resolution

  • +
+

For optimal performance, we recommend the following:

+
    +
  • 4 GB of RAM or more

  • +
  • Dedicated SSD with at least 120 GB of available space

  • +
  • Graphics card capable of 1920x1080 resolution or higher

  • +
+

Please note that helloSystem is not currently available for computers with ARM-based processors, although there are build instructions for Raspberry Pi.

+

When reviewing or benchmarking helloSystem, it is important to note that virtual machines may not provide an accurate representation of the system’s stability, feature set, and performance. Therefore, we recommend that reviewers use real hardware for these purposes. Running helloSystem on actual hardware will provide a more authentic experience and allow reviewers to test the system’s capabilities in a more realistic environment. Additionally, using real hardware will help to ensure that the system’s hardware support is properly evaluated. For these reasons, we strongly advise against conducting tests and benchmarks in a virtual environment, even though VirtualBox guest drivers are preinstalled.

+
+
+

Installation

+

Installing helloSystem is a relatively straightforward process. Follow these steps to install helloSystem on your system:

+
    +
  1. Download the helloSystem ISO file from the helloSystem website.

  2. +
  3. Burn the ISO file to a USB drive or DVD.

  4. +
  5. Insert the USB drive or DVD into your computer and boot from it.

  6. +
  7. Follow the on-screen instructions to install helloSystem.

  8. +
+

helloSystem is designed to be installed on a dedicated SSD, and for the sake of simplicity currently cannot be installed alongside other operating systems on the same disk. Additionally, if you are running helloSystem on a device with a UEFI firmware, you may need to disable Secure Boot in order to boot into helloSystem.

+

If you encounter any issues during the installation process, please consult the helloSystem documentation or contact the helloSystem discussion forum for assistance.

+
+
+

User Interface

+

The six-part series on Linux desktop usability by helloSystem’s founder eventually lead to the design and development of helloSystem. The series explored aspects of desktop usability, from user interface design to application packaging and distribution. The insights expressed in the series helped inform the design decisions behind helloSystem, with a focus on simplicity, ease of use, and discoverability. The intended result is a user-friendly and efficient operating system that is easy to use and customize, even for non-technical users.

+

The helloSystem user interface is designed to be intuitive, functional, and discoverable, with a range of features and tools to meet the needs of both new and experienced users. Here are some key concepts:

+
    +
  • Command key left to the spacebar: On systems with a Mac-style keyboard, the Command key is located to the left of the spacebar, which can be more comfortable for Mac users. When helloSystem is used with a PC keyboard, the Alt key functions as the Command key, being located in the same physical location on the keyboard.

  • +
  • Global menu bar: helloSystem features a global menu bar, which is a menu bar that is located at the top of the screen, rather than within the application window. This provides for a consistent user experience across applications, even if those applications are written in non-native frameworks such as Gtk or Electron.

  • +
  • Keyboard layout and language autodetection: When using a Mac or a Raspberry Pi Keyboard and Hub, helloSystem will automatically detect the keyboard layout and language, removing the need to configure it manually.

  • +
  • Menu search and launcher: helloSystem includes a powerful menu search and launcher, which can be used to quickly find and launch applications, files, and menu commands. It is located in the top left corner of the global menu bar and can be a true productivity booster, as it allows the system to be operated virtually only by using the keyboard.

  • +
  • Application bundles: Applications on helloSystem are structured as self-contained bundles, which can be easily installed, removed, and updated.

  • +
  • launch command using a database: helloSystem uses a database to manage launch commands, rather than relying on traditional XDG desktop files, which will provide better functionality, e.g., for applications that can be freely moved around in the fileystem without the need to update .desktop files.

  • +
  • Source code editability for many Utilities: Many of the utilities included with helloSystem have their source code included and do not need to be compiled, making it easy for users to customize and contribute to the system. Right-click on an application icon and choose “Show Contents” to see and edit the source code.

  • +
+
+
+

Features

+
    +
  • Resource efficiency: helloSystem is designed to be lightweight and efficient, with moderate resource usage, making it suitable for use on a range of hardware configurations. Compare the RAM usage to other similar systems.

  • +
  • Graphics and media support: helloSystem includes a range of appliactions and features designed to support graphics artists, designers, videographers, makers with 3D printers, and other creative professionals, without requiring them to think much about the operating system.

  • +
  • Under Construction: The “Under Construction” section of the menu provides access to various utilities and tools that are currently in development, and are looking for contributors to help bring them to completion. helloSystem does not hide its open source nature, and invites power users to join the development fun.

  • +
  • Zeroconf (mDNS-SD): helloSystem makes use of this technology throughout the system to advertise and browse network resources, like servers, printers, and the like.

  • +
  • Create Live Media utility: helloSystem includes a tool for creating live media, which can be used to create a bootable USB or DVD to try helloSystem without installing it on your system. It can also burn the latest, frequently released, experimental ISO builds directly to USB sticks.

  • +
+
+
+

Particularities

+
    +
  • Please refer to the global menu bar at the top of the screen in helloSystem as the “Menu”, as those who have grown up using a Macintosh will likely feel right at home with this naming convention. Avoid terminology like “panel”, as the target audience of helloSystem may not be familiar with it. Similarly, please refer to the “desktop”, “documents”, and “folders” rather than the “wallpaper”, “files”, and “directories”.

  • +
  • The file manager in helloSystem, Filer, is intentionally kept simple and is aspiring to grow into a truly spatial file manager over time. Which means that every document and folder has one physical location on the screen, and one location only. When opening an empty folder, it will show a blank window. This is because there is nothing to display in an empty folder, much like how a text editor shows a blank window when opening a new text file.

  • +
  • helloSystem uses black text on white background. With the intoduction of modern graphical user interfaces, black text on white background (like paper, “WYSIWYG”) was a revelation compared to the amber or green screens of MS-DOS PCs.

  • +
  • In helloSystem, there is no concept of “launchers.” Instead, it uses symlinks to applications, which can be created by dragging and dropping an application from its folder to the desktop. Keep in mind that helloSystem aims to keep things simple and straightforward for switchers from the Mac, who don’t have conceptions of “launchers”.

  • +
  • The Dock is not used by default in helloSystem, although it is still available in /System for those who really need it. While the Dock was a later addition to the Mac OS X experience, helloSystem allows users to switch between applications like on Classic systems, saving precious screen real estate at the bottom of the screen.

  • +
  • In helloSystem, there is no unified control panel. Instead, there are individual preferences applications located in /Applications/Preferences. This is simpler and more similar to the control panels found in System 7.

  • +
+
+
+

Support

+

helloSystem is a community-driven project. If you encounter any issues or have questions about helloSystem, there are several resources available to help you get support and connect with the community:

+
    +
  • Official website: The helloSystem website (https://hellosystem.github.io/) provides a range of resources and information about the operating system, including documentation for users and for developers.

  • +
  • Issue tracker: If you encounter a bug or have an issue with helloSystem, please submit a report to the issue tracker (https://github.com/helloSystem/ISO/issues) on the project’s GitHub page. This is a great way to get help and connect with the development team and the broader helloSystem community.

  • +
  • Discussions: The helloSystem forum (https://github.com/helloSystem/hello/discussions/) provides a platform for users to connect with each other and discuss topics related to helloSystem, including troubleshooting, brainstorming, and development.

  • +
  • IRC channel: For more immediate assistance, you can join the helloSystem IRC channel (#hellosystem) on the Libera.Chat network. This is a great way to connect with other users and developers in real time. Please stay in the channel for several days, as many contributors cannot be there 24/7.

  • +
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/search.html b/search.html new file mode 100644 index 00000000..52d7d393 --- /dev/null +++ b/search.html @@ -0,0 +1,158 @@ + + + + + + Search — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/searchindex.js b/searchindex.js new file mode 100644 index 00000000..7ca0ce78 --- /dev/null +++ b/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({"docnames": ["developer/acknowledgements", "developer/application-bundles", "developer/applications", "developer/architecture", "developer/base", "developer/binary-compatibility", "developer/boot", "developer/building", "developer/contact", "developer/contributing", "developer/developer-tools", "developer/distributions", "developer/filer-context-menus", "developer/geom_rowr", "developer/graphics", "developer/linux", "developer/localization", "developer/man", "developer/menu", "developer/midi", "developer/monkey-patch", "developer/ports", "developer/rpi", "developer/specifications", "developer/tracing", "developer/ux-guidelines", "index", "reviewer/guide", "user/components", "user/components/applications", "user/components/applications/falkon", "user/components/applications/iridium", "user/components/autostart", "user/components/filesystems", "user/components/preferences", "user/components/preferences/boot-environments", "user/components/preferences/desktop", "user/components/preferences/keyboard", "user/components/preferences/sharing", "user/components/preferences/shortcuts", "user/components/preferences/wireless-networks", "user/components/system", "user/components/system/dock", "user/components/system/filer", "user/components/system/launch", "user/components/system/menu", "user/components/utilities", "user/components/utilities/calculator", "user/components/utilities/calendar", "user/components/utilities/create-live-media", "user/components/utilities/hardware-probe", "user/components/utilities/install", "user/components/utilities/mountarchive", "user/components/utilities/remote-assistance", "user/components/utilities/sticky-notes", "user/components/utilities/update", "user/components/windows", "user/feedback", "user/getting-started", "user/troubleshooting"], "filenames": ["developer/acknowledgements.md", "developer/application-bundles.md", "developer/applications.md", "developer/architecture.md", "developer/base.md", "developer/binary-compatibility.md", "developer/boot.md", "developer/building.md", "developer/contact.md", "developer/contributing.md", "developer/developer-tools.md", "developer/distributions.md", "developer/filer-context-menus.md", "developer/geom_rowr.md", "developer/graphics.md", "developer/linux.md", "developer/localization.md", "developer/man.md", "developer/menu.md", "developer/midi.md", "developer/monkey-patch.md", "developer/ports.md", "developer/rpi.md", "developer/specifications.md", "developer/tracing.md", "developer/ux-guidelines.md", "index.md", "reviewer/guide.md", "user/components.md", "user/components/applications.md", "user/components/applications/falkon.md", "user/components/applications/iridium.md", "user/components/autostart.md", "user/components/filesystems.md", "user/components/preferences.md", "user/components/preferences/boot-environments.md", "user/components/preferences/desktop.md", "user/components/preferences/keyboard.md", "user/components/preferences/sharing.md", "user/components/preferences/shortcuts.md", "user/components/preferences/wireless-networks.md", "user/components/system.md", "user/components/system/dock.md", "user/components/system/filer.md", "user/components/system/launch.md", "user/components/system/menu.md", "user/components/utilities.md", "user/components/utilities/calculator.md", "user/components/utilities/calendar.md", "user/components/utilities/create-live-media.md", "user/components/utilities/hardware-probe.md", "user/components/utilities/install.md", "user/components/utilities/mountarchive.md", "user/components/utilities/remote-assistance.md", "user/components/utilities/sticky-notes.md", "user/components/utilities/update.md", "user/components/windows.md", "user/feedback.md", "user/getting-started.md", "user/troubleshooting.md"], "titles": ["Acknowledgements", "Application Bundles", "Applications", "Architecture", "Working with the FreeBSD base system", "Binary Compatibility", "Boot process", "Building the Live ISO", "Contact", "Contributing", "Developer Tools", "Note to distributions", "Extending Filer context menus", "geom_rowr kernel module", "Graphics hardware autoconfiguration", "Building on Linux", "Localization", "Writing man pages", "Global Menu", "MIDI", "Monkey Patching", "Working with FreeBSD Ports", "Raspberry Pi", "Specifications", "Tracing with DTrace/dtruss", "User Experience Guidelines", "hello", "Reviewer Guide", "Getting to know the system", "Applications", "Falkon", "Iridium", "Autostart", "Filesystems", "Preferences", "Boot Environments", "Desktop", "Keyboard", "Sharing", "Shortcut Keys", "Wireless Networks", "System components", "Dock", "Filer", "launch", "Menu", "Utilities", "Calculator", "Calendar", "Create Live Media", "Hardware Probe", "Install helloSystem", "mountarchive", "Remote Assistance", "Sticky Notes", "Update", "Windows", "Providing feedback", "Getting started", "Troubleshooting"], "terms": {"grate": 0, "i": [0, 1, 2, 3, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 29, 30, 31, 32, 35, 36, 37, 38, 39, 40, 42, 43, 44, 45, 47, 48, 49, 50, 51, 53, 55, 57, 58, 59], "made": [0, 6, 12, 13, 20, 21, 38, 49, 53], "follow": [0, 2, 6, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 26, 27, 28, 30, 31, 33, 34, 38, 39, 41, 43, 44, 45, 46, 49, 51, 55, 58], "person": [0, 35, 53], "organ": 0, "mention": [0, 7, 18], "roughli": [0, 12, 22], "order": [0, 1, 3, 6, 10, 11, 12, 19, 21, 27, 35, 49, 57, 58], "first": [0, 3, 4, 6, 9, 10, 12, 15, 21, 25, 31, 51, 57, 58], "involv": 0, "http": [0, 1, 2, 4, 5, 6, 7, 9, 10, 11, 12, 15, 17, 18, 21, 22, 25, 26, 27, 31, 50, 57, 58, 59], "www": [0, 12, 18, 21, 22, 31], "org": [0, 1, 4, 5, 6, 8, 11, 12, 15, 18, 21, 22, 25, 50, 57, 58], "provid": [0, 1, 3, 6, 7, 12, 13, 18, 20, 22, 23, 25, 27, 32, 43, 49, 51, 53, 56, 58], "underli": [0, 25], "oper": [0, 1, 6, 7, 11, 12, 18, 26, 27, 35, 38, 43, 49, 50, 51, 53, 55, 56, 58], "system": [0, 1, 3, 5, 11, 12, 13, 14, 15, 20, 21, 23, 25, 26, 29, 32, 35, 37, 38, 39, 42, 44, 45, 49, 50, 51, 55, 56, 59], "As": [0, 5, 6, 12, 13, 18, 19, 21, 42, 44, 53], "list": [0, 6, 7, 12, 18, 21, 22, 23, 24, 39, 44, 45, 58], "freshport": 0, "end": [0, 6, 7, 12, 18, 19, 21, 22, 38, 44, 53], "user": [0, 2, 3, 5, 7, 8, 10, 12, 13, 14, 15, 18, 20, 21, 23, 32, 35, 36, 38, 43, 44, 48, 50, 51, 52, 56, 57, 58], "applic": [0, 7, 10, 12, 14, 16, 21, 22, 23, 27, 28, 32, 34, 35, 36, 37, 38, 39, 40, 41, 44, 47, 48, 49, 51, 53, 55, 58], "probonopd": 0, "found": [0, 9, 12, 13, 19, 22, 27], "act": [0, 34], "main": [0, 4, 5, 6, 7, 12, 13, 18, 19, 22, 51, 59], "develop": [0, 2, 5, 6, 7, 8, 11, 13, 15, 16, 18, 20, 21, 22, 25, 27, 50, 55, 57, 58], "pkgdemon": 0, "malco2001": 0, "irc": [0, 8, 27, 57], "furybsd": [0, 6, 7, 13], "origin": [0, 1, 6, 18, 21, 31], "wrote": [0, 19], "tool": [0, 1, 7, 13, 15, 17, 19, 21, 23, 24, 27, 43, 50, 52, 58], "creat": [0, 2, 6, 7, 12, 13, 14, 15, 16, 17, 18, 19, 22, 25, 27, 28, 32, 34, 43, 46, 51, 55, 59], "live": [0, 2, 9, 10, 14, 18, 27, 28, 35, 46, 51, 59], "iso": [0, 2, 6, 9, 10, 15, 22, 27, 49, 58], "com": [0, 1, 2, 4, 6, 7, 9, 10, 15, 17, 18, 21, 22, 26, 27, 31, 57, 59], "continu": [0, 6, 7, 13, 18, 20, 51], "build": [0, 6, 9, 11, 18, 22, 27, 55, 58], "infrastructur": [0, 7], "fkorotkov": 0, "help": [0, 3, 22, 25, 27, 38, 50, 53], "support": [0, 1, 5, 6, 7, 11, 12, 14, 18, 19, 22, 25, 33, 58], "concern": [0, 12, 18], "all": [0, 3, 5, 6, 7, 8, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 32, 35, 45, 49, 50, 51, 54, 55, 56, 57, 58, 59], "thing": [0, 1, 5, 6, 9, 18, 19, 22, 25, 27], "freebsdfound": 0, "gave": 0, "permiss": [0, 2, 22, 43, 51], "us": [0, 1, 3, 4, 5, 6, 7, 9, 10, 11, 12, 14, 15, 16, 17, 18, 20, 21, 22, 24, 26, 27, 29, 31, 33, 35, 37, 38, 39, 40, 41, 42, 43, 45, 48, 49, 50, 51, 53, 55, 56, 57, 58, 59], "trademark": 0, "instal": [0, 1, 3, 5, 7, 10, 12, 15, 18, 19, 21, 24, 28, 31, 35, 38, 43, 44, 46, 49, 55], "util": [0, 2, 10, 13, 18, 19, 22, 24, 27, 28, 33, 39, 40, 45, 48, 49, 50, 51, 53, 55, 58], "vermaden": 0, "feedback": [0, 22], "configur": [0, 3, 6, 12, 14, 15, 19, 23, 27, 39, 51, 58], "advic": 0, "tap": 0, "click": [0, 1, 3, 12, 18, 19, 21, 22, 27, 29, 35, 37, 39, 42, 43, 45, 51, 52, 53, 54, 56, 59], "two": [0, 5, 12, 21, 25, 58], "finger": 0, "scroll": [0, 6], "synapt": 0, "elan": 0, "touchpad": 0, "rekol": 0, "revenmartin": 0, "panda": [0, 22], "statu": [0, 5, 7, 17, 18, 55, 58], "bar": [0, 3, 18, 27, 43, 45, 51, 54, 58], "which": [0, 1, 3, 5, 6, 7, 10, 12, 13, 14, 15, 16, 18, 19, 22, 25, 27, 28, 34, 35, 37, 39, 41, 42, 43, 44, 46, 49, 51, 58, 59], "hello": [0, 3, 6, 7, 9, 11, 20, 27, 57, 58, 59], "menu": [0, 6, 10, 15, 19, 27, 28, 29, 35, 37, 39, 41, 42, 43, 44, 53, 54, 56, 58, 59], "base": [0, 2, 6, 8, 10, 12, 15, 18, 19, 21, 22, 27, 31, 51, 57, 58], "cyber": [0, 22], "dock": [0, 10, 27, 28, 41, 44, 45, 56], "aolo": 0, "a_l_": 0, "implement": [0, 12, 15, 17, 23, 44], "action": [0, 7, 18, 39, 51], "search": [0, 2, 3, 15, 18, 27, 29, 39, 41, 44, 59], "through": [0, 3, 9, 10, 18, 38, 44], "menubar": [0, 18, 22], "antonyjr0": 0, "put": [0, 3, 42, 58], "field": [0, 6, 18, 51, 58, 59], "integr": [0, 7, 10, 11, 18, 44], "keshavbhatt": 0, "keshavmail68": 0, "make": [0, 2, 5, 6, 7, 12, 13, 15, 17, 18, 19, 20, 22, 24, 25, 27, 30, 35, 38, 39, 41, 49, 52, 55, 56, 58, 59], "submenu": [0, 12], "clickabl": 0, "reach": [0, 13, 25], "out": [0, 5, 6, 12, 19, 21, 22, 23, 25, 29, 45, 49, 51, 58], "kernel": [0, 6, 24, 55], "improv": [0, 18], "document": [0, 1, 6, 10, 12, 16, 18, 23, 25, 27, 30, 41, 43, 49, 51, 58], "sphinx": 0, "evangel": 0, "restructuredtext": 0, "cmake": [0, 15, 21, 22], "qt": [0, 1, 2, 3, 10, 22, 48], "translat": [0, 18], "lpozo": 0, "tutori": [0, 24], "sampl": 0, "code": [0, 2, 6, 7, 9, 11, 13, 15, 18, 20, 21, 27, 29, 48, 58], "form": [0, 1, 2, 12, 22, 29, 53], "basi": 0, "calcul": [0, 14, 28, 41, 46], "app": [0, 2, 3, 7, 18, 23, 32, 42, 44], "mrclksr": 0, "initgfx": [0, 6, 14, 20], "graphic": [0, 2, 7, 10, 12, 24, 27, 32, 44, 45, 47, 50, 56, 58, 59], "hardwar": [0, 15, 19, 21, 27, 28, 37, 40, 46, 59], "autoconfigur": 0, "grahamperrin": 0, "earli": [0, 20], "test": [0, 5, 7, 11, 12, 14, 20, 21, 22, 25, 27, 29, 46], "refresh": [0, 30], "itself": [0, 1, 12, 21, 22, 58], "automat": [0, 6, 7, 10, 16, 19, 21, 22, 27, 29, 31, 32, 33, 35, 37, 38, 42, 43, 44, 51, 58], "fix": [0, 4, 13, 21, 44], "desktop": [0, 1, 11, 15, 17, 21, 22, 23, 26, 27, 28, 32, 34, 38, 44, 52, 56, 58], "multi": 0, "monitor": [0, 3], "setup": [0, 6, 15], "moochri": 0, "filer": [0, 10, 15, 27, 28, 35, 41, 44, 52], "ad": [0, 3, 12, 14, 18, 51], "initi": [0, 7, 10, 25], "spatial": [0, 27, 43], "mode": [0, 12, 15, 43, 49, 58, 59], "option": [0, 1, 6, 12, 13, 15, 19, 20, 21, 27, 31, 36, 38, 58], "folder": [0, 10, 12, 27, 29, 32, 39, 41, 43], "open": [0, 1, 2, 3, 9, 12, 15, 16, 18, 24, 27, 29, 33, 35, 39, 41, 43, 49, 51, 52, 53, 55, 58], "new": [0, 6, 9, 12, 13, 14, 16, 18, 21, 22, 27, 35, 54, 55, 58, 59], "window": [0, 3, 6, 12, 19, 23, 25, 27, 28, 33, 35, 38, 39, 41, 43, 49, 52, 53, 58], "alreadi": [0, 6, 12, 13, 18, 21, 22, 24, 35, 58, 59], "come": [0, 1, 2, 3, 4, 6, 7, 8, 18, 21, 22, 23, 29, 30, 34, 39, 41, 43, 46, 57, 58], "front": [0, 38], "rather": [0, 1, 3, 9, 12, 15, 18, 19, 21, 23, 24, 27], "than": [0, 1, 3, 5, 9, 12, 15, 18, 19, 21, 22, 23, 24, 27, 40, 58], "same": [0, 1, 2, 3, 5, 7, 10, 11, 12, 13, 18, 22, 25, 27, 44, 51, 58], "multipl": [0, 3, 14, 44, 58], "time": [0, 1, 2, 5, 6, 10, 12, 13, 15, 19, 20, 21, 22, 23, 24, 25, 27, 31, 41, 51, 55], "volum": 0, "show": [0, 2, 3, 6, 8, 12, 18, 20, 21, 27, 29, 54, 57], "up": [0, 12, 15, 16, 18, 21, 24, 27, 43, 55, 58, 59], "host": [0, 16, 58], "crowd": 0, "sourc": [0, 2, 6, 7, 9, 14, 16, 18, 19, 21, 25, 27, 29, 43, 48, 58], "cree": 0, "possibl": [0, 1, 3, 6, 7, 9, 12, 18, 20, 21, 25, 40, 43, 44, 51, 58], "intel": [0, 5, 13, 58], "gpu": [0, 5, 6, 14, 22], "driver": [0, 5, 6, 13, 23, 27, 50], "12": [0, 4, 5, 6, 7, 18, 21, 58], "2": [0, 2, 4, 5, 6, 7, 12, 13, 18, 21, 22, 27, 45, 49, 58, 59], "from": [0, 1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 19, 20, 22, 23, 25, 26, 27, 31, 33, 35, 37, 38, 39, 42, 43, 44, 45, 48, 49, 50, 51, 53, 55, 56, 57, 58, 59], "privat": [0, 50], "packag": [0, 5, 6, 14, 15, 18, 19, 23, 27, 33, 43, 55, 58], "falkon": [0, 1, 22, 28, 29], "browser": [0, 10, 18, 30, 31, 39], "doe": [0, 5, 6, 7, 12, 13, 14, 15, 18, 19, 21, 22, 24, 27, 32, 35, 44, 51, 55, 58, 59], "pull": [0, 5, 9, 18, 25], "mani": [0, 1, 3, 9, 10, 12, 16, 18, 24, 27, 43, 44], "kde": [0, 7, 12, 15, 18, 25], "depend": [0, 2, 3, 5, 6, 12, 14, 19, 21, 22, 25, 51], "updat": [0, 4, 6, 15, 16, 19, 22, 27, 28, 46, 58], "requir": [0, 1, 6, 9, 12, 15, 18, 21, 25, 43, 51], "write": [0, 6, 12, 13, 14, 20, 21, 22, 33, 46, 53, 58], "geom_rowr": 0, "modul": [0, 6, 14], "combin": [0, 6, 13, 14, 18, 39], "read": [0, 6, 12, 13, 20, 21, 22, 24, 25, 33, 53], "onli": [0, 1, 6, 8, 12, 13, 18, 20, 21, 27, 29, 35, 39, 53, 55, 58], "devic": [0, 6, 7, 14, 19, 20, 22, 23, 27, 49, 51, 55, 58], "jsm222": [0, 18], "hellodesktop": [0, 11, 18, 59], "compon": [0, 6, 7, 9, 11, 15, 28, 55, 58], "detail": [0, 1, 6, 12, 18, 21, 22, 50, 51, 58], "global": [0, 3, 6, 27], "chrome": [0, 31], "firefox": [0, 59], "patch": [0, 1, 6, 21], "thunderbird": 0, "s199p": 0, "wa1k9k": 0, "s199pwa1k9r": 0, "aarch64": [0, 22], "mszoek": 0, "thatzoek": 0, "freedesktop": [0, 12, 18], "filemanager1": 0, "api": 0, "hellosystem": [0, 1, 2, 3, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16, 18, 19, 20, 22, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35, 38, 39, 41, 42, 43, 44, 45, 46, 49, 55, 56, 57, 58, 59], "spanish": 0, "zweibruecken": 0, "ip": [0, 23, 38, 50], "de": [0, 12], "donat": [0, 58], "mac": [0, 1, 3, 18, 25, 26, 27, 37, 38, 39, 50], "mini": 0, "mid": 0, "2010": [0, 12], "macmini4": 0, "1": [0, 5, 6, 7, 12, 13, 14, 15, 17, 18, 20, 21, 22, 25, 35, 58, 59], "zoo": 0, "bittin": 0, "swedish": 0, "frameworkcomput": 0, "mainboard": [0, 58], "i5": 0, "1135g7": 0, "program": [0, 12, 18], "hierosm": 0, "alia": 0, "tuuux": 0, "rewrot": 0, "process": [0, 1, 3, 10, 11, 12, 18, 20, 21, 22, 23, 24, 27, 51, 58], "159": 0, "network": [0, 1, 3, 6, 10, 23, 27, 28, 34, 38, 43, 51], "manag": [1, 3, 6, 18, 23, 27, 41, 43, 58, 59], "nativ": [1, 3, 17, 23, 27, 39, 55], "whenev": [1, 3, 12, 19, 25, 32, 44, 58], "ar": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 20, 21, 22, 23, 25, 27, 28, 31, 33, 34, 35, 39, 41, 42, 43, 44, 45, 46, 48, 49, 50, 51, 55, 57, 58, 59], "xdg": [1, 3, 7, 12, 22, 23, 27], "style": [1, 27, 58], "file": [1, 3, 4, 6, 7, 10, 13, 14, 16, 17, 19, 21, 22, 23, 24, 27, 29, 31, 35, 41, 44, 49, 52, 53, 58], "consid": [1, 3, 9, 12, 18, 19, 23, 40, 58], "should": [1, 2, 3, 5, 6, 7, 12, 13, 14, 15, 17, 18, 19, 20, 22, 23, 25, 27, 36, 37, 38, 44, 51, 55, 56, 58], "ship": [1, 10, 14, 15, 17, 23], "can": [1, 2, 3, 4, 5, 6, 7, 8, 10, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 27, 29, 30, 31, 32, 35, 36, 37, 38, 39, 42, 43, 44, 45, 48, 49, 50, 51, 53, 55, 57, 58, 59], "easili": [1, 12, 22, 27, 48, 53, 59], "move": [1, 5, 27, 43, 44], "around": [1, 5, 6, 27, 49], "filesystem": [1, 6, 7, 13, 15, 20, 28, 44], "reloc": 1, "copi": [1, 21, 22, 35, 43, 53], "e": [1, 3, 5, 6, 7, 9, 10, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 24, 25, 27, 35, 38, 39, 44, 49, 52, 53, 58, 59], "g": [1, 3, 5, 6, 7, 9, 10, 12, 13, 14, 15, 18, 19, 20, 21, 22, 24, 25, 27, 30, 35, 38, 39, 44, 49, 52, 53, 58], "anoth": [1, 6, 12, 18, 20, 22, 24, 38, 49], "machin": [1, 5, 6, 15, 22, 27, 38, 50, 53, 58], "share": [1, 3, 12, 18, 22, 23, 28, 31, 34, 50, 53, 58], "local": [1, 3, 6, 7, 12, 13, 14, 18, 20, 21, 22, 29, 31, 38, 40, 43, 51], "get": [1, 3, 6, 7, 13, 17, 21, 22, 24, 27, 37, 38, 41, 50, 53], "second": [1, 6, 12, 58], "instanc": [1, 3, 19], "chang": [1, 6, 7, 9, 12, 13, 14, 18, 19, 20, 22, 29, 30, 35, 37, 38, 44, 49, 54, 56, 58, 59], "while": [1, 7, 8, 11, 12, 19, 22, 27, 44, 57, 58], "keep": [1, 5, 6, 9, 11, 12, 15, 22, 27, 41, 54, 55, 57], "delet": [1, 6, 12, 43], "trash": [1, 43], "without": [1, 3, 5, 6, 10, 12, 13, 15, 16, 18, 19, 20, 22, 23, 25, 27, 49, 52, 58], "need": [1, 3, 5, 6, 7, 10, 12, 13, 15, 16, 19, 21, 22, 23, 25, 27, 29, 39, 43, 44, 49, 55, 57, 58, 59], "modifi": [1, 21, 39], "icon": [1, 3, 12, 18, 19, 27, 29, 36, 42, 54, 56], "ani": [1, 6, 8, 9, 12, 13, 18, 21, 22, 24, 25, 27, 31, 49, 51, 53, 55, 56, 57, 58, 59], "side": [1, 45, 58], "effect": [1, 12, 20, 37, 38, 44, 59], "other": [1, 3, 6, 8, 9, 10, 14, 15, 19, 21, 23, 24, 25, 27, 29, 35, 43, 44, 45, 49, 53, 57, 58], "part": [1, 6, 12, 13, 18, 21, 27], "distribut": [1, 7, 24, 27, 58], "archiv": [1, 22, 52], "like": [1, 2, 3, 4, 6, 7, 9, 12, 13, 14, 15, 19, 20, 21, 22, 24, 25, 26, 27, 29, 31, 37, 38, 42, 43, 44, 45, 49, 51, 52, 58], "zip": [1, 7, 22, 52], "disk": [1, 2, 6, 7, 12, 13, 15, 21, 27, 29, 33, 35, 43, 51, 55, 58], "imag": [1, 6, 7, 10, 12, 13, 22, 36, 49, 58], "understood": 1, "switcher": [1, 25, 26, 27, 37, 39], "similar": [1, 2, 3, 18, 21, 27, 39], "simplifi": [1, 2, 3, 6, 11, 23], "gnustep": [1, 18, 23], "minim": [1, 3, 10, 12, 15, 23, 27, 45, 56], "link": [1, 3, 18], "execut": [1, 6, 7, 13, 20, 39, 43, 44, 45], "launch": [1, 10, 12, 15, 17, 24, 27, 28, 31, 32, 39, 41], "when": [1, 2, 3, 5, 6, 7, 10, 12, 13, 14, 15, 18, 19, 21, 22, 27, 30, 32, 35, 38, 43, 44, 49, 51, 55, 58, 59], "doubl": [1, 3, 12, 42, 43, 52], "resourc": [1, 12, 16, 27, 29], "png": [1, 22], "mime": [1, 12], "type": [1, 6, 12, 22, 23, 45, 49, 58, 59], "separ": [1, 5, 10, 12, 18, 19, 21], "In": [1, 3, 4, 6, 8, 11, 12, 15, 16, 18, 19, 21, 22, 24, 25, 27, 36, 38, 43, 49, 51, 57, 58, 59], "realiz": 1, "full": [1, 15, 24, 51, 55, 56, 58], "intend": [1, 6, 12, 18, 22, 25, 26, 27, 55, 57], "function": [1, 6, 12, 18, 24, 27, 35, 39, 45, 49, 58], "addit": [1, 6, 19, 27, 36, 43], "metadata": 1, "mai": [1, 2, 3, 4, 6, 7, 8, 11, 12, 13, 14, 15, 18, 21, 22, 23, 25, 27, 35, 36, 39, 49, 51, 53, 55, 57, 58, 59], "name": [1, 2, 3, 6, 7, 11, 12, 17, 18, 19, 20, 21, 23, 27, 34, 35, 44, 45, 51, 58, 59], "version": [1, 3, 4, 5, 6, 7, 13, 14, 18, 21, 22, 36, 44, 49, 58], "etc": [1, 3, 6, 12, 14, 15, 18, 20, 21, 22, 23, 58], "possibli": [1, 2, 3, 6, 12, 18, 24], "suffici": [1, 3, 58], "thi": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 27, 28, 29, 30, 31, 34, 35, 36, 37, 38, 39, 41, 43, 44, 45, 46, 48, 49, 50, 51, 53, 55, 56, 57, 58, 59], "rox": 1, "apprun": 1, "diricon": 1, "specif": [1, 2, 3, 6, 7, 12, 18, 19, 43], "amend": 1, "determin": [1, 3, 5, 6, 7, 12, 44, 49], "yet": [1, 3, 6, 19, 22, 23, 25, 32, 53, 58, 59], "These": [1, 2, 3, 12, 18, 23, 51], "bridg": [1, 8, 57], "mere": [1, 12, 20, 26], "do": [1, 4, 8, 9, 11, 12, 16, 18, 21, 22, 24, 27, 35, 38, 43, 44, 50, 51, 57, 58, 59], "contain": [1, 3, 5, 6, 10, 12, 13, 18, 22, 25, 27, 29, 39, 51, 56], "payload": 1, "tradit": [1, 22, 27], "wai": [1, 6, 7, 9, 12, 13, 17, 18, 19, 20, 22, 25, 27, 32, 35, 42, 44, 45, 49], "A": [1, 3, 7, 8, 9, 10, 12, 13, 18, 19, 20, 22, 25, 39, 45, 49, 51], "desktop2app": [1, 23], "autom": [1, 24], "creation": [1, 13], "pleas": [1, 2, 6, 8, 9, 11, 12, 15, 18, 19, 21, 22, 26, 27, 35, 38, 39, 40, 50, 55, 57, 58, 59], "note": [1, 5, 6, 7, 12, 13, 17, 18, 19, 21, 22, 27, 28, 35, 44, 46, 58], "discourag": 1, "avail": [1, 6, 10, 12, 18, 19, 23, 27, 33, 35, 38, 41, 44, 49, 56, 58], "technologi": [1, 3, 18, 23, 27], "backward": 1, "compat": [1, 3, 13, 15, 23, 50, 58], "exist": [1, 3, 4, 7, 12, 14, 18, 20, 22, 23, 32, 35, 43, 44, 49, 51, 56], "here": [1, 4, 6, 9, 12, 13, 18, 20, 21, 22, 27, 51, 58], "real": [1, 3, 4, 6, 7, 15, 20, 21, 27, 56, 58], "world": [1, 3, 6, 16], "exampl": [1, 2, 5, 6, 7, 11, 14, 17, 18, 22, 23, 24, 30, 43, 45, 48, 51, 52, 59], "how": [1, 4, 6, 12, 18, 19, 21, 22, 25, 27, 33, 36, 44, 48, 58], "written": [1, 2, 3, 5, 10, 13, 15, 17, 18, 23, 24, 27, 29, 49, 58], "c": [1, 4, 6, 9, 10, 12, 13, 15, 18, 19, 21, 22], "github": [1, 2, 4, 6, 7, 9, 10, 15, 17, 18, 21, 22, 26, 27, 30, 31, 57, 59], "cirru": 1, "ci": [1, 7], "qhexedit": 1, "The": [1, 3, 5, 6, 7, 8, 10, 13, 15, 18, 19, 20, 21, 22, 23, 24, 25, 27, 30, 32, 34, 35, 36, 37, 38, 40, 42, 44, 45, 47, 48, 49, 50, 51, 52, 53, 54, 56, 58, 59], "compil": [1, 2, 5, 10, 15, 16, 19, 21, 27, 43], "upload": [1, 21, 50], "fulli": [1, 12], "result": [1, 6, 7, 12, 13, 15, 21, 27, 37, 45, 58], "download": [1, 2, 3, 4, 6, 7, 9, 10, 15, 22, 27, 29, 46], "releas": [1, 4, 5, 7, 9, 10, 27, 55, 58], "see": [1, 2, 8, 9, 12, 13, 17, 18, 19, 20, 21, 22, 27, 31, 33, 35, 38, 41, 45, 51, 53, 57, 58, 59], "yml": [1, 21], "If": [1, 3, 6, 7, 8, 9, 12, 13, 14, 15, 18, 19, 20, 21, 22, 23, 24, 25, 27, 31, 35, 36, 37, 38, 44, 49, 51, 57, 58, 59], "suppos": [1, 3, 4, 7, 12, 18, 21], "one": [1, 3, 4, 5, 6, 7, 9, 11, 12, 15, 18, 19, 21, 22, 23, 24, 27, 40, 43, 44, 45, 49, 58, 59], "must": [1, 3, 7, 9, 12, 13, 18, 20, 21, 25, 51], "so": [1, 3, 6, 7, 8, 9, 12, 13, 14, 17, 18, 19, 20, 21, 22, 23, 27, 29, 43, 57], "rel": [1, 27], "usr": [1, 2, 4, 6, 7, 13, 14, 15, 17, 18, 20, 21, 22, 31, 58], "lib": [1, 13, 18, 19, 21, 22, 59], "sed": [1, 6, 15, 20, 22], "": [1, 3, 5, 6, 12, 13, 15, 17, 18, 20, 21, 22, 27, 36, 42, 44, 50, 51], "bin": [1, 2, 6, 7, 15, 17, 18, 20, 21, 22], "ln": [1, 6, 19, 22, 42], "rm": [1, 4, 6, 13, 21, 22], "work": [1, 5, 6, 11, 12, 13, 14, 15, 16, 18, 19, 22, 23, 25, 27, 35, 39, 43, 44, 58, 59], "becaus": [1, 12, 13, 18, 21, 22, 25, 27, 29, 44, 55], "coincid": 1, "string": [1, 6, 12, 18, 53], "ha": [1, 4, 6, 8, 12, 14, 15, 17, 18, 19, 20, 21, 22, 24, 25, 27, 34, 35, 37, 39, 44, 49, 51, 53, 55, 57, 58, 59], "exact": [1, 13, 22, 55], "length": 1, "wa": [1, 6, 12, 13, 14, 18, 19, 22, 25, 27], "case": [1, 3, 5, 6, 8, 14, 16, 20, 21, 22, 40, 43, 50, 55, 57, 58], "would": [1, 3, 4, 6, 9, 11, 12, 13, 14, 18, 19, 20, 21, 22, 23, 26, 27, 31, 37, 43, 45, 49, 51, 57, 58], "either": [1, 7, 12, 22, 32, 58], "specifi": [1, 3, 6, 12, 23, 44], "rpath": 1, "patchelf": 1, "For": [1, 2, 6, 7, 11, 17, 18, 19, 21, 22, 23, 27, 35, 39, 43, 52, 58, 59], "relocat": 1, "take": [1, 7, 12, 13, 22, 25, 38, 39, 49, 51, 58, 59], "care": [1, 12, 25, 31], "data": [1, 4, 12, 13, 19, 22, 35, 46, 58], "those": [1, 3, 5, 6, 7, 9, 12, 18, 22, 27, 31, 32, 33, 49, 58], "appnam": 1, "void": [1, 21], "qstringlist": 1, "qstandardpath": 1, "standardloc": 1, "appdataloc": 1, "accord": [1, 18], "resolv": [1, 59], "clearli": [1, 11], "where": [1, 3, 9, 12, 13, 14, 18, 35], "locat": [1, 7, 10, 12, 13, 16, 27, 29, 35, 43, 44, 51], "instead": [1, 3, 5, 6, 12, 14, 20, 22, 25, 27, 43, 58], "qstring": [1, 21], "qcoreappl": 1, "applicationdirpath": 1, "construct": [1, 6, 27, 47], "kaidanim": 1, "kaidan": 1, "commit": [1, 7, 58], "da38011b55a1aa5d17764647ecd699deb4be437f": 1, "directori": [1, 6, 7, 12, 14, 16, 19, 21, 22, 27, 29, 32, 43, 44], "have": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 20, 21, 22, 23, 24, 25, 27, 30, 32, 35, 38, 39, 44, 49, 51, 52, 55, 57, 58], "been": [1, 6, 10, 12, 14, 15, 19, 20, 22, 24, 25, 30, 35, 38, 39, 49, 53, 58, 59], "orient": 1, "includ": [1, 2, 6, 7, 10, 11, 12, 13, 15, 21, 27, 39, 49, 50, 51, 57], "risc": 1, "o": [1, 2, 4, 6, 10, 12, 13, 16, 17, 18, 19, 22, 27, 38, 43], "nextstep": 1, "openstep": 1, "x": [1, 5, 6, 12, 13, 14, 18, 20, 22, 27, 38], "variou": [1, 3, 6, 11, 16, 18, 27, 38], "classic": [1, 15, 27], "macintosh": [1, 21, 27, 33, 37, 58], "singl": [1, 18, 21, 23], "kept": [1, 27], "fork": [1, 7, 18], "en": [1, 6, 16, 21], "wikipedia": [1, 30], "wiki": [1, 5, 6, 11, 15, 18, 22, 23, 57, 58], "application_directori": 1, "sourceforg": 1, "net": [1, 18, 58], "html": [1, 12, 18, 22, 30], "resource_fork": 1, "especi": [2, 7, 11, 21, 22, 29, 58], "prefer": [2, 9, 10, 12, 18, 22, 27, 28, 35, 36, 37, 38, 39, 40, 45, 51, 54, 55, 58], "simpl": [2, 3, 6, 9, 18, 19, 22, 27, 47, 48], "easi": [2, 7, 22, 27, 32, 49], "hack": 2, "claus": 2, "bsd": [2, 3, 21, 50, 58, 59], "licens": [2, 3, 11, 21, 51], "default": [2, 6, 10, 12, 13, 14, 15, 18, 22, 23, 25, 27, 30, 34, 35, 36, 37, 43, 51, 58], "also": [2, 3, 6, 7, 8, 9, 10, 12, 13, 15, 17, 18, 21, 22, 24, 25, 27, 29, 35, 37, 39, 42, 43, 44, 45, 53], "accept": [2, 3, 12, 21, 58], "ideal": [2, 3, 30], "bundl": [2, 3, 23, 27, 29, 32, 43, 44, 55], "extern": [2, 3, 49, 51, 55], "apart": 2, "what": [2, 5, 9, 12, 18, 19, 22, 24, 25, 44, 57, 59], "some": [2, 3, 4, 6, 9, 12, 13, 18, 19, 21, 22, 23, 27, 29, 39, 49, 59], "python": [2, 10, 48], "design": [2, 3, 11, 13, 15, 18, 20, 22, 23, 25, 26, 27, 44], "invit": [2, 27, 48], "power": [2, 10, 22, 27, 59], "look": [2, 6, 9, 12, 13, 15, 21, 22, 27, 29, 43, 44, 48, 58], "start": [2, 3, 10, 12, 14, 15, 17, 18, 19, 20, 27, 31, 32, 33, 35, 38, 42, 45, 49, 51, 59], "experi": [2, 3, 15, 18, 20, 22, 23, 27, 56], "eventu": [2, 3, 12, 22, 27], "contribut": [2, 11, 18, 19, 27], "conjunct": 2, "format": [2, 6, 20, 21, 23, 58], "an": [2, 3, 4, 5, 6, 7, 9, 10, 11, 13, 15, 18, 19, 20, 21, 23, 25, 27, 29, 31, 32, 36, 37, 38, 39, 42, 43, 44, 45, 48, 49, 51, 55, 58, 59], "id": [2, 4, 6, 10, 12, 14, 53, 58], "autocomplet": 2, "veri": [2, 3, 12, 13, 20, 21, 22, 49], "access": [2, 18, 19, 22, 23, 27, 34, 41, 51, 52, 53, 58], "environ": [2, 3, 6, 10, 11, 12, 17, 21, 22, 27, 28, 34, 44, 55], "low": [2, 11, 22], "barrier": 2, "entri": [2, 6, 12, 24, 45], "No": [2, 19, 21, 22], "just": [2, 3, 4, 6, 12, 21, 22, 23, 25, 44, 58], "awai": [2, 36, 58], "tini": 2, "log": [2, 6, 14, 15, 21, 22, 32, 33, 38, 45, 51, 59], "calendar": [2, 28, 46], "anyon": [2, 51], "abl": [2, 3, 5, 12, 38, 51, 53, 58], "understand": [2, 3, 22, 25, 27], "learnpyqt": 2, "15": [2, 12, 22], "minut": [2, 6, 51], "we": [2, 3, 6, 8, 11, 12, 13, 18, 21, 22, 25, 27, 57, 58, 59], "mean": [2, 3, 6, 9, 12, 13, 15, 19, 22, 27, 51, 59], "introduct": 2, "gui": 2, "qt5": [2, 22], "you": [2, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 18, 19, 20, 21, 22, 24, 25, 26, 27, 29, 30, 31, 32, 35, 36, 37, 38, 39, 40, 42, 43, 44, 45, 49, 50, 51, 52, 53, 54, 55, 57, 58, 59], "interest": [2, 11, 18, 22, 59], "book": [2, 21, 25], "martin": 2, "fitzpatrick": 2, "There": [2, 6, 9, 12, 18, 20, 22, 24, 44, 55], "forum": [2, 8, 19, 27, 59], "creator": [2, 10, 12, 26], "edit": [2, 6, 7, 15, 21, 27, 29, 30, 34], "interfac": [2, 5, 7, 10, 12, 18, 19, 21, 44], "env": [2, 22], "python3": [2, 18], "encod": [2, 12, 23], "utf": [2, 12, 23], "8": [2, 6, 12, 13, 22, 23, 35, 42, 45, 51, 58], "import": [2, 5, 13, 16, 18, 25, 27, 55], "sy": [2, 6, 15], "pyqt5": [2, 29, 30], "qtwidget": [2, 10, 16], "qapplic": 2, "qwidget": 2, "qtcore": [2, 16], "qfile": 2, "uic": 2, "loadui": 2, "class": [2, 12, 16, 22], "widget": [2, 16, 18, 48], "def": [2, 16], "__init__": [2, 16], "self": [2, 16, 27], "super": [2, 3], "load_ui": 2, "path": [2, 3, 6, 13, 16, 21, 41, 44, 58], "join": [2, 8, 27, 57], "dirnam": [2, 16, 20], "__file__": [2, 16], "ui_fil": 2, "readonli": [2, 13], "close": [2, 3, 12, 13, 43, 56], "__name__": 2, "__main__": 2, "exit": [2, 6, 14, 17, 19, 22], "exec_": 2, "simplic": [3, 26, 27, 57], "mind": [3, 9, 15, 22, 27, 57], "less": [3, 9, 12, 15, 22, 26], "better": [3, 9, 12, 22, 26, 27], "page": [3, 5, 6, 9, 12, 19, 21, 22, 23, 27, 29, 59], "describ": [3, 4, 5, 6, 12, 18, 19, 21, 22, 25, 28, 34, 41, 46, 58], "kei": [3, 6, 12, 18, 20, 27, 28, 34, 35, 42, 43, 45, 58, 59], "element": [3, 8, 12, 57], "To": [3, 6, 7, 10, 12, 14, 15, 16, 17, 18, 19, 21, 22, 23, 27, 29, 33, 35, 42, 43, 45, 51, 53, 56, 58], "begin": [3, 12, 15, 18, 59], "everyth": [3, 6, 9, 14, 21], "welcom": [3, 5, 6, 9, 12, 21, 23, 25, 26, 39], "10x": 3, "pyqt": 3, "qml": [3, 10, 18], "kf5": [3, 22], "absolut": [3, 12], "els": [3, 6, 12, 15], "gtk": [3, 27], "rational": 3, "most": [3, 6, 12, 16, 19, 20, 22, 29, 36, 42, 44, 51, 57, 58], "cross": 3, "product": [3, 25, 27], "platform": [3, 15, 18, 27, 58], "often": 3, "henc": [3, 6, 7, 19, 22, 25, 44], "best": [3, 5, 15, 16, 58], "choos": [3, 12, 27, 35, 36, 45], "now": [3, 4, 6, 18, 21, 22, 38, 58], "philosoph": 3, "someth": [3, 9, 12, 18, 20, 21, 25, 44, 55, 59], "fynedesk": 3, "its": [3, 6, 12, 13, 14, 18, 20, 22, 23, 27, 35, 42, 49, 51, 52, 54, 56], "current": [3, 6, 12, 13, 18, 20, 22, 27, 35, 43, 45, 51, 55, 58, 59], "state": [3, 6, 12, 13, 25, 53, 55], "cannot": [3, 6, 7, 13, 14, 18, 19, 21, 22, 27, 33, 35, 44, 49, 51, 59], "truli": [3, 27], "mayb": [3, 9, 12, 22], "think": [3, 27], "carbon": 3, "wherea": 3, "becom": [3, 6, 12, 15, 18, 23, 35], "cocoa": 3, "minimum": [3, 27, 58], "number": [3, 9, 12, 18, 23, 50], "viabl": 3, "produc": [3, 7, 18, 21], "effici": [3, 12, 13, 25, 27], "each": [3, 5, 7, 9, 12, 20, 21, 23, 27, 28, 32, 34, 41, 46], "few": [3, 4, 8, 21, 45, 49, 57], "besid": [3, 6, 25], "ones": [3, 9, 12, 22], "central": [3, 18, 22], "outsid": [3, 6, 13, 20], "ti": 3, "avoid": [3, 9, 12, 27], "overli": 3, "complex": [3, 9, 11, 19, 25], "insuffici": 3, "legaci": 3, "reason": [3, 6, 12, 15, 22, 23, 27, 58, 59], "handl": [3, 6, 12, 18, 23, 44], "appdir": [3, 32, 44], "displai": [3, 6, 12, 18, 22, 27, 38, 45, 58], "wide": [3, 12, 18, 32, 39, 43, 59], "about": [3, 5, 6, 12, 19, 21, 22, 25, 26, 27, 31, 45, 46, 50, 58, 59], "comput": [3, 6, 7, 14, 18, 19, 22, 25, 27, 32, 34, 35, 36, 39, 41, 49, 50, 51, 53, 54, 55, 58, 59], "activ": [3, 10, 18, 20, 35, 38, 51, 59], "It": [3, 5, 6, 11, 12, 13, 18, 19, 21, 22, 25, 26, 27, 31, 35, 37, 40, 42, 43, 44, 49, 51, 58, 59], "box": [3, 19, 25, 29, 38, 53], "run": [3, 5, 6, 8, 10, 11, 12, 13, 14, 16, 18, 19, 21, 22, 23, 24, 27, 35, 37, 41, 43, 49, 51, 52, 53, 55, 58, 59], "pin": [3, 42], "futur": [3, 6, 12, 13, 22, 23, 24, 36, 51], "anim": 3, "indic": [3, 18], "being": [3, 6, 7, 11, 13, 15, 18, 23, 27, 49, 58], "them": [3, 5, 6, 7, 9, 10, 12, 18, 21, 22, 25, 27, 32, 35, 43, 50, 52], "expect": [3, 4, 5, 6, 8, 19, 21, 25, 37, 57, 58], "given": [3, 12], "find": [3, 6, 7, 12, 13, 18, 21, 22, 27, 29, 50], "highest": [3, 25], "last": [3, 12, 51, 58], "onto": [3, 21, 58], "gain": 3, "knowledg": [3, 9, 22], "shell": [3, 6, 12, 18], "script": [3, 13, 15, 20, 22, 59], "hardcod": [3, 6, 22], "appropri": [3, 6, 16, 51], "shall": 3, "give": [3, 11, 12, 18, 20, 22, 23, 27, 46, 58], "clear": [3, 6, 19, 22], "text": [3, 6, 15, 16, 20, 23, 27, 34, 53], "error": [3, 6, 12, 13, 17, 21, 22, 44, 51, 59], "messag": [3, 6, 12, 19, 20, 44, 59], "offer": [3, 19, 23, 27, 43, 53], "solut": [3, 22], "fall": 3, "back": [3, 6, 8, 9, 13, 22, 45, 55, 57, 58], "consol": [3, 6, 20], "output": [3, 6, 12, 14, 19], "could": [3, 7, 12, 13, 19, 22, 23], "notifi": [3, 18], "via": [3, 8, 14, 18, 43, 50, 57], "much": [3, 13, 22, 27], "simpler": [3, 21, 27], "convolut": 3, "d": [3, 6, 8, 9, 12, 13, 14, 15, 16, 19, 20, 21, 23, 30], "bu": [3, 23], "until": [3, 6], "introduc": 3, "talk": [3, 19], "lightweight": [3, 27], "standard": [3, 6, 12, 15, 17, 23], "publish": [3, 13, 18, 23, 25, 50], "subscrib": 3, "identifi": [3, 6, 14, 50, 51], "mqtt": 3, "benefit": 3, "allow": [3, 5, 6, 12, 13, 18, 19, 20, 21, 23, 27, 31, 35, 36, 37, 38, 49, 51, 53, 54, 55, 58, 59], "commun": [3, 7, 15, 18, 23, 27, 53], "meantim": 3, "even": [3, 4, 12, 22, 25, 27, 42, 44, 58], "though": [3, 12, 18, 19, 22, 27], "obscur": 3, "red": [3, 56], "hat": 3, "simpli": [3, 6, 7, 22, 37, 43], "attach": [3, 12, 22, 33, 37, 51, 55, 58], "drive": [3, 21, 27, 50, 58], "connect": [3, 7, 10, 23, 24, 27, 38, 40, 49, 51, 53], "co": 3, "respons": [3, 8, 12, 57], "did": [3, 22], "explicitli": [3, 12], "custom": [3, 6, 12, 21, 25, 27, 30, 36, 55], "pre": [3, 49, 51, 55, 58], "commonli": [3, 42], "termin": [3, 6, 12, 18, 19, 23, 24, 39], "regular": [3, 6, 12], "insid": [3, 12, 13, 18, 20, 39], "subdirectori": [3, 12], "panel": [3, 27], "languag": [3, 6, 10, 16, 17, 22, 27, 29, 37, 58], "openzf": [3, 33], "boot": [3, 7, 14, 27, 28, 33, 34, 55, 58], "scratch": [3, 55], "re": [3, 18, 20, 21, 59], "situat": [4, 6, 12, 21, 22], "necessari": [4, 21, 22], "softwar": [4, 5, 18, 21, 22, 25, 39, 49, 51, 55], "section": [4, 5, 6, 8, 9, 12, 14, 21, 22, 27, 28, 34, 36, 41, 44, 46], "small": [4, 9, 12, 13, 21, 51], "life": [4, 21], "bug": [4, 17, 21, 27, 30], "bugzilla": [4, 18, 30], "show_bug": [4, 18], "cgi": [4, 6, 18], "251025": 4, "src": [4, 6], "blob": [4, 6, 21], "sbin": [4, 6, 20], "efivar": 4, "unfortun": [4, 6, 14, 19, 58], "whole": [4, 22, 39], "want": [4, 5, 9, 11, 12, 13, 14, 15, 18, 22, 25, 45, 51, 55, 58], "ftp": 4, "pub": 4, "amd64": [4, 5, 58], "whatev": [4, 22], "txz": 4, "Then": [4, 6, 18, 24, 35, 38, 45, 58, 59], "cd": [4, 6, 7, 15, 16, 21, 22, 58], "tar": [4, 21, 22, 52], "xf": [4, 22, 33], "ensur": [4, 12, 21, 27], "obj": 4, "review": [4, 5, 21], "d29620": 4, "wget": [4, 7, 22], "yytb47lr5cxaijaaupeh": 4, "phid": 4, "gihl33z7feu4dagjxjgz": 4, "sbin_efivar_efivar": 4, "concept": [5, 25, 27], "engin": [5, 18, 22, 25], "target": [5, 6, 12, 27, 49, 51], "forc": [5, 12], "upgrad": [5, 35], "entir": [5, 6, 7, 12, 49, 51], "freebsd": [5, 6, 7, 11, 13, 18, 19, 22, 23, 24, 26, 27, 30, 35, 38, 43, 51, 55, 58], "point": [5, 6, 12, 14, 18, 21, 27, 58], "lot": 5, "downstream": 5, "10": [5, 6, 22, 25, 27], "year": [5, 25], "stack": [5, 6, 24], "top": [5, 18, 25, 27, 45], "worri": [5, 22], "break": [5, 12], "draft": [5, 12], "experienc": [5, 6, 21, 27], "request": [5, 6, 9, 18], "abi": [5, 18], "defin": [5, 6, 12, 14, 16, 18, 19, 21, 39], "factor": [5, 22, 25], "quarterli": [5, 18, 33], "major": [5, 35], "subsequ": [5, 6, 22], "minor": 5, "older": [5, 14], "0": [5, 6, 10, 12, 13, 14, 18, 19, 20, 21, 22, 25, 35, 38, 42, 45, 52, 55, 58], "librari": [5, 6, 17, 21, 59], "3": [5, 18, 20, 21, 22, 39, 52], "14": [5, 22], "But": [5, 11, 12], "happen": [5, 6, 12, 14, 16, 22], "try": [5, 11, 14, 21, 22, 27, 49, 59], "pkg": [5, 7, 18, 19, 21, 22, 24, 55], "static": [5, 12], "add": [5, 6, 7, 13, 14, 15, 21, 22, 25, 30, 39, 54, 58], "built": [5, 7, 12, 18, 21, 58], "13": [5, 6, 7, 22], "wrong": [5, 6, 14, 44, 55, 59], "architectur": [5, 18, 19, 22], "appar": [5, 6, 12, 18], "assumpt": [5, 12], "export": [5, 6, 18, 21, 22], "seem": [5, 6, 15, 22], "issu": [5, 6, 9, 12, 18, 21, 27, 39, 50, 55, 57], "still": [5, 6, 7, 12, 18, 20, 25, 27, 39], "release_0": 5, "release_1": 5, "release_2": 5, "NOT": [5, 22, 50], "latest": [5, 12, 13, 14, 27, 58], "vanish": 5, "over": [5, 6, 16, 18, 19, 22, 23, 25, 27, 38, 43, 51, 58], "kbi": 5, "extens": [5, 6, 12, 31], "normal": [5, 6, 12, 20, 22, 59], "howev": [5, 6, 7, 15, 17, 19, 22], "notabl": [5, 39], "except": [5, 49], "i915km": 5, "explan": 5, "whether": [5, 12, 14, 18, 19, 22, 43, 51], "minr": 5, "binarycompat": 5, "practic": [5, 16], "maintain": [5, 21, 23], "centric": 6, "bring": [6, 11, 22, 27], "soon": [6, 35], "delai": 6, "servic": [6, 12, 15, 18, 19, 22, 23, 43, 50, 59], "beyond": [6, 22], "after": [6, 8, 10, 12, 13, 14, 15, 19, 20, 22, 38, 57, 58, 59], "set": [6, 10, 12, 13, 14, 15, 16, 18, 19, 20, 21, 25, 27, 34, 35, 38, 47, 51, 55, 58], "ntp": 6, "rc": [6, 14, 15, 20, 22], "might": [6, 12, 18, 22, 23, 24, 51, 55, 58, 59], "overwritten": [6, 21], "never": [6, 12], "startup": [6, 12, 37, 59], "disabl": [6, 27, 34, 51], "question": [6, 8, 11, 18, 19, 22, 27, 50, 57], "thei": [6, 11, 12, 18, 20, 25, 27, 29, 33, 38, 53], "don": [6, 9, 22, 25, 27, 31, 58], "t": [6, 9, 12, 13, 15, 16, 17, 19, 22, 25, 27, 31, 38, 39, 58, 59], "sequenc": [6, 19], "later": [6, 22, 27, 58], "session": [6, 12, 15, 18, 32, 45], "instruct": [6, 22, 27, 49, 51, 55, 58], "danger": [6, 22], "potenti": [6, 58], "lead": [6, 12, 13, 22, 27], "go": [6, 7, 9, 10, 21, 22, 36, 39, 43, 49, 55], "who": [6, 25, 27, 38, 44], "know": [6, 12, 19, 22, 44], "roll": [6, 9, 55], "conf": [6, 14, 18, 21, 22], "defaultroute_carrier_delai": 6, "defaultroute_delai": 6, "background_dhcli": 6, "ye": [6, 12, 18, 20, 21, 22, 55, 58], "late": [6, 18, 20], "sh": [6, 7, 15, 22], "slim": [6, 22, 55, 59], "subr": 6, "start_cmd": 6, "_start": 6, "extra_command": 6, "disable_early_servic": 6, "disable_early_services_cmd": 6, "_disable_early_servic": 6, "devd": [6, 22], "stai": [6, 8, 12, 27, 57], "enabl": [6, 12, 15, 18, 19, 34, 51, 58], "mous": [6, 22, 42, 53, 56, 58], "pointer": [6, 9, 58], "xorg": [6, 14, 20, 22, 23, 59], "webcamd": 6, "vboxservic": 6, "dsbdriverd": 6, "netif": 6, "rout": [6, 18], "defaultrout": 6, "avahi": 6, "daemon": [6, 22], "tmp": [6, 20], "cupsd": 6, "ntpdate": 6, "smartd": 6, "sshd": 6, "late_start": 6, "restart": [6, 12, 19, 22, 35, 38, 45, 49, 51, 55, 58, 59], "invok": [6, 18, 22, 32, 39, 44], "dhcpd": 6, "onestart": [6, 15], "done": [6, 11, 13, 15, 20, 21, 22, 43], "late_disable_early_servic": 6, "load_rc_config": 6, "run_rc_command": 6, "sudo": [6, 7, 12, 14, 15, 18, 19, 21, 24, 42, 55, 58, 59], "chmod": [6, 20, 22], "check": [6, 12, 14, 21, 35, 38, 50, 51, 55, 57], "greatli": [6, 11], "reduc": [6, 9, 10, 16, 22], "grep": [6, 14, 15, 21, 24, 59], "r": [6, 12, 13, 22], "clear_tmp_en": 6, "dbus_en": [6, 22], "initgfx_en": [6, 14], "load_acpi_en": 6, "slim_en": 6, "zfs_enabl": 6, "reboot": [6, 22, 58], "usabl": [6, 22, 26, 27, 59], "appear": [6, 7, 12, 13, 18, 19, 21, 56], "faster": [6, 22], "grei": [6, 35], "press": [6, 12, 19, 20, 35, 39, 43, 45, 58, 59], "stage": [6, 21], "prompt": [6, 14, 20], "At": [6, 13, 20, 21, 58], "writabl": [6, 12, 13, 20], "enter": [6, 12, 14, 18, 20, 35, 38, 43, 44, 45, 51, 58], "contin": 6, "partli": 6, "init_script": 6, "scrlk": 6, "your": [6, 7, 9, 11, 12, 14, 16, 19, 21, 25, 27, 29, 30, 32, 35, 36, 37, 38, 39, 40, 41, 43, 49, 50, 51, 52, 53, 54, 55, 58, 59], "keyboard": [6, 19, 22, 27, 28, 30, 34, 35, 39, 41, 53, 58], "arrow": 6, "down": [6, 25, 41, 49, 58], "again": [6, 12, 21, 22, 56], "hit": 6, "mv": [6, 13, 20, 22], "sf": [6, 19], "xterm": [6, 20, 22, 59], "abov": [6, 7, 12, 15, 19, 22, 58, 59], "watch": [6, 24], "goe": [6, 14, 22, 44], "anyth": [6, 19, 22, 53], "replac": [6, 7, 12, 21, 22, 23, 38, 55], "load": [6, 12, 13, 14, 22, 24, 59], "monkei": 6, "6": [6, 18, 22], "7": [6, 10, 18, 20, 21, 22, 27, 55, 58], "complet": [6, 18, 19, 27, 39, 51, 55], "differ": [6, 12, 13, 14, 15, 18, 22, 39, 58, 59], "accordingli": [6, 19], "compress": [6, 13], "uzip": [6, 7, 13, 22], "dure": [6, 7, 20, 21, 27, 37, 51], "mount": [6, 13, 21, 33, 34, 52], "turn": [6, 21], "achiev": [6, 12, 13, 16, 57], "project": [6, 7, 11, 13, 16, 18, 27, 53, 58], "descript": [6, 12, 17, 18, 21, 24], "aspect": [6, 20, 25, 27, 36, 51], "overlai": [6, 7], "loader": 6, "smart": 6, "enough": [6, 13, 15, 22], "manual": [6, 18, 19, 27], "well": [6, 12, 14, 22, 27, 43, 44, 55], "zf": [6, 22, 35], "ko": [6, 13, 14], "opensolari": 6, "onward": 6, "cryptodev": 6, "ramdisk": [6, 7, 13], "uf": [6, 13, 22], "under": [6, 13, 18, 19, 20, 21, 27, 29, 35, 36, 38, 50], "mfsroot_nam": 6, "content": [6, 7, 12, 13, 14, 21, 27, 29, 49, 51], "init": [6, 20], "w": [6, 12, 13, 30], "tree": [6, 12, 18, 43], "replic": 6, "swap": [6, 13, 15, 37, 39, 51], "memdisk": 6, "livecd": 6, "helper": 6, "chroot": [6, 13], "deal": [6, 12, 21], "detect": [6, 14, 22, 27, 40, 58], "pci": [6, 14], "virtual": [6, 27], "relat": [6, 9, 15, 18, 27, 50], "tell": [6, 8, 20, 22, 57], "reroot": 6, "particular": [6, 9, 12], "tri": [6, 31, 51], "proxi": 6, "offici": [6, 18, 22, 27, 37], "raspberri": [6, 27, 37, 58], "pi": [6, 27, 37, 58], "appl": [6, 25, 37, 58], "store": [6, 7, 14, 18, 31, 35, 43, 58], "prev": [6, 37, 58], "lang": [6, 21, 37, 58], "kbd": [6, 37, 58], "efi": [6, 14, 37, 58], "variabl": [6, 12, 13, 14, 22, 44, 58], "login": [6, 12, 34], "inform": [6, 12, 17, 18, 21, 23, 25, 27, 34, 41, 50, 51, 58, 59], "earlier": [6, 14, 18], "step": [6, 7, 21, 22, 27, 51, 55, 58], "hang": 6, "damag": [6, 22], "wait": [6, 13, 19], "next": [6, 21, 24, 51, 59], "tmpf": 6, "dev": [6, 7, 13, 14, 20, 22, 58], "unknown": [6, 22], "miss": 6, "ctrl": [6, 12, 19, 37, 39, 58, 59], "moment": [6, 22], "By": [6, 14, 24, 50, 51], "pgup": 6, "pgdn": 6, "print": [6, 22, 25, 27], "relev": [6, 12, 22, 59], "recenc": 6, "cpu": [6, 22, 24, 58], "usag": [6, 20, 27], "decid": [6, 12, 25], "proc_compar": 6, "averag": [6, 25], "cmd": [6, 37], "pid": [6, 24], "explain": [6, 9, 25], "waitchannel": 6, "u": [6, 12, 13, 18, 19, 22, 25, 39, 57, 58, 59], "wall": 6, "clock": 6, "finish": 6, "call": [6, 7, 11, 12, 18, 20, 51, 52, 56], "elaps": 6, "slice": 6, "spend": 6, "block": [6, 21, 31], "amount": [6, 9, 59], "spent": [6, 12], "within": [6, 9, 10, 15, 23, 27, 31], "actual": [6, 12, 14, 18, 22, 27, 29, 43, 44, 47, 59], "count": [6, 12, 13, 21, 22, 24, 58], "toward": 6, "figur": 6, "oppos": 6, "space": [6, 7, 12, 13, 21, 27, 39, 45, 51, 58], "percent": 6, "resid": [6, 13, 58], "size": [6, 10, 56], "rss": 6, "memori": [6, 7, 12, 13, 58], "occupi": 6, "ram": [6, 7, 13, 15, 27, 58, 59], "62": [6, 58], "sleep": [6, 15, 20, 58], "1739": 6, "nanslp": 6, "97r": 6, "00u": 6, "00": [6, 14], "2168k": 6, "observ": [6, 24], "inspect": [6, 35], "command": [6, 7, 12, 13, 15, 17, 18, 19, 20, 22, 23, 24, 27, 32, 34, 35, 39, 41, 45, 58], "otherwis": [6, 14, 22, 44, 55], "sinc": [6, 8, 13, 16, 18, 20, 21, 22, 25, 35, 57, 58], "v": [6, 13, 22], "befor": [6, 12, 13, 20, 21, 22, 29, 35, 55, 58], "backspac": 6, "ok": 6, "altern": [6, 13, 15, 18, 25, 56, 57], "short": 6, "sai": [6, 12, 18, 21, 57], "immedi": [6, 8, 13, 22, 27, 37, 57], "esc": [6, 12, 20, 39, 58], "unset": [6, 18, 20], "boot_mut": [6, 20], "splash": 6, "advanc": [6, 19, 22, 34, 35, 43, 58], "administr": [6, 35, 51], "rescu": 6, "drop": [6, 27, 58], "below": [6, 42, 58], "line": [6, 7, 12, 15, 17, 19, 21, 22, 23, 24, 25, 35, 58], "variant": [6, 18], "thereof": 6, "unabl": 6, "onc": [6, 8, 9, 12, 13, 21, 33, 38, 49, 51, 53, 55, 58], "autologin": 6, "occur": 6, "fail": [6, 13, 19, 21], "refer": [6, 18, 21, 22, 25, 26, 27, 35, 39, 58], "more": [6, 9, 12, 13, 17, 18, 19, 22, 23, 24, 25, 26, 27, 31, 34, 40, 51, 55, 58], "caus": [6, 9, 22], "tend": 6, "manipul": 6, "vidcontrol": 6, "conscontrol": 6, "disappear": 6, "broad": 6, "audienc": [6, 27], "non": [6, 12, 14, 19, 21, 27, 39, 58], "technic": [6, 18, 22, 27], "behavior": [6, 12, 36], "textual": 6, "upon": [6, 22, 31, 38], "techniqu": 6, "adjust": [6, 36], "userland": [6, 13, 55], "ttyv0": 6, "redirect": 6, "null": [6, 19], "shutdown": 6, "dummi": 6, "noth": [6, 18, 21, 27], "prevent": [6, 12, 18, 50], "resolut": [6, 22, 27, 58], "tty": 6, "empti": [6, 12, 18, 27], "spawn": 6, "comment": [6, 9, 21, 22], "syslog": 6, "visual": [6, 12, 18, 27], "interrupt": [6, 20], "On": [6, 13, 18, 22, 24, 27, 44, 49, 58], "silenc": 6, "NO": [6, 14], "lua": [6, 13], "virtualbox": [6, 15, 27, 58], "hard": [6, 7, 15, 18, 22, 29, 50, 51, 55, 58], "beastie_dis": 6, "increas": [6, 11, 25, 31], "timeout": 6, "interpret": 6, "lua54": 6, "core": [6, 7, 15, 26, 51, 58], "447": 6, "attempt": 6, "index": [6, 18, 50], "nil": 6, "valu": [6, 12, 17, 18, 22], "traceback": 6, "issystem386": 6, "56": 6, "recorddefault": 6, "525": 6, "chunk": 6, "cli": 6, "31": 6, "36": 6, "4th": [6, 13], "unus": 6, "mislead": 6, "remov": [6, 7, 12, 16, 18, 21, 22, 27, 31, 34, 39, 41, 49, 50, 51, 58], "uw": [6, 18], "exec": [6, 12], "easier": 6, "essenti": [6, 12, 15], "One": [6, 17, 24], "quickli": [6, 9, 17, 22, 27], "repeat": [6, 12, 21, 51], "place": [6, 8, 12, 13, 14, 25, 29, 31, 32, 56], "ismenuskip": 6, "return": [6, 16, 17, 22], "lower": 6, "getenv": 6, "config": [6, 14, 19, 22], "loadelf": 6, "directli": [6, 19, 27, 44], "try_includ": 6, "suggest": [6, 12, 16, 51], "hook": 6, "our": [6, 25, 57, 59], "own": [6, 7, 11, 14, 18, 27, 30], "experiment": [6, 9, 22, 27, 49, 58], "man": [6, 30], "queri": 6, "sektion": 6, "color": [6, 36], "undocu": [6, 18], "perform": [6, 7, 13, 18, 20, 25, 27, 35, 41, 43, 49, 51, 58], "command_error": 6, "pars": [6, 12], "getchar": 6, "ischar": 6, "setenv": [6, 21, 22], "unsetenv": 6, "printc": 6, "openfil": 6, "closefil": 6, "readfil": 6, "writefil": 6, "term_putimag": 6, "fb_putimag": 6, "fb_setpixel": 6, "fb_line": 6, "fb_bezier": 6, "fb_drawrect": 6, "term_drawrect": 6, "gener": [6, 7, 9, 10, 14, 18, 19, 25, 58], "lua_": 6, "stand": 6, "liblua": 6, "cut": [6, 12, 21, 22], "f": [6, 12, 13, 20, 21, 24, 58], "l": [6, 13, 15, 16, 21, 30, 38, 58], "assembl": 7, "upstream": [7, 18], "repositori": [7, 15, 21, 22, 59], "deriv": [7, 11, 18, 23], "ghostbsd": 7, "strive": 7, "far": [7, 11, 12, 22], "reli": [7, 12, 27], "binari": [7, 43], "wherev": 7, "builder": 7, "git": [7, 15, 18, 21, 22], "handi": 7, "match": [7, 12, 13, 14, 21, 24, 45], "ghz": [7, 22, 58], "dual": [7, 58], "processor": [7, 27, 58], "4": [7, 13, 18, 21, 22, 25, 27, 58], "gib": [7, 49, 58], "50": 7, "gb": [7, 22, 27, 51, 58], "rw": [7, 22], "port": [7, 12, 18, 19, 22, 23, 43, 53, 58], "fast": [7, 49], "internet": [7, 22, 39, 49, 51, 53, 57], "y": [7, 19, 21, 22], "zsync": 7, "bash": [7, 22], "devel": [7, 21], "py": [7, 16, 18], "librsvg2": 7, "ca_root_nss": 7, "clone": [7, 15, 21, 22, 35], "dd": [7, 13, 22, 58], "xfce": [7, 18, 22], "dax": [7, 58], "b": [7, 12, 13, 17, 21, 22, 58], "4m": [7, 58], "progress": [7, 19, 21, 22, 51, 58], "respect": [7, 11, 16, 21, 37, 39], "overwrit": [7, 49, 51, 55, 58], "select": [7, 12, 14, 15, 19, 25, 29, 34, 35, 36, 42, 43, 44, 45, 49, 51, 53, 56, 58], "extra": [7, 13, 18, 43, 49, 51], "caution": [7, 49, 51], "undon": [7, 49, 51], "conveni": [7, 12, 22, 31, 49], "cdrecord": 7, "cdrtool": 7, "filenam": [7, 12], "trivial": 7, "appli": [7, 12, 21], "cinnamon": 7, "gnome": [7, 18], "openbox": [7, 22], "rebuild": 7, "substitut": [7, 12], "transient": 7, "fly": 7, "wallpap": [7, 22, 27], "font": [7, 22, 36, 55], "great": [8, 9, 12, 22, 25, 27], "interact": [8, 23, 29, 44], "feel": [8, 9, 27, 39, 44, 57], "free": [8, 9, 11, 12, 13, 57], "ask": [8, 35, 43, 57], "q": [8, 19, 21, 22], "happi": 8, "hear": 8, "meet": [8, 27, 57], "matrix": [8, 25, 57], "client": [8, 18, 38, 57], "web": [8, 12, 30, 31, 50, 57], "channel": [8, 27, 57], "libera": [8, 27, 57], "advantag": [8, 12, 25, 44, 57], "receiv": [8, 46, 57], "were": [8, 12, 18, 25, 38, 57], "offlin": [8, 57], "dai": [8, 27, 57], "answer": [8, 57], "volunt": [8, 9, 16, 57], "chanc": [9, 12, 20], "awesom": 9, "pure": 9, "driven": [9, 27], "highli": [9, 22, 27, 51], "discuss": [9, 18, 27, 59], "track": [9, 19, 31], "hesit": [9, 11, 57], "topic": [9, 12, 18, 27], "mark": [9, 42, 58], "cours": [9, 30], "ticket": 9, "too": [9, 21, 22], "liber": [9, 55], "fixm": 9, "todo": [9, 13], "alwai": [9, 11, 12], "philosophi": [9, 25, 26], "complic": 9, "larg": [9, 51], "structur": [9, 27], "deep": 9, "subclass": 9, "arithmet": 9, "appreci": [9, 22], "why": [9, 18, 25], "polici": [9, 11], "merg": 9, "pr": 9, "breakag": 9, "master": [9, 21, 22], "crash": [9, 14, 15, 18, 22], "flag": [9, 58], "good": [9, 12, 21, 22], "header": 10, "img": [10, 13, 58], "obtain": [10, 12], "tag": [10, 16], "r0": 10, "pycharm": 10, "ce": 10, "editor": [10, 27], "ui": [10, 12, 16, 18], "liteid": 10, "recommend": [10, 13, 23, 25, 27, 51, 58], "long": [10, 18, 27, 53], "server": [10, 14, 23, 27], "parallel": 10, "zeal": 10, "known": [10, 12, 13, 18, 19, 39, 43, 44, 58], "docset": 10, "prior": [10, 22, 31], "guid": [10, 22], "focus": 11, "coher": 11, "ultim": 11, "qualiti": 11, "third": 11, "parti": 11, "permit": 11, "awar": 11, "portabl": 11, "significantli": [11, 18, 25], "mainten": 11, "burden": 11, "distinguish": 11, "collect": [11, 12, 19, 22, 50], "individu": [11, 27, 58], "realli": [11, 27, 51], "contact": [11, 27, 50, 58, 59], "team": [11, 27, 57], "regard": [11, 18, 19, 35], "item": [12, 18, 25], "conform": 12, "ema": 12, "adopt": [12, 13, 18], "novemb": [12, 25], "23": 12, "inherit": 12, "pcmanfm": 12, "verifi": [12, 14, 15, 19, 22], "portion": 12, "correct": [12, 18, 19, 21, 22, 51], "alt": [12, 27, 37, 39, 45, 58, 59], "quit": [12, 17, 39, 58], "f2": [12, 58, 59], "three": [12, 15, 18, 56, 59], "thought": 12, "suitabl": [12, 14, 22, 24, 27, 49], "whose": 12, "met": 12, "runtim": [12, 13], "tooltip": 12, "on_fold": 12, "on_fil": 12, "on_desktop": 12, "mimetyp": 12, "inod": 12, "strictli": [12, 22, 58], "equal": 12, "sign": 12, "syntax": 12, "selectioncount": 12, "qtermin": [12, 21, 55], "workdir": 12, "allfil": 12, "echo": [12, 13, 20, 21, 22], "scheme": 12, "nautilu": 12, "save": [12, 14, 27, 58], "deepli": 12, "probabl": [12, 18, 22], "somewher": 12, "group": [12, 35, 51], "itemslist": 12, "common": [12, 13, 18, 24], "summari": [12, 51], "sensit": 12, "boolean": 12, "true": [12, 27], "fals": 12, "semicolon": 12, "rest": 12, "basenam": 12, "desktop_file_id": 12, "xdg_data_dir": 12, "_desktop_file_id_": 12, "uniqu": [12, 50], "sever": [12, 22, 27, 44], "display": 12, "label": [12, 20, 34], "against": [12, 27], "gather": 12, "recurs": 12, "subitem": 12, "arbitrari": 12, "decis": [12, 25, 27], "evalu": [12, 27], "neither": 12, "nor": 12, "candid": 12, "valid": [12, 13, 43], "least": [12, 15, 22, 27, 58, 59], "primarili": [12, 18], "req": 12, "localestr": 12, "associ": [12, 18, 25, 50], "theme": [12, 22], "suggestedshortcut": 12, "shortcut": [12, 28, 29, 34, 37, 41], "reserv": [12, 13, 22], "overrid": [12, 20, 51], "f1": 12, "hidden": 12, "spec": [12, 18, 22], "hi": 12, "present": [12, 35, 51], "upper": [12, 18], "dir": 12, "equival": [12, 18], "uninstal": [12, 31], "due": [12, 18], "renam": [12, 51], "let": [12, 18, 19, 22, 35, 37, 38, 39, 40, 45, 51, 58], "targetcontext": 12, "targetloc": 12, "targettoolbar": 12, "toolbar": 12, "nice": [12, 19], "stabl": 12, "toolbarlabel": 12, "_profile_id_": 12, "ascii": 12, "enclos": 12, "between": [12, 13, 18, 27], "squar": 12, "bracket": 12, "dynam": [12, 14, 30, 44], "ignor": [12, 22], "fallback": [12, 14, 18, 35], "append": [12, 22], "orphan": 12, "choic": 12, "profile_id": 12, "OR": 12, "ed": [12, 16, 25], "slightli": 12, "seen": 12, "exactli": [12, 15, 25], "argument": 12, "executionmod": 12, "chosen": 12, "embed": 12, "special": [12, 18, 51, 59], "featur": [12, 15, 17, 20, 51], "ran": 12, "displayoutput": 12, "stream": 12, "stdout": 12, "stderr": 12, "startupnotifi": 12, "send": [12, 18], "desktop_startup_id": 12, "notif": [12, 18], "shown": [12, 18, 43, 44, 45, 51, 53], "startupwmclass": 12, "absent": 12, "assum": [12, 13, 22, 58, 59], "protocol": [12, 18, 22, 46], "map": [12, 18], "wm": 12, "hint": 12, "executea": 12, "numer": 12, "uid": 12, "presenc": 12, "subsystem": 12, "keyword": 12, "redisplai": 12, "elsewher": 12, "unspecifi": 12, "remaind": 12, "said": [12, 22], "AND": 12, "negat": 12, "video": [12, 14, 27, 52], "And": 12, "bmp": 12, "onlyshowin": 12, "notshowin": 12, "anywher": [12, 44], "tryexec": 12, "eval": 12, "success": [12, 14, 58], "showifregist": 12, "dbu": [12, 18, 22, 59], "regist": [12, 18], "_comment": 12, "_": 12, "_thi": 12, "showifrun": 12, "showiftru": 12, "svn": 12, "showifdbuscal": 12, "audio": [12, 19, 44], "mpeg": 12, "charact": [12, 45, 51], "wildcard": 12, "alon": 12, "subgroup": 12, "servicetyp": 12, "excludeservicetyp": 12, "h": [12, 18, 30, 39], "matchcas": 12, "satisfi": [12, 13, 18, 55], "sftp": [12, 23, 43], "smb": 12, "secret": 12, "music": 12, "impli": 12, "todai": 12, "view": [12, 13, 29, 34, 38, 50], "capabl": [12, 21, 27, 51, 58], "ANDed": 12, "readabl": 12, "both": [12, 14, 27, 58], "predefin": [12, 30], "owner": 12, "invalid": 12, "doesn": [12, 15, 22], "secur": [12, 17, 27, 50, 53, 59], "sort": [12, 14, 18, 21], "correctli": [12, 13, 14, 22], "escap": 12, "quot": [12, 21], "Or": [12, 21, 59], "sensibl": [12, 25], "declens": 12, "singular": 12, "plural": 12, "thu": [12, 19], "contrarili": 12, "irrelev": 12, "pierr": 12, "paul": 12, "jacqu": 12, "predict": 12, "ident": 12, "obvious": 12, "sens": [12, 18], "mix": 12, "unless": [12, 39, 44], "unwait": 12, "nonetheless": 12, "warn": [12, 22, 51], "counter": 12, "left": [12, 23, 27, 37, 39, 51, 58], "exercis": 12, "reader": 12, "word": 12, "tabl": 12, "recal": 12, "unpredict": 12, "hostnam": [12, 23, 38, 43, 50, 51], "uri": 12, "m": [12, 19, 21, 22, 27, 51, 58], "n": 12, "usernam": [12, 38, 43, 50, 51, 59], "op": 12, "p": [12, 13, 15, 16, 19, 22, 24, 58], "processu": 12, "meta": 12, "algorithm": 12, "goal": [12, 18, 27, 53, 57], "laid": 12, "final": [12, 21], "prepar": [12, 13, 21], "elimin": 12, "duplic": [12, 50], "flat": 12, "consist": [12, 14, 18, 21, 25, 27, 28], "address": [12, 18, 38, 43, 50], "consum": [12, 13], "root": [12, 13, 15, 18, 22], "input": [12, 16, 19], "phase": [12, 23], "solv": 12, "signif": 12, "Not": [12, 18, 22, 23, 58], "risk": [12, 22], "collis": 12, "konqueror": 12, "krusad": 12, "useract": 12, "thunar": 12, "jona": 12, "b\u00e4hr": 12, "david": 12, "faur": 12, "ted": [12, 18], "gould": [12, 18], "hong": 12, "jen": 12, "yee": 12, "pcman": 12, "michael": 12, "pyne": 12, "liam": 12, "quin": 12, "wieser": 12, "medium": [13, 49, 51, 58], "physic": [13, 27, 34, 58], "dvd": [13, 27, 58], "geom": 13, "modular": [13, 22], "transform": 13, "framework": [13, 18, 27, 58], "md": [13, 15, 17, 21], "geom_uzip": 13, "principl": [13, 25, 26], "sector": [13, 21], "zero": [13, 20, 22], "1m": [13, 22], "512": [13, 22], "mdconfig": [13, 22], "vnode": 13, "9": [13, 21], "newf": 13, "md9": 13, "mnt": 13, "popul": [13, 51], "cp": [13, 20, 21, 22], "umount": 13, "kldload": [13, 24], "md0": 13, "md1": 13, "512m": 13, "sure": [13, 15, 16, 22, 51, 59], "rowr": 13, "rowr0": 13, "pxeboot": 13, "logic": 13, "togeth": 13, "usual": [13, 18, 35, 58], "makef": 13, "20": [13, 22], "cdroot": 13, "mkuzip": 13, "uncompress": 13, "byte": [13, 24, 50], "hold": [13, 22, 59], "suffix": 13, "medias": 13, "mismatch": 13, "3gb": 13, "malloc": [13, 22], "isn": 13, "grow": [13, 27], "firmwar": [13, 22, 27, 58], "wlan": [13, 22, 40, 58], "symlink": [13, 19, 27, 32, 42], "sysroot": 13, "kern": 13, "module_path": 13, "mkdir": [13, 15, 16, 21, 22, 58], "nullf": 13, "sysctl": [13, 14, 59], "With": [13, 18, 20, 22, 27], "problem": [13, 19, 55], "unrel": 13, "discoveri": [13, 23], "zpool": 13, "inabl": 13, "pool": [13, 22], "insert": [13, 20, 22, 27, 49], "workaround": [13, 22], "copyright": [13, 22], "2021": [13, 18, 22], "jordan": 13, "gordeev": 13, "author": [13, 17, 18, 50], "certain": [13, 23, 41], "level": [13, 22, 24], "matur": 13, "initgfx_devic": 14, "db": 14, "initgfx_xorg": 14, "cfg": 14, "tgz": 14, "x11": [14, 15, 18, 21], "path_xorg_cfg_dir": 14, "md5": 14, "checksum": [14, 21], "vgapci": 14, "var": [14, 52], "initgfx_config": 14, "initgfx_kmod": 14, "auto": 14, "acceler": [14, 58], "xinit": 14, "vesa": 14, "scfb": 14, "bio": [14, 58], "cat": [14, 18, 20, 21, 22], "card": [14, 27, 40, 49, 51, 58], "vendornam": 14, "corpor": 14, "busid": 14, "endsect": 14, "initgfx_menu": 14, "autodetect": [14, 27], "initgfx_default": 14, "temporarili": 14, "failsaf": 14, "bootload": [14, 20, 35], "properli": [14, 15, 18, 22, 27, 50], "opengl": 14, "seemingli": 14, "cover": [14, 22, 23, 35], "390": 14, "modeset": 14, "independ": 15, "That": [15, 22], "necessarili": 15, "alpin": 15, "0h165": 15, "stop": [15, 59], "debian": 15, "apk": 15, "readm": [15, 21], "j": [15, 25], "nproc": 15, "onestop": 15, "clang": 15, "cmakecach": 15, "txt": [15, 17, 22], "alpinelinux": 15, "password": [15, 22, 35, 38, 43, 51], "repo": [15, 18], "plasma": [15, 25], "sddm": 15, "wayland": [15, 18], "smoothli": 15, "guest": [15, 27, 58], "su": [15, 21], "switch": [15, 22, 27, 39, 55], "killal": [15, 22, 59], "plasmashel": 15, "shoud": 15, "somewhat": [15, 22], "loos": 15, "classic_install_or_sys_mode_on_raspberry_pi": 15, "anymor": [15, 22, 42, 58], "partit": [15, 22, 49, 51], "falloc": [15, 58], "8g": 15, "swapfil": 15, "mkswap": 15, "swapon": [15, 22], "kill": [15, 22], "1gb": 15, "model": [15, 22, 25, 27], "weblat": 16, "everyon": [16, 25, 53], "Be": 16, "button": [16, 39, 51, 56, 59], "deepl": 16, "googl": [16, 18, 30, 31], "microsoft": 16, "pick": [16, 24], "internation": 16, "tstranslat": 16, "tstr": 16, "i18n": 16, "tr": 16, "mainwindow": 16, "wizard": 16, "qwizard": 16, "object": [16, 18, 25, 43], "setwindowtitl": 16, "windowtitl": 16, "findchildren": 16, "qobject": 16, "none": [16, 18, 21, 22], "findchildrenrecurs": 16, "hasattr": 16, "settext": 16, "english": 16, "pylupdate5": 16, "noobsolet": 16, "unneed": 16, "xml": [16, 18], "further": [16, 22, 23, 57], "fullest": 17, "markup": 17, "mdoc": 17, "steep": 17, "learn": [17, 26, 31], "curv": 17, "markdown": [17, 23], "pandoc": 17, "templat": [17, 22], "pragmaticlinuxblog": 17, "pandocmanpag": 17, "convert": [17, 18, 22, 23], "col": 17, "prognam": 17, "synopsi": 17, "context": [17, 18, 42], "diagnost": 17, "histori": 17, "caveat": 17, "consider": [17, 25], "unifi": [18, 27], "regardless": 18, "toolkit": [18, 21, 24], "crucial": 18, "date": [18, 41, 58], "subject": [18, 20, 21, 22], "submit": [18, 21, 27, 50, 55], "screen": [18, 19, 20, 22, 25, 27, 34, 35, 36, 42, 44, 45, 49, 51, 53, 55, 56, 58], "term": [18, 51], "canon": 18, "right": [18, 22, 27, 29, 42, 45, 54, 56], "corner": [18, 27], "background": [18, 25, 27, 34, 41], "trai": 18, "area": [18, 20, 38, 39, 40, 43, 51], "bottom": [18, 27, 42], "tbd": 18, "statusnotifieritem": 18, "report": [18, 21, 27, 58, 59], "quick": [18, 22, 42], "peopl": [18, 53], "agateau": 18, "dead": 18, "2020": [18, 21], "2009": 18, "workspac": 18, "evolv": 18, "ximion": 18, "transfer": 18, "registrar": 18, "establish": 18, "emploi": 18, "gapplic": 18, "therefor": [18, 25, 27, 37], "gio": 18, "overlap": 18, "scope": 18, "complement": 18, "deprec": 18, "xwindow": 18, "Such": 18, "extrem": 18, "hud": 18, "serv": [18, 48], "method": [18, 19], "gmenu_dbusmenu_proxi": 18, "latter": 18, "overview": [18, 23, 27], "had": 18, "ubuntu": [18, 22], "rough": 18, "aytana": 18, "buddhist": 18, "sphere": 18, "abandon": 18, "ayatanaind": 18, "ayatana": 18, "sni": 18, "focu": [18, 26, 27], "agnost": 18, "longer": [18, 58], "ubport": 18, "mate": 18, "migrat": 18, "21": [18, 22], "04": [18, 22], "across": [18, 27, 59], "transport": 18, "intern": [18, 49, 51], "screenkei": 18, "hand": [18, 21, 22, 45, 56, 58], "sunweav": 18, "unmaintain": 18, "2022": [18, 19], "libayatana": 18, "appind": 18, "menumodel": 18, "jayatana": 18, "supposedli": [18, 19], "java": 18, "swing": 18, "netbean": 18, "jetbrain": 18, "airyx": 18, "dbuskit": 18, "subset": 18, "appkit": 18, "bind": 18, "inter": [18, 23], "incomplet": 18, "libappindicator3": 18, "ksni": 18, "systrai": 18, "bugtrack": 18, "launchpad": 18, "purpos": [18, 27], "theori": 18, "statusnotifi": 18, "rilian": 18, "la": 18, "te": 18, "norwegianrockcat": 18, "my": 18, "strip": 18, "sometim": [18, 22], "audac": [18, 44], "advis": [18, 27, 51], "fuction": 18, "retir": 18, "apt": 18, "kded": 18, "plasma_applet_appmenu": 18, "wxwidget": 18, "linux": [18, 19, 22, 23, 24, 27, 33, 49, 50, 58], "wx31": 18, "plasma5": 18, "dictionari": 18, "referenc": 18, "random": 18, "ultimak": 18, "cura": 18, "site": 18, "um": 18, "pass": 18, "putenv": 18, "thank": [18, 55], "jesper": 18, "schmitz": 18, "mouridsen": 18, "substanti": 18, "aur": 18, "archlinux": 18, "cgit": 18, "airyxo": 18, "firefox_app": 18, "0001": 18, "remot": [18, 28, 34, 41, 46, 51], "gdk": 18, "mozilla": 18, "1419151": 18, "mail": [18, 53], "122amd64": 18, "eof": [18, 20], "url": [18, 21, 22, 50], "mozillapatch": 18, "mirror_typ": 18, "srv": 18, "signature_typ": 18, "pubkei": 18, "ssl": 18, "cert": 18, "prioriti": 18, "100": 18, "public": [18, 50], "miicijanbgkqhkig9w0baqefaaocag8amiiccgkcagea5get92ahukykzh2q2np3": 18, "wu7gxbmeno5iqi1ea327lhmhjb18e0mw9dkygxz74pbbtamyamdy4g1vn3cstp": 18, "jkvnrocsnboaz1l6riyftjzx0pvaqydtblcnjtf92x1kk8yp1jy3bah8s19ikvwd": 18, "jx": 18, "2j33bojrh3jbilxdpu51wpitdum4uu": 18, "mdrmh2": 18, "rghjvx3zkgre": 18, "byxmgrybqg": 18, "roewp0pv9dbdq0vx3qibjahq7zfdcwzi1urr85": 18, "km58kxylt1yhw": 18, "vrd3scom1i": 18, "mron0zvo2f8": 18, "obzy3llnnzj": 18, "xiwxh": 18, "lni4kmmdohmksysytrrz1bpcnsy8qoe4g3": 18, "x7q": 18, "i8k0jaamwwd9yvkf6hyq09rft3wqv2aaowr0835ohxcenjjfcoucmcakjnsf": 18, "ozyuykkpqsm8bkj": 18, "qaoxbif1fqjbjzrinysuj4": 18, "m6twkvtso8h4": 18, "eiqfd7fyj3h": 18, "jsz2ubydttoef1tk79ovoo8ns7fqzck7ffovelxuy2omdikrw0scfpki9um5dfrr": 18, "ryxn4dwvzlwb": 18, "tnbbkbxifjavwqjhewfzqguhsk": 18, "slqh7ueyl": 18, "bnlfhxlmvn0omk": 18, "gfm24evekju1phkbdhvad": 18, "ngfq4g": 18, "hcbabcrtjxdrs1ztdwjtcjmfnceyfjz0drc": 18, "q9ctv5oary9fqy0ndgwguqucaweaaq": 18, "94": 18, "1_1": 18, "91": 18, "0_1": 18, "aim": [18, 25, 27], "hope": 18, "gmenudbusmenuproxi": 18, "kai": 18, "broulik": 18, "phabric": [18, 21], "d10461": 18, "forward": [18, 58], "libreoffic": 18, "gimp": 18, "inkscap": 18, "standalon": 18, "xprop": 18, "_kde_net_wm_appmenu_object_path": 18, "_kde_net_wm_appmenu_service_nam": 18, "59": 18, "definit": 18, "describeal": 18, "idea": [18, 21, 26], "fildem": 18, "cutefisho": 18, "decad": 19, "ago": [19, 25], "someon": 19, "jack": 19, "fact": 19, "haven": 19, "writeup": 19, "musician": 19, "usb": [19, 20, 21, 22, 27, 49, 51, 58], "control": [19, 27, 38, 53, 58], "plug": 19, "node": 19, "arriv": 19, "midicat": 19, "rmidi": 19, "plai": [19, 48], "fluidsynth": 19, "musescor": 19, "soundfont": 19, "sf2": 19, "lmm": 19, "dropdown": 19, "recent": [19, 44, 55], "per": [19, 32, 39, 43], "q2": 19, "aseqdump": 19, "event": [19, 21, 22, 24], "ch": 19, "recompil": 19, "want_alsa": 19, "makefil": [19, 21], "cmake_off": 19, "want_calf": 19, "want_cap": 19, "want_cmt": 19, "want_swh": 19, "want_stk": 19, "want_tap": 19, "want_vst": 19, "cmake_on": 19, "want_qt5": 19, "clean": [19, 21], "sndio": 19, "pane": 19, "gear": 19, "tripleoscil": 19, "seq_hw": 19, "466": 19, "snd_seq_hw_open": 19, "snd": 19, "sdl": 19, "directmedia": 19, "layer": 19, "rapid": 20, "cycl": 20, "loacat": 20, "stick": [20, 27, 49, 51, 58], "fat32": 20, "msdosf": 20, "monkey_patch": 20, "monkey_was_her": 20, "__wait": 20, "sync": 20, "rare": 20, "destroi": [20, 58], "mortal": [20, 26], "readlink": 20, "mount_md": 20, "particularli": [20, 27], "debug": [20, 50], "maxim": [20, 25, 56], "monkey_patch_init_script": 20, "correspond": [21, 22], "lxqt": 21, "474": 21, "qtermwidget": 21, "059d832086facb19035a07d975ea4fd05d36b1ec": 21, "terminaldisplai": 21, "cpp": 21, "l3206": 21, "depth": 21, "allow_unsupported_system": 21, "csh": 21, "xarg": 21, "annoi": [21, 31], "entiti": 21, "make_jobs_unsaf": 21, "j4": [21, 22], "qtermwidget5_dir": 21, "qtermwidget5": 21, "ld_library_path": 21, "orig": 21, "nano": [21, 22], "qchar": 21, "qlatin1char": 21, "droptext": 21, "urltext": 21, "qlatin1str": 21, "makepatch": 21, "lib_terminaldisplai": 21, "11": 21, "03": 21, "08": 21, "19": [21, 25], "26": 21, "utc": 21, "3099": 21, "dropev": 21, "qdropev": 21, "affect": [21, 35, 39], "kshell": 21, "quotearg": 21, "porter": 21, "handbook": 21, "authorit": 21, "portlint": 21, "sysutil": 21, "fluxengin": 21, "portnam": 21, "distvers": 21, "572": 21, "categori": [21, 57], "probono": 21, "puredarwin": 21, "floppi": 21, "pc": [21, 27, 37, 58], "mit": 21, "lib_depend": 21, "libsqlite3": 21, "databas": [21, 27, 50, 58], "sqlite3": 21, "libstdc": 21, "gcc9": 21, "build_depend": 21, "ninja": 21, "gmake": 21, "use_github": 21, "gh_account": 21, "davidgiven": 21, "gh_tagnam": 21, "61ff48c": 21, "install_program": 21, "wrksrc": 21, "brother120tool": 21, "stagedir": 21, "prefix": [21, 50], "brother240tool": 21, "mk": 21, "makeplist": 21, "plist": 21, "5": [21, 22, 25, 52], "convent": [21, 27], "complain": 21, "reshuffl": 21, "doc": [21, 22], "qa": 21, "uniq": 21, "speed": [21, 22], "descr": 21, "cheap": 21, "exot": 21, "amiga": 21, "clv": 21, "bizarr": 21, "128": [21, 22], "weird": 21, "commod": 21, "connector": 21, "solder": 21, "board": [21, 22], "fiddli": 21, "surfac": 21, "assembli": 21, "fuss": 21, "nineteen": 21, "joint": 21, "cowlark": 21, "makesum": 21, "mistak": 21, "fine": 21, "deinstal": 21, "shar": 21, "rf": [21, 22], "cf": 21, "portvers": 21, "reinstal": 21, "diff": 21, "u999999": 21, "home": [21, 22, 27, 32, 35, 38, 39, 43, 58], "x11_qtermin": 21, "devel_lxqt": 21, "toolkits_qtermwidget": 21, "differenti": 21, "credenti": [21, 35, 43], "d37378": 21, "d37379": 21, "d37380": 21, "past": [21, 22, 53], "aaz": 21, "xlibr": 21, "although": [22, 23, 27, 29], "investig": 22, "feasibl": 22, "benefici": 22, "rk3399": 22, "pinebook": 22, "pro": 22, "pine64": 22, "rockpro64_rk3399": 22, "brief": 22, "walkthrough": 22, "readymad": 22, "decent": 22, "400": 22, "suppli": 22, "microsd": [22, 49], "hdmi": [22, 58], "ethernet": [22, 58], "sata": [22, 58], "nvme": 22, "msdosboot": 22, "hdmi_saf": 22, "disable_overscan": 22, "display_auto_detect": 22, "max_framebuffer_width": 22, "3840": 22, "max_framebuffer_height": 22, "2160": 22, "max_framebuff": 22, "gpu_mem": 22, "pi4": 22, "dtoverlai": 22, "vc4": 22, "km": 22, "v3d": 22, "framebuffer_width": 22, "width": 22, "framebuffer_height": 22, "height": 22, "pcie": 22, "off": 22, "64": [22, 27, 58], "bit": [22, 27, 58], "arm": [22, 27], "land": 22, "basic": [22, 23], "fluxbox": 22, "lite": 22, "startfluxbox": 22, "xinitrc": 22, "startx": [22, 59], "easiest": 22, "pkgconf": 22, "qmake": 22, "buildtool": 22, "kdbusaddon": 22, "kwindowsystem": 22, "libdbusmenu": 22, "concurr": 22, "quickcontrols2": 22, "libfm": 22, "libqtxdg": 22, "throughout": [22, 27], "refus": 22, "3691": 22, "stylesheet": 22, "qss": 22, "univers": 22, "xubuntu": 22, "artwork": 22, "theme_16": 22, "2_all": 22, "deb": 22, "xz": 22, "elementari": 22, "raw": [22, 24, 58], "githubusercont": 22, "brand": 22, "artifexsoftwar": 22, "urw": 22, "base35": 22, "20200910": 22, "unzip": 22, "ttf": [22, 55], "proce": [22, 51], "similarli": [22, 27], "cursor": [22, 56], "everi": [22, 25, 27, 58], "curl": 22, "fss": 22, "egrep": 22, "automount": [22, 33, 55], "rfv": 22, "mountarch": [22, 28, 46], "temporari": 22, "mmcsd0s2a": 22, "zeroconf": [22, 23, 27, 43], "avahi_en": 22, "slow": 22, "wear": 22, "me": 22, "suck": 22, "adapt": [22, 58], "nixcraft": 22, "breifli": 22, "encrypt": [22, 53], "8192": 22, "mb": 22, "tweak": 22, "sake": [22, 27], "multipli": 22, "gigabyt": 22, "1024": [22, 58], "4096": [22, 58], "0600": 22, "md42": 22, "sw": 22, "aq": 22, "swapinfo": 22, "k": 22, "enhanc": 22, "notic": 22, "boost": 22, "lifespan": 22, "permen": 22, "ve": 22, "heat": 22, "sing": 22, "fan": 22, "trick": 22, "competat": 22, "cool": 22, "bite": 22, "ass": 22, "thermal": 22, "throttl": 22, "littl": 22, "phone": [22, 25], "charger": 22, "iphon": 22, "macbook": 22, "won": 22, "rasbperri": 22, "manufactur": 22, "foundat": [22, 27], "ir": 22, "oem": 22, "argon": 22, "ONE": 22, "inher": 22, "push": 22, "robust": 22, "ussu": 22, "afford": 22, "failur": 22, "eeprom": 22, "flash": [22, 51], "limit": 22, "overdo": 22, "liquid": 22, "nitrogen": 22, "afraid": 22, "max": 22, "msdo": 22, "over_voltag": 22, "arm_freq": 22, "2147": 22, "gpu_freq": 22, "700": 22, "mhz": 22, "maximum": 22, "unlik": 22, "higher": [22, 27], "3000": 22, "900": 22, "probabi": 22, "diminish": 22, "badass": 22, "invest": 22, "monster": 22, "cooler": 22, "pretti": 22, "warm": 22, "paper": [22, 25, 27], "2019": 22, "bsdcan": 22, "vadot": 22, "adventure_in_drmland": 22, "frogfind": 22, "instant": 22, "crashlog": 22, "17t10": 22, "sa": 22, "apr": 22, "17": 22, "render": 22, "qtwebengin": 22, "backtrac": 22, "0x213810": 22, "0x499b4994": 22, "_pthread_sigmask": 22, "0x524": 22, "libthr": 22, "rockpro64": 22, "4gb": [22, 58, 59], "zram": 22, "android": 22, "chromium": [22, 31], "ever": 22, "summerofcode2019project": 22, "virtualmemorycompress": 22, "maco": [22, 49, 58], "lifewir": 22, "2260327": 22, "tenforum": 22, "17993": 22, "unaccept": 22, "700m": 22, "md7": 22, "constrain": 22, "qt_qpa_platformthem": 22, "stare": 22, "friendli": [23, 25, 27], "desir": [23, 29, 58], "enthusiast": 23, "mdn": [23, 27], "dn": [23, 43], "sd": [23, 27, 43, 49, 51], "websit": [23, 27], "ssh": [23, 38, 43, 51], "discov": [23, 43], "ipp": 23, "everywher": 23, "printer": [23, 27], "appimag": 23, "predominantli": 23, "exhaust": [23, 39], "formal": 23, "mostli": 23, "Their": 23, "declin": 23, "icccm": 23, "ewmh": 23, "picom": 23, "ipc": 23, "vast": 23, "bodi": 23, "examin": 24, "strace": 24, "dtraceal": 24, "featherpad": 24, "ax": 24, "1886": 24, "probe": [24, 28, 40, 46, 58], "syscal": 24, "liner": 24, "task": [24, 43], "measur": 24, "profil": 24, "schedul": 24, "tcp": [24, 58], "inbound": 24, "went": 25, "replica": 25, "ux": 25, "openli": 25, "spell": 25, "publicli": [25, 50], "30": 25, "profession": [25, 27], "fit": 25, "plan": 25, "inc": [25, 58], "1992": 25, "addison": 25, "weslei": 25, "compani": 25, "isbn": 25, "201": 25, "62216": 25, "prais": 25, "semin": 25, "kind": 25, "empir": 25, "evid": 25, "percentag": 25, "border": 25, "movement": 25, "larger": [25, 58], "distanc": 25, "inch": 25, "diagon": 25, "outperform": 25, "walk": 25, "jb": 25, "comparison": 25, "jc": 25, "chew": 25, "whitesid": 25, "proceed": 25, "sigchi": 25, "confer": 25, "chi": 25, "machineri": 25, "pp": 25, "221": 25, "225": 25, "seattl": 25, "unit": 25, "90": 25, "dl": 25, "acm": 25, "doi": 25, "pdf": 25, "1145": 25, "97243": 25, "97277": 25, "behind": [25, 26, 27], "proven": 25, "hurt": 25, "harder": 25, "behav": [25, 29, 51], "unnecessari": 25, "face": 25, "wish": [25, 50], "willkommen": 26, "bienvenu": 26, "benvenuto": 26, "bienvenido": 26, "\u3088\u3046\u3053\u305d": 26, "mabuhai": 26, "tervetuloa": 26, "v\u00e4lkommen": 26, "\u0434\u043e\u0431\u0440\u043e": 26, "\u043f\u043e\u0436\u0430\u043b\u043e\u0432\u0430\u0442\u044c": 26, "ho\u015f": 26, "geldiniz": 26, "bonvenon": 26, "\u6b61\u8fce": 26, "\u043b\u0430\u0441\u043a\u0430\u0432\u043e": 26, "\u043f\u0440\u043e\u0441\u0438\u043c\u043e": 26, "\u6b22\u8fce": 26, "eleg": 26, "Its": [26, 27], "rock": 27, "solid": 27, "appeal": 27, "notebook": 27, "emphasi": 27, "instantli": 27, "guidanc": 27, "perspect": 27, "creativ": 27, "3d": 27, "thorough": 27, "explor": 27, "x86": 27, "dedic": [27, 43], "storag": [27, 49, 51, 55], "1024x768": [27, 58], "optim": 27, "ssd": [27, 58], "120": 27, "1920x1080": 27, "benchmark": 27, "accur": 27, "represent": 27, "stabil": 27, "authent": 27, "realist": 27, "addition": [27, 33], "strongli": 27, "conduct": 27, "preinstal": 27, "straightforward": 27, "burn": 27, "alongsid": 27, "uefi": [27, 58], "encount": 27, "consult": [27, 49], "assist": [27, 28, 46], "six": 27, "seri": 27, "founder": 27, "insight": 27, "express": 27, "eas": 27, "discover": 27, "intuit": 27, "rang": 27, "spacebar": [27, 37, 39], "comfort": 27, "electron": [27, 58], "layout": [27, 34], "hub": [27, 58], "launcher": [27, 43], "booster": 27, "freeli": 27, "fileystem": 27, "moder": 27, "compar": 27, "media": [27, 28, 35, 46, 51], "appliact": 27, "artist": 27, "videograph": 27, "maker": 27, "contributor": 27, "hide": [27, 45, 56], "natur": 27, "fun": 27, "advertis": [27, 31, 38], "brows": 27, "bootabl": [27, 35, 49, 51, 55, 58], "frequent": 27, "grown": 27, "terminologi": 27, "familiar": [27, 56], "intention": 27, "aspir": 27, "blank": [27, 51], "black": 27, "white": 27, "intoduct": 27, "modern": 27, "wysiwyg": 27, "revel": 27, "amber": 27, "green": [27, 56], "drag": [27, 56], "preciou": 27, "estat": [27, 56], "io": 27, "tracker": [27, 31], "broader": 27, "troubleshoot": 27, "brainstorm": 27, "chat": [27, 53], "24": 27, "iridium": [28, 29], "autostart": [28, 42], "wireless": [28, 34, 58], "sticki": [28, 46], "traffic": [28, 53], "light": 28, "resiz": 28, "auxiliari": [29, 58], "reload": 29, "frankfurt": 30, "duckduckgo": 30, "m\u00fcnchen": 30, "sp": 30, "startpag": 30, "hamburg": 30, "stuttgart": 30, "gh": 30, "Of": 30, "preview": [30, 55], "webstor": 31, "privaci": [31, 46], "cooki": 31, "popup": 31, "visit": 31, "dont": 31, "eu": 31, "deactiv": 31, "ublock": 31, "unwant": 31, "gorhil": 31, "json": 31, "mechan": 32, "precis": 32, "exfat": 33, "ntf": 33, "ext4": 33, "hf": 33, "sgi": 33, "cap": 34, "lock": [34, 55], "snapshot": [35, 55], "safe": 35, "critic": 35, "wheel": [35, 51], "mountpoint": [35, 52], "checkbox": [35, 37, 38, 51], "backsapc": 35, "bectl": 35, "hood": 35, "s\u0142awomir": 35, "wojciech": 35, "wojtczak": 35, "scale": 36, "beneath": 36, "tab": 36, "leav": 36, "uncheck": [37, 38], "vnc": 38, "account": [38, 43, 51], "sit": [38, 42], "colleagu": 38, "ssvnc": 38, "unix": [38, 44], "host_displai": 38, "5900": 38, "localhost": 38, "x11vnc": 38, "auth": 38, "xauthor": 38, "ssvncviewer": 38, "kwin": 39, "kglobalaccel": 39, "cosmet": 39, "frontmost": 39, "forcefulli": 39, "malfunct": 39, "prtscn": 39, "screenshot": 39, "shut": [41, 49], "glanc": 42, "typic": [42, 43, 44, 49, 51], "programmat": 42, "dot": 42, "lack": 43, "dialog": 43, "announc": 43, "bonjour": 43, "tld": 43, "steve": 44, "job": 44, "exclus": 44, "skip": 44, "tradition": 44, "gracefulli": 44, "capit": 44, "subtl": 44, "among": 45, "unhid": [45, 56], "quicker": 45, "mathemat": 45, "statement": 45, "sqrt": 45, "timezon": [45, 51], "prerequisit": 46, "tox": 46, "almost": 49, "discard": 49, "newer": 49, "usb3": 49, "usb2": 49, "degrad": 49, "came": [49, 55], "balenaetch": 49, "successfulli": [49, 53, 58], "anonym": 50, "info": [50, 58], "collabor": 50, "perman": 50, "uuid": 50, "serial": 50, "32": [50, 58], "salt": 50, "sha512": 50, "hash": 50, "agre": [50, 51], "visibl": 50, "confirm": [50, 51], "php": 50, "accident": 50, "__instal": 51, "signifi": 51, "unmodifi": 51, "agreement": 51, "destin": 51, "eras": 51, "member": 51, "john": 51, "jdoe": 51, "retyp": 51, "travelm": [51, 58], "b117": [51, 58], "zone": 51, "slower": 51, "coupl": 51, "newli": 51, "gz": 52, "bz2": 52, "extract": 52, "plugin": 52, "invidi": 52, "1001": 52, "_home_user_desktop_plugin": 52, "peer": 53, "friend": 53, "trust": 53, "clipboard": 53, "tunnel": 53, "tester": 55, "backup": 55, "partial": 55, "procedur": 55, "dejavu": 55, "carefulli": 55, "craft": 55, "yellow": 56, "previou": [56, 58], "edg": 56, "titl": 56, "twitter": 57, "hashtag": 57, "post": 57, "th": 57, "relai": 57, "amd": 58, "vga": 58, "800x600": 58, "broken": 58, "flavor": 58, "gnu": 58, "hundr": 58, "sound": 58, "systemat": 58, "11th": 58, "gen": 58, "acer": 58, "revo": 58, "rl85": 58, "dell": 58, "optiplex": 58, "780": 58, "sponsor": 58, "lenovo": 58, "inexpens": 58, "802": 58, "11n": 58, "0bda": 58, "8176": 58, "realtek": 58, "semiconductor": 58, "corp": 58, "rtl8188cu": 58, "wire": 58, "0b95": 58, "772b": 58, "asix": 58, "ax88772b": 58, "bare": 58, "metal": 58, "kvm": 58, "vm": 58, "verbos": [58, 59], "pwd": 58, "x86_64": 58, "q35": 58, "accel": 58, "smp": 58, "virtio": 58, "netdev": 58, "vmnic": 58, "hostfwd": 58, "5222": 58, "22": 58, "std": 58, "soundhw": 58, "hda": 58, "0_0d26": 58, "tablet": 58, "ovmf": 58, "fedora": 58, "edk2": 58, "ovmf_cod": 58, "fd": 58, "smbio": 58, "vendor": 58, "0vendor": 58, "0version": 58, "0date": 58, "expand": 58, "balloon": 58, "socket": 58, "8gb": 58, "16": 58, "reluct": 59, "occasion": 59, "snippet": 59, "liveus": 59, "chose": 59, "seek": 59, "ld_debug": 59, "unprivileged_proc_debug": 59, "truss": 59, "jump": 59, "head": 59, "organis": 59, "particip": 59}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"acknowledg": 0, "freebsd": [0, 4, 15, 21, 59], "project": [0, 9], "port": [0, 21], "maintain": 0, "simon": 0, "peter": 0, "joe": 0, "malonei": 0, "cirru": [0, 21], "ci": [0, 21], "fedor": 0, "korotkov": 0, "foundat": 0, "s\u0142awomir": 0, "wojciech": 0, "wojtczak": 0, "reven": 0, "martin": 0, "cutefisho": 0, "al": 0, "rimoldi": 0, "antoni": 0, "jr": 0, "keshav": 0, "bhatt": 0, "freebsdhelp": 0, "twitter": 0, "theassassin": 0, "leodani": 0, "pozo": 0, "ramo": 0, "marcel": 0, "kaiser": 0, "graham": 0, "perrin": 0, "preyk": 0, "chri": 0, "moor": 0, "weblat": 0, "ree": 0, "jordan": 0, "gordeev": 0, "jesper": 0, "schmitz": 0, "mouridsen": 0, "jsmdk": 0, "sergei": 0, "tyuryukanov": 0, "zo\u00eb": 0, "knox": 0, "alphamodh0": 0, "sebastian": 0, "birnbach": 0, "luna": 0, "jernberg": 0, "framework": [0, 3], "comput": [0, 30, 38, 43, 45], "inc": 0, "j\u00e9r\u00f4me": 0, "ornech": 0, "applic": [1, 2, 3, 5, 18, 19, 29, 42, 43, 45, 59], "bundl": 1, "benefit": 1, "format": [1, 12], "app": 1, "appdir": 1, "wrapper": 1, "legaci": 1, "packag": [1, 7, 21, 22], "build": [1, 4, 5, 7, 12, 15, 21], "make": [1, 4, 16, 21, 43], "an": [1, 12, 22], "load": 1, "privat": [1, 18], "librari": [1, 18], "avoid": [1, 25], "absolut": 1, "path": [1, 12, 45], "credit": 1, "us": [2, 13, 19, 23, 25, 44], "ui": 2, "file": [2, 12, 18, 20, 43], "pyqt": 2, "architectur": 3, "desktop": [3, 6, 7, 12, 18, 36, 59], "compon": [3, 22, 41], "filer": [3, 12, 22, 43], "menu": [3, 12, 14, 18, 22, 25, 45], "dock": [3, 22, 42], "launch": [3, 22, 42, 43, 44, 45], "command": [3, 4, 37, 44], "ipc": 3, "mechan": 3, "util": [3, 46], "prefer": [3, 34], "work": [4, 21], "base": 4, "system": [4, 6, 7, 18, 19, 22, 27, 28, 41, 43, 58], "exampl": [4, 12, 19, 20, 21], "instal": [4, 6, 22, 27, 51, 58], "sourc": 4, "code": 4, "line": 4, "tool": [4, 10], "without": [4, 21], "chang": [4, 21], "binari": 5, "compat": 5, "recommend": [5, 22], "kernel": [5, 13], "modul": [5, 13, 18], "refer": [5, 12], "boot": [6, 13, 20, 22, 35, 59], "process": [6, 13], "speed": 6, "up": [6, 22], "debug": [6, 18, 59], "live": [6, 7, 13, 20, 49, 58], "earli": 6, "troubleshoot": [6, 14, 59], "see": [6, 42], "what": 6, "i": 6, "do": 6, "while": 6, "graphic": [6, 14, 22], "screen": [6, 38, 59], "shown": 6, "verbos": 6, "mode": 6, "singl": 6, "user": [6, 22, 25, 27], "start": [6, 9, 22, 58], "mute": 6, "modifi": 6, "bootload": 6, "script": [6, 7], "iso": [7, 13, 20], "requir": [7, 22, 27, 58], "write": [7, 17, 49], "media": [7, 49, 58], "usb": 7, "drive": [7, 22], "burn": 7, "dvd": 7, "custom": 7, "differ": [7, 20], "environ": [7, 18, 35, 58, 59], "set": [7, 22, 37], "configur": [7, 25], "contact": 8, "discuss": [8, 57], "chat": [8, 57], "contribut": [9, 16], "how": 9, "get": [9, 18, 28, 45, 58, 59], "our": 9, "valu": 9, "area": 9, "we": 9, "especi": 9, "need": [9, 18], "help": [9, 59], "develop": [10, 23], "note": [11, 54], "distribut": 11, "extend": 12, "context": 12, "action": 12, "identifi": 12, "search": [12, 30, 45], "manag": [12, 45], "object": 12, "profil": 12, "condit": 12, "definit": 12, "paramet": 12, "expans": 12, "multipl": 12, "execut": [12, 18], "whole": 12, "hierarchi": 12, "The": [12, 39], "level": 12, "zero": 12, "case": [12, 13], "contributor": 12, "geom_rowr": 13, "theori": [13, 14, 20], "oper": [13, 14, 20], "test": [13, 19, 55, 58], "caveat": 13, "devic": 13, "size": 13, "reroot": 13, "zf": 13, "licens": 13, "hardwar": [14, 22, 50, 58], "autoconfigur": 14, "disabl": [14, 37], "driver": 14, "automat": [14, 30], "setup": 14, "nvidia": 14, "linux": 15, "chroot": 15, "host": 15, "run": [15, 20, 42], "hellodesktop": [15, 22], "raspberri": [15, 22], "pi": [15, 22], "local": [16, 30], "translat": 16, "string": 16, "avail": [16, 43], "qt": [16, 18], "python": 16, "man": 17, "page": [17, 30], "order": 17, "section": 17, "global": [18, 25], "terminologi": 18, "concept": 18, "api": 18, "implement": 18, "involv": 18, "libappind": 18, "libappmenu": 18, "gtk": 18, "from": [18, 21], "vala": 18, "panel": 18, "appmenu": 18, "repositori": 18, "uniti": 18, "gtk2": 18, "parser": 18, "gtk3": 18, "libdbusmenu": 18, "glib": 18, "qt5": 18, "kf5": 18, "plugin": 18, "plasma": 18, "applet": 18, "libappmenuplugin": 18, "wxgtk": 18, "libwx_gtk3u_cor": 18, "variabl": 18, "gtk_modul": 18, "ubuntu_menuproxi": 18, "chromium": 18, "chrome": 18, "patch": [18, 20], "firefox": 18, "thunderbird": 18, "gmenu": 18, "dbusmenu": 18, "proxi": 18, "5": 18, "d": [18, 22], "bu": [18, 22], "viewer": 18, "know": [18, 28], "xorg": 18, "window": [18, 22, 45, 56], "id": 18, "limit": 18, "other": [18, 22, 59], "midi": 19, "dev": 19, "umidi": 19, "oss": 19, "raw": 19, "open": [19, 45], "sound": 19, "alsa": 19, "seq": 19, "server": 19, "monkei": 20, "creat": [20, 21, 35, 49, 58], "volum": 20, "appli": 20, "fly": 20, "monkeypatch": 20, "sh": 20, "init_script": 20, "pull": 21, "tree": 21, "scratch": 21, "updat": [21, 55], "exist": 21, "prerequisit": [22, 49, 51], "option": [22, 25], "prepar": 22, "sd": 22, "card": 22, "bootabl": 22, "ssd": 22, "session": 22, "compil": 22, "core": 22, "qtplugin": 22, "icon": [22, 25], "asset": 22, "overlai": 22, "adjust": 22, "fstab": 22, "enabl": [22, 38], "avahi": 22, "edit": [22, 39], "hello": [22, 26], "ad": 22, "improv": 22, "perform": [22, 45], "swap": 22, "greater": 22, "memori": 22, "capabl": 22, "overclock": 22, "your": [22, 45, 57], "known": 22, "issu": [22, 58, 59], "miss": 22, "login": [22, 38, 59], "web": 22, "browser": 22, "ram": 22, "compress": 22, "specif": 23, "embrac": 23, "hellosystem": [23, 51], "convent": 23, "relev": 23, "trace": 24, "dtrace": 24, "dtruss": 24, "experi": [25, 57], "guidelin": 25, "macintosh": 25, "human": 25, "interfac": [25, 27], "bar": 25, "walker": 25, "n": 25, "smelcer": 25, "1990": 25, "superior": 25, "hidden": 25, "hamburg": 25, "review": 27, "guid": 27, "introduct": 27, "featur": 27, "particular": 27, "support": 27, "falkon": 30, "shortcut": [30, 39, 43], "engin": 30, "encyclopedia": 30, "relat": 30, "reload": 30, "iridium": 31, "autostart": 32, "filesystem": 33, "view": [35, 39], "remov": [35, 43], "mount": 35, "more": [35, 59], "inform": [35, 45], "background": [36, 44], "label": 36, "text": 36, "advanc": 36, "keyboard": [37, 43], "layout": 37, "select": 37, "physic": 37, "kei": [37, 39], "act": 37, "cap": 37, "lock": 37, "share": [38, 57], "name": 38, "remot": [38, 43, 53], "access": [38, 43], "ha": 38, "default": 39, "wireless": 40, "network": [40, 58], "keep": 42, "shut": 45, "down": 45, "document": 45, "folder": 45, "certain": 45, "calcul": [45, 47], "date": 45, "time": 45, "calendar": 48, "download": [49, 58], "probe": 50, "data": 50, "privaci": 50, "mountarch": 52, "assist": 53, "receiv": 53, "give": 53, "about": 53, "tox": 53, "protocol": 53, "sticki": 54, "traffic": 56, "light": 56, "resiz": 56, "provid": 57, "feedback": 57, "idea": 57, "wishlist": 57, "item": 57, "forum": 57, "ventoi": 58, "virtual": 58, "qemu": 58, "parallel": 58, "proxmox": 58, "ve": 58, "vmware": 58, "workstat": 58, "notabl": 59, "logo": 59, "than": 59, "five": 59, "minut": 59, "stall": 59, "black": 59, "prompt": 59}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Acknowledgements": [[0, "acknowledgements"]], "FreeBSD project": [[0, "freebsd-project"]], "FreeBSD port maintainers": [[0, "freebsd-port-maintainers"]], "Simon Peter": [[0, "simon-peter"]], "Joe Maloney": [[0, "joe-maloney"]], "Cirrus CI": [[0, "cirrus-ci"]], "Fedor Korotkov": [[0, "fedor-korotkov"]], "FreeBSD Foundation": [[0, "freebsd-foundation"]], "S\u0142awomir Wojciech Wojtczak": [[0, "slawomir-wojciech-wojtczak"]], "Reven Martin (CutefishOS)": [[0, "reven-martin-cutefishos"]], "Ale Rimoldi": [[0, "ale-rimoldi"]], "Antony jr": [[0, "antony-jr"]], "Keshav Bhatt": [[0, "keshav-bhatt"]], "@FreeBSDHelp on twitter": [[0, "freebsdhelp-on-twitter"]], "TheAssassin": [[0, "theassassin"]], "Leodanis Pozo Ramos": [[0, "leodanis-pozo-ramos"]], "Marcel Kaiser": [[0, "marcel-kaiser"]], "Graham Perrin": [[0, "graham-perrin"]], "PreyK": [[0, "preyk"]], "Chris Moore": [[0, "chris-moore"]], "Weblate": [[0, "weblate"]], "Chris Rees": [[0, "chris-rees"]], "Jordan Gordeev": [[0, "jordan-gordeev"]], "Jesper Schmitz Mouridsen (jsmdk)": [[0, "jesper-schmitz-mouridsen-jsmdk"]], "Sergey Tyuryukanov": [[0, "sergey-tyuryukanov"]], "Zo\u00eb Knox": [[0, "zoe-knox"]], "alphamodh0": [[0, "alphamodh0"]], "Sebastian Birnbach": [[0, "sebastian-birnbach"]], "Luna Jernberg": [[0, "luna-jernberg"]], "Framework Computer Inc": [[0, "framework-computer-inc"]], "J\u00e9r\u00f4me Ornech": [[0, "jerome-ornech"]], "Application Bundles": [[1, "application-bundles"]], "Benefits": [[1, "benefits"]], "Application bundle formats": [[1, "application-bundle-formats"]], ".app bundles": [[1, "app-bundles"]], ".AppDir bundles": [[1, "appdir-bundles"]], "Wrappers for legacy packages": [[1, "wrappers-for-legacy-packages"]], "Building application bundles": [[1, "building-application-bundles"]], "Making an application load privately bundled libraries": [[1, "making-an-application-load-privately-bundled-libraries"]], "Avoiding absolute paths": [[1, "avoiding-absolute-paths"]], "Credits": [[1, "credits"]], "Applications": [[2, "applications"], [3, "applications"], [29, "applications"]], "Using .ui files in PyQt": [[2, "using-ui-files-in-pyqt"]], "Architecture": [[3, "architecture"]], "Frameworks": [[3, "frameworks"]], "Desktop components": [[3, "desktop-components"]], "Filer": [[3, "filer"], [22, "filer"], [43, "filer"]], "Menu": [[3, "menu"], [22, "menu"], [45, "menu"]], "Dock": [[3, "dock"], [22, "dock"], [42, "dock"]], "launch command": [[3, "launch-command"]], "IPC mechanism for the desktop": [[3, "ipc-mechanism-for-the-desktop"]], "Utilities": [[3, "utilities"], [46, "utilities"]], "Preferences": [[3, "preferences"], [34, "preferences"]], "Working with the FreeBSD base system": [[4, "working-with-the-freebsd-base-system"]], "Example": [[4, "example"], [21, "example"]], "Installing the FreeBSD source code": [[4, "installing-the-freebsd-source-code"]], "Building a command line tool without changes": [[4, "building-a-command-line-tool-without-changes"]], "Making changes": [[4, "making-changes"]], "Binary Compatibility": [[5, "binary-compatibility"]], "Application compatibility": [[5, "application-compatibility"]], "Recommendation for building binary compatible applications": [[5, "recommendation-for-building-binary-compatible-applications"]], "Kernel module compatibility": [[5, "kernel-module-compatibility"]], "Recommendation for building binary compatible kernel modules": [[5, "recommendation-for-building-binary-compatible-kernel-modules"]], "References": [[5, "references"], [12, "references"]], "Boot process": [[6, "boot-process"]], "Speeding up the boot process": [[6, "speeding-up-the-boot-process"]], "Debugging the Live system boot process": [[6, "debugging-the-live-system-boot-process"]], "Live system early boot process": [[6, "live-system-early-boot-process"]], "Troubleshooting the Live system early boot process": [[6, "troubleshooting-the-live-system-early-boot-process"]], "Seeing what the system is doing while the graphical boot screen is shown": [[6, "seeing-what-the-system-is-doing-while-the-graphical-boot-screen-is-shown"]], "Boot in verbose mode": [[6, "boot-in-verbose-mode"]], "Boot into verbose single-user mode": [[6, "boot-into-verbose-single-user-mode"]], "Graphical desktop start process": [[6, "graphical-desktop-start-process"]], "Troubleshooting the graphical desktop start process": [[6, "troubleshooting-the-graphical-desktop-start-process"]], "Installed system boot process": [[6, "installed-system-boot-process"]], "Boot Mute": [[6, "boot-mute"]], "Modifying bootloader scripts": [[6, "modifying-bootloader-scripts"]], "Building the Live ISO": [[7, "building-the-live-iso"], [7, "id1"]], "System requirements for building": [[7, "system-requirements-for-building"]], "Writing Live Media to USB drive": [[7, "writing-live-media-to-usb-drive"]], "Burning Live Media to DVD": [[7, "burning-live-media-to-dvd"]], "Customizing the Live ISO": [[7, "customizing-the-live-iso"]], "Different desktop environments": [[7, "different-desktop-environments"]], "Customizing the set of packages": [[7, "customizing-the-set-of-packages"]], "Customizing configuration": [[7, "customizing-configuration"]], "Customizing the build script": [[7, "customizing-the-build-script"]], "Contact": [[8, "contact"]], "Discussions": [[8, "discussions"]], "Chat": [[8, "chat"], [57, "chat"]], "Contributing": [[9, "contributing"]], "How to get started?": [[9, "how-to-get-started"]], "Our project values": [[9, "our-project-values"]], "Areas we especially need help with": [[9, "areas-we-especially-need-help-with"]], "Developer Tools": [[10, "developer-tools"]], "Note to distributions": [[11, "note-to-distributions"]], "Extending Filer context menus": [[12, "extending-filer-context-menus"]], "Examples": [[12, "examples"]], "An example of an action": [[12, "an-example-of-an-action"]], "An example of a menu": [[12, "an-example-of-a-menu"]], "Desktop file": [[12, "desktop-file"]], "Desktop file format": [[12, "desktop-file-format"]], "Desktop file identifier": [[12, "desktop-file-identifier"]], "Desktop files search path": [[12, "desktop-files-search-path"]], "Managed objects": [[12, "managed-objects"]], "Actions and profiles": [[12, "actions-and-profiles"]], "Menus": [[12, "menus"]], "Conditions": [[12, "conditions"], [12, "id1"]], "Action definition": [[12, "action-definition"]], "Profile definition": [[12, "profile-definition"]], "Menu definition": [[12, "menu-definition"]], "Parameters": [[12, "parameters"]], "Parameters expansion": [[12, "parameters-expansion"]], "Multiple execution": [[12, "multiple-execution"]], "Building the whole hierarchy": [[12, "building-the-whole-hierarchy"]], "The level-zero case": [[12, "the-level-zero-case"]], "Contributors": [[12, "contributors"]], "geom_rowr kernel module": [[13, "geom-rowr-kernel-module"]], "Use case": [[13, "use-case"]], "Theory of operation": [[13, "theory-of-operation"], [14, "theory-of-operation"], [20, "theory-of-operation"]], "Test": [[13, "test"]], "Use in the Live ISO boot process": [[13, "use-in-the-live-iso-boot-process"]], "Caveats": [[13, "caveats"]], "Device size": [[13, "device-size"]], "Reroot": [[13, "reroot"]], "ZFS": [[13, "zfs"]], "License": [[13, "license"]], "Graphics hardware autoconfiguration": [[14, "graphics-hardware-autoconfiguration"]], "Disabling the graphics driver menu": [[14, "disabling-the-graphics-driver-menu"]], "Disabling the automatic graphics driver setup": [[14, "disabling-the-automatic-graphics-driver-setup"]], "Troubleshooting": [[14, "troubleshooting"], [59, "troubleshooting"]], "Nvidia drivers": [[14, "nvidia-drivers"]], "Building on Linux": [[15, "building-on-linux"]], "Building in a chroot on a FreeBSD host": [[15, "building-in-a-chroot-on-a-freebsd-host"]], "Running helloDesktop on Linux": [[15, "running-hellodesktop-on-linux"]], "Building and running helloDesktop on Raspberry Pi": [[15, "building-and-running-hellodesktop-on-raspberry-pi"]], "Localization": [[16, "localization"]], "Contributing translations": [[16, "contributing-translations"]], "Making strings available for translation": [[16, "making-strings-available-for-translation"]], "Qt": [[16, "qt"]], "Python": [[16, "python"]], "Writing man pages": [[17, "writing-man-pages"]], "Order of sections": [[17, "order-of-sections"]], "Global Menu": [[18, "global-menu"]], "Terminology": [[18, "terminology"]], "Concepts": [[18, "concepts"]], "APIs": [[18, "apis"]], "Implementations": [[18, "implementations"]], "Libraries involved": [[18, "libraries-involved"]], "libappindicator": [[18, "libappindicator"]], "libappmenu-gtk-module library from vala-panel-appmenu repository": [[18, "libappmenu-gtk-module-library-from-vala-panel-appmenu-repository"]], "unity-gtk-module": [[18, "unity-gtk-module"]], "libappmenu-gtk2-parser and libappmenu-gtk3-parser": [[18, "libappmenu-gtk2-parser-and-libappmenu-gtk3-parser"]], "libdbusmenu-glib": [[18, "libdbusmenu-glib"]], "libdbusmenu-gtk3": [[18, "libdbusmenu-gtk3"]], "libdbusmenu-qt5": [[18, "libdbusmenu-qt5"]], "Kf5 Appmenu Plugin": [[18, "kf5-appmenu-plugin"]], "Kf5 Plasma Applet Appmenu Plugin": [[18, "kf5-plasma-applet-appmenu-plugin"]], "Kf5 Plasma Private libappmenuplugin": [[18, "kf5-plasma-private-libappmenuplugin"]], "wxGtk libwx_gtk3u_core": [[18, "wxgtk-libwx-gtk3u-core"]], "Files involved": [[18, "files-involved"]], "Environment variables involved": [[18, "environment-variables-involved"]], "GTK_MODULES=appmenu-gtk-module": [[18, "gtk-modules-appmenu-gtk-module"]], "UBUNTU_MENUPROXY": [[18, "ubuntu-menuproxy"]], "Executables involved": [[18, "executables-involved"]], "Chromium, Chrome": [[18, "chromium-chrome"]], "Patches needed for Firefox and Thunderbird": [[18, "patches-needed-for-firefox-and-thunderbird"]], "GMenu-DBusMenu-Proxy": [[18, "gmenu-dbusmenu-proxy"]], "Debugging with Qt 5 D-Bus Viewer": [[18, "debugging-with-qt-5-d-bus-viewer"]], "Getting the menus for a Qt application knowing the Xorg window ID": [[18, "getting-the-menus-for-a-qt-application-knowing-the-xorg-window-id"]], "Getting the menus for a Gtk application": [[18, "getting-the-menus-for-a-gtk-application"]], "Limitations": [[18, "limitations"]], "Implementations for other desktop systems": [[18, "implementations-for-other-desktop-systems"]], "MIDI": [[19, "midi"]], "Using /dev/umidi*": [[19, "using-dev-umidi"]], "Testing": [[19, "testing"], [19, "id1"], [19, "id3"], [55, "testing"]], "Example application": [[19, "example-application"], [19, "id2"], [19, "id4"]], "Using OSS Raw-MIDI (Open Sound System)": [[19, "using-oss-raw-midi-open-sound-system"]], "Using alsa-seq-server": [[19, "using-alsa-seq-server"]], "Monkey Patching": [[20, "monkey-patching"]], "Creating the monkey patch volume": [[20, "creating-the-monkey-patch-volume"]], "Booting a Live ISO applying the monkey patch on-the-fly": [[20, "booting-a-live-iso-applying-the-monkey-patch-on-the-fly"]], "Example monkeypatch.sh file": [[20, "example-monkeypatch-sh-file"]], "Booting a Live ISO running a different init_script": [[20, "booting-a-live-iso-running-a-different-init-script"]], "Working with FreeBSD Ports": [[21, "working-with-freebsd-ports"]], "Pulling the ports tree": [[21, "pulling-the-ports-tree"]], "Building the port without changes": [[21, "building-the-port-without-changes"]], "Making changes to the port": [[21, "making-changes-to-the-port"]], "Making packages": [[21, "making-packages"]], "Creating a port from scratch": [[21, "creating-a-port-from-scratch"]], "Updating existing ports": [[21, "updating-existing-ports"]], "Working with Cirrus CI": [[21, "working-with-cirrus-ci"]], "Raspberry Pi": [[22, "raspberry-pi"]], "Prerequisites": [[22, "prerequisites"], [49, "prerequisites"], [51, "prerequisites"]], "Optional hardware": [[22, "optional-hardware"]], "Preparing an SD card": [[22, "preparing-an-sd-card"]], "Preparing a bootable SSD drive (optional but recommended)": [[22, "preparing-a-bootable-ssd-drive-optional-but-recommended"]], "Booting into the system": [[22, "booting-into-the-system"]], "Starting a graphical session": [[22, "starting-a-graphical-session"]], "Compiling and installing helloDesktop core components": [[22, "compiling-and-installing-hellodesktop-core-components"]], "Install prerequisites": [[22, "install-prerequisites"]], "launch": [[22, "launch"], [44, "launch"]], "QtPlugin": [[22, "qtplugin"]], "Icons and other assets": [[22, "icons-and-other-assets"]], "Installing required packages": [[22, "installing-required-packages"]], "Installing overlays": [[22, "installing-overlays"]], "Adjusting fstab": [[22, "adjusting-fstab"]], "Enabling D-Bus and Avahi": [[22, "enabling-d-bus-and-avahi"]], "Editing start-hello": [[22, "editing-start-hello"]], "Starting helloDesktop session": [[22, "starting-hellodesktop-session"]], "Adding a user": [[22, "adding-a-user"]], "Improving system performance": [[22, "improving-system-performance"]], "Setting up SWAP for greater system memory capabilities": [[22, "setting-up-swap-for-greater-system-memory-capabilities"]], "Overclocking your system": [[22, "overclocking-your-system"]], "Known issues": [[22, "known-issues"]], "Missing login window": [[22, "missing-login-window"]], "Web browser": [[22, "web-browser"]], "RAM compression": [[22, "ram-compression"]], "Missing icons": [[22, "missing-icons"]], "Specifications": [[23, "specifications"]], "Specifications embraced for use in helloSystem": [[23, "specifications-embraced-for-use-in-hellosystem"]], "Conventions developed for use in helloSystem": [[23, "conventions-developed-for-use-in-hellosystem"]], "Specifications with relevance for helloSystem": [[23, "specifications-with-relevance-for-hellosystem"]], "Tracing with DTrace/dtruss": [[24, "tracing-with-dtrace-dtruss"]], "User Experience Guidelines": [[25, "user-experience-guidelines"]], "Macintosh Human Interface Guidelines": [[25, "macintosh-human-interface-guidelines"]], "Using the global menu bar": [[25, "using-the-global-menu-bar"]], "Walker, N & Smelcer, 1990 (Superiority of the global menu bar)": [[25, "walker-n-smelcer-1990-superiority-of-the-global-menu-bar"]], "Avoiding hidden menus hamburger icons": [[25, "avoiding-hidden-menus-hamburger-icons"]], "Avoiding configuration options": [[25, "avoiding-configuration-options"]], "hello": [[26, "hello"]], "Reviewer Guide": [[27, "reviewer-guide"]], "Introduction": [[27, "introduction"]], "System Requirements": [[27, "system-requirements"]], "Installation": [[27, "installation"]], "User Interface": [[27, "user-interface"]], "Features": [[27, "features"]], "Particularities": [[27, "particularities"]], "Support": [[27, "support"]], "Getting to know the system": [[28, "getting-to-know-the-system"]], "Falkon": [[30, "falkon"]], "Search shortcuts": [[30, "search-shortcuts"]], "Search Engines": [[30, "search-engines"]], "Encyclopedia": [[30, "encyclopedia"]], "Computer related": [[30, "computer-related"]], "Automatic reloading of local pages": [[30, "automatic-reloading-of-local-pages"]], "Iridium": [[31, "iridium"]], "Autostart": [[32, "autostart"]], "Filesystems": [[33, "filesystems"]], "Boot Environments": [[35, "boot-environments"]], "Viewing Boot Environments": [[35, "viewing-boot-environments"]], "Creating Boot Environments": [[35, "creating-boot-environments"]], "Removing Boot Environments": [[35, "removing-boot-environments"]], "Mounting Boot Environments": [[35, "mounting-boot-environments"]], "Booting into a Boot Environment": [[35, "booting-into-a-boot-environment"]], "More Information": [[35, "more-information"]], "Desktop": [[36, "desktop"]], "Background": [[36, "background"], [44, "background"]], "Label Text": [[36, "label-text"]], "Advanced": [[36, "advanced"]], "Keyboard": [[37, "keyboard"]], "Setting the keyboard layout": [[37, "setting-the-keyboard-layout"]], "Selecting a physical key to act as \u2318 (command)": [[37, "selecting-a-physical-key-to-act-as-command"]], "Disabling the Caps Lock key": [[37, "disabling-the-caps-lock-key"]], "Sharing": [[38, "sharing"]], "Computer Name": [[38, "computer-name"]], "Remote Login": [[38, "remote-login"]], "Screen Sharing": [[38, "screen-sharing"]], "Accessing the screen of remote computers": [[38, "accessing-the-screen-of-remote-computers"]], "Accessing the screen of a remote computer that has Screen Sharing enabled": [[38, "accessing-the-screen-of-a-remote-computer-that-has-screen-sharing-enabled"]], "Accessing the screen of a remote computer that has Remote Login enabled": [[38, "accessing-the-screen-of-a-remote-computer-that-has-remote-login-enabled"]], "Shortcut Keys": [[39, "shortcut-keys"]], "The \u2318 key": [[39, "the-key"]], "Default shortcuts": [[39, "default-shortcuts"]], "Viewing shortcuts": [[39, "viewing-shortcuts"]], "Editing shortcuts": [[39, "editing-shortcuts"]], "Wireless Networks": [[40, "wireless-networks"]], "System components": [[41, "system-components"]], "Launching applications": [[42, "launching-applications"], [43, "launching-applications"], [45, "launching-applications"]], "Seeing running applications": [[42, "seeing-running-applications"]], "Keeping applications in the Dock": [[42, "keeping-applications-in-the-dock"]], "Making applications available to the system": [[43, "making-applications-available-to-the-system"]], "Removing applications": [[43, "removing-applications"]], "Accessing files on remote computers": [[43, "accessing-files-on-remote-computers"]], "Keyboard shortcuts": [[43, "keyboard-shortcuts"]], "Using the launch command": [[44, "using-the-launch-command"]], "Getting computer information": [[45, "getting-computer-information"]], "Managing windows": [[45, "managing-windows"]], "Shutting down": [[45, "shutting-down"]], "Searching in application menus": [[45, "searching-in-application-menus"]], "Searching for documents and folders on your computer": [[45, "searching-for-documents-and-folders-on-your-computer"]], "Opening folders at certain paths": [[45, "opening-folders-at-certain-paths"]], "Performing calculations": [[45, "performing-calculations"]], "Date and time": [[45, "date-and-time"]], "Calculator": [[47, "calculator"]], "Calendar": [[48, "calendar"]], "Create Live Media": [[49, "create-live-media"]], "Downloading and writing Live Media": [[49, "downloading-and-writing-live-media"]], "Hardware Probe": [[50, "hardware-probe"]], "Data Privacy": [[50, "data-privacy"]], "Install helloSystem": [[51, "install-hellosystem"]], "Installing helloSystem": [[51, "installing-hellosystem"]], "mountarchive": [[52, "mountarchive"]], "Remote Assistance": [[53, "remote-assistance"]], "Receiving Remote Assistance": [[53, "receiving-remote-assistance"]], "Giving Remote Assistance": [[53, "giving-remote-assistance"]], "About the Tox protocol": [[53, "about-the-tox-protocol"]], "Sticky Notes": [[54, "sticky-notes"]], "Update": [[55, "update"]], "Windows": [[56, "windows"]], "Traffic lights": [[56, "traffic-lights"]], "Resizing windows": [[56, "resizing-windows"]], "Providing feedback": [[57, "providing-feedback"]], "Sharing your experience": [[57, "sharing-your-experience"]], "Discussing ideas and wishlist items": [[57, "discussing-ideas-and-wishlist-items"]], "Discussion forum": [[57, "discussion-forum"]], "Getting started": [[58, "getting-started"]], "System requirements": [[58, "system-requirements"]], "Downloading": [[58, "downloading"]], "Creating Live Media": [[58, "creating-live-media"]], "Ventoy": [[58, "ventoy"]], "Tested hardware": [[58, "tested-hardware"]], "Networking hardware": [[58, "networking-hardware"]], "Virtualization environments": [[58, "virtualization-environments"]], "QEMU": [[58, "qemu"]], "Parallels": [[58, "parallels"]], "Proxmox VE": [[58, "proxmox-ve"]], "VMware Workstation": [[58, "vmware-workstation"]], "Installation issue": [[58, null]], "Notable issues": [[59, "notable-issues"]], "FreeBSD logo on screen for more than five minutes": [[59, "freebsd-logo-on-screen-for-more-than-five-minutes"]], "Boot stalls with black screen": [[59, "boot-stalls-with-black-screen"]], "login: prompt, no desktop environment": [[59, "login-prompt-no-desktop-environment"]], "Debugging application issues": [[59, "debugging-application-issues"]], "Other issues": [[59, "other-issues"]], "Getting help": [[59, "getting-help"]]}, "indexentries": {}}) \ No newline at end of file diff --git a/user/components.html b/user/components.html new file mode 100644 index 00000000..6f167c94 --- /dev/null +++ b/user/components.html @@ -0,0 +1,200 @@ + + + + + + Getting to know the system — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Getting to know the system

+

helloSystem consists of the following key components, each of which are described in this section:

+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/applications.html b/user/components/applications.html new file mode 100644 index 00000000..15ad9160 --- /dev/null +++ b/user/components/applications.html @@ -0,0 +1,174 @@ + + + + + + Applications — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Applications

+

Most applications in helloSystem come in the form of application bundles. An application bundle is an application that looks and behaves like a file but is actually a directory, containing not only the application but also auxiliary files such as icons and other resources. To view the contents of an application bundle, right-click on it and select “Show Contents”. This is useful especially for open source applications written in languages such as PyQt5, because you can interactively edit the source code and test your changes.

+

Viewing the contents of an application bundle

+

helloSystem comes with some applications out of the box, and some applications need to be downloaded before they can be used.

+

You find the applications in the menu under “System -> Applications”, and in the /Applications folder on your hard disk, although they can also be placed in other locations if you so desire.

+ +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/applications/falkon.html b/user/components/applications/falkon.html new file mode 100644 index 00000000..35ba04ef --- /dev/null +++ b/user/components/applications/falkon.html @@ -0,0 +1,199 @@ + + + + + + Falkon — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ +
+

Falkon

+

Falkon is the web browser that comes with helloSystem by default.

+
+

Search shortcuts

+

The following search shortcuts have been predefined:

+
+

Search Engines

+
    +
  • g: Search Google. Example: g Frankfurt

  • +
  • d: Search DuckDuckGo. Example: d München

  • +
  • sp: Search StartPage. Example: sp Hamburg

  • +
+
+
+

Encyclopedia

+
    +
  • w: Search Wikipedia. Example: w Stuttgart

  • +
+
+ +
+
+

Automatic reloading of local pages

+

Falkon automatically refreshes the page when a local HTML document is changed. +This makes it ideal for dynamically previewing locally edited HTML pages.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/applications/iridium.html b/user/components/applications/iridium.html new file mode 100644 index 00000000..09b79763 --- /dev/null +++ b/user/components/applications/iridium.html @@ -0,0 +1,169 @@ + + + + + + Iridium — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ +
+

Iridium

+

Iridium is an optional web browser that can be used on helloSystem. It is based on the Chromium browser.

+

Upon first start of the Iridium browser, the following extensions are automatically installed from https://chrome.google.com/webstore/ to increase privacy and convenience:

+ +

You can uninstall those extensions at any time from within Iridium.

+

If you would like Iridium not to install those extensions from the Chrome Web Store in the first place, remove the files in /usr/local/share/iridium/extensions/*.json prior to launching Iridium for the first time.

+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/autostart.html b/user/components/autostart.html new file mode 100644 index 00000000..e77b1c18 --- /dev/null +++ b/user/components/autostart.html @@ -0,0 +1,162 @@ + + + + + + Autostart — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Autostart

+

The Autostart mechanism provides an easy way to automatically start applications whenever the computer is started (to be precise, when a user is logged into a graphical desktop session). Applications can be either .app bundles or .AppDir directories.

+
    +
  • System-wide autostart: Place applications (or symlinks to applications) into the /Applications/Autostart folder to have them started for all users of the computer

  • +
  • ~Per-user autostart: Place applications (or symlinks to applications) into the ~/Applications/Autostart folder (in your home folder) to have them started for all users of the computer. You can create the folder if it does not exist yet~

  • +
+

The launch command is invoked for each of those applications and launches the applications.

+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/filesystems.html b/user/components/filesystems.html new file mode 100644 index 00000000..79a1567b --- /dev/null +++ b/user/components/filesystems.html @@ -0,0 +1,167 @@ + + + + + + Filesystems — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Filesystems

+

helloSystem uses the OpenZFS for the boot disk.

+

Additionally, the following filesystems are supported in helloSystem, but it cannot be started from those:

+
    +
  • exFAT (Windows) once available in quarterly packages

  • +
  • NTFS (Windows; read-write support)

  • +
  • EXT4 (Linux) once available in quarterly packages

  • +
  • HFS+ (Macintosh)

  • +
  • XFS (SGI)

  • +
+

Supported filesystems are automatically mounted by automount.

+

To see how they are mounted, open the Logs utility and attach a disk.

+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/preferences.html b/user/components/preferences.html new file mode 100644 index 00000000..259f21a0 --- /dev/null +++ b/user/components/preferences.html @@ -0,0 +1,207 @@ + + + + + + Preferences — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + +
+
+ + + + \ No newline at end of file diff --git a/user/components/preferences/boot-environments.html b/user/components/preferences/boot-environments.html new file mode 100644 index 00000000..aa7817cb --- /dev/null +++ b/user/components/preferences/boot-environments.html @@ -0,0 +1,213 @@ + + + + + + Boot Environments — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Boot Environments

+

Boot Environments are bootable clones of snapshots of the working system. Boot Environments allow you to create a safe fallback Boot Environment before upgrading or making major changes to the system.

+

Other applications may create Boot Environments automatically before performing critical operations such as major operating system upgrades.

+
+

Warning

+

Boot Environments by default do not cover all locations, such as /home where your personal data is usually stored.

+
+

The Boot Environments preferences application lets you view, create, remove, mount, and boot into Boot Environments.

+
+

Note

+

Boot Environments functionality cannot be used when the system is running from Live media. It can only be used when the system has been installed to a disk.

+
+
+

Viewing Boot Environments

+

Open the Boot Environments preferences application. If you have a user password set, you will be asked to enter your credentials. Only users in the administrative group (wheel) can use the Boot Environments application by default.

+

You will see the available Boot Environments.

+
+
+

Creating Boot Environments

+

To create a new Boot Environment, click New… and enter a name for the new Boot Environment.

+
+
+

Removing Boot Environments

+

Select a Boot Environment by clicking on it, and then press Remove. Note that you cannot remove the currently active Boot Environment.

+
+
+

Mounting Boot Environments

+

You can make available, or “mount”, existing Boot Environments, e.g., in order to inspect them or to copy files from there.

+

To do this, select a Boot Environment by clicking on it, and then press Mount. Note that you cannot mount the currently active Boot Environment since it is already mounted at /.

+

The selected Boot Environment will be mounted, and a Filer window will be opened at the mountpoint of the Boot Environment.

+
+
+

Booting into a Boot Environment

+

Activate a Boot Environment by checking its checkbox, and then press Restart…. The computer will restart into the selected Boot Environment.

+

You can also select which Boot Environment to start into from the bootloader. Starting with helloSystem 0.8.1, press the press the Backsapce key on your keyboard as soon as the screen becomes grey. Then use the FreeBSD bootloader menu to choose a Boot Environment and to start the system. Note that choosing a Boot Environment this way does not change the default Boot Environment, and will affect the current boot only.

+
+
+

More Information

+

Advanced users can use the bectl command on the command line, which the Boot Environments preferences application is using under the hood.

+

For more information regarding Boot Environments, please refer to the ZFS Boot Environments presentation by Sławomir Wojciech Wojtczak.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/preferences/desktop.html b/user/components/preferences/desktop.html new file mode 100644 index 00000000..ba3bacc1 --- /dev/null +++ b/user/components/preferences/desktop.html @@ -0,0 +1,183 @@ + + + + + + Desktop — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ +
+

Desktop

+

The Desktop preferences application allows you to customize the behavior of your computer’s desktop.

+
+

Background

+

In this section of the Desktop preferences application, you can select a background color and an optional background image. If an image is selected, you can choose how it should be scaled on the screen.

+
+
+

Label Text

+

In this section of the Desktop preferences application, you can select a font and color for the text beneath icons on the desktop.

+
+
+

Advanced

+

Under the advanced tab of the Desktop preferences application, advanced users can adjust additional aspects of the behavior of the desktop. Most users should leave the defaults. This tab may go away in a future version.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/preferences/keyboard.html b/user/components/preferences/keyboard.html new file mode 100644 index 00000000..626215bc --- /dev/null +++ b/user/components/preferences/keyboard.html @@ -0,0 +1,190 @@ + + + + + + Keyboard — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ +
+

Keyboard

+

The Keyboard preferences application lets you change the keyboard layout (language) of your attached keyboard, and allows you to set which physical key should act as your ⌘ (command) key. It also lets you disable the Caps Lock key.

+
+

Note

+

The keyboard layout (language) gets set automatically during system startup if an official Raspberry Pi keyboard is attached or the system is running on Macintosh hardware, which has the prev-lang:kbd EFI key set.

+
+
+

Setting the keyboard layout

+

Simply click on a language (keyboard layout). The change is effective immediately.

+
+
+

Selecting a physical key to act as ⌘ (command)

+

Swapping the keys will result in the key left from the spacebar to act as the ⌘ (command) key (like switchers from the Mac would expect) and therefore is the default.

+

If a PC keyboard is attached, you can select the Use the Alt key as ⌘ checkbox. This will swap the Ctrl and Alt keys.

+

If an Apple keyboard is attached, you can select the Use the ⌘ key for menu shortcuts checkbox. This will swap the alt ⌥ and cmd ⌘ keys.

+

If you prefer the keys not be swapped, simply uncheck the respective checkbox. The change is effective immediately.

+
+
+

Disabling the Caps Lock key

+

You can select the “Disable the Caps Lock key” checkbox. This will disable the Caps Lock key. The change is effective immediately.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/preferences/sharing.html b/user/components/preferences/sharing.html new file mode 100644 index 00000000..972485fe --- /dev/null +++ b/user/components/preferences/sharing.html @@ -0,0 +1,213 @@ + + + + + + Sharing — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ +
+

Sharing

+

The Sharing preferences application lets you make your computer accessible from the network.

+

Sharing.app

+
+

Computer Name

+

The Computer Name (hostname) is displayed. You can change it. Changes in the Computer Name will take effect upon restarting the computer.

+
+
+

Remote Login

+

Check the Remote Login checkbox to make your computer accessible over ssh.

+
+
+

Screen Sharing

+

Check the Screen Sharing checkbox to make the screen of your computer accessible through VNC over ssh and advertise it on the network. This allows another user who has an account on your computer to view the screen, and to control the computer as if they were sitting in front of it. This can be helpful, e.g., for getting help from colleagues. The Screen Sharing checkbox will automatically be unchecked when the computer is restarted or after a connection has been made and has ended.

+
+
+

Accessing the screen of remote computers

+
+
+

Accessing the screen of a remote computer that has Screen Sharing enabled

+

If Screen Sharing is active on the remote computer, then you can use SSVNC (available for Windows, Mac OS X, and various Unix-like systems) to access the machine over the local area network.

+

In SSVNC please do:

+
    +
  • Under VNC Host_Display please enter: <IP Address>:0

  • +
  • Options… -> Check the Use SSH box and the Unix Username & Password box

  • +
  • Under Unix Username enter the username you have set when you installed helloSystem

  • +
  • Under Unix Password enter the password you have set when you installed helloSystem

  • +
+
+
+

Accessing the screen of a remote computer that has Remote Login enabled

+

If Screen Sharing is not active but Remote Login is active on the remote computer, then you can connect over the local area network and enable Screen Sharing as follows. Replace user with your username on the remote computer, and FreeBSD.local. with the hostname of the remote computer:

+
$ ssh -t -L 5900:localhost:5900 user@FreeBSD.local. 'x11vnc -display :0 -auth /home/user/.Xauthority -once -localhost'
+
+
+

Log into the remote computer. Then start the Remote Desktop client as follows:

+
$ ssvncviewer localhost
+
+
+

You should now be able to see and operate the screen.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/preferences/shortcuts.html b/user/components/preferences/shortcuts.html new file mode 100644 index 00000000..7cd067b9 --- /dev/null +++ b/user/components/preferences/shortcuts.html @@ -0,0 +1,217 @@ + + + + + + Shortcut Keys — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Shortcut Keys

+
+

Note

+

The Shortcut Keys preferences application has been removed following the switch to KWin, which comes with kglobalaccel. This area still needs work.

+
+

The Shortcut Keys preferences application lets you view and edit system-wide keyboard shortcuts.

+
+

Note

+

The left Ctrl and Alt keys are swapped in helloSystem by default to make shortcuts feel welcoming to switchers coming from the Mac.

+
+

A shortcut is a key or key combination you can press to invoke a defined action on your computer. Shortcuts can be defined by applications (per-application shortcuts), or can affect the whole system (system-wide shortcuts).

+
+

Note

+

The Shortcut Keys preferences application lets you view and edit system-wide keyboard shortcuts only, not per-application shortcuts. Some applications contain similar functionality inside the respective application to view and edit per-application keyboard shortcuts.

+
+
+

The ⌘ key

+

The ⌘ key, also known as Command, is the key left to the spacebar on helloSystem, unless you have configured your system differently.

+
+

Note

+

Non-native software may refer to the Command key as “Ctrl”. This is a known cosmetic issue.

+
+
+
+

Default shortcuts

+

Open the Shortcut Keys preferences application to view the default system-wide shortcuts.

+

Notable default shortcuts include:

+
    +
  • Press ⌘ + Space to search in the Menu (e.g., to launch applications or to execute commands in the frontmost application)

  • +
  • Press Ctrl + ⌘ + Esc and click on an application window to forcefully quit an application that is malfunctioning

  • +
  • Press ⌘ + ⇧ + 3 or the PrtScn key on your keyboard to take a screenshot

  • +
  • Press ⌘ + ⇧ + H to go to the Home folder

  • +
  • Press ⌘ + ⇧ + A to go to the Applications folder

  • +
  • Press ⌘ + ⇧ + U to go to the Utilities folder

  • +
  • Press Ctrl + ⌘ + T to open a Terminal

  • +
  • Press Ctrl + ⌘ + I to open the internet browser

  • +
+

This list is not exhaustive.

+
+
+

Viewing shortcuts

+

For a complete list of system-wide shortcuts, please open the Shortcut Keys preferences application to view the default shortcuts.

+
+
+

Editing shortcuts

+

Use the buttons in the Shortcut Keys preferences application to add, remove, and modify system-wide shortcuts.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/preferences/wireless-networks.html b/user/components/preferences/wireless-networks.html new file mode 100644 index 00000000..99afc2c0 --- /dev/null +++ b/user/components/preferences/wireless-networks.html @@ -0,0 +1,171 @@ + + + + + + Wireless Networks — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Wireless Networks

+

The Wireless Networks preferences application lets you connect to wireless local area networks (WLANs).

+

It is possible to use more than one wireless network card.

+
+

Note

+

Please consider using the Hardware Probe utility in case your network card is not detected by the Wireless Networks preferences application.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/system.html b/user/components/system.html new file mode 100644 index 00000000..5f60e612 --- /dev/null +++ b/user/components/system.html @@ -0,0 +1,198 @@ + + + + + + System components — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ + +
+
+ + + + \ No newline at end of file diff --git a/user/components/system/dock.html b/user/components/system/dock.html new file mode 100644 index 00000000..9226b3af --- /dev/null +++ b/user/components/system/dock.html @@ -0,0 +1,183 @@ + + + + + + Dock — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ +
+

Dock

+

The Dock is a quick way to launch the most commonly used applications, and a way to see which applications are running at a glance.

+

It typically sits at the bottom of the screen.

+

As of helloSystem 0.8.0, the Dock is not started automatically anymore, but you can run it by double-clicking its icon in /System. You can also put a symlink into /Applications/Autostart if you like (sudo ln -s /System/Dock.app /Applications/Autostart/), or start it programmatically with launch Dock.

+
+

Launching applications

+

To launch an application, click on it in the Dock.

+
+
+

Seeing running applications

+

Running applications are marked with a dot below the application icon in the Dock.

+
+
+

Keeping applications in the Dock

+

To keep an application in the Dock even if it is not running, click on its icon in the Dock with the right mouse key, and select “Pin” from the context menu.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/system/filer.html b/user/components/system/filer.html new file mode 100644 index 00000000..61feb0b6 --- /dev/null +++ b/user/components/system/filer.html @@ -0,0 +1,212 @@ + + + + + + Filer — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ +
+

Filer

+

Filer is the application that you can use to manage objects like files, folders, and applications on your computer.

+

Filer can perform typical tasks of a file manager:

+
    +
  • Open files and folders

  • +
  • Create, move, and delete files and folders

  • +
+

In helloSystem, many tasks are done in the Filer that would require extra tools in other operating systems. For example, you can use the Filer to

+
    +
  • Launch applications (instead of using a dedicated launcher)

  • +
  • Make applications available to the system (instead of using a package manager or compiling from source)

  • +
  • Remove applications (instead of using a package manager)

  • +
  • Accessing files on remote computers (instead of using a dedicated application that can access files over ssh/sftp)

  • +
+
+

Launching applications

+

To launch an application, double-click it in Filer (you can also use the ⌘O shortcut to open an application, or press ⌘↓). In case you double-click on a binary that is lacking the execute permission, a dialog will ask you whether you would like to make the binary executable.

+
+
+

Making applications available to the system

+

Applications for helloSystem typically come as application bundles. An application bundle looks like a file but is actually stored as a directory on disk. To make an application available to the system, simply move or copy it to one of the well-known locations for applications, such as /Applications for system-wide applications, or ~/Applications (in your home directory) for per-user applications.

+

In addition to applications specifically offered for helloSystem, advanced users can use the tools provided by FreeBSD to compile applications from the ports tree, and/or to install FreeBSD packages.

+
+
+

Removing applications

+

To remove an application from the system, move it to the Trash.

+
+
+

Accessing files on remote computers

+

Computers on the local area network that are offering access via SFTP are automatically discovered and are shown in the “Network” area of Filer. Double-click on a network directory to access it. You will be asked to provide valid credentials (username, password) of an account on the remote computer. For this to work, computers need to provide SFTP services and announce them over dns-sd (Zeroconf, Bonjour).

+

It is also possible to access files on computers that are not on the local area network. To do so, enter sftp://hostname.tld in the address bar of Filer and press the Enter key.

+
+
+

Keyboard shortcuts

+

In addition to the shortcuts documented in the menus, the following shortcuts exist when Filer is running in Spatial Mode (which is the default on helloSystem):

+
    +
  • ⌘↓: Open the selected application, file, or folder

  • +
  • ⌘↑: Go up one folder

  • +
  • ⌘⇧O: Open the selected application, file, or folder, and close the current window

  • +
  • ⌘⇧↓: Open the selected application, file, or folder, and close the current window

  • +
  • ⌘⇧↑: Go up one folder, and close the current window

  • +
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/system/launch.html b/user/components/system/launch.html new file mode 100644 index 00000000..494a92ee --- /dev/null +++ b/user/components/system/launch.html @@ -0,0 +1,202 @@ + + + + + + launch — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ +
+

launch

+
+

“It’s not just what it looks like and feels like. Design is how it works.”

+

—Steve Jobs

+
+

The launch command is used to launch graphical applications on helloSystem. When you select an application from the Menu or the Dock, then the launch command is invoked to actually launch the application.

+
+

Hint

+

As an end user who is using the graphical user interface exclusively, you will not need to interact with the launch command directly and can skip this section.

+
+
+

Background

+

On UNIX systems, applications are typically launched by entering the name of the executable file, which is searched in a fixed list of directories determined by the $PATH environment variable.

+

Many graphical desktop environments use .desktop files to integrate applications with the system. While this has traditionally worked well for installed applications, it does not work well for dynamically changing applications that are moved in the filesystem, such as .app bundles or .AppDir directories. Also, it does not handle multiple versions of the same application gracefully. Hence, helloSystem uses the launch command to launch graphical applications. This has the following advantages:

+
    +
  • You do not need to know the path to the application to be launched, even if the application is not on the $PATH

  • +
  • If multiple versions of an application are available on the system, the most recent one will be launched automatically (unless specified otherwise by the user) (to be implemented)

  • +
  • If something goes wrong and the application cannot be launched, then a graphical error message will be shown on the screen

  • +
+

Graphical error message if something goes wrong

+
+
+

Using the launch command

+

Whenever possible, graphical applications should be launched through the launch command on helloSystem.

+

There are several ways in which the launch command can be invoked:

+
    +
  • launch /Applications/Filer.app

  • +
  • launch Filer.app

  • +
  • launch Filer

  • +
+

Note that capitalization can have subtle effects:

+
    +
  • launch audacity launches audacity from the $PATH if it exists anywhere on the $PATH

  • +
  • launch Audacity launches e.g., /Applications/Audio/Audacity.app/Audacity if it exists there or in other well-known application locations (because no Audacity exists anywhere on the $PATH)

  • +
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/system/menu.html b/user/components/system/menu.html new file mode 100644 index 00000000..88de1559 --- /dev/null +++ b/user/components/system/menu.html @@ -0,0 +1,224 @@ + + + + + + Menu — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ + + + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/utilities.html b/user/components/utilities.html new file mode 100644 index 00000000..bd5b586a --- /dev/null +++ b/user/components/utilities.html @@ -0,0 +1,200 @@ + + + + + + Utilities — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/utilities/calculator.html b/user/components/utilities/calculator.html new file mode 100644 index 00000000..af6f29c0 --- /dev/null +++ b/user/components/utilities/calculator.html @@ -0,0 +1,170 @@ + + + + + + Calculator — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/user/components/utilities/calendar.html b/user/components/utilities/calendar.html new file mode 100644 index 00000000..d5aed343 --- /dev/null +++ b/user/components/utilities/calendar.html @@ -0,0 +1,171 @@ + + + + + + Calendar — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/user/components/utilities/create-live-media.html b/user/components/utilities/create-live-media.html new file mode 100644 index 00000000..32e9efa5 --- /dev/null +++ b/user/components/utilities/create-live-media.html @@ -0,0 +1,200 @@ + + + + + + Create Live Media — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Create Live Media

+

A Live Medium is a storage device that can be used to start your computer with the helloSystem without having to install helloSystem to the internal storage of the computer. It allows you to try out helloSystem without making any changes to the software installed on your computer. Almost all functionality of helloSystem is available in Live mode, with very few exceptions. Changes being made, including files created, will be discarded when the system is shut down or restarted.

+

The Create Live Media utility provides an easy and convenient way to create bootable Live Media on devices such as USB sticks. It downloads and writes Live ISOs to devices in one go.

+

Create Live Media

+

This is useful if you are running helloSystem and would like to write a newer (or experimental) version of the system to a bootable storage device.

+
+

Prerequisites

+

In order to create a Live medium, you need

+
    +
  • A computer running any version of helloSystem with the Create Live Media utility

  • +
  • A fast internet connection (a typical download is around 2 GiB)

  • +
  • A suitable external storage device, e.g., a USB3 device. USB2 devices can be used but performance may be degraded. On some systems, other storage media such as SD cards or microSD cards can be used. Consult the documentation that came with your computer to determine which type of media can be used to start your computer.

  • +
+
+

Note

+

The Create Live Media utility cannot be used on other operating systems such as Windows, Linux, or macOS.

+

If you would like to create Live Media for helloSystem using one of those operating systems, you can use applications that can write images to USB storage devices, such as balenaEtcher.

+
+
+
+

Downloading and writing Live Media

+

The Create Live Media utility downloads and writes a Live ISO image in one go to a storage medium. Open the Create Live Media utility and follow the instructions on screen.

+
+

Warning

+

The Create Live Media utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device.

+

This operation cannot be undone.

+
+

Once the image has been written to the device successfully, you can restart your computer to start from the Live Medium, or remove the device and insert it into another computer to start that computer from the Live Medium.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/utilities/hardware-probe.html b/user/components/utilities/hardware-probe.html new file mode 100644 index 00000000..60da6969 --- /dev/null +++ b/user/components/utilities/hardware-probe.html @@ -0,0 +1,188 @@ + + + + + + Hardware Probe — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Hardware Probe

+

The Hardware Probe utility collects hardware details of your computer and can anonymously upload them to the public database at bsd-hardware.info.

+

+

This can help users and operating system developers to collaboratively debug hardware related issues, check for operating system compatibility and find drivers.

+

You will get a permanent probe URL to view and share collected information.

+
+

Data Privacy

+

The Hardware Probe utility can upload the hardware probe to the hardware database. The probe will be published publicly under a permanent URL to view the probe.

+

Private information (including the username, machine’s hostname, IP addresses, MAC addresses, UUIDs and serial numbers) is NOT uploaded to the database.

+

The tool uploads 32-byte prefix of salted SHA512 hash of MAC addresses/UUIDs and serial numbers to properly identify unique computers and hard drives. All the data is uploaded securely via HTTPS.

+
+

Note

+

By using this utility to upload your hardware probe, you agree that information about your hardware will be uploaded to a publicly visible database.

+

Do not use this utility if you do not agree with this.

+
+

By uploading your hardware probe you confirm uploading of 32-byte prefix of salted SHA512 hash of MAC addresses and serial numbers to prevent duplication of computers in the database.

+

The web service and the database are operated by linux-hardware.org. The authors of the graphical Hardware Probe utility are not associated with the operator of the web service. Please contact https://linux-hardware.org/index.php?view=contacts in case of questions and in case you wish accidentally submitted probes to be removed from the database.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/utilities/install.html b/user/components/utilities/install.html new file mode 100644 index 00000000..6042ecfe --- /dev/null +++ b/user/components/utilities/install.html @@ -0,0 +1,212 @@ + + + + + + Install helloSystem — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Install helloSystem

+

Once you have tried out helloSystem from the live medium, you may want to install the system to the hard disk in your computer, or an externally attached storage device.

+

The __Install helloSystem utility lets you install helloSystem on your computer from a running Live system.

+
+

Note

+

The utility is called Install helloSystem to signify that helloSystem contains a largely unmodified FreeBSD core operating system. It might be renamed “Install helloSystem” in the future.

+
+

Install FreeBSD

+

When you install helloSystem using the __Install helloSystem utility, the installed system will behave like the Live system in most aspects.

+
+

Prerequisites

+
    +
  • A bootable helloSystem Live Medium

  • +
  • A computer capable of starting from the Live Medium

  • +
  • An internal or external storage device with 8 GB of storage space. More space is highly recommended to allow for adding applications and documents

  • +
+
+
+

Installing helloSystem

+

Start your computer from a helloSystem Live Medium. Open the __Install helloSystem utility and follow the instructions on screen.

+

The installer starts by presenting a summary. Click on “Continue”. To install the software, you must agree to the terms of the software license agreement. Click on “Continue” to proceed. Click on a destination disk on which the operating system should be installed. A warning will inform you that the entire disk will be erased. Confirm whether you want to do this by clicking on the appropriate button.

+
+

Warning

+

The Install helloSystem utility will overwrite the entire contents of the selected device, including all of its pre-existing partitions. Take extra caution when selecting the target device.

+

This operation cannot be undone.

+
+

If you are really sure that you have selected the correct device, click “Continue”.

+

In the next step, you will create an account for the main user of the computer. The information entered here is used to identify the main user of the computer. This user will have administrative permissions (will be member of the wheel group).

+
    +
  • In the field Full Name, enter your first name(s), followed by a blank, followed by your last name. Example: John Doe. This field can be left blank if you prefer not to provide your full name

  • +
  • The field Username will be automatically populated with a suggested username. It must not contain any special characters such as blanks. You can override the suggested default if you like. Example: jdoe

  • +
  • Enter a password into the Password field. Repeat the same password in the Retype Password field. These fields can be left blank if you prefer not to use a password, but this will mean that anyone with access to your computer will be able to log in, and you will not be able to log in over the network

  • +
  • The field Computer Name will be automatically populated with a suggested computer name (hostname). This name will be used to identify your computer on the local area network. It must not contain any special characters such as blanks. You can override the suggested default if you like. Example: Johns-TravelMate-B117-M

  • +
  • Check the checkbox Enable users to log in over the network (ssh) if you would like to allow accessing the computer remotely. By default, this requires a password to be set for the computer account

  • +
  • Check the checkbox Set time zone based on current location if you would like timezone on the installed system to be set automatically. This feature requires an active internet connection

  • +
  • Check the checkbox Disable swap (recommended for USB sticks and SD cards) if you are installing the operating system to a medium on which no swap space should be used. This may be advisable on small system disks, and when installing to slower flash based media such as USB sticks and SD cards

  • +
+

Click “Continue” to proceed. The system will be installed to the selected disk. This process typically takes a couple of minutes depending on your system configuration, during which a progress bar will be shown.

+

You can click on “Installer Log” at any time to see a detailed log of the actions performed by the installer and details on any possible errors.

+

Once the installation has completed, remove the Live medium from your computer and click the “Restart” button to start the newly installed system.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/utilities/mountarchive.html b/user/components/utilities/mountarchive.html new file mode 100644 index 00000000..1beae607 --- /dev/null +++ b/user/components/utilities/mountarchive.html @@ -0,0 +1,170 @@ + + + + + + mountarchive — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

mountarchive

+

The mountarchive tool makes archives (like .zip, .tar.gz, and .tar.bz2 accessible in the Filer without having to extract them.

+

For example, if you double-click a zip file called plugin.video.invidious-0.5.3.zip on your desktop, it will be mounted and a Filer window will be opened at its mountpoint, e.g., /var/run/user/1001/_home_user_Desktop_plugin.video.invidious-0.5.3.zip.

+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/utilities/remote-assistance.html b/user/components/utilities/remote-assistance.html new file mode 100644 index 00000000..1ea56b23 --- /dev/null +++ b/user/components/utilities/remote-assistance.html @@ -0,0 +1,192 @@ + + + + + + Remote Assistance — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Remote Assistance

+

The Remote Assistance utility allows a peer on the Internet to access and control your computer using the encrypted peer-to-peer Tox protocol. This can be helpful, e.g., to receive help from a friend.

+
+

Warning

+

Running the Remote Assistance utility will give your peer access to the screen, mouse, and keyboard of your computer, and read-write to any ports that may be open on your machine. Only share the ID with people you trust.

+
+
+

Receiving Remote Assistance

+

To get help form a peer, open the Remote Assistance utility. Once a connection has been made, a long string (the ID) is shown on the screen. This string has also been copied to the clipboard. Give that string to your remote peer, e.g., by pasting it into a mail or chat window.

+

Once your peer has successfully connected, they will be able to see and operate anything on your screen, and to connect to any ports that may be open on your machine.

+
+
+

Giving Remote Assistance

+

As the remote peer (the person providing help), open the Remote Assistance utility, and select “Give Assistance” from the File menu. Paste the long string (the ID) you received into the text box and click “Connect”.

+

Once the connection has been made, you will be able to see and operate the screen of the other machine.

+
+
+

About the Tox protocol

+

The Remote Assistance application uses the Tox protocol to tunnel traffic. Tox is a peer-to-peer protocol that offers end-to-end encryption. The stated goal of the project is to provide secure yet easily accessible communication for everyone.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/utilities/sticky-notes.html b/user/components/utilities/sticky-notes.html new file mode 100644 index 00000000..7c77fc11 --- /dev/null +++ b/user/components/utilities/sticky-notes.html @@ -0,0 +1,170 @@ + + + + + + Sticky Notes — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/user/components/utilities/update.html b/user/components/utilities/update.html new file mode 100644 index 00000000..c907e44c --- /dev/null +++ b/user/components/utilities/update.html @@ -0,0 +1,197 @@ + + + + + + Update — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+ +
+
+ +
+

Update

+

Once you have installed the system to the hard disk in your computer, or an externally attached storage device, you may want to keep it recent by running the Update utility from time to time.

+
+

Note

+

This utility is currently in Developer Preview status and is intended for developers and testers. Only use it if you have a backup of your system or if you are running on a test system that you can set up from scratch if needed.

+
+

This utility

+
    +
  • Creates a new Boot Environment (bootable partial snapshot). This is not a full replacement for a backup but should allow you to roll back to the state before the update, should something go wrong

  • +
  • Updates the FreeBSD operating system components (kernel and userland)

  • +
  • Updates all FreeBSD Packages

  • +
  • Currently does not update any applications that came with helloSystem as native application bundles

  • +
+

+
+

Testing

+

Please follow this exact procedure when testing the Update utility:

+
    +
  • Install a helloSystem 0.7.0 pre-release build to hard disk.

  • +
  • Open QTerminal and run sudo pkg lock --yes automount slim dejavu liberation-fonts-ttf. This step is important because otherwise the update will overwrite carefully crafted helloSystem customizations. (There may be more packages that need to be locked as well.)

  • +
  • Run the Update utility and follow the on-screen instructions.

  • +
  • Once the update has completed, restart your computer to make full use of the updated software.

  • +
  • Run the Boot Environments preferences application and check that there is a boot environment that you can switch back to in the case you are not satisfied with the updated system.

  • +
+

Please submit any problems you might be running into to this issue.

+

Thanks for testing the Update utility.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/components/windows.html b/user/components/windows.html new file mode 100644 index 00000000..a63ba662 --- /dev/null +++ b/user/components/windows.html @@ -0,0 +1,175 @@ + + + + + + Windows — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Windows

+

helloSystem provides a graphical desktop experience that should be familiar to users of existing desktop operating systems.

+
+

Traffic lights

+

Windows contain three buttons, called “traffic lights”:

+
    +
  • Red: Click this button to close the window

  • +
  • Yellow: Click this button to hide (minimize) the window. To make the window appear again, click on its icon in the Dock, or select “Unhide all” from the System menu

  • +
  • Green: Click this button to make the window use the full screen real estate available (maximize). Click this button again to resize the window to its previous size

  • +
+
+
+

Resizing windows

+

Place the mouse cursor in any edge of the window. The cursor will change. Click and drag the mouse to resize the window.

+

Alternatively, click in the window title with the right-hand mouse button and select “Resize” from the menu, then drag the mouse to resize the window.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/feedback.html b/user/feedback.html new file mode 100644 index 00000000..1263970c --- /dev/null +++ b/user/feedback.html @@ -0,0 +1,170 @@ + + + + + + Providing feedback — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Providing feedback

+
+

Sharing your experience

+

If you would share your experience with helloSystem on twitter, use the #helloSystem hashtag.

+
+
+

Discussing ideas and wishlist items

+

Please check https://github.com/helloSystem/hello first, including the wiki. Feel free to discuss ideas and wishlist items at https://github.com/helloSystem/hello/issues, but please do keep in mind that in order to achieve the intended goal of simplicity, the team needs to say “no” to most wishlist items that do not further that goal.

+
+
+

Discussion forum

+

Please see our GitHub Discussions and do not hesitate to post your ideas, questions, and show us what you are doing with helloSystem in th “Show&Tell” category.

+
+
+

Chat

+

You can meet other helloSystem users and developers in the #helloSystem Internet Relay Chat channel at irc.libera.chat.

+

Alternatively, you can join #helloSystem:matrix.org from any Matrix client (such as the Element web-based Matrix client). This Matrix channel is bridged to the IRC channel. Joining via Matrix has the advantage that you will see responses that you may have received while you were offline. So after asking a question, you can come back in a day or so to see if there were any responses.

+

In any case, please stay in the channel for a few days and do not expect to receive answers immediately, since we are all volunteers.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/getting-started.html b/user/getting-started.html new file mode 100644 index 00000000..b6f62146 --- /dev/null +++ b/user/getting-started.html @@ -0,0 +1,329 @@ + + + + + + Getting started — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Getting started

+
+

System requirements

+
    +
  • 2 GHz dual core Intel/AMD 64-bit processor

  • +
  • 2 GiB RAM system memory (4 GiB recommended; before 0.7.0: 4 GiB minimum)

  • +
  • VGA capable of 800x600 screen resolution (1024x768 or more recommended)

  • +
  • Either a CD/DVD drive or a USB port for booting the installer media

  • +
  • On non-Macintosh hardware, a Raspberry Pi Keyboard and Hub is recommended as it allows the keyboard and system language to be detected automatically if it is attached while the system is starting up. On Macintosh hardware, the prev-lang:kbd EFI variable is usually set and is used to detect the keyboard and system language. Note that the key left to the space bar is used as the Command key (Alt key on PC keyboards, Apple key on Apple keyboards).

  • +
+

Please refer to FreeBSD Hardware Compatibility for more information on individual components.

+
+
+

Downloading

+

The latest helloSystem release ISO image is available for download here:

+

GitHub release (latest by date)

+

Experimental and pre-release images are available for download here:

+

GitHub release (latest SemVer including pre-releases)

+
+

Important

+

Experimental images get built automatically whenever source code is committed. Not every build is tested. Builds marked as “Pre-Release” are strictly for developers, may be broken and may not even boot.

+
+
+
+

Creating Live Media

+

The ISO file needs to be written to a device, e.g., to a USB stick, in order to a computer being able to start from it. This will overwrite and destroy all data on that device.

+

If you are already running helloSystem, then you can use the built-in Create Live Media utility to download and write live media.

+

If you are not running helloSystem yet or would like to use the command line, the following command should work on all BSD flavors:

+
$ sudo dd if=<path to ISO file> of=/dev/daX bs=4m status=progress
+
+
+

On GNU-style systems (e.g., most Linux distributions), status=progress does not work and can be left away.

+
+
+

Ventoy

+

Ventoy is a tool that lets you boot the operating systems of multiple ISO files that are residing on the same disk, without the need to write the ISO to a physical device. Starting with version 1.0.62, Ventoy can boot helloSystem 0.7.0 and later.

+

If you are not running helloSystem yet, then please refer to the Ventoy documentation on how to create a bootable Ventoy disk (that you put your ISOs on) using Windows or Linux.

+

If you are already running helloSystem and would like to create a bootable Ventoy disk, please follow these steps instead since the Ventoy installation instructions since the Ventoy documentation only describes installation using Windows and Linux:

+

image

+
    +
  1. Run The Create Live Media utility in helloSystem

  2. +
  3. From the drop-down menu, select Ventoy. Select the latest version (at least 1.0.62), and create a Ventoy Live medium (a 1 GB USB stick is sufficient for this)

  4. +
  5. Boot from the Ventoy Live medium you just created, and use it to install Ventoy to a disk (a SSD with hundreds of GB of space is recommended if you want to store hundreds of different operating system ISOs)

  6. +
  7. At this point, you don’t need the Ventoy Live medium anymore (the 1 GB USB stick)

  8. +
  9. Put one or more helloSystem ISOs (and potentially ISOs of other operating systems supported by Ventoy) onto the Ventoy disk (the one with hundreds of GB of space)

  10. +
  11. Once a new version of Ventoy comes out, put the latest Ventoy Live ISO onto your Ventoy disk, just like any other operating system ISO. Boot it to update the Ventoy installation on the Ventoy disk itself (yes, it can update the disk it is running from)

  12. +
+
+
+

Tested hardware

+

hello is known to boot to a graphical desktop on the following machines. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. has not yet been tested systematically.

+

helloSystem developers currently have access to the following hardware:

+
    +
  • Framework Mainboard (11th Gen Intel® Core™)

  • +
  • Acer TravelMate B117

  • +
  • Acer Revo RL85

  • +
  • Dell Inc. OptiPlex 780

  • +
+

Please contact us if you would like to sponsor the project with a hardware donation. We are especially looking for Apple and Lenovo devices from the previous generations that should be available second-hand inexpensively.

+

To see Hardware Probes of systems running helloSystem, please see the helloSystem Hardware Database provided by bsd-hardware.info. It is reasonable to assume that every system listed there can at least successfully boot helloSystem. Auxiliary functionality such as wireless networking, sound over HDMI, sleep, graphics acceleration, etc. may or may not be working.

+
+

Networking hardware

+

Not all networking devices may be supported by FreeBSD yet. In those cases, you may want to consider using a USB based networking devices. helloSystem developers currently have access to the following USB based networking devices which are known to work:

+ +

Detailed information on #FreeBSD wireless network card compatibility is available at https://wiki.freebsd.org/dev.

+
+
+
+

Virtualization environments

+
+

Note

+

We recommend running helloSystem on real hardware (“bare metal”) if possible. This should give you the best possible performance and hardware support.

+
+

Users have reported success in running helloSystem in the following virtualization environments:

+
    +
  • VirtualBox host (on FreeBSD and on macOS), known to work in BIOS and EFI modes

  • +
  • VMware Workstation works in BIOS and EFI modes (see below)

  • +
  • QEMU host (on Linux), works in both BIOS and EFI modes (see below). Note that for acceptable performance, QEMU needs KVM which is currently not available on FreeBSD hosts yet

  • +
  • Parallels host, reported to work in EFI mode (see below)

  • +
  • Proxmox VE

  • +
+

Please note:

+
    +
  • The VM needs to be 64-bit

  • +
  • The VM needs at least 2 GB of RAM

  • +
  • The VM needs at least 2 CPU cores

  • +
  • The boot process takes longer than you might expect; boot in verbose mode to see the details

  • +
  • For best results set EFI/UEFI boot mode (not BIOS)

  • +
+

Please report back about the results on your virtualization environment.

+
+

QEMU

+

Create an 8 GiB (or larger) hello.img image file on which you can install the system:

+
$ pwd
+/home/user
+$ mkdir -p .qemu/hello
+$ fallocate -l $(( 8*1024*1024*1024 )) .qemu/hello/hello.img
+
+
+

Then, boot helloSystem:

+
$ qemu-system-x86_64 -machine type=q35,accel=kvm \
+-enable-kvm -cpu host -smp 2 -m 4096 \
+-device virtio-net,netdev=vmnic -netdev user,id=vmnic,hostfwd=tcp::5222-:22 \
+-vga std -soundhw hda -no-quit \
+-drive format=raw,file=${HOME}/.qemu/hello/hello.img \
+-drive format=raw,file=${HOME}/Downloads/hello-0.4.0_0D26-FreeBSD-12.1-amd64.iso \
+-boot menu=on
+
+
+

When QEMU starts, press esc and select 2 to boot the ISO.

+

Use the Install FreeBSD utility (System -> Applications -> Utilities -> Install FreeBSD) to install helloSystem to the disk image.

+

Then restart QEMU, you now remove the last two options from the above command.

+

Notes

+
    +
  • The hostfwd= option creates a port forward from your host port 5222 to the Qemu VM port 22.

  • +
  • Unfortunately the qemu-system-x86_64 USB tablet options do not work; you will need to press Ctrl+Alt+g to release the mouse pointer from the QEMU window

  • +
  • To make QEMU full screen, press Ctrl+Alt+F

  • +
+

To boot/install hello in UEFI mode, first install OVMF Open Virtual Machine Firmware on your host side. The package name for Fedora 32 is edk2-ovmf

+

Then add these two qemu-system-x86_64 options:

+
-bios /usr/share/edk2/ovmf/OVMF_CODE.fd \
+-smbios type=0,vendor=0vendor,version=0version,date=0date,release=0.0,uefi=on \
+
+
+
+
+

Parallels

+
    +
  • Select Hardware > Boot Order.

  • +
  • Expand Advanced Settings. Set BIOS to “EFI 64-bit” and in the Boot flags field, enter vm.bios.efi=1.

  • +
+

Screenshot

+
+
+

Proxmox VE

+
    +
  • Memory: 4GB (not ballooned)

  • +
  • Processors: 2 (1 socket 2 cores)

  • +
  • BIOS: OVMF (UEFI)

  • +
  • Display: Default (VGA)

  • +
  • Machine: q35

  • +
  • SATA Controller: VirtIO SATA for attaching virtual disk to (to install the system on)

  • +
  • CD Drive: helloSystem ISO

  • +
  • Hard Disk: At least 8GB Raw

  • +
  • Network Device: VirtIO

  • +
+

To set resolution, press F2 at boot to access OVMF settings. Select ‘Device Manager > OVMF Platform Configuration > Change Preferred’, save and reboot.

+
+
+

VMware Workstation

+

Tested on VMware Workstation 16.2.1

+
+

Installation issue

+

For best results while installing, please set your CPU to 1 socket, and no more than 4 cores

+

After installation, you can set the CPU socket and core count to your desire.

+
+
    +
  • Memory: 4GB

  • +
  • Processors: 4 (1 socket, 4 cores)

  • +
  • Hard Disk: At least 8GB

  • +
  • Guest Operating System Version: FreeBSD 12 64-bit

  • +
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/user/troubleshooting.html b/user/troubleshooting.html new file mode 100644 index 00000000..c51fe93b --- /dev/null +++ b/user/troubleshooting.html @@ -0,0 +1,216 @@ + + + + + + Troubleshooting — helloSystem documentation + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Troubleshooting

+
+

Notable issues

+
+

FreeBSD logo on screen for more than five minutes

+

It can take up to five minutes to start the system in Live mode. If you see the FreeBSD logo on screen for more than five minutes, then something might be wrong and you might need to restart the computer.

+

If – after five minutes – you’re reluctant to stop the computer, you can occasionally key Ctrl-T to get some information about what the computer is doing. If there is no change from one snippet to the next, across three or more snippets, you may reasonably assume that the computer needs to be restarted.

+
    +
  • Please restart the computer. If normal use of the power button is not effective, press and hold.

  • +
  • Then, please start the computer in verbose mode to see any relevant error messages that may help in resolving the issue.

  • +
+
+
+

Boot stalls with black screen

+

This means that Xorg has been started but for some reason the login manager slim or the helloDesktop startup script start-hello cannot run.

+
    +
  • Boot in verbose mode

  • +
  • Press Ctrl+Alt+F2

  • +
  • Log in

  • +
  • sudo killall Xorg

  • +
  • sudo service dbus restart

  • +
  • sudo service slim restart

  • +
+

If this does not work:

+
    +
  • sudo killall Xorg

  • +
  • startx

  • +
  • In XTerm, sudo liveuser (or the username you chose)

  • +
  • start-hello

  • +
+
+
+

login: prompt, no desktop environment

+
    +
  • Please make sure that your computer has at least 4GB of RAM. helloSystem currently needs at least this amount to be started in Live mode.

  • +
  • The graphics hardware in your computer may not yet, or not yet easily, be usable with helloSystem. Try with a different computer, or seek help.

  • +
+
+
+
+

Debugging application issues

+

When debugging application issues, it can be helpful to see what an application is actually doing. For example, if we are interested in which libraries with “menu” in their name firefox is loading, we can run

+
$ LD_DEBUG=libs firefox 2>&1 | grep -i menu
+
+
+

Or, if we are interested in which activities with “menu” in their name firefox is doing, we can run

+
$ sudo sysctl security.bsd.unprivileged_proc_debug=1
+$ truss firefox 2>&1 | grep -e menu 
+
+
+
+
+

Other issues

+

Use the Search or jump to… field at the head of the main https://github.com/helloSystem/ page – above the helloSystem logo. This special page allows an organisation-wide search, across all helloSystem repositories. Click in the field, then begin typing.

+

If your issue is not already reported, you can create a new one.

+
+
+

Getting help

+

Please participate in our discussion forum or contact us.

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file