diff --git a/core/config/schema/core.data_types.schema.yml b/core/config/schema/core.data_types.schema.yml index 2eb112b..b5337c3 100644 --- a/core/config/schema/core.data_types.schema.yml +++ b/core/config/schema/core.data_types.schema.yml @@ -728,33 +728,25 @@ field.float.value: type: float label: 'Value' -# Human readable string that is associated with a format. +# Text with a text format. text_format: type: mapping label: 'Text with text format' - # Even though it is not sensible to translate the text format of a formatted - # string, we conceive of the text and its date format as a single composite - # object and declare that object (or in other words the entire mapping) as - # translatable. This causes the entire mapping to be saved to the language - # overrides of the configuration. Storing only the (to be formatted) text - # could result in security problems in case the text format of the source - # text is changed. + # We declare the entire mapping of text and text format as translatable. This + # causes the entire mapping to be saved to the language overrides of the + # configuration. Storing only the (to be formatted) text could result in + # security problems in case the text format of the source text is changed. translatable: true mapping: value: type: text label: 'Text' - # locale.module integrates the language overrides of shipped configuration - # with https://localize.drupal.org. Because it only handles strings and - # cannot deal with complex data structures, it parses the configuration - # schema until it reaches a primitive and only then checks whether the - # element is translatable. + # Mark the actual text as translatable (in addition to the entire mapping + # being marked as translatable) so that shipped configuration with + # formatted text can participate in the string translation system. translatable: true format: type: string label: 'Text format' - # Even though the entire 'text_format' is marked as translatable for the - # sake of language configuration overrides, the ID of the text format of - # texts in shipped configuration should not be exposed to - # https://localize.drupal.org - + # The text format should not be translated as part of the string + # translation system, so this is not marked as translatable.