Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
css
 
 
 
 
img
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
v
 
 

README.md

Fontes do site das Funções ZZ

Aqui estão os fontes do site das Funções ZZ, no ar em https://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 para ver como fica, há algumas opções.

  • Use um contêiner Docker que tenha a gem github-pages instalada numa versão recente, para não precisar instalar nada em sua máquina. Este por exemplo:

      docker run -it --rm -v "$PWD":/usr/src/app -p 4000:4000 starefossen/github-pages
    
  • Use a gem github-pages para instalar em sua máquina todos os requisitos. Instruções em https://github.com/github/pages-gem.

About

Website das Funções ZZ, hospedado no GitHub Pages

Resources

Releases

No releases published

Packages

No packages published