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

Enhanced FAQ

Browse Source 
Fixed capitalization for "Getting started", added "Translation" and "Source problems", fixed stuff in "Reading local manga".

This branch has a link which is dependant on #21.
This commit is contained in:
Simon Mattila 2019-09-19 18:15:34 +02:00
parent 7cdf69f6af
commit 8b4e4a5291
6 changed files with 129 additions and 55 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/.vuepress/config.js
View File

@ -19,7 +19,7 @@ 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',

86
src/help/faq/extensions.md
View File

@ -84,48 +84,6 @@ 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
@ -231,6 +189,50 @@ out which extension to install for the specific source that you want.
- NANI? Scans - 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.
<figure class="centered">
<img :src="$withBase('/assets/media/openinwebview.jpg')">
</figure>
### Error: java.lang Exception: Challenge not found ### Error: java.lang Exception: Challenge not found
Try closing (force-quit) and reopening Tachiyomi. Try closing (force-quit) and reopening Tachiyomi.

4
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)

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

@ -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` the root of your internal storage or external SD card, usually `/sdcard`
and `/storage/18F5-2C11` (with different values). 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
::: 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 chapters later you'll have to manually refresh the chapter list
(by pulling down the 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 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 Tachiyomi will see two chapters in a single manga.
`/storage/18F5-2C11/Tachiyomi/local/my manga/ch2`
the app 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).

47
src/help/guides/source-problems.md Normal file
View File

@ -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.

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)