Ignore hidden and editor temporary files in livereload file watcher

Filter out files that match common editor temporary/backup file
patterns in the livereload file watcher callback:

- Files starting with '.' (dotfiles, vim swap files like .foo.md.swp)
- Files ending with '~' (backup files)
- Files matching '#*#' (Emacs auto-save files)

This prevents live reload from being triggered repeatedly by
editor temporary files, which was especially problematic for
vim users where editing .md files creates .foo.md.swp files.

Fixes #2519

Author: shenxianpeng

mkdocs/livereload/__init__.py

@@ -162,6 +162,17 @@ def watch(self, path: str, func: None = None, *, recursive: bool = True) -> None
         def callback(event):
             if event.is_directory:
                 return
+            # Ignore hidden files and editor temporary/backup files:
+            # - .dotfiles (vim swap .foo.md.swp, .foo.md.swo, .foo.md.swn, etc.)
+            # - files ending with ~ (editor backup)
+            # - #files# matching Emacs auto-save pattern
+            name = os.path.basename(event.src_path)
+            if (
+                name.startswith(".")
+                or name.endswith("~")
+                or (name.startswith("#") and name.endswith("#"))
+            ):
+                return
             log.debug(str(event))
             with self._rebuild_cond:
                 self._want_rebuild = True