[Creat0R]

Пример постинга текущей работы:

Работаю над...

Код:

index.htm
AutoIt.htm
macros.htm

P.S
Может завести аккаунт на code.google? Там будет проще оставлять и собирать файлы, а также постить тикеты по неисправностям и недочётам...

могут встретиься повторы »

До конца шапку прочитай...

[proxy]

Может завести аккаунт на code.goole? Там будет проще оставлять и собирать файлы, а также постить тикеты по неисправностям и недочётам... »

Думаю, конечно нужно. Вопрос на сколько это будет удобно - постить там или тут. Но не попробовав - не узнаешь ))
но там, как минимум можно постить готовые варианты, для всеобщего доступа.

sourceforge.net ?

[Vadikan]

Вы хорошее дело затеяли. Позволю себе дать несколько советов и предложить посильную помощь от ресурса

Как распаковать CHM вы уже разобрались, но все-таки скажу, что это легко делает HTML Help Workshop. В нем же потом лучше собирать справку. Дополнительная информация тут: Как создать CHM файл (HTM2CHM и HTML Help Workshop в действии). Никакими Help&Manual пользоваться не стоит - эти программы вносят свои изменения в код и стили.

В идеале правку HTML страниц нужно делать в текстовом редакторе - том же SciTe, хотя я не знаю, можно ли подключить к нему проверку русской орфографии (это важный момент!). Все визуальные редакторы вносят свои косяки в код. Сам я пользуюсь Kompozer (к нему проверку орфографии можно подключить, могу дать словарь), но он тоже форматирует код по своему. Хотя на отображение HTML страниц это особо не влияет, косяки могут проявлятся при использовании тегов pre, например. Не исключаю, что вы столкнетесь с чем-то подобным, поскольку в справке много кода.

Очевидно, с нуля справку переводить не нужно, поскольку русская уже есть для версии 3.2.5.4 http://www.autoitscript.com/autoit3/docs.shtml Т.е. нужно править только новые/изменившиеся статьи. Вам обязательно нужно выйти на контакт с Валерием Ивановым, поскольку он имеет опыт создания справки - у него есть наработки, наверняка. К тому же он, судя по форуму собирается работать над переводом. Его нужно подключить к работе в нашей команде, если он согласится.

Для размещения файлов я могу предложить место на нашем FTP. В принципе, при работе над документацией нужно использовать SVN (subversion), но у нас на данный момент такой возможности нет. Ссылки на отдельные файлы можно будет публиковать без проблем.

Для отслеживания багов у нас поднят Mantis, к которому я могу дать доступ участникам проекта, если вам нужно. Туда, в принципе, тоже можно прикреплять файлы.

[proxy]

Как распаковать CHM вы уже разобрались, но все-таки скажу, что это легко делает HTML Help Workshop. В нем же потом лучше собирать справку. Дополнительная информация тут: Как создать CHM файл (HTM2CHM и HTML Help Workshop в действии). Никакими Help&Manual пользоваться не стоит - эти программы вносят свои изменения в код и стили. В идеале правку HTML страниц нужно делать в текстовом редакторе - том же SciTe, хотя я не знаю, можно ли подключить к нему проверку русской орфографии (это важный момент!). Все визуальные редакторы вносят свои косяки в код. Сам я пользуюсь Kompozer (к нему проверку орфографии можно подключить, могу дать словарь), но он тоже форматирует код по своему. Хотя на отображение HTML страниц это особо не влияет, косяки могут проявлятся при использовании тегов pre, например. Не исключаю, что вы столкнетесь с чем-то подобным, поскольку в справке много кода. »

Creat0R, думаю, было бы не плохо протестировать и определиться с "инструментами", с помощью которых, и именно только ими, редактировать английский вариант документации, переводя его на русский. И далее, как будут известны конкретные программы/версии, выложить архивчик, что будет как бы SDK для перевода. Таким образом сразу избавимся от проблем с кривыми html. Сегодня и сам займусь тестами программ.

Очевидно, с нуля справку переводить не нужно, поскольку русская уже есть для версии 3.2.5.4 http://www.autoitscript.com/autoit3/docs.shtml Т.е. нужно править только новые/изменившиеся статьи. »

Это конечно логично. Но имхо, надо все таки брать оригинал и проверять - все ли совпадает с уже существующим его переводом. Так как бывают небольшие дополнения/изминения в английской версии, где более 90% статьи уже переведенно.

Его нужно подключить к работе в нашей команде, если он согласится. »

Верно. Кто займеться общением с Велерой? ....что бы не стучались к нему по 40 людей одновременно ))

Для размещения файлов я могу предложить место на нашем FTP. »

Думаю нам пригадиться.

Для отслеживания багов у нас поднят Mantis »

А вот это еще лучший вариант, это уж точно будет полезно.

[Vadikan]

Но имхо, надо все таки брать оригинал и проверять - все ли совпадает с уже существующим его переводом. Так как бывают небольшие дополнения/изминения в английской версии, где более 90% статьи уже переведенно. »

Конечно, нужно сверять, но это лучше, чем переводить с нуля. Я сказал об этом потому, что никто в теме не упомянул существующую справку.

Mantis » А вот это еще лучший вариант, это уж точно будет полезно »

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

[proxy]

Конечно, нужно сверять, но это лучше, чем переводить с нуля. »

Да, да, именно об этом и говорил ))

Я сказал об этом потому, что никто в теме не упомянул существующую справку. »

ну как же:

2.1. опубликовать названия (страницы, номера, или индетификаторы) страниц/статей, которые необходимо перевести: новых статей (которыйх нет в русской справке) и старых статей (которые есть в русской, но их необходимо исправить), »

Честно говоря, я не знаю, как вы его будете использовать для данной цели. Разве что для каждой статьи (страницы) заводить баг и обсуждать все это в Мантисе. В принципе, это возможно - там почтовые уведомления ходят. »

В принципе именно это и планируется, т.е. я об этом думаю, так как для каждой переведенной страницы будет вердикт Creat0R-а, что исправить, и соответственно дальнейшие обсуждения с автором перевода, или же сразу - все ок.
Аналог: для каждой переведенной страницы создовать новую тему на форуме, что бы обсудить "судьбу" результата. Конечно можно и в одной теме все страницы обсуждать, но думаю, будет каша. Сам с Мантисом не знаком, но то, что понял из описания, как раз напомнило то, что ты написал (цитата что выше).

[Medic84]

Я думаю может Creat0R, распределит всем кому что переводить? Или не пойдет?

Кстати Vadikan, можешь дать словарь к kompozer'у?

[proxy]

Я думаю может Creat0R, распределит всем кому что переводить? Или не пойдет? »

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

Кстати Vadikan, можешь дать словарь к kompozer'у? »

[Medic84]

Работаю над...

Код:

intro/installdir.htm

Пока взял это т.к. времени не оч много

[Creat0R]

В идеале правку HTML страниц нужно делать в текстовом редакторе »

Но это же не удобно... у меня есть Pspad, он умеет проверять орфографию, но переводить строчки среди тегов ужасно неудобно...

с нуля справку переводить не нужно »

Да да, я позже выложу в шапку список страниц, которые вовсе трогать не нужно, из перевести две секунды (взять значения из старой справки).

Вам обязательно нужно выйти на контакт с Валерием Ивановым, поскольку он имеет опыт создания справки - у него есть наработки, наверняка. »

Написал ему на офф. сайте в ПМ

судя по форуму собирается работать над переводом »

Я не уверен, имя Valery в посте Jon'а там уже с «Jun 2 2008, 09:25 PM»

Для размещения файлов я могу предложить место на нашем FTP »

О, это было бы неплохо, чтобы все именно туда и кидали готовые странички, а потом их можно будет собрать без проблем.

может Creat0R, распределит всем кому что переводить? »

Нет. Сами выбирайте, то что не занято конечно