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 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 vão te ajudar 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 usando o gerenciador de pacotes de sua escolha para sua plataforma.

Primeiros Passos

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

Esta seção assume que você já instalou o tema Blowfish.

Acabamos de lançar uma ferramenta CLI para ajudá-lo a começar com o Blowfish. Ela ajudará com a instalação e configuração. Instale a ferramenta CLI globalmente usando:

Configuração

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

O Blowfish é um tema altamente personalizável e usa alguns dos recursos mais recentes do Hugo para simplificar sua configuração.

O tema vem com uma configuração padrão que permite você começar com um blog 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 configurações adicionais para ajustar o design. Alternativamente, você também pode fornecer seu próprio modelo e ter controle total sobre o conteúdo da página inicial.

Shortcodes

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

Além de todos os shortcodes padrão do Hugo, o Blowfish adiciona alguns extras para funcionalidades adicionais.

Alert
#

alert exibe seu conteúdo como uma caixa de mensagem estilizada dentro do seu artigo. É útil para chamar a atenção para informações importantes que você 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 sites têm mais de um autor contribuindo com conteúdo e, portanto, requerem mais de um único autor padrão para todo o site. Para esses casos de uso, o Blowfish permite aos usuários estender a lista de autores usando o recurso 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 usuário.

Miniaturas

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

Miniaturas
#

O Blowfish foi aprimorado para facilitar adicionar suporte visual às suas postagens. Para fazer isso, você só precisa colocar um arquivo 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 você está lendo a documentação em ordem, agora deve conhecer todos os recursos e configurações disponíveis no Blowfish. Esta página foi projetada para reunir tudo e oferecer alguns exemplos práticos que você pode querer usar em seu projeto Hugo.

Séries

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

O Blowfish fornece um recurso para agrupar um conjunto de artigos sob uma “série”. Colocar um artigo em uma série exibirá o restante dos artigos da série em cada página individual e fornecerá uma maneira rápida de navegar entre eles. Você pode ver um exemplo disso acima.

Personalização avançada

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

Existem muitas maneiras de fazer alterações avançadas no 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, poste suas perguntas nas GitHub Discussions.

Hospedagem e implantação

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

Existem muitas formas de implantar seu site Hugo construído com Blowfish. O tema é projetado para ser flexível em quase qualquer cenário de implantação.

O Blowfish usa URLs relativas em todo o tema. Isso permite que sites sejam facilmente implantados em subpastas e hosts como GitHub Pages. Normalmente não há configuração especial necessária, desde que o parâmetro baseURL tenha sido configurado no arquivo hugo.toml.

Firebase: Visualizações & Curtidas

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

Para poder suportar dados dinâmicos em seu site, adicionamos suporte para integrar o Firebase. Isso permitirá que você use o recurso de visualizações em listas e posts.

Vá para o site 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 arquivo params.toml. Mais detalhes podem ser encontrados nesta página. Você pode encontrar um exemplo do arquivo 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 um novo banco de dados e escolha iniciar no modo produção. Selecione a localização do servidor e aguarde. Uma vez iniciado, você precisa configurar as regras. Basta copiar e colar o arquivo abaixo e pressionar publicar. Essas regras garantem que as visualizações só podem ser incrementadas em 1, e as curtidas só podem ser alteradas 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;
 }
 }
}

Habilitar autorização anônima - Selecione Build e abra Authentication. Selecione começar, clique em Anônimo e ative, salve.
Aproveite - agora você pode ativar visualizações e curtidas 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

Hospedagem e implantação

Firebase: Visualizações & Curtidas

Instalação
#

Alert
#

Analytics
#

Miniaturas
#