|
1 | | -# The JavaScript Tutorial |
| 1 | +# The Modern JavaScript Tutorial in Turkish |
2 | 2 |
|
3 | | -This repository hosts the content of the Modern JavaScript Tutorial, published at [https://javascript.info](https://javascript.info). |
| 3 | +This repository hosts the translation of <https://javascript.info> in Turkish. |
4 | 4 |
|
5 | | -## Translations |
| 5 | +Please help us to make the translation better. |
6 | 6 |
|
7 | | -We'd like to make the tutorial available in many languages. Please help us to translate. |
| 7 | +- See the [Turkish Translate Progress](https://github.com/javascript-tutorial/tr.javascript.info/issues/1) issue. |
| 8 | +- Choose an unchecked article you'd like to translate. |
| 9 | +- Add a comment to that issue to inform the maintainer that you're translating it. |
| 10 | +- Fork the repository, translate and send a PR when done. |
8 | 11 |
|
9 | | -Here's the list of existing ongoing translations (in alphabetical order): |
| 12 | +🎉 Thank you! |
10 | 13 |
|
11 | | -| Language | Github | Translation leads | Translated (%) | Last Commit | Published | |
12 | | -|----------|--------|-------------------|----------------|-------------|-----------| |
13 | | -| Azerbaijani | [orkhan-huseyn/javascript-tutorial-az](https://github.com/orkhan-huseyn/javascript-tutorial-az) | @orkhan-huseyn |  |  | | |
14 | | -| Chinese | [xitu/javascript-tutorial-zh](https://github.com/xitu/javascript-tutorial-zh) | @leviding |  |  | [zh.javascript.info](https://zh.javascript.info) | |
15 | | -| French | [HachemiH/javascript-tutorial-fr](https://github.com/HachemiH/javascript-tutorial-fr) | @HachemiH |  |  | | |
16 | | -| Japanese | [KenjiI/javascript-tutorial-ja](https://github.com/KenjiI/javascript-tutorial-ja) | @KenjiI |  |  | [ja.javascript.info](https://ja.javascript.info) | |
17 | | -| Korean | [Violet-Bora-Lee/javascript-tutorial-ko](https://github.com/Violet-Bora-Lee/javascript-tutorial-ko) | @Violet-Bora-Lee |  |  | | |
18 | | -| Persian (Farsi) | [mehradsadeghi/javascript-tutorial-fa](https://github.com/mehradsadeghi/javascript-tutorial-fa) | @mehradsadeghi | started |  | | |
19 | | -| Polish | [krzmaciek/javascript-tutorial-pl](https://github.com/krzmaciek/javascript-tutorial-pl) | @krzmaciek |  |  | | |
20 | | -| Romanian | [lighthousand/javascript-tutorial-ro](https://github.com/lighthousand/javascript-tutorial-ro) | @lighthousand |  |  | | |
21 | | -| Russian | [iliakan/javascript-tutorial-ru](https://github.com/iliakan/javascript-tutorial-ru) | @iliakan | * . |  | [learn.javascript.ru](https://learn.javascript.ru) | |
22 | | -| Turkish | [sahinyanlik/javascript-tutorial-tr](https://github.com/sahinyanlik/javascript-tutorial-tr) | @sahinyanlik |  |  | | |
| 14 | +Your name and the contribution size will appear in the "About project" page when the translation gets published. |
23 | 15 |
|
24 | | -`*` – the previous version is published in Russian, need to backport/translate the new one from English. |
| 16 | +P.S. The full list of languages can be found at <https://github.com/javascript-tutorial/translate>. |
25 | 17 |
|
26 | | -**If you'd like to translate it into your language:** |
| 18 | +## Structure |
27 | 19 |
|
28 | | -1. First, check if the translation has already started in the list above or in issues. If it exists, contact the original lead, ask him to join efforts. If the translation is stalled, ask him to transfer the repo to you or just create a new one and continue from where they stopped. |
29 | | -2. If there's no such translation, create a new one. Clone the repository, change its name to `javascript-tutorial-<lang>` (by your language) and [create an issue](https://github.com/iliakan/javascript-tutorial-en/issues/new) for me to add you to the list. |
| 20 | +Every chapter, an article or a task resides in its own folder. |
30 | 21 |
|
31 | | -**You can edit the text in any editor.** The tutorial uses enhanced "markdown" format, easy to grasp. And if you want to see how it looks on-site, there's a server to run the tutorial locally at <https://github.com/iliakan/javascript-tutorial-server>. |
| 22 | +The folder is named `N-url`, where `N` – is the number for sorting (articles are ordered), and `url` is the URL-slug on the site. |
32 | 23 |
|
33 | | -## Structure |
| 24 | +The folder has one of files: |
| 25 | + |
| 26 | +- `index.md` for a section, |
| 27 | +- `article.md` for an article, |
| 28 | +- `task.md` for a task formulation (+`solution.md` with the solution text if any). |
| 29 | + |
| 30 | +A file starts with the `# Title Header`, and then the text in Markdown-like format, editable in a simple text editor. |
| 31 | + |
| 32 | +Additional resources and examples for the article or the task, are also in the same folder. |
| 33 | + |
| 34 | +## Translation Tips |
| 35 | + |
| 36 | +The translation doesn't have to be word-by-word precise. It should be technically correct and explain well. |
| 37 | + |
| 38 | +If you see that the English version can be improved – great, please send a PR to it. |
| 39 | + |
| 40 | +### Text in Code Blocks |
| 41 | + |
| 42 | +- Translate comments. |
| 43 | +- Translate user-messages and example strings. |
| 44 | +- Don't translate variables, classes, identifiers. |
| 45 | +- Ensure that the code works after the translation :) |
| 46 | + |
| 47 | +Example: |
| 48 | + |
| 49 | +```js |
| 50 | +// Example |
| 51 | +const text = "Hello, world"; |
| 52 | +document.querySelector('.hello').innerHTML = text; |
| 53 | +``` |
| 54 | + |
| 55 | +✅ DO (translate comment): |
| 56 | + |
| 57 | +```js |
| 58 | +// Ejemplo |
| 59 | +const text = 'Hola mundo'; |
| 60 | +document.querySelector('.hello').innerHTML = text; |
| 61 | +``` |
| 62 | + |
| 63 | +❌ DON'T (translate class): |
| 64 | + |
| 65 | +```js |
| 66 | +// Ejemplo |
| 67 | +const text = 'Hola mundo'; |
| 68 | +// ".hello" is a class |
| 69 | +// DO NOT TRANSLATE |
| 70 | +document.querySelector('.hola').innerHTML = text; |
| 71 | +``` |
| 72 | + |
| 73 | +### External Links |
| 74 | + |
| 75 | +If an external link is to Wikipedia, e.g. `https://en.wikipedia.org/wiki/JavaScript`, and a version of that article exists in your language that is of decent quality, link to that version instead. |
| 76 | + |
| 77 | +Example: |
| 78 | + |
| 79 | +```md |
| 80 | +[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language. |
| 81 | +``` |
| 82 | + |
| 83 | +✅ OK (en -> es): |
| 84 | + |
| 85 | +```md |
| 86 | +[JavaScript](https://es.wikipedia.org/wiki/JavaScript) es un lenguaje de programación. |
| 87 | +``` |
| 88 | + |
| 89 | +For links to MDN, that are only partially translated, also use the language-specific version. |
34 | 90 |
|
35 | | -Every chapter, article or a task has its folder. |
| 91 | +If a linked article has no translated version, leave the link "as is". |
36 | 92 |
|
37 | | -The folder is named like `N-url`, where `N` is a number for the sorting purposes and `url` is the URL part with title of the material. |
38 | 93 |
|
39 | | -The type of the material is defined by the file inside the folder: |
| 94 | +## Running locally |
40 | 95 |
|
41 | | - - `index.md` stands for a chapter |
42 | | - - `article.md` stands for an article |
43 | | - - `task.md` stands for a task (solution must be provided in `solution.md` file aswell) |
| 96 | +You can run the tutorial locally, to immediately see the changes on-site. |
44 | 97 |
|
45 | | -Each of these files starts from the `# Main header`. |
| 98 | +The server is at <https://github.com/javascript-tutorial/server>. |
0 commit comments