Энциклопедия для Фар 3

Столкнулись с проблемой в использовании Far? Здесь можно получить помощь.
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Энциклопедия для Фар 3

Post by Skirda »

Есть желающие для выверки/правки/наполнения/уточнения/etc. Писания для Far 3.0?
Рабочая почти актуальная есть здесь https://farmanager.com/svn/trunk/enc/enc_rus3.work/
Вопрос состоит в том, чтобы заинтересованным лицам дать доступ на RW в enc_rus3.work.

Так же есть вот такая идея (может и глупая; обсуждаемо):
В одном месте вести и Rus и Eng версии.
Внутри каждого html абзацы задавать <div lang="ru"> или <div lang="en"> (или...), а скриптами потом "делить"...
We are the Borg. You will be assimilated.
So Say We All!
g_max
Posts: 88
Joined: Mon 20 Mar, 2006 15:19
Location: Винница

Re: Энциклопедия для Фар 3

Post by g_max »

По поводу локализации - если использовать спец. софт для переводов - удобнее, если разные языки в разных файлах.
User avatar
Tim Sobolev
Posts: 729
Joined: Fri 01 Apr, 2005 14:46
Location: Украина
Has thanked: 1 time
Been thanked: 7 times

Re: Энциклопедия для Фар 3

Post by Tim Sobolev »

Не помешало бы содержимое каталога enc_rus2 откатить до актуального для 1807 билда состояния, а то бардак :wink:
User avatar
Alexey Samlyukov
Posts: 1765
Joined: Tue 15 Mar, 2005 17:28
Been thanked: 7 times
Contact:

Re: Энциклопедия для Фар 3

Post by Alexey Samlyukov »

как я помню, в enc_rus2 только титульная страница правилась на фар3.
каталоги enc_rus и enc_rus2 скорее всего будут удалены, как это случилось уже с плагинами.
останется только enc_rus3
User avatar
Tim Sobolev
Posts: 729
Joined: Fri 01 Apr, 2005 14:46
Location: Украина
Has thanked: 1 time
Been thanked: 7 times

Re: Энциклопедия для Фар 3

Post by Tim Sobolev »

Каталоги можно удалить, если будет возможность получить в любой момент энциклопедию для требуемой версии.
User avatar
Alexey Samlyukov
Posts: 1765
Joined: Tue 15 Mar, 2005 17:28
Been thanked: 7 times
Contact:

Re: Энциклопедия для Фар 3

Post by Alexey Samlyukov »

тык, "своя" версия входит в "свой" дистрибутив.
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Re: Энциклопедия для Фар 3

Post by Skirda »

Снова о сабже... Помог бы кто...
Из очень насущного - файл pluginsr.hhc
Основное отличие от предыдущих версий: нет Экспортируемых, сервисных, структур, но есть (должно быть) разные АПИ (а внутри уже и эксп и сервисные и структуры и определения...)
We are the Borg. You will be assimilated.
So Say We All!
User avatar
techie
Posts: 795
Joined: Mon 03 Oct, 2005 22:42
Has thanked: 35 times
Been thanked: 6 times

Re: Энциклопедия для Фар 3

Post by techie »

Сложно помогать с toolchain на Perl. Для меня это основной затык. Для Python я бы что-нибудь придумал. Как вариант - API может генерится из pluginsr.hhc, например, с помощью toochain от PySide - но глубоко не исследовал. На худой конец есть Doxygen, но вывод обычно выглядит отстойно. В Python документация не в .HTML, а в .RST, каждая функция сопровождается комментом, в какой версии добавлена и пр. Синхронизации перевода нет. Для синхронизации надо вести версии каждого файла.
User avatar
HaRT
Moderator
Posts: 10863
Joined: Tue 30 Aug, 2005 17:21
Has thanked: 221 times
Been thanked: 358 times

Re: Энциклопедия для Фар 3

Post by HaRT »

techie
doxygen и подобные инструменты хороши тем, что документация не отрывается от документируемого кода, и у программиста наименьший шанс изменить API, но не обновить документацию. А внешний вид можно настраивать в широких пределах. То, что видел я, меня как пользователя вполне устраивало.
Фар есть инструмент, а не нянька. © 2009 DrKnS
User avatar
Alexey Samlyukov
Posts: 1765
Joined: Tue 15 Mar, 2005 17:28
Been thanked: 7 times
Contact:

Re: Энциклопедия для Фар 3

Post by Alexey Samlyukov »

В общем, тут какой-то умник попросил сделать из исходников писания "смотрелку", я понимаю, что чукчи все читатели, а писать за них будут другие.
Но из-за этой бредовой хотелки теперь нормально работать с сорцами нельзя.
User avatar
WARP ItSelf
Самый умный
Posts: 1011
Joined: Tue 15 Mar, 2005 23:19
Contact:

Re: Энциклопедия для Фар 3

Post by WARP ItSelf »

Внутри каждого html абзацы задавать <div lang="ru"> или <div lang="en"> (или...), а скриптами потом "делить"...
Не, так делать не надо. Тут правильно сказали про софт для перевода. Только в разные файлы с одинаковой структурой.
Никто не знал, а я...
User avatar
Andrey Budko
Posts: 1203
Joined: Fri 01 Apr, 2005 14:03
Contact:

Re: Энциклопедия для Фар 3

Post by Andrey Budko »

У меня FarEncyclopedia.ru.chm выглядит так:

Image

Физически невозможно прочитать.

Помогает убрать это:
<meta http-equiv="X-UA-Compatible" content="IE=edge">

Win7, девственный IE9 с на всякий случай сброшенными настройками.
User avatar
Alexey Samlyukov
Posts: 1765
Joined: Tue 15 Mar, 2005 17:28
Been thanked: 7 times
Contact:

Re: Энциклопедия для Фар 3

Post by Alexey Samlyukov »

это было исправлено в начале недели. в последних ночнушках должно нормальное лежать.
User avatar
John Doe
Бюрократ
Posts: 13855
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 428 times
Contact:

Re: Энциклопедия для Фар 3

Post by John Doe »

На самом деле причина мелкого текста кроется в том, что Энциклопедию долгое время не собирали в ночных сборках, и за это время кто-то грамотный решил что заголовки в Писании должны быть "единообразны" (а в разделе макро они отличались), и поломал декларацию
Без URL эта декларация неправильна, а точнее просто пропускается браузером, заставляя его игнорировать современные стандарты, и отображать страницы в режиме quirks.
Естественно при этом поломались новые таблицы (текст в браузере стал огромный), но этот неизвестный благополучно "пофиксил" CSS:

Изменение стиля поломало CHM, что не сразу заметили, но заметив - снова "пофиксили", удалив <meta http-equiv="X-UA-Compatible" content="IE=edge">
Браво...
User avatar
Alexey Samlyukov
Posts: 1765
Joined: Tue 15 Mar, 2005 17:28
Been thanked: 7 times
Contact:

Re: Энциклопедия для Фар 3

Post by Alexey Samlyukov »

совместимость с IE 5.5 - это конечно большая проблема, в сравнении с тем, что описание макр не имеет отношения к описанию Плугин АПИ; тем, что макры теперь описываются в двух частях; тем, что одна часть актуальная, но находится всегда в оффлайне, а вторая неактуальная, но в онлайне...
кричать "браво" неуместно как-то тут...
Post Reply

Return to “Нужна помощь”