gantry5
5.5.19
¿Listo para empezar con Gantry 5? ¡Genial! Estamos aquí para ayudar.
En esta página, obtendrá algunos consejos rápidos que le ayudarán a empezar a utilizar Gantry 5. Puede encontrar documentación más detallada para cada uno de estos consejos haciendo clic en el botón Más información en la parte inferior de cada sección.
Esperamos que disfrutes de Gantry 5 tanto como nosotros disfrutamos haciéndolo.
Los requisitos de administración back-end de Gantry en orden de preferencia son los siguientes:
Nota: Internet Explorer ya no es compatible
Gantry 5 es un marco mediante el cual se crean temas impulsados por Gantry. Para que un tema de Gantry funcione, necesitarás instalar tanto el marco como el tema . Hacer esto no es nada difícil.
Lo primero que debe hacer es descargar la última versión de Gantry 5 e Hydrogen. Puede hacerlo haciendo clic en los enlaces a continuación o a través de GitHub.
| Descargar estable | Descargar compilaciones de CI |
|---|
Una vez que tenga los paquetes más recientes, la instalación es sencilla. Proporcionamos una guía paso a paso en la parte de Instalación de esta documentación.
Más información
Cuando haya instalado y activado tanto el marco Gantry como Hydrogen, podrá acceder al administrador de Gantry 5 de varias maneras diferentes. Lo más fácil es simplemente navegar a Componentes > Plantillas Gantry 5 desde la parte posterior de Joomla.
Aquí verá una lista de todos los temas instalados con Gantry. Puede obtener una vista previa del tema desde aquí o seleccionar Configurar para ir directamente al Administrador de Gantry, donde puede comenzar a modificar su sitio con tecnología Gantry.
El Administrador de Gantry tiene múltiples herramientas administrativas que puede consultar para configurar el aspecto y las funciones de su tema impulsado por Gantry. A continuación se ofrece un desglose rápido de cada una de estas herramientas y lo que puede hacer con ellas.
Notará los siguientes elementos del menú en Gantry 5 Administrator:
Editor de menú : este panel administrativo le brinda la posibilidad de mejorar el menú de la plataforma modificando el estilo, reorganizando enlaces y creando elementos de menú que se encuentran fuera del Administrador de menús integrado del CMS.
Acerca de : esta página le brinda información rápida y de un vistazo sobre el tema al que accede actualmente. Esta es una ventanilla única para obtener información sobre el tema, que incluye: nombre, número de versión, creador, enlaces de soporte, funciones y más.
Configuración de plataforma : este botón lo lleva a la página de configuración del CMS para Gantry 5. En Joomla, esta es la página de configuración de permisos .
Borrar caché : este botón borra los archivos de caché relacionados con Gantry. Esto incluye todos los archivos temporales fuera de CSS y la información de configuración.
Menú desplegable de esquemas : este menú desplegable facilita el cambio rápido entre esquemas sin tener que salir del Administrador de Gantry.
Estilos : este panel administrativo le brinda acceso a configuraciones de esquema relacionadas con el estilo. Esto incluye cosas como colores de tema, fuentes, ajustes preestablecidos de estilo y más.
Configuración : Este panel administrativo le ofrece la posibilidad de configurar los ajustes funcionales del tema. Esto incluye configurar valores predeterminados para partículas, así como habilitar/deshabilitar partículas individuales.
Diseño : este panel administrativo es donde configurará el diseño de su tema. En este panel se crea un módulo de colocación de posiciones, partículas, espaciadores y scripts no renderizados, como el código de Google Analytics.
Más información
Debido a que Gantry 5 es tan diferente de cualquier versión de Gantry anterior, se nos ocurrieron algunos términos para ayudar a entender las relaciones que las nuevas características de Gantry tienen entre sí. A continuación se ofrece un desglose rápido de los términos de uso común relacionados con Gantry 5.
| Término | Definición |
|---|---|
| Describir | Un estilo configurable utilizado en una o más áreas de su sitio. Sirve como contenedor en el que se establecen el estilo, la configuración y el diseño de una página. |
| Partícula | Un bloque de datos típicamente pequeño que se utiliza en el front-end. Actúa de manera muy parecida a un widget/módulo, pero se puede configurar fácilmente en el Administrador de Gantry 5. |
| Átomo | Un tipo de partícula que contiene datos no renderizados, como secuencias de comandos personalizadas (JS, CSS, etc.) o secuencias de comandos de análisis para el seguimiento del tráfico. |
Más información
Se ha creado una sala de chat utilizando Gitter donde puedes ir a hablar sobre el proyecto con desarrolladores, contribuyentes y otros miembros de la comunidad. Este es el mejor lugar al que acudir para obtener consejos rápidos y analizar funciones con otras personas.
La documentación también está disponible y se agrega continuamente a medida que avanza el desarrollo. ¿Falta algo? Puedes contribuir a la documentación a través de GitHub.
Contribuir al marco Gantry 5 o a su documentación asociada es fácil. El desarrollo de ambos proyectos se lleva a cabo a través de Github, donde puede enviar problemas para informar cualquier error o sugerir mejoras, así como enviar sus propias solicitudes de extracción para enviar sus propias correcciones y adiciones.
Recomendamos conversar con el equipo a través de Gitter antes de enviar la solicitud de extracción para evitar duplicar una solución que ya está pendiente o que probablemente se sobrescribirá con un próximo cambio.
Para usar la versión git de Gantry, primero debe instalar las dependencias del compositor. Para hacer esto, ejecute:
bin/composer-install
Después de eso, debe vincular correctamente Gantry a su instalación de CMS.
En nuestro entorno de desarrollo, utilizamos Gulp para agrupar JavaScript y compilar SCSS con la capacidad de watch para que cualquier cambio en los archivos de destino active automáticamente la recompilación.
Si desea configurar esto en su propio entorno de desarrollo, puede hacerlo siguiendo estas sencillas instrucciones.
Tenga en cuenta que para que esto funcione, necesita tener el código fuente Gantry 5 y no un paquete. Puedes clonarlo o descargar la fuente desde GitHub.
Lo primero que necesitas es Node / NPM . Si aún no los tiene, puede obtener el instalador para su sistema operativo desde https://nodejs.org/download/.
El siguiente paso es instalar todas las dependencias del módulo JS. Para hacerlo, asegúrese de estar en la raíz del proyecto Gantry 5 y ejecute el comando npm install .
Una vez hecho esto, puedes instalar Gulp . Recomendamos instalar Gulp globalmente para que pueda usar el comando desde cualquier carpeta. Aquí está el comando para hacerlo: sudo npm install gulp --global
Gantry tiene diferentes conjuntos de archivos JS y CSS que se pueden volver a compilar desde la raíz. La primera vez que comience con Gantry, o si alguna vez necesita restablecer y reinstalar todos los módulos, puede ejecutar el comando npm run build-assets . Esta operación eliminará todas las carpetas node_modules y volverá a ejecutar npm install en todas las carpetas del proyecto. Tomará un tiempo.
Un método alternativo que no eliminará todas las carpetas node_modules es mediante gulp -up .
Junto con el comando
-up, también puede utilizar-update,--update,-up,--up,-install,--install,-inst,--inst,-go,--go,-deps,--deps. Lo que te resulte más fácil de recordar. El código entenderá por sí solo si necesita instalarse por primera vez o simplemente actualizar los módulos del nodo.Tenga en cuenta que esto puede tardar unos momentos.
En este punto tienes todo lo que necesitas para ejecutar Gulp. Simplemente escriba el comando gulp y debería ver cómo se compilan CSS y JS.
También proporcionamos algunas tareas útiles:
$ gulp / $ gulp all : compila todo el CSS y JS del proyecto.$ gulp watch : inicia los compiladores en modo watch . Cualquier cambio aplicado a archivos JS o SCSS de destino activará una recompilación automática.$ gulp watch --css / $ gulp watch --js : inicia los compiladores en modo watch y escucha solo los cambios SCSS o JS . Útil si sólo te concentras en uno y no en el otro.$ gulp css / $ gulp js : compila todos los archivos CSS o JS, en caso de que solo esté trabajando en uno y no en el otro.$ gulp —prod : compila todos los CSS y JS en modo de producción. Los archivos compilados no tendrán mapas de origen y se comprimirán (esto suele tardar un poco más que el modo normal). El archivo JSON de Google Fonts se puede generar siguiendo la guía en https://developers.google.com/fonts/docs/developer_api o simplemente usando https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY -URL https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY . Debe habilitar el uso de la API de Google Fonts y proporcionar su clave API en lugar de YOUR-API-KEY .
Gantry Framework v5 o posterior tiene un sistema de licencia dual (MIT o GPL versión 2 o posterior). Esto significa que usted es libre de elegir qué licencia (MIT o GPL versión 2 o posterior) es adecuada para sus necesidades.
| Más detalles |
|---|
