Разработка технической документации и технические писатели Технические писатели и разработка технической документации технические писатели в Телеграм 

 obmen_soobsheniyami.png Чат для технических писателей 
 Зарегистрируйтесь
Страницы: 1 2 След.
RSS
Кто займется переводом документации по DITA?
 
Товарищи! Друзья! Коллеги! Может организуемся и переведем документацию по Dita-технологии? Без русского языка это все нереально сложно((
Быть или не быть?
 
Без английского языка (хотябы умения читать) заниматься IT (да и другими областями например телеком) вообще не рекомендуется.
Если собираетесь стать специалистом, то необходимо начинать изучать.
Можно конечно дожидаться пока другие переведут, но IT это быстроменяющаяся область и английский здесь язык дефакто.
Что касается перевода то как в любом деле на это нужны ресурсы - время, люди, деньги...
 
Вот я тоже работаю в IT с английским языком неважно(( трудностей миллион по этому поводу, изучать действительно надо, вот Вы сами Сергей начните переводить и выучите, заодно и другим поможете. :)
Хочу все знать!
 
Цитата
Без английского языка (хотябы умения читать) заниматься IT (да и другими областями например телеком) вообще не рекоментуется.
Да..начинаю это понимать :( . Учить надо бесспорно, но и почитать охота) буду мучить переводчик))
Быть или не быть?
 
Можно использовать wiki для перевода, т.е каждый делает по мере возможностей перевод текста и выкладывает туда, но тут другой вопрос, будет ли кто-нибудь этим заниматься?
Работаю по-старинке...
 
Цитата
Можно использовать wiki для перевода, т.е каждый делает по мере возможностей перевод текста и выкладывает туда, но тут другой вопрос, будет ли кто-нибудь этим заниматься?

Собираюсь изучать DITA и могу поучаствовать в переводе документации по ней. Но если переводить коллективно, предавартельно нужно договриться о терминологии.
 
Да, я бы принял тоже участие в этом, кто еще?
Быть или не быть?
 
Цитата

Собираюсь изучать DITA и могу поучаствовать в переводе документации по ней. Но если переводить коллективно, предавартельно нужно договриться о терминологии.

Это не реально.
Практика переводов показала, что договориться можно только
по более-менее устоявшимся терминам.
По вновь вводимым терминам (понятиям)  адекватный перевод
становится возможным только  после перевода и понимания самого материала.
Кроме того, нужен еще литературный редактор, который приведет разнообразые стили изложения разных переводчиков к стандартному "научному" стилю.
 
Цитата

Это не реально.
Практика переводов показала, что договориться можно только
по более-менее устоявшимся терминам.
По вновь вводимым терминам (понятиям)  адекватный перевод
становится возможным только  после перевода и понимания самого материала.
Кроме того, нужен еще литературный редактор, который приведет разнообразые стили изложения разных переводчиков к стандартному "научному" стилю.

Все это так. Но и терминов не очень много, главное, не путаться в основных. Редактирование - второй этап, без выполненного перевода о нем и говорить рано. Так что это не препятствует начать работы по приближению DITA к русскоязычной аудитории. Кстати, переводчики оказываются в привилегированном положении, поскольку, переводя, они глубже знакомятся с техническими деталями и легко могут стать адептами DITA )))
 
я бы приняла участие, с чего можно начать?
Хочу все знать!
 
Добрый день. Я уже оставля ссылки на документацию по DITA.

Для начала что касается установки, настройки и азам работы советую почитать DITA for SOLO Writers
http://www.lone-dita.com/Portals/0/dita/ditaguide.pdf

Это позволит начать работу...

Что бы понять как размечать документацию (назначение элементови их атрибутов)
http://xml.coverpages.org/DITAv10-OS-La ... 050509.pdf

Впринципе для работы и этого достаточно.

Можно еще переводить ту доку которая идет в составе DITA Open Toolkit.
 
Вчера попробовал, а сегодня попробую начать переводить на wiki http://wiki.techwriters.ru/index.php?ti ... D1%8F:DITA, если что поправляйте. Мне кажется дита это вынос мозга уже))
Быть или не быть?
 
А какова цель перевода? Там же десятки тысяч страниц. Мне кажется, достаточно описать как ее устанавливать и настраивать по минимуму для работы с кириллицей. Ну еще можно описать основы для работы с PDF и CHM. Именно этим пытаюсь заняться уже пару недель. Создал группу на Facebook для русскоязычных пользователей Dita, хочу выкладывать инфу там.
 
Цитата
Создал группу на Facebook для русскоязычных пользователей Dita, хочу выкладывать инфу там.
А почему бы не сделать здесь? Я могу сделать отдельный раздел под это дело, если Вам это будет интересно. На Facebook не все зарегистрированны(.
 
Цитата
А почему бы не сделать здесь? Я могу сделать отдельный раздел под это дело
Да можно и здесь... Только, сами понимаете, - нужно время. Работа с Dita уже стала моим хобби, но и основной работы выше крыши.. Описание может растянуться на долго.
Создавайте раздел ;-)
 
Цитата
Работа с Dita уже стала моим хобби, ...

Автор, по простоте душевной, назвал  истинную причину того, почему DITA у нас не "бороздит космические дали" - технология  не востребована в реальной жизни, на практическом уровне,  остановилась на уровне хобби (типа ловля бабочек, коллекционирование винных этикеток и т. п.,  т. е. воспринимается как нечто несерьезное, как модное увлечение, которое со временем пройдет и на смену ему придет другое).
 
Цитата

Автор, по простоте душевной, назвал  истинную причину того, почему DITA у нас не "бороздит космические дали" - технология  не востребована в реальной жизни, на практическом уровне,  остановилась на уровне хобби (типа ловля бабочек, коллекционирование винных этикеток и т. п.,  т. е. воспринимается как нечто несерьезное, как модное увлечение, которое со временем пройдет и на смену ему придет другое).

Нет, немного не так. Технология востребована очень даже. Технология используется компаниями для подготовки документации в разных форматах.
Я же назвал ее своим хобби, потому что на работе засиживаюсь долго из за нее, прихожу домой  опять Dita, и днем и ночью форумы, переводчики, документация по XSL, ANT. Никто не понимает что это, а я ей постоянно занят. И мне интересно. Я помогаю ее настраивать другим людям бесплатно, хотя мог бы зарабатывать на этом, но мне это не надо, т.к., опять же, это мое увлечение, а не основной источник дохода. Мне нравится переписывать куски кода на свой лад.
Цитата

остановилась на уровне хобби.
АГА!  Когда технология изучена на достаточном для работы уровне, появляется желание что-то подкрутить и доработать. Узнать что-то новое, применить знания и помочь кому-то.
Только это не технология остановилась, а "автор" вырос профессионально ;-)
А у вас она не "бороздит", видимо потому, что "фирма заплатит за уже настроенный продукт, че заморачиваться" . :-)
 
Цитата

Технология используется компаниями для подготовки документации в разных форматах.

Утверждая это,  вы, мягко говоря, вводите своих клиентов в заблуждение.
Чтобы готовить документацию из единого источника в разные  форматы, есть много  других, гораздо более простых решений (как я уже писал, используя бесплатный  Eclipse я получю документацию в 5 форматах).  
Технология DITA  нужна для совсем других целей.

Цитата

А у вас она не "бороздит", видимо потому, что "фирма заплатит за уже настроенный продукт, че заморачиваться" . :-)

У каждой затеи (в том числе и с DITA) должна быть экономическая целессобразность
(если, конечно, речь идет о собственных деньгах, а не деньгах клиентов),  или,
говоря "научно",  технико-экономическое обоснование.  
Пока таких расчетов я не встречал ( если вы проводили их для ваших  клиентов,  покажите нам).
Например.
Покупка DITA  - X руб.
Освоение (скажем, в течение  У мес.  N  работниками  при их среднй зарплате S руб.)
Итого разовые затраты:  X + Y*N*S руб.
Выгода:
-либо сокращение количества работников для подготовки документации (уменьшение трудозатат)  - экономия на зарплате  - (особенно учитывая, что теперь это не простые специалисты, а крутые (ADVANCED);  
- либо сокращение сроков разработки документации и, соответственно,  возможность  выполнять  больше  заказов (увеличение объемов).
Чтобы было понятнее, воспользуюсь  приемом В. И.  Чапаева ("метод 3-картошек").
Допустим, а занимаюсь копанием ям  размером 2x2 м (ну, например,  на кладбише) и пользуюсь  для этого лопатой.
В день,  в среднем, копаю две ямы.
Приходит некто  и говорит "Давайте, вы купите экскаватор".
Я начинаю думать о выгодности это предлжения:
- яма будет выкопана за полчаса- очень хорошо.

Но:
- надо купить экскаватор (немалая сумма);
- научится на нем ездить и копать и обслуживать его (ремонт, горючее);
- если  я выкопаю с помощью экскаватора 2 ямы за час, то что он будет делать остальное время (т. е. будет простаивать и не оправдывать понесенных затрат?)

Отсюда выводы:
1 если мне надо ежедневно копать 2 ямы,  я воспользуюсь лопатой;
2 и только  в том случае,  если надо ежедневно рыть многокилометровые траншеи, я куплю экскаватор.
C DITA  ситуация аналогична.
 
Так кто займется переводом документации по DITA? :-)
 
Цитата
как я уже писал, используя бесплатный  Eclipse я получю документацию в 5 форматах.  
Технология DITA  нужна для совсем других целей.
Чего лезть в тему перевода доки по Dita со своим эклипсом ? Скорее на уровень выше нужно..
Цитата

У каждой затеи (в том числе и с DITA) должна быть экономическая целессобразность
(если, конечно, речь идет о собственных деньгах, а не деньгах клиентов),  или,
говоря "научно",  технико-экономическое обоснование.  
Вот один из примеров затрат на обучение технологии http://www.suite-sol.com/pages/services/dita_qs_ws_nc_october_2010.html

Цитата
Цитата
Создал группу на Facebook для русскоязычных пользователей Dita, хочу выкладывать инфу там.
А почему бы не сделать здесь? Я могу сделать отдельный раздел под это дело, если Вам это будет интересно. На Facebook не все зарегистрированны(.
Мне интересно предоставить информацию из СВОЕГО ЛИЧНОГО опыта, ПОДЕЛИТЬСЯ знаниями, которые получил, а не продавать их, помочь кому-либо в освоении не простой технологии. Доказывать, что экскаватор лучше лопаты или что-то обосновывать - некогда. Для этого есть куча других форумов.
 
Цитата

Вот один из примеров затрат на обучение технологии http://www.suite-sol.com/pages/services/dita_qs_ws_nc_october_2010.html

Это одна из статей затрат (без стоимости пробретения самой DITA).
$1200 за трехдневный курс (я так понимаю, теоретический курс).
Научиться за  3 дня  устанавливать, настраивать и реально начать использовать DITA
без практики работы с ней так же реально,  как научиться играть на рояле, изучив его конструкцию и нотную грамоту.  
О предполагаемой выгоде (прибыли )  от внедрения DITA - ни слова (а именно это самое важное).


PS   На этом  прекращаю дискуссию о DITA.
В каком-то смысле  прав ADVANCED (он же Teux), что DITA  “бороздит космические просторы”. Если следовать его  аллегории, DITA – космический корабль, используемый для передвижения  в определенной среде. Но, как известно,  космических кораблей (то бишь DITA) требуется не много (очень ограниченное количество).  В основном население для передвижения использует более дешевые и практичные средства – машины, поезда, самолеты.
 
Цитата
Так кто займется переводом документации по DITA?

Не нужно этого. Там и так все понятно. Нужен ресурс, на котором бы публиковались статьи на злободневные темы. Одна из них - установка DITA-OT. Хотя я бы расширил эту тему, назвав "Настройка среды конвертации".

Но что пользы, если я или вы опишем свои решения, а в глубоко закопанной ветке их никто не найдет?

Могу поделиться конкретными файлами, конфигурационными параметрами. На их основе можно создавать нормальные PDF с помощью FOP. Но хочется, чтобы это было в каком-то постоянном месте, которое посвящено DITA.

Тормозит организационный вопрос, а полезная информация и опыт успешных внедрений есть.
 
Цитата
Нужен ресурс, на котором бы публиковались статьи на злободневные темы. Одна из них - установка DITA-OT. Хотя я бы расширил эту тему, назвав "Настройка среды конвертации".
Цитата
Но что пользы, если я или вы опишем свои решения, а в глубоко закопанной ветке их никто не найдет?
Коллеги, я повторю, но все можно сделать здесь. Готов создать или отдельный подфорум на который будет ссылка с главной страницы форума (тема не затеряется). Дополнительно, можно создать раздел для статей на сайте. Готов обсудить ваши предложения, т.к считаю что технология Dita будет интересна многим, сам в свое время искал по ней документацию на русском и оказалось что ее нет совсем, так же на этом форуме можно организовать и помощь новичкам в настройке Dita.
 
Цитата
Коллеги, я повторю, но все можно сделать здесь.

Если возможно, заведите ветку "DITA" на верхнем уровне форума. Через некоторое время кину в нее ссылку на контрольный пример настройки и конвертации в PDF (с собственными шаблонами). В качестве исходников возьму тот же "гараж" из DITA-OT.


Цитата
В каком-то смысле  прав ADVANCED (он же Teux), что DITA  “бороздит космические просторы”.

У вас, дорогой коллега, от жары и пожаров обострилась мнительность? Это скоро пройдет.
Мне не нужно шифроваться, чтобы еще раз услышать ваше мнение о DITA  :lol:

Вы же сами, как утверждаете, используете XML-технологию, хотя и не отличаете Eclipse от DocBook.
Что ж вы так на DITA ополчились? Это точно такая же XML-технология, но в отличии от уходящего в историю DocBook, DITA завоевывает будущее. Дороговизна внедрения связана исключительно с недостатком информации. Как только многие освоят DITA, критическая масса накопленных знаний в профессиональной среде пробьет барьер дороговизны.

Притом я не спорю, что не всем нужна DITA, поскольку не всем нужны XML-технологии. Ее применение оправдано в следующих случаях:

- ведется коллективная работа над документами;
- документация хранится в системе контроля версий, где отлеживаются даты и авторы всех изменений;
- документы имеют модульную структуру и обеспечивается повторное использование материала;
- применяются специализированные разделы с новыми элементами (которых нет в DITA);
- требуется переводить документацию на разные языки с использованием Translation Memory;
- документация выводится в разные форматы - PDF, CHM, web help;
- для владеющих XSLT дается полный контроль над форматом выводимых документов, при этом применяется унифицированный и очень мощный препроцессинг DITA-OT;
- вывод автоматизирован и во время конвертации подверстывается дополнительная информация из файлов или базы данных.

Скажите, какая настольная издательская система может выполнять все эти задачи и является бесплатной?
Если же ваши потребности не выходят за рамки MS Word, то используйте его. Никто косо не посмотрит, ибо эффективность на первом месте.

Цитата
PS   На этом  прекращаю дискуссию о DITA.
На моей памяти это уже второй раз. А вы актер, коллега, хороший актер!
 
Цитата
А вы актер, коллега, хороший актер!


Бурные овации, переходящие в буфет.
Страницы: 1 2 След.
Читают тему