Bem-vindo ao Blowfish! :tada: 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.

n9o.xyz

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

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.

madoke.org

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

code-chimp.com

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

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.

mucahitkurtlar.github.io

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

brendanwallace.github.io

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

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.

pmnxis.github.io

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

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.

ciicadalab.github.io

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

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.

georgiancodeclub.github.io

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

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.

fahru.my.id

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

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.

loisvelasco.is-a.dev

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

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.

insidemordecai.com

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

blastomussa.dev

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

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.

jam.dsg.li

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

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.

priyakdey.com

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

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.

sdehm.dev

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

dizzytech.de

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

alejandro-ao.com

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

adir1.com

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

blog.muffn.io

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

nick.bouwhuis.net

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

vividscc.com

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

technicat.com

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

fugugames.com

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

hyperbowl3d.com

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

talkdimsum.com

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

alanctanner.com

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

rdgo.dev

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

clemsau.com

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

weaxsey.org

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

nikarashihatsu.github.io

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

halcyonstraits.com

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

50-nuances-octets.fr

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

marupanda.art/marucomics

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

m3upt.com

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

pacochan.net

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

vkmki001.github.io

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

bbagwang.com

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

jamiemoxon.tech

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

theindiecoder.cloud

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

gma.name

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

mayer.life

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

scottmckendry.tech

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

ohdmire.github.io

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

ricklan.photography

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

deepumohan.com/tech

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

joush007.github.io

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

blog.stonegarden.dev

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

renaud.warnotte.be

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

BoringTech.net

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

technicaldc.github.io

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

alxhslm.github.io

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

the-maze.net

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

DXPetti.com

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

asterisk.lol

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

ekwska.com

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

aakashnand.com

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

karlukle.site

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

Adam Madej - Gameplay Animator

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

eallion.com

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

Synaptic Sugar

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

michaeldorner.de

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

Ignacio Conde

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

UmmIt - Blog

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

nveshaan

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

kumacat.pages.dev

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

andrealucchini.com

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

glomyer.dev

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

utrodus.com

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

lazarusoverlook.com

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

p3rception.github.io

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

Handbook on Teaching Empirical Software Engineering: Online Materials

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

blog.lofibean.cc

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

Academy Customize

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

mrtruongvu.com

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

StepaniaH

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

Laterre Dev

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

Lazy Product Reviews

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

zzzhome

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

Bootleg Coal Rebellion

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

Chill-Try

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

Hudson McNamara

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

Weg um Weg

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

The Space 🌍

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

blog.francescopapini.com

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

Adri Antunez's Cloud Site

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

irusukan

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

FEEC/UNICAMP IA382 - Seminar in Computer Engineering

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

blog.francescopapini.com

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

Kyo's Garden

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

abantikabhuti.github.io

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

yag0x1.github.io

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

Learn-Software.com

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

mitri.lol

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

kieranlowe.io

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

eike.in

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

tbsch.de | Smart Home, Technik, Kram

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

metalhearf.fr

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

encelo.github.io

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

ncine.github.io

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

István Merza

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

daytaur.com

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

zzamboni.org

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

Tower of Kubes

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

monpetitdev.fr

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

Noor Khafidzin

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

Reyneese on WoW

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

David Writes

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

GOODJINC

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

Artur Tyloch

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

Tats Shibata

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

Radek Průša

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

jbetzen.net

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

alst.ovh

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

Zarvelion Zynji

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

Airika

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

Cook Like A Nerd

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

Cintia Ching

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

luizcarloscf.github.io

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

Robin Fairchild

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

Paraguay4Life

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

www.gsking.co.uk

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

Construa a sua página inicial usando Blowfish e Hugo

Wed, 04 Oct 2023 00:00:00 +0000

Há apenas um ano, criei o Blowfish, um tema Hugo criado para construir a minha visão única para a minha página inicial pessoal. Também decidi torná-lo um projeto de código aberto. Hoje, o Blowfish transformou-se num próspero projeto de código aberto com mais de 600 estrelas no GitHub e centenas de utilizadores. Neste tutorial, mostrarei como começar e ter o seu site a funcionar em alguns minutos.

Múltiplos autores

Wed, 12 Oct 2022 00:00:00 +0000

Um exemplo rápido de como múltiplos autores podem ser utilizados.

Miniaturas

Mon, 26 Sep 2022 00:00:00 +0000

Um exemplo rápido de como começar a utilizar miniaturas nos seus artigos.

Ícones

Fri, 14 Aug 2020 00:00:00 +0000

O Blowfish tem suporte integrado para vários ícones do FontAwesome 6. Estes podem ser incluídos no seu site através do partial icon ou do shortcode icon.

Além disso, os ícones personalizados também são totalmente suportados. Simplesmente forneça os seus próprios assets de ícones SVG colocando-os no diretório assets/icons/ na raiz do seu projeto. Todos os ícones no diretório de ícones estarão disponíveis em todo o tema. Para obter o preenchimento automático de cor, cada caminho SVG necessita do atributo XML fill="currentColor".

Markdown

Mon, 11 Mar 2019 00:00:00 +0000

Este artigo oferece uma amostra da formatação básica de Markdown que pode ser utilizada no Blowfish, também mostra como alguns elementos HTML básicos são decorados.

Conteúdo rico

Sun, 10 Mar 2019 00:00:00 +0000

Este é um exemplo de um resumo de conteúdo rico.

Texto de preenchimento

Sat, 09 Mar 2019 00:00:00 +0000

Lorem est tota propiore conpellat pectoribus de pectora summo.

Notação matemática

Fri, 08 Mar 2019 00:00:00 +0000

O KaTeX pode ser utilizado para renderizar notação matemática dentro dos artigos.

Diagramas e fluxogramas

Wed, 06 Mar 2019 00:00:00 +0000

É fácil adicionar diagramas e fluxogramas aos artigos utilizando Mermaid.

Gráficos

Wed, 06 Mar 2019 00:00:00 +0000

O Blowfish inclui Chart.js para gráficos e visualizações de dados poderosos.

Emoji :parachute:

Tue, 05 Mar 2019 00:00:00 +0000

📖🏞️🧗🏽🐉🧙🏽‍♂️🧚🏽👸

Template de receita

Tue, 22 Dec 1987 00:00:00 +0000

Obrigado por querer contribuir para a comunidade do Blowfish.

Como começar?
#

Este é um artigo template que explica como criar um novo artigo para a secção de guias do Blowfish.

Bem-vindo ao Blowfish! :tada: on Blowfish

Bem-vindo ao Blowfish

n9o.xyz

Instalação

Instalação #

madoke.org

code-chimp.com

Primeiros Passos

Configuração

mucahitkurtlar.github.io

brendanwallace.github.io

Layout da Página Inicial

pmnxis.github.io

Shortcodes

Alert #

ciicadalab.github.io

Front Matter

georgiancodeclub.github.io

Múltiplos autores

fahru.my.id

Partials

Analytics #

loisvelasco.is-a.dev

Miniaturas

Miniaturas #

Exemplos de conteúdo

insidemordecai.com

blastomussa.dev

Séries

jam.dsg.li

Personalização avançada

Alojamento e implementação

priyakdey.com

Firebase: Visualizações & Gostos

sdehm.dev

dizzytech.de

alejandro-ao.com

adir1.com

blog.muffn.io

nick.bouwhuis.net

vividscc.com

technicat.com

fugugames.com

hyperbowl3d.com

talkdimsum.com

alanctanner.com

rdgo.dev

clemsau.com

weaxsey.org

nikarashihatsu.github.io

halcyonstraits.com

50-nuances-octets.fr

marupanda.art/marucomics

m3upt.com

pacochan.net

vkmki001.github.io

bbagwang.com

jamiemoxon.tech

theindiecoder.cloud

gma.name

mayer.life

scottmckendry.tech

ohdmire.github.io

ricklan.photography

deepumohan.com/tech

joush007.github.io

blog.stonegarden.dev

renaud.warnotte.be

BoringTech.net

technicaldc.github.io

alxhslm.github.io

the-maze.net

DXPetti.com

asterisk.lol

ekwska.com

aakashnand.com

karlukle.site

Adam Madej - Gameplay Animator

eallion.com

Synaptic Sugar

Instalação
#

Alert
#

Analytics
#

Miniaturas
#