Minor docker-101 doc updates, typos fixed #983

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

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

readme: fix logo uri

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

documentation: include generated HTML in release archives

Closes https://github.com/shaarli/Shaarli/issues/908
Relates to https://github.com/shaarli/Shaarli/pull/772

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

documentation: set edit_uri

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

documentation: remove uneeded resources

Relates to https://github.com/shaarli/Shaarli/issues/312
Relates to https://github.com/shaarli/Shaarli/pull/772

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

documentation: remove generated HTML from SCM

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

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

Merge pull request #911 from virtualtam/fix/release/composer

fix: use pinned dependency revisions when generating release archives

fix: use pinned dependency revisions when generating release archives

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

Merge pull request #912 from virtualtam/travis/precise

travis: explicitly set the build dist to `precise`

travis: explicitly set the build dist to `precise`

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

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

Using only one form in linklist.html + adding untaggedonly filter - fix #885

Merge pull request #906 from virtualtam/docker/cleanup

docker: remove `dev` image, update documentation

Generate HTML documentation

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

docker: remove `dev` image, update documentation

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

Changed:
- Update Docker image list
- Update Docker documentation structure

Removed:
- Delete Dockerfile and resources for the `dev` image
- Cleanup `doc/` resources

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

Merge pull request #896 from ArthurHoaro/hotfix/firefox-social-subdir

Fix Firefox Social button in the default theme

doc: fix bullet list formatting

https://shaarli.readthedocs.io/en/master/Shaarli-configuration/

Merge pull request #901 from shaarli/fix-900

Remove merge conflict leftover

Merge pull request #899 from smuth4/master

Respect HTTP_X_FORWARDED_HOST

Add tests to cover new server_url behavior

Remove merge conflict leftover

Fixes #900

Respect HTTP_X_FORWARDED_HOST

alongside _PORT and _PROTO
Fixes #879

doc: contributing: remove leftover link to wiki

Merge pull request #772 from nodiscc/rtfd

Generate HTML documentation using MkDocs

makefile: remove [[link]] -> [link](url) conversion logic
all links in documentation have been converted to standard markdown link syntax

make htmlpages

makefile: remove obsolete 'doc' target
official documentation can now be found in doc/md/

doc: release: update doc generation instructions

CONTRIBUTING.md: define new workflow for documentation edition and contributions