1269 lines
36 KiB
Lua
1269 lines
36 KiB
Lua
DIAG_LINE_ONLY_SPACE =
|
||
'只有空格的空行。'
|
||
DIAG_LINE_POST_SPACE =
|
||
'後置空格。'
|
||
DIAG_UNUSED_LOCAL =
|
||
'未使用的區域變數 `{}`。'
|
||
DIAG_UNDEF_GLOBAL =
|
||
'未定義的全域變數 `{}`。'
|
||
DIAG_UNDEF_FIELD =
|
||
'未定義的屬性/欄位 `{}`。'
|
||
DIAG_UNDEF_ENV_CHILD =
|
||
'未定義的變數 `{}`(多載了 `_ENV` )。'
|
||
DIAG_UNDEF_FENV_CHILD =
|
||
'未定義的變數 `{}`(處於模組中)。'
|
||
DIAG_GLOBAL_IN_NIL_ENV =
|
||
'不能使用全域變數( `_ENV` 被設為了 `nil` )。'
|
||
DIAG_GLOBAL_IN_NIL_FENV =
|
||
'不能使用全域變數(模組被設為了 `nil` )。'
|
||
DIAG_UNUSED_LABEL =
|
||
'未使用的標籤 `{}`。'
|
||
DIAG_UNUSED_FUNCTION =
|
||
'未使用的函式。'
|
||
DIAG_UNUSED_VARARG =
|
||
'未使用的不定引數。'
|
||
DIAG_REDEFINED_LOCAL =
|
||
'重複定義區域變數 `{}`。'
|
||
DIAG_DUPLICATE_INDEX =
|
||
'重複的索引 `{}`。'
|
||
DIAG_DUPLICATE_METHOD =
|
||
'重複的方法 `{}`。'
|
||
DIAG_PREVIOUS_CALL =
|
||
'會被直譯為 `{}{}` 。你可能需要加一個 `;`。'
|
||
DIAG_PREFIELD_CALL =
|
||
'會被直譯為 `{}{}` 。你可能需要加一個 `,` 或 `;` 。'
|
||
DIAG_OVER_MAX_ARGS =
|
||
'函式最多接收 {:d} 個引數,但獲得了 {:d} 個。'
|
||
DIAG_MISS_ARGS =
|
||
'函式最少接收 {:d} 個引數,但獲得了 {:d} 個。'
|
||
DIAG_OVER_MAX_VALUES =
|
||
'只有 {} 個變數,但你設定了 {} 個值。'
|
||
DIAG_AMBIGUITY_1 =
|
||
'會優先運算 `{}` ,你可能需要加個括號。'
|
||
DIAG_LOWERCASE_GLOBAL =
|
||
'首字母小寫的全域變數,你是否漏了 `local` 或是有拼寫錯誤?'
|
||
DIAG_EMPTY_BLOCK =
|
||
'空程式碼區塊'
|
||
DIAG_DIAGNOSTICS =
|
||
'Lua 診斷'
|
||
DIAG_SYNTAX_CHECK =
|
||
'Lua 語法檢查'
|
||
DIAG_NEED_VERSION =
|
||
'在 {} 中是合法的,目前為 {}'
|
||
DIAG_DEFINED_VERSION =
|
||
'在 {} 中有定義,目前為 {}'
|
||
DIAG_DEFINED_CUSTOM =
|
||
'在 {} 中有定義'
|
||
DIAG_DUPLICATE_CLASS =
|
||
'重複定義的 Class `{}`。'
|
||
DIAG_UNDEFINED_CLASS =
|
||
'未定義的 Class `{}`。'
|
||
DIAG_CYCLIC_EXTENDS =
|
||
'循環繼承。'
|
||
DIAG_INEXISTENT_PARAM =
|
||
'不存在的參數。'
|
||
DIAG_DUPLICATE_PARAM =
|
||
'重複的參數。'
|
||
DIAG_NEED_CLASS =
|
||
'需要先定義 Class 。'
|
||
DIAG_DUPLICATE_SET_FIELD=
|
||
'重複定義的欄位 `{}`。'
|
||
DIAG_SET_CONST =
|
||
'不能對常數賦值。'
|
||
DIAG_SET_FOR_STATE =
|
||
'修改了循環變數。'
|
||
DIAG_CODE_AFTER_BREAK =
|
||
'無法執行到 `break` 後的程式碼。'
|
||
DIAG_UNBALANCED_ASSIGNMENTS =
|
||
'由於值的數量不夠而被賦值為了 `nil` 。在Lua中, `x, y = 1` 等價於 `x, y = 1, nil` 。'
|
||
DIAG_REQUIRE_LIKE =
|
||
'你可以在設定中將 `{}` 視為 `require`。'
|
||
DIAG_COSE_NON_OBJECT =
|
||
'無法 close 此類型的值。(除非給此類型設定 `__close` 元方法)'
|
||
DIAG_COUNT_DOWN_LOOP =
|
||
'你的意思是 `{}` 嗎?'
|
||
DIAG_UNKNOWN =
|
||
'無法推測出類型。'
|
||
DIAG_DEPRECATED =
|
||
'已棄用。'
|
||
DIAG_DIFFERENT_REQUIRES =
|
||
'使用了不同的名字 `require` 了同一個檔案。'
|
||
DIAG_REDUNDANT_RETURN =
|
||
'冗餘回傳。'
|
||
DIAG_AWAIT_IN_SYNC =
|
||
'只能在標記為非同步的函式中呼叫非同步函式。'
|
||
DIAG_NOT_YIELDABLE =
|
||
'此函式的第 {} 個參數沒有被標記為可讓出,但是傳入了非同步函式。(使用 `---@param name async fun()` 來標記為可讓出)'
|
||
DIAG_DISCARD_RETURNS =
|
||
'不能丟棄此函式的回傳值。'
|
||
DIAG_NEED_CHECK_NIL =
|
||
'需要判空'
|
||
DIAG_CIRCLE_DOC_CLASS =
|
||
'循環繼承的類別。'
|
||
DIAG_DOC_FIELD_NO_CLASS =
|
||
'欄位必須定義在類別之後。'
|
||
DIAG_DUPLICATE_DOC_ALIAS =
|
||
'重複定義的別名 `{}`.'
|
||
DIAG_DUPLICATE_DOC_FIELD =
|
||
'重複定義的欄位 `{}`。'
|
||
DIAG_DUPLICATE_DOC_PARAM =
|
||
'重複指向的參數 `{}`。'
|
||
DIAG_UNDEFINED_DOC_CLASS =
|
||
'未定義的類別 `{}`。'
|
||
DIAG_UNDEFINED_DOC_NAME =
|
||
'未定義的類型或別名 `{}`。'
|
||
DIAG_UNDEFINED_DOC_PARAM =
|
||
'指向了未定義的參數 `{}`。'
|
||
DIAG_MISSING_GLOBAL_DOC_COMMENT = -- TODO: need translate!
|
||
'Missing comment for global function `{}`.'
|
||
DIAG_MISSING_GLOBAL_DOC_PARAM = -- TODO: need translate!
|
||
'Missing @param annotation for parameter `{}` in global function `{}`.'
|
||
DIAG_MISSING_GLOBAL_DOC_RETURN = -- TODO: need translate!
|
||
'Missing @return annotation at index `{}` in global function `{}`.'
|
||
DIAG_MISSING_LOCAL_EXPORT_DOC_COMMENT = -- TODO: need translate!
|
||
'Missing comment for exported local function `{}`.'
|
||
DIAG_MISSING_LOCAL_EXPORT_DOC_PARAM = -- TODO: need translate!
|
||
'Missing @param annotation for parameter `{}` in exported local function `{}`.'
|
||
DIAG_MISSING_LOCAL_EXPORT_DOC_RETURN = -- TODO: need translate!
|
||
'Missing @return annotation at index `{}` in exported local function `{}`.'
|
||
DIAG_INCOMPLETE_SIGNATURE_DOC_PARAM = -- TODO: need translate!
|
||
'Incomplete signature. Missing @param annotation for parameter `{}` in function `{}`.'
|
||
DIAG_INCOMPLETE_SIGNATURE_DOC_RETURN = -- TODO: need translate!
|
||
'Incomplete signature. Missing @return annotation at index `{}` in function `{}`.'
|
||
DIAG_UNKNOWN_DIAG_CODE =
|
||
'未知的診斷代碼 `{}`。'
|
||
DIAG_CAST_LOCAL_TYPE =
|
||
'已顯式定義變數的類型為 `{def}`,不能再將其類型轉換為 `{ref}`。'
|
||
DIAG_CAST_FIELD_TYPE =
|
||
'已顯式定義欄位的類型為 `{def}`,不能再將其類型轉換為 `{ref}`。'
|
||
DIAG_ASSIGN_TYPE_MISMATCH =
|
||
'不能將 `{ref}` 賦值給 `{def}`。'
|
||
DIAG_PARAM_TYPE_MISMATCH =
|
||
'不能將 `{ref}` 賦值給參數 `{def}`.'
|
||
DIAG_UNKNOWN_CAST_VARIABLE =
|
||
'未知的類型轉換變數 `{}`.'
|
||
DIAG_CAST_TYPE_MISMATCH =
|
||
'不能將 `{ref}` 轉換為 `{def}`。'
|
||
DIAG_MISSING_RETURN_VALUE =
|
||
'至少需要 {min} 個回傳值,但此處只回傳 {rmax} 個值。'
|
||
DIAG_MISSING_RETURN_VALUE_RANGE =
|
||
'至少需要 {min} 個回傳值,但此處只回傳 {rmin} 到 {rmax} 個值。'
|
||
DIAG_REDUNDANT_RETURN_VALUE =
|
||
'最多只有 {max} 個回傳值,但此處回傳了第 {rmax} 個值。'
|
||
DIAG_REDUNDANT_RETURN_VALUE_RANGE =
|
||
'最多只有 {max} 個回傳值,但此處回傳了第 {rmin} 到第 {rmax} 個值。'
|
||
DIAG_MISSING_RETURN =
|
||
'此處需要回傳值。'
|
||
DIAG_RETURN_TYPE_MISMATCH =
|
||
'第 {index} 個回傳值的類型為 `{def}` ,但實際回傳的是 `{ref}`。\n{err}'
|
||
DIAG_UNKNOWN_OPERATOR = -- TODO: need translate!
|
||
'Unknown operator `{}`.'
|
||
DIAG_UNREACHABLE_CODE = -- TODO: need translate!
|
||
'Unreachable code.'
|
||
DIAG_INVISIBLE_PRIVATE = -- TODO: need translate!
|
||
'Field `{field}` is private, it can only be accessed in class `{class}`.'
|
||
DIAG_INVISIBLE_PROTECTED = -- TODO: need translate!
|
||
'Field `{field}` is protected, it can only be accessed in class `{class}` and its subclasses.'
|
||
DIAG_INVISIBLE_PACKAGE = -- TODO: need translate!
|
||
'Field `{field}` can only be accessed in same file `{uri}`.'
|
||
DIAG_GLOBAL_ELEMENT = -- TODO: need translate!
|
||
'Element is global.'
|
||
|
||
MWS_NOT_SUPPORT =
|
||
'{} 目前還不支援多工作目錄,我可能需要重新啟動才能支援新的工作目錄...'
|
||
MWS_RESTART =
|
||
'重新啟動'
|
||
MWS_NOT_COMPLETE =
|
||
'工作目錄還沒有準備好,你可以稍後再試一下...'
|
||
MWS_COMPLETE =
|
||
'工作目錄準備好了,你可以再試一下了...'
|
||
MWS_MAX_PRELOAD =
|
||
'預載入檔案數已達上限({}),你需要手動打開需要載入的檔案。'
|
||
MWS_UCONFIG_FAILED =
|
||
'使用者設定檔儲存失敗。'
|
||
MWS_UCONFIG_UPDATED =
|
||
'使用者設定檔已更新。'
|
||
MWS_WCONFIG_UPDATED =
|
||
'工作區設定檔已更新。'
|
||
|
||
WORKSPACE_SKIP_LARGE_FILE =
|
||
'已跳過過大的檔案:{}。目前設定的大小限制為:{} KB,該檔案大小為:{} KB'
|
||
WORKSPACE_LOADING =
|
||
'正在載入工作目錄'
|
||
WORKSPACE_DIAGNOSTIC =
|
||
'正在對工作目錄進行診斷'
|
||
WORKSPACE_SKIP_HUGE_FILE =
|
||
'出於效能考慮,已停止對此檔案解析:{}'
|
||
WORKSPACE_NOT_ALLOWED =
|
||
'你的工作目錄被設定為了 `{}` ,Lua語言伺服拒絕載入此目錄,請檢查你的設定檔。[了解更多](https://github.com/LuaLS/lua-language-server/wiki/FAQ#why-is-the-server-scanning-the-wrong-folder)'
|
||
WORKSPACE_SCAN_TOO_MUCH = -- TODO: need translate!
|
||
'已掃描了超過 {} 個檔案,目前掃描的目錄為 `{}`. Please see the [FAQ](https://github.com/LuaLS/lua-language-server/wiki/FAQ#how-can-i-improve-startup-speeds) to see how you can include fewer files. It is also possible that your [configuration is incorrect](https://github.com/LuaLS/lua-language-server/wiki/FAQ#why-is-the-server-scanning-the-wrong-folder).'
|
||
|
||
PARSER_CRASH =
|
||
'語法解析崩潰了!遺言:{}'
|
||
PARSER_UNKNOWN =
|
||
'未知語法錯誤...'
|
||
PARSER_MISS_NAME =
|
||
'缺少名稱。'
|
||
PARSER_UNKNOWN_SYMBOL =
|
||
'未知符號`{symbol}`。'
|
||
PARSER_MISS_SYMBOL =
|
||
'缺少符號`{symbol}`。'
|
||
PARSER_MISS_ESC_X =
|
||
'必須是2個16進制字元。'
|
||
PARSER_UTF8_SMALL =
|
||
'至少有1個字元。'
|
||
PARSER_UTF8_MAX =
|
||
'必須在 {min} 與 {max} 之間。'
|
||
PARSER_ERR_ESC =
|
||
'錯誤的跳脫字元。'
|
||
PARSER_MUST_X16 =
|
||
'必須是16進制字元。'
|
||
PARSER_MISS_EXPONENT =
|
||
'缺少指數部分。'
|
||
PARSER_MISS_EXP =
|
||
'缺少表達式。'
|
||
PARSER_MISS_FIELD =
|
||
'缺少欄位/屬性名。'
|
||
PARSER_MISS_METHOD =
|
||
'缺少方法名。'
|
||
PARSER_ARGS_AFTER_DOTS =
|
||
'`...`必須是最後一個引數。'
|
||
PARSER_KEYWORD =
|
||
'關鍵字無法作為名稱。'
|
||
PARSER_EXP_IN_ACTION =
|
||
'該表達式不能作為敘述。'
|
||
PARSER_BREAK_OUTSIDE =
|
||
'`break`必須在循環內部。'
|
||
PARSER_MALFORMED_NUMBER =
|
||
'無法構成有效數字。'
|
||
PARSER_ACTION_AFTER_RETURN =
|
||
'`return`之後不能再執行程式碼。'
|
||
PARSER_ACTION_AFTER_BREAK =
|
||
'`break`之後不能再執行程式碼。'
|
||
PARSER_NO_VISIBLE_LABEL =
|
||
'標籤`{label}`不可見。'
|
||
PARSER_REDEFINE_LABEL =
|
||
'標籤`{label}`重定義。'
|
||
PARSER_UNSUPPORT_SYMBOL =
|
||
'{version} 不支援該符號。'
|
||
PARSER_UNEXPECT_DOTS =
|
||
'`...`只能在不定參函式中使用。'
|
||
PARSER_UNEXPECT_SYMBOL =
|
||
'未知的符號 `{symbol}` 。'
|
||
PARSER_UNKNOWN_TAG =
|
||
'不支援的屬性。'
|
||
PARSER_MULTI_TAG =
|
||
'只能設定一個屬性。'
|
||
PARSER_UNEXPECT_LFUNC_NAME =
|
||
'區域函式只能使用識別字作為名稱。'
|
||
PARSER_UNEXPECT_EFUNC_NAME =
|
||
'函式作為表達式時不能命名。'
|
||
PARSER_ERR_LCOMMENT_END =
|
||
'應使用 `{symbol}` 來關閉多行註解。'
|
||
PARSER_ERR_C_LONG_COMMENT =
|
||
'Lua應使用 `--[[ ]]` 來進行多行註解。'
|
||
PARSER_ERR_LSTRING_END =
|
||
'應使用 `{symbol}` 來關閉長字串。'
|
||
PARSER_ERR_ASSIGN_AS_EQ =
|
||
'應使用 `=` 來進行賦值操作。'
|
||
PARSER_ERR_EQ_AS_ASSIGN =
|
||
'應使用 `==` 來進行等於判斷。'
|
||
PARSER_ERR_UEQ =
|
||
'應使用 `~=` 來進行不等於判斷。'
|
||
PARSER_ERR_THEN_AS_DO =
|
||
'應使用 `then` 。'
|
||
PARSER_ERR_DO_AS_THEN =
|
||
'應使用 `do` 。'
|
||
PARSER_MISS_END =
|
||
'缺少對應的 `end` 。'
|
||
PARSER_ERR_COMMENT_PREFIX =
|
||
'Lua應使用 `--` 來進行註解。'
|
||
PARSER_MISS_SEP_IN_TABLE =
|
||
'需要用 `,` 或 `;` 進行分割。'
|
||
PARSER_SET_CONST =
|
||
'不能對常數賦值。'
|
||
PARSER_UNICODE_NAME =
|
||
'包含了 Unicode 字元。'
|
||
PARSER_ERR_NONSTANDARD_SYMBOL =
|
||
'Lua中應使用符號 `{symbol}` 。'
|
||
PARSER_MISS_SPACE_BETWEEN =
|
||
'符號之間必須保留空格。'
|
||
PARSER_INDEX_IN_FUNC_NAME =
|
||
'命名函式的名稱中不能使用 `[name]` 形式。'
|
||
PARSER_UNKNOWN_ATTRIBUTE =
|
||
'區域變數屬性應該是 `const` 或 `close` 。'
|
||
PARSER_AMBIGUOUS_SYNTAX = -- TODO: need translate!
|
||
'在 Lua 5.1 中,函数调用的左括号必须与函数在同一行。'
|
||
PARSER_NEED_PAREN = -- TODO: need translate!
|
||
'需要添加一对括号。'
|
||
PARSER_NESTING_LONG_MARK = -- TODO: need translate!
|
||
'Nesting of `[[...]]` is not allowed in Lua 5.1 .'
|
||
PARSER_LOCAL_LIMIT = -- TODO: need translate!
|
||
'Only 200 active local variables and upvalues can be existed at the same time.'
|
||
PARSER_LUADOC_MISS_CLASS_NAME =
|
||
'缺少類別名稱。'
|
||
PARSER_LUADOC_MISS_EXTENDS_SYMBOL =
|
||
'缺少符號 `:` 。'
|
||
PARSER_LUADOC_MISS_CLASS_EXTENDS_NAME =
|
||
'缺少要繼承的類別名稱。'
|
||
PARSER_LUADOC_MISS_SYMBOL =
|
||
'缺少符號 `{symbol}`。'
|
||
PARSER_LUADOC_MISS_ARG_NAME =
|
||
'缺少參數名稱。'
|
||
PARSER_LUADOC_MISS_TYPE_NAME =
|
||
'缺少類型名。'
|
||
PARSER_LUADOC_MISS_ALIAS_NAME =
|
||
'缺少別名。'
|
||
PARSER_LUADOC_MISS_ALIAS_EXTENDS =
|
||
'缺少別名定義。'
|
||
PARSER_LUADOC_MISS_PARAM_NAME =
|
||
'缺少要指向的參數名稱。'
|
||
PARSER_LUADOC_MISS_PARAM_EXTENDS =
|
||
'缺少參數的類型定義。'
|
||
PARSER_LUADOC_MISS_FIELD_NAME =
|
||
'缺少欄位名稱。'
|
||
PARSER_LUADOC_MISS_FIELD_EXTENDS =
|
||
'缺少欄位的類型定義。'
|
||
PARSER_LUADOC_MISS_GENERIC_NAME =
|
||
'缺少泛型名稱。'
|
||
PARSER_LUADOC_MISS_GENERIC_EXTENDS_NAME =
|
||
'缺少泛型要繼承的類別名稱。'
|
||
PARSER_LUADOC_MISS_VARARG_TYPE =
|
||
'缺少可變引數的類型定義。'
|
||
PARSER_LUADOC_MISS_FUN_AFTER_OVERLOAD =
|
||
'缺少關鍵字 `fun` 。'
|
||
PARSER_LUADOC_MISS_CATE_NAME =
|
||
'缺少文件類型名稱。'
|
||
PARSER_LUADOC_MISS_DIAG_MODE =
|
||
'缺少診斷模式。'
|
||
PARSER_LUADOC_ERROR_DIAG_MODE =
|
||
'診斷模式不正確。'
|
||
PARSER_LUADOC_MISS_LOCAL_NAME =
|
||
'缺少變數名。'
|
||
|
||
SYMBOL_ANONYMOUS =
|
||
'<匿名函式>'
|
||
|
||
HOVER_VIEW_DOCUMENTS =
|
||
'檢視文件'
|
||
HOVER_DOCUMENT_LUA51 =
|
||
'https://www.lua.org/manual/5.1/manual.html#{}'
|
||
HOVER_DOCUMENT_LUA52 =
|
||
'https://www.lua.org/manual/5.2/manual.html#{}'
|
||
HOVER_DOCUMENT_LUA53 =
|
||
'http://cloudwu.github.io/lua53doc/manual.html#{}'
|
||
HOVER_DOCUMENT_LUA54 =
|
||
'https://www.lua.org/manual/5.4/manual.html#{}'
|
||
HOVER_DOCUMENT_LUAJIT =
|
||
'https://www.lua.org/manual/5.1/manual.html#{}'
|
||
HOVER_NATIVE_DOCUMENT_LUA51 =
|
||
'command:extension.lua.doc?["en-us/51/manual.html/{}"]'
|
||
HOVER_NATIVE_DOCUMENT_LUA52 =
|
||
'command:extension.lua.doc?["en-us/52/manual.html/{}"]'
|
||
HOVER_NATIVE_DOCUMENT_LUA53 =
|
||
'command:extension.lua.doc?["zh-cn/53/manual.html/{}"]'
|
||
HOVER_NATIVE_DOCUMENT_LUA54 =
|
||
'command:extension.lua.doc?["en-us/54/manual.html/{}"]'
|
||
HOVER_NATIVE_DOCUMENT_LUAJIT =
|
||
'command:extension.lua.doc?["en-us/51/manual.html/{}"]'
|
||
HOVER_MULTI_PROTOTYPE =
|
||
'({} 個原型)'
|
||
HOVER_STRING_BYTES =
|
||
'{} 個位元組'
|
||
HOVER_STRING_CHARACTERS =
|
||
'{} 個位元組,{} 個字元'
|
||
HOVER_MULTI_DEF_PROTO =
|
||
'({} 個定義,{} 個原型)'
|
||
HOVER_MULTI_PROTO_NOT_FUNC =
|
||
'({} 個非函式定義)'
|
||
HOVER_USE_LUA_PATH =
|
||
'(搜尋路徑: `{}` )'
|
||
HOVER_EXTENDS =
|
||
'展開為 {}'
|
||
HOVER_TABLE_TIME_UP =
|
||
'出於效能考慮,已停用了部分類型推斷。'
|
||
HOVER_WS_LOADING =
|
||
'正在載入工作目錄:{} / {}'
|
||
HOVER_AWAIT_TOOLTIP =
|
||
'正在呼叫非同步函式,可能會讓出目前共常式'
|
||
|
||
ACTION_DISABLE_DIAG =
|
||
'在工作區停用診斷 ({})。'
|
||
ACTION_MARK_GLOBAL =
|
||
'標記 `{}` 為已定義的全域變數。'
|
||
ACTION_REMOVE_SPACE =
|
||
'清除所有後置空格。'
|
||
ACTION_ADD_SEMICOLON =
|
||
'添加 `;` 。'
|
||
ACTION_ADD_BRACKETS =
|
||
'添加括號。'
|
||
ACTION_RUNTIME_VERSION =
|
||
'修改執行版本為 {} 。'
|
||
ACTION_OPEN_LIBRARY =
|
||
'載入 {} 中的全域變數。'
|
||
ACTION_ADD_DO_END =
|
||
'添加 `do ... end` 。'
|
||
ACTION_FIX_LCOMMENT_END =
|
||
'改用正確的多行註解關閉符號。'
|
||
ACTION_ADD_LCOMMENT_END =
|
||
'關閉多行註解。'
|
||
ACTION_FIX_C_LONG_COMMENT =
|
||
'修改為 Lua 的多行註解格式。'
|
||
ACTION_FIX_LSTRING_END =
|
||
'改用正確的長字串關閉符號。'
|
||
ACTION_ADD_LSTRING_END =
|
||
'關閉長字串。'
|
||
ACTION_FIX_ASSIGN_AS_EQ =
|
||
'改為 `=` 。'
|
||
ACTION_FIX_EQ_AS_ASSIGN =
|
||
'改為 `==` 。'
|
||
ACTION_FIX_UEQ =
|
||
'改為 `~=` 。'
|
||
ACTION_FIX_THEN_AS_DO =
|
||
'改為 `then` 。'
|
||
ACTION_FIX_DO_AS_THEN =
|
||
'改為 `do` 。'
|
||
ACTION_ADD_END =
|
||
'添加 `end` (根據縮排推測添加位置)。'
|
||
ACTION_FIX_COMMENT_PREFIX =
|
||
'改為 `--` 。'
|
||
ACTION_FIX_NONSTANDARD_SYMBOL =
|
||
'改為 `{symbol}`。'
|
||
ACTION_RUNTIME_UNICODE_NAME =
|
||
'允許使用 Unicode 字元。'
|
||
ACTION_SWAP_PARAMS =
|
||
'將其改為 `{node}` 的第 {index} 個參數'
|
||
ACTION_FIX_INSERT_SPACE =
|
||
'插入空格'
|
||
ACTION_JSON_TO_LUA =
|
||
'把 JSON 轉成 Lua'
|
||
ACTION_DISABLE_DIAG_LINE=
|
||
'在此行停用診斷 ({})。'
|
||
ACTION_DISABLE_DIAG_FILE=
|
||
'在此檔案停用診斷 ({})。'
|
||
ACTION_MARK_ASYNC =
|
||
'將目前函式標記為非同步。'
|
||
ACTION_ADD_DICT =
|
||
'添加 \'{}\' 到工作區字典'
|
||
ACTION_FIX_ADD_PAREN = -- TODO: need translate!
|
||
'添加括号。'
|
||
|
||
COMMAND_DISABLE_DIAG =
|
||
'停用診斷'
|
||
COMMAND_MARK_GLOBAL =
|
||
'標記全域變數'
|
||
COMMAND_REMOVE_SPACE =
|
||
'清除所有後置空格'
|
||
COMMAND_ADD_BRACKETS =
|
||
'添加括號'
|
||
COMMAND_RUNTIME_VERSION =
|
||
'修改執行版本'
|
||
COMMAND_OPEN_LIBRARY =
|
||
'載入第三方庫中的全域變數'
|
||
COMMAND_UNICODE_NAME =
|
||
'允許使用 Unicode 字元'
|
||
COMMAND_JSON_TO_LUA =
|
||
'JSON 轉 Lua'
|
||
COMMAND_JSON_TO_LUA_FAILED =
|
||
'JSON 轉 Lua 失敗:{}'
|
||
COMMAND_ADD_DICT =
|
||
'添加單字到字典裡'
|
||
COMMAND_REFERENCE_COUNT = -- TODO: need translate!
|
||
'{} references'
|
||
|
||
COMPLETION_IMPORT_FROM =
|
||
'從 {} 中匯入'
|
||
COMPLETION_DISABLE_AUTO_REQUIRE =
|
||
'停用自動require'
|
||
COMPLETION_ASK_AUTO_REQUIRE =
|
||
'在檔案頂部添加程式碼 require 此檔案?'
|
||
|
||
DEBUG_MEMORY_LEAK =
|
||
'{} 很抱歉發生了嚴重的記憶體漏失,語言伺服即將重新啟動。'
|
||
DEBUG_RESTART_NOW =
|
||
'立即重新啟動'
|
||
|
||
WINDOW_COMPILING =
|
||
'正在編譯'
|
||
WINDOW_DIAGNOSING =
|
||
'正在診斷'
|
||
WINDOW_INITIALIZING =
|
||
'正在初始化...'
|
||
WINDOW_PROCESSING_HOVER =
|
||
'正在處理懸浮提示...'
|
||
WINDOW_PROCESSING_DEFINITION =
|
||
'正在處理轉到定義...'
|
||
WINDOW_PROCESSING_REFERENCE =
|
||
'正在處理轉到引用...'
|
||
WINDOW_PROCESSING_RENAME =
|
||
'正在處理重新命名...'
|
||
WINDOW_PROCESSING_COMPLETION =
|
||
'正在處理自動完成...'
|
||
WINDOW_PROCESSING_SIGNATURE =
|
||
'正在處理參數提示...'
|
||
WINDOW_PROCESSING_SYMBOL =
|
||
'正在處理檔案符號...'
|
||
WINDOW_PROCESSING_WS_SYMBOL =
|
||
'正在處理工作區符號...'
|
||
WINDOW_PROCESSING_SEMANTIC_FULL =
|
||
'正在處理全量語義著色...'
|
||
WINDOW_PROCESSING_SEMANTIC_RANGE =
|
||
'正在處理差量語義著色...'
|
||
WINDOW_PROCESSING_HINT =
|
||
'正在處理內嵌提示...'
|
||
WINDOW_PROCESSING_BUILD_META = -- TODO: need translate!
|
||
'Processing build meta...'
|
||
WINDOW_INCREASE_UPPER_LIMIT =
|
||
'增加上限'
|
||
WINDOW_CLOSE =
|
||
'關閉'
|
||
WINDOW_SETTING_WS_DIAGNOSTIC =
|
||
'你可以在設定中延遲或停用工作目錄診斷'
|
||
WINDOW_DONT_SHOW_AGAIN =
|
||
'不再提示'
|
||
WINDOW_DELAY_WS_DIAGNOSTIC =
|
||
'空閒時診斷(延遲{}秒)'
|
||
WINDOW_DISABLE_DIAGNOSTIC =
|
||
'停用工作區診斷'
|
||
WINDOW_LUA_STATUS_WORKSPACE =
|
||
'工作區:{}'
|
||
WINDOW_LUA_STATUS_CACHED_FILES =
|
||
'已快取檔案:{ast}/{max}'
|
||
WINDOW_LUA_STATUS_MEMORY_COUNT =
|
||
'記憶體佔用:{mem:.f}M'
|
||
WINDOW_LUA_STATUS_TIP =
|
||
[[
|
||
|
||
這個圖標是貓,
|
||
不是狗也不是狐狸!
|
||
↓↓↓
|
||
]]
|
||
WINDOW_LUA_STATUS_DIAGNOSIS_TITLE=
|
||
'進行工作區診斷'
|
||
WINDOW_LUA_STATUS_DIAGNOSIS_MSG =
|
||
'是否進行工作區診斷?'
|
||
WINDOW_APPLY_SETTING =
|
||
'套用設定'
|
||
WINDOW_CHECK_SEMANTIC =
|
||
'如果你正在使用市場中的顏色主題,你可能需要同時修改 `editor.semanticHighlighting.enabled` 選項為 `true` 才會使語義著色生效。'
|
||
WINDOW_TELEMETRY_HINT =
|
||
'請允許發送匿名的使用資料與錯誤報告,幫助我們進一步完善此延伸模組。在[此處](https://github.com/LuaLS/lua-language-server/wiki/Home#privacy)閱讀我們的隱私聲明。'
|
||
WINDOW_TELEMETRY_ENABLE =
|
||
'允許'
|
||
WINDOW_TELEMETRY_DISABLE =
|
||
'禁止'
|
||
WINDOW_CLIENT_NOT_SUPPORT_CONFIG =
|
||
'你的用戶端不支援從伺服端修改設定,請手動修改以下設定:'
|
||
WINDOW_LCONFIG_NOT_SUPPORT_CONFIG=
|
||
'暫時不支援自動修改本地設定,請手動修改以下設定:'
|
||
WINDOW_MANUAL_CONFIG_ADD =
|
||
'為 `{key}` 添加值 `{value:q}`;'
|
||
WINDOW_MANUAL_CONFIG_SET =
|
||
'將 `{key}` 的值設定為 `{value:q}`;'
|
||
WINDOW_MANUAL_CONFIG_PROP =
|
||
'將 `{key}` 的屬性 `{prop}` 設定為 `{value:q}`;'
|
||
WINDOW_APPLY_WHIT_SETTING =
|
||
'套用並修改設定'
|
||
WINDOW_APPLY_WHITOUT_SETTING =
|
||
'套用但不修改設定'
|
||
WINDOW_ASK_APPLY_LIBRARY =
|
||
'是否需要將你的工作環境配置為 `{}` ?'
|
||
WINDOW_SEARCHING_IN_FILES =
|
||
'正在檔案中搜尋...'
|
||
WINDOW_CONFIG_LUA_DEPRECATED = -- TODO: need translate!
|
||
'`config.lua` is deprecated, please use `config.json` instead.'
|
||
WINDOW_CONVERT_CONFIG_LUA = -- TODO: need translate!
|
||
'Convert to `config.json`'
|
||
WINDOW_MODIFY_REQUIRE_PATH = -- TODO: need translate!
|
||
'Do you want to modify the require path?'
|
||
WINDOW_MODIFY_REQUIRE_OK = -- TODO: need translate!
|
||
'Modify'
|
||
|
||
CONFIG_LOAD_FAILED =
|
||
'無法讀取設定檔案:{}'
|
||
CONFIG_LOAD_ERROR =
|
||
'設定檔案載入錯誤:{}'
|
||
CONFIG_TYPE_ERROR =
|
||
'設定檔案必須是lua或json格式:{}'
|
||
CONFIG_MODIFY_FAIL_SYNTAX_ERROR = -- TODO: need translate!
|
||
'Failed to modify settings, there are syntax errors in the settings file: {}'
|
||
CONFIG_MODIFY_FAIL_NO_WORKSPACE = -- TODO: need translate!
|
||
[[
|
||
Failed to modify settings:
|
||
* The current mode is single-file mode, server cannot create `.luarc.json` without workspace.
|
||
* The language client dose not support modifying settings from the server side.
|
||
|
||
Please modify following settings manually:
|
||
{}
|
||
]]
|
||
CONFIG_MODIFY_FAIL = -- TODO: need translate!
|
||
[[
|
||
Failed to modify settings
|
||
|
||
Please modify following settings manually:
|
||
{}
|
||
]]
|
||
|
||
PLUGIN_RUNTIME_ERROR =
|
||
[[
|
||
延伸模組發生錯誤,請彙報給延伸模組作者。
|
||
請在輸出或日誌中查看詳細資訊。
|
||
延伸模組路徑:{}
|
||
]]
|
||
PLUGIN_TRUST_LOAD =
|
||
[[
|
||
目前設定試圖載入位於此位置的延伸模組:{}
|
||
|
||
注意,惡意的延伸模組可能會危害您的電腦
|
||
]]
|
||
PLUGIN_TRUST_YES =
|
||
[[
|
||
信任並載入延伸模組
|
||
]]
|
||
PLUGIN_TRUST_NO =
|
||
[[
|
||
不要載入此延伸模組
|
||
]]
|
||
|
||
CLI_CHECK_ERROR_TYPE =
|
||
'check 必須是一個字串,但是是一個 {}'
|
||
CLI_CHECK_ERROR_URI =
|
||
'check 必須是一個有效的 URI,但是是 {}'
|
||
CLI_CHECK_ERROR_LEVEL =
|
||
'checklevel 必須是這些值之一:{}'
|
||
CLI_CHECK_INITING =
|
||
'正在初始化...'
|
||
CLI_CHECK_SUCCESS =
|
||
'診斷完成,沒有發現問題'
|
||
CLI_CHECK_RESULTS =
|
||
'診斷完成,共有 {} 個問題,請查看 {}'
|
||
CLI_DOC_INITING = -- TODO: need translate!
|
||
'Loading documents ...'
|
||
CLI_DOC_DONE = -- TODO: need translate!
|
||
[[
|
||
Document exporting completed!
|
||
Raw data: {}
|
||
Markdown(example): {}
|
||
]]
|
||
|
||
TYPE_ERROR_ENUM_GLOBAL_DISMATCH = -- TODO: need translate!
|
||
'Type `{child}` cannot match enumeration type of `{parent}`'
|
||
TYPE_ERROR_ENUM_GENERIC_UNSUPPORTED = -- TODO: need translate!
|
||
'Cannot use generic `{child}` in enumeration'
|
||
TYPE_ERROR_ENUM_LITERAL_DISMATCH = -- TODO: need translate!
|
||
'Literal `{child}` cannot match the enumeration value of `{parent}`'
|
||
TYPE_ERROR_ENUM_OBJECT_DISMATCH = -- TODO: need translate!
|
||
'The object `{child}` cannot match the enumeration value of `{parent}`. They must be the same object'
|
||
TYPE_ERROR_ENUM_NO_OBJECT = -- TODO: need translate!
|
||
'The passed in enumeration value `{child}` is not recognized'
|
||
TYPE_ERROR_INTEGER_DISMATCH = -- TODO: need translate!
|
||
'Literal `{child}` cannot match integer `{parent}`'
|
||
TYPE_ERROR_STRING_DISMATCH = -- TODO: need translate!
|
||
'Literal `{child}` cannot match string `{parent}`'
|
||
TYPE_ERROR_BOOLEAN_DISMATCH = -- TODO: need translate!
|
||
'Literal `{child}` cannot match boolean `{parent}`'
|
||
TYPE_ERROR_TABLE_NO_FIELD = -- TODO: need translate!
|
||
'Field `{key}` does not exist in the table'
|
||
TYPE_ERROR_TABLE_FIELD_DISMATCH = -- TODO: need translate!
|
||
'The type of field `{key}` is `{child}`, which cannot match `{parent}`'
|
||
TYPE_ERROR_CHILD_ALL_DISMATCH = -- TODO: need translate!
|
||
'All subtypes in `{child}` cannot match `{parent}`'
|
||
TYPE_ERROR_PARENT_ALL_DISMATCH = -- TODO: need translate!
|
||
'`{child}` cannot match any subtypes in `{parent}`'
|
||
TYPE_ERROR_UNION_DISMATCH = -- TODO: need translate!
|
||
'`{child}` cannot match `{parent}`'
|
||
TYPE_ERROR_OPTIONAL_DISMATCH = -- TODO: need translate!
|
||
'Optional type cannot match `{parent}`'
|
||
TYPE_ERROR_NUMBER_LITERAL_TO_INTEGER = -- TODO: need translate!
|
||
'The number `{child}` cannot be converted to an integer'
|
||
TYPE_ERROR_NUMBER_TYPE_TO_INTEGER = -- TODO: need translate!
|
||
'Cannot convert number type to integer type'
|
||
TYPE_ERROR_DISMATCH = -- TODO: need translate!
|
||
'Type `{child}` cannot match `{parent}`'
|
||
|
||
LUADOC_DESC_CLASS =
|
||
[=[
|
||
定義一個類別/表結構
|
||
## 語法
|
||
`---@class <name> [: <parent>[, <parent>]...]`
|
||
## 用法
|
||
```
|
||
---@class Manager: Person, Human
|
||
Manager = {}
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#class)
|
||
]=]
|
||
LUADOC_DESC_TYPE =
|
||
[=[
|
||
指定一個變數的類型
|
||
|
||
預設類型: `nil` 、 `any` 、 `boolean` 、 `string` 、 `number` 、 `integer`、
|
||
`function` 、 `table` 、 `thread` 、 `userdata` 、 `lightuserdata`
|
||
|
||
(可以使用 `@alias` 提供自訂類型)
|
||
|
||
## 語法
|
||
`---@type <type>[| [type]...`
|
||
|
||
## 用法
|
||
### 一般
|
||
```
|
||
---@type nil|table|myClass
|
||
local Example = nil
|
||
```
|
||
|
||
### 陣列
|
||
```
|
||
---@type number[]
|
||
local phoneNumbers = {}
|
||
```
|
||
|
||
### 列舉
|
||
```
|
||
---@type "red"|"green"|"blue"
|
||
local color = ""
|
||
```
|
||
|
||
### 表
|
||
```
|
||
---@type table<string, boolean>
|
||
local settings = {
|
||
disableLogging = true,
|
||
preventShutdown = false,
|
||
}
|
||
|
||
---@type { [string]: true }
|
||
local x --x[""] is true
|
||
```
|
||
|
||
### 函式
|
||
```
|
||
---@type fun(mode?: "r"|"w"): string
|
||
local myFunction
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#types-and-type)
|
||
]=]
|
||
LUADOC_DESC_ALIAS =
|
||
[=[
|
||
新增你的自訂類型,可以與 `@param`、`@type` 等一起使用。
|
||
|
||
## 語法
|
||
`---@alias <name> <type> [description]`\
|
||
或
|
||
```
|
||
---@alias <name>
|
||
---| 'value' [# comment]
|
||
---| 'value2' [# comment]
|
||
...
|
||
```
|
||
|
||
## 用法
|
||
### Expand to other type
|
||
```
|
||
---@alias filepath string Path to a file
|
||
|
||
---@param path filepath Path to the file to search in
|
||
function find(path, pattern) end
|
||
```
|
||
|
||
### 列舉
|
||
```
|
||
---@alias font-style
|
||
---| '"underlined"' # Underline the text
|
||
---| '"bold"' # Bolden the text
|
||
---| '"italic"' # Make the text italicized
|
||
|
||
---@param style font-style Style to apply
|
||
function setFontStyle(style) end
|
||
```
|
||
|
||
### Literal Enum
|
||
```
|
||
local enums = {
|
||
READ = 0,
|
||
WRITE = 1,
|
||
CLOSED = 2
|
||
}
|
||
|
||
---@alias FileStates
|
||
---| `enums.READ`
|
||
---| `enums.WRITE`
|
||
---| `enums.CLOSE`
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#alias)
|
||
]=]
|
||
LUADOC_DESC_PARAM =
|
||
[=[
|
||
宣告一個函式參數
|
||
|
||
## 語法
|
||
`@param <name>[?] <type> [comment]`
|
||
|
||
## 用法
|
||
### 一般
|
||
```
|
||
---@param url string The url to request
|
||
---@param headers? table<string, string> HTTP headers to send
|
||
---@param timeout? number Timeout in seconds
|
||
function get(url, headers, timeout) end
|
||
```
|
||
|
||
### 可變引數
|
||
```
|
||
---@param base string The base to concat to
|
||
---@param ... string The values to concat
|
||
function concat(base, ...) end
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#param)
|
||
]=]
|
||
LUADOC_DESC_RETURN =
|
||
[=[
|
||
宣告一個回傳值
|
||
|
||
## 語法
|
||
`@return <type> [name] [description]`\
|
||
或\
|
||
`@return <type> [# description]`
|
||
|
||
## 用法
|
||
### 一般
|
||
```
|
||
---@return number
|
||
---@return number # The green component
|
||
---@return number b The blue component
|
||
function hexToRGB(hex) end
|
||
```
|
||
|
||
### 僅限類型和名稱
|
||
```
|
||
---@return number x, number y
|
||
function getCoords() end
|
||
```
|
||
|
||
### 僅限類型
|
||
```
|
||
---@return string, string
|
||
function getFirstLast() end
|
||
```
|
||
|
||
### 回傳變數值
|
||
```
|
||
---@return string ... The tags of the item
|
||
function getTags(item) end
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#return)
|
||
]=]
|
||
LUADOC_DESC_FIELD =
|
||
[=[
|
||
在類別/表中宣告一個欄位。 這使你可以為表提供更深入詳細的文件。
|
||
|
||
## 語法
|
||
`---@field <name> <type> [description]`
|
||
|
||
## 用法
|
||
```
|
||
---@class HTTP_RESPONSE
|
||
---@field status HTTP_STATUS
|
||
---@field headers table<string, string> The headers of the response
|
||
|
||
---@class HTTP_STATUS
|
||
---@field code number The status code of the response
|
||
---@field message string A message reporting the status
|
||
|
||
---@return HTTP_RESPONSE response The response from the server
|
||
function get(url) end
|
||
|
||
--This response variable has all of the fields defined above
|
||
response = get("localhost")
|
||
|
||
--Extension provided intellisense for the below assignment
|
||
statusCode = response.status.code
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#field)
|
||
]=]
|
||
LUADOC_DESC_GENERIC =
|
||
[=[
|
||
模擬泛型。 泛型可以允許類型被重用,因為它們有助於定義可用於不同類型的"通用形狀"。
|
||
|
||
## 語法
|
||
`---@generic <name> [:parent_type] [, <name> [:parent_type]]`
|
||
|
||
## 用法
|
||
### 一般
|
||
```
|
||
---@generic T
|
||
---@param value T The value to return
|
||
---@return T value The exact same value
|
||
function echo(value)
|
||
return value
|
||
end
|
||
|
||
-- Type is string
|
||
s = echo("e")
|
||
|
||
-- Type is number
|
||
n = echo(10)
|
||
|
||
-- Type is boolean
|
||
b = echo(true)
|
||
|
||
-- We got all of this info from just using
|
||
-- @generic rather than manually specifying
|
||
-- each allowed type
|
||
```
|
||
|
||
### 捕獲泛型類型的名稱
|
||
```
|
||
---@class Foo
|
||
local Foo = {}
|
||
function Foo:Bar() end
|
||
|
||
---@generic T
|
||
---@param name `T` # the name generic type is captured here
|
||
---@return T # generic type is returned
|
||
function Generic(name) end
|
||
|
||
local v = Generic("Foo") -- v is an object of Foo
|
||
```
|
||
|
||
### Lua 表如何使用泛型
|
||
```
|
||
---@class table<K, V>: { [K]: V }
|
||
|
||
-- This is what allows us to create a table
|
||
-- and intellisense keeps track of any type
|
||
-- we give for key (K) or value (V)
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#generics-and-generic)
|
||
]=]
|
||
LUADOC_DESC_VARARG =
|
||
[=[
|
||
主要用於對 EmmyLua 註解的向下支援。 `@vararg` 不提供輸入或允許描述。
|
||
|
||
**在記錄參數(變數或非變數)時,您應該改用 `@param`。**
|
||
|
||
## 語法
|
||
`@vararg <type>`
|
||
|
||
## 用法
|
||
```
|
||
---Concat strings together
|
||
---@vararg string
|
||
function concat(...) end
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#vararg)
|
||
]=]
|
||
LUADOC_DESC_OVERLOAD =
|
||
[=[
|
||
允許定義多個函數簽章。
|
||
|
||
## 語法
|
||
`---@overload fun(<name>[: <type>] [, <name>[: <type>]]...)[: <type>[, <type>]...]`
|
||
|
||
## 用法
|
||
```
|
||
---@overload fun(t: table, value: any): number
|
||
function table.insert(t, position, value) end
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#overload)
|
||
]=]
|
||
LUADOC_DESC_DEPRECATED =
|
||
[=[
|
||
將函式標記為已棄用。 這會導致任何不推薦使用的函式呼叫被 ~~擊穿~~。
|
||
|
||
## 語法
|
||
`---@deprecated`
|
||
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#deprecated)
|
||
]=]
|
||
LUADOC_DESC_META =
|
||
[=[
|
||
表示這是一個中繼檔案,應僅用於定義和智慧感知。
|
||
|
||
中繼檔案有 3 個主要區別需要注意:
|
||
1. 中繼檔案中不會有任何基於上下文的智慧感知
|
||
2. 將 `require` 檔案路徑懸停在中繼檔案中會顯示 `[meta]` 而不是絕對路徑
|
||
3. `Find Reference` 功能會忽略中繼檔案
|
||
|
||
## 語法
|
||
`---@meta`
|
||
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#meta)
|
||
]=]
|
||
LUADOC_DESC_VERSION =
|
||
[=[
|
||
指定此函式獨有的 Lua 版本。
|
||
|
||
Lua 版本:`5.1` 、 `5.2` 、 `5.3` 、 `5.4` 、 `JIT`。
|
||
|
||
需要 `Diagnostics: Needed File Status` 設定。
|
||
|
||
## 語法
|
||
`---@version <version>[, <version>]...`
|
||
|
||
## 用法
|
||
### 一般
|
||
```
|
||
---@version JIT
|
||
function onlyWorksInJIT() end
|
||
```
|
||
### 指定多個版本
|
||
```
|
||
---@version <5.2,JIT
|
||
function oldLuaOnly() end
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#version)
|
||
]=]
|
||
LUADOC_DESC_SEE =
|
||
[=[
|
||
定義可以檢視以獲取更多資訊的內容
|
||
|
||
## Syntax
|
||
`---@see <text>`
|
||
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#see)
|
||
]=]
|
||
LUADOC_DESC_DIAGNOSTIC =
|
||
[=[
|
||
啟用/停用診斷錯誤與警告等。
|
||
|
||
操作:`disable` 、 `enable` 、 `disable-line` 、 `disable-next-line`
|
||
|
||
[名稱](https://github.com/LuaLS/lua-language-server/blob/cbb6e6224094c4eb874ea192c5f85a6cba099588/script/proto/define.lua#L54)
|
||
|
||
## 語法
|
||
`---@diagnostic <action>[: <name>]`
|
||
|
||
## 用法
|
||
### 停用下一行
|
||
```
|
||
---@diagnostic disable-next-line: undefined-global
|
||
```
|
||
|
||
### 手動切換
|
||
```
|
||
---@diagnostic disable: unused-local
|
||
local unused = "hello world"
|
||
---@diagnostic enable: unused-local
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#diagnostic)
|
||
]=]
|
||
LUADOC_DESC_MODULE =
|
||
[=[
|
||
提供 `require` 的語義。
|
||
|
||
## 語法
|
||
`---@module <'module_name'>`
|
||
|
||
## 用法
|
||
```
|
||
---@module 'string.utils'
|
||
local stringUtils
|
||
-- This is functionally the same as:
|
||
local module = require('string.utils')
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#module)
|
||
]=]
|
||
LUADOC_DESC_ASYNC =
|
||
[=[
|
||
將函式標記為非同步。
|
||
|
||
## 語法
|
||
`---@async`
|
||
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#async)
|
||
]=]
|
||
LUADOC_DESC_NODISCARD =
|
||
[=[
|
||
防止此函式的回傳值被丟棄/忽略。
|
||
如果忽略回傳值,這將引發 `discard-returns` 警告。
|
||
|
||
## 語法
|
||
`---@nodiscard`
|
||
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#nodiscard)
|
||
]=]
|
||
LUADOC_DESC_CAST =
|
||
[=[
|
||
允許轉型(類型轉換)。
|
||
|
||
## 語法
|
||
`@cast <variable> <[+|-]type>[, <[+|-]type>]...`
|
||
|
||
## 用法
|
||
### 覆蓋類型
|
||
```
|
||
---@type integer
|
||
local x --> integer
|
||
|
||
---@cast x string
|
||
print(x) --> string
|
||
```
|
||
### 增加類型
|
||
```
|
||
---@type string
|
||
local x --> string
|
||
|
||
---@cast x +boolean, +number
|
||
print(x) --> string|boolean|number
|
||
```
|
||
### 移除類型
|
||
```
|
||
---@type string|table
|
||
local x --> string|table
|
||
|
||
---@cast x -string
|
||
print(x) --> table
|
||
```
|
||
---
|
||
[檢視文件](https://github.com/LuaLS/lua-language-server/wiki/Annotations#cast)
|
||
]=]
|
||
LUADOC_DESC_OPERATOR = -- TODO: need translate!
|
||
[=[
|
||
Provide type declaration for [operator metamethods](http://lua-users.org/wiki/MetatableEvents).
|
||
|
||
## Syntax
|
||
`@operator <operation>[(input_type)]:<resulting_type>`
|
||
|
||
## Usage
|
||
### Vector Add Metamethod
|
||
```
|
||
---@class Vector
|
||
---@operation add(Vector):Vector
|
||
|
||
vA = Vector.new(1, 2, 3)
|
||
vB = Vector.new(10, 20, 30)
|
||
|
||
vC = vA + vB
|
||
--> Vector
|
||
```
|
||
### Unary Minus
|
||
```
|
||
---@class Passcode
|
||
---@operation unm:integer
|
||
|
||
pA = Passcode.new(1234)
|
||
pB = -pA
|
||
--> integer
|
||
```
|
||
[View Request](https://github.com/LuaLS/lua-language-server/issues/599)
|
||
]=]
|
||
LUADOC_DESC_ENUM = -- TODO: need translate!
|
||
[=[
|
||
Mark a table as an enum. If you want an enum but can't define it as a Lua
|
||
table, take a look at the [`@alias`](https://github.com/LuaLS/lua-language-server/wiki/Annotations#alias)
|
||
tag.
|
||
|
||
## Syntax
|
||
`@enum <name>`
|
||
|
||
## Usage
|
||
```
|
||
---@enum colors
|
||
local colors = {
|
||
white = 0,
|
||
orange = 2,
|
||
yellow = 4,
|
||
green = 8,
|
||
black = 16,
|
||
}
|
||
|
||
---@param color colors
|
||
local function setColor(color) end
|
||
|
||
-- Completion and hover is provided for the below param
|
||
setColor(colors.green)
|
||
```
|
||
]=]
|
||
LUADOC_DESC_PACKAGE = -- TODO: need translate!
|
||
[=[
|
||
Mark a function as private to the file it is defined in. A packaged function
|
||
cannot be accessed from another file.
|
||
|
||
## Syntax
|
||
`@package`
|
||
|
||
## Usage
|
||
```
|
||
---@class Animal
|
||
---@field private eyes integer
|
||
local Animal = {}
|
||
|
||
---@package
|
||
---This cannot be accessed in another file
|
||
function Animal:eyesCount()
|
||
return self.eyes
|
||
end
|
||
```
|
||
]=]
|
||
LUADOC_DESC_PRIVATE = -- TODO: need translate!
|
||
[=[
|
||
Mark a function as private to a @class. Private functions can be accessed only
|
||
from within their class and are not accessable from child classes.
|
||
|
||
## Syntax
|
||
`@private`
|
||
|
||
## Usage
|
||
```
|
||
---@class Animal
|
||
---@field private eyes integer
|
||
local Animal = {}
|
||
|
||
---@private
|
||
function Animal:eyesCount()
|
||
return self.eyes
|
||
end
|
||
|
||
---@class Dog:Animal
|
||
local myDog = {}
|
||
|
||
---NOT PERMITTED!
|
||
myDog:eyesCount();
|
||
```
|
||
]=]
|
||
LUADOC_DESC_PROTECTED = -- TODO: need translate!
|
||
[=[
|
||
Mark a function as protected within a @class. Protected functions can be
|
||
accessed only from within their class or from child classes.
|
||
|
||
## Syntax
|
||
`@protected`
|
||
|
||
## Usage
|
||
```
|
||
---@class Animal
|
||
---@field private eyes integer
|
||
local Animal = {}
|
||
|
||
---@protected
|
||
function Animal:eyesCount()
|
||
return self.eyes
|
||
end
|
||
|
||
---@class Dog:Animal
|
||
local myDog = {}
|
||
|
||
---Permitted because function is protected, not private.
|
||
myDog:eyesCount();
|
||
```
|
||
]=]
|