AdvancedNewFile

Sublime Text的高级文件创建。

概述

此插件允许在项目中快速创建文件。有关高级功能的详细信息，请参阅功能部分。

兼容性说明

Sublime Text 2和3

1.7.0是最后一个与此版本的Sublime Text 2和3兼容的版本。不打算维护这些版本的Sublime Text的兼容性，并且将不会获得未来的增强。如需最新功能，请考虑升级到Sublime Text 4。

安装

请注意，使用任一方法，您可能需要重启Sublime Text 2才能加载插件。

包控制

推荐使用通过包控制进行安装。它将处理包的更新。要安装，请执行以下操作。

• 在命令面板中，输入包控制：安装包
• 搜索ANF以查看可用的命令列表

手动

将该仓库克隆或复制到包目录。如果您使用此方法，则需要将文件夹重命名为AdvancedNewFile。默认情况下，包目录位于

• OS X: ~/Library/Application Support/Sublime Text 2/Packages/
• Windows: %APPDATA%/Sublime Text 2/Packages/
• Linux: ~/.config/sublime-text-2/Packages/

或

• OS X: ~/Library/Application Support/Sublime Text 3/Packages/
• Windows: %APPDATA%/Sublime Text 3/Packages/
• Linux: ~/.config/sublime-text-3/Packages/

根据Windows上的安装，ST包路径可能为%APPDATA%/Sublime Text 2/...

使用

只需通过适当的快捷键调用 AdvancedNewFile 输入。然后，将路径和文件名输入到输入字段中。按下 Enter 键后，将创建文件。此外，如果指定的目录尚不存在，它们也将被创建。有关此插件的更高级用法，请参阅 高级路径用法。默认情况下，创建文件时的路径将在您输入路径信息时显示在状态栏中。

默认目录：默认目录由 default_root 设置指定。默认情况下，它将是窗口中列出的文件夹的顶级目录。如果无法解析，则使用主目录。有关更多信息，请参阅 设置 (default_root)。

未绑定默认快捷键的命令

该插件支持重命名和删除文件。然而，它们默认未绑定到任何快捷键。有关可用命令的更多信息，请参阅 GitHub wiki 页面。

将命令添加到菜单

该插件默认不包含任何菜单命令。要自己添加，请参阅 GitHub wiki

快捷键映射

如果您的快捷键遇到问题，请考虑运行 FindKeyConflicts，它也可通过包管理器获取。或者，在 Sublime Text 控制台中输入 sublime.log_commands(True) 将命令日志设置为 true。

Windows

ctrl+alt+n：创建新文件的通用快捷键。

ctrl+shift+alt+n：除了创建指定的文件夹外，新文件夹还将包含一个 __init__.py 文件。

OS X 和 Linux

Linux 和 OS X 的超级键分别是 Windows 和命令键。

super+alt+n：创建新文件的通用快捷键。

shift+super+alt+n：除了创建指定的文件夹外，新文件夹还将包含一个 __init__.py 文件。

设置

默认设置可通过导航到 首选项 -> 包设置 -> AdvancedNewFile - 默认 来查看。要修改默认设置，请导航到 首选项 -> 包设置 -> AdvancedNewFile -> 用户。

别名:

包含与目录关联的一系列别名的字典。有关更多信息，请参阅 别名

os_specific_alias:

包含与目录关联的一系列别名的字典。这些别名将与平台相关。有关更多信息，请参阅 平台特定别名

default_initial:

将自动插入到新文件创建输入中的字符串。

use_cursor_text:

一个布尔值，用于确定是否将来自缓冲区的文本（由引号或选区选中），自动插入到新文件生成输入字段。如果使用多个光标，则第一个包含在引号中或选区的输入将被使用。

show_files:

一个布尔值，用于确定是否应将常规文件包含在自动完成列表中。

show_path:

一个布尔值，用于确定是否应在状态栏中显示要创建的文件的路径。

default_root:

用于确定使用 AdvancedNewFile 时的默认根目录的值。它必须以下值之一

• project_folder- 默认路径将是 'default_folder_index' 设置指定的文件夹。
• current - 默认路径将是当前活动视图的目录。
• home - 默认路径将是您的家目录。
• path - 默认路径由 default_path 设置定义。

如果当前视图的目录无法解析，则将使用窗口顶层的文件夹。如果窗口顶层文件夹也无法解析，则将使用主目录。

default_path:

当为“default_root”设置指定了“path”时，此路径用作默认路径。该路径应该是绝对路径。如果指定了相对路径，则它将相对于AdvancedNewFile包目录。

default_folder_index:

表示当为“default_root”指定“folder”时使用的文件夹索引的整数值。如果使用的索引超出了现有文件夹的范围，则默认为0（顶层文件夹）。

alias_root:

此条目定义了在解析定义为相对路径的别名时使用的根。有关有效条目的更多信息，请参阅default_root。注意，对于路径，将指定alias_path。

alias_path:

如果为“alias_root”设置的“path”已指定，则此路径用作默认路径。

alias_folder_index:

表示当为“alias_root”指定“folder”时使用的文件夹索引的整数值。如果使用的索引超出了现有文件夹的范围，则默认为0。

ignore_case:

一个布尔值，指定在构建自动完成列表时是否应忽略大小写。

auto_refresh_sidebar:

一个布尔值，指定文件夹是否应该自动刷新并更新侧边栏。在某些构建中，项目文件夹内容更新时侧边栏不刷新。此设置是这些情况下刷新侧边栏的必要条件。默认值为False。

completion_type:

指定要使用的自动完成的字符串类型。有效值是“windows”或“nix”。

complete_single_entry

一个布尔设置，指定在只有一个完成项且完成类型为“windows”时是否插入分隔符。

use_folder_name:

一个布尔设置，指定是否使用文件夹名称或项目中的指定名称。此设置仅适用于ST3。

relative_from_current:

布尔设置，指定相对路径是否应基于当前工作目录。

default_extension:

包含默认文件扩展名的字符串。注意，如果指定的路径不包含点（.）字符，则应用此扩展名。

folder_permissions:

表示应应用于新创建文件夹的权限的字符串。例如，“777” -> 用户、组和其他的读写执行（RWX）。

file_permissions:

表示应应用于新创建文件的权限的字符串。例如，“777” -> 用户、组和其他的读写执行（RWX）。

rename_default:

重命名文件的默认输入。特殊值<filename>将替换为当前文件名。特殊值<filepath>将替换为包括文件名的完整文件路径。特殊值<filedirectory>将替换为不包含文件名的文件路径。请注意，如果文件存在于磁盘上，冒号作为默认值将解析为与<filedirectory>相同的路径。

vcs_management:

控制移动和删除文件时是否使用版本控制系统（VCS）管理的设置。

file_templates:

包含用于创建新文件时使用的模板信息的对象。此对象的键值应该是文件扩展名。无扩展名（如“Makefile”或“.bash_profile”）的文件使用完整文件名作为键。值可以是插入的内容字符串或路径列表。如果指定了路径列表，则选择时将显示文件名称。路径必须是绝对路径、用户的家目录（~/）或相对于包目录（Packages）。这些相对文件应采用“Packages/User/mytest.sublime-snippet”的形式。如果使用字符串或列表中只有一个条目，它将自动插入到任何新创建的文件中。

shell_input:

将此值设置为 true 将允许您在像使用 shell 一样使用转义字符。例如，给定输入字符串 "foo\ bar"，false 会导致在 foo 目录中创建名为 “ bar” 的文件。将此值设置为 true 时，将创建一个名为 “foo bar” 的文件。此外，将此值设置为 true 还允许进行花括号展开。目前，仅支持逗号分隔的条目。

append_extension_on_move:

设置以控制是否将扩展名自动应用到重命名的文件中。

relative_fallback_index:

一个代表要使用的文件夹索引的整数值，当无法从当前活动视图解析相对路径时使用。如果使用超出现有文件夹范围的索引，则默认为 0（顶级文件夹）。如果没有文件夹作为项目的一部分，则使用主目录。

append_extension_on_copy:

设置以控制是否将扩展名自动应用到复制的文件中。

copy_default:

与 rename_default 相同，应用于复制命令。

cut_to_file_default:

与 rename_default 相同，应用于剪切到文件命令。

current_fallback_to_project:

如果默认根设置为当前，则应使用项目文件夹作为默认值而不是主目录。

warn_overwrite_on_move:

当尝试使用移动命令覆盖现有文件时，应显示警告。

new_file_default_root：与 default_root 对新文件命令相同。除了对 default_root 列出的有效值之外，“default_root” 将使用该设置的值。

rename_file_default_root：与 default_root 对重命名文件命令相同。除了对 default_root 列出的有效值之外，“default_root” 将使用该设置的值。

copy_file_default_root：与 default_root 对复制文件命令相同。除了对 default_root 列出的有效值之外，“default_root” 将使用该设置的值。

empty_filename_action：在输入空白文件名时执行替代操作。目前，此操作仅在新建文件命令中实现，它将打开一个未命名的文件。默认值为 false

cursor_before_extension：指定初始输入时，此布尔值将在最后一个出现点之前放置光标。默认值为 False。

项目特定设置

上述所有设置也可以作为项目特定设置的一部分进行指定。这些值将覆盖由更高级别的设置设置的任何先前值，except for aliases。别名设置将与别名的高级配置合并。此外，如果默认/用户设置和项目设置中存在相同的别名，则项目设置将具有优先权。

"settings": {
    "AdvancedNewFile": {
        "default_initial": "/project/specific/path"
    }
}

功能

init.py 创建

此插件可选择性在创建的目录中创建 __init__。请参考 键映射 以查看执行此操作的默认键绑定。

Tab 自动完成

在输入部分路径后，只需按 Tab 键即可自动完成它。继续按 Tab 键可遍历选项。

高级路径使用

主目录

要从主目录开始，请像在 shell 中一样以 ~/ 开头。

别名

您可以为快速导航到目录创建别名。只需输入别名后跟一个冒号，然后指定路径即可。请注意，在指定别名与 预定义别名 发生冲突的情况下，指定的别名将具有优先权。

别名路径可以是相对的或绝对的。如果指定了相对路径，则使用alias_root设置作为基准。当指定绝对路径时，请确保使用特定于系统的风格（例如，Windows C:\Users\username\Desktop，OS X和Linux /home/username/desktop/）。此外，您还可以使用~/指定从家目录的别名。

如果指定了无效的别名，则创建文件时将显示错误提示。

示例别名

{
    "alias": {
        "Desktop": "~/Desktop/"
    }
}

要使用上述别名，当指定新文件时，请输入Desktop:testDir/testFile，这将创建位于<home_directory>/Desktop/testDir/testFile的文件。

平台特定别名

您还可以创建特定于平台的别名。这些遵循与别名相似的规则集。但是，而不是指定要使用的字符串路径，而是指定一个字典。此字典可以包含以下键：windows、linux和osx。此特定别名的路径将根据使用的操作系统来决定。如果在alias和os_specific_alias中指定了相同的别名，则将使用os_specific_alias中的路径。

示例OS特定别名

{
    "os_specific_alias": {
        "subl_packages": {
            "windows": "~\\AppData\\Roaming\\Sublime Text 2\\Packages",
            "linux": "~/.config/sublime-text-2/Packages",
            "osx": "~/Library/Application Support/Sublime Text 2/Packages"
        }
    }
}

预定义别名

窗口中的顶级文件夹

可以通过输入文件夹名称后跟一个冒号来指定顶级文件夹。然后指定路径，就像您通常那样。

注意

在Sublime Text 2中，文件夹名称将是文件夹的实际名称，而不是在项目中指定的任意名称。然而，由于API更新，Sublime Text 3中的文件夹名称将与侧边栏名称匹配。要在Sublime Text 2中实现类似的行为，您可以为alias创建项目特定设置。

当前工作目录

要指定当前工作目录，只需输入一个冒号，无需任何前缀文本。或者，在您的设置中将relative_from_current设置为true。相对于当前工作目录指定的路径将从当前工作目录开始。

注意

感谢Dima Kukushkin（《https://github.com/xobb1t》）对此插件的原始工作的贡献。还要感谢《https://github.com/facelessuser》和biermeester以及matthjes对特定于平台设置的构思。此外，感谢《https://github.com/kemayo》帮助识别git可执行文件。

所使用的库

• ushlex - 改进的shlex版本，支持Python 2的Unicode字符。

贡献者

• alirezadot
• aventurella
• btsai
• edmundask
• skuroda
• xobb1t