From 0ed2a2071fe5b7610d4e4122096129857359b651 Mon Sep 17 00:00:00 2001 From: David Luevano Alvarado Date: Sun, 11 Jun 2023 04:34:59 -0600 Subject: update manga server entry --- src/blog/a/manga_server_with_komga.md | 91 +++++++++++++++++++++++++---------- 1 file changed, 65 insertions(+), 26 deletions(-) (limited to 'src') diff --git a/src/blog/a/manga_server_with_komga.md b/src/blog/a/manga_server_with_komga.md index fb5feac..257e0d7 100644 --- a/src/blog/a/manga_server_with_komga.md +++ b/src/blog/a/manga_server_with_komga.md @@ -75,7 +75,7 @@ This `komga` package creates a `komga` (service) user and group which is tied to Configure it by editing `/etc/komga.conf`: -```conf +```sh SERVER_PORT=8989 SERVER_SERVLET_CONTEXT_PATH=/ # this depends a lot of how it's going to be served (domain, subdomain, ip, etc) @@ -94,12 +94,12 @@ KOMGA_DATABASE_BACKUP_SCHEDULE="0 0 */8 * * ?" My changes (shown above): - Port on `8989` because `8080` its too generic. -- `cron` schedules +- `cron` schedules. - It's not actually `cron` but rather a `cron`-like syntax used by [Spring](https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/scheduling/support/CronSequenceGenerator.html) as stated in the [Komga config](https://komga.org/installation/configuration.html#optional-configuration). - Added the remember me key. - For more check out [Komga: Configuration options](https://komga.org/installation/configuration.html). -If you're going to run it locally (or LAN/VPN) you can start the `komga.service` and access it via IP at `http://:(/base_url)` as stated at [Komga: Accessing the web interface](https://komga.org/installation/webui.html), else continue with the next steps for the reverse proxy and certificate. +If you're going to run it locally (or LAN/VPN) you can start the `komga.service` and access it via IP at `http://:(/base_url)` as stated at [Komga: Accessing the web interface](https://komga.org/installation/webui.html), then you can continue with the [mangal](#mangal) section, else continue with the next steps for the reverse proxy and certificate. ## Reverse proxy @@ -124,7 +124,7 @@ server { } ``` -If it's going to be used as a subdir on another domain then just change the `location` (with `/subdir` instead of `/`) directive to the corresponding `.conf` file; be careful with the `proxy_pass` directive, it has to match what you configured at `/etc/komga.conf` for the `SERVER_SERVLET_CONTEXT_PATH` regardless of the `/subdir` you selected at `location`. +If it's going to be used as a subdir on another domain then just change the `location` with `/subdir` instead of `/`; be careful with the `proxy_pass` directive, it has to match what you configured at `/etc/komga.conf` for the `SERVER_SERVLET_CONTEXT_PATH` regardless of the `/subdir` you selected at `location`. ## SSL certificate @@ -222,7 +222,7 @@ So instad of installing with `yay` we'll build it from source. We need to have ` pacman -S go ``` -Then clone my fork of `mangal` and build/install it: +Then clone my fork of `mangal` and `build`/`install` it: ```sh git clone https://github.com/luevano/mangal.git # not sure if you can use SSH to clone @@ -230,7 +230,7 @@ cd mangal make install # or just `make build` and then move the binary to somewhere in your $PATH ``` -This will use `go install` so it will install to a path specified by your environment variables, for more run `go help install`. It was installed to `$HOME/.local/bin/go/mangal` for me, then just make sure this is included in your PATH. +This will use `go install` so it will install to a path specified by the `go` environment variables, for more run `go help install`. It was installed to `$HOME/.local/bin/go/mangal` for me because my env vars, then just make sure this is included in your `PATH`. Check it was correctly installed by running `mangal version`, which should print something like: @@ -275,12 +275,12 @@ And install whatever you want, it picks up the sources/scrapers from the configu Two main ways of using `mangal`: -- TUI: for initial browsing/downloading and testing things out. If the manga finished publishing, this should be enough. -- inline: for automation on manga that is still publishing and I need to check/download every once in a while. +- **TUI**: for initial browsing/downloading and testing things out. If the manga finished publishing, this should be enough. +- **inline**: for automation on manga that is still publishing and I need to check/download every once in a while. ### Headless browser -Before continuing, I gotta say I went through some bullshit while trying to use the custom Lua scrapers that use the *headless* browser (actually just a wrapper of [go-rod/rod](https://github.com/go-rod/rod), and honestly it is not really a "headless" browser, `mangal` "documentation" is just wrong). For mor on my rant check out my last [entry](https://blog.luevano.xyz/a/learned_go_and_lua_hard_way.html). +Before continuing, I gotta say I went through some bullshit while trying to use the custom Lua scrapers that use the *headless* browser (actually just a wrapper of [go-rod/rod](https://github.com/go-rod/rod), and honestly it is not really a "headless" browser, `mangal` "documentation" is just wrong). For more on my rant check out my last [entry](https://blog.luevano.xyz/a/learned_go_and_lua_hard_way.html). There is no concrete documentation on the "headless" browser, only that it is automatically set up and ready to use... but it doesn't install any library/dependency needed. I discovered the following libraries that were missing on my Arch minimal install: @@ -317,7 +317,7 @@ mangal Download manga using the TUI by selecting the source/scrapper, search the manga/comic you want and then you can select each chapter to download (use `tab` to select all). This is what I use when downloading manga that already finished publishing, or when I'm just searching and testing out how it downloads the manga (directory name, and manga information). -Note that some scrapters will contain duplicated chapters, as they have uploaded chapters from the community. This happens a lot with [MangaDex](https://mangadex.org/). +Note that some scrapters will contain duplicated chapters, as they have multiple uploaded chapters from the community, usually for different *scanlation groups*. This happens a lot with [MangaDex](https://mangadex.org/). ### Inline @@ -327,7 +327,7 @@ The inline mode is a single terminal command meant to be used to automate stuff mangal inline --manga