Skip to content

Commit e31a0a4

Browse files
authored
feat: Add blog section for tutorials and technical articles (#6)
* feat: add blog section for tutorials and technical articles - Enable blog plugin in preset-classic with reading time display - Create blog directory with welcome post - Add Blog link to navbar and footer - Add Korean and Japanese translations for blog content - Update news post author to yhk1038 (Yonghyun Kim) - Reorder locale dropdown: English โ†’ Japanese โ†’ Korean Closes #5 * refactor: remove redundant i18n authors.yml files Keep only English authors.yml files in blog/ and news/ directories. Docusaurus will use the default locale's authors.yml for all locales.
1 parent 24b9256 commit e31a0a4

11 files changed

Lines changed: 153 additions & 17 deletions

File tree

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
slug: welcome
3+
title: Welcome to the T-Ruby Blog
4+
authors: [yhk1038]
5+
tags: [announcement]
6+
---
7+
8+
Welcome to the official T-Ruby blog! This is where we'll share tutorials, technical deep-dives, and insights about type-safe Ruby development.
9+
10+
<!-- truncate -->
11+
12+
## What You'll Find Here
13+
14+
This blog will be your go-to resource for:
15+
16+
### Tutorials
17+
18+
Step-by-step guides to help you get the most out of T-Ruby. From basic type annotations to advanced generic patterns, we'll cover it all.
19+
20+
### Technical Deep-Dives
21+
22+
Explore the internals of T-Ruby's type system. Learn how type inference works, how RBS files are generated, and the design decisions behind the project.
23+
24+
### Best Practices
25+
26+
Real-world patterns and practices for writing type-safe Ruby code. We'll share examples from actual projects and discuss common pitfalls to avoid.
27+
28+
### Community Highlights
29+
30+
Showcasing interesting projects and contributions from the T-Ruby community.
31+
32+
## Stay Updated
33+
34+
Follow our [News](/news) section for release announcements and project updates. For in-depth content, bookmark this blog and check back regularly.
35+
36+
We're excited to share this journey with you. Happy typing!

โ€Žblog/authors.ymlโ€Ž

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
yhk1038:
2+
name: Yonghyun Kim
3+
url: https://github.com/yhk1038
4+
image_url: https://github.com/yhk1038.png
5+
6+
t-ruby-team:
7+
name: T-Ruby Team
8+
url: https://github.com/type-ruby
9+
image_url: /img/logo.svg

โ€Ždocusaurus.config.tsโ€Ž

Lines changed: 28 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -22,20 +22,20 @@ const config: Config = {
2222

2323
i18n: {
2424
defaultLocale: 'en',
25-
locales: ['en', 'ko', 'ja'],
25+
locales: ['en', 'ja', 'ko'],
2626
localeConfigs: {
2727
en: {
2828
htmlLang: 'en-US',
2929
label: 'English',
3030
},
31-
ko: {
32-
htmlLang: 'ko-KR',
33-
label: 'ํ•œ๊ตญ์–ด',
34-
},
3531
ja: {
3632
htmlLang: 'ja-JP',
3733
label: 'ๆ—ฅๆœฌ่ชž',
3834
},
35+
ko: {
36+
htmlLang: 'ko-KR',
37+
label: 'ํ•œ๊ตญ์–ด',
38+
},
3939
},
4040
},
4141

@@ -47,7 +47,20 @@ const config: Config = {
4747
sidebarPath: './sidebars.ts',
4848
editUrl: 'https://github.com/type-ruby/t-ruby.github.io/tree/main/',
4949
},
50-
blog: false,
50+
blog: {
51+
showReadingTime: true,
52+
blogTitle: 'T-Ruby Blog',
53+
blogDescription: 'Tutorials, technical articles, and best practices for T-Ruby',
54+
blogSidebarTitle: 'Recent Posts',
55+
blogSidebarCount: 5,
56+
postsPerPage: 10,
57+
editUrl: 'https://github.com/type-ruby/t-ruby.github.io/tree/main/',
58+
feedOptions: {
59+
type: ['rss', 'atom'],
60+
xslt: true,
61+
copyright: `Copyright ${new Date().getFullYear()} T-Ruby.`,
62+
},
63+
},
5164
theme: {
5265
customCss: './src/css/custom.css',
5366
},
@@ -102,6 +115,11 @@ const config: Config = {
102115
label: 'Playground',
103116
position: 'left',
104117
},
118+
{
119+
to: '/blog',
120+
label: 'Blog',
121+
position: 'left',
122+
},
105123
{
106124
to: '/news',
107125
label: 'News',
@@ -145,6 +163,10 @@ const config: Config = {
145163
label: 'Playground',
146164
to: '/playground',
147165
},
166+
{
167+
label: 'Blog',
168+
to: '/blog',
169+
},
148170
{
149171
label: 'News',
150172
to: '/news',

โ€Ži18n/ja/docusaurus-plugin-content-blog-news/2025-12-24-introducing-t-ruby.mdโ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
slug: introducing-t-ruby
33
title: T-Ruby ใฎใ”็ดนไป‹
4-
authors: [t-ruby-team]
4+
authors: [yhk1038]
55
tags: [announcement]
66
---
77

โ€Ži18n/ja/docusaurus-plugin-content-blog-news/authors.ymlโ€Ž

Lines changed: 0 additions & 4 deletions
This file was deleted.
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
slug: welcome
3+
title: T-Ruby ใƒ–ใƒญใ‚ฐใธใ‚ˆใ†ใ“ใ
4+
authors: [yhk1038]
5+
tags: [announcement]
6+
---
7+
8+
ๅ…ฌๅผ T-Ruby ใƒ–ใƒญใ‚ฐใธใ‚ˆใ†ใ“ใ๏ผใ“ใ“ใงใฏใ€ใƒใƒฅใƒผใƒˆใƒชใ‚ขใƒซใ€ๆŠ€่ก“็š„ใช่ฉณ็ดฐ่งฃ่ชฌใ€ๅž‹ๅฎ‰ๅ…จใช Ruby ้–‹็™บใซ้–ขใ™ใ‚‹ใ‚คใƒณใ‚ตใ‚คใƒˆใ‚’ๅ…ฑๆœ‰ใ—ใฆใ„ใใพใ™ใ€‚
9+
10+
<!-- truncate -->
11+
12+
## ใ“ใฎใƒ–ใƒญใ‚ฐใง่ฆ‹ใคใ‘ใ‚‰ใ‚Œใ‚‹ใ‚‚ใฎ
13+
14+
ใ“ใฎใƒ–ใƒญใ‚ฐใงใฏไปฅไธ‹ใฎใ‚ณใƒณใƒ†ใƒณใƒ„ใ‚’ๆไพ›ใ—ใพใ™๏ผš
15+
16+
### ใƒใƒฅใƒผใƒˆใƒชใ‚ขใƒซ
17+
18+
T-Ruby ใ‚’ๆœ€ๅคง้™ใซๆดป็”จใ™ใ‚‹ใŸใ‚ใฎใ‚นใƒ†ใƒƒใƒ—ใƒใ‚คใ‚นใƒ†ใƒƒใƒ—ใ‚ฌใ‚คใƒ‰ใ€‚ๅŸบๆœฌ็š„ใชๅž‹ใ‚ขใƒŽใƒ†ใƒผใ‚ทใƒงใƒณใ‹ใ‚‰้ซ˜ๅบฆใชใ‚ธใ‚งใƒใƒชใƒƒใ‚ฏใƒ‘ใ‚ฟใƒผใƒณใพใงใ€ใ™ในใฆใ‚’ใ‚ซใƒใƒผใ—ใพใ™ใ€‚
19+
20+
### ๆŠ€่ก“็š„ใช่ฉณ็ดฐ่งฃ่ชฌ
21+
22+
T-Ruby ใฎๅž‹ใ‚ทใ‚นใƒ†ใƒ ใฎๅ†…้ƒจใ‚’ๆŽขใ‚Šใพใ™ใ€‚ๅž‹ๆŽจ่ซ–ใฎไป•็ต„ใฟใ€RBS ใƒ•ใ‚กใ‚คใƒซใฎ็”Ÿๆˆๆ–นๆณ•ใ€ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎ่จญ่จˆๆฑบๅฎšใซใคใ„ใฆๅญฆใณใพใ™ใ€‚
23+
24+
### ใƒ™ใ‚นใƒˆใƒ—ใƒฉใ‚ฏใƒ†ใ‚ฃใ‚น
25+
26+
ๅž‹ๅฎ‰ๅ…จใช Ruby ใ‚ณใƒผใƒ‰ใ‚’ๆ›ธใใŸใ‚ใฎๅฎŸ่ทต็š„ใชใƒ‘ใ‚ฟใƒผใƒณใจใƒ—ใƒฉใ‚ฏใƒ†ใ‚ฃใ‚นใ€‚ๅฎŸ้š›ใฎใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใ‹ใ‚‰ใฎไพ‹ใ‚’ๅ…ฑๆœ‰ใ—ใ€้ฟใ‘ใ‚‹ในใไธ€่ˆฌ็š„ใช่ฝใจใ—็ฉดใซใคใ„ใฆ่ญฐ่ซ–ใ—ใพใ™ใ€‚
27+
28+
### ใ‚ณใƒŸใƒฅใƒ‹ใƒ†ใ‚ฃใƒใ‚คใƒฉใ‚คใƒˆ
29+
30+
T-Ruby ใ‚ณใƒŸใƒฅใƒ‹ใƒ†ใ‚ฃใ‹ใ‚‰ใฎ่ˆˆๅ‘ณๆทฑใ„ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใ‚„่ฒข็Œฎใ‚’็ดนไป‹ใ—ใพใ™ใ€‚
31+
32+
## ๆœ€ๆ–ฐๆƒ…ๅ ฑใ‚’ๅ…ฅๆ‰‹
33+
34+
ใƒชใƒชใƒผใ‚น็™บ่กจใ‚„ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฎๆ›ดๆ–ฐใซใคใ„ใฆใฏใ€[ใƒ‹ใƒฅใƒผใ‚น](/news)ใ‚ปใ‚ฏใ‚ทใƒงใƒณใ‚’ใ”่ฆงใใ ใ•ใ„ใ€‚่ฉณ็ดฐใชใ‚ณใƒณใƒ†ใƒณใƒ„ใซใคใ„ใฆใฏใ€ใ“ใฎใƒ–ใƒญใ‚ฐใ‚’ใƒ–ใƒƒใ‚ฏใƒžใƒผใ‚ฏใ—ใฆๅฎšๆœŸ็š„ใซใƒใ‚งใƒƒใ‚ฏใ—ใฆใใ ใ•ใ„ใ€‚
35+
36+
ใ“ใฎๆ—…ใ‚’็š†ใ•ใ‚“ใจๅ…ฑๆœ‰ใงใใ‚‹ใ“ใจใ‚’ๆฅฝใ—ใฟใซใ—ใฆใ„ใพใ™ใ€‚Happy typing๏ผ

โ€Ži18n/ko/docusaurus-plugin-content-blog-news/2025-12-24-introducing-t-ruby.mdโ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
slug: introducing-t-ruby
33
title: T-Ruby ์†Œ๊ฐœ
4-
authors: [t-ruby-team]
4+
authors: [yhk1038]
55
tags: [announcement]
66
---
77

โ€Ži18n/ko/docusaurus-plugin-content-blog-news/authors.ymlโ€Ž

Lines changed: 0 additions & 4 deletions
This file was deleted.
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
slug: welcome
3+
title: T-Ruby ๋ธ”๋กœ๊ทธ์— ์˜ค์‹  ๊ฒƒ์„ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค
4+
authors: [yhk1038]
5+
tags: [announcement]
6+
---
7+
8+
๊ณต์‹ T-Ruby ๋ธ”๋กœ๊ทธ์— ์˜ค์‹  ๊ฒƒ์„ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค! ์ด๊ณณ์—์„œ ํŠœํ† ๋ฆฌ์–ผ, ๊ธฐ์ˆ  ์‹ฌ์ธต ๋ถ„์„, ํƒ€์ž… ์•ˆ์ „ Ruby ๊ฐœ๋ฐœ์— ๋Œ€ํ•œ ์ธ์‚ฌ์ดํŠธ๋ฅผ ๊ณต์œ ํ•  ์˜ˆ์ •์ž…๋‹ˆ๋‹ค.
9+
10+
<!-- truncate -->
11+
12+
## ์ด ๋ธ”๋กœ๊ทธ์—์„œ ๋‹ค๋ฃจ๋Š” ๋‚ด์šฉ
13+
14+
์ด ๋ธ”๋กœ๊ทธ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์ฝ˜ํ…์ธ ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค:
15+
16+
### ํŠœํ† ๋ฆฌ์–ผ
17+
18+
T-Ruby๋ฅผ ์ตœ๋Œ€ํ•œ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ๋„๋ก ๋„์™€์ฃผ๋Š” ๋‹จ๊ณ„๋ณ„ ๊ฐ€์ด๋“œ. ๊ธฐ๋ณธ ํƒ€์ž… ์–ด๋…ธํ…Œ์ด์…˜๋ถ€ํ„ฐ ๊ณ ๊ธ‰ ์ œ๋„ค๋ฆญ ํŒจํ„ด๊นŒ์ง€ ๋ชจ๋‘ ๋‹ค๋ฃน๋‹ˆ๋‹ค.
19+
20+
### ๊ธฐ์ˆ  ์‹ฌ์ธต ๋ถ„์„
21+
22+
T-Ruby ํƒ€์ž… ์‹œ์Šคํ…œ์˜ ๋‚ด๋ถ€๋ฅผ ํƒ๊ตฌํ•ฉ๋‹ˆ๋‹ค. ํƒ€์ž… ์ถ”๋ก ์˜ ์ž‘๋™ ๋ฐฉ์‹, RBS ํŒŒ์ผ ์ƒ์„ฑ ๋ฐฉ๋ฒ•, ํ”„๋กœ์ ํŠธ์˜ ์„ค๊ณ„ ๊ฒฐ์ •์— ๋Œ€ํ•ด ์•Œ์•„๋ด…๋‹ˆ๋‹ค.
23+
24+
### ๋ฒ ์ŠคํŠธ ํ”„๋ž™ํ‹ฐ์Šค
25+
26+
ํƒ€์ž… ์•ˆ์ „ Ruby ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ•˜๊ธฐ ์œ„ํ•œ ์‹ค์ œ ํŒจํ„ด๊ณผ ์‚ฌ๋ก€. ์‹ค์ œ ํ”„๋กœ์ ํŠธ์˜ ์˜ˆ์ œ๋ฅผ ๊ณต์œ ํ•˜๊ณ  ํ”ผํ•ด์•ผ ํ•  ์ผ๋ฐ˜์ ์ธ ํ•จ์ •์— ๋Œ€ํ•ด ๋…ผ์˜ํ•ฉ๋‹ˆ๋‹ค.
27+
28+
### ์ปค๋ฎค๋‹ˆํ‹ฐ ํ•˜์ด๋ผ์ดํŠธ
29+
30+
T-Ruby ์ปค๋ฎค๋‹ˆํ‹ฐ์˜ ํฅ๋ฏธ๋กœ์šด ํ”„๋กœ์ ํŠธ์™€ ๊ธฐ์—ฌ๋ฅผ ์†Œ๊ฐœํ•ฉ๋‹ˆ๋‹ค.
31+
32+
## ์ตœ์‹  ์†Œ์‹ ๋ฐ›๊ธฐ
33+
34+
๋ฆด๋ฆฌ์Šค ๊ณต์ง€ ๋ฐ ํ”„๋กœ์ ํŠธ ์—…๋ฐ์ดํŠธ๋Š” [๋‰ด์Šค](/news) ์„น์…˜์„ ํ™•์ธํ•˜์„ธ์š”. ์‹ฌ์ธต ์ฝ˜ํ…์ธ ๋ฅผ ์œ„ํ•ด ์ด ๋ธ”๋กœ๊ทธ๋ฅผ ๋ถ๋งˆํฌํ•˜๊ณ  ์ •๊ธฐ์ ์œผ๋กœ ๋ฐฉ๋ฌธํ•ด ์ฃผ์„ธ์š”.
35+
36+
์ด ์—ฌ์ •์„ ํ•จ๊ป˜ํ•˜๊ฒŒ ๋˜์–ด ๊ธฐ์ฉ๋‹ˆ๋‹ค. ์ฆ๊ฑฐ์šด ํƒ€์ดํ•‘ ๋˜์„ธ์š”!

โ€Žnews/2025-12-24-introducing-t-ruby.mdโ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
slug: introducing-t-ruby
33
title: Introducing T-Ruby
4-
authors: [t-ruby-team]
4+
authors: [yhk1038]
55
tags: [announcement]
66
---
77

0 commit comments

Comments
ย (0)