Skip to content
Joniel R. de Oliveira edited this page Nov 24, 2023 · 11 revisions

Bem-vindo(a) ao JonielOliveira.github.io wiki!

Passos / Requisitos do Projeto:

  1. Configuração do Repositório: Crie um novo repositório no GitHub para o seu Wiki e clone-o para o seu ambiente de desenvolvimento local.

O repositório criado para este projeto é o: {Repositório}. Além do repositório principal existe um fork do repositório dentro da organização {Fork} cria pelos membros do grupo. Membros:


  1. Estrutura Básica: Configure a estrutura básica do projeto, incluindo a pasta de templates e recursos estáticos.

A estrutura básica aplicada ao projeto está apresentada na imagem abaixo:

Estrutura do Projeto


  1. Criação de Postagens: Crie um arquivo JSON para armazenar as informações gerais como titulo, descrição e autor.

  2. Geração de Páginas: Use a linguagem Python para ler os dados de um arquivo markdown e gerar páginas HTML estáticas para cada postagem do blog.

  3. Integração do Gitflow: Configure um fluxo de trabalho com o Gitflow, que envolve a criação de branches para desenvolvimento, features e releases, para melhor organização e colaboração.

  4. Personalização e Estilo: Personalize o estilo do blog usando CSS, criando uma aparência agradável (Isso fica a critério).

  5. Teste Local: Teste o blog localmente para verificar se as postagens são geradas corretamente e se o estilo está de acordo com o esperado.

  6. Publicação no GitHub Pages: Faça o push do projeto para o repositório no GitHub e habilite o GitHub Pages nas configurações do repositório. Isso permitirá que o blog seja publicado online.

  7. Documentar como foi feito o procedimento: O primeiro post no Wiki/blog deve ser uma documentação de como você pensou e quais os principais procedimentos que realizou para concluir essa atividade.

  8. Automatização do Processo: Implemente automações usando scripts Python para atualizar automaticamente o blog quando novas postagens forem adicionadas (Opcional).


Arquivo – Requirements.txt: Utilizado para armazenar as informações ralativas as dependências necessárias para a instalação de um determinado módulo. Nesse projeto foi necessário a instalação de 3 módulos: Flask, Markdown2 e Frozen-Flask. Para a instalação desses módulos pode-se utilizar os seguintes comandos:

pip install Flask

pip install markdown2

pip install Frozen-Flask

Após a instalação desses módulos as dependências podem ser armazenadas no arquivo "requirements.txt" utilizando o seguinte comando:

pip freeze > requirements.txt

Deste modo, pode-se fazer a mesma instalação futuramente dos 3 módulos apenas usando o arquivo "requirements.txt". Isso é muito útil para criar o processo de deploy. O comando para a instalação por meio do arquivo "requirements.txt" é o seguinte:

pip install -r requirements.txt

O arquivo "requirements.txt" do projeto ficou da seguinte forma:

blinker==1.7.0 #Flask

click==8.1.7 #Flask

colorama==0.4.6 #Flask

flask==3.0.0 #Flask

frozen-flask==1.0.1 #Frozen-Flask

importlib-metadata==6.8.0 #Flask

itsdangerous==2.1.2 #Flask

Jinja2==3.1.2 #Flask

markdown2==2.4.10 #Markdown2

MarkupSafe==2.1.3 #Flask

werkzeug==3.0.1 #Flask

zipp==3.17.0 #Flask


Clone this wiki locally