Skip to content
This repository has been archived by the owner on Jan 15, 2024. It is now read-only.

Commit

Permalink
Make use of new Navigation component (#152)
Browse files Browse the repository at this point in the history
Make use of new Navigation component (#152)
  • Loading branch information
Soitora authored Apr 30, 2020
1 parent 3f8f722 commit c49576f
Show file tree
Hide file tree
Showing 11 changed files with 78 additions and 64 deletions.
15 changes: 13 additions & 2 deletions src/.vuepress/components/Navigation.vue
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<template>
<span v-if="nav.link" class="app-navigation" title="App navigation">
<a class="app-link" :href="nav.link">
<a class="app-link" :href="nav.link + entry">
<MaterialIcon v-if="nav.icon" class="app-icon" :iconName="nav.icon" />
<span class="app-label">{{ nav.text }}</span>
<slot />
Expand All @@ -23,6 +23,10 @@ export default {
type: String,
required: true,
},
entry: {
type: String,
default: "",
},
},
computed: {
nav() {
Expand All @@ -43,7 +47,7 @@ export default {
extensions: { text: "Extensions", icon: "extension" },
download_queue: { text: "Download queue", icon: "get_app" },
source_migration: { text: "Source migration", icon: "compare_arrows" },
settings: { text: "Settings", icon: "settings" },
settings: { text: "Settings", icon: "settings", link: "/help/guides/settings/" },
about: { text: "About", icon: "info" },
help: { text: "Help", icon: "help" },
/* Settings */
Expand All @@ -64,6 +68,13 @@ export default {
/* Sources */
latest: { text: "LATEST" },
browse: { text: "BROWSE" },
/* Legacy */
old_library: { text: "My library", icon: "class" },
old_about: { text: "About", icon: "help", link: "/help/guides/settings/about" },
old_catalogues: { text: "Catalogues", icon: "explore" },
old_overflow: { text: "Overflow menu", icon: "more_vert" },
old_backup: { text: "Backup", icon: "cloud_upload", link: "/help/guides/settings/backup" },
old_extensions: { text: "Extensions", icon: "extension" },
}[this.item];
},
},
Expand Down
38 changes: 19 additions & 19 deletions src/help/faq/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,17 +11,17 @@ sidebarDepth: 2
### Library

#### How can I see how many chapters I've downloaded?
This can be done by enabling **Download badges** under **<MaterialIcon icon-name="class"/> My library**.
This can be done by enabling **Download badges** under <Navigation item="old_library"/>.

::: guide
Enable it by going to **<MaterialIcon icon-name="class"/> My library****<MaterialIcon icon-name="filter_list"/> Filter****Display** section then checking the **Download badges** option in the bottom.
Enable it by going to <Navigation item="old_library"/> → <Navigation item="filter"/> → **Display** section then checking the **Download badges** option in the bottom.
:::

#### Some covers are white after restoring from backup
The URL to the cover has probably changed. To fix this, refresh the metadata of your library.

::: guide
Refresh your metadata by going to **[<MaterialIcon icon-name="settings"/> Settings](/help/guides/settings/)****[<MaterialIcon icon-name="code"/> Advanced](/help/guides/settings/advanced)** then pressing **[Refresh library metadata](/help/guides/settings/advanced/#refresh-library-metadata)**.
Refresh your metadata by going to <Navigation item="settings"/> → <Navigation item="settings_advanced"/> then pressing **[Refresh library metadata](/help/guides/settings/advanced/#refresh-library-metadata)**.
::: aside
Read more [here](/help/guides/settings/advanced/#refresh-library-metadata)
:::
Expand All @@ -30,7 +30,7 @@ Read more [here](/help/guides/settings/advanced/#refresh-library-metadata)
Every now and then you find a manga that is translated by more than one group, because of this you get multiple releases for every chapter in the manga. To fix this the easiest way is to change sorting to **Total chapters**. You won't see any changes but, when you start reading you'll automatically skip the duplicate releases.

::: guide
Change library sorting by going to **<MaterialIcon icon-name="class"/> My library****<MaterialIcon icon-name="filter_list"/> Filter****Sort** section then in this case selecting **Total chapters**.
Change library sorting by going to <Navigation item="old_library"/> → <Navigation item="filter"/> → **Sort** section then in this case selecting **Total chapters**.
:::

#### Why do I see `attempt to invoke virtual method 'com.hippo.unifile...`?
Expand Down Expand Up @@ -83,7 +83,7 @@ If you don't see a **Tachiyomi** folder on your device, try downloading a chapte
#### How do I enable automatic updates?
The **Tachiyomi** app now has in-app updating for both stable and preview versions. It happens automatically in the background if you got **[Check for updates](/help/guides/settings/about/#check-for-updates)** enabled.
::: guide
If you go to **[<MaterialIcon icon-name="settings"/> Settings](/help/guides/settings/)****[<MaterialIcon icon-name="help"/> About](/help/guides/settings/about)** you will find the **[Check for updates](/help/guides/settings/about/#check-for-updates)** toggle, you can also press **[Version](/help/guides/settings/about/#version)** to force check for updates.
If you go to <Navigation item="settings"/> → <Navigation item="old_about"/> you will find the **[Check for updates](/help/guides/settings/about/#check-for-updates)** toggle, you can also press **[Version](/help/guides/settings/about/#version)** to force check for updates.
:::

### User Interface
Expand All @@ -92,7 +92,7 @@ If you go to **[<MaterialIcon icon-name="settings"/> Settings](/help/guides/sett
Only the UI has been localized, language in manga will still be using the language of the source selected.

::: guide
You can change language by going to **[<MaterialIcon icon-name="settings"/> Settings](/help/guides/settings/)****[<MaterialIcon icon-name="tune"/> General](/help/guides/settings/general)** then pressing **[Language](/help/guides/settings/general/#language)**.
You can change language by going to <Navigation item="settings"/> → <Navigation item="settings_general"/> then pressing **[Language](/help/guides/settings/general/#language)**.
::: aside
Read more [here](/help/guides/settings/general/#language)
:::
Expand Down Expand Up @@ -188,11 +188,11 @@ If you need more help regarding this, read [this](https://www.theandroidsoul.com
Extensions for **Tachiyomi** are technically installed the same as normal apps. Either you uninstall them through the app section on your phones settings or you go can do it in the app.

::: guide
To uninstall an extension from within **Tachiyomi**, go to **<MaterialIcon icon-name="extension"/> Extensions** then tap **Uninstall** on the extension you want to remove.
To uninstall an extension from within **Tachiyomi**, go to <Navigation item="old_extensions"/> then tap **Uninstall** on the extension you want to remove.
:::

#### Why don't I have extensions or any sources in the catalogue?
- **Tachiyomi** no longer have pre-installed extensions, this means that you will need to install extensions you want to use from the **<MaterialIcon icon-name="extension"/> Extensions** menu.
- **Tachiyomi** no longer have pre-installed extensions, this means that you will need to install extensions you want to use from the <Navigation item="old_extensions"/> menu.
- If you're getting the `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.

::: expander <strong>Click to expand!</strong>
Expand All @@ -215,10 +215,10 @@ Read more about Batoto shutting down [here](https://goboiano.com/manga-scanlatio
:::

#### Why are my extensions not showing up in Catalogues?
If you've freshly reinstalled the **Tachiyomi** app, the installed extensions might not show up in **<MaterialIcon icon-name="explore"/> Catalogues** until you enable them.
If you've freshly reinstalled the **Tachiyomi** app, the installed extensions might not show up in <Navigation item="old_catalogues"/> until you enable them.

::: guide GUIDE
To fix this, go to **<MaterialIcon icon-name="explore"/> Catalogues****[<MaterialIcon icon-name="settings"/> Sources](/help/guides/catalogues/#sources)**. Now you can proceed to enabling your desired sources.
To fix this, go to <Navigation item="old_catalogues"/> **Sources**. Now you can proceed to enabling your desired sources.
:::

#### Why can't I restore my backup?
Expand All @@ -229,8 +229,8 @@ To restore backups, **Tachiyomi** requires to have extensions installed for the
It might be because the title is worded differently. Follow any of the steps below:
- Look up the title on a search engine like **Google** or a manga tracking service such as [AniList](https://anilist.co/home).
- See which site has the series, often a single site will not satisfy all your needs.
- Download the extension for that source from **<MaterialIcon icon-name="extension"/> Extensions** if it exists, read [this](/help/faq/#which-sources-are-in-the-multi-source-extensions) for a list of which extensions contains what sources.
- Go to **<MaterialIcon icon-name="explore"/> Catalogues****[Browse](/help/guides/catalogues/#browse)** on a source then search for the manga again.
- Download the extension for that source from <Navigation item="old_extensions"/> if it exists, read [this](/help/faq/#which-sources-are-in-the-multi-source-extensions) for a list of which extensions contains what sources.
- Go to <Navigation item="old_catalogues"/> → <Navigation item="browse"/> on a source then search for the manga again.


#### Some common errors you might encounter
Expand All @@ -248,18 +248,18 @@ This means that the manga has been licensed and can no longer be read on that so
The source you selected may have Cloudflare protection on and is enforcing CAPTCHAs.

1. Find a manga in your library that is from the source you're trying to access
1. Tap on the overflow menu in the Info tab (3 dots)
1. Open in Webview
1. Complete the CAPTCHA if present and wait for the page to finish loading
1. Press back rather than exiting the app and if that does not work, use the back arrow
2. Tap on the <Navigation item="old_overflow"/> in the **Info** tab
3. Open in WebView
4. Complete the CAPTCHA if present and wait for the page to finish loading
5. Press back rather than exiting the app and if that does not work, use the back arrow

### MangaDex

#### No results when searching
If you're not getting any results when searching MangaDex then you need to log in. To do so enter the **WebView** for **MangaDex** then press the **Manga** drop-down and choose either **Sign up** or **Log in** to proceed with the log in.

::: guide
To enter the **WebView** go to **<MaterialIcon icon-name="explore"/> Catalogues****[Browse](/help/guides/catalogues/#browse)**/**[Latest](/help/guides/catalogues/#latest)** next to **MangaDex**, open any manga from the list and then press the **<MaterialIcon icon-name="more_vert"/> Overflow menu** in the top-right corner and then press **Open in web view**.
To enter the **WebView** go to <Navigation item="old_catalogues"/> → <Navigation item="browse"/>/<Navigation item="latest"/> next to **MangaDex**, open any manga from the list and then press the <Navigation item="old_overflow"/> in the top-right corner and then press **Open in web view**.
:::

::: expander <strong>Click to reveal video guide!</strong>
Expand Down Expand Up @@ -313,14 +313,14 @@ It's not currently possible to restore backup from MangaRock officially, as the

1. Uninstall the MangaRock extension.
1. Install the [DummyRock](/assets/misc/tachiyomi-en.dummyrock-v1.2.1-debug.apk) file.
1. Go to **<MaterialIcon icon-name="extension"/> Extensions** menu and press **Trust** to proceed.
1. Go to <Navigation item="old_extensions"/> menu and press **Trust** to proceed.
1. Restore backup.

#### Why do I get `Value url at 0 of type java.lang.String cannot be converted to JSONObject`?
If you get this error when opening **MangaRock** chapters, try clearing your chapter cache.

::: guide
Chapter cache can be cleared by going to **[<MaterialIcon icon-name="settings"/> Settings](/help/guides/settings/)****[<MaterialIcon icon-name="code"/> Advanced](/help/guides/settings/advanced)** then pressing [Clear chapter cache](/help/guides/settings/advanced/#clear-chapter-cache).
Chapter cache can be cleared by going to <Navigation item="settings"/> → <Navigation item="settings_advanced"/> then pressing [Clear chapter cache](/help/guides/settings/advanced/#clear-chapter-cache).
::: aside
Read more about clearing chapter cache [here](/help/guides/settings/advanced/#clear-chapter-cache)
:::
Expand Down
12 changes: 6 additions & 6 deletions src/help/guides/categories.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@ lang: en-US

# Categories

`Categories` can store your bookmarks in custom made categories, which keeps your library neat and organized. You can name and sort them however you want according to your preference (ie. Genre, Reading Status etc).
**Categories** can store your bookmarks in custom made categories, which keeps your library neat and organized. You can name and sort them however you want according to your preference (ie. Genre, Reading Status etc).

## Create a Category

To make a category, go to `My Library`, then click on the triple dots (``) on the top right, then click `Edit categories` and then press the button with a plus sign (`+`).
To make a category, go to <Navigation item="old_library"/>, then click on the <Navigation item="old_overflow"/> on the top right, then click **Edit categories** and then press the button with a plus sign **(`+`)**.

::: expander <strong>Click to reveal video guide!</strong>
<figure class="centered">
Expand All @@ -21,7 +21,7 @@ To make a category, go to `My Library`, then click on the triple dots (`⋮`) on

## Edit a Category

You can edit a Category in `My Library` > triple dots (``) > `Edit categories` then long press the category you want to edit, then press the pencil icon.
You can edit a Category in <Navigation item="old_library"/> → <Navigation item="old_overflow"/> → **Edit categories** then long press the category you want to edit, then press the pencil icon.

::: expander <strong>Click to reveal video guide!</strong>
<figure class="centered">
Expand All @@ -33,9 +33,9 @@ You can edit a Category in `My Library` > triple dots (`⋮`) > `Edit categories

## Change Category order

You can change the order of Categories, such as bringing a certain Category to the top. This category will appear as the first tab on `My Library`.
You can change the order of Categories, such as bringing a certain Category to the top. This category will appear as the first tab on <Navigation item="old_library"/>.

To do this, go to `My Library` > triple dots (``) > `Edit categories` then drag the triple bar icon (``) up or down.
To do this, go to <Navigation item="old_library"/> → <Navigation item="old_overflow"/> → **Edit categories** then drag the triple bar icon **(``)** up or down.

::: expander <strong>Click to reveal video guide!</strong>
<figure class="centered">
Expand All @@ -47,7 +47,7 @@ To do this, go to `My Library` > triple dots (`⋮`) > `Edit categories` then dr

## Delete a Category

You can delete a Category in `My Library` > triple dots (``) > `Edit categories` then long press the category you want to delete, and press the trash can icon (<MaterialIcon icon-name="delete"/>).
You can delete a Category in <Navigation item="old_library"/> → <Navigation item="old_overflow"/> → **Edit categories** then long press the category you want to delete, and press the trash can icon (<MaterialIcon icon-name="delete"/>).

::: expander <strong>Click to reveal video guide!</strong>
<figure class="centered">
Expand Down
12 changes: 6 additions & 6 deletions src/help/guides/creating-backups.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,11 +16,11 @@ Backups can hold the following information:

## Restoring

Restoring is done from the [<MaterialIcon icon-name="cloud_upload"/> Backup](/help/guides/settings/backup) settings. To restore without issues be sure to:
Restoring is done from the <Navigation item="old_backup"/> settings. To restore without issues be sure to:

* Install all the <MaterialIcon icon-name="extension"/> Extensions that were installed at the time of the backup.
* Log into the [<MaterialIcon icon-name="autorenew"/> Tracking](/help/guides/settings/tracking) services that you use.
* Log into **MangaDex** using **Webview** [as explained here](/help/faq/#no-results-when-searching).
* Install all the <Navigation item="extensions"/> Extensions that were installed at the time of the backup.
* Log into the <Navigation item="settings_tracking"/> services that you use.
* Log into **MangaDex** using **WebView** [as explained here](/help/faq/#no-results-when-searching).
* You're able to access all the sources through the **WebView**.
* Be on a consistent internet connection.

Expand All @@ -29,15 +29,15 @@ Restoring is done from the [<MaterialIcon icon-name="cloud_upload"/> Backup](/he
You can transfer downloaded manga chapters from one version of **Tachiyomi** to another.

::: guide
You can do this by going to **[<MaterialIcon icon-name="settings"/> Settings](/help/guides/settings/)**[<MaterialIcon icon-name="get_app"/> Downloads](/help/guides/settings/downloads) and then set the download directory to that of the download folder of your old **Tachiyomi**, then restore the backup.
You can do this by going to <Navigation item="settings"/> → <Navigation item="settings_downloads"/> and then set the download directory to that of the download folder of your old **Tachiyomi**, then restore the backup.
:::

## Turning on auto-backups

It is highly recommended you turn on auto backups, this will ensure you can recover if need be.

::: guide
You can do this by going to **[<MaterialIcon icon-name="settings"/> Settings](/help/guides/settings/)**[<MaterialIcon icon-name="cloud_upload"/> Backup](/help/guides/settings/backup) and then setting a [backup frequency](/help/guides/settings/backup/#backup-frequency). In the case of a catastrophic failure, at least you will be able to recover.
You can do this by going to <Navigation item="settings"/> → <Navigation item="old_backup"/> and then setting a [backup frequency](/help/guides/settings/backup/#backup-frequency). In the case of a catastrophic failure, at least you will be able to recover.
:::

## Forks information
Expand Down
12 changes: 6 additions & 6 deletions src/help/guides/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ You can download the latest version of **Tachiyomi** from any of the above butto

If you want to try new features before they get to the stable release, you can download the preview version.

Open and install the `.apk` file you just downloaded.
Open and install the **`.apk`** file you just downloaded.

<figure class="centered">
<img height="128"
Expand All @@ -22,10 +22,10 @@ Open and install the `.apk` file you just downloaded.

## 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 <Navigation item="old_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?"](/help/faq/#how-do-i-allow-third-party-installations).

Expand All @@ -39,13 +39,13 @@ If you're getting stopped by a security prompt and don't know what to do you can

## 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 <Navigation item="old_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 <Navigation item="latest"/> button on your source, or you can use <Navigation item="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.

It should now appear in your `My Library` tab, ready to be read!
It should now appear in your <Navigation item="old_library"/> tab, ready to be read!

::: expander <strong>Click to reveal video guide!</strong>
<figure class="centered">
Expand Down
Loading

0 comments on commit c49576f

Please sign in to comment.