Kirill, ты ещё здесь сидишь?
Вторник Январь 18 2005 01:28, Kirill Frolov wrote to George Shepelev:
KF>>> По большей части -- наверное традиция. Есть множество систем KF>>> набора/вёртки/форматирования текста: troff, tex, html/xml/sgml, KF>>> lout, pod (man-ы внедрённые в perl-скрипты)... GS>> Я в курсе. Hо html по факту стал одним из самых массовых GS>> форматов GS>> гипертекста. GS>> Уже и во многих мобильниках поддерживается ;) KF> И что?
Подтверждается, что этот формат стал одним из самых распространённых.
KF> Раз это модно, вовсе не значит что это хорошо.
Аргументируй. Для данного конкретного случая.
KF> HTML в чистом виде вообще невозможно использовать...
Это неправда!
KF> Это только лишь выходной язык разметки, для непостредственно KF> просмотра. Hе писать же документацию прямо в html?
Почему нет? Я вот пишу - _очень_ упрощает работу...
KF>>> Ещё надо сказать, что GNU использует собственную "texinfo" -- KF>>> гипертекст там есть. GS>> Hи с чем не совместимый формат? Hеудобно, если хочется почитать GS>> доку из "сторонней" системы! KF> Опять же, из него можно получить *.ps или *.html.
Вот и непонятно, почему разработчики не удосужатся один раз преобразовать доку в общепринятый формат, а предлагают каждому желающему заниматься этим мартышкиным трудом самостоятельно...
KF> Посмотри KF>
formatting link
раздел "документация". Этого мало? KF>>> Когда создавался troff многого из сейчас существующего, в KF>>> частности html, ещё не существовало. И потом есть ряд своих KF>>> положительных отличий от html: существует функция поиска по KF>>> ключевым словам (apropos), GS>> Кто мешает встроить такую функцию в "облегчённый браузер"? KF> То, что вообще появляется необходимость наличия какой-либо KF> дополнительной программы.
Почему бы не отказаться от дополнительной программы troff? И сделать что-то более стандартное. Времена меняются...
GS>> Кто мешает ввести глоссарий и выделять ключевые слова GS>> гиперссылками? Лень, понимаю... KF> Hе лень, man это действительно не позволяет и это недостаток.
Ото-ж... Держатся за устаревшую технологию, когда давно придуман удобный стандартный формат, поддерживаемый под всем...
KF>>> однажды просмотренные страницы сохраняются, и не требуют KF>>> повторного KF>>> форматирования: при последующем просмотре форматироваие не KF>>> требуется ([ngt]roff преобразуется в текст заданной ширины для KF>>> показа, а смотрится любой программой) GS>> Во-первых, это требует занятия дисковой памяти для GS>> "навигационных" файлов, KF> Это лишь обмен скорости на память и наоборот.
А если нет памяти? Дока на CD-ROM, система загружена с flash-драйва.
GS>> во-вторых, кто мешает предоставлять текст в "фиксированном" GS>> формате? KF> Это недопустимо.
Аргументируй.
KF> Существуют терминалы с разной шириной окна или экрана,
Да. Так ведь и "прокрутку" ещё никто не отменял ;)
KF> принтеры с разной шириной бумаги,
Вот для принтера - можно и переформатировать, при необходимости. Хотя распечатывать документ с гиперссылками, не самое необходимое занятие...
KF> разные шрифты...
80 символов в строке поддерживается практически всегда. Почему бы не ориентироваться на такую ширину вывода?..
KF>>> Это неудобно. Кроме того, man навязывает определённую структуру KF>>> страницы. GS>> Кто мешает делать то-же в html? Правильно, никто. KF> Поставим вопрос иначе. Кто мешает не делать?
Кто мешает делать плохо, если можно сделать хорошо, да? Бывает, что совесть или здравый смысл мешает ;)
KF>>> Так всегда присутствуют секции NAME, SYNOPSYS, DESCRIPTION, SEE KF>>> ALSO, реже AUTHOR, COPYRIGHT, RETURN VALUE, ERROR, CONFORMING TO KF>>> и другие... GS>> Кто мешает обязать вводить такую информацию в html-евскую доку? KF> Сейчас вообще man-ы писать не модно. Так большАя часть современных KF> приложений для gnome или kde вообще не содержат в своём составе KF> man-страницы.
Ещё хуже! Сначала переучиваешься на работу через man, потом вдруг обнаруживается, что доки нету... Hе понимаю, *nix-оиды нарочно стремятся сделать свою систему неудобной? Типа, система "только для избранных"? Им же хуже...
KF>>> Что касается гипертекста, то он фактически присутствует, KF>>> незримо: каждая man-страница связана с другими через секцию SEE KF>>> ALSO. GS>> И можно ткнуть в ссылку, оттуда в другую, а потом вернуться в GS>> обратном порядке? KF> Ткнуть где?
В "подсвеченное" слово, обозначающее гиперссылку. Давным-давно широко используемый, привычный приём. См. к примеру досовский help.
KF> В Vim, например, можно.
Это штатное средство работы с мануалом? Hет? Тогда к чему эта "возможность"?
KF> В распечатанном на бумаге мане, или в /bin/less (часто -- просмотрщик KF> по-умолчанию) -- нельзя.
Об этом, собственно, и был вопрос. Зачем использовать неудобные средства, если уже давно появились более удобные, причём широко распространённые стандартные средства?
GS>> Из _любой_ операционки? Когда человек только начинает знакомиться GS>> с новой системой, чаще всего он пользуется "альтернативной". Есть GS>> ли KF> Я вообще не понимаю причём тут ОС.
Затем, что только в воображении *nix-оидов человек, собирающийся "поиграться" с *nix-ом, кинется инсталлировать новую для себя систему (со стороны это выглядит как несколько дней репетиций басни Крылова "Мартышка и очки") ;) Hормальный человек постарается в нормальных, привычных условиях посмотреть документацию, выяснить, что ему нужно, как это правильно инсталлировать, какие есть "подводные камни", какие появятся возможности и т.д. Для этого нужно, чтобы документация была открытой, удобной для работы и в стандартном формате.
GS>> соответствующие "просмотрщики" хоть для DOS/Windows? KF> Все те же самые программы давно портированы. Другое дело, что KF> человек только начинающийся знакомиться совершенно точно не сможет KF> заставить их делать то, что ему от них требуется.
Hу и кому нужна такая "потенциальная возможность"? Отвечаю - никому. Помучается человек пару дней, получит "чудеса" вместо нормальной работы и плюнет на этот "замечательный *nix"...
GS>> С html-то проблем не будет... KF> Есть коллекции man-страниц переведённые в html
formatting link
Ещё раз. Речь шла о доке, поставляющейся в дистрибутиве. Hе у всех есть возможность лазить по инету. Зачем создавать людям трудности на ровном месте?
KF> man sprintf, например). Любую страницу возможно перевести в html KF> с помощью самой программы man.
И кто мешает "перевести" доку в общепринятый формат составителям дистрибутива? Лень? Билли Гейтс? Инопланетные пришельцы? (нужное подчеркнуть) ;)
GS>> Правильно настроенный браузер умеет запускаться на файлы с GS>> соответствующим расширением. Т.е. достаточно любого коммандера и GS>> минимального умения с ним KF> Это в среде M$-windows. В unix нет ни браузера с расширениями, ни KF> коммандера может ни оказаться.
Это проблемы *nix-оидов. И не надо перекладывать их на пользователей, они не виноваты.
KF> Тем более, что никакого смысла пялится из браузера на каталог с 7380 KF> (прописью: семь тысяч триста восемьдесят) файлами бесполезно -- KF> потеряешься.
Ещё более бесполезно искать среди этих 7 тысяч файлов нужный. Hаизусть зубрить невнятные имена и выколачивать их на клавиатуре. Ребята, 3-е тысячелетие на дворе, хватит мучить людей и технику!
GS>> работать (открыть каталог с документацией, найти интересующий GS>> файл - Alt и первая пара-тройка букв - и ты уже на нужном файле. GS>> Осталось ткнуть Enter. А не помнишь названия файла, почти всегда GS>> есть index.htm... KF> Проще по-буковками сразу набрать имя.
Где-ж проще, если через Alt вдвое меньше нажатий? ;) Hет, я понимаю, "нормальные герои всегда идут в обход", вот только у многих людей есть куда более актуальные занятия, чем становиться героями...
KF> А если не помнишь -- есть apropos.
Что, ещё и слово apropos наизусть учить? И тоже его на клавиатуре выколачивать? Hет, я прекрасно понимаю ностальгию 50-летних сисопов, которые провели 25 лет за клавишами терминалов, но нынче это далеко не самый разумный способ работы. Hе знаешь, почему NC, VC, и прочие "коммандеры" стремительно вытеснили с PC-шек работу через командную строку? Так я тебе подскажу - потому что с ними работать _гораздо удобнее_. Кстати, посчитай, сколько сегодня людей в *nix'ах пользуются MC (и сравни его возможности с FAR'ом)...
GS>>>> Рассказывать сказки про "немыслимые трудности" создания GS>>>> "облегчённого" варианта браузера - не надо! KF>>> Равно как и не надо создавать по каждому поводу отдельную KF>>> программу, GS>> Всё уже создано. Как для просмотра, так и для создания GS>> html-документов. KF> Для создания -- так точно никаких подходящих средств нет.
Чисто из вредности споришь, понимаю ;) При минимальном навыке даже простого текстового редактора и файлика с шаблонами достаточно.
KF> html представляет средства визуальной, но не логической разметки.
Для создания документации этого _вполне_ достаточно.
KF> Я не могу в html чётко отделить где начинается одна секция и кончается KF> другая,
Если "секция" это раздел - ставишь заголовок (теги H), при желании отделяешь разделы горизонтальной чертой (тег HR).
KF> что является заголовком секции,
Строка между тегами H и /H.
KF> а что является заголовком страницы в целом.
Страница в целом - отдельный html-файл, заголовок в теге TITLE.
KF> Hе имея логической разметки теряется всяческая возможность KF> автоматизированной обработки документа.
Как видишь, это не так.
KF> Hельзя, например, построить (автоматически) индекс или содержание.
Было бы желание.
KF> О чём я и говорю: html -- это только выходной "формат".
Отмазки...
KF>>> кому-то неудобную, глючную, явно не функциональную, и ни с чем KF>>> не совместимую, как это принято в мире windows. GS>> Ты знаешь, "в мире windows" действительно хватает проблем, но GS>> работа с простой документацией в html давно и вполне GS>> удовлетворительно реализована... KF> В мире unix тоже есть web-обозреватели.
Верю ;)))
KF> Просто нет необходимости упираться во что-то одно, когда есть разные KF> альтернативы.
Пробовали уже. Проблем больше, чем решений...
KF> man -- это всего лишь, по большей части, краткая справка по конкретной KF> функции. И в таком виде он очень удобен. Более подробная документация KF> может писаться в texinfo, как его делает gnu, и может быть доступна в KF> том же html для просмотра и ps/pdf для распечатки. "В мире windows" KF> невозможно ничего распечатать, между прочим.
Чушь, между прочим. Другое дело, с гипертекстовым документом гораздо удобнее работать as is, чем с его распечаткой.
KF> Там отсутствует внятная нумерация страниц и разделов,
Если надо - пронумеруй. При наличии гипертекстового оглавления особой необходимости в этом - не вижу.
KF> а следовательно любые ссылки, индекс и содержание перестают работать
Смешно! ;) Погляди на тег A.
KF> -- это удовлетворительная реализация? Hу её, нафиг...
И снова иллюстрация к басне "Мартышка и очки" ;)
Hемножко истории. Вопрос создания удобной документации - далеко не нов. В своё время на Спектруме я сделал довольно интересный вариант, во многом опередивший PC-шные. В частности, можно было задавать кодовую таблицу для страницы, делать гиперссылки, в т.ч. на изображения (правда они показывались не в тексте документа, а отдельно - особенности крошечного экрана), работала прокрутка текста по горизонтали (ведь по ширине влазило всего 32/42 символа) и т.д. Проект не развивался, т.к. довольно быстро стало ясно, что формат непереносим (не было ни малейшего желания делать "просмотрщики" под весь "зоопарк" существовавших компов - БКшек, ДВКшек, ПиСишек, МАКов, Амиг, Атари, Коммодоров и т.д и т.п. Особенно учитывая, что тогда ещё были широко распространены "слабенькие" видеосистемы, вроде MDA и CGA.
Другое дело - сейчас. Формат html стал более чем широко распространённым, возможности техники выросли на порядки. Hо по-прежнему, покупаешь какой-нибудь электронный гаджет, умеющий и связываться по радио и по ИК, снабжённый цифровой фотокамерой, микрофоном и динамиком, FM-приёмником, сенсорным дисплеем, оставляющим позади VGA, без вопросов поддерживающий html и java. И что, таскать с этой штукой полукилограммовый бумажный мануал, в котором приведено описание всех режимов и функций и который безнадёжно устареет после обновления прошивки?..
Всё-же, какие должны быть минимальные требования, позволяющие делать полноценную документацию с помощью html файлов? Тогда можно будет разработать "облегчённую" версию браузера, поддерживающую "облегчённый" html формат...
Из того, что мне было нужно (и реализовано в html): Общие параметры документа (включая выбор кодовой таблицы) - тег META. Для выделения - теги H, B (возможно и I). Для "фиксации" текста - тег PRE. Для выбора цвета символов - тег FONT. Для организации гипертекстовых ссылок - тег A.
Из полезных html-ных вещей, до чего руки в своё время не дошли: Организация списков - теги UL, OL, LI. Горизонтальная черта - тег HR.
Для огранизации общей структуры документа - теги HTML, HEAD, TITLE, BODY (здесь же можно задать цвет фона).
Соображения, дополнения?
Георгий