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 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:

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

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:

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: