Skip to content

Commit 12c50b6

Browse files
authored
Translate A New Look for Ruby's Documentation (ru) (#3741)
1 parent 8b577c4 commit 12c50b6

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
layout: news_post
3+
title: "Новый облик документации Ruby"
4+
author: "Stan Lo"
5+
translator: "ablzh"
6+
date: 2025-12-23 00:00:00 +0000
7+
lang: ru
8+
---
9+
10+
Вслед за [редизайном ruby-lang.org](https://www.ruby-lang.org/ru/news/2025/12/22/redesign-site-identity/), у нас есть еще новости в честь 30-летия Ruby: [docs.ruby-lang.org][ruby-doc] получил полностью новый облик с Aliki — новым стандартным шаблоном [RDoc](https://github.com/ruby/rdoc).
11+
12+
## Свежий взгляд на документацию Ruby
13+
14+
Писать на Ruby всегда было удовольствием, и теперь чтение документации Ruby может соответствовать этому опыту. Aliki привносит современный и чистый дизайн на [docs.ruby-lang.org][ruby-doc] и в любой гем, который генерирует документацию с помощью RDoc версии 7.0 и выше.
15+
16+
## Ключевые особенности
17+
18+
- **Улучшенный поиск**: ранжирование с учетом регистра, нечеткий поиск и поддержка поиска констант.
19+
- **Темная тема**: учитывает настройки вашей ОС с возможностью ручного переключения.
20+
- **Трехколоночный макет**: левая боковая панель для навигации, центральная часть для контента и правая боковая панель для оглавления.
21+
- **Улучшения блоков кода**: кнопки копирования в блоках кода и подсветка синтаксиса C.
22+
- **Настраиваемый футер**: авторы гемов могут добавлять ссылки на свой репозиторий, трекер задач и другие ресурсы.
23+
24+
## Для авторов гемов
25+
26+
Если вы генерируете документацию с помощью RDoc 7.0+, ваши пользователи автоматически увидят Aliki. Вы можете настроить ссылки в футере или вернуться к теме Darkfish в вашем файле `.rdoc_options`.
27+
28+
## Попробуйте сами
29+
30+
Посмотрите на новый дизайн в действии на [docs.ruby-lang.org][ruby-doc].
31+
32+
Если вы обнаружите ошибки или у вас появятся предложения, пожалуйста, [откройте issue](https://github.com/ruby/rdoc/issues) на GitHub.
33+
34+
[ruby-doc]: https://docs.ruby-lang.org/en/master/

0 commit comments

Comments
 (0)