TypeDoc includes a lot of literal strings. By convention, messages which are displayed
to the user at the INFO level or above should be present in this object to be available
for translation. Messages at the VERBOSE level need not be translated as they are primarily
intended for debugging. ERROR/WARNING deprecation messages related to TypeDoc's API, or
requesting users submit a bug report need not be translated.
Errors thrown by TypeDoc are generally not considered translatable as they are not
displayed to the user. An exception to this is errors thrown by the validate method
on options, as option readers will use them to report errors to the user.
Interface Keys
This object uses a similar convention as TypeScript, where the specified key should
indicate where placeholders are present by including a number in the name. This is
so that translations can easily tell that they are including the appropriate placeholders.
This will also be validated at runtime by the Internationalization class, but
it's better to have that hint when editing as well.
This interface defines the available translatable strings, and the number of placeholders
that are required to use each string. Plugins may use declaration merging to add members
to this interface to use TypeDoc's internationalization module.
Example
declaremodule"typedoc" { interfaceTranslatableStrings { // Define a translatable string with no arguments plugin_msg: []; // Define a translatable string requiring one argument plugin_msg_0: [string]; } }
at_most_one_inheritdoc_tag_expected_in_comment_at_0:[string] = "At most one @inheritDoc tag is expected in a comment, ignoring all but the first in comment at {0}"
at_most_one_remarks_tag_expected_in_comment_at_0:[string] = "At most one @remarks tag is expected in a comment, ignoring all but the first in comment at {0}"
at_most_one_returns_tag_expected_in_comment_at_0:[string] = "At most one @returns tag is expected in a comment, ignoring all but the first in comment at {0}"
content_in_remarks_block_overwritten_by_inheritdoc_in_comment_at_0:[string] = "Content in the @remarks block will be overwritten by the @inheritDoc tag in comment at {0}"
content_in_summary_overwritten_by_inheritdoc_in_comment_at_0:[string] = "Content in the summary section will be overwritten by the @inheritDoc tag in comment at {0}"
frontmatter_children_0_should_be_an_array_of_strings_or_object_with_string_values:[string] = "Frontmatter children in {0} should be an array of strings or an object with string values"
Readonlygit_remote_0_not_valid
git_remote_0_not_valid:[string] = ...
Readonlyglob_0_did_not_match_any_files
glob_0_did_not_match_any_files:[string] = ...
Readonlyhelp_alwaysCreateEntryPointModule
help_alwaysCreateEntryPointModule:[] = "When set, TypeDoc will always create a `Module` for entry points, even if only one is provided"
Readonlyhelp_basePath
help_basePath:[] = "Specifies the base path to be used when displaying file paths"
Readonlyhelp_blockTags
help_blockTags:[] = "Block tags which TypeDoc should recognize when parsing comments"
Readonlyhelp_cacheBust
help_cacheBust:[] = "Include the generation time in links to static assets"
Readonlyhelp_categorizeByGroup
help_categorizeByGroup:[] = "Specify whether categorization will be done at the group level"
Readonlyhelp_categoryOrder
help_categoryOrder:[] = "Specify the order in which categories appear. * indicates the relative order for categories not in the list"
Readonlyhelp_cleanOutputDir
help_cleanOutputDir:[] = "If set, TypeDoc will remove the output directory before writing output"
Readonlyhelp_cname
help_cname:[] = "Set the CNAME file text, it's useful for custom domains on GitHub Pages"
Readonlyhelp_commentStyle
help_commentStyle:[] = "Determines how TypeDoc searches for comments"
Readonlyhelp_compilerOptions
help_compilerOptions:[] = "Selectively override the TypeScript compiler options used by TypeDoc"
Readonlyhelp_customCss
help_customCss:[] = "Path to a custom CSS file to for the theme to import"
Readonlyhelp_customFooterHtml
help_customFooterHtml:[] = "Custom footer after the TypeDoc link"
Readonlyhelp_customFooterHtmlDisableWrapper
help_customFooterHtmlDisableWrapper:[] = "If set, disables the wrapper element for customFooterHtml"
Readonlyhelp_customJs
help_customJs:[] = "Path to a custom JS file to import"
Readonlyhelp_darkHighlightTheme
help_darkHighlightTheme:[] = "Specify the code highlighting theme in dark mode"
Readonlyhelp_defaultCategory
help_defaultCategory:[] = "Specify the default category for reflections without a category"
Readonlyhelp_disableGit
help_disableGit:[] = "Assume that all can be linked to with the sourceLinkTemplate, sourceLinkTemplate must be set if this is enabled. {path} will be rooted at basePath"
Readonlyhelp_disableSources
help_disableSources:[] = "Disable setting the source of a reflection when documenting it"
Readonlyhelp_emit
help_emit:[] = "Specify what TypeDoc should emit, 'docs', 'both', or 'none'"
Readonlyhelp_entryPoints
help_entryPoints:[] = "The entry points of your documentation"
Readonlyhelp_entryPointStrategy
help_entryPointStrategy:[] = "The strategy to be used to convert entry points into documentation modules"
Readonlyhelp_exclude
help_exclude:[] = "Define patterns to be excluded when expanding a directory that was specified as an entry point"
Readonlyhelp_excludeCategories
help_excludeCategories:[] = "Exclude symbols within this category from the documentation"
Readonlyhelp_excludeExternals
help_excludeExternals:[] = "Prevent externally resolved symbols from being documented"
Readonlyhelp_excludeInternal
help_excludeInternal:[] = "Prevent symbols that are marked with @internal from being documented"
Readonlyhelp_excludeNotDocumented
help_excludeNotDocumented:[] = "Prevent symbols that are not explicitly documented from appearing in the results"
Readonlyhelp_excludeNotDocumentedKinds
help_excludeNotDocumentedKinds:[] = "Specify the type of reflections that can be removed by excludeNotDocumented"
Readonlyhelp_excludePrivate
help_excludePrivate:[] = "Ignore private variables and methods, defaults to true."
Readonlyhelp_excludeProtected
help_excludeProtected:[] = "Ignore protected variables and methods"
Readonlyhelp_excludeReferences
help_excludeReferences:[] = "If a symbol is exported multiple times, ignore all but the first export"
Readonlyhelp_excludeTags
help_excludeTags:[] = "Remove the listed block/modifier tags from doc comments"
Readonlyhelp_externalPattern
help_externalPattern:[] = "Define patterns for files that should be considered being external"
Readonlyhelp_externalSymbolLinkMappings
help_externalSymbolLinkMappings:[] = "Define custom links for symbols not included in the documentation"
Readonlyhelp_githubPages
help_githubPages:[] = "Generate a .nojekyll file to prevent 404 errors in GitHub Pages. Defaults to `true`"
Readonlyhelp_gitRemote
help_gitRemote:[] = "Use the specified remote for linking to GitHub/Bitbucket source files. Has no effect if disableGit or disableSources is set"
Readonlyhelp_gitRevision
help_gitRevision:[] = "Use specified revision instead of the last revision for linking to GitHub/Bitbucket source files. Has no effect if disableSources is set"
Readonlyhelp_groupOrder
help_groupOrder:[] = "Specify the order in which groups appear. * indicates the relative order for groups not in the list"
Readonlyhelp_headings
help_headings:[] = "Determines which optional headings are rendered"
Readonlyhelp_help
help_help:[] = "Print this message"
Readonlyhelp_hideGenerator
help_hideGenerator:[] = "Do not print the TypeDoc link at the end of the page"
Readonlyhelp_hideParameterTypesInTitle
help_hideParameterTypesInTitle:[] = "Hides parameter types in signature titles for easier scanning"
Readonlyhelp_highlightLanguages
help_highlightLanguages:[] = "Specify the languages which will be loaded to highlight code when rendering"
Readonlyhelp_hostedBaseUrl
help_hostedBaseUrl:[] = "Specify a base URL to be used in generating a sitemap.xml in our output folder and canonical links. If not specified, no sitemap will be generated"
Readonlyhelp_includeVersion
help_includeVersion:[] = "Add the package version to the project name"
Readonlyhelp_inlineTags
help_inlineTags:[] = "Inline tags which TypeDoc should recognize when parsing comments"
Readonlyhelp_intentionallyNotExported
help_intentionallyNotExported:[] = "A list of types which should not produce 'referenced but not documented' warnings"
Readonlyhelp_jsDocCompatibility
help_jsDocCompatibility:[] = "Sets compatibility options for comment parsing that increase similarity with JSDoc comments"
Readonlyhelp_json
help_json:[] = "Specify the location and filename a JSON file describing the project is written to"
Readonlyhelp_kindSortOrder
help_kindSortOrder:[] = "Specify the sort order for reflections when 'kind' is specified"
Readonlyhelp_lang
help_lang:[] = "Sets the language to be used in generation and in TypeDoc's messages"
Readonlyhelp_lightHighlightTheme
help_lightHighlightTheme:[] = "Specify the code highlighting theme in light mode"
Readonlyhelp_locales
help_locales:[] = "Add translations for a specified locale. This option is primarily intended to be used as a stopgap while waiting for official locale support to be added to TypeDoc"
Readonlyhelp_logLevel
help_logLevel:[] = "Specify what level of logging should be used"
Readonlyhelp_markdownItLoader
help_markdownItLoader:[] = "Specify a callback to be called when loading the markdown-it instance. Will be passed the instance of the parser which TypeDoc will use"
Readonlyhelp_markdownItOptions
help_markdownItOptions:[] = "Specify the options passed to markdown-it, the Markdown parser used by TypeDoc"
Readonlyhelp_markdownLinkExternal
help_markdownLinkExternal:[] = "Specifies that http[s]:// links in comments and markdown files should be treated as external links to be opened in a new tab"
Readonlyhelp_maxTypeConversionDepth
help_maxTypeConversionDepth:[] = "Set the maximum depth of types to be converted"
Readonlyhelp_modifierTags
help_modifierTags:[] = "Modifier tags which TypeDoc should recognize when parsing comments"
Readonlyhelp_name
help_name:[] = "Set the name of the project that will be used in the header of the template"
Readonlyhelp_navigation
help_navigation:[] = "Determines how the navigation sidebar is organized"
Readonlyhelp_navigationLeaves
help_navigationLeaves:[] = "Branches of the navigation tree which should not be expanded"
Readonlyhelp_navigationLinks
help_navigationLinks:[] = "Defines links to be included in the header"
Readonlyhelp_options
help_options:[] = "Specify a json option file that should be loaded. If not specified TypeDoc will look for 'typedoc.json' in the current directory"
Readonlyhelp_out
help_out:[] = "Specify the location the documentation should be written to"
Readonlyhelp_packageOptions
help_packageOptions:[] = "Set options which will be set within each package when entryPointStrategy is set to packages"
Readonlyhelp_plugin
help_plugin:[] = "Specify the npm plugins that should be loaded. Omit to load all installed plugins"
Readonlyhelp_preserveLinkText
help_preserveLinkText:[] = "If set, @link tags without link text will use the text content as the link. If not set, will use the target reflection name"
Readonlyhelp_preserveWatchOutput
help_preserveWatchOutput:[] = "If set, TypeDoc will not clear the screen between compilation runs"
Readonlyhelp_pretty
help_pretty:[] = "Specify whether the output JSON should be formatted with tabs"
Readonlyhelp_projectDocuments
help_projectDocuments:[] = "Documents which should be added as children to the root of the generated documentation. Supports globs to match multiple files"
Readonlyhelp_readme
help_readme:[] = "Path to the readme file that should be displayed on the index page. Pass `none` to disable the index page and start the documentation on the globals page"
Readonlyhelp_requiredToBeDocumented
help_requiredToBeDocumented:[] = "A list of reflection kinds that must be documented"
Readonlyhelp_searchCategoryBoosts
help_searchCategoryBoosts:[] = "Configure search to give a relevance boost to selected categories"
Readonlyhelp_searchGroupBoosts
help_searchGroupBoosts:[] = 'Configure search to give a relevance boost to selected kinds (eg "class")'
Readonlyhelp_searchInComments
help_searchInComments:[] = "If set, the search index will also include comments. This will greatly increase the size of the search index"
Readonlyhelp_searchInDocuments
help_searchInDocuments:[] = "If set, the search index will also include documents. This will greatly increase the size of the search index"
Readonlyhelp_showConfig
help_showConfig:[] = "Print the resolved configuration and exit"
Readonlyhelp_sidebarLinks
help_sidebarLinks:[] = "Defines links to be included in the sidebar"
Readonlyhelp_skipErrorChecking
help_skipErrorChecking:[] = "Do not run TypeScript's type checking before generating docs"
Readonlyhelp_sort
help_sort:[] = "Specify the sort strategy for documented values"
Readonlyhelp_sortEntryPoints
help_sortEntryPoints:[] = "If set, entry points will be subject to the same sorting rules as other reflections"
Readonlyhelp_sourceLinkExternal
help_sourceLinkExternal:[] = "Specifies that source links should be treated as external links to be opened in a new tab"
Readonlyhelp_sourceLinkTemplate
help_sourceLinkTemplate:[] = "Specify a link template to be used when generating source urls. If not set, will be automatically created using the git remote. Supports {path}, {line}, {gitRevision} placeholders"
Readonlyhelp_theme
help_theme:[] = "Specify the theme name to render the documentation with"
Readonlyhelp_titleLink
help_titleLink:[] = "Set the link the title in the header points to. Defaults to the documentation homepage"
Readonlyhelp_treatValidationWarningsAsErrors
help_treatValidationWarningsAsErrors:[] = "If set, warnings emitted during validation will be treated as errors. This option cannot be used to disable treatWarningsAsErrors for validation warnings"
Readonlyhelp_treatWarningsAsErrors
help_treatWarningsAsErrors:[] = "If set, all warnings will be treated as errors"
Readonlyhelp_tsconfig
help_tsconfig:[] = "Specify a TypeScript config file that should be loaded. If not specified TypeDoc will look for 'tsconfig.json' in the current directory"
Readonlyhelp_useHostedBaseUrlForAbsoluteLinks
help_useHostedBaseUrlForAbsoluteLinks:[] = "If set, TypeDoc will produce absolute links to pages on your site using the hostedBaseUrl option"
Readonlyhelp_useTsLinkResolution
help_useTsLinkResolution:[] = "Use TypeScript's link resolution when determining where @link tags point. This only applies to JSDoc style comments"
Readonlyhelp_validation
help_validation:[] = "Specify which validation steps TypeDoc should perform on your generated documentation"
Readonlyhelp_version
help_version:[] = "Print TypeDoc's version"
Readonlyhelp_visibilityFilters
help_visibilityFilters:[] = "Specify the default visibility for builtin filters and additional filters according to modifier tags"
Readonlyhelp_watch
help_watch:[] = "Watch files for changes and rebuild docs on change"
Readonlyhighlight_theme_0_must_be_one_of_1
highlight_theme_0_must_be_one_of_1:[string, string] = "{0} must be one of the following: {1}"
highlightLanguages_contains_invalid_languages_0:[string] = "highlightLanguages contains invalid languages: {0}, run typedoc --help for a list of supported languages"
ReadonlyhostedBaseUrl_must_start_with_http
hostedBaseUrl_must_start_with_http:[] = "hostedBaseUrl must start with http:// or https://"
inline_inheritdoc_should_not_appear_in_block_tag_in_comment_at_0:[string] = "An inline @inheritDoc tag should not appear within a block tag as it will not be processed in comment at {0}"
invalid_intentionally_not_exported_symbols_0:[string] = "The following symbols were marked as intentionally not exported, but were either not referenced in the documentation, or were exported:\n\t{0}"
loaded_multiple_times_0:[string] = "TypeDoc has been loaded multiple times. This is commonly caused by plugins which have their own installation of TypeDoc. The loaded paths are:\n\t{0}"
Readonlyloaded_plugin_0
loaded_plugin_0:[string] = ...
Readonlylocales_must_be_an_object
locales_must_be_an_object:[] = "The 'locales' option must be set to an object which resembles: { en: { theme_implements: \"Implements\" }}"
nested_packages_unsupported_0:[string] = "Project at {0} has entryPointStrategy set to packages, but nested packages are not supported"
Readonlyno_compiler_options_set
no_compiler_options_set:[] = "No compiler options set. This likely means that TypeDoc did not find your tsconfig.json. Generated documentation will probably be empty"
Readonlyno_entry_points_for_packages
no_entry_points_for_packages:[] = "No entry points provided to packages mode, documentation cannot be generated"
Readonlyno_entry_points_provided
no_entry_points_provided:[] = "No entry points were provided, this is likely a misconfiguration"
Readonlyno_entry_points_to_merge
no_entry_points_to_merge:[] = "No entry points provided to merge"
What is translatable?
TypeDoc includes a lot of literal strings. By convention, messages which are displayed to the user at the INFO level or above should be present in this object to be available for translation. Messages at the VERBOSE level need not be translated as they are primarily intended for debugging. ERROR/WARNING deprecation messages related to TypeDoc's API, or requesting users submit a bug report need not be translated.
Errors thrown by TypeDoc are generally not considered translatable as they are not displayed to the user. An exception to this is errors thrown by the
validate
method on options, as option readers will use them to report errors to the user.Interface Keys
This object uses a similar convention as TypeScript, where the specified key should indicate where placeholders are present by including a number in the name. This is so that translations can easily tell that they are including the appropriate placeholders. This will also be validated at runtime by the Internationalization class, but it's better to have that hint when editing as well.
This interface defines the available translatable strings, and the number of placeholders that are required to use each string. Plugins may use declaration merging to add members to this interface to use TypeDoc's internationalization module.
Example