Merge pull request #22 from tachiyomiorg/faq-enhance

Enhanced FAQ
This commit is contained in:
Soitora 2019-09-20 05:14:53 +02:00 committed by GitHub
commit f1d41c5308
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 151 additions and 140 deletions

View File

@ -19,11 +19,19 @@ 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',
children: ['/help/faq/application', '/help/faq/extensions']
children: [
'/help/faq/application',
'/help/faq/extensions'
]
},
'/extensions/'
],

View File

@ -8,36 +8,27 @@ sidebarDepth: 2
### How can I see how many chapters I've downloaded?
If you want to see how many chapters you have downloaded for all manga on
My Library, enable `Download Badges`. It's under the `Filter` options in
`My Library` (the upside-down pyramid of lines beside the three-dot) at
the very bottom. Red is downloaded chapter count and Blue is unread
chapter count.
If you want to see how many chapters you have downloaded for all manga on My Library, enable `Download Badges`. It's under the `Filter` options in `My Library` (the upside-down pyramid of lines beside the three-dot) at the very bottom. Red is downloaded chapter count and Blue is unread chapter count.
### Some covers are white after restoring from backup
The URL to the cover has changed. To fix this, refresh the metadata of
your library in `Settings > Advanced`.
The URL to the cover has changed. To fix this, refresh the metadata of your library in `Settings > Advanced`.
## Reader
### Why are some images not displayed?
Aside from network issues, it could be because the images are too big
or the decoder doesn't support that image.
Aside from network issues, it could be because the images are too big or the decoder doesn't support that image.
## Downloads
### What happened to the simultaneous downloads feature?
It was removed in version `0.7.0` to prevent IP bans caused by too many
requests. We know that speed is being sacrificed but it's better than
not being able to access a source at all.
It was removed in version `0.7.0` to prevent IP bans caused by too many requests. We know that speed is being sacrificed but it's better than not being able to access a source at all.
### Downloads are unstable
Be aware that it could be a network issue on your device or on the
catalog you are trying to download from.
Be aware that it could be a network issue on your device or on the catalog you are trying to download from.
### Can you make it possible to store manga on both internal storage and external SD-card?
@ -58,21 +49,18 @@ You can search a manga from your MAL list like this: `my: <manga>`.
### How do I import my Manga into Tachiyomi?
We recommend you to read [this](https://github.com/inorichi/tachiyomi/wiki/Local-manga)
guide on how to do so.
We recommend you to read [this](https://github.com/inorichi/tachiyomi/wiki/Local-manga) guide on how to do so.
### I can't find the Tachiyomi folder
If you don't see a Tachiyomi folder on your device, try downloading a chapter
of any Manga or creating a backup so that the folder can be created.
If you don't see a Tachiyomi folder on your device, try downloading a chapter of any Manga or creating a backup so that the folder can be created.
## Application Updates
### How do I enable automatic updates?
The Tachiyomi app now has in-app updating for both stable and dev versions.
If you go to `Settings > About > Version` to check for updates, you can
force an update there or wait for the app to notify you.
If you go to `Settings > About > Version` to check for updates, you can force an update there or wait for the app to notify you.
## User Interface
@ -82,22 +70,13 @@ Tachiyomi is (as of writing) available in 35 different languages.
By default, the app language follows the language setting of your device.
You can also set your own preferred language for Tachiyomi. Simply
from side panel go to the `Settings > General > Language`.
You can also set your own preferred language for Tachiyomi. Simply from side panel go to the `Settings > General > Language`.
::: tip NOTE
Only the UI has been localized, content will still be using
the language of the source selected (i.e. English for KissManga
source, Some sources have multiple Language too).
Only the UI has been localized, content will still be using the language of the source selected (i.e. English for KissManga source, Some sources have multiple Language too).
:::
If you want to help translate Tachiyomi, read [this](https://github.com/inorichi/tachiyomi/wiki/Translation).
<figure>
<a href="https://hosted.weblate.org/engage/tachiyomi/?utm_source=widget" target="_blank">
<img src="https://hosted.weblate.org/widgets/tachiyomi/-/multi-auto.svg">
</a>
</figure>
If you want to help translate Tachiyomi, read our [guide](../guides/translation.md) on it.
## Miscellaneous

View File

@ -65,10 +65,11 @@ so when upgrading or installing versions above this, installing the extensions
you use will be required to install extensions from the extensions menu
(the one with the puzzle piece).
**B:** If you're getting a "Loader not implemented" error after clicking on
a manga, you will need to reinstall the extensions you used to use. Which
number in the menu corresponds to which is below. Be aware that Batoto is
deprecated so you will need to migrate from that source to others.
**B:** If you're getting a "Loader not implemented" error after clicking on a manga, you will need to reinstall the extensions you used to use. Which number in the menu corresponds to which is below.
::: warning
Be aware that Batoto is deprecated so you will need to migrate from that source to others.
:::
::: expander <strong>Click to expand!</strong>
::: tip
@ -84,52 +85,9 @@ 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.
<figure class="centered">
<img :src="$withBase('/assets/media/openinwebview.jpg')">
</figure>
### Which sources are there in the multi-source extensions?
Some extensions contain multiple sources, look at the list below to find
out which extension to install for the specific source that you want.
Some extensions contain multiple sources, look at the list below to find out which extension to install for the specific source that you want.
::: expander <strong>Click to expand!</strong>
::: tip
@ -243,47 +201,40 @@ Try closing (force-quit) and reopening Tachiyomi.
Make sure you're on app version `0.8.4` or higher.
:::
If you're not getting any results when searching MangaDex then
you need to log in.
If you're not getting any results when searching MangaDex then you need to log in.
To do so, go to `Browse`/`Latest` for MangaDex under `Catalogues`, open
any manga from the list and then press the overflow menu (3 dot menu)
in the top-right corner and then the `Open in web view` button.
To do so, go to `Browse`/`Latest` for MangaDex under `Catalogues`, open any manga from the list and then press the overflow menu (3 dot menu) in the top-right corner and then the `Open in web view` button.
Now go to the hamburger menu, press the `Manga` drop-down and then
choose either `Sign up` or `Log in` to proceed with the log in.
Now go to the hamburger menu, press the `Manga` drop-down and then choose either `Sign up` or `Log in` to proceed with the log in.
### Alternate searching method
In `Mangadex 1.2.52` and newer the extension allows you to search using
the id number to find manga. To get the id number look at the URL of
the manga you want to add.
In `Mangadex 1.2.52` and newer the extension allows you to search using the id number to find manga. To get the id number look at the URL of the manga you want to add.
An example search: `id:31477`.
### Chapters from Mangaplus are broken
Install the Mangaplus extension and then migrate the manga that
uses Mangaplus on Mangadex onto the Mangaplus source.
Install the Mangaplus extension and then migrate the manga that uses Mangaplus on Mangadex onto the Mangaplus source.
## MangaRock
### Regarding MangaRock going away:
#### Regarding MangaRock going away:
- You won't lose existing bookmarks or downloads.
- Chapters will no longer be updated once MangaRock is dead.
- There is no native way to automatically import your favorites from
MangaRock (although you can try [waicool20/mr2tachiyomi](https://github.com/waicool20/mr2tachiyomi)).
- There is no native way to automatically import your favorites from MangaRock (although you can try [waicool20/mr2tachiyomi](https://github.com/waicool20/mr2tachiyomi)).
- Popular alternatives: Mangasee, Kissmanga, MangaDex, Mangakakalot, Toonily.
### Migrate to Tachiyomi
::: tip
Read more about the situation [here](https://mrcomics.com/).
:::
There is a tool to migrate from MangaRock to Tachiyomi courtesy of a member
of our Discord server by the same name as the creator, but a computer is
required to finish the migration successfully.
#### Migrate to Tachiyomi
Note that you must download the 64-bit version of Java or it will run
out of memory. Access the program at [waicool20/mr2tachiyomi](https://github.com/waicool20/mr2tachiyomi).
There is a tool to migrate from MangaRock to Tachiyomi courtesy of a member of our Discord server by the same name as the creator, but a computer is required to finish the migration successfully.
Note that you must download the 64-bit version of Java or it will run out of memory. Access the program at [waicool20/mr2tachiyomi](https://github.com/waicool20/mr2tachiyomi).
## Madara
@ -297,6 +248,4 @@ Install Genkan. Migrate all Leviatan scans. Update Madara.
### Error: Page list is empty
If you get this error then you need to solve the captcha on their website
using your browser (*Google Chrome*, *Samsung Browser*, *Firefox*, *Opera*,
etc.).
If you get this error then you need to solve the captcha on their website using your browser (*Google Chrome*, *Samsung Browser*, *Firefox*, *Opera*, etc.).

View File

@ -1,8 +1,10 @@
---
title: Getting Started
title: Getting started
lang: en-US
---
# Getting started
## Installation
[![github](https://img.shields.io/github/release/inorichi/tachiyomi.svg?style=for-the-badge&maxAge=600)](https://github.com/inorichi/tachiyomi/releases/latest) [![github downloads](https://img.shields.io/github/downloads/inorichi/tachiyomi/total.svg?style=for-the-badge&maxAge=600)](http://www.somsubhra.com/github-release-stats/?username=inorichi&repository=tachiyomi)
@ -12,8 +14,7 @@ You can download the latest version of `Tachiyomi` from the [GitHub releases](ht
<Badge text="tachiyomi-vX.Y.Z.apk"/>
If you want to try new features before they get to the stable release,
you can download the dev version [here](http://tachiyomi.kanade.eu/latest).
If you want to try new features before they get to the stable release, you can download the dev version [here](http://tachiyomi.kanade.eu/latest).
Open and install the `.apk` file you just downloaded from GitHub.
@ -24,16 +25,12 @@ Open and install the `.apk` file you just downloaded from GitHub.
## Installing an extension
Now that Tachiyomi is installed, open the app and navigate to the
`Extensions` tab.
Now that Tachiyomi is installed, open the app and navigate to the `Extensions` tab.
In this guide we will use MangaDex, our most popular extension.
Press the `Install` button and accept the installation prompt that
will be shown.
Press the `Install` button and accept the installation prompt that will be shown.
If you're getting stopped by a security prompt and don't know what to do
you can read this FAQ section: ["How do I allow third-party installations
on my phone?"](/help/faq/extensions/#how-do-i-allow-third-party-installations).
If you're getting stopped by a security prompt and don't know what to do you can read this FAQ section: ["How do I allow third-party installations?"](/help/faq/extensions/#how-do-i-allow-third-party-installations).
<figure class="centered">
<video autoplay crossorigin="use-credentials" height="534"
@ -47,15 +44,11 @@ on my phone?"](/help/faq/extensions/#how-do-i-allow-third-party-installations).
## Adding manga to your library
Now that you've installed the MangaDex extension it should show up in
the `Catalogues` tab. The items appearing here are called `Sources`
(can also be called Catalogues), an extension can contains multiple sources.
Now that you've installed the MangaDex extension it should show up in the `Catalogues` tab. The items appearing here are called `Sources` (can also be called Catalogues), an extension can contains multiple sources.
To find and add manga, you can now either use the `Latest` button on your
source, or you can use `Browse` and search for it.
To find and add manga, you can now either use the `Latest` button on your source, or you can use `Browse` and search for it.
Now that you've found manga that you want to add to your library, click
on it and then press the blue bookmark button.
Now that you've found manga that you want to add to your library, click on it and then press the blue bookmark button.
It should now appear in your `My Library` tab, ready to be read!

View File

@ -5,30 +5,26 @@ lang: en-US
# Reading local manga
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).
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
chapters later you'll have to manually refresh the chapter list
(by pulling down the list).
After that, they will be shown in the catalogue as a new source.
Supported chapter formats are directories with pictures inside, ZIP/CBZ,
RAR/CBR and EPUB. But expect better performance with directories and ZIP/CBZ.
::: warning IMPORTANT
Remember to give the app disk permissions on Android 6 and newer.
:::
You can also place your chapters or manga in both storages and Tachiyomi
will merge them. For example, with
If you add more chapters then you'll have to manually refresh the chapter list (by pulling down the list).
`/sdcard/Tachiyomi/local/my manga/ch1`
Supported chapter formats are directories with pictures inside, `ZIP`/`CBZ`, `RAR`/`CBR` and `EPUB`. But expect better performance with directories and `ZIP`/`CBZ`.
and
You can also place your chapters or manga in both storages and Tachiyomi will merge them.
`/storage/18F5-2C11/Tachiyomi/local/my manga/ch2`
**Example:**
- `/sdcard/Tachiyomi/local/my manga/ch1`
- `/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).
The path to the folder (or archive) with images must contain both the manga title and the chapter name (as seen above).
You can then access the manga in `Catalogues > Local manga`.

View File

@ -0,0 +1,66 @@
---
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.
### Solving a captcha <Badge text="0.8.4 +"/>
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.
::: tip
If webview doesn't work for you, please update the `Android System WebView` app through [Play Store](https://play.google.com/store/apps/details?id=com.google.android.webview), then go to [Developer Options](https://developer.android.com/studio/debug/dev-options) in your phone's settings and set WebView Implementation to Android System WebView.
:::
<figure class="centered">
<img :src="$withBase('/assets/media/openinwebview.jpg')">
</figure>

View File

@ -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)
***
[![Translation status](https://hosted.weblate.org/widgets/tachiyomi/-/multi-auto.svg)](https://hosted.weblate.org/engage/tachiyomi/?utm_source=widget)