learnstorybook.com
learnstorybook.com copied to clipboard
chromaui
Translations wanted
Learn Storybook is read by over 300,000 developers! We need help translating the tutorial to other languages.
What's needed
Translating is manageable for one person. The content length is the equivalent to one long blog post (5–6k words). Ideally, we try to have 2 people to collaborate on writing and proofreading, but that shouldn't prevent you from getting started.
Note: React/English is the "master" edition that is updated often. Please use React/English as the source-of-truth in your translations. 🙏
How to get started
- Comment on this issue with your language (so folks can work together)
- Add a new directory in content with language (e.g.,
/react/jp). - Copy the existing docs to the new directory
- Translate markdown content including what's in the "frontmatter" (title, tocTitle, description). Do not change the code snippets, commit, or filename.
- Run the project on localhost using yarn dev to confirm that everything looks OK. For now, you can preview changes by going to a url that looks like this http://localhost:8000/intro-to-storybook/react/jp/composite-component/
- Make a pull request
- Get a review by another native language speaker (if possible)
Status
React
| Language | Contributors | Discussion | Status |
|---|---|---|---|
| 🇲🇽 Spanish | @lmac-1 @icarlossz, @luchux | 🎉 Live | |
| 🇨🇳 Simplified Chinese | @chinanf-boy,@STPace | 🎉 Live | |
| 🇹🇼 🇭🇰Traditional Chinese | @ymcheung | 🎉 Live | |
| 🇵🇹🇧🇷 Portuguese | @jonniebigodes | 🎉 Live | |
| 🇳🇱🇧🇪 Dutch | @Robin-Hoodie, @ghengeveld | 🎉 Live | |
| 🇩🇪 German | @renet @jonathanherdt | 🎉 Live | |
| 🇯🇵 Japanese | @chameleonhead, @match5121 | 🎉 Live | |
| 🇫🇷 French | @Draketheb4dass , @rjussserand | 🎉 Live | |
| 🇮🇹 Italian | @ludovicobesana , @giowhatever | 🎉 Live | |
| 🇰🇷 Korean | @katepark1009, @jinho6225 | 🎉 Live | |
| 🇲🇦 Arabic | @eihabkhan, @merodiro | 🎉 Live |
React Native
| Language | Contributors | Discussion | Status |
|---|---|---|---|
| 🇲🇽 Spanish | @IvanSotelo | ||
| 🇵🇹🇧🇷 Portuguese | @Wanderson77, @pablolucas890 | 🎉 Live |
Angular
| Language | Contributors | Discussion | Status |
|---|---|---|---|
| 🇲🇽 Spanish | @josegarciamanez | #478 | 🎉 Live |
| 🇵🇹 Portuguese | @jonniebigodes | 🎉 Live | |
| 🇯🇵 Japanese | @nagashimam, @chameleonhead | 🎉 Live |
Vue
| Language | Contributors | Discussion | Status |
|---|---|---|---|
| 🇵🇹🇧🇷 Portuguese | @jonniebigodes | 🎉 Live | |
| 🇲🇽 Spanish | @IvanSotelo | 🎉 Live | |
| 🇫🇷 French | @jeanphibaconnais | 🎉 Live | |
| 🇨🇳 Simplified Chinese | @zydmayday, @fengnzl | #680 | 🎉 Live |
| 🇮🇹 Italian | @Archetipo95 , @ludovicobesana | 🎉 Live |
Svelte
| Language | Contributors | Discussion | Status |
|---|---|---|---|
| 🇲🇽 Spanish | @IvanSotelo | 🎉 Live |
Hello, It would be great if you use ISO 639-1 to url. e.g. /content/ja , /content/es, it looks more standard and url is short
@geromegrignon Yes please! The Angular editions don't have the recently added addon chapter yet, can you include that in your translation? 🙏
ok, do you want me to make a PR to add this chapter to the Angular english version as well?
Yea that’d be awesome 👏 On Thu, Dec 27, 2018 at 12:05 PM Gérôme Grignon [email protected] wrote:
ok, do you want me to make a PR to add this chapter to the Angular english version as well?
— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/chromaui/learnstorybook.com/issues/3#issuecomment-450192090, or mute the thread https://github.com/notifications/unsubscribe-auth/AAQE2RBB5Z1i4NrAM4Ctiam1wMLMRsUwks5u9P3SgaJpZM4TFl7Z .
If you want i can help out with the portuguese translation. I will start with the react version and then move on systematically to the angular and vue documentation.
Yes we’d really appreciate it @jonniebigodes! @tmeasday is looking to update the tutorial to +4.x in the next couple of days so perfect timing 👌 On Fri, Dec 28, 2018 at 12:56 PM jonniebigodes [email protected] wrote:
If you want i can help out with the portuguese translation. I will start with the react version and then move on systematically to the angular and vue documentation.
— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/chromaui/learnstorybook.com/issues/3#issuecomment-450400633, or mute the thread https://github.com/notifications/unsubscribe-auth/AAQE2WX-6WtuNBB5BxQwd-Gt_9mQO9eeks5u9ltGgaJpZM4TFl7Z .
Just to be clear I think the written text + code samples work more or less with 4.0 (let me know if not!). It’s just the code repository is a little out of date. On 29 Dec 2018, 5:15 AM +1100, Dominic Nguyen [email protected], wrote:
Yes we’d really appreciate it @jonniebigodes! @tmeasday is looking to update the tutorial to +4.x in the next couple of days so perfect timing 👌 On Fri, Dec 28, 2018 at 12:56 PM jonniebigodes [email protected] wrote:
If you want i can help out with the portuguese translation. I will start with the react version and then move on systematically to the angular and vue documentation.
— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/chromaui/learnstorybook.com/issues/3#issuecomment-450400633, or mute the thread https://github.com/notifications/unsubscribe-auth/AAQE2WX-6WtuNBB5BxQwd-Gt_9mQO9eeks5u9ltGgaJpZM4TFl7Z .
— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.
OK, and as soon as the tutorial is done, i'll pick up on it and proceed from there and start the translation. Sounds good?
@jonniebigodes sorry if I wasn't clear; what I meant was the tutorial should be good for v4 as it stands. It's just the code repository (https://github.com/chromaui/learnstorybook-code) hasn't yet been updated for v4. But if a user follows the steps in the tutorial it should work.
I'll be updating the code in the near future, but I am not sure how soon, perhaps within the next 2 weeks? I can't really say if it'll be sooner.
In theory the text will not change when I make those changes (as I am just bringing the code up to date with the text), although it's possible I'll discover some problems as I do so. So depending on your own schedule it'd make sense to either wait for me to make the update (to be absolutely sure you are translating the final text) or just do the translation now (if waiting a couple of weeks doesn't work for you).
@tmeasday sorry it was my mistake, i understood it wrong. I'm cloning the tutorial's repository and start working on the translations as we speak.
@tmeasday I think I can translate this into Korean, starting from React first, if you think it's okay.
🙏 @moonformeli I'd be thrilled about a Korean translation.
🎉 Shoutout to @jonniebigodes for shipping Portuguese!
@domyen Quick question. Is it better to do PR with fully translated files than with partially translated files? :)
Fully translated is a bit easier. But if you end up submitting a PR with partial translations just mention that in the post and I’ll add a “do not merge” tag. On Fri, Jan 25, 2019 at 5:43 AM moonformeli [email protected] wrote:
@domyen https://github.com/domyen Quick question. Is it better to do PR with fully translated files than with partially translated files? :)
— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/chromaui/learnstorybook.com/issues/3#issuecomment-457532174, or mute the thread https://github.com/notifications/unsubscribe-auth/AAQE2e2vZfXkD1FHoeH8l9YlNK0koKTZks5vGt-9gaJpZM4TFl7Z .
@tmeasday just updated the English guide to the new Storybook 5.0. The translations could use a review so they stay up to date!
Mind taking a look @icarlossz @alterx @luchux @chinanf-boy @danielduan @jonniebigodes 🙏
@domyen i've been keeping an eye on the twitter feed and saw the update. I was looking for a update on the guide so that i could make the changes on the translations. Going to start making the necessary adjustments starting tomorrow.
I'm not sure I made any text changes -- I updated the code snippets where required (very limited) in all the translations, and all the images are shared so should have just worked. You can check commits to be totally sure of course.
However I only did the React version. If someone has the time to walk through the Vue and/or Angular tutorials and see if there any problems that would be greatly appreciated.
I updated the source code for React too to use SB5. Ideally we'd do that for the other view layers too. I figure most people are on React so that's where I've put the time for now 😓
@domyen, Carlos reporting for duty :P I'll take a look to the Spanish and English versions of Angular during this week. I think there's also a new chapter that's missing for the Angular version, I'll add that one too.
I started translating of vue part to Russian in https://github.com/b0g3r/learnstorybook.com/tree/ru
Awesome!
Tom On 18 Mar 2019, 6:59 AM +1100, Dima Boger [email protected], wrote:
I started translating of vue part to Russian in https://github.com/b0g3r/learnstorybook.com/tree/ru — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.