I've seen a number of suggestions for the initial "ignore everything" rule, both here on SO and on other sites, but I found most of them to have thir own annoying usage issues. this has given rise to projects like the distributable .gitinclude.NET
and the GH Pages hosted git-do-not-ignore
, each of which simply help make this less tedious to manutain.
each of these (and many other blog posts) recommend starting out with a simply *
to, quite literally, ignore all files and folders in the current root.
thereafter, including a file is "as simple" as prefixing the path with !
, such as !.gitignore
to ensure our repo doesn't ignore it's own .gitignore
rules file.
the down side of this, is that when Git encounters an ignored folder, for performance reasons it does not check it's contents. trying to not ignore a file in a nested path gets very cumbersome:
# ...when ignoring all files and folders in the current root
*
!custom_path # allow Git to look inside this folder
custom_path/* # but ignore everything it contains
!custom_path/extras # allow Git to look inside this folder
custom_path/extras/* # but ignore everything it contains
!custom_path/extras/path_to_keep # allow Git to see the file or folder you want to commit
so to offer an alternative idea, I've just configured a .gitignore
file in the root of my Windows user profile folder, starting with **/*
instead of the commonly seen *
or *.*
.
thereafter, each path that I want to explicitly include requires only one entry per tree level. slightly simplifying the previous example to the following:
# ...when ignoring all files recursively from the current root
**/*
!custom_path # allow Git to look inside this folder
!custom_path/extras # allow Git to look inside this folder
!custom_path/extras/path_to_keep # allow Git to see the file or folder you want to commit
this is not exactly a massive difference, but it is enough of a difference to make the file much easier to read and maintain, especially when trying to "un-ignore" a file nested about 5 levels deep...