Skip to content

Commit

Permalink
Randomize DNS table order (#2438)
Browse files Browse the repository at this point in the history
Signed-off-by: Daniel Gray <dngray@privacyguides.org>
  • Loading branch information
jonaharagon authored and dngray committed Mar 16, 2024
1 parent bfa4b0f commit 8ba1782
Show file tree
Hide file tree
Showing 4 changed files with 74 additions and 3 deletions.
1 change: 1 addition & 0 deletions config/mkdocs-common.yml
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,7 @@ extra_css:
- assets/stylesheets/extra.css?v=3.17.0
extra_javascript:
- assets/javascripts/mathjax.js
- assets/javascripts/randomize-element.js

watch:
- ../theme
Expand Down
2 changes: 2 additions & 0 deletions docs/dns.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: "DNS Resolvers"
icon: material/dns
description: These are some encrypted DNS providers we recommend switching to, to replace your ISP's default configuration.
cover: dns.webp
global:
- [randomize-element, "table tbody"]
---

Encrypted DNS with third-party servers should only be used to get around basic [DNS blocking](https://en.wikipedia.org/wiki/DNS_blocking) when you can be sure there won't be any consequences. Encrypted DNS will not help you hide any of your browsing activity.
Expand Down
65 changes: 65 additions & 0 deletions theme/assets/javascripts/randomize-element.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
/**
* @overview Randomizes the order of an HTML element's children.
* @author Jonah Aragon <jonah@triplebit.net>
* @license
* Copyright (c) 2024 Jonah Aragon
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*/

// Fetch global data from meta tag
let globalData = document.querySelector("#global-data");

if (globalData.dataset.randomizeElement) {
// Get elements to be randomized from meta tag in HTML
let randomizeElement = globalData.dataset.randomizeElement;
console.log("Randomizing child elements of " + randomizeElement);

// Get all elements to be randomized
let randomizeChildren = document.querySelectorAll(randomizeElement);
let randomizeArray = Array.from(randomizeChildren);

// Handle multiple elements to be randomized
for (const element of randomizeArray) {
let selector = " > *";
if (globalData.dataset.randomizeElementSelector) {
selector = globalData.dataset.randomizeElementSelector
}

// Select all direct children of element
let children = element.querySelectorAll(randomizeElement + selector);

// Randomize rows (simple, probably not efficient)
let randomChildren = Array.from(children)
.map(value => ({ value, sort: Math.random() }))
.sort((a, b) => a.sort - b.sort)
.map(({ value }) => value);

// Replace each element with randomly selected element
for (let i = 0; i < children.length; i++) {
let child = randomChildren[i].cloneNode(true);
child.classList.add("randomized");
let parent = children[i].parentNode;
parent.insertBefore(child, children[i]);
children[i].remove();
}

}

}
9 changes: 6 additions & 3 deletions theme/main.html
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,9 @@
{% endif %}
<link rel="icon" href="{{ config.theme.favicon | url }}">
<meta name="generator" content="mkdocs-{{ mkdocs_version }}, mkdocs-material-9.1.0+insiders-4.32.2">
{% if page %}
<meta name="global-data" id="global-data" {% for data in page.meta.global %}data-{{ data.0 }}="{{data.1}}"{% endfor %}>
{% endif %}
{% endblock %}
{% block htmltitle %}
{% if page.meta and page.meta.meta_title and config.theme.language == "en" %}
Expand All @@ -68,19 +71,19 @@
{% endblock %}
{% block announce %}{% if config.extra.offline %}
You're viewing an offline copy of Privacy Guides built on {{ build_date_utc }}.
<a href="https://www.privacyguides.org/">
<a href="https://www.privacyguides.org/">
<strong>Visit privacyguides.org for the latest version.</strong>
</a>
{% elif config.extra.context == "deploy-preview" %}
You're viewing an <strong>unreviewed preview</strong> of Privacy Guides built on {{ build_date_utc }}.
These previews are <strong>user-submitted</strong> and may not necessarily reflect the opinion of the site.
<a href="https://www.privacyguides.org/">
<a href="https://www.privacyguides.org/">
<strong>Visit privacyguides.org for current advice.</strong>
</a>
{% elif config.extra.context == "branch-deploy" %}
You're viewing a <strong>staging branch</strong> of Privacy Guides built on {{ build_date_utc }}.
The information on this page may be incomplete or otherwise not yet meet our editorial release standards.
<a href="https://www.privacyguides.org/">
<a href="https://www.privacyguides.org/">
<strong>Visit privacyguides.org for current advice.</strong>
</a>
{% else %}{% endif %}{% endblock %}
Expand Down

0 comments on commit 8ba1782

Please sign in to comment.