Skip to content

MonoBrasil/website

 
 

Repository files navigation

Site do MonoBrasil

Este repositório contem os arquivos que geram o site do MonoBrasil http://www.monobrasil.com.br com base na versão do site original do Projeto Mono http://www.mono-project.com.

O site usa a ferramenta Jekyll (http://jekyllrb.com), um gerador de site estático. O GitHub Pages, onde o site está hospeado, suporta nativamente o Jekyll de forma que cada vez que alguém publica um comite neste repositório, o site será reconstruído e atualizado (após alguns segundos a minutos). Para hospedar o site você mesmo, veja Setting up a local copy of the website.

Esforço de Tradução

Movi o passo-a-passo para a página Brasil

Contribuindo para o site

Nota: Problemas maiores ou pedidos de funcionalidades devem ser preenchidos no Controle de Problemas primeiramente, para que possamos discutir as implicações.

Se você quer editar uma página, a forma mais fácil é clicar no link Edit page on GitHub debaixo do título da página.

Isto irá abrir o arquivo fonte no GitHub onde você pode clicar o botão com ícone de um lápis e começar a editar: Arrow to pencil

O editor do GitHub's mostra tanto o fonte em Markdown como também um preview da página renderizada: Code editor

Depois de terminar as suas mudanças, entre um sumário e uma descrição e clique no botão "Propose file change" para abrir um pull request: Propose file change

Escrevendo uma postagem para o blog

Blogar é muito fácil com o Jekyll. Simplesmente adicione um novo arquivo Markdown no diretório _posts seguindo a convenção de nome de arquivo: ANO-MÊS-DIA-título.md (ANO/MÊS/DIA em forma numérica com zeros à esquerda)

Tenha cuidado de não incluir caracteres especiais no nome do artigo e use '-' ao invés de espaços. A data de publicação da postagem será automaticamente extraída do nome do arquivo.

Estrutura do repositório

  • _includes - pasta especial contem pedaços reutilizáveis que podem ser incluídos via {% include file.html %} em outras páginas
  • _layouts - pasta especial contem os leiautes compartilhados entre as páginas. Leiautes podem ser herdados, o leiaute raiz é o base.html
  • _posts - pasta especial, contem as páginas fonte da seção de blog, see Escrevendo uma postagem para o blogt
  • _site - a saida gerada pelo Jekyll por default é colocada nesta pasta
  • archived - conteúdo que não é mais relevante mas mantido para manter links externos funcionando
  • community - contem os fontes das páginas da seção da comunidade no site
  • css - contem as folhas de estilo css
  • docs - contem os fontes das páginas da seção de documentação
  • download - contem os fontes das páginas da seção de download
  • images - contem as imagens usadas nas páginas
  • news - lista as páginas contidas no diretório _posts

Criando uma cópia local do site

Para mudanças maiores, usar o editor web do GitHub não é muito conveniente. Uma forma melhor é criar uma cópia local para experimentar com ela.

Dependências

  • Ruby - Jekyll é escrito em Ruby
  • Bundler - um gerenciador de pacotes para Ruby. Instale-o rodando gem install bundler

Depois que você clonou o seu fork do repositório, rode os seguintes comandos:

  1. bundle install - baixa as bibliotecas necessárias ao Jekyll
  2. bundle exec jekyll serve - constroi o site e roda um servidor local na porta 4000

Nota: você pode adicionar a opção --watch ao executar jekyll serve para que o Jekyll monitore as mudanças de arquivo, o que significa que o site será reconstruido quand um arquivo é modificado.
Nota 2: em sistemas de arquivos sem diferenciação de maiúsculas/minúsculas como no Windows e Mac OS X você pode cair em laços infinitos de redirecionamento com algumas URLs. O 'jeitinho' é desabilitar localmente os redirecionamentos removendo a entrada gems: jekyll-redirect-from da sua cópia do _config.yml.

O site estará rodando localmente: website

Releases

No releases published

Packages

No packages published

Languages

  • HTML 79.6%
  • CSS 10.0%
  • Ruby 8.7%
  • Batchfile 1.7%