The 2026 Drupal Business Survey is open. Your response will help shape the future of the Drupal business ecosystem.i.5. Convenciones en la guía
Esta guía hace las siguientes suposiciones y asume los siguientes requisitos previos:
- Esta guía está organizada en temas; vea Sección i.3, “Organización” para más detalles. Muchos temas incluyen una sección de Conocimientos previos, que lista otros temas que se requieren conocer para comprender el tema que está leyendo. También se asumen algunos conocimientos básicos: vea Sección i.2, “Audiencia y objetivo” para más detalles.
- Muchos temas del tipo tarea listan Requisitos del sitio, que son tareas que debe realizar en su sitio web antes de poder empezar la tarea en el tema que está leyendo.
- Los requisitos del sitio específicos se relacionan con el escenario de ejemplo usado a través de la guía de construir un sitio web de un mercado de granjeros ( vea Sección i.6, “Escenario de guía” para más detalles). Puede adaptar las tareas a su propio escenario, pero también tendrá que recordar los cambios que hizo cuando decida si el sitio web satisface los requisitos de cada tarea.
- Para todos las tareas después de Sección 3.7, “Running the Interactive Installer”, hay también un requisito implícito: debe tener instalada la última versión estable del sistema de gestión de contenidos en su sitio, y haber iniciado sesión con un usuario que tenga suficientes permisos para realizar la tarea ( tal como la cuenta de usuario creada cuando instaló el sitio web, que automáticamente tiene todos los permisos).
- Si ha leido todos los temas en orden, y ejecutado todos los pasos en la tarea a medida que avanza ( manteniendo la sesión iniciada ), debera tener los conocimientos básicos y los requisitos del sitio cubiertos para cada tema a medida que lo va leyendo.
- Esta guía muestra como realizar tareas usando la interfaz de usuario administrativa, y, siempre que sea posible, también usando la última versión de la herramienta de línea de comando Drush ( vea Sección 3.2, “Concept: Additional Tools” ). Puede usar diferentes herramientas de consola, tal como Drupal Console ( si busca los comandos equivalentes ), o de usar la interfaz de administración por ahora.
Las siguientes convenciones se han usado en el texto de esta guía:
- La URL ejemplo.com es la URL base de su sitio web. Vea la sección de Navegación abajo para más detalles sobre cómo se indican las URLs internas de su sitio.
- El texto que debería ver en la interfaz de usuario de su sitio web se muestra en cursiva, tal como: Haga click en Guardar configuración. Esto solo aplica a texto en la interfaz de usuario que viene del programa, no al texto que ha sido introducido en un tema anterior. Por ejemplo, en un tema sobre edición, podría ver este paso: Haga click en Editar en la fila de la página Sobre nosotros ( Editar debería estar en cursiva, pero Sobre nosotros no lo estará, porque la página Sobre nosotros fue creada en un tema anterior.
- URLs, nombres de archivo, y terminología nueva también se muestran en cursiva.
El texto que debería introducir en una línea de comandos se muestra en tipología monospace, como por ejemplo:
drush cr
- En esta guía, la palabra directorio siempre se usa para referirse a directorios de archivos ( algunas personas prefieren llamarlas carpetas ).
Para hacer la mayoría de tareas en esta guía, necesitará visitar una o más páginas de la interfaz administrativa de su sitio. Podría ver alguna cosa como esta en las instrucciones ( esto tomará más sentido cuando haya instalado el software ).
En el menú administrativo Administrar, navegue a Estructura > Taxonomía (admin/structure/taxonomy)
Las instrucciones de navegación como estas asumen que tiene el módulo Toolbar instalado, y este ejemplo significa, que en la barra superior en su sitio web, tendría que hacer click en Administrar para exponer las opciones del menú. Entonces, haga click en Estructura, luego en Taxonomía, y finalmente, estaría en la pagina con la URL http://example.com/admin/structure/taxonomy ( si la URL base de su sitio web es http://example.com ).
Aqui vemos otro ejemplo:
En el menú administrativo Administrar, navegue a Configuración > Sistema > Configuraciones básicas del sitio ) (admin/config/system/site-information)
En este ejemplo, después de hacer click en Administrar y Configuración, necesitaría encontrar la sección Sistema en la página, y dentro de ella, hacer click en Configuraciones básicas del sitio. Una vez realizados estos pasos, debería terminar en http://example.com/admin/config/system/site-information_.
Una nota más: si está usando el tema administrativo estándar del núcleo Seven, muchos botones de "Añadir" son mostrados con signos de + en ellos. Por ejemplo, en admin/content, el botón de Agregar contenido aparece como + Agregar contenido. Sin embargo, esto depende del tema y no es realmente parte del texto en el botón (por ejemplo, no necesariamente sería leído por un lector de pantalla), por lo que en esta guía, la convención es no mencionar el signo + en el botones.
Muchos de los temas de tareas en esta guía incluyen pasos donde completará un formulario web. En la mayoría de los casos, se incluirá una imagen de captura de pantalla del formulario, junto con una tabla de los valores que deberá ingresar en cada campo del formulario. Por ejemplo, puede ver una tabla que comienza así, explicando el formulario de información del sitio que vería si navegara a Configuration> System> Site information (admin / config / system / site-information):
| Nombre del campo | Explicación | Valor de ejemplo |
|---|---|---|
Detalles del sitio > Nombre del sitio | Nombre de su sitio web | Mercado de granjeros CualquierPueblo |
Para usar esta tabla, busque el campo etiquetado como Nombre del sitio en la sección que se encuentra bajo Detalles del sitio en el formulario, y introduzca el nombre de su sitio web en ese campo. Se sugiere un ejemplo de valor "Mercado de granjeros CualquierPueblo" en la tabla, que está relacionado con el escenario de construir un sitio web para un mercado de granjeros y encontrará durante toda esta guía ( vea Sección i.6, “Escenario de guía” para más detalles ). En algunos formularios, usted tendrá que hacer click en el título de la sección ( como Detalles del sitio en este ejemplo ) para expandir la sección y encontrar el campo que contiene.
Atribuciones
Escrito/editado por Jennifer Hodgdon. Traducido por Guiu Rocafort Ferrer.
Source file: preface-conventions.asciidoc
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion
