Feature: add option to set default timezone

[Guts]

Example:

- rss:
    date_from_meta:
      as_creation: "date"
      as_update: false
      datetime_format: "%Y-%m-%d %H:%M"
      default_timezone: "Europe/Paris"

Defaults to UTC.

• Python >= 3.9 - no need for additional 3rd party package (or tzdata if an updated version of IANA db is needed)
• Python < 3.9 - need to install pytz alongside.

Closes #133

[codecov]

Codecov Report

Merging #142 (4083099) into main (9dc0f24) will increase coverage by 0.48%.
The diff coverage is 87.50%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #142      +/-   ##
==========================================
+ Coverage   81.21%   81.69%   +0.48%     
==========================================
  Files           5        7       +2     
  Lines         330      366      +36     
  Branches       72       80       +8     
==========================================
+ Hits          268      299      +31     
- Misses         40       42       +2     
- Partials       22       25       +3     

Impacted Files	Coverage Δ
mkdocs_rss_plugin/timezoner_pre39.py	83.33% <83.33%> (ø)
mkdocs_rss_plugin/timezoner_py39.py	83.33% <83.33%> (ø)
mkdocs_rss_plugin/util.py	72.43% <92.85%> (+1.00%)	⬆️
mkdocs_rss_plugin/plugin.py	96.15% <100.00%> (+0.07%)	⬆️

[squidfunk]

Awesome, thanks for implementing! Looking forward to the next release (no hurry) 😀

[Guts]

Awesome, thanks for implementing! Looking forward to the next release (no hurry) grinning

Thanks for testing and feeding back. I wanted to complete the related documentation before releasing.

It leads me to think about a default_time option allowing to set a default hour of publication to avoid the "midnight syndrome". With a range to get a random hour picked?

What do you think @squidfunk?

[Guts]

It leads me to think about a default_time option allowing to set a default hour of publication to avoid the "midnight syndrome".

Got time to implement it in #145

[squidfunk]

It leads me to think about a default_time option allowing to set a default hour of publication to avoid the "midnight syndrome". With a range to get a random hour picked?

Shouldn't that be covered by UTC? The idea was that if you parse the date, it should default to YYYY-mm-dd 00:00:00.

[Guts]

It's defined before to set the timezone (custom or UTC by default), so the time is just added to a simple date. Example:

Config:

plugins:
  - rss:
      date_from_meta:
        as_creation: "date"
        as_update: false
        datetime_format: "%Y-%m-%d"
        default_time: "22:00"

Page meta:

---
title: "This page title is a perfect clickbait!"
authors:
  - guts
date: 2020-10-22
---

Output:

  <pubDate>Thu, 22 Oct 2020 22:00:00 +0000</pubDate>

Am I missing something?

[squidfunk]

Okay, I may have confused something here. My problem was that when the date is left out, the time was shifted by the timezone offset. Since this is fixed now, you can view my comment as resolved. Personally, I don't see much use for a default_time option, but when you think it makes sense, I see no problem with this conflicting.