This is the Jekyll source code for the official Ruby programming language website.

First time contributing? Welcome! This guide will help you get the website running locally in just a few steps.

• Ruby (latest stable version recommended) - Install Ruby
• Git - Install Git

1. Install Bundler (if you haven't already):

   gem install bundler

2. Clone and setup the project:

   git clone https://github.com/ruby/www.ruby-lang.org.git
   cd www.ruby-lang.org/
   bundle config set --local without production
   bundle install

3. Start the development server:

   bundle exec rake serve

4. View the website: Open http://localhost:4000/ in your browser

   ⏱️ Note: The initial build takes several minutes. Make some tea! 🍵

• 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

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

New to open source? Check out First Contributions for a beginner-friendly guide.

# Quick development server (faster rebuilds)
bundle exec jekyll serve --watch --future --incremental

# Full build (for testing)
bundle exec rake build

Important: Always run the full test suite before submitting a pull request:

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)

You can run these tests while developing to catch issues early.

This project supports multiple languages! Each language has its own folder:

• en/ - English (base language)
• ja/ - Japanese
• es/ - Spanish
• fr/ - French
• And many more...

Want to help translate? See our translation guide for detailed instructions.

• 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

If you can't build locally or want to test under production conditions:

1. Setup Heroku: Sign up at heroku.com and install Heroku CLI

2. Create preview app:

   heroku login
   heroku create --buildpack https://github.com/ruby/heroku-buildpack-www-ruby-lang.git

3. Deploy your branch:

   git push heroku your-branch-name:master
   heroku open

• Questions? Join our Gitter chat
• Found a bug? Open an issue
• Need more info? Check the project wiki

This site uses Tailwind CSS for styling. After making changes to HTML/Markdown files or Tailwind configuration:

npm run build-css   # build CSS
npm run watch-css   # watch and rebuild CSS automatically

Note: You need to have Node.js installed to run these commands.

Besides generating and previewing the site you can perform additional tests with these tasks:

bundle exec rake lint          # run linter on markdown files
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)

For detailed contribution guidelines, coding standards, and project structure, see our wiki.

Thank you for helping make Ruby's website better for everyone! 🎉