From d1c4abcd4fd514387a698f65a9d620813030512e Mon Sep 17 00:00:00 2001 From: Jonah Aragon Date: Wed, 29 Mar 2023 14:27:39 -0500 Subject: [PATCH] Add some structured data entities (#2106) --- docs/about/index.md | 15 +++- docs/android.md | 64 +++++++++++++++++ docs/basics/common-misconceptions.md | 29 ++++++++ docs/desktop-browsers.md | 32 +++++++++ docs/index.md | 26 +++++++ docs/mobile-browsers.md | 28 ++++++++ docs/passwords.md | 104 +++++++++++++++++++++++++++ theme/main.html | 5 ++ theme/overrides/home.en.html | 2 +- theme/schema.html | 41 +---------- 10 files changed, 304 insertions(+), 42 deletions(-) diff --git a/docs/about/index.md b/docs/about/index.md index e6003d90..220930d6 100644 --- a/docs/about/index.md +++ b/docs/about/index.md @@ -1,7 +1,20 @@ --- -template: schema.html title: "About Privacy Guides" description: Privacy Guides is a socially motivated website that provides information for protecting your data security and privacy. +schema: + "@context": https://schema.org + "@type": Organization + "@id": https://www.privacyguides.org/ + name: Privacy Guides + url: https://www.privacyguides.org/en/about/ + logo: https://www.privacyguides.org/en/assets/brand/png/square/pg-yellow.png + sameAs: + - https://twitter.com/privacy_guides + - https://github.com/privacyguides + - https://www.wikidata.org/wiki/Q111710163 + - https://opencollective.com/privacyguides + - https://www.youtube.com/@privacyguides + - https://mastodon.neat.computer/@privacyguides --- ![Privacy Guides logo](../assets/brand/png/square/pg-yellow.png){ align=right } diff --git a/docs/android.md b/docs/android.md index 40a46aae..84ad28c1 100644 --- a/docs/android.md +++ b/docs/android.md @@ -2,6 +2,70 @@ title: "Android" icon: 'simple/android' description: You can replace the operating system on your Android phone with these secure and privacy-respecting alternatives. +schema: + - "@context": http://schema.org + "@type": WebPage + name: Private Android Operating Systems + url: "./" + - "@context": http://schema.org + "@type": CreativeWork + name: Android + image: /assets/img/android/android.svg + url: https://source.android.com/ + sameAs: https://en.wikipedia.org/wiki/Android_(operating_system) + - "@context": http://schema.org + "@type": CreativeWork + name: GrapheneOS + image: /assets/img/android/grapheneos.svg + url: https://grapheneos.org/ + sameAs: https://en.wikipedia.org/wiki/GrapheneOS + subjectOf: + "@context": http://schema.org + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": CreativeWork + name: Divest + image: /assets/img/android/divestos.svg + url: https://divestos.org/ + sameAs: https://en.wikipedia.org/wiki/DivestOS + subjectOf: + "@context": http://schema.org + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": Product + name: Pixel + brand: + "@type": Brand + name: Google + image: /assets/img/android/google-pixel.png + sameAs: https://en.wikipedia.org/wiki/Google_Pixel + review: + "@type": Review + author: + "@type": Organization + name: Privacy Guides + - "@context": http://schema.org + "@type": MobileApplication + name: Shelter + applicationCategory: Utilities + operatingSystem: Android + - "@context": http://schema.org + "@type": MobileApplication + name: Auditor + applicationCategory: Utilities + operatingSystem: Android + - "@context": http://schema.org + "@type": MobileApplication + name: Secure Camera + applicationCategory: Utilities + operatingSystem: Android + - "@context": http://schema.org + "@type": MobileApplication + name: Secure PDF Viewer + applicationCategory: Utilities + operatingSystem: Android --- ![Android logo](assets/img/android/android.svg){ align=right } diff --git a/docs/basics/common-misconceptions.md b/docs/basics/common-misconceptions.md index ed70fa3d..f27e7da5 100644 --- a/docs/basics/common-misconceptions.md +++ b/docs/basics/common-misconceptions.md @@ -2,6 +2,35 @@ title: "Common Misconceptions" icon: 'material/robot-confused' description: Privacy isn't a straightforward topic, and it's easy to get caught up in marketing claims and other disinformation. +schema: + - "@context": https://schema.org + "@type": FAQPage + mainEntity: + - "@type": Question + name: Is open source software inherently secure? + acceptedAnswer: + "@type": Answer + text: | + Whether the source code is available and how software is licensed does not inherently affect its security in any way. Open-source software has the potential to be more secure than proprietary software, but there is absolutely no guarantee this is the case. When you evaluate software, you should look at the reputation and security of each tool on an individual basis. + - "@type": Question + name: Can shifting trust to another provider increase privacy? + acceptedAnswer: + "@type": Answer + text: | + We talk about "shifting trust" a lot when discussing solutions like VPNs (which shift the trust you place in your ISP to the VPN provider). While this protects your browsing data from your ISP specifically, the VPN provider you choose still has access to your browsing data: Your data isn't completely secured from all parties. + - "@type": Question + name: Are privacy-focused solutions inherently trustworthy? + acceptedAnswer: + "@type": Answer + text: | + Focusing solely on the privacy policies and marketing of a tool or provider can blind you to its weaknesses. When you're looking for a more private solution, you should determine what the underlying problem is and find technical solutions to that problem. For example, you may want to avoid Google Drive, which gives Google access to all of your data. The underlying problem in this case is lack of E2EE, so you should make sure that the provider you switch to actually implements E2EE, or use a tool (like Cryptomator) which provides E2EE on any cloud provider. Switching to a "privacy-focused" provider (that doesn't implement E2EE) doesn't solve your problem: it just shifts trust from Google to that provider. + - "@type": Question + name: How complicated should my threat model be? + acceptedAnswer: + "@type": Answer + text: | + We often see people describing privacy threat models that are overly complex. Often, these solutions include problems like many different email accounts or complicated setups with lots of moving parts and conditions. The replies are usually answers to "What is the best way to do X?" + Finding the "best" solution for yourself doesn't necessarily mean you are after an infallible solution with dozens of conditions—these solutions are often difficult to work with realistically. As we discussed previously, security often comes at the cost of convenience. --- ## "Open-source software is always secure" or "Proprietary software is more secure" diff --git a/docs/desktop-browsers.md b/docs/desktop-browsers.md index de331cd1..52d69034 100644 --- a/docs/desktop-browsers.md +++ b/docs/desktop-browsers.md @@ -2,6 +2,38 @@ title: "Desktop Browsers" icon: material/laptop description: Firefox and Brave are our recommendations for standard/non-anonymous browsing. +schema: + - "@context": http://schema.org + "@type": WebPage + name: Private Desktop Browser Recommendations + url: "./" + relatedLink: "../mobile-browsers/" + - "@context": http://schema.org + "@type": SoftwareApplication + name: Firefox + image: /assets/img/browsers/firefox.svg + url: https://firefox.com + applicationCategory: Web Browser + operatingSystem: + - Windows + - macOS + - Linux + subjectOf: + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": SoftwareApplication + name: Brave + image: /assets/img/browsers/brave.svg + url: https://brave.com + applicationCategory: Web Browser + operatingSystem: + - Windows + - macOS + - Linux + subjectOf: + "@type": WebPage + url: "./" --- These are our currently recommended desktop web browsers and configurations for standard/non-anonymous browsing. If you need to browse the internet anonymously, you should use [Tor](tor.md) instead. In general, we recommend keeping your browser extensions to a minimum; they have privileged access within your browser, require you to trust the developer, can make you [stand out](https://en.wikipedia.org/wiki/Device_fingerprint#Browser_fingerprint), and [weaken](https://groups.google.com/a/chromium.org/g/chromium-extensions/c/0ei-UCHNm34/m/lDaXwQhzBAAJ) site isolation. diff --git a/docs/index.md b/docs/index.md index 8b323bf3..0b1e7edf 100644 --- a/docs/index.md +++ b/docs/index.md @@ -4,6 +4,32 @@ hide: - navigation - toc - feedback +schema: + - "@context": https://schema.org + "@type": Organization + "@id": https://www.privacyguides.org/ + name: Privacy Guides + url: https://www.privacyguides.org/en/about/ + logo: https://www.privacyguides.org/en/assets/brand/png/square/pg-yellow.png + sameAs: + - https://twitter.com/privacy_guides + - https://github.com/privacyguides + - https://www.wikidata.org/wiki/Q111710163 + - https://opencollective.com/privacyguides + - https://www.youtube.com/@privacyguides + - https://mastodon.neat.computer/@privacyguides + - "@context": https://schema.org + "@type": WebSite + name: Privacy Guides + url: "https://www.privacyguides.org/" + sameAs: + - https://www.wikidata.org/wiki/Q111710163 + potentialAction: + "@type": SearchAction + target: + "@type": EntryPoint + urlTemplate: "https://www.privacyguides.org/?q={search_term_string}" + query-input: required name=search_term_string --- ## Why should I care? diff --git a/docs/mobile-browsers.md b/docs/mobile-browsers.md index 76dfeb3e..fcff50c2 100644 --- a/docs/mobile-browsers.md +++ b/docs/mobile-browsers.md @@ -2,6 +2,34 @@ title: "Mobile Browsers" icon: material/cellphone-information description: These browsers are what we currently recommend for standard/non-anonymous internet browsing on your phone. +schema: + - "@context": http://schema.org + "@type": WebPage + name: Private Mobile Browser Recommendations + url: "./" + relatedLink: "../desktop-browsers/" + - "@context": http://schema.org + "@type": MobileApplication + name: Brave + image: /assets/img/browsers/brave.svg + url: https://brave.com + applicationCategory: Web Browser + operatingSystem: + - Android + subjectOf: + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": MobileApplication + name: Safari + image: /assets/img/browsers/safari.svg + url: https://www.apple.com/safari/ + applicationCategory: Web Browser + operatingSystem: + - iOS + subjectOf: + "@type": WebPage + url: "./" --- These are our currently recommended mobile web browsers and configurations for standard/non-anonymous internet browsing. If you need to browse the internet anonymously, you should use [Tor](tor.md) instead. In general, we recommend keeping extensions to a minimum; they have privileged access within your browser, require you to trust the developer, can make you [stand out](https://en.wikipedia.org/wiki/Device_fingerprint#Browser_fingerprint), and [weaken](https://groups.google.com/a/chromium.org/g/chromium-extensions/c/0ei-UCHNm34/m/lDaXwQhzBAAJ) site isolation. diff --git a/docs/passwords.md b/docs/passwords.md index e6b72371..7295c059 100644 --- a/docs/passwords.md +++ b/docs/passwords.md @@ -2,6 +2,110 @@ title: "Password Managers" icon: material/form-textbox-password description: Password managers allow you to securely store and manage passwords and other credentials. +schema: + - "@context": http://schema.org + "@type": WebPage + name: Password Manager Recommendations + url: "./" + - "@context": http://schema.org + "@type": SoftwareApplication + name: Bitwarden + image: /assets/img/password-management/bitwarden.svg + url: https://bitwarden.com + sameAs: https://en.wikipedia.org/wiki/Bitwarden + applicationCategory: Password Manager + operatingSystem: + - Windows + - macOS + - Linux + - Android + - iOS + subjectOf: + "@context": http://schema.org + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": SoftwareApplication + name: 1Password + image: /assets/img/password-management/1password.svg + url: https://1password.com + sameAs: https://en.wikipedia.org/wiki/1Password + applicationCategory: Password Manager + operatingSystem: + - Windows + - macOS + - Linux + - Android + - iOS + subjectOf: + "@context": http://schema.org + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": SoftwareApplication + name: Psono + image: /assets/img/password-management/psono.svg + url: https://psono.com + applicationCategory: Password Manager + operatingSystem: + - Android + - iOS + subjectOf: + "@context": http://schema.org + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": SoftwareApplication + name: KeePassXC + image: /assets/img/password-management/keepassxc.svg + url: https://keepassxc.org/ + sameAs: https://en.wikipedia.org/wiki/KeePassXC + applicationCategory: Password Manager + operatingSystem: + - Windows + - macOS + - Linux + subjectOf: + "@context": http://schema.org + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": SoftwareApplication + name: KeePassDX + image: /assets/img/password-management/keepassdx.svg + url: https://www.keepassdx.com/ + applicationCategory: Password Manager + operatingSystem: Android + subjectOf: + "@context": http://schema.org + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": SoftwareApplication + name: Strongbox + image: /assets/img/password-management/strongbox.svg + url: https://strongboxsafe.com/ + applicationCategory: Password Manager + operatingSystem: iOS + subjectOf: + "@context": http://schema.org + "@type": WebPage + url: "./" + - "@context": http://schema.org + "@type": SoftwareApplication + name: gopass + image: /assets/img/password-management/gopass.svg + url: https://www.gopass.pw/ + applicationCategory: Password Manager + operatingSystem: + - Windows + - macOS + - Linux + - FreeBSD + subjectOf: + "@context": http://schema.org + "@type": WebPage + url: "./" --- Password managers allow you to securely store and manage passwords and other credentials with the use of a master password. diff --git a/theme/main.html b/theme/main.html index ed83e22e..3b4b1c59 100644 --- a/theme/main.html +++ b/theme/main.html @@ -67,3 +67,8 @@ Visit privacyguides.org for current advice. {% else %}{% endif %}{% endblock %} +{% block extrahead %}{% if page and page.meta and page.meta.schema %} + +{% endif %}{% endblock %} diff --git a/theme/overrides/home.en.html b/theme/overrides/home.en.html index f251e9fa..2b4df311 100644 --- a/theme/overrides/home.en.html +++ b/theme/overrides/home.en.html @@ -20,7 +20,7 @@ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. #} --> -{% extends "schema.html" %} +{% extends "main.html" %} {% block extrahead %} {{ super() }} diff --git a/theme/schema.html b/theme/schema.html index 01e799d1..6d59ac5b 100644 --- a/theme/schema.html +++ b/theme/schema.html @@ -20,43 +20,4 @@ IN THE SOFTWARE. #} --> {% extends "main.html" %} -{% block extrahead %} - -{% endblock %} +{# This file can be deleted when it is no longer referenced by localized sites #}