add support pages
parent
77cf81c876
commit
fc60c8a6d2
|
@ -0,0 +1 @@
|
||||||
|
.DS_Store
|
|
@ -1,7 +1,9 @@
|
||||||
|
# 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).
|
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
|
1. Open nightTab
|
||||||
2. Open the developer tools
|
2. Open the developer tools
|
||||||
3. Go to the console ([Finding your browser's developer console](https://balsamiq.com/support/faqs/browserconsole/))
|
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
|
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
|
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`.
|
||||||
|
|
|
@ -1,3 +1,5 @@
|
||||||
|
# Setting nightTab as your Firefox homepage
|
||||||
|
|
||||||
Firefox does not allow addons to replace the "homepage". However there is a workaround:
|
Firefox does not allow addons to replace the "homepage". However there is a workaround:
|
||||||
|
|
||||||
- Open a new Firefox window
|
- Open a new Firefox window
|
||||||
|
|
|
@ -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.
|
|
@ -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.
|
|
@ -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.
|
|
@ -0,0 +1 @@
|
||||||
|
<svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 24 24" width="24" height="24" fill="currentColor"><path d="M12 15.516c1.922 0 3.516-1.594 3.516-3.516s-1.594-3.516-3.516-3.516-3.516 1.594-3.516 3.516 1.594 3.516 3.516 3.516zM19.453 12.984l2.109 1.641c0.188 0.141 0.234 0.422 0.094 0.656l-2.016 3.469c-0.141 0.234-0.375 0.281-0.609 0.188l-2.484-0.984c-0.516 0.375-1.078 0.75-1.688 0.984l-0.375 2.625c-0.047 0.234-0.234 0.422-0.469 0.422h-4.031c-0.234 0-0.422-0.188-0.469-0.422l-0.375-2.625c-0.609-0.234-1.172-0.563-1.688-0.984l-2.484 0.984c-0.234 0.094-0.469 0.047-0.609-0.188l-2.016-3.469c-0.141-0.234-0.094-0.516 0.094-0.656l2.109-1.641c-0.047-0.328-0.047-0.656-0.047-0.984s0-0.656 0.047-0.984l-2.109-1.641c-0.188-0.141-0.234-0.422-0.094-0.656l2.016-3.469c0.141-0.234 0.375-0.281 0.609-0.188l2.484 0.984c0.516-0.375 1.078-0.75 1.688-0.984l0.375-2.625c0.047-0.234 0.234-0.422 0.469-0.422h4.031c0.234 0 0.422 0.188 0.469 0.422l0.375 2.625c0.609 0.234 1.172 0.563 1.688 0.984l2.484-0.984c0.234-0.094 0.469-0.047 0.609 0.188l2.016 3.469c0.141 0.234 0.094 0.516-0.094 0.656l-2.109 1.641c0.047 0.328 0.047 0.656 0.047 0.984s0 0.656-0.047 0.984z"></path></svg>
|
After Width: | Height: | Size: 1.1 KiB |
|
@ -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.
|
|
@ -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.
|
|
@ -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.
|
Loading…
Reference in New Issue