diff --git a/src/.vuepress/config.js b/src/.vuepress/config.js
index 9f9d6c5c..5e903420 100644
--- a/src/.vuepress/config.js
+++ b/src/.vuepress/config.js
@@ -19,7 +19,7 @@ module.exports = {
'/',
{
title: 'Guides',
- children: ['/help/guides/getting-started', '/help/guides/reading-local-manga']
+ children: ['/help/guides/getting-started', '/help/guides/reading-local-manga', '/help/guides/source-problems', '/help/guides/translation']
},
{
title: 'FAQ',
diff --git a/src/help/faq/extensions.md b/src/help/faq/extensions.md
index e0295f27..0d72d289 100644
--- a/src/help/faq/extensions.md
+++ b/src/help/faq/extensions.md
@@ -84,48 +84,6 @@ deprecated so you will need to migrate from that source to others.
10. WieManga
:::
-## Source problems
-
-Create your issue or see if it's already been listed
-[**here**](https://github.com/inorichi/tachiyomi-extensions/issues).
-
-### Why am I getting a 503 in (this source)?
-
-This may be on account that the source you selected has Cloudflare protection
-on, so you will need to do a captcha through webview (Not your browser).
-To do this, you will need to find a manga in your library that is from
-the source you're trying to access, tap on the overflow menu in the Info
-tab (3 dots), open in Webview, and do the captcha there (wait for the page
-to finish loading). Be sure to press back rather than exit the app and if
-that does not work, use the back arrow.
-
-### Cloudflare captcha
-
-Please note that webview is not the same as using your browser.
-Webview is a new feature introduced in stable version `0.8.4` to allow
-for log-in only features and solving captcha.
-
-You can find the web view option by opening a manga, then tapping the 3
-dots in the top right while in the `Info` tab. If you have no existing
-manga from the source, go to `Catalogues`, press `Browse` beside the
-source, and open a manga, following the above instructions.
-
-Once you are in webview, you will see a webpage and a bar on top with
-an arrow at the left side, pointing to the left edge of your screen.
-If there is no captcha on the webpage, initiate one by tapping a manga
-title, if possible. Once a captcha is shown, solve it. After that, use
-the aforementioned back arrow on the bar at the top of your screen to
-go back to your manga. Please do not use the back button on your phone
-as it does not work as expected.
-
-If webview doesn't work for you, please update the Android System WebView
-app through Play Store, then go to `Developer Options` in your phone's
-settings and set WebView Implementation to Android System WebView.
-
-
-
-
-
### Which sources are there in the multi-source extensions?
Some extensions contain multiple sources, look at the list below to find
@@ -231,6 +189,50 @@ out which extension to install for the specific source that you want.
- NANI? Scans
:::
+## Source problems
+
+Create your issue or see if it's already been listed
+[**here**](https://github.com/inorichi/tachiyomi-extensions/issues).
+
+You can read more about source problems in [our guide](../guides/source-problems.md).
+
+### Why am I getting a 503 in (this source)?
+
+This may be on account that the source you selected has Cloudflare protection
+on, so you will need to do a captcha through webview (Not your browser).
+To do this, you will need to find a manga in your library that is from
+the source you're trying to access, tap on the overflow menu in the Info
+tab (3 dots), open in Webview, and do the captcha there (wait for the page
+to finish loading). Be sure to press back rather than exit the app and if
+that does not work, use the back arrow.
+
+### Cloudflare captcha
+
+Please note that webview is not the same as using your browser.
+Webview is a new feature introduced in stable version `0.8.4` to allow
+for log-in only features and solving captcha.
+
+You can find the web view option by opening a manga, then tapping the 3
+dots in the top right while in the `Info` tab. If you have no existing
+manga from the source, go to `Catalogues`, press `Browse` beside the
+source, and open a manga, following the above instructions.
+
+Once you are in webview, you will see a webpage and a bar on top with
+an arrow at the left side, pointing to the left edge of your screen.
+If there is no captcha on the webpage, initiate one by tapping a manga
+title, if possible. Once a captcha is shown, solve it. After that, use
+the aforementioned back arrow on the bar at the top of your screen to
+go back to your manga. Please do not use the back button on your phone
+as it does not work as expected.
+
+If webview doesn't work for you, please update the Android System WebView
+app through Play Store, then go to `Developer Options` in your phone's
+settings and set WebView Implementation to Android System WebView.
+
+
+
+
+
### Error: java.lang Exception: Challenge not found
Try closing (force-quit) and reopening Tachiyomi.
diff --git a/src/help/guides/getting-started.md b/src/help/guides/getting-started.md
index cfb607a7..a39c6817 100644
--- a/src/help/guides/getting-started.md
+++ b/src/help/guides/getting-started.md
@@ -1,8 +1,10 @@
---
-title: Getting Started
+title: Getting started
lang: en-US
---
+# Getting started
+
## Installation
[](https://github.com/inorichi/tachiyomi/releases/latest) [](http://www.somsubhra.com/github-release-stats/?username=inorichi&repository=tachiyomi)
diff --git a/src/help/guides/reading-local-manga.md b/src/help/guides/reading-local-manga.md
index 149fae98..c8987a41 100644
--- a/src/help/guides/reading-local-manga.md
+++ b/src/help/guides/reading-local-manga.md
@@ -9,24 +9,27 @@ You have to place your manga inside the folder `Tachiyomi/local` located in
the root of your internal storage or external SD card, usually `/sdcard`
and `/storage/18F5-2C11` (with different values).
-After that, they will be shown in the catalogue as a new source. **Remember to
-give the app disk permissions on Android 6.0 and higher**. If you add more
+After that, they will be shown in the catalogue as a new source.
+
+::: warning IMPORTANT
+Remember to give the app disk permissions on Android 6 and newer.
+:::
+
+If you add more
chapters later you'll have to manually refresh the chapter list
(by pulling down the list).
-Supported chapter formats are directories with pictures inside, ZIP/CBZ,
-RAR/CBR and EPUB. But expect better performance with directories and ZIP/CBZ.
+
+
+Supported chapter formats are directories with pictures inside, `ZIP`/`CBZ`,
+`RAR`/`CBR` and `EPUB`. But expect better performance with directories and `ZIP`/`CBZ`.
You can also place your chapters or manga in both storages and Tachiyomi
-will merge them. For example, with
+will merge them. For example, with:
-`/sdcard/Tachiyomi/local/my manga/ch1`
+`/sdcard/Tachiyomi/local/my manga/ch1` and `/storage/18F5-2C11/Tachiyomi/local/my manga/ch2`
-and
-
-`/storage/18F5-2C11/Tachiyomi/local/my manga/ch2`
-
-the app will see two chapters in a single manga.
+Tachiyomi will see two chapters in a single manga.
The path to the folder (or archive) with images must contain both the
manga title and the chapter name (as seen above).
diff --git a/src/help/guides/source-problems.md b/src/help/guides/source-problems.md
new file mode 100644
index 00000000..9a757467
--- /dev/null
+++ b/src/help/guides/source-problems.md
@@ -0,0 +1,47 @@
+---
+title: Source problems
+lang: en-US
+---
+
+# Source problems
+
+**This page is for when you encounter a problem with a source (built-in or extension).**
+
+::: danger It can be accompanied by these error messages:
++ HTTP Error 5xx
+- HTTP Error 4xx
++ java.security.cert.CertPathValidatorException
+- Page List is empty
++ Unable to resolve host
+- unexpected url
++ Attempt to invoke virtual method 'java.lang.String org.jsoup.nodes.Node.attr(java.lang.String)' on a null object reference
+:::
+
+## Diagnosis
+1. Try opening the manga in webview. If there is CAPTCHA, solve it and see if it helped.
+1. Change your internet connection (switch to WiFi, mobile data or a VPN, use a "What's my IP" site to confirm your ip has changed), then try again.
+1. Ask other users to try the action that gives you the error.
+
+::: tip Bonus step
+Try the latest dev version, your issue may have been fixed. Also check versions of your extensions.
+:::
+
+If any of these help go to [it only happens to me](#it-only-happens-to-me).
+If it's not just you, go to [everyone is having this problem](#everyone-is-having-this-problem).
+
+### It only happens to me
+You may be getting a CAPTCHA, may have been IP-banned, or some other counter-measure that website owners deploy against programs like Tachiyomi. If that is the case, there is probably nothing that can be done about that. Some of them (like CAPTCHA) have to be manually solved, some are temporary (IP bans).
+
+**Workarounds that can lower chance of it happening again:**
+* Don't use downloads with the source.
+* Have less manga in library from the source.
+
+::: tip
+All of the above are very imprecise and fuzzy rules, because each site has their own, non-public limits and triggers.
+:::
+
+### Everyone is having this problem
+In this case it is a problem with the site.
+1. Have a look at [open](https://github.com/inorichi/tachiyomi/issues) issues.
+1. It may have been fixed already, but not released yet, so look at [closed](https://github.com/inorichi/tachiyomi/issues?q=is%3Aissue+is%3Aclosed) issues as well.
+1. If you can't find the issue there, you can open a new one.
diff --git a/src/help/guides/translation.md b/src/help/guides/translation.md
new file mode 100644
index 00000000..4f0e75d7
--- /dev/null
+++ b/src/help/guides/translation.md
@@ -0,0 +1,20 @@
+---
+title: Translation
+lang: en-US
+---
+
+# Translation
+
+## Weblate
+
+**The project is available at [https://hosted.weblate.org/engage/tachiyomi/](https://hosted.weblate.org/engage/tachiyomi/)**
+(direct [https://hosted.weblate.org/projects/tachiyomi/strings/](https://hosted.weblate.org/projects/tachiyomi/strings/))
+
+The translators guide can be found at [https://docs.weblate.org/en/latest/user/index.html](https://docs.weblate.org/en/latest/user/index.html). Notice also:
+* [https://docs.weblate.org/en/latest/user/profile.html#secondary-languages](https://docs.weblate.org/en/latest/user/profile.html#secondary-languages)
+* [https://docs.weblate.org/en/latest/user/profile.html#subscriptions](https://docs.weblate.org/en/latest/user/profile.html#subscriptions)
+* [https://docs.weblate.org/en/latest/user/translating.html#glossary](https://docs.weblate.org/en/latest/user/translating.html#glossary)
+
+***
+
+[](https://hosted.weblate.org/engage/tachiyomi/?utm_source=widget)