search

squidfunk / mkdocs-material

Documentation that simply works
https://squidfunk.github.io/mkdocs-material/
MIT License
20.91k stars 3.54k forks source link

Python Jinja2 Exception for ".icons/fontawesome/solid/home.svg" when Building or Serving Site #3572

Closed ghost closed 2 years ago

ghost commented 2 years ago

Contribution guidelines

I've found a bug and checked that ...

Description

Unable to Build or Serve Site, gives a Python Jinja2 Exception, it seems to be related to .icons/fontawesome/solid/home.svg

Expected behaviour

I would expect to be able to build the site without any exceptions, and serve it to view my current site for testing.

Actual behaviour

I get an exception when building;

root@unraid [Fri Feb 11 12:54]: /mnt/user/Config/Documentation# docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material build
INFO     -  Cleaning site directory
INFO     -  Building documentation to directory: /docs/site
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 1128, in __call__
    return self.main(*args, **kwargs)
  File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1053, in main
    rv = self.invoke(ctx)
  File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1659, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1395, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/usr/local/lib/python3.9/site-packages/click/core.py", line 754, in invoke
    return __callback(*args, **kwargs)
  File "/usr/local/lib/python3.9/site-packages/mkdocs/__main__.py", line 187, in build_command
    build.build(config.load_config(**kwargs), dirty=not clean)
  File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/build.py", line 306, in build
    _build_theme_template(template, env, files, config, nav)
  File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/build.py", line 111, in _build_theme_template
    output = _build_template(template_name, template, files, config, nav)
  File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/build.py", line 90, in _build_template
    output = template.render(context)
  File "/usr/local/lib/python3.9/site-packages/jinja2/environment.py", line 1291, in render
    self.environment.handle_exception()
  File "/usr/local/lib/python3.9/site-packages/jinja2/environment.py", line 925, in handle_exception
    raise rewrite_traceback_stack(source=source)
  File "/usr/local/lib/python3.9/site-packages/material/404.html", line 4, in top-level template code
    {% extends "main.html" %}
  File "/usr/local/lib/python3.9/site-packages/material/main.html", line 4, in top-level template code
    {% extends "base.html" %}
  File "/usr/local/lib/python3.9/site-packages/material/base.html", line 175, in top-level template code
    {% block footer %}
  File "/usr/local/lib/python3.9/site-packages/material/base.html", line 176, in block 'footer'
    {% include "partials/footer.html" %}
  File "/usr/local/lib/python3.9/site-packages/material/partials/footer.html", line 45, in top-level template code
    {% include "partials/social.html" %}
  File "/usr/local/lib/python3.9/site-packages/material/partials/social.html", line 12, in top-level template code
    {% include ".icons/" ~ social.icon ~ ".svg" %}
  File "/usr/local/lib/python3.9/site-packages/jinja2/loaders.py", line 214, in get_source
    raise TemplateNotFound(template)
jinja2.exceptions.TemplateNotFound: .icons/fontawesome/solid/home.svg

With Verbose Option, I get this;

root@unraid [Fri Feb 11 13:04]: /mnt/user/Config/Documentation# docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material build --verbose
DEBUG    -  Loading configuration file: /docs/mkdocs.yml
DEBUG    -  Loaded theme configuration for 'material' from
            '/usr/local/lib/python3.9/site-packages/material/mkdocs_theme.yml': {'language': 'en', 'direction': None,
            'features': [], 'palette': {'primary': None, 'accent': None}, 'font': {'text': 'Roboto', 'code': 'Roboto
            Mono'}, 'icon': None, 'favicon': 'assets/images/favicon.png', 'include_search_page': False,
            'search_index_only': True, 'static_templates': ['404.html']}
DEBUG    -  Config value: 'config_file_path' = '/docs/mkdocs.yml'
DEBUG    -  Config value: 'site_name' = 'REDACTED'
DEBUG    -  Config value: 'nav' = None
DEBUG    -  Config value: 'pages' = None
DEBUG    -  Config value: 'site_url' = 'http://docs.REDACTED/'
DEBUG    -  Config value: 'site_description' = None
DEBUG    -  Config value: 'site_author' = 'REDACTED REDACTED'
DEBUG    -  Config value: 'theme' = Theme(name='material', dirs=['/usr/local/lib/python3.9/site-packages/material',
            '/usr/local/lib/python3.9/site-packages/mkdocs/templates'], static_templates=['404.html', 'sitemap.xml'],
            locale=Locale(language='en', territory=''), language='en', direction=None, features=['navigation.indexes',
            'navigation.instant', 'navigation.sections', 'navigation.tabs', 'navigation.tabs.sticky', 'navigation.top',
            'navigation.tracking', 'search.highlight', 'search.suggest'], palette=[{'scheme': 'slate', 'primary': 'red',
            'accent': 'red', 'toggle': {'icon': 'material/toggle-switch-off-outline', 'name': 'Switch to Light Mode'}},
            {'scheme': 'default', 'primary': 'indigo', 'accent': 'indigo', 'toggle': {'icon': 'material/toggle-switch',
            'name': 'Switch to Dark Mode'}}], font={'text': 'Roboto', 'code': 'Roboto Mono'}, icon={'repo':
            'fontawesome/brands/gitlab'}, favicon='assets/images/favicon.png', include_search_page=False,
            search_index_only=True)
DEBUG    -  Config value: 'docs_dir' = '/docs/Main'
DEBUG    -  Config value: 'site_dir' = '/docs/site'
DEBUG    -  Config value: 'copyright' = 'Copyright &copy; 2017 - 2022 REDACTED REDACTED'
DEBUG    -  Config value: 'google_analytics' = None
DEBUG    -  Config value: 'dev_addr' = Address(host='127.0.0.1', port=8000)
DEBUG    -  Config value: 'use_directory_urls' = True
DEBUG    -  Config value: 'repo_url' = 'https://gitlab.REDACTED/config/documentation/'
DEBUG    -  Config value: 'repo_name' = 'GitLab'
DEBUG    -  Config value: 'edit_uri' = 'edit/master/'
DEBUG    -  Config value: 'extra_css' = []
DEBUG    -  Config value: 'extra_javascript' = []
DEBUG    -  Config value: 'extra_templates' = []
DEBUG    -  Config value: 'markdown_extensions' = ['toc', 'tables', 'fenced_code', 'admonition', 'attr_list',
            'pymdownx.keys', 'pymdownx.superfences', 'pymdownx.tabbed', 'pymdownx.tilde']
DEBUG    -  Config value: 'mdx_configs' = {'pymdownx.tabbed': {'alternate_style': True}}
DEBUG    -  Config value: 'strict' = False
DEBUG    -  Config value: 'remote_branch' = 'gh-pages'
DEBUG    -  Config value: 'remote_name' = 'origin'
DEBUG    -  Config value: 'extra' = {'social': [{'icon': 'fontawesome/solid/home', 'link': 'https://proxy.REDACTED',
            'name': 'Dashboard'}, {'icon': 'fontawesome/solid/desktop', 'link': 'https://unraid.REDACTED', 'name':
            'unRAID'}, {'icon': 'fontawesome/solid/route', 'link': 'https://opnsense.REDACTED', 'name': 'OPNsense'},
            {'icon': 'fontawesome/brands/gitlab', 'link': 'https://gitlab.REDACTED', 'name': 'GitLab'}, {'icon':
            'fontawesome/solid/clipboard-check', 'link': 'https://grafana.REDACTED', 'name': 'Grafana'}, {'icon':
            'fontawesome/solid/laptop-code', 'link': 'https://code.REDACTED/?folder=/data/Config/Documentation/Main',
            'name': 'Docs Code-Server'}]}
DEBUG    -  Config value: 'plugins' = PluginCollection([('search', <mkdocs.contrib.search.SearchPlugin object at
            0x1459cc2c5220>)])
INFO     -  Cleaning site directory
INFO     -  Building documentation to directory: /docs/site
DEBUG    -  Reading markdown pages.
DEBUG    -  Reading: README.md
DEBUG    -  Reading: Data/Data-Categories.md
DEBUG    -  Reading: Data/Data-Locations.md
DEBUG    -  Reading: Data/Naming-Conventions.md
DEBUG    -  Reading: Data/__Data.md
DEBUG    -  Reading: Data/Backups/index.md
DEBUG    -  Reading: Data/Backups/Threat-Mitigations.md
DEBUG    -  Reading: Data/Backups/Local/Backup-Server.md
DEBUG    -  Reading: Data/Backups/Local/Misc.md
DEBUG    -  Reading: Data/Backups/Local/unRAID-Backup-Archives.md
DEBUG    -  Reading: Data/Backups/Portable/personal-laptop.md
DEBUG    -  Reading: Data/Backups/Remote/Summary.md
DEBUG    -  Reading: Data/Curation/index.md
DEBUG    -  Reading: Data/Curation/archive-git-projects.md
DEBUG    -  Reading: Development/fetch-upstream.md
DEBUG    -  Reading: Development/ytdl.md
DEBUG    -  Reading: Development/Ansible/README.md
DEBUG    -  Reading: Development/Ansible/WinRM.md
DEBUG    -  Reading: Development/stPyTools/ddns.md
DEBUG    -  Reading: Development/stPyTools/rclone.md
DEBUG    -  Reading: Guides/adding-a-new-service.md
DEBUG    -  Reading: Guides/power-outage.md
DEBUG    -  Reading: Guides/Backups/Creating-an-offsite-Backup.md
DEBUG    -  Reading: Guides/Backups/create-photo-usb.md
DEBUG    -  Reading: Guides/Backups/unRAID-to-BackupPC.md
DEBUG    -  Reading: Guides/Knowledge Base/import.md
DEBUG    -  Reading: Guides/Knowledge Base/Linux/common-setup.md
DEBUG    -  Reading: Guides/Knowledge Base/Linux/useful-linux-commands.md
DEBUG    -  Reading: Guides/Knowledge Base/Linux/useful-linux-log-filtering-commands.md
DEBUG    -  Reading: Guides/Knowledge Base/Linux/cPanel/block-wordpress-attacks.md
DEBUG    -  Reading: Guides/Knowledge Base/Windows/setup_win_wsl_device.md
DEBUG    -  Reading: Guides/Knowledge Base/Windows/useful-powershell-commands.md
DEBUG    -  Reading: Guides/Knowledge Base/Windows/windows-special-administration-console.md
DEBUG    -  Reading: Guides/Linux/create-and-mount-encrypted-filesystem.md
DEBUG    -  Reading: Guides/Linux/installing-zsh-and-oh-my-zsh.md
DEBUG    -  Reading: Guides/Linux/verify-the-integrity-of-a-video.md
DEBUG    -  Reading: Guides/Tasks/daily-tasks.md
DEBUG    -  Reading: Guides/Tasks/monthly-tasks.md
DEBUG    -  Reading: Guides/Tasks/quaterly-tasks.md
DEBUG    -  Reading: Guides/Tasks/weekly-tasks.md
DEBUG    -  Reading: Guides/unRAID/RebootServer.md
DEBUG    -  Reading: Infrastructure/incidents.md
DEBUG    -  Reading: Infrastructure/Locations/index.md
DEBUG    -  Reading: Infrastructure/Locations/primary-location.md
DEBUG    -  Reading: Infrastructure/Network/IPs.md
DEBUG    -  Reading: Infrastructure/Network/Switches.md
DEBUG    -  Reading: Infrastructure/Network/Topology.md
DEBUG    -  Reading: Infrastructure/Network/VLANs.md
DEBUG    -  Reading: Infrastructure/Network/Wireless-Access-Points.md
DEBUG    -  Reading: Infrastructure/Network/OPNsense/index.md
DEBUG    -  Reading: Infrastructure/Network/OPNsense/DHCP.md
DEBUG    -  Reading: Infrastructure/Network/OPNsense/Firewall.md
DEBUG    -  Reading: Infrastructure/Network/OPNsense/Unbound.md
DEBUG    -  Reading: Infrastructure/Servers/index.md
DEBUG    -  Reading: Infrastructure/Servers/BACKUP-PC.md
DEBUG    -  Reading: Infrastructure/Servers/Backup-Host.md
DEBUG    -  Reading: Infrastructure/Servers/Backup-NAS.md
DEBUG    -  Reading: Infrastructure/Servers/Download-VM.md
DEBUG    -  Reading: Infrastructure/Servers/Kubuntu-VM.md
DEBUG    -  Reading: Infrastructure/Servers/bast-arch-1.md
DEBUG    -  Reading: Infrastructure/Servers/unRAID/README.md
DEBUG    -  Reading: Infrastructure/Servers/unRAID/Configuration.md
DEBUG    -  Reading: Infrastructure/Servers/unRAID/Docker.md
DEBUG    -  Reading: Infrastructure/Servers/unRAID/Shares.md
DEBUG    -  Reading: Infrastructure/Servers/unRAID/VMs.md
DEBUG    -  Reading: Infrastructure/Servers/unRAID/WireguardVPN.md
DEBUG    -  Reading: Infrastructure/Servers/unRAID/Plugins/README.md
DEBUG    -  Reading: Infrastructure/Servers/unRAID/Plugins/UserScripts.md
DEBUG    -  Reading: Infrastructure/Servers/unRAID/Plugins/rclone.md
DEBUG    -  Reading: Other Devices/Memory-Cards-and-Sticks.md
DEBUG    -  Reading: Other Devices/PiKVM.md
DEBUG    -  Reading: Other Devices/Portable-HDDs.md
DEBUG    -  Reading: Other Devices/REDACTED-LAPTOP-WORK.md
DEBUG    -  Reading: Other Devices/WDMyCloud.md
DEBUG    -  Reading: Other Devices/IoT/Sonoff.md
DEBUG    -  Reading: Other Devices/REDACTED-Laptop/README.md
DEBUG    -  Reading: Other Devices/REDACTED-Laptop/BrowserSearchEngines.md
DEBUG    -  Reading: Other Devices/REDACTED-Laptop/REDACTED-LAPTOP_SPECCY.md
DEBUG    -  Reading: Services/index.md
DEBUG    -  Reading: Services/KeePass.md
DEBUG    -  Reading: Services/rclone.md
DEBUG    -  Reading: Services/service-costs.md
DEBUG    -  Reading: Services/Clients/index.md
DEBUG    -  Reading: Services/Clients/2fa.md
DEBUG    -  Reading: Services/Clients/Telegraf.md
DEBUG    -  Reading: Services/Clients/Wireguard.md
DEBUG    -  Reading: Services/Clients/Zabbix-Agent.md
DEBUG    -  Reading: Services/External/Domains-and-DNS.md
DEBUG    -  Reading: Services/External/GSuite.md
DEBUG    -  Reading: Services/External/Monitoring.md
DEBUG    -  Reading: Services/External/Office365.md
DEBUG    -  Reading: Services/External/SMTP.md
DEBUG    -  Reading: Services/Internal/DNS.md
DEBUG    -  Reading: Services/Internal/Databases.md
DEBUG    -  Reading: Services/Internal/GitLab.md
DEBUG    -  Reading: Services/Internal/Guacamole.md
DEBUG    -  Reading: Services/Internal/Mattermost.md
DEBUG    -  Reading: Services/Internal/Nessus.md
DEBUG    -  Reading: Services/Internal/PiHole.md
DEBUG    -  Reading: Services/Internal/SWAG.md
DEBUG    -  Reading: Services/Internal/TIG.md
DEBUG    -  Reading: Services/Internal/Zabbix.md
DEBUG    -  Reading: Services/Internal/Media/Plex-Meta-Manager.md
DEBUG    -  Reading: Services/Internal/Media/Tautulli.md
DEBUG    -  Copying static assets.
DEBUG    -  Copying media file: 'Infrastructure/Locations/PL_Desk_Layout.drawio'
DEBUG    -  Copying media file: 'Infrastructure/Locations/PL_Desk_Layout.png'
DEBUG    -  Copying media file: 'Infrastructure/Locations/PL_Downstairs.drawio'
DEBUG    -  Copying media file: 'Infrastructure/Locations/PL_Downstairs.png'
DEBUG    -  Copying media file: 'Infrastructure/Locations/PL_Upstairs.drawio'
DEBUG    -  Copying media file: 'Infrastructure/Locations/PL_Upstairs.png'
DEBUG    -  Copying media file: 'Infrastructure/Locations/PL_Upstairs_Furniture.drawio'
DEBUG    -  Copying media file: 'Infrastructure/Locations/PL_Upstairs_Furniture.png'
DEBUG    -  Copying media file: 'Infrastructure/Network/Topology.drawio'
DEBUG    -  Copying media file: 'Infrastructure/Network/Topology.png'
DEBUG    -  Copying media file: 'assets/images/favicon.png'
DEBUG    -  Copying media file: 'assets/javascripts/bundle.5a9542cf.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/bundle.5a9542cf.min.js.map'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.ar.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.da.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.de.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.du.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.es.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.fi.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.fr.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.hi.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.hu.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.it.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.ja.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.jp.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.multi.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.nl.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.no.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.pt.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.ro.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.ru.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.stemmer.support.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.sv.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.th.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.tr.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.vi.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/min/lunr.zh.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/tinyseg.js'
DEBUG    -  Copying media file: 'assets/javascripts/lunr/wordcut.js'
DEBUG    -  Copying media file: 'assets/javascripts/workers/search.092fa1f6.min.js'
DEBUG    -  Copying media file: 'assets/javascripts/workers/search.092fa1f6.min.js.map'
DEBUG    -  Copying media file: 'assets/stylesheets/main.50e68009.min.css'
DEBUG    -  Copying media file: 'assets/stylesheets/main.50e68009.min.css.map'
DEBUG    -  Copying media file: 'assets/stylesheets/palette.e6a45f82.min.css'
DEBUG    -  Copying media file: 'assets/stylesheets/palette.e6a45f82.min.css.map'
DEBUG    -  Building theme template: 404.html
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 1128, in __call__
    return self.main(*args, **kwargs)
  File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1053, in main
    rv = self.invoke(ctx)
  File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1659, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1395, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/usr/local/lib/python3.9/site-packages/click/core.py", line 754, in invoke
    return __callback(*args, **kwargs)
  File "/usr/local/lib/python3.9/site-packages/mkdocs/__main__.py", line 187, in build_command
    build.build(config.load_config(**kwargs), dirty=not clean)
  File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/build.py", line 306, in build
    _build_theme_template(template, env, files, config, nav)
  File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/build.py", line 111, in _build_theme_template
    output = _build_template(template_name, template, files, config, nav)
  File "/usr/local/lib/python3.9/site-packages/mkdocs/commands/build.py", line 90, in _build_template
    output = template.render(context)
  File "/usr/local/lib/python3.9/site-packages/jinja2/environment.py", line 1291, in render
    self.environment.handle_exception()
  File "/usr/local/lib/python3.9/site-packages/jinja2/environment.py", line 925, in handle_exception
    raise rewrite_traceback_stack(source=source)
  File "/usr/local/lib/python3.9/site-packages/material/404.html", line 4, in top-level template code
    {% extends "main.html" %}
  File "/usr/local/lib/python3.9/site-packages/material/main.html", line 4, in top-level template code
    {% extends "base.html" %}
  File "/usr/local/lib/python3.9/site-packages/material/base.html", line 175, in top-level template code
    {% block footer %}
  File "/usr/local/lib/python3.9/site-packages/material/base.html", line 176, in block 'footer'
    {% include "partials/footer.html" %}
  File "/usr/local/lib/python3.9/site-packages/material/partials/footer.html", line 45, in top-level template code
    {% include "partials/social.html" %}
  File "/usr/local/lib/python3.9/site-packages/material/partials/social.html", line 12, in top-level template code
    {% include ".icons/" ~ social.icon ~ ".svg" %}
  File "/usr/local/lib/python3.9/site-packages/jinja2/loaders.py", line 214, in get_source
    raise TemplateNotFound(template)
jinja2.exceptions.TemplateNotFound: .icons/fontawesome/solid/home.svg

When serving I don't get an exception, it just stops;

root@unraid [Fri Feb 11 12:52]: /mnt/user/Config/Documentation# docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material

INFO     -  Building documentation...
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     -  Cleaning site directory
.icons/fontawesome/solid/home.svg

EDIT: When changing the Docker Tag to 8.1.10 instead of latest / 8.1.11, it works as expected (no changes to config etc are made), so looks like something in v8.1.11 maybe?

Steps to reproduce

Pull Latest Docker Container. Try and Build Site with Config below. Observe Error.

Package versions

Docker Container on Latest Tag;

root@unraid [Fri Feb 11 13:04]: /mnt/user/Config/Documentation# docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material -V
mkdocs, version 1.2.3 from /usr/local/lib/python3.9/site-packages/mkdocs (Python 3.9)

Configuration

extra:
  social:
    - icon: fontawesome/solid/home #address-card #desktop (as an alt-icon)
      link: https://REDACTED
      name: Dashboard
    - icon: fontawesome/solid/desktop
      link: https://REACATED
      name: unRAID
    - icon: fontawesome/solid/route
      link: REDACTED
      name: OPNsense
    - icon: fontawesome/brands/gitlab
      link: REACTED
      name: GitLab
    - icon: fontawesome/solid/clipboard-check
      link: REDACTED
      name: Grafana
    - icon: fontawesome/solid/laptop-code
      link: REDACTED
      name: Docs Code-Server
markdown_extensions:
  - admonition
  - attr_list
  - pymdownx.keys
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tilde
theme:
  name: 'material'
  features:
    - navigation.indexes
    - navigation.instant
    - navigation.sections
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.top
    - navigation.tracking
    - search.highlight
    - search.suggest
  icon:
    repo: fontawesome/brands/gitlab
  palette:
    - scheme: slate
      primary: red #amber #blue grey
      accent: red #teal #lime #amber
      toggle:
        icon: material/toggle-switch-off-outline
        name: Switch to Light Mode
    - scheme: default
      primary: indigo
      accent: indigo
      toggle:
        icon: material/toggle-switch
        name: Switch to Dark Mode
plugins:
  - search:
      lang: en
copyright: Copyright &copy; 2017 - 2022
docs_dir: /docs/Main
edit_uri: edit/master/
repo_name: GitLab
repo_url: https://REDACTED/config/documentation
site_author: REDACTED
site_name: REDACTED
site_url: http://REDACTED

System information

squidfunk commented 2 years ago

Thanks for reporting. 8.1.11 ships the latest FontAwesome major version (v5), so some icons might have been renamed by the maintainers of FontAwesome. Unfortunately, it's impossible for me to keep track of all icons (we're shipping more than 8k), so you have to check the FontAwesome repository how this icon is now called, or if it's still contained in the free version of FontAwesome.

The release notes should've contained a notice regarding the major upgrade, that's an oversight on my side. I'll add a note that 8.1.11 ships the new version. Closing, as it's nothing we can fix – authors have to switch icons.

squidfunk commented 2 years ago

Updated the changelog in 92c11bb1e.

chrieke commented 2 years ago

For anyone with the same issue, home was changed to house. fontawesome/solid/house