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.
Movi o passo-a-passo para a página Brasil
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:
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.
_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 é obase.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 pastaarchived- conteúdo que não é mais relevante mas mantido para manter links externos funcionandocommunity- contem os fontes das páginas da seção da comunidade no sitecss- contem as folhas de estilo cssdocs- contem os fontes das páginas da seção de documentaçãodownload- contem os fontes das páginas da seção dedownloadimages- contem as imagens usadas nas páginasnews- lista as páginas contidas no diretório_posts
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.
- 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:
bundle install- baixa as bibliotecas necessárias ao Jekyllbundle 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:
