Website das Funções ZZ, hospedado no GitHub Pages
Shell HTML Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_data
_layouts
css
download
img
online
zzansi2html
.gitignore
404.html
CNAME
Gemfile
Gemfile.lock
README.md
_config.yml
acessivel.html
anuncio-13.2.md
anuncio-15.5.md
aovivo.html
changelog.html
concurso-logo.html
contato.html
dev.html
docs.html
donate.md
faq.md
funcoeszz
hist.md
index.md
list.html
logo.html
logomatico.html
man.html
my.md
premio.html
thanks.html
v

README.md

Fontes do site das Funções ZZ

Aqui estão os fontes do site das Funções ZZ, no ar em http://funcoeszz.net.

Correções e sugestões são muito bem-vindas!

No final de cada página do site há um link direto para o seu arquivo-fonte no GitHub, pronto para você editar.

Recomendo editar estes arquivos diretamente pelo site do GitHub em vez de baixá-los para sua máquina. É mais rápido e mais fácil.

Nerdices

  • O site é hospedado diretamente no GitHub, usando o esquema de GitHub Pages.

  • Após cada commit neste repositório, o site é reconstruído automaticamente e a alteração já vai pro ar.

  • A ferramenta que constrói o site, convertendo os arquivos Markdown para HTML e aplicando o template em todas as páginas é o Jekyll.

  • No template e nas páginas Markdown e HTML, é possível usar uma linguagem simples chamada Liquid, para fazer loops, condicionais e filtros, quando necessário. As tags são {% … %} para comandos e {{ … }} para inserir texto na página. Exemplo usado no list.html:

    {% for item in site.data.list %}
    <tr>
        <td>{{ forloop.index }}</td>
        <td><a href="man.html#{{ item[0] }}">{{ item[0] }}</a></td>
        <td>{{ item[1] | escape }}</td>
    </tr>
    {% endfor %}
  • No final, temos um site 100% estático usando somente arquivos HTML. Não há PHP nem qualquer processamento no servidor.

  • O que precisa ser PHP, como a API das funções e o ZZ a la carte, ficam em subdomínios, hospedados no DreamHost.

Estrutura do site

  • css/site.css – Arquivo CSS com os estilos do site.

  • css/monokai.css – Syntax highlight para os códigos e linhas de comando nas tags <PRE>.

  • _layouts/default.html – Template usado em todas as páginas. Aqui se edita o formato geral e o menu.

  • _data/* – Arquivos de dados no formato YAML, usados para construir algumas páginas. Veja detalhes no _data/README.md.

  • _config.yml – Arquivo de configuração do site, usado pelo Jekyll.

  • Gemfile, Gemfile.lock – Esquema da linguagem Ruby para especificar os plugins usados pelo site. É necessário para poder rodar o site localmente, usando o mesmo ambiente do servidor. Mas você não precisa se preocupar com isso, pode ignorar estes arquivos.

  • O resto são os arquivos normais de conteúdo do site, alguns em Markdown, alguns já em HTML.

Desenvolvimento local

É melhor editar os arquivos direto pelo site do GitHub, mas se fizer questão de rodar localmente:

$ bundle install                # Instalar plugins
$ bundle update github-pages    # Atualizar plugins
$ bundle exec jekyll serve      # Rodar o site localmente