alexwlchan.net

Alexwlchan.net

Este repo tem o código para o meu site pessoal, Alexwlchan.net, que é um site estático construído com Jekyll. Inclui vários plugins que escrevi para personalizar o site.

Principais ferramentas

O site usa:

• Jekyll, que gera as páginas HTML
• Sass, para construir o CSS e as folhas de estilo
• Ações do GitHub, que constrói e implanta o site
• Caddy, que é o servidor da web

Quando quero fazer uma alteração, abro uma solicitação de tração. Isso desencadeia uma construção com ações do GitHub e, como parte da construção, verifica o HTML com o HTML Properador. Isso verifica o texto Alt ausente, links quebrados, HTML inválido e assim por diante.

Se o site passar os cheques, ele será automaticamente mesclado e a construção na filial main publica a alteração no meu servidor da web.

Construindo o local

Você precisa de Git, Ruby e Python instalados.

Para executar uma cópia local do site:

$ git clone [email protected]:alexwlchan/alexwlchan.net.git

$ python3 -m venv .venv
$ pip install -r requirements.txt

$ bundle install

$ bundle exec jekyll serve

O site deve estar em execução em http: // localhost: 5757. Se você fizer alterações nos arquivos de origem, ele será atualizado automaticamente.

Para construir um conjunto único de arquivos HTML estáticos:

$ bundle exec jekyll build

Isso cria um conjunto de arquivos HTML no _site .

Como funciona o site

Eu publico o código -fonte para que outras pessoas possam ver como o site funciona e talvez usar algumas das idéias para seus próprios sites. Esta é uma lista de coisas que eu acho interessantes ou incomuns:

• Geração de alimentação de átomos
• NO-Javascript Twitter incorpora
• Vinculando ao meu trabalho em outros sites
• Validando o assunto da frente em arquivos de marcação

Contribuindo

As correções para erros de digitação são bem -vindos, mas as contribuições serão ignoradas.

Se você deseja usar algum dos componentes em seus próprios projetos - plug -ins, layouts, folhas de estilo - fique à vontade para fazê -lo.

Licença

• Exceto onde observado de outra forma, o site e o código associado são licenciados como: como:

  • Creative Commons Attribution 4.0 International (também conhecido como CC por 4.0)
  • A licença do MIT

  Se você estiver reutilizando meu conteúdo, poderá usar qualquer licença mais apropriada.

  Principalmente o CC BOD é bom, mas as licenças Creative Commons não são adequadas para o código, então eu tenho o MIT como alternativa.

• Algumas imagens que estão sendo usadas sob licenças Creative Commons de outras pessoas; Veja o post onde uma imagem é usada para atribuição.

• Todos os ícones do site são usados ​​sob uma licença sem royalties do projeto substantivo; Deve haver comentários nos arquivos SVG indicando sua fonte. Os autores originais do ícone mantêm direitos autorais.