Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[docs] Add missing sections to events reference page in IT and CN #5523

Conversation

hejld
Copy link
Contributor

@hejld hejld commented Nov 21, 2015

Fixes #432.

This PR adds missing parts of the events documentation to the respective Italian and Chinese translations. The english version was already done in #5142.

The translations are still WIP. Following section titles still need to be translated:

it-IT (done):

Composition Events
Selection Events

ko-KR:

Composition Events

zh-CN:

Selection Events
Media Events
Image Events

Could you guys help a bit? @minwe @marocchino @claudiopro

Thanks!

@@ -139,7 +139,6 @@ DOMEventTarget relatedTarget

이 포커스 이벤트는 폼 엘리먼트뿐만 아니라 모든 React DOM 엘리먼트에서 작동합니다.

<a name="form-events"></a>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It used at docs/docs/07-forms.ko-KR.md:11 's link.
I want leave it as is.

<form> 이벤트에 관한 정보는 폼 이벤트를 보세요.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Section headers have anchors by default, can we use #폼-이벤트 anchor instead - without the need for hidden element?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since kramdown strip i18n characters.

http://facebook.github.io/react/docs/events-ko-KR.html#폼-이벤트

is not valid link.
Auto-generated link (http://facebook.github.io/react/docs/events-ko-KR.html#-) is pointing "이벤트 풀링".

You can check this behaviour on current page.
http://facebook.github.io/react/docs/events-ko-KR.html#-

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same issue with http://facebook.github.io/react/docs/events-zh-CN.html. Is it a known limitation or issue of Jekyll ?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can read more at here.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@marocchino wow, thanks! Good to know 👀

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't use Kramdown, we use Redcarpet. The header generation is done in a custom plugin (https://github.com/facebook/react/blob/master/docs/_plugins/header_links.rb) which is pretty naive (only supports a small number of characters).

When making changes like this, please run the server and ensure they work. This change won't work (as @marocchino said) without also changing how we generate the header links.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @marocchino and @zpao for the details! I will remove this change here and keep it for another pull request once we know better solution.

@marocchino
Copy link
Contributor

🙆‍♀️

@claudiopro
Copy link
Contributor

@hejld you should be all set!

@hejld
Copy link
Contributor Author

hejld commented Nov 22, 2015

Awesome, thanks @claudiopro!

@hejld hejld force-pushed the add-selection-and-composition-events-on-reference-page branch from 8644723 to 1c20cea Compare November 22, 2015 12:24
@facebook-github-bot
Copy link

@hejld updated the pull request.

@hejld hejld changed the title Add missing sections to events reference page in IT and CN [docs] Add missing sections to events reference page in IT and CN Nov 22, 2015
@claudiopro
Copy link
Contributor

np at all 👍

@hejld hejld force-pushed the add-selection-and-composition-events-on-reference-page branch from 1c20cea to 18a3a39 Compare November 24, 2015 14:57
@facebook-github-bot
Copy link

@hejld updated the pull request.

@zpao
Copy link
Member

zpao commented Nov 24, 2015

Thanks!

zpao added a commit that referenced this pull request Nov 24, 2015
…nts-on-reference-page

[docs] Add missing sections to events reference page in IT and CN
@zpao zpao merged commit 54e6057 into facebook:master Nov 24, 2015
zpao added a commit that referenced this pull request Dec 1, 2015
…nts-on-reference-page

[docs] Add missing sections to events reference page in IT and CN
(cherry picked from commit 54e6057)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants