From a083de7d43ba37b60f81e5bae098a34b1a0d48ac Mon Sep 17 00:00:00 2001
From: nobody <info@localcdn.org>
Date: Sun, 7 Feb 2021 08:07:45 +0100
Subject: [PATCH] FAQ supplemented with uBlock rules

---
 pages/help/help.css          |   4 +++
 pages/help/help.html         |  47 +++++++++++++++++++++++++++++++++--
 pages/help/ublock-easy.png   | Bin 0 -> 900 bytes
 pages/help/ublock-hard.png   | Bin 0 -> 1049 bytes
 pages/help/ublock-medium.png | Bin 0 -> 1132 bytes
 5 files changed, 49 insertions(+), 2 deletions(-)
 create mode 100644 pages/help/help.css
 create mode 100644 pages/help/ublock-easy.png
 create mode 100644 pages/help/ublock-hard.png
 create mode 100644 pages/help/ublock-medium.png

diff --git a/pages/help/help.css b/pages/help/help.css
new file mode 100644
index 00000000..837d17ec
--- /dev/null
+++ b/pages/help/help.css
@@ -0,0 +1,4 @@
+table {
+  border-collapse: separate;
+  border-spacing: 3em 1em;
+}
diff --git a/pages/help/help.html b/pages/help/help.html
index cfdbf507..2b907752 100644
--- a/pages/help/help.html
+++ b/pages/help/help.html
@@ -6,6 +6,7 @@
         <meta charset="utf-8">
         <link rel="stylesheet" type="text/css" href="../style.css">
         <link rel="stylesheet" type="text/css" href="../base.css">
+        <link rel="stylesheet" type="text/css" href="help.css">
         <link rel="shortcut icon" href="../images/favicon.ico" type="image/x-icon">
         <link rel="icon" href="../images/favicon.ico" type="image/x-icon">
         <script src="../../modules/internal/helpers.js"></script>
@@ -20,6 +21,7 @@
                     <ul>
                         <li><a class="no-icon" href="#introduction">Introduction</a></li>
                         <li><a class="no-icon" href="#html-filter">What is "<span data-i18n-content="labelManipulateDOM">HTML filter</span>"?</a></li>
+                        <li><a class="no-icon" href="#rule-generator">Rule generator</a></li>
                         <li><a class="no-icon" href="#websites-issues">Some websites look strange or are not easy to use</a></li>
                         <li><a class="no-icon" href="#google-fonts">Why is there a "Block Google Fonts" option?</a></li>
                         <li><a class="no-icon" href="#statistics">What about the statistics? Is anything transferred to any servers?</a></li>
@@ -35,12 +37,53 @@
             <div id="html-filter" class="notice">
                 <div class="subtle-hint"><div class="topic-label">What is "<span data-i18n-content="labelManipulateDOM">HTML filter</span>"? (Firefox only)</div>
                     <p>In most cases LocalCDN can easily replace embedded frameworks and improves privacy. In some cases the website may try to prevent this by setting certain options in the HTML source code. LocalCDN reads the HTML source code before it is displayed in the browser and removes these options.</p>
-                    <p><i>Why is it necessary to remove crossorigin and integrity attributes?</i></p>
-                    <p>The crossorigin attribute prevents the replacement because the source is no longer <code><b>cdnjs.cloudflare.com/ajax/libs/jquery/1.12.4/jquery.js</b></code> but <code><b>moz-extension://UUID/resources/jquery/1.12.4</b></code>. crossorigin forces the browser to ignore other sources.</p>
+                    <p><em>Why is it necessary to remove crossorigin and integrity attributes?</em></p>
+                    <p>The crossorigin attribute prevents the replacement because the source is no longer <code><strong>cdnjs.cloudflare.com/ajax/libs/jquery/1.12.4/jquery.js</strong></code> but <code><strong>moz-extension://UUID/resources/jquery/1.12.4</strong></code>. crossorigin forces the browser to ignore other sources.</p>
                     <p>To save disk space and to deliver more frameworks LocalCDN upgrades a framework. An integrity tag is the hash value of a file. If the check fails, the browser won't include a framework. The integrity check will fail because the hash values for e.g. jQuery 1.10.1 and jQuery 1.12.4 are different.</p>
                     <p>Unfortunately, it sometimes happens that special characters are then displayed incorrectly. In this case you can deactivate the setting again, to display the umlauts correctly.</p>
                 </div>
             </div>
+            <div id="rule-generator" class="notice">
+                <div class="subtle-hint"><div class="topic-label">Rule generator</div>
+                    <p>If you want to automatically redirect all supported CDN connections to LocalCDN, you can add these rules to your adblocker to allow these redirections.</p>
+                    <p>If you do not want to add these rules, you must allow each CDN connection individually for each website.</p>
+                    <p>
+                        <u><strong>Only uBlock Origin:</strong></u> <br>
+                        These rules are only relevant in "medium" or "hard" mode, because it blocks all 3rd-party resources. They are not necessary in "default", "easy" or "very-easy" mode. For more information, please visit the uBlock Origin Wiki.
+                    </p>
+                    <table>
+                        <caption>Contact Information</caption>
+                        <thead>
+                            <tr>
+                                <th scope="col">Icon</th>
+                                <th scope="col">Mode</th>
+                                <th scope="col">Rules useful</th>
+                                <th scope="col">uBlock Wiki</th>
+                            </tr>
+                        </thead>
+                        <tbody>
+                            <tr>
+                                <td><img src="ublock-easy.png" alt="Default"></a></td>
+                                <td>Default/Easy</td>
+                                <td>No</td>
+                                <td><a href="https://github.com/gorhill/uBlock/wiki/Blocking-mode#very-easy-mode-details-" rel="nofollow">Link (github.com)</a></td>
+                            </tr>
+                            <tr>
+                                <td><img src="ublock-medium.png" alt="Medium"></a></td>
+                                <td>Medium</td>
+                                <td>Yes</td>
+                                <td><a href="https://github.com/gorhill/uBlock/wiki/Blocking-mode:-medium-mode" rel="nofollow">Link (github.com)</a></td>
+                            </tr>
+                            <tr>
+                                <td><img src="ublock-hard.png" alt="Hard"></a></td>
+                                <td>Hard</td>
+                                <td>Yes</td>
+                                <td><a href="https://github.com/gorhill/uBlock/wiki/Blocking-mode:-hard-mode" rel="nofollow">Link (github.com)</a></td>
+                            </tr>
+                        </tbody>
+                    </table>
+                </div>
+            </div>
             <div id="websites-issues" class="notice">
                 <div class="subtle-hint"><div class="topic-label">Some websites look strange or are not easy to use</div>
                     <p>There are two possible reasons: Either a framework/library is required that LocalCDN doesn't (yet) deliver or an SOP.</p><p>A SOP (Same origin policy) is a security mechanism that determines what data the browser is allowed to load. It helps to isolate malicious documents and thus reduce possible attack vectors. This policy prevents the browser from loading the external frameworks of LocalCDN.</p>
diff --git a/pages/help/ublock-easy.png b/pages/help/ublock-easy.png
new file mode 100644
index 0000000000000000000000000000000000000000..1263dc5a56a4f3115d055eaf1366752a898e7b76
GIT binary patch
literal 900
zcmV-~1AF|5P)<h;3K|Lk000e1NJLTq002G!002A)0{{R33D^030000vP)t-s_xAT$
zS6QH-q2=G+{r&!i0t58&@?~XZeE<M!Yi!if(6_a=fq#FhQ&7f?ir%fJiy|hUGc{oe
z3s$0LbN~PY21!IgR7l6|SL>RiAPfZp(Ey_M{U3G{E^3QbyZd)D-!KmKaB?SA>c4b?
z-#4&-;p~j|v!8)am>I(IFY4PW`JrwpTRyl4`w+~9gy8Sg2hzip=z-un+=gMG9YA&6
zw!)1Ijn40qK!~<O>Z3L{=EnlB`20ZI^PuAwcKKv8oem~%TbgbXty)XQ`&dB%076xs
zZgPSOnE^yY*=yc1f%VlC{F-&PumtoTOi{xEs}Uq5x9n&$J9*#~G1+e(qSl&(KC|0*
zy4`#%aCs@lXbL=nmksSj2Vu7tK9^FlSUpEEi1KVOKu!R_NF5ya`jT3+Ftr#_D7FtC
zIg^Hn%FqdWF6w-UReo|~i+Ieoi|arlXi6XsaNO2XpfHW2dzJj+rNa3E5jYMI>C|=v
z@N-JcJUV7?d0yb`H1-0=0kZ3c4>+g9I_{F;8+$v6h*^QM=hZvARf`j0WQOaOwL6?q
zI&$1kJkRiTr)H`3c4X(Q;jA;miSq2WwE{(jaoht};H<YKf#@y?`Jp^}d}4G)W_&3O
z$=jTD{0~UiWXBb?K5ZAc$SPpB=o<H3dCzeRv1xSz7iO>vublI`HMi<Rof}o_Hdk<E
zMSpAKb))@YFKKrJr?#B4H@JO+cMY0;fYX7M-n(Y(ZlwZ8>t46E>kf`K<%FB<@_IRo
z+?h(Aecn&<t99tu=M0~0a$~X>1grDX$v_7COR-d{+`blPzC*#A=_Rt5@Oi`baJA&L
zTW6NVtto`GjO>T;wfNkG_SvBy9Js+vIoV6u*77Mbm0oxdbplVKyK}Yd+c7MOn+dj=
z<$5AmT&>tvd!_sr=;x|_782iQU{SomotyE&0Eb2WO5Y9<w8E#8V5;N|&*mrf?kT*~
zfE~lJa>tJA5<Vj@*PEKxW6aiB{WKi1|5<^?o$$dNipRe)KupE%$=f$>{659*A(&T5
zUhEaeM^m(gl;BsZ_Xy-W{<w3e`biBu<hnlL4)n|$>H*dH*$-8F65YS~YVtrG{NaR;
acmDvUHZEDFr3Byr0000<MNUMnLSTZVG{DyY

literal 0
HcmV?d00001

diff --git a/pages/help/ublock-hard.png b/pages/help/ublock-hard.png
new file mode 100644
index 0000000000000000000000000000000000000000..870f3b830b6d2f92d1f095f3f0d069861c7b7c29
GIT binary patch
literal 1049
zcmV+!1m^pRP)<h;3K|Lk000e1NJLTq002G!002A)0{{R33D^030000{P)t-s_xAUD
z0094CT>a(d`Tzm;^Yi}y|Nj60f&c;g`T6(H&;N~y(*gthwX>H61+G<6WB~%Tp`+&g
z{>F)i*R89WFf)P@7w!TC{1p=SLqPi?A|<BWFaQ7pgGod|R7l6wS670ZFbst;5-w|C
zhd%c|Xe1W~j3MMRN|vGcS<+KM6vh7~@Nf-;6WD>k{rd+caU(e5;BR1Hz(Kaldo+BH
zDl6`}y52y6DuC7@qVhj@IHji<c(jVKV9o1FjIp3@eOLBV-^j<pQRjgS05o-7k@$m?
zstV_PFwS_$*-owlt~Ei!+8sQc)N6s)2}8szby&I?yt}UI55pnJtSz?`gylJL4**q`
zGY3Zqs;bp8iHw+y7TU~V55O4uEkBhH2mPR^yrHYW;^j{*3N6qE2L!6Cq+_^OZctn8
z;V%~qgJH7`9@r*vB)EL@+Ur^?^Rf;wTeYw=LMQOZ;8u_f2T$CxemuPXXggQrxDlTe
zo|GryQAgevv%wd>X6sMzA{1goL%YSuc;6Q*Tm*Cik0A$N;}kTd+ph80inK@Sgkj}M
z<+MBheKm?!mR(aN+SzQONyK`FQwvZ)Pluszr}7KuP<c4pVX26%Ub2CMQI<}m%)n#9
z&Y8e@^`i_z8+6UQG0*T=bM+k4E(si}kzlNxe>yowgt2R^6GES}&Zj#f!+8VQu=eVx
z-52U&obvi?JYpN+GQd5;!YhP;!=gj^UBMeiLGu&qx_&w1eZ^U`#M{TT@$j;21WsfC
z;NpVy?KV~DHh~0!A3D1Va6s90CE~L0a{G2y@8GbrzU82kcBUV({)-&6(>BU$SJ-r=
zM0L~aoJ%6<wD^U046m+RCCQSsO7L(g7~UYx^CiBbN7UyNc<=Jv;z)3X>kn_>Uk%kk
zF`?^u07&42OV^gS=|K(c&$X;Q6bW1j>52{U{YE{AH^R`4lmuNl^}k0MG$e0mx}<!g
zbRVg#hp}l|TGmb-%lJ+OPH^JR7i-frA@jNXNV*o2F+~6z#}m3HryF1HrTmsY^U<g9
z^Jqi2^d!$h^*d_i2dglaoo6$56NgDg&85@qde<}nJQ?5se<vw-raSMaLBW$LkY7%H
z)b9zPzo{<(9t@@6{OhNUFyC~0C;*<0yHE_VV>;i*p~&!joTPSRFD(`Q6kG1p3zZlP
z_Z)II>DKesYRnoAsRgi~p2^yQ@^>7(*U9|%oz>IbzOQPfd$Rj6Wr<gWcmE-=4|4QD
zhRa-H!^K9I#KP$=oQ}l>Be$`>|A@FVD#yZukCQ~hMcj+*2NOK|e#@+aI}iT=HEKL^
T2fpC800000NkvXXu0mjfYZL^{

literal 0
HcmV?d00001

diff --git a/pages/help/ublock-medium.png b/pages/help/ublock-medium.png
new file mode 100644
index 0000000000000000000000000000000000000000..5e28b7497f4fe480c10c4b77947bf3e409b4f72f
GIT binary patch
literal 1132
zcmV-y1e5!TP)<h;3K|Lk000e1NJLTq002Ay002G+0{{R3K<bD~0001NP)t-s_xAUR
z0tET``~d>-{{R2=^z!rd`v3v|`1bjJ00Hai{sjZU1P0$^XaE2H?Dz29zrO!HO77Ru
z{)LD9tW!#600yI@zjJo~(U_2)G&AGO&EmGKWdtiACi{;a9;2fBz=4DwA>3<Fn}I-H
z(E;~=000BKNkl<ZNXNC8;hL%-5QYI~2u%~UPNtRZ?)~5689)%sb@%)@Q;(VPGQ$T0
z6J!6`FuZ=>oGfB+er~_xzxifA5UU@Rib8flVDP`&lW84-cgE(c?{;yCX?*x@Y<ZZ{
zNwnsTs04g($}~yFnv4Q<cdfi#D}R5r)@dnJ+#X}4B<hds@Vz~>5^EA|&`e1wI^Ql^
zI*D#O!Ek%r1Vck@O?x7;gS}*#zol!VPRP{achOtXh#ucXoY_tv0bVA^dls_XCVk)!
zd3sx<Xs3XpF3N+8yV8>nqH9}y^}QHat@SpcNMT{aHU&WC+-XtJms!ZH@Gz!JM0(HU
zOzO66EPREoJY?6IcJMN{;TCD82sVf=s!Cfp(_s56+5k)DJ=3HscZWEKZFFf4mGgXT
zTdUU8S_#SkCuu?Jz7Q}3wL1rY6uNY=G&9U(lz}*pnLI=Nb@cGn!DU+<&1VZ$>RE;S
zB~ze=GryN9oE<7TQHPBTFq4Z)B%VvR`h3ax{kVn?Q_<>)=DJxt&r%B}upWl7f1Pt;
z-(Wj>O|aHZFnN+;%u3)bkL<n{%uJ6_jCAuWEQC$2pX4y-j*Z6L=_bx>n6epO#3q?y
z&#_=JTz1g-MIx6(0$5;*VC~uE_T#E1_X7zgLt+qoCd!7*XV}Fz6+STv383c`+k%O{
zabx!o>b$lOj{*u^`Ns}sF-&+3&&!3^#hlKE@R?<?ZmDN6!wNXTAR~Co5}0TMUpNE0
z<{<Y-53>}`IRGd4^fQbR%og}UFqF%dx7E)_!NNRKBF<wz*)gBsSnfH_8p#&58H1Ny
zAfr|L1fRz;)i-rKi6tRPI2euN{0uLi_ca?nk2}^C$zg+{<_69IX!9IKA!PgK^Xq;g
zyTAUdY(Tl%?w@vv-THCtZ~S@g$Nu~@^LDw_D>Hj!;+YiV^UCICwjw*zkt^x+i%hL*
z5a?Z6*u?Oi*at5Vs1n$0@=<9)d)V;gJm0YAAj0;(RRq~bR&OhsdwUz*#u|>%jWUXM
zUEu=H6aTyi+$q+4K|xd3^E{<Fe=)?(NHMK8QDXm0{pLMx!5gKBqR_`%?D#f*hvK>_
zMRU5=uV-LiwJmynz<mKpzL}t-$`1EDfPD9hY`bJee_qn^<hLFb;#+__x}&nain^zW
z5r3?z!*FBS$)`YEjVl&suiVCs3BsKy(%)3Pzv2GB1Kg^*x7^@w;{J!fC;LL+dP%>p
y?A;OJFa8Yex5W4Idi4O`*C1|oj=x(zJN6fyfk>R8XrA`~0000<MNUMnLSTZ-G&__4

literal 0
HcmV?d00001