Updated FAQ (markdown)

rugk 2017-11-12 23:54:39 +01:00
parent a51b034934
commit df20ca01c9

7
FAQ.md

@ -21,7 +21,6 @@ Please have a look at these questions *before* opening an issue in this repo.
* [How to make PrivateBin work on my Android phone with data saver mode?](#user-content-how-to-make-privatebin-work-on-my-android-phone-with-data-saver-mode)
* [How to make PrivateBin work when using Cloudflare for DDoS protection?](#user-content-how-to-make-privatebin-work-when-using-cloudflare-for-ddos-protection)
* [How to make PrivateBin work when I have changed some JavaScript files?](#user-content-how-to-make-privatebin-work-when-i-have-changed-some-javascript-files)
* [How to fix email-decode.min.js script causing errors?](#how-to-fix-email-decodeminjs-script-from-causing-errors)
## General
@ -206,12 +205,12 @@ More details on Google Chromes Data Saver mode on Android can be found at [Googl
Cloudflare works as a reverse proxy in front of your webserver. Apart from protecting your site against DDoS it acts as a man-in-the-middle even for HTTPS sites and by default tries to optimize your site for faster loading. Part of that optimization (currently) breaks our [SRI](https://scotthelme.co.uk/subresource-integrity/) used to ensure that your JS files don't get modified (actually it works as intended as Cloudflare _does_ modify them). It has been reported that disabling the "rocket loader" feature in Cloudflare solves this issue.
Similarly, if you encounter problems with `email-decode.min.js` you've enabled "email obfuscation" for your site in Cloudflare. In that case you will need to create a page rule for your PrivateBin URL to disable "email obfuscation".
### How to make PrivateBin work when I have changed some JavaScript files?
When changing the JS files (or adding new ones) you need to [regenerate the SRI hashes](https://github.com/PrivateBin/PrivateBin/wiki/Development#subresource-integrity-for-javascript-resources) in your template, so that they match the updated files.
If you didn't change the JS files intentionally, there might be someone/something interfering with these files. Most likely this is a (reverse) proxy, such as Cloudflare, certain VPNs, data saver modes in your client, etc. Try to use it from a different internet connection and a different device to figure out what is manipulating the files and if you can disable/circumvent it.
### How to fix email-decode.min.js script from causing errors?
This problem seems to be specific to CloudFlare users. If you've enabled Email Obfuscation for your site, then you will need to create a page rule for your PrivateBin url with the Email Obfuscation disabled.
### How to fix script from causing errors?