Documentação on Blowfish

Bem-vindo ao Blowfish

Mon, 01 Jan 0001 00:00:00 +0000

O Blowfish está repleto de funcionalidades.

O objetivo original do Blowfish era desenvolver um tema simples e leve. O tema é um fork do Congo e expande a sua visão inicial.

Instalação

Mon, 01 Jan 0001 00:00:00 +0000

Simplesmente siga o procedimento padrão do Hugo Início Rápido para começar rapidamente.

Instruções detalhadas de instalação podem ser encontradas abaixo. Instruções para atualizar o tema também estão disponíveis.

Instalação
#

Estas instruções irão ajudá-lo a começar com Hugo e Blowfish a partir de um estado completamente vazio. A maioria das dependências mencionadas neste guia pode ser instalada utilizando o gestor de pacotes da sua escolha para a sua plataforma.

Primeiros Passos

Mon, 01 Jan 0001 00:00:00 +0000

Esta secção assume que já instalou o tema Blowfish.

Acabámos de lançar uma ferramenta CLI para o ajudar a começar com o Blowfish. Irá ajudá-lo com a instalação e configuração. Instale a ferramenta CLI globalmente utilizando:

Configuração

Mon, 01 Jan 0001 00:00:00 +0000

O Blowfish é um tema altamente personalizável e utiliza algumas das funcionalidades mais recentes do Hugo para simplificar a sua configuração.

O tema vem com uma configuração predefinida que lhe permite começar com um blogue básico ou site estático.

Layout da Página Inicial

Mon, 01 Jan 0001 00:00:00 +0000

O Blowfish fornece um layout de página inicial totalmente flexível. Existem dois modelos principais para escolher com definições adicionais para ajustar o design. Alternativamente, também pode fornecer o seu próprio modelo e ter controlo total sobre o conteúdo da página inicial.

Shortcodes

Mon, 01 Jan 0001 00:00:00 +0000

Para além de todos os shortcodes predefinidos do Hugo, o Blowfish adiciona alguns extras para funcionalidades adicionais.

Alert
#

alert apresenta o seu conteúdo como uma caixa de mensagem estilizada dentro do seu artigo. É útil para chamar a atenção para informações importantes que não quer que o leitor perca.

Front Matter

Mon, 01 Jan 0001 00:00:00 +0000

Além dos parâmetros de front matter padrão do Hugo, o Blowfish adiciona várias opções adicionais para personalizar a apresentação de artigos individuais. Todos os parâmetros de front matter do tema disponíveis estão listados abaixo.

Múltiplos autores

Mon, 01 Jan 0001 00:00:00 +0000

Alguns websites têm mais do que um autor a contribuir com conteúdo e, portanto, requerem mais do que um único autor predefinido para todo o site. Para esses casos de uso, o Blowfish permite aos utilizadores estender a lista de autores utilizando a funcionalidade de múltiplos autores.

Partials

Mon, 01 Jan 0001 00:00:00 +0000

Analytics
#

O Blowfish fornece suporte integrado para Fathom Analytics, Google Analytics e Umami Analytics. O Fathom é uma alternativa paga ao Google Analytics que respeita a privacidade do utilizador.

Miniaturas

Mon, 01 Jan 0001 00:00:00 +0000

Miniaturas
#

O Blowfish foi melhorado para facilitar adicionar suporte visual às suas publicações. Para fazer isso, só precisa de colocar um ficheiro de imagem (quase todos os formatos são suportados, mas recomendamos .png ou .jpg) que comece com feature* dentro do diretório principal do seu artigo, como mostrado no exemplo abaixo.

Exemplos de conteúdo

Mon, 01 Jan 0001 00:00:00 +0000

Se tem lido a documentação por ordem, agora deverá conhecer todas as funcionalidades e configurações disponíveis no Blowfish. Esta página foi concebida para reunir tudo e oferecer alguns exemplos práticos que poderá querer utilizar no seu projeto Hugo.

Séries

Mon, 01 Jan 0001 00:00:00 +0000

O Blowfish fornece uma funcionalidade para agrupar um conjunto de artigos sob uma “série”. Colocar um artigo numa série apresentará os restantes artigos da série em cada página individual e fornecerá uma forma rápida de navegar entre eles. Pode ver um exemplo disso acima.

Personalização avançada

Mon, 01 Jan 0001 00:00:00 +0000

Existem muitas formas de fazer alterações avançadas ao Blowfish. Leia abaixo para saber mais sobre o que pode ser personalizado e a melhor forma de alcançar o resultado desejado.

Se precisar de mais orientação, publique as suas perguntas nas GitHub Discussions.

Alojamento e implementação

Mon, 01 Jan 0001 00:00:00 +0000

Existem muitas formas de implementar o seu website Hugo construído com Blowfish. O tema é concebido para ser flexível em quase qualquer cenário de implementação.

O Blowfish utiliza URLs relativos em todo o tema. Isto permite que os sites sejam facilmente implementados em subpastas e hosts como GitHub Pages. Normalmente não é necessária nenhuma configuração especial desde que o parâmetro baseURL tenha sido configurado no ficheiro hugo.toml.

Firebase: Visualizações & Gostos

Mon, 01 Jan 0001 00:00:00 +0000

Para poder suportar dados dinâmicos no seu website, adicionámos suporte para integrar o Firebase. Isto permitirá utilizar a funcionalidade de visualizações em listas e publicações.

Vá ao website do Firebase e crie uma conta gratuitamente
Crie um novo projeto
Selecione a localização do analytics
Configure o Firebase no Blowfish obtendo as variáveis do seu projeto e configurando-as no ficheiro params.toml. Mais detalhes podem ser encontrados nesta página. Pode encontrar um exemplo do ficheiro que o Firebase fornecerá abaixo, observe os parâmetros dentro do objeto FirebaseConfig.

// Import the functions you need from the SDKs you need
import { initializeApp } from "firebase/app";
import { getAnalytics } from "firebase/analytics";
// TODO: Add SDKs for Firebase products that you want to use
// https://firebase.google.com/docs/web/setup#available-libraries

// Your web app's Firebase configuration
// For Firebase JS SDK v7.20.0 and later, measurementId is optional
const firebaseConfig = {
  apiKey: "AIzaSyB5tqlqDky77Vb4Tc4apiHV4hRZI18KGiY",
  authDomain: "blowfish-21fff.firebaseapp.com",
  projectId: "blowfish-21fff",
  storageBucket: "blowfish-21fff.appspot.com",
  messagingSenderId: "60108104191",
  appId: "1:60108104191:web:039842ebe1370698b487ca",
  measurementId: "G-PEDMYR1V0K"
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);
const analytics = getAnalytics(app);

Configurar Firestore - Selecione Build e abra Firestore. Crie uma nova base de dados e escolha iniciar no modo produção. Selecione a localização do servidor e aguarde. Assim que estiver iniciado, precisa de configurar as regras. Basta copiar e colar o ficheiro abaixo e premir publicar. Estas regras garantem que as visualizações só podem ser incrementadas em 1, e os gostos só podem ser alterados em +1 ou -1 (e nunca abaixo de 0).

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // Views - read anyone, only increment by 1
    match /views/{document} {
      allow read: if request.auth != null;
      allow create: if request.auth != null
                    && request.resource.data.keys().hasOnly(['views'])
                    && request.resource.data.views == 1;
      allow update: if request.auth != null
                    && request.resource.data.diff(resource.data).affectedKeys().hasOnly(['views'])
                    && request.resource.data.views == resource.data.views + 1;
    }

    // Likes - read anyone, only +1 or -1
    match /likes/{document} {
      allow read: if request.auth != null;
      allow create: if request.auth != null
                    && request.resource.data.keys().hasOnly(['likes'])
                    && request.resource.data.likes == 1;
      allow update: if request.auth != null
                    && request.resource.data.diff(resource.data).affectedKeys().hasOnly(['likes'])
                    && (request.resource.data.likes == resource.data.likes + 1
                        || request.resource.data.likes == resource.data.likes - 1)
                    && request.resource.data.likes >= 0;
    }

    // Deny everything else
    match /{document=**} {
      allow read, write: if false;
    }
  }
}

Ativar autorização anónima - Selecione Build e abra Authentication. Selecione começar, clique em Anónimo e ative, guarde.
Aproveite - agora pode ativar visualizações e gostos no Blowfish para todos (ou específicos) artigos.

Documentação on Blowfish

Bem-vindo ao Blowfish

Instalação

Instalação #

Primeiros Passos

Configuração

Layout da Página Inicial

Shortcodes

Alert #

Front Matter

Múltiplos autores

Partials

Analytics #

Miniaturas

Miniaturas #

Exemplos de conteúdo

Séries

Personalização avançada

Alojamento e implementação

Firebase: Visualizações & Gostos

Instalação
#

Alert
#

Analytics
#

Miniaturas
#