Skip to content

MonoBrasil/website

This branch is 439 commits ahead of, 1468 commits behind mono/website:gh-pages.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

729d6e3 · Apr 7, 2017
Jan 19, 2017
Aug 13, 2014
Sep 6, 2016
Jan 21, 2017
Jan 21, 2017
Jan 21, 2017
Mar 10, 2015
Jan 21, 2017
Jan 21, 2017
Feb 10, 2016
Apr 7, 2017
Sep 6, 2016
Sep 6, 2016
Jul 22, 2016
Nov 8, 2014
Sep 6, 2016
Aug 30, 2014
Jul 26, 2014
Sep 6, 2016
Nov 24, 2013
Aug 24, 2016
Sep 6, 2016
Oct 24, 2014
Feb 7, 2016
Feb 18, 2015
Jul 16, 2014
Apr 7, 2017
Dec 11, 2015
Aug 7, 2015
Aug 7, 2015

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%