mkdocs-include-markdown-plugin 6.0.4__tar.gz → 6.0.6__tar.gz

{mkdocs_include_markdown_plugin-6.0.4 → mkdocs_include_markdown_plugin-6.0.6}/LICENSE

@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2017-2023 Joe Rickerby and contributors
+   Copyright 2017-2024 Joe Rickerby and contributors
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{mkdocs_include_markdown_plugin-6.0.4 → mkdocs_include_markdown_plugin-6.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: mkdocs-include-markdown-plugin
-Version: 6.0.4
+Version: 6.0.6
 Summary: Mkdocs Markdown includer plugin.
 Project-URL: Source, https://github.com/mondeja/mkdocs-include-markdown-plugin
 Project-URL: Documentation, https://github.com/mondeja/mkdocs-include-markdown-plugin#documentation
@@ -96,46 +96,51 @@ plugins:
       end: <!--end-->
 ```
 
-- <a name="config_tags" href="#config_tags">#</a> **opening_tag** and
-  **closing_tag**: The default opening and closing tags. By default are
-  `{%` and `%}`.
-
-  ```yaml
-  plugins:
-    - include-markdown:
-        opening_tag: "{!"
-        closing_tag: "!}"
-  ```
-
-- <a name="config_exclude" href="#config_exclude">#</a> **exclude**: Define
-  global exclusion wildcard patterns. Relative paths defined here will be
-  relative to the _docs/_ directory.
-
-  ```yaml
-  plugins:
-    - include-markdown:
-        exclude:
-          - LICENSE.md
-          - api/**
-  ```
-
-- <a name="config_cache" href="#config_cache">#</a> **cache**: Define a
-  expiration time in seconds for cached HTTP requests when including
-  from URLs.
-
-  ```yaml
-  plugins:
-    - include-markdown:
-        cache: 600
-  ```
-
-  In order to use this feature, the dependency [platformdirs] must be installed.
-  You can include it in the installation of the plugin adding the `cache` extra:
-
-  ```txt
-  # requirements.txt
-  mkdocs-include-markdown-plugin[cache]
-  ```
+#### `opening_tag` and `closing_tag`
+
+Default opening and closing tags. When not specified they are `{%` and `%}`.
+
+```yaml
+plugins:
+  - include-markdown:
+      opening_tag: "{!"
+      closing_tag: "!}"
+```
+
+<!-- mdpo-disable-next-line -->
+
+#### `exclude`
+
+Global exclusion wildcard patterns. Relative paths defined here will be
+relative to the [`docs_dir`] directory.
+
+```yaml
+plugins:
+  - include-markdown:
+      exclude:
+        - LICENSE.md
+        - api/**
+```
+
+<!-- mdpo-disable-next-line -->
+
+#### `cache`
+
+Expiration time in seconds for cached HTTP requests when including from URLs.
+
+```yaml
+plugins:
+  - include-markdown:
+      cache: 600
+```
+
+In order to use this feature, the dependency [platformdirs] must be installed.
+You can include it in the installation of the plugin adding the `cache` extra:
+
+```txt
+# requirements.txt
+mkdocs-include-markdown-plugin[cache]
+```
 
 ### Reference
 
@@ -148,7 +153,9 @@ Paths of included files can be either:
 - Local files:
   - Absolute paths (starting with a path separator).
   - Relative from the file that includes them (starting with `./` or `../`).
-  - Relative from the _docs/_ directory.
+  - Relative to the [`docs_dir`] directory. For instance if your `docs_dir` is
+    _./docs/_, then `includes/header.md` will match the file
+    _./docs/includes/header.md_.
 - [Bash wildcard globs] matching multiple local files.
 
 File paths to include and string arguments can be wrapped by double `"` or
@@ -212,7 +219,7 @@ content to include.
 
 ```jinja
 {%
-   include-markdown 'docs/includes/header.md'
+   include-markdown 'includes/header.md'
    start='<!--\n\ttable-start\n-->'
    end='<!--\n\ttable-end\n-->'
    rewrite-relative-urls=false
@@ -222,7 +229,7 @@ content to include.
 
 ```jinja
 {%
-   include-markdown "docs/includes/header.md"
+   include-markdown "includes/header.md"
    heading-offset=1
 %}
 ```
@@ -303,6 +310,10 @@ Includes the content of a file or a group of files.
   [giving me the permissions][cibuildwheel-470] to separate this plugin from the
   documentation of [cibuildwheel][cibuildwheel-repo-link].
 
+[Bash wildcard globs]: https://facelessuser.github.io/wcmatch/glob/#syntax
+
+<!-- mdpo-disable -->
+
 [pypi-link]: https://pypi.org/project/mkdocs-include-markdown-plugin
 [pypi-version-badge-link]: https://img.shields.io/pypi/v/mkdocs-include-markdown-plugin?logo=pypi&logoColor=white
 [tests-image]: https://img.shields.io/github/actions/workflow/status/mondeja/mkdocs-include-markdown-plugin/ci.yml?logo=github&label=tests&branch=master
@@ -316,4 +327,4 @@ Includes the content of a file or a group of files.
 [cibuildwheel-repo-link]: https://github.com/pypa/cibuildwheel
 [es-readme-link]: https://github.com/mondeja/mkdocs-include-markdown-plugin/blob/master/locale/es/README.md
 [fr-readme-link]: https://github.com/mondeja/mkdocs-include-markdown-plugin/blob/master/locale/fr/README.md
-[Bash wildcard globs]: https://facelessuser.github.io/wcmatch/glob/#syntax
+[`docs_dir`]: https://www.mkdocs.org/user-guide/configuration/#docs_dir

{mkdocs_include_markdown_plugin-6.0.4 → mkdocs_include_markdown_plugin-6.0.6}/README.md

@@ -61,46 +61,51 @@ plugins:
       end: <!--end-->
 ```
 
-- <a name="config_tags" href="#config_tags">#</a> **opening_tag** and
-  **closing_tag**: The default opening and closing tags. By default are
-  `{%` and `%}`.
-
-  ```yaml
-  plugins:
-    - include-markdown:
-        opening_tag: "{!"
-        closing_tag: "!}"
-  ```
-
-- <a name="config_exclude" href="#config_exclude">#</a> **exclude**: Define
-  global exclusion wildcard patterns. Relative paths defined here will be
-  relative to the _docs/_ directory.
-
-  ```yaml
-  plugins:
-    - include-markdown:
-        exclude:
-          - LICENSE.md
-          - api/**
-  ```
-
-- <a name="config_cache" href="#config_cache">#</a> **cache**: Define a
-  expiration time in seconds for cached HTTP requests when including
-  from URLs.
-
-  ```yaml
-  plugins:
-    - include-markdown:
-        cache: 600
-  ```
-
-  In order to use this feature, the dependency [platformdirs] must be installed.
-  You can include it in the installation of the plugin adding the `cache` extra:
-
-  ```txt
-  # requirements.txt
-  mkdocs-include-markdown-plugin[cache]
-  ```
+#### `opening_tag` and `closing_tag`
+
+Default opening and closing tags. When not specified they are `{%` and `%}`.
+
+```yaml
+plugins:
+  - include-markdown:
+      opening_tag: "{!"
+      closing_tag: "!}"
+```
+
+<!-- mdpo-disable-next-line -->
+
+#### `exclude`
+
+Global exclusion wildcard patterns. Relative paths defined here will be
+relative to the [`docs_dir`] directory.
+
+```yaml
+plugins:
+  - include-markdown:
+      exclude:
+        - LICENSE.md
+        - api/**
+```
+
+<!-- mdpo-disable-next-line -->
+
+#### `cache`
+
+Expiration time in seconds for cached HTTP requests when including from URLs.
+
+```yaml
+plugins:
+  - include-markdown:
+      cache: 600
+```
+
+In order to use this feature, the dependency [platformdirs] must be installed.
+You can include it in the installation of the plugin adding the `cache` extra:
+
+```txt
+# requirements.txt
+mkdocs-include-markdown-plugin[cache]
+```
 
 ### Reference
 
@@ -113,7 +118,9 @@ Paths of included files can be either:
 - Local files:
   - Absolute paths (starting with a path separator).
   - Relative from the file that includes them (starting with `./` or `../`).
-  - Relative from the _docs/_ directory.
+  - Relative to the [`docs_dir`] directory. For instance if your `docs_dir` is
+    _./docs/_, then `includes/header.md` will match the file
+    _./docs/includes/header.md_.
 - [Bash wildcard globs] matching multiple local files.
 
 File paths to include and string arguments can be wrapped by double `"` or
@@ -177,7 +184,7 @@ content to include.
 
 ```jinja
 {%
-   include-markdown 'docs/includes/header.md'
+   include-markdown 'includes/header.md'
    start='<!--\n\ttable-start\n-->'
    end='<!--\n\ttable-end\n-->'
    rewrite-relative-urls=false
@@ -187,7 +194,7 @@ content to include.
 
 ```jinja
 {%
-   include-markdown "docs/includes/header.md"
+   include-markdown "includes/header.md"
    heading-offset=1
 %}
 ```
@@ -268,6 +275,10 @@ Includes the content of a file or a group of files.
   [giving me the permissions][cibuildwheel-470] to separate this plugin from the
   documentation of [cibuildwheel][cibuildwheel-repo-link].
 
+[Bash wildcard globs]: https://facelessuser.github.io/wcmatch/glob/#syntax
+
+<!-- mdpo-disable -->
+
 [pypi-link]: https://pypi.org/project/mkdocs-include-markdown-plugin
 [pypi-version-badge-link]: https://img.shields.io/pypi/v/mkdocs-include-markdown-plugin?logo=pypi&logoColor=white
 [tests-image]: https://img.shields.io/github/actions/workflow/status/mondeja/mkdocs-include-markdown-plugin/ci.yml?logo=github&label=tests&branch=master
@@ -281,4 +292,4 @@ Includes the content of a file or a group of files.
 [cibuildwheel-repo-link]: https://github.com/pypa/cibuildwheel
 [es-readme-link]: https://github.com/mondeja/mkdocs-include-markdown-plugin/blob/master/locale/es/README.md
 [fr-readme-link]: https://github.com/mondeja/mkdocs-include-markdown-plugin/blob/master/locale/fr/README.md
-[Bash wildcard globs]: https://facelessuser.github.io/wcmatch/glob/#syntax
+[`docs_dir`]: https://www.mkdocs.org/user-guide/configuration/#docs_dir

{mkdocs_include_markdown_plugin-6.0.4 → mkdocs_include_markdown_plugin-6.0.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mkdocs-include-markdown-plugin"
-version = "6.0.4"
+version = "6.0.6"
 description = "Mkdocs Markdown includer plugin."
 readme = "README.md"
 license = "Apache-2.0"
@@ -74,7 +74,7 @@ dependencies = ["pytest~=7.0", "coverage~=6.4", "covdefaults"]
 
 [[tool.hatch.envs.tests.matrix]]
 python = ["py38", "py39", "py310", "py311", "py312"]
-mkdocs = ["1.4.0", "1.4.3", "1.5.0", "1.5.3"]
+mkdocs = ["1.4.0", "1.4.3", "1.5.0", "1.5.3", "1.6.0"]
 cache = ["yes", "no"]
 
 [tool.hatch.envs.tests.overrides]
@@ -83,6 +83,7 @@ matrix.mkdocs.dependencies = [
   { value = "mkdocs==1.4.3", if = ["1.4.3"] },
   { value = "mkdocs==1.5.0", if = ["1.5.0"] },
   { value = "mkdocs==1.5.3", if = ["1.5.3"] },
+  { value = "mkdocs==1.6.0", if = ["1.6.0"] },
 ]
 matrix.cache.dependencies = [{ value = "platformdirs", if = ["yes"] }]
 
@@ -103,9 +104,9 @@ targets = [{ file = "pyproject.toml" }]
 [tool.project-config]
 cache = "2 days"
 style = [
-  "gh://mondeja/project-config-styles@v5.1/base/pre-commit/md2po2md.json5",
-  "gh://mondeja/project-config-styles@v5.1/python/base.json5",
-  "gh://mondeja/project-config-styles@v5.1/python/mypy.json5",
+  "gh://mondeja/project-config-styles@v5.2.1/base/pre-commit/md2po2md.json5",
+  "gh://mondeja/project-config-styles@v5.2.1/python/base.json5",
+  "gh://mondeja/project-config-styles@v5.2.1/python/mypy.json5",
 ]
 
 [tool.coverage.run]
@@ -121,6 +122,8 @@ fail_under = 1
 [tool.ruff]
 line-length = 80
 target-version = "py38"
+
+[tool.ruff.lint]
 select = [
   "W",
   "B",
@@ -150,19 +153,19 @@ select = [
 ]
 ignore = ["G004"]
 
-[tool.ruff.pydocstyle]
+[tool.ruff.lint.pydocstyle]
 convention = "google"
 
-[tool.ruff.flake8-quotes]
+[tool.ruff.lint.flake8-quotes]
 inline-quotes = "single"
 multiline-quotes = "single"
 
-[tool.ruff.flake8-pytest-style]
+[tool.ruff.lint.flake8-pytest-style]
 fixture-parentheses = false
 parametrize-values-type = "tuple"
 parametrize-values-row-type = "tuple"
 
-[tool.ruff.isort]
+[tool.ruff.lint.isort]
 lines-after-imports = 2
 combine-as-imports = true
 force-wrap-aliases = true
@@ -176,7 +179,7 @@ extra-standard-library = [
   "wsgiref.types"
 ]
 
-[tool.ruff.per-file-ignores]
+[tool.ruff.lint.per-file-ignores]
 "tests/**" = [
   "I002",
   "D100",

{mkdocs_include_markdown_plugin-6.0.4 → mkdocs_include_markdown_plugin-6.0.6}/src/mkdocs_include_markdown_plugin/directive.py

@@ -8,6 +8,7 @@ import string
 from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
+from mkdocs.exceptions import PluginError
 from wcmatch import glob
 
 from mkdocs_include_markdown_plugin import process
@@ -174,19 +175,19 @@ def parse_bool_options(
 
 
 def resolve_file_paths_to_include(
-    filename_or_url: str,
-    includer_page_src_path: str,
+    include_string: str,
+    includer_page_src_path: str | None,
     docs_dir: str,
     ignore_paths: list[str],
 ) -> tuple[list[str], bool]:
     """Resolve the file paths to include for a directive."""
-    if process.is_url(filename_or_url):
-        return [filename_or_url], True
+    if process.is_url(include_string):
+        return [include_string], True
 
-    if process.is_absolute_path(filename_or_url):
+    if process.is_absolute_path(include_string):
         if os.name == 'nt':  # pragma: nt cover
             # Windows
-            fpath = os.path.normpath(filename_or_url)
+            fpath = os.path.normpath(include_string)
             if not os.path.isfile(fpath):
                 return [], False
 
@@ -195,13 +196,19 @@ def resolve_file_paths_to_include(
             ), False
         return process.filter_paths(
             glob.iglob(
-                os.path.normpath(filename_or_url),
+                os.path.normpath(include_string),
                 flags=GLOB_FLAGS,
             ),
             ignore_paths,
         ), False
 
-    if process.is_relative_path(filename_or_url):
+    if process.is_relative_path(include_string):
+        if includer_page_src_path is None:  # pragma: no cover
+            raise PluginError(
+                'Relative paths are not allowed when the includer page'
+                ' source path is not provided. The include string'
+                f" '{include_string}' is located inside a generated page.",
+            )
         root_dir = os.path.abspath(
             os.path.dirname(includer_page_src_path),
         )
@@ -209,7 +216,7 @@ def resolve_file_paths_to_include(
             (
                 os.path.normpath(os.path.join(root_dir, fp))
                 for fp in glob.iglob(
-                    filename_or_url,
+                    include_string,
                     flags=GLOB_FLAGS,
                     root_dir=root_dir,
                 )
@@ -221,7 +228,7 @@ def resolve_file_paths_to_include(
         (
             os.path.normpath(os.path.join(docs_dir, fp))
             for fp in glob.iglob(
-                filename_or_url,
+                include_string,
                 flags=GLOB_FLAGS,
                 root_dir=docs_dir,
             )
@@ -232,7 +239,7 @@ def resolve_file_paths_to_include(
 
 def resolve_file_paths_to_exclude(
     exclude_string: str,
-    includer_page_src_path: str,
+    includer_page_src_path: str | None,
     docs_dir: str,
 ) -> list[str]:
     """Resolve the file paths to exclude for a directive."""
@@ -241,6 +248,12 @@ def resolve_file_paths_to_exclude(
         return glob.glob(exclude_string, flags=GLOB_FLAGS)
 
     if process.is_relative_path(exclude_string):
+        if includer_page_src_path is None:  # pragma: no cover
+            raise PluginError(
+                'Relative paths are not allowed when the includer page'
+                ' source path is not provided. The exclude string'
+                f" '{exclude_string}' is located inside a generated page.",
+            )
         root_dir = os.path.abspath(
             os.path.dirname(includer_page_src_path),
         )

{mkdocs_include_markdown_plugin-6.0.4 → mkdocs_include_markdown_plugin-6.0.6}/src/mkdocs_include_markdown_plugin/event.py

@@ -58,9 +58,26 @@ def lineno_from_content_start(content: str, start: int) -> int:
     return content[:start].count('\n') + 1
 
 
+def file_lineno_message(
+        page_src_path: str | None,
+        docs_dir: str,
+        lineno: int,
+) -> str:
+    """Return a message with the file path and line number."""
+    if page_src_path is None:  # pragma: no cover
+        return f'generated page content (line {lineno})'
+    return (
+        f'{os.path.relpath(page_src_path, docs_dir)}'
+        f':{lineno}'
+    )
+
+
 def get_file_content(  # noqa: PLR0913, PLR0915
         markdown: str,
-        page_src_path: str,
+        # Generated pages return `None` for `file.abs_src_path` because
+        # they are not read from a file. In this case, page_src_path is
+        # set to `None`.
+        page_src_path: str | None,
         docs_dir: str,
         tags: IncludeTags,
         defaults: DefaultValues,
@@ -85,8 +102,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
             )
             raise PluginError(
                 "Found no path passed including with 'include'"
-                f' directive at {os.path.relpath(page_src_path, docs_dir)}'
-                f':{lineno}',
+                ' directive at'
+                f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
             )
 
         arguments_string = match['arguments']
@@ -114,9 +131,10 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                 )
                 raise PluginError(
                     "Invalid empty 'exclude' argument in 'include'"
-                    f' directive at {os.path.relpath(page_src_path, docs_dir)}'
-                    f':{lineno}',
+                    ' directive at'
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 )
+
             ignore_paths.extend(
                 resolve_file_paths_to_exclude(
                     exclude_string,
@@ -139,9 +157,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                 directive_match_start,
             )
             raise PluginError(
-                f"No files found including '{raw_filename}'"
-                f' at {os.path.relpath(page_src_path, docs_dir)}'
-                f':{lineno}',
+                f"No files found including '{raw_filename}' at"
+                f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
             )
 
         if files_watcher is not None and not is_url:
@@ -160,8 +177,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
             raise PluginError(
                 f"Invalid value for '{invalid_bool_args[0]}' argument of"
                 " 'include' directive at"
-                f' {os.path.relpath(page_src_path, docs_dir)}'
-                f':{lineno}. Possible values are true or false.',
+                f' {file_lineno_message(page_src_path, docs_dir, lineno)}.'
+                f' Possible values are true or false.',
             )
 
         start_match = ARGUMENT_REGEXES['start'].search(arguments_string)
@@ -173,8 +190,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                     directive_match_start,
                 )
                 raise PluginError(
-                    "Invalid empty 'start' argument in 'include' directive at "
-                    f'{os.path.relpath(page_src_path, docs_dir)}:{lineno}',
+                    "Invalid empty 'start' argument in 'include' directive at"
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 )
         else:
             start = defaults['start']
@@ -188,8 +205,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                     directive_match_start,
                 )
                 raise PluginError(
-                    "Invalid empty 'end' argument in 'include' directive at "
-                    f'{os.path.relpath(page_src_path, docs_dir)}:{lineno}',
+                    "Invalid empty 'end' argument in 'include' directive at"
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 )
         else:
             end = defaults['end']
@@ -204,8 +221,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                 )
                 raise PluginError(
                     "Invalid empty 'encoding' argument in 'include'"
-                    ' directive at '
-                    f'{os.path.relpath(page_src_path, docs_dir)}:{lineno}',
+                    ' directive at'
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 )
         else:
             encoding = defaults['encoding']
@@ -278,12 +295,14 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                     markdown,
                     directive_match_start,
                 )
-                relative_path = os.path.relpath(page_src_path, docs_dir)
+                file_lineno = file_lineno_message(
+                    page_src_path, docs_dir, lineno,
+                )
                 logger.warning(
                     (
                         f"Delimiter {delimiter_name} '{delimiter_value}'"
                         " of 'include' directive at"
-                        f' {relative_path}:{lineno}'
+                        f' {file_lineno}'
                         f' not detected in the file{plural_suffix}'
                         f' {readable_files_to_include}'
                     ),
@@ -307,8 +326,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
             )
             raise PluginError(
                 "Found no path passed including with 'include-markdown'"
-                f' directive at {os.path.relpath(page_src_path, docs_dir)}'
-                f':{lineno}',
+                f' directive at'
+                f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
             )
 
         arguments_string = match['arguments']
@@ -336,8 +355,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                 )
                 raise PluginError(
                     "Invalid empty 'exclude' argument in 'include-markdown'"
-                    f' directive at {os.path.relpath(page_src_path, docs_dir)}'
-                    f':{lineno}',
+                    f' directive at'
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 )
             ignore_paths.extend(
                 resolve_file_paths_to_exclude(
@@ -362,8 +381,7 @@ def get_file_content(  # noqa: PLR0913, PLR0915
             )
             raise PluginError(
                 f"No files found including '{raw_filename}' at"
-                f' {os.path.relpath(page_src_path, docs_dir)}'
-                f':{lineno}',
+                f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
             )
 
         if files_watcher is not None and not is_url:
@@ -386,8 +404,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
             raise PluginError(
                 f"Invalid value for '{invalid_bool_args[0]}' argument of"
                 " 'include-markdown' directive at"
-                f' {os.path.relpath(page_src_path, docs_dir)}'
-                f':{lineno}. Possible values are true or false.',
+                f' {file_lineno_message(page_src_path, docs_dir, lineno)}.'
+                f' Possible values are true or false.',
             )
 
         # start and end arguments
@@ -401,8 +419,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                 )
                 raise PluginError(
                     "Invalid empty 'start' argument in 'include-markdown'"
-                    f' directive at {os.path.relpath(page_src_path, docs_dir)}'
-                    f':{lineno}',
+                    f' directive at'
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 )
         else:
             start = defaults['start']
@@ -417,8 +435,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                 )
                 raise PluginError(
                     "Invalid empty 'end' argument in 'include-markdown'"
-                    f' directive at {os.path.relpath(page_src_path, docs_dir)}'
-                    f':{lineno}',
+                    f' directive at'
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 )
         else:
             end = defaults['end']
@@ -433,8 +451,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                 )
                 raise PluginError(
                     "Invalid empty 'encoding' argument in 'include-markdown'"
-                    ' directive at '
-                    f'{os.path.relpath(page_src_path, docs_dir)}:{lineno}',
+                    ' directive at'
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 )
         else:
             encoding = defaults['encoding']
@@ -444,8 +462,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
             arguments_string,
         )
         if offset_match:
-            offset = offset_match[1]
-            if offset == '':
+            offset_raw_value = offset_match[1]
+            if offset_raw_value == '':
                 lineno = lineno_from_content_start(
                     markdown,
                     directive_match_start,
@@ -453,19 +471,19 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                 raise PluginError(
                     "Invalid empty 'heading-offset' argument in"
                     " 'include-markdown' directive at"
-                    f' {os.path.relpath(page_src_path, docs_dir)}:{lineno}',
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 )
             try:
-                offset = int(offset)
+                offset = int(offset_raw_value)
             except ValueError:
                 lineno = lineno_from_content_start(
                     markdown,
                     directive_match_start,
                 )
                 raise PluginError(
-                    f"Invalid 'heading-offset' argument \"{offset}\" in"
-                    " 'include-markdown' directive at "
-                    f'{os.path.relpath(page_src_path, docs_dir)}:{lineno}',
+                    f"Invalid 'heading-offset' argument \"{offset_raw_value}\""
+                    " in 'include-markdown' directive at"
+                    f' {file_lineno_message(page_src_path, docs_dir, lineno)}',
                 ) from None
         else:
             offset = defaults['heading-offset']
@@ -523,11 +541,17 @@ def get_file_content(  # noqa: PLR0913, PLR0915
 
             # relative URLs rewriting
             if bool_options['rewrite-relative-urls'].value:
-                new_text_to_include = process.rewrite_relative_urls(
-                    new_text_to_include,
-                    source_path=file_path,
-                    destination_path=page_src_path,
-                )
+                if page_src_path is None:  # pragma: no cover
+                    logger.warning(
+                        'Relative URLs rewriting is not supported in'
+                        ' generated pages.',
+                    )
+                else:
+                    new_text_to_include = process.rewrite_relative_urls(
+                        new_text_to_include,
+                        source_path=file_path,
+                        destination_path=page_src_path,
+                    )
 
             # comments
             if bool_options['comments'].value:
@@ -556,7 +580,7 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                     )
                 )
 
-            if offset_match:
+            if offset:
                 new_text_to_include = process.increase_headings_offset(
                     new_text_to_include,
                     offset=offset + cumulative_heading_offset,
@@ -577,12 +601,14 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                     markdown,
                     directive_match_start,
                 )
-                relative_path = os.path.relpath(page_src_path, docs_dir)
+                file_lineno = file_lineno_message(
+                    page_src_path, docs_dir, lineno,
+                )
                 logger.warning(
                     (
                         f"Delimiter {delimiter_name} '{delimiter_value}' of"
                         " 'include-markdown' directive at"
-                        f' {relative_path}:{lineno}'
+                        f' {file_lineno}'
                         f' not detected in the file{plural_suffix}'
                         f' {readable_files_to_include}'
                     ),