Repository navigation
Вычитка #288
Description
Перед тем, как показывать новый учебник людям, его нужно вычитать.
Даже после хорошего перевода бывают предложения, написанные не совсем по-русски, непонятные объяснения и т.п.
Чтобы это отловить, достаточно прочитать русский текст свежим взглядом.
Можно сделать это локально, установив сервер https://github.com/javascript-tutorial/server.
Если что не так - PR. Я сам помечу статью галочкой после вычитки.
Спасибо!
The JavaScript language
An introduction
JavaScript Fundamentals
- Hello, world!
- Code structure
- The modern mode, "use strict"
- Variables
- Data types
- Type Conversions
- Operators
- Comparisons
- Interaction: alert, prompt, confirm
- Conditional operators: if, '?'
- Logical operators
- Loops: while and for
- The "switch" statement
- Functions
- Function expressions and arrows
- JavaScript specials
Code quality
Objects: the basics
- Objects
- Garbage collection
- Symbol type
- Object methods, "this"
- Object to primitive conversion
- Constructor, operator "new"
Data types
- Methods of primitives
- Numbers
- Strings
- Arrays
- Array methods
- Iterables
- Map and Set
- WeakMap and WeakSet
- Object.keys, values, entries
- Destructuring assignment
- Date and time
- JSON methods, toJSON
Advanced working with functions
- Recursion and stack
- Rest parameters and spread operator
- Closure
- The old "var"
- Global object
- Function object, NFE
- The "new Function" syntax
- Scheduling: setTimeout and setInterval
- Decorators and forwarding, call/apply
- Function binding
- Arrow functions revisited
Object properties configuration
Prototypes, inheritance
Classes
- Class basic syntax
- Class inheritance
- Static properties and methods
- Private and protected properties and methods
- Extending built-in classes
- Class checking: "instanceof"
- Mixins
Error handling
Promises, async/await
- Introduction: callbacks
- Promise
- Promises chaining
- Error handling with promises
- Promise API
- Promisification
- Microtasks
- Async/await
Generators, advanced iteration
Modules
Miscellaneous
Browser: Document, Events, Interfaces
Document
- Browser environment, specs
- DOM tree
- Walking the DOM
- Searching: getElement*, querySelector*
- Node properties: type, tag and contents
- Attributes and properties
- Modifying the document
- Styles and classes
- Element size and scrolling
- Window sizes and scrolling
- Coordinates
Introduction to Events
- Introduction to browser events
- Bubbling and capturing
- Event delegation
- Browser default actions
- Dispatching custom events
UI Events
- Mouse events basics
- Moving: mouseover/out, mouseenter/leave
- Drag'n'Drop with mouse events
- Keyboard: keydown and keyup
- Scrolling
Forms, controls
- Form properties and methods
- Focusing: focus/blur
- Events: change, input, cut, copy, paste
- Forms: event and method submit
Document and resource loading
- Page: DOMContentLoaded, load, beforeunload, unload
- Scripts: async, defer
- Resource loading: onload and onerror
Miscellaneous
Frames and windows
Binary data, files
Network requests
- Fetch
- FormData
- Fetch: Download progress
- Fetch: Abort
- Fetch: Cross-Origin Requests
- Fetch API
- URL objects
- XMLHttpRequest
- Resumable file upload
- Long polling
- WebSocket
- Server Sent Events
Storing data in the browser
Animation
Web components
- From the orbital height
- Custom elements
- Shadow DOM and events
- Template element
- Shadow DOM slots, composition
- Shadow DOM styling
- Shadow DOM and events
Regular expressions
- Patterns and flags
- Methods of RegExp and String
- Character classes
- Escaping, special characters
- Sets and ranges [...]
- Quantifiers +, *, ? and {n}
- Greedy and lazy quantifiers
- Capturing groups
- Backreferences in pattern: \n and \k
- Alternation (OR) |
- String start ^ and finish $
- Multiline mode, flag "m"
- Lookahead and lookbehind
- Infinite backtracking problem
- Unicode: flag "u"
- Unicode character properties \p
- Sticky flag "y", searching at position
Metadata
Metadata
Assignees
Labels
No labels
Activity
iliakan commentedon Jul 6, 2019
@javascript-tutorial/translate-ru почитайте, что получилось, пожалуйста.
oshliaer commentedon Jul 9, 2019
На вычитке.
iliakan commentedon Jul 25, 2019
@javascript-tutorial/translate-ru up =)
xcurveballx commentedon Jul 25, 2019
@iliakan По вопросу вычитки я думаю так: вычитывать стоит дать или проф. редактору с целью исправления каких-то неточностей/ошибок на проф. уровне или вычитывать следует автору с целью проверить, всё ли так в плане единого авторского стиля и фактического изложения материала.
Предлагать вычитывать всем желающим мне кажется контрпродуктивным, так как у всех разное мышление, разные привычные фразы (многие из других стран вообще) и технический кругозор, не говоря уже о грамотности.
Как вариант, поскольку так или иначе все главы были прочитаны во время перевода и ревью, то можно считать учебник готовым, а дальнейшие правки/улучшения производить ориентируясь на комментарии читателей - кому что непонятно, кто где ошибку заметит и т.д. Как-то так.
iliakan commentedon Jul 25, 2019
Автор уже проверил =), но любой перевод нуждается в шлифовке, при чтении на свежую голову корявые обороты и тавтологии становятся видны.
iliakan commentedon Jul 26, 2019
Читаю вот и вижу, где-то фразы недопереведены, где-то оборот не по-русски звучит.
iliakan commentedon Jul 26, 2019
@javascript-tutorial/translate-ru Может кто-то поучаствовать в вычитке? Внимательно прочитать текст, где надо - улучшить фразы, иногда доперевести по мелочи.
Если возьмете какой-то раздел из первых - напишите, я тогда более сложные вещи буду читать.
xcurveballx commentedon Jul 26, 2019
@iliakan могу взять раздел Objects: the basics
iliakan commentedon Jul 28, 2019
@aruseni у вас были очень дельные комментарии по строкам, может быть, вы сможете поучаствовать в вычитке?
Кстати, я сделал механизм перевода картинок (замены фраз в SVG), там местами есть несоответствие текста переведённого тому, что в иллюстрациях.
Можно либо вернуть в тексте англ, либо в картинках перевести (см файл images.yml в корне)
iliakan commentedon Jul 28, 2019
@xcurveballx вычитал =) Может, регэкспы (если в них разбираешься хорошо)? или Animation?
aruseni commentedon Jul 28, 2019
@iliakan Спасибо!
Беру Scrolling.
iliakan commentedon Jul 30, 2019
Картинки я вроде перевёл )
iliakan commentedon Aug 2, 2019
В переводах много ошибок. Вычитывать необходимо.
oshliaer commentedon Aug 2, 2019
Как отправлять PR? На каждую ошибку?
iliakan commentedon Aug 2, 2019
На статью. Потом я здесь помечу.
oshliaer commentedon Aug 12, 2019
@iliakan , зацени #446, пожалуйста. Или надо искать только грубые нарушения текста?
xcurveballx commentedon Aug 17, 2019
@iliakan При попытке открыть по ссылке статью про карринг (напрямую или из содержания в закрепе) - https://github.com/javascript-tutorial/ru.javascript.info/blob/master/1-js/06-advanced-functions/11-currying-partials открывается страница 404. Что-то не так с ссылкой или изменилась структура учебника?
oshliaer commentedon Aug 18, 2019
@xcurveballx, переименовано без изменений ce7a22a
iliakan commentedon Aug 18, 2019
@xcurveballx да, переименовал, я с сайта всё читаю, поэтому не заметил. Убрал.
oshliaer commentedon Aug 18, 2019
@iliakan , я читаю с локального сервера только
master. Это же верный путь?iliakan commentedon Aug 18, 2019
в смысле ветка? ветка master - да, верная.
xcurveballx commentedon Sep 1, 2019
@iliakan в разделе Data types последние несколько статей не открываются по ссылке - 404.
iliakan commentedon Sep 1, 2019
@xcurveballx Там статья map/set/weakmap/weakset была разделена на две. Обновил список, сейчас должно быть ок.
iliakan commentedon Sep 2, 2019
Обновлён раздел "регулярные выражения". Сами темы не поменялись, скорее большой рефакторинг, чтобы сделать всё проще и понятнее. Просьба прочитать, написать если что-то не так.