From e5cd2cdf7b8b67a0cc97786fd1e14ca06a640c1c Mon Sep 17 00:00:00 2001 From: Shia Date: Thu, 25 Dec 2025 09:25:47 +0900 Subject: [PATCH 1/2] cp {en,ko}/news/_posts/2025-12-23-new-look-for-ruby-documentation.md --- ...5-12-23-new-look-for-ruby-documentation.md | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 ko/news/_posts/2025-12-23-new-look-for-ruby-documentation.md diff --git a/ko/news/_posts/2025-12-23-new-look-for-ruby-documentation.md b/ko/news/_posts/2025-12-23-new-look-for-ruby-documentation.md new file mode 100644 index 0000000000..3e03b489e5 --- /dev/null +++ b/ko/news/_posts/2025-12-23-new-look-for-ruby-documentation.md @@ -0,0 +1,34 @@ +--- +layout: news_post +title: "A New Look for Ruby's Documentation" +author: "Stan Lo" +translator: +date: 2025-12-23 00:00:00 +0000 +lang: en +--- + +Following the [ruby-lang.org redesign](https://www.ruby-lang.org/en/news/2025/12/22/redesign-site-identity/), we have more news to celebrate Ruby's 30th anniversary: [docs.ruby-lang.org][ruby-doc] has a completely new look with Aliki—[RDoc](https://github.com/ruby/rdoc)'s new default theme. + +## A Fresh Look for Ruby Documentation + +Ruby has always been a joy to write, and now reading Ruby documentation can match that experience. Aliki brings a modern, clean design to [docs.ruby-lang.org][ruby-doc] and any gem that generates documentation with RDoc v7.0+. + +## Key Features + +- **Improved search**: Case-aware ranking, fuzzy matching, and support for searching constants +- **Dark mode**: Respects your OS preference with a manual toggle +- **Three-column layout**: Left sidebar for navigation, center for content, right sidebar for table of contents +- **Code block improvements**: Copy buttons on code blocks and C syntax highlighting +- **Customizable footer**: Gem maintainers can add links to their repository, issue tracker, and other resources + +## For Gem Authors + +If you generate documentation with RDoc 7.0+, your users will see Aliki automatically. You can customize footer links or switch back to the Darkfish theme in your `.rdoc_options` file. + +## Try It Out + +See the new look in action at [docs.ruby-lang.org][ruby-doc]. + +If you find issues or have suggestions, please [open an issue](https://github.com/ruby/rdoc/issues) on GitHub. + +[ruby-doc]: https://docs.ruby-lang.org/en/master/ From 0f78f9f9bcd2075041debe9b6adf414aec977fa6 Mon Sep 17 00:00:00 2001 From: Shia Date: Thu, 25 Dec 2025 09:29:38 +0900 Subject: [PATCH 2/2] Translate "A New Look for Ruby's Documentation" (ko) --- ...5-12-23-new-look-for-ruby-documentation.md | 34 +++++++++---------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/ko/news/_posts/2025-12-23-new-look-for-ruby-documentation.md b/ko/news/_posts/2025-12-23-new-look-for-ruby-documentation.md index 3e03b489e5..431f271da4 100644 --- a/ko/news/_posts/2025-12-23-new-look-for-ruby-documentation.md +++ b/ko/news/_posts/2025-12-23-new-look-for-ruby-documentation.md @@ -1,34 +1,34 @@ --- layout: news_post -title: "A New Look for Ruby's Documentation" +title: "Ruby 문서의 새로운 모습" author: "Stan Lo" -translator: +translator: "shia" date: 2025-12-23 00:00:00 +0000 -lang: en +lang: ko --- -Following the [ruby-lang.org redesign](https://www.ruby-lang.org/en/news/2025/12/22/redesign-site-identity/), we have more news to celebrate Ruby's 30th anniversary: [docs.ruby-lang.org][ruby-doc] has a completely new look with Aliki—[RDoc](https://github.com/ruby/rdoc)'s new default theme. +[ruby-lang.org 재디자인](https://www.ruby-lang.org/ko/news/2025/12/22/redesign-site-identity/)에 이어, Ruby의 30주년을 기념하는 또 다른 소식을 전합니다. [docs.ruby-lang.org][ruby-doc]가 [RDoc](https://github.com/ruby/rdoc)의 새로운 기본 테마인 Aliki와 함께 완전히 새로운 모습으로 탈바꿈했습니다. -## A Fresh Look for Ruby Documentation +## Ruby 문서의 새로운 외관 -Ruby has always been a joy to write, and now reading Ruby documentation can match that experience. Aliki brings a modern, clean design to [docs.ruby-lang.org][ruby-doc] and any gem that generates documentation with RDoc v7.0+. +Ruby는 항상 작성하기 즐거운 언어였으며, 이제 Ruby 문서를 읽는 경험도 그에 맞춰 개선되었습니다. Aliki는 [docs.ruby-lang.org][ruby-doc]와 RDoc v7.0+로 문서를 생성하는 모든 gem에 현대적이고 깔끔한 디자인을 제공합니다. -## Key Features +## 주요 기능 -- **Improved search**: Case-aware ranking, fuzzy matching, and support for searching constants -- **Dark mode**: Respects your OS preference with a manual toggle -- **Three-column layout**: Left sidebar for navigation, center for content, right sidebar for table of contents -- **Code block improvements**: Copy buttons on code blocks and C syntax highlighting -- **Customizable footer**: Gem maintainers can add links to their repository, issue tracker, and other resources +- **개선된 검색**: 대소문자 인식 랭킹, 퍼지 매칭, 상수 검색 지원 +- **다크 모드**: OS 설정을 따르며 수동 토글 지원 +- **3단 레이아웃**: 왼쪽 사이드바는 탐색, 중앙은 콘텐츠, 오른쪽 사이드바는 목차 +- **코드 블록 개선**: 코드 블록에 복사 버튼 추가 및 C 문법 하이라이팅 +- **커스터마이징 가능한 하단**: Gem 관리자가 저장소, 이슈 트래커 및 기타 리소스에 대한 링크를 추가할 수 있습니다 -## For Gem Authors +## Gem 작성자를 위한 안내 -If you generate documentation with RDoc 7.0+, your users will see Aliki automatically. You can customize footer links or switch back to the Darkfish theme in your `.rdoc_options` file. +RDoc 7.0+로 문서를 생성하는 경우, 사용자는 자동으로 Aliki를 보게 됩니다. `.rdoc_options` 파일에서 하단 링크를 커스터마이징하거나 Darkfish 테마로 되돌릴 수 있습니다. -## Try It Out +## 직접 확인해 보세요 -See the new look in action at [docs.ruby-lang.org][ruby-doc]. +[docs.ruby-lang.org][ruby-doc]에서 새로운 모습을 직접 확인해 보세요. -If you find issues or have suggestions, please [open an issue](https://github.com/ruby/rdoc/issues) on GitHub. +문제를 발견하거나 제안 사항이 있으시면, GitHub에 [이슈를 등록](https://github.com/ruby/rdoc/issues)해 주세요. [ruby-doc]: https://docs.ruby-lang.org/en/master/