Go to file
rollsicecream a80653968e
Email: Proton grammar, free accounts 1GB (#2512)
Signed-off-by: Daniel Gray <dngray@privacyguides.org>
2024-04-11 14:55:22 +09:30
.cache/plugin/social Remove per-language config files (#2513) 2024-04-10 17:52:14 -05:00
.devcontainer Remove per-language config files (#2513) 2024-04-10 17:52:14 -05:00
.github Remove per-language config files (#2513) 2024-04-10 17:52:14 -05:00
.vscode Link to mirrors in README (#2507) 2024-04-10 20:22:09 +09:30
docs Email: Proton grammar, free accounts 1GB (#2512) 2024-04-11 14:55:22 +09:30
includes Add alternative networks (#2506) 2024-04-10 20:17:00 +09:30
modules Enable website development (#2490) 2024-04-06 00:42:52 -05:00
theme Remove per-language config files (#2513) 2024-04-10 17:52:14 -05:00
.allowed_signers Enable SSH Git commit signing (#1122) 2022-04-27 16:04:13 -05:00
.editorconfig Stop using Netlify for production hosting (#2472) 2024-04-02 23:56:14 +10:30
.gitattributes MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
.gitignore Remove per-language config files (#2513) 2024-04-10 17:52:14 -05:00
.gitmodules Link to NPO Radio 1 interview (#2103) 2023-03-27 09:51:11 -05:00
.markdownlint.yml Automated PR Testing (#2469) 2024-04-02 23:56:20 +10:30
.python-version Upgrade to Python 3.12 (#2468) 2024-04-01 00:39:12 +10:30
CITATION.cff Update license year (#2363) 2024-01-07 07:42:44 +10:30
crowdin.yml Enable new mkdocs-material features (#2451) 2024-04-05 21:14:23 +10:30
Dockerfile Remove per-language config files (#2513) 2024-04-10 17:52:14 -05:00
LICENSE Relicensing (#1820) 2022-09-29 10:14:43 -05:00
LICENSE-CODE Update license year (#2363) 2024-01-07 07:42:44 +10:30
mkdocs-production.yml Remove per-language config files (#2513) 2024-04-10 17:52:14 -05:00
mkdocs.yml Remove per-language config files (#2513) 2024-04-10 17:52:14 -05:00
Pipfile Upgrade to Python 3.12 (#2468) 2024-04-01 00:39:12 +10:30
Pipfile.lock Enable website development (#2490) 2024-04-06 00:42:52 -05:00
README.md Remove per-language config files (#2513) 2024-04-10 17:52:14 -05:00

Privacy Guides

Your central privacy and security resource to protect yourself online.

About

Privacy Guides is a socially motivated website that provides information for protecting your data security and privacy. Our mission is to inform the public about the value of digital privacy, and global government initiatives which aim to monitor your online activity. We are a non-profit collective operated entirely by volunteer team members and contributors. Our website is free of advertisements and not affiliated with any of the listed providers.

The current list of team members can be found here. Additionally, many people have made contributions to the project, and you can too!

Featured on: Tweakers, The New York Times, and Wired

Contributing

All contributors to the site are listed here. If you make a substantial (i.e. copyright eligible) contribution to the project and would like to be formally credited, you are welcome to include your information in the appropriate authors section in CITATION.cff as well, just submit a PR or ask @jonaharagon to make the change.

Mirrors

Alternative Networks

Note

Most hidden service providers are not very extensively used or tested, which is why we strongly recommend Tor. Using other networks could be more likely to endanger your anonymity, so make sure you know what you're doing.

Git Mirrors

GitHub GitLab Codeberg Gitea Forgejo

License

Copyright © 2019 - 2024 Privacy Guides contributors.

Privacy Guides content is licensed under the Creative Commons Attribution-NoDerivatives 4.0 International Public License, and the underlying source code used to format and display that content on www.privacyguides.org is licensed under the MIT License.

Generally speaking, content can be found in the /docs, /theme/assets/img and /includes folders; and source code and configuration files can be found in the /config and /theme folders, and in the root of this repository. Any source code snippets contained within documentation files are MIT Licensed. Please contact us if you require clarification on any of these terms.

These licenses do not apply to any work where another license is otherwise noted.

Logos in the /theme/assets/img folder may not be original works of Privacy Guides and therefore cannot be (re)licensed by us. We believe that these logos obtained from third-party providers are either in the public domain or fair use. In a nutshell, legal fair use doctrine allows the use of copyrighted images in order to identify the subject for purposes of public comment. However, these logos and other images may still be subject to trademark laws in one or more jurisdictions. Before using this content, please ensure that it is used to identify the entity or organization that owns the trademark and that you have the right to use it under the laws which apply in the circumstances of your intended use. When copying content from this website, you are solely responsible for ensuring that you do not infringe someone else's trademark or copyright.

You may comply with our license terms in any reasonable manner, but not in any way that suggests Privacy Guides endorses you or your use. You may not use the Privacy Guides branding in your own project without express approval from this project. Privacy Guides's brand trademarks include the "Privacy Guides" wordmark and shield logo.

When you contribute to this repository you are doing so under the above licenses, and you are granting Privacy Guides a perpetual, worldwide, non-exclusive, transferable, royalty-free, irrevocable license with the right to sublicense such rights through multiple tiers of sublicensees, to reproduce, modify, display, perform and distribute your contribution as part of our project.

Developing

Committing to this repository requires signing your commits (git config commit.gpgsign true) unless you are making edits via the GitHub.com text editor interface. As of August 2022 the preferred signing method is SSH commit signatures, but GPG signing is also acceptable. You should add your signing key to your GitHub profile.

With mkdocs-material

  1. Install required packages: pip install mkdocs-material
  2. Run a local preview of the English site: mkdocs serve

With mkdocs-material-insiders

This website uses mkdocs-material-insiders which offers additional functionality over the open-source mkdocs-material project. For obvious reasons we cannot distribute access to the insiders repository.

Team members should clone the repository with mkdocs-material-insiders directly. This method is identical to production:

  1. Clone this repository and submodules: git clone --recurse-submodules https://github.com/privacyguides/privacyguides.org.git
  2. Enable SSH commit verification with our local .allowed_signers file: git config gpg.ssh.allowedSignersFile .allowed_signers
  3. Install Python 3.12.
  4. Install pipenv: pip install pipenv
  5. Install dependencies: pipenv install --dev (install Pillow and CairoSVG as well to generate social cards)
  6. Serve the site locally: pipenv run mkdocs serve --config-file mkdocs-production.yml (set CARDS=true to generate social cards)
    • The site will be available at http://localhost:8000
    • You can build the site locally with pipenv run mkdocs build --config-file mkdocs-production.yml
    • This version of the site should be identical to the live, production version

If you commit to main with commits signed with your SSH key, you should add your SSH key to .allowed_signers in this repo.

Releasing

It is required to create a GitHub release to publish the current site to privacyguides.org. The current main branch can be previewed at https://main.staging.privacyguides.dev prior to release.

  1. Create a new tag: git tag -s YYYY.MM.DD -m 'Some message'
    • Tag numbering: YYYY.MM.DD - if two+ releases are published on the same day, append short commit sha to next release, e.g. YYYY.MM.DD-6aa14e8
    • Enable GPG tag signing by default (git config tag.gpgSign true) to avoid missing signatures
  2. Push the tag to GitHub: git push --tags
  3. A GitHub Release will be automatically created and deployed to the live site.
    • You may wish to manually check or edit the release changelog/title after it is published for accuracy.