public/icons/*your_scraper_name*/ directory:
+ - [ ] `16.png`: a 16×16 pixel icon for the doc
+ - [ ] `16@2x.png`: a 32×32 pixel icon for the doc
+ - [ ] `SOURCE`: A text file containing the URL to the page the image can be found on or the URL of the original image itself
+
+
+
+
+If you're updating existing documentation to its latest version, please ensure that you have:
+
+- [ ] Updated the versions and releases in the scraper file
+- [ ] Ensured the license is up-to-date
+- [ ] Ensured the icons and the `SOURCE` file in public/icons/*your_scraper_name*/ are up-to-date if the documentation has a custom icon
+- [ ] Ensured `self.links` contains up-to-date urls if `self.links` is defined
+- [ ] Tested the changes locally to ensure:
+ - The scraper still works without errors
+ - The scraped documentation still looks consistent with the rest of DevDocs
+ - The categorization of entries is still good
diff --git a/.github/no-response.yml b/.github/no-response.yml
new file mode 100644
index 0000000000..ab687134c8
--- /dev/null
+++ b/.github/no-response.yml
@@ -0,0 +1,8 @@
+daysUntilClose: 30
+responseRequiredLabel: needs-info
+closeComment: >
+ This issue has been automatically closed because there has been no response
+ to our request for more information from the original author. With only the
+ information that’s currently in the issue, we don’t have enough information
+ to take action. Please comment if you have or find the answer we need so we
+ can investigate further.
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
new file mode 100644
index 0000000000..e83dfeb3df
--- /dev/null
+++ b/.github/workflows/build.yml
@@ -0,0 +1,31 @@
+name: Deploy
+
+on:
+ push:
+ branches:
+ - main
+
+jobs:
+ deploy:
+ name: Deploy to Heroku
+ runs-on: ubuntu-24.04
+ if: github.repository == 'freeCodeCamp/devdocs'
+ steps:
+ - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2.7.0
+ - name: Set up Ruby
+ uses: ruby/setup-ruby@8aeb6ff8030dd539317f8e1769a044873b56ea71 # v1.268.0
+ with:
+ bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+ - name: Run tests
+ run: bundle exec rake
+ - name: Install Heroku CLI
+ run: |
+ curl https://cli-assets.heroku.com/install.sh | sh
+ - name: Deploy to Heroku
+ uses: akhileshns/heroku-deploy@e3eb99d45a8e2ec5dca08735e089607befa4bf28 # v3.14.15
+ with:
+ heroku_api_key: ${{secrets.HEROKU_API_KEY}}
+ heroku_app_name: "devdocs"
+ heroku_email: "team@freecodecamp.com"
+ dontuseforce: true # --force should never be necessary
+ dontautocreate: true # The app exists, it should not be created
diff --git a/.github/workflows/docker-build.yml b/.github/workflows/docker-build.yml
new file mode 100644
index 0000000000..dd0ac8a062
--- /dev/null
+++ b/.github/workflows/docker-build.yml
@@ -0,0 +1,54 @@
+name: Build and Push Docker Images
+on:
+ schedule:
+ - cron: '0 0 1 * *' # Run monthly on the 1st
+ workflow_dispatch: # Allow manual triggers
+env:
+ REGISTRY: ghcr.io
+ IMAGE_NAME: ${{ github.repository }}
+jobs:
+ build-and-push:
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ packages: write
+ strategy:
+ matrix:
+ variant:
+ - name: regular
+ file: Dockerfile
+ suffix: ''
+ - name: alpine
+ file: Dockerfile-alpine
+ suffix: '-alpine'
+
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+ with:
+ persist-credentials: false
+
+ - name: Log in to the Container registry
+ uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3
+ with:
+ registry: ${{ env.REGISTRY }}
+ username: ${{ github.actor }}
+ password: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Extract metadata for Docker
+ id: meta
+ uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5
+ with:
+ images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+ tags: |
+ type=raw,value=latest${{ matrix.variant.suffix }}
+ type=raw,value={{date 'YYYYMMDD'}}${{ matrix.variant.suffix }}
+
+ - name: Build and push image
+ uses: docker/build-push-action@ca052bb54ab0790a636c9b5f226502c73d547a25 # v5
+ with:
+ context: .
+ file: ./${{ matrix.variant.file }}
+ push: true
+ tags: ${{ steps.meta.outputs.tags }}
+ labels: ${{ steps.meta.outputs.labels }}
diff --git a/.github/workflows/schedule-doc-report.yml b/.github/workflows/schedule-doc-report.yml
new file mode 100644
index 0000000000..f5d1eb1213
--- /dev/null
+++ b/.github/workflows/schedule-doc-report.yml
@@ -0,0 +1,18 @@
+name: Generate documentation versions report
+on:
+ schedule:
+ - cron: '17 4 1 * *'
+ workflow_dispatch:
+
+jobs:
+ report:
+ runs-on: ubuntu-24.04
+ if: github.repository == 'freeCodeCamp/devdocs'
+ steps:
+ - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2.7.0
+ - name: Set up Ruby
+ uses: ruby/setup-ruby@8aeb6ff8030dd539317f8e1769a044873b56ea71 # v1.268.0
+ with:
+ bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+ - name: Generate report
+ run: bundle exec thor updates:check --github-token ${{ secrets.DEVDOCS_BOT_PAT }} --upload
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
new file mode 100644
index 0000000000..953d3e0256
--- /dev/null
+++ b/.github/workflows/test.yml
@@ -0,0 +1,18 @@
+name: Ruby tests
+
+on:
+ pull_request:
+ branches:
+ - main
+
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+ - name: Set up Ruby
+ uses: ruby/setup-ruby@8aeb6ff8030dd539317f8e1769a044873b56ea71 # v1.268.0
+ with:
+ bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+ - name: Run tests
+ run: bundle exec rake
diff --git a/.gitignore b/.gitignore
index 8b22282640..bbf749a452 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,10 +1,14 @@
.DS_Store
.bundle
-*.pxm
-*.sketch
+log
tmp
public/assets
public/fonts
public/docs/**/*
-!public/docs/docs.json
-!public/docs/**/index.json
+docs/**/*
+!docs/*.md
+/vendor
+*.tar
+*.tar.bz2
+*.tar.gz
+*.zip
diff --git a/.image_optim.yml b/.image_optim.yml
new file mode 100644
index 0000000000..f846feb462
--- /dev/null
+++ b/.image_optim.yml
@@ -0,0 +1,22 @@
+verbose: false
+skip_missing_workers: true
+allow_lossy: true
+threads: 1
+advpng: false
+gifsicle:
+ interlace: false
+ level: 3
+ careful: true
+jhead: false
+jpegoptim:
+ strip: all
+ max_quality: 100
+jpegrecompress: false
+jpegtran: false
+optipng: false
+pngcrush: false
+pngout: false
+pngquant:
+ quality: !ruby/range 80..99
+ speed: 3
+svgo: false
diff --git a/.ruby-version b/.ruby-version
index a6254504e4..2aa5131992 100644
--- a/.ruby-version
+++ b/.ruby-version
@@ -1 +1 @@
-2.3.1
\ No newline at end of file
+3.4.7
diff --git a/.slugignore b/.slugignore
new file mode 100644
index 0000000000..9daeafb986
--- /dev/null
+++ b/.slugignore
@@ -0,0 +1 @@
+test
diff --git a/.tool-versions b/.tool-versions
new file mode 100644
index 0000000000..3f03c7a73d
--- /dev/null
+++ b/.tool-versions
@@ -0,0 +1 @@
+ruby 3.4.7
diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index f819a513ae..0000000000
--- a/.travis.yml
+++ /dev/null
@@ -1 +0,0 @@
-language: ruby
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
deleted file mode 100644
index fd4bd5349c..0000000000
--- a/CONTRIBUTING.md
+++ /dev/null
@@ -1,83 +0,0 @@
-# Contributing to DevDocs
-
-Want to contribute? Great. Please review the following guidelines carefully and search for existing issues before opening a new one.
-
-**Table of Contents:**
-
-1. [Reporting bugs](#reporting-bugs)
-2. [Requesting new features](#requesting-new-features)
-3. [Requesting new documentations](#requesting-new-documentations)
-4. [Contributing code and features](#contributing-code-and-features)
-5. [Contributing new documentations](#contributing-new-documentations)
-6. [Updating existing documentations](#updating-existing-documentations)
-7. [Other contributions](#other-contributions)
-8. [Coding conventions](#coding-conventions)
-9. [Questions?](#questions)
-
-## Reporting bugs
-
-1. Update to the most recent master release; the bug may already be fixed.
-2. Search for existing issues; it's possible someone has already encountered this bug.
-3. Try to isolate the problem and include steps to reproduce it.
-4. Share as much information as possible (e.g. browser/OS environment, log output, stack trace, screenshots, etc.).
-
-## Requesting new features
-
-1. Search for similar feature requests; someone may have already requested it.
-2. Make sure your feature fits DevDocs's [vision](https://github.com/Thibaut/devdocs/blob/master/README.md#vision).
-3. Provide a clear and detailed explanation of the feature and why it's important to add it.
-
-For general feedback and ideas, please use the [mailing list](https://groups.google.com/d/forum/devdocs).
-
-## Requesting new documentations
-
-Please don't open issues to request new documentations.
-Use the [Trello board](https://trello.com/b/6BmTulfx/devdocs-documentation) where everyone can vote.
-
-## Contributing code and features
-
-1. Search for existing issues; someone may already be working on a similar feature.
-2. Before embarking on any significant pull request, please open an issue describing the changes you intend to make. Otherwise you risk spending a lot of time working on something I may not want to merge. This also tells other contributors that you're working on the feature.
-3. Follow the [coding conventions](#coding-conventions).
-4. If you're modifying the Ruby code, include tests and ensure they pass.
-5. Try to keep your pull request small and simple.
-6. When it makes sense, squash your commits into a single commit.
-7. Describe all your changes in the commit message and/or pull request.
-
-## Contributing new documentations
-
-See the [wiki](https://github.com/Thibaut/devdocs/wiki) to learn how to add new documentations.
-
-**Important:** the documentation's license must permit alteration, redistribution and commercial use, and the documented software must be released under an open source license. Feel free to get in touch if you're not sure if a documentation meets those requirements.
-
-In addition to the [guidelines for contributing code](#contributing-code-and-features), the following guidelines apply to pull requests that add a new documentation:
-
-* Your documentation must come with an official icon, in both 1x and 2x resolutions (16x16 and 32x32 pixels). This is important because icons are the only thing differentiating search results in the UI.
-* DevDocs favors quality over quantity. Your documentation should only include documents that most developers may want to read semi-regularly. By reducing the number of entries, we make it easier to find other, more relevant entries.
-* Remove as much content and HTML markup as possible, particularly content not associated with any entry (e.g. introduction, changelog, etc.).
-* Names must be as short as possible and unique across the documentation.
-* The number of types (categories) should ideally be less than 100.
-* Don't modify the icon sprite. I'll do it after your pull request is merged.
-
-## Updating existing documentations
-
-Please don't submit a pull request updating the version number of a documentation, unless a change is required in the scraper and you've verified that it works.
-
-To ask that an existing documentation be updated, please use the [Trello board](https://trello.com/c/2B0hmW7M/52-request-updates-here).
-
-## Other contributions
-
-Besides new docs and features, here are other ways you can contribute:
-
-* **Improve our copy.** English isn't my first language so if you notice grammatical or usage errors, feel free to submit a pull request — it'll be much appreciated.
-* **Participate in the issue tracker.** Your opinion matters — feel free to add comments to existing issues. You're also welcome to participate to the [mailing list](https://groups.google.com/d/forum/devdocs).
-
-## Coding conventions
-
-* two spaces; no tabs
-* no trailing whitespace; blank lines should have no spaces; new line at end-of-file
-* use the same coding style as the rest of the codebase
-
-## Questions?
-
-If you have any questions, please feel free to ask on the [mailing list](https://groups.google.com/d/forum/devdocs).
diff --git a/COPYRIGHT b/COPYRIGHT
index c9f04ecb61..374054bdbf 100644
--- a/COPYRIGHT
+++ b/COPYRIGHT
@@ -1,13 +1,13 @@
-Copyright 2013-2016 Thibaut Courouble and other contributors
+Copyright 2013-2025 Thibaut Courouble and other contributors
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/.
Please do not use the name DevDocs to endorse or promote products
-derived from this software without my permission, except as may be
-necessary to comply with the notice/attribution requirements.
+derived from this software without the maintainers' permission, except
+as may be necessary to comply with the notice/attribution requirements.
-I also wish that any documentation file generated using this software
+We 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.
\ No newline at end of file
+credit where credit's due. Thanks.
diff --git a/Dockerfile b/Dockerfile
index 3e873d25f6..aff0ae395a 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,17 +1,25 @@
+FROM ruby:3.4.7
+ENV LANG=C.UTF-8
+ENV ENABLE_SERVICE_WORKER=true
-FROM ruby:2.3.1
-MAINTAINER Conor Heine ` elements, expand them.
+$.openDetailsAncestors = function (el) {
+ while (el) {
+ if (el.tagName === "DETAILS") {
+ el.open = true;
+ }
+ el = el.parentElement;
+ }
+}
+
+let smoothScroll =
+ (smoothStart =
+ smoothEnd =
+ smoothDistance =
+ smoothDuration =
+ null);
+
+$.smoothScroll = function (el, end) {
+ smoothEnd = end;
+
+ if (smoothScroll) {
+ const newDistance = smoothEnd - smoothStart;
+ smoothDuration += Math.min(300, Math.abs(smoothDistance - newDistance));
+ smoothDistance = newDistance;
+ return;
+ }
+
+ smoothStart = el.scrollTop;
+ smoothDistance = smoothEnd - smoothStart;
+ smoothDuration = Math.min(300, Math.abs(smoothDistance));
+ const startTime = Date.now();
+
+ smoothScroll = function () {
+ const p = Math.min(1, (Date.now() - startTime) / smoothDuration);
+ const y = Math.max(
+ 0,
+ Math.floor(
+ smoothStart +
+ smoothDistance * (p < 0.5 ? 2 * p * p : p * (4 - p * 2) - 1),
+ ),
+ );
+ el.scrollTop = y;
+ if (p === 1) {
+ return (smoothScroll = null);
+ } else {
+ return requestAnimationFrame(smoothScroll);
+ }
+ };
+ return requestAnimationFrame(smoothScroll);
+};
+
+//
+// Utilities
+//
+
+$.makeArray = function (object) {
+ if (Array.isArray(object)) {
+ return object;
+ } else {
+ return Array.prototype.slice.apply(object);
+ }
+};
+
+$.arrayDelete = function (array, object) {
+ const index = array.indexOf(object);
+ if (index >= 0) {
+ array.splice(index, 1);
+ return true;
+ } else {
+ return false;
+ }
+};
+
+// Returns true if the object is an array or a collection of DOM elements.
+$.isCollection = (object) =>
+ Array.isArray(object) || typeof object?.item === "function";
+
+const ESCAPE_HTML_MAP = {
+ "&": "&",
+ "<": "<",
+ ">": ">",
+ '"': """,
+ "'": "'",
+ "/": "/",
+};
+
+const ESCAPE_HTML_REGEXP = /[&<>"'\/]/g;
+
+$.escape = (string) =>
+ string.replace(ESCAPE_HTML_REGEXP, (match) => ESCAPE_HTML_MAP[match]);
+
+const ESCAPE_REGEXP = /([.*+?^=!:${}()|\[\]\/\\])/g;
+
+$.escapeRegexp = (string) => string.replace(ESCAPE_REGEXP, "\\$1");
+
+$.urlDecode = (string) => decodeURIComponent(string.replace(/\+/g, "%20"));
+
+$.classify = function (string) {
+ string = string.split("_");
+ for (let i = 0; i < string.length; i++) {
+ var substr = string[i];
+ string[i] = substr[0].toUpperCase() + substr.slice(1);
+ }
+ return string.join("");
+};
+
+//
+// Miscellaneous
+//
+
+$.noop = function () {};
+
+$.popup = function (value) {
+ try {
+ window.open(value.href || value, "_blank", "noopener");
+ } catch (error) {
+ const win = window.open();
+ if (win.opener) {
+ win.opener = null;
+ }
+ win.location = value.href || value;
+ }
+};
+
+let isMac = null;
+$.isMac = () =>
+ isMac != null ? isMac : (isMac = navigator.userAgent.includes("Mac"));
+
+let isIE = null;
+$.isIE = () =>
+ isIE != null
+ ? isIE
+ : (isIE =
+ navigator.userAgent.includes("MSIE") ||
+ navigator.userAgent.includes("rv:11.0"));
+
+let isChromeForAndroid = null;
+$.isChromeForAndroid = () =>
+ isChromeForAndroid != null
+ ? isChromeForAndroid
+ : (isChromeForAndroid =
+ navigator.userAgent.includes("Android") &&
+ /Chrome\/([.0-9])+ Mobile/.test(navigator.userAgent));
+
+let isAndroid = null;
+$.isAndroid = () =>
+ isAndroid != null
+ ? isAndroid
+ : (isAndroid = navigator.userAgent.includes("Android"));
+
+let isIOS = null;
+$.isIOS = () =>
+ isIOS != null
+ ? isIOS
+ : (isIOS =
+ navigator.userAgent.includes("iPhone") ||
+ navigator.userAgent.includes("iPad"));
+
+$.overlayScrollbarsEnabled = function () {
+ if (!$.isMac()) {
+ return false;
+ }
+ const div = document.createElement("div");
+ div.setAttribute(
+ "style",
+ "width: 100px; height: 100px; overflow: scroll; position: absolute",
+ );
+ document.body.appendChild(div);
+ const result = div.offsetWidth === div.clientWidth;
+ document.body.removeChild(div);
+ return result;
+};
+
+const HIGHLIGHT_DEFAULTS = {
+ className: "highlight",
+ delay: 1000,
+};
+
+$.highlight = function (el, options) {
+ options = { ...HIGHLIGHT_DEFAULTS, ...(options || {}) };
+ el.classList.add(options.className);
+ setTimeout(() => el.classList.remove(options.className), options.delay);
+};
diff --git a/assets/javascripts/models/doc.coffee b/assets/javascripts/models/doc.coffee
deleted file mode 100644
index 642fa1ff87..0000000000
--- a/assets/javascripts/models/doc.coffee
+++ /dev/null
@@ -1,145 +0,0 @@
-class app.models.Doc extends app.Model
- # Attributes: name, slug, type, version, release, db_size, mtime, links
-
- constructor: ->
- super
- @reset @
- @slug_without_version = @slug.split('~')[0]
- @fullName = "#{@name}" + if @version then " #{@version}" else ''
- @icon = @slug_without_version
- @short_version = @version.split(' ')[0] if @version
- @text = @toEntry().text
-
- reset: (data) ->
- @resetEntries data.entries
- @resetTypes data.types
- return
-
- resetEntries: (entries) ->
- @entries = new app.collections.Entries(entries)
- @entries.each (entry) => entry.doc = @
- return
-
- resetTypes: (types) ->
- @types = new app.collections.Types(types)
- @types.each (type) => type.doc = @
- return
-
- fullPath: (path = '') ->
- path = "/#{path}" unless path[0] is '/'
- "/#{@slug}#{path}"
-
- fileUrl: (path) ->
- "#{app.config.docs_host}#{@fullPath(path)}?#{@mtime}"
-
- dbUrl: ->
- "#{app.config.docs_host}/#{@slug}/#{app.config.db_filename}?#{@mtime}"
-
- indexUrl: ->
- "#{app.indexHost()}/#{@slug}/#{app.config.index_filename}?#{@mtime}"
-
- toEntry: ->
- return @entry if @entry
- @entry = new app.models.Entry
- doc: @
- name: @fullName
- path: 'index'
- @entry.addAlias(@name) if @version
- @entry
-
- findEntryByPathAndHash: (path, hash) ->
- if hash and entry = @entries.findBy 'path', "#{path}##{hash}"
- entry
- else if path is 'index'
- @toEntry()
- else
- @entries.findBy 'path', path
-
- load: (onSuccess, onError, options = {}) ->
- return if options.readCache and @_loadFromCache(onSuccess)
-
- callback = (data) =>
- @reset data
- onSuccess()
- @_setCache data if options.writeCache
- return
-
- ajax
- url: @indexUrl()
- success: callback
- error: onError
-
- clearCache: ->
- app.localStorage.del @slug
- return
-
- _loadFromCache: (onSuccess) ->
- return unless data = @_getCache()
-
- callback = =>
- @reset data
- onSuccess()
- return
-
- setTimeout callback, 0
- true
-
- _getCache: ->
- return unless data = app.localStorage.get @slug
-
- if data[0] is @mtime
- return data[1]
- else
- @clearCache()
- return
-
- _setCache: (data) ->
- app.localStorage.set @slug, [@mtime, data]
- return
-
- install: (onSuccess, onError, onProgress) ->
- return if @installing
- @installing = true
-
- error = =>
- @installing = null
- onError()
- return
-
- success = (data) =>
- @installing = null
- app.db.store @, data, onSuccess, error
- return
-
- ajax
- url: @dbUrl()
- success: success
- error: error
- progress: onProgress
- timeout: 3600
- return
-
- uninstall: (onSuccess, onError) ->
- return if @installing
- @installing = true
-
- success = =>
- @installing = null
- onSuccess()
- return
-
- error = =>
- @installing = null
- onError()
- return
-
- app.db.unstore @, success, error
- return
-
- getInstallStatus: (callback) ->
- app.db.version @, (value) ->
- callback installed: !!value, mtime: value
- return
-
- isOutdated: (status) ->
- status and status.installed and @mtime isnt status.mtime
diff --git a/assets/javascripts/models/doc.js b/assets/javascripts/models/doc.js
new file mode 100644
index 0000000000..a900c61ea1
--- /dev/null
+++ b/assets/javascripts/models/doc.js
@@ -0,0 +1,202 @@
+app.models.Doc = class Doc extends app.Model {
+ // Attributes: name, slug, type, version, release, db_size, mtime, links
+
+ constructor() {
+ super(...arguments);
+ this.reset(this);
+ this.slug_without_version = this.slug.split("~")[0];
+ this.fullName = `${this.name}` + (this.version ? ` ${this.version}` : "");
+ this.icon = this.slug_without_version;
+ if (this.version) {
+ this.short_version = this.version.split(" ")[0];
+ }
+ this.text = this.toEntry().text;
+ }
+
+ reset(data) {
+ this.resetEntries(data.entries);
+ this.resetTypes(data.types);
+ }
+
+ resetEntries(entries) {
+ this.entries = new app.collections.Entries(entries);
+ this.entries.each((entry) => {
+ return (entry.doc = this);
+ });
+ }
+
+ resetTypes(types) {
+ this.types = new app.collections.Types(types);
+ this.types.each((type) => {
+ return (type.doc = this);
+ });
+ }
+
+ fullPath(path) {
+ if (path == null) {
+ path = "";
+ }
+ if (path[0] !== "/") {
+ path = `/${path}`;
+ }
+ return `/${this.slug}${path}`;
+ }
+
+ fileUrl(path) {
+ return `${app.config.docs_origin}${this.fullPath(path)}?${this.mtime}`;
+ }
+
+ dbUrl() {
+ return `${app.config.docs_origin}/${this.slug}/${app.config.db_filename}?${this.mtime}`;
+ }
+
+ indexUrl() {
+ return `${app.indexHost()}/${this.slug}/${app.config.index_filename}?${
+ this.mtime
+ }`;
+ }
+
+ toEntry() {
+ if (this.entry) {
+ return this.entry;
+ }
+ this.entry = new app.models.Entry({
+ doc: this,
+ name: this.fullName,
+ path: "index",
+ });
+ if (this.version) {
+ this.entry.addAlias(this.name);
+ }
+ return this.entry;
+ }
+
+ findEntryByPathAndHash(path, hash) {
+ const entry = hash && this.entries.findBy("path", `${path}#${hash}`);
+ if (entry) {
+ return entry;
+ } else if (path === "index") {
+ return this.toEntry();
+ } else {
+ return this.entries.findBy("path", path);
+ }
+ }
+
+ load(onSuccess, onError, options) {
+ if (options == null) {
+ options = {};
+ }
+ if (options.readCache && this._loadFromCache(onSuccess)) {
+ return;
+ }
+
+ const callback = (data) => {
+ this.reset(data);
+ onSuccess();
+ if (options.writeCache) {
+ this._setCache(data);
+ }
+ };
+
+ return ajax({
+ url: this.indexUrl(),
+ success: callback,
+ error: onError,
+ });
+ }
+
+ clearCache() {
+ app.localStorage.del(this.slug);
+ }
+
+ _loadFromCache(onSuccess) {
+ const data = this._getCache();
+ if (!data) {
+ return;
+ }
+
+ const callback = () => {
+ this.reset(data);
+ onSuccess();
+ };
+
+ setTimeout(callback, 0);
+ return true;
+ }
+
+ _getCache() {
+ const data = app.localStorage.get(this.slug);
+ if (!data) {
+ return;
+ }
+
+ if (data[0] === this.mtime) {
+ return data[1];
+ } else {
+ this.clearCache();
+ return;
+ }
+ }
+
+ _setCache(data) {
+ app.localStorage.set(this.slug, [this.mtime, data]);
+ }
+
+ install(onSuccess, onError, onProgress) {
+ if (this.installing) {
+ return;
+ }
+ this.installing = true;
+
+ const error = () => {
+ this.installing = null;
+ onError();
+ };
+
+ const success = (data) => {
+ this.installing = null;
+ app.db.store(this, data, onSuccess, error);
+ };
+
+ ajax({
+ url: this.dbUrl(),
+ success,
+ error,
+ progress: onProgress,
+ timeout: 3600,
+ });
+ }
+
+ uninstall(onSuccess, onError) {
+ if (this.installing) {
+ return;
+ }
+ this.installing = true;
+
+ const success = () => {
+ this.installing = null;
+ onSuccess();
+ };
+
+ const error = () => {
+ this.installing = null;
+ onError();
+ };
+
+ app.db.unstore(this, success, error);
+ }
+
+ getInstallStatus(callback) {
+ app.db.version(this, (value) =>
+ callback({ installed: !!value, mtime: value }),
+ );
+ }
+
+ isOutdated(status) {
+ if (!status) {
+ return false;
+ }
+ const isInstalled = status.installed || app.settings.get("autoInstall");
+ return isInstalled && this.mtime !== status.mtime;
+ }
+};
diff --git a/assets/javascripts/models/entry.coffee b/assets/javascripts/models/entry.coffee
deleted file mode 100644
index 2288ecd568..0000000000
--- a/assets/javascripts/models/entry.coffee
+++ /dev/null
@@ -1,78 +0,0 @@
-#= require app/searcher
-
-class app.models.Entry extends app.Model
- # Attributes: name, type, path
-
- constructor: ->
- super
- @text = applyAliases(app.Searcher.normalizeString(@name))
-
- addAlias: (name) ->
- text = applyAliases(app.Searcher.normalizeString(name))
- @text = [@text] unless Array.isArray(@text)
- @text.push(if Array.isArray(text) then text[1] else text)
- return
-
- fullPath: ->
- @doc.fullPath if @isIndex() then '' else @path
-
- dbPath: ->
- @path.replace /#.*/, ''
-
- filePath: ->
- @doc.fullPath @_filePath()
-
- fileUrl: ->
- @doc.fileUrl @_filePath()
-
- _filePath: ->
- result = @path.replace /#.*/, ''
- result += '.html' unless result[-5..-1] is '.html'
- result
-
- isIndex: ->
- @path is 'index'
-
- getType: ->
- @doc.types.findBy 'name', @type
-
- loadFile: (onSuccess, onError) ->
- app.db.load(@, onSuccess, onError)
-
- applyAliases = (string) ->
- if ALIASES.hasOwnProperty(string)
- return [string, ALIASES[string]]
- else
- words = string.split('.')
- for word, i in words when ALIASES.hasOwnProperty(word)
- words[i] = ALIASES[word]
- return [string, words.join('.')]
- return string
-
- @ALIASES = ALIASES =
- 'angular': 'ng'
- 'angular.js': 'ng'
- 'backbone.js': 'bb'
- 'c++': 'cpp'
- 'coffeescript': 'cs'
- 'elixir': 'ex'
- 'javascript': 'js'
- 'jquery': '$'
- 'knockout.js': 'ko'
- 'less': 'ls'
- 'lodash': '_'
- 'marionette': 'mn'
- 'markdown': 'md'
- 'modernizr': 'mdr'
- 'moment.js': 'mt'
- 'nginx': 'ngx'
- 'numpy': 'np'
- 'pandas': 'pd'
- 'postgresql': 'pg'
- 'python': 'py'
- 'ruby.on.rails': 'ror'
- 'ruby': 'rb'
- 'sass': 'scss'
- 'tensorflow': 'tf'
- 'typescript': 'ts'
- 'underscore.js': '_'
diff --git a/assets/javascripts/models/entry.js b/assets/javascripts/models/entry.js
new file mode 100644
index 0000000000..98822bc97e
--- /dev/null
+++ b/assets/javascripts/models/entry.js
@@ -0,0 +1,70 @@
+//= require app/searcher
+
+app.models.Entry = class Entry extends app.Model {
+ static applyAliases(string) {
+ const aliases = app.config.docs_aliases;
+ if (aliases.hasOwnProperty(string)) {
+ return [string, aliases[string]];
+ } else {
+ const words = string.split(".");
+ for (let i = 0; i < words.length; i++) {
+ var word = words[i];
+ if (aliases.hasOwnProperty(word)) {
+ words[i] = aliases[word];
+ return [string, words.join(".")];
+ }
+ }
+ }
+ return string;
+ }
+
+ // Attributes: name, type, path
+ constructor() {
+ super(...arguments);
+ this.text = Entry.applyAliases(app.Searcher.normalizeString(this.name));
+ }
+
+ addAlias(name) {
+ const text = Entry.applyAliases(app.Searcher.normalizeString(name));
+ if (!Array.isArray(this.text)) {
+ this.text = [this.text];
+ }
+ this.text.push(Array.isArray(text) ? text[1] : text);
+ }
+
+ fullPath() {
+ return this.doc.fullPath(this.isIndex() ? "" : this.path);
+ }
+
+ dbPath() {
+ return this.path.replace(/#.*/, "");
+ }
+
+ filePath() {
+ return this.doc.fullPath(this._filePath());
+ }
+
+ fileUrl() {
+ return this.doc.fileUrl(this._filePath());
+ }
+
+ _filePath() {
+ let result = this.path.replace(/#.*/, "");
+ if (result.slice(-5) !== ".html") {
+ result += ".html";
+ }
+ return result;
+ }
+
+ isIndex() {
+ return this.path === "index";
+ }
+
+ getType() {
+ return this.doc.types.findBy("name", this.type);
+ }
+
+ loadFile(onSuccess, onError) {
+ return app.db.load(this, onSuccess, onError);
+ }
+};
diff --git a/assets/javascripts/models/model.coffee b/assets/javascripts/models/model.coffee
deleted file mode 100644
index 7f157f7c4f..0000000000
--- a/assets/javascripts/models/model.coffee
+++ /dev/null
@@ -1,3 +0,0 @@
-class app.Model
- constructor: (attributes) ->
- @[key] = value for key, value of attributes
diff --git a/assets/javascripts/models/model.js b/assets/javascripts/models/model.js
new file mode 100644
index 0000000000..def06e55ce
--- /dev/null
+++ b/assets/javascripts/models/model.js
@@ -0,0 +1,8 @@
+app.Model = class Model {
+ constructor(attributes) {
+ for (var key in attributes) {
+ var value = attributes[key];
+ this[key] = value;
+ }
+ }
+};
diff --git a/assets/javascripts/models/type.coffee b/assets/javascripts/models/type.coffee
deleted file mode 100644
index 6351ad16d7..0000000000
--- a/assets/javascripts/models/type.coffee
+++ /dev/null
@@ -1,14 +0,0 @@
-class app.models.Type extends app.Model
- # Attributes: name, slug, count
-
- fullPath: ->
- "/#{@doc.slug}-#{@slug}/"
-
- entries: ->
- @doc.entries.findAllBy 'type', @name
-
- toEntry: ->
- new app.models.Entry
- doc: @doc
- name: "#{@doc.name} / #{@name}"
- path: '..' + @fullPath()
diff --git a/assets/javascripts/models/type.js b/assets/javascripts/models/type.js
new file mode 100644
index 0000000000..bc264ac189
--- /dev/null
+++ b/assets/javascripts/models/type.js
@@ -0,0 +1,19 @@
+app.models.Type = class Type extends app.Model {
+ // Attributes: name, slug, count
+
+ fullPath() {
+ return `/${this.doc.slug}-${this.slug}/`;
+ }
+
+ entries() {
+ return this.doc.entries.findAllBy("type", this.name);
+ }
+
+ toEntry() {
+ return new app.models.Entry({
+ doc: this.doc,
+ name: `${this.doc.name} / ${this.name}`,
+ path: ".." + this.fullPath(),
+ });
+ }
+};
diff --git a/assets/javascripts/news.json b/assets/javascripts/news.json
index d67f87eb84..1f821abae4 100644
--- a/assets/javascripts/news.json
+++ b/assets/javascripts/news.json
@@ -1,5 +1,280 @@
[
[
+ "2025-10-19",
+ "New documentations: Lit, Graphviz, Bun"
+ ],
+ [
+ "2025-07-14",
+ "New documentation: Tcllib"
+ ],
+ [
+ "2025-06-27",
+ "New documentation: Zsh"
+ ],
+ [
+ "2025-06-04",
+ "New documentation: es-toolkit"
+ ],
+ [
+ "2025-05-28",
+ "New documentation: Vert.x"
+ ],
+ [
+ "2025-02-23",
+ "New documentation: Three.js"
+ ],
+ [
+ "2025-02-16",
+ "New documentation: OpenLayers"
+ ],
+ [
+ "2024-11-23",
+ "New documentation: DuckDB"
+ ],
+ [
+ "2024-08-20",
+ "New documentation: Linux man pages"
+ ],
+ [
+ "2024-07-28",
+ "New documentation: OpenGL"
+ ],
+ [
+ "2024-06-12",
+ "New documentations: Next.js, click"
+ ],
+ [
+ "2024-01-24",
+ "New documentation: Playwright"
+ ],
+ [
+ "2024-01-20",
+ "New documentation: htmx"
+ ],
+ [
+ "2024-01-12",
+ "New documentation: Hammerspoon"
+ ],
+ [
+ "2024-01-05",
+ "New documentation: Bazel"
+ ],
+ [
+ "2023-10-09",
+ "New documentations: hapi, joi, Nushell, Varnish"
+ ],
+ [
+ "2023-08-24",
+ "New documentation: Fluture"
+ ],
+ [
+ "2022-12-20",
+ "New documentations: QUnit, Wagtail"
+ ],
+ [
+ "2022-11-04",
+ "New documentation: VueUse"
+ ],
+ [
+ "2022-10-10",
+ "New documentation: Astro"
+ ],
+ [
+ "2022-10-09",
+ "New documentations: FastAPI, Vitest"
+ ],
+ [
+ "2022-10-02",
+ "New documentation: Svelte"
+ ],
+ [
+ "2022-09-21",
+ "Added HTTP/3 to HTTP"
+ ],
+ [
+ "2022-09-06",
+ "New documentation: date-fns"
+ ],
+ [
+ "2022-08-27",
+ "New documentations: Sanctuary, Requests, Axios"
+ ],
+ [
+ "2022-05-03",
+ "New documentations: Kubernetes, Kubectl"
+ ],
+ [
+ "2022-04-25",
+ "New documentation: Nix"
+ ],
+ [
+ "2022-03-31",
+ "New documentation: Eigen3"
+ ],
+ [
+ "2022-02-21",
+ "New documentation: Tailwind CSS"
+ ],
+ [
+ "2022-01-12",
+ "New documentation: React Router"
+ ],
+ [
+ "2022-01-09",
+ "New documentation: Deno"
+ ],
+ [
+ "2021-12-29",
+ "New documentation: PointCloudLibrary"
+ ],
+ [
+ "2021-12-27",
+ "New documentation: Zig"
+ ],
+ [
+ "2021-12-26",
+ "New documentation: GNU Make"
+ ],
+ [
+ "2021-12-07",
+ "New documentation: Prettier",
+ "Renamed documentation: Web APIs"
+ ],
+ [
+ "2021-12-05",
+ "New documentation: esbuild"
+ ],
+ [
+ "2021-12-04",
+ "New documentation: Vite"
+ ],
+ [
+ "2021-11-29",
+ "New documentation: i3"
+ ],
+ [
+ "2021-06-09",
+ "New documentation: R"
+ ],
+ [
+ "2021-05-31",
+ "New documentation: Web Extensions"
+ ],
+ [
+ "2021-05-26",
+ "New documentations: LaTeX, jq"
+ ],
+ [
+ "2021-04-29",
+ "Added """
-
-back = 'Go back'
-
-app.templates.notFoundPage = ->
- error """ Page not found. """,
- """ It may be missing from the source documentation or this could be a bug. """,
- back
-
-app.templates.pageLoadError = ->
- error """ The page failed to load. """,
- """ It may be missing from the server (try reloading the app) or you could be offline.
- If you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. """, - """ #{back} · Reload - · Retry """ - -app.templates.bootError = -> - error """ The app failed to load. """, - """ Check your Internet connection and try reloading.
- If you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. """ - -app.templates.offlineError = (reason) -> - if reason is 'cookie_blocked' - return error """ Cookies must be enabled to use offline mode. """ - - reason = switch reason - when 'not_supported' - """ Unfortunately your browser either doesn't support IndexedDB or does not make it available. """ - when 'cant_open' - """ Although your browser supports IndexedDB, DevDocs couldn't open the database.
- This could be because you're browsing in private mode or have disallowed offline storage on the domain. """ - when 'empty' - """ Although your browser supports IndexedDB, DevDocs couldn't properly set up the database.
- This could be because the database is corrupted. Try resetting the app. """ - when 'apple' - """ Unfortunately Safari's implementation of IndexedDB is badly broken.
- This message will automatically go away when Apple fix their code. """ - - error """ Offline mode is unavailable. """, - """ DevDocs requires IndexedDB to cache documentations for offline access.
#{reason} """ - -app.templates.unsupportedBrowser = """ -`;
+};
+
+const back = 'Go back';
+
+app.templates.notFoundPage = () =>
+ error(
+ " Page not found. ",
+ " It may be missing from the source documentation or this could be a bug. ",
+ back,
+ );
+
+app.templates.pageLoadError = () =>
+ error(
+ " The page failed to load. ",
+ ` 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).
+If you're online and you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. `, + ` ${back} · Reload +· Retry `, + ); + +app.templates.bootError = () => + error( + " The app failed to load. ", + ` Check your Internet connection and try reloading.
+If you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. `, + ); + +app.templates.offlineError = function (reason, exception) { + if (reason === "cookie_blocked") { + return error(" Cookies must be enabled to use offline mode. "); + } + + reason = (() => { + switch (reason) { + case "not_supported": + return ` DevDocs requires IndexedDB to cache documentations for offline access.
+Unfortunately your browser either doesn't support IndexedDB or doesn't make it available. `; + case "buggy": + return ` DevDocs requires IndexedDB to cache documentations for offline access.
+Unfortunately your browser's implementation of IndexedDB contains bugs that prevent DevDocs from using it. `; + case "private_mode": + return ` Your browser appears to be running in private mode.
+This prevents DevDocs from caching documentations for offline access.`; + case "exception": + return ` An error occurred when trying to open the IndexedDB database:
+
+
+This could be because you're browsing in private mode or have disallowed offline storage on the domain. `; + case "version": + return ` The IndexedDB database was modified with a newer version of the app.
+Reload the page to use offline mode. `; + case "empty": + return ' The IndexedDB database appears to be corrupted. Try resetting the app. '; + } + })(); + + return error("Offline mode is unavailable.", reason); +}; + +app.templates.unsupportedBrowser = `\ +
Thanks :) """ - -app.templates.notifUpdateDocs = -> - textNotif """ Documentation updates available. """, - """ Install them as soon as possible to avoid broken pages. """ diff --git a/assets/javascripts/templates/notif_tmpl.js b/assets/javascripts/templates/notif_tmpl.js new file mode 100644 index 0000000000..f24c3c11a0 --- /dev/null +++ b/assets/javascripts/templates/notif_tmpl.js @@ -0,0 +1,110 @@ +const notif = function (title, html) { + html = html.replace(/${title} +${html} +\ +`; +}; + +const textNotif = (title, message) => + notif(title, `
Thanks :) `, + ); + +app.templates.notifUpdateDocs = () => + textNotif( + " Documentation updates available. ", + ' Install them as soon as possible to avoid broken pages. ', + ); + +app.templates.notifAnalyticsConsent = () => + textNotif( + " Tracking cookies ", + ` We would like to gather usage data about how DevDocs is used through Google Analytics and Gauges. We only collect anonymous traffic information. +Please confirm if you accept our tracking cookies. You can always change your decision in the settings. +
Accept or Decline `, + ); diff --git a/assets/javascripts/templates/pages/about_tmpl.coffee b/assets/javascripts/templates/pages/about_tmpl.coffee deleted file mode 100644 index 3ac46435c1..0000000000 --- a/assets/javascripts/templates/pages/about_tmpl.coffee +++ /dev/null @@ -1,578 +0,0 @@ -app.templates.aboutPage = -> """ - - -
-
-
-
Angular.js', - '2010-2016 Google, Inc.', - 'CC BY', - 'https://creativecommons.org/licenses/by/4.0/' - ], [ - 'Ansible', - '2012-2016 Michael DeHaan
© 2016 Red Hat, Inc.', - 'GPLv3', - 'https://raw.githubusercontent.com/ansible/ansible/devel/COPYING' - ], [ - 'Apache HTTP Server
Apache Pig', - '2016 The Apache Software Foundation
Apache and the Apache feather logo are trademarks of The Apache Software Foundation.', - 'Apache', - 'https://www.apache.org/licenses/LICENSE-2.0' - ], [ - 'Backbone.js', - '2010-2016 Jeremy Ashkenas, DocumentCloud', - 'MIT', - 'https://raw.githubusercontent.com/jashkenas/backbone/master/LICENSE' - ], [ - 'Bootstrap', - '2011-2016 Twitter, Inc.', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'Bottle', - '2016 Marcel Hellkamp', - 'MIT', - 'https://raw.githubusercontent.com/bottlepy/bottle/master/LICENSE' - ], [ - 'Bower', - '2016 Bower contributors', - 'MIT', - 'https://github.com/bower/bower.github.io/blob/1057905c18d899106f91372e6cca7ef54a91d60f/package.json#L20' - ], [ - 'C
C++', - 'cppreference.com', - 'CC BY-SA', - 'http://en.cppreference.com/w/Cppreference:Copyright/CC-BY-SA' - ], [ - 'CakePHP', - '2005-2016 The Cake Software Foundation, Inc.', - 'MIT', - 'https://raw.githubusercontent.com/cakephp/cakephp/master/LICENSE.txt' - ], [ - 'Chai', - '2011-2015 Jake Luer', - 'MIT', - 'https://github.com/chaijs/chai/blob/master/README.md#license' - ], [ - 'Chef™', - 'Chef Software, Inc.', - 'CC BY', - 'https://raw.githubusercontent.com/chef/chef-web-docs-2016/master/LICENSE' - ], [ - 'Clojure', - 'Rich Hickey', - 'EPL', - 'https://github.com/clojure/clojure/blob/master/epl-v10.html' - ], [ - 'CMake', - '2000-2016 Kitware, Inc.
© 2000-2011 Insight Software Consortium', - 'BSD', - 'https://cmake.org/licensing/' - ], [ - 'CodeIgniter', - '2014-2016 British Columbia Institute of Technology', - 'MIT', - 'https://raw.githubusercontent.com/bcit-ci/CodeIgniter/develop/license.txt' - ], [ - 'CoffeeScript', - '2009-2015 Jeremy Ashkenas', - 'MIT', - 'https://raw.githubusercontent.com/jashkenas/coffee-script/master/LICENSE' - ], [ - 'Cordova', - '2012-2016 The Apache Software Foundation', - 'Apache', - 'https://raw.githubusercontent.com/apache/cordova-docs/master/LICENSE' - ], [ - 'CSS
DOM
HTML
JavaScript
SVG
XPath', - '2005-2016 Mozilla Developer Network and individual contributors', - 'CC BY-SA', - 'https://creativecommons.org/licenses/by-sa/2.5/' - ], [ - 'Crystal', - '2012-2016 Manas Technology Solutions', - 'Apache', - 'https://raw.githubusercontent.com/crystal-lang/crystal/master/LICENSE' - ], [ - 'D3.js', - '2010-2016 Michael Bostock', - 'BSD', - 'https://raw.githubusercontent.com/d3/d3/master/LICENSE' - ], [ - 'Django', - 'Django Software Foundation and individual contributors', - 'BSD', - 'https://raw.githubusercontent.com/django/django/master/LICENSE' - ], [ - 'Docker', - '2013-2016 Docker, Inc.
Docker and the Docker logo are trademarks of Docker, Inc.', - 'Apache', - 'https://raw.githubusercontent.com/docker/docker/master/LICENSE' - ], [ - 'Dojo', - '2005-2015 The Dojo Foundation', - 'BSD + AFL', - 'http://dojotoolkit.org/license.html' - ], [ - 'Drupal', - '2001-2015 by the original authors
Drupal is a registered trademark of Dries Buytaert.', - 'GPLv2', - 'https://api.drupal.org/api/drupal/LICENSE.txt' - ], [ - 'Ember.js', - '2016 Yehuda Katz, Tom Dale and Ember.js contributors', - 'MIT', - 'https://raw.githubusercontent.com/emberjs/ember.js/master/LICENSE' - ], [ - 'Elixir', - '2012-2016 Plataformatec', - 'Apache', - 'https://raw.githubusercontent.com/elixir-lang/elixir/master/LICENSE' - ], [ - 'Erlang', - '1999-2016 Ericsson AB', - 'Apache', - 'https://raw.githubusercontent.com/erlang/otp/maint/LICENSE.txt' - ], [ - 'Express', - '2016 StrongLoop, IBM, and other expressjs.com contributors.', - 'Unknown', - 'https://github.com/expressjs/expressjs.com/issues/413' - ], [ - 'Fish', - '2005-2009 Axel Liljencrantz', - 'GPLv2', - 'https://fishshell.com/docs/current/license.html' - ], [ - 'GCC
GNU Fortran', - 'Free Software Foundation', - 'GFDL', - 'https://www.gnu.org/licenses/fdl-1.3.en.html' - ], [ - 'Git', - '2005-2016 Linus Torvalds and others', - 'GPLv2', - 'https://raw.githubusercontent.com/git/git/master/COPYING' - ], [ - 'Go', - 'Google, Inc.', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'Grunt', - 'GruntJS Team', - 'MIT', - 'https://github.com/gruntjs/grunt-docs/blob/master/package.json#L10' - ], [ - 'Haskell', - 'The University of Glasgow', - 'BSD', - 'https://www.haskell.org/ghc/license' - ], [ - 'Haxe', - '2005-2016 Haxe Foundation', - 'MIT', - 'http://haxe.org/foundation/open-source.html' - ], [ - 'InfluxData', - '2015 InfluxData, Inc.', - 'MIT', - 'https://github.com/influxdata/docs.influxdata.com/blob/master/LICENSE' - ], [ - 'jQuery', - 'Packt Publishing
© jQuery Foundation and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/jquery/api.jquery.com/master/LICENSE.txt' - ], [ - 'jQuery Mobile', - 'jQuery Foundation and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/jquery/api.jquerymobile.com/master/LICENSE.txt' - ], [ - 'jQuery UI', - 'jQuery Foundation and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/jquery/api.jqueryui.com/master/LICENSE.txt' - ], [ - 'Julia', - '2009-2016 Jeff Bezanson, Stefan Karpinski, Viral B. Shah, and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/JuliaLang/julia/master/LICENSE.md' - ], [ - 'Knockout.js', - 'Steven Sanderson, the Knockout.js team, and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/knockout/knockout/master/LICENSE' - ], [ - 'Kotlin', - '2010-2016 JetBrains s.r.o.', - 'Apache', - 'https://raw.githubusercontent.com/JetBrains/kotlin-web-site/master/LICENSE' - ], [ - 'Laravel', - 'Taylor Otwell', - 'MIT', - 'https://raw.githubusercontent.com/laravel/framework/master/LICENSE.txt' - ], [ - 'Less', - '2009-2016 The Core Less Team', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'Lo-Dash', - '2012-2016 The Dojo Foundation', - 'MIT', - 'https://raw.githubusercontent.com/lodash/lodash/master/LICENSE.txt' - ], [ - 'Lua', - '1994–2015 Lua.org, PUC-Rio', - 'MIT', - 'http://www.lua.org/license.html' - ], [ - 'LÖVE', - '2006-2016 LÖVE Development Team', - 'GFDL', - 'http://www.gnu.org/copyleft/fdl.html' - ], [ - 'Marionette.js', - '2016 Muted Solutions, LLC', - 'MIT', - 'https://mutedsolutions.mit-license.org/' - ], [ - 'Markdown', - '2004 John Gruber', - 'BSD', - 'https://daringfireball.net/projects/markdown/license' - ], [ - 'Matplotlib', - '2012-2016 Matplotlib Development Team. All rights reserved.', - 'Custom', - 'https://raw.githubusercontent.com/matplotlib/matplotlib/master/LICENSE/LICENSE' - ], [ - 'Meteor', - '2011-2016 Meteor Development Group', - 'MIT', - 'https://raw.githubusercontent.com/meteor/meteor/master/LICENSE.txt' - ], [ - 'Minitest', - 'Ryan Davis, seattle.rb', - 'MIT', - 'https://github.com/seattlerb/minitest/blob/master/README.rdoc#license' - ], [ - 'Mocha', - 'Mocha contributors', - 'CC BY', - 'https://creativecommons.org/licenses/by/4.0/' - ], [ - 'Modernizr', - '2009-2016 The Modernizr team', - 'MIT', - 'https://modernizr.com/license/' - ], [ - 'Moment.js', - '2011-2016 Tim Wood, Iskren Chernev, Moment.js contributors', - 'MIT', - 'https://raw.githubusercontent.com/moment/moment/master/LICENSE' - ], [ - 'Mongoose', - '2010 LearnBoost', - 'MIT', - 'https://github.com/LearnBoost/mongoose/blob/master/README.md#license' - ], [ - 'nginx', - '2002-2016 Igor Sysoev
© 2011-2016 Nginx, Inc.', - 'BSD', - 'http://nginx.org/LICENSE' - ], [ - 'nginx / Lua Module', - '2009-2016 Xiaozhe Wang (chaoslawful)
© 2009-2016 Yichun "agentzh" Zhang (章亦春), CloudFlare Inc.', - 'BSD', - 'https://github.com/openresty/lua-nginx-module#copyright-and-license' - ], [ - 'Node.js', - 'Joyent, Inc. and other Node contributors
Node.js is a trademark of Joyent, Inc.', - 'MIT', - 'https://raw.githubusercontent.com/nodejs/node/master/LICENSE' - ], [ - 'Nokogiri', - '2008-2016 Aaron Patterson, Mike Dalessio, Charles Nutter, Sergio Arbeo, Patrick Mahoney, Yoko Harada, Akinori Musha, John Shahid', - 'MIT', - 'https://raw.githubusercontent.com/sparklemotion/nokogiri/master/LICENSE.txt' - ], [ - 'npm', - 'npm, Inc. and Contributors
npm is a trademark of npm, Inc.', - 'npm', - 'https://raw.githubusercontent.com/npm/npm/master/LICENSE' - ], [ - 'NumPy', - '2008-2016 NumPy Developers', - 'NumPy', - 'https://raw.githubusercontent.com/numpy/numpy/master/LICENSE.txt' - ], [ - 'OpenTSDB', - '2010-2016 The OpenTSDB Authors', - 'LGPLv2.1', - 'https://raw.githubusercontent.com/OpenTSDB/opentsdb.net/gh-pages/COPYING.LESSER' - ], [ - 'Padrino', - '2010-2016 Padrino', - 'MIT', - 'https://raw.githubusercontent.com/padrino/padrino-framework/master/padrino/LICENSE.txt' - ], [ - 'pandas', - '2011-2012 Lambda Foundry, Inc. and PyData Development Team
© 2008-2011 AQR Capital Management, LLC
© 2008-2014 the pandas development team', - 'BSD', - 'https://raw.githubusercontent.com/pydata/pandas/master/LICENSE' - ], [ - 'Perl', - '1993-2016 Larry Wall and others', - 'GPLv1', - 'http://perldoc.perl.org/index-licence.html' - ], [ - 'Phalcon', - '2011-2016 Phalcon Framework Team', - 'CC BY', - 'https://docs.phalconphp.com/en/latest/reference/license.html' - ], [ - 'Phaser', - '2016 Richard Davey, Photon Storm Ltd.', - 'MIT', - 'https://raw.githubusercontent.com/photonstorm/phaser/master/license.txt' - ], [ - 'Phoenix', - '2014 Chris McCord', - 'MIT', - 'https://raw.githubusercontent.com/phoenixframework/phoenix/master/LICENSE.md' - ], [ - 'PHP', - '1997-2016 The PHP Documentation Group', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'PHPUnit', - '2005-2016 Sebastian Bergmann', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'PostgreSQL', - '1996-2016 The PostgreSQL Global Development Group
© 1994 The Regents of the University of California', - 'PostgreSQL', - 'http://www.postgresql.org/about/licence/' - ], [ - 'Python', - '1990-2015 Python Software Foundation
Python is a trademark of the Python Software Foundation.', - 'PSFL', - 'https://docs.python.org/3/license.html' - ], [ - 'Q', - '2009-2015 Kristopher Michael Kowal and contributors', - 'MIT', - 'https://raw.githubusercontent.com/kriskowal/q/v1/LICENSE' - ], [ - 'Ramda', - '2013-2016 Scott Sauyet and Michael Hurley', - 'MIT', - 'https://raw.githubusercontent.com/ramda/ramda/master/LICENSE.txt' - ], [ - 'React, React Native, Flow, Relay', - '2013-2016 Facebook Inc.', - 'CC BY', - 'https://raw.githubusercontent.com/facebook/react/master/LICENSE-docs' - ], [ - 'Redis', - '2009-2016 Salvatore Sanfilippo', - 'CC BY-SA', - 'https://creativecommons.org/licenses/by-sa/4.0/' - ], [ - 'Redux', - '2015-2016 Dan Abramov', - 'MIT', - 'https://raw.githubusercontent.com/reactjs/redux/master/LICENSE.md' - ], [ - 'RequireJS', - 'jQuery Foundation and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/requirejs/requirejs/master/LICENSE' - ], [ - 'RethinkDB', - 'RethinkDB contributors', - 'CC BY-SA', - 'https://raw.githubusercontent.com/rethinkdb/docs/master/LICENSE' - ], [ - 'Ruby', - '1993-2016 Yukihiro Matsumoto', - 'Ruby', - 'https://www.ruby-lang.org/en/about/license.txt' - ], [ - 'Ruby on Rails', - '2004-2016 David Heinemeier Hansson
Rails, Ruby on Rails, and the Rails logo are trademarks of David Heinemeier Hansson.', - 'MIT', - 'https://raw.githubusercontent.com/rails/rails/master/activerecord/MIT-LICENSE' - ], [ - 'Rust', - '2016 The Rust Project Developers', - 'MIT', - 'https://raw.githubusercontent.com/rust-lang/rust/master/LICENSE-MIT' - ], [ - 'Sass', - '2006-2016 Hampton Catlin, Nathan Weizenbaum, and Chris Eppstein', - 'MIT', - 'https://raw.githubusercontent.com/sass/sass/stable/MIT-LICENSE' - ], [ - 'scikit-image', - '2011 the scikit-image team', - 'BSD', - 'http://scikit-image.org/docs/dev/license.html' - ], [ - 'scikit-learn', - '2007-2016 The scikit-learn developers', - 'BSD', - 'https://raw.githubusercontent.com/scikit-learn/scikit-learn/master/COPYING' - ], [ - 'Sinon', - '2010-2016 Christian Johansen', - 'BSD', - 'https://raw.githubusercontent.com/cjohansen/Sinon.JS/master/LICENSE' - ], [ - 'Socket.io', - '2014-2015 Automattic', - 'MIT', - 'https://raw.githubusercontent.com/Automattic/socket.io/master/LICENSE' - ], [ - 'Statsmodels', - '2009-2012 Statsmodels Developers
© 2006-2008 Scipy Developers
© 2006 Jonathan E. Taylor', - 'BSD', - 'https://raw.githubusercontent.com/statsmodels/statsmodels/master/LICENSE.txt' - ], [ - 'Symfony', - '2004-2016 Fabien Potencier', - 'MIT', - 'https://symfony.com/doc/current/contributing/code/license.html' - ], [ - 'Tcl/Tk', - 'The Regents of the University of California, Sun Microsystems, Inc., Scriptics Corporation, and other parties', - 'Tcl/Tk', - 'http://tcl.tk/software/tcltk/license.html' - ], [ - 'TensorFlow', - '2015 The TensorFlow Authors', - 'Apache', - 'https://raw.githubusercontent.com/tensorflow/tensorflow/master/LICENSE' - ], [ - 'Twig', - '2009-2016 The Twig Team', - 'BSD', - 'http://twig.sensiolabs.org/license' - ], [ - 'TypeScript', - 'Microsoft and other contributors', - 'Apache', - 'https://raw.githubusercontent.com/Microsoft/TypeScript-Handbook/master/LICENSE' - ], [ - 'Underscore.js', - '2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors', - 'MIT', - 'https://raw.githubusercontent.com/jashkenas/underscore/master/LICENSE' - ], [ - 'Vagrant', - '2010-2016 Mitchell Hashimoto', - 'MIT', - 'https://raw.githubusercontent.com/mitchellh/vagrant/master/LICENSE' - ], [ - 'Vue.js', - '2013-2016 Evan You, Vue.js contributors', - 'MIT', - 'https://raw.githubusercontent.com/vuejs/vue/master/LICENSE' - ], [ - 'Webpack', - '2012-2016 Tobias Koppers', - 'MIT', - 'https://raw.githubusercontent.com/webpack/webpack/master/LICENSE' - ], [ - 'Yii', - '2008-2016 by Yii Software LLC', - 'BSD', - 'https://raw.githubusercontent.com/yiisoft/yii/master/LICENSE' - ] -] diff --git a/assets/javascripts/templates/pages/about_tmpl.js b/assets/javascripts/templates/pages/about_tmpl.js new file mode 100644 index 0000000000..e3142da5fc --- /dev/null +++ b/assets/javascripts/templates/pages/about_tmpl.js @@ -0,0 +1,96 @@ +app.templates.aboutPage = function () { + let doc; + const all_docs = app.docs.all().concat(...(app.disabledDocs.all() || [])); + // de-duplicate docs by doc.name + const docs = []; + for (doc of all_docs) { + if (!docs.find((d) => d.name === doc.name)) { + docs.push(doc); + } + } + return `\ + + +
-
-"""
diff --git a/assets/javascripts/templates/pages/help_tmpl.js b/assets/javascripts/templates/pages/help_tmpl.js
new file mode 100644
index 0000000000..e155d82999
--- /dev/null
+++ b/assets/javascripts/templates/pages/help_tmpl.js
@@ -0,0 +1,179 @@
+app.templates.helpPage = function () {
+ const ctrlKey = $.isMac() ? "cmd" : "ctrl";
+ const navKey = $.isMac() ? "cmd" : "alt";
+ const arrowScroll = app.settings.get("arrowScroll");
+
+ const aliases = Object.entries(app.config.docs_aliases);
+ const middle = Math.ceil(aliases.length / 2);
+ const aliases_one = aliases.slice(0, middle);
+ const aliases_two = aliases.slice(middle);
+
+ return `\
+
+
+
-
-
- The current tab will continue to work, though (provided you installed all the documentations you want to use beforehand). """ - -app.templates.offlineDoc = (doc, status) -> - outdated = doc.isOutdated(status) - - html = """ -
- #{doc.fullName}
- #{Math.ceil(doc.db_size / 100000) / 10} MB
- """
-
- html += if !(status and status.installed)
- """
- -
- Install
- """
- else if outdated
- """
- Outdated
- Update - Uninstall
- """
- else
- """
- Up-to-date
- Uninstall
- """
-
- html + ' '
diff --git a/assets/javascripts/templates/pages/offline_tmpl.js b/assets/javascripts/templates/pages/offline_tmpl.js
new file mode 100644
index 0000000000..ad46753195
--- /dev/null
+++ b/assets/javascripts/templates/pages/offline_tmpl.js
@@ -0,0 +1,88 @@
+app.templates.offlinePage = (docs) => `\
+
+The current tab will continue to function even when you go offline (provided you installed all the documentations beforehand). `; + } +}; + +app.templates.offlineDoc = function (doc, status) { + const outdated = doc.isOutdated(status); + + let html = `\ +
+ ${doc.fullName}
+ ${
+ Math.ceil(doc.db_size / 100000) / 10
+ } MB \
+`;
+
+ html += !(status && status.installed)
+ ? `\
+-
+Outdated
+ - \
+`
+ : `\
+Up‑to‑date
+ ";
+};
diff --git a/assets/javascripts/templates/pages/root_tmpl.coffee.erb b/assets/javascripts/templates/pages/root_tmpl.coffee.erb
deleted file mode 100644
index c7a768a03b..0000000000
--- a/assets/javascripts/templates/pages/root_tmpl.coffee.erb
+++ /dev/null
@@ -1,84 +0,0 @@
-app.templates.splash = """\
+`;
+<% end %>
+
+app.templates.mobileIntro = `\
+#{$.escape entry.name} """
diff --git a/assets/javascripts/templates/pages/type_tmpl.js b/assets/javascripts/templates/pages/type_tmpl.js
new file mode 100644
index 0000000000..8e0723325c
--- /dev/null
+++ b/assets/javascripts/templates/pages/type_tmpl.js
@@ -0,0 +1,11 @@
+app.templates.typePage = (type) => {
+ return ` ${$.escape(entry.name)} `;
+};
diff --git a/assets/javascripts/templates/path_tmpl.coffee b/assets/javascripts/templates/path_tmpl.coffee
deleted file mode 100644
index b8247b8c33..0000000000
--- a/assets/javascripts/templates/path_tmpl.coffee
+++ /dev/null
@@ -1,5 +0,0 @@
-app.templates.path = (doc, type, entry) ->
- html = """#{doc.fullName}"""
- html += """#{type.name}""" if type
- html += """#{$.escape entry.name}""" if entry
- html
diff --git a/assets/javascripts/templates/path_tmpl.js b/assets/javascripts/templates/path_tmpl.js
new file mode 100644
index 0000000000..9d02c042e7
--- /dev/null
+++ b/assets/javascripts/templates/path_tmpl.js
@@ -0,0 +1,15 @@
+app.templates.path = function (doc, type, entry) {
+ const arrow = '';
+ let html = `${doc.fullName}`;
+ if (type) {
+ html += `${arrow}${
+ type.name
+ }`;
+ }
+ if (entry) {
+ html += `${arrow}${$.escape(entry.name)}`;
+ }
+ return html;
+};
diff --git a/assets/javascripts/templates/sidebar_tmpl.coffee b/assets/javascripts/templates/sidebar_tmpl.coffee
deleted file mode 100644
index f37dabcc6a..0000000000
--- a/assets/javascripts/templates/sidebar_tmpl.coffee
+++ /dev/null
@@ -1,76 +0,0 @@
-templates = app.templates
-
-templates.sidebarDoc = (doc, options = {}) ->
- link = """"""
- if options.disabled
- link += """Enable"""
- else
- link += """"""
- link += """#{doc.release}""" if doc.release
- link += """#{doc.name}"""
- link += " #{doc.version}" if options.disabled and doc.version
- link + ""
-
-templates.sidebarType = (type) ->
- """#{type.count}#{type.name}"""
-
-templates.sidebarEntry = (entry) ->
- """#{$.escape entry.name}"""
-
-templates.sidebarResult = (entry) ->
- addons = if entry.isIndex() and app.disabledDocs.contains(entry.doc)
- """Enable"""
- else
- """"""
- addons += """#{entry.doc.short_version}""" if entry.doc.version and not entry.isIndex()
- """#{addons}#{$.escape entry.name}"""
-
-templates.sidebarNoResults = ->
- html = """
alt + c shortcut to copy URL of original page."
+ ],
+ [
+ "2021-02-26",
+ "New documentation: React Bootstrap"
+ ],
+ [
+ "2021-01-03",
+ "New documentation: OCaml"
+ ],
+ [
+ "2020-12-23",
+ "New documentation: GTK"
+ ],
+ [
+ "2020-12-07",
+ "New documentations: Flask, Groovy, Jinja, Werkzeug"
+ ],
+ [
+ "2020-12-04",
+ "New documentation: HAProxy"
+ ],
+ [
+ "2020-11-17",
+ "TensorFlow has been split into TensorFlow Python, TensorFlow C++"
+ ],
+ [
+ "2020-11-14",
+ "New documentations: PyTorch, Spring Boot"
+ ],
+ [
+ "2020-01-13",
+ "New “Automatic” theme: match your browser or system dark mode setting. Enable it in preferences."
+ ],
+ [
+ "2020-01-13",
+ "New documentation: Gnuplot"
+ ],
+ [
+ "2019-10-26",
+ "New documentation: Sequelize"
+ ], [
+ "2019-10-20",
+ "New documentations: MariaDB and ReactiveX"
+ ], [
+ "2019-09-02",
+ "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"
+ ], [
+ "2019-07-21",
+ "Fixed several bugs, added an option to automatically download documentation and more."
+ ], [
+ "2019-07-19",
+ "Replaced the AppCache with a Service Worker (which makes DevDocs an installable PWA) and fixed layout preferences on Firefox."
+ ], [
+ "2018-09-23",
+ "New documentations: Puppeteer and Handlebars.js"
+ ], [
+ "2018-08-12",
+ "New documentations: Dart and Qt"
+ ], [
+ "2018-07-29",
+ "New documentations: Bash, Graphite and Pygame"
+ ], [
+ "2018-07-08",
+ "New documentations: Leaflet, Terraform and Koa"
+ ], [
+ "2018-03-26",
+ "DevDocs is joining the freeCodeCamp community. Read the announcement here."
+ ], [
+ "2018-02-04",
+ "New documentations: Babel, Jekyll and JSDoc"
+ ], [
+ "2017-11-26",
+ "New documentations: Bluebird, ESLint and Homebrew"
+ ], [
+ "2017-11-18",
+ "Added print & PDF stylesheet.\nFeedback welcome on Twitter and GitHub."
+ ], [
+ "2017-09-10",
+ "Preferences can now be exported and imported."
+ ], [
+ "2017-09-03",
+ "New documentations: D, Nim and Vulkan"
+ ], [
+ "2017-07-23",
+ "New documentation: Godot"
+ ], [
+ "2017-06-04",
+ "New documentations: Electron, Pug, and Falcon"
+ ], [
+ "2017-05-14",
+ "New documentations: Jest, Jasmine and Liquid"
+ ], [
+ "2017-04-30",
+ "New documentation: OpenJDK"
+ ], [
+ "2017-02-26",
+ "Refreshed design.",
+ "Added Preferences."
+ ], [
+ "2017-01-22",
+ "New HTTP documentation (thanks Mozilla)"
+ ], [
+ "2016-12-04",
+ "New documentations: SQLite, Codeception and CodeceptJS"
+ ], [
+ "2016-11-20",
+ "New documentations: Yarn, Immutable.js and Async"
+ ], [
"2016-10-10",
"New documentations: scikit-learn and Statsmodels"
], [
@@ -55,7 +330,7 @@
"New documentations: Erlang and Tcl/Tk"
], [
"2016-01-24",
- "“Multi-version support” has landed!\nClick Select documentation to pick which versions to use. More versions will be added in the coming weeks.\nIf you notice any bugs, please report them on GitHub."
+ "“Multi-version support” has landed!"
], [
"2015-11-22",
"New documentations: Phoenix, Dojo, Relay and Flow"
@@ -79,11 +354,8 @@
"New documentations: Q and OpenTSDB"
], [
"2015-07-26",
- "Added search abbreviations (e.g. $ is an alias for jQuery).\nClick here to see the full list. Feel free to suggest more on GitHub.",
+ "Added search aliases (e.g. $ is an alias for jQuery).\nClick here to see the full list. Feel free to suggest more on GitHub.",
"Added shift + ↓/↑ shortcut for scrolling (same as alt + ↓/↑)."
- ], [
- "2015-07-12",
- "New sponsors: JetBrains and Code School\nIf you like DevDocs, please take a moment to check out their products — they're awesome!"
], [
"2015-07-05",
"New documentations: Drupal, Vue.js, Phaser and webpack"
@@ -108,10 +380,10 @@
"New io.js, Symfony, Clojure, Lua and Yii 1.1 documentations"
], [
"2015-02-08",
- "New dark theme\nClick the icon in the bottom left corner to activate.\nFeedback welcome :)"
+ "New dark theme"
], [
"2015-01-13",
- "Offline mode has landed!\nIf you notice any bugs, please report them on GitHub."
+ "Offline mode has landed!"
], [
"2014-12-21",
"New React, RethinkDB, Socket.IO, Modernizr and Bower documentations"
@@ -123,7 +395,7 @@
"New Python 2 documentation"
], [
"2014-11-09",
- "New design\nFeedback welcome on Twitter and GitHub."
+ "New design\nFeedback welcome on Twitter and GitHub."
], [
"2014-10-19",
"New SVG, Marionette.js, and Mongoose documentations"
@@ -208,7 +480,7 @@
"New Ruby documentation"
], [
"2013-10-24",
- "DevDocs is now open source."
+ "DevDocs is now open source."
], [
"2013-10-09",
"DevDocs is now available as a Chrome web app."
diff --git a/assets/javascripts/templates/base.coffee b/assets/javascripts/templates/base.coffee
deleted file mode 100644
index 841d1e0bb7..0000000000
--- a/assets/javascripts/templates/base.coffee
+++ /dev/null
@@ -1,11 +0,0 @@
-app.templates.render = (name, value, args...) ->
- template = app.templates[name]
-
- if Array.isArray(value)
- result = ''
- result += template(val, args...) for val in value
- result
- else if typeof template is 'function'
- template(value, args...)
- else
- template
diff --git a/assets/javascripts/templates/base.js b/assets/javascripts/templates/base.js
new file mode 100644
index 0000000000..fc445ef19c
--- /dev/null
+++ b/assets/javascripts/templates/base.js
@@ -0,0 +1,15 @@
+app.templates.render = function (name, value, ...args) {
+ const template = app.templates[name];
+
+ if (Array.isArray(value)) {
+ let result = "";
+ for (var val of value) {
+ result += template(val, ...args);
+ }
+ return result;
+ } else if (typeof template === "function") {
+ return template(value, ...args);
+ } else {
+ return template;
+ }
+};
diff --git a/assets/javascripts/templates/error_tmpl.coffee b/assets/javascripts/templates/error_tmpl.coffee
deleted file mode 100644
index a6a8e97458..0000000000
--- a/assets/javascripts/templates/error_tmpl.coffee
+++ /dev/null
@@ -1,67 +0,0 @@
-error = (title, text = '', links = '') ->
- text = """#{text}
""" if text - links = """#{links}
""" if links - """#{title}
#{text}#{links}- If you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. """, - """ #{back} · Reload - · Retry """ - -app.templates.bootError = -> - error """ The app failed to load. """, - """ Check your Internet connection and try reloading.
- If you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. """ - -app.templates.offlineError = (reason) -> - if reason is 'cookie_blocked' - return error """ Cookies must be enabled to use offline mode. """ - - reason = switch reason - when 'not_supported' - """ Unfortunately your browser either doesn't support IndexedDB or does not make it available. """ - when 'cant_open' - """ Although your browser supports IndexedDB, DevDocs couldn't open the database.
- This could be because you're browsing in private mode or have disallowed offline storage on the domain. """ - when 'empty' - """ Although your browser supports IndexedDB, DevDocs couldn't properly set up the database.
- This could be because the database is corrupted. Try resetting the app. """ - when 'apple' - """ Unfortunately Safari's implementation of IndexedDB is badly broken.
- This message will automatically go away when Apple fix their code. """ - - error """ Offline mode is unavailable. """, - """ DevDocs requires IndexedDB to cache documentations for offline access.
#{reason} """ - -app.templates.unsupportedBrowser = """ -
-
-"""
diff --git a/assets/javascripts/templates/error_tmpl.js b/assets/javascripts/templates/error_tmpl.js
new file mode 100644
index 0000000000..c047d46e5e
--- /dev/null
+++ b/assets/javascripts/templates/error_tmpl.js
@@ -0,0 +1,95 @@
+const error = function (title, text, links) {
+ if (text == null) {
+ text = "";
+ }
+ if (links == null) {
+ links = "";
+ }
+ if (text) {
+ text = `Your browser is unsupported, sorry.
-DevDocs is an API documentation browser which supports the following browsers: -
-
-
- Recent versions of Chrome and Firefox -
- Safari 5.1+ -
- Opera 12.1+ -
- Internet Explorer 10+ -
- iOS 6+ -
- Android 4.1+ -
- Windows Phone 8+ -
- If you're unable to upgrade, I apologize. - I decided to prioritize speed and new features over support for older browsers. -
- Note: if you're already using one of the browsers above, check your settings and add-ons. - The app uses feature detection, not user agent sniffing. -
- — Thibaut @DevDocs -
${text}
`; + } + if (links) { + links = `${links}
`; + } + return `${title}
${text}${links}+If you're online and you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. `, + ` ${back} · Reload +· Retry `, + ); + +app.templates.bootError = () => + error( + " The app failed to load. ", + ` Check your Internet connection and try reloading.
+If you keep seeing this, you're likely behind a proxy or firewall that blocks cross-domain requests. `, + ); + +app.templates.offlineError = function (reason, exception) { + if (reason === "cookie_blocked") { + return error(" Cookies must be enabled to use offline mode. "); + } + + reason = (() => { + switch (reason) { + case "not_supported": + return ` DevDocs requires IndexedDB to cache documentations for offline access.
+Unfortunately your browser either doesn't support IndexedDB or doesn't make it available. `; + case "buggy": + return ` DevDocs requires IndexedDB to cache documentations for offline access.
+Unfortunately your browser's implementation of IndexedDB contains bugs that prevent DevDocs from using it. `; + case "private_mode": + return ` Your browser appears to be running in private mode.
+This prevents DevDocs from caching documentations for offline access.`; + case "exception": + return ` An error occurred when trying to open the IndexedDB database:
+
${exception.name}: ${exception.message} `;
+ case "cant_open":
+ return ` An error occurred when trying to open the IndexedDB database:+
${exception.name}: ${exception.message}+This could be because you're browsing in private mode or have disallowed offline storage on the domain. `; + case "version": + return ` The IndexedDB database was modified with a newer version of the app.
+Reload the page to use offline mode. `; + case "empty": + return ' The IndexedDB database appears to be corrupted. Try resetting the app. '; + } + })(); + + return error("Offline mode is unavailable.", reason); +}; + +app.templates.unsupportedBrowser = `\ +
+
\
+`;
diff --git a/assets/javascripts/templates/notice_tmpl.coffee b/assets/javascripts/templates/notice_tmpl.coffee
deleted file mode 100644
index 6aab2e42bf..0000000000
--- a/assets/javascripts/templates/notice_tmpl.coffee
+++ /dev/null
@@ -1,9 +0,0 @@
-notice = (text) -> """Your browser is unsupported, sorry.
+DevDocs is an API documentation browser which supports the following browsers: +
-
+
- Recent versions of Firefox, Chrome, or Opera +
- Safari 11.1+ +
- Edge 17+ +
- iOS 11.3+ +
+ If you're unable to upgrade, we apologize. + We decided to prioritize speed and new features over support for older browsers. +
+ Note: if you're already using one of the browsers above, check your settings and add-ons. + The app uses feature detection, not user agent sniffing. +
+ — @DevDocs +
#{text}
""" - -app.templates.singleDocNotice = (doc) -> - notice """ You're browsing the #{doc.fullName} documentation. To browse all docs, go to - #{app.config.production_host} (or pressesc). """
-
-app.templates.disabledDocNotice = ->
- notice """ This documentation is disabled.
- To enable it, click Select documentation. """
diff --git a/assets/javascripts/templates/notice_tmpl.js b/assets/javascripts/templates/notice_tmpl.js
new file mode 100644
index 0000000000..49793eb571
--- /dev/null
+++ b/assets/javascripts/templates/notice_tmpl.js
@@ -0,0 +1,9 @@
+const notice = (text) => `${text}
`; + +app.templates.singleDocNotice = (doc) => + notice(` You're browsing the ${doc.fullName} documentation. To browse all docs, go to +${app.config.production_host} (or pressesc). `);
+
+app.templates.disabledDocNotice = () =>
+ notice(` This documentation is disabled.
+To enable it, go to Preferences. `);
diff --git a/assets/javascripts/templates/notif_tmpl.coffee b/assets/javascripts/templates/notif_tmpl.coffee
deleted file mode 100644
index 73a3352c30..0000000000
--- a/assets/javascripts/templates/notif_tmpl.coffee
+++ /dev/null
@@ -1,63 +0,0 @@
-notif = (title, html) ->
- html = html.replace /#{title}#{html}"""
-
-textNotif = (title, message) ->
- notif title, """#{message}"""
-
-app.templates.notifUpdateReady = ->
- textNotif """ DevDocs has been updated. """,
- """ Reload the page to use the new version. """
-
-app.templates.notifError = ->
- textNotif """ Oops, an error occured. """,
- """ Try reloading, and if the problem persists,
- resetting the app.
- You can also report this issue on GitHub. """
-
-app.templates.notifQuotaExceeded = ->
- textNotif """ The offline database has exceeded its size limitation. """,
- """ 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. """
-
-app.templates.notifCookieBlocked = ->
- textNotif """ Please enable cookies. """,
- """ DevDocs will not work properly if cookies are disabled. """
-
-app.templates.notifInvalidLocation = ->
- textNotif """ DevDocs must be loaded from #{app.config.production_host} """,
- """ Otherwise things are likely to break. """
-
-app.templates.notifNews = (news) ->
- notif 'Changelog', """
#{app.templates.newsList(news, years: false)}
"""
-
-app.templates.notifUpdates = (docs, disabledDocs) ->
- html = ''
-
- if docs.length > 0
- html += ''
-
- notif 'Updates', "#{html}
"
-
-app.templates.notifShare = ->
- textNotif """ Hi there! """,
- """ Like DevDocs? Help us reach more developers by sharing the link with your friends on
- Twitter, Facebook,
- Reddit, etc.'
- html += '
'
-
- if disabledDocs.length > 0
- html += '- '
- for doc in docs
- html += "
- #{doc.name}"
- html += "
→#{doc.release}" if doc.release - html += '
Disabled:' - html += '
- '
- for doc in disabledDocs
- html += "
- #{doc.name}"
- html += "
→#{doc.release}" if doc.release - html += """Enable""" - html += '
Thanks :) """ - -app.templates.notifUpdateDocs = -> - textNotif """ Documentation updates available. """, - """ Install them as soon as possible to avoid broken pages. """ diff --git a/assets/javascripts/templates/notif_tmpl.js b/assets/javascripts/templates/notif_tmpl.js new file mode 100644 index 0000000000..f24c3c11a0 --- /dev/null +++ b/assets/javascripts/templates/notif_tmpl.js @@ -0,0 +1,110 @@ +const notif = function (title, html) { + html = html.replace(/${title} +${html} +\ +`; +}; + +const textNotif = (title, message) => + notif(title, `
${message}`);
+
+app.templates.notifUpdateReady = () =>
+ textNotif(
+ 'DevDocs has been updated.',
+ 'Reload the page to use the new version.',
+ );
+
+app.templates.notifError = () =>
+ textNotif(
+ " Oops, an error occurred. ",
+ ` Try reloading, and if the problem persists,
+resetting the app.
+You can also report this issue on GitHub. `,
+ );
+
+app.templates.notifQuotaExceeded = () =>
+ textNotif(
+ " The offline database has exceeded its size limitation. ",
+ " 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. ",
+ );
+
+app.templates.notifCookieBlocked = () =>
+ textNotif(
+ " Please enable cookies. ",
+ " DevDocs will not work properly if cookies are disabled. ",
+ );
+
+app.templates.notifInvalidLocation = () =>
+ textNotif(
+ ` DevDocs must be loaded from ${app.config.production_host} `,
+ " Otherwise things are likely to break. ",
+ );
+
+app.templates.notifImportInvalid = () =>
+ textNotif(
+ " Oops, an error occurred. ",
+ " The file you selected is invalid. ",
+ );
+
+app.templates.notifNews = (news) =>
+ notif(
+ "Changelog",
+ `
${app.templates.newsList(news, {
+ years: false,
+ })}
`,
+ );
+
+app.templates.notifUpdates = function (docs, disabledDocs) {
+ let doc;
+ let html = '';
+
+ if (docs.length > 0) {
+ html += '";
+ }
+
+ return notif("Updates", `${html}
`);
+};
+
+app.templates.notifShare = () =>
+ textNotif(
+ " Hi there! ",
+ ` Like DevDocs? Help us reach more developers by sharing the link with your friends on
+Twitter, Facebook,
+Reddit, etc.';
+ html += '
";
+ }
+
+ if (disabledDocs.length > 0) {
+ html += '- ';
+ for (doc of docs) {
+ html += `
- ${doc.name}`;
+ if (doc.release) {
+ html += `
→${doc.release}`; + } + } + html += "
Disabled:'; + html += '
- ';
+ for (doc of disabledDocs) {
+ html += `
- ${doc.name}`;
+ if (doc.release) {
+ html += `
→${doc.release}`; + } + html += 'Enable'; + } + html += "
Thanks :) `, + ); + +app.templates.notifUpdateDocs = () => + textNotif( + " Documentation updates available. ", + ' Install them as soon as possible to avoid broken pages. ', + ); + +app.templates.notifAnalyticsConsent = () => + textNotif( + " Tracking cookies ", + ` We would like to gather usage data about how DevDocs is used through Google Analytics and Gauges. We only collect anonymous traffic information. +Please confirm if you accept our tracking cookies. You can always change your decision in the settings. +
Accept or Decline `, + ); diff --git a/assets/javascripts/templates/pages/about_tmpl.coffee b/assets/javascripts/templates/pages/about_tmpl.coffee deleted file mode 100644 index 3ac46435c1..0000000000 --- a/assets/javascripts/templates/pages/about_tmpl.coffee +++ /dev/null @@ -1,578 +0,0 @@ -app.templates.aboutPage = -> """ - - -
API Documentation Browser
-DevDocs combines multiple API documentations in a fast, organized, and searchable interface. -
-
-
- Created and maintained by Thibaut Courouble -
- Free and open source - -
To keep up-to-date with the latest news: -
-
-
- Follow @DevDocs on Twitter -
- Watch the repository on GitHub -
- Join the mailing list -
If you like DevDocs, please consider supporting my work on
- Gratipay. Thanks!
-
-
Credits
- -Special thanks to: -
-
-
- MaxCDN and Gauges for offering a free account to DevDocs -
- MaxCDN, Shopify, JetBrains and Code School for sponsoring DevDocs in the past -
- Heroku and New Relic for providing awesome free service -
- Daniel Bruce for the Entypo pictograms -
- Jeremy Kratz for the C/C++ logo -
| Documentation - | Copyright - | License - #{(" |
|---|---|---|
| #{c[0]} | © #{c[1]} | #{c[2]}" for c in credits).join('')} - |
Questions & Answers
--
-
- Where can I suggest new docs and features? -
- You can suggest and vote for new docs on the Trello board.
- If you have a specific feature request, add it to the issue tracker.
- Otherwise use the mailing list. - - Where can I report bugs? -
- In the issue tracker. Thanks! -
For anything else, feel free to email me at thibaut@devdocs.io. - -
Copyright and License
-
- Copyright 2013–2016 Thibaut Courouble and other contributors
- This software is licensed under the terms of the Mozilla Public License v2.0.
- You may obtain a copy of the source code at github.com/Thibaut/devdocs.
- For more information, see the COPYRIGHT
- and LICENSE files.
-
-
Plugins and Extensions
- - -Privacy Policy
--
-
- devdocs.io ("App") is operated by Thibaut Courouble ("We"). -
- We do not collect personal information. -
- We use Google Analytics, Gauges and Sentry to collect anonymous traffic information and improve the app. -
- The app uses cookies to store user preferences. -
- 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. -
- If you have any questions regarding privacy, please email thibaut@devdocs.io. -
Angular.js', - '2010-2016 Google, Inc.', - 'CC BY', - 'https://creativecommons.org/licenses/by/4.0/' - ], [ - 'Ansible', - '2012-2016 Michael DeHaan
© 2016 Red Hat, Inc.', - 'GPLv3', - 'https://raw.githubusercontent.com/ansible/ansible/devel/COPYING' - ], [ - 'Apache HTTP Server
Apache Pig', - '2016 The Apache Software Foundation
Apache and the Apache feather logo are trademarks of The Apache Software Foundation.', - 'Apache', - 'https://www.apache.org/licenses/LICENSE-2.0' - ], [ - 'Backbone.js', - '2010-2016 Jeremy Ashkenas, DocumentCloud', - 'MIT', - 'https://raw.githubusercontent.com/jashkenas/backbone/master/LICENSE' - ], [ - 'Bootstrap', - '2011-2016 Twitter, Inc.', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'Bottle', - '2016 Marcel Hellkamp', - 'MIT', - 'https://raw.githubusercontent.com/bottlepy/bottle/master/LICENSE' - ], [ - 'Bower', - '2016 Bower contributors', - 'MIT', - 'https://github.com/bower/bower.github.io/blob/1057905c18d899106f91372e6cca7ef54a91d60f/package.json#L20' - ], [ - 'C
C++', - 'cppreference.com', - 'CC BY-SA', - 'http://en.cppreference.com/w/Cppreference:Copyright/CC-BY-SA' - ], [ - 'CakePHP', - '2005-2016 The Cake Software Foundation, Inc.', - 'MIT', - 'https://raw.githubusercontent.com/cakephp/cakephp/master/LICENSE.txt' - ], [ - 'Chai', - '2011-2015 Jake Luer', - 'MIT', - 'https://github.com/chaijs/chai/blob/master/README.md#license' - ], [ - 'Chef™', - 'Chef Software, Inc.', - 'CC BY', - 'https://raw.githubusercontent.com/chef/chef-web-docs-2016/master/LICENSE' - ], [ - 'Clojure', - 'Rich Hickey', - 'EPL', - 'https://github.com/clojure/clojure/blob/master/epl-v10.html' - ], [ - 'CMake', - '2000-2016 Kitware, Inc.
© 2000-2011 Insight Software Consortium', - 'BSD', - 'https://cmake.org/licensing/' - ], [ - 'CodeIgniter', - '2014-2016 British Columbia Institute of Technology', - 'MIT', - 'https://raw.githubusercontent.com/bcit-ci/CodeIgniter/develop/license.txt' - ], [ - 'CoffeeScript', - '2009-2015 Jeremy Ashkenas', - 'MIT', - 'https://raw.githubusercontent.com/jashkenas/coffee-script/master/LICENSE' - ], [ - 'Cordova', - '2012-2016 The Apache Software Foundation', - 'Apache', - 'https://raw.githubusercontent.com/apache/cordova-docs/master/LICENSE' - ], [ - 'CSS
DOM
HTML
JavaScript
SVG
XPath', - '2005-2016 Mozilla Developer Network and individual contributors', - 'CC BY-SA', - 'https://creativecommons.org/licenses/by-sa/2.5/' - ], [ - 'Crystal', - '2012-2016 Manas Technology Solutions', - 'Apache', - 'https://raw.githubusercontent.com/crystal-lang/crystal/master/LICENSE' - ], [ - 'D3.js', - '2010-2016 Michael Bostock', - 'BSD', - 'https://raw.githubusercontent.com/d3/d3/master/LICENSE' - ], [ - 'Django', - 'Django Software Foundation and individual contributors', - 'BSD', - 'https://raw.githubusercontent.com/django/django/master/LICENSE' - ], [ - 'Docker', - '2013-2016 Docker, Inc.
Docker and the Docker logo are trademarks of Docker, Inc.', - 'Apache', - 'https://raw.githubusercontent.com/docker/docker/master/LICENSE' - ], [ - 'Dojo', - '2005-2015 The Dojo Foundation', - 'BSD + AFL', - 'http://dojotoolkit.org/license.html' - ], [ - 'Drupal', - '2001-2015 by the original authors
Drupal is a registered trademark of Dries Buytaert.', - 'GPLv2', - 'https://api.drupal.org/api/drupal/LICENSE.txt' - ], [ - 'Ember.js', - '2016 Yehuda Katz, Tom Dale and Ember.js contributors', - 'MIT', - 'https://raw.githubusercontent.com/emberjs/ember.js/master/LICENSE' - ], [ - 'Elixir', - '2012-2016 Plataformatec', - 'Apache', - 'https://raw.githubusercontent.com/elixir-lang/elixir/master/LICENSE' - ], [ - 'Erlang', - '1999-2016 Ericsson AB', - 'Apache', - 'https://raw.githubusercontent.com/erlang/otp/maint/LICENSE.txt' - ], [ - 'Express', - '2016 StrongLoop, IBM, and other expressjs.com contributors.', - 'Unknown', - 'https://github.com/expressjs/expressjs.com/issues/413' - ], [ - 'Fish', - '2005-2009 Axel Liljencrantz', - 'GPLv2', - 'https://fishshell.com/docs/current/license.html' - ], [ - 'GCC
GNU Fortran', - 'Free Software Foundation', - 'GFDL', - 'https://www.gnu.org/licenses/fdl-1.3.en.html' - ], [ - 'Git', - '2005-2016 Linus Torvalds and others', - 'GPLv2', - 'https://raw.githubusercontent.com/git/git/master/COPYING' - ], [ - 'Go', - 'Google, Inc.', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'Grunt', - 'GruntJS Team', - 'MIT', - 'https://github.com/gruntjs/grunt-docs/blob/master/package.json#L10' - ], [ - 'Haskell', - 'The University of Glasgow', - 'BSD', - 'https://www.haskell.org/ghc/license' - ], [ - 'Haxe', - '2005-2016 Haxe Foundation', - 'MIT', - 'http://haxe.org/foundation/open-source.html' - ], [ - 'InfluxData', - '2015 InfluxData, Inc.', - 'MIT', - 'https://github.com/influxdata/docs.influxdata.com/blob/master/LICENSE' - ], [ - 'jQuery', - 'Packt Publishing
© jQuery Foundation and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/jquery/api.jquery.com/master/LICENSE.txt' - ], [ - 'jQuery Mobile', - 'jQuery Foundation and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/jquery/api.jquerymobile.com/master/LICENSE.txt' - ], [ - 'jQuery UI', - 'jQuery Foundation and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/jquery/api.jqueryui.com/master/LICENSE.txt' - ], [ - 'Julia', - '2009-2016 Jeff Bezanson, Stefan Karpinski, Viral B. Shah, and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/JuliaLang/julia/master/LICENSE.md' - ], [ - 'Knockout.js', - 'Steven Sanderson, the Knockout.js team, and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/knockout/knockout/master/LICENSE' - ], [ - 'Kotlin', - '2010-2016 JetBrains s.r.o.', - 'Apache', - 'https://raw.githubusercontent.com/JetBrains/kotlin-web-site/master/LICENSE' - ], [ - 'Laravel', - 'Taylor Otwell', - 'MIT', - 'https://raw.githubusercontent.com/laravel/framework/master/LICENSE.txt' - ], [ - 'Less', - '2009-2016 The Core Less Team', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'Lo-Dash', - '2012-2016 The Dojo Foundation', - 'MIT', - 'https://raw.githubusercontent.com/lodash/lodash/master/LICENSE.txt' - ], [ - 'Lua', - '1994–2015 Lua.org, PUC-Rio', - 'MIT', - 'http://www.lua.org/license.html' - ], [ - 'LÖVE', - '2006-2016 LÖVE Development Team', - 'GFDL', - 'http://www.gnu.org/copyleft/fdl.html' - ], [ - 'Marionette.js', - '2016 Muted Solutions, LLC', - 'MIT', - 'https://mutedsolutions.mit-license.org/' - ], [ - 'Markdown', - '2004 John Gruber', - 'BSD', - 'https://daringfireball.net/projects/markdown/license' - ], [ - 'Matplotlib', - '2012-2016 Matplotlib Development Team. All rights reserved.', - 'Custom', - 'https://raw.githubusercontent.com/matplotlib/matplotlib/master/LICENSE/LICENSE' - ], [ - 'Meteor', - '2011-2016 Meteor Development Group', - 'MIT', - 'https://raw.githubusercontent.com/meteor/meteor/master/LICENSE.txt' - ], [ - 'Minitest', - 'Ryan Davis, seattle.rb', - 'MIT', - 'https://github.com/seattlerb/minitest/blob/master/README.rdoc#license' - ], [ - 'Mocha', - 'Mocha contributors', - 'CC BY', - 'https://creativecommons.org/licenses/by/4.0/' - ], [ - 'Modernizr', - '2009-2016 The Modernizr team', - 'MIT', - 'https://modernizr.com/license/' - ], [ - 'Moment.js', - '2011-2016 Tim Wood, Iskren Chernev, Moment.js contributors', - 'MIT', - 'https://raw.githubusercontent.com/moment/moment/master/LICENSE' - ], [ - 'Mongoose', - '2010 LearnBoost', - 'MIT', - 'https://github.com/LearnBoost/mongoose/blob/master/README.md#license' - ], [ - 'nginx', - '2002-2016 Igor Sysoev
© 2011-2016 Nginx, Inc.', - 'BSD', - 'http://nginx.org/LICENSE' - ], [ - 'nginx / Lua Module', - '2009-2016 Xiaozhe Wang (chaoslawful)
© 2009-2016 Yichun "agentzh" Zhang (章亦春), CloudFlare Inc.', - 'BSD', - 'https://github.com/openresty/lua-nginx-module#copyright-and-license' - ], [ - 'Node.js', - 'Joyent, Inc. and other Node contributors
Node.js is a trademark of Joyent, Inc.', - 'MIT', - 'https://raw.githubusercontent.com/nodejs/node/master/LICENSE' - ], [ - 'Nokogiri', - '2008-2016 Aaron Patterson, Mike Dalessio, Charles Nutter, Sergio Arbeo, Patrick Mahoney, Yoko Harada, Akinori Musha, John Shahid', - 'MIT', - 'https://raw.githubusercontent.com/sparklemotion/nokogiri/master/LICENSE.txt' - ], [ - 'npm', - 'npm, Inc. and Contributors
npm is a trademark of npm, Inc.', - 'npm', - 'https://raw.githubusercontent.com/npm/npm/master/LICENSE' - ], [ - 'NumPy', - '2008-2016 NumPy Developers', - 'NumPy', - 'https://raw.githubusercontent.com/numpy/numpy/master/LICENSE.txt' - ], [ - 'OpenTSDB', - '2010-2016 The OpenTSDB Authors', - 'LGPLv2.1', - 'https://raw.githubusercontent.com/OpenTSDB/opentsdb.net/gh-pages/COPYING.LESSER' - ], [ - 'Padrino', - '2010-2016 Padrino', - 'MIT', - 'https://raw.githubusercontent.com/padrino/padrino-framework/master/padrino/LICENSE.txt' - ], [ - 'pandas', - '2011-2012 Lambda Foundry, Inc. and PyData Development Team
© 2008-2011 AQR Capital Management, LLC
© 2008-2014 the pandas development team', - 'BSD', - 'https://raw.githubusercontent.com/pydata/pandas/master/LICENSE' - ], [ - 'Perl', - '1993-2016 Larry Wall and others', - 'GPLv1', - 'http://perldoc.perl.org/index-licence.html' - ], [ - 'Phalcon', - '2011-2016 Phalcon Framework Team', - 'CC BY', - 'https://docs.phalconphp.com/en/latest/reference/license.html' - ], [ - 'Phaser', - '2016 Richard Davey, Photon Storm Ltd.', - 'MIT', - 'https://raw.githubusercontent.com/photonstorm/phaser/master/license.txt' - ], [ - 'Phoenix', - '2014 Chris McCord', - 'MIT', - 'https://raw.githubusercontent.com/phoenixframework/phoenix/master/LICENSE.md' - ], [ - 'PHP', - '1997-2016 The PHP Documentation Group', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'PHPUnit', - '2005-2016 Sebastian Bergmann', - 'CC BY', - 'https://creativecommons.org/licenses/by/3.0/' - ], [ - 'PostgreSQL', - '1996-2016 The PostgreSQL Global Development Group
© 1994 The Regents of the University of California', - 'PostgreSQL', - 'http://www.postgresql.org/about/licence/' - ], [ - 'Python', - '1990-2015 Python Software Foundation
Python is a trademark of the Python Software Foundation.', - 'PSFL', - 'https://docs.python.org/3/license.html' - ], [ - 'Q', - '2009-2015 Kristopher Michael Kowal and contributors', - 'MIT', - 'https://raw.githubusercontent.com/kriskowal/q/v1/LICENSE' - ], [ - 'Ramda', - '2013-2016 Scott Sauyet and Michael Hurley', - 'MIT', - 'https://raw.githubusercontent.com/ramda/ramda/master/LICENSE.txt' - ], [ - 'React, React Native, Flow, Relay', - '2013-2016 Facebook Inc.', - 'CC BY', - 'https://raw.githubusercontent.com/facebook/react/master/LICENSE-docs' - ], [ - 'Redis', - '2009-2016 Salvatore Sanfilippo', - 'CC BY-SA', - 'https://creativecommons.org/licenses/by-sa/4.0/' - ], [ - 'Redux', - '2015-2016 Dan Abramov', - 'MIT', - 'https://raw.githubusercontent.com/reactjs/redux/master/LICENSE.md' - ], [ - 'RequireJS', - 'jQuery Foundation and other contributors', - 'MIT', - 'https://raw.githubusercontent.com/requirejs/requirejs/master/LICENSE' - ], [ - 'RethinkDB', - 'RethinkDB contributors', - 'CC BY-SA', - 'https://raw.githubusercontent.com/rethinkdb/docs/master/LICENSE' - ], [ - 'Ruby', - '1993-2016 Yukihiro Matsumoto', - 'Ruby', - 'https://www.ruby-lang.org/en/about/license.txt' - ], [ - 'Ruby on Rails', - '2004-2016 David Heinemeier Hansson
Rails, Ruby on Rails, and the Rails logo are trademarks of David Heinemeier Hansson.', - 'MIT', - 'https://raw.githubusercontent.com/rails/rails/master/activerecord/MIT-LICENSE' - ], [ - 'Rust', - '2016 The Rust Project Developers', - 'MIT', - 'https://raw.githubusercontent.com/rust-lang/rust/master/LICENSE-MIT' - ], [ - 'Sass', - '2006-2016 Hampton Catlin, Nathan Weizenbaum, and Chris Eppstein', - 'MIT', - 'https://raw.githubusercontent.com/sass/sass/stable/MIT-LICENSE' - ], [ - 'scikit-image', - '2011 the scikit-image team', - 'BSD', - 'http://scikit-image.org/docs/dev/license.html' - ], [ - 'scikit-learn', - '2007-2016 The scikit-learn developers', - 'BSD', - 'https://raw.githubusercontent.com/scikit-learn/scikit-learn/master/COPYING' - ], [ - 'Sinon', - '2010-2016 Christian Johansen', - 'BSD', - 'https://raw.githubusercontent.com/cjohansen/Sinon.JS/master/LICENSE' - ], [ - 'Socket.io', - '2014-2015 Automattic', - 'MIT', - 'https://raw.githubusercontent.com/Automattic/socket.io/master/LICENSE' - ], [ - 'Statsmodels', - '2009-2012 Statsmodels Developers
© 2006-2008 Scipy Developers
© 2006 Jonathan E. Taylor', - 'BSD', - 'https://raw.githubusercontent.com/statsmodels/statsmodels/master/LICENSE.txt' - ], [ - 'Symfony', - '2004-2016 Fabien Potencier', - 'MIT', - 'https://symfony.com/doc/current/contributing/code/license.html' - ], [ - 'Tcl/Tk', - 'The Regents of the University of California, Sun Microsystems, Inc., Scriptics Corporation, and other parties', - 'Tcl/Tk', - 'http://tcl.tk/software/tcltk/license.html' - ], [ - 'TensorFlow', - '2015 The TensorFlow Authors', - 'Apache', - 'https://raw.githubusercontent.com/tensorflow/tensorflow/master/LICENSE' - ], [ - 'Twig', - '2009-2016 The Twig Team', - 'BSD', - 'http://twig.sensiolabs.org/license' - ], [ - 'TypeScript', - 'Microsoft and other contributors', - 'Apache', - 'https://raw.githubusercontent.com/Microsoft/TypeScript-Handbook/master/LICENSE' - ], [ - 'Underscore.js', - '2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors', - 'MIT', - 'https://raw.githubusercontent.com/jashkenas/underscore/master/LICENSE' - ], [ - 'Vagrant', - '2010-2016 Mitchell Hashimoto', - 'MIT', - 'https://raw.githubusercontent.com/mitchellh/vagrant/master/LICENSE' - ], [ - 'Vue.js', - '2013-2016 Evan You, Vue.js contributors', - 'MIT', - 'https://raw.githubusercontent.com/vuejs/vue/master/LICENSE' - ], [ - 'Webpack', - '2012-2016 Tobias Koppers', - 'MIT', - 'https://raw.githubusercontent.com/webpack/webpack/master/LICENSE' - ], [ - 'Yii', - '2008-2016 by Yii Software LLC', - 'BSD', - 'https://raw.githubusercontent.com/yiisoft/yii/master/LICENSE' - ] -] diff --git a/assets/javascripts/templates/pages/about_tmpl.js b/assets/javascripts/templates/pages/about_tmpl.js new file mode 100644 index 0000000000..e3142da5fc --- /dev/null +++ b/assets/javascripts/templates/pages/about_tmpl.js @@ -0,0 +1,96 @@ +app.templates.aboutPage = function () { + let doc; + const all_docs = app.docs.all().concat(...(app.disabledDocs.all() || [])); + // de-duplicate docs by doc.name + const docs = []; + for (doc of all_docs) { + if (!docs.find((d) => d.name === doc.name)) { + docs.push(doc); + } + } + return `\ + + +
DevDocs: API Documentation Browser
+DevDocs combines multiple developer documentations in a clean and organized web UI with instant search, offline support, mobile version, dark theme, keyboard shortcuts, and more. +
DevDocs is free and open source. It was created by Thibaut Courouble and is operated by freeCodeCamp. +
To keep up-to-date with the latest news: +
+ +Copyright and License
+
+ Copyright 2013–2025 Thibaut Courouble and other contributors
+ This software is licensed under the terms of the Mozilla Public License v2.0.
+ You may obtain a copy of the source code at github.com/freeCodeCamp/devdocs.
+ For more information, see the COPYRIGHT
+ and LICENSE files.
+
+
Plugins and Extensions
+ + +Questions & Answers
+-
+
- Where can I suggest new docs and features? +
- You can suggest and vote for new docs on the Trello board.
+ If you have a specific feature request, add it to the issue tracker.
+ Otherwise, come talk to us in the Discord chat room. + - Where can I report bugs? +
- In the issue tracker. Thanks! +
Credits
+ +Special thanks to: +
-
+
- Sentry and Gauges for offering a free account to DevDocs +
- MaxCDN, Shopify, JetBrains and Code School for sponsoring DevDocs in the past +
- Heroku and New Relic for providing awesome free service +
- Jeremy Kratz for the C/C++ logo +
+
+
+
+
+| Documentation + | Copyright/License + | Source code + ${docs + .map( + (doc) => + ` |
|---|---|---|
| ${doc.name} | ${doc.attribution} | Source code |
Privacy Policy
+-
+
- devdocs.io ("App") is operated by freeCodeCamp ("We"). +
- We do not collect personal information through the app. +
- 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. +
- We use Sentry to collect crash data and improve the app. +
- The app uses cookies to store user preferences. +
- 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. +
- If you have any questions regarding privacy, please email privacy@freecodecamp.org. +
Search
-
- The search is case-insensitive and supports fuzzy matching (for queries longer than two characters).
- For example, searching bgcp brings up background-clip.
- Abbreviations are also supported (full list below).
- For example, $ is an alias for jQuery.
-
-
-
- Searching a single documentation -
-
- You can scope the search to a single documentation by typing its name (or an abbreviation),
- and pressing
Tab(Spaceon mobile devices). - For example, to search the JavaScript documentation, enterjavascript- orjs, thenTab.
- To clear the current scope, empty the search field and hitBackspace. - - Prefilling the search field -
-
- The search field can be prefilled from the URL by visiting devdocs.io/#q=keyword.
- Characters after
#q=will be used as search string.
- To search a single documentation, add its name and a space before the keyword: - devdocs.io/#q=js date. - - Searching using the address bar -
-
- DevDocs supports OpenSearch, meaning it can easily be installed as a search engine on most web browsers.
-
-
-
- On Chrome, the setup is done automatically. Simply press
Tabwhen devdocs.io is autocompleted - in the omnibox (to set a custom keyword, click Manage search engines\u2026 in Chrome's settings). - - On Firefox, open the search engine list (icon in the search bar) and select Add "DevDocs Search". - DevDocs is now available in the search bar. You can also search from the location bar by following - these instructions. -
- On Chrome, the setup is done automatically. Simply press
Keyboard Shortcuts
-Selection
--
-
-
-
↓-↑- - Move selection -
-
-
→-←- - Show/hide sub-list -
-
-
enter- - Open selection -
-
-
#{ctrlKey} + enter- - Open selection in a new tab -
Navigation
--
-
-
-
#{navKey} + ←-#{navKey} + →- - Go back/forward -
-
-
alt + ↓-alt + ↑-
-shift + ↓-shift + ↑- - Scroll step by step
- -
-
space-shift + space- - Scroll screen by screen -
-
-
#{ctrlKey} + ↑-#{ctrlKey} + ↓- - Scroll to the top/bottom -
Misc
--
-
-
-
alt + f- - Focus first link in the content area
(press tab to focus the other links) - -
-
alt + r- - Reveal current page in sidebar -
-
-
alt + g- - Search on Google -
-
-
alt + s- - Search on Stack Overflow -
-
-
escape- - Reset
(press twice in single doc mode) - -
-
?- - Show this page -
- Tip: If the cursor is no longer in the search field, press backspace or - continue to type and it will refocus the search field and start showing new results. - -
Abbreviations
-Feel free to suggest new abbreviations on GitHub. -
| Word - | Alias - #{(" |
|---|---|
| #{key} | #{value}" for key, value of app.models.Entry.ALIASES).join('')} - |
User Guide
+ +Managing Documentations
++ Documentations can be enabled and disabled in the Preferences. + Alternatively, you can enable a documentation by searching for it in the main search + and clicking the "Enable" link in the results. + For faster and better search, only enable the documentations you plan on actively using. +
+ 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. + +
Search
+
+ The search is case-insensitive and ignores whitespace. It supports fuzzy matching
+ (e.g. bgcp matches background-clip)
+ as well as aliases (full list below).
+
-
+
- Searching a single documentation +
-
+ The search can be scoped to a single documentation by typing its name (or an abbreviation)
+ and pressing
tab(spaceon mobile). + For example, to search the JavaScript documentation, enterjavascript+ orjs, thentab.
+ To clear the current scope, empty the search field and hitbackspaceor +esc. + - Prefilling the search field +
-
+ The search can be prefilled from the URL by visiting devdocs.io/#q=keyword.
+ Characters after
#q=will be used as search query.
+ To search a single documentation, add its name (or an abbreviation) and a space before the keyword: + devdocs.io/#q=js date. + - Searching using the address bar +
-
+ DevDocs supports OpenSearch. It can easily be installed as a search engine on most web browsers:
+
-
+
- On Chrome, the setup is done automatically. Simply press
tabwhen devdocs.io is autocompleted + in the omnibox (to set a custom keyword, click Manage search engines\u2026 in Chrome's settings). + - On Firefox, add the search from the address bar: + Click ••• in the address bar, and select Add Search Engine. Then, you can add a keyword for this search engine in the preferences. +
- On Chrome, the setup is done automatically. Simply press
+ Note: the above search features only work for documentations that are enabled. + +
Keyboard Shortcuts
+Sidebar
+-
+
-
+ ${arrowScroll ? '
shift+ ' : ""} +↓+↑+ - Move selection +
-
+ ${arrowScroll ? '
shift+ ' : ""} +→+←+ - Show/hide sub-list +
-
+
enter+ - Open selection +
-
+
${ctrlKey} + enter+ - Open selection in a new tab +
-
+
alt + r+ - Reveal current page in sidebar +
Browsing
+-
+
-
+
${navKey} + ←+${navKey} + →+ - Go back/forward +
-
+ ${
+ arrowScroll
+ ? '
↓' + + '↑' + : 'alt + ↓' + + 'alt + ↑' + + "
" + + 'shift + ↓' + + 'shift + ↑' + } + - Scroll step by step
+ -
+
space+shift + space+ - Scroll screen by screen +
-
+
${ctrlKey} + ↑+${ctrlKey} + ↓+ - Scroll to the top/bottom +
-
+
alt + f+ - Focus first link in the content area
(press tab to focus the other links) +
App
+-
+
-
+
ctrl + ,+ - Open preferences +
-
+
esc+ - Clear search field / reset UI +
-
+
?+ - Show this page +
Miscellaneous
+-
+
-
+
alt + c+ - Copy URL of original page +
-
+
alt + o+ - Open original page +
-
+
alt + g+ - Search on Google +
-
+
alt + s+ - Search on Stack Overflow +
-
+
alt + d+ - Search on DuckDuckGo +
+ Tip: If the cursor is no longer in the search field, press / or
+ continue to type and it will refocus the search field and start showing new results.
+
+
Search Aliases
+
+
+
+
+
+
+| Word + | Alias + ${aliases_one + .map( + ([key, value]) => + ` |
|---|---|
| ${key} | ${value}`, + ) + .join("")} + |
| Word + | Alias + ${aliases_two + .map( + ([key, value]) => + ` |
|---|---|
| ${key} | ${value}`, + ) + .join("")} + |
Feel free to suggest new aliases on GitHub.\ +`; +}; diff --git a/assets/javascripts/templates/pages/news_tmpl.coffee.erb b/assets/javascripts/templates/pages/news_tmpl.coffee.erb deleted file mode 100644 index 32f0e8b9ab..0000000000 --- a/assets/javascripts/templates/pages/news_tmpl.coffee.erb +++ /dev/null @@ -1,36 +0,0 @@ -#= depend_on news.json - -app.templates.newsPage = -> - """
Changelog
-
- For the latest news, follow @DevDocs.
- For development updates, follow the project on GitHub.
-
#{app.templates.newsList app.news}
"""
-
-app.templates.newsList = (news, options = {}) ->
- year = new Date().getUTCFullYear()
- result = ''
-
- for value in news
- date = new Date(value[0])
- if options.years isnt false and year isnt date.getUTCFullYear()
- year = date.getUTCFullYear()
- result += "#{year}
" - result += newsItem(date, value[1..]) - - result - -MONTHS = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'] - -newsItem = (date, news) -> - date = """#{MONTHS[date.getUTCMonth()]} #{date.getUTCDate()}""" - result = '' - - for text, i in news - text = text.split "\n" - title = """#{text.shift()}""" - result += """#{if i is 0 then date else ''} #{title} #{text.join '
'}
"""
-
- result
-
-app.news = <%= App.news.to_json %>
diff --git a/assets/javascripts/templates/pages/news_tmpl.js.erb b/assets/javascripts/templates/pages/news_tmpl.js.erb
new file mode 100644
index 0000000000..72f4b1dd07
--- /dev/null
+++ b/assets/javascripts/templates/pages/news_tmpl.js.erb
@@ -0,0 +1,41 @@
+//= depend_on news.json
+
+app.templates.newsPage = () => ` '}
Changelog
+
+For the latest news, follow @DevDocs.
+For development updates, follow the project on GitHub.
+
${app.templates.newsList(app.news)}
`;
+
+app.templates.newsList = function(news, options = {}) {
+ let year = new Date().getUTCFullYear();
+ let result = '';
+
+ for (let value of news) {
+ const date = new Date(value[0]);
+ if ((options.years !== false) && (year !== date.getUTCFullYear())) {
+ year = date.getUTCFullYear();
+ result += `${year}
`; + } + result += newsItem(date, value.slice(1)); + } + + return result; +}; + +const MONTHS = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']; + +var newsItem = function(date, news) { + date = `${MONTHS[date.getUTCMonth()]} ${date.getUTCDate()}`; + let result = ''; + + for (let i = 0; i < news.length; i++) { + let text = news[i]; + text = text.split("\n"); + const title = `${text.shift()}`; + result += `${i === 0 ? date : ''} ${title} ${text.join('
')}
`;
+ }
+
+ return result;
+};
+
+app.news = <%= App.news.to_json %>
diff --git a/assets/javascripts/templates/pages/offline_tmpl.coffee b/assets/javascripts/templates/pages/offline_tmpl.coffee
deleted file mode 100644
index c65cc1dcf0..0000000000
--- a/assets/javascripts/templates/pages/offline_tmpl.coffee
+++ /dev/null
@@ -1,76 +0,0 @@
-app.templates.offlinePage = (docs) -> """
- ')}
Offline Documentation
- -
-
-
-
-
- | Documentation | -Size | -Status | -Action | -
|---|
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. -
Questions & Answers
--
-
- How does this work? -
- Each page is cached as a key-value pair in IndexedDB (downloaded from a single file).
- The app also uses AppCache and localStorage to cache the assets and index files. - - Can I close the tab/browser? -
- #{canICloseTheTab()} -
- What if I don't update a documentation? -
- You'll see outdated content and some pages will be missing or broken, since the rest of the app (including data for the search and sidebar) uses a different caching mechanism which is updated automatically. -
- I found a bug, where do I report it? -
- In the issue tracker. Thanks! -
- How do I uninstall/reset the app? -
- Click here. -
- Why aren't all documentations listed above? -
- You have to enable them first. -
- The current tab will continue to work, though (provided you installed all the documentations you want to use beforehand). """ - -app.templates.offlineDoc = (doc, status) -> - outdated = doc.isOutdated(status) - - html = """ -
Offline Documentation
+ +
+
+
+
+
+
+
+
+
+
+
+| Documentation | +Size | +Status | +Action | +
|---|
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. +
Questions & Answers
+-
+
- How does this work? +
- Each page is cached as a key-value pair in IndexedDB (downloaded from a single file).
+ The app also uses Service Workers and localStorage to cache the assets and index files. + - Can I close the tab/browser? +
- ${canICloseTheTab()} +
- What if I don't update a documentation? +
- 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. +
- I found a bug, where do I report it? +
- In the issue tracker. Thanks! +
- How do I uninstall/reset the app? +
- Click here. +
- Why aren't all documentations listed above? +
- You have to enable them first. +
ENABLE_SERVICE_WORKER environment variable to true)";
+ }
+
+ return ` No. Service Workers ${reason}, so loading devdocs.io offline won't work.+The current tab will continue to function even when you go offline (provided you installed all the documentations beforehand). `; + } +}; + +app.templates.offlineDoc = function (doc, status) { + const outdated = doc.isOutdated(status); + + let html = `\ +
DevDocs
"""
-
-<% if App.development? %>
-app.templates.intro = """
-
-"""
-<% else %>
-app.templates.intro = """
-
-"""
-<% end %>
-
-app.templates.mobileNav = """
-
-"""
-
-app.templates.mobileIntro = """
-
-
-"""
-
-app.templates.androidWarning = """
- Welcome!
-DevDocs combines multiple API documentations in a fast, organized, and searchable interface. - Here's what you should know before you start: -
-
-
- To pick your docs, click Select documentation at the bottom of the menu -
- The search supports fuzzy matching (e.g. "bgcp" matches "background-clip") -
- To search a specific documentation, type its name (or an abbreviation), then Space -
- For the latest news, follow @DevDocs -
- DevDocs is open source -
Happy coding! - Stop showing this message -
-
-"""
diff --git a/assets/javascripts/templates/pages/root_tmpl.js.erb b/assets/javascripts/templates/pages/root_tmpl.js.erb
new file mode 100644
index 0000000000..b82e9a9e6a
--- /dev/null
+++ b/assets/javascripts/templates/pages/root_tmpl.js.erb
@@ -0,0 +1,74 @@
+app.templates.splash = "Hi there
-DevDocs is running inside an Android WebView. Some features may not work properly. -
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. -
To install DevDocs on your phone, visit devdocs.io in Chrome and select "Add to home screen" in the menu. -
DevDocs
";
+
+<% if App.development? %>
+app.templates.intro = `\
+\
+`;
+<% else %>
+app.templates.intro = `\
+
+ Stop showing this message
+
Welcome!
+DevDocs combines multiple API documentations in a fast, organized, and searchable interface. + Here's what you should know before you start: +
-
+
- Open the Preferences to enable more docs and customize the UI. +
- You don't have to use your mouse — see the list of keyboard shortcuts or press ?. +
- The search supports fuzzy matching (e.g. "bgcp" brings up "background-clip"). +
- To search a specific documentation, type its name (or an abbr.), then Tab. +
- You can search using your browser's address bar — learn how. +
- DevDocs works offline, on mobile, and can be installed as web app. +
- For the latest news, follow @DevDocs. +
- DevDocs is free and open source. + +
- And if you're new to coding, check out freeCodeCamp's open source curriculum. +
+ Happy coding! +
+
\
+`;
+
+app.templates.androidWarning = `\
+Welcome!
+DevDocs combines multiple API documentations in a fast, organized, and searchable interface. + Here's what you should know before you start: +
-
+
- Pick your docs in the Preferences. +
- The search supports fuzzy matching. +
- To search a specific documentation, type its name (or an abbr.), then Space. +
- For the latest news, follow @DevDocs. +
- DevDocs is open source. +
Happy coding! + Stop showing this message +
+
\
+`;
diff --git a/assets/javascripts/templates/pages/settings_tmpl.js b/assets/javascripts/templates/pages/settings_tmpl.js
new file mode 100644
index 0000000000..cfd30de1b2
--- /dev/null
+++ b/assets/javascripts/templates/pages/settings_tmpl.js
@@ -0,0 +1,118 @@
+const themeOption = ({ label, value }, settings) => `\
+\
+`;
+
+app.templates.settingsPage = (settings) => `\
+Hi there
+DevDocs is running inside an Android WebView. Some features may not work properly. +
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. +
To install DevDocs on your phone, visit devdocs.io in Chrome and select "Add to home screen" in the menu. +
Preferences
+ +
+
+
+Theme:
+
+ ${
+ settings.autoSupported
+ ? themeOption(
+ {
+ label: "Automatic Matches system setting",
+ value: "auto",
+ },
+ settings,
+ )
+ : ""
+ }
+ ${themeOption({ label: "Light", value: "default" }, settings)}
+ ${themeOption({ label: "Dark", value: "dark" }, settings)}
+
+
+
+
+General:
+ +
+
+
+
+
+
+
+
+
+
+
+
+Scrolling:
+ +
+
+
+
+
+
+
++ + + +
+ \ +`; diff --git a/assets/javascripts/templates/pages/type_tmpl.coffee b/assets/javascripts/templates/pages/type_tmpl.coffee deleted file mode 100644 index c419a6a8c4..0000000000 --- a/assets/javascripts/templates/pages/type_tmpl.coffee +++ /dev/null @@ -1,6 +0,0 @@ -app.templates.typePage = (type) -> - """
#{type.doc.fullName} / #{type.name}
-- #{app.templates.render 'typePageEntry', type.entries()}
${type.doc.fullName} / ${type.name}
+- ${app.templates.render(
+ "typePageEntry",
+ type.entries(),
+ )}
No results.
"""
- html += """
- Note: documentations must be enabled to appear in the search.
- """ unless app.isSingleDoc() or app.disabledDocs.isEmpty()
- html
-
-templates.sidebarPageLink = (count) ->
- """Show more\u2026 (#{count})"""
-
-templates.sidebarLabel = (doc, options = {}) ->
- label = """"""
-
-templates.sidebarVersionedDoc = (doc, versions, options = {}) ->
- html = """#{doc.name}
#{versions}
"""
-
-templates.sidebarDisabled = (options) ->
- """Disabled (#{options.count})
""" - -templates.sidebarDisabledList = (html) -> - """#{html}
"""
-
-templates.sidebarDisabledVersionedDoc = (doc, versions) ->
- """#{doc.name}#{versions}
"""
-
-templates.sidebarPickerNote = """
- Tip: for faster and better search results, select only the docs you need.
- Vote for new documentation
- """
-
-sidebarFooter = (html) -> """"""
-
-templates.sidebarSettings = ->
- sidebarFooter """
-
-
-
- """
-
-templates.sidebarSave = ->
- sidebarFooter """Save"""
diff --git a/assets/javascripts/templates/sidebar_tmpl.js b/assets/javascripts/templates/sidebar_tmpl.js
new file mode 100644
index 0000000000..80db6aef16
--- /dev/null
+++ b/assets/javascripts/templates/sidebar_tmpl.js
@@ -0,0 +1,111 @@
+const { templates } = app;
+
+const arrow = '';
+
+templates.sidebarDoc = function (doc, options) {
+ if (options == null) {
+ options = {};
+ }
+ let link = ``;
+ if (options.disabled) {
+ link += `Enable`;
+ } else {
+ link += arrow;
+ }
+ if (doc.release) {
+ link += `${doc.release}`;
+ }
+ link += `${doc.name}`;
+ if (options.fullName || (options.disabled && doc.version)) {
+ link += ` ${doc.version}`;
+ }
+ return link + "";
+};
+
+templates.sidebarType = (type) =>
+ `${arrow}${
+ type.count
+ }${$.escape(type.name)}`;
+
+templates.sidebarEntry = (entry) =>
+ `${$.escape(
+ entry.name,
+ )}`;
+
+templates.sidebarResult = function (entry) {
+ let addons =
+ entry.isIndex() && app.disabledDocs.contains(entry.doc)
+ ? `Enable`
+ : '';
+ if (entry.doc.version && !entry.isIndex()) {
+ addons += `${entry.doc.short_version}`;
+ }
+ return `${addons}${$.escape(
+ entry.name,
+ )}`;
+};
+
+templates.sidebarNoResults = function () {
+ let html = ' No results.
';
+ if (!app.isSingleDoc() && !app.disabledDocs.isEmpty()) {
+ html += `\
+Note: documentations must be enabled to appear in the search.
\
+`;
+ }
+ return html;
+};
+
+templates.sidebarPageLink = (count) =>
+ `Show more\u2026 (${count})`;
+
+templates.sidebarLabel = function (doc, options) {
+ if (options == null) {
+ options = {};
+ }
+ let label = '`;
+};
+
+templates.sidebarVersionedDoc = function (doc, versions, options) {
+ if (options == null) {
+ options = {};
+ }
+ let html = `${versions}
`
+ );
+};
+
+templates.sidebarDisabled = (options) =>
+ `${arrow}Disabled (${options.count}) Customize
`; + +templates.sidebarDisabledList = (html) => + `${html}
`;
+
+templates.sidebarDisabledVersionedDoc = (doc, versions) =>
+ `${arrow}${doc.name}${versions}
`;
+
+templates.docPickerHeader =
+ 'Documentation Enable
';
+
+templates.docPickerNote = `\
+Tip: for faster and better search results, select only the docs you need.
+Vote for new documentation\
+`;
diff --git a/assets/javascripts/templates/tip_tmpl.coffee b/assets/javascripts/templates/tip_tmpl.coffee
deleted file mode 100644
index 9436497e61..0000000000
--- a/assets/javascripts/templates/tip_tmpl.coffee
+++ /dev/null
@@ -1,10 +0,0 @@
-app.templates.tipKeyNav = """
- - ProTip - (click to dismiss) -
- Hit ↓ ↑ ← → to navigate the sidebar.
- Hit space / shift space, alt ↓/↑ or shift ↓/↑ to scroll the page.
-
- See all keyboard shortcuts -""" diff --git a/assets/javascripts/templates/tip_tmpl.js b/assets/javascripts/templates/tip_tmpl.js new file mode 100644 index 0000000000..223ffe9587 --- /dev/null +++ b/assets/javascripts/templates/tip_tmpl.js @@ -0,0 +1,16 @@ +app.templates.tipKeyNav = () => `\ +
+ ProTip + (click to dismiss) +
+ Hit ${
+ app.settings.get("arrowScroll") ? 'shift +' : ""
+ } ↓ ↑ ← → to navigate the sidebar.
+ Hit space / shift space${
+ app.settings.get("arrowScroll")
+ ? ' or ↓/↑'
+ : ', alt ↓/↑ or shift ↓/↑'
+ } to scroll the page.
+
+ See all keyboard shortcuts\ +`; diff --git a/assets/javascripts/tracking.js b/assets/javascripts/tracking.js index 6f505c5d4b..c15781f5c3 100644 --- a/assets/javascripts/tracking.js +++ b/assets/javascripts/tracking.js @@ -1,20 +1,55 @@ try { - if (app.config.env == 'production') { - (function() { - (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ - (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), - m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) - })(window,document,'script','https://www.google-analytics.com/analytics.js','ga'); - ga('create', 'UA-5544833-12', 'devdocs.io'); - ga('send', 'pageview'); - })(); + if (app.config.env === "production") { + if (Cookies.get("analyticsConsent") === "1") { + (function (i, s, o, g, r, a, m) { + i["GoogleAnalyticsObject"] = r; + (i[r] = + i[r] || + function () { + (i[r].q = i[r].q || []).push(arguments); + }), + (i[r].l = 1 * new Date()); + (a = s.createElement(o)), (m = s.getElementsByTagName(o)[0]); + a.async = 1; + a.src = g; + m.parentNode.insertBefore(a, m); + })( + window, + document, + "script", + "https://www.google-analytics.com/analytics.js", + "ga", + ); + ga("create", "UA-5544833-12", "devdocs.io"); + page.track(function () { + ga("send", "pageview", { + page: location.pathname + location.search + location.hash, + dimension1: + app.router.context && + app.router.context.doc && + app.router.context.doc.slug_without_version, + }); + }); - (function() { - var _gauges=_gauges||[];!function(){var a=document.createElement("script"); - a.type="text/javascript",a.async=!0,a.id="gauges-tracker", - a.setAttribute("data-site-id","51c15f82613f5d7819000067"), - a.src="https://secure.gaug.es/track.js";var b=document.getElementsByTagName("script")[0]; - b.parentNode.insertBefore(a,b)}(); - })(); + page.track(function () { + if (window._gauges) _gauges.push(["track"]); + else + (function () { + var _gauges = _gauges || []; + !(function () { + var a = document.createElement("script"); + (a.type = "text/javascript"), + (a.async = !0), + (a.id = "gauges-tracker"), + a.setAttribute("data-site-id", "51c15f82613f5d7819000067"), + (a.src = "https://secure.gaug.es/track.js"); + var b = document.getElementsByTagName("script")[0]; + b.parentNode.insertBefore(a, b); + })(); + })(); + }); + } else { + resetAnalytics(); + } } -} catch(e) { } +} catch (e) {} diff --git a/assets/javascripts/vendor/cookies.js b/assets/javascripts/vendor/cookies.js index 975239c21d..e592a5de8e 100644 --- a/assets/javascripts/vendor/cookies.js +++ b/assets/javascripts/vendor/cookies.js @@ -1,141 +1,208 @@ -/*! - * Cookies.js - 0.3.1 - * Wednesday, April 24 2013 @ 2:28 AM EST +/* + * Cookies.js - 1.2.3 (patched for SameSite=Strict and secure=true) + * https://github.com/ScottHamper/Cookies * - * Copyright (c) 2013, Scott Hamper - * Licensed under the MIT license, - * http://www.opensource.org/licenses/MIT + * This is free and unencumbered software released into the public domain. */ -(function (undefined) { - 'use strict'; +(function (global, undefined) { + "use strict"; + + var factory = function (window) { + if (typeof window.document !== "object") { + throw new Error( + "Cookies.js requires a `window` with a `document` object", + ); + } var Cookies = function (key, value, options) { - return arguments.length === 1 ? - Cookies.get(key) : Cookies.set(key, value, options); + return arguments.length === 1 + ? Cookies.get(key) + : Cookies.set(key, value, options); }; // Allows for setter injection in unit tests - Cookies._document = document; - Cookies._navigator = navigator; + Cookies._document = window.document; + + // Used to ensure cookie keys do not collide with + // built-in `Object` properties + Cookies._cacheKeyPrefix = "cookey."; // Hurr hurr, :) + + Cookies._maxExpireDate = new Date("Fri, 31 Dec 9999 23:59:59 UTC"); Cookies.defaults = { - path: '/' + path: "/", + SameSite: "Strict", + secure: true, }; Cookies.get = function (key) { - if (Cookies._cachedDocumentCookie !== Cookies._document.cookie) { - Cookies._renewCache(); - } + if (Cookies._cachedDocumentCookie !== Cookies._document.cookie) { + Cookies._renewCache(); + } - return Cookies._cache[key]; + var value = Cookies._cache[Cookies._cacheKeyPrefix + key]; + + return value === undefined ? undefined : decodeURIComponent(value); }; Cookies.set = function (key, value, options) { - options = Cookies._getExtendedOptions(options); - options.expires = Cookies._getExpiresDate(value === undefined ? -1 : options.expires); - - Cookies._document.cookie = Cookies._generateCookieString(key, value, options); - - return Cookies; + options = Cookies._getExtendedOptions(options); + options.expires = Cookies._getExpiresDate( + value === undefined ? -1 : options.expires, + ); + + Cookies._document.cookie = Cookies._generateCookieString( + key, + value, + options, + ); + + return Cookies; }; Cookies.expire = function (key, options) { - return Cookies.set(key, undefined, options); + return Cookies.set(key, undefined, options); }; Cookies._getExtendedOptions = function (options) { - return { - path: options && options.path || Cookies.defaults.path, - domain: options && options.domain || Cookies.defaults.domain, - expires: options && options.expires || Cookies.defaults.expires, - secure: options && options.secure !== undefined ? options.secure : Cookies.defaults.secure - }; + return { + path: (options && options.path) || Cookies.defaults.path, + domain: (options && options.domain) || Cookies.defaults.domain, + SameSite: (options && options.SameSite) || Cookies.defaults.SameSite, + expires: (options && options.expires) || Cookies.defaults.expires, + secure: + options && options.secure !== undefined + ? options.secure + : Cookies.defaults.secure, + }; }; Cookies._isValidDate = function (date) { - return Object.prototype.toString.call(date) === '[object Date]' && !isNaN(date.getTime()); + return ( + Object.prototype.toString.call(date) === "[object Date]" && + !isNaN(date.getTime()) + ); }; Cookies._getExpiresDate = function (expires, now) { - now = now || new Date(); - switch (typeof expires) { - case 'number': expires = new Date(now.getTime() + expires * 1000); break; - case 'string': expires = new Date(expires); break; - } - - if (expires && !Cookies._isValidDate(expires)) { - throw new Error('`expires` parameter cannot be converted to a valid Date instance'); - } - - return expires; + now = now || new Date(); + + if (typeof expires === "number") { + expires = + expires === Infinity + ? Cookies._maxExpireDate + : new Date(now.getTime() + expires * 1000); + } else if (typeof expires === "string") { + expires = new Date(expires); + } + + if (expires && !Cookies._isValidDate(expires)) { + throw new Error( + "`expires` parameter cannot be converted to a valid Date instance", + ); + } + + return expires; }; Cookies._generateCookieString = function (key, value, options) { - key = encodeURIComponent(key); - value = (value + '').replace(/[^!#$&-+\--:<-\[\]-~]/g, encodeURIComponent); - options = options || {}; - - var cookieString = key + '=' + value; - cookieString += options.path ? ';path=' + options.path : ''; - cookieString += options.domain ? ';domain=' + options.domain : ''; - cookieString += options.expires ? ';expires=' + options.expires.toGMTString() : ''; - cookieString += options.secure ? ';secure' : ''; - - return cookieString; + key = key.replace(/[^#$&+\^`|]/g, encodeURIComponent); + key = key.replace(/\(/g, "%28").replace(/\)/g, "%29"); + value = (value + "").replace( + /[^!#$&-+\--:<-\[\]-~]/g, + encodeURIComponent, + ); + options = options || {}; + + var cookieString = key + "=" + value; + cookieString += options.path ? ";path=" + options.path : ""; + cookieString += options.domain ? ";domain=" + options.domain : ""; + cookieString += options.SameSite ? ";SameSite=" + options.SameSite : ""; + cookieString += options.expires + ? ";expires=" + options.expires.toUTCString() + : ""; + cookieString += options.secure ? ";secure" : ""; + + return cookieString; }; - Cookies._getCookieObjectFromString = function (documentCookie) { - var cookieObject = {}; - var cookiesArray = documentCookie ? documentCookie.split('; ') : []; + Cookies._getCacheFromString = function (documentCookie) { + var cookieCache = {}; + var cookiesArray = documentCookie ? documentCookie.split("; ") : []; - for (var i = 0; i < cookiesArray.length; i++) { - var cookieKvp = Cookies._getKeyValuePairFromCookieString(cookiesArray[i]); + for (var i = 0; i < cookiesArray.length; i++) { + var cookieKvp = Cookies._getKeyValuePairFromCookieString( + cookiesArray[i], + ); - if (cookieObject[cookieKvp.key] === undefined) { - cookieObject[cookieKvp.key] = cookieKvp.value; - } + if ( + cookieCache[Cookies._cacheKeyPrefix + cookieKvp.key] === undefined + ) { + cookieCache[Cookies._cacheKeyPrefix + cookieKvp.key] = + cookieKvp.value; } + } - return cookieObject; + return cookieCache; }; Cookies._getKeyValuePairFromCookieString = function (cookieString) { - // "=" is a valid character in a cookie value according to RFC6265, so cannot `split('=')` - var separatorIndex = cookieString.indexOf('='); - - // IE omits the "=" when the cookie value is an empty string - separatorIndex = separatorIndex < 0 ? cookieString.length : separatorIndex; + // "=" is a valid character in a cookie value according to RFC6265, so cannot `split('=')` + var separatorIndex = cookieString.indexOf("="); + + // IE omits the "=" when the cookie value is an empty string + separatorIndex = + separatorIndex < 0 ? cookieString.length : separatorIndex; + + var key = cookieString.substr(0, separatorIndex); + var decodedKey; + try { + decodedKey = decodeURIComponent(key); + } catch (e) { + if (console && typeof console.error === "function") { + console.error('Could not decode cookie with key "' + key + '"', e); + } + } - return { - key: decodeURIComponent(cookieString.substr(0, separatorIndex)), - value: decodeURIComponent(cookieString.substr(separatorIndex + 1)) - }; + return { + key: decodedKey, + value: cookieString.substr(separatorIndex + 1), // Defer decoding value until accessed + }; }; Cookies._renewCache = function () { - Cookies._cache = Cookies._getCookieObjectFromString(Cookies._document.cookie); - Cookies._cachedDocumentCookie = Cookies._document.cookie; + Cookies._cache = Cookies._getCacheFromString(Cookies._document.cookie); + Cookies._cachedDocumentCookie = Cookies._document.cookie; }; Cookies._areEnabled = function () { - return Cookies._navigator.cookieEnabled || - Cookies.set('cookies.js', 1).get('cookies.js') === '1'; + var testKey = "cookies.js"; + var areEnabled = Cookies.set(testKey, 1).get(testKey) === "1"; + Cookies.expire(testKey); + return areEnabled; }; Cookies.enabled = Cookies._areEnabled(); - // AMD support - if (typeof define === 'function' && define.amd) { - define(function () { return Cookies; }); - // CommonJS and Node.js module support. - } else if (typeof exports !== 'undefined') { - // Support Node.js specific `module.exports` (which can be a function) - if (typeof module !== 'undefined' && module.exports) { - exports = module.exports = Cookies; - } - // But always support CommonJS module 1.1.1 spec (`exports` cannot be a function) - exports.Cookies = Cookies; - } else { - window.Cookies = Cookies; + return Cookies; + }; + var cookiesExport = + global && typeof global.document === "object" ? factory(global) : factory; + + // AMD support + if (typeof define === "function" && define.amd) { + define(function () { + return cookiesExport; + }); + // CommonJS/Node.js support + } else if (typeof exports === "object") { + // Support Node.js specific `module.exports` (which can be a function) + if (typeof module === "object" && typeof module.exports === "object") { + exports = module.exports = cookiesExport; } -})(); \ No newline at end of file + // But always support CommonJS module 1.1.1 spec (`exports` cannot be a function) + exports.Cookies = cookiesExport; + } else { + global.Cookies = cookiesExport; + } +})(typeof window === "undefined" ? this : window); diff --git a/assets/javascripts/vendor/fastclick.js b/assets/javascripts/vendor/fastclick.js deleted file mode 100755 index 3af4f9d6f1..0000000000 --- a/assets/javascripts/vendor/fastclick.js +++ /dev/null @@ -1,841 +0,0 @@ -;(function () { - 'use strict'; - - /** - * @preserve FastClick: polyfill to remove click delays on browsers with touch UIs. - * - * @codingstandard ftlabs-jsv2 - * @copyright The Financial Times Limited [All Rights Reserved] - * @license MIT License (see LICENSE.txt) - */ - - /*jslint browser:true, node:true*/ - /*global define, Event, Node*/ - - - /** - * Instantiate fast-clicking listeners on the specified layer. - * - * @constructor - * @param {Element} layer The layer to listen on - * @param {Object} [options={}] The options to override the defaults - */ - function FastClick(layer, options) { - var oldOnClick; - - options = options || {}; - - /** - * Whether a click is currently being tracked. - * - * @type boolean - */ - this.trackingClick = false; - - - /** - * Timestamp for when click tracking started. - * - * @type number - */ - this.trackingClickStart = 0; - - - /** - * The element being tracked for a click. - * - * @type EventTarget - */ - this.targetElement = null; - - - /** - * X-coordinate of touch start event. - * - * @type number - */ - this.touchStartX = 0; - - - /** - * Y-coordinate of touch start event. - * - * @type number - */ - this.touchStartY = 0; - - - /** - * ID of the last touch, retrieved from Touch.identifier. - * - * @type number - */ - this.lastTouchIdentifier = 0; - - - /** - * Touchmove boundary, beyond which a click will be cancelled. - * - * @type number - */ - this.touchBoundary = options.touchBoundary || 10; - - - /** - * The FastClick layer. - * - * @type Element - */ - this.layer = layer; - - /** - * The minimum time between tap(touchstart and touchend) events - * - * @type number - */ - this.tapDelay = options.tapDelay || 200; - - /** - * The maximum time for a tap - * - * @type number - */ - this.tapTimeout = options.tapTimeout || 700; - - if (FastClick.notNeeded(layer)) { - return; - } - - // Some old versions of Android don't have Function.prototype.bind - function bind(method, context) { - return function() { return method.apply(context, arguments); }; - } - - - var methods = ['onMouse', 'onClick', 'onTouchStart', 'onTouchMove', 'onTouchEnd', 'onTouchCancel']; - var context = this; - for (var i = 0, l = methods.length; i < l; i++) { - context[methods[i]] = bind(context[methods[i]], context); - } - - // Set up event handlers as required - if (deviceIsAndroid) { - layer.addEventListener('mouseover', this.onMouse, true); - layer.addEventListener('mousedown', this.onMouse, true); - layer.addEventListener('mouseup', this.onMouse, true); - } - - layer.addEventListener('click', this.onClick, true); - layer.addEventListener('touchstart', this.onTouchStart, false); - layer.addEventListener('touchmove', this.onTouchMove, false); - layer.addEventListener('touchend', this.onTouchEnd, false); - layer.addEventListener('touchcancel', this.onTouchCancel, false); - - // Hack is required for browsers that don't support Event#stopImmediatePropagation (e.g. Android 2) - // which is how FastClick normally stops click events bubbling to callbacks registered on the FastClick - // layer when they are cancelled. - if (!Event.prototype.stopImmediatePropagation) { - layer.removeEventListener = function(type, callback, capture) { - var rmv = Node.prototype.removeEventListener; - if (type === 'click') { - rmv.call(layer, type, callback.hijacked || callback, capture); - } else { - rmv.call(layer, type, callback, capture); - } - }; - - layer.addEventListener = function(type, callback, capture) { - var adv = Node.prototype.addEventListener; - if (type === 'click') { - adv.call(layer, type, callback.hijacked || (callback.hijacked = function(event) { - if (!event.propagationStopped) { - callback(event); - } - }), capture); - } else { - adv.call(layer, type, callback, capture); - } - }; - } - - // If a handler is already declared in the element's onclick attribute, it will be fired before - // FastClick's onClick handler. Fix this by pulling out the user-defined handler function and - // adding it as listener. - if (typeof layer.onclick === 'function') { - - // Android browser on at least 3.2 requires a new reference to the function in layer.onclick - // - the old one won't work if passed to addEventListener directly. - oldOnClick = layer.onclick; - layer.addEventListener('click', function(event) { - oldOnClick(event); - }, false); - layer.onclick = null; - } - } - - /** - * Windows Phone 8.1 fakes user agent string to look like Android and iPhone. - * - * @type boolean - */ - var deviceIsWindowsPhone = navigator.userAgent.indexOf("Windows Phone") >= 0; - - /** - * Android requires exceptions. - * - * @type boolean - */ - var deviceIsAndroid = navigator.userAgent.indexOf('Android') > 0 && !deviceIsWindowsPhone; - - - /** - * iOS requires exceptions. - * - * @type boolean - */ - var deviceIsIOS = /iP(ad|hone|od)/.test(navigator.userAgent) && !deviceIsWindowsPhone; - - - /** - * iOS 4 requires an exception for select elements. - * - * @type boolean - */ - var deviceIsIOS4 = deviceIsIOS && (/OS 4_\d(_\d)?/).test(navigator.userAgent); - - - /** - * iOS 6.0-7.* requires the target element to be manually derived - * - * @type boolean - */ - var deviceIsIOSWithBadTarget = deviceIsIOS && (/OS [6-7]_\d/).test(navigator.userAgent); - - /** - * BlackBerry requires exceptions. - * - * @type boolean - */ - var deviceIsBlackBerry10 = navigator.userAgent.indexOf('BB10') > 0; - - /** - * Determine whether a given element requires a native click. - * - * @param {EventTarget|Element} target Target DOM element - * @returns {boolean} Returns true if the element needs a native click - */ - FastClick.prototype.needsClick = function(target) { - switch (target.nodeName.toLowerCase()) { - - // Don't send a synthetic click to disabled inputs (issue #62) - case 'button': - case 'select': - case 'textarea': - if (target.disabled) { - return true; - } - - break; - case 'input': - - // File inputs need real clicks on iOS 6 due to a browser bug (issue #68) - if ((deviceIsIOS && target.type === 'file') || target.disabled) { - return true; - } - - break; - case 'label': - case 'iframe': // iOS8 homescreen apps can prevent events bubbling into frames - case 'video': - return true; - } - - return (/\bneedsclick\b/).test(target.className); - }; - - - /** - * Determine whether a given element requires a call to focus to simulate click into element. - * - * @param {EventTarget|Element} target Target DOM element - * @returns {boolean} Returns true if the element requires a call to focus to simulate native click. - */ - FastClick.prototype.needsFocus = function(target) { - switch (target.nodeName.toLowerCase()) { - case 'textarea': - return true; - case 'select': - return !deviceIsAndroid; - case 'input': - switch (target.type) { - case 'button': - case 'checkbox': - case 'file': - case 'image': - case 'radio': - case 'submit': - return false; - } - - // No point in attempting to focus disabled inputs - return !target.disabled && !target.readOnly; - default: - return (/\bneedsfocus\b/).test(target.className); - } - }; - - - /** - * Send a click event to the specified element. - * - * @param {EventTarget|Element} targetElement - * @param {Event} event - */ - FastClick.prototype.sendClick = function(targetElement, event) { - var clickEvent, touch; - - // On some Android devices activeElement needs to be blurred otherwise the synthetic click will have no effect (#24) - if (document.activeElement && document.activeElement !== targetElement) { - document.activeElement.blur(); - } - - touch = event.changedTouches[0]; - - // Synthesise a click event, with an extra attribute so it can be tracked - clickEvent = document.createEvent('MouseEvents'); - clickEvent.initMouseEvent(this.determineEventType(targetElement), true, true, window, 1, touch.screenX, touch.screenY, touch.clientX, touch.clientY, false, false, false, false, 0, null); - clickEvent.forwardedTouchEvent = true; - targetElement.dispatchEvent(clickEvent); - }; - - FastClick.prototype.determineEventType = function(targetElement) { - - //Issue #159: Android Chrome Select Box does not open with a synthetic click event - if (deviceIsAndroid && targetElement.tagName.toLowerCase() === 'select') { - return 'mousedown'; - } - - return 'click'; - }; - - - /** - * @param {EventTarget|Element} targetElement - */ - FastClick.prototype.focus = function(targetElement) { - var length; - - // Issue #160: on iOS 7, some input elements (e.g. date datetime month) throw a vague TypeError on setSelectionRange. These elements don't have an integer value for the selectionStart and selectionEnd properties, but unfortunately that can't be used for detection because accessing the properties also throws a TypeError. Just check the type instead. Filed as Apple bug #15122724. - if (deviceIsIOS && targetElement.setSelectionRange && targetElement.type.indexOf('date') !== 0 && targetElement.type !== 'time' && targetElement.type !== 'month') { - length = targetElement.value.length; - targetElement.setSelectionRange(length, length); - } else { - targetElement.focus(); - } - }; - - - /** - * Check whether the given target element is a child of a scrollable layer and if so, set a flag on it. - * - * @param {EventTarget|Element} targetElement - */ - FastClick.prototype.updateScrollParent = function(targetElement) { - var scrollParent, parentElement; - - scrollParent = targetElement.fastClickScrollParent; - - // Attempt to discover whether the target element is contained within a scrollable layer. Re-check if the - // target element was moved to another parent. - if (!scrollParent || !scrollParent.contains(targetElement)) { - parentElement = targetElement; - do { - if (parentElement.scrollHeight > parentElement.offsetHeight) { - scrollParent = parentElement; - targetElement.fastClickScrollParent = parentElement; - break; - } - - parentElement = parentElement.parentElement; - } while (parentElement); - } - - // Always update the scroll top tracker if possible. - if (scrollParent) { - scrollParent.fastClickLastScrollTop = scrollParent.scrollTop; - } - }; - - - /** - * @param {EventTarget} targetElement - * @returns {Element|EventTarget} - */ - FastClick.prototype.getTargetElementFromEventTarget = function(eventTarget) { - - // On some older browsers (notably Safari on iOS 4.1 - see issue #56) the event target may be a text node. - if (eventTarget.nodeType === Node.TEXT_NODE) { - return eventTarget.parentNode; - } - - return eventTarget; - }; - - - /** - * On touch start, record the position and scroll offset. - * - * @param {Event} event - * @returns {boolean} - */ - FastClick.prototype.onTouchStart = function(event) { - var targetElement, touch, selection; - - // Ignore multiple touches, otherwise pinch-to-zoom is prevented if both fingers are on the FastClick element (issue #111). - if (event.targetTouches.length > 1) { - return true; - } - - targetElement = this.getTargetElementFromEventTarget(event.target); - touch = event.targetTouches[0]; - - if (deviceIsIOS) { - - // Only trusted events will deselect text on iOS (issue #49) - selection = window.getSelection(); - if (selection.rangeCount && !selection.isCollapsed) { - return true; - } - - if (!deviceIsIOS4) { - - // Weird things happen on iOS when an alert or confirm dialog is opened from a click event callback (issue #23): - // when the user next taps anywhere else on the page, new touchstart and touchend events are dispatched - // with the same identifier as the touch event that previously triggered the click that triggered the alert. - // Sadly, there is an issue on iOS 4 that causes some normal touch events to have the same identifier as an - // immediately preceeding touch event (issue #52), so this fix is unavailable on that platform. - // Issue 120: touch.identifier is 0 when Chrome dev tools 'Emulate touch events' is set with an iOS device UA string, - // which causes all touch events to be ignored. As this block only applies to iOS, and iOS identifiers are always long, - // random integers, it's safe to to continue if the identifier is 0 here. - if (touch.identifier && touch.identifier === this.lastTouchIdentifier) { - event.preventDefault(); - return false; - } - - this.lastTouchIdentifier = touch.identifier; - - // If the target element is a child of a scrollable layer (using -webkit-overflow-scrolling: touch) and: - // 1) the user does a fling scroll on the scrollable layer - // 2) the user stops the fling scroll with another tap - // then the event.target of the last 'touchend' event will be the element that was under the user's finger - // when the fling scroll was started, causing FastClick to send a click event to that layer - unless a check - // is made to ensure that a parent layer was not scrolled before sending a synthetic click (issue #42). - this.updateScrollParent(targetElement); - } - } - - this.trackingClick = true; - this.trackingClickStart = event.timeStamp; - this.targetElement = targetElement; - - this.touchStartX = touch.pageX; - this.touchStartY = touch.pageY; - - // Prevent phantom clicks on fast double-tap (issue #36) - if ((event.timeStamp - this.lastClickTime) < this.tapDelay) { - event.preventDefault(); - } - - return true; - }; - - - /** - * Based on a touchmove event object, check whether the touch has moved past a boundary since it started. - * - * @param {Event} event - * @returns {boolean} - */ - FastClick.prototype.touchHasMoved = function(event) { - var touch = event.changedTouches[0], boundary = this.touchBoundary; - - if (Math.abs(touch.pageX - this.touchStartX) > boundary || Math.abs(touch.pageY - this.touchStartY) > boundary) { - return true; - } - - return false; - }; - - - /** - * Update the last position. - * - * @param {Event} event - * @returns {boolean} - */ - FastClick.prototype.onTouchMove = function(event) { - if (!this.trackingClick) { - return true; - } - - // If the touch has moved, cancel the click tracking - if (this.targetElement !== this.getTargetElementFromEventTarget(event.target) || this.touchHasMoved(event)) { - this.trackingClick = false; - this.targetElement = null; - } - - return true; - }; - - - /** - * Attempt to find the labelled control for the given label element. - * - * @param {EventTarget|HTMLLabelElement} labelElement - * @returns {Element|null} - */ - FastClick.prototype.findControl = function(labelElement) { - - // Fast path for newer browsers supporting the HTML5 control attribute - if (labelElement.control !== undefined) { - return labelElement.control; - } - - // All browsers under test that support touch events also support the HTML5 htmlFor attribute - if (labelElement.htmlFor) { - return document.getElementById(labelElement.htmlFor); - } - - // If no for attribute exists, attempt to retrieve the first labellable descendant element - // the list of which is defined here: http://www.w3.org/TR/html5/forms.html#category-label - return labelElement.querySelector('button, input:not([type=hidden]), keygen, meter, output, progress, select, textarea'); - }; - - - /** - * On touch end, determine whether to send a click event at once. - * - * @param {Event} event - * @returns {boolean} - */ - FastClick.prototype.onTouchEnd = function(event) { - var forElement, trackingClickStart, targetTagName, scrollParent, touch, targetElement = this.targetElement; - - if (!this.trackingClick) { - return true; - } - - // Prevent phantom clicks on fast double-tap (issue #36) - if ((event.timeStamp - this.lastClickTime) < this.tapDelay) { - this.cancelNextClick = true; - return true; - } - - if ((event.timeStamp - this.trackingClickStart) > this.tapTimeout) { - return true; - } - - // Reset to prevent wrong click cancel on input (issue #156). - this.cancelNextClick = false; - - this.lastClickTime = event.timeStamp; - - trackingClickStart = this.trackingClickStart; - this.trackingClick = false; - this.trackingClickStart = 0; - - // On some iOS devices, the targetElement supplied with the event is invalid if the layer - // is performing a transition or scroll, and has to be re-detected manually. Note that - // for this to function correctly, it must be called *after* the event target is checked! - // See issue #57; also filed as rdar://13048589 . - if (deviceIsIOSWithBadTarget) { - touch = event.changedTouches[0]; - - // In certain cases arguments of elementFromPoint can be negative, so prevent setting targetElement to null - targetElement = document.elementFromPoint(touch.pageX - window.pageXOffset, touch.pageY - window.pageYOffset) || targetElement; - targetElement.fastClickScrollParent = this.targetElement.fastClickScrollParent; - } - - targetTagName = targetElement.tagName.toLowerCase(); - if (targetTagName === 'label') { - forElement = this.findControl(targetElement); - if (forElement) { - this.focus(targetElement); - if (deviceIsAndroid) { - return false; - } - - targetElement = forElement; - } - } else if (this.needsFocus(targetElement)) { - - // Case 1: If the touch started a while ago (best guess is 100ms based on tests for issue #36) then focus will be triggered anyway. Return early and unset the target element reference so that the subsequent click will be allowed through. - // Case 2: Without this exception for input elements tapped when the document is contained in an iframe, then any inputted text won't be visible even though the value attribute is updated as the user types (issue #37). - if ((event.timeStamp - trackingClickStart) > 100 || (deviceIsIOS && window.top !== window && targetTagName === 'input')) { - this.targetElement = null; - return false; - } - - this.focus(targetElement); - this.sendClick(targetElement, event); - - // Select elements need the event to go through on iOS 4, otherwise the selector menu won't open. - // Also this breaks opening selects when VoiceOver is active on iOS6, iOS7 (and possibly others) - if (!deviceIsIOS || targetTagName !== 'select') { - this.targetElement = null; - event.preventDefault(); - } - - return false; - } - - if (deviceIsIOS && !deviceIsIOS4) { - - // Don't send a synthetic click event if the target element is contained within a parent layer that was scrolled - // and this tap is being used to stop the scrolling (usually initiated by a fling - issue #42). - scrollParent = targetElement.fastClickScrollParent; - if (scrollParent && scrollParent.fastClickLastScrollTop !== scrollParent.scrollTop) { - return true; - } - } - - // Prevent the actual click from going though - unless the target node is marked as requiring - // real clicks or if it is in the whitelist in which case only non-programmatic clicks are permitted. - if (!this.needsClick(targetElement)) { - event.preventDefault(); - this.sendClick(targetElement, event); - } - - return false; - }; - - - /** - * On touch cancel, stop tracking the click. - * - * @returns {void} - */ - FastClick.prototype.onTouchCancel = function() { - this.trackingClick = false; - this.targetElement = null; - }; - - - /** - * Determine mouse events which should be permitted. - * - * @param {Event} event - * @returns {boolean} - */ - FastClick.prototype.onMouse = function(event) { - - // If a target element was never set (because a touch event was never fired) allow the event - if (!this.targetElement) { - return true; - } - - if (event.forwardedTouchEvent) { - return true; - } - - // Programmatically generated events targeting a specific element should be permitted - if (!event.cancelable) { - return true; - } - - // Derive and check the target element to see whether the mouse event needs to be permitted; - // unless explicitly enabled, prevent non-touch click events from triggering actions, - // to prevent ghost/doubleclicks. - if (!this.needsClick(this.targetElement) || this.cancelNextClick) { - - // Prevent any user-added listeners declared on FastClick element from being fired. - if (event.stopImmediatePropagation) { - event.stopImmediatePropagation(); - } else { - - // Part of the hack for browsers that don't support Event#stopImmediatePropagation (e.g. Android 2) - event.propagationStopped = true; - } - - // Cancel the event - event.stopPropagation(); - event.preventDefault(); - - return false; - } - - // If the mouse event is permitted, return true for the action to go through. - return true; - }; - - - /** - * On actual clicks, determine whether this is a touch-generated click, a click action occurring - * naturally after a delay after a touch (which needs to be cancelled to avoid duplication), or - * an actual click which should be permitted. - * - * @param {Event} event - * @returns {boolean} - */ - FastClick.prototype.onClick = function(event) { - var permitted; - - // It's possible for another FastClick-like library delivered with third-party code to fire a click event before FastClick does (issue #44). In that case, set the click-tracking flag back to false and return early. This will cause onTouchEnd to return early. - if (this.trackingClick) { - this.targetElement = null; - this.trackingClick = false; - return true; - } - - // Very odd behaviour on iOS (issue #18): if a submit element is present inside a form and the user hits enter in the iOS simulator or clicks the Go button on the pop-up OS keyboard the a kind of 'fake' click event will be triggered with the submit-type input element as the target. - if (event.target.type === 'submit' && event.detail === 0) { - return true; - } - - permitted = this.onMouse(event); - - // Only unset targetElement if the click is not permitted. This will ensure that the check for !targetElement in onMouse fails and the browser's click doesn't go through. - if (!permitted) { - this.targetElement = null; - } - - // If clicks are permitted, return true for the action to go through. - return permitted; - }; - - - /** - * Remove all FastClick's event listeners. - * - * @returns {void} - */ - FastClick.prototype.destroy = function() { - var layer = this.layer; - - if (deviceIsAndroid) { - layer.removeEventListener('mouseover', this.onMouse, true); - layer.removeEventListener('mousedown', this.onMouse, true); - layer.removeEventListener('mouseup', this.onMouse, true); - } - - layer.removeEventListener('click', this.onClick, true); - layer.removeEventListener('touchstart', this.onTouchStart, false); - layer.removeEventListener('touchmove', this.onTouchMove, false); - layer.removeEventListener('touchend', this.onTouchEnd, false); - layer.removeEventListener('touchcancel', this.onTouchCancel, false); - }; - - - /** - * Check whether FastClick is needed. - * - * @param {Element} layer The layer to listen on - */ - FastClick.notNeeded = function(layer) { - var metaViewport; - var chromeVersion; - var blackberryVersion; - var firefoxVersion; - - // Devices that don't support touch don't need FastClick - if (typeof window.ontouchstart === 'undefined') { - return true; - } - - // Chrome version - zero for other browsers - chromeVersion = +(/Chrome\/([0-9]+)/.exec(navigator.userAgent) || [,0])[1]; - - if (chromeVersion) { - - if (deviceIsAndroid) { - metaViewport = document.querySelector('meta[name=viewport]'); - - if (metaViewport) { - // Chrome on Android with user-scalable="no" doesn't need FastClick (issue #89) - if (metaViewport.content.indexOf('user-scalable=no') !== -1) { - return true; - } - // Chrome 32 and above with width=device-width or less don't need FastClick - if (chromeVersion > 31 && document.documentElement.scrollWidth <= window.outerWidth) { - return true; - } - } - - // Chrome desktop doesn't need FastClick (issue #15) - } else { - return true; - } - } - - if (deviceIsBlackBerry10) { - blackberryVersion = navigator.userAgent.match(/Version\/([0-9]*)\.([0-9]*)/); - - // BlackBerry 10.3+ does not require Fastclick library. - // https://github.com/ftlabs/fastclick/issues/251 - if (blackberryVersion[1] >= 10 && blackberryVersion[2] >= 3) { - metaViewport = document.querySelector('meta[name=viewport]'); - - if (metaViewport) { - // user-scalable=no eliminates click delay. - if (metaViewport.content.indexOf('user-scalable=no') !== -1) { - return true; - } - // width=device-width (or less than device-width) eliminates click delay. - if (document.documentElement.scrollWidth <= window.outerWidth) { - return true; - } - } - } - } - - // IE10 with -ms-touch-action: none or manipulation, which disables double-tap-to-zoom (issue #97) - if (layer.style.msTouchAction === 'none' || layer.style.touchAction === 'manipulation') { - return true; - } - - // Firefox version - zero for other browsers - firefoxVersion = +(/Firefox\/([0-9]+)/.exec(navigator.userAgent) || [,0])[1]; - - if (firefoxVersion >= 27) { - // Firefox 27+ does not have tap delay if the content is not zoomable - https://bugzilla.mozilla.org/show_bug.cgi?id=922896 - - metaViewport = document.querySelector('meta[name=viewport]'); - if (metaViewport && (metaViewport.content.indexOf('user-scalable=no') !== -1 || document.documentElement.scrollWidth <= window.outerWidth)) { - return true; - } - } - - // IE11: prefixed -ms-touch-action is no longer supported and it's recomended to use non-prefixed version - // http://msdn.microsoft.com/en-us/library/windows/apps/Hh767313.aspx - if (layer.style.touchAction === 'none' || layer.style.touchAction === 'manipulation') { - return true; - } - - return false; - }; - - - /** - * Factory method for creating a FastClick object - * - * @param {Element} layer The layer to listen on - * @param {Object} [options={}] The options to override the defaults - */ - FastClick.attach = function(layer, options) { - return new FastClick(layer, options); - }; - - - if (typeof define === 'function' && typeof define.amd === 'object' && define.amd) { - - // AMD. Register as an anonymous module. - define(function() { - return FastClick; - }); - } else if (typeof module !== 'undefined' && module.exports) { - module.exports = FastClick.attach; - module.exports.FastClick = FastClick; - } else { - window.FastClick = FastClick; - } -}()); diff --git a/assets/javascripts/vendor/mathml.js b/assets/javascripts/vendor/mathml.js index b97829581c..129726201c 100644 --- a/assets/javascripts/vendor/mathml.js +++ b/assets/javascripts/vendor/mathml.js @@ -4,17 +4,22 @@ * Adapted from: https://github.com/fred-wang/mathml.css */ (function () { - window.addEventListener("load", function() { + window.addEventListener("load", function () { var box, div, link, namespaceURI; // First check whether the page contains any