Doc: sync from Wiki, generate HTML

Signed-off-by: VirtualTam <virtualtam@flibidi.net>

diff --git a/doc/3rd-party-libraries.html b/doc/3rd-party-libraries.html
index a9c3a88ed45c745be2a1a88e9fa570bed7f1e9dc..86f670aefabac96c0ce70a3c84320cb163cca02f 100644 (file)
--- a/doc/3rd-party-libraries.html
+++ b/doc/3rd-party-libraries.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Backup,-restore,-import-and-export.html b/doc/Backup,-restore,-import-and-export.html
index 183a5ed4d2a0449d9f5fb5ea6296d1f0cae78d21..40c7a852b6a339f0e7ade55a026bef4bec718aa0 100644 (file)
--- a/doc/Backup,-restore,-import-and-export.html
+++ b/doc/Backup,-restore,-import-and-export.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Coding-guidelines.html b/doc/Coding-guidelines.html
index 0f071a5ae05d3f966cbba151ff616fb0808ed434..fd6fa57159abe07b62110a476ca9cb485b6ddbb2 100644 (file)
--- a/doc/Coding-guidelines.html
+++ b/doc/Coding-guidelines.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Community-&-Related-software.html b/doc/Community-&-Related-software.html
index 5468379c0a54d568a19c90b027d633303ece1dda..25ef0f883130e05964e92f74e2f35ec78e4aeb8d 100644 (file)
--- a/doc/Community-&-Related-software.html
+++ b/doc/Community-&-Related-software.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.html b/doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.html
index 9e930e522fd65b2235493e6e0a6df8c9967ead60..1e81b7358d7bcdf9bddc44b148f4a6477dce74d6 100644 (file)
--- a/doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.html
+++ b/doc/Copy-an-existing-installation-over-SSH-and-serve-it-locally.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Datastore-hacks.html b/doc/Datastore-hacks.html
index 4677ae9100f9b9391cf0452453e4e6599327e8f4..e3adee1990b9b3de056604cb3788de7583564a55 100644 (file)
--- a/doc/Datastore-hacks.html
+++ b/doc/Datastore-hacks.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Development.html b/doc/Development.html
index 1e33eff4574fc0581d6c2c74bdbaa4193f2d5e58..6e222573ae3d2bd27ab0e304ae38fcf44534c9f1 100644 (file)
--- a/doc/Development.html
+++ b/doc/Development.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Directory-structure.html b/doc/Directory-structure.html
index 4ea5e24954022cfcfe207546144d0f84068a9537..ae0458f3cc2070446282100dbe8026f60d6d0a71 100644 (file)
--- a/doc/Directory-structure.html
+++ b/doc/Directory-structure.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Download-CSS-styles-from-an-OPML-list.html b/doc/Download-CSS-styles-from-an-OPML-list.html
index b21a54bdbcb067b7595a5a3ee9a14f4593af80f1..033dd18cc9a1a4fe5c52fbb1b6ceef12d4997594 100644 (file)
--- a/doc/Download-CSS-styles-from-an-OPML-list.html
+++ b/doc/Download-CSS-styles-from-an-OPML-list.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Example-patch---add-new-via-field-for-links.html b/doc/Example-patch---add-new-via-field-for-links.html
index 44352d3e38b761493d4bd96c1da76f69104b92a9..ff73ec0f764633ece156b56d62c8e6f97c477073 100644 (file)
--- a/doc/Example-patch---add-new-via-field-for-links.html
+++ b/doc/Example-patch---add-new-via-field-for-links.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/FAQ.html b/doc/FAQ.html
index 0ebd1bcfbeedacc282ddd54a3665095eefd5bb18..b26b63550c9d5f5aee967dcd8af2342d354ab1e4 100644 (file)
--- a/doc/FAQ.html
+++ b/doc/FAQ.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Firefox-share.html b/doc/Firefox-share.html
index 198afe232f4a74abc4a924b08901f0b4544ba91b..d666ac7b4c11e4c176bd152a699dacc9188c0fcf 100644 (file)
--- a/doc/Firefox-share.html
+++ b/doc/Firefox-share.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/GnuPG-signature.html b/doc/GnuPG-signature.html
index c9e0455a23759c4bedec81212081947f757ba0cb..b7dc1083fd31cd729e76f72f0ce3131db90cb351 100644 (file)
--- a/doc/GnuPG-signature.html
+++ b/doc/GnuPG-signature.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Home.html b/doc/Home.html
index 37d62e8b4804124c279d597550c00b3c7bdc2313..90372a40b40a76e2ca9a128e0e00377d8640f295 100644 (file)
--- a/doc/Home.html
+++ b/doc/Home.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Plugin-System.html b/doc/Plugin-System.html
index 6d08d8595febf33df3af726000d768b3c43afd98..719b76fe4d52fe9c0219926af1ed636f2bb0863c 100644 (file)
--- a/doc/Plugin-System.html
+++ b/doc/Plugin-System.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/RSS-feeds.html b/doc/RSS-feeds.html
index 4a9b7a0e9477a673f0d3cc7354047245120500b2..7d1de078bc0027ce601778d11d10f80bf1219383 100644 (file)
--- a/doc/RSS-feeds.html
+++ b/doc/RSS-feeds.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Security.html b/doc/Security.html
index 1fbbabde06e9d043f4d388a6bac3f60c4526c8ff..db44da2ca09114f9e10e46346a7dfa2d72bb473d 100644 (file)
--- a/doc/Security.html
+++ b/doc/Security.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Server-configuration.html b/doc/Server-configuration.html
index de6bf488cec95b7289bbb1c6ef6437e6a9d8c463..e4e383a3a2dd24ce8136d10c16533036325a25e3 100644 (file)
--- a/doc/Server-configuration.html
+++ b/doc/Server-configuration.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Server-requirements.html b/doc/Server-requirements.html
index bf5a2e8bcc4be8e9bb1d481752b483c3b966cfa5..b0426eec67740a66b9e05652b12dcc300bd4bd13 100644 (file)
--- a/doc/Server-requirements.html
+++ b/doc/Server-requirements.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Shaarli-configuration.html b/doc/Shaarli-configuration.html
index 90c095420c5d43d0d0d5719ea6590fb5cc04c5c3..663b43e5f94aea163ad2db022190b5c94e633c87 100644 (file)
--- a/doc/Shaarli-configuration.html
+++ b/doc/Shaarli-configuration.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Sharing-button.html b/doc/Sharing-button.html
index 034f2f9c9c207e8569fec37ebf36a49d3a39bf18..d3f362535a279c14d9678f7d656b339867fbebcd 100644 (file)
--- a/doc/Sharing-button.html
+++ b/doc/Sharing-button.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Static-analysis.html b/doc/Static-analysis.html
index d4588e4d8551cafe1c6704b1ecc21106c39a1fca..dd1dd223eb95179a69da4f1638458edec233db57 100644 (file)
--- a/doc/Static-analysis.html
+++ b/doc/Static-analysis.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/TODO.html b/doc/TODO.html
index f66d64f26052d7dcfcbb00b77330371a682c238c..c25775ccbc84e501ac463a3ba438d0dcedfabecd 100644 (file)
--- a/doc/TODO.html
+++ b/doc/TODO.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Theming.html b/doc/Theming.html
index e814dadf7b456b443d515a2dfbaa18feb195eaf6..b5d214e58322c6431197547fffe0fcf20ce8621d 100644 (file)
--- a/doc/Theming.html
+++ b/doc/Theming.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Troubleshooting.html b/doc/Troubleshooting.html
index 6965a578ea32d92ac4bb72741ee7024c94e1b433..00cfdff825600c9b31c8977aed10f19daa769fe3 100644 (file)
--- a/doc/Troubleshooting.html
+++ b/doc/Troubleshooting.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>
@@ -74,6 +75,54 @@ code > span.er { color: #ff0000; font-weight: bold; }
 </ul>
 </div>
 <h1 id="troubleshooting">Troubleshooting</h1>
+<h2 id="browser">Browser</h2>
+<h3 id="redirection-issues-http-referer">Redirection issues (HTTP Referer)</h3>
+<p>Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.</p>
+<p>See:</p>
+<ul>
+<li><a href="https://en.wikipedia.org/wiki/HTTP_referer">HTTP referer</a> (Wikipedia)<a href=".html"></a></li>
+<li><a href="http://www.ghacks.net/2015/01/22/improve-online-privacy-by-controlling-referrer-information/">Improve online privacy by controlling referrer information</a><a href=".html"></a></li>
+<li><a href="http://b.agilob.net/better-security-privacy-and-anonymity-in-firefox/">Better security, privacy and anonymity in Firefox</a><a href=".html"></a></li>
+</ul>
+<h3 id="firefox-http-referer-options">Firefox HTTP Referer options</h3>
+<p>HTTP settings are available by browsing <code>about:config</code>, here are the available settings and their values.</p>
+<p><code>network.http.sendRefererHeader</code> - determines when to send the Referer HTTP header</p>
+<ul>
+<li>0: Never send the referring URL
+<ul>
+<li>not recommended, may break some sites</li>
+</ul></li>
+<li>1: Send only on clicked links</li>
+<li>2 (default): Send for links and images</li>
+</ul>
+<p><code>network.http.referer.XOriginPolicy</code> - Cross-domain origin policy</p>
+<ul>
+<li>0 (default): Always send</li>
+<li>1: Send if base domains match</li>
+<li>2: Send if hosts match</li>
+</ul>
+<p><code>network.http.referer.spoofSource</code> - Referer spoofing (~faking)</p>
+<ul>
+<li>false (default): real referer</li>
+<li>true: spoof referer (use target URI as referer)</li>
+</ul>
+<p><code>network.http.referer.trimmingPolicy</code> - trim the URI not to send a full Referer</p>
+<ul>
+<li>0 (default): send full URI</li>
+<li>1: scheme+host+port+path</li>
+<li>2: scheme+host+port</li>
+</ul>
+<h3 id="firefox-localhost-and-redirections">Firefox, localhost and redirections</h3>
+<p><code>localhost</code> is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or anly accept requests from the same base domain/host, Shaarli redirections will not work properly.</p>
+<p>To solve this, assign a local domain to your host, e.g.</p>
+<pre><code>127.0.0.1 localhost desktop localhost.lan
+::1       localhost desktop localhost.lan</code></pre>
+<p>and browse Shaarli at <a href="http://localhost.lan/" class="uri">http://localhost.lan/</a>.</p>
+<p>Related threads:</p>
+<ul>
+<li><a href="https://bbs.archlinux.org/viewtopic.php?id=156064">What is localhost.localdomain for?</a><a href=".html"></a></li>
+<li><a href="https://github.com/shaarli/Shaarli/issues/311">Stop returning to the first page after editing a bookmark from another page</a><a href=".html"></a></li>
+</ul>
 <h2 id="login">Login</h2>
 <h3 id="i-forgot-my-password">I forgot my password!</h3>
 <p>Delete the file <code>data/config.php</code> and display the page again. You will be asked for a new login/password.</p>
@@ -83,6 +132,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <h3 id="list-of-all-login-attempts">List of all login attempts</h3>
 <p>The file <code>data/log.txt</code> shows all logins (successful or failed) and bans/lifted bans.<br />Search for <code>failed</code> in this file to look for unauthorized login attempts.</p>
 <h2 id="hosting-problems">Hosting problems</h2>
+<h3 id="old-php-versions">Old PHP versions</h3>
 <ul>
 <li>On <strong>free.fr</strong> : Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing. Don't forget to create a <code>sessions</code> directory at the root of your webspace. Change the file extension to <code>.php5</code> or create a <code>.htaccess</code> file in the directory where Shaarli is located containing:</li>
 </ul>

diff --git a/doc/Troubleshooting.md b/doc/Troubleshooting.md
index 4adf7c928ff157fa9aef1b9e08ab086787f6df40..4e6cdb063b458515160d1dfaccb16b231d52a6d3 100644 (file)
--- a/doc/Troubleshooting.md
+++ b/doc/Troubleshooting.md
@@ -1,7 +1,53 @@
 #Troubleshooting
+## Browser
+### Redirection issues (HTTP Referer)
+Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.
+
+See:
+- [HTTP referer](https://en.wikipedia.org/wiki/HTTP_referer) (Wikipedia)[](.html)
+- [Improve online privacy by controlling referrer information](http://www.ghacks.net/2015/01/22/improve-online-privacy-by-controlling-referrer-information/)[](.html)
+- [Better security, privacy and anonymity in Firefox](http://b.agilob.net/better-security-privacy-and-anonymity-in-firefox/)[](.html)
+
+### Firefox HTTP Referer options
+HTTP settings are available by browsing `about:config`, here are the available settings and their values.
+
+`network.http.sendRefererHeader` - determines when to send the Referer HTTP header
+- 0: Never send the referring URL
+    - not recommended, may break some sites
+- 1: Send only on clicked links
+- 2 (default): Send for links and images
+
+`network.http.referer.XOriginPolicy` - Cross-domain origin policy
+- 0 (default): Always send
+- 1: Send if base domains match
+- 2: Send if hosts match
+
+`network.http.referer.spoofSource` - Referer spoofing (~faking)
+- false (default): real referer
+- true: spoof referer (use target URI as referer)
+
+`network.http.referer.trimmingPolicy` - trim the URI not to send a full Referer
+- 0 (default): send full URI
+- 1: scheme+host+port+path
+- 2: scheme+host+port
+
+### Firefox, localhost and redirections
+`localhost` is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or anly accept requests from the same base domain/host, Shaarli redirections will not work properly.
+
+To solve this, assign a local domain to your host, e.g.
+```
+127.0.0.1 localhost desktop localhost.lan
+::1       localhost desktop localhost.lan
+```
+
+and browse Shaarli at http://localhost.lan/.
+
+Related threads:
+- [What is localhost.localdomain for?](https://bbs.archlinux.org/viewtopic.php?id=156064)[](.html)
+- [Stop returning to the first page after editing a bookmark from another page](https://github.com/shaarli/Shaarli/issues/311)[](.html)
+
 ## Login
 ### I forgot my password!
-
 Delete the file `data/config.php` and display the page again. You will be asked for a new login/password.
 
 ### I'm locked out - Login bruteforce protection
@@ -10,11 +56,11 @@ Login form is protected against brute force attacks: 4 failed logins will ban th
 To remove the current IP bans, delete the file `data/ipbans.php`
 
 ### List of all login attempts
-
 The file `data/log.txt` shows all logins (successful or failed) and bans/lifted bans.
 Search for `failed` in this file to look for unauthorized login attempts.
 
 ## Hosting problems
+### Old PHP versions
  * On **free.fr** : Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing.  Don't forget to create a `sessions` directory at the root of your webspace. Change the file extension to `.php5` or create a `.htaccess` file in the directory where Shaarli is located containing:
 
 ```ini
@@ -56,5 +102,4 @@ This can be caused by several things:
 Follow the instructions in the error message. Make sure you are accessing shaarli via a direct IP address or a proper hostname. If you have **no dots** in the hostname (e.g. `localhost` or `http://my-webserver/shaarli/`), some browsers will not store cookies at all (this respects the [HTTP cookie specification](http://curl.haxx.se/rfc/cookie_spec.html)).[](.html)
 
 ### pubsubhubbub support
-
 Download [publisher.php](https://pubsubhubbub.googlecode.com/git/publisher_clients/php/library/publisher.php) at the root of your Shaarli installation and set `$GLOBALS['config'['PUBSUBHUB_URL']` in your `config.php`]('PUBSUBHUB_URL']`-in-your-`config.php`.html)

diff --git a/doc/Unit-tests.html b/doc/Unit-tests.html
index 25873cb01ea2e9fb4f26780f02326838228245fb..f4b42bdfbc70cacb2b909bee957d3f35b9f25101 100644 (file)
--- a/doc/Unit-tests.html
+++ b/doc/Unit-tests.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/Usage.html b/doc/Usage.html
index cffdc4d6ed081eac927233e2e82319ba178e0d38..ad5b79650f48c91e7c8f9bbf503afa5a516d7147 100644 (file)
--- a/doc/Usage.html
+++ b/doc/Usage.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/_Sidebar.html b/doc/_Sidebar.html
index c2725196678605b88e2feb89f42f9f54e239f8c9..0f9d546e5cbdf2d75ba1cbba96c0f2396ee6f678 100644 (file)
--- a/doc/_Sidebar.html
+++ b/doc/_Sidebar.html
@@ -32,6 +32,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>
@@ -74,6 +75,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>

diff --git a/doc/_Sidebar.md b/doc/_Sidebar.md
index 64b16491436a8ec5c877989a866510e7f9bb4822..db75943a2bbaaf201927ccf7aa7d29df9e7954d6 100644 (file)
--- a/doc/_Sidebar.md
+++ b/doc/_Sidebar.md
@@ -12,6 +12,7 @@
     - [Backup, restore, import and export](Backup,-restore,-import-and-export.html)
     - [Copy an existing installation over SSH and serve it locally](Copy-an-existing-installation-over-SSH-and-serve-it-locally.html)
     - [Download CSS styles from an OPML list](Download-CSS-styles-from-an-OPML-list.html)
+    - [Datastore hacks](Datastore-hacks.html)
 - [Troubleshooting](Troubleshooting.html)
 - [Development](Development.html)
     - [GnuPG signature](GnuPG-signature.html)

diff --git a/doc/sidebar.html b/doc/sidebar.html
index 1b5854007bf9ebee1964669908c931fe87f4625c..e8bc59323ebd65022ec1b15dc9af6b4575abcaa9 100644 (file)
--- a/doc/sidebar.html
+++ b/doc/sidebar.html
@@ -18,6 +18,7 @@
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>