Registry / devops / mkdocs-same-dir

mkdocs-same-dir

JSON →
library0.1.5pypypi✓ verified 83d ago

A MkDocs plugin that allows placing the mkdocs.yml configuration file in the same directory as your documentation source files, rather than in a parent directory. Version 0.1.5, maintained as part of the ProperDocs ecosystem. Release cadence is low.

devops
pip install mkdocs-same-dir
github ↗package ↗docs ↗
INSTALL
IMPORT
SIG · MKDOCS-SAME-DIR
M
mkdocs-same-dir
devopspythonv0.1.5
Install
3.1s avg
Import
—
Disk
34MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v0.1.5 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 34.3MB
glibc
py 3.10–3.95 runs
installs and imports cleanly · install 3.1s · import 0.000s · 36MB
34MB installed
● package 34MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

same_dir
✓ import mkdocs_same_dir
✗ from mkdocs_same_dir import same_dir

Enable the plugin in your mkdocs.yml configuration.

# mkdocs.yml plugins: - same_dir
Debug
Known issues
deprecatedPlugin warns when used with the original 'mkdocs' executable. It is intended for use with the 'properdocs' executable as part of the ProperDocs project.
fix
Install and use 'properdocs' instead of 'mkdocs'.
affects: >=0.1.4
gotchaThe plugin only affects how mkdocs.yml is resolved; it does not change the behavior of MkDocs itself. Ensure your configuration follows standard MkDocs conventions.
fix
Place mkdocs.yml in the docs directory and verify paths in the configuration are relative to that directory.
affects: all
Upgrade
Version history
0.1.5latest on PyPI · released Apr 17, 2026
Audit
Dependencies
mkdocsrequiredCore dependency; this is a MkDocs plugin.
Agent activity
2 hits · last 30 days
node
2
Resources
githubhttps://github.com/oprypin/mkdocs-same-dir ↗
packagehttps://pypi.org/project/mkdocs-same-dir/ ↗
docshttps://oprypin.github.io/mkdocs-same-dir/ ↗
mkdocs-same-dir — pip install mkdocs-same-dir · libregistry