question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Favicon setting creates orphan file or incorrect file

See original GitHub issue

I 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

  1. If you specifiy a custom favicon via the favicon setting, Material still generates the default favicon.png file favicon and puts it in assets/images/. The generated help correctly uses the custom favicon, but an orphan favicon.png file is included in the output.
  2. If you specify a custom favicon via the favicon setting 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 favicon 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

  1. Create an empty project.
  2. In mkdocs.yml, set the favicon setting to any path (causes issue 1) or to assets/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:closed
  • Created 4 years ago
  • Comments:16 (15 by maintainers)

github_iconTop GitHub Comments

1reaction
wilhelmercommented, Oct 2, 2019

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!

0reactions
waylancommented, Oct 4, 2019

@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 mkdocs theme, 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.

Read more comments on GitHub >

github_iconTop 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 >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found