Skip to content

Commit

Permalink
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add docs
Browse files Browse the repository at this point in the history
Kamaroth92 committed Jan 9, 2025

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
1 parent 9a389d8 commit 47a4f2c
Showing 2 changed files with 77 additions and 75 deletions.
148 changes: 75 additions & 73 deletions docs/source/config_reference/plugins.rst
Original file line number Diff line number Diff line change
@@ -615,79 +615,6 @@ Usage:
<genre>Comedy</genre>
<genre>Drama</genre>
----------------------------------------------------------------------------------------------------

season_nfo_tags
-------------------------
Adds a single NFO file in the season directory. An NFO file is simply an XML file with a
``.nfo`` extension. It uses the last entry's source variables which can change per download
invocation. Be cautious of which variables you use.

Usage:

.. code-block:: yaml
presets:
my_example_preset:
season_nfo_tags:
# required
nfo_name: "Season 01/season.nfo"
nfo_root: "season"
tags:
title: "My custom season name!"
# optional
kodi_safe: False
``enable``

:expected type: Optional[OverridesFormatter]
:description:
Can typically be left undefined to always default to enable. For preset convenience,
this field can be set using an override variable to easily toggle whether this plugin
is enabled or not via Boolean.


``kodi_safe``

:expected type: Optional[Boolean]
:description:
Defaults to False. Kodi does not support > 3-byte unicode characters, which include
emojis and some foreign language characters. Setting this to True will replace those
characters with '□'.


``nfo_name``

:expected type: EntryFormatter
:description:
The NFO file name.


``nfo_root``

:expected type: EntryFormatter
:description:
The root tag of the NFO's XML. In the usage above, it would look like

.. code-block:: xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<season>
</season>
``tags``

:expected type: NfoTags
:description:
Tags within the nfo_root tag. In the usage above, it would look like

.. code-block:: xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<season>
<title>My custom season name!</title>
</season>
----------------------------------------------------------------------------------------------------

@@ -843,6 +770,81 @@ In addition, any override variable defined will automatically create a ``sanitiz
for use. In the example above, ``output_directory_sanitized`` will exist and perform
sanitization on the value when used.

----------------------------------------------------------------------------------------------------

season_nfo_tags
---------------
Adds a single NFO file in the season directory. An NFO file is simply an XML file with a
``.nfo`` extension. It uses the last entry's source variables which can change per download
invocation. Be cautious of which variables you use.

Usage:

.. code-block:: yaml
presets:
my_example_preset:
season_nfo_tags:
# required
nfo_name: "season.nfo"
nfo_root: "season"
tags:
title: "My custom season name!"
# optional
kodi_safe: False
``enable``

:expected type: Optional[OverridesFormatter]
:description:
Can typically be left undefined to always default to enable. For preset convenience,
this field can be set using an override variable to easily toggle whether this plugin
is enabled or not via Boolean.


``kodi_safe``

:expected type: Optional[Boolean]
:description:
Defaults to False. Kodi does not support > 3-byte unicode characters, which include
emojis and some foreign language characters. Setting this to True will replace those
characters with '□'.


``nfo_name``

:expected type: EntryFormatter
:description:
The NFO file name.


``nfo_root``

:expected type: EntryFormatter
:description:
The root tag of the NFO's XML. In the usage above, it would look like

.. code-block:: xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<season>
</season>
``tags``

:expected type: NfoTags
:description:
Tags within the nfo_root tag. In the usage above, it would look like

.. code-block:: xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<season>
<title>My custom season name!</title>
</season>
----------------------------------------------------------------------------------------------------

split_by_chapters
4 changes: 2 additions & 2 deletions src/ytdl_sub/__init__.py
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
__pypi_version__ = "2025.01.09.post1"
__local_version__ = "2025.01.09+52a1be3"
__pypi_version__ = "2025.01.09.post2"
__local_version__ = "2025.01.09+9a389d8"

0 comments on commit 47a4f2c

Please sign in to comment.