Documentation: add reverse proxy examples for Docker images

Closes https://github.com/shaarli/Shaarli/issues/888

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

Merge pull request #846 from virtualtam/docker/alpine

Docker: switch to Alpine Linux

Merge pull request #996 from virtualtam/fix/user-css

Fix: enable access to data/user.css (Apache 2.2 & 2.4)

Fix: enable access to data/user.css (Apache 2.2 & 2.4)

Relates to https://github.com/shaarli/Shaarli/issues/872
Relates to https://github.com/shaarli/Shaarli/issues/993

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

EditorConfig: add .htaccess support

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

Merge pull request #995 from virtualtam/lint/editorconfig

Add EditorConfig configuration

Add EditorConfig configuration

EditorConfig allows specifying indentation, line feed and encoding
properties according to the type of file being edited.

Most editors support it out-of-the-box, or can benefit from it through a
plugin.

See:
- http://editorconfig.org/
- https://github.com/editorconfig/editorconfig
- https://github.com/editorconfig/editorconfig/wiki/EditorConfig-Properties

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

Merge pull request #992 from ArthurHoaro/feature/import-history

Don't write History for link import

Merge pull request #990 from danieljakots/master

Fix link in Upgrade-and-migration.md

Don't write History for link import

With large imports it has a large impact on performances and isn't really useful.

Instead, write an IMPORT event, which let client using the history service resync its DB.

-> 15k link import done in 6 seconds.

Fixes #985

Fix link in Upgrade-and-migration.md

Badge version

Merge pull request #988 from ArthurHoaro/changelog-0.9.2

Changelog 0.9.2 + AUTHORS

Update AUTHORS

Signed-off-by: ArthurHoaro <arthur@hoa.ro>

Changelog v0.9.2

Merge pull request #987 from ArthurHoaro/hotfix/security-issue

Fix security issue reported by @chb9

Fix security issue reported by @chbi

Vulnerability introduced by 6ccd0b218fbd34de750f55b78f3dc43bb3d9fa8e - release with Shaarli v0.9.1.

Merge pull request #979 from ArthurHoaro/feature/assets-cache-version

 Add a version hash for asset loading to prevent browser's cache issue

Merge pull request #980 from ArthurHoaro/hotfix/textarea-resize-jumpy

Fix jumpy textarea with long content in post edit

Merge pull request #983 from bvberkum/pullrequest/shaarli-docker-quickstart

Docker quickstart

Minor docker-101 doc updates, typos fixed #983

docker: rename resources for the stable image

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

docker: switch to Alpine Linux for the master image

Relates to https://github.com/shaarli/Shaarli/issues/843

Changed:
- switch base image from Debian:Jessie to Alpine:3.6
- switch to PHP 7.1
- switch from supervisord to s6 to manage services

See:
- https://alpinelinux.org/
- https://wiki.alpinelinux.org/wiki/Nginx_with_PHP
- http://www.skarnet.org/software/s6/
  - http://www.skarnet.org/software/s6/s6-svscan.html
  - http://www.skarnet.org/software/s6/s6-svc.html
  - http://www.skarnet.org/software/s6/s6-svstat.html

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

Merge pull request #981 from mark-gerarts/default-note-title

Allow setting of a default note title, see #963

Docker quickstart: one more grammar mistake. Made it a bit more terse.

Docker-101: added working systemd config example

Typo's, unified structure a bit.

- Fixes inevitable typo that crept in.
- Removed some blank lines, newlines, to match established whitespace use better.
- Minor grammar improvement.

Docker 101: container start and cleanup

Added docker quickstart example, with user-data volume

Allow setting of a default note title, see #963

Fix jumpy textarea with long content in post edit

We manually reset the scroll position, to avoid height = 'auto' jump to the top

Fixes #971

Rename shaarli_version constant to uppercase

Add a version hash for asset loading to prevent browser's cache issue

The hash is generated using the same salt as the one used for credentials (1 salt per instance)  in order to avoid exposing the instance version.

Fixes #965

Merge pull request #976 from ArthurHoaro/hotfix/url-parentheses

Fix parsing for description links with parentheses

Merge pull request #975 from virtualtam/robustness

Improve robustness for zlib and file operations

Fix parsing for description links with parentheses

With markdown plugin disabled

relates to #966

Merge pull request #947 from thewilli/wildcardsearch

wildcard tag search support

Robustness: safer gzinflate/zlib usage

Relates to https://github.com/shaarli/Shaarli/pull/846

PHP's `gzinflate()` fails with an error when being passed an empty string

See:
- https://bugs.php.net/bug.php?id=71395

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

Robustness: safer RainTPL directory handling

Relates to https://github.com/shaarli/Shaarli/issues/845
Relates to https://github.com/shaarli/Shaarli/issues/846
Relates to https://github.com/shaarli/Shaarli/pull/909

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

Merge pull request #972 from virtualtam/travis/trusty

Travis: switch to Ubuntu Trusty build environment

Tests: update localization tests

Rely on `mag_IN` (Magahi - INDIA) being unavailable when running localization
test suites, instead of `pt_BR` that is now available from Travis build images.

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

Travis: switch to Ubuntu Trusty build environment

Relates to https://github.com/shaarli/Shaarli/issues/970
Relates to https://github.com/shaarli/Shaarli/pull/912

See:
- https://docs.travis-ci.com/user/reference/trusty/
- https://blog.travis-ci.com/2017-07-11-trusty-as-default-linux-is-coming

Added:
- print available locales before running tests

Removed:
- do not install extra language packs

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

Merge pull request #909 from virtualtam/docker/test-environments

docker: add alpine,debian,ubuntu test images

Merge pull request #961 from thewilli/private-shaarli-login-redirect

added option to redirect all anonymous users to login page

docker: add alpine,debian,ubuntu test images

Relates to https://github.com/shaarli/Shaarli/issues/843

Added:
- Makefile target to run commands in a Docker test context
- Docker images to run Shaarli test suites:
  - Alpine 3.6
  - Debian 8
  - Debian 9
  - Ubuntu 16.04
- Documentation

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

visited links color: same hue as unvisited links, darkened

Related to https://github.com/shaarli/Shaarli/issues/877
Plain grey links would lead to think that the link is somehow disabled/inaccessible/private
This slightly improves clarity/usability

added option to redirect all anonymous users to login page

- new setting *force_login* added and documented
- if both, *force_login* and *hide_public_links* are set to true, all requests
  (except for the feeds) are redirected to the login page

Merge pull request #939 from ArthurHoaro/hotfix/firefox-social-title

Firefox Social title: Use document.title instead of RainTPL variable

Firefox Social title: Use document.title instead of RainTPL variable

Fixes #929

Make  work behind a reverse proxy

Without HTTP_X_FORWARDED_PORT check,  might be set to false even though the user is using HTTPS, thus disabling Firefox Social block display

Merge pull request #956 from virtualtam/fix/make-authors

Documentation+Makefile: update AUTHORS generation

Merge pull request #950 from thewilli/delete-fix

fixed link deletion

Merge pull request #951 from thewilli/fix-daily

fixed daily links if there are no links

wildcard tag search support

- when searching for tags you can now include '*' as wildcard placeholder
- new search reduces overall overhead when filtering for tags
- fixed combination with description tag search ('#' prefix)
- tests added

fixed link deletion

When deleting links, the js of the default theme separated ids by an escaped space ('+').
There was a trailing '+' after the ids which led to the php code detecting multiple values
even for single values. In combination with the id '0' this could led to no id found at all
and a resulting php error.

this commit fixes the behavior and adds an additional error handling and trimming to the php code.

fixed daily links if there are no links

- the previous code tried to use links from a previous day if there are no one for the current one
- the new code skips this part if there are no entries (i.e. days) at all
- modified showDaily() to fit PSR-1 and PSR-2

Documentation+Makefile: update AUTHORS generation

Fixes https://github.com/shaarli/Shaarli/issues/935

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

Merge pull request #944 from thewilli/configure-rememberme

new setting: default value for 'remember me' checkbox

new setting: default value for 'remember me' checkbox

- the default state for the login page's 'remember me' checkbox can now be configured
- adapted the default and vintage theme to consider the new setting
- added documentation for the new setting

Merge pull request #940 from ArthurHoaro/hotfix/empty-urls

Generates a permalink URL if the URL is set to blank

Merge pull request #942 from thewilli/fix-wiki-links

migrated Github wiki links to readthedocs

Merge pull request #946 from thewilli/clean

small code cleanup

code clean: cookie expiration

- unified code style (spaces around operators)
- prevented expiration time to be calculated twice
- replaced tabs with spaces

removed doc and code references to magic quotes

- removed all references to magic quotes
- magic quotes are not supported on PHP >= 5.4 (https://secure.php.net/manual/en/security.magicquotes.php)
- Shaarli does not support PHP < 5.5

migrated Github wiki links to readthedocs

Generates a permalinks URL if the URL is set to blank

Fixes #926

Merge pull request #938 from ArthurHoaro/hotfix/tagcloud-order

Sort tag cloud in alphabetical order

Sort tag cloud in alphabetical order

Fixes #932

Merge pull request #934 from thewilli/fix-note-bookmarklet

fixed note bookmarklet

fixed note bookmarklet

- the double quotes used in the alert() call of the note bookmarklet in the default template collided with the ones of the href tag
- replaced the double quotes with single ones (just like the link bookmarklet)

Merge pull request #928 from virtualtam/documentation/v0.9.1

documentation: update installation instructions for 0.9.1

documentation: update installation instructions for 0.9.1

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

Merge pull request #927 from virtualtam/changelog

Update Changelog for 0.9.1

Update CHANGELOG.md for 0.9.1

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

documentation: fix list formatting

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

Merge pull request #925 from ArthurHoaro/theme/remove-2nd-sort-by

Remove the 2nd green 'sort by' row in link list

Merge pull request #924 from ArthurHoaro/feature/hide-list-search

Hide the search link if no tag has been searched in tag list

Merge pull request #923 from ArthurHoaro/hotfix/untagged

Fix untagged only button

Remove the 2nd green 'sort by' row in link list

It isn't really useful and doesn't look good if there isn't enough tags

Hide the search link if no tag has been searched in tag list

Fix untagged only button

Merge pull request #920 from virtualtam/documentation/rest-3rd

documentation: update 3rd-party resources

documentation: update 3rd-party resources

Relates to https://github.com/shaarli/Shaarli/issues/915

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

Merge pull request #918 from Lucas-C/master

Adding missing empty() as spotted in #889 code review

Adding missing empty() as spotted in #889 code review

Merge pull request #917 from virtualtam/documentation/fixes+improvements

Documentation fixes, improvements and additions

documentation: elaborate on REST API server & client prerequisites

Relates to https://github.com/shaarli/Shaarli/issues/903
Relates to https://github.com/shaarli/Shaarli/issues/905

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

documentation: remove obsolete doc release instructions

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

documentation: add links to example REST API clients

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

documentation: rewrite the REST API PHP client example

Closes https://github.com/shaarli/Shaarli/issues/905
Relates to https://github.com/shaarli/Shaarli/pull/751
See https://shaarli.github.io/api-documentation/

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

documentation: update release download and usage information

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

documentation: remove duplicate "Coding guidelines" page

The information is already present under "Static analysis"

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

documentation: fix rendering and internal references

This is mainly cleanup after switching from Github-flavoured Markdown
rendered by Github Pages, to standard Markdown rendered by MkDocs.

Changed:
- rephrase some section titles

Fixed:
- list rendering (items, sub-items))
- code rendering
- quotes
- dead links

Removed:
- extraneous navigational elements

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

Merge pull request #916 from ArthurHoaro/hotfix/fix-composer-php-version

Fix PHP version configuration in composer.json

Fix PHP version configuration in composer.json

Without this setting, composer would download dependencies depending on the PHP version installed on the system.
E.G. I was getting doctrine/instantiator 1.1, which requires at least PHP 7.1.

Merge pull request #910 from virtualtam/documentation/improvements

Include generated doc in release archives, remove HTML from SCM

Merge pull request #887 from ArthurHoaro/hotfix/dash-tag-rename

Make sure that the tag exists before altering/removing it

Move tag renaming code to LinkDB and unit test it

Merge pull request #889 from Lucas-C/master

Using only one form in linklist.html - fix #885

Merge pull request #913 from virtualtam/fix/readme

readme: fix logo uri