Skip to content

Commit e52bc21

Browse files
committed
Add guide
1 parent a19da94 commit e52bc21

File tree

1 file changed

+84
-0
lines changed

1 file changed

+84
-0
lines changed

MULTILANG_SIMPLE_GUIDE.md

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
# How to Write Multi-Language Posts - Simple Guide
2+
3+
This is the **easiest way** to create posts in multiple languages without knowing HTML.
4+
5+
## Quick Start (Copy & Paste)
6+
7+
Just copy the template below into a new post file. Replace the text in each colored section with your content.
8+
9+
```markdown
10+
---
11+
layout: posts
12+
title: "Your German Title Here"
13+
date: 2026-01-XX 12:00:00
14+
categories: freifunkmuc
15+
translations: [en, fr, es, ua]
16+
---
17+
18+
<section data-lang="de" class="language-content active" markdown="1">
19+
20+
**German Title or Heading**
21+
22+
Replace this with your German text.
23+
24+
You can write normally:
25+
- Use bullet points
26+
- **Make text bold**
27+
- [Add links](https://example.com)
28+
- Create | tables | like | this |
29+
30+
</section>
31+
32+
<section data-lang="en" class="language-content" markdown="1">
33+
34+
**English Title or Heading**
35+
36+
Replace this with your English translation.
37+
38+
</section>
39+
40+
<section data-lang="fr" class="language-content" markdown="1">
41+
42+
**French Title or Heading**
43+
44+
Replace this with your French translation.
45+
46+
</section>
47+
48+
<section data-lang="es" class="language-content" markdown="1">
49+
50+
**Spanish Title or Heading**
51+
52+
Replace this with your Spanish translation.
53+
54+
</section>
55+
56+
<section data-lang="ua" class="language-content" markdown="1">
57+
58+
**Ukrainian Title or Heading**
59+
60+
Replace this with your Ukrainian translation.
61+
62+
</section>
63+
```
64+
65+
## What Each Line Means (For Reference)
66+
67+
- `{::options parse_block_html="true" /}` = Tells Jekyll "please render markdown below"
68+
- `data-lang="de"` = This block is German
69+
- `class="language-content active"` = Show this by default
70+
- `markdown="1"` = Render markdown inside this box
71+
- The language switcher in top-right handles the rest automatically
72+
73+
## That's All You Need to Know!
74+
75+
- Just copy the template
76+
- Replace the 5 text sections with your translations
77+
- Save the file with format: `_posts/YYYY-MM-DD-your-title.markdown`
78+
- Done! No HTML knowledge required.
79+
80+
The language switcher automatically:
81+
- Shows German by default
82+
- Detects user's browser language
83+
- Saves user's choice in their browser
84+
- Switches content when they click the dropdown

0 commit comments

Comments
 (0)