add Blog with entries

2024-11-10 06:54:21 +00:00 · 2024-09-12 15:05:52 +01:00 · 2024-09-12 15:05:52 +01:00 · 5cd1173607
commit 5cd1173607
parent a2189dc989
8 changed files with 214 additions and 3 deletions
--- a/docs/blog/.authors.yml
+++ b/docs/blog/.authors.yml
@ -0,0 +1,17 @@
+authors:
+  yozora:
+    name: Yozora
+    description: Moderator
+    avatar: https://avatars.githubusercontent.com/u/96386153?v=4
+  sohjiro:
+    name: Sohjiro
+    description: Founder
+    avatar: https://avatars.githubusercontent.com/u/1631064?v=4
+  chaz:
+    name: Chaz Larson
+    description: Moderator
+    avatar: https://avatars.githubusercontent.com/u/3865541?v=4
+  bullmoose:
+    name: Bullmoose
+    description: Moderator
+    avatar: https://avatars.githubusercontent.com/u/12549033?v=4
--- a/docs/blog/images/RT-Aud-Direct.png
+++ b/docs/blog/images/RT-Aud-Direct.png
--- a/docs/blog/images/RT-Crit-Direct.png
+++ b/docs/blog/images/RT-Crit-Direct.png
--- a/docs/blog/images/mascot-welcome.png
+++ b/docs/blog/images/mascot-welcome.png
--- a/docs/blog/index.md
+++ b/docs/blog/index.md
@ -0,0 +1,2 @@
+# Latest Kometa News
+This is our home for all kometa-related news stories, ranging from showcasing our community creations to providing you with important updates.
--- a/docs/blog/posts/apply-ratings-without-operations.md
+++ b/docs/blog/posts/apply-ratings-without-operations.md
@ -0,0 +1,155 @@
+---
+title: "Apply Ratings Overlays without using Operations"
+date:
+    created: 2024-09-12
+authors:
+    - yozora
+    - chaz
+categories:
+    - Announcements
+    - Defaults
+    - Overlays
+---
+
+![Ratings GIF](https://mir-s3-cdn-cf.behance.net/project_modules/hd/8bfb74111957539.600b408feb79c.gif){ align=right itemprop="image" }
+
+**Say goodbye to using Operations to update your ratings, and say hello to quicker rating overlays!**
+
+We've been hard at work in the background trying to simplify the process for applying ratings to posters, and we're ready to introduce a feature we call "Direct Ratings".
+
+Direct Ratings allows Kometa to fetch the ratings from the source (such as IMDb, TMDb, Rotten Tomatoes via MDBList, etc.) during the Overlay process, completely bypassing the need to use Mass Rating Update operations to fetch and apply the ratings into the three Plex ratings slots.
+
+We are hoping that this new process will help to reduce your runtimes and allow you to get right to the good stuff.
+
+<!-- more -->
+
+
+## What's Changed?
+
+In previous versions of Kometa, you had three slots in Plex (user, critic, audience) which you could use as placeholders for the ratings that you wanted to show as Overlays. For example, you could use the `Mass Audience Rating Update` to place the Metacritic rating into the Audience slot, and then use that data to feed your overlays so that the Audience rating is associated with the Metacritic image.
+
+This was a tedious process that limited the user to having 3 ratings shown on their poster, and required operations to run and check for any rating updates prior to the Overlay application process.
+
+Our new system bypasses this process by completely detaching the ratings applied on Overlays from the slots within Plex. You no longer need to use Operations, you can simply tell Kometa to fetch the rating you want and apply it as an overlay.
+
+### How does it work?
+
+Below is an example of the old and new system of using the `- default: ratings` file to apply the TMDb, IMDb and Rotten Tomatoes Audience score to a library:
+
+=== "Previous Process"
+
+    ```yaml
+    libraries:
+      Movies:
+        operations:
+          mass_user_rating_update: tmdb
+          mass_audience_rating_update: imdb
+          mass_critic_rating_update: mdb_tomatoesaudience
+        overlay_files:
+          - default: ratings
+            template_variables:
+              rating1: user
+              rating1_image: tmdb
+              rating2: audience
+              rating2_image: imdb
+              rating3: critic
+              rating3_image: rt_popcorn
+    ```
+
+=== "New Process"
+
+    ```yaml
+    libraries:
+      Movies:
+        overlay_files:
+          - default: ratings
+            template_variables:
+              rating1: tmdb
+              rating2: imdb
+              rating3: mdb_tomatoesaudience
+    ```
+
+As you can see from the new process, the operations have completely disappeared from the process. Additionally, you no longer have to specify what image you want to use; Kometa will automatically select the most appropriate image to use based on your rating source, for example using the IMDb logo if your rating source is `imdb`
+
+### Can I still use the old method?
+
+Absolutely, this is not a breaking change and if you want to continue to use the Mass Rating Update operations method then you can continue to do so, we have no plans to retire the old method.
+
+If you do want to switch to the new method, there are some drawbacks that we want to be upfront about:
+
+- The new process will only work for Movies and Shows, it does not work at the Season or Episode level. You can still use the new method for Shows and Movies, but you will have to continue using the old method for any Season and Episode-level rating overlays.
+- Due to the way that the ratings are now pulled down, the default file can no longer show the "Fresh" or "Rotten" image for Rotten Tomatoes based upon the score that a particular movie/show has, this is because the ratings is pulled down too late in the overlay process for us to be able to add logic to check what the number is.
+    - To combat this, we've created new images for Rotten Tomatoes Audience and Critic ratings which you can see here:
+
+    ![RT-Aud-Direct.png](../images/RT-Aud-Direct.png) ![RT-Crit-Direct.png](../images/RT-Crit-Direct.png)
+
+### Can I use the system for my own overlays?
+
+Absolutely, this update is not specific to the ratings Default file, it can be used on any rating overlay.
+
+A full list of the available Ratings Text can be found [here](../../files/overlays.md#special-rating-text)
+
+An added benefit is that you are no longer limited to 3 ratings, as you can see here I have added 5 ratings to my overlays:
+
+![5 Overlays](https://media.discordapp.net/attachments/929901956271570945/1222537162944417842/image.png?ex=66e43d75&is=66e2ebf5&hm=176c744442389ec0a858882d1b760acc19222a1403ea03009009a95065f2bba7&=&format=webp&quality=lossless)
+
+```yaml
+overlays:
+  backdrop:
+    overlay:
+      name: backdrop
+      back_color: "#00000099"
+      back_height: 500
+      vertical_position: top
+    plex_all: true
+  mytext:
+    overlay:
+      name: text(tmdb_rating is <<tmdb_rating>>)
+      horizontal_offset: 0
+      horizontal_align: center
+      vertical_offset: 30
+      vertical_align: top
+      font_size: 63
+      font_color: "#FFFFFF"
+    plex_all: true
+  mytext2:
+    overlay:
+      name: text(mdb_letterboxd_rating% is <<mdb_letterboxd_rating%>>)
+      horizontal_offset: 0
+      horizontal_align: center
+      vertical_offset: 130
+      vertical_align: top
+      font_size: 63
+      font_color: "#FFFFFF"
+    plex_all: true
+  mytext3:
+    overlay:
+      name: text(mdb_tmdb_rating# is <<mdb_tmdb_rating#>>)
+      horizontal_offset: 0
+      horizontal_align: center
+      vertical_offset: 230
+      vertical_align: top
+      font_size: 63
+      font_color: "#FFFFFF"
+    plex_all: true
+  mytext4:
+    overlay:
+      name: text(mdb_tomatoes_rating/ is <<mdb_tomatoes_rating/>>)
+      horizontal_offset: 0
+      horizontal_align: center
+      vertical_offset: 330
+      vertical_align: top
+      font_size: 63
+      font_color: "#FFFFFF"
+    plex_all: true
+  mytext5:
+    overlay:
+      name: text(imdb_rating is <<imdb_rating>>)
+      horizontal_offset: 0
+      horizontal_align: center
+      vertical_offset: 430
+      vertical_align: top
+      font_size: 63
+      font_color: "#FFFFFF"
+    plex_all: true
+```
--- a/docs/blog/posts/welcome.md
+++ b/docs/blog/posts/welcome.md
@ -0,0 +1,23 @@
+---
+title: "Welcome to the Kometa Blog!"
+date:
+    created: 2024-09-11
+authors:
+    - sohjiro
+---
+
+![Welcome Mascot](../images/mascot-welcome.png){ align=right itemprop="image" }
+
+**We're so happy to finally have a dedicated blog where we can post longer-form content for all of our users**
+
+We plan to use this blog to help us reach our users who don't follow us on Discord, which is where we have primarily posted updates and announcements.
+
+We also want to use this space to showcase some of our incredible community-driven creations; collections, overlays and more! Keep your eyes peeled for more on this.
+
+<!-- more -->
+
+Our aim is for this blog to continue to grow as Kometa does, and we will provide running commentary on new features, announcements, tips & tricks and more!
+
+We're always open to suggestions on how we can improve the blog, the best way to get in touch with us is via our [Discord Server](https://kometa.wiki/en/nightly/link/).
+
+Stay tuned for more updates from the Kometa team!
--- a/mkdocs.yml
+++ b/mkdocs.yml
@ -19,6 +19,7 @@ theme:
    - content.code.copy
    - header.autohide
    - announce.dismiss
+    - navigation.indexes
    - navigation.footer
    - navigation.tabs
    - navigation.tabs.sticky
@ -62,6 +63,20 @@ plugins:
        'malauth.md': 'https://replit.com/@chazlarson/MALAuth'
        'traktauth.md': 'https://replit.com/@chazlarson/TraktAuth'
  - material-plausible
+  - blog:
+      enabled: true
+      post_date_format: long
+      post_dir: "{blog}/posts"
+      blog_toc: true
+      categories_allowed:
+        - Announcements
+        - Hotfix
+        - Showcase
+        - Overlays
+        - Collections
+        - Playlists
+        - Builders
+        - Defaults
 extra:
  alternate:
    - name: Latest Docs
@ -349,6 +364,5 @@ nav:
    - EXPLANATION GUIDES: *guides
    - COMPANION SCRIPTS: *scripts
    - USEFUL LINKS: *links
-  - SPONSOR: https://github.com/sponsors/meisnate12
-#  - SHOWCASE:
-#    - Overlays Showcase: showcase/overlays.md
+  - BLOG:
+      - blog/index.md