www.ruby-lang.org
www.ruby-lang.org copied to clipboard
[Update]www.r-l.org zh_cn status
This is an updated list of https://github.com/ruby/www.ruby-lang.org/issues/1074 which lists the things left to do. Please feel free to take tasks :smiley:
Please do leave a comment if you want to work on some of the things to avoid people double work on the same thing. :sweat_smile:
Places that need your help :cry:
- [x] Page footer and possibly more localizations in _config.yml
Pages
- [x] About https://www.ruby-lang.org/en/about @hlcfan
- [x] About/logo https://www.ruby-lang.org/en/about/logo @hlcfan
- [x] About/website (new!) https://www.ruby-lang.org/en/about/website @hlcfan
- [x] Documentation https://www.ruby-lang.org/en/documentation
- [x] Documentation/installation (new!) https://www.ruby-lang.org/en/documentation/installation @tzwm
- [ ] Security https://www.ruby-lang.org/en/security (minor changes; not to translate: the list of
More known issues
) @cursorzz - [ ] many more pages have been changed over the years and should be updated
News (Please update from newest first!)
- [ ] 2014/10/27/rexml-dos-cve-2014-8080 @AndyHelix
- [ ] 2014/09/02/Railscamp-Koeln
- [ ] 2014/07/01/eol-for-1-8-7-and-1-9-2 @diguage
- [ ] 2014/06/16/rubyworld-conference-2014-speaker-invite @diguage
- [ ] 2016 Fukuoka Ruby Award Competition - Entries to be judged by Matz @Zane5
How to help
-
- Fork this repository.
-
- Clone
[email protected]:ruby/www.ruby-lang.org.git to
your local machine.
- Clone
-
- Add your forked remote:
git remote add [your_username] [email protected]:[your_username]/www.ruby-lang.org.git
(Replace[your_username]
with your GitHub username)
- Add your forked remote:
-
- Get latest master branch:
git pull origin master
- Get latest master branch:
-
- Pick a task from above
-
- Create a descriptive feature branch. (
zh_cn/update-installation
)
- Create a descriptive feature branch. (
-
- Find the file and start translating.
if the doc does not exist, copy
en
one to corresponding location underzh_cn
. if doc already exists, compare withen
and update to latest. If file is too big, you can also translate/update some part of it.
- Find the file and start translating.
if the doc does not exist, copy
-
- Preview
bundle
to install dependencies. Then runrake preview
to preview the website (May take 10 minutes!). Visit localhost:4000 and go to corresponding location of the site you're working on to see if anything goes wrong. This is a Jekyll powered website, you can know more about Jekyll here.
- Preview
-
- Finished translation, add and commit it.
git add
andgit commit -v
, please write a descriptive commit message, you need to include(zh_cn)
in the commit message.
- Finished translation, add and commit it.
-
- Push to your fork:
git push forked [your-descriptive-feature-branch-name]
.
- Push to your fork:
-
- Visit https://github.com/ruby/www.ruby-lang.org, you shall see there is a create a pull request button.
-
- Click button to create a Pull Request with descriptive title and body. Link back to this PR by putting
Related #1074
in your PR body.
- Click button to create a Pull Request with descriptive title and body. Link back to this PR by putting
-
- Run
rake preview
and post a screenshot in the pull request.
- Run
Now wait your Pull Request to get reviewed! :confetti_ball: Thank you! :bow:
If you reviewed a pull request, and think it is good to merge, can drop a comment like: :+1: , :shipit: , etc.
If you are not familiar with Git, you can try git-it. :wink:
Examples
- Translate Page example: Example 1, Example 2
- Update outdated page example: Example 1, Example 2
- Fix typo example: Example 1, Example 2
- Translate news example: Example 1, Example 2
Style of Translation
Please refer to https://github.com/sparanoid/chinese-copywriting-guidelines
News from 2014 (except maybe security related) really do not need translation; this is especially true for conference announcements and the like! (cc @diguage: affects speaker invite)
My comment from the previous issue is still true, here it comes again:
Please concentrate on security announcements and static pages like
- about (changed)
- about/logo, about/website (new!)
- documentation/installation (new!); this also involves updates in documentation
-
security (minor changes; not to translate: the list of
More known issues
) - many more pages have been changed over the years and should be updated
Old release announcements or conference invitations are not of priority.
Also I noticed that currently many posts link to en
posts, like security announcements, but translations now exist and should be linked to instead.
@hlcfan I will translate Fukuoka Ruby Award 2016 (zh_cn)
@hlcfan I will translate Fukuoka Ruby Award 2016 (zh_cn)
Awesome!
@Zane5 If possible, focus on static pages & security announcements first, thanks! :blush:
documentation/installation (new!); this also involves updates in documentation security (minor changes; not to translate: the list of More known issues)
@hlcfan Two issues then we can remove unmaintained notice! /cc @stomar