insiders build 8.5.6-4.25.2 fails to build a blog #4457
Description
Contribution guidelines
- I've read the contribution guidelines and wholeheartedly agree
I've found a bug and checked that ...
- ... the problem doesn't occur with the
mkdocsorreadthedocsthemes - ... the problem persists when all overrides are removed, i.e.
custom_dir,extra_javascriptandextra_css - ... the documentation does not mention anything about my problem
- ... there are no open or closed issues that are related to my problem
Description
I built the latest release of mkdocs-insiders and the standalone blog fails to build. Maybe because of the docs_dir setting.
Expected behaviour
Blog builds
Actual behaviour
Blog build fails with the following stack
docker run -it --rm -p 8002:8000 -v $(pwd):/docs ghcr.io/hellt/mkdocs-material-insiders:8.5.6-4.25.2
WARNING - Config value: 'dev_addr'. Warning: 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.
INFO - Building documentation...
INFO - Cleaning site directory
INFO - The following pages exist in the docs directory, but are not included in the "nav" configuration:
- about.md
- posts/2017/How to install pyhton3 in Amazon Linux AMI.md
- posts/2017/count_lines_in_git_repo.md
- posts/2017/go_dev_on_mac_linux.md
- posts/2017/hugo_gitlab_cloudflare.md
- posts/2017/nginx-uwsgi-flask-alpine.md
- posts/2017/nokdoc_sentinel_lambda.md
- posts/2017/sros_rootifier.md
- posts/2017/vifmove.md
- posts/2017/virsh_remove_w_xargs.md
- posts/2017/wait_for_ssh_paramiko.md
- posts/2017/xrdp_on_ubuntu1604.md
- posts/2017/yaml_hljs.md
- posts/2017/yang-explorer-alpine.md
- posts/2018/aws_csa_certification.md
- posts/2018/openstack_coa.md
- posts/2018/s3_multiple_upload.md
- posts/2018/saturating_with_ftp.md
- posts/2019/download_ts_streams.md
- posts/2019/frontend-for-your-restapi.md
- posts/2019/serverless-gc-functions.md
- posts/2020/gnmi-arista.md
- posts/2020/gnmi-map.md
- posts/2020/gnmic-yang-completions.md
- posts/2020/gnmic.md
- posts/2020/netconf-console-docker.md
- posts/2020/netconf-xml-skeleton.md
- posts/2020/ngrok_fwd.md
- posts/2020/nokia-yang-tree.md
- posts/2020/projectdocs.md
- posts/2020/remote_capture_eve.md
- posts/2020/subtree.md
- posts/2021/containerlab.md
- posts/2021/git-remove-big-files.md
- posts/2021/goreleaser-apt-yum.md
- posts/2021/ovs-free-lacp.md
- posts/2021/public-srlinux.md
- posts/2021/scrapli-kubectl.md
- posts/2021/scrapligo-options.md
- posts/2021/uksm-patch.md
- posts/2022/gnmic-openconfig.md
- posts/2022/guestfish-container.md
- posts/2022/netrel001.md
- posts/2022/netrel002.md
- posts/noshut/2015-06-02-ldp-ordered-label-distribution-control-explained.md
- posts/noshut/2015-06-14-ospf-neighbors-on-a-point-to-broadcast-network.md
- posts/noshut/2015-06-22-alcatel-lucent-ospf-configuration-tutorial.md
- posts/noshut/2015-06-24-alcatel-lucent-configuring-packet-ip-filters.md
- posts/noshut/2015-08-24-alcatel-lucent-bgp-configuration-tutorial-part-1-basic-ebgp-ibgp.md
- posts/noshut/2015-09-23-alcatel-lucent-bgp-configuration-tutorial-part-2-bgp-policies-community.md
- posts/noshut/2015-11-03-basic-l3vpn-bgpmpls-vpn-or-vprn-configuration-alcatel-lucent-juniper.md
- posts/noshut/2016-04-01-building-web-front-end-for-python-scripts-with-flask.md
- posts/noshut/2016-11-14-bgp-vpls-explained.md
ERROR - Error building page 'index.md': 'pagination' is undefined
Traceback (most recent call last):
File "/usr/local/bin/mkdocs", line 8, in <module>
sys.exit(cli())
File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1130, in __call__
return self.main(*args, **kwargs)
File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1055, in main
rv = self.invoke(ctx)
File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1657, in invoke
return _process_result(sub_ctx.command.invoke(sub_ctx))
File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1404, in invoke
return ctx.invoke(self.callback, **ctx.params)
File "/usr/local/lib/python3.9/site-packages/click/core.py", line 760, in invoke
return __callback(*args, **kwargs)
File "/usr/local/lib/python3.9/site-packages/mkdocs/__main__.py", line 234, in serve_command
serve.serve(dev_addr=dev_addr, livereload=livereload, watch=watch, **kwargs)
File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/serve.py", line 82, in serve
builder(config)
File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/serve.py", line 75, in builder
build(config, live_server=live_server, dirty=dirty)
File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/build.py", line 329, in build
_build_page(file.page, config, doc_files, nav, env, dirty)
File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/build.py", line 231, in _build_page
output = template.render(context)
File "/usr/local/lib/python3.9/site-packages/jinja2/environment.py", line 1301, in render
self.environment.handle_exception()
File "/usr/local/lib/python3.9/site-packages/jinja2/environment.py", line 936, in handle_exception
raise rewrite_traceback_stack(source=source)
File "/usr/local/lib/python3.9/site-packages/material/blog.html", line 4, in top-level template code
{% extends "main.html" %}
File "/docs/blog/overrides/main.html", line 1, in top-level template code
{% extends "base.html" %}
File "/usr/local/lib/python3.9/site-packages/material/base.html", line 181, in top-level template code
{% block container %}
File "/usr/local/lib/python3.9/site-packages/material/blog.html", line 14, in block 'container'
{% block pagination %}
File "/usr/local/lib/python3.9/site-packages/material/blog.html", line 15, in block 'pagination'
{% include "partials/pagination.html" %}
File "/usr/local/lib/python3.9/site-packages/material/partials/pagination.html", line 10, in top-level template code
pagination({
File "/usr/local/lib/python3.9/site-packages/jinja2/utils.py", line 83, in from_obj
if hasattr(obj, "jinja_pass_arg"):
jinja2.exceptions.UndefinedError: 'pagination' is undefined
Steps to reproduce
build a container for the 8.5.6-4.25.2 insiders and try to build a blog with the following settings
Package versions
- Python:
python --version - MkDocs:
mkdocs --version - Material:
pip show mkdocs-material | grep -E ^Version
Configuration
site_name: some
docs_dir: blog
nav:
- Blog:
- index.md
- Tags: tags.md
theme:
name: material
custom_dir: blog/overrides
# 404 page
static_templates:
- 404.html
# Don't include MkDocs' JavaScript
include_search_page: false
search_index_only: true
features:
- navigation.top
- navigation.instant
- navigation.tabs
- search.suggest
- content.code.annotate
- toc.follow
- content.tooltips
- navigation.indexes
language: en
# Plugins
plugins:
- meta
- blog:
blog_dir: .
post_url_date_format: yyyy
archive: false
categories: false
- tags:
tags_file: tags.md
- search:
separator: '[\s\-\_]'
- minify:
minify_html: trueSystem information
- Operating system: Mac
- Browser: Chrome