Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/awesome-br/awesome-br.github.io
https://github.com/awesome-br/awesome-br.github.io
List: awesome-br.github.io
awesome awesome-list
Last synced: 7 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/awesome-br/awesome-br.github.io
- Owner: awesome-br
- License: cc0-1.0
- Created: 2015-10-21T23:32:12.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2022-12-06T16:58:57.000Z (almost 2 years ago)
- Last Synced: 2024-05-23T06:34:31.150Z (6 months ago)
- Topics: awesome, awesome-list
- Language: HTML
- Homepage: http://awesome-br.com
- Size: 1.08 MB
- Stars: 464
- Watchers: 50
- Forks: 138
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - awesome-br/awesome-br.github.io - (HTML)
- divertidalista - Awesome BR - coleção de links nas mais diversas tecnologias
README
# [awesome-br.com](http://awesome-br.com)
[](https://travis-ci.org/awesome-br/awesome-br.github.io)
- [Nossa Proposta](#nossa-proposta)
- [Como funciona](#como-funciona)
- [Como Participar](#como-participar)
- [Como testar o awesome no seu computador](#como-testar-o-awesome-no-seu-computador)
- [Como usar a CLI](https://github.com/welksonramos/awesome-br-cli)
- [Conheça os colaboradores](http://awesome-br.com/#/colaboradores)
## 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](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](http://tableless.com.br/tudo-que-voce-queria-saber-sobre-git-e-github-mas-tinha-vergonha-de-perguntar/). 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 é:
```json
{
"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](https://nodejs.org/en/) 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:
```bash
Starting up http-server, serving ./
Available on:
http:127.0.0.1:8081
http: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:
[](http://awesome-br.com/#/laravel)
[](http://awesome-br.com/#/android)
Markdown:
```
[](http://awesome-br.com/#/laravel)`
```
HTML:
```
```