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 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 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.

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 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.

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 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.

pmnxis.github.io

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

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.

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 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.

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 usuário.

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 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.

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 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.

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 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.

priyakdey.com

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

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.

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

Story Seed Library

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

Construa 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 minha visão única para minha página inicial pessoal. Também decidi torná-lo um projeto de código aberto. Hoje, o Blowfish se transformou em um próspero projeto de código aberto com mais de 600 estrelas no GitHub e centenas de usuários. Neste tutorial, mostrarei como começar e ter seu site funcionando 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 usados.

Miniaturas

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

Um exemplo rápido de como começar a usar miniaturas em 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, ícones personalizados também são totalmente suportados. Simplesmente forneça 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 precisa 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 usada 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

KaTeX pode ser usado 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 usando 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 com a comunidade do Blowfish.

Como começar?
#

Este é um artigo template que explica como criar um novo artigo para a seçã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

Hospedagem e implantação

priyakdey.com

Firebase: Visualizações & Curtidas

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
#