public/icons/*your_scraper_name*/ directory:\n - [ ] `16.png`: a 16×16 pixel icon for the doc\n - [ ] `16@2x.png`: a 32×32 pixel icon for the doc\n - [ ] `SOURCE`: A text file containing the URL to the page the image can be found on or the URL of the original image itself\n\n\n\n\nIf you're updating existing documentation to its latest version, please ensure that you have:\n\n- [ ] Updated the versions and releases in the scraper file\n- [ ] Ensured the license is up-to-date\n- [ ] Ensured the icons and the `SOURCE` file in public/icons/*your_scraper_name*/ are up-to-date if the documentation has a custom icon\n- [ ] Ensured `self.links` contains up-to-date urls if `self.links` is defined\n- [ ] Tested the changes locally to ensure:\n - The scraper still works without errors\n - The scraped documentation still looks consistent with the rest of DevDocs\n - The categorization of entries is still good\n"
},
{
"path": ".github/no-response.yml",
"content": "daysUntilClose: 30\nresponseRequiredLabel: needs-info\ncloseComment: >\n This issue has been automatically closed because there has been no response\n to our request for more information from the original author. With only the\n information that’s currently in the issue, we don’t have enough information\n to take action. Please comment if you have or find the answer we need so we\n can investigate further.\n"
},
{
"path": ".github/workflows/build.yml",
"content": "name: Deploy\n\non:\n push:\n branches:\n - main\n\njobs:\n deploy:\n name: Deploy to Heroku\n runs-on: ubuntu-24.04\n if: github.repository == 'freeCodeCamp/devdocs'\n steps:\n - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2.7.0\n - name: Set up Ruby\n uses: ruby/setup-ruby@09a7688d3b55cf0e976497ff046b70949eeaccfd # v1.288.0\n with:\n bundler-cache: true # runs 'bundle install' and caches installed gems automatically\n - name: Run tests\n run: bundle exec rake\n - name: Install Heroku CLI\n run: |\n curl https://cli-assets.heroku.com/install.sh | sh\n - name: Deploy to Heroku\n uses: akhileshns/heroku-deploy@e3eb99d45a8e2ec5dca08735e089607befa4bf28 # v3.14.15\n with:\n heroku_api_key: ${{secrets.HEROKU_API_KEY}}\n heroku_app_name: \"devdocs\"\n heroku_email: \"team@freecodecamp.com\"\n dontuseforce: true # --force should never be necessary\n dontautocreate: true # The app exists, it should not be created\n"
},
{
"path": ".github/workflows/docker-build.yml",
"content": "name: Build and Push Docker Images\non:\n schedule:\n - cron: '0 0 1 * *' # Run monthly on the 1st\n workflow_dispatch: # Allow manual triggers\nenv:\n REGISTRY: ghcr.io\n IMAGE_NAME: ${{ github.repository }}\njobs:\n build-and-push:\n runs-on: ubuntu-latest\n permissions:\n contents: read\n packages: write\n strategy:\n matrix:\n variant:\n - name: regular\n file: Dockerfile\n suffix: ''\n - name: alpine\n file: Dockerfile-alpine\n suffix: '-alpine'\n\n steps:\n - name: Checkout repository\n uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4\n with:\n persist-credentials: false\n\n - name: Log in to the Container registry\n uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3\n with:\n registry: ${{ env.REGISTRY }}\n username: ${{ github.actor }}\n password: ${{ secrets.GITHUB_TOKEN }}\n\n - name: Extract metadata for Docker\n id: meta\n uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5\n with:\n images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}\n tags: |\n type=raw,value=latest${{ matrix.variant.suffix }}\n type=raw,value={{date 'YYYYMMDD'}}${{ matrix.variant.suffix }}\n\n - name: Build and push image\n uses: docker/build-push-action@ca052bb54ab0790a636c9b5f226502c73d547a25 # v5\n with:\n context: .\n file: ./${{ matrix.variant.file }}\n push: true\n tags: ${{ steps.meta.outputs.tags }}\n labels: ${{ steps.meta.outputs.labels }}\n"
},
{
"path": ".github/workflows/schedule-doc-report.yml",
"content": "name: Generate documentation versions report\non:\n schedule:\n - cron: '17 4 1 * *'\n workflow_dispatch:\n\njobs:\n report:\n runs-on: ubuntu-24.04\n if: github.repository == 'freeCodeCamp/devdocs'\n steps:\n - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2.7.0\n - name: Set up Ruby\n uses: ruby/setup-ruby@09a7688d3b55cf0e976497ff046b70949eeaccfd # v1.288.0\n with:\n bundler-cache: true # runs 'bundle install' and caches installed gems automatically\n - name: Generate report\n run: bundle exec thor updates:check --github-token ${{ secrets.DEVDOCS_BOT_PAT }} --upload\n"
},
{
"path": ".github/workflows/test.yml",
"content": "name: Ruby tests\n\non:\n pull_request:\n branches:\n - main\n\njobs:\n test:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1\n - name: Set up Ruby\n uses: ruby/setup-ruby@09a7688d3b55cf0e976497ff046b70949eeaccfd # v1.288.0\n with:\n bundler-cache: true # runs 'bundle install' and caches installed gems automatically\n - name: Run tests\n run: bundle exec rake\n"
},
{
"path": ".gitignore",
"content": ".DS_Store\n.bundle\nlog\ntmp\npublic/assets\npublic/fonts\npublic/docs/**/*\ndocs/**/*\n!docs/*.md\n/vendor\n*.tar\n*.tar.bz2\n*.tar.gz\n*.zip\nassets/stylesheets/components/_environment.scss\nassets/stylesheets/global/_icons.scss\n"
},
{
"path": ".image_optim.yml",
"content": "verbose: false\nskip_missing_workers: true\nallow_lossy: true\nthreads: 1\nadvpng: false\ngifsicle:\n interlace: false\n level: 3\n careful: true\njhead: false\njpegoptim:\n strip: all\n max_quality: 100\njpegrecompress: false\njpegtran: false\noptipng: false\npngcrush: false\npngout: false\npngquant:\n quality: !ruby/range 80..99\n speed: 3\nsvgo: false\n"
},
{
"path": ".ruby-version",
"content": "3.4.8\n"
},
{
"path": ".slugignore",
"content": "test\n"
},
{
"path": ".tool-versions",
"content": "ruby 3.4.8\n"
},
{
"path": "COPYRIGHT",
"content": "Copyright 2013-2026 Thibaut Courouble and other contributors\n\n This Source Code Form is subject to the terms of the Mozilla Public\n License, v. 2.0. If a copy of the MPL was not distributed with this\n file, You can obtain one at http://mozilla.org/MPL/2.0/.\n\nPlease do not use the name DevDocs to endorse or promote products\nderived from this software without the maintainers' permission, except\nas may be necessary to comply with the notice/attribution requirements.\n\nWe also wish that any documentation file generated using this software\nbe attributed to DevDocs. Let's be fair to all contributors by giving\ncredit where credit's due. Thanks.\n"
},
{
"path": "Dockerfile",
"content": "FROM ruby:3.4.7\nENV LANG=C.UTF-8\nENV ENABLE_SERVICE_WORKER=true\n\nWORKDIR /devdocs\n\nRUN apt-get update && \\\n apt-get -y install git nodejs libcurl4 && \\\n gem install bundler && \\\n rm -rf /var/lib/apt/lists/*\n\nCOPY Gemfile Gemfile.lock Rakefile /devdocs/\n\nRUN bundle config set path.system true && \\\n bundle install && \\\n rm -rf ~/.gem /root/.bundle/cache /usr/local/bundle/cache\n\nCOPY . /devdocs\n\nRUN thor docs:download --all && \\\n thor assets:compile && \\\n rm -rf /tmp\n\nEXPOSE 9292\nCMD rackup -o 0.0.0.0\n"
},
{
"path": "Dockerfile-alpine",
"content": "FROM ruby:3.4.7-alpine\n\nENV LANG=C.UTF-8\nENV ENABLE_SERVICE_WORKER=true\n\nWORKDIR /devdocs\n\nCOPY . /devdocs\n\nRUN apk --update add nodejs build-base libstdc++ gzip git zlib-dev libcurl && \\\n gem install bundler && \\\n bundle config set path.system true && \\\n bundle config set without 'test' && \\\n bundle install && \\\n thor docs:download --all && \\\n thor assets:compile && \\\n apk del gzip build-base git zlib-dev && \\\n rm -rf /var/cache/apk/* /tmp ~/.gem /root/.bundle/cache \\\n /usr/local/bundle/cache /usr/lib/node_modules\n\nEXPOSE 9292\nCMD rackup -o 0.0.0.0\n"
},
{
"path": "Gemfile",
"content": "source 'https://rubygems.org'\nruby '3.4.8'\n\ngem 'activesupport', require: false\ngem 'html-pipeline'\ngem 'nokogiri'\ngem 'pry-byebug'\ngem 'rake'\ngem 'terminal-table'\ngem 'thor'\ngem 'typhoeus'\ngem 'yajl-ruby', require: false\n\ngroup :app do\n gem 'browser'\n gem 'chunky_png'\n gem 'erubi'\n gem 'dartsass-sprockets'\n gem 'image_optim_pack', platforms: :ruby\n gem 'image_optim'\n gem 'rack-ssl-enforcer'\n gem 'rack'\n gem 'rss'\n gem 'sinatra-contrib'\n gem 'sinatra'\n gem 'sprockets-helpers'\n gem 'sprockets'\n gem 'thin'\nend\n\ngroup :production do\n gem 'newrelic_rpm'\n gem \"terser\"\nend\n\ngroup :development do\n gem 'better_errors'\nend\n\ngroup :docs do\n gem 'progress_bar', require: false\n gem 'redcarpet'\n gem 'tty-pager', require: false\n gem 'unix_utils', require: false\nend\n\ngroup :test do\n gem 'minitest'\n gem 'rack-test', require: false\n gem 'rr', require: false\nend\n\nif ENV['SELENIUM'] == '1'\n gem 'capybara'\n gem 'selenium-webdriver'\nend\n"
},
{
"path": "LICENSE",
"content": "Mozilla Public License Version 2.0\n==================================\n\n1. Definitions\n--------------\n\n1.1. \"Contributor\"\n means each individual or legal entity that creates, contributes to\n the creation of, or owns Covered Software.\n\n1.2. \"Contributor Version\"\n means the combination of the Contributions of others (if any) used\n by a Contributor and that particular Contributor's Contribution.\n\n1.3. \"Contribution\"\n means Covered Software of a particular Contributor.\n\n1.4. \"Covered Software\"\n means Source Code Form to which the initial Contributor has attached\n the notice in Exhibit A, the Executable Form of such Source Code\n Form, and Modifications of such Source Code Form, in each case\n including portions thereof.\n\n1.5. \"Incompatible With Secondary Licenses\"\n means\n\n (a) that the initial Contributor has attached the notice described\n in Exhibit B to the Covered Software; or\n\n (b) that the Covered Software was made available under the terms of\n version 1.1 or earlier of the License, but not also under the\n terms of a Secondary License.\n\n1.6. \"Executable Form\"\n means any form of the work other than Source Code Form.\n\n1.7. \"Larger Work\"\n means a work that combines Covered Software with other material, in\n a separate file or files, that is not Covered Software.\n\n1.8. \"License\"\n means this document.\n\n1.9. \"Licensable\"\n means having the right to grant, to the maximum extent possible,\n whether at the time of the initial grant or subsequently, any and\n all of the rights conveyed by this License.\n\n1.10. \"Modifications\"\n means any of the following:\n\n (a) any file in Source Code Form that results from an addition to,\n deletion from, or modification of the contents of Covered\n Software; or\n\n (b) any new file in Source Code Form that contains any Covered\n Software.\n\n1.11. \"Patent Claims\" of a Contributor\n means any patent claim(s), including without limitation, method,\n process, and apparatus claims, in any patent Licensable by such\n Contributor that would be infringed, but for the grant of the\n License, by the making, using, selling, offering for sale, having\n made, import, or transfer of either its Contributions or its\n Contributor Version.\n\n1.12. \"Secondary License\"\n means either the GNU General Public License, Version 2.0, the GNU\n Lesser General Public License, Version 2.1, the GNU Affero General\n Public License, Version 3.0, or any later versions of those\n licenses.\n\n1.13. \"Source Code Form\"\n means the form of the work preferred for making modifications.\n\n1.14. \"You\" (or \"Your\")\n means an individual or a legal entity exercising rights under this\n License. For legal entities, \"You\" includes any entity that\n controls, is controlled by, or is under common control with You. For\n purposes of this definition, \"control\" means (a) the power, direct\n or indirect, to cause the direction or management of such entity,\n whether by contract or otherwise, or (b) ownership of more than\n fifty percent (50%) of the outstanding shares or beneficial\n ownership of such entity.\n\n2. License Grants and Conditions\n--------------------------------\n\n2.1. Grants\n\nEach Contributor hereby grants You a world-wide, royalty-free,\nnon-exclusive license:\n\n(a) under intellectual property rights (other than patent or trademark)\n Licensable by such Contributor to use, reproduce, make available,\n modify, display, perform, distribute, and otherwise exploit its\n Contributions, either on an unmodified basis, with Modifications, or\n as part of a Larger Work; and\n\n(b) under Patent Claims of such Contributor to make, use, sell, offer\n for sale, have made, import, and otherwise transfer either its\n Contributions or its Contributor Version.\n\n2.2. Effective Date\n\nThe licenses granted in Section 2.1 with respect to any Contribution\nbecome effective for each Contribution on the date the Contributor first\ndistributes such Contribution.\n\n2.3. Limitations on Grant Scope\n\nThe licenses granted in this Section 2 are the only rights granted under\nthis License. No additional rights or licenses will be implied from the\ndistribution or licensing of Covered Software under this License.\nNotwithstanding Section 2.1(b) above, no patent license is granted by a\nContributor:\n\n(a) for any code that a Contributor has removed from Covered Software;\n or\n\n(b) for infringements caused by: (i) Your and any other third party's\n modifications of Covered Software, or (ii) the combination of its\n Contributions with other software (except as part of its Contributor\n Version); or\n\n(c) under Patent Claims infringed by Covered Software in the absence of\n its Contributions.\n\nThis License does not grant any rights in the trademarks, service marks,\nor logos of any Contributor (except as may be necessary to comply with\nthe notice requirements in Section 3.4).\n\n2.4. Subsequent Licenses\n\nNo Contributor makes additional grants as a result of Your choice to\ndistribute the Covered Software under a subsequent version of this\nLicense (see Section 10.2) or under the terms of a Secondary License (if\npermitted under the terms of Section 3.3).\n\n2.5. Representation\n\nEach Contributor represents that the Contributor believes its\nContributions are its original creation(s) or it has sufficient rights\nto grant the rights to its Contributions conveyed by this License.\n\n2.6. Fair Use\n\nThis License is not intended to limit any rights You have under\napplicable copyright doctrines of fair use, fair dealing, or other\nequivalents.\n\n2.7. Conditions\n\nSections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted\nin Section 2.1.\n\n3. Responsibilities\n-------------------\n\n3.1. Distribution of Source Form\n\nAll distribution of Covered Software in Source Code Form, including any\nModifications that You create or to which You contribute, must be under\nthe terms of this License. You must inform recipients that the Source\nCode Form of the Covered Software is governed by the terms of this\nLicense, and how they can obtain a copy of this License. You may not\nattempt to alter or restrict the recipients' rights in the Source Code\nForm.\n\n3.2. Distribution of Executable Form\n\nIf You distribute Covered Software in Executable Form then:\n\n(a) such Covered Software must also be made available in Source Code\n Form, as described in Section 3.1, and You must inform recipients of\n the Executable Form how they can obtain a copy of such Source Code\n Form by reasonable means in a timely manner, at a charge no more\n than the cost of distribution to the recipient; and\n\n(b) You may distribute such Executable Form under the terms of this\n License, or sublicense it under different terms, provided that the\n license for the Executable Form does not attempt to limit or alter\n the recipients' rights in the Source Code Form under this License.\n\n3.3. Distribution of a Larger Work\n\nYou may create and distribute a Larger Work under terms of Your choice,\nprovided that You also comply with the requirements of this License for\nthe Covered Software. If the Larger Work is a combination of Covered\nSoftware with a work governed by one or more Secondary Licenses, and the\nCovered Software is not Incompatible With Secondary Licenses, this\nLicense permits You to additionally distribute such Covered Software\nunder the terms of such Secondary License(s), so that the recipient of\nthe Larger Work may, at their option, further distribute the Covered\nSoftware under the terms of either this License or such Secondary\nLicense(s).\n\n3.4. Notices\n\nYou may not remove or alter the substance of any license notices\n(including copyright notices, patent notices, disclaimers of warranty,\nor limitations of liability) contained within the Source Code Form of\nthe Covered Software, except that You may alter any license notices to\nthe extent required to remedy known factual inaccuracies.\n\n3.5. Application of Additional Terms\n\nYou may choose to offer, and to charge a fee for, warranty, support,\nindemnity or liability obligations to one or more recipients of Covered\nSoftware. However, You may do so only on Your own behalf, and not on\nbehalf of any Contributor. You must make it absolutely clear that any\nsuch warranty, support, indemnity, or liability obligation is offered by\nYou alone, and You hereby agree to indemnify every Contributor for any\nliability incurred by such Contributor as a result of warranty, support,\nindemnity or liability terms You offer. You may include additional\ndisclaimers of warranty and limitations of liability specific to any\njurisdiction.\n\n4. Inability to Comply Due to Statute or Regulation\n---------------------------------------------------\n\nIf it is impossible for You to comply with any of the terms of this\nLicense with respect to some or all of the Covered Software due to\nstatute, judicial order, or regulation then You must: (a) comply with\nthe terms of this License to the maximum extent possible; and (b)\ndescribe the limitations and the code they affect. Such description must\nbe placed in a text file included with all distributions of the Covered\nSoftware under this License. Except to the extent prohibited by statute\nor regulation, such description must be sufficiently detailed for a\nrecipient of ordinary skill to be able to understand it.\n\n5. Termination\n--------------\n\n5.1. The rights granted under this License will terminate automatically\nif You fail to comply with any of its terms. However, if You become\ncompliant, then the rights granted under this License from a particular\nContributor are reinstated (a) provisionally, unless and until such\nContributor explicitly and finally terminates Your grants, and (b) on an\nongoing basis, if such Contributor fails to notify You of the\nnon-compliance by some reasonable means prior to 60 days after You have\ncome back into compliance. Moreover, Your grants from a particular\nContributor are reinstated on an ongoing basis if such Contributor\nnotifies You of the non-compliance by some reasonable means, this is the\nfirst time You have received notice of non-compliance with this License\nfrom such Contributor, and You become compliant prior to 30 days after\nYour receipt of the notice.\n\n5.2. If You initiate litigation against any entity by asserting a patent\ninfringement claim (excluding declaratory judgment actions,\ncounter-claims, and cross-claims) alleging that a Contributor Version\ndirectly or indirectly infringes any patent, then the rights granted to\nYou by any and all Contributors for the Covered Software under Section\n2.1 of this License shall terminate.\n\n5.3. In the event of termination under Sections 5.1 or 5.2 above, all\nend user license agreements (excluding distributors and resellers) which\nhave been validly granted by You or Your distributors under this License\nprior to termination shall survive termination.\n\n************************************************************************\n* *\n* 6. Disclaimer of Warranty *\n* ------------------------- *\n* *\n* Covered Software is provided under this License on an \"as is\" *\n* basis, without warranty of any kind, either expressed, implied, or *\n* statutory, including, without limitation, warranties that the *\n* Covered Software is free of defects, merchantable, fit for a *\n* particular purpose or non-infringing. The entire risk as to the *\n* quality and performance of the Covered Software is with You. *\n* Should any Covered Software prove defective in any respect, You *\n* (not any Contributor) assume the cost of any necessary servicing, *\n* repair, or correction. This disclaimer of warranty constitutes an *\n* essential part of this License. No use of any Covered Software is *\n* authorized under this License except under this disclaimer. *\n* *\n************************************************************************\n\n************************************************************************\n* *\n* 7. Limitation of Liability *\n* -------------------------- *\n* *\n* Under no circumstances and under no legal theory, whether tort *\n* (including negligence), contract, or otherwise, shall any *\n* Contributor, or anyone who distributes Covered Software as *\n* permitted above, be liable to You for any direct, indirect, *\n* special, incidental, or consequential damages of any character *\n* including, without limitation, damages for lost profits, loss of *\n* goodwill, work stoppage, computer failure or malfunction, or any *\n* and all other commercial damages or losses, even if such party *\n* shall have been informed of the possibility of such damages. This *\n* limitation of liability shall not apply to liability for death or *\n* personal injury resulting from such party's negligence to the *\n* extent applicable law prohibits such limitation. Some *\n* jurisdictions do not allow the exclusion or limitation of *\n* incidental or consequential damages, so this exclusion and *\n* limitation may not apply to You. *\n* *\n************************************************************************\n\n8. Litigation\n-------------\n\nAny litigation relating to this License may be brought only in the\ncourts of a jurisdiction where the defendant maintains its principal\nplace of business and such litigation shall be governed by laws of that\njurisdiction, without reference to its conflict-of-law provisions.\nNothing in this Section shall prevent a party's ability to bring\ncross-claims or counter-claims.\n\n9. Miscellaneous\n----------------\n\nThis License represents the complete agreement concerning the subject\nmatter hereof. If any provision of this License is held to be\nunenforceable, such provision shall be reformed only to the extent\nnecessary to make it enforceable. Any law or regulation which provides\nthat the language of a contract shall be construed against the drafter\nshall not be used to construe this License against a Contributor.\n\n10. Versions of the License\n---------------------------\n\n10.1. New Versions\n\nMozilla Foundation is the license steward. Except as provided in Section\n10.3, no one other than the license steward has the right to modify or\npublish new versions of this License. Each version will be given a\ndistinguishing version number.\n\n10.2. Effect of New Versions\n\nYou may distribute the Covered Software under the terms of the version\nof the License under which You originally received the Covered Software,\nor under the terms of any subsequent version published by the license\nsteward.\n\n10.3. Modified Versions\n\nIf you create software not governed by this License, and you want to\ncreate a new license for such software, you may create and use a\nmodified version of this License if you rename the license and remove\nany references to the name of the license steward (except to note that\nsuch modified license differs from this License).\n\n10.4. Distributing Source Code Form that is Incompatible With Secondary\nLicenses\n\nIf You choose to distribute Source Code Form that is Incompatible With\nSecondary Licenses under the terms of this version of the License, the\nnotice described in Exhibit B of this License must be attached.\n\nExhibit A - Source Code Form License Notice\n-------------------------------------------\n\n This Source Code Form is subject to the terms of the Mozilla Public\n License, v. 2.0. If a copy of the MPL was not distributed with this\n file, You can obtain one at http://mozilla.org/MPL/2.0/.\n\nIf it is not possible or desirable to put the notice in a particular\nfile, then You may include the notice in a location (such as a LICENSE\nfile in a relevant directory) where a recipient would be likely to look\nfor such a notice.\n\nYou may add additional accurate notices of copyright ownership.\n\nExhibit B - \"Incompatible With Secondary Licenses\" Notice\n---------------------------------------------------------\n\n This Source Code Form is \"Incompatible With Secondary Licenses\", as\n defined by the Mozilla Public License, v. 2.0.\n"
},
{
"path": "Procfile",
"content": "web: bundle exec rackup config.ru -p $PORT\n"
},
{
"path": "README.md",
"content": "# [DevDocs](https://devdocs.io) — API Documentation Browser\n\nDevDocs combines multiple developer documentations in a clean and organized web UI with instant search, offline support, mobile version, dark theme, keyboard shortcuts, and more.\n\nDevDocs was created by [Thibaut Courouble](https://thibaut.me) and is operated by [freeCodeCamp](https://www.freecodecamp.org).\n\n## We are currently searching for maintainers\n\nPlease reach out to the community on [Discord](https://discord.gg/PRyKn3Vbay) if you would like to join the team!\n\nKeep track of development news:\n\n* Join the `#contributors` chat room on [Discord](https://discord.gg/PRyKn3Vbay)\n* Watch the repository on [GitHub](https://github.com/freeCodeCamp/devdocs/subscription)\n* Follow [@DevDocs](https://twitter.com/DevDocs) on Twitter\n\n**Table of Contents:** [Quick Start](#quick-start) · [Vision](#vision) · [App](#app) · [Scraper](#scraper) · [Commands](#available-commands) · [Contributing](#contributing) · [Documentation](#documentation) · [Related Projects](#related-projects) · [License](#copyright--license) · [Questions?](#questions)\n\n## Quick Start\n\nUnless you wish to contribute to the project, we recommend using the hosted version at [devdocs.io](https://devdocs.io). It's up-to-date and works offline out-of-the-box.\n\n### Using Docker (Recommended)\n\nThe easiest way to run DevDocs locally is using Docker:\n\n```sh\ndocker run --name devdocs -d -p 9292:9292 ghcr.io/freecodecamp/devdocs:latest\n```\n\nThis will start DevDocs at [localhost:9292](http://localhost:9292). We provide both regular and Alpine-based images:\n- `ghcr.io/freecodecamp/devdocs:latest` - Standard image\n- `ghcr.io/freecodecamp/devdocs:latest-alpine` - Alpine-based (smaller size)\n\nImages are automatically built and updated monthly with the latest documentation.\n\nAlternatively, you can build the image yourself:\n\n```sh\ngit clone https://github.com/freeCodeCamp/devdocs.git && cd devdocs\ndocker build -t devdocs .\ndocker run --name devdocs -d -p 9292:9292 devdocs\n```\n\n### Manual Installation\n\nDevDocs is made of two pieces: a Ruby scraper that generates the documentation and metadata, and a JavaScript app powered by a small Sinatra app.\n\nDevDocs requires Ruby 3.4.1 (defined in [`Gemfile`](./Gemfile)), libcurl, and a JavaScript runtime supported by [ExecJS](https://github.com/rails/execjs#readme) (included in OS X and Windows; [Node.js](https://nodejs.org/en/) on Linux). On Arch Linux run `pacman -S ruby ruby-bundler ruby-erb ruby-irb`.\n\nOnce you have these installed, run the following commands:\n\n```sh\ngit clone https://github.com/freeCodeCamp/devdocs.git && cd devdocs\ngem install bundler\nbundle install\nbundle exec thor docs:download --default\nbundle exec rackup\n```\n\nFinally, point your browser at [localhost:9292](http://localhost:9292) (the first request will take a few seconds to compile the assets). You're all set.\n\nThe `thor docs:download` command is used to download pre-generated documentations from DevDocs's servers (e.g. `thor docs:download html css`). You can see the list of available documentations and versions by running `thor docs:list`. To update all downloaded documentations, run `thor docs:download --installed`. To download and install all documentation this project has available, run `thor docs:download --all`.\n\n**Note:** there is currently no update mechanism other than `git pull origin main` to update the code and `thor docs:download --installed` to download the latest version of the docs. To stay informed about new releases, be sure to [watch](https://github.com/freeCodeCamp/devdocs/subscription) this repository.\n\n## Vision\n\nDevDocs aims to make reading and searching reference documentation fast, easy and enjoyable.\n\nThe app's main goals are to:\n\n* Keep load times as short as possible\n* Improve the quality, speed, and order of search results\n* Maximize the use of caching and other performance optimizations\n* Maintain a clean and readable user interface\n* Be fully functional offline\n* Support full keyboard navigation\n* Reduce “context switch” by using a consistent typography and design across all documentations\n* Reduce clutter by focusing on a specific category of content (API/reference) and indexing only the minimum useful to most developers.\n\n**Note:** DevDocs is neither a programming guide nor a search engine. All our content is pulled from third-party sources and the project doesn't intend to compete with full-text search engines. Its backbone is metadata; each piece of content is identified by a unique, \"obvious\" and short string. Tutorials, guides and other content that don't meet this requirement are outside the scope of the project.\n\n## App\n\nThe web app is all client-side JavaScript, powered by a small [Sinatra](http://www.sinatrarb.com)/[Sprockets](https://github.com/rails/sprockets) application. It relies on files generated by the [scraper](#scraper).\n\nMany of the code's design decisions were driven by the fact that the app uses XHR to load content directly into the main frame. This includes stripping the original documents of most of their HTML markup (e.g. scripts and stylesheets) to avoid polluting the main frame, and prefixing all CSS class names with an underscore to prevent conflicts.\n\nAnother driving factor is performance and the fact that everything happens in the browser. A service worker (which comes with its own set of constraints) and `localStorage` are used to speed up the boot time, while memory consumption is kept in check by allowing the user to pick his/her own set of documentations. The search algorithm is kept simple because it needs to be fast even searching through 100,000 strings.\n\nDevDocs being a developer tool, the browser requirements are high:\n\n* Recent versions of Firefox, Chrome, or Opera\n* Safari 11.1+\n* Edge 17+\n* iOS 11.3+\n\nThis allows the code to take advantage of the latest DOM and HTML5 APIs and make developing DevDocs a lot more fun!\n\n## Scraper\n\nThe scraper is responsible for generating the documentation and index files (metadata) used by the [app](#app). It's written in Ruby under the `Docs` module.\n\nThere are currently two kinds of scrapers: `UrlScraper` which downloads files via HTTP and `FileScraper` which reads them from the local filesystem. They both make copies of HTML documents, recursively following links that match a set of rules and applying all sorts of modifications along the way, in addition to building an index of the files and their metadata. Documents are parsed using [Nokogiri](http://nokogiri.org).\n\nModifications made to each document include:\n\n* removing content such as the document structure (``, ``, etc.), comments, empty nodes, etc.\n* fixing links (e.g. to remove duplicates)\n* replacing all external (not scraped) URLs with their fully qualified counterpart\n* replacing all internal (scraped) URLs with their unqualified and relative counterpart\n* adding content, such as a title and link to the original document\n* ensuring correct syntax highlighting using [Prism](http://prismjs.com/)\n\nThese modifications are applied via a set of filters using the [HTML::Pipeline](https://github.com/jch/html-pipeline) library. Each scraper includes filters specific to itself, one of which is tasked with figuring out the pages' metadata.\n\nThe end result is a set of normalized HTML partials and two JSON files (index + offline data). Because the index files are loaded separately by the [app](#app) following the user's preferences, the scraper also creates a JSON manifest file containing information about the documentations currently available on the system (such as their name, version, update date, etc.).\n\nMore information about [scrapers](./docs/scraper-reference.md) and [filters](./docs/filter-reference.md) is available in the `docs` folder.\n\n## Available Commands\n\nThe command-line interface uses [Thor](http://whatisthor.com). To see all commands and options, run `thor list` from the project's root.\n\n```sh\n# Server\nrackup # Start the server (ctrl+c to stop)\nrackup --help # List server options\n\n# Docs\nthor docs:list # List available documentations\nthor docs:download # Download one or more documentations\nthor docs:manifest # Create the manifest file used by the app\nthor docs:generate # Generate/scrape a documentation\nthor docs:page # Generate/scrape a documentation page\nthor docs:package # Package a documentation for use with docs:download\nthor docs:clean # Delete documentation packages\n\n# Console\nthor console # Start a REPL\nthor console:docs # Start a REPL in the \"Docs\" module\n\n# Tests can be run quickly from within the console using the \"test\" command.\n# Run \"help test\" for usage instructions.\nthor test:all # Run all tests\nthor test:docs # Run \"Docs\" tests\nthor test:app # Run \"App\" tests\n\n# Assets\nthor assets:compile # Compile assets (not required in development mode)\nthor assets:clean # Clean old assets\n```\n\nIf multiple versions of Ruby are installed on your system, commands must be run through `bundle exec`.\n\n## Contributing\n\nContributions are welcome. Please read the [contributing guidelines](./.github/CONTRIBUTING.md).\n\n## Documentation\n\n* [Adding documentations to DevDocs](./docs/adding-docs.md)\n* [Scraper Reference](./docs/scraper-reference.md)\n* [Filter Reference](./docs/filter-reference.md)\n* [Maintainers’ Guide](./docs/maintainers.md)\n\n## DevDocs Quick Usage Cheatsheet\n\nBelow are some helpful shortcuts and usage tips that are not immediately obvious to new users:\n\n- Press / or Ctrl + K to instantly focus the search bar.\n- Press ? to open DevDocs’ built-in help overlay.\n- Press ↑ or ↓ to navigate search results without touching the mouse.\n- Press Enter to open the highlighted search result.\n- Press Backspace to go back to the previously viewed page.\n- Press Shift + S to toggle the sidebar visibility.\n- Press A to open the list of all installed documentation sets.\n- Press Esc to close popups, overlays, and search.\n- Use the **⚡ Offline Mode toggle** to download docs for offline use.\n- You can pin specific documentation sets to the sidebar for quicker access.\n\nThese shortcuts make DevDocs faster to navigate and more efficient for daily use.\n\n\n## Related Projects\n\nMade something cool? Feel free to open a PR to add a new row to this table! You might want to discover new projects via https://github.com/topics/devdocs.\n\n\n\n| Project | Description | Last commit | Stars |\n| ------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |\n| [yannickglt/alfred-devdocs](https://github.com/yannickglt/alfred-devdocs) | Alfred workflow |  |  |\n| [Merith-TK/devdocs_webapp_kotlin](https://github.com/Merith-TK/devdocs_webapp_kotlin) | Android application |  |  |\n| [gruehle/dev-docs-viewer](https://github.com/gruehle/dev-docs-viewer) | Brackets extension |  |  |\n| [egoist/devdocs-desktop](https://github.com/egoist/devdocs-desktop) | Electron application |  |  |\n| [skeeto/devdocs-lookup](https://github.com/skeeto/devdocs-lookup) | Emacs function |  |  |\n| [astoff/devdocs.el](https://github.com/astoff/devdocs.el) | Emacs viewer |  |  |\n| [naquad/devdocs-shell](https://github.com/naquad/devdocs-shell) | GTK shell with Vim integration |  |  |\n| [hardpixel/devdocs-desktop](https://github.com/hardpixel/devdocs-desktop) | GTK application |  |  |\n| [qwfy/doc-browser](https://github.com/qwfy/doc-browser) | Linux application |  |  |\n| [dteoh/devdocs-macos](https://github.com/dteoh/devdocs-macos) | macOS application |  |  |\n| [Sublime Text plugin](https://sublime.wbond.net/packages/DevDocs) | Sublime Text plugin |  |  |\n| [mohamed3nan/DevDocs-Tab](https://github.com/mohamed3nan/DevDocs-Tab) | VS Code extension (view as tab) |  |  |\n| [deibit/vscode-devdocs](https://marketplace.visualstudio.com/items?itemName=deibit.devdocs) | VS Code extension (open the browser) |  |  |\n| [mdh34/quickDocs](https://github.com/mdh34/quickDocs) | Vala/Python based viewer |  |  |\n| [girishji/devdocs.vim](https://github.com/girishji/devdocs.vim) | Vim plugin & TUI (browse inside Vim) |  |  |\n| [romainl/vim-devdocs](https://github.com/romainl/vim-devdocs) | Vim plugin |  |  |\n| [waiting-for-dev/vim-www](https://github.com/waiting-for-dev/vim-www) | Vim plugin |  |  |\n| [emmanueltouzery/apidocs.nvim](https://github.com/emmanueltouzery/apidocs.nvim) | Neovim plugin |  |  |\n| [toiletbril/dedoc](https://github.com/toiletbril/dedoc) | Terminal based viewer |  |  |\n| [Raycast Devdocs](https://www.raycast.com/djpowers/devdocs) | Raycast extension | Unavailable | Unavailable |\n| [chrisgrieser/alfred-docs-searches](https://github.com/chrisgrieser/alfred-docs-searches) | Alfred workflow |  |  |\n\n## Copyright / License\n\nCopyright 2013–2026 Thibaut Courouble and [other contributors](https://github.com/freeCodeCamp/devdocs/graphs/contributors)\n\nThis software is licensed under the terms of the Mozilla Public License v2.0. See the [COPYRIGHT](./COPYRIGHT) and [LICENSE](./LICENSE) files.\n\nPlease do not use the name DevDocs to endorse or promote products derived from this software without the maintainers' permission, except as may be necessary to comply with the notice/attribution requirements.\n\nWe also wish that any documentation file generated using this software be attributed to DevDocs. Let's be fair to all contributors by giving credit where credit's due. Thanks!\n\n## Questions?\n\nIf you have any questions, please feel free to ask them on the `#contributors` chat room on [Discord](https://discord.gg/PRyKn3Vbay).\n"
},
{
"path": "Rakefile",
"content": "#!/usr/bin/env rake\n\nrequire 'bundler/setup'\nrequire 'thor'\n\nBundler.require :default\n$LOAD_PATH.unshift 'lib'\n\ntask :default do\n $LOAD_PATH.unshift 'test'\n Dir['test/**/*_test.rb'].map(&File.method(:expand_path)).each(&method(:require))\nend\n\nnamespace :assets do\n desc 'Compile all assets'\n task :precompile do\n load 'tasks/docs.thor'\n DocsCLI.new.prepare_deploy\n\n load 'tasks/assets.thor'\n AssetsCLI.new.compile\n end\nend\n"
},
{
"path": "Thorfile",
"content": "$LOAD_PATH.unshift 'lib'\n"
},
{
"path": "assets/images/.gitignore",
"content": "sprites/**/*\n"
},
{
"path": "assets/javascripts/app/app.js",
"content": "class App extends Events {\n _$ = $;\n _$$ = $$;\n _page = page;\n collections = {};\n models = {};\n templates = {};\n views = {};\n\n init() {\n try {\n this.initErrorTracking();\n } catch (error) {}\n if (!this.browserCheck()) {\n return;\n }\n\n this.el = $(\"._app\");\n this.localStorage = new LocalStorageStore();\n if (app.ServiceWorker.isEnabled()) {\n this.serviceWorker = new app.ServiceWorker();\n }\n this.settings = new app.Settings();\n this.db = new app.DB();\n\n this.settings.initLayout();\n\n this.docs = new app.collections.Docs();\n this.disabledDocs = new app.collections.Docs();\n this.entries = new app.collections.Entries();\n\n this.router = new app.Router();\n this.shortcuts = new app.Shortcuts();\n this.document = new app.views.Document();\n if (this.isMobile()) {\n this.mobile = new app.views.Mobile();\n }\n\n if (document.body.hasAttribute(\"data-doc\")) {\n this.DOC = JSON.parse(document.body.getAttribute(\"data-doc\"));\n this.bootOne();\n } else if (this.DOCS) {\n this.bootAll();\n } else {\n this.onBootError();\n }\n }\n\n browserCheck() {\n if (this.isSupportedBrowser()) {\n return true;\n }\n document.body.innerHTML = app.templates.unsupportedBrowser;\n this.hideLoadingScreen();\n return false;\n }\n\n initErrorTracking() {\n // Show a warning message and don't track errors when the app is loaded\n // from a domain other than our own, because things are likely to break.\n // (e.g. cross-domain requests)\n if (this.isInvalidLocation()) {\n new app.views.Notif(\"InvalidLocation\");\n } else {\n if (this.config.sentry_dsn) {\n Raven.config(this.config.sentry_dsn, {\n release: this.config.release,\n whitelistUrls: [/devdocs/],\n includePaths: [/devdocs/],\n ignoreErrors: [/NPObject/, /NS_ERROR/, /^null$/, /EvalError/],\n tags: {\n mode: this.isSingleDoc() ? \"single\" : \"full\",\n iframe: (window.top !== window).toString(),\n electron: (!!window.process?.versions?.electron).toString(),\n },\n shouldSendCallback: () => {\n try {\n if (this.isInjectionError()) {\n this.onInjectionError();\n return false;\n }\n if (this.isAndroidWebview()) {\n return false;\n }\n } catch (error) {}\n return true;\n },\n dataCallback(data) {\n try {\n data.user ||= {};\n Object.assign(data.user, app.settings.dump());\n if (data.user.docs) {\n data.user.docs = data.user.docs.split(\"/\");\n }\n if (app.lastIDBTransaction) {\n data.user.lastIDBTransaction = app.lastIDBTransaction;\n }\n data.tags.scriptCount = document.scripts.length;\n } catch (error) {}\n return data;\n },\n }).install();\n }\n this.previousErrorHandler = onerror;\n window.onerror = this.onWindowError.bind(this);\n CookiesStore.onBlocked = this.onCookieBlocked;\n }\n }\n\n bootOne() {\n this.doc = new app.models.Doc(this.DOC);\n this.docs.reset([this.doc]);\n this.doc.load(this.start.bind(this), this.onBootError.bind(this), {\n readCache: true,\n });\n new app.views.Notice(\"singleDoc\", this.doc);\n delete this.DOC;\n }\n\n bootAll() {\n const docs = this.settings.getDocs();\n for (var doc of this.DOCS) {\n (docs.includes(doc.slug) ? this.docs : this.disabledDocs).add(doc);\n }\n this.migrateDocs();\n this.docs.load(this.start.bind(this), this.onBootError.bind(this), {\n readCache: true,\n writeCache: true,\n });\n delete this.DOCS;\n }\n\n start() {\n let doc;\n for (doc of this.docs.all()) {\n this.entries.add(doc.toEntry());\n }\n for (doc of this.disabledDocs.all()) {\n this.entries.add(doc.toEntry());\n }\n for (doc of this.docs.all()) {\n this.initDoc(doc);\n }\n this.trigger(\"ready\");\n this.router.start();\n this.hideLoadingScreen();\n setTimeout(() => {\n if (!this.doc) {\n this.welcomeBack();\n }\n return this.removeEvent(\"ready bootError\");\n }, 50);\n }\n\n initDoc(doc) {\n for (var type of doc.types.all()) {\n doc.entries.add(type.toEntry());\n }\n this.entries.add(doc.entries.all());\n }\n\n migrateDocs() {\n let needsSaving;\n for (var slug of this.settings.getDocs()) {\n if (!this.docs.findBy(\"slug\", slug)) {\n var doc;\n\n needsSaving = true;\n if (slug === \"webpack~2\") {\n doc = this.disabledDocs.findBy(\"slug\", \"webpack\");\n }\n if (slug === \"angular~4_typescript\") {\n doc = this.disabledDocs.findBy(\"slug\", \"angular\");\n }\n if (slug === \"angular~2_typescript\") {\n doc = this.disabledDocs.findBy(\"slug\", \"angular~2\");\n }\n if (!doc) {\n doc = this.disabledDocs.findBy(\"slug_without_version\", slug);\n }\n if (doc) {\n this.disabledDocs.remove(doc);\n this.docs.add(doc);\n }\n }\n }\n\n if (needsSaving) {\n this.saveDocs();\n }\n }\n\n enableDoc(doc, _onSuccess, onError) {\n if (this.docs.contains(doc)) {\n return;\n }\n\n const onSuccess = () => {\n if (this.docs.contains(doc)) {\n return;\n }\n this.disabledDocs.remove(doc);\n this.docs.add(doc);\n this.docs.sort();\n this.initDoc(doc);\n this.saveDocs();\n if (app.settings.get(\"autoInstall\")) {\n doc.install(_onSuccess, onError);\n } else {\n _onSuccess();\n }\n };\n\n doc.load(onSuccess, onError, { writeCache: true });\n }\n\n saveDocs() {\n this.settings.setDocs(this.docs.all().map((doc) => doc.slug));\n this.db.migrate();\n return this.serviceWorker != null\n ? this.serviceWorker.updateInBackground()\n : undefined;\n }\n\n welcomeBack() {\n let visitCount = this.settings.get(\"count\");\n this.settings.set(\"count\", ++visitCount);\n if (visitCount === 5) {\n new app.views.Notif(\"Share\", { autoHide: null });\n }\n new app.views.News();\n new app.views.Updates();\n return (this.updateChecker = new app.UpdateChecker());\n }\n\n reboot() {\n if (location.pathname !== \"/\" && location.pathname !== \"/settings\") {\n window.location = `/#${location.pathname}`;\n } else {\n window.location = \"/\";\n }\n }\n\n reload() {\n this.docs.clearCache();\n this.disabledDocs.clearCache();\n if (this.serviceWorker) {\n this.serviceWorker.reload();\n } else {\n this.reboot();\n }\n }\n\n reset() {\n this.localStorage.reset();\n this.settings.reset();\n if (this.db != null) {\n this.db.reset();\n }\n if (this.serviceWorker != null) {\n this.serviceWorker.update();\n }\n window.location = \"/\";\n }\n\n showTip(tip) {\n if (this.isSingleDoc()) {\n return;\n }\n const tips = this.settings.getTips();\n if (!tips.includes(tip)) {\n tips.push(tip);\n this.settings.setTips(tips);\n new app.views.Tip(tip);\n }\n }\n\n hideLoadingScreen() {\n if ($.overlayScrollbarsEnabled()) {\n document.body.classList.add(\"_overlay-scrollbars\");\n }\n document.documentElement.classList.remove(\"_booting\");\n }\n\n indexHost() {\n // Can't load the index files from the host/CDN when service worker is\n // enabled because it doesn't support caching URLs that use CORS.\n return this.config[\n this.serviceWorker && this.settings.hasDocs()\n ? \"index_path\"\n : \"docs_origin\"\n ];\n }\n\n onBootError(...args) {\n this.trigger(\"bootError\");\n this.hideLoadingScreen();\n }\n\n onQuotaExceeded() {\n if (this.quotaExceeded) {\n return;\n }\n this.quotaExceeded = true;\n new app.views.Notif(\"QuotaExceeded\", { autoHide: null });\n }\n\n onCookieBlocked(key, value, actual) {\n if (this.cookieBlocked) {\n return;\n }\n this.cookieBlocked = true;\n new app.views.Notif(\"CookieBlocked\", { autoHide: null });\n Raven.captureMessage(`CookieBlocked/${key}`, {\n level: \"warning\",\n extra: { value, actual },\n });\n }\n\n onWindowError(...args) {\n if (this.cookieBlocked) {\n return;\n }\n if (this.isInjectionError(...args)) {\n this.onInjectionError();\n } else if (this.isAppError(...args)) {\n if (typeof this.previousErrorHandler === \"function\") {\n this.previousErrorHandler(...args);\n }\n this.hideLoadingScreen();\n if (!this.errorNotif) {\n this.errorNotif = new app.views.Notif(\"Error\");\n }\n this.errorNotif.show();\n }\n }\n\n onInjectionError() {\n if (!this.injectionError) {\n this.injectionError = true;\n alert(`\\\nJavaScript code has been injected in the page which prevents DevDocs from running correctly.\nPlease check your browser extensions/addons. `);\n Raven.captureMessage(\"injection error\", { level: \"info\" });\n }\n }\n\n isInjectionError() {\n // Some browser extensions expect the entire web to use jQuery.\n // I gave up trying to fight back.\n return (\n window.$ !== app._$ ||\n window.$$ !== app._$$ ||\n window.page !== app._page ||\n typeof $.empty !== \"function\" ||\n typeof page.show !== \"function\"\n );\n }\n\n isAppError(error, file) {\n // Ignore errors from external scripts.\n return file && file.includes(\"devdocs\") && file.endsWith(\".js\");\n }\n\n isSupportedBrowser() {\n try {\n const features = {\n bind: !!Function.prototype.bind,\n pushState: !!history.pushState,\n matchMedia: !!window.matchMedia,\n insertAdjacentHTML: !!document.body.insertAdjacentHTML,\n defaultPrevented:\n document.createEvent(\"CustomEvent\").defaultPrevented === false,\n cssVariables: !!CSS.supports?.(\"(--t: 0)\"),\n };\n\n for (var key in features) {\n var value = features[key];\n if (!value) {\n Raven.captureMessage(`unsupported/${key}`, { level: \"info\" });\n return false;\n }\n }\n\n return true;\n } catch (error) {\n Raven.captureMessage(\"unsupported/exception\", {\n level: \"info\",\n extra: { error },\n });\n return false;\n }\n }\n\n isSingleDoc() {\n return document.body.hasAttribute(\"data-doc\");\n }\n\n isMobile() {\n return this._isMobile != null\n ? this._isMobile\n : (this._isMobile = app.views.Mobile.detect());\n }\n\n isAndroidWebview() {\n return this._isAndroidWebview != null\n ? this._isAndroidWebview\n : (this._isAndroidWebview = app.views.Mobile.detectAndroidWebview());\n }\n\n isInvalidLocation() {\n return (\n this.config.env === \"production\" &&\n !location.host.startsWith(app.config.production_host)\n );\n }\n}\n\nthis.app = new App();\n"
},
{
"path": "assets/javascripts/app/config.js.erb",
"content": "app.config = {\n db_filename: 'db.json',\n default_docs: <%= App.default_docs.to_json %>,\n docs_aliases: <%= App.docs_aliases.to_json %>,\n docs_origin: '<%= App.docs_origin %>',\n env: '<%= App.environment %>',\n history_cache_size: 10,\n index_filename: 'index.json',\n index_path: '/<%= App.docs_prefix %>',\n max_results: 50,\n production_host: 'devdocs.io',\n search_param: 'q',\n sentry_dsn: '<%= App.sentry_dsn %>',\n version: <%= Time.now.to_i %>,\n release: <%= Time.now.utc.httpdate.to_json %>,\n mathml_stylesheet: '/mathml.css',\n favicon_spritesheet: '<%= image_path('sprites/docs.png') %>',\n service_worker_path: '/service-worker.js',\n service_worker_enabled: <%= App.environment == :production || ENV['ENABLE_SERVICE_WORKER'] == 'true' %>,\n}\n"
},
{
"path": "assets/javascripts/app/db.js",
"content": "app.DB = class DB {\n static NAME = \"docs\";\n static VERSION = 15;\n\n constructor() {\n this.versionMultipler = $.isIE() ? 1e5 : 1e9;\n this.useIndexedDB = this.useIndexedDB();\n this.callbacks = [];\n }\n\n db(fn) {\n if (!this.useIndexedDB) {\n return fn();\n }\n if (fn) {\n this.callbacks.push(fn);\n }\n if (this.open) {\n return;\n }\n\n try {\n this.open = true;\n const req = indexedDB.open(\n DB.NAME,\n DB.VERSION * this.versionMultipler + this.userVersion(),\n );\n req.onsuccess = (event) => this.onOpenSuccess(event);\n req.onerror = (event) => this.onOpenError(event);\n req.onupgradeneeded = (event) => this.onUpgradeNeeded(event);\n } catch (error) {\n this.fail(\"exception\", error);\n }\n }\n\n onOpenSuccess(event) {\n let error;\n const db = event.target.result;\n\n if (db.objectStoreNames.length === 0) {\n try {\n db.close();\n } catch (error1) {}\n this.open = false;\n this.fail(\"empty\");\n } else if ((error = this.buggyIDB(db))) {\n try {\n db.close();\n } catch (error2) {}\n this.open = false;\n this.fail(\"buggy\", error);\n } else {\n this.runCallbacks(db);\n this.open = false;\n db.close();\n }\n }\n\n onOpenError(event) {\n event.preventDefault();\n this.open = false;\n const { error } = event.target;\n\n switch (error.name) {\n case \"QuotaExceededError\":\n this.onQuotaExceededError();\n break;\n case \"VersionError\":\n this.onVersionError();\n break;\n case \"InvalidStateError\":\n this.fail(\"private_mode\");\n break;\n default:\n this.fail(\"cant_open\", error);\n }\n }\n\n fail(reason, error) {\n this.cachedDocs = null;\n this.useIndexedDB = false;\n if (!this.reason) {\n this.reason = reason;\n }\n if (!this.error) {\n this.error = error;\n }\n if (error) {\n if (typeof console.error === \"function\") {\n console.error(\"IDB error\", error);\n }\n }\n this.runCallbacks();\n if (error && reason === \"cant_open\") {\n Raven.captureMessage(`${error.name}: ${error.message}`, {\n level: \"warning\",\n fingerprint: [error.name],\n });\n }\n }\n\n onQuotaExceededError() {\n this.reset();\n this.db();\n app.onQuotaExceeded();\n Raven.captureMessage(\"QuotaExceededError\", { level: \"warning\" });\n }\n\n onVersionError() {\n const req = indexedDB.open(DB.NAME);\n req.onsuccess = (event) => {\n return this.handleVersionMismatch(event.target.result.version);\n };\n req.onerror = function (event) {\n event.preventDefault();\n return this.fail(\"cant_open\", error);\n };\n }\n\n handleVersionMismatch(actualVersion) {\n if (Math.floor(actualVersion / this.versionMultipler) !== DB.VERSION) {\n this.fail(\"version\");\n } else {\n this.setUserVersion(actualVersion - DB.VERSION * this.versionMultipler);\n this.db();\n }\n }\n\n buggyIDB(db) {\n if (this.checkedBuggyIDB) {\n return;\n }\n this.checkedBuggyIDB = true;\n try {\n this.idbTransaction(db, {\n stores: $.makeArray(db.objectStoreNames).slice(0, 2),\n mode: \"readwrite\",\n }).abort(); // https://bugs.webkit.org/show_bug.cgi?id=136937\n return;\n } catch (error) {\n return error;\n }\n }\n\n runCallbacks(db) {\n let fn;\n while ((fn = this.callbacks.shift())) {\n fn(db);\n }\n }\n\n onUpgradeNeeded(event) {\n const db = event.target.result;\n if (!db) {\n return;\n }\n\n const objectStoreNames = $.makeArray(db.objectStoreNames);\n\n if (!$.arrayDelete(objectStoreNames, \"docs\")) {\n try {\n db.createObjectStore(\"docs\");\n } catch (error) {}\n }\n\n for (var doc of app.docs.all()) {\n if (!$.arrayDelete(objectStoreNames, doc.slug)) {\n try {\n db.createObjectStore(doc.slug);\n } catch (error1) {}\n }\n }\n\n for (var name of objectStoreNames) {\n try {\n db.deleteObjectStore(name);\n } catch (error2) {}\n }\n }\n\n store(doc, data, onSuccess, onError, _retry) {\n if (_retry == null) {\n _retry = true;\n }\n this.db((db) => {\n if (!db) {\n onError();\n return;\n }\n\n const txn = this.idbTransaction(db, {\n stores: [\"docs\", doc.slug],\n mode: \"readwrite\",\n ignoreError: false,\n });\n txn.oncomplete = () => {\n if (this.cachedDocs != null) {\n this.cachedDocs[doc.slug] = doc.mtime;\n }\n onSuccess();\n };\n txn.onerror = (event) => {\n event.preventDefault();\n if (txn.error?.name === \"NotFoundError\" && _retry) {\n this.migrate();\n setTimeout(() => {\n return this.store(doc, data, onSuccess, onError, false);\n }, 0);\n } else {\n onError(event);\n }\n };\n\n let store = txn.objectStore(doc.slug);\n store.clear();\n for (var path in data) {\n var content = data[path];\n store.add(content, path);\n }\n\n store = txn.objectStore(\"docs\");\n store.put(doc.mtime, doc.slug);\n });\n }\n\n unstore(doc, onSuccess, onError, _retry) {\n if (_retry == null) {\n _retry = true;\n }\n this.db((db) => {\n if (!db) {\n onError();\n return;\n }\n\n const txn = this.idbTransaction(db, {\n stores: [\"docs\", doc.slug],\n mode: \"readwrite\",\n ignoreError: false,\n });\n txn.oncomplete = () => {\n if (this.cachedDocs != null) {\n delete this.cachedDocs[doc.slug];\n }\n onSuccess();\n };\n txn.onerror = function (event) {\n event.preventDefault();\n if (txn.error?.name === \"NotFoundError\" && _retry) {\n this.migrate();\n setTimeout(() => {\n return this.unstore(doc, onSuccess, onError, false);\n }, 0);\n } else {\n onError(event);\n }\n };\n\n let store = txn.objectStore(\"docs\");\n store.delete(doc.slug);\n\n store = txn.objectStore(doc.slug);\n store.clear();\n });\n }\n\n version(doc, fn) {\n const version = this.cachedVersion(doc);\n if (version != null) {\n fn(version);\n return;\n }\n\n this.db((db) => {\n if (!db) {\n fn(false);\n return;\n }\n\n const txn = this.idbTransaction(db, {\n stores: [\"docs\"],\n mode: \"readonly\",\n });\n const store = txn.objectStore(\"docs\");\n\n const req = store.get(doc.slug);\n req.onsuccess = function () {\n fn(req.result);\n };\n req.onerror = function (event) {\n event.preventDefault();\n fn(false);\n };\n });\n }\n\n cachedVersion(doc) {\n if (!this.cachedDocs) {\n return;\n }\n return this.cachedDocs[doc.slug] || false;\n }\n\n versions(docs, fn) {\n const versions = this.cachedVersions(docs);\n if (versions) {\n fn(versions);\n return;\n }\n\n return this.db((db) => {\n if (!db) {\n fn(false);\n return;\n }\n\n const txn = this.idbTransaction(db, {\n stores: [\"docs\"],\n mode: \"readonly\",\n });\n txn.oncomplete = function () {\n fn(result);\n };\n const store = txn.objectStore(\"docs\");\n var result = {};\n\n docs.forEach((doc) => {\n const req = store.get(doc.slug);\n req.onsuccess = function () {\n result[doc.slug] = req.result;\n };\n req.onerror = function (event) {\n event.preventDefault();\n result[doc.slug] = false;\n };\n });\n });\n }\n\n cachedVersions(docs) {\n if (!this.cachedDocs) {\n return;\n }\n const result = {};\n for (var doc of docs) {\n result[doc.slug] = this.cachedVersion(doc);\n }\n return result;\n }\n\n load(entry, onSuccess, onError) {\n if (this.shouldLoadWithIDB(entry)) {\n return this.loadWithIDB(entry, onSuccess, () =>\n this.loadWithXHR(entry, onSuccess, onError)\n );\n } else {\n return this.loadWithXHR(entry, onSuccess, onError);\n }\n }\n\n loadWithXHR(entry, onSuccess, onError) {\n return ajax({\n url: entry.fileUrl(),\n dataType: \"html\",\n success: onSuccess,\n error: onError,\n });\n }\n\n loadWithIDB(entry, onSuccess, onError) {\n return this.db((db) => {\n if (!db) {\n onError();\n return;\n }\n\n if (!db.objectStoreNames.contains(entry.doc.slug)) {\n onError();\n this.loadDocsCache(db);\n return;\n }\n\n const txn = this.idbTransaction(db, {\n stores: [entry.doc.slug],\n mode: \"readonly\",\n });\n const store = txn.objectStore(entry.doc.slug);\n\n const req = store.get(entry.dbPath());\n req.onsuccess = function () {\n if (req.result) {\n onSuccess(req.result);\n } else {\n onError();\n }\n };\n req.onerror = function (event) {\n event.preventDefault();\n onError();\n };\n this.loadDocsCache(db);\n });\n }\n\n loadDocsCache(db) {\n if (this.cachedDocs) {\n return;\n }\n this.cachedDocs = {};\n\n const txn = this.idbTransaction(db, {\n stores: [\"docs\"],\n mode: \"readonly\",\n });\n txn.oncomplete = () => {\n setTimeout(() => this.checkForCorruptedDocs(), 50);\n };\n\n const req = txn.objectStore(\"docs\").openCursor();\n req.onsuccess = (event) => {\n const cursor = event.target.result;\n if (!cursor) {\n return;\n }\n this.cachedDocs[cursor.key] = cursor.value;\n cursor.continue();\n };\n req.onerror = function (event) {\n event.preventDefault();\n };\n }\n\n checkForCorruptedDocs() {\n this.db((db) => {\n let slug;\n this.corruptedDocs = [];\n const docs = (() => {\n const result = [];\n for (var key in this.cachedDocs) {\n var value = this.cachedDocs[key];\n if (value) {\n result.push(key);\n }\n }\n return result;\n })();\n if (docs.length === 0) {\n return;\n }\n\n for (slug of docs) {\n if (!app.docs.findBy(\"slug\", slug)) {\n this.corruptedDocs.push(slug);\n }\n }\n\n for (slug of this.corruptedDocs) {\n $.arrayDelete(docs, slug);\n }\n\n if (docs.length === 0) {\n setTimeout(() => this.deleteCorruptedDocs(), 0);\n return;\n }\n\n const txn = this.idbTransaction(db, {\n stores: docs,\n mode: \"readonly\",\n ignoreError: false,\n });\n txn.oncomplete = () => {\n if (this.corruptedDocs.length > 0) {\n setTimeout(() => this.deleteCorruptedDocs(), 0);\n }\n };\n\n for (var doc of docs) {\n txn.objectStore(doc).get(\"index\").onsuccess = (event) => {\n if (!event.target.result) {\n this.corruptedDocs.push(event.target.source.name);\n }\n };\n }\n });\n }\n\n deleteCorruptedDocs() {\n this.db((db) => {\n let doc;\n const txn = this.idbTransaction(db, {\n stores: [\"docs\"],\n mode: \"readwrite\",\n ignoreError: false,\n });\n const store = txn.objectStore(\"docs\");\n while ((doc = this.corruptedDocs.pop())) {\n this.cachedDocs[doc] = false;\n store.delete(doc);\n }\n });\n Raven.captureMessage(\"corruptedDocs\", {\n level: \"info\",\n extra: { docs: this.corruptedDocs.join(\",\") },\n });\n }\n\n shouldLoadWithIDB(entry) {\n return (\n this.useIndexedDB && (!this.cachedDocs || this.cachedDocs[entry.doc.slug])\n );\n }\n\n idbTransaction(db, options) {\n app.lastIDBTransaction = [options.stores, options.mode];\n const txn = db.transaction(options.stores, options.mode);\n if (options.ignoreError !== false) {\n txn.onerror = function (event) {\n event.preventDefault();\n };\n }\n if (options.ignoreAbort !== false) {\n txn.onabort = function (event) {\n event.preventDefault();\n };\n }\n return txn;\n }\n\n reset() {\n try {\n indexedDB?.deleteDatabase(DB.NAME);\n } catch (error) {}\n }\n\n useIndexedDB() {\n try {\n if (!app.isSingleDoc() && window.indexedDB) {\n return true;\n } else {\n this.reason = \"not_supported\";\n return false;\n }\n } catch (error) {\n return false;\n }\n }\n\n migrate() {\n app.settings.set(\"schema\", this.userVersion() + 1);\n }\n\n setUserVersion(version) {\n app.settings.set(\"schema\", version);\n }\n\n userVersion() {\n return app.settings.get(\"schema\");\n }\n};\n"
},
{
"path": "assets/javascripts/app/router.js",
"content": "app.Router = class Router extends Events {\n static routes = [\n [\"*\", \"before\"],\n [\"/\", \"root\"],\n [\"/settings\", \"settings\"],\n [\"/offline\", \"offline\"],\n [\"/about\", \"about\"],\n [\"/news\", \"news\"],\n [\"/help\", \"help\"],\n [\"/:doc-:type/\", \"type\"],\n [\"/:doc/\", \"doc\"],\n [\"/:doc/:path(*)\", \"entry\"],\n [\"*\", \"notFound\"],\n ];\n\n constructor() {\n super();\n for (var [path, method] of this.constructor.routes) {\n page(path, this[method].bind(this));\n }\n this.setInitialPath();\n }\n\n start() {\n page.start();\n }\n\n show(path) {\n page.show(path);\n }\n\n triggerRoute(name) {\n this.trigger(name, this.context);\n this.trigger(\"after\", name, this.context);\n }\n\n before(context, next) {\n const previousContext = this.context;\n this.context = context;\n this.trigger(\"before\", context);\n\n const res = next();\n if (res) {\n this.context = previousContext;\n return res;\n } else {\n return;\n }\n }\n\n doc(context, next) {\n let doc;\n if (\n (doc =\n app.docs.findBySlug(context.params.doc) ||\n app.disabledDocs.findBySlug(context.params.doc))\n ) {\n context.doc = doc;\n context.entry = doc.toEntry();\n this.triggerRoute(\"entry\");\n return;\n } else {\n return next();\n }\n }\n\n type(context, next) {\n const doc = app.docs.findBySlug(context.params.doc);\n const type = doc?.types?.findBy(\"slug\", context.params.type);\n\n if (type) {\n context.doc = doc;\n context.type = type;\n this.triggerRoute(\"type\");\n return;\n } else {\n return next();\n }\n }\n\n entry(context, next) {\n const doc = app.docs.findBySlug(context.params.doc);\n if (!doc) {\n return next();\n }\n let { path } = context.params;\n const { hash } = context;\n\n let entry = doc.findEntryByPathAndHash(path, hash);\n if (entry) {\n context.doc = doc;\n context.entry = entry;\n this.triggerRoute(\"entry\");\n return;\n } else if (path.slice(-6) === \"/index\") {\n path = path.substr(0, path.length - 6);\n entry = doc.findEntryByPathAndHash(path, hash);\n if (entry) {\n return entry.fullPath();\n }\n } else {\n path = `${path}/index`;\n entry = doc.findEntryByPathAndHash(path, hash);\n if (entry) {\n return entry.fullPath();\n }\n }\n\n return next();\n }\n\n root() {\n if (app.isSingleDoc()) {\n return \"/\";\n }\n this.triggerRoute(\"root\");\n }\n\n settings(context) {\n if (app.isSingleDoc()) {\n return `/#/${context.path}`;\n }\n this.triggerRoute(\"settings\");\n }\n\n offline(context) {\n if (app.isSingleDoc()) {\n return `/#/${context.path}`;\n }\n this.triggerRoute(\"offline\");\n }\n\n about(context) {\n if (app.isSingleDoc()) {\n return `/#/${context.path}`;\n }\n context.page = \"about\";\n this.triggerRoute(\"page\");\n }\n\n news(context) {\n if (app.isSingleDoc()) {\n return `/#/${context.path}`;\n }\n context.page = \"news\";\n this.triggerRoute(\"page\");\n }\n\n help(context) {\n if (app.isSingleDoc()) {\n return `/#/${context.path}`;\n }\n context.page = \"help\";\n this.triggerRoute(\"page\");\n }\n\n notFound(context) {\n this.triggerRoute(\"notFound\");\n }\n\n isIndex() {\n return (\n this.context?.path === \"/\" ||\n (app.isSingleDoc() && this.context?.entry?.isIndex())\n );\n }\n\n isSettings() {\n return this.context?.path === \"/settings\";\n }\n\n setInitialPath() {\n // Remove superfluous forward slashes at the beginning of the path\n let path = location.pathname.replace(/^\\/{2,}/g, \"/\");\n if (path !== location.pathname) {\n page.replace(path + location.search + location.hash, null, true);\n }\n\n if (location.pathname === \"/\") {\n if ((path = this.getInitialPathFromHash())) {\n page.replace(path + location.search, null, true);\n } else if ((path = this.getInitialPathFromCookie())) {\n page.replace(path + location.search + location.hash, null, true);\n }\n }\n }\n\n getInitialPathFromHash() {\n try {\n return new RegExp(\"#/(.+)\").exec(decodeURIComponent(location.hash))?.[1];\n } catch (error) {}\n }\n\n getInitialPathFromCookie() {\n const path = Cookies.get(\"initial_path\");\n if (path) {\n Cookies.expire(\"initial_path\");\n return path;\n }\n }\n\n replaceHash(hash) {\n page.replace(\n location.pathname + location.search + (hash || \"\"),\n null,\n true\n );\n }\n};\n"
},
{
"path": "assets/javascripts/app/searcher.js",
"content": "//\n// Match functions\n//\n\nlet fuzzyRegexp,\n i,\n index,\n lastIndex,\n match,\n matcher,\n matchIndex,\n matchLength,\n queryLength,\n score,\n separators,\n value,\n valueLength;\nconst SEPARATOR = \".\";\n\nlet query =\n (queryLength =\n value =\n valueLength =\n matcher = // current match function\n fuzzyRegexp = // query fuzzy regexp\n index = // position of the query in the string being matched\n lastIndex = // last position of the query in the string being matched\n match = // regexp match data\n matchIndex =\n matchLength =\n score = // score for the current match\n separators = // counter\n i =\n null); // cursor\n\nfunction exactMatch() {\n index = value.indexOf(query);\n if (!(index >= 0)) {\n return;\n }\n\n lastIndex = value.lastIndexOf(query);\n\n if (index !== lastIndex) {\n return Math.max(\n scoreExactMatch(),\n ((index = lastIndex) && scoreExactMatch()) || 0,\n );\n } else {\n return scoreExactMatch();\n }\n}\n\nfunction scoreExactMatch() {\n // Remove one point for each unmatched character.\n score = 100 - (valueLength - queryLength);\n\n if (index > 0) {\n // If the character preceding the query is a dot, assign the same score\n // as if the query was found at the beginning of the string, minus one.\n if (value.charAt(index - 1) === SEPARATOR) {\n score += index - 1;\n // Don't match a single-character query unless it's found at the beginning\n // of the string or is preceded by a dot.\n } else if (queryLength === 1) {\n return;\n // (1) Remove one point for each unmatched character up to the nearest\n // preceding dot or the beginning of the string.\n // (2) Remove one point for each unmatched character following the query.\n } else {\n i = index - 2;\n while (i >= 0 && value.charAt(i) !== SEPARATOR) {\n i--;\n }\n score -=\n index -\n i + // (1)\n (valueLength - queryLength - index); // (2)\n }\n\n // Remove one point for each dot preceding the query, except for the one\n // immediately before the query.\n separators = 0;\n i = index - 2;\n while (i >= 0) {\n if (value.charAt(i) === SEPARATOR) {\n separators++;\n }\n i--;\n }\n score -= separators;\n }\n\n // Remove five points for each dot following the query.\n separators = 0;\n i = valueLength - queryLength - index - 1;\n while (i >= 0) {\n if (value.charAt(index + queryLength + i) === SEPARATOR) {\n separators++;\n }\n i--;\n }\n score -= separators * 5;\n\n return Math.max(1, score);\n}\n\nfunction fuzzyMatch() {\n if (valueLength <= queryLength || value.includes(query)) {\n return;\n }\n if (!(match = fuzzyRegexp.exec(value))) {\n return;\n }\n matchIndex = match.index;\n matchLength = match[0].length;\n score = scoreFuzzyMatch();\n if (\n (match = fuzzyRegexp.exec(\n value.slice((i = value.lastIndexOf(SEPARATOR) + 1)),\n ))\n ) {\n matchIndex = i + match.index;\n matchLength = match[0].length;\n return Math.max(score, scoreFuzzyMatch());\n } else {\n return score;\n }\n}\n\nfunction scoreFuzzyMatch() {\n // When the match is at the beginning of the string or preceded by a dot.\n if (matchIndex === 0 || value.charAt(matchIndex - 1) === SEPARATOR) {\n return Math.max(66, 100 - matchLength);\n // When the match is at the end of the string.\n } else if (matchIndex + matchLength === valueLength) {\n return Math.max(33, 67 - matchLength);\n // When the match is in the middle of the string.\n } else {\n return Math.max(1, 34 - matchLength);\n }\n}\n\n//\n// Searchers\n//\n\napp.Searcher = class Searcher extends Events {\n static CHUNK_SIZE = 20000;\n\n static DEFAULTS = {\n max_results: app.config.max_results,\n fuzzy_min_length: 3,\n };\n\n static SEPARATORS_REGEXP =\n /#|::|:-|->|\\$(?=\\w)|\\-(?=\\w)|\\:(?=\\w)|\\ [\\/\\-&]\\ |:\\ |\\ /g;\n static EOS_SEPARATORS_REGEXP = /(\\w)[\\-:]$/;\n static INFO_PARANTHESES_REGEXP = /\\ \\(\\w+?\\)$/;\n static EMPTY_PARANTHESES_REGEXP = /\\(\\)/;\n static EVENT_REGEXP = /\\ event$/;\n static DOT_REGEXP = /\\.+/g;\n static WHITESPACE_REGEXP = /\\s/g;\n\n static EMPTY_STRING = \"\";\n static ELLIPSIS = \"...\";\n static STRING = \"string\";\n\n static normalizeString(string) {\n return string\n .toLowerCase()\n .replace(Searcher.ELLIPSIS, Searcher.EMPTY_STRING)\n .replace(Searcher.EVENT_REGEXP, Searcher.EMPTY_STRING)\n .replace(Searcher.INFO_PARANTHESES_REGEXP, Searcher.EMPTY_STRING)\n .replace(Searcher.SEPARATORS_REGEXP, SEPARATOR)\n .replace(Searcher.DOT_REGEXP, SEPARATOR)\n .replace(Searcher.EMPTY_PARANTHESES_REGEXP, Searcher.EMPTY_STRING)\n .replace(Searcher.WHITESPACE_REGEXP, Searcher.EMPTY_STRING);\n }\n\n static normalizeQuery(string) {\n string = this.normalizeString(string);\n return string.replace(Searcher.EOS_SEPARATORS_REGEXP, \"$1.\");\n }\n\n constructor(options) {\n super();\n this.options = { ...Searcher.DEFAULTS, ...(options || {}) };\n }\n\n find(data, attr, q) {\n this.kill();\n\n this.data = data;\n this.attr = attr;\n this.query = q;\n this.setup();\n\n if (this.isValid()) {\n this.match();\n } else {\n this.end();\n }\n }\n\n setup() {\n query = this.query = this.constructor.normalizeQuery(this.query);\n queryLength = query.length;\n this.dataLength = this.data.length;\n this.matchers = [exactMatch];\n this.totalResults = 0;\n this.setupFuzzy();\n }\n\n setupFuzzy() {\n if (queryLength >= this.options.fuzzy_min_length) {\n fuzzyRegexp = this.queryToFuzzyRegexp(query);\n this.matchers.push(fuzzyMatch);\n } else {\n fuzzyRegexp = null;\n }\n }\n\n isValid() {\n return queryLength > 0 && query !== SEPARATOR;\n }\n\n end() {\n if (!this.totalResults) {\n this.triggerResults([]);\n }\n this.trigger(\"end\");\n this.free();\n }\n\n kill() {\n if (this.timeout) {\n clearTimeout(this.timeout);\n this.free();\n }\n }\n\n free() {\n this.data = null;\n this.attr = null;\n this.dataLength = null;\n this.matchers = null;\n this.matcher = null;\n this.query = null;\n this.totalResults = null;\n this.scoreMap = null;\n this.cursor = null;\n this.timeout = null;\n }\n\n match() {\n if (!this.foundEnough() && (this.matcher = this.matchers.shift())) {\n this.setupMatcher();\n this.matchChunks();\n } else {\n this.end();\n }\n }\n\n setupMatcher() {\n this.cursor = 0;\n this.scoreMap = new Array(101);\n }\n\n matchChunks() {\n this.matchChunk();\n\n if (this.cursor === this.dataLength || this.scoredEnough()) {\n this.delay(() => this.match());\n this.sendResults();\n } else {\n this.delay(() => this.matchChunks());\n }\n }\n\n matchChunk() {\n ({ matcher } = this);\n for (let j = 0, end = this.chunkSize(); j < end; j++) {\n value = this.data[this.cursor][this.attr];\n if (value.split) {\n // string\n valueLength = value.length;\n if ((score = matcher())) {\n this.addResult(this.data[this.cursor], score);\n }\n } else {\n // array\n score = 0;\n for (value of Array.from(this.data[this.cursor][this.attr])) {\n valueLength = value.length;\n score = Math.max(score, matcher() || 0);\n }\n if (score > 0) {\n this.addResult(this.data[this.cursor], score);\n }\n }\n this.cursor++;\n }\n }\n\n chunkSize() {\n if (this.cursor + Searcher.CHUNK_SIZE > this.dataLength) {\n return this.dataLength % Searcher.CHUNK_SIZE;\n } else {\n return Searcher.CHUNK_SIZE;\n }\n }\n\n scoredEnough() {\n return this.scoreMap[100]?.length >= this.options.max_results;\n }\n\n foundEnough() {\n return this.totalResults >= this.options.max_results;\n }\n\n addResult(object, score) {\n let name;\n (\n this.scoreMap[(name = Math.round(score))] || (this.scoreMap[name] = [])\n ).push(object);\n this.totalResults++;\n }\n\n getResults() {\n const results = [];\n for (let j = this.scoreMap.length - 1; j >= 0; j--) {\n var objects = this.scoreMap[j];\n if (objects) {\n results.push(...objects);\n }\n }\n return results.slice(0, this.options.max_results);\n }\n\n sendResults() {\n const results = this.getResults();\n if (results.length) {\n this.triggerResults(results);\n }\n }\n\n triggerResults(results) {\n this.trigger(\"results\", results);\n }\n\n delay(fn) {\n return (this.timeout = setTimeout(fn, 1));\n }\n\n queryToFuzzyRegexp(string) {\n const chars = string.split(\"\");\n for (i = 0; i < chars.length; i++) {\n var char = chars[i];\n chars[i] = $.escapeRegexp(char);\n }\n return new RegExp(chars.join(\".*?\")); // abc -> /a.*?b.*?c.*?/\n }\n};\n\napp.SynchronousSearcher = class SynchronousSearcher extends app.Searcher {\n match() {\n if (this.matcher) {\n if (!this.allResults) {\n this.allResults = [];\n }\n this.allResults.push(...this.getResults());\n }\n return super.match(...arguments);\n }\n\n free() {\n this.allResults = null;\n return super.free(...arguments);\n }\n\n end() {\n this.sendResults(true);\n return super.end(...arguments);\n }\n\n sendResults(end) {\n if (end && this.allResults?.length) {\n return this.triggerResults(this.allResults);\n }\n }\n\n delay(fn) {\n return fn();\n }\n};\n"
},
{
"path": "assets/javascripts/app/serviceworker.js",
"content": "app.ServiceWorker = class ServiceWorker extends Events {\n static isEnabled() {\n return !!navigator.serviceWorker && app.config.service_worker_enabled;\n }\n\n constructor() {\n super();\n this.onStateChange = this.onStateChange.bind(this);\n this.registration = null;\n this.notifyUpdate = true;\n\n navigator.serviceWorker\n .register(app.config.service_worker_path, { scope: \"/\" })\n .then(\n (registration) => this.updateRegistration(registration),\n (error) => console.error(\"Could not register service worker:\", error),\n );\n }\n\n update() {\n if (!this.registration) {\n return;\n }\n this.notifyUpdate = true;\n return this.registration.update().catch(() => {});\n }\n\n updateInBackground() {\n if (!this.registration) {\n return;\n }\n this.notifyUpdate = false;\n return this.registration.update().catch(() => {});\n }\n\n reload() {\n return this.updateInBackground().then(() => app.reboot());\n }\n\n updateRegistration(registration) {\n this.registration = registration;\n $.on(this.registration, \"updatefound\", () => this.onUpdateFound());\n }\n\n onUpdateFound() {\n if (this.installingRegistration) {\n $.off(this.installingRegistration, \"statechange\", this.onStateChange);\n }\n this.installingRegistration = this.registration.installing;\n $.on(this.installingRegistration, \"statechange\", this.onStateChange);\n }\n\n onStateChange() {\n if (\n this.installingRegistration &&\n this.installingRegistration.state === \"installed\" &&\n navigator.serviceWorker.controller\n ) {\n this.installingRegistration = null;\n this.onUpdateReady();\n }\n }\n\n onUpdateReady() {\n if (this.notifyUpdate) {\n this.trigger(\"updateready\");\n }\n }\n};\n"
},
{
"path": "assets/javascripts/app/settings.js",
"content": "app.Settings = class Settings {\n static PREFERENCE_KEYS = [\n \"hideDisabled\",\n \"hideIntro\",\n \"manualUpdate\",\n \"fastScroll\",\n \"arrowScroll\",\n \"analyticsConsent\",\n \"docs\",\n \"dark\", // legacy\n \"theme\",\n \"layout\",\n \"size\",\n \"tips\",\n \"noAutofocus\",\n \"autoInstall\",\n \"spaceScroll\",\n \"spaceTimeout\",\n \"noDocSpecificIcon\",\n ];\n\n static INTERNAL_KEYS = [\"count\", \"schema\", \"version\", \"news\"];\n\n static LAYOUTS = [\n \"_max-width\",\n \"_sidebar-hidden\",\n \"_native-scrollbars\",\n \"_text-justify-hyphenate\",\n ];\n\n static defaults = {\n count: 0,\n hideDisabled: false,\n hideIntro: false,\n news: 0,\n manualUpdate: false,\n schema: 1,\n analyticsConsent: false,\n theme: \"auto\",\n spaceScroll: 1,\n spaceTimeout: 0.5,\n noDocSpecificIcon: false,\n };\n\n constructor() {\n this.store = new CookiesStore();\n this.cache = {};\n this.autoSupported =\n window.matchMedia(\"(prefers-color-scheme)\").media !== \"not all\";\n if (this.autoSupported) {\n this.darkModeQuery = window.matchMedia(\"(prefers-color-scheme: dark)\");\n this.darkModeQuery.addListener(() => this.setTheme(this.get(\"theme\")));\n }\n }\n\n get(key) {\n let left;\n if (this.cache.hasOwnProperty(key)) {\n return this.cache[key];\n }\n this.cache[key] =\n (left = this.store.get(key)) != null\n ? left\n : this.constructor.defaults[key];\n if (key === \"theme\" && this.cache[key] === \"auto\" && !this.darkModeQuery) {\n return (this.cache[key] = \"default\");\n } else {\n return this.cache[key];\n }\n }\n\n set(key, value) {\n this.store.set(key, value);\n delete this.cache[key];\n if (key === \"theme\") {\n this.setTheme(value);\n }\n }\n\n del(key) {\n this.store.del(key);\n delete this.cache[key];\n }\n\n hasDocs() {\n try {\n return !!this.store.get(\"docs\");\n } catch (error) {}\n }\n\n getDocs() {\n return this.store.get(\"docs\")?.split(\"/\") || app.config.default_docs;\n }\n\n setDocs(docs) {\n this.set(\"docs\", docs.join(\"/\"));\n }\n\n getTips() {\n return this.store.get(\"tips\")?.split(\"/\") || [];\n }\n\n setTips(tips) {\n this.set(\"tips\", tips.join(\"/\"));\n }\n\n setLayout(name, enable) {\n this.toggleLayout(name, enable);\n\n const layout = (this.store.get(\"layout\") || \"\").split(\" \");\n $.arrayDelete(layout, \"\");\n\n if (enable) {\n if (!layout.includes(name)) {\n layout.push(name);\n }\n } else {\n $.arrayDelete(layout, name);\n }\n\n if (layout.length > 0) {\n this.set(\"layout\", layout.join(\" \"));\n } else {\n this.del(\"layout\");\n }\n }\n\n hasLayout(name) {\n const layout = (this.store.get(\"layout\") || \"\").split(\" \");\n return layout.includes(name);\n }\n\n setSize(value) {\n this.set(\"size\", value);\n }\n\n dump() {\n return this.store.dump();\n }\n\n export() {\n const data = this.dump();\n for (var key of Settings.INTERNAL_KEYS) {\n delete data[key];\n }\n return data;\n }\n\n import(data) {\n let key, value;\n const object = this.export();\n for (key in object) {\n value = object[key];\n if (!data.hasOwnProperty(key)) {\n this.del(key);\n }\n }\n for (key in data) {\n value = data[key];\n if (Settings.PREFERENCE_KEYS.includes(key)) {\n this.set(key, value);\n }\n }\n }\n\n reset() {\n this.store.reset();\n this.cache = {};\n }\n\n initLayout() {\n if (this.get(\"dark\") === 1) {\n this.set(\"theme\", \"dark\");\n this.del(\"dark\");\n }\n this.setTheme(this.get(\"theme\"));\n for (var layout of app.Settings.LAYOUTS) {\n this.toggleLayout(layout, this.hasLayout(layout));\n }\n this.initSidebarWidth();\n }\n\n setTheme(theme) {\n if (theme === \"auto\") {\n theme = this.darkModeQuery.matches ? \"dark\" : \"default\";\n }\n const { classList } = document.documentElement;\n classList.remove(\"_theme-default\", \"_theme-dark\");\n classList.add(\"_theme-\" + theme);\n this.updateColorMeta();\n }\n\n updateColorMeta() {\n const color = getComputedStyle(document.documentElement)\n .getPropertyValue(\"--headerBackground\")\n .trim();\n $(\"meta[name=theme-color]\").setAttribute(\"content\", color);\n }\n\n toggleLayout(layout, enable) {\n const { classList } = document.body;\n // sidebar is always shown for settings; its state is updated in app.views.Settings\n if (layout !== \"_sidebar-hidden\" || !app.router?.isSettings) {\n classList.toggle(layout, enable);\n }\n classList.toggle(\"_overlay-scrollbars\", $.overlayScrollbarsEnabled());\n }\n\n initSidebarWidth() {\n const size = this.get(\"size\");\n if (size) {\n document.documentElement.style.setProperty(\"--sidebarWidth\", size + \"px\");\n }\n }\n};\n"
},
{
"path": "assets/javascripts/app/shortcuts.js",
"content": "app.Shortcuts = class Shortcuts extends Events {\n constructor() {\n super();\n this.onKeydown = this.onKeydown.bind(this);\n this.onKeypress = this.onKeypress.bind(this);\n this.isMac = $.isMac();\n this.start();\n }\n\n start() {\n $.on(document, \"keydown\", this.onKeydown);\n $.on(document, \"keypress\", this.onKeypress);\n }\n\n stop() {\n $.off(document, \"keydown\", this.onKeydown);\n $.off(document, \"keypress\", this.onKeypress);\n }\n\n swapArrowKeysBehavior() {\n return app.settings.get(\"arrowScroll\");\n }\n\n spaceScroll() {\n return app.settings.get(\"spaceScroll\");\n }\n\n showTip() {\n app.showTip(\"KeyNav\");\n return (this.showTip = null);\n }\n\n spaceTimeout() {\n return app.settings.get(\"spaceTimeout\");\n }\n\n onKeydown(event) {\n if (this.buggyEvent(event)) {\n return;\n }\n const result = (() => {\n if (event.ctrlKey || event.metaKey) {\n if (!event.altKey && !event.shiftKey) {\n return this.handleKeydownSuperEvent(event);\n }\n } else if (event.shiftKey) {\n if (!event.altKey) {\n return this.handleKeydownShiftEvent(event);\n }\n } else if (event.altKey) {\n return this.handleKeydownAltEvent(event);\n } else {\n return this.handleKeydownEvent(event);\n }\n })();\n\n if (result === false) {\n event.preventDefault();\n }\n }\n\n onKeypress(event) {\n if (\n this.buggyEvent(event) ||\n (event.charCode === 63 && document.activeElement.tagName === \"INPUT\")\n ) {\n return;\n }\n if (!event.ctrlKey && !event.metaKey) {\n const result = this.handleKeypressEvent(event);\n if (result === false) {\n event.preventDefault();\n }\n }\n }\n\n handleKeydownEvent(event, _force) {\n if (\n !_force &&\n [37, 38, 39, 40].includes(event.which) &&\n this.swapArrowKeysBehavior()\n ) {\n return this.handleKeydownAltEvent(event, true);\n }\n\n if (\n !event.target.form &&\n ((48 <= event.which && event.which <= 57) ||\n (65 <= event.which && event.which <= 90))\n ) {\n this.trigger(\"typing\");\n return;\n }\n\n switch (event.which) {\n case 8:\n if (!event.target.form) {\n return this.trigger(\"typing\");\n }\n break;\n case 13:\n return this.trigger(\"enter\");\n case 27:\n this.trigger(\"escape\");\n return false;\n case 32:\n if (\n event.target.type === \"search\" &&\n this.spaceScroll() &&\n (!this.lastKeypress ||\n this.lastKeypress < Date.now() - this.spaceTimeout() * 1000)\n ) {\n this.trigger(\"pageDown\");\n return false;\n }\n break;\n case 33:\n return this.trigger(\"pageUp\");\n case 34:\n return this.trigger(\"pageDown\");\n case 35:\n if (!event.target.form) {\n return this.trigger(\"pageBottom\");\n }\n break;\n case 36:\n if (!event.target.form) {\n return this.trigger(\"pageTop\");\n }\n break;\n case 37:\n if (!event.target.value) {\n return this.trigger(\"left\");\n }\n break;\n case 38:\n this.trigger(\"up\");\n if (typeof this.showTip === \"function\") {\n this.showTip();\n }\n return false;\n case 39:\n if (!event.target.value) {\n return this.trigger(\"right\");\n }\n break;\n case 40:\n this.trigger(\"down\");\n if (typeof this.showTip === \"function\") {\n this.showTip();\n }\n return false;\n case 191:\n if (!event.target.form) {\n this.trigger(\"typing\");\n return false;\n }\n break;\n }\n }\n\n handleKeydownSuperEvent(event) {\n switch (event.which) {\n case 13:\n return this.trigger(\"superEnter\");\n case 37:\n if (this.isMac) {\n this.trigger(\"superLeft\");\n return false;\n }\n break;\n case 38:\n this.trigger(\"pageTop\");\n return false;\n case 39:\n if (this.isMac) {\n this.trigger(\"superRight\");\n return false;\n }\n break;\n case 40:\n this.trigger(\"pageBottom\");\n return false;\n case 188:\n this.trigger(\"preferences\");\n return false;\n }\n }\n\n handleKeydownShiftEvent(event, _force) {\n if (\n !_force &&\n [37, 38, 39, 40].includes(event.which) &&\n this.swapArrowKeysBehavior()\n ) {\n return this.handleKeydownEvent(event, true);\n }\n\n if (!event.target.form && 65 <= event.which && event.which <= 90) {\n this.trigger(\"typing\");\n return;\n }\n\n switch (event.which) {\n case 32:\n this.trigger(\"pageUp\");\n return false;\n case 38:\n if (!getSelection()?.toString()) {\n this.trigger(\"altUp\");\n return false;\n }\n break;\n case 40:\n if (!getSelection()?.toString()) {\n this.trigger(\"altDown\");\n return false;\n }\n break;\n }\n }\n\n handleKeydownAltEvent(event, _force) {\n if (\n !_force &&\n [37, 38, 39, 40].includes(event.which) &&\n this.swapArrowKeysBehavior()\n ) {\n return this.handleKeydownEvent(event, true);\n }\n\n switch (event.which) {\n case 9:\n return this.trigger(\"altRight\", event);\n case 37:\n if (!this.isMac) {\n this.trigger(\"superLeft\");\n return false;\n }\n break;\n case 38:\n this.trigger(\"altUp\");\n return false;\n case 39:\n if (!this.isMac) {\n this.trigger(\"superRight\");\n return false;\n }\n break;\n case 40:\n this.trigger(\"altDown\");\n return false;\n case 67:\n this.trigger(\"altC\");\n return false;\n case 68:\n this.trigger(\"altD\");\n return false;\n case 70:\n return this.trigger(\"altF\", event);\n case 71:\n this.trigger(\"altG\");\n return false;\n case 79:\n this.trigger(\"altO\");\n return false;\n case 82:\n this.trigger(\"altR\");\n return false;\n case 83:\n this.trigger(\"altS\");\n return false;\n }\n }\n\n handleKeypressEvent(event) {\n if (event.which === 63 && !event.target.value) {\n this.trigger(\"help\");\n return false;\n } else {\n return (this.lastKeypress = Date.now());\n }\n }\n\n buggyEvent(event) {\n try {\n event.target;\n event.ctrlKey;\n event.which;\n return false;\n } catch (error) {\n return true;\n }\n }\n};\n"
},
{
"path": "assets/javascripts/app/update_checker.js",
"content": "app.UpdateChecker = class UpdateChecker {\n constructor() {\n this.lastCheck = Date.now();\n\n $.on(window, \"focus\", () => this.onFocus());\n if (app.serviceWorker) {\n app.serviceWorker.on(\"updateready\", () => this.onUpdateReady());\n }\n\n setTimeout(() => this.checkDocs(), 0);\n }\n\n check() {\n if (app.serviceWorker) {\n app.serviceWorker.update();\n } else {\n ajax({\n url: $('script[src*=\"application\"]').getAttribute(\"src\"),\n dataType: \"application/javascript\",\n error: (_, xhr) => {\n if (xhr.status === 404) {\n return this.onUpdateReady();\n }\n },\n });\n }\n }\n\n onUpdateReady() {\n new app.views.Notif(\"UpdateReady\", { autoHide: null });\n }\n\n checkDocs() {\n if (!app.settings.get(\"manualUpdate\")) {\n app.docs.updateInBackground();\n } else {\n app.docs.checkForUpdates((i) => {\n if (i > 0) {\n return this.onDocsUpdateReady();\n }\n });\n }\n }\n\n onDocsUpdateReady() {\n new app.views.Notif(\"UpdateDocs\", { autoHide: null });\n }\n\n onFocus() {\n if (Date.now() - this.lastCheck > 21600e3) {\n this.lastCheck = Date.now();\n this.check();\n }\n }\n};\n"
},
{
"path": "assets/javascripts/application.js",
"content": "//= require_tree ./vendor\n\n//= require lib/license\n//= require_tree ./lib\n\n//= require app/app\n//= require app/config\n//= require_tree ./app\n\n//= require collections/collection\n//= require_tree ./collections\n\n//= require models/model\n//= require_tree ./models\n\n//= require views/view\n//= require_tree ./views\n\n//= require_tree ./templates\n\n//= link_tree ../images/sprites\n\n//= require tracking\n\nvar init = function () {\n document.removeEventListener(\"DOMContentLoaded\", init, false);\n\n if (document.body) {\n return app.init();\n } else {\n return setTimeout(init, 42);\n }\n};\n\ndocument.addEventListener(\"DOMContentLoaded\", init, false);\n"
},
{
"path": "assets/javascripts/collections/collection.js",
"content": "app.Collection = class Collection {\n constructor(objects) {\n if (objects == null) {\n objects = [];\n }\n this.reset(objects);\n }\n\n model() {\n return app.models[this.constructor.model];\n }\n\n reset(objects) {\n if (objects == null) {\n objects = [];\n }\n this.models = [];\n for (var object of objects) {\n this.add(object);\n }\n }\n\n add(object) {\n if (object instanceof app.Model) {\n this.models.push(object);\n } else if (object instanceof Array) {\n for (var obj of object) {\n this.add(obj);\n }\n } else if (object instanceof app.Collection) {\n this.models.push(...(object.all() || []));\n } else {\n this.models.push(new (this.model())(object));\n }\n }\n\n remove(model) {\n this.models.splice(this.models.indexOf(model), 1);\n }\n\n size() {\n return this.models.length;\n }\n\n isEmpty() {\n return this.models.length === 0;\n }\n\n each(fn) {\n for (var model of this.models) {\n fn(model);\n }\n }\n\n all() {\n return this.models;\n }\n\n contains(model) {\n return this.models.includes(model);\n }\n\n findBy(attr, value) {\n return this.models.find((model) => model[attr] === value);\n }\n\n findAllBy(attr, value) {\n return this.models.filter((model) => model[attr] === value);\n }\n\n countAllBy(attr, value) {\n let i = 0;\n for (var model of this.models) {\n if (model[attr] === value) {\n i += 1;\n }\n }\n return i;\n }\n};\n"
},
{
"path": "assets/javascripts/collections/docs.js",
"content": "app.collections.Docs = class Docs extends app.Collection {\n static model = \"Doc\";\n static NORMALIZE_VERSION_RGX = /\\.(\\d)$/;\n static NORMALIZE_VERSION_SUB = \".0$1\";\n\n // Load models concurrently.\n // It's not pretty but I didn't want to import a promise library only for this.\n static CONCURRENCY = 3;\n\n findBySlug(slug) {\n return (\n this.findBy(\"slug\", slug) || this.findBy(\"slug_without_version\", slug)\n );\n }\n sort() {\n return this.models.sort((a, b) => {\n if (a.name === b.name) {\n if (\n !a.version ||\n a.version.replace(\n Docs.NORMALIZE_VERSION_RGX,\n Docs.NORMALIZE_VERSION_SUB,\n ) >\n b.version.replace(\n Docs.NORMALIZE_VERSION_RGX,\n Docs.NORMALIZE_VERSION_SUB,\n )\n ) {\n return -1;\n } else {\n return 1;\n }\n } else if (a.name.toLowerCase() > b.name.toLowerCase()) {\n return 1;\n } else {\n return -1;\n }\n });\n }\n load(onComplete, onError, options) {\n let i = 0;\n\n var next = () => {\n if (i < this.models.length) {\n this.models[i].load(next, fail, options);\n } else if (i === this.models.length + Docs.CONCURRENCY - 1) {\n onComplete();\n }\n i++;\n };\n\n var fail = function (...args) {\n if (onError) {\n onError(args);\n onError = null;\n }\n next();\n };\n\n for (let j = 0, end = Docs.CONCURRENCY; j < end; j++) {\n next();\n }\n }\n\n clearCache() {\n for (var doc of this.models) {\n doc.clearCache();\n }\n }\n\n uninstall(callback) {\n let i = 0;\n var next = () => {\n if (i < this.models.length) {\n this.models[i++].uninstall(next, next);\n } else {\n callback();\n }\n };\n next();\n }\n\n getInstallStatuses(callback) {\n app.db.versions(this.models, (statuses) => {\n if (statuses) {\n for (var key in statuses) {\n var value = statuses[key];\n statuses[key] = { installed: !!value, mtime: value };\n }\n }\n callback(statuses);\n });\n }\n\n checkForUpdates(callback) {\n this.getInstallStatuses((statuses) => {\n let i = 0;\n if (statuses) {\n for (var slug in statuses) {\n var status = statuses[slug];\n if (this.findBy(\"slug\", slug).isOutdated(status)) {\n i += 1;\n }\n }\n }\n callback(i);\n });\n }\n\n updateInBackground() {\n this.getInstallStatuses((statuses) => {\n if (!statuses) {\n return;\n }\n for (var slug in statuses) {\n var status = statuses[slug];\n var doc = this.findBy(\"slug\", slug);\n if (doc.isOutdated(status)) {\n doc.install($.noop, $.noop);\n }\n }\n });\n }\n};\n"
},
{
"path": "assets/javascripts/collections/entries.js",
"content": "app.collections.Entries = class Entries extends app.Collection {\n static model = \"Entry\";\n};\n"
},
{
"path": "assets/javascripts/collections/types.js",
"content": "app.collections.Types = class Types extends app.Collection {\n static model = \"Type\";\n static GUIDES_RGX =\n /(^|\\()(guides?|tutorials?|reference|book|getting\\ started|manual|examples)($|[\\):])/i;\n static APPENDIX_RGX = /appendix/i;\n\n groups() {\n const result = [];\n for (var type of this.models) {\n const name = this._groupFor(type);\n result[name] ||= [];\n result[name].push(type);\n }\n return result.filter((e) => e.length > 0);\n }\n\n _groupFor(type) {\n if (Types.GUIDES_RGX.test(type.name)) {\n return 0;\n } else if (Types.APPENDIX_RGX.test(type.name)) {\n return 2;\n } else {\n return 1;\n }\n }\n};\n"
},
{
"path": "assets/javascripts/debug.js",
"content": "//\n// App\n//\n\nconst _init = app.init;\napp.init = function () {\n console.time(\"Init\");\n _init.call(app);\n console.timeEnd(\"Init\");\n return console.time(\"Load\");\n};\n\nconst _start = app.start;\napp.start = function () {\n console.timeEnd(\"Load\");\n console.time(\"Start\");\n _start.call(app, ...arguments);\n return console.timeEnd(\"Start\");\n};\n\n//\n// Searcher\n//\n\napp.Searcher = class TimingSearcher extends app.Searcher {\n setup() {\n console.groupCollapsed(`Search: ${this.query}`);\n console.time(\"Total\");\n return super.setup();\n }\n\n match() {\n if (this.matcher) {\n console.timeEnd(this.matcher.name);\n }\n return super.match();\n }\n\n setupMatcher() {\n console.time(this.matcher.name);\n return super.setupMatcher();\n }\n\n end() {\n console.log(`Results: ${this.totalResults}`);\n console.timeEnd(\"Total\");\n console.groupEnd();\n return super.end();\n }\n\n kill() {\n if (this.timeout) {\n if (this.matcher) {\n console.timeEnd(this.matcher.name);\n }\n console.groupEnd();\n console.timeEnd(\"Total\");\n console.warn(\"Killed\");\n }\n return super.kill();\n }\n};\n\n//\n// View tree\n//\n\nthis.viewTree = function (view, level, visited) {\n if (view == null) {\n view = app.document;\n }\n if (level == null) {\n level = 0;\n }\n if (visited == null) {\n visited = [];\n }\n if (visited.includes(view)) {\n return;\n }\n visited.push(view);\n\n console.log(\n `%c ${Array(level + 1).join(\" \")}${\n view.constructor.name\n }: ${!!view.activated}`,\n \"color:\" + ((view.activated && \"green\") || \"red\"),\n );\n\n for (var key of Object.keys(view || {})) {\n var value = view[key];\n if (key !== \"view\" && value) {\n if (typeof value === \"object\" && value.setupElement) {\n this.viewTree(value, level + 1, visited);\n } else if (value.constructor.toString().match(/Object\\(\\)/)) {\n for (var k of Object.keys(value || {})) {\n var v = value[k];\n if (v && typeof v === \"object\" && v.setupElement) {\n this.viewTree(v, level + 1, visited);\n }\n }\n }\n }\n }\n};\n"
},
{
"path": "assets/javascripts/docs.js.erb",
"content": "//= depend_on docs.json\napp.DOCS = <%= File.read App.docs_manifest_path %>;\n"
},
{
"path": "assets/javascripts/lib/ajax.js",
"content": "const MIME_TYPES = {\n json: \"application/json\",\n html: \"text/html\",\n};\n\nfunction ajax(options) {\n applyDefaults(options);\n serializeData(options);\n\n const xhr = new XMLHttpRequest();\n xhr.open(options.type, options.url, options.async);\n\n applyCallbacks(xhr, options);\n applyHeaders(xhr, options);\n\n xhr.send(options.data);\n\n if (options.async) {\n return { abort: abort.bind(undefined, xhr) };\n } else {\n return parseResponse(xhr, options);\n }\n\n function applyDefaults(options) {\n for (var key in ajax.defaults) {\n if (options[key] == null) {\n options[key] = ajax.defaults[key];\n }\n }\n }\n\n function serializeData(options) {\n if (!options.data) {\n return;\n }\n\n if (options.type === \"GET\") {\n options.url += \"?\" + serializeParams(options.data);\n options.data = null;\n } else {\n options.data = serializeParams(options.data);\n }\n }\n\n function serializeParams(params) {\n return Object.entries(params)\n .map(\n ([key, value]) =>\n `${encodeURIComponent(key)}=${encodeURIComponent(value)}`,\n )\n .join(\"&\");\n }\n\n function applyCallbacks(xhr, options) {\n if (!options.async) {\n return;\n }\n\n xhr.timer = setTimeout(\n onTimeout.bind(undefined, xhr, options),\n options.timeout * 1000,\n );\n if (options.progress) {\n xhr.onprogress = options.progress;\n }\n xhr.onreadystatechange = function () {\n if (xhr.readyState === 4) {\n clearTimeout(xhr.timer);\n onComplete(xhr, options);\n }\n };\n }\n\n function applyHeaders(xhr, options) {\n if (!options.headers) {\n options.headers = {};\n }\n\n if (options.contentType) {\n options.headers[\"Content-Type\"] = options.contentType;\n }\n\n if (\n !options.headers[\"Content-Type\"] &&\n options.data &&\n options.type !== \"GET\"\n ) {\n options.headers[\"Content-Type\"] = \"application/x-www-form-urlencoded\";\n }\n\n if (options.dataType) {\n options.headers[\"Accept\"] =\n MIME_TYPES[options.dataType] || options.dataType;\n }\n\n for (var key in options.headers) {\n var value = options.headers[key];\n xhr.setRequestHeader(key, value);\n }\n }\n\n function onComplete(xhr, options) {\n if (200 <= xhr.status && xhr.status < 300) {\n const response = parseResponse(xhr, options);\n if (response != null) {\n onSuccess(response, xhr, options);\n } else {\n onError(\"invalid\", xhr, options);\n }\n } else {\n onError(\"error\", xhr, options);\n }\n }\n\n function onSuccess(response, xhr, options) {\n if (options.success != null) {\n options.success.call(options.context, response, xhr, options);\n }\n }\n\n function onError(type, xhr, options) {\n if (options.error != null) {\n options.error.call(options.context, type, xhr, options);\n }\n }\n\n function onTimeout(xhr, options) {\n xhr.abort();\n onError(\"timeout\", xhr, options);\n }\n\n function abort(xhr) {\n clearTimeout(xhr.timer);\n xhr.onreadystatechange = null;\n xhr.abort();\n }\n\n function parseResponse(xhr, options) {\n if (options.dataType === \"json\") {\n return parseJSON(xhr.responseText);\n } else {\n return xhr.responseText;\n }\n }\n\n function parseJSON(json) {\n try {\n return JSON.parse(json);\n } catch (error) {}\n }\n}\n\najax.defaults = {\n async: true,\n dataType: \"json\",\n timeout: 30,\n type: \"GET\",\n // contentType\n // context\n // data\n // error\n // headers\n // progress\n // success\n // url\n};\n"
},
{
"path": "assets/javascripts/lib/cookies_store.js",
"content": "// Intentionally called CookiesStore instead of CookieStore\n// Calling it CookieStore causes issues when the Experimental Web Platform features flag is enabled in Chrome\n// Related issue: https://github.com/freeCodeCamp/devdocs/issues/932\nclass CookiesStore {\n static INT = /^\\d+$/;\n\n static onBlocked() {}\n\n get(key) {\n let value = Cookies.get(key);\n if (value != null && CookiesStore.INT.test(value)) {\n value = parseInt(value, 10);\n }\n return value;\n }\n\n set(key, value) {\n if (value === false) {\n this.del(key);\n return;\n }\n\n if (value === true) {\n value = 1;\n }\n if (\n value &&\n (typeof CookiesStore.INT.test === \"function\"\n ? CookiesStore.INT.test(value)\n : undefined)\n ) {\n value = parseInt(value, 10);\n }\n Cookies.set(key, \"\" + value, { path: \"/\", expires: 1e8 });\n if (this.get(key) !== value) {\n CookiesStore.onBlocked(key, value, this.get(key));\n }\n }\n\n del(key) {\n Cookies.expire(key);\n }\n\n reset() {\n try {\n for (var cookie of document.cookie.split(/;\\s?/)) {\n Cookies.expire(cookie.split(\"=\")[0]);\n }\n return;\n } catch (error) {}\n }\n\n dump() {\n const result = {};\n for (var cookie of document.cookie.split(/;\\s?/)) {\n if (cookie[0] !== \"_\") {\n cookie = cookie.split(\"=\");\n result[cookie[0]] = cookie[1];\n }\n }\n return result;\n }\n}\n"
},
{
"path": "assets/javascripts/lib/events.js",
"content": "class Events {\n on(event, callback) {\n if (event.includes(\" \")) {\n for (var name of event.split(\" \")) {\n this.on(name, callback);\n }\n } else {\n this._callbacks ||= {};\n this._callbacks[event] ||= [];\n this._callbacks[event].push(callback);\n }\n return this;\n }\n\n off(event, callback) {\n let callbacks, index;\n if (event.includes(\" \")) {\n for (var name of event.split(\" \")) {\n this.off(name, callback);\n }\n } else if (\n (callbacks = this._callbacks?.[event]) &&\n (index = callbacks.indexOf(callback)) >= 0\n ) {\n callbacks.splice(index, 1);\n if (!callbacks.length) {\n delete this._callbacks[event];\n }\n }\n return this;\n }\n\n trigger(event, ...args) {\n this.eventInProgress = { name: event, args };\n const callbacks = this._callbacks?.[event];\n if (callbacks) {\n for (const callback of callbacks.slice(0)) {\n if (typeof callback === \"function\") {\n callback(...args);\n }\n }\n }\n this.eventInProgress = null;\n if (event !== \"all\") {\n this.trigger(\"all\", event, ...args);\n }\n return this;\n }\n\n removeEvent(event) {\n if (this._callbacks != null) {\n for (var name of event.split(\" \")) {\n delete this._callbacks[name];\n }\n }\n return this;\n }\n}\n"
},
{
"path": "assets/javascripts/lib/favicon.js",
"content": "let defaultUrl = null;\nlet currentSlug = null;\n\nconst imageCache = {};\nconst urlCache = {};\n\nconst withImage = function (url, action) {\n if (imageCache[url]) {\n return action(imageCache[url]);\n } else {\n const img = new Image();\n img.crossOrigin = \"anonymous\";\n img.src = url;\n return (img.onload = () => {\n imageCache[url] = img;\n return action(img);\n });\n }\n};\n\nthis.setFaviconForDoc = function (doc) {\n if (currentSlug === doc.slug || app.settings.get(\"noDocSpecificIcon\")) {\n return;\n }\n\n const favicon = $('link[rel=\"icon\"]');\n\n if (defaultUrl === null) {\n defaultUrl = favicon.href;\n }\n\n if (urlCache[doc.slug]) {\n favicon.href = urlCache[doc.slug];\n currentSlug = doc.slug;\n return;\n }\n\n const iconEl = $(`._icon-${doc.slug.split(\"~\")[0]}`);\n if (iconEl === null) {\n return;\n }\n\n const styles = window.getComputedStyle(iconEl, \":before\");\n\n const backgroundPositionX = styles[\"background-position-x\"];\n const backgroundPositionY = styles[\"background-position-y\"];\n if (backgroundPositionX === undefined || backgroundPositionY === undefined) {\n return;\n }\n\n const bgUrl = app.config.favicon_spritesheet;\n const sourceSize = 16;\n const sourceX = Math.abs(parseInt(backgroundPositionX.slice(0, -2)));\n const sourceY = Math.abs(parseInt(backgroundPositionY.slice(0, -2)));\n\n return withImage(bgUrl, (docImg) =>\n withImage(defaultUrl, function (defaultImg) {\n const size = defaultImg.width;\n\n const canvas = document.createElement(\"canvas\");\n const ctx = canvas.getContext(\"2d\");\n\n canvas.width = size;\n canvas.height = size;\n ctx.drawImage(defaultImg, 0, 0);\n\n const docIconPercentage = 65;\n const destinationCoords = (size / 100) * (100 - docIconPercentage);\n const destinationSize = (size / 100) * docIconPercentage;\n\n ctx.drawImage(\n docImg,\n sourceX,\n sourceY,\n sourceSize,\n sourceSize,\n destinationCoords,\n destinationCoords,\n destinationSize,\n destinationSize,\n );\n\n try {\n urlCache[doc.slug] = canvas.toDataURL();\n favicon.href = urlCache[doc.slug];\n\n return (currentSlug = doc.slug);\n } catch (error) {\n Raven.captureException(error, { level: \"info\" });\n return this.resetFavicon();\n }\n }),\n );\n};\n\nthis.resetFavicon = function () {\n if (defaultUrl !== null && currentSlug !== null) {\n $('link[rel=\"icon\"]').href = defaultUrl;\n return (currentSlug = null);\n }\n};\n"
},
{
"path": "assets/javascripts/lib/license.js",
"content": "/*\n * Copyright 2013-2026 Thibaut Courouble and other contributors\n *\n * This source code is licensed under the terms of the Mozilla\n * Public License, v. 2.0, a copy of which may be obtained at:\n * http://mozilla.org/MPL/2.0/\n */\n"
},
{
"path": "assets/javascripts/lib/local_storage_store.js",
"content": "this.LocalStorageStore = class LocalStorageStore {\n get(key) {\n try {\n return JSON.parse(localStorage.getItem(key));\n } catch (error) {}\n }\n\n set(key, value) {\n try {\n localStorage.setItem(key, JSON.stringify(value));\n return true;\n } catch (error) {}\n }\n\n del(key) {\n try {\n localStorage.removeItem(key);\n return true;\n } catch (error) {}\n }\n\n reset() {\n try {\n localStorage.clear();\n return true;\n } catch (error) {}\n }\n};\n"
},
{
"path": "assets/javascripts/lib/page.js",
"content": "/*\n * Based on github.com/visionmedia/page.js\n * Licensed under the MIT license\n * Copyright 2012 TJ Holowaychuk ` elements, expand them.\n$.openDetailsAncestors = function (el) {\n while (el) {\n if (el.tagName === \"DETAILS\") {\n el.open = true;\n }\n el = el.parentElement;\n }\n}\n\nlet smoothScroll =\n (smoothStart =\n smoothEnd =\n smoothDistance =\n smoothDuration =\n null);\n\n$.smoothScroll = function (el, end) {\n smoothEnd = end;\n\n if (smoothScroll) {\n const newDistance = smoothEnd - smoothStart;\n smoothDuration += Math.min(300, Math.abs(smoothDistance - newDistance));\n smoothDistance = newDistance;\n return;\n }\n\n smoothStart = el.scrollTop;\n smoothDistance = smoothEnd - smoothStart;\n smoothDuration = Math.min(300, Math.abs(smoothDistance));\n const startTime = Date.now();\n\n smoothScroll = function () {\n const p = Math.min(1, (Date.now() - startTime) / smoothDuration);\n const y = Math.max(\n 0,\n Math.floor(\n smoothStart +\n smoothDistance * (p < 0.5 ? 2 * p * p : p * (4 - p * 2) - 1),\n ),\n );\n el.scrollTop = y;\n if (p === 1) {\n return (smoothScroll = null);\n } else {\n return requestAnimationFrame(smoothScroll);\n }\n };\n return requestAnimationFrame(smoothScroll);\n};\n\n//\n// Utilities\n//\n\n$.makeArray = function (object) {\n if (Array.isArray(object)) {\n return object;\n } else {\n return Array.prototype.slice.apply(object);\n }\n};\n\n$.arrayDelete = function (array, object) {\n const index = array.indexOf(object);\n if (index >= 0) {\n array.splice(index, 1);\n return true;\n } else {\n return false;\n }\n};\n\n// Returns true if the object is an array or a collection of DOM elements.\n$.isCollection = (object) =>\n Array.isArray(object) || typeof object?.item === \"function\";\n\nconst ESCAPE_HTML_MAP = {\n \"&\": \"&\",\n \"<\": \"<\",\n \">\": \">\",\n '\"': \""\",\n \"'\": \"'\",\n \"/\": \"/\",\n};\n\nconst ESCAPE_HTML_REGEXP = /[&<>\"'\\/]/g;\n\n$.escape = (string) =>\n string.replace(ESCAPE_HTML_REGEXP, (match) => ESCAPE_HTML_MAP[match]);\n\nconst ESCAPE_REGEXP = /([.*+?^=!:${}()|\\[\\]\\/\\\\])/g;\n\n$.escapeRegexp = (string) => string.replace(ESCAPE_REGEXP, \"\\\\$1\");\n\n$.urlDecode = (string) => decodeURIComponent(string.replace(/\\+/g, \"%20\"));\n\n$.classify = function (string) {\n string = string.split(\"_\");\n for (let i = 0; i < string.length; i++) {\n var substr = string[i];\n string[i] = substr[0].toUpperCase() + substr.slice(1);\n }\n return string.join(\"\");\n};\n\n//\n// Miscellaneous\n//\n\n$.noop = function () {};\n\n$.popup = function (value) {\n try {\n window.open(value.href || value, \"_blank\", \"noopener\");\n } catch (error) {\n const win = window.open();\n if (win.opener) {\n win.opener = null;\n }\n win.location = value.href || value;\n }\n};\n\nlet isMac = null;\n$.isMac = () =>\n isMac != null ? isMac : (isMac = navigator.userAgent.includes(\"Mac\"));\n\nlet isIE = null;\n$.isIE = () =>\n isIE != null\n ? isIE\n : (isIE =\n navigator.userAgent.includes(\"MSIE\") ||\n navigator.userAgent.includes(\"rv:11.0\"));\n\nlet isChromeForAndroid = null;\n$.isChromeForAndroid = () =>\n isChromeForAndroid != null\n ? isChromeForAndroid\n : (isChromeForAndroid =\n navigator.userAgent.includes(\"Android\") &&\n /Chrome\\/([.0-9])+ Mobile/.test(navigator.userAgent));\n\nlet isAndroid = null;\n$.isAndroid = () =>\n isAndroid != null\n ? isAndroid\n : (isAndroid = navigator.userAgent.includes(\"Android\"));\n\nlet isIOS = null;\n$.isIOS = () =>\n isIOS != null\n ? isIOS\n : (isIOS =\n navigator.userAgent.includes(\"iPhone\") ||\n navigator.userAgent.includes(\"iPad\"));\n\n$.overlayScrollbarsEnabled = function () {\n if (!$.isMac()) {\n return false;\n }\n const div = document.createElement(\"div\");\n div.setAttribute(\n \"style\",\n \"width: 100px; height: 100px; overflow: scroll; position: absolute\",\n );\n document.body.appendChild(div);\n const result = div.offsetWidth === div.clientWidth;\n document.body.removeChild(div);\n return result;\n};\n\nconst HIGHLIGHT_DEFAULTS = {\n className: \"highlight\",\n delay: 1000,\n};\n\n$.highlight = function (el, options) {\n options = { ...HIGHLIGHT_DEFAULTS, ...(options || {}) };\n el.classList.add(options.className);\n setTimeout(() => el.classList.remove(options.className), options.delay);\n};\n"
},
{
"path": "assets/javascripts/models/doc.js",
"content": "app.models.Doc = class Doc extends app.Model {\n // Attributes: name, slug, type, version, release, db_size, mtime, links\n\n constructor() {\n super(...arguments);\n this.reset(this);\n this.slug_without_version = this.slug.split(\"~\")[0];\n this.fullName = `${this.name}` + (this.version ? ` ${this.version}` : \"\");\n this.icon = this.slug_without_version;\n if (this.version) {\n this.short_version = this.version.split(\" \")[0];\n }\n this.text = this.toEntry().text;\n }\n\n reset(data) {\n this.resetEntries(data.entries);\n this.resetTypes(data.types);\n }\n\n resetEntries(entries) {\n this.entries = new app.collections.Entries(entries);\n this.entries.each((entry) => {\n return (entry.doc = this);\n });\n }\n\n resetTypes(types) {\n this.types = new app.collections.Types(types);\n this.types.each((type) => {\n return (type.doc = this);\n });\n }\n\n fullPath(path) {\n if (path == null) {\n path = \"\";\n }\n if (path[0] !== \"/\") {\n path = `/${path}`;\n }\n return `/${this.slug}${path}`;\n }\n\n fileUrl(path) {\n return `${app.config.docs_origin}${this.fullPath(path)}?${this.mtime}`;\n }\n\n dbUrl() {\n return `${app.config.docs_origin}/${this.slug}/${app.config.db_filename}?${this.mtime}`;\n }\n\n indexUrl() {\n return `${app.indexHost()}/${this.slug}/${app.config.index_filename}?${\n this.mtime\n }`;\n }\n\n toEntry() {\n if (this.entry) {\n return this.entry;\n }\n this.entry = new app.models.Entry({\n doc: this,\n name: this.fullName,\n path: \"index\",\n });\n if (this.version) {\n this.entry.addAlias(this.name);\n }\n return this.entry;\n }\n\n findEntryByPathAndHash(path, hash) {\n const entry = hash && this.entries.findBy(\"path\", `${path}#${hash}`);\n if (entry) {\n return entry;\n } else if (path === \"index\") {\n return this.toEntry();\n } else {\n return this.entries.findBy(\"path\", path);\n }\n }\n\n load(onSuccess, onError, options) {\n if (options == null) {\n options = {};\n }\n if (options.readCache && this._loadFromCache(onSuccess)) {\n return;\n }\n\n const callback = (data) => {\n this.reset(data);\n onSuccess();\n if (options.writeCache) {\n this._setCache(data);\n }\n };\n\n return ajax({\n url: this.indexUrl(),\n success: callback,\n error: onError,\n });\n }\n\n clearCache() {\n app.localStorage.del(this.slug);\n }\n\n _loadFromCache(onSuccess) {\n const data = this._getCache();\n if (!data) {\n return;\n }\n\n const callback = () => {\n this.reset(data);\n onSuccess();\n };\n\n setTimeout(callback, 0);\n return true;\n }\n\n _getCache() {\n const data = app.localStorage.get(this.slug);\n if (!data) {\n return;\n }\n\n if (data[0] === this.mtime) {\n return data[1];\n } else {\n this.clearCache();\n return;\n }\n }\n\n _setCache(data) {\n app.localStorage.set(this.slug, [this.mtime, data]);\n }\n\n install(onSuccess, onError, onProgress) {\n if (this.installing) {\n return;\n }\n this.installing = true;\n\n const error = () => {\n this.installing = null;\n onError();\n };\n\n const success = (data) => {\n this.installing = null;\n app.db.store(this, data, onSuccess, error);\n };\n\n ajax({\n url: this.dbUrl(),\n success,\n error,\n progress: onProgress,\n timeout: 3600,\n });\n }\n\n uninstall(onSuccess, onError) {\n if (this.installing) {\n return;\n }\n this.installing = true;\n\n const success = () => {\n this.installing = null;\n onSuccess();\n };\n\n const error = () => {\n this.installing = null;\n onError();\n };\n\n app.db.unstore(this, success, error);\n }\n\n getInstallStatus(callback) {\n app.db.version(this, (value) =>\n callback({ installed: !!value, mtime: value }),\n );\n }\n\n isOutdated(status) {\n if (!status) {\n return false;\n }\n const isInstalled = status.installed || app.settings.get(\"autoInstall\");\n return isInstalled && this.mtime !== status.mtime;\n }\n};\n"
},
{
"path": "assets/javascripts/models/entry.js",
"content": "//= require app/searcher\n\napp.models.Entry = class Entry extends app.Model {\n static applyAliases(string) {\n const aliases = app.config.docs_aliases;\n if (aliases.hasOwnProperty(string)) {\n return [string, aliases[string]];\n } else {\n const words = string.split(\".\");\n for (let i = 0; i < words.length; i++) {\n var word = words[i];\n if (aliases.hasOwnProperty(word)) {\n words[i] = aliases[word];\n return [string, words.join(\".\")];\n }\n }\n }\n return string;\n }\n\n // Attributes: name, type, path\n constructor() {\n super(...arguments);\n this.text = Entry.applyAliases(app.Searcher.normalizeString(this.name));\n }\n\n addAlias(name) {\n const text = Entry.applyAliases(app.Searcher.normalizeString(name));\n if (!Array.isArray(this.text)) {\n this.text = [this.text];\n }\n this.text.push(Array.isArray(text) ? text[1] : text);\n }\n\n fullPath() {\n return this.doc.fullPath(this.isIndex() ? \"\" : this.path);\n }\n\n dbPath() {\n return this.path.replace(/#.*/, \"\");\n }\n\n filePath() {\n return this.doc.fullPath(this._filePath());\n }\n\n fileUrl() {\n return this.doc.fileUrl(this._filePath());\n }\n\n _filePath() {\n let result = this.path.replace(/#.*/, \"\");\n if (result.slice(-5) !== \".html\") {\n result += \".html\";\n }\n return result;\n }\n\n isIndex() {\n return this.path === \"index\";\n }\n\n getType() {\n return this.doc.types.findBy(\"name\", this.type);\n }\n\n loadFile(onSuccess, onError) {\n return app.db.load(this, onSuccess, onError);\n }\n};\n"
},
{
"path": "assets/javascripts/models/model.js",
"content": "app.Model = class Model {\n constructor(attributes) {\n for (var key in attributes) {\n var value = attributes[key];\n this[key] = value;\n }\n }\n};\n"
},
{
"path": "assets/javascripts/models/type.js",
"content": "app.models.Type = class Type extends app.Model {\n // Attributes: name, slug, count\n\n fullPath() {\n return `/${this.doc.slug}-${this.slug}/`;\n }\n\n entries() {\n return this.doc.entries.findAllBy(\"type\", this.name);\n }\n\n toEntry() {\n return new app.models.Entry({\n doc: this.doc,\n name: `${this.doc.name} / ${this.name}`,\n path: \"..\" + this.fullPath(),\n });\n }\n};\n"
},
{
"path": "assets/javascripts/news.json",
"content": "[\n [\n \"2026-02-14\",\n \"New documentation: CouchDB\"\n ],\n [\n \"2025-10-19\",\n \"New documentations: Lit, Graphviz, Bun\"\n ],\n [\n \"2025-07-14\",\n \"New documentation: Tcllib\"\n ],\n [\n \"2025-06-27\",\n \"New documentation: Zsh\"\n ],\n [\n \"2025-06-04\",\n \"New documentation: es-toolkit\"\n ],\n [\n \"2025-05-28\",\n \"New documentation: Vert.x\"\n ],\n [\n \"2025-02-23\",\n \"New documentation: Three.js\"\n ],\n [\n \"2025-02-16\",\n \"New documentation: OpenLayers\"\n ],\n [\n \"2024-11-23\",\n \"New documentation: DuckDB\"\n ],\n [\n \"2024-08-20\",\n \"New documentation: Linux man pages\"\n ],\n [\n \"2024-07-28\",\n \"New documentation: OpenGL\"\n ],\n [\n \"2024-06-12\",\n \"New documentations: Next.js, click\"\n ],\n [\n \"2024-01-24\",\n \"New documentation: Playwright\"\n ],\n [\n \"2024-01-20\",\n \"New documentation: htmx\"\n ],\n [\n \"2024-01-12\",\n \"New documentation: Hammerspoon\"\n ],\n [\n \"2024-01-05\",\n \"New documentation: Bazel\"\n ],\n [\n \"2023-10-09\",\n \"New documentations: hapi, joi, Nushell, Varnish\"\n ],\n [\n \"2023-08-24\",\n \"New documentation: Fluture\"\n ],\n [\n \"2022-12-20\",\n \"New documentations: QUnit, Wagtail\"\n ],\n [\n \"2022-11-04\",\n \"New documentation: VueUse\"\n ],\n [\n \"2022-10-10\",\n \"New documentation: Astro\"\n ],\n [\n \"2022-10-09\",\n \"New documentations: FastAPI, Vitest\"\n ],\n [\n \"2022-10-02\",\n \"New documentation: Svelte\"\n ],\n [\n \"2022-09-21\",\n \"Added HTTP/3 to HTTP\"\n ],\n [\n \"2022-09-06\",\n \"New documentation: date-fns\"\n ],\n [\n \"2022-08-27\",\n \"New documentations: Sanctuary, Requests, Axios\"\n ],\n [\n \"2022-05-03\",\n \"New documentations: Kubernetes, Kubectl\"\n ],\n [\n \"2022-04-25\",\n \"New documentation: Nix\"\n ],\n [\n \"2022-03-31\",\n \"New documentation: Eigen3\"\n ],\n [\n \"2022-02-21\",\n \"New documentation: Tailwind CSS\"\n ],\n [\n \"2022-01-12\",\n \"New documentation: React Router\"\n ],\n [\n \"2022-01-09\",\n \"New documentation: Deno\"\n ],\n [\n \"2021-12-29\",\n \"New documentation: PointCloudLibrary\"\n ],\n [\n \"2021-12-27\",\n \"New documentation: Zig\"\n ],\n [\n \"2021-12-26\",\n \"New documentation: GNU Make\"\n ],\n [\n \"2021-12-07\",\n \"New documentation: Prettier\",\n \"Renamed documentation: Web APIs\"\n ],\n [\n \"2021-12-05\",\n \"New documentation: esbuild\"\n ],\n [\n \"2021-12-04\",\n \"New documentation: Vite\"\n ],\n [\n \"2021-11-29\",\n \"New documentation: i3\"\n ],\n [\n \"2021-06-09\",\n \"New documentation: R\"\n ],\n [\n \"2021-05-31\",\n \"New documentation: Web Extensions\"\n ],\n [\n \"2021-05-26\",\n \"New documentations: LaTeX, jq\"\n ],\n [\n \"2021-04-29\",\n \"Added `;\n};\n\nconst back = 'Go back';\n\napp.templates.notFoundPage = () =>\n error(\n \" Page not found. \",\n \" It may be missing from the source documentation or this could be a bug. \",\n back,\n );\n\napp.templates.pageLoadError = () =>\n error(\n \" The page failed to load. \",\n ` It may be missing from the server (try reloading the app) or you could be offline (try installing the documentation for offline usage when online again).
\nIf you're online and you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. `,\n ` ${back} · Reload\n· Retry `,\n );\n\napp.templates.bootError = () =>\n error(\n \" The app failed to load. \",\n ` Check your Internet connection and try reloading.
\nIf you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. `,\n );\n\napp.templates.offlineError = function (reason, exception) {\n if (reason === \"cookie_blocked\") {\n return error(\" Cookies must be enabled to use offline mode. \");\n }\n\n reason = (() => {\n switch (reason) {\n case \"not_supported\":\n return ` DevDocs requires IndexedDB to cache documentations for offline access.
\nUnfortunately your browser either doesn't support IndexedDB or doesn't make it available. `;\n case \"buggy\":\n return ` DevDocs requires IndexedDB to cache documentations for offline access.
\nUnfortunately your browser's implementation of IndexedDB contains bugs that prevent DevDocs from using it. `;\n case \"private_mode\":\n return ` Your browser appears to be running in private mode.
\nThis prevents DevDocs from caching documentations for offline access.`;\n case \"exception\":\n return ` An error occurred when trying to open the IndexedDB database:
\n
\n
\nThis could be because you're browsing in private mode or have disallowed offline storage on the domain. `;\n case \"version\":\n return ` The IndexedDB database was modified with a newer version of the app.
\nReload the page to use offline mode. `;\n case \"empty\":\n return ' The IndexedDB database appears to be corrupted. Try resetting the app. ';\n }\n })();\n\n return error(\"Offline mode is unavailable.\", reason);\n};\n\napp.templates.unsupportedBrowser = `\\\n
Thanks :) `,\n );\n\napp.templates.notifUpdateDocs = () =>\n textNotif(\n \" Documentation updates available. \",\n ' Install them as soon as possible to avoid broken pages. ',\n );\n\napp.templates.notifAnalyticsConsent = () =>\n textNotif(\n \" Tracking cookies \",\n ` We would like to gather usage data about how DevDocs is used through Google Analytics and Gauges. We only collect anonymous traffic information.\nPlease confirm if you accept our tracking cookies. You can always change your decision in the settings.\n
Accept or Decline `,\n );\n" }, { "path": "assets/javascripts/templates/pages/about_tmpl.js", "content": "app.templates.aboutPage = function () {\n let doc;\n const all_docs = app.docs.all().concat(...(app.disabledDocs.all() || []));\n // de-duplicate docs by doc.name\n const docs = [];\n for (doc of all_docs) {\n if (!docs.find((d) => d.name === doc.name)) {\n docs.push(doc);\n }\n }\n return `\\\n\n\n
\nThe current tab will continue to function even when you go offline (provided you installed all the documentations beforehand). `;\n }\n};\n\napp.templates.offlineDoc = function (doc, status) {\n const outdated = doc.isOutdated(status);\n\n let html = `\\\n\n ${doc.fullName} \n ${\n Math.ceil(doc.db_size / 100000) / 10\n } MB \\\n`;\n\n html += !(status && status.installed)\n ? `\\\n- \nOutdated \n - \\\n`\n : `\\\nUp‑to‑date \n \";\n};\n"
},
{
"path": "assets/javascripts/templates/pages/root_tmpl.js.erb",
"content": "app.templates.splash = \"\\\n`;\n<% end %>\n\napp.templates.mobileIntro = `\\\n${$.escape(entry.name)} `;\n};\n"
},
{
"path": "assets/javascripts/templates/path_tmpl.js",
"content": "app.templates.path = function (doc, type, entry) {\n const arrow = '';\n let html = `${doc.fullName}`;\n if (type) {\n html += `${arrow}${\n type.name\n }`;\n }\n if (entry) {\n html += `${arrow}${$.escape(entry.name)}`;\n }\n return html;\n};\n"
},
{
"path": "assets/javascripts/templates/sidebar_tmpl.js",
"content": "const { templates } = app;\n\nconst arrow = '';\n\ntemplates.sidebarDoc = function (doc, options) {\n if (options == null) {\n options = {};\n }\n let link = ``;\n if (options.disabled) {\n link += `Enable`;\n } else {\n link += arrow;\n }\n if (doc.release) {\n link += `${doc.release}`;\n }\n link += `${doc.name}`;\n if (options.fullName || (options.disabled && doc.version)) {\n link += ` ${doc.version}`;\n }\n return link + \"\";\n};\n\ntemplates.sidebarType = (type) =>\n `${arrow}${\n type.count\n }${$.escape(type.name)}`;\n\ntemplates.sidebarEntry = (entry) =>\n `${$.escape(\n entry.name,\n )}`;\n\ntemplates.sidebarResult = function (entry) {\n let addons =\n entry.isIndex() && app.disabledDocs.contains(entry.doc)\n ? `Enable`\n : '';\n if (entry.doc.version && !entry.isIndex()) {\n addons += `${entry.doc.short_version}`;\n }\n return `${addons}${$.escape(\n entry.name,\n )}`;\n};\n\ntemplates.sidebarNoResults = function () {\n let html = '
alt + c shortcut to copy URL of original page.\"\n ],\n [\n \"2021-02-26\",\n \"New documentation: React Bootstrap\"\n ],\n [\n \"2021-01-03\",\n \"New documentation: OCaml\"\n ],\n [\n \"2020-12-23\",\n \"New documentation: GTK\"\n ],\n [\n \"2020-12-07\",\n \"New documentations: Flask, Groovy, Jinja, Werkzeug\"\n ],\n [\n \"2020-12-04\",\n \"New documentation: HAProxy\"\n ],\n [\n \"2020-11-17\",\n \"TensorFlow has been split into TensorFlow Python, TensorFlow C++\"\n ],\n [\n \"2020-11-14\",\n \"New documentations: PyTorch, Spring Boot\"\n ],\n [\n \"2020-01-13\",\n \"New “Automatic” theme: match your browser or system dark mode setting. Enable it in preferences.\"\n ],\n [\n \"2020-01-13\",\n \"New documentation: Gnuplot\"\n ],\n [\n \"2019-10-26\",\n \"New documentation: Sequelize\"\n ], [\n \"2019-10-20\",\n \"New documentations: MariaDB and ReactiveX\"\n ], [\n \"2019-09-02\",\n \"New documentations added over the last 3 weeks: Scala, WordPress, Cypress, SaltStack, Composer, Vue Router, Vuex, Pony, RxJS, Octave, Trio, Django REST Framework, Enzyme and GnuCOBOL\"\n ], [\n \"2019-07-21\",\n \"Fixed several bugs, added an option to automatically download documentation and more.\"\n ], [\n \"2019-07-19\",\n \"Replaced the AppCache with a Service Worker (which makes DevDocs an installable PWA) and fixed layout preferences on Firefox.\"\n ], [\n \"2018-09-23\",\n \"New documentations: Puppeteer and Handlebars.js\"\n ], [\n \"2018-08-12\",\n \"New documentations: Dart and Qt\"\n ], [\n \"2018-07-29\",\n \"New documentations: Bash, Graphite and Pygame\"\n ], [\n \"2018-07-08\",\n \"New documentations: Leaflet, Terraform and Koa\"\n ], [\n \"2018-03-26\",\n \"DevDocs is joining the freeCodeCamp community. Read the announcement here.\"\n ], [\n \"2018-02-04\",\n \"New documentations: Babel, Jekyll and JSDoc\"\n ], [\n \"2017-11-26\",\n \"New documentations: Bluebird, ESLint and Homebrew\"\n ], [\n \"2017-11-18\",\n \"Added print & PDF stylesheet.\\nFeedback welcome on Twitter and GitHub.\"\n ], [\n \"2017-09-10\",\n \"Preferences can now be exported and imported.\"\n ], [\n \"2017-09-03\",\n \"New documentations: D, Nim and Vulkan\"\n ], [\n \"2017-07-23\",\n \"New documentation: Godot\"\n ], [\n \"2017-06-04\",\n \"New documentations: Electron, Pug, and Falcon\"\n ], [\n \"2017-05-14\",\n \"New documentations: Jest, Jasmine and Liquid\"\n ], [\n \"2017-04-30\",\n \"New documentation: OpenJDK\"\n ], [\n \"2017-02-26\",\n \"Refreshed design.\",\n \"Added Preferences.\"\n ], [\n \"2017-01-22\",\n \"New HTTP documentation (thanks Mozilla)\"\n ], [\n \"2016-12-04\",\n \"New documentations: SQLite, Codeception and CodeceptJS\"\n ], [\n \"2016-11-20\",\n \"New documentations: Yarn, Immutable.js and Async\"\n ], [\n \"2016-10-10\",\n \"New documentations: scikit-learn and Statsmodels\"\n ], [\n \"2016-09-18\",\n \"New documentations: pandas and Twig\"\n ], [\n \"2016-09-05\",\n \"New documentations: Fish, Bottle and scikit-image\"\n ], [\n \"2016-08-07\",\n \"New documentation: Docker\"\n ], [\n \"2016-07-31\",\n \"New documentations: Bootstrap 3 and Bootstrap 4\"\n ], [\n \"2016-07-24\",\n \"New documentations: Julia, Crystal and Redux\"\n ], [\n \"2016-07-03\",\n \"New documentations: CMake and Matplotlib\"\n ], [\n \"2016-06-19\",\n \"New documentation: LÖVE\"\n ], [\n \"2016-06-12\",\n \"New documentation: Angular 2\"\n ], [\n \"2016-06-05\",\n \"New documentations: Kotlin and Padrino\"\n ], [\n \"2016-04-24\",\n \"New documentations: NumPy and Apache Pig\"\n ], [\n \"2016-04-17\",\n \"New documentation: Perl\"\n ], [\n \"2016-04-10\",\n \"New documentations: Support tables (caniuse.com), GCC and GNU Fortran\"\n ], [\n \"2016-03-27\",\n \"New documentation: TypeScript\"\n ], [\n \"2016-03-06\",\n \"New documentations: TensorFlow, Haxe and Ansible\"\n ], [\n \"2016-02-28\",\n \"New documentations: CodeIgniter, nginx Lua Module and InfluxData\"\n ], [\n \"2016-02-15\",\n \"New documentations: CakePHP, Chef and Ramda\"\n ], [\n \"2016-01-31\",\n \"New documentations: Erlang and Tcl/Tk\"\n ], [\n \"2016-01-24\",\n \"“Multi-version support” has landed!\"\n ], [\n \"2015-11-22\",\n \"New documentations: Phoenix, Dojo, Relay and Flow\"\n ], [\n \"2015-11-08\",\n \"New documentations: Elixir and Vagrant\"\n ], [\n \"2015-10-18\",\n \"Added a \\\"Copy to clipboard\\\" button inside each code block.\"\n ], [\n \"2015-09-13\",\n \"New documentation: Phalcon\"\n ], [\n \"2015-08-09\",\n \"New documentation: React Native\"\n ], [\n \"2015-08-03\",\n \"Added an icon in the sidebar to constrain the width of the UI (visible when applicable).\"\n ], [\n \"2015-08-02\",\n \"New documentations: Q and OpenTSDB\"\n ], [\n \"2015-07-26\",\n \"Added search aliases (e.g. $ is an alias for jQuery).\\nClick here to see the full list. Feel free to suggest more on GitHub.\",\n \"Added shift + ↓/↑ shortcut for scrolling (same as alt + ↓/↑).\"\n ], [\n \"2015-07-05\",\n \"New documentations: Drupal, Vue.js, Phaser and webpack\"\n ], [\n \"2015-05-24\",\n \"New Rust documentation\"\n ], [\n \"2015-04-26\",\n \"New Apache HTTP Server and npm documentations\"\n ], [\n \"2015-03-22\",\n \"New Meteor and mocha documentations\"\n ], [\n \"2015-02-22\",\n \"Improved HTTP documentation\",\n \"New Minitest documentation\"\n ], [\n \"2015-02-16\",\n \"The sidebar is now resizable (drag & drop).\"\n ], [\n \"2015-02-15\",\n \"New io.js, Symfony, Clojure, Lua and Yii 1.1 documentations\"\n ], [\n \"2015-02-08\",\n \"New dark theme\"\n ], [\n \"2015-01-13\",\n \"Offline mode has landed!\"\n ], [\n \"2014-12-21\",\n \"New React, RethinkDB, Socket.IO, Modernizr and Bower documentations\"\n ], [\n \"2014-11-30\",\n \"New PHPUnit and Nokogiri documentations\"\n ], [\n \"2014-11-16\",\n \"New Python 2 documentation\"\n ], [\n \"2014-11-09\",\n \"New design\\nFeedback welcome on Twitter and GitHub.\"\n ], [\n \"2014-10-19\",\n \"New SVG, Marionette.js, and Mongoose documentations\"\n ], [\n \"2014-10-18\",\n \"New nginx documentation\"\n ], [\n \"2014-10-13\",\n \"New XPath documentation\"\n ], [\n \"2014-09-07\",\n \"Updated the HTML, CSS, JavaScript, and DOM documentations with additional content.\"\n ], [\n \"2014-08-04\",\n \"New Django documentation\"\n ], [\n \"2014-07-27\",\n \"New Markdown documentation\"\n ], [\n \"2014-07-05\",\n \"New Cordova documentation\"\n ], [\n \"2014-07-01\",\n \"New Chai and Sinon documentations\"\n ], [\n \"2014-06-15\",\n \"New RequireJS documentation\"\n ], [\n \"2014-06-14\",\n \"New Haskell documentation\"\n ], [\n \"2014-05-25\",\n \"New Laravel documentation\"\n ], [\n \"2014-05-04\",\n \"New Express, Grunt, and MaxCDN documentations\"\n ], [\n \"2014-04-06\",\n \"New Go documentation\"\n ], [\n \"2014-03-30\",\n \"New C++ documentation\"\n ], [\n \"2014-03-16\",\n \"New Yii documentation\"\n ], [\n \"2014-03-08\",\n \"Added path bar.\"\n ], [\n \"2014-02-22\",\n \"New C documentation\"\n ], [\n \"2014-02-16\",\n \"New Moment.js documentation\"\n ], [\n \"2014-02-12\",\n \"The root/category pages are now included in the search index (e.g. CSS)\"\n ], [\n \"2014-01-19\",\n \"New D3.js and Knockout.js documentations\"\n ], [\n \"2014-01-18\",\n \"DevDocs is now available as a Firefox web app.\"\n ], [\n \"2014-01-12\",\n \"Added alt + g shortcut for searching on Google.\",\n \"Added alt + r shortcut for revealing the current page in the sidebar.\"\n ], [\n \"2013-12-14\",\n \"New PostgreSQL documentation\"\n ], [\n \"2013-12-13\",\n \"New Git and Redis documentations\"\n ], [\n \"2013-11-26\",\n \"New Python documentation\"\n ], [\n \"2013-11-19\",\n \"New Ruby on Rails documentation\"\n ], [\n \"2013-11-16\",\n \"New Ruby documentation\"\n ], [\n \"2013-10-24\",\n \"DevDocs is now open source.\"\n ], [\n \"2013-10-09\",\n \"DevDocs is now available as a Chrome web app.\"\n ], [\n \"2013-09-22\",\n \"New PHP documentation\"\n ], [\n \"2013-09-06\",\n \"New Lo-Dash documentation \",\n \"On mobile devices you can now search a specific documentation by typing its name and Space.\"\n ], [\n \"2013-09-01\",\n \"New jQuery UI and jQuery Mobile documentations\"\n ], [\n \"2013-08-28\",\n \"New smartphone interface\\nTested on iOS 6+ and Android 4.1+\"\n ], [\n \"2013-08-25\",\n \"New Ember.js documentation\"\n ], [\n \"2013-08-18\",\n \"New CoffeeScript documentation\",\n \"URL search now automatically opens the first result.\"\n ], [\n \"2013-08-13\",\n \"New Angular.js documentation\"\n ], [\n \"2013-08-11\",\n \"New Sass and Less documentations\"\n ], [\n \"2013-08-05\",\n \"New Node.js documentation\"\n ], [\n \"2013-08-03\",\n \"Added support for OpenSearch\"\n ], [\n \"2013-07-30\",\n \"New Backbone.js documentation\"\n ], [\n \"2013-07-27\",\n \"You can now customize the list of documentations.\\nNew docs will be hidden by default, but you'll see a notification when there are new releases.\",\n \"New HTTP documentation\"\n ], [\n \"2013-07-15\",\n \"URL search now works with single documentations: devdocs.io/#q=js sort\"\n ], [\n \"2013-07-13\",\n \"Added syntax highlighting\",\n \"Added documentation versions\"\n ], [\n \"2013-07-11\",\n \"New Underscore.js documentation \",\n \"Improved compatibility with tablets\\nA mobile version is planned as soon as other high priority features have been implemented.\"\n ], [\n \"2013-07-10\",\n \"You can now search specific documentations.\\nSimply type the documentation's name and press Tab.\\nThe name is fuzzy matched so you can use abbreviations like js for JavaScript.\"\n ], [\n \"2013-07-08\",\n \"Improved search with fuzzy matching and better results\\nFor example, searching jqmka now returns jQuery.makeArray().\",\n \"DevDocs finally has an icon.\",\n \"space has replaced alt + space for scrolling down.\"\n ], [\n \"2013-07-06\",\n \"New DOM and DOM Events documentations\\nDevDocs now includes almost all reference documents available on the Mozilla Developer Network.\\nBig thank you to Mozilla and all the people that contributed to MDN.\",\n \"Implemented URL search: devdocs.io/#q=sort\"\n ], [\n \"2013-07-02\",\n \"New JavaScript documentation\"\n ], [\n \"2013-06-28\",\n \"DevDocs made the front page of Hacker News!\\nHi everyone — thanks for trying DevDocs.\\nPlease bear with me while I fix bugs and scramble to add more docs.\\nThis is only v1. There's a lot more to come.\"\n ], [\n \"2013-06-18\",\n \"Initial release\"\n ]\n]\n"
},
{
"path": "assets/javascripts/templates/base.js",
"content": "app.templates.render = function (name, value, ...args) {\n const template = app.templates[name];\n\n if (Array.isArray(value)) {\n let result = \"\";\n for (var val of value) {\n result += template(val, ...args);\n }\n return result;\n } else if (typeof template === \"function\") {\n return template(value, ...args);\n } else {\n return template;\n }\n};\n"
},
{
"path": "assets/javascripts/templates/error_tmpl.js",
"content": "const error = function (title, text, links) {\n if (text == null) {\n text = \"\";\n }\n if (links == null) {\n links = \"\";\n }\n if (text) {\n text = `${text}
`;\n }\n if (links) {\n links = `${links}
`;\n }\n return `${title}
${text}${links}\nIf you're online and you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. `,\n ` ${back} · Reload\n· Retry `,\n );\n\napp.templates.bootError = () =>\n error(\n \" The app failed to load. \",\n ` Check your Internet connection and try reloading.
\nIf you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. `,\n );\n\napp.templates.offlineError = function (reason, exception) {\n if (reason === \"cookie_blocked\") {\n return error(\" Cookies must be enabled to use offline mode. \");\n }\n\n reason = (() => {\n switch (reason) {\n case \"not_supported\":\n return ` DevDocs requires IndexedDB to cache documentations for offline access.
\nUnfortunately your browser either doesn't support IndexedDB or doesn't make it available. `;\n case \"buggy\":\n return ` DevDocs requires IndexedDB to cache documentations for offline access.
\nUnfortunately your browser's implementation of IndexedDB contains bugs that prevent DevDocs from using it. `;\n case \"private_mode\":\n return ` Your browser appears to be running in private mode.
\nThis prevents DevDocs from caching documentations for offline access.`;\n case \"exception\":\n return ` An error occurred when trying to open the IndexedDB database:
\n
${exception.name}: ${exception.message} `;\n case \"cant_open\":\n return ` An error occurred when trying to open the IndexedDB database:\n
${exception.name}: ${exception.message}\nThis could be because you're browsing in private mode or have disallowed offline storage on the domain. `;\n case \"version\":\n return ` The IndexedDB database was modified with a newer version of the app.
\nReload the page to use offline mode. `;\n case \"empty\":\n return ' The IndexedDB database appears to be corrupted. Try resetting the app. ';\n }\n })();\n\n return error(\"Offline mode is unavailable.\", reason);\n};\n\napp.templates.unsupportedBrowser = `\\\n
\n
\\\n`;\n"
},
{
"path": "assets/javascripts/templates/notice_tmpl.js",
"content": "const notice = (text) => `Your browser is unsupported, sorry.
\nDevDocs is an API documentation browser which supports the following browsers:\n
- \n
- Recent versions of Firefox, Chrome, or Opera\n
- Safari 11.1+\n
- Edge 17+\n
- iOS 11.3+\n
\n If you're unable to upgrade, we apologize.\n We decided to prioritize speed and new features over support for older browsers.\n
\n Note: if you're already using one of the browsers above, check your settings and add-ons.\n The app uses feature detection, not user agent sniffing.\n
\n — @DevDocs\n
${text}
`;\n\napp.templates.singleDocNotice = (doc) =>\n notice(` You're browsing the ${doc.fullName} documentation. To browse all docs, go to\n${app.config.production_host} (or pressesc). `);\n\napp.templates.disabledDocNotice = () =>\n notice(` This documentation is disabled.\nTo enable it, go to Preferences. `);\n"
},
{
"path": "assets/javascripts/templates/notif_tmpl.js",
"content": "const notif = function (title, html) {\n html = html.replace(/${title}\n${html}\n\\\n`;\n};\n\nconst textNotif = (title, message) =>\n notif(title, `${message}`);\n\napp.templates.notifUpdateReady = () =>\n textNotif(\n 'DevDocs has been updated.',\n 'Reload the page to use the new version.',\n );\n\napp.templates.notifError = () =>\n textNotif(\n \" Oops, an error occurred. \",\n ` Try reloading, and if the problem persists,\nresetting the app.
\nYou can also report this issue on GitHub. `,\n );\n\napp.templates.notifQuotaExceeded = () =>\n textNotif(\n \" The offline database has exceeded its size limitation. \",\n \" Unfortunately this quota can't be detected programmatically, and the database can't be opened while over the quota, so it had to be reset. \",\n );\n\napp.templates.notifCookieBlocked = () =>\n textNotif(\n \" Please enable cookies. \",\n \" DevDocs will not work properly if cookies are disabled. \",\n );\n\napp.templates.notifInvalidLocation = () =>\n textNotif(\n ` DevDocs must be loaded from ${app.config.production_host} `,\n \" Otherwise things are likely to break. \",\n );\n\napp.templates.notifImportInvalid = () =>\n textNotif(\n \" Oops, an error occurred. \",\n \" The file you selected is invalid. \",\n );\n\napp.templates.notifNews = (news) =>\n notif(\n \"Changelog\",\n `
${app.templates.newsList(news, {\n years: false,\n })}
`,\n );\n\napp.templates.notifUpdates = function (docs, disabledDocs) {\n let doc;\n let html = '';\n\n if (docs.length > 0) {\n html += '\";\n }\n\n return notif(\"Updates\", `${html}
`);\n};\n\napp.templates.notifShare = () =>\n textNotif(\n \" Hi there! \",\n ` Like DevDocs? Help us reach more developers by sharing the link with your friends on\nTwitter, Facebook,\nReddit, etc.';\n html += '
\";\n }\n\n if (disabledDocs.length > 0) {\n html += '- ';\n for (doc of docs) {\n html += `
- ${doc.name}`;\n if (doc.release) {\n html += `
→${doc.release}`;\n }\n }\n html += \"
Disabled:';\n html += '
- ';\n for (doc of disabledDocs) {\n html += `
- ${doc.name}`;\n if (doc.release) {\n html += `
→${doc.release}`;\n }\n html += 'Enable';\n }\n html += \"
Thanks :) `,\n );\n\napp.templates.notifUpdateDocs = () =>\n textNotif(\n \" Documentation updates available. \",\n ' Install them as soon as possible to avoid broken pages. ',\n );\n\napp.templates.notifAnalyticsConsent = () =>\n textNotif(\n \" Tracking cookies \",\n ` We would like to gather usage data about how DevDocs is used through Google Analytics and Gauges. We only collect anonymous traffic information.\nPlease confirm if you accept our tracking cookies. You can always change your decision in the settings.\n
Accept or Decline `,\n );\n" }, { "path": "assets/javascripts/templates/pages/about_tmpl.js", "content": "app.templates.aboutPage = function () {\n let doc;\n const all_docs = app.docs.all().concat(...(app.disabledDocs.all() || []));\n // de-duplicate docs by doc.name\n const docs = [];\n for (doc of all_docs) {\n if (!docs.find((d) => d.name === doc.name)) {\n docs.push(doc);\n }\n }\n return `\\\n\n\n
DevDocs: API Documentation Browser
\nDevDocs combines multiple developer documentations in a clean and organized web UI with instant search, offline support, mobile version, dark theme, keyboard shortcuts, and more.\n
DevDocs is free and open source. It was created by Thibaut Courouble and is operated by freeCodeCamp.\n
To keep up-to-date with the latest news:\n
\n\nCopyright and License
\n\n Copyright 2013–2026 Thibaut Courouble and other contributors
\n This software is licensed under the terms of the Mozilla Public License v2.0.
\n You may obtain a copy of the source code at github.com/freeCodeCamp/devdocs.
\n For more information, see the COPYRIGHT\n and LICENSE files.\n\n
Plugins and Extensions
\n\n\nQuestions & Answers
\n- \n
- Where can I suggest new docs and features?\n
- You can suggest and vote for new docs on the Trello board.
\n If you have a specific feature request, add it to the issue tracker.
\n Otherwise, come talk to us in the Discord chat room.\n - Where can I report bugs?\n
- In the issue tracker. Thanks!\n
Credits
\n\nSpecial thanks to:\n
- \n
- Sentry and Gauges for offering a free account to DevDocs\n
- MaxCDN, Shopify, JetBrains and Code School for sponsoring DevDocs in the past\n
- Heroku and New Relic for providing awesome free service\n
- Jeremy Kratz for the C/C++ logo\n
\n \n
\n
\n\n| Documentation\n | Copyright/License\n | Source code\n ${docs\n .map(\n (doc) =>\n ` |
|---|---|---|
| ${doc.name} | ${doc.attribution} | Source code |
Privacy Policy
\n- \n
- devdocs.io (\"App\") is operated by freeCodeCamp (\"We\").\n
- We do not collect personal information through the app.\n
- We use Google Analytics and Gauges to collect anonymous traffic information if you have given consent to this. You can change your decision in the settings.\n
- We use Sentry to collect crash data and improve the app.\n
- The app uses cookies to store user preferences.\n
- By using the app, you signify your acceptance of this policy. If you do not agree to this policy, please do not use the app.\n
- If you have any questions regarding privacy, please email privacy@freecodecamp.org.\n
User Guide
\n\nManaging Documentations
\n\n Documentations can be enabled and disabled in the Preferences.\n Alternatively, you can enable a documentation by searching for it in the main search\n and clicking the \"Enable\" link in the results.\n For faster and better search, only enable the documentations you plan on actively using.\n
\n Once a documentation is enabled, it becomes part of the search and its content can be downloaded for offline access — and faster page loads when online — in the Offline area.\n\n
Search
\n\n The search is case-insensitive and ignores whitespace. It supports fuzzy matching\n (e.g. bgcp matches background-clip)\n as well as aliases (full list below).\n
- \n
- Searching a single documentation\n
- \n The search can be scoped to a single documentation by typing its name (or an abbreviation)\n and pressing
tab(spaceon mobile).\n For example, to search the JavaScript documentation, enterjavascript\n orjs, thentab.
\n To clear the current scope, empty the search field and hitbackspaceor\nesc.\n - Prefilling the search field\n
- \n The search can be prefilled from the URL by visiting devdocs.io/#q=keyword.\n Characters after
#q=will be used as search query.
\n To search a single documentation, add its name (or an abbreviation) and a space before the keyword:\n devdocs.io/#q=js date.\n - Searching using the address bar\n
- \n DevDocs supports OpenSearch. It can easily be installed as a search engine on most web browsers:\n
- \n
- On Chrome, the setup is done automatically. Simply press
tabwhen devdocs.io is autocompleted\n in the omnibox (to set a custom keyword, click Manage search engines\\u2026 in Chrome's settings).\n - On Firefox, add the search from the address bar:\n Click ••• in the address bar, and select Add Search Engine. Then, you can add a keyword for this search engine in the preferences.\n
- On Chrome, the setup is done automatically. Simply press
\n Note: the above search features only work for documentations that are enabled.\n\n
Keyboard Shortcuts
\nSidebar
\n- \n
- \n ${arrowScroll ? '
shift+ ' : \"\"}\n↓\n↑\n - Move selection\n
- \n ${arrowScroll ? '
shift+ ' : \"\"}\n→\n←\n - Show/hide sub-list\n
- \n
enter\n - Open selection\n
- \n
${ctrlKey} + enter\n - Open selection in a new tab\n
- \n
alt + r\n - Reveal current page in sidebar\n
Browsing
\n- \n
- \n
${navKey} + ←\n${navKey} + →\n - Go back/forward\n
- \n ${\n arrowScroll\n ? '
↓' +\n '↑'\n : 'alt + ↓' +\n 'alt + ↑' +\n \"
\" +\n 'shift + ↓' +\n 'shift + ↑'\n }\n - Scroll step by step
\n - \n
space\nshift + space\n - Scroll screen by screen\n
- \n
${ctrlKey} + ↑\n${ctrlKey} + ↓\n - Scroll to the top/bottom\n
- \n
alt + f\n - Focus first link in the content area
(press tab to focus the other links)\n
App
\n- \n
- \n
ctrl + ,\n - Open preferences\n
- \n
esc\n - Clear search field / reset UI\n
- \n
?\n - Show this page\n
Miscellaneous
\n- \n
- \n
alt + c\n - Copy URL of original page\n
- \n
alt + o\n - Open original page\n
- \n
alt + g\n - Search on Google\n
- \n
alt + s\n - Search on Stack Overflow\n
- \n
alt + d\n - Search on DuckDuckGo\n
\n Tip: If the cursor is no longer in the search field, press / or\n continue to type and it will refocus the search field and start showing new results.\n\n
Search Aliases
\n\n \n
\n \n
\n
\n| Word\n | Alias\n ${aliases_one\n .map(\n ([key, value]) =>\n ` |
|---|---|
| ${key} | ${value}`,\n )\n .join(\"\")}\n |
| Word\n | Alias\n ${aliases_two\n .map(\n ([key, value]) =>\n ` |
|---|---|
| ${key} | ${value}`,\n )\n .join(\"\")}\n |
Feel free to suggest new aliases on GitHub.\\\n`;\n};\n" }, { "path": "assets/javascripts/templates/pages/news_tmpl.js.erb", "content": "//= depend_on news.json\n\napp.templates.newsPage = () => `
Changelog
\n\nFor the latest news, follow @DevDocs.
\nFor development updates, follow the project on GitHub.\n
${app.templates.newsList(app.news)}
`;\n\napp.templates.newsList = function(news, options = {}) {\n let year = new Date().getUTCFullYear();\n let result = '';\n\n for (let value of news) {\n const date = new Date(value[0]);\n if ((options.years !== false) && (year !== date.getUTCFullYear())) {\n year = date.getUTCFullYear();\n result += `${year}
`;\n }\n result += newsItem(date, value.slice(1));\n }\n\n return result;\n};\n\nconst MONTHS = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];\n\nvar newsItem = function(date, news) {\n date = `${MONTHS[date.getUTCMonth()]} ${date.getUTCDate()}`;\n let result = '';\n\n for (let i = 0; i < news.length; i++) {\n let text = news[i];\n text = text.split(\"\\n\");\n const title = `${text.shift()}`;\n result += `${i === 0 ? date : ''} ${title} ${text.join('
')}
`;\n }\n\n return result;\n};\n\napp.news = <%= App.news.to_json %>\n"
},
{
"path": "assets/javascripts/templates/pages/offline_tmpl.js",
"content": "app.templates.offlinePage = (docs) => `\\\n')}
Offline Documentation
\n\n\n \n
\n\n\n \n
\n\n \n
\n
\n| Documentation | \nSize | \nStatus | \nAction | \n
|---|
Note: your browser may delete DevDocs's offline data if your computer is running low on disk space and you haven't used the app in a while. Load this page before going offline to make sure the data is still there.\n
Questions & Answers
\n- \n
- How does this work?\n
- Each page is cached as a key-value pair in IndexedDB (downloaded from a single file).
\n The app also uses Service Workers and localStorage to cache the assets and index files.\n - Can I close the tab/browser?\n
- ${canICloseTheTab()}\n
- What if I don't update a documentation?\n
- You'll see outdated content and some pages will be missing or broken, because the rest of the app (including data for the search and sidebar) uses a different caching mechanism that's updated automatically.\n
- I found a bug, where do I report it?\n
- In the issue tracker. Thanks!\n
- How do I uninstall/reset the app?\n
- Click here.\n
- Why aren't all documentations listed above?\n
- You have to enable them first.\n
ENABLE_SERVICE_WORKER environment variable to true)\";\n }\n\n return ` No. Service Workers ${reason}, so loading devdocs.io offline won't work.\nThe current tab will continue to function even when you go offline (provided you installed all the documentations beforehand). `;\n }\n};\n\napp.templates.offlineDoc = function (doc, status) {\n const outdated = doc.isOutdated(status);\n\n let html = `\\\n
DevDocs
\";\n\n<% if App.development? %>\napp.templates.intro = `\\\n\\\n`;\n<% else %>\napp.templates.intro = `\\\n
\n Stop showing this message\n
Welcome!
\nDevDocs combines multiple API documentations in a fast, organized, and searchable interface.\n Here's what you should know before you start:\n
- \n
- Open the Preferences to enable more docs and customize the UI.\n
- You don't have to use your mouse — see the list of keyboard shortcuts or press ?.\n
- The search supports fuzzy matching (e.g. \"bgcp\" brings up \"background-clip\").\n
- To search a specific documentation, type its name (or an abbr.), then Tab.\n
- You can search using your browser's address bar — learn how.\n
- DevDocs works offline, on mobile, and can be installed as web app.\n
- For the latest news, follow @DevDocs.\n
- DevDocs is free and open source.\n
![](\"https://img.shields.io/github/stars/freeCodeCamp/devdocs.svg?style=social\")
\n - And if you're new to coding, check out freeCodeCamp's open source curriculum.\n
Happy coding!\n
\n
\\\n`;\n\napp.templates.androidWarning = `\\\nWelcome!
\nDevDocs combines multiple API documentations in a fast, organized, and searchable interface.\n Here's what you should know before you start:\n
- \n
- Pick your docs in the Preferences.\n
- The search supports fuzzy matching.\n
- To search a specific documentation, type its name (or an abbr.), then Space.\n
- For the latest news, follow @DevDocs.\n
- DevDocs is open source.\n
Happy coding!\n Stop showing this message\n
\n
\\\n`;\n"
},
{
"path": "assets/javascripts/templates/pages/settings_tmpl.js",
"content": "const themeOption = ({ label, value }, settings) => `\\\n\\\n`;\n\napp.templates.settingsPage = (settings) => `\\\nHi there
\nDevDocs is running inside an Android WebView. Some features may not work properly.\n
If you downloaded an app called DevDocs on the Play Store, please uninstall it — it's made by someone who is using (and profiting from) the name DevDocs without permission.\n
To install DevDocs on your phone, visit devdocs.io in Chrome and select \"Add to home screen\" in the menu.\n
Preferences
\n\n\n
\n\nTheme:
\n\n ${\n settings.autoSupported\n ? themeOption(\n {\n label: \"Automatic Matches system setting\",\n value: \"auto\",\n },\n settings,\n )\n : \"\"\n }\n ${themeOption({ label: \"Light\", value: \"default\" }, settings)}\n ${themeOption({ label: \"Dark\", value: \"dark\" }, settings)}\n
\n\n
\n\nGeneral:
\n\n\n \n \n \n \n \n \n \n
\n\n
\n\nScrolling:
\n\n\n \n \n \n \n \n
\n\n \n \n\n
\n \\\n`;\n" }, { "path": "assets/javascripts/templates/pages/type_tmpl.js", "content": "app.templates.typePage = (type) => {\n return `
${type.doc.fullName} / ${type.name}
\n- ${app.templates.render(\n \"typePageEntry\",\n type.entries(),\n )}
No results.
';\n if (!app.isSingleDoc() && !app.disabledDocs.isEmpty()) {\n html += `\\\nNote: documentations must be enabled to appear in the search.
\\\n`;\n }\n return html;\n};\n\ntemplates.sidebarPageLink = (count) =>\n `Show more\\u2026 (${count})`;\n\ntemplates.sidebarLabel = function (doc, options) {\n if (options == null) {\n options = {};\n }\n let label = '`;\n};\n\ntemplates.sidebarVersionedDoc = function (doc, versions, options) {\n if (options == null) {\n options = {};\n }\n let html = `${arrow}${doc.name}
${versions}
`\n );\n};\n\ntemplates.sidebarDisabled = (options) =>\n `${arrow}Disabled (${options.count}) Customize
`;\n\ntemplates.sidebarDisabledList = (html) =>\n `${html}
`;\n\ntemplates.sidebarDisabledVersionedDoc = (doc, versions) =>\n `${arrow}${doc.name}${versions}
`;\n\ntemplates.docPickerHeader =\n 'Documentation Enable
';\n\ntemplates.docPickerNote = `\\\nTip: for faster and better search results, select only the docs you need.
\nVote for new documentation\\\n`;\n"
},
{
"path": "assets/javascripts/templates/tip_tmpl.js",
"content": "app.templates.tipKeyNav = () => `\\\n\n ProTip\n (click to dismiss)\n
\n Hit ${\n app.settings.get(\"arrowScroll\") ? 'shift +' : \"\"\n } ↓ ↑ ← → to navigate the sidebar.
\n Hit space / shift space${\n app.settings.get(\"arrowScroll\")\n ? ' or ↓/↑'\n : ', alt ↓/↑ or shift ↓/↑'\n } to scroll the page.\n
\n See all keyboard shortcuts\\\n`;\n" }, { "path": "assets/javascripts/tracking.js", "content": "try {\n if (app.config.env === \"production\") {\n if (Cookies.get(\"analyticsConsent\") === \"1\") {\n (function (i, s, o, g, r, a, m) {\n i[\"GoogleAnalyticsObject\"] = r;\n (i[r] =\n i[r] ||\n function () {\n (i[r].q = i[r].q || []).push(arguments);\n }),\n (i[r].l = 1 * new Date());\n (a = s.createElement(o)), (m = s.getElementsByTagName(o)[0]);\n a.async = 1;\n a.src = g;\n m.parentNode.insertBefore(a, m);\n })(\n window,\n document,\n \"script\",\n \"https://www.google-analytics.com/analytics.js\",\n \"ga\",\n );\n ga(\"create\", \"UA-5544833-12\", \"devdocs.io\");\n page.track(function () {\n ga(\"send\", \"pageview\", {\n page: location.pathname + location.search + location.hash,\n dimension1:\n app.router.context &&\n app.router.context.doc &&\n app.router.context.doc.slug_without_version,\n });\n });\n\n page.track(function () {\n if (window._gauges) _gauges.push([\"track\"]);\n else\n (function () {\n var _gauges = _gauges || [];\n !(function () {\n var a = document.createElement(\"script\");\n (a.type = \"text/javascript\"),\n (a.async = !0),\n (a.id = \"gauges-tracker\"),\n a.setAttribute(\"data-site-id\", \"51c15f82613f5d7819000067\"),\n (a.src = \"https://secure.gaug.es/track.js\");\n var b = document.getElementsByTagName(\"script\")[0];\n b.parentNode.insertBefore(a, b);\n })();\n })();\n });\n } else {\n resetAnalytics();\n }\n }\n} catch (e) {}\n" }, { "path": "assets/javascripts/vendor/cookies.js", "content": "/*\n * Cookies.js - 1.2.3 (patched for SameSite=Strict and secure=true)\n * https://github.com/ScottHamper/Cookies\n *\n * This is free and unencumbered software released into the public domain.\n */\n(function (global, undefined) {\n \"use strict\";\n\n var factory = function (window) {\n if (typeof window.document !== \"object\") {\n throw new Error(\n \"Cookies.js requires a `window` with a `document` object\",\n );\n }\n\n var Cookies = function (key, value, options) {\n return arguments.length === 1\n ? Cookies.get(key)\n : Cookies.set(key, value, options);\n };\n\n // Allows for setter injection in unit tests\n Cookies._document = window.document;\n\n // Used to ensure cookie keys do not collide with\n // built-in `Object` properties\n Cookies._cacheKeyPrefix = \"cookey.\"; // Hurr hurr, :)\n\n Cookies._maxExpireDate = new Date(\"Fri, 31 Dec 9999 23:59:59 UTC\");\n\n Cookies.defaults = {\n path: \"/\",\n SameSite: \"Strict\",\n secure: true,\n };\n\n Cookies.get = function (key) {\n if (Cookies._cachedDocumentCookie !== Cookies._document.cookie) {\n Cookies._renewCache();\n }\n\n var value = Cookies._cache[Cookies._cacheKeyPrefix + key];\n\n return value === undefined ? undefined : decodeURIComponent(value);\n };\n\n Cookies.set = function (key, value, options) {\n options = Cookies._getExtendedOptions(options);\n options.expires = Cookies._getExpiresDate(\n value === undefined ? -1 : options.expires,\n );\n\n Cookies._document.cookie = Cookies._generateCookieString(\n key,\n value,\n options,\n );\n\n return Cookies;\n };\n\n Cookies.expire = function (key, options) {\n return Cookies.set(key, undefined, options);\n };\n\n Cookies._getExtendedOptions = function (options) {\n return {\n path: (options && options.path) || Cookies.defaults.path,\n domain: (options && options.domain) || Cookies.defaults.domain,\n SameSite: (options && options.SameSite) || Cookies.defaults.SameSite,\n expires: (options && options.expires) || Cookies.defaults.expires,\n secure:\n options && options.secure !== undefined\n ? options.secure\n : Cookies.defaults.secure,\n };\n };\n\n Cookies._isValidDate = function (date) {\n return (\n Object.prototype.toString.call(date) === \"[object Date]\" &&\n !isNaN(date.getTime())\n );\n };\n\n Cookies._getExpiresDate = function (expires, now) {\n now = now || new Date();\n\n if (typeof expires === \"number\") {\n expires =\n expires === Infinity\n ? Cookies._maxExpireDate\n : new Date(now.getTime() + expires * 1000);\n } else if (typeof expires === \"string\") {\n expires = new Date(expires);\n }\n\n if (expires && !Cookies._isValidDate(expires)) {\n throw new Error(\n \"`expires` parameter cannot be converted to a valid Date instance\",\n );\n }\n\n return expires;\n };\n\n Cookies._generateCookieString = function (key, value, options) {\n key = key.replace(/[^#$&+\\^`|]/g, encodeURIComponent);\n key = key.replace(/\\(/g, \"%28\").replace(/\\)/g, \"%29\");\n value = (value + \"\").replace(\n /[^!#$&-+\\--:<-\\[\\]-~]/g,\n encodeURIComponent,\n );\n options = options || {};\n\n var cookieString = key + \"=\" + value;\n cookieString += options.path ? \";path=\" + options.path : \"\";\n cookieString += options.domain ? \";domain=\" + options.domain : \"\";\n cookieString += options.SameSite ? \";SameSite=\" + options.SameSite : \"\";\n cookieString += options.expires\n ? \";expires=\" + options.expires.toUTCString()\n : \"\";\n cookieString += options.secure ? \";secure\" : \"\";\n\n return cookieString;\n };\n\n Cookies._getCacheFromString = function (documentCookie) {\n var cookieCache = {};\n var cookiesArray = documentCookie ? documentCookie.split(\"; \") : [];\n\n for (var i = 0; i < cookiesArray.length; i++) {\n var cookieKvp = Cookies._getKeyValuePairFromCookieString(\n cookiesArray[i],\n );\n\n if (\n cookieCache[Cookies._cacheKeyPrefix + cookieKvp.key] === undefined\n ) {\n cookieCache[Cookies._cacheKeyPrefix + cookieKvp.key] =\n cookieKvp.value;\n }\n }\n\n return cookieCache;\n };\n\n Cookies._getKeyValuePairFromCookieString = function (cookieString) {\n // \"=\" is a valid character in a cookie value according to RFC6265, so cannot `split('=')`\n var separatorIndex = cookieString.indexOf(\"=\");\n\n // IE omits the \"=\" when the cookie value is an empty string\n separatorIndex =\n separatorIndex < 0 ? cookieString.length : separatorIndex;\n\n var key = cookieString.substr(0, separatorIndex);\n var decodedKey;\n try {\n decodedKey = decodeURIComponent(key);\n } catch (e) {\n if (console && typeof console.error === \"function\") {\n console.error('Could not decode cookie with key \"' + key + '\"', e);\n }\n }\n\n return {\n key: decodedKey,\n value: cookieString.substr(separatorIndex + 1), // Defer decoding value until accessed\n };\n };\n\n Cookies._renewCache = function () {\n Cookies._cache = Cookies._getCacheFromString(Cookies._document.cookie);\n Cookies._cachedDocumentCookie = Cookies._document.cookie;\n };\n\n Cookies._areEnabled = function () {\n var testKey = \"cookies.js\";\n var areEnabled = Cookies.set(testKey, 1).get(testKey) === \"1\";\n Cookies.expire(testKey);\n return areEnabled;\n };\n\n Cookies.enabled = Cookies._areEnabled();\n\n return Cookies;\n };\n var cookiesExport =\n global && typeof global.document === \"object\" ? factory(global) : factory;\n\n // AMD support\n if (typeof define === \"function\" && define.amd) {\n define(function () {\n return cookiesExport;\n });\n // CommonJS/Node.js support\n } else if (typeof exports === \"object\") {\n // Support Node.js specific `module.exports` (which can be a function)\n if (typeof module === \"object\" && typeof module.exports === \"object\") {\n exports = module.exports = cookiesExport;\n }\n // But always support CommonJS module 1.1.1 spec (`exports` cannot be a function)\n exports.Cookies = cookiesExport;\n } else {\n global.Cookies = cookiesExport;\n }\n})(typeof window === \"undefined\" ? this : window);\n" }, { "path": "assets/javascripts/vendor/mathml.js", "content": "/* This Source Code Form is subject to the terms of the Mozilla Public\n * License, v. 2.0. If a copy of the MPL was not distributed with this\n * file, You can obtain one at http://mozilla.org/MPL/2.0/.\n * Adapted from: https://github.com/fred-wang/mathml.css */\n\n(function () {\n window.addEventListener(\"load\", function () {\n var box, div, link, namespaceURI;\n // First check whether the page contains any