diff --git a/src/.vuepress/config.js b/src/.vuepress/config.js index 9d1d591f..8355cf27 100644 --- a/src/.vuepress/config.js +++ b/src/.vuepress/config.js @@ -8,16 +8,22 @@ module.exports = { docsDir: 'src', editLinks: true, nav: [ - { text: 'Guide', link: '/guide/' }, - { text: 'FAQ', link: '/faq/' }, + { text: 'Guide', link: '/help/guide/' }, + { text: 'FAQ', link: '/help/faq/' }, { text: 'Extensions', link: '/extensions/' }, { text: 'Wiki', link: 'https://github.com/inorichi/tachiyomi/wiki' }, - { text: 'Discord', link: 'https://discord.gg/tachiyomi' } + { text: 'Discord', link: 'https://discord.gg/tachiyomi' }, + { text: 'Reddit', link: 'https://reddit.com/r/Tachiyomi' } ], sidebar: [ '/', - '/guide/', - '/faq/', + '/help/guide/', + { + title: 'FAQ', + path: '/help/faq/', + collapsable: false, + children: ['/help/faq/application/', '/help/faq/extensions/'] + }, '/extensions/' ], lastUpdated: 'Last Updated' diff --git a/src/.vuepress/public/assets/media/openinwebview.jpg b/src/.vuepress/public/assets/media/openinwebview.jpg new file mode 100644 index 00000000..d20c747b Binary files /dev/null and b/src/.vuepress/public/assets/media/openinwebview.jpg differ diff --git a/src/README.md b/src/README.md index 1c59533b..0d3e8b7a 100644 --- a/src/README.md +++ b/src/README.md @@ -3,7 +3,7 @@ home: true lang: en-US heroImage: /assets/media/hero.png actionText: Get Started → -actionLink: /guide/ +actionLink: /help/guide/ features: - title: Extensions details: Online reading from sources such as KissManga, MangaDex and more. diff --git a/src/faq/README.md b/src/faq/README.md deleted file mode 100644 index abc4f249..00000000 --- a/src/faq/README.md +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: FAQ -lang: en-US -sidebarDepth: 2 ---- - -# FAQ - -You can find more frequently asked questions -[here](https://github.com/inorichi/tachiyomi/wiki/FAQ#frequently-asked-questions). - -## App questions - -### What are some good extensions? - -The most popular are MangaDex, MangaRock and MangaSee, these are large -sites which host content from scanlators, there's also extensions like -Genkan, Madara, FoolSlide and ComiCake which contain sources which -host directly from the scanlators own websites. - -[Here](https://docs.google.com/spreadsheets/d/1TyJEUg78WWH4zgnf3g6M2lkbWpBWbd40FYiPVQhW8IU/edit#gid=0) -is a good spreadsheet showing the different extensions and their sources. - -### How do I allow third-party installations? - -When installing your first extension and are prompted that your phone -isn't allowed to install unknown apps from that source, simply press -the `Settings` button and then allow it. - -Two example videos, left one is for newer Androids. - -
- - -
- -### Why won't the extensions install? - -In some cases your phone might have some issues downloading the -extensions, in those cases you can try installing them yourselves -directly from the source. [Here](https://github.com/inorichi/tachiyomi-extensions/tree/repo/apk) -is the repository for the files. - -To install just download the `.apk` file for the extension you want -and then install it, like how you installed Tachiyomi. - -### Does Tachiyomi have 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. - -### 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. - -### How do I change the app language? - -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`. - -::: 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). -::: - -If you want to help translate Tachiyomi, read [this](https://github.com/inorichi/tachiyomi/wiki/Translation). - -
- - - -
- -## MangaDex - -### No results when searching - -::: tip -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. - -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. - -### Chapters from Mangaplus are broken - -Install the Mangaplus extension and then migrate the manga that -uses Mangaplus on Mangadex onto the Mangaplus source. - -## MangaRock - -### Slow updates to Tachiyomi - -MangaRock's API updates less frequently than the app or the website, -so you may need to wait a couple hours or more before it shows up -in Tachiyomi. - -## Madara - -### Leviatan Scans is missing - -Leviatan Scans has shifted from Madara to Genkan extension. - -Install Genkan. Migrate all Leviatan scans. Update Madara. diff --git a/src/help/faq/README.md b/src/help/faq/README.md new file mode 100644 index 00000000..1d887506 --- /dev/null +++ b/src/help/faq/README.md @@ -0,0 +1,14 @@ +--- +title: FAQ +lang: en-US +sidebarDepth: 2 +--- + +# FAQ + +Here you can find the frequently asked questions. + +They are separated by the categories listed below. + +- [Application](/help/faq/application/) +- [Extensions](/help/faq/extensions/) diff --git a/src/help/faq/application/README.md b/src/help/faq/application/README.md new file mode 100644 index 00000000..ff1eb1cf --- /dev/null +++ b/src/help/faq/application/README.md @@ -0,0 +1,115 @@ +--- +title: Application +lang: en-US +sidebarDepth: 2 +--- + +## Library + +### 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. + +### 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`. + +## 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. + +## 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. + +### 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. + +### Can you make it possible to store manga on both internal storage and external SD-card? + +At the moment, no. You could try using symlinks (requires root). + +## Tracking + +### How do I log in with Kitsu? + +To log in with Kitsu you need to use your Email address as your username. + +### I can't find manga in MAL's search results + +You can search a manga from your MAL list like this: `my: `. +[#65](https://github.com/inorichi/tachiyomi/issues/65) + +## Local 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. + +### 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. + +## 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. + +## User Interface + +### How do I change the app language? + +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`. + +::: 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). +::: + +If you want to help translate Tachiyomi, read [this](https://github.com/inorichi/tachiyomi/wiki/Translation). + +
+ + + +
+ +## Miscellaneous + +### iOS Version + +Is there an iOS version? No. Is there going to be? There are no plans for +one since iOS and Android apps are nothing alike. + +### I lost everything, what now? + +Tachiyomi is still in beta. Some design changes or unexpected errors may +lead to data loss. While I try for them not to happen, sometimes it is +unavoidable. To avoid this in the future, you can use the automatic +backup feature in Settings. If your file manager supports it, you may +even backup to Google Drive. diff --git a/src/help/faq/extensions/README.md b/src/help/faq/extensions/README.md new file mode 100644 index 00000000..9e00ac3d --- /dev/null +++ b/src/help/faq/extensions/README.md @@ -0,0 +1,300 @@ +--- +title: Extensions +lang: en-US +sidebarDepth: 2 +--- + +## General + +### What are some good extensions? + +The most popular are MangaDex, MangaRock and MangaSee, these are large +sites which host content from scanlators, there's also extensions like +Genkan, Madara, FoolSlide and ComiCake which contain sources which +host directly from the scanlators own websites. + +[Here](https://docs.google.com/spreadsheets/d/1TyJEUg78WWH4zgnf3g6M2lkbWpBWbd40FYiPVQhW8IU/edit#gid=0) +is a good spreadsheet showing the different extensions and their sources. + +### Why won't the extensions install? + +In some cases your phone might have some issues downloading the +extensions, in those cases you can try installing them yourselves +directly from the source. [Here](https://github.com/inorichi/tachiyomi-extensions/tree/repo/apk) +is the repository for the files. + +To install just download the `.apk` file for the extension you want +and then install it, like how you installed Tachiyomi. + +### How do I allow third-party installations? + +When installing your first extension and are prompted that your phone +isn't allowed to install unknown apps from that source, simply press +the `Settings` button and then allow it. + +Two example videos, left one is for newer Androids. + +
+ + +
+ +### How do I uninstall an extension? + +Extensions for Tachiyomi are technically installed the same as normal apps. +Either you uninstall them through the place you normally uninstall apps or +you go to the `Extensions` tab, enter the extension you wish to uninstall +then press `Uninstall`. + +### Why don't I have extensions or any sources in the catalog? + +**A:** Tachiyomi `0.8.4` and above no longer have pre-installed extensions, +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. + +::: tip +1. Batoto +2. Mangahere +3. Mangafox +4. Kissmanga +5. Readmanga +6. Mintmanga +7. Mangachan +8. ReadMangaToday +9. Mangasee +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. + +
+ +
+ +### Wich 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. + +::: tip +1. Comicake + - Whim Scans + - Champion Scans + - LetItGo Scans +2. Foolslide + - Jamini’s Box + - Helvetica Scans + - Sense-Scans + - Kirei Cake + - Silent Sky + - Mangatellers + - Iskultrip Scans + - Anata no Motokare + - Death Toll Scans + - DKThias Scanlations + - World Three + - Doki Fansubs + - Yuri-ism + - Ajia no Scantrad + - One Time Scans + - Tsubasa Society + - MangaScouts + - Storm in Heaven + - Lilyreader + - Midnight Haven + - Russification/Русификация + - Evil Flowers + - AkaiYuhiMun team + - LupiTeam + - HentaiCafe + - ShoujoSense + - The Cat Scans + - ShojouHearts +3. Genkan + - Leviatan Scans + - Psycho Play + - One Shot Scans + - KaguyaDex + - Komi Scans + - Hunlight Scans +4. Madara + - Mangasushi + - NinjaScans + - ReadManhua + - ZeroScans + - IsekaiScans + - Happy Tea Scans + - Just For Fun + - Agent of Change Translations + - Kanjiku + - KomikGo + - Luxy Scans + - Tritinia Scans + - Tsubaki No Scan + - Yokai Jump + - ZManga + - Mangazuki.me + - Mangazuki.online + - Mangazuki.club + - 1st Kiss + - Mangalike + - Manga SY + - Manhwa Club + - WuxiaWorld + - Yo Manga + - ManyToon + - Chibi Manga +5. My Manga Reader CMS + - مانجا اون لاين + - Read Comics Online + - Biamam Scans + - Fallen Angels + - Hatigarm Scans + - Mangawww Reader + - ZXComic + - White Cloud Pavilion + - MangaTreat Scans + - SOS Scanltaion + - Scan FR + - Scan VF + - Komikid + - ToraScans + - Comic Space + - Mangas Yuri + - Dracaena + - Nikushima + - Anigai Clan + - MangaHanta + - Fallen Angel Scans + - LeoManga + - Mangadoor + - Mangas.pw + - HentaiShark +6. MangaCards + - Valhalla Scans + - NANI? Scans +::: + +### Error: java.lang Exception: Challenge not found + +Try closing (force-quit) and reopening Tachiyomi. + +## MangaDex + +### No results when searching + +::: tip +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. + +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. + +### 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. + +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. + +## MangaRock + +### 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)). +- Popular alternatives: Mangasee, Kissmanga, MangaDex, Mangakakalot, Toonily. + +### Migrate to Tachiyomi + +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 + +### Leviatan Scans is missing + +Leviatan Scans has shifted from Madara to Genkan extension. + +Install Genkan. Migrate all Leviatan scans. Update Madara. + +## KissManga + +### 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.). diff --git a/src/guide/README.md b/src/help/guide/README.md similarity index 96% rename from src/guide/README.md rename to src/help/guide/README.md index 9fc3afa5..cb858588 100644 --- a/src/guide/README.md +++ b/src/help/guide/README.md @@ -31,7 +31,7 @@ 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?"](/faq/#how-do-i-allow-third-party-installations). +on my phone?"](/help/faq/extensions/#how-do-i-allow-third-party-installations).