From fc60c8a6d2a850ca9e08a888be4f85badf39cf4c Mon Sep 17 00:00:00 2001 From: zombieFox Date: Fri, 20 Aug 2021 19:00:28 +0100 Subject: [PATCH] add support pages --- .gitignore | 1 + Recovering-user-settings-and-bookmarks.md | 6 ++++-- Setting-nightTab-as-your-Firefox-homepage.md | 4 +++- backup-nighttab-setup.md | 12 ++++++++++++ browser-support.md | 5 +++++ clearing-cookies-and-cache.md | 7 +++++++ image/icon/settings.svg | 1 + ...kground-image-upload-is-no-longer-supported.md | 15 +++++++++++++++ nighttab-respects-your-privacy.md | 3 +++ restore-nighttab-setup.md | 15 +++++++++++++++ 10 files changed, 66 insertions(+), 3 deletions(-) create mode 100644 .gitignore create mode 100644 backup-nighttab-setup.md create mode 100644 browser-support.md create mode 100644 clearing-cookies-and-cache.md create mode 100644 image/icon/settings.svg create mode 100644 local-background-image-upload-is-no-longer-supported.md create mode 100644 nighttab-respects-your-privacy.md create mode 100644 restore-nighttab-setup.md diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..e43b0f9 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +.DS_Store diff --git a/Recovering-user-settings-and-bookmarks.md b/Recovering-user-settings-and-bookmarks.md index c3f0be0..958b944 100644 --- a/Recovering-user-settings-and-bookmarks.md +++ b/Recovering-user-settings-and-bookmarks.md @@ -1,7 +1,9 @@ -In the event of a bug or loading issue, user settings and bookmarks saved when using nightTab can be recovered from the browser [local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage). +# Recovering user settings and bookmarks + +In the event of a bug or loading issue, user settings and bookmarks saved when using nightTab can be recovered from the browser [local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage). 1. Open nightTab 2. Open the developer tools 3. Go to the console ([Finding your browser's developer console](https://balsamiq.com/support/faqs/browserconsole/)) 4. Use the command `copy(localStorage.getItem("nightTab-backup"))` or `copy(localStorage.getItem("nightTab"))` to copy your data to the clipboard -5. Paste this data into an empty text file and save as a JSON file, eg: my-nightTab-settings.json \ No newline at end of file +5. Paste this data into an empty text file and save as a [JSON](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Objects/JSON#no_really_what_is_json) file, e.g. `my-nightTab-settings.json`. diff --git a/Setting-nightTab-as-your-Firefox-homepage.md b/Setting-nightTab-as-your-Firefox-homepage.md index 03774c6..6046791 100644 --- a/Setting-nightTab-as-your-Firefox-homepage.md +++ b/Setting-nightTab-as-your-Firefox-homepage.md @@ -1,3 +1,5 @@ +# Setting nightTab as your Firefox homepage + Firefox does not allow addons to replace the "homepage". However there is a workaround: - Open a new Firefox window @@ -5,4 +7,4 @@ Firefox does not allow addons to replace the "homepage". However there is a work - In Firefox preferences under `Home`, change `Homepage and new windows` to `Custom URLs...` - Then click `Use Current Page`. -nightTab will now appear as the homepage. \ No newline at end of file +nightTab will now appear as the homepage. diff --git a/backup-nighttab-setup.md b/backup-nighttab-setup.md new file mode 100644 index 0000000..fff15e6 --- /dev/null +++ b/backup-nighttab-setup.md @@ -0,0 +1,12 @@ +# Backup nightTab setup + +nightTab is privacy first extension and does not save any user data on a remote database. For this reason if nightTab is uninstalled your start page bookmarks, settings and theme will also be removed. + +For this reason you should frequently backup your settings. This can easily be done from the ![Settings](image/icon/settings.svg) `Menu` > `Data` > `Backup` > `Export Data`. + + +A backup [JSON](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Objects/JSON#no_really_what_is_json) file will be saved to your computer. This backup file will be named with a data and timestamp for easy reference, e.g. `nightTab backup - 2021.08.16 - 09 10 29.json`. + +You can use this backup file to restore your settings on any device with nightTab installed. + +To restore your setup go to ![Settings](image/icon/settings.svg) `Menu` > `Data` > `Restore` > `Import Data`. Then select the previously exported backup JSON file. diff --git a/browser-support.md b/browser-support.md new file mode 100644 index 0000000..696fc3e --- /dev/null +++ b/browser-support.md @@ -0,0 +1,5 @@ +# Browser support + +nightTab as an extension supports Chrome and Firefox. Testing and development is only conducted on these browsers. + +Opera [does not support extensions](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/chrome_url_overrides) to change the new tab page so can not be supported in this project. diff --git a/clearing-cookies-and-cache.md b/clearing-cookies-and-cache.md new file mode 100644 index 0000000..f2117d8 --- /dev/null +++ b/clearing-cookies-and-cache.md @@ -0,0 +1,7 @@ +# Clearing cookies and cache + +No user data is sent anywhere, no remote database or central user management. All your data is saved to your browser. + +This means if you clear your browser cache or cookies nightTab will reset to its default state. + +[Extensions or apps which clear your cache or cookies](https://github.com/zombieFox/nightTab/issues/209#issue-669174744) when closing the browsers will also force nightTab to reset to its default state. diff --git a/image/icon/settings.svg b/image/icon/settings.svg new file mode 100644 index 0000000..9c1b2c3 --- /dev/null +++ b/image/icon/settings.svg @@ -0,0 +1 @@ + diff --git a/local-background-image-upload-is-no-longer-supported.md b/local-background-image-upload-is-no-longer-supported.md new file mode 100644 index 0000000..d806cd5 --- /dev/null +++ b/local-background-image-upload-is-no-longer-supported.md @@ -0,0 +1,15 @@ +# Local background image upload is no longer supported + +_This change was made in nightTab 7.0.0_ + +Allowing a user to upload local images has its benefits but also many drawbacks and issues. + +As a rule, nightTab does not store any user data on a remote database. As such any image file uploaded to use as background has to be stored on the client side in local storage (in the browser cache). This [storage has a limit](https://github.com/zombieFox/nightTab/issues/93#issuecomment-679922767) (which varies between browsers) of about 5MB. + +Images can very easily exceed 5MB in size. Which is a problem when the same storage is used to save user settings: the layout, bookmarks and theme settings. When this happens the browser throws an error and nightTab can’t function as expected. + +[Other issues with image file support](https://github.com/zombieFox/nightTab/issues/69#issuecomment-522295606) continue to appear. Some images just fail to load. + +For the reasons above the local image background controls have been dropped from the feature set. + +nightTab still supports linking to image files via a URL. Just paste one or more URLs into the Theme Background input to change the background image. This method is the most reliable and uses the least amount of storage space. diff --git a/nighttab-respects-your-privacy.md b/nighttab-respects-your-privacy.md new file mode 100644 index 0000000..c16afd6 --- /dev/null +++ b/nighttab-respects-your-privacy.md @@ -0,0 +1,3 @@ +# nightTab respects your privacy + +This project runs completely on the client side, in the browser. No user data is sent anywhere, no remote database or central user management. diff --git a/restore-nighttab-setup.md b/restore-nighttab-setup.md new file mode 100644 index 0000000..f71805c --- /dev/null +++ b/restore-nighttab-setup.md @@ -0,0 +1,15 @@ +# Restore nightTab setup + +You can restore a nightTab backup [JSON](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Objects/JSON#no_really_what_is_json) file by going to ![Settings](image/icon/settings.svg) `Menu` > `Data` > `Restore` > `Import Data`. + +From her find and select a previously exported backup JSON file on your device. + +Next you will have the option to restore the `Bookmarks`, `Theme` or `Settings` from the backup JSON file. + +Selecting `Bookmarks` will import the user added bookmarks which will keep any custom Colours, Accents and Borders each may have. + +Selecting `Theme` will import the user added Colour, Accent, Fonts, Background and any saved Custom Themes. + +Selecting `Settings` will import the Layout size and position, Header area size, Bookmark area size and other user settings. + +After select which parts of the backup JSON file to restore click, `Import` to complete process.