Changing admonition icon set not working

[5nafu]

We are currently trying to change the admonition icons as explained in the material theme documentation.

Our mkdocs.yaml looks like this:

site_name: '...'
site_description: '...'
#uncomment the below lines if you want to enable the edit button in your techdocs
edit_uri: blob/main/docs/ #don't change it, just uncomment
repo_url: '...'
theme:
  name: material
  palette:
    scheme: default
  features:
    - toc.follow
    - navigation.indexes
    - content.code.copy
    - content.code.annotate
  icon:
    admonition:
      example: fontawesome/solid/flask
plugins:
  - techdocs-core
  - awesome-pages
markdown_extensions:
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
  - admonition
  - pymdownx.details
  - mdx_truly_sane_lists:
      nested_indent: 4

Unfortunately, the icons stay the same when we try to run a preview of the documentation with npx @techdocs/cli serve. If we switch to mkdocs (mkdocs serve) directly, the icons work as expected.

We found an issue squidfunk/mkdocs-material#3987 suggesting that removing the palette setting might solve the issue, but this did not help in out case.

[vishes-shell]

@5nafu sorry to interrupt, it's not really about changeing admonition icom.

Have you managed to make annotate working within backstage instance?

i have:

• mkdocs serve - works
• techdocs-cli build - works
• techdocs page within backstage - don't work

i really want to make it work within backstage...

[daneah]

@vishes-shell According to #128 code annotation isn't supported for (understandable) deeper architectural reasons, but I am curious as well.

[vanchaxy]

@vishes-shell @daneah I have updated #128 with a solution for annotation support if you are still interested