- Nossa Proposta
- Como funciona
- Como Participar
- Como testar o awesome no seu computador
- Como usar a CLI
- Conheça os colaboradores
Awesome BR possui um formato aberto a comunidade que deseja compartilhar conteúdo de qualidade frente às tecnologias mais atuais do mercado.
Nossa proposta é fortalecer a difusão das tecnologias de desenvolvimento web na língua portuguesa.
Nossa página http://awesome-br.github.io contém uma lista buscável de tecnologias, e cada tecnologia possui uma lista de links apontando para o melhor conteúdo em português da web. Todas as contribuições são feitas pela comunidade, todos podem participar.
Para participar é necessário conhecimento em git/github. Caso esteja com dificuldades, leia este artigo. Após realizar o fork deste projeto, faça suas contribuições de acordo com a tecnologia em questão, alterando o arquivo .json dentro da pasta sections. Por exemplo, se você deseja adicionar um link na categoria Laravel, edite o arquivo sections/laravel.json e faça o pull request.
O formato para um novo item em qualquer tecnologia é:
{
"name": "Título do link",
"url": "Url do link",
"type": "Tipo",
"tags": [
"tags",
"tags"
],
"paid": false,
"author": {
"name": "Nome do autor",
"url": "Url do site do autor"
}
}O tipo pode ser: "artigo", "livro", "video", "screencast", "styleguide", "palestra", "tutorial", "dica", "slide", "vídeo", "documentação", "url", "curso", "guia", "pacote", "hangout", "slideshare", "apostila", "site". Outros tipos deverão ser requisitados abrindo uma ISSUE, pois o teste de Integração Contínua vai falhar.
Se você deseja adicionar uma nova tecnologia, edite o arquivo sections.json incluindo um novo item e adicione o relativo arquivo json no diretório sections. Você pode usar o arquivo sections/base.json como base. Não adicione uma categoria vazia. Teste e faça o PR para que possamos analisar.
Antes de enviar o pull request para o nosso repositório central, recomendamos testar a execução do site no seu computador. Isso pode ser feito através de um servidor web simples, como o http-server provido pelo node. Para isso, é preciso instalar o node e npm no seu sistema operacional, o que pode ser facilmente feito através do site oficial para Windows, ou através do sudo apt-get install npm no linux (debian).
Após instalar o node e o npm, instale as dependências (http-server) através do comando npm install, e, após a instalação, execute o comando npm run http-server.
A resposta que terá é algo semelhante a:
Starting up http-server, serving ./
Available on:
http:127.0.0.1:8081
http:192.168.0.132:8081Copie a URL, juntamente com a porta, e abra o site no navegador.
Dica: Use ctrl+shift+r para atualizar o cache após alterar os arquivos .json.
Alternativamente, você pode executar o comando ´python -m SimpleHTTPServer 9001´. Note que você deve ter o python instalado em sua máquina. A maioria dos S.O's Unix-Like como Mac e Linux já vem com o python pré-instalado. Após executar o comando, acesse, pelo navegador, o endereço http://localhost:9001
Adicione o badge no repositório do seu projeto ou em seu blog! Exemplo:
Markdown:
[](http://awesome-br.com/#/laravel)`
HTML:
<a href="http://awesome-br.com/#/laravel"><img src="https://img.shields.io/badge/awesome--br.com-laravel-red.svg" alt="Awesome BR - Laravel" /></a>
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent