Acerca de los archivos reutilizables
Los archivos reutilizables son cadenas largas de texto reutilizable, como párrafos o listas de procedimientos, a las que se puede hacer referencia en varios archivos de contenido.
Usamos Markdown (en lugar de YAML) para los archivos reutilizables. Markdown permite que nuestra canalización de localización divida las cadenas en segmentos traducibles más pequeños, lo que provoca menos errores de traducción y menos abandono cuando cambia el contenido de origen en inglés.
Cada archivo reutilizable reside en su propio archivo Markdown.
La ruta de acceso y el nombre de archivo de cada archivo Markdown determina cuál será su ruta de acceso en el objeto de datos. Por ejemplo, en las páginas se podrá acceder a un archivo denominado /data/reusables/foo/bar.md como {% data reusables.foo.bar %}.
Los archivos reutilizables se dividen generalmente en directorios por tarea. Por ejemplo, si vas a crear una cadena reutilizable para artículos sobre notificaciones GitHub, la agregarías en el directorio data/reusables/notifications/, en un archivo denominado data/reusables/notifications/YOUR-REUSABLE-NAME.md. La referencia de contenido que agregaría al origen sería similar a {% data reusables.notifications.YOUR-REUSABLE-NAME %}.
Aplicación del control de versiones a los archivos reutilizables
Las archivos reutilizables pueden incluir condicionales Liquid para representar de forma condicional el contenido en función de la versión actual que se vea.
Acerca de las variables
Las variables son cadenas cortas de texto reutilizable.
Usamos archivos YAML para las variables.
La ruta, el nombre de archivo y las claves de cada archivo YAML determinan cuál será su ruta en el objeto de datos.
Por ejemplo, este archivo YAML, data/variables/foo/bar.yml, contiene dos variables:
# the YAML file can contain multiple short strings in one file
meaning_of_life: 42
# the strings can also be nested if needed
nested:
values:
too: Yes!
Los valores serían accesibles como {% data foo.bar.meaning_of_life %} y {% data foo.bar.nested.values.too %}.