Board.KolibriOS.org

Официальный форум KolibriOS
Текущее время: Ср июл 26, 2017 7:35 pm

Часовой пояс: UTC+03:00




Начать новую тему  Ответить на тему  [ 69 сообщений ]  На страницу Пред. 1 2 3 4 5 След.
Автор Сообщение
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Пн май 03, 2010 10:12 pm 
Не в сети

Зарегистрирован: Вт сен 12, 2006 9:44 pm
Сообщения: 37
А почему вопрос ?

_________________
Все сложное - просто!


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Вт май 04, 2010 12:30 am 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
G@K писал(а):
А почему вопрос ?

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

_________________
ушёл...


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Вт май 04, 2010 3:42 pm 
Не в сети
Аватара пользователя

Зарегистрирован: Пт июн 27, 2008 3:22 pm
Сообщения: 971
Very good. :) Только вот хотелось бы какое-то выделение кода в тексте, в идеале подсветкой синтаксиса, как в fasmw.


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Вт май 04, 2010 4:20 pm 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
Вот новый выпуск. Так как времени у мну почти нет, изменения совсем небольшие - переделана заглавная страница, теперь документация называется "Pterox' DocPack" (надеюсь Willow не будет против - название приглянулось :)), почти на каждой странице раздела "KolibriOS API" появилась ссылка для открытия содержания этого самого раздела, чтобы не нажимать двести раз кнопку [<-] (назад), также добавлен мануал по ФАСМу.
Цитата:
Very good. :) Только вот хотелось бы какое-то выделение кода в тексте, в идеале подсветкой синтаксиса, как в fasmw.

Спасибо :wink: В следующем выпуске постараюсь сделать подсветку и многое что еще другое.
З.Ы. Этот выпуск сделан больше для того, чтобы показать - дело не заглохло, и хоть малыми шагами, но движется навстречу прогрессу :lol:
http://ftp.kolibrios.org/users/Nasarus/Pterox'_DocPack/KOS_0.7.7.0+/R3.7z

_________________
ушёл...


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 12:36 am 
Не в сети
Аватара пользователя

Зарегистрирован: Пн фев 09, 2009 4:13 am
Сообщения: 445
Уже лучше, но в разделе "Установка" почему-то находится описание API функции. А в целом документация мне нравиться. :D

_________________
\ Маузер в руке, Путин – на крюке! \ Путину – клизму! Смерть капитализму! \ Путин – параша, победа будет наша!\
\ Застрели буржуя в спину! Он не лучше чем скотина! \
Изображение


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 12:45 am 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
Rock_maniak_forever писал(а):
Уже лучше, но в разделе "Установка" почему-то находится описание API функции. А в целом документация мне нравиться. :D

Исправим-с))

_________________
ушёл...


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 6:27 am 
Не в сети
Mentor
Аватара пользователя

Зарегистрирован: Вт янв 15, 2008 11:27 am
Сообщения: 750
1) файл hot_keys.htm битый (забит нулями)
2) почему бы "Предыдущие выпуски" не разбить по версиям?
3) если перейти к документу в папке api, не работает ссылка внизу страницы ("История выпусков"). нужно изменить относительный путь.


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 6:42 am 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
Albom писал(а):
1) файл hot_keys.htm битый (забит нулями)
3) если перейти к документу в папке api, не работает ссылка внизу страницы ("История выпусков"). нужно изменить относительный путь.

Сегодня поправлю и выложу
Albom писал(а):

http://ftp.kolibrios.org/users/Nasarus/ ... 7.0+/R2.7z - предыдущая версия, старые может как-нибудь потом выложу.

_________________
ушёл...


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 8:07 am 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
Цитата:
2) почему бы "Предыдущие выпуски" не разбить по версиям?

Извиняюсь, неправильно понял (я дурак). Обязательно сделаю это в релизе R5

_________________
ушёл...


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 8:10 am 
Не в сети

Зарегистрирован: Пн сен 24, 2007 11:11 am
Сообщения: 2814
I. Информация для пользователя KolibriOS
"Этот выпуск" - не совсем понятно, о системе или о справке идет речь. Может, "Информация об этой версии системы", или еще как-то?
Лицензия - "Лицензионное соглашение"? Почему бы сразу не открывать GNU GPL, вместо того, чтобы заставлять пользователя потом нажимать два раза на кнопку назад?
TCP/IP стек - в информации для пользователя идет раньше, чем горячие клавиши. Однако содержит в себе информацию, важную скорее для разработчика. Лучше может разделить на две части? Одна - как настроить сеть (примено так и назвать), а другая - как разрабатывать приложения с доступом к стеку.
Другие приложения - не сразу и поймешь, какие-такие другие.
Предыдущие выпуски - скорее я бы включил все это в раздел "для любознательных"

Зато добавил бы страничку, описывающую основные возможности системы, требования к ПК и названия программ - какие для чего нужны.

II. Для программиста
Документация по API. mike.dld на wiki предложил использовать таблицы для наглядного описания системных функций. Почему бы не поступить именно так? Таблицы можно делать и в псевдографике (я даже программы видел для автоматического конвертирования html-таблиц)
FASM manual есть и на русском (правда, совсем не свежий)
Использование различных компиляторов в КолибриОС. Зачем в русской версии документации и русская, и английская статья?

III. Насчет онлайн-версии и поддержании в актуальном состоянии
Чем не нравится wiki, почему бы не синхронизировать все это?
Аккуратно подправить там главную страницу (давно пора изменить ссылки по разделам).
И время от времени новые и обновленные страницы из wiki добавлять в htm-версию

IV. О навигации
Копирайт на страницы добавлен везде с историей версий. А ссылочек "Назад, на главную, вперед" - очень жаль, что нет.


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 8:25 am 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
Исправил ошибки, о которых мне сообщили (и не только :D). Обновил документацию по FASM'у до версии 1.68 (раньше было 1.62).
Вот выпуск R4:
R4.7z - 407 447 байт

Albom писал(а):
3) если перейти к документу в папке api, не работает ссылка внизу страницы ("История выпусков"). нужно изменить относительный путь.

К сожалению, HTMLv не поддерживает ссылки формата "../index.htm", поэтому есть два варианта развития событий: либо держать все страницы в одной папке, либо ждать когда Leency сделает поддержку в своем браузере :D.
Asper писал(а):
Very good. :) Только вот хотелось бы какое-то выделение кода в тексте, в идеале подсветкой синтаксиса, как в fasmw.

Та же ситуация - либо идти через *опу и прописывать цвет в HTML-страницах, либо делать подсветку программно с помощью HTMLv +/- Tynipad

P.S.: Большое спасибо всем авторам и тестерам!

_________________
ушёл...


Последний раз редактировалось Nasarus Ср май 05, 2010 10:52 am, всего редактировалось 2 раза.

Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 8:49 am 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
Sorcerer

Спасибо за совет. В версии R6 все сделаю как надо =)

_________________
ушёл...


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 8:53 am 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
Sorcerer писал(а):
IV. О навигации
Копирайт на страницы добавлен везде с историей версий. А ссылочек "Назад, на главную, вперед" - очень жаль, что нет.

Я за копирайтом не гонюсь, просто лень было переделывать комментарий :D

_________________
ушёл...


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Ср май 05, 2010 10:54 am 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
Заменил "копирайт" на "Pterox' DocPack R4.1"
Вложение:
Clipboard02.jpg
Clipboard02.jpg [ 7.24 КБ | 2897 просмотров ]

R4.1.7z - 407 451 байт
не гонюсь...

_________________
ушёл...


Вернуться к началу
 Заголовок сообщения: Re: KolibriOS Documentation
СообщениеДобавлено: Чт май 13, 2010 9:08 pm 
Не в сети
Аватара пользователя

Зарегистрирован: Ср янв 27, 2010 10:59 am
Сообщения: 269
Новый, 5-ый релиз документации. Главные плюсы: 1)в разделе "KolibriOS API" все ссылки теперь рабочие; 2) история версий разбита по номерам (спасибо Albom'у за совет). Остальные изменения читайте в спойлере ниже:
Спойлер: Показать
1. Переделаны статьи "Лицензионное соглашение", "История версий Колибри OS"; licence.htm удален за ненадобностью
2. Переделаны страницы DocPack.htm (index.htm, соответсвенно)
3. История версий разбита на страницы (v0.7.7.0.htm, v.0.5.2.0 и т.д.)
4. Частично синхронизированы с wiki описания некоторых API-функций
5. Благодаря изменениям все ссылки в разделе "API" теперь работают.
6. Для удобства навигации содержимое папки API вернулось в папку Pages. По этой же причине там теперь лежит папка Data
7. Для удобства навигации в папке Pages теперь лежит копия файла DockPack.htm (index.htm)
8. Создан файл files.ini - группированый список файлов. Пока в нем только страницы описания API

Это скриншот:
Спойлер: Показать
Вложение:
Screenshot.png
Screenshot.png [ 18.11 КБ | 2853 просмотра ]

Ссылка:
Pterox' DocPack R5.7z - 409 416 байт

_________________
ушёл...


Вернуться к началу
Показать сообщения за:  Поле сортировки  
Начать новую тему  Ответить на тему  [ 69 сообщений ]  На страницу Пред. 1 2 3 4 5 След.

Часовой пояс: UTC+03:00


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

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


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

Найти:
Перейти:  
Создано на основе phpBB® Forum Software © phpBB Limited
Русская поддержка phpBB