Favicon setting creates orphan file or incorrect file
See original GitHub issueI checked that…
- … the documentation does not mention anything about my problem
- … the problem doesn’t occur with the default MkDocs template
- … the problem is not in any of my customizations (CSS, JS, template)
- … there are no open or closed issues that are related to my problem
Description
- If you specifiy a custom favicon via the
faviconsetting, Material still generates the defaultfavicon.pngfile
and puts it in assets/images/. The generated help correctly uses the custom favicon, but an orphanfavicon.pngfile is included in the output. - If you specify a custom favicon via the
faviconsetting and the path to the custom icon is[docs_dir]/assets/images/favicon.png, the custom icon is not included in the output. Instead, the default icon
is used.
Expected behavior
The correct favicon should be displayed in the output. No orphan favicon.png file should be included in the output.
Actual behavior
See description.
Steps to reproduce the bug
- Create an empty project.
- In
mkdocs.yml, set thefaviconsetting to any path (causes issue 1) or toassets/images/favicon.png(causes issue 2).
Package versions
- Python:
3.7.3. - MkDocs:
1.0.4 - Material:
4.4.2
Project configuration
Issue 1:
theme:
name: material
favicon: favicon.ico
Issue 2:
theme:
name: material
favicon: assets/images/favicon.png
System information
- OS: Windows 10
- Browser: Any
Issue Analytics
- State:
- Created 4 years ago
- Comments:16 (15 by maintainers)
Top Results From Across the Web
Favicon Not Showing Up - How to Fix In Chrome, Wordpress ...
Common reasons your Favicon is not showing up · Syntax errors · Your browser has cached your site as one without a favicon...
Read more >Files that have no remaining usages are no longer deleted by ...
Because it no longer was in use, Drupal 8 settings would have downgraded the file from "permanent" to "temporary" after. The file is...
Read more >Troubleshoot links - Adobe Support
Use the Check Links feature to search for broken links and orphaned files (files that still exist in the site but that aren't...
Read more >Virtual machines appear as invalid or orphaned in vCenter ...
An "invalid" virtual machine is a VM that is inaccessible because the ESXi host is offline or inaccessible, the VM configuration file is ......
Read more >3 Ways to Recover Orphaned File - Wondershare Recoverit
This makes it necessary to leave the orphan files in the system. ... CHKDSK tries to recover orphaned files and also fixes any...
Read more >
Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found

Hmm. I installed the latest dev version via
pip install https://github.com/mkdocs/mkdocs/archive/master.tar.gz, but both issues persist. Which is a little weird since @neoword did the same (as mentioned in https://github.com/mkdocs/mkdocs/pull/1672) and it worked for him. Or do I specifically have to work off commit #f200a60? How do I do that?But yeah, I suppose this issue can be closed anyway. Thanks for your time!
@wilhelmer could you please create a new issue in the MkDocs project with a full summary of the problem (minimal reproducible example). Be sure to include any system specific information. If you can reproduce the problem with the default
mkdocstheme, that would be even better (if you can’t, then include that detail as well). Feel free to link to both this issue and mkdocs/mkdocs#1672.I’m certain that this is not an issue specific to Material and we are creating a lot of noise for @squidfunk.