На вашем родном языке

Коротко о главном

Если вы открыли эту документацию, увидели её на языке, на котором действительно читаете, — а не на том, который просто способны разобрать, — и вашим первым порывом было взглянуть ещё раз, может быть, прочесть пару фраз, чтобы проверить, звучат ли они естественно, значит, мы уже понимаем друг друга. Вот этот взгляд во второй раз — и есть вся причина, по которой существует эта страница. И если прямо сейчас вы читаете это не на английском, а на другом языке — это ровно то, на что мы и надеялись.

Пространство между «понимать» и «любить»

Язык, на котором говорят о проектировании программ, — английский, и для большинства инженеров руководство на английском — самая обычная вещь на свете. С парой-тройкой инструментов с этим вполне можно жить. Но если английский вам не родной, вам знакомо чувство, что между вами и страницей всё-таки что-то стоит — тонкая, непрекращающаяся прослойка перевода, которую вы прокручиваете в голове, пока читаете справочник, и снова — пока пишете своё.

Мы знаем это, потому что это и про нас тоже. Мы инженеры, для которых английский не родной; мы годами читали руководства на английском и писали документацию и код по-английски. Поэтому мы острее многих чувствуем разницу между статьёй, которую вы просто читаете, и той, которую приходится понимать с усилием. И та и другая оставят вас при знании. Но только одна — со спокойной душой. Понимать что-то и получать от этого удовольствие — не одно и то же, и именно об этой разнице весь наш труд.

Почему восемнадцать языков

Когда вы пролистываете список языков и насчитываете под два десятка строк — и не все из них самые распространённые в мире, — это не случайность и не галочка для галочки. Они здесь, потому что мы хотим, чтобы вам это нравилось: и сам продукт, и то, вокруг чего он построен. PDF — это система, основанная на правилах: переносимый формат документов, заданный — вплоть до объектной модели и синтаксиса — формальным стандартом (ISO 32000-2). Нас это тихо завораживает, и нам хотелось бы, чтобы завораживало и вас.

Вот почему часть этих статей читается не как сухой справочник, а скорее как понятный рассказ о том, как PDF на самом деле устроен. И если какая-то из них объясняет вам то, о чём вы никогда не слышали, — ни секунды не переживайте. Дело не только в вас. Пока мы сами не сели и не прочитали ISO 32000-2, мы тоже этого не знали. Страница, которая учит вас чему-то новому об этом формате, на языке, в котором можно расслабиться, — это страница, которая делает свою работу.

Особенно для Юго-Восточной Азии

Крупные мировые языки были само собой разумеющимся. А вот что мы добавили намеренно — это языки Юго-Восточной Азии: индонезийский, тайский и вьетнамский. У Европы, Америки и Северо-Восточной Азии давняя, глубокая культура разработки — и давно есть документация под стать ей. А у Юго-Восточной Азии — одно из самых быстрорастущих в мире сообществ разработчиков, и при этом первоклассная документация на родном языке всё ещё доходит туда в последнюю очередь. Нам не хотелось становиться ещё одним инструментом, для которого она — что-то второстепенное.

И кем бы вы ни были — студентом, начинающим инженером на первом настоящем проекте, независимым разработчиком, командой, встраивающей PDF в свой стек, — мы хотим для вас одного и того же: простой радости от того, что делаешь что-то работающее, и тех небольших, настоящих удовольствий, которые получаешь, только когда понимаешь, что делаешь, прямо в процессе. Полюбить ремесло проще, когда руководство не становится ещё и преградой.

Чего это нам на самом деле стоит

Всё это не бесплатно, и мы не станем делать вид, что это иначе. Даже с опорой на машинный перевод каждый новый язык — это большие и непрерывные затраты на сопровождение, а машинный черновик — лишь стартовая черта. Пройти путь от «слова переведены» до «статья по-настоящему понятна и читается естественно для того, кто думает на этом языке» — это трудная, живая человеческая работа, и в неё мы вкладываем немало сил. К хорошей документации предъявляется планка качества, которая включает понятность для её настоящего читателя (ISO/IEC/IEEE 26514); и для нас эта планка не опускается лишь оттого, что у читателя сменился язык.

Поэтому, когда перевод удаётся, пожалуйста, воспринимайте его так, как он и задуман: не как удобную опцию, а как маленький знак заботы от одной группы инженеров к другой.

Слово тому, кто это читает

Будем честны: на восемнадцати языках не каждая фраза окажется безупречной, и какие-то страницы доходят до одних языков раньше, чем до других. Если какой-то абзац звучит на вашем языке неуклюже или неверно — скажите нам: мы относимся к дефекту в документации так же, как к любому другому инженерному дефекту, а не как к косметической мелочи. Именно так она становится лучше.

А больше всего нам хочется, чтобы вы читали это на том языке, на котором думаете, и чтобы где-то здесь PDF понравился вам чуть больше, чем вы ожидали, а создавать вещи стало чуть приятнее, чем было сегодня утром. Если это ваша первая серьёзная встреча с PDF — или с PHP, — добро пожаловать. Мы начинали ровно там же, где сейчас вы: с любопытством, чуть в стороне от англоязычного центра тяжести, и радовались, когда наконец находили руководство, которое будто разговаривало с нами. Это мы и написали так, чтобы оно могло говорить с вами.

Связанные материалы

• Документация как продукт — дисциплина качества, стоящая за этой документацией, и локализация — её часть.
• Компания за NextPDF — кто мы и почему коммерческий продукт стал open core.
• Open core, без привязки к поставщику — лицензионная модель, которая позволяет нам и дальше вкладываться в такую работу.