aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc/Home.md
diff options
context:
space:
mode:
authornodiscc <nodiscc@gmail.com>2015-04-05 22:18:04 +0200
committernodiscc <nodiscc@gmail.com>2015-04-05 22:18:04 +0200
commit10070c3700aba137aab7b341d6116584f22715a3 (patch)
treea1dffbbeff1f029d466ef18b4f64c8870ffa23ea /doc/Home.md
parentf3e89f50ecae76ddd6bf77e23b4a84bec998bd69 (diff)
downloadShaarli-10070c3700aba137aab7b341d6116584f22715a3.tar.gz
Shaarli-10070c3700aba137aab7b341d6116584f22715a3.tar.zst
Shaarli-10070c3700aba137aab7b341d6116584f22715a3.zip
doc: update documentation (sync from wiki)
Diffstat (limited to 'doc/Home.md')
-rw-r--r--doc/Home.md63
1 files changed, 55 insertions, 8 deletions
diff --git a/doc/Home.md b/doc/Home.md
index c80b8c92..bbece989 100644
--- a/doc/Home.md
+++ b/doc/Home.md
@@ -8,6 +8,52 @@ If you'd like a feature added, see if it fits in the list of [Ideas for Plugins]
8 8
9_Note: This documentation is available online at https://github.com/shaarli/Shaarli/wiki, and locally in the `doc/` directory of your Shaarli installation._ 9_Note: This documentation is available online at https://github.com/shaarli/Shaarli/wiki, and locally in the `doc/` directory of your Shaarli installation._
10 10
11----------------------------------------------------------------------------------
12
13<!-- MarkdownTOC depth=3 -->
14
15- [Basic Usage](#basic-usage)
16 - [Add the sharing button (_bookmarklet_) to your browser](#add-the-sharing-button-_bookmarklet_-to-your-browser)
17 - [Share links using the _bookmarklet_](#share-links-using-the-_bookmarklet_)
18- [Other usage examples](#other-usage-examples)
19 - [Using Shaarli as a blog, notepad, pastebin...](#using-shaarli-as-a-blog-notepad-pastebin)
20 - [RSS Feeds or Picture Wall for a specific search/tag](#rss-feeds-or-picture-wall-for-a-specific-searchtag)
21- [Configuration](#configuration)
22 - [Main data/options.php file](#main-dataoptionsphp-file)
23 - [Changing theme](#changing-theme)
24 - [Changing template](#changing-template)
25- [Backup](#backup)
26- [Troubleshooting](#troubleshooting)
27 - [I forgot my password !](#i-forgot-my-password-)
28 - [I'm locked out - Login bruteforce protection](#im-locked-out---login-bruteforce-protection)
29 - [List of all login attempts](#list-of-all-login-attempts)
30 - [Exporting from Diigo](#exporting-from-diigo)
31 - [Importing from SemanticScuttle](#importing-from-semanticscuttle)
32 - [Importing from Mister Wong](#importing-from-mister-wong)
33 - [Hosting problems](#hosting-problems)
34 - [Dates are not properly formatted](#dates-are-not-properly-formatted)
35 - [Problems on CentOS servers](#problems-on-centos-servers)
36 - [My session expires ! I can't stay logged in](#my-session-expires--i-cant-stay-logged-in)
37 - [`Sessions do not seem to work correctly on your server`](#sessions-do-not-seem-to-work-correctly-on-your-server)
38 - [pubsubhubbub support](#pubsubhubbub-support)
39- [Notes](#notes)
40 - [Various hacks](#various-hacks)
41 - [Changing timestamp for a link](#changing-timestamp-for-a-link)
42- [Related software](#related-software)
43- [Other links](#other-links)
44- [FAQ](#faq)
45 - [Why did you create Shaarli ?](#why-did-you-create-shaarli-)
46 - [Why use Shaarli and not Delicious/Diigo ?](#why-use-shaarli-and-not-deliciousdiigo-)
47 - [What does Shaarli mean ?](#what-does-shaarli-mean-)
48- [Technical details](#technical-details)
49 - [Directory structure](#directory-structure)
50 - [Why not use a real database ? Files are slow !](#why-not-use-a-real-database--files-are-slow-)
51- [Wiki - TODO](#wiki---todo)
52
53<!-- /MarkdownTOC -->
54
55
56
11------------------------------------------------------------------ 57------------------------------------------------------------------
12 58
13# Basic Usage 59# Basic Usage
@@ -139,23 +185,24 @@ You have two ways of backing up your database:
139 * This can be done using the [shaarchiver](https://github.com/nodiscc/shaarchiver) tool. Example command: `./export-bookmarks.py --url=https://my.server.com/shaarli --username=myusername --password=mysupersecretpassword --download-dir=./ --type=all` 185 * This can be done using the [shaarchiver](https://github.com/nodiscc/shaarchiver) tool. Example command: `./export-bookmarks.py --url=https://my.server.com/shaarli --username=myusername --password=mysupersecretpassword --download-dir=./ --type=all`
140 186
141 187
188# Troubleshooting
189
190### I forgot my password !
191
192Delete the file data/config.php and display the page again. You will be asked for a new login/password.
193
194
142 195
143# Login bruteforce protection 196### I'm locked out - Login bruteforce protection
144Login form is protected against brute force attacks: 4 failed logins will ban the IP address from login for 30 minutes. Banned IPs can still browse links. 197Login form is protected against brute force attacks: 4 failed logins will ban the IP address from login for 30 minutes. Banned IPs can still browse links.
145 198
146To remove the current IP bans, delete the file `data/ipbans.php` 199To remove the current IP bans, delete the file `data/ipbans.php`
147 200
148## List of all login attempts 201### List of all login attempts
149 202
150The file `data/log.txt` shows all logins (successful or failed) and bans/lifted bans. 203The file `data/log.txt` shows all logins (successful or failed) and bans/lifted bans.
151Search for `failed` in this file to look for unauthorized login attempts. 204Search for `failed` in this file to look for unauthorized login attempts.
152 205
153# Troubleshooting
154
155### I forgot my password !
156
157Delete the file data/config.php and display the page again. You will be asked for a new login/password.
158
159 206
160### Exporting from Diigo 207### Exporting from Diigo
161 208