OberonCore
https://forum.oberoncore.ru/

Документация в формате HTML
https://forum.oberoncore.ru/viewtopic.php?f=4&t=2069
Страница 1 из 1

Автор:  Роман М. [ Среда, 18 Ноябрь, 2009 13:38 ]
Заголовок сообщения:  Документация в формате HTML

Искал (возможно, плохо) документацию по БлэкБоксу в сети в формате HTML.
Информации по BB, так скажем, почти ноль. Возможно, это и есть причина низкой осведомлённости о Компонентном Паскале среди окружающих.

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

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

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

Роман М. писал(а):
Искал (возможно, плохо) документацию по БлэкБоксу в сети в формате HTML.
... Хотелось бы найти документацию с иерархией ссылок по подсистемам, искать что-то в поисковой системе по ключевым словам в веб-сети.
Почему бы просто не распечатать в pdf? Поисковики умеют искать в pdf.

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

Фразу "распечатать в pdf" следует понимать как "вместо физического принтера воспользуйтесь pdf-принтером".

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

Роман М. писал(а):
Искал (возможно, плохо) документацию по БлэкБоксу в сети в формате HTML.

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

Автор:  Info21 [ Четверг, 19 Ноябрь, 2009 11:24 ]
Заголовок сообщения:  Re: Документация в формате HTML

Pavel писал(а):
А ссылки в PDF файлах работают? И куда они ссылаются?
Доступный поисковикам PDF без ссылок лучше, чем несуществующий HTML со ссылками :)

Автор:  Евгений Темиргалеев [ Четверг, 26 Ноябрь, 2009 15:23 ]
Заголовок сообщения:  Re: Документация в формате HTML

В свете: viewtopic.php?f=47&t=2120

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

Автор:  Valery Solovey [ Четверг, 26 Ноябрь, 2009 16:02 ]
Заголовок сообщения:  Re: Документация в формате HTML

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

Автор:  Евгений Темиргалеев [ Четверг, 26 Ноябрь, 2009 16:15 ]
Заголовок сообщения:  Re: Документация в формате HTML

В этом есть необходимость, раз народ желает. Но не критично.

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

Автор:  Роман М. [ Четверг, 03 Декабрь, 2009 22:43 ]
Заголовок сообщения:  Re: Документация в формате HTML

Те, кто писал, что полно документации в формате HTML в интернете, могут показать мне на неё прямые ссылки? Добрые совете типа "воспользоваться PDF принтерами" мало чем помогают.
На oberoncore.ru окромя переведённой документации ODC ничего не видел. К тому же, мне не перевод нужен, а HTML с перекрёстными ссылками - чтобы была независимо от наличия BBCB!

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

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

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

Автор:  Илья Ермаков [ Четверг, 03 Декабрь, 2009 22:52 ]
Заголовок сообщения:  Re: Документация в формате HTML

Странное требование "независимо от ББКБ" для программы, которую на современную флешку можно поместить в нескольких стах копиях...

Автор:  Роман М. [ Пятница, 04 Декабрь, 2009 02:43 ]
Заголовок сообщения:  Re: Документация в формате HTML

Да ничего в этом странного не вижу! В дороге, на мобильном телефоне, к сожалению, нет возможности читать документацию ODC. Зато HTML - проблем нет. А способов встраивания ББ в телефон пока не знаю.

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

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

Автор:  Евгений Темиргалеев [ Пятница, 04 Декабрь, 2009 03:29 ]
Заголовок сообщения:  Re: Документация в формате HTML

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

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

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

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

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

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

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

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


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

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

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

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

У нас тоже интересное было наблюдение. При объяснении начальных основ программирования девочки лучше воспринимают картинки в виде блок-схем, а пацаны - слова в виде автокода. Очень мало тех, кому пофигу, каким способом ему показывают.
Проверяли на 2-м и 3-м курсах.

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

Сделал затравку для web-справочника по Компонентному паскалю. Пока только по процедурам без типов, общего описания модуля и т.п. и вбивать информацию вручную приходится, но систему планирую доработать.

http://oberon.molpit.ru/

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

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

divan писал(а):
вопрос по копирайту. Подскажите, что нужно написать на сайте, чтобы скопировать туда документацию из английского и русского BB ?
В их лицензии обсуждается только софт. DEFINITION и все интерфейсы -- это часть софта. Прочтите их лицензию внимательно с этой точки зрения.

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

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

Автор:  Евгений Темиргалеев [ Понедельник, 18 Октябрь, 2010 16:16 ]
Заголовок сообщения:  Re: Документация в формате HTML

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").

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

Евгений Темиргалеев писал(а):
Info21 писал(а):
В их лицензии обсуждается только софт.
В который, по определению лицензии, документация входит:
Тем более.

Страница 1 из 1 Часовой пояс: UTC + 3 часа
Powered by phpBB® Forum Software © phpBB Group
https://www.phpbb.com/