Support For awesome-br.github.io
awesome-br/ awesome-br.github.io
Need help with awesome-br.github.io?
awesome-br
465 Stars 149 Forks Creative Commons Zero v1.0 Universal 752 Commits 17 Opened issues
awesome-br.com
Como testar o awesome no seu computador
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
. 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",
"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
incluindo um novo item e adicione o relativo arquivo json no diretório
. 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
provido pelo
. Para isso, é preciso instalar o
no seu sistema operacional, o que pode ser facilmente feito através do site oficial para Windows, ou através do
no linux (debian).
Após instalar o
, instale as dependências (
) através do comando
, e, após a instalação, execute o comando
npm run http-server
A resposta que terá é algo semelhante a:
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
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](https://img.shields.io/badge/awesome--br.com-laravel-green.svg)](http://awesome-br.com/#/laravel)`