Usando GemPress para publicar sua Cápsula Gemini

2021-09-25 | aprates.dev

[1] Read this post in english

  ____                ____
 / __/  ___ _ ___ __ |  _ \ _ __ ___ ,___ ___
/ / __ / _ \ `_  `_ `| |_) | '__/ _ \ __/ __/
\ \_| |  --| | | | | |  __/| | |  --|__ |__ |
 \__,_|\___\_| |_| |_|_|   |_|  \___\___/___/               

Este é um meta post, pois trata de como publicar uma cápsula como esta no Geminispace, usando a mesma ferramenta com a qual é publicada.

O que é?

GemPress é um framework, mais adequado para usuários Linux, escrito em Bash e C para agilizar a publicação de Cápsulas Gemini, ao mesmo tempo que a torna disponível como uma página HTML comum, para um público mais amplo.

Isto permite que você crie conteúdo diretamente no formato Gemini usando qualquer editor de texto puro. E depois de configurado corretamente, com um único comando 'publique', anexe rodapés, gere o atom feed e atualize o site nos dois mundos: Gemini e HTTP(S).

Como funciona?

Publique em cinco etapas simples:

1. Siga as instruções de instalação README no repositório do projeto [2].

2. Crie seu conteúdo localmente seguindo esta estrutura de pasta e convenção de nomenclatura:

contents
├── index.gmi                 # Home
└── log                       # Pasta do log (onde as postagens vão)
    ├── index.gmi             # Arquivo (links para todas as postagens)
    └── YYYY-DD-MM-post-1.gmi # Post (exemplo)

3. Edite os rodapés gmi-footer.gmi e web-footer.gmi na pasta de modelos fornecida.

4. Verifique se está tudo certo com ./publish local para obter sua Cápsula construída em ./capsule e um clone na pasta ./website em formato HTML.

5. Publique! ./publish srht

Nota: no momento em que escrevo, apenas o SourceHut Pages [3] é suportado como serviço de hospedagem para publicação automática, mas outros serviços podem ser adicionados facilmente.

Por que isso importa?

O Geminispace tem um espírito 'faça você mesmo' em sua essência. Então decidi criar a minha própria estrutura para publicar minha Cápsula

Existem muitas outras ferramentas por aí, mas esta pode ser a melhor para aqueles que, como eu, preferem escrever o código-fonte do conteúdo como texto Gemini e querem que ele seja montado com rodapés e publicado automaticamente como uma cápsula Gemini e como um Site normal.

O código-base do projeto deve ser fácil o bastante para que outros desenvolvedores personalizem de acordo com suas necessidades, e contribuições também são bem-vindas. Algum esforço foi dedicado a tentar mantê-lo simples e bem documentado.

Contribuindo

Patches e perguntas? Participe e torne o GemPress seu também. As instruções sobre como fazer isso estão dentro do README no repositório do projeto.

Referências

[2] Repositório do projeto GemPress
[3] SourceHut Pages

Veja também

[4] Arquivos da Cápsula
[5] Home da Cápsula

Quer mais?

Comente sobre um dos meus posts, fale comigo, diga: hello@aprates.dev

[6] Assine o feed da Cápsula
[7] Confira o projeto FatScript no GitLab
[8] Confira meus projetos no GitHub
[9] Confira meus projetos no SourceHut

Junte-se ao Geminispace

Gemini é um novo protocolo de Internet introduzido em 2019, como uma alternativa ao http(s) ou gopher, para conteúdos em texto leve e melhor privacidade.

Não sabe como, mas quer fazer parte do clube? Veja:
[10] Guia de início rápido Gemini

Já tem um cliente Gemini?
[11] Navegue nesta cápsula via Gemini

---

© aprates.dev, 2021-2023 - o conteúdo deste site está licenciado sob
[12] Licença Creative Commons BY-NC-SA 4.0
[13] Construído orgulhosamente com GemPress
[14] Política de Privacidade