From 02e9e91c8684f82c410d267bb73cc031da2ef8b4 Mon Sep 17 00:00:00 2001 From: Dale Davies Date: Fri, 3 Mar 2023 14:51:26 +0000 Subject: [PATCH] Update readme with details of site status options --- README.md | 25 ++++++++++++++++++------- 1 file changed, 18 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 1d231a0..1c4bceb 100644 --- a/README.md +++ b/README.md @@ -161,17 +161,20 @@ Edit the `/sites/sites.json` file to include your own sites on the startpage... "url" : "https://cloud.example.com", "icon": "nextcloud.png", "tags": ["home", "stuff", "things"] - }, - { - "name": "Paperless", - "url" : "https://paperless.example.com", - "icon": "paperless.jpg", - "tags": ["things", "home"] - }, + } { "name": "Google", "url" : "https://www.google.com", "nofollow": false + }, + { + "name": "Teapot", + "url" : "https://www.google.com/pagedoesnotexist", + "status": { + "allowed_status_codes": [418], + "request_method": "GET", + "url": "https://www.google.com/teapot" + } } ] } @@ -205,6 +208,14 @@ On a per-site basis use `"nofollow": true` to include `rel="nofollow"` on specif On a per-site basis use `"newtab": true` to open specific site links in a new browser tab. +#### status + +Options to control how status checking works can be defined for each site... + +- `allowed_status_codes`: A list of additional status codes (in the 4XX and 5XX ranges) that could represent the site is online, for example if the site responds with "418 I'm a teapot". +- `request_method`: By default Jump will make a HEAD request when checking a site's status, you can use this option to specify `GET` instead. +- `url`: An alternate status URL to check instead of the main site URL. + ### Search Edit the `/search/searchengines.json` file to customise the list of search engines available from the search dropdown, the first search engine in the list will be the default...