// While you can edit this file, it's best to put your changes in

// "User/Preferences.sublime-settings", which overrides the settings in here.
//
// Settings may also be placed in file type specific options files, for
// example, in Packages/Python/Python.sublime-settings for python files.
{
    // Sets the colors used within the text area
    //主題文件
    "color_scheme": "Packages/Color Scheme - Default/Monokai.tmTheme",

    // Note that the font_face and font_size are overriden in the platform
    // specific settings file, for example, "Preferences (Linux).sublime-settings".
    // Because of this, setting them here will have no effect: you must set them
    // in your User File Preferences.
    //字體樣式、大小
    "font_face": "",
    "font_size": 10,

    // Valid options are "no_bold", "no_italic", "no_antialias", "gray_antialias",
    // "subpixel_antialias", "no_round" (OS X only) and "directwrite" (Windows only)
    // 字體選項：no_bold不顯示粗體字，no_italic不顯示斜體字，no_antialias和no_antialias關(guān)閉反鋸齒
    // subpixel_antialias和no_round是OS X系統(tǒng)獨有的
    // directwrite是Windows系統(tǒng)獨有的
    "font_options": [],

    // Characters that are considered to separate words
    // 在文字上雙擊會全選當(dāng)前的內(nèi)容，如果里面出現(xiàn)以下字符，就會被截斷
    "word_separators": "./\\()\"'-:,.;<>~!@#$%^&*|+=[]{}`~?",

    // Set to false to prevent line numbers being drawn in the gutter
    // 是否顯示行號
    "line_numbers": true,

    // Set to false to hide the gutter altogether
    // 是否顯示行號邊欄
    "gutter": true,

    // Spacing between the gutter and the text
    // 行號邊欄和文字的間距
    "margin": 4,

    // Fold buttons are the triangles shown in the gutter to fold regions of text
    // 是否顯示代碼折疊按鈕
    "fold_buttons": true,

    // Hides the fold buttons unless the mouse is over the gutter
    // 不管鼠標(biāo)在不在行號邊欄，代碼折疊按鈕一直顯示
    "fade_fold_buttons": true,

    // Columns in which to display vertical rulers
    //列顯示垂直標(biāo)尺，在中括號里填入數(shù)字，寬度按字符計算
    "rulers": [],

    // Set to true to turn spell checking on by default
    // 是否打開拼寫檢查
    "spell_check": false,

    // The number of spaces a tab is considered equal to
    // Tab鍵制表符寬度
    "tab_size": 4,

    // Set to true to insert spaces when tab is pressed
    // 設(shè)為true時，縮進(jìn)和遇到Tab鍵時使用空格替代
    "translate_tabs_to_spaces": false,

    // If translate_tabs_to_spaces is true, use_tab_stops will make tab and
    // backspace insert/delete up to the next tabstop
    // translate_tabs_to_spaces設(shè)置為true，Tab和Backspace的刪除/插入作用于制表符寬度
    // 否則作用于單個空格
    "use_tab_stops": true,

    // Set to false to disable detection of tabs vs. spaces on load
    // false時禁止在載入的時候檢測制表符和空格
    "detect_indentation": true,

    // Calculates indentation automatically when pressing enter
    // 按回車時，自動與制表位對齊
    "auto_indent": true,

    // Makes auto indent a little smarter, e.g., by indenting the next line
    // after an if statement in C. Requires auto_indent to be enabled.
    //針對C語言的
    "smart_indent": true,

    // Adds whitespace up to the first open bracket when indenting. Requires
    // auto_indent to be enabled.
    // 需要啟用auto_indent，第一次打開括號縮進(jìn)時插入空格？（沒測試出來效果…）
    "indent_to_bracket": false,

    // Trims white space added by auto_indent when moving the caret off the
    // line.
    // 顯示對齊的白線是否根據(jù)回車、tab等操作自動填補(bǔ)
    "trim_automatic_white_space": true,

    // Disables horizontal scrolling if enabled.
    // May be set to true, false, or "auto", where it will be disabled for
    // source code, and otherwise enabled.
    // 是否自動換行，如果選auto，需要加雙引號
    "word_wrap": "auto",

    // Set to a value other than 0 to force wrapping at that column rather than the
    // window width
    // 設(shè)置窗口內(nèi)文字區(qū)域的寬度
    "wrap_width": 0,

    // Set to false to prevent word wrapped lines from being indented to the same
    // level
    // 防止被縮進(jìn)到同一級的字換行
    "indent_subsequent_lines": true,

    // Draws text centered in the window rather than left aligned
    // 如果沒有定義過，則文件居中顯示（比如新建的文件）
    "draw_centered": false,

    // Controls auto pairing of quotes, brackets etc
    // 自動匹配引號，括號等
    "auto_match_enabled": true,

    // Word list to use for spell checking
    // 拼寫檢查的單詞列表路徑
    "dictionary": "Packages/Language - English/en_US.dic",

    // Set to true to draw a border around the visible rectangle on the minimap.
    // The color of the border will be determined by the "minimapBorder" key in
    // the color scheme
    // 代碼地圖的可視區(qū)域部分是否加上邊框，邊框的顏色可在配色方案上加入minimapBorder鍵
    "draw_minimap_border": false,

    // If enabled, will highlight any line with a caret
    // 突出顯示當(dāng)前光標(biāo)所在的行
    "highlight_line": false,

    // Valid values are "smooth", "phase", "blink", "wide" and "solid".、
    // 設(shè)置光標(biāo)閃動方式
    "caret_style": "smooth",

    // Set to false to disable underlining the brackets surrounding the caret
    // 是否特殊顯示當(dāng)前光標(biāo)所在的括號、代碼頭尾閉合標(biāo)記
    "match_brackets": true,

    // Set to false if you'd rather only highlight the brackets when the caret is
    // next to one
    // 設(shè)為false時，只有光標(biāo)在括號或頭尾閉合標(biāo)記的兩端時，match_brackets才生效
    "match_brackets_content": true,

    // Set to false to not highlight square brackets. This only takes effect if
    // match_brackets is true
    // 是否突出顯示圓括號，match_brackets為true生效
    "match_brackets_square": true,

    // Set to false to not highlight curly brackets. This only takes effect if
    // match_brackets is true
    // 是否突出顯示大括號，match_brackets為true生效
    "match_brackets_braces": true,

    // Set to false to not highlight angle brackets. This only takes effect if
    // match_brackets is true
    // 是否突出顯示尖括號，match_brackets為true生效
    "match_brackets_angle": false,

    // Enable visualization of the matching tag in HTML and XML
    // html和xml下突出顯示光標(biāo)所在標(biāo)簽的兩端，影響HTML、XML、CSS等
    "match_tags": true,

    // Highlights other occurrences of the currently selected text
    // 全文突出顯示和當(dāng)前選中字符相同的字符
    "match_selection": true,

    // Additional spacing at the top of each line, in pixels
    // 設(shè)置每一行到頂部，以像素為單位的間距，效果相當(dāng)于行距
    "line_padding_top": 0,

    // Additional spacing at the bottom of each line, in pixels
    // 設(shè)置每一行到底部，以像素為單位的間距，效果相當(dāng)于行距
    "line_padding_bottom": 0,

    // Set to false to disable scrolling past the end of the buffer.
    // On OS X, this value is overridden in the platform specific settings, so
    // you'll need to place this line in your user settings to override it.
    // 設(shè)置為false時，滾動到文本的最下方時，沒有緩沖區(qū)
    "scroll_past_end": true,

    // This controls what happens when pressing up or down when on the first
    // or last line.
    // On OS X, this value is overridden in the platform specific settings, so
    // you'll need to place this line in your user settings to override it.
    // 控制向上或向下到第一行或最后一行時發(fā)生什么（沒明白也沒試出來）
    "move_to_limit_on_up_down": false,

    // Set to "none" to turn off drawing white space, "selection" to draw only the
    // white space within the selection, and "all" to draw all white space
    // 按space或tab時，實際會產(chǎn)生白色的點（一個空格一個點）或白色的橫線（tab_size設(shè)置的制表符的寬度），選中狀態(tài)下才能看到
    // 設(shè)置為none時，什么情況下都不顯示這些點和線
    // 設(shè)置為selection時，只顯示選中狀態(tài)下的點和線
    // 設(shè)置為all時，則一直顯示
    "draw_white_space": "selection",

    // Set to false to turn off the indentation guides.
    // The color and width of the indent guides may be customized by editing
    // the corresponding .tmTheme file, and specifying the colors "guide",
    // "activeGuide" and "stackGuide"
    // 制表位的對齊白線是否顯示，顏色可在主題文件里設(shè)置（guide，activeGuide，stackGuide）
    "draw_indent_guides": true,

    // Controls how the indent guides are drawn, valid options are
    // "draw_normal" and "draw_active". draw_active will draw the indent
    // guides containing the caret in a different color.
    // 制表位的對齊白線，draw_normal為一直顯示，draw_active為只顯示當(dāng)前光標(biāo)所在的代碼控制域
    "indent_guide_options": ["draw_normal"],

    // Set to true to removing trailing white space on save
    // 為true時，保存文件時會刪除每行結(jié)束后多余的空格
    "trim_trailing_white_space_on_save": false,

    // Set to true to ensure the last line of the file ends in a newline
    // character when saving
    // 為true時，保存文件時光標(biāo)會在文件的最后向下?lián)Q一行
    "ensure_newline_at_eof_on_save": false,

    // Set to true to automatically save files when switching to a different file
    // or application
    // 切換到其它文件標(biāo)簽或點擊其它非本軟件區(qū)域，文件自動保存
    "save_on_focus_lost": false,

    // The encoding to use when the encoding can't be determined automatically.
    // ASCII, UTF-8 and UTF-16 encodings will be automatically detected.
    // 編碼時不能自動檢測編碼時，將自動檢測ASCII, UTF-8 和 UTF-16
    "fallback_encoding": "Western (Windows 1252)",

    // Encoding used when saving new files, and files opened with an undefined
    // encoding (e.g., plain ascii files). If a file is opened with a specific
    // encoding (either detected or given explicitly), this setting will be
    // ignored, and the file will be saved with the encoding it was opened
    // with.
    // 默認(rèn)編碼格式
    "default_encoding": "UTF-8",

    // Files containing null bytes are opened as hexadecimal by default
    // 包含空字節(jié)的文件被打開默認(rèn)為十六進(jìn)制
    "enable_hexadecimal_encoding": true,

    // Determines what character(s) are used to terminate each line in new files.
    // Valid values are 'system' (whatever the OS uses), 'windows' (CRLF) and
    // 'unix' (LF only).
    // 每一行結(jié)束的時候用什么字符做終止符
    "default_line_ending": "system",

    // When enabled, pressing tab will insert the best matching completion.
    // When disabled, tab will only trigger snippets or insert a tab.
    // Shift+tab can be used to insert an explicit tab when tab_completion is
    // enabled.
    // 設(shè)置為enabled時，在一個字符串間按Tab將插入一個制表符
    // 設(shè)置為true時，按Tab會根據(jù)前后環(huán)境進(jìn)行代碼自動匹配填補(bǔ)
    "tab_completion": true,

    // Enable auto complete to be triggered automatically when typing.
    // 代碼提示
    "auto_complete": true,

    // The maximum file size where auto complete will be automatically triggered.
    // 代碼提示的大小限制
    "auto_complete_size_limit": 4194304,

    // The delay, in ms, before the auto complete window is shown after typing
    // 代碼提示延遲顯示
    "auto_complete_delay": 50,

    // Controls what scopes auto complete will be triggered in
    // 代碼提示的控制范圍
    "auto_complete_selector": "source - comment",

    // Additional situations to trigger auto complete
    // 觸發(fā)代碼提示的其他情況
    "auto_complete_triggers": [ {"selector": "text.html", "characters": "<"} ],

    // By default, auto complete will commit the current completion on enter.
    // This setting can be used to make it complete on tab instead.
    // Completing on tab is generally a superior option, as it removes
    // ambiguity between committing the completion and inserting a newline.
    // 設(shè)為false時，選擇提示的代碼按回車或點擊可以輸出出來，但選擇true時不會輸出而是直接換行
    "auto_complete_commit_on_tab": false,

    // Controls if auto complete is shown when snippet fields are active.
    // Only relevant if auto_complete_commit_on_tab is true.
    // auto_complete_commit_on_tab必須為true，控制代碼提示的活躍度
    "auto_complete_with_fields": false,

    // By default, shift+tab will only unindent if the selection spans
    // multiple lines. When pressing shift+tab at other times, it'll insert a
    // tab character - this allows tabs to be inserted when tab_completion is
    // enabled. Set this to true to make shift+tab always unindent, instead of
    // inserting tabs.
    // 設(shè)置為false，使用Shift + tab總是插入制表符
    "shift_tab_unindent": false,

    // If true, the copy and cut commands will operate on the current line
    // when the selection is empty, rather than doing nothing.
    //復(fù)制與剪切的
    "copy_with_empty_selection": true,

    // If true, the selected text will be copied into the find panel when it's
    // shown.
    // On OS X, this value is overridden in the platform specific settings, so
    // you'll need to place this line in your user settings to override it.
    // 選中的文本按Ctrl + f時，自動復(fù)制到查找面板的文本框里
    "find_selected_text": true,

    // When drag_text is enabled, clicking on selected text will begin a
    // drag-drop operation
    //拖動文本
    "drag_text": true,

    //
    // User Interface Settings
    //

    // The theme controls the look of Sublime Text's UI (buttons, tabs, scroll bars, etc)
    //主題
    "theme": "Default.sublime-theme",

    // Set to 0 to disable smooth scrolling. Set to a value between 0 and 1 to
    // scroll slower, or set to larger than 1 to scroll faster
    // 滾動的速度
    "scroll_speed": 1.0,

    // Controls side bar animation when expanding or collapsing folders
    // 左邊邊欄文件夾動畫
    "tree_animation_enabled": true,

    // Makes tabs with modified files more visible
    //高亮未保存文件
    "highlight_modified_tabs": false,
    // 標(biāo)簽頁的關(guān)閉按鈕
    "show_tab_close_buttons": true,

    // Show folders in the side bar in bold
    //在側(cè)邊欄顯示文件夾
    "bold_folder_labels": false,

    // OS X 10.7 only: Set to true to disable Lion style full screen support.
    // Sublime Text must be restarted for this to take effect.
    //開啟全屏，針對 OS X 10.7
    "use_simple_full_screen": false,

    // OS X only. Valid values are true, false, and "auto". Auto will enable
    // the setting when running on a screen 2880 pixels or wider (i.e., a
    // Retina display). When this setting is enabled, OpenGL is used to
    // accelerate drawing. Sublime Text must be restarted for changes to take
    // effect.
    //針對OS X,使用OpenGL畫圖，需重啟
    "gpu_window_buffer": "auto",

    // Valid values are "system", "enabled" and "disabled"
    //延遲滾動條
    "overlay_scroll_bars": "system",

    //
    // Application Behavior Settings
    //

    // Exiting the application with hot_exit enabled will cause it to close
    // immediately without prompting. Unsaved modifications and open files will
    // be preserved and restored when next starting.
    //
    // Closing a window with an associated project will also close the window
    // without prompting, preserving unsaved changes in the workspace file
    // alongside the project.
    // 熱退出功能！退出時不會提示是否保存文件，而是直接退出
    "hot_exit": true,

    // remember_open_files makes the application start up with the last set of
    // open files. Changing this to false will have no effect if hot_exit is
    // true
    //記憶之前打開的文件
    "remember_open_files": true,

    // OS X only: When files are opened from finder, or by dragging onto the
    // dock icon, this controls if a new window is created or not.
    //始終在新窗口打開文件，針對OS X
    "open_files_in_new_window": true,

    // OS X only: This controls if an empty window is created at startup or not.
    //在打開程序的時候新建窗口，針對OS X
    "create_window_at_startup": true,

    // Set to true to close windows as soon as the last file is closed, unless
    // there's a folder open within the window. This is always enabled on OS X,
    // changing it here won't modify the behavior.
    //當(dāng)沒有文件時，關(guān)閉程序，針對Windows
    "close_windows_when_empty": false,

    // Show the full path to files in the title bar.
    // On OS X, this value is overridden in the platform specific settings, so
    // you'll need to place this line in your user settings to override it.
    //在標(biāo)題欄顯示絕對路徑
    "show_full_path": true,

    // Shows the Build Results panel when building. If set to false, the Build
    // Results can be shown via the Tools/Build Results menu.
    "show_panel_on_build": true,

    // Preview file contents when clicking on a file in the side bar. Double
    // clicking or editing the preview will open the file and assign it a tab.
    //在側(cè)邊欄預(yù)覽文件
    "preview_on_click": true,

    // folder_exclude_patterns and file_exclude_patterns control which files
    // are listed in folders on the side bar. These can also be set on a per-
    // project basis.
    // 哪些文件會被顯示到邊欄上
    "folder_exclude_patterns": [".svn", ".git", ".hg", "CVS"],
    "file_exclude_patterns": ["*.pyc", "*.pyo", "*.exe", "*.dll", "*.obj","*.o", "*.a", "*.lib", "*.so", "*.dylib", "*.ncb", "*.sdf", "*.suo", "*.pdb", "*.idb", ".DS_Store", "*.class", "*.psd", "*.db"],
    // These files will still show up in the side bar, but won't be included in
    // Goto Anything or Find in Files
    "binary_file_patterns": ["*.jpg", "*.jpeg", "*.png", "*.gif", "*.ttf", "*.tga", "*.dds", "*.ico", "*.eot", "*.pdf", "*.swf", "*.jar", "*.zip"],

    // List any packages to ignore here. When removing entries from this list,
    // a restart may be required if the package contains plugins.
    // 刪除你想要忽略的插件，需要重啟
    "ignored_packages": ["Vintage"]
}