Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cannot override config of extensions appended in techdocs-core #220

Open
kunickiaj opened this issue Sep 16, 2024 · 4 comments
Open

Cannot override config of extensions appended in techdocs-core #220

kunickiaj opened this issue Sep 16, 2024 · 4 comments
Labels

Comments

@kunickiaj
Copy link
Contributor

kunickiaj commented Sep 16, 2024

For example, if one wants to enable slugify on content tabs, they cant because the extension is always appended even if already configured in the user's mkdocs.yml

I saw #214 which i think intended to address this issue, but i still cant get configuration to get merged with the default atechdocs one.

config["markdown_extensions"].append("pymdownx.tabbed")

Have also tried

plugins:
  - techdocs-core
markdown_extensions:
  - pymdownx.extra:
      pymdownx.tabbed:
        slugify: !!python/object/apply:pymdownx.slugs.slugify
          kwds:
            case: lower

I suspect the issue is that while #214 removed the superfences plugin from the list of appended, it did not remove the others provided by pymdownx.extra still resulting in impossible configuration for those.

@kunickiaj kunickiaj closed this as not planned Won't fix, can't repro, duplicate, stale Sep 16, 2024
@kunickiaj kunickiaj reopened this Sep 16, 2024
@kunickiaj
Copy link
Contributor Author

After some more investigation I see that the config is correctly applied in normal mkdocs serve (on 8080) even with the techdocs-core plugin added so it seems something is being stripped out (dont know if this depends on some js) but something in techdocs is preventing the generation of the slugified anchor links.

@deejay1
Copy link
Contributor

deejay1 commented Sep 25, 2024

@kunickiaj which version of techdocs-cli are you using? this was only recently fixed and should be in backstage 1.31.1

@kunickiaj
Copy link
Contributor Author

Using techdocs-core 1.4.2 and backstage 1.30.1 and whatever the latest CLI is I think.

I did try to patch around this but still had no success in the slugify tabs to work.

Copy link

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

@github-actions github-actions bot added the stale label Nov 27, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants