Você não pode selecionar mais de 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.
Annika Backstrom 7586a48628
games: add Forager to Completed list
5 meses atrás
assets/css footer: add social links, restyle 7 meses atrás
bin tags: ignore binary files 7 meses atrás
content games: add Forager to Completed list 5 meses atrás
nginx move css version into filename behind a rewrite rule 7 meses atrás
pelican-plugins wip 1 ano atrás
sassc docker: update from ruby sass to sassc 7 meses atrás
templates Move template from `pages` directory, to a new `templates` directory 1 ano atrás
themes/bleached move css version into filename behind a rewrite rule 7 meses atrás
.drone.yml docker: update from ruby sass to sassc 7 meses atrás
.env Small text change 8 meses atrás
.gitignore Add a template.md and some docs 1 ano atrás
Dockerfile docker: update from ruby sass to sassc 7 meses atrás
Dockerfile.sass docker: update from ruby sass to sassc 7 meses atrás
Makefile make: remove container after run 7 meses atrás
README.md readme: add note about skipping deploys 7 meses atrás
docker-compose.yml docker: update from ruby sass to sassc 7 meses atrás
docker-nginx.conf Removing old build tools, adding docker things 1 ano atrás
pelicanconf.py config: unset twitter name 7 meses atrás
publishconf.py move css version into filename behind a rewrite rule 7 meses atrás
requirements.txt Update to Pelican 4.0.1 10 meses atrás

README.md

The source code for sixohthree.com.

Development

Local development and deployment are assisted by Docker, Docker Compose, and Drone CI. The .drone.yml file is specific to my environment and private image repository, so if you’re adapting my customizations to your environment, make sure you change the `image: settings.

To develop locally:

$ docker-compose up

This will start a persistent container for nginx (to serve content at localhost:8045 and sass (to compile changed SCSS files). It will also run pelican on your content dir.

If you make content or theme changes and want to regenerate the site, re-run the pelican container:

$ docker-compose run pelican

This command is aliased to make all and make thanks to the Makefile. A Vim alias like nnoremap <leader>m :silent make<CR> lets you quickly rebuild the site from within your editor.

Editing the Docker containers

The pelican and sass containers are custom, generated from Dockerfile and Dockerfile.sass, respectively. You can regenerate these containers using bin/docker-build-image.

Skipping CI (deploy) during push

Include [skip ci] in your commit message to exclude this commit from the Drone CI deploy pipeline.

Site Styles

Margin and padding classes

Margin and padding can be controlled using spacer classes. These use a multiplier in the class name, with a base of 6px. For example, .p-2 would apply 6px * 2 padding on all sides.

Class Attributes
p-[0/1/2/3] padding
p-t-[0/1/2/3] padding-top
p-r-[0/1/2/3] padding-right
p-b-[0/1/2/3] padding-bottom
p-l-[0/1/2/3] padding-left
p-x-[0/1/2/3] padding-top and padding-bottom
p-y-[0/1/2/3] padding-left and padding-right
m-[0/1/2/3] margin
m-t-[0/1/2/3] margin-top
m-r-[0/1/2/3] margin-right
m-b-[0/1/2/3] margin-bottom
m-l-[0/1/2/3] margin-left
m-x-[0/1/2/3] margin-top and margin-bottom
m-y-[0/1/2/3] margin-left and margin-right

Responsive CSS

@include-media is used for responsive CSS. To use this library, include one of the following directives in your SCSS file:

  • @include media('>tablet') -- 768px and above
  • @include media('>desktop') -- 1024px and above

By convention, styles should be mobile-first, with overrides at and above certain breakpoints.

Article Templates

A template article exists in templates/article.md. If you use Vim, you can add an autocmd to inject this template into any new file in content. Example snippet for .vimrc:

if has("autocmd")
    augroup templates
        autocmd!
        autocmd BufNewFile */blogdir/content/*.md 0r %:s?content/.*?templates/article.md?
    augroup END
endif

Social embed images

tl;dr Add two headers for embeds:

Meta-Image-Square: /media/2017/09/burrito/sniff.512x512.jpg
Meta-Image-FB: /media/2017/09/burrito/sniff.1200x630.jpg

Twitter

Code:

Meta-Image-Square: /media/2017/09/burrito/sniff.512x512.jpg

Description:

URL of image to use in the card. Images must be less than 5MB in size. JPG, PNG, WEBP and GIF formats are supported. Only the first frame of an animated GIF will be used. SVG is not supported.

https://dev.twitter.com/cards/markup

Facebook (Open Graph)

Code:

Meta-Image-FB: /media/2017/09/burrito/sniff.1200x630.jpg

Description:

Use images that are at least 1200 x 630 pixels for the best display on high resolution devices. At the minimum, you should use images that are 600 x 315 pixels to display link page posts with larger images. Images can be up to 8MB in size.

https://developers.facebook.com/docs/sharing/best-practices/