OberonCore

Библиотека  Wiki  Форум  BlackBox  Компоненты  Проекты
Текущее время: Воскресенье, 16 Июнь, 2019 13:34

Часовой пояс: UTC + 3 часа




Начать новую тему Ответить на тему  [ Сообщений: 20 ] 
Автор Сообщение
 Заголовок сообщения: Документация в формате HTML
СообщениеДобавлено: Среда, 18 Ноябрь, 2009 13:38 
Аватара пользователя

Зарегистрирован: Пятница, 25 Сентябрь, 2009 13:10
Сообщения: 1162
Откуда: Tel-Aviv
Искал (возможно, плохо) документацию по БлэкБоксу в сети в формате HTML.
Информации по BB, так скажем, почти ноль. Возможно, это и есть причина низкой осведомлённости о Компонентном Паскале среди окружающих.

Пробовал экспортировать ODC в XHTM средствами среды ББ:
  • вместо кириллицы - кракозябры
  • отсутствуют вставляемые объекты (включая картинки).

Хотелось бы найти документацию с иерархией ссылок по подсистемам, искать что-то в поисковой системе по ключевым словам в веб-сети.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Среда, 18 Ноябрь, 2009 14:58 
Аватара пользователя

Зарегистрирован: Пятница, 25 Ноябрь, 2005 12:02
Сообщения: 8127
Откуда: Троицк, Москва
Роман М. писал(а):
Искал (возможно, плохо) документацию по БлэкБоксу в сети в формате HTML.
... Хотелось бы найти документацию с иерархией ссылок по подсистемам, искать что-то в поисковой системе по ключевым словам в веб-сети.
Почему бы просто не распечатать в pdf? Поисковики умеют искать в pdf.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Среда, 18 Ноябрь, 2009 18:50 

Зарегистрирован: Понедельник, 30 Июль, 2007 10:53
Сообщения: 1537
Откуда: Беларусь, Минск
Фразу "распечатать в pdf" следует понимать как "вместо физического принтера воспользуйтесь pdf-принтером".


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Четверг, 19 Ноябрь, 2009 11:13 

Зарегистрирован: Суббота, 09 Декабрь, 2006 08:56
Сообщения: 35
Откуда: Беларусь
Роман М. писал(а):
Искал (возможно, плохо) документацию по БлэкБоксу в сети в формате HTML.

А ссылки в PDF файлах работают? И куда они ссылаются?


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Четверг, 19 Ноябрь, 2009 11:24 
Аватара пользователя

Зарегистрирован: Пятница, 25 Ноябрь, 2005 12:02
Сообщения: 8127
Откуда: Троицк, Москва
Pavel писал(а):
А ссылки в PDF файлах работают? И куда они ссылаются?
Доступный поисковикам PDF без ссылок лучше, чем несуществующий HTML со ссылками :)


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Четверг, 26 Ноябрь, 2009 15:23 
Модератор
Аватара пользователя

Зарегистрирован: Среда, 16 Ноябрь, 2005 00:53
Сообщения: 4489
Откуда: Россия, Орёл
В свете: viewtopic.php?f=47&t=2120

Меня больше интересует инструмент для экспорта всей документации (во всех локализациях) в формат докувики. Самому взяться пока времени нету...


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Четверг, 26 Ноябрь, 2009 16:02 

Зарегистрирован: Понедельник, 30 Июль, 2007 10:53
Сообщения: 1537
Откуда: Беларусь, Минск
В этом нет необходимости. По крайней мере, для русской документации. Я для себя часть документации переводил с английского. И это с учётом того, что английского я, в общем-то, не знаю. И сравнивал свой перевод с имеющимся. Разница получилась довольно существенная. Нашёл даже одно-два места, где смысл был передан зеркально противоположно. То есть, в английской версии написано "делать можно только так", а в имеющемся переводе написано "только так не делайте". А также полно мест, где русский текст можно толковать 4-5-ю способами.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Четверг, 26 Ноябрь, 2009 16:15 
Модератор
Аватара пользователя

Зарегистрирован: Среда, 16 Ноябрь, 2005 00:53
Сообщения: 4489
Откуда: Россия, Орёл
В этом есть необходимость, раз народ желает. Но не критично.

Вопрос же коррекции русских переводов, во многих местах черновых, гораздо более важен. Но к первому отношения не имеет.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Четверг, 03 Декабрь, 2009 22:43 
Аватара пользователя

Зарегистрирован: Пятница, 25 Сентябрь, 2009 13:10
Сообщения: 1162
Откуда: Tel-Aviv
Те, кто писал, что полно документации в формате HTML в интернете, могут показать мне на неё прямые ссылки? Добрые совете типа "воспользоваться PDF принтерами" мало чем помогают.
На oberoncore.ru окромя переведённой документации ODC ничего не видел. К тому же, мне не перевод нужен, а HTML с перекрёстными ссылками - чтобы была независимо от наличия BBCB!

Евгений Темиргалеев писал(а):
В свете: viewtopic.php?f=47&t=2120

Меня больше интересует инструмент для экспорта всей документации (во всех локализациях) в формат докувики. Самому взяться пока времени нету...

Ничего сложного. Мало чем отличается от генерации HTML.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Четверг, 03 Декабрь, 2009 22:52 
Модератор
Аватара пользователя

Зарегистрирован: Понедельник, 14 Ноябрь, 2005 18:39
Сообщения: 9121
Откуда: Россия, Орёл
Странное требование "независимо от ББКБ" для программы, которую на современную флешку можно поместить в нескольких стах копиях...


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Пятница, 04 Декабрь, 2009 02:43 
Аватара пользователя

Зарегистрирован: Пятница, 25 Сентябрь, 2009 13:10
Сообщения: 1162
Откуда: Tel-Aviv
Да ничего в этом странного не вижу! В дороге, на мобильном телефоне, к сожалению, нет возможности читать документацию ODC. Зато HTML - проблем нет. А способов встраивания ББ в телефон пока не знаю.

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

Мотив этой темы - не пожаловаться, а улучшить ситуацию. Этим я уже занялся и результаты есть. Как только будет что показать, я обязательно опубликую их.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Пятница, 04 Декабрь, 2009 03:29 
Модератор
Аватара пользователя

Зарегистрирован: Среда, 16 Ноябрь, 2005 00:53
Сообщения: 4489
Откуда: Россия, Орёл
Роман М. писал(а):
Те, кто писал, что полно документации в формате HTML в интернете, могут показать мне на неё прямые ссылки?
Не припоминаю, чтобы кто-то такое писал...

Ссылки тут собраны: http://oberoncore.ru/weblinks


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Пятница, 04 Декабрь, 2009 06:56 
Аватара пользователя

Зарегистрирован: Пятница, 25 Ноябрь, 2005 12:02
Сообщения: 8127
Откуда: Троицк, Москва
Роман М. писал(а):
Те, кто писал, что полно документации в формате HTML в интернете, могут показать мне на неё прямые ссылки? Добрые совете типа "воспользоваться PDF принтерами" мало чем помогают.
Вы бы прежде чем серчать, проблему свою как следует сформулировали.

Проблема, как теперь видно, в том, чтобы читать документацию с мобильника.
Это новый поворот, по-моему, эту проблему еще не поднимали.
Очень хорошо, что подняли.
Флаг в руки :)


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Пятница, 04 Декабрь, 2009 07:03 
Аватара пользователя

Зарегистрирован: Среда, 29 Март, 2006 12:09
Сообщения: 495
Info21 писал(а):
Роман М. писал(а):
Те, кто писал, что полно документации в формате HTML в интернете, могут показать мне на неё прямые ссылки? Добрые совете типа "воспользоваться PDF принтерами" мало чем помогают.
Вы бы прежде чем серчать, проблему свою как следует сформулировали.

Проблема, как теперь видно, в том, чтобы читать документацию с мобильника.
Это новый поворот, по-моему, эту проблему еще не поднимали.
Очень хорошо, что подняли.
Флаг в руки :)


Ну слава Богу...


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Пятница, 04 Декабрь, 2009 07:40 
Аватара пользователя

Зарегистрирован: Пятница, 25 Ноябрь, 2005 12:02
Сообщения: 8127
Откуда: Троицк, Москва
Димыч писал(а):
Ну слава Богу...
Интересно в Байтике наблюдать разницу между девочками (там их две, обе невероятно толковые) и мальчиками.
С девочками четкое ощущение, что с ними общаешься, -- они слушают и, главное, слышат, и по делу отвечают.
С пацанами картина иная: ему вечно в башку шибанет, и как гвоздь там сидит, и целая проблема слова найти, чтобы ему там этот гвоздик разогнуть.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Пятница, 04 Декабрь, 2009 09:31 

Зарегистрирован: Суббота, 07 Март, 2009 15:39
Сообщения: 3055
Откуда: Астрахань
У нас тоже интересное было наблюдение. При объяснении начальных основ программирования девочки лучше воспринимают картинки в виде блок-схем, а пацаны - слова в виде автокода. Очень мало тех, кому пофигу, каким способом ему показывают.
Проверяли на 2-м и 3-м курсах.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Понедельник, 18 Октябрь, 2010 11:19 
Аватара пользователя

Зарегистрирован: Четверг, 08 Октябрь, 2009 15:00
Сообщения: 2336
Сделал затравку для web-справочника по Компонентному паскалю. Пока только по процедурам без типов, общего описания модуля и т.п. и вбивать информацию вручную приходится, но систему планирую доработать.

http://oberon.molpit.ru/

Возник вопрос по копирайту. Подскажите, что нужно написать на сайте, чтобы скопировать туда документацию из английского и русского BB ?


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Понедельник, 18 Октябрь, 2010 16:10 
Аватара пользователя

Зарегистрирован: Пятница, 25 Ноябрь, 2005 12:02
Сообщения: 8127
Откуда: Троицк, Москва
divan писал(а):
вопрос по копирайту. Подскажите, что нужно написать на сайте, чтобы скопировать туда документацию из английского и русского BB ?
В их лицензии обсуждается только софт. DEFINITION и все интерфейсы -- это часть софта. Прочтите их лицензию внимательно с этой точки зрения.

Как минимум нужно указать (С) Oberon microsystems, Inc. и дать их URL: http://oberon.ch/

В самом крайнем случае нужно им написать и спросить.


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Понедельник, 18 Октябрь, 2010 16:16 
Модератор
Аватара пользователя

Зарегистрирован: Среда, 16 Ноябрь, 2005 00:53
Сообщения: 4489
Откуда: Россия, Орёл
Info21 писал(а):
В их лицензии обсуждается только софт.
В который, по определению лицензии, документация входит:
BlackBox License писал(а):
The following is the license that applies to this copy of the BlackBox Component Builder software components and the accompanying documentation (collectively, the "Software").


Вернуться к началу
 Профиль  
 
 Заголовок сообщения: Re: Документация в формате HTML
СообщениеДобавлено: Понедельник, 18 Октябрь, 2010 17:05 
Аватара пользователя

Зарегистрирован: Пятница, 25 Ноябрь, 2005 12:02
Сообщения: 8127
Откуда: Троицк, Москва
Евгений Темиргалеев писал(а):
Info21 писал(а):
В их лицензии обсуждается только софт.
В который, по определению лицензии, документация входит:
Тем более.


Вернуться к началу
 Профиль  
 
Показать сообщения за:  Поле сортировки  
Начать новую тему Ответить на тему  [ Сообщений: 20 ] 

Часовой пояс: UTC + 3 часа


Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 1


Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете добавлять вложения

Найти:
Вся информация, размещаемая участниками на конференции (тексты сообщений, вложения и пр.) © 2005-2019, участники конференции «OberonCore», если специально не оговорено иное.
Администрация не несет ответственности за мнения, стиль и достоверность высказываний участников, равно как и за безопасность материалов, предоставляемых участниками во вложениях.
Без разрешения участников и ссылки на конференцию «OberonCore» любое воспроизведение и/или копирование высказываний полностью и/или по частям запрещено.
Powered by phpBB® Forum Software © phpBB Group
Русская поддержка phpBB