gantry5
5.5.19
Pronto para começar com o Gantry 5? Isso é ótimo! Estamos aqui para ajudar.
Nesta página, você obterá algumas dicas rápidas para ajudá-lo a começar a usar o Gantry 5. Você pode encontrar documentação mais detalhada para cada uma dessas dicas clicando no botão Saiba mais na parte inferior de cada seção.
Esperamos que você goste do Gantry 5 tanto quanto nós gostamos de fazê-lo.
Os requisitos de administração back-end do Gantry em ordem de preferência são os seguintes:
Nota: o Internet Explorer não é mais compatível
Gantry 5 é uma estrutura pela qual os temas baseados em Gantry são criados. Para que um tema Gantry funcione, você precisará instalar o framework e o tema . Fazer isso não é nada difícil.
A primeira coisa que você precisa fazer é baixar a versão mais recente do Gantry 5 e do Hydrogen. Você pode fazer isso clicando nos links abaixo ou via GitHub.
| Baixar Estável | Baixar compilações de CI |
|---|
Depois de ter os pacotes mais recentes, a instalação é simples. Fornecemos um guia passo a passo na parte Instalação desta documentação.
Saber mais
Depois de instalar e ativar a estrutura Gantry e o Hydrogen, você poderá acessar o administrador do Gantry 5 de várias maneiras diferentes. O mais fácil é simplesmente navegar até Componentes > Modelos do Gantry 5 no back-end do Joomla.
Aqui, você verá uma lista de todos os temas instalados com tecnologia Gantry. Você pode visualizar o tema aqui ou selecionar Configurar para ir diretamente ao administrador do Gantry, onde você pode começar a modificar seu site com tecnologia Gantry.
O Gantry Administrator possui várias ferramentas administrativas que você pode navegar para configurar a aparência e o funcionamento do seu tema desenvolvido pelo Gantry. Aqui está uma análise rápida de cada uma dessas ferramentas e o que você pode fazer com elas.
Você notará os seguintes itens de menu no Administrador do Gantry 5:
Editor de Menu : Este painel administrativo oferece a capacidade de aprimorar o menu da plataforma alterando o estilo, reorganizando links e criando itens de menu que ficam fora do Gerenciador de Menu integrado do CMS.
Sobre : Esta página fornece informações rápidas e resumidas sobre o tema atualmente acessado. Este é um balcão único para obter informações sobre o tema, incluindo: nome, número da versão, criador, links de suporte, recursos e muito mais.
Configurações da plataforma : Este botão leva você para a página de configurações do CMS para Gantry 5. No Joomla, esta é a página de configuração de permissões .
Limpar Cache : Este botão limpa os arquivos de cache relacionados ao Gantry. Isso inclui todos os arquivos temporários fora do CSS e informações de configuração.
Menu suspenso de contornos : esse menu suspenso facilita a alternância rápida entre contornos sem a necessidade de sair do administrador do Gantry.
Estilos : Este painel administrativo dá acesso às configurações de contorno relacionadas ao estilo. Isso inclui coisas como cores de tema, fontes, predefinições de estilo e muito mais.
Configurações : Este painel administrativo oferece a capacidade de definir as configurações funcionais do tema. Isso inclui definir padrões para partículas, bem como ativar/desativar partículas individuais.
Layout : Este painel administrativo é onde você configuraria o layout do seu tema. A criação de posições de módulo de posicionamento, partículas, espaçadores e scripts não renderizados, como o código do Google Analytics, é feita neste painel.
Saber mais
Como o Gantry 5 é muito diferente de qualquer versão do Gantry anterior, criamos alguns termos para ajudar a entender as relações que os novos recursos do Gantry têm entre si. Aqui está uma análise rápida dos termos comumente usados relacionados ao Gantry 5.
| Prazo | Definição |
|---|---|
| Contorno | Um estilo configurável usado em uma ou mais áreas do seu site. Ele serve como o contêiner no qual o estilo, as configurações e o layout de uma página são definidos. |
| Partícula | Um bloco normalmente pequeno de dados usado no front-end. Ele funciona como um widget/módulo, mas pode ser facilmente configurado no Gantry 5 Administrator. |
| Átomo | Um tipo de partícula que contém dados não renderizados, como scripts personalizados (JS, CSS, etc.) ou scripts analíticos para rastreamento de tráfego. |
Saber mais
Uma sala de bate-papo foi criada usando o Gitter, onde você pode conversar sobre o projeto com desenvolvedores, colaboradores e outros membros da comunidade. Este é o melhor lugar para obter dicas rápidas e discutir recursos com outras pessoas.
A documentação também está disponível e é continuamente adicionada à medida que o desenvolvimento avança. Está faltando alguma coisa? Você pode contribuir com a documentação por meio do GitHub.
Contribuir para a estrutura do Gantry 5 ou para a documentação associada é fácil. O desenvolvimento de ambos os projetos está sendo conduzido via Github, onde você pode enviar problemas para relatar quaisquer bugs ou sugerir melhorias, bem como enviar suas próprias solicitações pull para enviar suas próprias correções e adições.
Recomendamos conversar com a equipe via Gitter antes de enviar a solicitação pull para evitar duplicação em uma correção que já está pendente ou que provavelmente será substituída por uma mudança futura.
Para usar a versão git do Gantry, primeiro você precisa instalar as dependências do compositor. Para fazer isso, execute:
bin/composer-install
Depois disso, você precisa vincular corretamente o Gantry à instalação do CMS.
Em nosso ambiente de desenvolvimento, usamos Gulp para agrupar JavaScript e compilar SCSS com a capacidade de watch para que qualquer alteração nos arquivos de destino acione automaticamente a recompilação.
Se desejar configurar isso em seu próprio ambiente de desenvolvimento, você pode fazê-lo seguindo estas instruções simples.
Observe que para que isso funcione, você precisa ter o código-fonte Gantry 5 e não um pacote. Você pode cloná- lo ou baixar o código-fonte do GitHub.
A primeira coisa que você precisa é Node / NPM . Se ainda não os tiver, você pode obter o instalador do seu sistema operacional em https://nodejs.org/download/.
A próxima etapa é instalar todas as dependências do módulo JS. Para fazer isso, certifique-se de estar na raiz do projeto Gantry 5 e execute o comando npm install .
Feito isso, você pode instalar o Gulp . Recomendamos instalar o Gulp globalmente para que você possa usar o comando de qualquer pasta. Aqui está o comando para fazer isso: sudo npm install gulp --global
Gantry possui diferentes conjuntos de arquivos JS e CSS que podem ser recompilados a partir da raiz. Na primeira vez que você começar a usar o Gantry, ou se precisar redefinir e reinstalar todos os módulos, poderá executar o comando npm run build-assets . Esta operação removerá todas as pastas node_modules e executará novamente npm install em todas as pastas do projeto. Isso vai demorar um pouco.
Um método alternativo que não remove todas as pastas node_modules é via gulp -up .
Junto com o comando
-up, você pode usar alternativamente-update,--update,-up,--up,-install,--install,-inst,--inst,-go,--go,-deps,--deps. O que for mais fácil para você lembrar. O código entenderá sozinho se precisa ser instalado pela primeira vez ou apenas atualizar os módulos do nó.Observe que isso pode levar alguns minutos.
Neste ponto você tem tudo que precisa para executar o Gulp. Basta digitar o comando gulp e você verá o CSS e JS sendo compilados.
Também fornecemos algumas tarefas úteis:
$ gulp / $ gulp all : Compila todo o CSS e JS do projeto.$ gulp watch : Inicia os compiladores no modo watch . Qualquer alteração aplicada aos arquivos JS ou SCSS direcionados acionará uma recompilação automática.$ gulp watch --css / $ gulp watch --js : Inicia os compiladores no modo watch e escuta apenas alterações SCSS ou JS . Útil se você estiver focando apenas em um e não no outro.$ gulp css / $ gulp js : Compila todos os arquivos CSS ou JS, caso você esteja trabalhando apenas em um e não no outro.$ gulp —prod : Compila cada CSS e JS no modo de produção. Os arquivos compilados não terão mapas de origem e serão compactados (isso geralmente leva um pouco mais de tempo que o modo normal). O arquivo JSON do Google Fonts pode ser gerado seguindo o guia em https://developers.google.com/fonts/docs/developer_api ou simplesmente usando https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY URL https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY . Você precisa ativar o uso da API Google Fonts e fornecer sua chave de API no lugar de YOUR-API-KEY .
O Gantry Framework v5 ou posterior é licenciado sob um sistema de licença dupla (MIT ou GPL versão 2 ou posterior. Isso significa que você é livre para escolher qual licença (MIT ou GPL versão 2 ou posterior) é apropriada para suas necessidades.
| Mais detalhes |
|---|
