Project.txt

:Project:  =  A collection of files and folders, which are shown in Sidebar
    Benefit:
        Quick open file in project: ctrl+p  [[Sublime Text.txt#Goto File]]
        Search amongst all files in project: [[Sublime Text.txt#Find in Files]]
        Goto Symbol and Goto Definition in project [[Sublime Text.txt#Goto Symbol]]
    There’s always an active project, whether it’s explicit or implicit
    .sublime-project
        Indicate: which files and folders are included
        Support relative path (i.e: "path": "..\\..\\User")
        This file can be stored anywhere
    .sublime-workspace files
        Workspaces  =  different views into the same project i.e: Specify which files are opened, which pane is visible
        only allow absolute path
        This file can be stored anywhere
    \Data\Local\Session.sublime_session
        Affect Recent Project (menu Project > Open recent  and  Project > Quick switch project). This is troublesome because:
        only allow absolute path => modify path lead to sublime_text.exe will confuse this file:
            Symptom: Recent Project are empty, Sidebar goes blank, no tab is open even if "remember_open_files": true
            Treatment:
                Project > Open recent > Clear items.  Then  Open .sublime-project individually
                In bad case, you may need to delete all .sublime-workspace files

Usage:
    To add file/folder to project:
        Menu Project > Add folder to project
        OR: Drag & drop onto Sidebar (View > Sidebar)  [[Sublime Text.txt#Side bar]]
    To switch between projects (ctrl+alt+p)
    To delete invalid project:
        Menu Project → open Recent → Clear recent
        OR: Open \Data\Local\Session.sublime_session → Edit section "recent_workspaces"
    To edit project file: use this .py plugin: sublime.active_window().open_file('E:\\Utilities\\Sublime Text\\x64\\Data\\Packages\\User\\Project\\Autohotkey.sublime-project')

.sublime-project  (JSON format)
    "folders":
        "path": can be relative to project directory, or an absolute path [Mandatory]
        "name": Text to display on the side bar [optional]
        Optionally have settings:
            file_exclude_patterns
            file_include_patterns
            folder_exclude_patterns
            folder_include_patterns
            follow_symlinks
            These settings are set for each folder in each project.
            To apply global inclue/exclude pattern to all projects:
                Preferences > Settings - User
                Only 3 options available:
                    "folder_exclude_patterns":
                    "file_exclude_patterns":
                    "binary_file_patterns":  //show up in the side bar, but won't be included in Goto Anything or Find in Files
        Converted projects from earlier versions may have a mount_points entry under folders. If you wish to use the exclude patterns, you'll need to change to the above format.
    "settings": override regular user settings but not syntax specific settings.
    "build_systems": Add to regular Tools/Build Systems menu [[Build.txt#.sublime-build]]
    Example:
        {
            "folders":
            [
               {
                  "path": "D:\\Doc\\Quick_search\\IT",
                  "folder_exclude_patterns": ["backup"],
                  "follow_symlinks": true,
                  "file_exclude_patterns": ["*.doc", "*.docx"]
               },
               {
                  "path": "docs",
                  "name": "Documentation",
                  "file_exclude_patterns": ["*.css"]
               }
            ],
            "settings":
            {
               "tab_size": 8
            },
            "build_systems":
            [
               {
                  "name": "List",
                  "cmd": ["ls"]
               }
            ]
        }