Welcome everyone š
Welcome to the hitchhiker's guide to the galaxy for contributing to our Tech blog (https://tech.smile.eu). If you are here, itās mostly because you will write some piece of awesome content and contribute to the fame and renown of Smile.
Following the brand identity guideline, we must be friendly but professional, accessible to the non-expert and feel knowledgable without being mister Know-It-All.
Your content must be pleasant to read and fluid. You can take your inspiration from the already existing content on our blog.
Some rules apply if you want to contribute. They are few but very important.
First, you'll need to join the team on github. You can write to thibault.milan@smile.eu and provide your github nick handle (@something).
Then, you'll need to choose how you want to write. You can either do it online on github.com (very very simple interface) or github.dev (Microsoft Code Web Studio) or, of course, you can use your own IDE.
writing/[your-name]
, pressing the green button.
_posts
and click on Add file
> Create a new file
writing/[your-name]
_posts/
Insert a front-matter header
---
layout: post # Always use this
url: # just complete here if the content is from another platform. If so, paste the URL here
title: "Smileās Innovation Watch #32" # Use " "
subtitle: |- # If you want to use subtitle, multiline, follow this example
Itās December once more and, if youāve not already managed the š āpresentsā situation, you must know that delivery is a complete mess thisā¦
slug: smiles-innovation-watch-32 # optional, let you customize the slug
description: # optional, will override SEO description tag
tags: # one per line, like this. You can use whatever you want here to describe your content.
- meta
- bitcoin
- paypal
- autonomous-cars
- ebcdic
category: techwatch #only one category. Optional
author: thmil #the author slug. Please read Author section of this document or Contributing.md
image: "assets/images/posts/0*dJorJpg38rjFtUJe.jpg" #your image.
---
Write your content under the front-matter. Using markdown or (x)HTML. If you don't know markdown, read this.
Put your pictures into uploads/posts/[year]/[month]/[date]/
. If you're on github.com, you'll have to navigate to / create thoses folders, then on Add File
> Upload
When you're done, create a PR to our main
branch and follow the checklist. On github.com, you should be prompted to create the PR when you save your main file (but you can wait you uploaded your pictures + create the content).
While you're writing your content, you may felt limited to what you can do. That's why, we included some rich content helpers below:
Directly in the content:
{% youtube "https://www.youtube.com/watch?v=ho8-vK0L1_8" %}
In front-matter:
location:
- latitude: 51.5285582
longitude: -0.2416807
- latitude: 52.5285582
longitude: -2.2416807
- title: custom marker title
image: custom marker image
url: custom marker url
latitude: 51.5285582
longitude: -0.2416807
Then, in your content {% google_map %}
In your content {% gist c08ee0f2726fd0e3909d %}
or {% gist c08ee0f2726fd0e3909d test.md %}
In your content {% twitter https://twitter.com/rubygems/status/518821243320287232 %}