Merge branch 'master' into improve-font-family-with-lang-attr

Author: sorah

404.md

@@ -9,7 +9,7 @@ permalink: /404.html
 (function() {
   // Detect language from URL path
   var path = window.location.pathname;
-  var match = path.match(/^\/(bg|de|en|es|fr|id|it|ja|ko|pl|pt|ru|tr|vi|zh_cn|zh_tw)\//);
+  var match = path.match(/^\/(bg|de|en|es|fr|id|it|ja|ko|pl|pt|ru|tr|ua|vi|zh_cn|zh_tw)\//);
 
   if (match && match[1] !== 'en') {
     var lang = match[1];

README.md

@@ -5,115 +5,123 @@ www.ruby-lang.org
 
 [![Build Status](https://github.com/ruby/www.ruby-lang.org/workflows/ci/badge.svg)](https://github.com/ruby/www.ruby-lang.org/actions?query=branch%3Amaster)
 
-This is the [Jekyll](http://www.jekyllrb.com/) source of
-the [www.ruby-lang.org](https://www.ruby-lang.org/) website.
+This is the [Jekyll](http://www.jekyllrb.com/) source code for the official [Ruby programming language website](https://www.ruby-lang.org/).
 
-## How to Contribute?
+## 🚀 Quick Start
 
-You can contribute by reporting errors or suggesting improvements.
-Just open an issue or pull request.
+**First time contributing?** Welcome! This guide will help you get the website running locally in just a few steps.
 
-This is a big project with many translations involved.
-Please help us stay on top of things by following our
-[guidelines for contributors](https://github.com/ruby/www.ruby-lang.org/wiki).
+### Prerequisites
 
-## Get It!
+- **Ruby** (latest stable version recommended) - [Install Ruby](https://www.ruby-lang.org/en/documentation/installation/)
+- **Git** - [Install Git](https://git-scm.com/downloads)
 
-Bundler will take care of the dependencies, so unless you
-already have done so, you might need to install bundler with:
+### Get It Running
 
-``` sh
-gem install bundler
-```
+1. **Install Bundler** (if you haven't already):
+   ```sh
+   gem install bundler
+   ```
 
-Then clone the repository and install the dependencies:
-
-``` sh
-git clone https://github.com/ruby/www.ruby-lang.org.git
-cd www.ruby-lang.org/
-bundle config set --local without production
-bundle install
-```
+2. **Clone and setup the project**:
+   ```sh
+   git clone https://github.com/ruby/www.ruby-lang.org.git
+   cd www.ruby-lang.org/
+   bundle config set --local without production
+   bundle install
+   ```
 
-## Make Changes
+3. **Start the development server**:
+   ```sh
+   bundle exec rake serve
+   ```
 
-Making changes is easy:
-just locate the Markdown source of the page you want to improve,
-then make your changes or add content.
+4. **View the website**: Open [http://localhost:4000/](http://localhost:4000/) in your browser
 
-If you plan to submit a pull request or want to preview your changes
-on Heroku, you need to
+   ⏱️ **Note:** The initial build takes several minutes. Make some tea! 🍵
 
-* create a topic branch,
-* commit your changes to this branch.
+## 🤝 How to Contribute
 
-See the [project's wiki][wiki] for some guidelines on how
-your commits and PRs should look like.
+### Quick Fixes
+- **Found a typo?** Just edit the Markdown file and submit a pull request!
+- **Broken link?** Open an issue and we'll fix it quickly
+- **Translation error?** Check our [translation guidelines](https://github.com/ruby/www.ruby-lang.org/wiki)
 
-## Preview Your Changes
+### Making Changes
 
-### Preview Locally
+1. **Find the content**: Website pages are in Markdown format in language-specific folders (e.g., `en/`, `ja/`, `es/`)
+2. **Create a branch**: `git checkout -b fix-typo-in-getting-started`
+3. **Make your changes**: Edit the Markdown files
+4. **Test as you go**: Run `bundle exec rake serve` to preview your changes
+5. **Run the test suite**: Before submitting, ensure all tests pass (see Testing section below)
+6. **Submit**: Open a pull request with a clear description
 
-Generate the website with
+**New to open source?** Check out [First Contributions](https://github.com/firstcontributions/first-contributions) for a beginner-friendly guide.
 
-``` sh
-bundle exec rake build
-```
+## 🛠️ Development
 
-Then start a local web server with
+### Local Development
+```sh
+# Quick development server (faster rebuilds)
+bundle exec jekyll serve --watch --future --incremental
 
-``` sh
-bundle exec rake serve
+# Full build (for testing)
+bundle exec rake build
 ```
 
-Open [http://localhost:4000/](http://localhost:4000/)
-in your browser to access the preview.
-
-**Note:** The build of the site will take several minutes.
+### Testing Your Changes
 
-Alternatively, you can use Jekyll directly.
+**Important**: Always run the full test suite before submitting a pull request:
 
-```
-bundle exec jekyll serve --watch --future --incremental
+```sh
+bundle exec rake lint          # Check markdown formatting
+bundle exec rake check:markup  # Validate HTML output
+bundle exec rake check:links   # Check for broken links (requires local server)
 ```
 
-If your draft uses future date, you may want to use `--future` option.
+You can run these tests while developing to catch issues early.
 
-### Preview on Heroku
+## 🌐 Translations
 
-In case a build is not possible on your local machine
-or you want to test your changes under production conditions
-you can also create a preview on Heroku.
+This project supports multiple languages! Each language has its own folder:
+- `en/` - English (base language)
+- `ja/` - Japanese
+- `es/` - Spanish
+- `fr/` - French
+- And many more...
 
-  * Sign up for [Heroku](http://www.heroku.com) if you do not have
-    an account yet.
+**Want to help translate?** See our [translation guide](https://github.com/ruby/www.ruby-lang.org/wiki) for detailed instructions.
 
-  * Install the [Heroku Toolbelt](https://toolbelt.heroku.com).
+## 📝 Content Guidelines
 
-  * Unless you already have, `cd` into your local working copy of this repo.
+- **Keep it simple**: Write for a global audience of developers with varying English proficiency
+- **Be clear**: Use straightforward language that's easy to understand
+- **Stay current**: Update version numbers and examples regularly
+- **Test your changes**: Always preview locally before submitting
 
-  * Create a preview app on Heroku using the custom buildpack:
+## 🔧 Heroku Preview (Advanced)
 
-    ``` sh
-    heroku login
-    heroku create --buildpack https://github.com/ruby/heroku-buildpack-www-ruby-lang.git
-    ```
+If you can't build locally or want to test under production conditions:
 
-  * Push your feature branch:
+1. **Setup Heroku**: Sign up at [heroku.com](http://www.heroku.com) and install [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli)
 
-    ``` sh
-    git push heroku feature_branch:master
-    ```
+2. **Create preview app**:
+   ```sh
+   heroku login
+   heroku create --buildpack https://github.com/ruby/heroku-buildpack-www-ruby-lang.git
+   ```
 
-    To create a preview of the master branch:
+3. **Deploy your branch**:
+   ```sh
+   git push heroku your-branch-name:master
+   heroku open
+   ```
 
-    ``` sh
-    git push heroku master
-    ```
-
-Open the preview in your browser with `heroku open` or
-retrieve the preview URL using `heroku info` and open it in your browser.
+## 💬 Getting Help
 
+- **Questions?** Join our [Gitter chat](https://gitter.im/ruby/www.ruby-lang.org)
+- **Found a bug?** [Open an issue](https://github.com/ruby/www.ruby-lang.org/issues)
+- **Need more info?** Check the [project wiki](https://github.com/ruby/www.ruby-lang.org/wiki)
 
 ## Styling with Tailwind CSS
 
@@ -139,8 +147,10 @@ bundle exec rake check:markup  # check markup for all generated pages
 bundle exec rake check:links   # check for 404's (needs a running local server)
 ```
 
-## More Information
+## 📚 More Information
+
+For detailed contribution guidelines, coding standards, and project structure, see our [wiki](https://github.com/ruby/www.ruby-lang.org/wiki).
 
-For more information see the [wiki][wiki].
+---
 
-[wiki]: https://github.com/ruby/www.ruby-lang.org/wiki
+**Thank you for helping make Ruby's website better for everyone!** 🎉

Rakefile

@@ -8,7 +8,7 @@ rescue LoadError => e
   exit(-1)
 end
 
-LANGUAGES = %w[bg de en es fr id it ja ko pl pt ru tr vi zh_cn zh_tw].freeze
+LANGUAGES = %w[bg de en es fr id it ja ko pl pt ru tr ua vi zh_cn zh_tw].freeze
 CONFIG = "_config.yml"
 
 task default: [:build]

_data/languages.yml

@@ -38,6 +38,9 @@
 - code: tr
   name: Turkish
   native_name: Türkçe
+- code: ua
+  name: Ukrainian
+  native_name: Українська
 - code: vi
   name: Vietnamese
   native_name: Tiếng Việt

_data/locales/home/ua.yml

@@ -0,0 +1,114 @@
+hero:
+  since: "З"
+  year: "1995"
+  title: "Ruby"
+  latest_version_label: "Остання версія:"
+  download_button: "Завантажити"
+  or: "або"
+  learn_more: "Дізнатися більше"
+
+try_ruby:
+  title: "Спробуйте Ruby!"
+  description: "Спробуйте Ruby у браузері просто зараз"
+  button_url: "https://try.ruby-lang.org/"
+  bottom_text: "Хочете дізнатися більше або спробувати Ruby?"
+  bottom_link_url: "https://try.ruby-lang.org/"
+
+why_ruby:
+  title: Чому Ruby?
+  description: Чому програмісти по всьому світу люблять Ruby? Що робить його <strong>цікавим</strong>?
+  features:
+    - id: ecosystem
+      title: Екосистема
+      read: Багаті геми підтримують усі види розробки.<br />Зрілі інструменти готові до використання.
+      copy: |
+        Ruby має велику колекцію бібліотек, що називаються гемами, які підтримують усе — від веброзробки до обробки даних.
+        Зі зрілими фреймворками на кшталт Rails і комплексними наборами інструментів ви можете поєднувати чудові наявні ресурси
+        для швидкого створення високоякісних застосунків без повторного винайдення колеса.
+      comment:
+        author:
+          id: matz
+          name: Yukihiro "Matz" Matsumoto
+          title: Творець Ruby
+        content: |
+          Коли я випустив Ruby у світ, я й не уявляв, що з нього виросте така багата екосистема.
+          Понад 200 000 гемів, Ruby on Rails, RSpec, Bundler — усе це створила й підтримувала спільнота.
+          Моє бажання «зробити програмістів щасливими» здійснилося так, як я не зміг би досягти сам.
+    - id: simple
+      title: Простота
+      read: Легко писати, легко читати.<br />Природний синтаксис, як у розмовній мові.
+      copy: |
+        Ruby має простий та інтуїтивний синтаксис, який читається як природна мова.
+        Позбуваючись складних символів і багатослівних конструкцій, філософія дизайну Ruby дозволяє вам безпосередньо висловлювати те, що ви хочете.
+        З мінімумом шаблонного коду й високою читабельністю він дружній для новачків і зручний для досвідчених розробників.
+      comment:
+        author:
+          id: dhh
+          name: David Heinemeier Hansson
+          title: Творець Ruby on Rails
+        content: |
+          Ruby — це просто найкрасивіша мова програмування, яку я коли-небудь бачив.<br />
+          І я приділяю чималу увагу новим мовам програмування, що з'являються,
+          новим середовищам, новим фреймворкам, і досі не бачив нічого, що відповідало б Ruby або перевершило його в чистоті дизайну.
+    - id: productivity
+      title: Продуктивність
+      read: Робіть більше з меншим обсягом коду.<br />Інтуїтивний синтаксис прискорює розробку.
+      copy: |
+        Виразний синтаксис Ruby дозволяє стисло писати складну логіку.
+        Використовуючи потужні можливості, як-от метапрограмування та блоки, ви можете зменшити повторення й зосередитися на вирішенні основних задач.
+        З потужними фреймворками для тестування ви можете зберігати якість і досягати швидких циклів розробки.
+      comment:
+        author:
+          id: pragdave
+          name: Dave Thomas
+          title: Автор "The Pragmatic Programmer"
+        content: |
+          Ruby швидко перетворює ідеї на код.
+          Його простота допомагає мені залишатися зосередженим; його виразність дозволяє писати так, як я думаю.<br />
+          Відчуття, ніби мова відходить убік, залишаючи тільки мене і задачу.
+          З чудовими інструментами та бібліотеками ідеї швидко стають працюючим, елегантним кодом.
+
+    - id: community
+      title: Спільнота
+      read: Розробники по всьому світу підтримують одне одного.<br />Тепла, активна спільнота.
+      copy: |
+        Спільнота Ruby дотримується культури "Matz is nice and so we are nice (MINASWAN)",
+        вітаючи всіх — від новачків до експертів. Конференції та зустрічі по всьому світу сприяють обміну знаннями й налагодженню зв'язків.
+        Це тепла, стійка спільнота, де люди допомагають один одному й ростуть разом.
+      comment:
+        author:
+          id: amanda
+          name: Amanda Perino
+          title: Виконавчий директор Rails Foundation
+        content: |
+          Спільнота Ruby сповнена таланту й креативності — розробників, яких приваблює елегантний синтаксис Ruby і які програмують заради задоволення.
+          Це яскрава, гостинна спільнота, готова поділитися своєю любов'ю до програмування з усіма.
+          Цей дух тепла й співпраці — безумовно, найбільша цінність Ruby.
+
+companies:
+  title: "Компанії"
+  heart: "♥"
+  subtitle: "Ruby"
+
+community:
+  title: "Долучайтеся до спільноти"
+  description_1: "Людей, які взаємодіють із Ruby не лише як користувачі, називають Rubyists."
+  description_2: "Rubyists, які люблять Ruby, — усі милі #rubyfriends. Активності спільноти бурхливі та веселі."
+  motto_prefix: "Універсальний девіз —"
+  motto_minaswan: "MINASWAN"
+  motto_separator: "—"
+  motto_translation: "Matz добрий, тож і ми добрі"
+  links:
+    - text: "Дізнайтеся більше про спільноту"
+      url: "/community/"
+    - text: "Майбутні міжнародні конференції"
+      url: "https://www.rubyevents.org"
+      external: true
+
+news_security:
+  news:
+    title: "Новини"
+    more_link: "Читати більше новин"
+  security:
+    title: "Безпека"
+    more_link: "Читати більше про безпеку"