awesome-br/awesome-br.github.io

Name: awesome-br.github.io

Owner: Awesome BR

Description: null

Created: 2015-10-21 23:32:12.0

Updated: 2018-01-15 20:11:19.0

Pushed: 2017-11-12 00:26:40.0

Homepage: http://awesome-br.com

Size: 992

Language: HTML

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

awesome-br.com

Build Status

Nossa Proposta

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.

Como funciona

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.

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

Como testar o awesome no seu computador

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:

ting up http-server, serving ./
lable on:
tp:127.0.0.1:8081
tp:192.168.0.132:8081

Copie 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

Divulgue o Awesome BR

Adicione o badge no repositório do seu projeto ou em seu blog! Exemplo:

Awesome BR - Laravel Awesome BR - Android

Markdown:

wesome BR - Laravel](https://img.shields.io/badge/awesome--br.com-laravel-green.svg)](http://awesome-br.com/#/laravel)`

HTML:

ref="http://awesome-br.com/#/laravel"><img src="https://img.shields.io/badge/awesome--br.com-laravel-red.svg" alt="Awesome BR - Laravel" /></a>

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.