Энциклопедия для Фар 3
Энциклопедия для Фар 3
Есть желающие для выверки/правки/наполнения/уточнения/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"> (или...), а скриптами потом "делить"...
Рабочая почти актуальная есть здесь 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!
So Say We All!
Re: Энциклопедия для Фар 3
По поводу локализации - если использовать спец. софт для переводов - удобнее, если разные языки в разных файлах.
- Tim Sobolev
- Posts: 729
- Joined: Fri 01 Apr, 2005 14:46
- Location: Украина
- Has thanked: 1 time
- Been thanked: 7 times
Re: Энциклопедия для Фар 3
Не помешало бы содержимое каталога enc_rus2 откатить до актуального для 1807 билда состояния, а то бардак
- Alexey Samlyukov
- Posts: 1765
- Joined: Tue 15 Mar, 2005 17:28
- Been thanked: 7 times
- Contact:
Re: Энциклопедия для Фар 3
как я помню, в enc_rus2 только титульная страница правилась на фар3.
каталоги enc_rus и enc_rus2 скорее всего будут удалены, как это случилось уже с плагинами.
останется только enc_rus3
каталоги enc_rus и enc_rus2 скорее всего будут удалены, как это случилось уже с плагинами.
останется только enc_rus3
- Tim Sobolev
- Posts: 729
- Joined: Fri 01 Apr, 2005 14:46
- Location: Украина
- Has thanked: 1 time
- Been thanked: 7 times
Re: Энциклопедия для Фар 3
Каталоги можно удалить, если будет возможность получить в любой момент энциклопедию для требуемой версии.
- Alexey Samlyukov
- Posts: 1765
- Joined: Tue 15 Mar, 2005 17:28
- Been thanked: 7 times
- Contact:
Re: Энциклопедия для Фар 3
Снова о сабже... Помог бы кто...
Из очень насущного - файл pluginsr.hhc
Основное отличие от предыдущих версий: нет Экспортируемых, сервисных, структур, но есть (должно быть) разные АПИ (а внутри уже и эксп и сервисные и структуры и определения...)
Из очень насущного - файл pluginsr.hhc
Основное отличие от предыдущих версий: нет Экспортируемых, сервисных, структур, но есть (должно быть) разные АПИ (а внутри уже и эксп и сервисные и структуры и определения...)
We are the Borg. You will be assimilated.
So Say We All!
So Say We All!
Re: Энциклопедия для Фар 3
Сложно помогать с toolchain на Perl. Для меня это основной затык. Для Python я бы что-нибудь придумал. Как вариант - API может генерится из pluginsr.hhc, например, с помощью toochain от PySide - но глубоко не исследовал. На худой конец есть Doxygen, но вывод обычно выглядит отстойно. В Python документация не в .HTML, а в .RST, каждая функция сопровождается комментом, в какой версии добавлена и пр. Синхронизации перевода нет. Для синхронизации надо вести версии каждого файла.
- HaRT
- Moderator
- Posts: 10863
- Joined: Tue 30 Aug, 2005 17:21
- Has thanked: 221 times
- Been thanked: 358 times
Re: Энциклопедия для Фар 3
techie
doxygen и подобные инструменты хороши тем, что документация не отрывается от документируемого кода, и у программиста наименьший шанс изменить API, но не обновить документацию. А внешний вид можно настраивать в широких пределах. То, что видел я, меня как пользователя вполне устраивало.
doxygen и подобные инструменты хороши тем, что документация не отрывается от документируемого кода, и у программиста наименьший шанс изменить API, но не обновить документацию. А внешний вид можно настраивать в широких пределах. То, что видел я, меня как пользователя вполне устраивало.
Фар есть инструмент, а не нянька. © 2009 DrKnS
- Alexey Samlyukov
- Posts: 1765
- Joined: Tue 15 Mar, 2005 17:28
- Been thanked: 7 times
- Contact:
Re: Энциклопедия для Фар 3
В общем, тут какой-то умник попросил сделать из исходников писания "смотрелку", я понимаю, что чукчи все читатели, а писать за них будут другие.
Но из-за этой бредовой хотелки теперь нормально работать с сорцами нельзя.
Но из-за этой бредовой хотелки теперь нормально работать с сорцами нельзя.
- WARP ItSelf
- Самый умный
- Posts: 1011
- Joined: Tue 15 Mar, 2005 23:19
- Contact:
Re: Энциклопедия для Фар 3
Не, так делать не надо. Тут правильно сказали про софт для перевода. Только в разные файлы с одинаковой структурой.Внутри каждого html абзацы задавать <div lang="ru"> или <div lang="en"> (или...), а скриптами потом "делить"...
Никто не знал, а я...
- Andrey Budko
- Posts: 1203
- Joined: Fri 01 Apr, 2005 14:03
- Contact:
Re: Энциклопедия для Фар 3
У меня FarEncyclopedia.ru.chm выглядит так:
Физически невозможно прочитать.
Помогает убрать это:
<meta http-equiv="X-UA-Compatible" content="IE=edge">
Win7, девственный IE9 с на всякий случай сброшенными настройками.
Физически невозможно прочитать.
Помогает убрать это:
<meta http-equiv="X-UA-Compatible" content="IE=edge">
Win7, девственный IE9 с на всякий случай сброшенными настройками.
- Alexey Samlyukov
- Posts: 1765
- Joined: Tue 15 Mar, 2005 17:28
- Been thanked: 7 times
- Contact:
Re: Энциклопедия для Фар 3
это было исправлено в начале недели. в последних ночнушках должно нормальное лежать.
- John Doe
- Бюрократ
- Posts: 13855
- Joined: Wed 27 Apr, 2005 20:42
- Has thanked: 73 times
- Been thanked: 428 times
- Contact:
Re: Энциклопедия для Фар 3
На самом деле причина мелкого текста кроется в том, что Энциклопедию долгое время не собирали в ночных сборках, и за это время кто-то грамотный решил что заголовки в Писании должны быть "единообразны" (а в разделе макро они отличались), и поломал декларацию
Без URL эта декларация неправильна, а точнее просто пропускается браузером, заставляя его игнорировать современные стандарты, и отображать страницы в режиме quirks.
Естественно при этом поломались новые таблицы (текст в браузере стал огромный), но этот неизвестный благополучно "пофиксил" CSS:
Изменение стиля поломало CHM, что не сразу заметили, но заметив - снова "пофиксили", удалив <meta http-equiv="X-UA-Compatible" content="IE=edge">
Браво...
Без URL эта декларация неправильна, а точнее просто пропускается браузером, заставляя его игнорировать современные стандарты, и отображать страницы в режиме quirks.
Естественно при этом поломались новые таблицы (текст в браузере стал огромный), но этот неизвестный благополучно "пофиксил" CSS:
Изменение стиля поломало CHM, что не сразу заметили, но заметив - снова "пофиксили", удалив <meta http-equiv="X-UA-Compatible" content="IE=edge">
Браво...
- Alexey Samlyukov
- Posts: 1765
- Joined: Tue 15 Mar, 2005 17:28
- Been thanked: 7 times
- Contact:
Re: Энциклопедия для Фар 3
совместимость с IE 5.5 - это конечно большая проблема, в сравнении с тем, что описание макр не имеет отношения к описанию Плугин АПИ; тем, что макры теперь описываются в двух частях; тем, что одна часть актуальная, но находится всегда в оффлайне, а вторая неактуальная, но в онлайне...
кричать "браво" неуместно как-то тут...
кричать "браво" неуместно как-то тут...