rescenic.github.io

Tema Purelog para Jekyll

Um modelo responsivo e bem projetado para ajudá-lo a começar seu próximo blog ou site.
Explore os documentos »

Ver demonstração · Reportar bug · Solicitar recurso

Sobre o projeto

Purelog é um tema de barra lateral responsivo para o popular gerador JAMstack Jekyll que usa apenas a estrutura Pure.css mínima (daí o nome!), enquanto segue as melhores práticas possíveis para acessibilidade e otimização de mecanismo de pesquisa.

Eu criei isso depois de terminar o Watery (do qual este tema foi construído), como uma forma de adicionar mais funcionalidade e design e ao mesmo tempo permanecer o mais leve possível.

Este projeto é voltado para quem procura um tema interessante para Jekyll que tenha recursos que não são comumente encontrados em outros lugares, especificamente com seções separadas dedicadas a: blogs, anotações e entradas de diários.

Características

Aqui estão alguns recursos interessantes deste tema Jekyll:

• Um _BLANK_config.yml totalmente personalizável e vazio para facilitar a instalação e o funcionamento.
• Uma função de pesquisa rápida no local usando o Simply Jekyll Search.
• Coleções personalizadas para diferentes tipos de material (anotações, redação de diários, etc.)
• Uma página de arquivo gerada automaticamente que exibe todas as entradas de todas as coleções.
• Geração automática de tags e páginas de categorias.
• Ter uma coleção _pages para facilitar a organização.
• Uma biografia do autor no final de cada postagem. (Localizado em _inclues/author.html )
• Suporte completo ao Rouge para realce de sintaxe. (Atualmente usando base16.solarized.light )
• Feed RSS gerado automaticamente, mapa do site, recursos de acessibilidade e otimização de mecanismo de pesquisa.

Instalação

Pré-requisitos

Jekyll requer o seguinte:

• Ruby versão 2.5.0 ou superior
• Ruby Gems
• GCC e Marca

Consulte Requisitos para guias e detalhes.

Instruções

1. Instale todos os pré-requisitos.
2. Instale as gemas jekyll e bundler.

 gem install jekyll bundler

3. Clone este repositório.

 git clone https://github.com/rescenic/rescenic.github.io.git

4. Mude para seu novo diretório.

 cd rescenic.github.io

5. Instale gemas do Gemfile .

 bundle install

6. Construa o site e disponibilize-o em um servidor local.

 bundle exec jekyll serve --livereload

7. Navegue até http://localhost:4000

Se você encontrar algum erro durante esse processo, verifique se instalou todos os pré-requisitos em Requisitos.

Se você ainda tiver problemas, consulte Solução de problemas.

Começando

Depois de ter o Jekyll instalado e funcionando, são necessárias apenas algumas etapas para tornar este tema seu:

1. Preencha o arquivo de configuração _BLANK_config.yml e substitua o _config.yml atual
2. Remova a pasta example_posts em _posts , _notes , _journals e comece a escrever a sua própria!
3. Modifique ou remova as páginas em _pages da maneira que achar melhor.
4. (Opcional) Modifique ou remova este README.md com informações sobre seu próprio projeto ou blog.
5. (Opcional) Modifique os arquivos CSS na pasta de assets para personalizar o site.

Roteiro

Existem vários recursos que ainda estou planejando criar e integrar, incluindo:

• Crie uma joia temática
• Adicione botões fáceis e automáticos para "Implantar no Netlify", Heroku, etc.
• Adicionar verificações de integração contínua do Travis
• Adicione documentação adicional para criar coleções personalizadas e páginas geradas automaticamente
• Adicione mais postagens e artigos de exemplo

Consulte os problemas em aberto para obter uma lista dos recursos propostos (e dos problemas conhecidos).

Contribuindo

As contribuições são o que tornam a comunidade de código aberto um lugar incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer será muito apreciada .

1. Bifurque o projeto
2. Crie sua ramificação de recursos ( git checkout -b feature/AmazingFeature )
3. Confirme suas alterações ( git commit -m 'Add some AmazingFeature' )
4. Enviar para a filial ( git push origin feature/AmazingFeature )
5. Abra uma solicitação pull

Licença

Distribuído sob a licença MIT. Você pode usar este projeto da maneira que achar melhor, sem precisar dar atribuição.

Consulte LICENSE para obter mais informações.

Recursos

Ao criar este tema, encontrei muitos recursos úteis e difíceis de encontrar. Se você quiser se aprofundar no Jekyll, dê uma olhada:

• Pulando em Jekyll: https://dev.to/brennan/jumping-into-jekyll-4o9h
• Folha de referências do Jekyll: https://devhints.io/jekyll
• Curso sobre Jekyll: https://learn-the-web.algonquindesign.ca/topics/jekyll/
• Jekyll para designers: http://simpleprimate.com/jekyll-for-designers/index.html
• Direitos autorais dinâmicos no Jekyll: https://michaelsoolee.com/jekyll-copyright/
• Criando breadcrumbs no Jekyll: https://jekyllcodex.org/without-plugin/breadcrumbs/
• Exiba todos os itens de TODAS as coleções: https://stackoverflow.com/questions/31171041/listing-all-collections-in-jekyll

Outros recursos

• Para visualizações de descontos: https://jaspervdj.be/lorem-markdownum/
• Estudo de caso sobre desempenho de webfont: https://www.keycdn.com/blog/web-font-performance
• Um extenso .gitignore : https://miguelmota.com/bytes/extensive-gitignore/

Crédito

Pure.css foi criado pelo grupo Pure CSS.

Simple Jekyll Search foi criado por Christian Fei.

Várias notas e ideias foram tiradas de Simply Jekyll por Raghuveer S..