|
3 | 3 | This repository hosts the translation of <https://javascript.info> in Danish.
|
4 | 4 |
|
5 | 5 |
|
| 6 | +**That's how you can contribute:** |
| 7 | + |
| 8 | +- See the [Danish Translate Progress](https://github.com/javascript-tutorial/da.javascript.info/issues/1) issue. |
| 9 | +- Choose an unchecked article you'd like to translate. |
| 10 | +- Add a comment with the article title to the issue, e.g. `An Introduction to JavaScript`. |
| 11 | + - Our bot will mark it in the issue, for everyone to know that you're translating it. |
| 12 | + - Your comment should contain only the title. |
| 13 | +- Fork the repository, translate and send a PR when done. |
| 14 | + - PR title should match article title, the bot will write it's number into the issue. |
| 15 | + |
| 16 | +Please kindly allow maintainers to review and merge or request changes in your translation. |
| 17 | + |
| 18 | +If maintainers do not respond, or if you'd like to become a maintainer, write us at the [main repo](https://github.com/javascript-tutorial/en.javascript.info/issues/new). |
| 19 | + |
| 20 | +**Let others know what you're translating, in message boards or chats in your language. Invite them to join!** |
| 21 | + |
| 22 | +🎉 Thank you! |
| 23 | + |
| 24 | +Your name and the contribution size will appear in the "About project" page when the translation gets published. |
| 25 | + |
| 26 | +P.S. The full list of languages can be found at <https://javascript.info/translate>. |
| 27 | + |
| 28 | +This repository hosts the translation of <https://javascript.info> in Danish. |
| 29 | + |
6 | 30 | **That's how you can contribute:**
|
7 | 31 |
|
8 | 32 | - See the [Danish Translate Progress](https://github.com/javascript-tutorial/da.javascript.info/issues/1) issue.
|
@@ -53,6 +77,69 @@ If you see that the English version can be improved – great, please send a PR
|
53 | 77 | - For other terms like `resolved promise`, `slash`, `regexp`, and so on - look for a glossary, hopefully there's one for your language already. If not, look for translations in manuals, such as [MDN](https://developer.mozilla.org/en-US/).
|
54 | 78 |
|
55 | 79 |
|
| 80 | +### Terms with meaning |
| 81 | + |
| 82 | +In English many terms have an obvious meaning. For a person who doesn't understand English, there's no such meaning. |
| 83 | + |
| 84 | +Please keep that in mind, sometimes explanations or additional translations are needed, e.g. |
| 85 | + |
| 86 | +```md |
| 87 | +`ReadableStream` objects allows to read data chunk-by-chunk. |
| 88 | +``` |
| 89 | + |
| 90 | +```md |
| 91 | +`ReadableStream` ("flujo legible") objeto ... |
| 92 | +``` |
| 93 | + |
| 94 | +### Text in Code Blocks |
| 95 | + |
| 96 | +- Translate comments. |
| 97 | +- Translate user-messages and example strings. |
| 98 | +- Don't translate variables, classes, identifiers. |
| 99 | +- Ensure that the code works after the translation :) |
| 100 | + |
| 101 | +Example: |
| 102 | + |
| 103 | +```js |
| 104 | +// Example |
| 105 | +const text = "Hello, world"; |
| 106 | +document.querySelector('.hello').innerHTML = text; |
| 107 | +``` |
| 108 | + |
| 109 | +✅ DO (translate comment): |
| 110 | + |
| 111 | +```js |
| 112 | +// Ejemplo |
| 113 | +const text = 'Hola mundo'; |
| 114 | +document.querySelector('.hello').innerHTML = text; |
| 115 | +``` |
| 116 | + |
| 117 | +Every chapter, an article or a task resides in its own folder. |
| 118 | + |
| 119 | +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. |
| 120 | + |
| 121 | +The folder has one of files: |
| 122 | + |
| 123 | +- `index.md` for a section, |
| 124 | +- `article.md` for an article, |
| 125 | +- `task.md` for a task formulation (+`solution.md` with the solution text if any). |
| 126 | + |
| 127 | +A file starts with the `# Title Header`, and then the text in Markdown-like format, editable in a simple text editor. |
| 128 | + |
| 129 | +Additional resources and examples for the article or the task, are also in the same folder. |
| 130 | + |
| 131 | +## Translation Tips |
| 132 | + |
| 133 | +Please keep line breaks and paragraphs "as is": don't add newlines and don't remove existing ones. Makes it easy to merge future changes from the English version into the translation. |
| 134 | + |
| 135 | +If you see that the English version can be improved – great, please send a PR to it. |
| 136 | + |
| 137 | +### Terms |
| 138 | + |
| 139 | +- Some specification terms are not to be translated, e.g. "Function Declaration" can be left "as is". |
| 140 | +- For other terms like `resolved promise`, `slash`, `regexp`, and so on - look for a glossary, hopefully there's one for your language already. If not, look for translations in manuals, such as [MDN](https://developer.mozilla.org/en-US/). |
| 141 | + |
| 142 | + |
56 | 143 | ### Terms with meaning
|
57 | 144 |
|
58 | 145 | In English many terms have an obvious meaning. For a person who doesn't understand English, there's no such meaning.
|
@@ -103,12 +190,11 @@ document.querySelector('.hola').innerHTML = text;
|
103 | 190 | Please note, that sometimes code is followed by pictures, and if you translate text `Hello` -> `Hola` in the code, you need to translate text in picturess as well.
|
104 | 191 |
|
105 | 192 | In that case it's probably easier not to translate such text. See more about translating images later.
|
106 |
| -======= |
| 193 | + |
107 | 194 | - `index.md` stands for a chapter
|
108 | 195 | - `article.md` stands for an article
|
109 | 196 | - `task.md` stands for a task (solution must be provided in `solution.md` file as well)
|
110 | 197 |
|
111 |
| - |
112 | 198 | ### External Links
|
113 | 199 |
|
114 | 200 | 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.
|
|
0 commit comments