bookish

Estudioso

Ver site de demonstração

Bookish é um perfil de instalação para Drupal 9+ que tenta tornar a experiência pronta para uso para os usuários do Tome a mais agradável possível.

Em termos de funcionalidade, o Bookish é semelhante ao perfil Standard. A maior parte do trabalho neste perfil tem sido tornar a experiência de edição e o frontend o mais moderno possível.

Alguns destaques de recursos são:

• Capacidade de filtrar e cortar imagens no upload, no CKEditor ou em um campo
• Funcionalidade de desfoque para imagens, semelhante ao GatsbyJS
• Um tema com suporte ao modo escuro, criado usando componentes de arquivo único
• Integrações de mapa de site Metatag, Pathauto, Lunr e XML simples já configuradas
• Capacidade de incorporar trechos de código no CKEditor estilizados no frontend
• Uma barra de ferramentas simplificada que lista apenas os atalhos padrão

Instalar (com Tomo)

A melhor maneira de usar o Bookish é com o projeto Tome Composer.

Os requisitos para usar o Tome localmente são:

• PHP 7+
• Compositor
• Drush
• SQLite 3.26+ e as extensões PHP relacionadas

Alternativamente, você pode executar os comandos abaixo usando a imagem Docker mortenson/tome. Consulte a documentação do script Docker para referência.

O Drush Launcher, que permite digitar simplesmente drush , não é necessário para usar o Tome. Se não estiver disponível, use vendor/bin/drush .

Para instalar o Tome e o Bookish, execute estes comandos:

 composer create-project drupal-tome/tome-project my_site --stability dev --no-interaction
cd my_site
composer require drupal-tome/bookish
drush tome:init # Select Bookish in the prompt

Agora você pode enviar sua base de código, conteúdo, configuração e arquivos iniciais para o Git.

Para iniciar um servidor web local, execute:

 drush runserver

em seguida, em outra guia, execute:

 drush uli -l 127.0.0.1:8888

e clique no link para começar a editar.

Para reinstalar seu site, execute:

 drush tome:install

Para obter informações sobre a implantação do seu site, você pode visitar /admin/help/topic/bookish_help.tome em seu site local ou ler a documentação em https://tome.fyi/docs.

Instalar (sem Tomo)

Se não quiser usar o Tome, você pode executá-lo em qualquer instalação do Drupal 9+:

 composer require drupal-tome/bookish
drush si bookish -y
drush pmu tome -y

Mais ajuda

Após fazer login, clique em “Ajuda” na barra de ferramentas. Este módulo possui extensa documentação localizada dentro do Drupal usando o módulo Help Topics. Um bom lugar para começar seria a página “Configurando seu site Bookish”, que irá guiá-lo na personalização da configuração do seu site.

Acelerando seu site com navegação AJAX (experimental)

Para emular o comportamento dos roteadores JavaScript que atualizam o conteúdo principal da página em vez de navegar para uma nova página quando os links são clicados, você pode ativar o módulo Bookish Speed. Observe que seu JavaScript terá que ser executado em behaviors e terá que usar once() . Scripts e estilos embutidos não são suportados.

Exportando conteúdo como YAML (experimental)

Se preferir exportar conteúdo como arquivos .yml, você pode tentar usar o codificador experimental "yaml" para Tome adicionando esta linha a settings.php:

 $settings['tome_sync_encoder'] = 'yaml';

Em seguida, ative o módulo bookish_yaml, que reformata o conteúdo rich text para garantir que seja facilmente editável como uma string YAML de várias linhas.

Em seguida, execute "drush tome:export" para reexportar seu conteúdo como arquivos .yml e remova os arquivos .json antigos após executar "drush tome:install" e confirmar que as coisas ainda funcionam.

Este recurso é experimental, mas pode ser o padrão para instalações do Tome no futuro, então agradecemos antecipadamente por testá-lo!