Mirrors/tachiyomi-website
2
0
Fork 0
mirror of https://github.com/tachiyomiorg/website.git synced 2024-12-21 07:31:58 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #22 from tachiyomiorg/faq-enhance

Browse Source 
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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
src/.vuepress/config.js
View File

@ -19,11 +19,19 @@ module.exports = {
'/', '/',
{ {
title: 'Guides', 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', title: 'FAQ',
children: ['/help/faq/application', '/help/faq/extensions'] children: [
'/help/faq/application',
'/help/faq/extensions'
]
}, },
'/extensions/' '/extensions/'
], ],

43
src/help/faq/application.md
View File

@ -8,36 +8,27 @@ sidebarDepth: 2
### How can I see how many chapters I've downloaded? ### 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 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.
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 ### Some covers are white after restoring from backup
The URL to the cover has changed. To fix this, refresh the metadata of The URL to the cover has changed. To fix this, refresh the metadata of your library in `Settings > Advanced`.
your library in `Settings > Advanced`.
## Reader ## Reader
### Why are some images not displayed? ### Why are some images not displayed?
Aside from network issues, it could be because the images are too big Aside from network issues, it could be because the images are too big or the decoder doesn't support that image.
or the decoder doesn't support that image.
## Downloads ## Downloads
### What happened to the simultaneous downloads feature? ### What happened to the simultaneous downloads feature?
It was removed in version `0.7.0` to prevent IP bans caused by too many 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.
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 ### Downloads are unstable
Be aware that it could be a network issue on your device or on the Be aware that it could be a network issue on your device or on the catalog you are trying to download from.
catalog you are trying to download from.
### Can you make it possible to store manga on both internal storage and external SD-card? ### 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? ### How do I import my Manga into Tachiyomi?
We recommend you to read [this](https://github.com/inorichi/tachiyomi/wiki/Local-manga) We recommend you to read [this](https://github.com/inorichi/tachiyomi/wiki/Local-manga) guide on how to do so.
guide on how to do so.
### I can't find the Tachiyomi folder ### I can't find the Tachiyomi folder
If you don't see a Tachiyomi folder on your device, try downloading a chapter 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.
of any Manga or creating a backup so that the folder can be created.
## Application Updates ## Application Updates
### How do I enable automatic updates? ### How do I enable automatic updates?
The Tachiyomi app now has in-app updating for both stable and dev versions. 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 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.
force an update there or wait for the app to notify you.
## User Interface ## 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. By default, the app language follows the language setting of your device.
You can also set your own preferred language for Tachiyomi. Simply You can also set your own preferred language for Tachiyomi. Simply from side panel go to the `Settings > General > Language`.
from side panel go to the `Settings > General > Language`.
::: tip NOTE ::: tip NOTE
Only the UI has been localized, content will still be using 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).
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). If you want to help translate Tachiyomi, read our [guide](../guides/translation.md) on it.
<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>
## Miscellaneous ## Miscellaneous

93
src/help/faq/extensions.md
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 you use will be required to install extensions from the extensions menu
(the one with the puzzle piece). (the one with the puzzle piece).
**B:** If you're getting a "Loader not implemented" error after clicking on **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.
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 ::: warning
deprecated so you will need to migrate from that source to others. Be aware that Batoto is deprecated so you will need to migrate from that source to others.
:::
::: expander <strong>Click to expand!</strong> ::: expander <strong>Click to expand!</strong>
::: tip ::: tip
@ -84,52 +85,9 @@ deprecated so you will need to migrate from that source to others.
10. WieManga 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? ### Which sources are there in the multi-source extensions?
Some extensions contain multiple sources, look at the list below to find Some extensions contain multiple sources, look at the list below to find out which extension to install for the specific source that you want.
out which extension to install for the specific source that you want.
::: expander <strong>Click to expand!</strong> ::: expander <strong>Click to expand!</strong>
::: tip ::: tip
@ -243,47 +201,40 @@ Try closing (force-quit) and reopening Tachiyomi.
Make sure you're on app version `0.8.4` or higher. Make sure you're on app version `0.8.4` or higher.
::: :::
If you're not getting any results when searching MangaDex then If you're not getting any results when searching MangaDex then you need to log in.
you need to log in.
To do so, go to `Browse`/`Latest` for MangaDex under `Catalogues`, open 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.
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 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.
choose either `Sign up` or `Log in` to proceed with the log in.
### Alternate searching method ### Alternate searching method
In `Mangadex 1.2.52` and newer the extension allows you to search using 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.
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`. An example search: `id:31477`.
### Chapters from Mangaplus are broken ### Chapters from Mangaplus are broken
Install the Mangaplus extension and then migrate the manga that Install the Mangaplus extension and then migrate the manga that uses Mangaplus on Mangadex onto the Mangaplus source.
uses Mangaplus on Mangadex onto the Mangaplus source.
## MangaRock ## MangaRock
### Regarding MangaRock going away: #### Regarding MangaRock going away:
- You won't lose existing bookmarks or downloads. - You won't lose existing bookmarks or downloads.
- Chapters will no longer be updated once MangaRock is dead. - Chapters will no longer be updated once MangaRock is dead.
- There is no native way to automatically import your favorites from - There is no native way to automatically import your favorites from MangaRock (although you can try [waicool20/mr2tachiyomi](https://github.com/waicool20/mr2tachiyomi)).
MangaRock (although you can try [waicool20/mr2tachiyomi](https://github.com/waicool20/mr2tachiyomi)).
- Popular alternatives: Mangasee, Kissmanga, MangaDex, Mangakakalot, Toonily. - 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 #### Migrate to Tachiyomi
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 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.
out of memory. Access the program at [waicool20/mr2tachiyomi](https://github.com/waicool20/mr2tachiyomi).
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 ## Madara
@ -297,6 +248,4 @@ Install Genkan. Migrate all Leviatan scans. Update Madara.
### Error: Page list is empty ### Error: Page list is empty
If you get this error then you need to solve the captcha on their website 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.).
using your browser (*Google Chrome*, *Samsung Browser*, *Firefox*, *Opera*,
etc.).

27
src/help/guides/getting-started.md
View File

@ -1,8 +1,10 @@
--- ---
title: Getting Started title: Getting started
lang: en-US lang: en-US
--- ---
# Getting started
## Installation ## 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) [![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"/> <Badge text="tachiyomi-vX.Y.Z.apk"/>
If you want to try new features before they get to the stable release, 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).
you can download the dev version [here](http://tachiyomi.kanade.eu/latest).
Open and install the `.apk` file you just downloaded from GitHub. 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 ## Installing an extension
Now that Tachiyomi is installed, open the app and navigate to the Now that Tachiyomi is installed, open the app and navigate to the `Extensions` tab.
`Extensions` tab.
In this guide we will use MangaDex, our most popular extension. In this guide we will use MangaDex, our most popular extension.
Press the `Install` button and accept the installation prompt that Press the `Install` button and accept the installation prompt that will be shown.
will be shown.
If you're getting stopped by a security prompt and don't know what to do 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).
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).
<figure class="centered"> <figure class="centered">
<video autoplay crossorigin="use-credentials" height="534" <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 ## Adding manga to your library
Now that you've installed the MangaDex extension it should show up in 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.
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 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.
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 Now that you've found manga that you want to add to your library, click on it and then press the blue bookmark button.
on it and then press the blue bookmark button.
It should now appear in your `My Library` tab, ready to be read! It should now appear in your `My Library` tab, ready to be read!

30
src/help/guides/reading-local-manga.md
View File

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

66
src/help/guides/source-problems.md Normal file
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>

20
src/help/guides/translation.md Normal file
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)