Protect your data against global mass surveillance programs.
Go to file
2023-03-22 13:34:49 -05:00
.github MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
config MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
docs Recommend Tresorit (#2100) 2023-03-22 13:34:49 -05:00
i18n New Crowdin Translations (#2088) 2023-03-14 16:54:06 +10:30
includes New Crowdin Translations (#2088) 2023-03-14 16:54:06 +10:30
modules Add dependency version locks (#2094) 2023-03-21 15:23:17 -05:00
theme Recommend Tresorit (#2100) 2023-03-22 13:34:49 -05:00
_redirects SEO fixes (#2070) 2023-03-03 09:27:46 -06:00
.allowed_signers Enable SSH Git commit signing (#1122) 2022-04-27 16:04:13 -05:00
.gitattributes MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
.gitignore Transition to mkdocs (#829) 2022-04-02 06:59:03 +10:30
.gitmodules Update Dependabot configuration 2023-03-21 11:05:52 -05:00
.markdownlint.yml MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
Brewfile.netlify Enable asset optimization (#2061) 2023-03-01 13:05:14 -06:00
CITATION.cff MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
crowdin.yml MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
LICENSE Relicensing (#1820) 2022-09-29 10:14:43 -05:00
LICENSE-CODE MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
netlify.toml MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
Pipfile MIT License source code (#2096) 2023-03-21 17:21:51 -05:00
Pipfile.lock Add dependency version locks (#2094) 2023-03-21 15:23:17 -05:00
README.md MIT License source code (#2096) 2023-03-21 17:21:51 -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. We are a non-profit collective operated entirely by volunteer team members and contributors.

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

Contributing

Mirrors

GitHub Gitea GitLab Codeberg SourceHut

License

Copyright © 2019 - 2023 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.

More info...

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.

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. Running this website locally without access to insiders is unsupported. If you are submitting a PR, please ensure the automatic preview generated for your PR looks correct, as that site will be built with the production insiders build.

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.8, this is the only version supported by Netlify.
  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 config/mkdocs.en.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 config/mkdocs.en.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

  1. Create a new tag: git tag -s v3.X.X -m 'Some message'
    • View existing tags
    • Tag numbering: Increment the MINOR (2nd) number when making significant changes (adding/deleting pages, etc.), increment the PATCH (3rd) number when making minor changes (typos, bug fixes). Probably leave the MAJOR number at 3 until a massive revamp (v1 -> v2 was the Jekyll to MkDocs transition, v2 -> v3 was the introduction of translations).
    • Consider enabling 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.