blog fails to build stating "archive /tmp/blog/archive" is outside repository at '/docs'

[ironicbadger]

Full code available on this branch here. What did I miss? The blog doesn't seem to want to build for some reason.

Relevant bits of the error:

pms-wiki-pms-wiki-1  | WARNING -  A relative path to 'blog/posts/2023-05-08-youtube-ktz-tailscale-splitdns.md' is included in the 'nav' configuration, which is not found in the documentation files.
...
pms-wiki-pms-wiki-1  |   stderr: 'fatal: /tmp/blog/archive/2023.md: '/tmp/blog/archive/2023.md' is outside repository at '/docs''

I don't exactly understand why it's failing as the blog dir is in the docs dir so relative pathing should be working. It's the same layout as the squidfunk repo for his blog. Confused!

---

Full output of the error:

pms-wiki-pms-wiki-1  | INFO    -  DeprecationWarning: 'cgi' is deprecated and slated for removal in Python 3.13
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/warnings.py", line 514, in _deprecated
pms-wiki-pms-wiki-1  |     warn(msg, DeprecationWarning, stacklevel=3)
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/htmlmin/main.py", line 28, in 
pms-wiki-pms-wiki-1  |     import cgi
pms-wiki-pms-wiki-1  | 
pms-wiki-pms-wiki-1  | 
pms-wiki-pms-wiki-1  | WARNING -  Config value 'dev_addr': The use of the IP address '0.0.0.0' suggests a production environment or the use of a proxy to connect to the MkDocs server. However, the MkDocs' server is intended for local development purposes only. Please use a third party production-ready server instead.
pms-wiki-pms-wiki-1  | INFO    -  Building documentation...
pms-wiki-pms-wiki-1  | INFO    -  Cleaning site directory
pms-wiki-pms-wiki-1  | INFO    -  The following pages exist in the docs directory, but are not included in the "nav" configuration:
pms-wiki-pms-wiki-1  |   - 01-overview/about-this-site.md
pms-wiki-pms-wiki-1  |   - 01-overview/nas-software-comparison.md
pms-wiki-pms-wiki-1  |   - 02-tech-stack/which-containers.md
pms-wiki-pms-wiki-1  |   - 02-tech-stack/os/linux.md
pms-wiki-pms-wiki-1  | WARNING -  A relative path to 'blog/posts/2023-05-08-youtube-ktz-tailscale-splitdns.md' is included in the 'nav' configuration, which is not found in the documentation files.
pms-wiki-pms-wiki-1  | ERROR   -  Error reading page 'blog/archive/2023.md': Cmd('git') failed due to: exit code(128)
pms-wiki-pms-wiki-1  |   cmdline: git log -n 1 --date=short --format=%ad /tmp/blog/archive/2023.md
pms-wiki-pms-wiki-1  |   stderr: 'fatal: /tmp/blog/archive/2023.md: '/tmp/blog/archive/2023.md' is outside repository at '/docs''
pms-wiki-pms-wiki-1  | Traceback (most recent call last):
pms-wiki-pms-wiki-1  |   File "/usr/local/bin/mkdocs", line 8, in <module>
pms-wiki-pms-wiki-1  |     sys.exit(cli())
pms-wiki-pms-wiki-1  |              ^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1157, in __call__
pms-wiki-pms-wiki-1  |     return self.main(*args, **kwargs)
pms-wiki-pms-wiki-1  |            ^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1078, in main
pms-wiki-pms-wiki-1  |     rv = self.invoke(ctx)
pms-wiki-pms-wiki-1  |          ^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1688, in invoke
pms-wiki-pms-wiki-1  |     return _process_result(sub_ctx.command.invoke(sub_ctx))
pms-wiki-pms-wiki-1  |                            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1434, in invoke
pms-wiki-pms-wiki-1  |     return ctx.invoke(self.callback, **ctx.params)
pms-wiki-pms-wiki-1  |            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/click/core.py", line 783, in invoke
pms-wiki-pms-wiki-1  |     return __callback(*args, **kwargs)
pms-wiki-pms-wiki-1  |            ^^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/mkdocs/__main__.py", line 270, in serve_command
pms-wiki-pms-wiki-1  |     serve.serve(**kwargs)
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/mkdocs/commands/serve.py", line 86, in serve
pms-wiki-pms-wiki-1  |     builder(config)
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/mkdocs/commands/serve.py", line 67, in builder
pms-wiki-pms-wiki-1  |     build(config, live_server=None if is_clean else server, dirty=is_dirty)
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/mkdocs/commands/build.py", line 322, in build
pms-wiki-pms-wiki-1  |     _populate_page(file.page, config, files, dirty)
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/mkdocs/commands/build.py", line 171, in _populate_page
pms-wiki-pms-wiki-1  |     page.markdown = config.plugins.on_page_markdown(
pms-wiki-pms-wiki-1  |                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/mkdocs/plugins.py", line 575, in on_page_markdown
pms-wiki-pms-wiki-1  |     return self.run_event('page_markdown', markdown, page=page, config=config, files=files)
pms-wiki-pms-wiki-1  |            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/mkdocs/plugins.py", line 507, in run_event
pms-wiki-pms-wiki-1  |     result = method(item, **kwargs)
pms-wiki-pms-wiki-1  |              ^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/mkdocs_git_revision_date_plugin/plugin.py", line 33, in on_page_markdown
pms-wiki-pms-wiki-1  |     revision_date = self.util.get_revision_date_for_file(page.file.abs_src_path)
pms-wiki-pms-wiki-1  |                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/mkdocs_git_revision_date_plugin/util.py", line 9, in get_revision_date_for_file
pms-wiki-pms-wiki-1  |     return self.g.log(path, n=1, date='short', format='%ad')
pms-wiki-pms-wiki-1  |            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/git/cmd.py", line 741, in <lambda>
pms-wiki-pms-wiki-1  |     return lambda *args, **kwargs: self._call_process(name, *args, **kwargs)
pms-wiki-pms-wiki-1  |                                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/git/cmd.py", line 1315, in _call_process
pms-wiki-pms-wiki-1  |     return self.execute(call, **exec_kwargs)
pms-wiki-pms-wiki-1  |            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pms-wiki-pms-wiki-1  |   File "/usr/local/lib/python3.11/site-packages/git/cmd.py", line 1109, in execute
pms-wiki-pms-wiki-1  |     raise GitCommandError(redacted_command, status, stderr_value, stdout_value)
pms-wiki-pms-wiki-1  | git.exc.GitCommandError: Cmd('git') failed due to: exit code(128)
pms-wiki-pms-wiki-1  |   cmdline: git log -n 1 --date=short --format=%ad /tmp/blog/archive/2023.md
pms-wiki-pms-wiki-1  |   stderr: 'fatal: /tmp/blog/archive/2023.md: '/tmp/blog/archive/2023.md' is outside repository at '/docs''

[squidfunk]

As I read the stack trace, it comes from git-revision-date-localized, essentially a duplicate of #5336. My guess is that you need to update git-revision-date-localized and/or the blog plugin (or Insiders? I'm not sure what you're using). If you continue to observe the error, I'd kindly as you to provide a minimal reproduction.

Update: I misread – you're using git-revision-date, not git-revision-date-localized! Thus, you could either raise the issue to the maintainer of the plugin (linking to #5336), or maybe the plugin has similar exclusion capabilities as mentioned in #5336.

[ironicbadger]

Can confirm disabling the git-revision-date plugin will permit a successful build. I will open an issue upstream linking to this thread. Thanks!

[squidfunk]

Great! ☺️ On a side note, I'd kindly ask you to not use discussions for reporting (potential) bugs. They are intended for questions. For bugs reports, please always open an issue and follow the bug reporting guide. It provides us with all necessary information and allows us to quickly find the root cause of undesired behavior, as we have all information available 🚀