How to Write a Blog Post ?

Step-by-step guide on writing a blog post.

How to Write a Blog Post

As of today you need an access to the the our company shared Gitlab. First clone the Gitlab repository:

1
2
git clone https://gitlab.thalesdigital.io/tsn/innovation/projects/blog.git
cd blog

Then create a new folder.

1
mkdir -p content/blogs/yourblog
  1. Create a New Markdown File: Create a new Markdown file in the content/blogs/yourblog directory. Name it appropriately, for example, my-new-post.md.
  2. Add Front Matter: Add the necessary front matter at the top of the file. Here is an example:
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
   ---
   title: 'My New Post'
   date: 2024-07-13T13:00:00+02:00
   summary: 'A brief summary of my new post'
   tags:
   - Data engineering
   - Finops
   categories:
   - Blog
   image: 'example-image.webp'
   authors:
   - 'Your Name'
   - 'A colleague'
   ---

And simply add some content. Check out the original documentation. We list the essential elements below

Short Codes

YouTube video

1
{{< youtube "0qwALOOvUik" >}}

Generic video file

Gist

1
{{< gist CaiJimmy e2751a943de10b2a5b3a8a6c2120cb86 >}}

GitLab Snippet

1
{{< gitlab 2589724 >}}

Quote

1
2
3
{{< quote author="A famous person" source="The book they wrote" url="https://en.wikipedia.org/wiki/Book">}}
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
{{< /quote >}}

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

A famous person, The book they wrote
1
Photo by [Codioful](https://unsplash.com/@codioful)

Photo by Codioful

Galleries

Hugo theme Stack supports the creation of interactive image galleries using Markdown. It’s powered by PhotoSwipe and its syntax was inspired by Typlog.

To use this feature, the image must be in the same directory as the Markdown file, as it uses Hugo’s page bundle feature to read the dimensions of the image. External images are not supported.

1
![Image 1](1.jpg) ![Image 2](2.jpg)

Image 1 Image 2

Photo by mymind and Luke Chesser on Unsplash

Licensed under CC BY-NC-SA 4.0
Last updated on Jan 29, 2025 07:57 UTC