Comments (4)
More information:
The error occurs when a module starts with a site name with a '/' in it
site_name: org/module1
Seems to be problematic
from mkdocs-monorepo-plugin.
Update: changing line 35 in edit_uri.py
to
alias = "/".join(parts)
fixes the issue (which seemed to already have been fixed in version 0.4.9)
So using /
instead of the os specific os.path
solves the problem... I don't know if you'd consider this a structural fix though 🤷♂️
from mkdocs-monorepo-plugin.
@timconinx Is the name of the component org/module
? Is that also the name in the software catalog? The catalog doesn't support /
in the name (https://backstage.io/docs/features/software-catalog/descriptor-format#name-required) so I'd be hesitant to say that techdocs supports slashes.
I'd recommend just using the allowed characters -_.
. Is that a viable option for you?
from mkdocs-monorepo-plugin.
Thank you for your answer. We changed the site-name
's to include underscores instead of slashes. And we'll make a note not to include slashes in future sitenames.
from mkdocs-monorepo-plugin.
Related Issues (20)
- Does mkdocs-monorepo-plugin still work with mkdocstrings?
- Will you maintain this plugin even with the new Mkdocs Insiders Projects Plugin? HOT 7
- DeprecationWarning: warning_filter
- Support `exclude_docs`
- Python 3.12 Compatibility HOT 1
- Support for different repos for referencing
- Include docs from outside main directory HOT 2
- Error when no `nav` and `docs_dir` are specified HOT 1
- Question: *include HOT 1
- Merge subdirectories into the same tree? HOT 4
- Running tests fail
- Question: Is it possible to point to multiple repo_url's? HOT 5
- Is additional configuration required in order to use Git Submodules? HOT 4
- Error when trying to do mkdocs serve
- Unable to use includes HOT 2
- Feature Request: Github Discussions HOT 1
- support edit_uri_template by using at least mkdocs >=1.4.0 HOT 2
- Status of the Project HOT 4
- monorepo with submodules (empty) HOT 5
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from mkdocs-monorepo-plugin.