kaeland.github.io
1.0.0
Este repositório fornece o código que você precisa para iniciar um site pessoal que mostra seu trabalho como desenvolvedor de software. E quando você gerencia o código em um repositório do GitHub, ele renderiza automaticamente uma página da Web com as informações do perfil do proprietário, incluindo uma foto, biografia e repositórios.
Seu site pessoal está esperando para ser personalizado, no entanto. Inclui espaço para destacar suas áreas de interesse específicas no desenvolvimento de software, como idiomas ou indústrias. E está de pé para publicar sua próxima ótima postagem no blog.
Tudo é possível usar a combinação de Jekyll (para criar seu site), páginas do GitHub (para hospedar seu site) e API do Github (para preencher automaticamente seu site com conteúdo).
github/personal-website Repo Você fará sua própria cópia do repositório "Site pessoal" para ter seu próprio projeto para personalizar. Um "garfo" é uma cópia de um repositório. Portanto, selecione "garfo" no topo do repositório github/personal-website .
Depois de encontrar um lar para o seu repositório bifurcado, é seu. Você é o proprietário, então está pronto para publicar, se desejar.
Se você deseja gerenciar seu site em um ambiente local de desenvolvimento da Web, usará o Ruby.
Depois de encontrar um lar para o seu repositório bifurcado, clone -o .
Jekyll é uma jóia Ruby que pode ser instalada na maioria dos sistemas.
gem install jekyll bundler
cd personal-website
bundle install
bundle exec jekyll serve
Quando você hospeda o código do seu site pessoal no Github, você recebe o apoio da hospedagem gratuita nas páginas do Github.
A abordagem mais rápida é renomear seu username.github.io do repositório.github.io, onde username é o seu nome de usuário do github (ou nome da organização). Então, na próxima vez que você for alterado no ramo master do seu repositório, eles estarão acessíveis na web em seu nome de username.github.io .
Se você deseja usar um domínio personalizado , adicione -o às configurações de "domínio personalizado" do seu repositório no github.com. E depois registre e/ou configure seu domínio com um provedor DNS.
É o seu site e você controla o código -fonte. Então você pode personalizar tudo, se quiser. Mas fornecemos um punhado de personalizações rápidas para você considerar ao tirar seu site.
A maioria das personalizações pode ser feita em questão de segundos, revisando o arquivo _config.yml do seu repositório. Lembre-se de reiniciar o servidor local cada vez que você economiza novas alterações, para que seu site movido a Jekyll reconstrua corretamente:
jekyll serve Por padrão, seu site será exibido em um layout de duas colunas em dispositivos de tela maior, com sua foto, nome e informações básicas exibidas em uma "barra lateral" alinhada à esquerda. Mas você pode alternar rapidamente para um layout de coluna única "empilhada" alterando a linha no seu arquivo _config.yml que lê layout: sidebar para layout: stacked .
Por padrão, seu site aparece com um fundo branco e cinza "claro", com texto escuro. Mas você pode mudar rapidamente para um fundo "escuro" com texto em branco, alterando a linha no seu arquivo _config.yml que lê style: light para style: dark .
Seu site vem pré-configurado com três tópicos (por exemplo, "web design" e "sass") que aparecem em uma seção intitulada "Meus interesses". Eles também são armazenados no arquivo _config.yml do seu repositório, onde você pode definir o nome de cada tópico e outros dois detalhes opcionais:
web_url : o endereço da Web que você gostaria do seu tópico para vincular (por exemplo, https://github.com/topics/sass ).image_url : o endereço da Web de uma imagem (idealmente quadrada) que você gostaria de aparecer com o seu tópico. Para adicionar uma página ao seu site (por exemplo, currículo detalhado):
.html ou .md na raiz do seu repositório.http://yoursite.dev/filename ). ---
layout: default
---
Para adicionar uma postagem no seu site:
.md no diretório /_posts/ do repositório. YEAR-MONTH-DAY-title.MARKUP
---
title: "The title of my blog post"
---
Seu site vem com uma postagem no blog de espaço reservado que você pode fazer referência. Notavelmente, seu assunto de frente declara published como false , para que não apareça no seu site.
Embora você também possa definir um layout no assunto da frente, seu site é pré-configurado para atribuir o layout post a todas as postagens no seu diretório /_posts/ . Portanto, você não precisa declarar isso em suas postagens, se não quiser.
As convenções de Jekyll para criar e gerenciar postagens de blogs são muito flexíveis. Você pode aprender mais na documentação de Jekyll para "Postagens".
Para fornecer uma base sólida para iniciar seu site pessoal, seu repositório inclui um punhado de "inclui"-arquivos dinâmicos .html que são reutilizados em todo o seu site. Todos eles estão armazenados no /_includes/ diretório.
Existem os suspeitos usuais, como header.html e footer.html . Mas há poucos mais que vale a pena apontar:
interests.html : Uma lista de título e dinâmica de "meus interesses", que é preenchida com os tópicos que você liste em seu _config.yml .masthead.html : Uma coleção do seu avatar, nome, biografia e outros metadados que é exibido com destaque em todas as suas páginas da web para ajudar a identificar o que é o site.post-card.html : Uma apresentação compacta e resumida de uma postagem no blog, reutilizada para exibir uma listagem das suas últimas postagens no blog.projects.html : uma lista de título e dinâmica de "My Projects", que é preenchida com uma lista dos seus mais novos repositórios do GitHub.repo-card.html : Uma apresentação compacta e resumida de um repositório, reutilizada para exibir uma listagem de seus repositórios do GitHub.thoughts.html : Uma lista de título e dinâmica de "My Thoughts", que é preenchida com uma lista das suas últimas postagens no blog.topic-card.html : Uma apresentação compacta e resumida de um tópico (definida no seu _config.yml ), reutilizada para exibir uma lista de seus interesses.Seu repositório vem com três layouts:
index.html para exibir listagens de seus projetos, interesses e (opcionalmente) suas postagens no blog./_posts/ diretório.A convenção de Jekyll para definir layouts é muito flexível. Você pode aprender mais sobre como personalizar seus layouts nos documentos Jekyll "Layouts".
Seu site é pré-configurado para usar uma estrutura CSS muito flexível chamada "Primer", juntamente com os estilos personalizados que você escreve na folha de estilo Sass /assets/styles.scss Sass. Atualmente, é referenciado no seu arquivo styles.scss , usando o CSS Import at-Rule:
@import url('https://unpkg.com/primer/build/build.css');
Obviamente, você é bem -vindo para removê -lo ou substituí -lo por outra estrutura. Lembre-se de que o HTML que seu site veio pré-embalado com referências múltiplas "classes de utilitário" para definir coisas como larguras, margens e cores de fundo da coluna.
O tema está disponível como código aberto nos termos da licença do MIT.
