diff options
author | nodiscc <nodiscc@gmail.com> | 2015-04-05 22:18:04 +0200 |
---|---|---|
committer | nodiscc <nodiscc@gmail.com> | 2015-04-05 22:18:04 +0200 |
commit | 10070c3700aba137aab7b341d6116584f22715a3 (patch) | |
tree | a1dffbbeff1f029d466ef18b4f64c8870ffa23ea | |
parent | f3e89f50ecae76ddd6bf77e23b4a84bec998bd69 (diff) | |
download | Shaarli-10070c3700aba137aab7b341d6116584f22715a3.tar.gz Shaarli-10070c3700aba137aab7b341d6116584f22715a3.tar.zst Shaarli-10070c3700aba137aab7b341d6116584f22715a3.zip |
doc: update documentation (sync from wiki)
-rw-r--r-- | doc/Home.md | 63 |
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 | |||
192 | Delete 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 |
144 | Login 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. | 197 | Login 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 | ||
146 | To remove the current IP bans, delete the file `data/ipbans.php` | 199 | To 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 | ||
150 | The file `data/log.txt` shows all logins (successful or failed) and bans/lifted bans. | 203 | The file `data/log.txt` shows all logins (successful or failed) and bans/lifted bans. |
151 | Search for `failed` in this file to look for unauthorized login attempts. | 204 | Search for `failed` in this file to look for unauthorized login attempts. |
152 | 205 | ||
153 | # Troubleshooting | ||
154 | |||
155 | ### I forgot my password ! | ||
156 | |||
157 | Delete 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 | ||