Code Monkey home page Code Monkey logo

blog.decaf.de's Introduction

DECAF Blog

👉 https://blog.decaf.de

How to set up and run Jekyll on your machine

For setup instructions, see SETUP.md!

Start your blog with:

$ bundle exec jekyll serve

To preview your site with drafts and future posts and unpublished posts, run Jekyll with all those switches (see docs):

$ bundle exec jekyll serve --drafts --future --unpublished

How to blog

The _posts folder is where your blog posts live. You typically write posts in Markdown, HTML is also supported.

All blog post files must begin with front matter which is used to set a layout and other meta data, for example:

---
layout: post
title: "Jobs: Laravel in Berlin, Westfalen oder remote"
author: ds

description: "Wie cool wäre es, wenn du genau die richtige Person bist und das hier liest!"
image: /content/images/2019/02/laravel_01.png
imageClass: seamless
featured: true
more: true
---

Front matter details:

Options Description Required
layout The page layout. It’s usually post, but sometimes you want to use a variant:
post-short: For short posts. Does not show post title, uses big typo.
Yes
title The post title. Yes
author The post author. Has to match with an id from _data/authors.yml. Yes
description A post description. Should be no longer than 160 chars. Will be used in several contexts, like post excerpts or page meta data for social media.
image A post image URL. Like description, the image will be used in several contexts.
imageClass seamless, if the image should not have a white outline. You probably want transparent images to be seamless.
featured true, if you like the post get listed on the »Featured Posts« page.
Hint: Excerpt makes use of description and image, if available!
more true, if you like to show an excerpt only and have a »Read more« button that links to the post. Typically used on long blog posts.
Hint: Excerpt makes use of description and image, if available!

How to publish

Just commit and push. Wait ~1 min and see it live! \o/

What else?

Twitter posts

We re-publish a lot of Tweets on our blog. In order to make Jekyll recognize a Twitter post, just use the tweet’s Id for the post slug, like YEAR-MONTH-DAY-ID.md.

Twitter posts don’t show the post title, use big typo (since tweets are short) and they provide a link to the tweet on Twitter.

Images

Drop your images in the content/images/ folder and refer to them by relative URLs, for example:

![Pic of a cat](/content/images/2019/03/cat.jpg)

If your image is transparent, you probably want to avoid the default white outline. In this case, switch to HTML notation and add a class seamless to the image:

<img class="seamless" src="/content/images/2019/03/cat.jpg" alt="Pic of a cat">

Code with syntax highlighting

We make use of Prism JS for code highlighting. You can create fenced code blocks by placing triple backticks before and after the code block, as you know it from GitHub Flavored Markdown. An optional language identifier enables syntax highlighting.

However, this is special to Jekyll: if your code snippet contains curly braces, you will likely need to place {% raw %} and {% endraw %} tags around your code! (See Liquid docs for raw.)

Lazy loading

Images from content/images/ will be lazy loaded per default. If you want iframes to lazy load as well, just change their src to data-lazy-src, like

<iframe data-lazy-src="https://giphy.com/embed/22nMX60cwdx5K" ... ></iframe>

blog.decaf.de's People

Contributors

dependabot-preview[bot] avatar dependabot[bot] avatar imgbotapp avatar schuer avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar

Forkers

harumuki

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.