Giter VIP home page Giter VIP logo

tech-blog's Introduction

Tech Blog

Blog de tecnologia do Elo7

O blog usa como ferramenta o docpad, um gerador de sites estáticos.

Criando Posts

Para criar um post, basta adicionar um novo arquivo dentro da pasta src/posts com o padrão de nomenclatura <nomedopost>.html.md. O layout para o post deve ser:

---
date: 2016-07-18
category: back-end
tags:
  - java
  - mockito
  - tdd
authors: [seugithub,outrogithubsetiver]
layout: post
title: Título do post
description: Alguma descrição do post que irá aparecer na home...
---

Para adicionar imagens ao seu post, adicione cada uma das imagens na pasta src/assets/images. Sua imagem deve ser .png ou .jpg e o nome deve seguir o padrão: <nomedopost>-<numerodaimagem>.<extensão>. Para referenciá-las no post, use URLs absolutas como /images/titulo-post-1.png.

Criando sua página de autor

Se você ainda não tem a sua página de autor, crie um arquivo <seugithub>.html.md na pasta src/publishers/. O template para esse arquivo deve ser:

---
title: <seu nome - title (meta) da página>
publisher: <seu nome - h1 da página>
layout: publisher
twitter: <seu twitter sem @>
github: <seu github sem @>
linkedin: <seu linkedin>
description: Aqui você pode descrever uma minibio sua :)
---

Dessa forma você poderá acessar a sua página de autor nessa url: localhost:9778/<seugithub>

Markdown

Todo o post deve ser escrito na linguagem markdown. Abaixo seguem alguns exemplos da marcação (apenas para demonstração, todas as marcações do markdown funcionam :) ):

  • h2 - ## Título de segundo nível
  • h3 - ### Título de terceiro nível
  • negrito - **texto em negrito**
  • itálico - *texto em itálico*
  • underline - _texto sublinhado_
  • imagem - ![Alt da imagem](url da imagem)
  • link - [texto do link](url do link)
  • código em bloco -

``` nomedalinguagem

trecho do código

```

  • código inline - `código`
  • lista - * item da lista
  • lista numerada - 1. item da lista
  • blockquote - > quote

Build e Desenvolvimento

  • Para rodar o projeto na sua máquina, é necessário ter instalado o npm e seguir os seguintes passos:
npm install
npm run dev
npm start

Labels do PR

Seu PR(Pull Request) pode ter duas classificações: POST (novo post do blog) ou ENHANCEMENT (melhorias para o blog como um todo). O PR pode passar pelas etapas de avaliação:

  • TO REVIEW - inicialmente seu PR entra para que outras pessoas possam testar.
  • FIX - quando um usuário testar um PR e tiver partes que devem ser alteradas, a label deve mudar para fix. Após o dono do PR fazer as modificações, a tarefa volta para TO REVIEW
  • APPROVED - após um usuário diferente do dono do PR testar e não existir mais modificações a serem feitas, deve-se aprovar o PR. Apenas o dono da tarefa pode mergear com a master.

Deploy

Para deployar:

  • pegue o post mais antigo aprovado
  • atualize a data do post para o dia de hoje (commit e push)
  • mergeie o post

Hospedagem

Blog hospedado no github-pages ou engenharia.elo7.com.br

tech-blog's People

Contributors

alinelee avatar aterribili avatar cristianoperez avatar davidrobert avatar diegocesar avatar edsonmarquezani avatar elo7-developer avatar ericdallo avatar erikatakahara avatar fernandabernardo avatar fernandes456 avatar ftfarias avatar henprz avatar igorbonadio avatar jlcassol avatar leonardosouza avatar lucasvasconcelos avatar luiz avatar macadantas avatar mariofts avatar mikedias avatar rapahaeru avatar rballet avatar rsicarelli avatar tavomaciel avatar tcelestino avatar tiagolimaelo7 avatar tisvasconcelos avatar williammizuta avatar

Stargazers

 avatar

Watchers

 avatar

Forkers

joepapst

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.