A place where you can actively contribute to robinwieruch.de.
- Improve any blog post by editing the file directly in this GitHub repository.
- Write a new guest blog post by creating a new file in this GitHub repository and follow the "Guidelines for Guest Bloggers" below. Get in touch with me before you start writing an entire article :)
Just create a new folder for your blog post. The folder's name will be the URI for the blog post. In this folder, you can create your markdown file with the text and use images from a folder next to it:
my-blog-post/
-- index.md
-- images
---- my-image.jpg
You can leave out all the frontmatter (e.g. title, description) that I use for my blog posts. I can add these later myself.
Don't use images for code. Instead use a code snippet the following way:
```javascript
const helloWorld = "Hello World!";
```
If you want to highlight changes in the code, that's what I usually do in my tutorials, then you can do it by providing the numbers of lines you want to highlight:
```javascript{3}
const helloWorld = "Hello World!";
console.log(helloWorld);
```
If you move around from file to file in your tutorial, don't forget to mention the place where you edit/create the next code snippet. Something like:
Now we are going to implement user model in the src/models/user.js file:
```javascript
const user = createModel('user');
```
Don't use images for code. Instead use code snippets. If you want to have images in the blog post, add them in at least 1024x768 resolution preferable in .jpg. In the article, reference the image with a proper alt text:
Image files are placed next to the blog post's markdown file.
There are many tutorials out there that are using lots of images to show a GUI where they do their configuration. I'd like to use as few images as possibles and encourage people to use more often their command line instead. If the a GUI needs to be shown, then an image can be used though.
I use Prettier in my projects which helps me to keep all my code snippets equally formatted for my tutorials. That's my default configuration:
{
"semi": true,
"trailingComma": "all",
"singleQuote": true,
"printWidth": 70
}
- h1 headline translates to
# My Headlinein markdown - h2 headline translates to
## My Secondary Headlinein markdown
My articles usually follow the same structure with optional ## Secondary Headlines in between:
Be clear about the motivation of this article ...
# My Headline
# My other Headline
## My Secondary Headline
<Divider />
Outro
Links can be used the following way:
[my article name](url)
I usually use italics with * for folders and files like src/models/user.index/js or src/.
I usually use bold with ** to point out the importance of something or to highlight a specific topic in a paragraph.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
